{ "schema": "fak-study-inventory-map/1", "repository": "ruvnet/ruflo", "url": "https://github.com/ruvnet/ruflo", "indexed_revision": "4dcff483482cee316f47552a961bcbaadc89f378", "observed_at": "2026-08-25T00:00:00Z", "totals": { "files": 5517, "directories": 1542, "bytes": 81506669, "runtime_files": 2315, "test_files": 645, "docs_files": 2015, "text_lines": 1613340 }, "source_classes": [ { "class": "readme_docs", "status": "covered", "evidence": [ ".agents/README.md", ".claude-plugin/README.md", ".claude/commands/agents/README.md", ".claude/commands/analysis/README.md", ".claude/commands/automation/README.md", ".claude/commands/coordination/README.md", ".claude/commands/github/README.md", ".claude/commands/hive-mind/README.md", ".claude/commands/hooks/README.md", ".claude/commands/memory/README.md", ".claude/commands/monitoring/README.md", ".claude/commands/optimization/README.md" ], "note": "local tree evidence found" }, { "class": "architecture_design", "status": "covered", "evidence": [ ".agents/skills/agent-arch-system-design/SKILL.md", ".agents/skills/agent-architecture/SKILL.md", ".agents/skills/v3-ddd-architecture/SKILL.md", ".claude/agents/architecture/system-design/arch-system-design.md", ".claude/agents/sparc/architecture.md", ".claude/commands/sparc/designer.md", ".claude/helpers/adr-compliance.sh", ".claude/skills/v3-ddd-architecture/SKILL.md", ".github/workflows/adr-166-mcp-bridge-security.yml", "docs/benchmarks/runs/adr-coverage.jsonl", "plugins/ruflo-adr/agents/adr-architect.md", "plugins/ruflo-adr/commands/adr.md" ], "note": "local tree evidence found" }, { "class": "runtime_source", "status": "covered", "evidence": [ ".agents/config.toml", ".agents/skills/memory-management/scripts/memory-backup.sh", ".agents/skills/memory-management/scripts/memory-consolidate.sh", ".agents/skills/security-audit/scripts/cve-remediate.sh", ".agents/skills/security-audit/scripts/security-scan.sh", ".agents/skills/sparc-methodology/scripts/sparc-init.sh", ".agents/skills/sparc-methodology/scripts/sparc-review.sh", ".agents/skills/swarm-orchestration/scripts/swarm-monitor.sh", ".agents/skills/swarm-orchestration/scripts/swarm-start.sh", ".claude-plugin/hooks/hooks.json", ".claude-plugin/marketplace.json", ".claude-plugin/plugin.json" ], "note": "local tree evidence found" }, { "class": "tests_fixtures", "status": "covered", "evidence": [ "plugins/ruflo-adr/scripts/__tests__/adr-create-schema-2651.test.mjs", "plugins/ruflo-adr/scripts/__tests__/index-idempotency-2660.test.mjs", "plugins/ruflo-adr/scripts/__tests__/parser-bullets-2659.test.mjs", "plugins/ruflo-adr/scripts/__tests__/skip-brain-dir-2911.test.mjs", "plugins/ruflo-agntcy/src/casa/__tests__/compile.test.ts", "plugins/ruflo-agntcy/src/casa/__tests__/enforce.test.ts", "plugins/ruflo-agntcy/src/receipts/__tests__/casa-receipt.test.ts", "plugins/ruflo-arena/tests/evolution.test.ts", "plugins/ruflo-arena/tests/games-arena.test.ts", "plugins/ruflo-arena/tests/mcp-tools.test.ts", "plugins/ruflo-arena/tests/tournament.test.ts", "plugins/ruflo-business-pods/scripts/pod-tick.test.mjs" ], "note": "local tree evidence found" }, { "class": "history_changelog_releases", "status": "covered", "evidence": [ ".claude/agents/github/release-manager.md", ".claude/agents/github/release-swarm.md", ".claude/commands/github/release-manager.md", ".claude/commands/github/release-swarm.md", ".github/workflows/stable-npm-release.yml", "CHANGELOG.md", "plugins/ruflo-core/scripts/witness/history.mjs", "plugins/ruflo-metaharness/scripts/drift-from-history.mjs", "plugins/ruflo-workflows/commands/gaia-history.md", "ruflo/docs/adr/ADR-031-HF-CHAT-HISTORY-PERSISTENCE.md", "ruflo/src/ruvocal/.github/release.yml", "v3/@claude-flow/cli/.claude/agents/github/release-manager.md" ], "note": "local tree evidence found" }, { "class": "open_closed_issues_prs_discussions", "status": "external_required", "evidence": [ "https://github.com/ruvnet/ruflo/issues?q=created%3A%3C%3D2026-08-14T15%3A39%3A43Z", "https://github.com/ruvnet/ruflo/pulls?q=created%3A%3C%3D2026-08-14T15%3A39%3A43Z", "https://github.com/ruvnet/ruflo/discussions" ], "note": "GitHub API read-back at the pinned commit timestamp found 1,613 issues (556 open, 1,057 closed), 1,291 pull requests (261 open, 1,030 closed), and all 86 discussions (84 open, 2 closed; 3 answered). Counts exclude items created after 2026-08-14T15:39:43Z." }, { "class": "roadmap_todos", "status": "covered", "evidence": [ "docs/IMPROVEMENT-ROADMAP.md", "v3/implementation/migration/v3-migration-roadmap.md", "v3/implementation/optimization/V3-OPTIMIZATION-ROADMAP.md" ], "note": "local tree evidence found" }, { "class": "license_provenance", "status": "covered", "evidence": [ "Cargo.toml", "LICENSE", "package.json", "plugins/ruflo-arena/package.json", "plugins/ruflo-graph-intelligence/package.json", "ruflo/package.json", "ruflo/src/mcp-bridge/package.json", "ruflo/src/ruvocal/LICENSE", "ruflo/src/ruvocal/mcp-bridge/package.json", "ruflo/src/ruvocal/package.json", "ruflo/src/ruvocal/stub/@reflink/reflink/package.json", "v3/@claude-flow/aidefence/package.json" ], "note": "local tree evidence found" }, { "class": "fak_selfquery_witness", "status": "external_required", "evidence": [ "fak help --all (routing, memory, hooks, skills, orchestration, telemetry)", "rg -n -i README.md docs internal cmd examples" ], "note": "Queried fak first across adoption, performance, security, reliability, architecture/orchestration, and operations; the candidate matrix records the closest owned surface and avoids filing duplicate capabilities." }, { "class": "candidate_matrix", "status": "external_required", "evidence": [ "docs/research/inventory/ruvnet-ruflo.json#non_tree_study.candidate_matrix" ], "note": "Four source-backed candidates were compared against fak-native surfaces; all were rejected or already owned, so no borrow survived." }, { "class": "completeness_critic", "status": "covered", "note": "generated by this inventory map's local tree walk; non-tree omissions remain named in the note" }, { "class": "issue_tracking", "status": "external_required", "evidence": [ "https://github.com/anthony-chaudhary/fak/issues/8931" ], "note": "Issue #8931 tracks this inventory completion. Candidate adjudication produced no surviving borrow, so no additional implementation issue was filed." } ], "subsystems": [ { "path": "v3", "files": 3417, "directories": 639, "bytes": 48768228, "runtime_files": 1738, "test_files": 548, "docs_files": 968, "text_lines": 1109011, "languages": [ { "language": "TypeScript", "files": 1866 }, { "language": "Docs", "files": 968 }, { "language": "Config", "files": 257 }, { "language": "Shell", "files": 69 }, { "language": "JavaScript", "files": 54 }, { "language": "Rust", "files": 24 } ], "example_paths": [ "v3/.agentic-flow/intelligence.json", "v3/@claude-flow/agents/architect.yaml", "v3/@claude-flow/agents/coder.yaml", "v3/@claude-flow/agents/reviewer.yaml", "v3/@claude-flow/agents/security-architect.yaml", "v3/@claude-flow/agents/tester.yaml", "v3/@claude-flow/aidefence/README.md", "v3/@claude-flow/aidefence/__tests__/threat-detection.test.ts" ], "source_classes": [ "architecture_design", "history_changelog_releases", "license_provenance", "readme_docs", "roadmap_todos", "runtime_source", "tests_fixtures" ] }, { "path": "plugins", "files": 602, "directories": 458, "bytes": 3380502, "runtime_files": 151, "test_files": 36, "docs_files": 330, "text_lines": 61242, "languages": [ { "language": "Docs", "files": 330 }, { "language": "Config", "files": 71 }, { "language": "TypeScript", "files": 66 }, { "language": "Shell", "files": 38 }, { "language": "JavaScript", "files": 1 } ], "example_paths": [ "plugins/README.md", "plugins/ruflo-adr/.claude-plugin/plugin.json", "plugins/ruflo-adr/README.md", "plugins/ruflo-adr/REFERENCE.md", "plugins/ruflo-adr/agents/adr-architect.md", "plugins/ruflo-adr/commands/adr.md", "plugins/ruflo-adr/docs/adrs/0001-adr-plugin-pattern.md", "plugins/ruflo-adr/docs/adrs/0002-reconcile-deleted-adrs.md" ], "source_classes": [ "architecture_design", "history_changelog_releases", "license_provenance", "readme_docs", "runtime_source", "tests_fixtures" ] }, { "path": "ruflo", "files": 556, "directories": 151, "bytes": 9621955, "runtime_files": 312, "test_files": 28, "docs_files": 50, "text_lines": 64002, "languages": [ { "language": "TypeScript", "files": 267 }, { "language": "Config", "files": 52 }, { "language": "Docs", "files": 50 }, { "language": "JavaScript", "files": 17 }, { "language": "Shell", "files": 4 } ], "example_paths": [ "ruflo/README.md", "ruflo/bin/ruflo.js", "ruflo/docker-compose.public.yml", "ruflo/docker-compose.yml", "ruflo/docs/AUTH.md", "ruflo/docs/DOCKER.md", "ruflo/docs/MODELS.md", "ruflo/docs/TOOLS.md" ], "source_classes": [ "architecture_design", "history_changelog_releases", "license_provenance", "readme_docs", "runtime_source", "tests_fixtures" ] }, { "path": ".claude", "files": 371, "directories": 100, "bytes": 2367486, "runtime_files": 37, "test_files": 0, "docs_files": 319, "text_lines": 75395, "languages": [ { "language": "Docs", "files": 319 }, { "language": "Shell", "files": 28 }, { "language": "Config", "files": 5 }, { "language": "JavaScript", "files": 4 } ], "example_paths": [ ".claude/agents/MIGRATION_SUMMARY.md", ".claude/agents/analysis/analyze-code-quality.md", ".claude/agents/analysis/code-analyzer.md", ".claude/agents/analysis/code-review/analyze-code-quality.md", ".claude/agents/architecture/system-design/arch-system-design.md", ".claude/agents/base-template-generator.md", ".claude/agents/consensus/byzantine-coordinator.md", ".claude/agents/consensus/crdt-synchronizer.md" ], "source_classes": [ "architecture_design", "history_changelog_releases", "readme_docs", "runtime_source" ] }, { "path": "docs", "files": 189, "directories": 18, "bytes": 6817241, "runtime_files": 0, "test_files": 0, "docs_files": 189, "text_lines": 199602, "languages": [ { "language": "Config", "files": 138 }, { "language": "Docs", "files": 44 } ], "example_paths": [ "docs/IMPROVEMENT-ROADMAP.md", "docs/QUALITY-SWEEP.md", "docs/STATUS.md", "docs/TEAM-GATEWAY-CHECKLIST.md", "docs/USERGUIDE.md", "docs/_config.yml", "docs/agenticow/findings.md", "docs/assets/sv-summit.png" ], "source_classes": [ "architecture_design", "readme_docs", "roadmap_todos" ] }, { "path": ".agents", "files": 144, "directories": 139, "bytes": 1425843, "runtime_files": 9, "test_files": 0, "docs_files": 135, "text_lines": 51744, "languages": [ { "language": "Docs", "files": 135 }, { "language": "Shell", "files": 8 }, { "language": "Config", "files": 1 } ], "example_paths": [ ".agents/README.md", ".agents/config.toml", ".agents/skills/agent-adaptive-coordinator/SKILL.md", ".agents/skills/agent-agent/SKILL.md", ".agents/skills/agent-agentic-payments/SKILL.md", ".agents/skills/agent-analyze-code-quality/SKILL.md", ".agents/skills/agent-app-store/SKILL.md", ".agents/skills/agent-arch-system-design/SKILL.md" ], "source_classes": [ "architecture_design", "readme_docs", "runtime_source" ] }, { "path": "scripts", "files": 105, "directories": 1, "bytes": 876796, "runtime_files": 6, "test_files": 2, "docs_files": 0, "text_lines": 1500, "languages": [ { "language": "Shell", "files": 6 } ], "example_paths": [ "scripts/__tests__/audit-supply-chain.test.mjs", "scripts/__tests__/stage-internal-runtime-bundles.test.mjs", "scripts/cleanup-v3.sh", "scripts/install.sh", "scripts/smoke-agentbbs.sh", "scripts/smoke-agenticow.sh", "scripts/verify-appliance.sh", "scripts/verify-federation-plugin.sh" ], "source_classes": [ "runtime_source", "tests_fixtures" ] }, { "path": ".github", "files": 38, "directories": 6, "bytes": 399551, "runtime_files": 32, "test_files": 0, "docs_files": 5, "text_lines": 9328, "languages": [ { "language": "Config", "files": 32 }, { "language": "Docs", "files": 5 } ], "example_paths": [ ".github/ISSUE_PATTERN_PERSISTENCE.md", ".github/ISSUE_TEMPLATE/rollback-incident.md", ".github/actions/npm-ci-retry/action.yml", ".github/dependabot.yml", ".github/issues/alpha-89-telemetry-implementation.md", ".github/supply-chain/README.md", ".github/supply-chain/accepted-findings.json", ".github/supply-chain/allowed-deps.json" ], "source_classes": [ "architecture_design", "history_changelog_releases", "open_closed_issues_prs_discussions", "readme_docs", "runtime_source" ] }, { "path": "tests", "files": 31, "directories": 3, "bytes": 299952, "runtime_files": 0, "test_files": 31, "docs_files": 1, "text_lines": 7310, "languages": [ { "language": "Shell", "files": 16 }, { "language": "TypeScript", "files": 8 }, { "language": "Config", "files": 4 }, { "language": "Docs", "files": 1 } ], "example_paths": [ "tests/context-persistence-hook.test.mjs", "tests/docker-regression/Dockerfile", "tests/docker-regression/Makefile", "tests/docker-regression/README.md", "tests/docker-regression/docker-compose.yml", "tests/docker-regression/fixtures/sample-code.ts", "tests/docker-regression/fixtures/sample-patterns.json", "tests/docker-regression/scripts/run-all-tests.sh" ], "source_classes": [ "readme_docs", "tests_fixtures" ] }, { "path": ".", "files": 20, "directories": 17, "bytes": 6373614, "runtime_files": 6, "test_files": 0, "docs_files": 8, "text_lines": 24002, "languages": [ { "language": "Docs", "files": 8 }, { "language": "Config", "files": 6 } ], "example_paths": [ "AGENTS.md", "CHANGELOG.md", "CLAUDE.local.md", "CLAUDE.md", "CONTRIBUTING.md", "Cargo.toml", "LICENSE", "README.md" ], "source_classes": [ "history_changelog_releases", "license_provenance", "readme_docs", "runtime_source" ] }, { "path": "verification", "files": 16, "directories": 3, "bytes": 1033430, "runtime_files": 7, "test_files": 0, "docs_files": 3, "text_lines": 5981, "languages": [ { "language": "Config", "files": 7 }, { "language": "Docs", "files": 3 } ], "example_paths": [ "verification/CAPABILITIES.md", "verification/README.md", "verification/cli-mcp-tool-baseline.json", "verification/inventory.json", "verification/linux/manifest.md.json", "verification/macos/manifest.md.json", "verification/mcp-tool-baseline.json", "verification/results.md" ], "source_classes": [ "history_changelog_releases", "readme_docs", "runtime_source" ] }, { "path": ".claude-plugin", "files": 13, "directories": 3, "bytes": 78747, "runtime_files": 7, "test_files": 0, "docs_files": 5, "text_lines": 2609, "languages": [ { "language": "Docs", "files": 5 }, { "language": "Shell", "files": 4 }, { "language": "Config", "files": 3 } ], "example_paths": [ ".claude-plugin/README.md", ".claude-plugin/docs/INSTALLATION.md", ".claude-plugin/docs/PLUGIN_SUMMARY.md", ".claude-plugin/docs/QUICKSTART.md", ".claude-plugin/docs/STRUCTURE.md", ".claude-plugin/hooks/hooks.json", ".claude-plugin/marketplace.json", ".claude-plugin/plugin.json" ], "source_classes": [ "readme_docs", "runtime_source" ] }, { "path": "plugin", "files": 4, "directories": 3, "bytes": 18497, "runtime_files": 3, "test_files": 0, "docs_files": 0, "text_lines": 311, "languages": [ { "language": "Config", "files": 2 }, { "language": "Shell", "files": 1 } ], "example_paths": [ "plugin/.claude-plugin/plugin.json", "plugin/hooks/hooks.json", "plugin/scripts/ruflo-hook.sh" ], "source_classes": [ "runtime_source" ] }, { "path": ".harness", "files": 3, "directories": 0, "bytes": 6510, "runtime_files": 2, "test_files": 0, "docs_files": 1, "text_lines": 130, "languages": [ { "language": "Config", "files": 2 }, { "language": "Docs", "files": 1 } ], "example_paths": [ ".harness/README.md", ".harness/manifest.json", ".harness/mcp-policy.json" ], "source_classes": [ "readme_docs", "runtime_source" ] }, { "path": "bin", "files": 3, "directories": 0, "bytes": 1225, "runtime_files": 3, "test_files": 0, "docs_files": 0, "text_lines": 27, "languages": [ { "language": "JavaScript", "files": 3 } ], "example_paths": [ "bin/cli.js", "bin/npx-repair.js", "bin/npx-safe-launch.js" ], "source_classes": [ "runtime_source" ] }, { "path": "data", "files": 3, "directories": 0, "bytes": 35739, "runtime_files": 2, "test_files": 0, "docs_files": 0, "text_lines": 1129, "languages": [ { "language": "Config", "files": 2 } ], "example_paths": [ "data/clone-data.ledger.json", "data/clone-data.proof.json" ], "source_classes": [ "runtime_source" ] }, { "path": ".githooks", "files": 1, "directories": 0, "bytes": 661, "runtime_files": 0, "test_files": 0, "docs_files": 0, "text_lines": 0 }, { "path": "services", "files": 1, "directories": 1, "bytes": 692, "runtime_files": 0, "test_files": 0, "docs_files": 1, "text_lines": 17, "languages": [ { "language": "Docs", "files": 1 } ], "example_paths": [ "services/cognitum-analytics/README.md" ], "source_classes": [ "readme_docs" ] } ], "skipped_dirs": [ ".git" ], "completeness_critic": "exhaustive local tree map plus pinned-timestamp GitHub issue, pull-request, and complete discussion read-back; fak self-query, candidate adjudication, and issue tracking are recorded under non_tree_study; skipped dependency/cache/control directories: .git", "non_tree_study": { "observed_at": "2026-08-25", "source_cutoff": { "revision": "4dcff483482cee316f47552a961bcbaadc89f378", "commit_timestamp": "2026-08-14T15:39:43Z" }, "github_surface": { "issues": { "total": 1613, "open": 556, "closed": 1057 }, "pull_requests": { "total": 1291, "open": 261, "closed": 1030 }, "discussions": { "total": 86, "open": 84, "closed": 2, "answered": 3 }, "method": "GitHub REST issues endpoint paged to exhaustion (issues and pull requests split by pull_request presence), plus GraphQL discussions(first:100); retained records created no later than the pinned commit timestamp." }, "self_query_axes": [ { "axis": "adoption", "fak_surface": "managed harness integrations, MCP, skills, and setup/doctor surfaces", "verdict": "owned" }, { "axis": "performance", "fak_surface": "native routing, shared setup/cache, context memory, benchmarks, and SOTA checks", "verdict": "owned" }, { "axis": "security", "fak_surface": "default-deny policy/adjudication, guard hooks, capability floors, and security scorecards", "verdict": "owned" }, { "axis": "reliability", "fak_surface": "DOS leases, goal gates, independent witnesses, watchdogs, and recovery surfaces", "verdict": "owned" }, { "axis": "architecture_orchestration", "fak_surface": "ultracode/task orchestration, lanes, messaging, reconciliation, and trajectory control", "verdict": "owned" }, { "axis": "operations", "fak_surface": "telemetry, health/doctor, study monitoring, ledgers, and observable outcomes", "verdict": "owned" } ], "candidate_matrix": [ { "candidate": "power-of-two-choices mesh load balancing", "source": [ "https://github.com/ruvnet/ruflo/issues/3026", "https://github.com/ruvnet/ruflo/pull/3027" ], "alternative": "fak native routing and orchestration scheduler", "disposition": "reject", "reason": "Ruflo evaluated and rejected its own experiment at the pinned revision; no validated gain or transferable witness survives." }, { "candidate": "evaluation bridge for memory retrieval fusion", "source": [ "https://github.com/ruvnet/ruflo/issues/3019", "https://github.com/ruvnet/ruflo/pull/3020" ], "alternative": "fak memory/context benchmarks and claim gates", "disposition": "stay_minimal", "reason": "The source is a Ruflo-specific BM25/semantic benchmark bridge, not evidence of a better fak-native memory primitive." }, { "candidate": "persisted swarm-health reporting", "source": [ "https://github.com/ruvnet/ruflo/pull/3017" ], "alternative": "fak DOS liveness, productivity, lease, and ultracode status witnesses", "disposition": "already_owned", "reason": "fak already exposes stronger witnessed scheduler health rather than a self-reported swarm status." }, { "candidate": "doctor checks for runtime/environment drift", "source": [ "https://github.com/ruvnet/ruflo/issues/3022", "https://github.com/ruvnet/ruflo/issues/3023", "https://github.com/ruvnet/ruflo/pull/3028" ], "alternative": "fak doctor/setup/preflight and deterministic gates", "disposition": "already_owned", "reason": "The fixes are Ruflo dependency and environment details; the reusable diagnostic pattern is already native to fak." } ], "issue_tracking": { "study_issue": "https://github.com/anthony-chaudhary/fak/issues/8931", "filed_borrows": [], "reason": "No candidate survived source validation and fak self-query as a distinct, evidence-backed borrow." } } }