{"id":50773456,"url":"https://github.com/atomadictech/fuse-sdk","last_synced_at":"2026-06-11T21:02:46.928Z","repository":{"id":359021219,"uuid":"1239625411","full_name":"atomadictech/fuse-sdk","owner":"atomadictech","description":"Atomadic Fuse SDK — per-repo monadic compiler. CLI + MCP server. pip install atomadic-fuse.","archived":false,"fork":false,"pushed_at":"2026-05-20T03:13:12.000Z","size":47,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-20T06:11:34.920Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/atomadictech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-15T09:22:33.000Z","updated_at":"2026-05-20T03:13:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/atomadictech/fuse-sdk","commit_stats":null,"previous_names":["atomadictech/fuse-sdk"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/atomadictech/fuse-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomadictech%2Ffuse-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomadictech%2Ffuse-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomadictech%2Ffuse-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomadictech%2Ffuse-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atomadictech","download_url":"https://codeload.github.com/atomadictech/fuse-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomadictech%2Ffuse-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34217315,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-11T21:02:46.295Z","updated_at":"2026-06-11T21:02:46.923Z","avatar_url":"https://github.com/atomadictech.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Atomadic Fuse SDK\n\nSpaghetti to Shippable.\n\nFuse is the public SDK for turning repository chaos into a clearer, more verifiable build workflow.\n\nIn plain English: Fuse helps you inspect a codebase, understand what is in it, search for useful building blocks, validate outputs, and drive agent or automation workflows through a typed Python client, a command-line tool, or MCP.\n\nIn technical terms: this repository ships the public Python package **`atomadic-fuse`** (PyPI **1.2.0**), the **`fuse-sdk`** CLI for hosted read-only calls, the **`fuse-mcp`** stdio server for local agents, example workflows, and a bundled seed logic-base for local bootstrapping.\n\n## Why Fuse\n\nMost AI-assisted build pipelines fail in familiar ways:\n- the same workflow behaves differently across tools\n- generation is easier than verification\n- agent integrations drift away from direct developer tooling\n- repo understanding, search, emit, and validation live in separate ad hoc scripts\n\nFuse gives you one public integration surface for:\n- typed Python calls with `FuseClient` (34 methods — hosted + operator tiers)\n- hosted CLI with **`fuse-sdk`** (14 public read-only verbs)\n- MCP-based agent integration with **`fuse-mcp`** (local stdio) or **`https://fuse.atomadic.tech/mcp`** (hosted)\n- free single-repo dry-run demo at **[fuse.atomadic.tech/#demo](https://fuse.atomadic.tech/#demo)** (no API key)\n\n## What You Can Do\n\n### For developers\n- scan and classify repositories before making changes\n- absorb a repo into a logic-base-backed workflow\n- search by intent, inspect lineage, and explain blocks\n- synthesize, emit, and compile through one client surface\n- lint, validate, deduplicate, and rebuild indexes for store maintenance\n\n### For agents and tooling teams\n- expose Fuse through MCP without writing a custom adapter\n- use the same public workflow surface across IDEs, scripts, CI jobs, and agent runtimes\n- build verification-first automations around methods like `verify_block`, `validate`, `doctor`, and `status`\n\n### For non-technical readers\n- Fuse is the part that helps teams go from \"we have a messy repo and too many brittle scripts\" to \"we have a repeatable interface for understanding, validating, and shipping work\"\n- it does not promise magic autopilot from a slogan alone; it gives you a concrete tool surface you can script, automate, and inspect\n\n## Install\n\n```bash\npip install atomadic-fuse==1.2.0\n```\n\nOptional extras:\n\n```bash\npip install \"atomadic-fuse[mcp]\"\npip install \"atomadic-fuse[gui]\"\npip install \"atomadic-fuse[mcp,gui]\"\n```\n\n## Quick Start\n\n```python\nfrom atomadic_fuse import FuseClient\n\nclient = FuseClient()  # uses https://fuse.atomadic.tech by default\n\nprint(client.doctor())\nprint(client.search_intent(\"validate and route input\", tier=\"t2\", limit=5))\nprint(client.verify_block(\"lb:t2:compose_path_composite:bd7e1d030ef5\"))\n```\n\nOperator-tier methods (`synthesize`, `compile`, `absorb`, etc.) require **master** API key on hosted MCP or local **`fuse-engine`** for full emit/repair.\n\n## Public API Surface\n\nThe Python package exposes **34 `FuseClient` methods** for local and hosted integration. The **hosted MCP worker** at `https://fuse.atomadic.tech/mcp` exposes **14 read-only public tools** (master tier unlocks 20 additional operator tools). Use `fuse-sdk` CLI for hosted verbs only; use local `fuse-engine` for full emit/repair.\n\n### Hosted public MCP tools (14)\n\nThese match `atomadic-ops/workers/atomadic-fuse-api/src/tool_manifest.json` visibility `public`:\n\n- `classify`, `catalog`, `doctor`, `fuse_recovery_status`, `verify_block`\n- `search_intent`, `explain_block`, `usage_stats`, `scan`, `validate`\n- `status`, `search`, `show`, `langs`\n\nAuth: `Authorization: Bearer $ATOMADIC_FUSE_API_KEY` (pro) or `$ATOMADIC_MASTER_KEY` (all tools). Free anonymous tier: 3 calls/day per verb (`classify` unmetered).\n\n### Full FuseClient methods (34)\n\nRepository workflows:\n- `compile`\n- `classify`\n- `absorb`\n- `scan`\n- `discover`\n- `synthesize`\n- `emit`\n- `intent`\n\nSearch, explain, and mapping:\n- `catalog`\n- `search`\n- `search_intent`\n- `logic_map`\n- `compose_stack`\n- `explain_block`\n- `explain_lineage`\n- `show`\n- `langs`\n- `polyglot`\n\nVerification and operations:\n- `doctor`\n- `status`\n- `validate`\n- `verify_block`\n- `usage_stats`\n- `fuse_recovery_status`\n\nStore and promotion helpers:\n- `quickstart`\n- `friction`\n- `promote_hypotheses`\n- `promote_candidate`\n- `lint_store`\n- `validate_store`\n- `deduplicate_store`\n- `rebuild_indexes`\n- `emit_corpus`\n- `capabilities`\n\nSource of truth: [src/atomadic_fuse/client.py](src/atomadic_fuse/client.py)\n\n## CLI Surface\n\nThe SDK ships **`fuse-sdk`** (public hosted read-only verbs) and **`fuse-mcp`** (local stdio MCP):\n\n```bash\nfuse-sdk doctor\nfuse-sdk classify --body-text \"def foo(): return 1\"\nfuse-sdk list   # hosted + local verbs\n```\n\nHosted verbs (14): classify, catalog, doctor, fuse_recovery_status, verify_block, search_intent, explain_block, usage_stats, scan, validate, status, search, show, langs.\n\nLocal-only: `init`, `seed-info`, `list`.\n\nExample:\n\n```bash\nfuse-sdk doctor\nfuse-sdk search --query validate\n```\n\n## Spaghetti to Shippable (S2S)\n\n**Tagline:** Spaghetti to Shippable in one call.\n\nS2S is the single-repo pipeline that ingests one messy repository, runs security + heal + emit stages, passes a **fitness gate**, and wraps a **T5 product bow** (README, `product.json`, local logic-base shard).\n\n| Surface | What it is | S2S support |\n|---------|------------|-------------|\n| **Hosted `FuseClient`** | HTTP client to `fuse.atomadic.tech` | Catalog, compile, verify — **not** full local S2S |\n| **Local Fuse engine** | `atomadic-fuse-next` (dev) → `atomadic-fuse` (stable) | **`fuse s2s`** / MCP `spaghetti_to_shippable` |\n\n```powershell\n# Local engine only (fuse-next today)\n./fuse.cmd s2s --source C:\\path\\to\\spaghetti --output C:\\path\\to\\product          # dry-run\n./fuse.cmd s2s --source C:\\path\\to\\spaghetti --output C:\\path\\to\\product --live # trust-gated\n```\n\n- **Dry-run (default):** plan and stage report; no disk mutations; no trust token.\n- **Live:** heal, emit, fitness gate, T5 bow — requires `gate_intent` PASS + trust attestation (`ATOMADIC_TRUST_TOKEN` or Nexus).\n- **Single repo only** on the public profile; multi-repo harvest/train stays T6 internal.\n\nDeep dive: [docs/S2S_AND_ENGINE_BOUNDARY.md](docs/S2S_AND_ENGINE_BOUNDARY.md)  \nOmega pipeline reference: [../docs/SPAGHETTI_TO_SHIPPABLE.md](../docs/SPAGHETTI_TO_SHIPPABLE.md)\n\n## MCP Surface\n\nFor agent runtimes, install the MCP extra and configure `fuse-mcp`:\n\n```json\n{\n  \"mcpServers\": {\n    \"atomadic-fuse\": {\n      \"command\": \"fuse-mcp\"\n    }\n  }\n}\n```\n\nHosted MCP endpoint:\n- `https://fuse.atomadic.tech/mcp`\n\n## Pricing\n\nVerified from the public pricing page at `atomadic.tech/pricing` on 2026-05-22.\n\nAPI key credit packs:\n- Starter: 500 calls for $8 one-time, no expiry\n- Best Value: 2,500 calls for $30 one-time, no expiry\n- Power: 10,000 calls for $98 one-time, no expiry\n\nPublic pricing notes currently shown on the site:\n- credits work across 75+ endpoints\n- card checkout is available\n- USDC on Base L2 is available\n- x402-style pay-per-call flows are described for autonomous agents\n\nPricing and endpoint coverage can change. For current public details, use:\n- `https://atomadic.tech/pricing`\n- `https://atomadic.tech/openapi.json`\n- `https://atomadic.tech/api-status`\n\n## Documentation\n\n- [Docs Index](docs/README.md)\n- [S2S and Engine Boundary](docs/S2S_AND_ENGINE_BOUNDARY.md)\n- [Whitepaper](docs/WHITEPAPER.md)\n- [Architecture](docs/ARCHITECTURE.md)\n- [MCP Quickstart](docs/MCP_QUICKSTART.md)\n- [Security and Privacy](docs/SECURITY_AND_PRIVACY.md)\n- [Operations Guide](docs/OPERATIONS.md)\n- [Benchmarks Guidance](docs/BENCHMARKS.md)\n- [Use Cases](docs/USE_CASES.md)\n- [Comparison Guide](docs/COMPARISON.md)\n\n## Public Boundary\n\nThis repository is a public SDK surface.\n- it documents package contracts, observable workflows, and integration patterns\n- it does not document private engine internals or unpublished orchestration systems\n- public claims in this repo should be reproducible from source, tests, examples, or public endpoints\n\n## PyPI publish\n\n| Path | When |\n|------|------|\n| **Manual (operator)** | Load `vault/VAULT.env` → `python -m build` → `twine upload dist/*` with `PYPI_API_TOKEN` |\n| **CI (tag `v*`)** | GitHub Actions `publish.yml` — requires repo secret `PYPI_API_TOKEN` |\n| **OIDC (optional)** | [PyPI trusted publishing](https://pypi.org/manage/account/publishing/) — owner `atomadictech`, repo `fuse-sdk`, workflow `publish.yml`, environment `pypi` |\n\nOrchestrated lane: `scripts/public_surface_release.ps1` (Atomadic-Release target).\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatomadictech%2Ffuse-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatomadictech%2Ffuse-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatomadictech%2Ffuse-sdk/lists"}