581 Commits

Author	SHA1	Message	Date
HAL9000	7ece6f1530	docs(spec): rename checkpoint triggers on_tool_write → before/after_tool_execute ... Update the Automatic Checkpoint Triggers table and configuration reference in docs/specification.md to use the trigger names that match the actual implementation in ToolRunner and config_service.py: - on_tool_write → before_tool_execute - on_tool_write_complete → after_tool_execute The implementation (PR #3474) chose before_/after_ prefix pattern for consistency with event naming conventions and because _execute is more precise than _write. The spec was not updated at that time. ISSUES CLOSED: #4745	2026-04-30 17:48:19 +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	0ade2526eb	docs(cli): update agents validation attach synopsis to use --key value named option format ... Update docs/specification.md to clarify that agents validation attach extra arguments use --key value named option format (not positional [<ARGS>...] format). Updates synopsis, argument description, and all inline references across the specification. ISSUES CLOSED: #4747	2026-04-29 17:08:17 +00:00
HAL9000	ab15eec673	docs(showcase): add audit log and security commands example to registry ... Register the existing audit-log-and-security.md example in the showcase registry (examples.json) so it appears alongside other CLI tool examples. Includes 17 audit commands covering list, show, count, and prune operations with all filter options. Closes #10824	2026-04-28 20:47:15 +00:00
HAL9000	ba53d2723b	docs(timeline): update schedule adherence Day 99 (2026-04-09)	2026-04-28 11:02:38 +00:00
HAL9000	98bc7c6b5d	docs(spec): align checkpoint trigger names and config key path with implementation ... - Update trigger names from 'on_tool_write' and 'on_tool_write_complete' to 'before_tool_execute' and 'after_tool_execute' to match the actual implementation in config_service.py - Correct config key path from 'core.checkpoints.auto_create_on' to 'checkpoints.auto_create_on' to match the actual configuration structure - Update TOML configuration examples to use comma-separated string format instead of array format, matching the actual ConfigService implementation - Update references to trigger names in the CLI Usage section to use the correct names	2026-04-28 08:20:42 +00:00
HAL9000	581dff6b43	spec(acms): add comprehensive ACMS v1 specification section (v3.4.0) ... Adds a comprehensive ACMS v1 (Advanced Context Management System) specification section covering all aspects of the context management architecture for milestone v3.4.0 — ACMS v1 + Context Scaling. Sections included: - Overview and design goals - Architecture: UKO (Unified Knowledge Ontology), CRP (Context Request Protocol), Context Pipeline, Storage Tiers (hot/warm/cold) - Module Definitions across all 4 architecture layers (Domain, Application, Infrastructure, Presentation) - Data Models: ContextFragment, ContextBudget, ProjectContextPolicy, ContextView, AssembledContext/ContextPayload, IndexMetadata - Key Interfaces: ACMSPipeline, ContextBudgetEnforcer, UKOStore, ContextTierService, RepoIndexingService - 10-Component Pipeline Architecture (3 phases: Strategy Orchestration, Fragment Fusion, Context Finalization) - Context Strategies: 6 built-in strategies with fallback degradation path - CLI Commands: agents context list/add/show/clear and agents project context set/show/inspect/simulate - Integration Points: Plan Lifecycle, Resource System, Actor/Agent, Configuration, DI Container - Database Schema: repo_indexes and indexed_files tables - v1 Known Limitations with planned conformance path - Acceptance Criteria for milestone v3.4.0 Replaces stuck [AUTO-ARCH-19] worker from Cycle 26. [AUTO-ARCH-20] Cycle 27 # Conflicts: # docs/specification.md	2026-04-26 18:45:44 +00:00
HAL9000	3975ad244c	docs(spec): fix invariant reconciliation, add ACMS thread safety, v3.6.0 section, ADR-049 ... - Fix invariant glossary entry: reconciliation now documented as occurring at each phase boundary (before Strategize, Execute, Apply, and after Apply) rather than only at start of Strategize (closes #9899) - Add Multi-Phase Invariant Enforcement note to Plan Lifecycle section - Add ACMS Thread Safety subsection documenting threading.RLock concurrency contract for ContextAssemblyPipeline and all context stores (closes #9859) - Append M7: Advanced Concepts and Deferred Features (v3.6.0) milestone spec section covering advanced invariant lifecycle, ACMS observability, plan hierarchy enhancements, and CLI communication pattern migration - Add ADR-049: CLI Communication Pattern documenting local CLI exemption from A2A boundary requirement and M9 migration path	2026-04-26 17:09:22 +00:00
HAL9000	0f0efe02e3	docs: update examples.json index with actor management workflow entry ... ISSUES CLOSED: #7539	2026-04-26 16:52:36 +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	663a6d2397	docs(decomposition): enhance docstrings and add spec section for selective subtree recomputation	2026-04-24 08:26:59 +00:00
HAL9000	dddfa48eb4	docs(spec): extend diagnostics example to cover all providers ... - update agents diagnostics examples to show all provider checks across rich, plain, JSON, and YAML formats - refresh error scenario samples to reflect the expanded provider coverage and recommendation counts - align CLI diagnostics output with the spec by adding explicit provider display names and consistent ordering Closes #5320	2026-04-24 03:51:32 +00:00
HAL9000	afc17b22c5	feat(architecture-pool-supervisor): add milestone assignment to spec PRs ... Restore original permission structure and model configuration while adding only the changes needed for issue #7521: forgejo_update_pull_request permission and PR Workflow for Major Changes documentation section. Fixes addressed: - Restore flat permission format (was incorrectly restructured to nested) - Restore model to claude-haiku-4-5 with reasoningEffort max - Restore removed critical rules (6: label delegation, 7: pagination) - Restore removed permission denials (*, doom_loop, question, etc.) - Add CHANGELOG.md entry for this feature - Restore CONTRIBUTORS.md to master (remove unrelated changes) ISSUES CLOSED: #7521 # Conflicts: # CONTRIBUTORS.md	2026-04-24 02:04:54 +00:00
HAL9000	44fc7411f9	ci: move benchmark regression job out of default PR workflow ... Extract the benchmark-regression job from the default PR CI workflow into a dedicated scheduled workflow (.forgejo/workflows/benchmark-scheduled.yml). The benchmark job was blocking PR feedback for 99-132 minutes even when lint/typecheck/tests passed in under 20 minutes. The new workflow runs: - Nightly regression tests (2 AM UTC) comparing HEAD against master - Weekly full benchmark suite (3 AM UTC Sundays) for trend analysis - Manual dispatch trigger for ad-hoc benchmark validation AWS S3 integration stores benchmark results for historical trend analysis. Documentation updated in docs/development/ci-cd.md. CONTRIBUTORS.md updated with benchmark workflow separation contribution. ISSUES CLOSED: #9040 # Conflicts: # CONTRIBUTORS.md # Conflicts: # CONTRIBUTORS.md	2026-04-23 14:24:09 +00:00
HAL9000	00d12c844d	[AUTO-TIME-2] Day 103 Timeline Update — Cycle 3 (2026-04-13 ~22:02 UTC) ... Update docs/timeline.md with Cycle 3 milestone status: - ALERT: Scope expanding faster than closing (+110 open in 60 min, only +2 closed) - M2 v3.1.0: 5 open (was 3) — scope expanding in closed milestone - M3 v3.2.0: 802 open (was 776), 269 closed — 25.1% completion - M4 v3.3.0: 157 open (was 148), 109 closed — 41.0% completion - M5 v3.4.0: 242 open (was 233), 139 closed — 36.5% completion - M6 v3.5.0: 1052 open (was 1032), 212 closed — 16.8% completion - M7 v3.6.0: 314 open (was 296), 152 closed — 32.6% completion - M8 v3.7.0: 574 open (was 548), 427 closed — 42.6% completion Added scope expansion alert section and Cycle 3 schedule adherence entries.	2026-04-21 20:32:34 +00:00
CoreRasurae	e19af527e6	revert 4e86ffe596 ... revert docs: document LLM provider fallback behavior (Anthropic Sonnet fallback) [AUTO-DOCS-7]	2026-04-21 19:44:48 +00:00
HAL9000	4e86ffe596	docs: document LLM provider fallback behavior (Anthropic Sonnet fallback) [AUTO-DOCS-7]	2026-04-21 17:26:19 +00:00
HAL9000	1f95ea0c2a	Update timeline: milestone status for 2026-04-19	2026-04-19 04:00:21 +00:00
HAL9000	89baa0a525	Update timeline: milestone status for 2026-04-19	2026-04-19 03:59:35 +00:00
CoreRasurae	0c5b140d29	fix(database): include alembic files in package distribution ... Move alembic configuration and migration files from repository root into the Python package structure to ensure they are included in the wheel distribution. This fix resolves the FileNotFoundError when running `agents init` in Docker containers or any environment using the built wheel distribution. Changes: - Move alembic/ directory from repo root to src/cleveragents/infrastructure/database/migrations/ - Move alembic.ini to the same new location and update script_location setting - Update MigrationRunner._find_alembic_ini() to search from the new canonical location within the package - Update create_template_db.py to point to the new alembic.ini location - Update documentation references to reflect new migration file locations - Create __init__.py for migrations package - The env.py file is imported when running tests that verify all modules can be imported without errors. However, context.config is only available when alembic is actually running migrations, not during normal module imports. This caused an AttributeError when the test tried to import the migrations.env module. - Fix by using getattr() with a default value to safely access context.config, and guard all code that uses config with None checks. This allows the module to be safely imported while still functioning correctly during migrations. Testing: - Verified MigrationRunner can locate alembic.ini in new location - Tested agents init succeeds in creating project with database - Template database creation works correctly - All migration tests should pass without changes Alembic files now follow standard Python packaging conventions, making them automatically included in wheel distributions without special configuration. ISSUES CLOSED: #4180	2026-04-17 17:40:00 +00:00
HAL9000	835bc580e2	spec: document JSON-RPC 2.0 A2A wire format (AUTO-ARCH-8) ... Updates the A2A Protocol section to reflect the rename of A2aRequest/ A2aResponse fields to standard JSON-RPC 2.0 names (method, id, result, error). Documents A2aVersionNegotiator for backward compatibility. Closes #8787	2026-04-15 08:44:55 +00:00
HAL9000	0d6b197504	docs(timeline): update schedule adherence Day 104 (2026-04-14) [AUTO-TIME-1]	2026-04-14 17:51:15 +00:00
HAL9000	510cb03d99	docs(spec): add v3.8.0 Server Implementation milestone plan and update status table (#7701) ... Co-authored-by: CleverThis <hal9000@cleverthis.com> Co-committed-by: CleverThis <hal9000@cleverthis.com>	2026-04-14 16:46:31 +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
CleverAgents Bot	9db348e5f6	docs(timeline): update schedule adherence Day 102 (2026-04-12)	2026-04-14 14:56:10 +00:00
HAL9000	6559a0e9df	docs: integrate docs-writer automation tracking workflows ... - document docs-writer responsibilities and automation tracking requirements\n- enforce automation tracking label validation and clean coverage regression tags\n\nISSUES CLOSED: #7616 # Conflicts: # CHANGELOG.md # docs/development/automation-tracking.md # docs/development/docs-writer.md # mkdocs.yml	2026-04-14 14:11:47 +00:00
clever-agent	c5820266fd	Build: improced merge agent logic to ensure faster and more effective merging into master	2026-04-13 15:30:00 -04:00
HAL9000	978849412d	docs(reference): align A2A facade API with implementation ... Fixes docs/reference/a2a.md Local Facade section. Issues #6620 and #6624. Fixes #6620 Fixes #6624 Automatically merged by PR Merge Pool Supervisor [AUTO-PRMRG-SUP] --- **Automated by CleverAgents Bot** Supervisor: PR Merge | Agent: pr-merge-pool-supervisor Co-authored-by: CleverThis <hal9000@cleverthis.com> Co-committed-by: CleverThis <hal9000@cleverthis.com>	2026-04-13 08:10:03 +00:00
clever-agent	56a430d31f	refactor(agents): rename backlog-grooming to grooming, fix tier selector dispatch ... Renamed backlog-grooming-pool-supervisor to grooming-pool-supervisor and backlog-grooming-worker to grooming-worker. The grooming agents now analyze all open issues AND pull requests (not just the backlog). Workers perform a full 10-point quality analysis on a single item instead of processing batches. PRs with unaddressed reviews are prioritized. PR labels are synced from linked issues. Workers post [GROOMED] markers for tracking. Fixed critical issue: implementation-pool-supervisor now correctly dispatches workers through tier selectors (tier-haiku/codex/sonnet/opus) instead of launching implementation-worker directly, ensuring the escalation model actually sets the correct model tier. Added implementation-worker to all four tier selector task permissions. Updated session tags from AUTO-BLOG to AUTO-GROOM. Updated specification sections 4.2.1, 5.5, 5.5.1, 9.7, and architecture diagram. ISSUES CLOSED: n/a	2026-04-12 22:33:40 -04:00
HAL9000	a3094dea2b	docs(spec): clarify path containment, datetime, and plugin security contracts ... Three implementation contracts clarified in response to security/correctness bugs surfaced by the bug hunt pool: 1. Path containment: Sandbox path validation MUST use Path.is_relative_to() not string prefix comparison. String prefix allows /tmp/sandboxmalicious to pass a /tmp/sandbox root check. Canonical implementation provided. 2. Datetime handling: All stored ISO timestamp comparisons MUST parse back to timezone-aware datetime objects before comparing. String comparison of ISO timestamps is incorrect when timezone offsets differ in format. Canonical parse_utc_ts() pattern provided. 3. Plugin protocol validation: Protocol compliance MUST be checked structurally via issubclass() — never by instantiating the plugin class. Instantiation runs __init__ side effects before the plugin is approved. These are minor clarifications (implementation contracts, not architectural changes) added to the existing Security and Extensibility sections. Refs: BUG-HUNT issues #7336 (path traversal), #7341 (datetime comparison), #7331 (plugin instantiation)	2026-04-13 00:44:44 +00:00
clever-agent	8692bb46e5	build: Refactored agent definitions to be simpler and less contention	2026-04-12 19:24:50 -04: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
clever-agent	b89b781881	docs(spec): add Section 22 — Division of Responsibilities and Redundancy Model ... Add comprehensive responsibility-first analysis of the entire agent system covering 144 named responsibilities (R-01 through R-144) organized into 8 categories with 29 sub-categories and complete bidirectional cross-references. Key additions: - Section 22.0: Categorized Responsibility Index with navigation guide - Section 7.9: Universal Supervisor Responsibilities (13 shared baseline) - Section 22.145: Redundancy Analysis Summary with depth distribution, highest-redundancy items, most cross-referenced agents, and 5 named redundancy patterns - 30 agent back-reference tables covering ~50 individual agents - Category introductions explaining scope and significance - 6th foundational principle (Defense-in-Depth) added to Section 1.1 Categories: A (Development Lifecycle, 50 items), B (Quality Assurance), C (Ticket Hygiene), D (Architecture), E (Operational Health), F (Human Interaction), G (Strategic Governance), H (Project Standards). ISSUES CLOSED: N/A	2026-04-11 23:03:56 -04:00
HAL9000	157b0d6b8c	docs(timeline): update schedule adherence Day 100 (2026-04-10) ... Refresh Day 100 entries using Forgejo telemetry across both cycle snapshots to capture scope expansion, milestone progress, and active session data.\n\n- Update today marker and Gantt update log for Day 100\n- Capture scope expansion metrics and milestone completion percentages\n- Refresh risk register, status summary, and track/milestone forecasts\n- Append Day 100 cycle-2 schedule adherence tables for teams and milestones\n- Note infrastructure changes (review requirement, supervisor additions)\n\nISSUES CLOSED: #6975	2026-04-11 02:52:50 +00:00
HAL9000	c76433f756	docs(tracking): document automation-tracking-manager centralization	2026-04-11 00:40:19 +00:00
HAL9000	39b6fb3fa8	docs: harden backup script example	2026-04-10 23:37:56 +00:00
HAL9000	6523034cb0	docs: add actor context management showcase (remove, export, import) ... Document the CLI-based lifecycle for removing, exporting, and importing named contexts, including JSON import limitations and scripting examples. ISSUES CLOSED: #4409	2026-04-10 23:37:56 +00:00
HAL9000	59ce94cd27	docs(timeline): update schedule adherence Day 99 (2026-04-09) ... Refresh timeline for Day 99 with updated gantt charts, status summary, and schedule adherence tables covering bug surge and milestone scope changes. ISSUES CLOSED: #5780	2026-04-10 22:24:17 +00:00
clever-agent	7e66e57c21	docs(spec): final pass — structural integrity audit ... - Fixed duplicate section number: two §2.4 -> renamed first to §2.3.1 - Verified all section cross-references valid - Verified Appendix A model/mode data matches frontmatter (10 samples) - Verified mkdocs.yml navigation entry - Comprehensive stale-name sweep: zero hits across all files - Added v1.36.0 revision entry with final statistics	2026-04-10 21:07:30 +00:00
clever-agent	3a69aef505	docs(spec): twentieth pass achieving spec-wide dual-account coherence ... - Fixed Glossary: HAL9000 definition updated for dual-account architecture - Fixed Section 6.17.2: "two-step" -> "dual-account" in protocol text - Fixed Section 12.1.2: PR Reviewer table, description, and permissions rationale all updated for curl-based dual-account review protocol - Fixed Section 19.5: Security Model rewritten from "single bot account" to dual-account with separate permission scopes per account - Fixed 2 remaining "Two-Step Review Protocol" references - Added v1.35.0 revision entry	2026-04-10 20:59:08 +00:00
clever-agent	05e5b26f2a	docs(spec): nineteenth pass fixing diagram, MCP tool refs, and edit:deny count ... - Fixed Section 6.17.2 diagram: removed orphaned single-account nodes, updated to show curl with FORGEJO_REVIEWER_PAT - Fixed Section 6.17.2 step text: forgejo_create_pull_review -> curl - Fixed edit:deny count from 41 to 42 - Added missing separator after diagram - Added v1.34.0 revision entry	2026-04-10 20:51:37 +00:00
clever-agent	edbb3471b0	docs(spec): eighteenth pass fixing review template gaps and credential completeness ... - Updated Section 6.17 introduction to include FORGEJO_REVIEWER_PASSWORD - Updated Section 6.17 env table descriptions for clarity - Added v1.33.0 revision entry for template and credential fixes	2026-04-10 20:43:55 +00:00
clever-agent	5dda3a2c43	docs(spec): seventeenth pass documenting MCP token limitation and curl workaround ... - Added Section 6.17.0: MCP Token Limitation — single server-level token, no per-call override, PR Reviewer must use curl for writes - Rewrote Section 21.22: "Total Bash Lockdown" -> "Restricted Bash with curl" - Added READ-via-MCP/WRITE-via-curl operation table - Added v1.32.0 revision entry	2026-04-10 20:37:33 +00:00
clever-agent	6baf921b52	docs(spec): sixteenth pass adding FORGEJO_REVIEWER_PASSWORD and purging stale language ... - Added FORGEJO_REVIEWER_PASSWORD to Section 6.17 env table and Appendix C - Purged all remaining "self-approval"/"shared bot account" language from spec - Updated Sections 8.3.2 and 8.3.3 for dual-account architecture - Added v1.31.0 revision entry	2026-04-10 20:31:25 +00:00
clever-agent	fcff61e1b5	docs(spec): fifteenth pass introducing dual-account architecture ... - Rewrote Section 6.17: "Shared Bot Account Problem" -> "Dual-Account Architecture" - New env vars: FORGEJO_REVIEWER_PAT, FORGEJO_REVIEWER_USERNAME - Formal APPROVED reviews are now the primary approval path - Updated Section 6.17.2: "Two-Step" -> "Dual-Account Review Protocol" - Updated Appendix C environment variable table - Added v1.30.0 revision entry	2026-04-10 20:23:55 +00:00
clever-agent	4029a3331a	docs(spec): fourteenth pass adding subagent specialization principle ... - Added Section 6.0: Subagent Specialization Principle (centralize, dont duplicate) - Updated Section 5.3.4: interval calculation now ATM-centralized - Updated Section 5.4: 11 operations (added CYCLE_ANNOUNCEMENT_REVIEW) - Added v1.29.0 revision entry: 17 duplicated blocks removed	2026-04-10 16:15:44 -04:00
clever-agent	c29975de8f	docs(spec): thirteenth pass documenting body template field enforcement ... - Added v1.28.0: all 18 status-creating agents now have Estimated Cycle Interval in their actual body templates, not just in reference notes	2026-04-10 16:15:44 -04:00
clever-agent	c70adfbbe5	docs(spec): twelfth pass documenting tracking reference reorder across all agents ... - Added v1.27.0 entry: all 17 agents fixed with correct READ-before-CREATE order - All agents now include rolling average interval defaults and Estimated Cycle Interval requirement	2026-04-10 16:15:44 -04:00
clever-agent	8443facae2	docs(spec): eleventh pass adding cycle interval, dual cleanup, and continuity ... - Added Section 5.3.4: Estimated Cycle Interval (rolling average 90/10) - Added Section 5.3.5: Dual Status Issue Cleanup (agent-side + groomer-side) - Added Section 5.3.6: Cycle Number Continuity Across Sessions - Updated Section 5.6 body template with mandatory Estimated Cycle Interval field - Added v1.26.0 revision entry	2026-04-10 16:15:44 -04:00
clever-agent	276ce39908	docs(spec): tenth pass adding startup state recovery protocol ... - Added Section 5.3.3: Startup State Recovery Protocol with mandatory read-then-delete-then-create sequence - Agent-specific recovery table for IPS, PR pools, watchdog, product-builder - Offline duration behavior rules (5min = normal, 2h+ = full re-scan) - Enhanced READ_TRACKING_STATE return schema in Section 5.4 - Added v1.25.0 revision entry	2026-04-10 16:15:44 -04:00