38 Commits

Author	SHA1	Message	Date
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
freemo	95851ff1a6	Docs: Refined skill and tool idea, improved CLI slightly, and made the table of contents more UI rich	2026-02-09 15:51:44 -05:00
freemo	b1a41a2b6f	Docs: fixed formatting issues	2026-02-08 16:57:21 -05:00
freemo	684996eea9	Docs: moved specification over to the MkDocs for better rendering	2026-02-08 14:33:43 -05:00
freemo	f74688e5f9	Refactored the boilerplate code to CleverAgents	2025-11-01 19:04:29 -04:00
freemo	b941ef9a1a	Significantly revamped the base project to use more robust static checking including benchmarks and integration test support	2025-10-31 16:18:53 -04:00
freemo	f7a5d26c41	Modernized build tooling	2025-08-01 18:38:09 -04:00