cleveragents/cleveragents-core
4
0
Fork 3
Code Issues 6.0k Pull Requests 115 Actions Packages Projects Releases Wiki Activity

docs: update documentation for v3.8.0 unreleased features
CI / unit_tests (push) Waiting to run
Details
CI / benchmark-publish (push) Waiting to run
Details
CI / build (push) Waiting to run
Details
CI / docker (push) Blocked by required conditions
Details
CI / helm (push) Waiting to run
Details
CI / status-check (push) Blocked by required conditions
Details
CI / lint (push) Waiting to run
Details
CI / typecheck (push) Waiting to run
Details
CI / security (push) Waiting to run
Details
CI / quality (push) Waiting to run
Details
CI / integration_tests (push) Waiting to run
Details
CI / e2e_tests (push) Waiting to run
Details
CI / coverage (push) Blocked by required conditions
Details
CI / benchmark-regression (push) Blocked by required conditions
Details

Browse Source 
- 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
This commit is contained in:
Jeffrey Phillips Freeman
2026-04-05 19:33:19 +00:00
parent 88cfc33ab2
commit f1ab5d90dc
6 changed files with 330 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+11
View File
@@ -30,6 +30,17 @@ embracing modern Python tooling.
PostgreSQL, MySQL, and DuckDB resources
- **Estimation lifecycle** — `actor.default.estimation` config key wires an estimation
actor into the Strategize-to-Estimate lifecycle hook
- **Shell danger detection** — TUI shell mode (`!` prefix) classifies commands by danger
level (LOW → CRITICAL) and surfaces a warning overlay before executing destructive,
privilege-escalating, or exfiltration-risk commands
- **Inline permission questions** — `PermissionQuestionWidget` renders single-file
permission requests directly in the conversation stream with single-key shortcuts
- **Invariant reconciliation** — `InvariantReconciliationActor` runs automatically at
every plan phase transition; failures block the transition and emit `INVARIANT_VIOLATED`
- **UKO provenance tracking** — every typed triple now carries `sourceResource`,
`validFrom`, and `isCurrent` metadata; a revision chain enables temporal queries
- **JSON-RPC 2.0 A2A wire format** — `A2aRequest`/`A2aResponse` fields renamed to
standard JSON-RPC 2.0 names (`method`, `id`, `result`, `error`)
- Fast Typer/Click-based interface with parity for help/version behavior
- Behavior-driven coverage via Behave and Robot Framework
- Nox automation for linting, typing, testing, docs, builds, and benchmarks