surface.json

{
  "generated_at_utc": "2026-05-10T00:21:01+00:00",
  "legacy_endpoint_map": {
    "adapt_plan": "plan",
    "audit_list": "explore",
    "auto": "transmute",
    "auto_apply": "plan",
    "auto_plan": "plan",
    "auto_step": "plan",
    "call_graph": "explore",
    "certify": "audit",
    "change_review": "audit",
    "cherry": "transmute",
    "cna_check": "audit",
    "code_intel": "explore",
    "commit_compose": "plan",
    "compose_tools": "plan",
    "context_pack": "plan",
    "discover": "explore",
    "doctor": "audit",
    "emergent": "explore",
    "emergent_scan": "explore",
    "emergent_swarm": "explore",
    "enforce": "audit",
    "enhancement": "hive",
    "evolve": "loop",
    "explain_repo": "explore",
    "exported_api_check": "audit",
    "finalize": "transmute",
    "forge_locate": "plan",
    "forge_util": "plan",
    "get_recipe": "plan",
    "guard_install": "audit",
    "handoff": "hive",
    "harvest": "explore",
    "hive_agent": "hive",
    "hive_consensus": "hive",
    "iterate": "loop",
    "lineage": "explore",
    "list_recipes": "plan",
    "load_policy": "plan",
    "maintain": "audit",
    "manifest_diff": "audit",
    "plan_apply": "plan",
    "preflight": "audit",
    "preflight_change": "audit",
    "recipes": "plan",
    "recon": "explore",
    "rollback_plan": "audit",
    "score_patch": "audit",
    "select_tests": "audit",
    "session": "hive",
    "sidecar_validate": "audit",
    "smell_scan": "explore",
    "synergy": "explore",
    "synergy_scan": "explore",
    "tool_factory": "plan",
    "trust_gate_response": "audit",
    "verify": "audit",
    "what_failed_last_time": "explore",
    "why_did_this_change": "explore",
    "wire": "audit",
    "workflow": "plan",
    "worktree_status": "audit"
  },
  "package_version": "0.87.0",
  "recipes": [
    {
      "checklist_steps": 5,
      "description": "Add a new top-level Forge verb (or sibling-tool verb) with tier-clean wiring.",
      "name": "add_cli_command",
      "schema_version": "atomadic-forge.recipe/v1",
      "validation_gate_steps": 2
    },
    {
      "checklist_steps": 5,
      "description": "Implement a feature that combines existing a1 helpers and a2 composites under an a3 module.",
      "name": "add_feature",
      "schema_version": "atomadic-forge.recipe/v1",
      "validation_gate_steps": 3
    },
    {
      "checklist_steps": 7,
      "description": "Bump the package version in pyproject.toml, add a CHANGELOG entry, and create a git tag.",
      "name": "bump_version",
      "schema_version": "atomadic-forge.recipe/v1",
      "validation_gate_steps": 3
    },
    {
      "checklist_steps": 17,
      "description": "Complete agent development cycle: orient \u2192 preflight \u2192 edit \u2192 validate \u2192 end-of-cycle scan. Enforces monadic tier law, CNA naming conventions, and closes with emergent/synergy/certify.",
      "name": "dev_cycle",
      "schema_version": "atomadic-forge.recipe/v1",
      "validation_gate_steps": 5
    },
    {
      "checklist_steps": 5,
      "description": "Debug and fix when forge certify reports ran=False or pass_ratio=0 despite pytest passing locally.",
      "name": "fix_test_detection",
      "schema_version": "atomadic-forge.recipe/v1",
      "validation_gate_steps": 2
    },
    {
      "checklist_steps": 5,
      "description": "Resolve a tier upward-import violation surfaced by forge wire (F0040\u2013F0049).",
      "name": "fix_wire_violation",
      "schema_version": "atomadic-forge.recipe/v1",
      "validation_gate_steps": 3
    },
    {
      "checklist_steps": 11,
      "description": "Golden path for agents working ON the Forge itself. Enforces session-start health gates, per-edit verification, and a strict session-end commit gate. Prevents metric drift, undocumented dispatch routes, and test-gate bypass \u2014 the failure modes documented in v0.86.0 stabilisation.",
      "name": "forge_self",
      "schema_version": "atomadic-forge.recipe/v1",
      "validation_gate_steps": 3
    },
    {
      "checklist_steps": 9,
      "description": "Audit every source file's name against the CNA (Convention Naming Adherence) rules for its tier. Files that don't follow the convention are flagged; rename them or move them to the correct tier.",
      "name": "naming_check",
      "schema_version": "atomadic-forge.recipe/v1",
      "validation_gate_steps": 2
    },
    {
      "checklist_steps": 5,
      "description": "Register Forge as an MCP server in a coding-agent client (Cursor / Claude Code / Aider / Devin).",
      "name": "publish_mcp",
      "schema_version": "atomadic-forge.recipe/v1",
      "validation_gate_steps": 1
    },
    {
      "checklist_steps": 6,
      "description": "Add CI + CHANGELOG entry + version bump + signed Receipt before tagging a release.",
      "name": "release_hardening",
      "schema_version": "atomadic-forge.recipe/v1",
      "validation_gate_steps": 4
    }
  ],
  "recipes_count": 10,
  "redaction_hooks": [],
  "schema_version": "atomadic-forge.surface/v1",
  "schema_version_registry": {
    "audit": "atomadic-forge.audit/v4",
    "create": "atomadic-forge.create/v1",
    "explore": "atomadic-forge.explore/v5",
    "hive": "atomadic-forge.hive/v4",
    "inspect": "atomadic-forge.inspect/v1",
    "loop": "atomadic-forge.loop/v2",
    "nexus": "atomadic-forge.nexus_call/v2",
    "plan": "atomadic-forge.agent_plan/v5",
    "transmute": "atomadic-forge.transmute/v2",
    "welcome": "atomadic-forge.welcome/v1",
    "wisdom": "atomadic-forge.wisdom/v2"
  },
  "tools": [
    {
      "description": "Use this when: you need to check, fix, verify, or safely change a repo. action='certify': 0-100 quality score (docs, tests, tier layout, import discipline). emit_receipt=true produces Forge Receipt v1 JSON. skip_tests=true for fast mode (~500ms). action='wire': finds every upward-import violation. suggest_repairs=true adds fix hints. action='enforce': apply mechanical fixes for wire violations (apply=false=dry-run). action='validate': validates a .forge sidecar TOML \u2014 required fields + types. action='guard': installs four enforcement layers (pre-commit hook, GHA workflow, pyproject contract, CONTRIBUTING block). apply=false returns planned writes. action='composite': single go/no-go verdict \u2014 wire+certify always, score_patch+preflight_change when diff/intent supplied; returns PASS/REFINE/FAIL. action='gate': deterministic hallucination detector for LLM responses \u2014 catches unresolved imports, syntax errors, stubs, false capability claims. action='health': Forge env diagnostic \u2014 version, Python, platform, optional deps. action='check': pre-edit guardrail \u2014 given intent + proposed_files, returns each file's tier, forbidden imports, affected tests, scope verdict. action='score': patch risk scorer \u2014 submit a unified diff, get architecture/test/public_API/release risk scores and needs_human_review. action='tests': minimum + full-confidence test set selection per intent. action='cna': Compose-Not-Add check \u2014 verify a proposed symbol is not duplicating an existing one (name + body-hash similarity). Returns PASS/REFINE/REJECT. action='rollback': structured undo plan \u2014 files to remove, caches to clean, docs to restore, tests to rerun, risk level. action='diff': compares two Forge manifests side-by-side. action='ast_scope': multi-repo AST blueprint + deterministic edit locks; attest_nexus=true mirrors locks to AAAA-Nexus lineage when a key is present, and otherwise returns a premium/x402 hint without failing. action='surface_gaps': find a1 entry points missing MCP or CLI coverage. action='wire_stubs': generate MCP handler + CLI stub + test skeleton for an unwired a1 function. action='dead_code': find defined-but-unreferenced symbols. action='maintainability': Maintainability Index per module (A/B/C/D). action='concept_bridge': synthesis plans from harvest candidates below TAU_TRUST. action='doc_update': regenerate README/CHANGELOG and extended docs (IDE_INTEGRATION.md, WHITEPAPER.md, AGENTS_GUIDE.md) from forge_metrics.json \u2014 zero LLM tokens. sections param: comma-separated readme,changelog,extended_docs. action='doc_drift': detect stale MCP tool/action/test counts across all key doc files before running doc_update. Returns drift_items list with file+line+found/expected.",
      "handler_qualname": "atomadic_forge.a1_at_functions.mcp_protocol._tool_audit",
      "input_schema": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "description": "'certify' \u2014 quality score; 'wire' \u2014 import violations; 'enforce' \u2014 fix wire violations; 'validate' \u2014 check sidecar TOML; 'guard' \u2014 install enforcement layers; 'composite' \u2014 go/no-go verdict; 'gate' \u2014 LLM hallucination check; 'health' \u2014 env diagnostic; 'check' \u2014 pre-edit guardrail; 'score' \u2014 patch risk scoring; 'tests' \u2014 select affected tests; 'cna' \u2014 Compose-Not-Add dedup check; 'rollback' \u2014 undo plan; 'diff' \u2014 compare two manifests; 'ast_scope' \u2014 AST blueprint + local locks + optional Nexus attestation; 'dead_code' \u2014 unreferenced symbols; 'maintainability' \u2014 MI per module; 'concept_bridge' \u2014 synthesis plans; 'surface_gaps' \u2014 find unwired a1 functions; 'wire_stubs' \u2014 generate MCP+CLI+test stubs; 'doc_update' \u2014 regenerate README/CHANGELOG/extended docs from metrics; 'doc_drift' \u2014 detect stale MCP/test counts across all doc files.",
            "enum": [
              "certify",
              "wire",
              "enforce",
              "validate",
              "guard",
              "composite",
              "gate",
              "health",
              "check",
              "score",
              "tests",
              "cna",
              "rollback",
              "diff",
              "ast_scope",
              "surface_gaps",
              "wire_stubs",
              "dead_code",
              "maintainability",
              "concept_bridge",
              "auto_wire",
              "doc_update",
              "doc_drift"
            ],
            "type": "string"
          },
          "agent_ids": {
            "description": "[ast_scope] Agent ids for round-robin locks.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "apply": {
            "default": false,
            "description": "[enforce/guard] false=dry-run, true=write.",
            "type": "boolean"
          },
          "attest_nexus": {
            "default": false,
            "description": "[ast_scope] Mirror locks to Nexus lineage if configured.",
            "type": "boolean"
          },
          "changed_files": {
            "description": "[tests/rollback] Files that were changed.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "diff": {
            "description": "[composite/score] Unified diff (git diff format).",
            "type": "string"
          },
          "emit_receipt": {
            "default": false,
            "type": "boolean"
          },
          "fail_under": {
            "default": 75.0,
            "description": "[composite] Certify score below this \u2192 FAIL.",
            "type": "number"
          },
          "function": {
            "description": "[wire_stubs] Public function name (e.g. 'compute_git_churn').",
            "type": "string"
          },
          "intent": {
            "description": "[composite/check/tests] Change intent.",
            "type": "string"
          },
          "known_capabilities": {
            "description": "[gate] Capability ids the project ships.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "left": {
            "description": "[diff] First manifest as JSON string.",
            "type": "string"
          },
          "left_path": {
            "description": "[diff] Path to first manifest file.",
            "type": "string"
          },
          "local_pkg_prefix": {
            "description": "[gate] Dotted prefix for local packages.",
            "type": "string"
          },
          "max_cyclomatic": {
            "default": 10,
            "description": "[guard] Max cyclomatic complexity.",
            "minimum": 1,
            "type": "integer"
          },
          "max_nodes": {
            "default": 200,
            "description": "[ast_scope] Maximum AST nodes to include.",
            "type": "integer"
          },
          "min_certify_score": {
            "default": 90,
            "description": "[guard] Min certify score threshold.",
            "maximum": 100,
            "minimum": 0,
            "type": "integer"
          },
          "module": {
            "description": "[wire_stubs] a1 module stem (e.g. 'git_churn').",
            "type": "string"
          },
          "name_top_n": {
            "default": 10,
            "description": "[cna] Top-N name matches.",
            "type": "integer"
          },
          "nexus_intent": {
            "description": "[ast_scope] Nexus lineage intent.",
            "type": "string"
          },
          "overwrite": {
            "default": false,
            "description": "[guard] Overwrite existing guard files.",
            "type": "boolean"
          },
          "package": {
            "type": [
              "string",
              "null"
            ]
          },
          "package_subdir": {
            "description": "[cna] Package subdirectory.",
            "type": "string"
          },
          "project_root": {
            "type": "string"
          },
          "project_roots": {
            "description": "[ast_scope] One or more repo roots.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "proposed_body": {
            "description": "[cna] Optional Python source for body-hash overlap.",
            "type": "string"
          },
          "proposed_files": {
            "description": "[composite/check] Files to change.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "proposed_name": {
            "description": "[cna] Bare or dotted name of the proposed symbol.",
            "type": "string"
          },
          "response": {
            "description": "[gate] LLM response text to check.",
            "type": "string"
          },
          "right": {
            "description": "[diff] Second manifest as JSON string.",
            "type": "string"
          },
          "right_path": {
            "description": "[diff] Path to second manifest file.",
            "type": "string"
          },
          "scope_threshold": {
            "default": 8,
            "description": "[check] Max files before scope warning.",
            "type": "integer"
          },
          "skip_tests": {
            "default": false,
            "description": "[certify] Fast structural-only mode.",
            "type": "boolean"
          },
          "source": {
            "type": "string"
          },
          "source_file": {
            "description": "[validate] Source file whose sidecar to validate.",
            "type": "string"
          },
          "strict_mode": {
            "default": false,
            "description": "[guard] Block on ANY score drop.",
            "type": "boolean"
          },
          "suggest_repairs": {
            "default": false,
            "type": "boolean"
          },
          "targets": {
            "description": "[ast_scope] Full qualnames or suffixes to lock.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "ttl_secs": {
            "default": 3600,
            "description": "[ast_scope] Lock TTL in seconds.",
            "type": "integer"
          }
        },
        "required": [
          "action"
        ],
        "type": "object"
      },
      "name": "audit",
      "schema_version": "atomadic-forge.audit/v4"
    },
    {
      "description": "Use this when: you have an INTENT (one-line description of a new package) plus one or more SEED REPOS to harvest from, and want a shippable pip-installable package as output. Runs the full Phase 1 pipeline: emergent_swarm cross-repo composition discovery -> materialize top-N candidates into a tier-organized package -> optional certify run on the new package. Returns the create receipt (intent, seed_repos, scan_summary, materialize report, scan_report_path). The scan_report_path lets callers re-run materialize with different selections without re-scanning.",
      "handler_qualname": "atomadic_forge.a1_at_functions.mcp_protocol._tool_create",
      "input_schema": {
        "additionalProperties": false,
        "properties": {
          "corroborate_with_call_graph": {
            "default": true,
            "description": "Corroborate candidates via AST call graph.",
            "type": "boolean"
          },
          "cross_repo_bonus": {
            "default": 15.0,
            "description": "Score bonus for cross-repo compositions.",
            "type": "number"
          },
          "domain_jump_required": {
            "default": true,
            "description": "Require cross-domain composition (default true).",
            "type": "boolean"
          },
          "intent": {
            "description": "One-line description of the package to assemble.",
            "type": "string"
          },
          "out_dir": {
            "description": "Where to write the new package (created if missing).",
            "type": "string"
          },
          "package": {
            "description": "Importable name of the new package (Python identifier).",
            "type": "string"
          },
          "project_root": {
            "type": "string"
          },
          "require_pure": {
            "default": false,
            "description": "Require pure functions only (no I/O).",
            "type": "boolean"
          },
          "run_certify": {
            "default": true,
            "description": "Run certify on the new package after materialize.",
            "type": "boolean"
          },
          "seed_repos": {
            "description": "Paths to repos to scan as composition sources.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "swarm_max_depth": {
            "default": 3,
            "description": "emergent_swarm max composition depth (cap=23).",
            "maximum": 23,
            "minimum": 1,
            "type": "integer"
          },
          "top_n": {
            "default": 5,
            "description": "Materialize the top-N candidates (default 5).",
            "maximum": 50,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "intent",
          "seed_repos",
          "out_dir",
          "package"
        ],
        "type": "object"
      },
      "name": "create",
      "schema_version": "atomadic-forge.create/v1"
    },
    {
      "description": "Use this when: you need to understand, analyze, or discover patterns in a repo. action='recon' (default): maps every public symbol into the 5 monadic tiers. action='explain': plain-English orientation \u2014 one-liner, core flow, do_not_break. action='call_graph': AST BFS walk \u2014 callers/callees of a target symbol. action='call_graph_summary': whole-package portfolio \u2014 orphans, hotspots, max depth. action='smell_scan': CC monsters, long functions, dup bodies (smell_score 0-100). action='churn': file-level git churn \u2014 hotspot/stable files, avg/median commits. action='surface_gaps': find a1 entry points missing MCP or CLI wiring (the gap punch-list). action='capability_scout': search GitHub for repos matching capability queries. action='dead_code': find defined-but-unreferenced symbols (vulture synthesis). action='maintainability': compute Maintainability Index per module (radon MI). action='concept_bridge': convert harvest candidates below TAU_TRUST into synthesis plans. action='lineage': query the .atomadic-forge lineage log (mode=all/by_file/failed_for_area). action='harvest': cross-repo cherry-hunter \u2014 diffs target vs source repos, ranks graft candidates by trust-gated confidence (max-depth 23, no LLM). action='synergy': intra-repo scanner \u2014 finds CLI verbs / a3 features that compose well. action='scan': single-repo emergent compositions (top_n, include_chains). action='swarm': multi-repo portfolio emergent scan (N\u226423) \u2014 cross-repo bonus. All actions: no LLM invoked.",
      "handler_qualname": "atomadic_forge.a1_at_functions.mcp_protocol._tool_explore",
      "input_schema": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "default": "recon",
            "description": "'recon' \u2014 tier map; 'explain' \u2014 narrative; 'call_graph' \u2014 symbol graph; 'call_graph_summary' \u2014 package portfolio; 'smell_scan' \u2014 code smell; 'churn' \u2014 git file churn; 'surface_gaps' \u2014 wiring gap list; 'capability_scout' \u2014 find harvest targets; 'dead_code' \u2014 unreferenced symbols; 'maintainability' \u2014 MI per module; 'concept_bridge' \u2014 synthesis plans from harvest candidates; 'lineage' \u2014 audit log; 'harvest' \u2014 cross-repo grafts; 'synergy' \u2014 composition patterns; 'scan' \u2014 single-repo emergent; 'swarm' \u2014 multi-repo emergent.",
            "enum": [
              "recon",
              "explain",
              "call_graph",
              "call_graph_summary",
              "smell_scan",
              "churn",
              "surface_gaps",
              "capability_scout",
              "dead_code",
              "maintainability",
              "concept_bridge",
              "lineage",
              "harvest",
              "synergy",
              "scan",
              "swarm",
              "agent_plan"
            ],
            "type": "string"
          },
          "area": {
            "description": "[lineage] Required when mode='failed_for_area'.",
            "type": "string"
          },
          "cc_threshold": {
            "default": 10,
            "description": "[smell_scan] Flag functions with CC > this.",
            "type": "integer"
          },
          "corroborate_with_call_graph": {
            "default": true,
            "description": "[swarm] Cross-validate edges against call_graph.",
            "type": "boolean"
          },
          "cross_repo_bonus": {
            "default": 15.0,
            "description": "[swarm] Score bonus per extra origin_repo.",
            "type": "number"
          },
          "depth": {
            "default": "agent",
            "type": "string"
          },
          "direction": {
            "default": "both",
            "description": "[call_graph] Walk direction.",
            "enum": [
              "callers",
              "callees",
              "both"
            ],
            "type": "string"
          },
          "domain_jump_required": {
            "default": true,
            "description": "[swarm] Require domain jump.",
            "type": "boolean"
          },
          "file": {
            "description": "[lineage] Required when mode='by_file'.",
            "type": "string"
          },
          "include_chains": {
            "default": false,
            "description": "[scan] Include full chain + score_breakdown.",
            "type": "boolean"
          },
          "include_details": {
            "default": false,
            "description": "[synergy] Include full detail blocks.",
            "type": "boolean"
          },
          "loc_threshold": {
            "default": 50,
            "description": "[smell_scan] Flag functions with body LOC > this.",
            "type": "integer"
          },
          "max_chains": {
            "default": 5000,
            "description": "[swarm] Max chains to evaluate.",
            "type": "integer"
          },
          "max_depth": {
            "default": 3,
            "description": "[call_graph] BFS depth cap; [scan/swarm] chain depth cap.",
            "maximum": 10,
            "minimum": 1,
            "type": "integer"
          },
          "min_score": {
            "default": 30.0,
            "description": "[capability_scout] Min harvest-confidence score to include.",
            "type": "number"
          },
          "mode": {
            "default": "all",
            "description": "[lineage] Query mode.",
            "enum": [
              "all",
              "by_file",
              "failed_for_area"
            ],
            "type": "string"
          },
          "package": {
            "description": "[call_graph/smell_scan/synergy/scan] Package name.",
            "type": "string"
          },
          "package_subdir": {
            "description": "[smell_scan] Optional subdir under project_root.",
            "type": "string"
          },
          "per_query": {
            "default": 8,
            "description": "[capability_scout] Max GitHub results per query (\u226430).",
            "type": "integer"
          },
          "project_root": {
            "type": "string"
          },
          "qualname": {
            "description": "[call_graph] Target symbol qualname.",
            "type": "string"
          },
          "queries": {
            "description": "[capability_scout] Comma-separated or list of capability search queries.",
            "items": {
              "type": "string"
            },
            "type": [
              "string",
              "array"
            ]
          },
          "repos": {
            "description": "[recon] list of repo paths (max 23); [swarm] list of {src_root, package} objects.",
            "items": {
              "type": "string"
            },
            "maxItems": 23,
            "minItems": 1,
            "type": "array"
          },
          "require_pure": {
            "default": false,
            "description": "[swarm] Require all symbols to be pure.",
            "type": "boolean"
          },
          "since": {
            "default": "",
            "description": "[churn] Git date filter (e.g. '6 months ago'). Empty = all time.",
            "type": "string"
          },
          "sources": {
            "description": "[harvest] Source repos. Max 23.",
            "items": {
              "type": "string"
            },
            "maxItems": 23,
            "minItems": 1,
            "type": "array"
          },
          "src_only": {
            "default": true,
            "description": "[churn/call_graph_summary] Restrict to src/ files only.",
            "type": "boolean"
          },
          "target": {
            "description": "[recon/harvest] Repo path.",
            "type": "string"
          },
          "top_n": {
            "default": 10,
            "description": "[synergy/scan/swarm] Max candidates returned.",
            "type": "integer"
          },
          "top_n_findings": {
            "default": 20,
            "description": "[smell_scan] Cap findings per category (0=unlimited).",
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "explore",
      "schema_version": "atomadic-forge.explore/v5"
    },
    {
      "description": "Use this when: managing the multi-agent hive, coordinating consensus, or recording agent handoffs and enhancement proposals. Lifecycle: action='register' \u2014 declare an agent's lane (role, capabilities, write_lanes, subscribes_to), max-depth 23. action='list' \u2014 see all agents. action='deactivate' \u2014 graceful shutdown. action='observe' \u2014 pull events since cursors. Consensus: action='propose' \u2014 open a cross-agent proposal (returns consensus_id). action='vote' \u2014 cast a vote (approve|reject|refine|abstain). action='needs_vote' \u2014 proposals awaiting your vote. action='result' \u2014 current verdict; record=true freezes it. action='recap' \u2014 full lifecycle of one consensus. Session: action='handoff_create' \u2014 write a structured agent-to-agent transfer; axiom_guard_status must be PASS|QUARANTINE. action='handoff_list' \u2014 recent handoffs. action='enhance_propose' \u2014 record a tool/feature proposal for human review. action='enhance_list' \u2014 read prior proposals. All actions are pure: no LLM.",
      "handler_qualname": "atomadic_forge.a1_at_functions.mcp_protocol._tool_hive",
      "input_schema": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "description": "Lifecycle: register|list|deactivate|observe. Consensus: propose|vote|needs_vote|result|recap. Session: handoff_create|handoff_list|enhance_propose|enhance_list.",
            "enum": [
              "register",
              "list",
              "deactivate",
              "observe",
              "propose",
              "vote",
              "needs_vote",
              "result",
              "recap",
              "handoff_create",
              "handoff_list",
              "enhance_propose",
              "enhance_list"
            ],
            "type": "string"
          },
          "agent_name": {
            "description": "[register/deactivate/observe/needs_vote/handoff] Agent name.",
            "type": "string"
          },
          "axiom_guard_status": {
            "default": "PASS",
            "enum": [
              "PASS",
              "QUARANTINE"
            ],
            "type": "string"
          },
          "capabilities": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "consensus_id": {
            "description": "[vote/result/recap] Target consensus id.",
            "type": "string"
          },
          "description": {
            "description": "[enhance_propose] Description.",
            "type": "string"
          },
          "evidence": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "files_created": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "files_modified": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "identity_claim": {
            "type": [
              "string",
              "null"
            ]
          },
          "include_deactivated": {
            "default": false,
            "type": "boolean"
          },
          "intent": {
            "description": "[propose/enhance_propose] Intent.",
            "type": "string"
          },
          "key_context": {
            "type": "string"
          },
          "limit": {
            "default": 50,
            "maximum": 500,
            "minimum": 1,
            "type": "integer"
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "payload": {
            "description": "[propose] Optional payload.",
            "type": "object"
          },
          "pending_tasks": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "project_root": {
            "type": "string"
          },
          "proposer": {
            "description": "[propose] Proposing agent name.",
            "type": "string"
          },
          "rationale": {
            "description": "[vote] Optional rationale.",
            "type": [
              "string",
              "null"
            ]
          },
          "record": {
            "default": false,
            "description": "[result] Freeze the verdict when true.",
            "type": "boolean"
          },
          "role": {
            "description": "[register] forge|cognition|doc|research|<custom>",
            "type": "string"
          },
          "session_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "since_consensus_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "since_wisdom_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "subscribes_to": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "test_results": {
            "additionalProperties": false,
            "properties": {
              "failed": {
                "minimum": 0,
                "type": "integer"
              },
              "passed": {
                "minimum": 0,
                "type": "integer"
              },
              "skipped": {
                "minimum": 0,
                "type": "integer"
              }
            },
            "type": "object"
          },
          "title": {
            "description": "[enhance_propose] Proposal title.",
            "type": "string"
          },
          "trust_threshold": {
            "default": 0.75,
            "maximum": 1.0,
            "minimum": 0.0,
            "type": "number"
          },
          "vote": {
            "description": "[vote] Vote value.",
            "enum": [
              "approve",
              "reject",
              "refine",
              "abstain"
            ],
            "type": "string"
          },
          "voter": {
            "description": "[vote] Voting agent name.",
            "type": "string"
          },
          "warnings": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "work_completed": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "write_lanes": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "action"
        ],
        "type": "object"
      },
      "name": "hive",
      "schema_version": "atomadic-forge.hive/v4"
    },
    {
      "description": "Use this when: you need low-level AST inspection or repo-structure reads that are too fine-grained for explore or audit. action='body': extract the full source body of a named function or class. action='symbol': extract a named symbol (with its imports) from a source file. action='class_signals': detect class-level signals (abstract, dataclass, protocol, etc.). action='ast_scope_blueprint': build a multi-repo AST scope blueprint (node set + import graph) for deterministic edit planning. action='mint_ast_locks': mint time-bounded edit locks from an existing blueprint. action='add_node': add a node to an existing AST scope (returns updated blueprint). action='classify_repo_layout': detect how a repo is organized (monadic, src-layout, flat, poetry, etc.). action='fingerprint_repo': SHA-256 normalized-AST fingerprint per a1 module (idempotent content hash, not file hash). action='synthesis_plan': extract an actionable synthesis plan from harvest candidates below TAU_TRUST. action='swarm_repo_specs': build batch repo-spec list for multi-repo operations (input to emergent_swarm / harvest). All actions: no LLM invoked.",
      "handler_qualname": "atomadic_forge.a1_at_functions.mcp_protocol._tool_inspect",
      "input_schema": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "description": "'body' \u2014 extract function/class source; 'symbol' \u2014 extract named symbol + imports; 'class_signals' \u2014 detect abstract/dataclass/protocol; 'ast_scope_blueprint' \u2014 multi-repo AST scope for edit planning; 'mint_ast_locks' \u2014 time-bounded edit locks from blueprint; 'add_node' \u2014 add node to existing AST scope; 'classify_repo_layout' \u2014 detect repo layout style; 'fingerprint_repo' \u2014 SHA-256 AST fingerprint per module; 'synthesis_plan' \u2014 synthesis plan from harvest candidates; 'swarm_repo_specs' \u2014 build batch repo specs.",
            "enum": [
              "body",
              "symbol",
              "class_signals",
              "ast_scope_blueprint",
              "mint_ast_locks",
              "add_node",
              "classify_repo_layout",
              "fingerprint_repo",
              "synthesis_plan",
              "swarm_repo_specs"
            ],
            "type": "string"
          },
          "agent_ids": {
            "description": "[ast_scope_blueprint/mint_ast_locks] Agent ids.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "blueprint": {
            "description": "[mint_ast_locks] Serialized blueprint (JSON string).",
            "type": "string"
          },
          "candidates": {
            "description": "[synthesis_plan] Harvest candidate objects.",
            "items": {
              "type": "object"
            },
            "type": "array"
          },
          "language": {
            "description": "[body] Source language.",
            "enum": [
              "python",
              "javascript",
              "typescript"
            ],
            "type": "string"
          },
          "max_nodes": {
            "default": 200,
            "description": "[ast_scope_blueprint] Max AST nodes to include.",
            "type": "integer"
          },
          "node": {
            "description": "[add_node] Node dict to add to scope.",
            "type": "object"
          },
          "project_root": {
            "type": "string"
          },
          "project_roots": {
            "description": "[ast_scope_blueprint] Repo root paths.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "repo_paths": {
            "description": "[swarm_repo_specs] Comma-separated repo paths.",
            "type": "string"
          },
          "source_file": {
            "description": "[symbol] Path to source file.",
            "type": "string"
          },
          "source_path": {
            "description": "[body] Absolute path to source file.",
            "type": "string"
          },
          "symbol_name": {
            "description": "[body/symbol] Name of the function or class.",
            "type": "string"
          },
          "target": {
            "description": "[class_signals] Path or module to inspect.",
            "type": "string"
          },
          "targets": {
            "description": "[ast_scope_blueprint/mint_ast_locks] Qualnames to lock.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "ttl_secs": {
            "default": 3600,
            "description": "[ast_scope_blueprint/mint_ast_locks] Lock TTL (seconds).",
            "type": "integer"
          }
        },
        "required": [
          "action"
        ],
        "type": "object"
      },
      "name": "inspect",
      "schema_version": "atomadic-forge.inspect/v1"
    },
    {
      "description": "Use this when: driving an LLM-guided iteration session against the repo. Forge has no embedded LLM \u2014 these actions return prompts you feed to your own LLM, then the response comes back here for the next round. action='iterate': scaffold a package and emit the first LLM prompt; returns session_id for resume. action='resume': feed the LLM's response back; advances the session and returns either the next prompt or the final result. action='evolve': start a recursive multi-round session (rounds, max-depth 23 system cap, stop_on_regression). action='evolve_step': advance the active evolve round.",
      "handler_qualname": "atomadic_forge.a1_at_functions.mcp_protocol._tool_loop",
      "input_schema": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "default": "iterate",
            "description": "'iterate' \u2014 start a single-round iterate session; 'resume' \u2014 continue with LLM response; 'evolve' \u2014 start a recursive multi-round session; 'evolve_step' \u2014 advance an evolve round.",
            "enum": [
              "iterate",
              "resume",
              "evolve",
              "evolve_step"
            ],
            "type": "string"
          },
          "evolve_session_id": {
            "description": "[evolve_step] Session id from evolve call.",
            "type": "string"
          },
          "intent": {
            "description": "[iterate/evolve] What you want the LLM to do.",
            "type": "string"
          },
          "iterations_per_round": {
            "default": 4,
            "description": "[evolve] Iterations per round.",
            "minimum": 1,
            "type": "integer"
          },
          "language": {
            "default": "python",
            "description": "[iterate/evolve] Target language.",
            "enum": [
              "python",
              "javascript",
              "typescript"
            ],
            "type": "string"
          },
          "max_iterations": {
            "default": 5,
            "description": "[iterate] Hard cap on resume calls.",
            "type": "integer"
          },
          "output": {
            "description": "[iterate/evolve] Output directory.",
            "type": "string"
          },
          "package": {
            "description": "[iterate/evolve] Package name.",
            "type": [
              "string",
              "null"
            ]
          },
          "project_root": {
            "type": "string"
          },
          "response": {
            "description": "[resume] Raw LLM response text.",
            "type": "string"
          },
          "rounds": {
            "default": 3,
            "description": "[evolve] Max rounds; D_max cap=23.",
            "maximum": 23,
            "minimum": 1,
            "type": "integer"
          },
          "seed_repos": {
            "description": "[iterate/evolve] Seed repo paths.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "session_id": {
            "description": "[resume] Session id from iterate call.",
            "type": "string"
          },
          "stagnation_threshold": {
            "default": 3,
            "description": "[evolve] Halt after N flat rounds.",
            "type": "integer"
          },
          "stop_on_regression": {
            "default": false,
            "description": "[evolve] Halt if score drops.",
            "type": "boolean"
          },
          "target_score": {
            "default": 75.0,
            "description": "[iterate/evolve] Target certify score.",
            "type": "number"
          }
        },
        "type": "object"
      },
      "name": "loop",
      "schema_version": "atomadic-forge.loop/v2"
    },
    {
      "description": "Use this when: calling LIVE AAAA-Nexus primitives. Requires ATOMADIC_MASTER_KEY or ATOMADIC_SUBSCRIPTION_KEY in env. op='identity_verify' \u2014 verify a DID/identity claim against Nexus. op='federation_mint' \u2014 mint a portable federation token (did, scope, ttl_secs). op='authorize_action' \u2014 gate whether subject can invoke action against resource. op='sys_trust_gate' \u2014 drift/hallucination check on a claim; returns PASS/FAIL. op='contract_verify' \u2014 verify a manifest hasn't drifted since subscription. op='lineage_record' \u2014 attest an intent+payload event to Nexus lineage. op='ratchet_register' \u2014 register a monotonic anti-replay stamp.",
      "handler_qualname": "atomadic_forge.a1_at_functions.mcp_protocol._tool_nexus",
      "input_schema": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "description": "authorize_action: the Nexus action being authorized",
            "type": "string"
          },
          "claim": {
            "description": "sys_trust_gate: claim object to evaluate",
            "type": "object"
          },
          "did": {
            "description": "federation_mint: DID to bind",
            "type": "string"
          },
          "identity": {
            "description": "identity_verify: DID or identity string",
            "type": "string"
          },
          "intent": {
            "description": "lineage_record: intent statement",
            "type": "string"
          },
          "manifest_hash": {
            "description": "contract_verify: expected manifest hash",
            "type": "string"
          },
          "op": {
            "description": "Nexus primitive to call",
            "enum": [
              "identity_verify",
              "federation_mint",
              "authorize_action",
              "sys_trust_gate",
              "contract_verify",
              "lineage_record",
              "ratchet_register"
            ],
            "type": "string"
          },
          "payload": {
            "description": "lineage_record: payload object",
            "type": "object"
          },
          "ratchet_id": {
            "description": "ratchet_register: ratchet identifier",
            "type": "string"
          },
          "resource": {
            "description": "authorize_action: target resource",
            "type": [
              "string",
              "null"
            ]
          },
          "scope": {
            "description": "federation_mint: scope list",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "stamp": {
            "description": "ratchet_register: monotonic stamp value",
            "type": "string"
          },
          "subject": {
            "description": "authorize_action/contract_verify/ratchet_register: subject",
            "type": "string"
          },
          "ttl_secs": {
            "default": 86400,
            "description": "federation_mint: token TTL",
            "minimum": 60,
            "type": "integer"
          }
        },
        "required": [
          "op"
        ],
        "type": "object"
      },
      "name": "nexus",
      "schema_version": "atomadic-forge.nexus_call/v2"
    },
    {
      "description": "Use this when: you need to orient, plan, scaffold, or assemble a commit on a repo. action='context': first-call context bundle \u2014 repo purpose, architecture law, tier map, blockers, best next action, test commands, policy, workflow_recipe. action='compose': match a goal keyword to a named workflow recipe. action='policy': return the raw agent policy dict without full orientation. action='recipes': list the full recipe catalogue or fetch one named recipe. action='generate' (default): runs scout+wire+certify, emits ranked agent_plan/v1. action='apply': executes a saved plan (plan_id required). apply=False dry-runs. action='locate': returns insertion-point line range + preview (~1000-token saving). action='commit': assembles structured commit message (~10k-token saving). action='scaffold': generate a four-piece MCP tool scaffold (a1+a3 inserts, test block) without mutating files \u2014 forge eats forge. action='steersman': AST-lock decision pack tiny enough for a 1B semantic router. No LLM client inside forge for scaffold/compose/policy/recipes. v0.48.0: transmute pipeline (auto/cherry/finalize) moved to `transmute` tool; LLM loops (iterate/resume/evolve/evolve_step) moved to `loop` tool.",
      "handler_qualname": "atomadic_forge.a1_at_functions.mcp_protocol._tool_plan_merged",
      "input_schema": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "default": "generate",
            "description": "'context' \u2014 first-call orientation bundle; 'compose' \u2014 workflow recipe for goal; 'policy' \u2014 raw agent policy dict; 'recipes' \u2014 recipe catalogue or named recipe; 'generate' \u2014 create refactor plan; 'apply' \u2014 execute saved plan; 'locate' \u2014 find forge insertion point; 'commit' \u2014 compose commit message; 'scaffold' \u2014 generate MCP tool boilerplate; 'steersman' \u2014 1B semantic-router decision pack.",
            "enum": [
              "context",
              "compose",
              "policy",
              "recipes",
              "generate",
              "apply",
              "locate",
              "commit",
              "scaffold",
              "steersman"
            ],
            "type": "string"
          },
          "agent_ids": {
            "description": "[steersman] AST lock owners.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "apply": {
            "default": false,
            "description": "[apply] false=dry-run, true=write.",
            "type": "boolean"
          },
          "attest_nexus": {
            "default": false,
            "description": "[steersman] Mirror AST locks to Nexus if configured.",
            "type": "boolean"
          },
          "body": {
            "description": "[commit] Optional narrative tail.",
            "type": "string"
          },
          "body_description": {
            "description": "[scaffold] Tool description body.",
            "type": "string"
          },
          "capability_filter": {
            "description": "[generate] Optional adapt_plan filter.",
            "type": "object"
          },
          "card_id": {
            "description": "[apply] Single-card; omit for all-applyable.",
            "type": "string"
          },
          "commit_type": {
            "default": "ship",
            "description": "[commit] Conventional-commit prefix.",
            "type": "string"
          },
          "create_module": {
            "default": false,
            "description": "[scaffold] Emit a starter module template.",
            "type": "boolean"
          },
          "files": {
            "description": "[context] Target or changed files for focused context.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "focus": {
            "description": "[context] Optional mode. 'change' adds file-targeted audit/test context; 'release' emphasizes the gate; 'debug' emphasizes lineage.",
            "enum": [
              "orientation",
              "change",
              "release",
              "debug"
            ],
            "type": "string"
          },
          "goal": {
            "default": "improve repo conformance",
            "description": "[generate] Improvement goal; [compose] recipe matching keyword.",
            "type": "string"
          },
          "handler_callable": {
            "description": "[scaffold] Callable name inside handler_module.",
            "type": "string"
          },
          "handler_module": {
            "description": "[scaffold] Dotted module path of impl.",
            "type": "string"
          },
          "include_coauthor": {
            "default": true,
            "description": "[commit] Include Co-Authored-By line.",
            "type": "boolean"
          },
          "input_schema": {
            "description": "[scaffold] JSON Schema for new tool.",
            "type": "object"
          },
          "intent": {
            "description": "[context/commit/generate] Intent string.",
            "type": "string"
          },
          "max_nodes": {
            "default": 200,
            "description": "[steersman] Max AST nodes in generated scope.",
            "type": "integer"
          },
          "max_questions": {
            "default": 24,
            "description": "[steersman] Max questions for the 1B router.",
            "type": "integer"
          },
          "mode": {
            "default": "improve",
            "enum": [
              "improve",
              "absorb"
            ],
            "type": "string"
          },
          "model": {
            "default": "llama3.2:1b",
            "description": "[steersman] Tiny local model name.",
            "type": "string"
          },
          "name": {
            "description": "[recipes] Optional recipe name \u2014 omit to list all, provide to fetch a single recipe's full body.",
            "type": "string"
          },
          "package": {
            "description": "[generate] Package name.",
            "type": [
              "string",
              "null"
            ]
          },
          "plan_id": {
            "description": "[apply] Required. Plan to execute.",
            "type": "string"
          },
          "point": {
            "description": "[locate] Named insertion point.",
            "enum": [
              "tools_dict",
              "all_export",
              "register_block",
              "mcp_server_imports",
              "test_pinned_set"
            ],
            "type": "string"
          },
          "project": {
            "type": "string"
          },
          "project_root": {
            "type": "string"
          },
          "project_roots": {
            "description": "[steersman] One or more repo roots.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "provider": {
            "default": "ollama",
            "description": "[steersman] Provider used when run_model=true.",
            "type": "string"
          },
          "run_model": {
            "default": false,
            "description": "[steersman] Ask provider/model for choices.",
            "type": "boolean"
          },
          "save": {
            "default": false,
            "description": "[generate] Persist the plan.",
            "type": "boolean"
          },
          "target": {
            "description": "[generate/auto/cherry/finalize] Repo path; [context] project path (defaults to project_root).",
            "type": "string"
          },
          "targets": {
            "description": "[steersman] AST qualnames or suffix targets.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "tool_name": {
            "description": "[scaffold] snake_case tool name.",
            "type": "string"
          },
          "top_n": {
            "default": 7,
            "type": "integer"
          },
          "use_this_when": {
            "description": "[scaffold] One-sentence trigger.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "plan",
      "schema_version": "atomadic-forge.agent_plan/v5"
    },
    {
      "description": "Use this when: absorbing a repo into a tier-organized package or running the full spaghetti\u2192certified pipeline. This is the FLAGSHIP. action='auto' (default): single-shot pipeline \u2014 scout\u2192cherry\u2192assimilate\u2192wire\u2192certify\u2192receipt. apply=False is a dry-run that returns the planned writes; apply=True actually materializes the package. action='cherry': produces a surgical cherry-pick manifest (cherry.json) before assimilation \u2014 pick=['all'] to take everything, or pass explicit qualnames to take a subset. action='finalize': materializes an existing cherry.json into a tier-organized package; lets you re-run with different selections without re-scanning. No LLM invoked for any action \u2014 pure deterministic absorption.",
      "handler_qualname": "atomadic_forge.a1_at_functions.mcp_protocol._tool_transmute",
      "input_schema": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "default": "auto",
            "description": "'auto' \u2014 full pipeline scout\u2192cherry\u2192assimilate\u2192wire\u2192certify; 'cherry' \u2014 produce cherry.json manifest only; 'finalize' \u2014 materialize existing cherry.json into package.",
            "enum": [
              "auto",
              "cherry",
              "finalize"
            ],
            "type": "string"
          },
          "apply": {
            "default": false,
            "description": "[auto/finalize] false=dry-run, true=write.",
            "type": "boolean"
          },
          "on_conflict": {
            "default": "rename",
            "description": "[auto/finalize] Symbol collision resolution.",
            "enum": [
              "rename",
              "first",
              "last",
              "fail"
            ],
            "type": "string"
          },
          "only_tier": {
            "description": "[cherry] Restrict to one tier.",
            "type": "string"
          },
          "output": {
            "description": "[auto/finalize] Output directory for the new package.",
            "type": "string"
          },
          "package": {
            "description": "[auto/finalize] Importable package name.",
            "type": [
              "string",
              "null"
            ]
          },
          "pick": {
            "description": "[cherry] Qualnames to pick; ['all']=everything.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "pick_all": {
            "default": false,
            "description": "[cherry] Shortcut for pick=['all'].",
            "type": "boolean"
          },
          "project_root": {
            "type": "string"
          },
          "target": {
            "description": "Source repo path to absorb from.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "transmute",
      "schema_version": "atomadic-forge.transmute/v2"
    },
    {
      "description": "RECOMMENDED FIRST CALL when an agent connects to Forge in a new session. Runs scout + certify + wire on the current repo and returns one structured response: real numbers (score, violations, symbol count), top 3 strengths, top 3 priorities, the single most-useful next call, a rendered narrative, an agent_guidance block (briefing for talking to the human user in the agent's own voice), a capability_showcase (12 headline tools grouped by job), and a safety_net (concrete Forge guarantees). Optional run_tests=true upgrades the default fast structural certify snapshot into a full pytest-backed handshake. Optional since_receipt path emits a since-last-scan diff (score delta, violation delta) so returning agents see what changed. Also useful any time you want a one-shot situation report mid-session.",
      "handler_qualname": "atomadic_forge.a1_at_functions.mcp_protocol._tool_welcome",
      "input_schema": {
        "additionalProperties": false,
        "properties": {
          "package": {
            "type": [
              "string",
              "null"
            ]
          },
          "project_root": {
            "type": "string"
          },
          "run_tests": {
            "default": false,
            "type": "boolean"
          },
          "since_receipt": {
            "type": [
              "string",
              "null"
            ]
          },
          "skip_certify": {
            "default": false,
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "name": "welcome",
      "schema_version": "atomadic-forge.welcome/v1"
    },
    {
      "description": "Use this when: interacting with the repo's institutional wisdom DB (.atomadic-forge/wisdom.jsonl). action='record' \u2014 append one lesson (insight, scope, tags, evidence, confidence). action='query' \u2014 relevance-rank entries by scope/tags/text; returns top_n with scores. action='list' \u2014 paginated dump of active entries (limit=20 by default; limit=0 for full; include_superseded=true for audit). action='recall' \u2014 top-N repo-scoped entries for a new agent (cheapest read path). action='promote' \u2014 cluster corroborated wisdom into draft recipe candidates. All actions are pure: no LLM.",
      "handler_qualname": "atomadic_forge.a1_at_functions.mcp_protocol._tool_wisdom",
      "input_schema": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "description": "record | query | list | recall | promote",
            "enum": [
              "record",
              "query",
              "list",
              "recall",
              "promote"
            ],
            "type": "string"
          },
          "agent_name": {
            "default": "anonymous",
            "description": "record: recording agent name",
            "type": "string"
          },
          "confidence": {
            "default": 0.5,
            "description": "record: confidence 0-1",
            "maximum": 1,
            "minimum": 0,
            "type": "number"
          },
          "evidence": {
            "description": "record: evidence paths (file:line refs)",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "include_bodies": {
            "default": false,
            "description": "promote: include full markdown bodies",
            "type": "boolean"
          },
          "include_superseded": {
            "default": false,
            "description": "list: include superseded entries",
            "type": "boolean"
          },
          "insight": {
            "description": "record: the lesson learned (specific and concrete)",
            "type": "string"
          },
          "limit": {
            "default": 20,
            "description": "list: max entries (0 = all)",
            "type": "integer"
          },
          "min_corroboration": {
            "default": 3,
            "description": "promote: min entries per cluster",
            "minimum": 2,
            "type": "integer"
          },
          "min_tag_overlap": {
            "default": 1,
            "description": "promote: min tag overlap per cluster",
            "minimum": 1,
            "type": "integer"
          },
          "project_root": {
            "type": "string"
          },
          "scope": {
            "default": "repo",
            "description": "record/query: scope filter",
            "enum": [
              "repo",
              "forge",
              "general"
            ],
            "type": "string"
          },
          "session_id": {
            "description": "record: session id",
            "type": [
              "string",
              "null"
            ]
          },
          "supersedes": {
            "description": "record: WIS-* id this supersedes",
            "type": [
              "string",
              "null"
            ]
          },
          "tags": {
            "description": "record: tag list; query: filter by tags",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "text": {
            "description": "query: free-text substring match (case-insensitive)",
            "type": [
              "string",
              "null"
            ]
          },
          "top_n": {
            "default": 5,
            "description": "query/recall: max entries to return",
            "maximum": 50,
            "minimum": 1,
            "type": "integer"
          },
          "write": {
            "default": false,
            "description": "promote: persist draft recipes to disk",
            "type": "boolean"
          }
        },
        "required": [
          "action"
        ],
        "type": "object"
      },
      "name": "wisdom",
      "schema_version": "atomadic-forge.wisdom/v2"
    }
  ],
  "tools_count": 11
}