34 lines
5.1 KiB
Markdown
34 lines
5.1 KiB
Markdown
# Agent Forum v4 - Consolidated Master Tracker
|
|
|
|
This document serves as the single source of truth for all concepts, data structures, and operational mechanisms defined in the `agent-forum.md` architectural blueprint. It consolidates the high-level architecture with the granular implementation constraints previously split across satellite documentation.
|
|
|
|
The table below tracks the definition, required implementation details, and Proof of Concept (PoC) coverage status for every implementable aspect of the Git-native ecosystem.
|
|
|
|
|
|
|
|
| Concept / Structure | Category | Blueprint Ref | Key Implementation Details | PoC File | Status |
|
|
| :--- | :--- | :--- | :--- | :--- | :--- |
|
|
| **Protocol Buffers (Protobuf)** | Data Structure | Section 1 | Serialized binary state and telemetry designed for conversion-less, high-performance data transfer. | `protobuf_poc.ts` | ✅ |
|
|
| **Git Notes** | Embedded Storage | Section 1 | Requires `git log --show-notes="forum/reasoning"` to fetch JSON payloads containing reasoning, risk, and telemetry. | `git_storage_poc.ts` | ✅ |
|
|
| **Orphan Branches** | Embedded Storage | Section 1 | Isolated `forum/meta-state` branch tracking CI/CD, RTMs, and DAGs without sharing main branch commit history. | `orphan_branch_poc.ts` | ✅ |
|
|
| **sqlite-vec & TurboQuant** | Embedded DB | Section 1 | 2-bit to 4-bit LSH/HNSW compression resulting in highly portable indexes typically under 30MB. | `vector_db_poc.ts` | ✅ |
|
|
| **Multi-Vec Isolation** | Embedded DB | Section 1 | Domain-specific SQLite files (e.g., `docs_graph.sqlite` distinct from `telemetry_graph.sqlite`) to prevent semantic bleed. | `multi_vec_poc.ts` | ✅ |
|
|
| **Declarative Frontmatter** | Data Structure | Section 1 & 4 | MUST utilize UUIDv7 (time-ordered) to allow historical sorting and chronological sequence inference directly from the ID. | `frontmatter_poc.ts` | ✅ |
|
|
| **The Project DAG** | Governance Structure | Section 4 | YAML schema explicitly requiring `id`, `blocked_by`, `legacy_slug`, `status`, and `description` fields. | `dag_engine_poc.ts` | ✅ |
|
|
| **Transitions Matrix** | Governance Structure | Section 1 & 2 | JSON mapping in `transitions.json` strictly defining Bounded Model Checking rules (e.g., `"Coder": { "requires": ["Gatekeeper_Approval"] }`). | `state_machine_poc.ts` | ✅ |
|
|
| **The Constitution (AGENTS.md)** | Governance Structure | Section 3 | Target application stack dynamically bound to the repository to statically prevent hallucinated dependencies. | `constitution_poc.ts` | ✅ |
|
|
| **Orchestration Matrix** | Governance Structure | Section 3 | Strict definition of inputs, outputs, and primary directives for the 6 core agents. | `orchestration_matrix_poc.ts` | ✅ |
|
|
| **Execution Flywheel** | Process | Section 5 | Continuous 3-step feedback loop: Analyst updates protocols, Gatekeeper reads constraints, cycle resets. | `execution_flywheel_poc.ts` | ✅ |
|
|
| **Git Merkle DAG Diffing** | Data Structure | Section 2 | Relies on `git ls-tree` and `git diff-tree` hashes for zero-overhead, O(1) context updates. | `merkle_diff_poc.ts` | ✅ |
|
|
| **SCIP Indexes** | Data Structure | Section 2 | Lightweight database mapping code definitions and references, typically extracted via Tree-sitter. | `code_intelligence_poc.ts` | ✅ |
|
|
| **ASTs & CFGs** | Data Structure | Section 2 | JSON/XML mapping of variable execution paths utilized for deterministic security proofs. | `cfg_poc.ts` | ✅ |
|
|
| **Mutation & Adjacency** | Data Structure | Section 2 & 3 | Blast radius and coverage enforcement mappings generated by tools like Stryker and CodeSee. | `mutation_poc.ts` | ✅ |
|
|
| **Static Analysis Payloads** | Data Structure | Section 2 | Standardized JSON/XML metric outputs from industry tools like Semgrep and SonarQube. | `static_analysis_poc.ts` | ✅ |
|
|
| **Tool Sandbox** | Process | Appendix A | Safe local execution environment for CLI/WebAssembly binaries (Tree-sitter, Semgrep) respecting Bounded Model Checking constraints. | `tool_sandbox_poc.ts` | ✅ |
|
|
| **Automated Git Hooks** | Process | Section 2 | Native pre-commit hooks configured to automatically generate SCIP and AST index graphs prior to agent interaction. | `git_hooks_poc.ts` | ✅ |
|
|
| **Ontologies (JSON-LD)** | Data Structure | Section 4 | Embedded `@type: "Requirement"` blocks compiled to a mathematical `ontology.graph` file for deep traceability. | `ontology_poc.ts` | ✅ |
|
|
| **OTel Traces** | Data Structure | Section 4 | Standardized `.trace.json` payloads capturing millisecond-level execution latencies during testing. | `telemetry_poc.ts` | ✅ |
|
|
| **Team Friction Telemetry** | Data Structure | Section 4 | JSON payloads recorded in the meta-state branch tracking MTTR, PR comment-to-code ratios, and idle handoff durations. | `telemetry_poc.ts` | ✅ |
|
|
| **Doc-to-LoRA** | Dismissed Concept | Section 6 | Rejected because generating megabytes of `.safetensors` adapter weights directly causes extreme Git repository bloat. | `graveyard_poc.ts` | ❌ |
|
|
| **PASTE (Speculative Tooling)** | Dismissed Concept | Section 6 | Rejected because speculative write operations cause irrecoverable race conditions and corrupt the meta-state branch. | `graveyard_poc.ts` | ❌ |
|