Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Phase 4: Structured activity log for ADF

Abierto
#641 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
30/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Estancado
Stack tecnológico
rust
Área
cli, observability-sre

Línea de trabajo

Start with the proposed terraphim_orchestrator/activity.rs module and review the Paperclip activity log references at packages/db/src/schema/activity_log.ts and server/src/services/activity.ts. Trace existing telemetry.jsonl writes before defining the structured event integration. Done means orchestrator mutations emit consistent append-only activity.jsonl events, existing telemetry remains compatible, and the adf activity CLI command can tail or query recent events.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

enhancement

Parent Epic

#637

Summary

Extend telemetry JSONL with structured activity events for all orchestrator mutations and agent lifecycle events.

Changes Required

terraphim_orchestrator
  • New activity.rs module with ActivityEvent enum and JSONL writer
  • Events to log:
    • ConfigChanged {before_hash, after_hash, changed_keys}
    • BudgetWarning {agent, spent_cents, budget_cents, percentage}
    • BudgetPaused {agent, spent_cents, budget_cents}
    • AgentDriftDetected {agent, score, level, action_taken}
    • AgentRestarted {agent, reason, restart_count, session_resumed}
    • CompoundReviewCompleted {findings_count, pr_created, duration}
    • ApprovalRequested {id, type, agent}
    • ApprovalDecided {id, decision, actor}
  • Schema: {timestamp, event_type, agent_name, details: {}, actor: "system"|"human"|agent_name}
  • Write to activity.jsonl in logs directory
Integration
  • Replace ad-hoc telemetry.jsonl writes with structured ActivityEvent emissions
  • Activity log is append-only, rotatable by external logrotate

Reference

  • Paperclip activity log: packages/db/src/schema/activity_log.ts
  • Paperclip activity service: server/src/services/activity.ts

Acceptance Criteria

  • All orchestrator mutations emit structured activity events
  • Events written to activity.jsonl with consistent schema
  • Events include timestamp, event_type, agent_name, details
  • Backward compatible with existing telemetry (can coexist)
  • adf activity CLI command to tail/query recent events
Lenguaje dominante
Rust
Estrellas
62
Forks
5
Merge medio
2 h 27 min
PR fusionados (30 d)
1

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de terraphim/terraphim-ai

Todos los issues de terraphim/terraphim-ai

Issues similares

Más issues de Rust

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.