- docs/api/actor.md: Add InvariantReconciliationActor section documenting
the built-in reconciliation actor introduced in v3.8.0, including the
reconciliation algorithm, ReconciliationResult/ConflictRecord/ScopeInvariants
data classes, standalone reconcile_invariants() function, DI registration,
and failure behaviour.
- docs/modules/devcontainer-discovery.md: New module guide for the
devcontainer auto-discovery system (v3.8.0 fix#2615), covering
DevcontainerDiscoveryResult, discover_devcontainers(), is_trigger_type(),
monorepo named-config support, and gotchas.
- mkdocs.yml: Add 'Devcontainer Auto-Discovery' to the Modules nav section,
alongside shell-safety, uko-provenance, invariant-reconciliation,
context-hydration, and git-worktree-sandbox module docs.
- robot/coverage_threshold.robot: Add tdd_issue and tdd_issue_4305 tags
to the Noxfile Contains Coverage Threshold Constant test case.
ISSUES CLOSED: #4485
- 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
HAL9000
freemo