56 Commits

Author	SHA1	Message	Date
HAL9000	44652c216a	docs: add sandbox, correction, and invariant module guides ... Document lifecycle details, security warnings, and CLI usage for the new module guides so implementors have a single reference. ISSUES CLOSED: #4848	2026-06-16 18:18:18 -04:00
HAL9000	7f47ec85da	docs(milestones): split oversized milestone pages into sub-pages (PR #9957) ... Refactor Milestones documentation to address PR #9957 reviewer feedback: - Split v3.0.0.md (506 lines) into 3 sub-pages under milestones/v3.0.0/: - index.md — Overview, goals, feature table, architecture notes (87 lines) - cli-reference.md — Full CLI command reference (142 lines) - deep-dive.md — Sandbox, persistence, domain model internals (95 lines) - Split v3.1.0.md (682 lines) into 5 sub-pages under milestones/v3.1.0/: - index.md — Overview, goals, feature table, architecture notes (69 lines) - actor-yaml.md — Actor YAML format + Compiler/LangGraph integration (131 lines) - integration.md — MCP Adapter + Tool Router provider normalization (91 lines) - skills.md — Skill Registry + Validation Runner gates (127 lines) - quickstart.md — Common workflows and reference guide (66 lines) - Update mkdocs.yml navigation to reflect the new sub-page structure - Total: from 2 files at 506/682 lines to 9 files all under 150 lines ISSUES CLOSED: #9957	2026-06-04 01:49:54 -04:00
HAL9000	980fcabc48	docs: document ACP to A2A module rename and symbol standardization [AUTO-DOCS-8]	2026-06-03 22:51:33 -04:00
HAL9000	46fff75c1a	docs: add v3.2.0 and v3.3.0 feature documentation [AUTO-DOCS-2]	2026-06-03 15:56:46 -04:00
HAL9000	54fef4768c	docs: add quick start guide (PR #9245) ... Add docs/quickstart.md with end-to-end quick start guide covering prerequisites, installation, project creation, resource registration, plan/apply workflow, and troubleshooting. Update mkdocs.yml navigation to include Quick Start page and rename ADR-028 title to Skill/Tool Abstraction Definition. Update CHANGELOG.md with quick start guide entry. Closes #9245	2026-05-06 04:29:40 +00:00
HAL9000	988a169831	docs: add InvariantReconciliationActor API docs, devcontainer discovery module guide, and mkdocs nav ... - 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	2026-05-05 06:15:57 +00:00
HAL9000	dde71cf8e2	docs(milestone): split advanced-concepts and tui docs into sub-documents ... Split docs/advanced-concepts.md (554 lines) into four sub-documents under docs/advanced-concepts/ and docs/tui.md (634 lines) into four sub-documents under docs/tui/, each under the 500-line limit per CONTRIBUTING.md. Advanced Concepts sub-documents: - docs/advanced-concepts/index.md: Overview, context strategies, LLM backends - docs/advanced-concepts/resource-types.md: Resource types, A2A rename - docs/advanced-concepts/container-tools.md: Container tools, scope chain, budgets, safety - docs/advanced-concepts/e2e-tests-and-plugins.md: E2E tests, code review, plugins TUI sub-documents: - docs/tui/index.md: Overview, getting started, main screen layout - docs/tui/sidebar-and-personas.md: Sidebar states, persona system - docs/tui/input-and-sessions.md: Reference/command input, session management - docs/tui/configuration-and-integration.md: Config, key bindings, theme, integration Updated mkdocs.yml navigation to reflect new sub-document structure. Updated CONTRIBUTORS.md with contribution entry for PR #9903. ISSUES CLOSED: #10533	2026-05-03 01:11:03 +00:00
HAL9000	aca9ae8e0e	docs(showcase): Adding showcase to nox docs ... Add the docs/showcase/ directory to the mkdocs.yml nav so that the showcase examples are visible when running `nox -s serve-docs` or `nox -s docs`. The showcase section includes the overview index and four category subdirectories: CLI Tools, API Clients, Data Processing, and Testing Tools. ISSUES CLOSED: #10859	2026-05-02 21:56:42 +00:00
HAL9000	d7f03ee0a6	docs: add CHANGELOG.md and CONTRIBUTING.md to docs tree ... Add mirrored versions of root CHANGELOG.md and CONTRIBUTING.md to the docs tree. Add migration headers noting these are mirrors of the authoritative root files. Update mkdocs.yml navigation to include both new pages between FAQ and Reference.	2026-04-30 14:26:39 +00:00
HAL9000	4f2122cd9e	docs: add action module API reference, update CHANGELOG and nav ... - Add docs/api/action.md: full API reference for ActionConfigSchema and ActionArgumentSchema — field tables, factory methods, camelCase compat mapping, env-var interpolation, database integrity note, and complete YAML example - Update docs/api/index.md: add cleveragents.action entry to module index - Update mkdocs.yml: add 'Action Schema: api/action.md' to the API Reference nav - Update CHANGELOG.md [Unreleased] Fixed: document plan use UNIQUE constraint violation fix (#4174, #4197) - Clarify from_yaml_file ValueError semantics, document inputs_schema type as dict[str, Any] | None, and update A2A ASV benchmarks to pass method= requests after JSON-RPC migration ISSUES CLOSED: #7472	2026-04-26 09:39:17 +00:00
HAL9000	df863f169b	docs(api): add ACMS/UKO API reference and update nav ... Add comprehensive API documentation for the cleveragents.acms package, covering the four-layer UKO ontology hierarchy (Layer 0-3), all public types (VocabularyRegistry, ProvenanceInfo, UKOClass, UKOProperty, UKOVocabulary, Layer2Dependency, ParadigmVocabulary), detail level maps (DetailLevelMapBuilder, build_detail_level_map, build_effective_map, resolve_detail_level), and all Layer 3 language vocabulary types for Python, TypeScript, Rust, and Java. - Add docs/api/acms.md with full API reference and usage example - Update docs/api/index.md to include ACMS/UKO in the module index - Update mkdocs.yml nav to include the new ACMS/UKO page - Update CHANGELOG.md [Unreleased] with the documentation addition	2026-04-14 15:45:11 +00:00
HAL9000	48532de1cd	docs: add context hydration and git worktree sandbox module docs ... - 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	2026-04-12 16:42:19 +00:00
HAL9000	c76433f756	docs(tracking): document automation-tracking-manager centralization	2026-04-11 00:40:19 +00:00
clever-agent	d8a31527f3	feat(docs): create agent system specification ... - Adds a comprehensive specification for the autonomous agent system. - Details the intended behavior, interactions, and design of all agents. - Includes Kroki-based diagrams for workflows and interactions. - Serves as the source of truth for agent implementation.	2026-04-10 14:28:41 -04:00
HAL9000	a3762a4cc2	docs: add invariant-reconciliation module guide, extend automation tracking docs, update mkdocs nav ... docs: add invariant-reconciliation module guide, extend automation tracking docs, update mkdocs nav - Add docs/modules/invariant-reconciliation.md: module guide for InvariantReconciliationActor (v3.8.0) - Extend docs/development/automation-tracking.md: all 16 supervisors, centralized tracking manager - Update mkdocs.yml: add Modules nav section, Custom Sandbox Strategy to Development ISSUES CLOSED: #5700 Co-authored-by: CleverThis <hal9000@cleverthis.com> Co-committed-by: CleverThis <hal9000@cleverthis.com>	2026-04-09 09:22:43 +00:00
freemo	9d258d53fe	docs(mkdocs): add providers module to API Reference navigation ... Add cleveragents.providers to the mkdocs.yml nav under API Reference. The providers.md page existed but was not linked in the navigation, making it inaccessible from the documentation site. ISSUES CLOSED: #4940	2026-04-08 23:40:24 +00:00
freemo	a323f07783	feat: implement new automation tracking system for agent supervision ... Replace shared session state issue tracking with individual tracking issues per agent to reduce noise and improve searchability. **Agent Updates:** - session-persister: [AUTO-SESSION] prefix with cycle management - implementation-orchestrator: [AUTO-IMP-POOL] prefix for health reports - system-watchdog: [AUTO-WATCHDOG] prefix for system health - backlog-groomer: [AUTO-GROOMER] prefix + backup cleanup functionality - human-liaison: [AUTO-LIAISON] prefix for status updates **New Features:** - Standardized issue title format: [AUTO-<PREFIX>] <TYPE> (Cycle <N>) - Announcement format: [AUTO-<PREFIX>] Announce: <message> - Automatic cleanup to prevent issue accumulation - Required 'Automation Tracking' label for filtering - Validation script for format compliance **Documentation:** - Complete system documentation at docs/development/automation-tracking.md - Added to mkdocs.yml navigation - Validation script at scripts/validate_automation_tracking.py **Benefits:** - Reduced noise from shared tracking issue - Better searchability with agent-specific prefixes - Cleaner history per agent type - Easier debugging with focused issue threads - Automatic cleanup prevents accumulation Closes automation tracking system implementation requirements.	2026-04-08 21:28:46 +00:00
freemo	c14f2d0a54	docs(development): add system watchdog architecture and audit reference ... Document the ca-system-watchdog continuous monitoring agent: - All 12 audit descriptions with severity levels and detection patterns - Session introspection via OpenCode Server API (Audits 6, 11, 12) - Finding severity table and action dispatch table - Health reporting format and configuration parameters - Constraints and related documentation links Add System Watchdog entry to mkdocs.yml Development nav section. Covers commits 8c13e63c and 77427bd7 (system watchdog introduction and deep session introspection enhancement).	2026-04-05 02:41:16 +00:00
freemo	8c81f13758	fix(infra): resolve TLS handshake failure on git.dev.cleveragents.com ... The TLS handshake failure on git.dev.cleveragents.com was caused by the hostname being absent from the certificate's Subject Alternative Names (SANs), or by SNI virtual-host misconfiguration on the server side. This commit delivers the repository-side remediation: - scripts/check-tls-cert.py: New TLS certificate health-check script. Connects to a hostname, verifies the certificate's SANs include the target hostname, checks expiry, and reports errors/warnings. Accepts an injectable SSLContext for unit testing without real network access. Supports wildcard SAN matching and configurable expiry warning threshold. - docs/development/ops-runbook.md: New ops runbook documenting the full certificate renewal procedure (Let's Encrypt/certbot and manual CA), SNI misconfiguration diagnosis steps, expiry monitoring with cron, and recommended alert thresholds (30/14/7/0 days). - features/tls_certificate_check.feature: 14 Behave scenarios tagged @tdd_issue @tdd_issue_1543 covering: missing SAN detection, valid SAN acceptance, expired certificate detection, expiry warning threshold, TLS handshake errors, connection timeouts, connection refused, wildcard SAN matching, and _hostname_matches_san unit tests. - features/steps/tls_certificate_check_steps.py: Step definitions for the above feature, using unittest.mock to inject SSL contexts and socket connections so no real network calls are made. - mkdocs.yml: Added Ops Runbook to the Development section navigation. The actual server-side certificate renewal (adding git.dev.cleveragents.com as a SAN and reloading the web server) must be performed by the server administrator following the procedure in docs/development/ops-runbook.md. Closes #1543 ISSUES CLOSED: #1543	2026-04-02 23:59:37 +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
freemo	d5b122d4a3	Docs: Updated to A2A and integrating rest standard	2026-03-11 13:19:55 -04:00
freemo	e98c8e6c79	Docs: Added and revised server-client protocol details	2026-03-11 10:02:27 -04:00
freemo	82def1112b	docs(tui): promote TUI to top-level section and fix mkdocs nav warnings ... Restructure the TUI specification from a nested subsection under "Behavior > UI / Interaction Model" to a top-level "## TUI" section, giving it equal standing with Core Concepts, Behavior, Configuration, and Architecture. All headings within the TUI section are promoted one level (#### → ###, ##### → ####). Fix mkdocs build nav warnings by adding ADR-044/045/046 to the mkdocs.yml nav and registering three missing reference pages (acms_fusion, context_indexing, resource_type_inheritance) in the gen_ref_pages.py nav builder.	2026-03-11 00:39:57 -04:00
freemo	c2db74ba81	Docs: Restyled ADR pages	2026-03-10 12:38:35 -04:00
freemo	01a2a03e2e	Docs: Improved the navigation seperating out ToC from top nac bar	2026-03-10 12:38:35 -04:00
freemo	ccc1617adf	Docs: Updated daily timeline documentation	2026-03-02 00:02:42 -05:00
freemo	0a28ea6e80	Docs: updated nav bar	2026-02-27 22:43:28 -05:00
freemo	67b4ddf5f8	Docs: Removed implementation-notes and migrated that information as comments on tickets	2026-02-23 21:48:07 -05:00
freemo	b1bf2250fb	Docs: Switched back to using QOTO's kroki.	2026-02-23 20:17:18 -05:00
freemo	09c2567d60	docs: Moved the last elements from implementation plan to their respective locations and deleted the plan from the repo ... Refs: #408	2026-02-23 17:53:26 -05:00
freemo	fb7b20bd6b	docs: Moved the notes taken during implementation to its own document ... Refs: #408	2026-02-23 17:53:02 -05:00
freemo	69b99d49e6	docs: Moved the implementation timeline out to its own document ... Refs: #408	2026-02-23 17:52:59 -05:00
freemo	55f83771b9	Docs: Added gantt charts to Implementation Timeline section	2026-02-23 01:11:36 -05:00
freemo	e28f9a8597	Docs: Add resource DAG operational semantics, tool reachability, cross-mechanism coordination, container, and LSP resource type ADRs (036-040) ... - ADR-036: Resource DAG Operational Semantics (10 purposes, sandbox boundary algebra) - ADR-037: Tool Reachability and Access Projection (transitive reach, read/write routing) - ADR-038: Cross-Mechanism Sandbox Coordination (coherence, write-then-sync, lazy materialization) - ADR-039: Container and Execution Environment Resource Types (9 engine-agnostic types) - ADR-040: Language Server Protocol Resource Types (lsp-server, lsp-workspace, lsp-document) - Updated specification.md with 7 new subsections for operational semantics - Updated resource_dag.md reference doc with operational semantics section - Updated ADR-008, ADR-011, ADR-015, ADR-027 with cross-references - Resolved merge conflicts from cherry-pick renumbering (033-037 -> 036-040) - Fixed all stale display-text references across all files	2026-02-21 19:51:28 -05:00
freemo	571d476493	Docs: Added decision tree recording and other details to the doc along with related ADR	2026-02-21 18:04:07 -05:00
freemo	0265b8c712	Docs: Added JINJA2 details to docs	2026-02-20 15:57:21 +00:00
freemo	24b475dcec	Docs: Normalized ADRs	2026-02-18 00:09:51 -05:00
freemo	740e08b2a4	Docs: Updated ADRs and specification to include details about standards	2026-02-17 19:31:27 -05:00
Jeffrey Phillips Freeman	ee5f0376d7	Replaced hand written Reference section with one generated from docstrings	2026-02-16 23:40:33 -05:00
Jeffrey Phillips Freeman	339b7de700	Docs: Added ADRs and improved TOC handling	2026-02-16 22:11:01 -05:00
freemo	155a5d7819	Docs: Updated ADRs and referenced them from the specification	2026-02-16 18:53:06 -05:00
Jeff (CTO)	d98666651f	feat(cli): align action commands to spec ... - Enforce config-only 'action create --config <file>' (remove legacy inline flags: --name, --strategy-actor, --execution-actor, --definition-of-done, --arg) - Load config via ActionConfigSchema.from_yaml_file() then Action.from_config() with clear validation error surfacing - Remove 'action available' subcommand (no draft state; actions are available by default) - Add REGEX positional arg to 'action list' for name filtering - Add Short Name and Definition of Done summary to all CLI outputs - Add 'action list --namespace/-n' and '--state/-s' filters - Update existing tests to match new config-only create flow - Add features/action_cli_spec_alignment.feature (19 scenarios) - Add robot/action_cli_spec.robot smoke tests - Add benchmarks/action_cli_bench.py ASV benchmarks - Add docs/reference/action_cli.md	2026-02-14 12:16:39 -05:00
freemo	36b4ec2b8d	feat(domain): align plan model with spec	2026-02-12 22:58:15 -05:00
freemo	6c7a48e7dc	Docs: split out some sections from the specification	2026-02-12 14:04:10 -05:00
freemo	687bf6b6ec	Docs: using standard kroki server since ours appears to be down (or broken)	2026-02-12 13:41:26 -05:00
freemo	a4b56fa308	Docs: Cleaned up some minor issues like docs not being in nav	2026-02-12 11:08:54 -05:00
freemo	4363fbe7c4	Docs: moved implementation plan here	2026-02-12 00:23:19 -05:00
freemo	e842a218c4	Docs: Added lightbox for expanding diagrams and images to full size in the documentation	2026-02-09 16:19:35 -05:00
freemo	0d9eaa85cb	Docs: Added kroki support to documentation for diagrams	2026-02-09 16:14:09 -05:00