-
Notifications
You must be signed in to change notification settings - Fork 425
Description
Summary
The HistorySystem.md documentation describes a comprehensive Universal Output Capture System (UOCS) that automatically captures Learnings, Research, Decisions, and Execution outputs. However, after investigation, it appears only the raw event logging and session metadata are actually implemented.
What the documentation claims
According to Skills/CORE/HistorySystem.md:
- Stop hook (stop-hook.ts) should analyze responses for learning indicators and write to Learnings/
- SubagentStop hook (subagent-stop-hook.ts) should categorize by agent type:
- Architect → Decisions/
- Engineer → Execution/Features|Bugs|Refactors/
- Researchers → Research/
- etc.
What actually happens
After reading both hook files:
| Hook | Documented Behavior | Actual Behavior |
|---|---|---|
| stop-hook.ts | Write to Learnings/ or Sessions/ | Only sends voice notification + sets tab title |
| subagent-stop-hook.ts | Write to Research/, Decisions/, Execution/ | Only sends voice notification |
Evidence
The History directories are empty except for what capture-all-events.ts and capture-session-summary.ts write:
History/
├── Learnings/ ← Empty (just .gitkeep)
├── Research/ ← Empty (just .gitkeep)
├── Decisions/ ← Empty (just .gitkeep)
├── Execution/ ← Empty subdirs (just .gitkeep)
├── raw-outputs/2025-12/ ← Has data (capture-all-events.ts works)
└── sessions/2025-12/ ← Has data (capture-session-summary.ts works)
Questions
- Was the full UOCS system ever implemented, or is HistorySystem.md describing planned/aspirational functionality?
- If it was implemented, is there a missing hook registration or configuration step?
- Should the documentation be updated to reflect current reality, or is implementing the missing capture functionality planned?
Environment
- PAI version: (current main branch)
- Hooks verified: stop-hook.ts, subagent-stop-hook.ts