Atomadic Forge

RECOMMENDED FIRST CALL: full onboarding scan in one response — score, violations, narrative, top 3 strengths, top 3 priorities, single best next call, agent_guidance briefing, capability_showcase tour, and safety_net guarantees. Optional since_receipt for diff-style returns.

Codebase analysis & discovery. action='recon' walks tier map; 'explain' returns plain-English orientation; 'call_graph' AST walk for a symbol; 'smell_scan' CC/LOC/dup detectors; 'lineage' queries the audit log; 'harvest' cross-repo graft candidates; 'synergy' feature-pair detection; 'scan'/'swarm' emergent composition discovery.

Quality gates & change safety. action='certify' 0-100 score; 'wire' upward-import violations; 'enforce' apply mechanical fixes; 'validate'/'guard' sidecar+enforcement layers; 'composite'/'gate'/'health' verify variants; 'check'/'score'/'tests'/'cna'/'rollback'/'diff' preflight + change-review variants.

Orient + plan + dev utilities (v0.48.0: 9 actions; transmute and loop split out as standalone tools). action='context'/'compose'/'policy'/'recipes' for first-call orientation + workflow recipes; 'generate'/'apply'/'locate'/'commit' for refactor planning + dev utilities; 'scaffold' for tool factory.

FLAGSHIP spaghetti->certified pipeline. action='auto' (default): single-shot scout->cherry->assimilate->wire->certify->receipt. action='cherry': produce a surgical cherry-pick manifest (cherry.json). action='finalize': materialize an existing cherry.json into a package. No LLM invoked — pure deterministic absorption. (Local-only — install atomadic-forge locally to run.)

LLM-driven iteration sessions. Forge has no embedded LLM — these actions return prompts you feed to your own LLM, then the response comes back here for the next round. action='iterate': scaffold and emit first prompt; returns session_id. action='resume': feed LLM response back to advance the session. action='evolve': start a recursive multi-round session (D_max=23). action='evolve_step': advance an active evolve round. (Local-only — install atomadic-forge locally to run.)

Multi-agent coordination. action='register'/'list'/'deactivate'/'observe' for agent lifecycle; 'propose'/'vote'/'needs_vote'/'result'/'recap' for consensus; 'handoff_create'/'handoff_list'/'enhance_propose'/'enhance_list' for session state.

Institutional memory DB. action='record' append a lesson; 'query' relevance-rank by scope/tags/text; 'list' paginated dump; 'recall' top-N repo-scoped entries (cheapest read); 'promote' cluster corroborated wisdom into draft recipes.

AAAA-Nexus auth primitives (uses op= NOT action=). op='identity_verify' | 'federation_mint' | 'authorize_action' | 'sys_trust_gate' | 'contract_verify' | 'lineage_record' | 'ratchet_register'. Requires ATOMADIC_MASTER_KEY or ATOMADIC_SUBSCRIPTION_KEY env. The 'authorize_action' op uses a separate 'action' field (the action being authorized) — distinct from this tool's op= dispatch key.

Intent + seed repos -> shippable pip-installable package. Runs the full Phase 1 pipeline: emergent_swarm cross-repo composition discovery -> materialize top-N candidates into tier-organized package -> optional certify. Returns the create receipt with scan_summary, materialize report, and scan_report_path. (Local-only — requires filesystem access; install atomadic-forge locally to run.)