- deduplicate changelog coverage for git worktree sandbox and context hydration
- clarify module guides with lifecycle notes, import examples, and tier rationale
- add HAL 9000 to CONTRIBUTORS for documentation work
ISSUES CLOSED: #7150
- Add docs/modules/git-worktree-sandbox.md: full lifecycle guide for
GitWorktreeSandbox including state machine, method reference, error
table, and CLI Apply Summary panel documentation (PR #5998)
- Add docs/modules/context-tier-hydrator.md: module guide for
ContextTierHydrator covering public API, limits/filters, fragment
structure, and structured log events (PR #4219, bug #1028)
- Update mkdocs.yml nav to include both new module pages
- Update README.md highlights with git worktree sandbox, ACMS context
tier hydration, and container/devcontainer resource stop features
- Update CHANGELOG.md [Unreleased] section with entries for PRs #5998,
#4219, #3250, #4197, #4175, #3837
- document the new module guides across docs and navigation\n- remove unrelated fix entries from changelog to keep the docs update scoped\n- link the sandbox guide to ADR-015 instead of spec line numbers\n- add HAL 9000 to contributors for documentation updates\n\nISSUES CLOSED: #6298
- docs/api/tui.md: Fix Persona dataclass to reflect actual Pydantic model with
all fields (icon, greeting, color, cycle_order, base_arguments, scoped_projects,
scoped_plans). Add PersonaPreset docs and effective_arguments() method.
Add txt export format to /session:export and CLI session export commands.
- docs/api/index.md: Add cleveragents.acms entry linking to reference/acms.md.
- docs/modules/uko-vocabulary-extensions.md: New module guide covering Layer 2
paradigm vocabularies (uko-oo, uko-func, uko-proc) and Layer 3 technology
vocabularies (uko-py, uko-ts, uko-rs, uko-java) with usage examples,
DetailLevelMap inheritance, and VocabularyRegistry API.
- mkdocs.yml: Add Module Guides nav section with shell-safety, uko-provenance,
and uko-vocabulary-extensions pages.
- Add docs/modules/context-hydration.md: documents the ACMS context
hydration pipeline (context_tier_hydrator) that fixes the empty
ContextTierService bug (#1028). Covers hydrate_tiers_from_project,
hydrate_tiers_for_plan, file listing strategies, limits, and
fragment metadata.
- Add docs/modules/git-worktree-sandbox.md: documents the
GitWorktreeSandbox class that isolates plan apply changes in a
dedicated git branch/worktree and merges back on commit (#4454).
Covers full lifecycle, error types, branch naming, and fallback
for non-git projects.
- Update docs/architecture.md: add Git Worktree Sandbox Apply section
and extend ACMS section with context hydration note.
- Update mkdocs.yml: add both new module pages to the Modules nav.
ISSUES CLOSED: #6841
- docs/reference/plan_cli.md: add note about legacy/v3 plan workflow
mixing being disallowed (introduced in v3.8.0, issue #1577)
- docs/reference/uko_runtime.md: document v3.8.0 provenance tracking
(sourceResource, validFrom, isCurrent on typed triples) and revision
chain for temporal queries across indexing runs (issue #891)
- docs/reference/decision_correction.md: add CorrectionAttemptRecord
section documenting the correction_attempts table, state lifecycle,
repository API, and usage examples (issue #920)
- docs/modules/uko-provenance.md: new module guide for UKO provenance
tracking covering purpose, how provenance is attached, revision chain
mechanics, query patterns, persistence format, BDD coverage, and gotchas
- Promote [Unreleased] CHANGELOG entries to [3.8.0] (2026-04-05)
- Add Shell Danger Detection section to docs/api/tui.md covering
ShellDangerLevel, DangerousPattern, ShellSafetyService, and
SafetyCheckResult with full API reference and usage examples
- Add InvariantService section to docs/api/core.md documenting
the new DI-registered singleton, its methods, and emitted events
- Update docs/architecture.md Plan Lifecycle section to document
invariant reconciliation as a phase transition gate
- Update README.md Highlights with shell danger detection, inline
permission questions, invariant reconciliation, UKO provenance
tracking, and JSON-RPC 2.0 A2A wire format
- Create docs/modules/shell-safety.md with full module guide
covering purpose, key classes, built-in patterns, custom pattern
registration, TUI integration, and testing guidance
ISSUES CLOSED: #1003#997#1391#1004#891#1501#1577#1941#2334
HAL9000
CleverAgents Bot
freemo