Missing hook scripts referenced in v3.0 hooks README

[michaelaye]

Summary

The hooks/README.md documents two hooks that don't have corresponding script files on disk. These may be missing from the v3.0 installer.

Missing Scripts

Hook	Event	Matcher	Listed in README	Exists on disk
CriteriaTracker.hook.ts	PostToolUse	all tools	Yes (line ~154)	No
SessionReactivator.hook.ts	UserPromptSubmit	—	Yes (line ~139)	No

README Description

From hooks/README.md:

• CriteriaTracker.hook.ts — "Real-time phase tracking + ISC criteria tracking" (PostToolUse, non-blocking, depends on lib/algorithm-state.ts)
• SessionReactivator.hook.ts — "Reactivate algorithm state on new prompt" (UserPromptSubmit, non-blocking, depends on lib/algorithm-state.ts)

Impact

• These hooks are not in settings.json (so no runtime errors), but the README presents them as part of the v3.0 hook architecture
• Both depend on lib/algorithm-state.ts — this file may also need to be checked/created
• The settings.json config shipped with v3.0 also had 5 other stale v2 hook references (FormatEnforcer, ExplicitRatingCapture, ImplicitSentimentCapture, DailyReminder, AgentOutputCapture) that don't exist on disk — these may also be installer oversights

Expected Behavior

Either:

1. The installer should create these hook scripts, OR
2. The README should be updated to remove references to hooks that aren't implemented yet

Environment

• PAI v3.0
• Claude Code with hooks system
• macOS (Darwin 25.2.0)

[michaelaye]

Additional: 7 hooks missing from installer's settings.json

Beyond the 2 missing script files, there were also 7 hooks that exist on disk but were NOT wired into settings.json by the installer:

Hook	Event	Matcher	Script exists	Was in settings.json
RatingCapture.hook.ts	UserPromptSubmit	—	Yes	No (replaced by stale ExplicitRatingCapture + ImplicitSentimentCapture)
SessionAutoName.hook.ts	UserPromptSubmit	—	Yes	No
AgentExecutionGuard.hook.ts	PreToolUse	Task	Yes	No
SkillGuard.hook.ts	PreToolUse	Skill	Yes	No
RelationshipMemory.hook.ts	SessionEnd	—	Yes	No
UpdateCounts.hook.ts	SessionEnd	—	Yes	No
IntegrityCheck.hook.ts	SessionEnd	—	Yes	No

All 7 are documented in hooks/README.md as part of the v3.0 architecture. The installer appears to ship scripts but doesn't register them in settings.json.

Full picture

The v3.0 installer has three issues:

1. 5 stale v2 hooks in settings.json referencing scripts that don't exist
2. 7 v3.0 hooks with scripts on disk but not wired into settings.json
3. 2 v3.0 hooks documented in README but with no script files at all

[kaimagnus]

Thanks for catching these discrepancies! Fixed in the v3.0 release. The hooks README has been updated:

1. SessionReactivator.hook.ts — Removed from the registry. This hook was planned but never implemented; its functionality is handled by AlgorithmTracker.hook.ts.

2. CriteriaTracker.hook.ts — Renamed to AlgorithmTracker.hook.ts in the registry to match the actual filename. The hook handles both phase tracking and ISC criteria tracking.

The execution flow diagram and hook registry tables now match the actual files in the hooks/ directory.