Tyler Gillispie
34a1f073eb
- Created `CONCEPTS.md` to track coverage of blueprint structures - Added 5 new PoCs: CFG, Constitution, Frontmatter, Mutation, and Orphan Branch - Registered all 15 experiments in `lab.ts` runner - Ensured zero-dependency Deno execution for tests Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com> Co-authored-by: mrteye <1945243+mrteye@users.noreply.github.com>
4.2 KiB
4.2 KiB
Agent Forum v4 - Concepts & PoC Coverage Tracker
This document tracks all concepts, data structures, and operational mechanisms
defined in the agent-forum-v4 blueprint and DATA_STRUCTURES.md, along with
their Proof of Concept (PoC) coverage status.
1. Storage Layers (Git-Native Storage)
| Concept | Status | PoC File | Description |
|---|---|---|---|
| 1.0 Protocol Buffers (Protobuf) | ✅ | protobuf_poc.ts |
High-performance binary serialization for agent state transfer. |
| 1.1 Git Notes | ✅ | git_storage_poc.ts |
Attaching metadata/JSON to Git commits without altering file content. |
| 1.2 Orphan Branches (Meta-State) | ✅ | orphan_branch_poc.ts |
Tracking project state separately from source code in isolated branches. |
| 1.3 Embedded Vector DBs (sqlite-vec) | ✅ | vector_db_poc.ts |
Associative fuzzy memory retrieval of semantic data. |
| 1.4 TurboQuant | ✅ | vector_db_poc.ts |
Compressing vectors to binary hashes. Mocked alongside Vector DB PoC. |
2. Process & Governance Structures
| Concept | Status | PoC File | Description |
|---|---|---|---|
| 2.0 Declarative Frontmatter (YAML UUIDs) | ✅ | frontmatter_poc.ts |
Unique identification of artifacts via UUIDv7 in YAML frontmatter. |
| 2.1 The Project DAG (YAML) | ✅ | dag_engine_poc.ts |
Execution order driven by mathematical DAG resolution. |
| 2.2 Bounded Model Checking (Transitions) | ✅ | state_machine_poc.ts |
Strict state machine rules (transitions.json) for agent roles. |
| 2.3 The Constitution (AGENTS.md) | ✅ | constitution_poc.ts |
Strict adherence to the machine-readable ruleset/stack boundaries. |
3. Code Intelligence Structures
| Concept | Status | PoC File | Description |
|---|---|---|---|
| 3.0 Git Merkle DAG Diffing | ✅ | merkle_diff_poc.ts |
O(1) context updates using native git tree diffing. |
| 3.1 SCIP Indexes (Semantic Code Protocol) | ✅ | code_intelligence_poc.ts |
Code symbol mapping (mocked via AST exports extraction). |
| 3.2 ASTs & Control Flow Graphs (CFGs) | ✅ | cfg_poc.ts |
Structured paths for security analysis (e.g., unsanitized inputs). |
| 3.3 Mutation Testing Scores | ✅ | mutation_poc.ts |
Blast radius / coverage enforcement by injecting bugs (Adversary). |
| 3.4 Dependency Graphing (Adjacency Matrices) | ✅ | dependency_graph_poc.ts |
Blast radius mapping via dependency matrices. |
4. Semantic & Telemetry Structures
| Concept | Status | PoC File | Description |
|---|---|---|---|
| 4.1 Ontologies (JSON-LD) | ✅ | ontology_poc.ts |
Deep traceability linking code/tasks to business requirements. |
| 4.2 OpenTelemetry Traces (.trace.json) | ✅ | telemetry_poc.ts |
Millisecond-level execution latency capture for bottleneck detection. |
| 4.3 Team Friction Telemetry | ✅ | telemetry_poc.ts |
Human-to-agent collaboration metrics (MTTR, Comment Ratios). |