{"_id":"@0xhoneyjar/construct-mibera-codex","name":"@0xhoneyjar/construct-mibera-codex","dist-tags":{"latest":"1.4.0"},"versions":{"1.4.0":{"name":"@0xhoneyjar/construct-mibera-codex","version":"1.4.0","description":"MICODEX — Mibera Codex navigation surface. CLI (`micodex`), MCP (stdio + HTTP), intent-layer search via QMD. Teaches agents to read the map.","type":"module","bin":{"micodex":"dist/bin/micodex.js","micodex-mcp":"dist/bin/mcp.js","micodex-mcp-http":"dist/bin/http.js"},"scripts":{"build":"tsc","start":"node dist/bin/http.js","start:http":"node dist/bin/http.js","micodex":"tsx bin/micodex.ts","micodex:dev":"tsx watch bin/micodex.ts","micodex:index":"bash scripts/build-micodex-index.sh","mcp":"tsx bin/mcp.ts","mcp:dev":"tsx watch bin/mcp.ts","http":"tsx bin/http.ts","http:dev":"tsx watch bin/http.ts","prepublishOnly":"tsc"},"dependencies":{"@hono/node-server":"^1.14.1","@modelcontextprotocol/sdk":"^1.18.2","gray-matter":"^4.0.3","hono":"^4.7.0","zod":"^3.25.28"},"peerDependencies":{"@tobilu/qmd":"^2.0.0"},"peerDependenciesMeta":{"@tobilu/qmd":{"optional":true}},"devDependencies":{"@types/node":"^22.10.0","tsx":"^4.19.2","typescript":"^5.7.2"},"engines":{"node":">=20"},"packageManager":"pnpm@8.15.9","repository":{"type":"git","url":"git+https://github.com/0xHoneyJar/construct-mibera-codex.git"},"license":"MIT","_id":"@0xhoneyjar/construct-mibera-codex@1.4.0","gitHead":"7fb2f15d98c30601ef12fe1df68af81edfb621f9","bugs":{"url":"https://github.com/0xHoneyJar/construct-mibera-codex/issues"},"homepage":"https://github.com/0xHoneyJar/construct-mibera-codex#readme","_nodeVersion":"23.3.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-udZILRvdPUcYP0mDiPjgsOWZHnc9RPImVO3cOsAOauGaMLGdHkWOflxBesjqLE1IwwjF5upYclYnrd5kQ0xfFg==","shasum":"e72b24c80502d310e35b6c9b7fa18568efeaf4ea","tarball":"https://registry.npmjs.org/@0xhoneyjar/construct-mibera-codex/-/construct-mibera-codex-1.4.0.tgz","fileCount":273,"unpackedSize":49482203,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICbZ7PVqAdWarja/P2fD0zVzDjHK7qL5SC+gbQY49nMsAiEAozcSI2LYX/hIIKCAC9A1oPQL5OV4GommMUnvUEOn/wc="}]},"_npmUser":{"name":"zksoju","email":"underrated@gmail.com"},"directories":{},"maintainers":[{"name":"janitooor","email":"jani@0xhoneyjar.xyz"},{"name":"zerkereth","email":"zerkereth@gmail.com"},{"name":"zksoju","email":"underrated@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/construct-mibera-codex_1.4.0_1777758328062_0.43499676487787275"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-02T21:45:27.997Z","1.4.0":"2026-05-02T21:45:28.365Z","modified":"2026-05-02T21:45:28.580Z"},"maintainers":[{"name":"janitooor","email":"jani@0xhoneyjar.xyz"},{"name":"zerkereth","email":"zerkereth@gmail.com"},{"name":"zksoju","email":"underrated@gmail.com"}],"description":"MICODEX — Mibera Codex navigation surface. CLI (`micodex`), MCP (stdio + HTTP), intent-layer search via QMD. Teaches agents to read the map.","homepage":"https://github.com/0xHoneyJar/construct-mibera-codex#readme","repository":{"type":"git","url":"git+https://github.com/0xHoneyJar/construct-mibera-codex.git"},"bugs":{"url":"https://github.com/0xHoneyJar/construct-mibera-codex/issues"},"license":"MIT","readme":"# The Mibera Codex\n\n*Documentation for Mibera Maker — 10,000 time-travelling Rebased Retard Beras carrying the eternal flame of the Rave.*\n\n> 📡 **codex-mcp v1** ships from this repo (Path A · stdio). Eight tools for narrative-bot consumers: `lookup_zone`, `lookup_archetype`, `lookup_factor`, `lookup_grail`, `lookup_mibera`, `list_zones`, `list_archetypes`, `validate_world_element`. See [§ codex-mcp](#-codex-mcp-anti-hallucination-lookup) below.\n\n---\n\n> *\"Milady has to die, so that Milady may live. Milady lost her way. And in ego death, she finds Mibera.\"*\n\n---\n\n## What is Mibera?\n\nMibera is the shadow side of Milady. Where Milady represents the **clearpill** — virtuous, supplements, suits — Mibera embodies the **ravepill** — the sweaty, filthy reality of the dance floor.\n\nWe are time-travelling Rebased Retard Beras, representatives of the High Council of 101 Bears. We exist outside of Milady time, but within it too.\n\n[Read the full philosophy →](core-lore/philosophy.md)\n\n---\n\n## The Codex Structure\n\n### I. The Story\nThe genesis mythology and philosophical framework.\n- [Philosophy & Genesis](core-lore/philosophy.md)\n\n### II. The Framework\nThe four Rave Tribes and cultural lineages.\n- [Archetypes](core-lore/archetypes.md) — Freetekno, Milady, Chicago Detroit, Acidhouse\n- [Ancestors](core-lore/ancestors/README.md) — Hindu, Mayan, Greek, Native American, and more\n\n### III. The Mysticism\nCosmic and chemical systems that define each Mibera.\n- [Astrology](traits/overlays/astrology/README.md) — Sun, Moon, and Ascending signs\n- [Elements](traits/overlays/elements/README.md) — Fire, Water, Air, Earth\n- [Drug-Tarot System](core-lore/drug-tarot-system.md) — 78 cards mapped to 78 drugs\n- [Drugs Deep Dive](traits/overlays/molecules/README.md) — Detailed profiles of all 78 substances\n\n### IV. The Art\n1,337+ visual traits across multiple categories.\n- [Visual Traits Overview](traits/overview.md)\n- Character, Accessories, Clothing, Items, Backgrounds\n\n### V. The Collection\nThe 10,000 Miberas and their temporal identities.\n- [All Miberas](miberas/README.md) — Individual entries with full metadata\n- [Grails](grails/README.md) — 43 hand-drawn 1/1 art pieces (42 canonical + Mijedi)\n- [MiParcels](miparcels/README.md) — 10,000 sealed envelopes from Phase 1 reveal\n- [Birthdays](birthdays/README.md) — 9,995 unique birthdays spanning 15,000 years\n- [Fractures](fractures/README.md) — 10 reveal phases from sealed envelope to final form\n\n### VI. The Mechanics\n- [Ranking & Scoring](traits/overlays/ranking/README.md) — Swag Score and tribal coherence\n\n### VII. The Ecosystem\nPartners and collaborations.\n- [Special Collections](special-collections/README.md) — Berachain ecosystem integrations\n- [Vending Machine](vending-machine/README.md) — VM-exclusive Shadow Traits (update in progress)\n\n### VIII. Behind the Scenes\nThe people and process behind the collection.\n- [Creative Process](behind-the-scenes/creative-process.md) — How the art was made\n- [Team History](behind-the-scenes/team-history.md) — The people who built Mibera\n\n### IX. On-Chain\nContract addresses and ecosystem mechanics.\n- [Contract Registry](_codex/data/contracts.json) — All ecosystem contract addresses\n- [Fractured Mibera](_codex/data/fractured-mibera.md) — 10 soulbound companion collections\n- [Shadow Traits](_codex/data/shadow-traits.md) — On-chain trait uniqueness system\n- [Candies Marketplace](_codex/data/candies-mechanics.md) — Seizure mechanics and holder discounts\n- [Mibera Sets](_codex/data/mibera-sets.md) — 12-tier ERC-1155 on Optimism\n- [Archetype Quiz](_codex/data/tarot-quiz.md) — Soulbound archetype alignment\n- [The 42 Motif](_codex/data/42-motif.md) — Numerological easter eggs across contracts\n- [Contract ABIs](_codex/data/abis/README.md) — Machine-readable contract interfaces\n\n### X. Data & Research\nMachine-readable exports and analytical datasets.\n- [Data Directory Index](_codex/data/README.md) — All exports with format descriptions\n- [Knowledge Graph](_codex/data/graph.json) — 11,475 nodes, 192,707 edges\n- [All Miberas (JSONL)](_codex/data/miberas.jsonl) — 10,000 entries as newline-delimited JSON\n- [All Grails (JSONL)](_codex/data/grails.jsonl) — 43 entries\n- [Scope & Boundaries](_codex/data/scope.json) — What this codex tracks and doesn't\n- [Known Gaps](_codex/data/gaps.json) — Documented unknowns with resolution paths\n- [Timeline](_codex/data/timeline.json) — Key ecosystem events\n\n---\n\n## Browse the Codex\n\nExplore the 10,000 Miberas through faceted search — filter by archetype, ancestor, drug, element, swag rank, birthday era, and more.\n\n[Browse all Miberas →](browse/README.md)\n\n---\n\n## Quick Stats\n\n| Metric | Value |\n|--------|-------|\n| Total Miberas | 10,000 |\n| Hand-Drawn Grails | 43 |\n| Unique Traits | 1,337+ |\n| Archetypes | 4 |\n| Ancestors | 33 |\n| Tarot-Drug Mappings | 78 |\n| Ecosystem Contracts | 11 |\n| Birthday Range | 13,166 BCE – 2024 CE |\n\n---\n\n## 📡 codex-mcp — anti-hallucination lookup\n\nThe codex ships an MCP server for narrative-bot consumers (freeside-characters' ruggy + satoshi today, future puruhani daemons). It is the **read interface** to the codex's canonical world-elements.\n\nPer [RFC #53](https://github.com/0xHoneyJar/construct-mibera-codex/issues/53) and Gumi's locked v1 design (2026-04-29):\n\n| Tool | What it returns |\n|---|---|\n| `lookup_zone(slug)` | Full zone — archetype, era, essence, Lynch primitives, KANSEI tokens |\n| `lookup_archetype(name)` | One of the 4 — era, zodiac, season, locations, figures, events, drugs, ancestors, fashion |\n| `lookup_factor(factor_id)` | Cross-construct JOIN with score-mibera — display name, dimension, archetype anchor, lore, status |\n| `lookup_grail(query)` | Grail by ID, slug, or name — name, category, description, status |\n| `lookup_mibera(id)` | Single Mibera by ID (1-10000) — full canonical trait set |\n| `list_zones()` | All zone summaries |\n| `list_archetypes()` | All 4 archetype summaries |\n| `validate_world_element(type, value)` | Canonical check + suggested-closest fuzzy match. Logs unmatched-but-Mibera-relevant queries to `grimoires/codex-mcp/coverage-gaps.jsonl` for periodic curator review |\n\n### Run locally\n\n```bash\npnpm install\npnpm mcp           # stdio server on stdin/stdout\n```\n\nAdd to Claude Code (`.claude/settings.json` or `claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"codex\": {\n      \"command\": \"pnpm\",\n      \"args\": [\"--prefix\", \"/path/to/construct-mibera-codex\", \"mcp\"]\n    }\n  }\n}\n```\n\n### Source of truth\n\n| Tool | Reads from |\n|---|---|\n| `lookup_zone` / `list_zones` | `core-lore/festival-zones-vocabulary.md` |\n| `lookup_archetype` / `list_archetypes` | `core-lore/archetypes.md` |\n| `lookup_factor` | `core-lore/factor-lore.md` |\n| `lookup_grail` | `_codex/data/grails.jsonl` |\n| `lookup_mibera` | `_codex/data/miberas.jsonl` |\n\nThe codex repo IS the SoT (per Gumi D3). Rolling latest, no semver tags (per C4) — commits land continuously.\n\n### Coverage gap log\n\nWhen `validate_world_element` returns `{ canonical: false }`, the (type, value, suggestion) is appended to `grimoires/codex-mcp/coverage-gaps.jsonl` (gitignored — local-only review surface). This is Gumi's curator queue: unmatched-but-Mibera-relevant queries that hint at codex gaps.\n\n### Anti-hallucination tier model\n\nPer `beacon.yaml.mcp.tiers`:\n\n- **🔒 HARD** — substrate enforces, LLM cannot escape (zone slug/emoji/archetype, archetype canonical names, factor IDs, mibera IDs, grail IDs)\n- **🪶 SOFT** — MCP provides reference, LLM has creative license over composition (zone essence, KANSEI texture, archetype figures/events/fashion, factor lore)\n- **🌀 LLM-OWNED** — no MCP involvement (narrator voice, activity-class words, closing observations)\n\nConsumer guards (e.g., score-mibera `hallucination-guard.ts`) validate generated narrative against the HARD set before delivery.\n\n### Doctrine\n\nImplements `constructs-mcp-shape` + `constructs-mcp-deployment-topology` from operator's vault. Path A (stdio) ships in this repo. Path B (self-hosted Streamable HTTP) is a follow-on cycle when production bot deploy demands it.\n\n---\n\n## Contributing\n\nThe codex is a living document. If something is wrong, missing, or could be better — [open an issue](https://github.com/0xHoneyJar/construct-mibera-codex/issues/new).\n\nCorrections, lore additions, cultural context, trait documentation, broken links, grail history, or information you think should be here but isn't — all welcome. Just describe what you're seeing and what you think it should be.\n\n---\n\n## License\n\n© Mibera Maker. All rights reserved.\n","readmeFilename":"README.md","_rev":"1-6a9679abae90cac7e859d3aa1d3ae6fb"}