Commit Graph

603 Commits

Author SHA1 Message Date
freemo e54818d5cb feat: enhance UAT tester with automatic documentation generation
ci.yml / feat: enhance UAT tester with automatic documentation generation (push) Failing after 0s
Extend the UAT testing agents to capture successful test workflows and
automatically generate showcase documentation demonstrating real-world
usage of CleverAgents.

Key features added:
- Documentation generation when tests succeed end-to-end
- Intelligent duplicate detection to avoid redundant examples
- Categorization into cli-tools, api-clients, data-processing, testing-tools
- Automatic PR creation for new documentation examples
- Integration with existing UAT workflow without disruption

Documentation structure:
- New docs/showcase/ directory for real-world examples
- Category-specific subdirectories with README guides
- Example template for consistent formatting
- JSON index for tracking and duplicate detection

The UAT tester now serves dual purposes:
1. Finding bugs through comprehensive testing (existing behavior)
2. Generating high-quality documentation from successful test runs (new)

This enables the system to build its own showcase of capabilities while
performing regular quality assurance, providing valuable examples for
users and demonstrating the system's practical applications.
2026-04-06 00:12:06 +00:00
freemo 1f64a274e3 docs: document ACMS real retrieval logic and automatic checkpoint triggers
ci.yml / docs: document ACMS real retrieval logic and automatic checkpoint triggers (push) Failing after 0s
ci.yml / docs: document ACMS real retrieval logic and automatic checkpoint triggers (pull_request) Failing after 0s
- docs/reference/context_strategies.md: update Built-in Strategies table
  to document real retrieval logic for all 6 strategies (SimpleKeyword,
  SemanticEmbedding, BreadthDepthNavigator, ARCE, TemporalArchaeology,
  PlanDecisionContext); add note about v1 character-frequency embedding
  approximation; note SpecStrategyAdapter registration (#3500)
- docs/reference/checkpointing.md: add Automatic Checkpoint Triggers
  section documenting the 4 triggers (on_tool_write, on_tool_write_complete,
  on_subplan_spawn, on_error), configuration via core.checkpoints.auto_create_on,
  and wiring into ToolRunner/SubplanExecutionService/PlanExecutor (#3439)
2026-04-05 21:31:44 +00:00
freemo 194c830f98 fix(ci): resolve repository push failure in CI pipeline
ci.yml / fix(ci): resolve repository push failure in CI pipeline (push) Failing after 0s
Reviewed and APPROVED. Closes CI push failure issue.
2026-04-05 21:25:11 +00:00
freemo 9dec3ead1b docs(development): add system watchdog architecture and audit reference
CI / lint (push) Waiting to run
CI / typecheck (push) Waiting to run
CI / security (push) Waiting to run
CI / quality (push) Waiting to run
CI / unit_tests (push) Waiting to run
CI / integration_tests (push) Waiting to run
CI / e2e_tests (push) Waiting to run
CI / coverage (push) Blocked by required conditions
CI / benchmark-regression (push) Blocked by required conditions
CI / benchmark-publish (push) Waiting to run
CI / build (push) Waiting to run
CI / docker (push) Blocked by required conditions
CI / helm (push) Waiting to run
CI / status-check (push) Blocked by required conditions
Reviewed and APPROVED. Documentation-only PR.
2026-04-05 21:23:59 +00:00
freemo 96470f39dc docs: update specification — add agents plan errors command
CI / lint (push) Waiting to run
CI / typecheck (push) Waiting to run
CI / security (push) Waiting to run
CI / quality (push) Waiting to run
CI / unit_tests (push) Waiting to run
CI / integration_tests (push) Waiting to run
CI / e2e_tests (push) Waiting to run
CI / coverage (push) Blocked by required conditions
CI / benchmark-regression (push) Blocked by required conditions
CI / benchmark-publish (push) Waiting to run
CI / build (push) Waiting to run
CI / docker (push) Blocked by required conditions
CI / helm (push) Waiting to run
CI / status-check (push) Blocked by required conditions
Reviewed and APPROVED. Closes #2883.
2026-04-05 21:16:20 +00:00
freemo 997af9a90a docs: update session export panels and plan executor subplan wiring
CI / lint (push) Waiting to run
CI / typecheck (push) Waiting to run
CI / security (push) Waiting to run
CI / quality (push) Waiting to run
CI / unit_tests (push) Waiting to run
CI / integration_tests (push) Waiting to run
CI / e2e_tests (push) Waiting to run
CI / coverage (push) Blocked by required conditions
CI / benchmark-regression (push) Blocked by required conditions
CI / benchmark-publish (push) Waiting to run
CI / build (push) Waiting to run
CI / docker (push) Blocked by required conditions
CI / helm (push) Waiting to run
CI / status-check (push) Blocked by required conditions
Reviewed and APPROVED. Documentation-only PR.
2026-04-05 21:14:39 +00:00
freemo 24b34e6715 docs: update specification — fix invariant precedence chain (3-tier→4-tier) and document non_overridable flag
CI / lint (push) Waiting to run
CI / typecheck (push) Waiting to run
CI / security (push) Waiting to run
CI / quality (push) Waiting to run
CI / unit_tests (push) Waiting to run
CI / integration_tests (push) Waiting to run
CI / e2e_tests (push) Waiting to run
CI / coverage (push) Blocked by required conditions
CI / benchmark-regression (push) Blocked by required conditions
CI / benchmark-publish (push) Waiting to run
CI / build (push) Waiting to run
CI / docker (push) Blocked by required conditions
CI / helm (push) Waiting to run
CI / status-check (push) Blocked by required conditions
Reviewed and APPROVED. Closes #3064.
2026-04-05 21:12:59 +00:00
freemo ef557a31a9 fix(a2a): change A2aErrorDetail.code to int and map error constants to JSON-RPC 2.0 integer codes
CI / lint (push) Waiting to run
CI / typecheck (push) Waiting to run
CI / security (push) Waiting to run
CI / quality (push) Waiting to run
CI / unit_tests (push) Waiting to run
CI / integration_tests (push) Waiting to run
CI / e2e_tests (push) Waiting to run
CI / coverage (push) Blocked by required conditions
CI / benchmark-regression (push) Blocked by required conditions
CI / benchmark-publish (push) Waiting to run
CI / build (push) Waiting to run
CI / docker (push) Blocked by required conditions
CI / helm (push) Waiting to run
CI / status-check (push) Blocked by required conditions
Reviewed and APPROVED. Closes #2746.
2026-04-05 21:10:14 +00:00
freemo 3acfe45b7b docs: add providers API reference, update index/architecture/changelog
CI / lint (push) Waiting to run
CI / typecheck (push) Waiting to run
CI / security (push) Waiting to run
CI / quality (push) Waiting to run
CI / unit_tests (push) Waiting to run
CI / integration_tests (push) Waiting to run
CI / e2e_tests (push) Waiting to run
CI / coverage (push) Blocked by required conditions
CI / benchmark-regression (push) Blocked by required conditions
CI / benchmark-publish (push) Waiting to run
CI / build (push) Waiting to run
CI / docker (push) Blocked by required conditions
CI / helm (push) Waiting to run
CI / status-check (push) Blocked by required conditions
Reviewed and APPROVED. Documentation-only PR.
2026-04-05 21:09:47 +00:00
freemo ddc6fb7372 docs: update session export panels and plan executor subplan wiring
CI / lint (pull_request) Successful in 35s
CI / typecheck (pull_request) Successful in 49s
CI / quality (pull_request) Successful in 45s
CI / security (pull_request) Successful in 56s
CI / helm (pull_request) Successful in 26s
CI / build (pull_request) Successful in 32s
CI / unit_tests (pull_request) Failing after 7m5s
CI / docker (pull_request) Has been skipped
CI / e2e_tests (pull_request) Failing after 11m14s
CI / integration_tests (pull_request) Failing after 23m7s
CI / coverage (pull_request) Successful in 11m9s
CI / status-check (pull_request) Failing after 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 56m59s
- docs/reference/session_cli.md: add Rich output panels documentation
  for agents session export (Session Export, Contents, Integrity panels
  with example output); update success message to 'Export completed';
  add stdout export note and example (#3424)
- docs/reference/plan_execute.md: add Subplan Spawning section
  documenting SubplanService and SubplanExecutionService injection into
  PlanExecutor, execution flow (_spawn_subplans, _execute_subplans,
  _apply_subplan_results_to_plan), failure handling, and updated
  architecture diagram (#3561)
2026-04-05 21:09:42 +00:00
freemo 98994e8b84 docs(lsp): document LspLifecycleManager restart_server deadlock fix
CI / lint (push) Waiting to run
CI / typecheck (push) Waiting to run
CI / security (push) Waiting to run
CI / quality (push) Waiting to run
CI / unit_tests (push) Waiting to run
CI / integration_tests (push) Waiting to run
CI / e2e_tests (push) Waiting to run
CI / coverage (push) Blocked by required conditions
CI / benchmark-regression (push) Blocked by required conditions
CI / benchmark-publish (push) Waiting to run
CI / build (push) Waiting to run
CI / docker (push) Blocked by required conditions
CI / helm (push) Waiting to run
CI / status-check (push) Blocked by required conditions
Reviewed and APPROVED. Documentation-only PR.
2026-04-05 21:08:33 +00:00
freemo fd1c674e6d docs: shell safety API, invariant reconciliation architecture, new feature highlights
CI / lint (push) Waiting to run
CI / typecheck (push) Waiting to run
CI / security (push) Waiting to run
CI / quality (push) Waiting to run
CI / unit_tests (push) Waiting to run
CI / integration_tests (push) Waiting to run
CI / e2e_tests (push) Waiting to run
CI / coverage (push) Blocked by required conditions
CI / benchmark-regression (push) Blocked by required conditions
CI / benchmark-publish (push) Waiting to run
CI / build (push) Waiting to run
CI / docker (push) Blocked by required conditions
CI / helm (push) Waiting to run
CI / status-check (push) Blocked by required conditions
Reviewed and APPROVED. Documentation-only PR. Closes #3377.
2026-04-05 21:06:51 +00:00
freemo 9e74fceddc docs: update and extend documentation for v3.8.0 changes
CI / lint (push) Waiting to run
CI / typecheck (push) Waiting to run
CI / security (push) Waiting to run
CI / quality (push) Waiting to run
CI / unit_tests (push) Waiting to run
CI / integration_tests (push) Waiting to run
CI / e2e_tests (push) Waiting to run
CI / coverage (push) Blocked by required conditions
CI / benchmark-regression (push) Blocked by required conditions
CI / benchmark-publish (push) Waiting to run
CI / build (push) Waiting to run
CI / docker (push) Blocked by required conditions
CI / helm (push) Waiting to run
CI / status-check (push) Blocked by required conditions
Reviewed and APPROVED. Documentation-only PR.
2026-04-05 21:06:49 +00:00
freemo 4b4f7d3305 docs(timeline): update schedule adherence Day 95 cycle-2 (2026-04-05)
CI / lint (pull_request) Successful in 26s
CI / typecheck (pull_request) Successful in 50s
CI / quality (pull_request) Successful in 27s
CI / security (pull_request) Successful in 1m0s
CI / build (pull_request) Successful in 24s
CI / helm (pull_request) Successful in 24s
CI / unit_tests (pull_request) Failing after 7m10s
CI / docker (pull_request) Has been skipped
CI / coverage (pull_request) Successful in 11m17s
CI / e2e_tests (pull_request) Successful in 17m47s
CI / integration_tests (pull_request) Failing after 23m0s
CI / status-check (pull_request) Failing after 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 57m6s
Cycle-2 refresh with latest Forgejo data (30 min after initial update):
- Open bugs: 853 -> 878 (+25 new UAT bugs)
- Open PRs: 181 -> 183 (+2)
- M3: 61% (228/371) -> 61% (228/376) — total grew +5
- M4: 58% (104/179) -> 57% (104/183) — total grew +4
- M5: 66% (126/191) -> 64% (126/196) — total grew +5
- M6: 56% (180/323) -> 55% (180/325) — total grew +2
- M7: 42% (138/327) -> 41% (138/335) — total grew +8
- M8: 43% (359/830) -> 41% (359/880) — dramatic +50 new issues
- M9: 25% (118/464) -> 25% (118/465) — stable
- Updated all gantt charts, status summary, risk section, Day 95 entry
2026-04-05 20:41:43 +00:00
freemo d0254ba43a docs(timeline): update schedule adherence Day 95 (2026-04-05)
CI / benchmark-publish (pull_request) Waiting to run
CI / build (pull_request) Waiting to run
CI / lint (pull_request) Waiting to run
CI / typecheck (pull_request) Waiting to run
CI / security (pull_request) Waiting to run
CI / quality (pull_request) Waiting to run
CI / unit_tests (pull_request) Waiting to run
CI / docker (pull_request) Blocked by required conditions
CI / integration_tests (pull_request) Waiting to run
CI / e2e_tests (pull_request) Waiting to run
CI / coverage (pull_request) Blocked by required conditions
CI / benchmark-regression (pull_request) Blocked by required conditions
CI / helm (pull_request) Waiting to run
CI / status-check (pull_request) Blocked by required conditions
Updated Day 95 entry with latest Forgejo data:
- Open bugs: 866 -> 853 (13 resolved)
- Open PRs: 179 -> 181 (+2 new)
- M3: 62% (228/366) -> 61% (228/371) — total grew
- M4: 60% (104/174) -> 58% (104/179) — total grew
- M5: 67% (126/189) -> 66% (126/191) — total grew
- M6: 55% (178/323) -> 56% (180/323) — slight improvement
- M7: 41% (131/317) -> 42% (138/327) — slight improvement
- M8: 43% (350/822) -> 43% (359/830) — stable
- M9: 25% (117/462) -> 25% (118/464) — stable
- Updated gantt chart completion percentages and legend
- Updated current status summary and risk section
2026-04-05 20:07:01 +00:00
freemo a0ac30d5de docs: update and extend documentation for v3.8.0 changes
CI / lint (pull_request) Successful in 21s
CI / typecheck (pull_request) Successful in 52s
CI / security (pull_request) Successful in 55s
CI / quality (pull_request) Successful in 39s
CI / build (pull_request) Successful in 29s
CI / helm (pull_request) Successful in 23s
CI / unit_tests (pull_request) Failing after 6m49s
CI / docker (pull_request) Has been skipped
CI / e2e_tests (pull_request) Successful in 17m22s
CI / integration_tests (pull_request) Failing after 23m1s
CI / coverage (pull_request) Successful in 11m3s
CI / status-check (pull_request) Failing after 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 56m57s
- 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
2026-04-05 20:05:48 +00:00
freemo 01472648c9 docs(timeline): update schedule adherence Day 95 (2026-04-05)
CI / unit_tests (push) Waiting to run
CI / lint (push) Waiting to run
CI / typecheck (push) Waiting to run
CI / security (push) Waiting to run
CI / quality (push) Waiting to run
CI / integration_tests (push) Waiting to run
CI / e2e_tests (push) Waiting to run
CI / coverage (push) Blocked by required conditions
CI / benchmark-regression (push) Blocked by required conditions
CI / benchmark-publish (push) Waiting to run
CI / build (push) Waiting to run
CI / docker (push) Blocked by required conditions
CI / helm (push) Waiting to run
CI / status-check (push) Blocked by required conditions
2026-04-05 19:37:01 +00:00
freemo d72993d908 docs: add shell safety API, invariant reconciliation architecture, and new feature highlights
CI / lint (pull_request) Successful in 29s
CI / typecheck (pull_request) Successful in 50s
CI / security (pull_request) Successful in 1m3s
CI / quality (pull_request) Successful in 33s
CI / build (pull_request) Successful in 23s
CI / helm (pull_request) Successful in 24s
CI / unit_tests (pull_request) Failing after 7m12s
CI / docker (pull_request) Has been skipped
CI / e2e_tests (pull_request) Successful in 17m51s
CI / integration_tests (pull_request) Failing after 23m31s
CI / coverage (pull_request) Successful in 10m44s
CI / status-check (pull_request) Failing after 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 56m49s
- 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
CI / unit_tests (push) Waiting to run
CI / benchmark-publish (push) Waiting to run
CI / build (push) Waiting to run
CI / docker (push) Blocked by required conditions
CI / helm (push) Waiting to run
CI / status-check (push) Blocked by required conditions
CI / lint (push) Waiting to run
CI / typecheck (push) Waiting to run
CI / security (push) Waiting to run
CI / quality (push) Waiting to run
CI / integration_tests (push) Waiting to run
CI / e2e_tests (push) Waiting to run
CI / coverage (push) Blocked by required conditions
CI / benchmark-regression (push) Blocked by required conditions
- 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 a8f26cb691 docs(lsp): document LspLifecycleManager restart_server lock pattern fix (#3165)
CI / lint (pull_request) Successful in 21s
CI / typecheck (pull_request) Successful in 47s
CI / security (pull_request) Successful in 1m0s
CI / quality (pull_request) Successful in 32s
CI / build (pull_request) Successful in 23s
CI / helm (pull_request) Successful in 23s
CI / unit_tests (pull_request) Successful in 7m2s
CI / e2e_tests (pull_request) Successful in 18m12s
CI / integration_tests (pull_request) Failing after 22m57s
CI / docker (pull_request) Successful in 1m21s
CI / coverage (pull_request) Successful in 10m55s
CI / status-check (pull_request) Failing after 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 56m47s
2026-04-05 18:09:32 +00:00
freemo f5d244cd37 fix(a2a): change A2aErrorDetail.code to int and map error constants to JSON-RPC 2.0 integer codes
CI / lint (pull_request) Failing after 30s
CI / typecheck (pull_request) Successful in 51s
CI / quality (pull_request) Successful in 46s
CI / security (pull_request) Successful in 53s
CI / coverage (pull_request) Has been skipped
CI / helm (pull_request) Successful in 23s
CI / build (pull_request) Successful in 47s
CI / unit_tests (pull_request) Successful in 6m30s
CI / docker (pull_request) Has been skipped
CI / e2e_tests (pull_request) Successful in 18m51s
CI / integration_tests (pull_request) Successful in 23m20s
CI / status-check (pull_request) Failing after 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Has been skipped
Per JSON-RPC 2.0 specification (Section 5.1), error codes must be integers.
This commit fixes the protocol compliance defect where A2aErrorDetail.code
was typed as str and error constants were string literals.

Changes:
- src/cleveragents/a2a/models.py: Change A2aErrorDetail.code from str to int;
  update field_validator to only validate 'message' (code no longer needs
  non-empty string check; Pydantic enforces int type)
- src/cleveragents/a2a/errors.py: Change all error code constants from string
  literals to JSON-RPC 2.0 integer codes per docs/reference/a2a.md taxonomy:
    NOT_FOUND = -32001, AUTH_ERROR = -32002, FORBIDDEN = -32003,
    INVALID_STATE = -32004, PLAN_ERROR = -32008, CONFIGURATION_ERROR = -32009,
    VALIDATION_ERROR = -32602, INTERNAL_ERROR = -32603
  Update map_domain_error() return type from tuple[str, str] to tuple[int, str]
- features/steps/a2a_facade_steps.py: Update A2aErrorDetail construction to
  map symbolic string names to integer codes via _CODE_MAP
- features/steps/a2a_facade_wiring_steps.py: Update error code assertion to
  map symbolic names to integers for comparison
- features/steps/a2a_facade_coverage_boost_steps.py: Same as above
- features/steps/a2a_jsonrpc_wire_format_steps.py: Update all A2aErrorDetail
  constructions and JSON-RPC dict payloads to use integer codes
- robot/helper_a2a_facade_wiring.py: Update wired_error_mapping() to compare
  against integer codes
- robot/helper_a2a_jsonrpc_wire_format.py: Update response_error_wire_format()
  to use integer code -32001 instead of string 'NOT_FOUND'

Wire format now produces {"code": -32001, ...} instead of {"code": "NOT_FOUND", ...},
making it compliant with JSON-RPC 2.0 and interoperable with standards-conformant clients.

ISSUES CLOSED: #2746
2026-04-05 17:53:56 +00:00
freemo 1783f0a211 docs(timeline): update schedule adherence Day 95 final v3 (2026-04-05)
CI / benchmark-publish (push) Waiting to run
CI / lint (push) Successful in 25s
CI / quality (push) Successful in 45s
CI / build (push) Successful in 22s
CI / typecheck (push) Successful in 50s
CI / security (push) Successful in 51s
CI / benchmark-regression (push) Waiting to run
CI / helm (push) Successful in 45s
CI / unit_tests (push) Successful in 6m33s
CI / docker (push) Successful in 11s
CI / coverage (push) Successful in 10m44s
CI / lint (pull_request) Successful in 19s
CI / e2e_tests (push) Successful in 17m37s
CI / quality (pull_request) Successful in 32s
CI / typecheck (pull_request) Successful in 57s
CI / security (pull_request) Successful in 51s
CI / build (pull_request) Successful in 27s
CI / helm (pull_request) Successful in 26s
CI / integration_tests (push) Successful in 22m56s
CI / status-check (push) Waiting to run
CI / unit_tests (pull_request) Successful in 7m25s
CI / coverage (pull_request) Successful in 10m57s
CI / e2e_tests (pull_request) Successful in 18m14s
CI / integration_tests (pull_request) Successful in 23m26s
CI / docker (pull_request) Successful in 11s
CI / status-check (pull_request) Successful in 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 56m45s
Final Day 95 timeline update (v3) with current Forgejo data as of 2026-04-05.

Key Changes:
- Open PRs: 92 → 170 (+78 new PRs from agent-driven activity)
- Open bugs: 536 → 809 (+273 new bugs from UAT/bug-hunt agents)
- Total open issues: 1547
- Session tracker: updated to #3377
- Milestone completions updated (all declined due to agent-driven issue creation outpacing closures)
- Gantt chart footer, update log, and both legend blocks updated
- Current Status Summary, Schedule Risk Summary, and Day 95 adherence entry all updated with final data
- New UAT bugs noted: #3444 (TUI HelpPanelOverlay keybinding mismatch), #3445 (plan rollback Rich output format incomplete)

Supersedes PR #3419 (docs/timeline-day95-v2) which had intermediate data.

Co-authored-by: Jeffrey Phillips Freeman <the@jeffreyfreeman.me>
Co-committed-by: Jeffrey Phillips Freeman <the@jeffreyfreeman.me>
2026-04-05 17:29:50 +00:00
freemo bb97f87a31 docs(spec): fix invariant precedence chain (3-tier->4-tier) and document non_overridable flag
CI / lint (pull_request) Successful in 20s
CI / typecheck (pull_request) Successful in 48s
CI / quality (pull_request) Successful in 33s
CI / security (pull_request) Successful in 1m4s
CI / build (pull_request) Successful in 19s
CI / helm (pull_request) Successful in 23s
CI / unit_tests (pull_request) Successful in 6m32s
CI / e2e_tests (pull_request) Successful in 17m32s
CI / integration_tests (pull_request) Successful in 23m8s
CI / docker (pull_request) Successful in 1m41s
CI / coverage (pull_request) Successful in 10m28s
CI / status-check (pull_request) Successful in 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 57m40s
Approved proposal: #3064

Changes:
- Glossary (line 92): Fix 3-tier precedence claim to correct 4-tier chain
  (plan > action > project > global) and add non_overridable exception note
- Line 18980: Fix Invariant Reconciliation Actor step 5 precedence reference
- Line 18991: Fix Strategize phase invariant reconciliation precedence reference
- Lines 19601-19604: Update Precedence and conflict resolution section to include
  action tier as a distinct scope (not promoted to plan tier) and add
  non_overridable exception clause
- Line 19618: Fix invariant view calculation precedence reference
- Lines 19621+: Add Non-overridable global invariants documentation block

Rationale: The glossary and two Strategize-phase descriptions incorrectly stated
a 3-tier precedence chain (plan > project > global), contradicting ADR-016 which
defines a 4-tier chain (plan > action > project > global). The implementation in
actor/reconciliation.py and application/services/plan_lifecycle_service.py
correctly uses the 4-tier model. The non_overridable field on the Invariant domain
model was implemented but completely undocumented in the spec.
2026-04-05 08:27:30 +00:00
freemo a17848064d docs: add providers API reference, update index/architecture/changelog
CI / lint (pull_request) Successful in 40s
CI / typecheck (pull_request) Successful in 56s
CI / quality (pull_request) Successful in 32s
CI / security (pull_request) Successful in 58s
CI / build (pull_request) Successful in 23s
CI / helm (pull_request) Successful in 23s
CI / unit_tests (pull_request) Successful in 7m17s
CI / docker (pull_request) Successful in 11s
CI / e2e_tests (pull_request) Successful in 15m51s
CI / coverage (pull_request) Successful in 10m18s
CI / integration_tests (pull_request) Successful in 23m11s
CI / status-check (pull_request) Successful in 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 58m25s
- 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 119170c3ad docs(timeline): update schedule adherence Day 95 (2026-04-05)
CI / lint (pull_request) Successful in 21s
CI / quality (pull_request) Successful in 37s
CI / typecheck (pull_request) Successful in 54s
CI / security (pull_request) Successful in 1m2s
CI / build (pull_request) Successful in 17s
CI / helm (pull_request) Successful in 24s
CI / unit_tests (pull_request) Successful in 6m54s
CI / coverage (pull_request) Successful in 10m25s
CI / e2e_tests (pull_request) Successful in 16m25s
CI / docker (pull_request) Successful in 1m36s
CI / integration_tests (pull_request) Successful in 23m16s
CI / status-check (pull_request) Successful in 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 56m44s
2026-04-05 06:17:10 +00:00
freemo 325f63d050 docs: update specification — add agents plan errors command
CI / lint (pull_request) Successful in 27s
CI / quality (pull_request) Successful in 32s
CI / security (pull_request) Successful in 1m3s
CI / build (pull_request) Successful in 25s
CI / helm (pull_request) Successful in 24s
CI / typecheck (pull_request) Successful in 3m59s
CI / unit_tests (pull_request) Successful in 6m45s
CI / e2e_tests (pull_request) Successful in 17m47s
CI / coverage (pull_request) Successful in 10m44s
CI / docker (pull_request) Successful in 1m48s
CI / integration_tests (pull_request) Successful in 22m53s
CI / status-check (pull_request) Successful in 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 56m6s
Documents the agents plan errors CLI command in both the Command
Synopsis and Command Reference sections of the specification.

The command was already implemented in src/cleveragents/cli/commands/plan.py
and referenced in the TUI slash catalog but was absent from the CLI
documentation sections.

Changes:
- Command Synopsis: added 'agents plan errors <PLAN_ID>' after plan rollback
- Command Reference: added '##### agents plan errors' section with synopsis,
  purpose, arguments, and Rich/Plain/JSON output examples

Approved via proposal issue #2883.

ISSUES CLOSED: #2883
2026-04-05 04:08:40 +00:00
freemo c14f2d0a54 docs(development): add system watchdog architecture and audit reference
CI / typecheck (pull_request) Successful in 47s
CI / quality (pull_request) Successful in 34s
CI / security (pull_request) Successful in 58s
CI / lint (pull_request) Successful in 3m24s
CI / build (pull_request) Successful in 19s
CI / helm (pull_request) Successful in 23s
CI / unit_tests (pull_request) Successful in 6m34s
CI / docker (pull_request) Successful in 11s
CI / e2e_tests (pull_request) Successful in 17m49s
CI / coverage (pull_request) Successful in 11m9s
CI / integration_tests (pull_request) Successful in 22m29s
CI / status-check (pull_request) Successful in 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 56m7s
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 66c99db163 docs(timeline): update schedule adherence Day 95 (2026-04-05)
CI / typecheck (pull_request) Successful in 46s
CI / quality (pull_request) Successful in 34s
CI / security (pull_request) Successful in 57s
CI / lint (pull_request) Successful in 3m21s
CI / build (pull_request) Successful in 17s
CI / helm (pull_request) Successful in 23s
CI / unit_tests (pull_request) Successful in 6m27s
CI / docker (pull_request) Successful in 1m35s
CI / e2e_tests (pull_request) Successful in 17m39s
CI / integration_tests (pull_request) Successful in 22m36s
CI / coverage (pull_request) Successful in 13m45s
CI / status-check (pull_request) Successful in 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 55m43s
2026-04-05 02:40:40 +00:00
freemo 03334aaa3d docs(timeline): update schedule adherence Day 54 (2026-04-03)
CI / benchmark-publish (pull_request) Has been skipped
CI / quality (pull_request) Successful in 33s
CI / security (pull_request) Successful in 51s
CI / build (pull_request) Successful in 29s
CI / helm (pull_request) Successful in 37s
CI / lint (pull_request) Successful in 3m25s
CI / typecheck (pull_request) Successful in 4m4s
CI / unit_tests (pull_request) Failing after 7m12s
CI / docker (pull_request) Has been skipped
CI / e2e_tests (pull_request) Failing after 14m6s
CI / integration_tests (pull_request) Failing after 22m12s
CI / coverage (pull_request) Successful in 10m30s
CI / status-check (pull_request) Failing after 1s
CI / typecheck (push) Has been cancelled
CI / lint (push) Has been cancelled
CI / security (push) Has been cancelled
CI / status-check (push) Has been cancelled
CI / quality (push) Has been cancelled
CI / unit_tests (push) Has been cancelled
CI / integration_tests (push) Has been cancelled
CI / e2e_tests (push) Has been cancelled
CI / coverage (push) Has been cancelled
CI / benchmark-regression (push) Has been cancelled
CI / benchmark-publish (push) Has been cancelled
CI / build (push) Has been cancelled
CI / docker (push) Has been cancelled
CI / helm (push) Has been cancelled
CI / benchmark-regression (pull_request) Successful in 55m50s
2026-04-04 19:17:58 +00:00
freemo 5c0016c79d docs: add DomainBaseModel API reference and CI template DB changelog entry
CI / helm (push) Successful in 23s
CI / lint (push) Successful in 25s
CI / build (push) Successful in 28s
CI / quality (push) Successful in 3m41s
CI / typecheck (push) Successful in 3m56s
CI / security (push) Successful in 4m6s
CI / benchmark-regression (push) Has been skipped
CI / unit_tests (push) Failing after 6m19s
CI / docker (push) Has been skipped
CI / e2e_tests (push) Failing after 14m13s
CI / coverage (push) Successful in 10m24s
CI / integration_tests (push) Failing after 21m19s
CI / status-check (push) Failing after 2s
CI / benchmark-publish (push) Has been cancelled
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 c678fcdcc3 docs(spec): document inline PermissionQuestionWidget for single-file permission requests
CI / benchmark-publish (pull_request) Has been skipped
CI / lint (pull_request) Failing after 19s
CI / quality (pull_request) Successful in 44s
CI / security (pull_request) Successful in 50s
CI / build (pull_request) Successful in 24s
CI / helm (pull_request) Successful in 23s
CI / typecheck (pull_request) Successful in 4m1s
CI / coverage (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Has been skipped
CI / unit_tests (pull_request) Failing after 6m18s
CI / docker (pull_request) Has been skipped
CI / e2e_tests (pull_request) Failing after 15m42s
CI / integration_tests (pull_request) Failing after 21m39s
CI / status-check (pull_request) Failing after 1s
Add inline permission question widget section to TUI documentation in
docs/specification.md and update ADR-044 Prompt Architecture section to
distinguish between single-file (inline widget) and multi-file
(PermissionsScreen) permission request handling.

Changes:
- docs/specification.md: Add '### Inline Permission Question Widget' section
  documenting PermissionQuestionWidget, InlinePermissionQuestion domain model,
  PermissionRequestType enum, PermissionDecision enum, keyboard shortcuts,
  and routing logic (single-file vs multi-file)
- docs/adr/ADR-044-tui-architecture-and-framework.md: Update Prompt Architecture
  item 3 from QuestionWidget to PermissionQuestionWidget with inline rendering
  description; add QuestionWidget as item 4 for non-file-specific choices

Triggered by PR #2181 (docs(tui): document PermissionQuestionWidget).
Approved via proposal issue #2178.

ISSUES CLOSED: #2178
2026-04-03 19:03:04 +00:00
freemo dd17d0f8e6 docs(tui): add shell safety, permission question widget, and first-run docs
CI / lint (push) Has been cancelled
CI / typecheck (push) Has been cancelled
CI / security (push) Has been cancelled
CI / quality (push) Has been cancelled
CI / benchmark-publish (push) Has been cancelled
CI / unit_tests (push) Has been cancelled
CI / integration_tests (push) Has been cancelled
CI / e2e_tests (push) Has been cancelled
CI / build (push) Has been cancelled
CI / helm (push) Has been cancelled
CI / coverage (push) Has been cancelled
CI / docker (push) Has been cancelled
CI / status-check (push) Has been cancelled
CI / benchmark-regression (push) Has been cancelled
Add reference documentation for three new TUI features:

- docs/reference/tui_shell_safety.md: Full reference for the shell danger
  detection subsystem (DangerousPatternDetector, ShellDangerLevel,
  DangerousPattern, DangerousCommandWarning, DEFAULT_PATTERNS registry).
  Covers all built-in patterns across CRITICAL/HIGH/MEDIUM/LOW levels,
  usage examples, and custom pattern extension.

- docs/reference/tui_permission_question.md: Full reference for the inline
  PermissionQuestionWidget (issue #997). Documents InlinePermissionQuestion,
  PermissionRequestType, PermissionDecision, render_permission_question(),
  PermissionDecisionEvent, and PermissionQuestionWidget with key bindings
  and usage examples.

- docs/reference/tui.md: Extended with First-Run Experience section
  (ActorSelectionOverlay, first_run helpers), Inline Permission Questions
  section, shell danger detection note in Shell Mode, updated module table,
  and links to new reference pages.
2026-04-03 18:01:26 +00:00
freemo 744abb9d62 docs(timeline): update schedule adherence Day 54 (2026-04-03)
CI / benchmark-publish (pull_request) Has been skipped
CI / helm (pull_request) Successful in 30s
CI / build (pull_request) Successful in 3m18s
CI / lint (pull_request) Successful in 3m18s
CI / quality (pull_request) Successful in 3m54s
CI / typecheck (pull_request) Successful in 3m55s
CI / security (pull_request) Successful in 4m7s
CI / unit_tests (pull_request) Failing after 6m40s
CI / docker (pull_request) Has been skipped
CI / e2e_tests (pull_request) Failing after 17m24s
CI / coverage (pull_request) Successful in 14m6s
CI / integration_tests (pull_request) Failing after 22m7s
CI / status-check (pull_request) Failing after 1s
CI / benchmark-regression (pull_request) Successful in 55m55s
2026-04-03 17:23:55 +00:00
freemo d66887766f docs(tui): document PermissionQuestionWidget and add CHANGELOG entry
CI / lint (pull_request) Successful in 20s
CI / quality (pull_request) Successful in 54s
CI / typecheck (pull_request) Successful in 58s
CI / security (pull_request) Successful in 59s
CI / build (pull_request) Successful in 24s
CI / helm (pull_request) Successful in 30s
CI / benchmark-publish (pull_request) Has been skipped
CI / unit_tests (pull_request) Failing after 6m59s
CI / docker (pull_request) Has been skipped
CI / coverage (pull_request) Successful in 11m7s
CI / e2e_tests (pull_request) Failing after 16m35s
CI / integration_tests (pull_request) Failing after 21m56s
CI / status-check (pull_request) Failing after 1s
CI / benchmark-regression (pull_request) Successful in 54m46s
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
eugen.thaci f66fb5a19a docs(spec): align ASCII UI tables in specification and related pages
CI / lint (push) Failing after 35s
CI / quality (push) Successful in 40s
CI / typecheck (push) Failing after 48s
CI / security (push) Failing after 49s
CI / coverage (push) Has been skipped
CI / build (push) Successful in 20s
CI / helm (push) Successful in 34s
CI / benchmark-regression (push) Has been skipped
CI / unit_tests (push) Failing after 2m12s
CI / docker (push) Has been skipped
CI / e2e_tests (push) Failing after 15m52s
CI / integration_tests (push) Failing after 22m11s
CI / status-check (push) Failing after 1s
CI / benchmark-publish (push) Has been cancelled
Align Unicode box-drawing blocks and related tables in specification.md,
ADR-044/045/046, and reference pages for consistent MkDocs rendering.

ISSUES CLOSED: #1171
2026-04-03 04:55:21 +00:00
freemo 108d87e1bb docs: update CHANGELOG and A2A API docs for recent merged PRs
CI / lint (push) Failing after 35s
CI / build (push) Successful in 37s
CI / security (push) Failing after 48s
CI / typecheck (push) Failing after 50s
CI / quality (push) Successful in 55s
CI / coverage (push) Has been skipped
CI / helm (push) Successful in 27s
CI / unit_tests (push) Failing after 2m20s
CI / docker (push) Has been skipped
CI / e2e_tests (push) Failing after 15m33s
CI / integration_tests (push) Failing after 21m26s
CI / status-check (push) Failing after 1s
CI / benchmark-regression (push) Has been skipped
CI / benchmark-publish (push) Has been cancelled
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 70e2ce4386 Merge pull request 'fix(infra): resolve TLS handshake failure on git.dev.cleveragents.com' (#1865) from fix/infra-tls-handshake-failure-git-dev into master
CI / lint (push) Failing after 26s
CI / security (push) Failing after 53s
CI / typecheck (push) Failing after 1m8s
CI / helm (push) Successful in 36s
CI / build (push) Has been cancelled
CI / quality (push) Has been cancelled
CI / benchmark-publish (push) Has been cancelled
CI / integration_tests (push) Has been cancelled
CI / unit_tests (push) Has been cancelled
CI / e2e_tests (push) Has been cancelled
CI / docker (push) Has been cancelled
CI / status-check (push) Has been cancelled
CI / coverage (push) Has been cancelled
CI / benchmark-regression (push) Has been cancelled
2026-04-03 01:13:31 +00:00
freemo 72a9a17a67 docs(timeline): update schedule adherence Day 54 (2026-04-03)
CI / build (push) Successful in 19s
CI / lint (push) Failing after 20s
CI / helm (push) Successful in 23s
CI / quality (push) Successful in 33s
CI / typecheck (push) Failing after 49s
CI / security (push) Failing after 50s
CI / coverage (push) Has been skipped
CI / benchmark-regression (push) Has been skipped
CI / unit_tests (push) Failing after 1m47s
CI / docker (push) Has been skipped
CI / e2e_tests (push) Failing after 15m10s
CI / integration_tests (push) Failing after 20m56s
CI / status-check (push) Failing after 1s
CI / benchmark-publish (push) Has been cancelled
Day 54 morning update. No merges overnight. Agents created 100+ new issues.

Key changes:
- Appended Day 54 schedule adherence entry
- Updated today marker to 2026-04-03 in both gantt charts
- Open bugs: 35 → 50 (+15 new bugs from agents overnight)
- Open PRs: 79 → 84 (+5 new fix/CI branches)
- Open issues: 400 → 500 (+100 new from agents overnight)
- M3 (v3.2.0): 82% → 75% (212/281, milestone grew 256→281)
- M4 (v3.3.0): 79% → 78% (99/127, milestone grew 126→127)
- M5 (v3.4.0): 88% → 87% (126/145, milestone grew 143→145)
- M6 (v3.5.0): 77% → 71% (172/241, milestone grew 221→241)
- M7 (v3.6.0): 73% → 68% (120/177, milestone grew 164→177)
- M8 (v3.7.0): 36% → 29% (54/185, milestone grew 152→185)
- M9 (v3.8.0): 40% → 26% (64/242, milestone grew 160→242)
2026-04-03 00:33:20 +00:00
freemo 8c81f13758 fix(infra): resolve TLS handshake failure on git.dev.cleveragents.com
CI / benchmark-publish (pull_request) Has been skipped
CI / build (pull_request) Successful in 18s
CI / helm (pull_request) Successful in 24s
CI / lint (pull_request) Failing after 28s
CI / quality (pull_request) Successful in 35s
CI / security (pull_request) Failing after 48s
CI / typecheck (pull_request) Failing after 50s
CI / coverage (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Has been skipped
CI / unit_tests (pull_request) Failing after 1m46s
CI / docker (pull_request) Has been skipped
CI / e2e_tests (pull_request) Failing after 13m19s
CI / integration_tests (pull_request) Failing after 21m9s
CI / status-check (pull_request) Failing after 1s
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 ee1710dc3e docs(timeline): update schedule adherence Day 53 (2026-04-02) night refresh
CI / build (push) Successful in 17s
CI / helm (push) Successful in 23s
CI / lint (push) Failing after 25s
CI / security (push) Failing after 50s
CI / typecheck (push) Failing after 52s
CI / coverage (push) Has been skipped
CI / benchmark-regression (push) Has been skipped
CI / unit_tests (push) Failing after 2m5s
CI / docker (push) Has been skipped
CI / quality (push) Successful in 3m41s
CI / e2e_tests (push) Failing after 15m2s
CI / integration_tests (push) Failing after 21m53s
CI / status-check (push) Failing after 1s
CI / benchmark-publish (push) Has been cancelled
Night refresh after UAT/bug-hunt/CI agents created 50+ new issues.

Key changes:
- Open bugs: 6 → 35 (UAT/bug-hunt agents created 29 new bugs #1749-#1791)
- Open PRs: 74 → 79 (+5 new CI/security PRs)
- Open issues: 339 → 400 (+61 new from UAT/bug-hunt/CI agents)
- M3 (v3.2.0): 85% → 82% (211/256, milestone grew from 236→256)
- M4 (v3.3.0): 80% → 79% (99/126, milestone grew from 124→126)
- M5 (v3.4.0): 89% → 88% (126/143, milestone grew from 142→143)
- M6 (v3.5.0): 79% → 77% (171/221, milestone grew from 214→221)
- M7 (v3.6.0): 75% → 73% (120/164, milestone grew from 150→164)
- M8 (v3.7.0): 38% → 36% (55/152, milestone grew from 107→152)
- M9 (v3.8.0): 35% → 40% (64/160, milestone grew from 49→160)
- Critical: coverage at 37% (#1782), AmbiguousStep crash (#1791)
2026-04-02 23:57:25 +00:00
freemo 33f1978bd0 fix(ci): resolve repository push failure in CI pipeline
ci.yml / fix(ci): resolve repository push failure in CI pipeline (push) Failing after 0s
ci.yml / fix(ci): resolve repository push failure in CI pipeline (pull_request) Failing after 0s
Root cause: actions/checkout@v4 was not configured with explicit write
credentials (token + persist-credentials), and no git user identity
(user.name/user.email) was set. Both are required for any git push
operation in Forgejo Actions.

Changes:
- release.yml create-release job: add token: secrets.FORGEJO_TOKEN and
  fetch-depth: 0 to checkout; add 'Configure git identity for push
  operations' step using HTTPS credential store; add 'Smoke-test push
  access' step that validates write permission via Forgejo API before
  any push attempt
- ci.yml: add push-validation job that validates push credentials on
  every CI run using FORGEJO_TOKEN, including credential helper
  verification and API-based write permission check; add push-validation
  to status-check needs and result reporting
- docs/development/ci-cd.md: add FORGEJO_TOKEN, FORGEJO_URL, and
  CONTAINER_REGISTRY* secrets to the secrets table; add 'Repository
  Push Authentication' section documenting root cause, fix pattern,
  smoke-test step, setup instructions, and security notes; add
  push-validation to CI job dependency graph and quality gates table

Design decisions:
- HTTPS token authentication (not SSH deploy keys) -- simpler to manage
- ~/.git-credentials with chmod 600 for ephemeral, secure storage
- Smoke-test validates write permission via API before push attempts
- push-validation job is independent (no needs) -- runs in parallel
- No hardcoded credentials -- all secrets via Forgejo Secrets

ISSUES CLOSED: #1541
2026-04-02 23:54:52 +00:00
freemo f063bed3e6 docs(timeline): update schedule adherence Day 53 (2026-04-02)
CI / lint (push) Failing after 19s
CI / helm (push) Successful in 23s
CI / build (push) Successful in 27s
CI / quality (push) Successful in 34s
CI / security (push) Failing after 44s
CI / typecheck (push) Failing after 49s
CI / coverage (push) Has been skipped
CI / benchmark-regression (push) Has been skipped
CI / unit_tests (push) Failing after 1m48s
CI / docker (push) Has been skipped
CI / e2e_tests (push) Failing after 12m56s
CI / integration_tests (push) Failing after 20m57s
CI / status-check (push) Failing after 1s
CI / benchmark-publish (push) Has been cancelled
End-of-day refresh after CLI fix wave merged 18 PRs.

Key changes:
- Open bugs: 143 → 6 (massive CLI fix wave resolved 137 bugs)
- Open PRs: 68 → 74 (6 net new after CLI fix wave)
- Open issues: 342 → 339
- M6 (v3.5.0): 77% → 79% (168/214 closed)
- M8 (v3.7.0): 44% → 38% (41/107 closed, milestone grew from 81→107)
- M9 (v3.8.0): 40% → 35% (17/49 closed, milestone grew from 42→49)
- Added end-of-day CLI fix wave bullet to What Has Been Completed
- Updated all sections with end-of-day data
2026-04-02 23:16:27 +00:00
freemo 0382b2f722 docs: update changelog and CLI reference docs for 2026-04-02 merged PRs
CI / build (push) Successful in 18s
CI / lint (push) Failing after 18s
CI / helm (push) Successful in 23s
CI / quality (push) Successful in 35s
CI / typecheck (push) Failing after 45s
CI / coverage (push) Has been skipped
CI / benchmark-regression (push) Has been skipped
CI / security (push) Failing after 52s
CI / unit_tests (push) Failing after 1m50s
CI / docker (push) Has been skipped
CI / benchmark-publish (push) Has been cancelled
CI / integration_tests (push) Has been cancelled
CI / e2e_tests (push) Has been cancelled
CI / status-check (push) Has been cancelled
- CHANGELOG: add Fixed entries for PRs #1574, #1570, #1569, #1547, #1548,
  #1522, #1524, #1525, #1520, #1553 covering rich output panels for session,
  actor, and plan commands, plus version commit SHA and provider fix
- docs/reference/session_cli.md: document new rich output panels for
  session create (Settings, Actor Details), session list (Name column,
  Summary panel), session show (Automation field), session delete
  (Deletion Summary, Cleanup panels); update export to document --format md
- docs/reference/actor_cli.md: document new rich output panels for
  actor remove (Actor Removed, Impact, Cleanup) and actor list (Summary panel)
- docs/reference/plan_cli.md: document new rich output for plan list
  (Elapsed column, Filters panel, Summary panel)
- docs/reference/cli_system_commands.md: document commit SHA resolution
  order (CLEVERAGENTS_COMMIT env var → git rev-parse → 'unknown')

ISSUES CLOSED: #1574 #1570 #1569 #1547 #1548 #1522 #1524 #1525 #1520 #1553
2026-04-02 23:06:12 +00:00
freemo 48cdcb6ea7 docs(spec): remove optional parentheses from required --config flags in command synopsis (#1573)
CI / lint (push) Failing after 17s
CI / helm (push) Successful in 23s
CI / build (push) Successful in 28s
CI / typecheck (push) Failing after 52s
CI / coverage (push) Has been skipped
CI / benchmark-regression (push) Has been skipped
CI / security (push) Failing after 1m1s
CI / unit_tests (push) Failing after 1m49s
CI / docker (push) Has been skipped
CI / benchmark-publish (push) Has been cancelled
CI / e2e_tests (push) Has been cancelled
CI / integration_tests (push) Has been cancelled
CI / quality (push) Has been cancelled
CI / status-check (push) Has been cancelled
Co-authored-by: Jeffrey Phillips Freeman <the@jeffreyfreeman.me>
Co-committed-by: Jeffrey Phillips Freeman <the@jeffreyfreeman.me>
2026-04-02 22:00:58 +00:00
freemo 71ce95fdf6 docs(specification): reorder command synopsis to separate validation commands (#1552)
CI / build (push) Successful in 17s
CI / lint (push) Failing after 19s
CI / helm (push) Successful in 23s
CI / typecheck (push) Failing after 50s
CI / security (push) Failing after 50s
CI / coverage (push) Has been skipped
CI / benchmark-regression (push) Has been skipped
CI / unit_tests (push) Failing after 1m46s
CI / docker (push) Has been skipped
CI / quality (push) Successful in 3m43s
CI / benchmark-publish (push) Has been cancelled
CI / e2e_tests (push) Has been cancelled
CI / integration_tests (push) Has been cancelled
CI / status-check (push) Has been cancelled
Implements issue #1552. Reorders the command synopsis in the specification to logically group validation commands separately from regular commands for better clarity.

Co-authored-by: Jeffrey Phillips Freeman <the@jeffreyfreeman.me>
Co-committed-by: Jeffrey Phillips Freeman <the@jeffreyfreeman.me>
2026-04-02 21:30:26 +00:00
freemo d318d92d1f docs(timeline): update schedule adherence Day 53 (2026-04-02)
CI / build (push) Successful in 17s
CI / lint (push) Failing after 17s
CI / helm (push) Successful in 30s
CI / typecheck (push) Failing after 49s
CI / coverage (push) Has been skipped
CI / benchmark-regression (push) Has been skipped
CI / security (push) Failing after 1m7s
CI / unit_tests (push) Failing after 1m51s
CI / docker (push) Has been skipped
CI / quality (push) Successful in 3m52s
CI / e2e_tests (push) Failing after 14m39s
CI / benchmark-publish (push) Has been cancelled
CI / integration_tests (push) Has been cancelled
CI / status-check (push) Has been cancelled
Late-day refresh: Open PRs 50→68 (+18 new fix PRs for UAT findings),
open issues 362→342 (-20 closed), open bugs 155→143 (-12 fixed).
Milestones: M3 85% (197/231), M4 80% (99/124), M5 89% (126/142),
M6 77% (165/214), M7 75% (112/149), M8 44% (36/81), M9 40% (17/42).
Recent merges: #1498 (tool add YAML), #1481 (session checksum),
#1479 (TUI CSS), #1338 (persona export/import).
2026-04-02 20:54:36 +00:00
freemo c81afea06b docs(timeline): update schedule adherence Day 53 (2026-04-02)
CI / lint (push) Failing after 17s
CI / build (push) Successful in 17s
CI / helm (push) Successful in 32s
CI / security (push) Failing after 47s
CI / typecheck (push) Failing after 53s
CI / coverage (push) Has been skipped
CI / benchmark-regression (push) Has been skipped
CI / unit_tests (push) Failing after 1m57s
CI / docker (push) Has been skipped
CI / quality (push) Successful in 3m58s
CI / e2e_tests (push) Failing after 15m25s
CI / integration_tests (push) Failing after 21m12s
CI / status-check (push) Failing after 1s
CI / benchmark-publish (push) Has been cancelled
End-of-day refresh: UAT supervisor fleet (cycles 11-131) discovered 100+
spec compliance bugs, surging open bug count from 50 to 155. M8 (v3.7.0)
net regression from 60% to 55% (36/65) due to 29 new UAT issues. Updated
milestone completion rates, gantt chart legend, risk register, current
status summary, and schedule adherence entry with end-of-day data.

Key changes:
- Open bugs: 50 → 155 (+105 UAT discoveries)
- Open PRs: 47 → 50 (+3 new UAT/bug PRs)
- Open issues: 289 → 362 (+73 new UAT/refactor/bug issues)
- M3 83% (190/227), M4 77% (89/115), M5 88% (126/143)
- M6 78% (165/211), M7 75% (114/152), M8 55% (36/65), M9 42% (17/40)
2026-04-02 19:50:26 +00:00
freemo 71177c6e1a docs: update changelog, API docs, and architecture for 2026-04-02 merged PRs
CI / lint (push) Failing after 18s
CI / build (push) Successful in 18s
CI / helm (push) Successful in 29s
CI / quality (push) Successful in 37s
CI / security (push) Failing after 52s
CI / typecheck (push) Failing after 58s
CI / coverage (push) Has been skipped
CI / benchmark-regression (push) Has been skipped
CI / unit_tests (push) Failing after 1m58s
CI / docker (push) Has been skipped
CI / benchmark-publish (push) Has been cancelled
CI / e2e_tests (push) Has been cancelled
CI / integration_tests (push) Has been cancelled
CI / status-check (push) Has been cancelled
- 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 48cff5cfe0 refactor(cli): rename plan lifecycle-list and lifecycle-apply to match specification
CI / build (push) Successful in 18s
CI / lint (push) Failing after 31s
CI / helm (push) Successful in 33s
CI / typecheck (push) Successful in 50s
CI / security (push) Failing after 51s
CI / coverage (push) Has been skipped
CI / benchmark-regression (push) Has been skipped
CI / unit_tests (push) Failing after 1m50s
CI / docker (push) Has been skipped
CI / quality (push) Successful in 3m43s
CI / integration_tests (push) Has been cancelled
CI / e2e_tests (push) Has been cancelled
CI / benchmark-publish (push) Has been cancelled
CI / status-check (push) Has been cancelled
Renames `plan lifecycle-list` to `plan list` and `plan lifecycle-apply` to `plan apply` to align with the specification's canonical command names. Removes legacy V2 plan commands that occupied those names.

- Renamed CLI command registrations from lifecycle-list/lifecycle-apply to list/apply
- Removed legacy V2 apply and list commands (~200 lines)
- Updated apply shortcut in main.py to delegate to v3 lifecycle
- Added defensive null check for plan existence in apply command
- Updated 63+ test, doc, and benchmark files for consistency

Closes #881

Co-authored-by: Jeffrey Phillips Freeman <the@jeffreyfreeman.me>
Co-committed-by: Jeffrey Phillips Freeman <the@jeffreyfreeman.me>
2026-04-02 19:09:04 +00:00
arch-guard 136c27a337 docs(timeline): update schedule adherence Day 53 (2026-04-02)
CI / lint (push) Failing after 19s
CI / helm (push) Successful in 23s
CI / build (push) Successful in 24s
CI / quality (push) Successful in 32s
CI / typecheck (push) Successful in 46s
CI / coverage (push) Has been skipped
CI / benchmark-regression (push) Has been skipped
CI / security (push) Failing after 58s
CI / unit_tests (push) Failing after 1m45s
CI / docker (push) Has been skipped
CI / benchmark-publish (push) Has been cancelled
CI / integration_tests (push) Has been cancelled
CI / e2e_tests (push) Has been cancelled
CI / status-check (push) Has been cancelled
Mid-day refresh: 47 open PRs (+2), 289 open issues (+15 new UAT/refactor
issues in v3.7.0 backlog). v3.5.0 advanced to 78% (164/209, +2 closed).
v3.7.0 at 60% (36/60, +1 new issue). 50 open bugs stable.

Updated sections: Gantt chart update log, footer, risk register legend,
Current Status Summary, What Remains To Be Done, Day 53 schedule adherence
entry (task inventory with per-developer breakdown).
2026-04-02 19:04:05 +00:00