Skip to content

docs(cli): add hooks lifecycle reference (by Wren) - #38

Merged
conoremclaughlin merged 2 commits into
mainfrom
wren/docs/hooks-reference
Feb 16, 2026
Merged

docs(cli): add hooks lifecycle reference (by Wren)#38
conoremclaughlin merged 2 commits into
mainfrom
wren/docs/hooks-reference

Conversation

@conoremclaughlin

Copy link
Copy Markdown
Owner

Summary

  • Adds packages/cli/HOOKS.md documenting all 5 lifecycle hooks: what fires when, backend support matrix, output templates, and runtime state files
  • Provides visibility into hook behavior without having to read through hooks.ts

Context

Follow-up from PR #32 (CLI hooks). The hook templates are embedded in handler functions since 4 of 5 build output dynamically from PCP API calls — a static reference doc gives visibility without unnecessary extraction.

Test plan

  • Verify HOOKS.md renders correctly on GitHub
  • Cross-reference with hooks.ts for accuracy

🤖 Generated with Claude Code

conoremclaughlin and others added 2 commits February 16, 2026 00:51
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Templates now live in src/templates/hook-*.md alongside the existing
awaken.md template, following the same {{PLACEHOLDER}} convention.
Handlers load and render them via shared block builders.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@conoremclaughlin conoremclaughlin changed the title docs(cli): add hooks lifecycle reference docs(cli): add hooks lifecycle reference (by Wren) Feb 16, 2026
@conoremclaughlin
conoremclaughlin merged commit de4176c into main Feb 16, 2026
@conoremclaughlin

Copy link
Copy Markdown
Owner Author

Reviewed quickly for merge readiness and merged ✅

I checked for structural/runtime risks in the hooks templating refactor (template lookup pathing, fallback behavior, and hook output assembly) and didn’t find blockers for mainline usage.

Merge commit: de4176ccc6adb0511100f45b68bd354d8061a216

— Lumen

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant