session-closure

name	session-closure
description	Manages the Protocol 128 multi-phase closure sequence including Technical Seal and Soul Persistence. Executes automatically when a session ends or work is complete.
disable-model-invocation	false

Session Closure (Protocol 128 Phases VI-VIII)

You are responsible for safely closing and persisting an agent's memory and working state at the end of a session or task completion.

Core Directives

1. Never Skip Retrospection: You must wait for the Orchestrator to signal that the loop and the Retrospective are formally complete before initiating the closure sequence.
2. Iron Check Compliance: If the Technical Seal detects drift in the Iron Core, you MUST abort closure and enter Safe Mode.
3. Sovereignty: You are the ONLY entity allowed to mutate global .agent/ state, update the Vector DB, or push to Git during closure. No generic loop may do this.

Plugin Dependencies

Plugin/Skill	Role
plugins/guardian-onboarding/scripts/capture_snapshot.py	Phase VI: Generates the sealed snapshot via context-bundler
plugins/rlm-factory/	Phase VI: Updates the global learning_package_snapshot.md
plugins/guardian-onboarding/scripts/persist_soul.py	Phase VII: Thin wrapper → delegates to huggingface-utils
plugins/huggingface-utils/	HF config, upload primitives, init — the single source of truth for all HuggingFace operations
plugins/obsidian-integration/skills/forge-soul-exporter/	Phase VII (Full Sync): Exports sealed vault notes to JSONL for HF
plugins/vector-db/	Phase VII: Ingests new artifacts into local ChromaDB
plugins/context-bundler/scripts/bundle.py	Called internally by capture_snapshot.py to produce the bundle
plugins/agent-loops/	The generic loop orchestration must signal completion before closure starts

[!IMPORTANT] All HuggingFace operations are now centralized in plugins/huggingface-utils/. The Guardian's persist_soul.py is a thin wrapper — it no longer contains inline HF logic. First-time setup: python plugins/huggingface-utils/skills/hf-init/scripts/hf_init.py

---

Phase Execution Steps

1. The Technical Seal & Context Synthesis (Phase VI)

Trigger the RLM Synthesizer to update global memory, and execute the Iron Check to formally lock in the current context.

# Option A: Inject summaries for files created/modified this session (preferred -- no Ollama needed)
python3 plugins/rlm-factory/skills/rlm-curator/scripts/inject_summary.py \
  --profile project --file <modified_file> --summary "<your summary>"

# Option B: Batch re-distill last 24h via Ollama (if Ollama is running)
python3 plugins/rlm-factory/skills/rlm-curator/scripts/distiller.py --profile project --since 24

# Capture the technical seal (Context Bundler & Tests)
python3 plugins/guardian-onboarding/scripts/capture_snapshot.py --type seal

Incremental Injection Rule: For every new script, plugin, skill, or significant doc created during the session, inject a summary immediately after creation using inject_summary.py. Do NOT wait until seal -- this keeps the cache current in real-time and avoids large batch runs.

Scratchpad Archiving Rule: The Guardian MUST extract any ephemeral "Shared Session State" or scratchpads left by the loop. These core findings must be synthesized and persisted into the Obsidian Vault and ingested into the Vector DB. Following successful extraction and synthesis, the Guardian is responsible for wiping the ephemeral state/scratchpads to maintain a clean environment.

Action: Confirm the command output states the seal was successful. If it fails, report the drift to the user and halt.

2. Soul Persistence & Ingestion (Phase VII)

Trace the agent's logic, broadcast the verified state to the Hugging Face repository, and ingest into local vectors.

# Persist Traces to Local Memory (.agent/learning/session_traces.jsonl)
# (Done natively by the closure script)

# Persist Soul — Incremental (Broadcast snapshot to HuggingFace)
python3 plugins/guardian-onboarding/scripts/persist_soul.py --snapshot .agent/learning/learning_package_snapshot.md

# OR: Full Genome Sync (rebuild soul_traces.jsonl from all sealed notes)
# python3 plugins/obsidian-integration/skills/forge-soul-exporter/scripts/forge_soul.py --vault-root . --full-sync

# Ingest Changes into Vector DB
python3 plugins/vector-db/skills/vector-db-agent/scripts/ingest.py --incremental --since 24

3. Session Close (Phase VIII)

Sync the immutable truth to Git and formally end the session.

# Version Control
git add .
git commit -m "chore(memory): seal session state and persist traces"
# git push # Wait for user approval as per Human Gate policy

# End workflow
python plugins/agent-loops/skills/orchestrator/scripts/agent_orchestrator.py end

Reference: For detailed acceptance criteria and failure handling, see references/acceptance-criteria.md.