aci-provenance

{
  "schema_version": 1,
  "type": "app",
  "slug": "aci-provenance",
  "title": "aci-provenance",
  "brief": "Real-world variant view for any MPN — distributor-truthed bare-chip candidates, symbol-variant sub-grouping, deep 3D-model search, citation-aware PDF deep-links. Feeds chipfit /3d-variants.",
  "version": "0.1.0",
  "tags": [],
  "license": "MIT",
  "sample_prompts": [
    {
      "label": "Run for one MPN",
      "prompt": "Run aci-provenance for RP2040 and show me the real-world variants Mouser carries"
    },
    {
      "label": "Symbol-variant demo",
      "prompt": "Show me the MCP4 family — I want to see the I2C vs SPI symbol-variant axis with the same fp + same 3D"
    },
    {
      "label": "Deep 3D search",
      "prompt": "Run the deep 3D-model search for STM32F407 — try the manufacturer site first then community fallbacks"
    }
  ],
  "install": {
    "binary_name": "aci-provenance",
    "install_dir": "",
    "install_hint": "",
    "version_cmd": ""
  },
  "readme": "---\nname: aci-provenance\ndescription: Real-world variant provenance for any MPN — datasheet + footprint + 3D trace, distributor-truthed bare-chip candidates (no fake variants), symbol-variant sub-grouping (SPI vs I2C etc), deep 3D-model search across manufacturer + community sources, citation-aware PDF deep-links, reveal-in-VS-Code. Feeds chipfit's variant picker so users never see invented variants. Trigger words — aci provenance, real-world variants, bare-chip variants, mpn variants, datasheet citations, deep 3d search, manufacturer-direct chip, mouser variant search, jlcpcb variants, lcsc fallback, symbol variants i2c spi, fp glb equivalence class, distributor truthed variants, footprint and 3d the same different pinout.\n---\n\n# aci-provenance — real-world variant provenance for any MPN\n\nWraps `adom-parts-search` + the local provenance JSON + a deep\nmanufacturer-3D-model search + a citation-aware PDF deep-linker\ninto a single Hydrogen webview. The output is the\n`<mpn>-variants.json` manifest that chipfit's `/3d-variants`,\n`aci library`, and `aci source --bom` all read.\n\n## Run\n\n```bash\nnode server.mjs --mpn RP2040 --port 8980\n```\n\nThen open in a Hydrogen webview tab:\n\n```\nhttps://<container-proxy>/proxy/8980/\n```\n\n## What it solves\n\nChipfit's old variant picker listed STEP files from the\nkicad-packages3d cache. Most of those don't correspond to any\norderable distributor SKU. User feedback 2026-04-28: *\"these\nvariants you're showing me don't exist in the real world and I'm\nsad you fooled me.\"*\n\naci-provenance is the data plumbing fix:\n\n- Bare-chip candidates only — filter out modules / dev boards\n- Search MPN-family-prefix mode (e.g. `MCP4` returns the whole\n  digital-pot family across SPI + I2C variants)\n- Symbol-signature sub-grouping when same fp+3D carries\n  different pinout (SPI vs I2C, single vs dual)\n- Boot-time URL probe so we never ship a templated link that's\n  bot-blocked or 404'd\n\n## Companion app\n\n[adom-pdf-viewer](https://github.com/adom-inc/adom-pdf-viewer)\nserves the in-page PDF viewer aci-provenance deep-links into for\nevery page citation. Cited pages are highlighted in the thumbnail\nstrip with snippet labels (\"footprint pad geometry\", \"GLB / package\nmodel\", etc.).\n\n## Manifest schema\n\nWritten to `project-content/schematics/footprints/<mpn>/<mpn>-variants.json`:\n\n```jsonc\n{\n  \"prefix\": \"RP2040\",\n  \"datasheet_recommended\": { \"full_mpn\": \"...\", \"marking\": \"...\", \"citation\": \"...\" },\n  \"variants\": [\n    {\n      \"full_mpn\": \"SC0914(13)\",\n      \"manufacturer\": \"Raspberry Pi\",\n      \"marking\": \"RP2040 (RP2B2)\",      // extracted from description\n      \"fp_glb_equivalence_class\": \"RP2040\",\n      \"symbol_signature\": \"MPN:RP2040\",  // family rules vary per MFR\n      \"protocol\": [\"SPI\", \"I2C\", \"UART\", \"USB1.1\"],\n      \"lifecycle\": \"unknown\",\n      \"distributors\": [{ \"name\": \"Mouser\", \"sku\": \"358-SC091413\", \"stock\": 104213, \"price_usd\": {...} }],\n      \"datasheet_url\": \"...\",\n      \"product_url\": \"...\"\n    }\n  ],\n  \"footprint_variants\": []\n}\n```\n\nFull spec: [adom-chipfit/PLAN.md Part 5](https://github.com/adom-inc/adom-chipfit/blob/main/PLAN.md).\n\n## Sample prompts\n\n- \"Run aci-provenance for RP2040 and show me the real-world\n  variants Mouser carries\"\n- \"Show me the MCP4 family — I want to see the I2C vs SPI\n  symbol-variant axis with the same fp + same 3D\"\n- \"Open this datasheet at page 608 with all the cited pages\n  highlighted in the thumbnail strip\"\n- \"Reveal /home/adom/project/.../RP2040-3d.glb in the VS Code\n  Explorer\"\n",
  "author": {
    "id": "695820315b5f1e4db2fcf602",
    "name": "Kyle Bergstedt",
    "email": "[email protected]"
  },
  "visibility": {
    "public": true
  },
  "hero": null,
  "discovery_triggers": [],
  "discovery_pitch": null,
  "metadata": {},
  "created_at": "2026-05-28T05:29:16.002Z",
  "updated_at": "2026-05-28T05:29:16.002Z",
  "skills": []
}