{
  "format": "ta-amps.seed-pack.proposal.v1",
  "status": "proposal_only",
  "pack_id": "faiss-ivf-pq-and-ann-index-cascade",
  "title": "FAISS IVF-PQ and ANN index cascade",
  "version": "0.1.0",
  "summary": "A collection of nouns and verbs for k-means++ Voronoi inverted-file partitioning, residual uint8 product quantization, asymmetric distance lookup tables and exact top-R reranking.",
  "license": "MIT",
  "store": "seedpack.faiss-ivf-pq-and-ann-index-cascade",
  "queue_placeholder": "conformance-seed-packs",
  "files": [
    {
      "path": "README.md",
      "sha256": "f110a8a48ad062ee4d0d0d1f61fb9eb4c43f13dd01ebd1188a9282e17ed5f344"
    },
    {
      "path": "source.json",
      "sha256": "8853bea3c2192f5ea30e91e965eea6121638eb1f4a7eabb3cca03648c705ba75"
    },
    {
      "path": "nouns.json",
      "sha256": "26f99c05d68d0723d6026bf8600c3d6aeabc5d9ecb15dc633f1bd57052017728"
    },
    {
      "path": "verbs.json",
      "sha256": "65f63f19ad2a6c05de3b683748405fe034bfaf82067299dc93e21c3e050bf4a5"
    }
  ],
  "nouns": [
    {
      "key": "faiss-ivf-pq-and-ann-index-cascade.v0.1.0.pack",
      "category_id": "noun.skill_pack",
      "role": "pack",
      "value_sha256": "80c134b24a7d28e1d1bae04e8558122e487b5f12a7c475072c59de38b4b3532c"
    },
    {
      "key": "faiss-ivf-pq-and-ann-index-cascade.v0.1.0.guardrail.divisible-subspaces-and-uint8-codebook-bounds",
      "category_id": "noun.skill_pack",
      "role": "guardrail",
      "value_sha256": "ede0e878ab9c1bf4d356c1cbc2aa80a15947e80703ccab6f909d8fb3a4af8bd5"
    },
    {
      "key": "faiss-ivf-pq-and-ann-index-cascade.v0.1.0.guardrail.grid-governed-cascade-and-zero-magic-literals",
      "category_id": "noun.skill_pack",
      "role": "guardrail",
      "value_sha256": "e4114ec8b82941647e9e5e01490a734c3c631a004d6e5d5eb7a23ee37764494b"
    },
    {
      "key": "faiss-ivf-pq-and-ann-index-cascade.v0.1.0.spec.ivf-pq-and-adc-cascade-grid",
      "category_id": "noun.benchmark_suite",
      "role": "spec",
      "value_sha256": "5358832a3c84ff788617140dbe41b2270493f26f2bd66bf636ce395254ef24e7"
    },
    {
      "key": "faiss-ivf-pq-and-ann-index-cascade.v0.1.0.rules.residual-pq-and-adc-lookup",
      "category_id": "noun.reflex_procedure",
      "role": "rules",
      "value_sha256": "e8812d16f4c2af98608f07cccbcd4dfce322e8fbc5bad216e04696eb3390c58a"
    },
    {
      "key": "faiss-ivf-pq-and-ann-index-cascade.v0.1.0.tool.ivf-pq-cascade",
      "category_id": "noun.code_node",
      "role": "tool_card",
      "value_sha256": "7d2c0ab06e8850adbe0e57bc028b3e98c727d09337ffb63224dfd83114c6ed87"
    },
    {
      "key": "faiss-ivf-pq-and-ann-index-cascade.v0.1.0.template.ivf-pq-cascade-receipt",
      "category_id": "noun.scene_recipe",
      "role": "template",
      "value_sha256": "3b5785fc1bc01837c694c0b35d30c3a86dc4dd9678f4d8f1e5c971dfd93921aa"
    },
    {
      "key": "faiss-ivf-pq-and-ann-index-cascade.v0.1.0.example.ivf-pq-cascade-bundle",
      "category_id": "noun.eval_run",
      "role": "example",
      "value_sha256": "1d00e392ac52c8cc532c99cb4df3f3ac2408e02e1bd8fdfe63ca5ab34dbbdfa7"
    },
    {
      "key": "faiss-ivf-pq-and-ann-index-cascade.v0.1.0.example.ivf-pq-cascade-receipt",
      "category_id": "noun.eval_run",
      "role": "example",
      "value_sha256": "3c08ca0798995055336d89653c98df3464bdbff90f480af7e945cdb8ce0873fa"
    }
  ],
  "verbs": [
    {
      "template_id": "faiss-ivf-pq-and-ann-index-cascade.fit-ivf-pq-voronoi-and-residual-codebooks",
      "kind": "verb.probe_source",
      "claimant": "agent",
      "idempotency_key": "seedpack:faiss-ivf-pq-and-ann-index-cascade:fit-ivf-pq-voronoi-and-residual-codebooks:38d1fd7528061ae7856e6b4f023911c8ca9fae2194860a591b31d227934ec921",
      "report_shape_sha256": "965e925451cd5d50c11cfde1030350c4552916b3a73692780a8e92337b84625b"
    },
    {
      "template_id": "faiss-ivf-pq-and-ann-index-cascade.benchmark-adc-and-exact-rerank-regimes",
      "kind": "verb.generate_seed",
      "claimant": "agent",
      "idempotency_key": "seedpack:faiss-ivf-pq-and-ann-index-cascade:benchmark-adc-and-exact-rerank-regimes:1688d08e2bd20d09d474c7184f9f1752986968eaa890ffe168f24ac0395becc6",
      "report_shape_sha256": "8af109ee9d6e45548a513bf9a3238d463eaef69fc4842aabc3ca924134482359"
    },
    {
      "template_id": "faiss-ivf-pq-and-ann-index-cascade.verify-ivf-pq-compression-and-recall-receipt",
      "kind": "verb.verify_gate",
      "claimant": "agent",
      "idempotency_key": "seedpack:faiss-ivf-pq-and-ann-index-cascade:verify-ivf-pq-compression-and-recall-receipt:6d3a5327ed337dd078b7f948f4b9fe5ac9c28967ea94ed7079e3d7583f119b09",
      "report_shape_sha256": "06de7f2341c15a61256a227dc156e5040365f9e298a5a435e24c5c8626a710f4"
    }
  ],
  "code": {
    "path": "packs/faiss-ivf-pq-and-ann-index-cascade/code",
    "files": 12,
    "sha256": "615969f3909cb6de9b9d29563107836861e25f49438633e40b4e31972ac033d6",
    "runs": "The library runs this code only in its own CI tests; workers run it under their own permissions. Reading, exporting or importing the pack runs none of it."
  },
  "dependencies": [
    {
      "pack_id": "configuration-grids-and-bounds",
      "keys": []
    },
    {
      "pack_id": "evaluation-design",
      "keys": []
    },
    {
      "pack_id": "wiring-and-conformance-checks",
      "keys": []
    }
  ],
  "boundaries": [
    "ProductQuantizedIvfIndex partitions R^D vectors across nlist Voronoi cells via deterministic k-means++, quantizes residual subvectors into compact uint8 PQ codes and evaluates queries via Asymmetric Distance Computation (ADC) lookup tables.",
    "Exact dense L2 reranking executes strictly on the shortlisted top-R ADC candidates when enabled by the active NodeGrid regime.",
    "All index topology, codebook, probing and rerank parameters resolve from default_grid_spec.json with zero inline magic literals.",
    "Importing the pack writes nothing, enqueues nothing and installs no code."
  ],
  "override_policy": {
    "automatic_merge": false,
    "on_conflict": "stop_and_clarify"
  },
  "importer": null,
  "importer_reason": "No manifest endpoint or generic importer exists. Reading or exporting this pack writes no records, enqueues no verbs and activates nothing.",
  "activation": {
    "automatic": false,
    "steps": [
      "An owner assigns the namespace, store and queue.",
      "Each noun is written create-only with existing grants and read back; its value SHA-256 must match the pin.",
      "A verb template is filled with exact pins and enqueued explicitly by an authorized requester."
    ]
  },
  "evaluation": {
    "result": null,
    "reason": "Offline shape, category and digest validation only. No worker has run these verbs."
  }
}