terraphim / terraphim/terraphim-ai

Phase 4: Nightly extraction -- automated workflow crystallisation via ADF

Aperta
#696 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

enhancement
Lingua principale
Rust
Stelle
62
Fork
5
Merge medio
2h 27m
PR unite (30g)
1

Descrizione

Parent Epic

Part of #692 (Operational Skill Store)

Summary

Add a new Core-tier ADF agent that runs nightly to automatically discover and crystallise successful multi-step workflows from session history into reusable procedures. This closes the loop -- instead of manual capture-success, the system learns from its own history.

What Changes

New ADF agent: procedure-crystalliser

Tier: Core (cron-scheduled, runs nightly)
CLI: terraphim-agent (uses sessions + learn subcommands)

Nightly workflow:

  1. terraphim-agent sessions import -- refresh session cache
  2. Scan recent sessions for successful multi-step sequences (exit code 0 chains)
  3. Classify sequences by task type using KG concept matching
  4. Deduplicate against existing procedures (Aho-Corasick)
  5. Store novel sequences as new CapturedProcedure entries
  6. Run learn health across all procedures
  7. Generate daily report: new procedures, degraded procedures, statistics
Orchestrator config addition
[[agents]]
name = "procedure-crystalliser"
tier = "Core"
cli = "terraphim-agent"
schedule = "0 2 * * *"   # 02:00 daily
working_dir = "/home/alex/terraphim-ai"
Session extraction API in terraphim_sessions
pub async fn extract_successful_sequences(
    since: DateTime<Utc>,
    min_steps: usize,
) -> Vec<CommandSequence>;

Affected Crates

  • terraphim_orchestrator (new agent config)
  • terraphim_sessions (extraction API)
  • terraphim_agent (orchestration entry point)

Dependencies

  • Phase 1 (#693) -- CapturedProcedure type
  • Phase 3 (#695) -- health monitoring
  • #637 Paperclip leverage into ADF (orchestrator infrastructure)
  • #639 Session persistence for Claude Code agents
  • #683 Tree-structured session storage

Acceptance Criteria

  • procedure-crystalliser agent defined in orchestrator config
  • Session extraction API returns successful command sequences
  • KG-based task type classification for discovered sequences
  • Aho-Corasick deduplication prevents storing known procedures
  • Daily report generated with new/degraded procedure counts
  • Integration test with sample session data

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Start with the existing structures in terraphim_orchestrator, terraphim_sessions, and terraphim_agent, then trace the sessions and learn subcommands used by the nightly workflow. Implement the procedure-crystalliser configuration, successful-sequence extraction, classification, deduplication, health checks, and daily report, and validate the result with integration tests using sample session data.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
rust
Ambito
ai, backend, cli
Tipo di issue
Funzionalità
Difficoltà
4/5
Tempo stimato
3-5 giorni
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
35/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.