docs: audit and align documentation with current codebase

AGENTS.md

@@ -36,15 +36,23 @@ npm run lint:fix   # biome check --write
 - `src/launch-orchestrator.ts` — Parallel multi-adapter launch orchestration (group IDs, worktree creation, parallel dispatch)
 - `src/matrix-parser.ts` — YAML matrix file parser + cross-product expansion for sweep launches
 - `src/worktree.ts` — Git worktree create/list/clean utilities
-- `src/hooks.ts` — Lifecycle hook runner (env vars: SESSION_ID, CWD, ADAPTER, BRANCH, EXIT_CODE, GROUP, MODEL)
+- `src/hooks.ts` — Lifecycle hook runner (env vars: AGENTCTL_SESSION_ID, AGENTCTL_CWD, AGENTCTL_ADAPTER, AGENTCTL_BRANCH, AGENTCTL_EXIT_CODE, AGENTCTL_GROUP, AGENTCTL_MODEL)
 - `src/cli.ts` — CLI entry point (commander)
 - `src/daemon/server.ts` — Daemon: Unix socket server + HTTP metrics
+- `src/daemon/supervisor.ts` — Daemon supervisor (auto-restart on crash)
 - `src/daemon/session-tracker.ts` — Session lifecycle tracking
 - `src/daemon/lock-manager.ts` — Auto + manual directory locks
 - `src/daemon/fuse-engine.ts` — Generic directory-scoped TTL fuse timers with configurable on-expire actions
+- `src/daemon/webhook.ts` — Webhook event emission (session.stopped)
 - `src/daemon/metrics.ts` — Prometheus metrics registry
 - `src/daemon/state.ts` — State persistence layer
 - `src/client/daemon-client.ts` — Unix socket client for CLI
+- `src/file-context.ts` — File context builder (--file/--spec flags)
+- `src/utils/config.ts` — Configuration loading (~/.agentctl/config.json)
+- `src/utils/resolve-binary.ts` — Binary path resolution
+- `src/utils/prompt-file.ts` — Prompt file handling (large prompts via temp files)
+- `src/utils/spawn-with-retry.ts` — Spawn with ENOENT retry
+- `src/utils/display.ts` — Display formatting utilities
 - `src/migration/migrate-locks.ts` — Migration from ~/.openclaw/locks
 
 ## Conventions
@@ -65,7 +73,7 @@ npm run lint:fix   # biome check --write
 ./scripts/release.sh [patch|minor|major]
 ```
 
-Bumps version, builds, tags, and runs `npm link`. No npm publish (local tool).
+Bumps version, builds, and pushes release branch. Tag push triggers npm publish via GitHub Actions. See RELEASING.md for full workflow.
 
 ## CI
 

CHANGELOG.md

@@ -6,7 +6,53 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
-## [1.5.0] - 2026-02-26
+### Added
+
+- Phase 1 ACP adoption — Codex adapter via ACP transport (#125, #127)
+- Lifecycle webhooks for `session.stopped` payloads (#123)
+- Callback metadata (`--callback-session`, `--callback-agent`) for orchestration (#123)
+- Spawn ENOENT retry for adapter launch resilience (#123)
+- Complete stateless daemon core — eliminate remaining shadow state (#117)
+
+### Fixed
+
+- Eliminate pending- session IDs — resolve real ID at launch (#131)
+- Webhook emit numeric `exit_status` + compatible HMAC headers (#128)
+- Eliminate daemon-env.json — derive env at spawn time (#119)
+- Update resolve-binary util (#121)
+
+### Docs
+
+- ADR-001: adopt ACP as primary agent interface (#126)
+
+## [1.6.0] - 2026-03-06
+
+### Added
+
+- `--file` flag to include context files in launch prompts (#95)
+- Use `history.jsonl` for Claude Code discover(), batch `lsof` calls (#96)
+
+### Fixed
+
+- Insert `--` separator before positional prompt args in codex/opencode/pi-rust (#106)
+- Peek/status timeout on opencode sessions (#100)
+- Use temp file for large prompts instead of CLI args (#101)
+
+## [1.5.2] - 2026-03-02
+
+### Fixed
+
+- OpenCode detach, matrix prompt override, persistent config defaults (#87)
+- Worktree slug collisions, pi-rust `--provider`/`--append-system-prompt` (#83)
+- Pass `--model` flag when launching OpenCode (#79)
+
+## [1.5.1] - 2026-02-27
+
+### Fixed
+
+- Resolve P0+P1 launcher/docs regressions (#76)
+
+## [1.5.0] - 2026-02-25
 
 ### Added