π The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
docs: update ADR-073 with v3.5.59 β real perf/neural tools, AgentDB, 58 tests
Reuven52a04d7cc8f5
diff --git a/v3/implementation/adrs/ADR-073-stub-tool-honesty-real-predictions.md b/v3/implementation/adrs/ADR-073-stub-tool-honesty-real-predictions.mdindex eeefa8c0ec..c3857e8b52 100644--- a/v3/implementation/adrs/ADR-073-stub-tool-honesty-real-predictions.md+++ b/v3/implementation/adrs/ADR-073-stub-tool-honesty-real-predictions.md@@ -2,8 +2,8 @@# ADR-073: Stub Tool Honesty & Real Predictions**Status**: Accepted-**Date**: 2026-04-06 (updated v3.5.57)-**Context**: Issue #1514 (independent audit), Issues #1516, #1518, #1521, #1526, #1530, #1531, #1538+**Date**: 2026-04-06 (updated v3.5.59)+**Context**: Issue #1514 (independent audit), Issues #1058, #1516, #1518, #1521, #1526, #1530, #1531, #1538, PR #1539## Decision@@ -95,6 +95,37 @@ All embedding model defaults now use `Xenova/` prefix (e.g., `Xenova/all-MiniLM-- `providers` CLI: clarifying comment on static catalog- `system_metrics`: wired up real agent/task counters from store files+### 9. Real implementations & AgentDB integration (v3.5.59, PR #1539)++Three performance tool stubs replaced with real implementations:+- `performance_bottleneck`: Real CPU load (`os.loadavg()`), memory (`process.memoryUsage()`), disk I/O latency (4KB write/read probe), severity classification+- `performance_profile`: Real V8 profiling with `process.cpuUsage()`, `performance.now()`, operation hotspot detection across memory/io/cpu targets+- `performance_optimize`: Real before/after system snapshots, GC collection (when `--expose-gc`), bottleneck-informed recommendations++Two neural tool stubs replaced with real implementations:+- `neural_compress`: Three real methods β quantize (Int8 via `quantizeInt8()` from memory-initializer, 3.92x compression), prune (remove low-usage patterns), distill (merge by cosine similarity > 0.95)+- `neural_optimize`: Target-aware β speed (dedup by hash+cosine), memory (Int8 quantization), accuracy (prune zero-norm embeddings), balanced (all three)++MCP request tracking:+- New `request-tracker.ts` singleton counter module tracks tool invocations in-process+- Wired into `mcp-server.ts` (success/error paths)+- `system_metrics` reads live counts instead of stale JSON++AgentDB integration (primary data layer with JSON fallback):+- `hive-mind` consensus results β `hive-consensus` namespace+- `hive-mind` shared memory β `hive-memory` namespace+- `daa_agent_create` β `daa-agents` namespace+- `daa_workflow_execute` β `daa-workflows` namespace+- All AgentDB writes are after JSON store save, in `try/catch` β backward compatible++TypeScript fixes:+- Zero TS compilation errors for first time β added ambient type declarations for 7 optional packages+- Fixed `unknown[]` casts in embeddings.ts, `registry as any` in memory-bridge.ts++Test coverage:+- 28 honesty tests (source-level checks for fabrication patterns)+- 30 feature-gap tests (verify real implementations, AgentDB integration, request tracking)+## Consequences- Token optimizer reports honest numbers (will show 0 savings when agentic-flow is not installed)@@ -102,23 +133,32 @@ All embedding model defaults now use `Xenova/` prefix (e.g., `Xenova/all-MiniLM-- `neural_train` stores real embeddings, no simulated accuracy- Zero instances of `Math.random()` for confidence/accuracy/metrics in shipped code- Zero instances of `setTimeout()` for fake delays in shipped code-- All `_stub: true` markers on tools that don't perform real work+- All remaining stubs marked `_stub: true`; all real tools marked `_real: true`- Users can distinguish real ML vs hash-based embedding via `_realEmbedding` flag- `hooks explain` matchScore uses real keyword ratio instead of random-- system_metrics returns real agent/task counts from persistent stores+- `system_metrics` returns real agent/task/request counts from persistent stores and live tracker+- `performance_bottleneck/profile/optimize` are fully real (V8 profiling, OS metrics, disk I/O)+- `neural_compress/optimize` are fully real (Int8 quantization, cosine similarity, pruning)+- AgentDB is primary data layer for hive-mind and DAA tools with JSON store backward compat+- 58 automated tests enforce honesty invariants and real implementation requirements## Tools Status (Post-Fix)| Category | Status | Notes ||----------|--------|-------|| Memory/HNSW | Real | Vector search, persistence, embeddings |-| AgentDB | Real | Pattern store, hierarchical recall, HNSW |+| AgentDB | Real | Pattern store, hierarchical recall, HNSW; primary layer for hive-mind + DAA || Embeddings | Real | Xenova/transformers, cosine similarity || Neural predict | Real (with patterns) | Cosine similarity search; empty array when no patterns || Neural train | Real | Embeds training data, stores as searchable patterns |+| Neural compress | **Real (v3.5.59)** | Int8 quantize (3.92x), prune, distill (cosine > 0.95) |+| Neural optimize | **Real (v3.5.59)** | Target-aware: speed/memory/accuracy/balanced |+| Performance bottleneck | **Real (v3.5.59)** | CPU load, memory, disk I/O latency, severity classification |+| Performance profile | **Real (v3.5.59)** | V8 cpuUsage, memoryUsage, operation hotspots |+| Performance optimize | **Real (v3.5.59)** | GC collect, before/after snapshots, recommendations || Token optimizer | Honest metrics | No fabricated numbers || Agent spawn/task | Real state tracking | Store persistence via agents/store.json |-| DAA tools | Honest | Local state, no fake delays or auto-completion |-| System metrics | Real | CPU/memory from os module, agents/tasks from stores |+| DAA tools | **Real + AgentDB (v3.5.59)** | Local state + AgentDB persistence, no fake delays |+| System metrics | **Real + live tracker (v3.5.59)** | CPU/memory from os, agents/tasks from stores, requests from tracker |+| Hive-mind | **Real + AgentDB (v3.5.59)** | Vote counting + AgentDB persistence for consensus + shared memory || WASM agents | Stub | Echo-based, no WASM runtime |-| Hive-mind | Partial | Vote counting works, BFT not differentiated |