9 Commits

Author	SHA1	Message	Date
freemo	3acfe45b7b	docs: add providers API reference, update index/architecture/changelog ... Reviewed and APPROVED. Documentation-only PR.	2026-04-05 21:09:47 +00:00
freemo	d72993d908	docs: add shell safety API, invariant reconciliation architecture, and new feature highlights ... - docs/api/tui.md: Document ShellDangerLevel, DangerousPattern, DEFAULT_PATTERNS, DangerousPatternDetector, ShellSafetyService, and SafetyCheckResult with full API reference, parameter tables, and usage examples - docs/architecture.md: Add Invariant Reconciliation section covering the builtin/invariant-reconciliation actor, four-scope algorithm, failure behaviour, and DI registration - README.md: Add Invariant Reconciliation, TUI shell danger detection, and UKO provenance tracking to the Highlights section ISSUES CLOSED: #3377	2026-04-05 19:36:58 +00:00
freemo	f1ab5d90dc	docs: update documentation for v3.8.0 unreleased features ... - 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	2026-04-05 19:33:19 +00:00
freemo	a17848064d	docs: add providers API reference, update index/architecture/changelog ... - docs/api/providers.md: new comprehensive API reference for cleveragents.providers — ProviderRegistry, ProviderType, ProviderCapabilities, ProviderInfo, LangChainChatProvider, module-level helpers, environment variables, and ASV benchmarks - docs/api/index.md: add providers module to module index table - docs/architecture.md: add Provider Registry section with discovery, selection, and factory usage examples - CHANGELOG.md: add [Unreleased] entries for: - agents plan list --namespace/-n option (#2616) - ASV benchmark suite for providers module (#3022) - MCP error extraction from content[0].text per MCP 1.4.0 (#2600) - CI quality gates restored to passing on master (#2629)	2026-04-05 07:03:54 +00:00
freemo	5c0016c79d	docs: add DomainBaseModel API reference and CI template DB changelog entry ... Add DomainBaseModel section to docs/api/core.md documenting the shared Pydantic base class from PR #2014 (issue #1941), and add CHANGELOG entry for the CI template DB extension from PR #2399 (issue #2334). ISSUES CLOSED: #1941 Co-authored-by: Jeffrey Phillips Freeman <jeffrey.freeman@cleverthis.com> Co-committed-by: Jeffrey Phillips Freeman <jeffrey.freeman@cleverthis.com>	2026-04-03 20:41:23 +00:00
freemo	d66887766f	docs(tui): document PermissionQuestionWidget and add CHANGELOG entry ... Add PermissionQuestionWidget API documentation to docs/api/tui.md including method table, key bindings, PermissionDecisionEvent dataclass, and render_permission_question() helper reference. Add corresponding CHANGELOG entry under [Unreleased] Added section. Refs: #997	2026-04-03 06:39:51 +00:00
freemo	108d87e1bb	docs: update CHANGELOG and A2A API docs for recent merged PRs ... Add CHANGELOG [Unreleased] entries for 6 recently merged commits: - feat(tui): shell danger detection patterns (#1003) - fix(a2a): JSON-RPC 2.0 wire format compliance — BREAKING field rename (#1501) - fix(cli): disallow mixing legacy and v3 plan workflows (#1577) - fix(cli): actor add rich output missing panels - fix(infra): E2E suite centralized database initialization (#1023) - ci(pipeline): parallelized static analysis jobs Update docs/api/a2a.md to reflect JSON-RPC 2.0 field name changes: A2aRequest.operation → method, A2aResponse.data → result, etc.	2026-04-03 02:43:00 +00:00
freemo	71177c6e1a	docs: update changelog, API docs, and architecture for 2026-04-02 merged PRs ... - CHANGELOG: add [Unreleased] entries for TUI first-run experience (#1391), session Markdown export (#1004), and UKO provenance/temporal versioning (#891) - README: add first-run experience and Markdown transcript export bullets - docs/api/tui.md: new TUI API reference covering first-run, persona system, input routing, slash commands, session export/import, and widgets - docs/api/index.md: add TUI entry to module index - docs/api/resource.md: document DatabaseResourceHandler and DevcontainerHandler full protocol implementations with method tables and examples - docs/architecture.md: expand UKO section with provenance/temporal versioning details; update TUI design decision summary - mkdocs.yml: add TUI page to API Reference nav ISSUES CLOSED: #1391 #1004 #891	2026-04-02 19:30:53 +00:00
freemo	e9c96c3d0c	docs: add API reference and architecture overview ... Add docs/api/ with per-module API documentation for core, a2a, actor, skills, tool, mcp, resource, and config packages. Add docs/architecture.md with a developer-oriented system overview including component map, layer diagram, plan lifecycle, and key design decisions. Update mkdocs.yml nav to expose both new sections. ISSUES CLOSED: #N/A	2026-04-02 19:02:53 +00:00