@nyuchi/mzizi-mcp 0.9.1 → 0.10.0

package/dist/registry.js

@@ -0,0 +1,280 @@
+/**
+ * The registry this MCP serves — read from files bundled into the build.
+ *
+ * `src/generated/registry.ts` is produced at build time by
+ * `scripts/generate-registry.mjs` from mzizi-dev/mzizi-registry at the commit
+ * pinned in `registry.pin.json`. It holds the exact payloads the registry's own
+ * API route handlers produce for that commit, so a tool answering from here and
+ * a consumer reading `api.mzizi.dev/v1` at the same commit get the same bytes.
+ *
+ * There is no network call and no database anywhere below. That is the owner's
+ * ruling — nothing but the console touches the database — and it also removes a
+ * class of failure: a tool can no longer be "down" because an upstream is.
+ *
+ * Failure policy is unchanged from the HTTP client this replaced: every method
+ * returns a discriminated result, so a tool turns "no such component" into a
+ * sentence the caller can act on rather than an exception.
+ */
+const ok = (data) => ({ ok: true, data });
+const miss = (message) => ({ ok: false, reason: "not_found", message });
+export function createRegistry(raw) {
+    // Parse on first use, once. The whole bundle is ~4 MB of JSON; a request that
+    // reads one component should not pay to parse 577.
+    const memo = new Map();
+    const parsed = (key, json) => {
+        if (json === undefined)
+            return undefined;
+        if (!memo.has(key))
+            memo.set(key, JSON.parse(json));
+        return memo.get(key);
+    };
+    const section = (name) => {
+        const v = parsed(`section:${name}`, raw.SECTIONS[name]);
+        if (v === undefined)
+            throw new Error(`registry bundle has no "${name}" section — regenerate it`);
+        return v;
+    };
+    const own = (o, k) => Object.prototype.hasOwnProperty.call(o, k);
+    const renames = () => section("renames");
+    /**
+     * The current name for `name`. Old `nyuchi-*` names were renamed to `mzizi-*`
+     * on 2026-09-27 and are baked into links and `components.json` files this
+     * repo does not control, so they must keep resolving — the same rule the
+     * registry's own `readComponent` applies.
+     */
+    function resolveName(name) {
+        if (own(raw.COMPONENTS, name))
+            return name;
+        const next = own(renames(), name) ? renames()[name] : undefined;
+        return next !== undefined && own(raw.COMPONENTS, next) ? next : undefined;
+    }
+    /** Every name a component has been known by, current first. */
+    function nameHistory(current) {
+        const map = renames();
+        return [current, ...Object.keys(map).filter((old) => map[old] === current)];
+    }
+    const notFound = (name) => miss(`The Mzizi registry has no component named "${name}". Check the name — list_components returns the valid set, and search matches on words.`);
+    return {
+        pin: raw.REGISTRY_PIN,
+        resolveName,
+        /** The index, filtered and paged exactly as `GET /v1/ui` does it. */
+        listComponents(q = {}) {
+            const index = section("index");
+            const all = index.items;
+            const matched = all.filter((c) => (q.node === undefined || c.node === q.node) &&
+                (q.owner === undefined || c.owner === q.owner) &&
+                (q.collection === undefined || c.collection === q.collection) &&
+                (q.type === undefined || c.type === q.type));
+            const offset = q.offset ?? 0;
+            const page = q.limit === undefined ? matched.slice(offset) : matched.slice(offset, offset + q.limit);
+            return ok({
+                ...index,
+                items: page,
+                meta: {
+                    total: matched.length,
+                    count: page.length,
+                    offset,
+                    limit: q.limit ?? null,
+                    registryTotal: all.length,
+                    filters: {
+                        node: q.node ?? null,
+                        owner: q.owner ?? null,
+                        collection: q.collection ?? null,
+                        type: q.type ?? null,
+                    },
+                },
+            });
+        },
+        /** One component, shadcn-shaped, with its source inline. */
+        getComponent(name) {
+            const current = resolveName(name);
+            if (!current)
+                return notFound(name);
+            const entry = parsed(`c:${current}`, raw.COMPONENTS[current]);
+            if (entry.status !== 200) {
+                // The registry itself refuses this item (e.g. a manifest declaring more
+                // files than it has). Pass its reason through rather than inventing one.
+                return { ok: false, reason: "invalid", message: String(entry.body?.error ?? `The registry cannot serve "${current}".`) };
+            }
+            return ok(current === name ? entry.body : { ...entry.body, renamedFrom: name });
+        },
+        /** Use cases, variants, sizes, a11y notes — from the item's `meta` in registry.json. */
+        getComponentDocs(name) {
+            const current = resolveName(name);
+            if (!current)
+                return notFound(name);
+            return ok(parsed(`d:${current}`, raw.COMPONENT_DOCS[current]));
+        },
+        /**
+         * Version history, derived from the changelog and the rename map.
+         *
+         * `GET /v1/ui/{name}/versions` reads the database's `component_versions` view,
+         * which this server must not touch. The committed changelog records which
+         * release added, modified, deprecated or removed each component, and the
+         * rename map records every earlier name — together that is the history the
+         * files hold. The row shape therefore differs from the database view's; it
+         * is documented in the README.
+         */
+        getComponentVersions(name) {
+            const current = resolveName(name);
+            if (!current)
+                return notFound(name);
+            const names = new Set(nameHistory(current));
+            const changes = [];
+            for (const entry of section("changelog")) {
+                for (const change of ["added", "modified", "deprecated", "removed"]) {
+                    const list = entry[`components_${change}`] ?? [];
+                    if (list.some((n) => names.has(n))) {
+                        changes.push({
+                            version: entry.version,
+                            title: entry.title ?? null,
+                            change,
+                            breaking: entry.breaking ?? null,
+                            released_at: entry.released_at ?? null,
+                        });
+                    }
+                }
+            }
+            const previousNames = [...names].slice(1);
+            return ok({
+                data: changes,
+                meta: {
+                    total: changes.length,
+                    component: current,
+                    previousNames,
+                    source: "changelog",
+                },
+            });
+        },
+        /**
+         * Word search over components, conventions, AI instruction sets and releases.
+         *
+         * Documentation pages are NOT here — they live on docs.mzizi.dev, which this
+         * server federates as the `docs_*` tools.
+         */
+        search(query, limit = 50) {
+            const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+            const scored = [];
+            const score = (fields) => {
+                let total = 0;
+                for (const term of terms) {
+                    let best = 0;
+                    for (const [value, weight] of fields) {
+                        if (value?.toLowerCase().includes(term))
+                            best = Math.max(best, weight);
+                    }
+                    if (best === 0)
+                        return 0; // every term must match somewhere
+                    total += best;
+                }
+                return total;
+            };
+            for (const c of section("index").items) {
+                const s = score([
+                    [c.name, 5],
+                    [c.title, 4],
+                    [(c.categories ?? []).join(" "), 3],
+                    [c.description, 2],
+                ]);
+                const exact = c.name.toLowerCase() === query.trim().toLowerCase() ? 100 : 0;
+                if (s)
+                    scored.push({ kind: "component", name: c.name, title: c.title, description: c.description, score: s + exact });
+            }
+            for (const c of section("conventions")) {
+                const s = score([
+                    [c.slug, 4],
+                    [c.title, 4],
+                    [c.body, 1],
+                ]);
+                if (s)
+                    scored.push({ kind: "convention", name: c.slug, title: c.title, score: s });
+            }
+            for (const i of section("aiInstructions").data) {
+                const s = score([
+                    [i.name, 4],
+                    [i.target, 3],
+                    [i.description, 2],
+                ]);
+                if (s)
+                    scored.push({ kind: "ai-instruction", name: i.name, description: i.description, score: s });
+            }
+            for (const r of section("changelog")) {
+                const s = score([
+                    [r.version, 4],
+                    [r.title, 2],
+                    [r.description, 1],
+                ]);
+                if (s)
+                    scored.push({ kind: "release", name: r.version, title: r.title, score: s });
+            }
+            scored.sort((a, b) => b.score - a.score || a.name.localeCompare(b.name));
+            const data = scored.slice(0, limit).map(({ score: _s, ...hit }) => hit);
+            return ok({
+                data,
+                meta: {
+                    total: scored.length,
+                    count: data.length,
+                    query,
+                    hint: "Documentation pages are searched by the docs_* tools (docs.mzizi.dev).",
+                },
+            });
+        },
+        getArchitecture() {
+            return ok(section("architecture"));
+        },
+        /** One node or rung. `n` is uncapped — a missing number is a gap, not an error. */
+        getNode(n) {
+            const key = String(n);
+            if (!own(raw.NODES, key)) {
+                return miss(`No node or rung numbered ${n}. Node numbers are labels, not a sequence — call get_architecture without a node to list every element.`);
+            }
+            return ok(parsed(`n:${key}`, raw.NODES[key]));
+        },
+        getBrand() {
+            return ok(section("brand"));
+        },
+        getUbuntuPillars() {
+            return ok(section("ubuntuPillars"));
+        },
+        getUbuntuPrinciples() {
+            return ok(section("ubuntuPrinciples"));
+        },
+        listAiInstructions() {
+            return ok(section("aiInstructions"));
+        },
+        /** By name, or by target audience (mcp-server, claude-system-prompt, …), as the API resolves it. */
+        getAiInstructions(name) {
+            if (own(raw.AI_INSTRUCTIONS, name))
+                return ok(parsed(`ai:${name}`, raw.AI_INSTRUCTIONS[name]));
+            const byTarget = section("aiInstructions").data.find((i) => i.target === name);
+            if (byTarget && own(raw.AI_INSTRUCTIONS, byTarget.name)) {
+                return ok(parsed(`ai:${byTarget.name}`, raw.AI_INSTRUCTIONS[byTarget.name]));
+            }
+            const names = section("aiInstructions").data.map((i) => i.name);
+            return miss(`No AI instruction set named or targeted "${name}". Available: ${names.join(", ")}.`);
+        },
+        /** The mzizi conventions — the list omits bodies; pass a name for one in full. */
+        listConventions() {
+            const rows = section("conventions").map(({ body: _b, ...rest }) => rest);
+            return ok({ data: rows, meta: { total: rows.length } });
+        },
+        getConvention(name) {
+            const all = section("conventions");
+            const hit = all.find((c) => c.slug === name);
+            if (!hit)
+                return miss(`No convention named "${name}". Available: ${all.map((c) => c.slug).join(", ")}.`);
+            return ok(hit);
+        },
+    };
+}
+let bundled;
+/**
+ * The registry bundled into this build. Imported lazily so a module that only
+ * needs the types (or a test with a fixture) does not load 4 MB of strings.
+ */
+export async function bundledRegistry() {
+    if (!bundled)
+        bundled = createRegistry(await import("./generated/registry.js"));
+    return bundled;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA8DH,MAAM,EAAE,GAAG,CAAI,IAAO,EAAS,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AACvD,MAAM,IAAI,GAAG,CAAC,OAAe,EAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;AAItF,MAAM,UAAU,cAAc,CAAC,GAAgB;IAC7C,8EAA8E;IAC9E,mDAAmD;IACnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAmB,CAAC;IACxC,MAAM,MAAM,GAAG,CAAI,GAAW,EAAE,IAAwB,EAAiB,EAAE;QACzE,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAM,CAAC;IAC5B,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,CAAI,IAAY,EAAK,EAAE;QACrC,MAAM,CAAC,GAAG,MAAM,CAAI,WAAW,IAAI,EAAE,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,2BAA2B,CAAC,CAAC;QACjG,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEjF,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,CAAyB,SAAS,CAAC,CAAC;IAEjE;;;;;OAKG;IACH,SAAS,WAAW,CAAC,IAAY;QAC/B,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChE,OAAO,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,CAAC;IAED,+DAA+D;IAC/D,SAAS,WAAW,CAAC,OAAe;QAClC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;QACtB,OAAO,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAChC,IAAI,CAAC,8CAA8C,IAAI,yFAAyF,CAAC,CAAC;IAEpJ,OAAO;QACL,GAAG,EAAE,GAAG,CAAC,YAAY;QACrB,WAAW;QAEX,qEAAqE;QACrE,cAAc,CAAC,IAAe,EAAE;YAC9B,MAAM,KAAK,GAAG,OAAO,CAAe,OAAO,CAAC,CAAC;YAC7C,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC;YACxB,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CACxB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC;gBAC3C,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC;gBAC9C,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,CAAC;gBAC7D,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAC9C,CAAC;YACF,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;YAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;YACrG,OAAO,EAAE,CAAC;gBACR,GAAG,KAAK;gBACR,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE;oBACJ,KAAK,EAAE,OAAO,CAAC,MAAM;oBACrB,KAAK,EAAE,IAAI,CAAC,MAAM;oBAClB,MAAM;oBACN,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;oBACtB,aAAa,EAAE,GAAG,CAAC,MAAM;oBACzB,OAAO,EAAE;wBACP,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI;wBACpB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;wBACtB,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;wBAChC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI;qBACrB;iBACF;aACF,CAAC,CAAC;QACL,CAAC;QAED,4DAA4D;QAC5D,YAAY,CAAC,IAAY;YACvB,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,CAAC,OAAO;gBAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,KAAK,GAAG,MAAM,CAAoD,KAAK,OAAO,EAAE,EAAE,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAE,CAAC;YAClH,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACzB,wEAAwE;gBACxE,yEAAyE;gBACzE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,8BAA8B,OAAO,IAAI,CAAC,EAAE,CAAC;YAC3H,CAAC;YACD,OAAO,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,CAAC;QAED,wFAAwF;QACxF,gBAAgB,CAAC,IAAY;YAC3B,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,CAAC,OAAO;gBAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,OAAO,EAAE,EAAE,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC;QAED;;;;;;;;;WASG;QACH,oBAAoB,CAAC,IAAY;YAC/B,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,CAAC,OAAO;gBAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAmC,EAAE,CAAC;YACnD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAmB,WAAW,CAAC,EAAE,CAAC;gBAC3D,KAAK,MAAM,MAAM,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,CAAU,EAAE,CAAC;oBAC7E,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;oBACjD,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;wBACnC,OAAO,CAAC,IAAI,CAAC;4BACX,OAAO,EAAE,KAAK,CAAC,OAAO;4BACtB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;4BAC1B,MAAM;4BACN,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;4BAChC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;yBACvC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YACD,MAAM,aAAa,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1C,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE;oBACJ,KAAK,EAAE,OAAO,CAAC,MAAM;oBACrB,SAAS,EAAE,OAAO;oBAClB,aAAa;oBACb,MAAM,EAAE,WAAW;iBACpB;aACF,CAAC,CAAC;QACL,CAAC;QAED;;;;;WAKG;QACH,MAAM,CAAC,KAAa,EAAE,KAAK,GAAG,EAAE;YAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAyC,EAAE,CAAC;YACxD,MAAM,KAAK,GAAG,CAAC,MAA2C,EAAE,EAAE;gBAC5D,IAAI,KAAK,GAAG,CAAC,CAAC;gBACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,IAAI,GAAG,CAAC,CAAC;oBACb,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;wBACrC,IAAI,KAAK,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;4BAAE,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;oBACzE,CAAC;oBACD,IAAI,IAAI,KAAK,CAAC;wBAAE,OAAO,CAAC,CAAC,CAAC,kCAAkC;oBAC5D,KAAK,IAAI,IAAI,CAAC;gBAChB,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC,CAAC;YAEF,KAAK,MAAM,CAAC,IAAI,OAAO,CAAe,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;gBACrD,MAAM,CAAC,GAAG,KAAK,CAAC;oBACd,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;oBACX,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;oBACZ,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACnC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;iBACnB,CAAC,CAAC;gBACH,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5E,IAAI,CAAC;oBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC;YACxH,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,OAAO,CAAe,aAAa,CAAC,EAAE,CAAC;gBACrD,MAAM,CAAC,GAAG,KAAK,CAAC;oBACd,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;oBACX,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;oBACZ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC,CAAC;gBACH,IAAI,CAAC;oBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACrF,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,OAAO,CAA2E,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAC;gBACzH,MAAM,CAAC,GAAG,KAAK,CAAC;oBACd,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;oBACX,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;oBACb,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;iBACnB,CAAC,CAAC;gBACH,IAAI,CAAC;oBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACrG,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,OAAO,CAAmB,WAAW,CAAC,EAAE,CAAC;gBACvD,MAAM,CAAC,GAAG,KAAK,CAAC;oBACd,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;oBACd,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;oBACZ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;iBACnB,CAAC,CAAC;gBACH,IAAI,CAAC;oBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACrF,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACzE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;YACxE,OAAO,EAAE,CAAC;gBACR,IAAI;gBACJ,IAAI,EAAE;oBACJ,KAAK,EAAE,MAAM,CAAC,MAAM;oBACpB,KAAK,EAAE,IAAI,CAAC,MAAM;oBAClB,KAAK;oBACL,IAAI,EAAE,wEAAwE;iBAC/E;aACF,CAAC,CAAC;QACL,CAAC;QAED,eAAe;YACb,OAAO,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;QACrC,CAAC;QAED,mFAAmF;QACnF,OAAO,CAAC,CAAS;YACf,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;gBACzB,OAAO,IAAI,CACT,4BAA4B,CAAC,yGAAyG,CACvI,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,QAAQ;YACN,OAAO,EAAE,CAAC,OAAO,CAA0B,OAAO,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,gBAAgB;YACd,OAAO,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,mBAAmB;YACjB,OAAO,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,kBAAkB;YAChB,OAAO,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,oGAAoG;QACpG,iBAAiB,CAAC,IAAY;YAC5B,IAAI,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC;gBAAE,OAAO,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/F,MAAM,QAAQ,GAAG,OAAO,CAAqD,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CACtG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CACzB,CAAC;YACF,IAAI,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxD,OAAO,EAAE,CAAC,MAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/E,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAoC,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACnG,OAAO,IAAI,CAAC,4CAA4C,IAAI,iBAAiB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpG,CAAC;QAED,kFAAkF;QAClF,eAAe;YACb,MAAM,IAAI,GAAG,OAAO,CAAe,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;YACvF,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,aAAa,CAAC,IAAY;YACxB,MAAM,GAAG,GAAG,OAAO,CAAe,aAAa,CAAC,CAAC;YACjD,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAC7C,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC,wBAAwB,IAAI,iBAAiB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzG,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,IAAI,OAA6B,CAAC;AAElC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC,OAAO;QAAE,OAAO,GAAG,cAAc,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAChF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/server.d.ts

@@ -1,34 +1,108 @@
 /**
  * The Mzizi MCP server.
  *
- * Backed by `mzizi.dev/api/v1` over HTTP. There is no Supabase client here.
+ * Served from files. The registry tools answer from the bundle generated at build time
+ * from mzizi-dev/mzizi-registry at the commit pinned in `registry.pin.json`
+ * (`registry.ts`); skills from this repo's skill files (`generated/skills.ts`); docs by
+ * federating the Mintlify MCP at docs.mzizi.dev (`docs-federation.ts`). Nothing here
+ * talks to a database, and no registry data is fetched at request time.
  *
- * WHAT CHANGED AND WHY. This server used to build its tool catalog at startup from the
- * `mcp_tool_registry` table and dispatch each call to a Supabase RPC, edge function or
- * table read — 62 enabled tools, defined as data. Two things were wrong with that:
- *
- *   1. Components are not rows. They are real files in `nyuchi/mzizi` that the Next.js
- *      app compiles and typechecks, so an error in one fails the build. The app serves
- *      them over `/api/v1/*`, which makes that API the source of truth and this server
- *      one of its clients. Reading the database put a second, uncompiled representation
- *      in the path — one that could disagree with the code while still looking correct.
- *
- *   2. A tool surface defined in a table changes whenever someone edits a row: no diff,
- *      no review, no test. The 10 tools live in `tools.ts` as code, so changing them is
- *      a pull request.
- *
- * The 10 are specified in `docs/mcp-tool-consolidation.md` (mzizi repo). Each carries its
- * `replaces` list in `TOOL_COVERAGE`, so coverage of the old 62 is checkable rather than
- * asserted.
+ * The tool surface is code, not data: the 10 registry tools live in `tools.ts`, each
+ * carrying its `replaces` list in `TOOL_COVERAGE`, and the `docs_*` tools mirror
+ * whatever the docs server lists.
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Registry } from "./registry.js";
+import { type DocsFederationOptions } from "./docs-federation.js";
 import type { FundiToolContext } from "./fundi-client.js";
-export declare const MZIZI_MCP_VERSION = "0.9.1";
+import { type IssueDeskContext } from "./tools.js";
+export declare const MZIZI_MCP_VERSION = "0.10.0";
 export type CreateServerOptions = {
     fundi?: FundiToolContext;
-    /** Override the API base — used by tests and by a preview deployment. */
-    apiBaseUrl?: string;
-    fetchImpl?: typeof fetch;
+    /** The signed-in user's issue desk. See `tools.ts` — absent off the Worker. */
+    desk?: IssueDeskContext;
+    /** The caller is anonymous on the Worker's free tier. See `tools.ts` and `access.ts`. */
+    anonymous?: {
+        fundi: boolean;
+    };
+    /** The registry to answer from — tests pass a fixture. Defaults to the bundled one. */
+    registry?: () => Promise<Registry>;
+    /** Docs federation settings, or `false` to register no docs tools. */
+    docs?: DocsFederationOptions | false;
 };
+/**
+ * What this server exposes, computed from what was actually registered.
+ *
+ * Shared by three surfaces so they cannot disagree: the `mzizi://tools`
+ * resource, the `mzizi_mcp_describe` tool, and the unauthenticated
+ * `GET /catalogue.json` route the portal reads for its live tool count. A
+ * hand-maintained fourth copy is how the old `mcp_tool_registry` drifted from
+ * the tools it claimed to describe.
+ */
+export declare function describeTools(registered: string[]): {
+    version: string;
+    source: {
+        registry: string;
+        skills: string;
+        docs: string;
+    };
+    note: string;
+    access: {
+        model: string;
+        signIn: {
+            tools: string[];
+            how: string;
+            url: string;
+            oauthProtectedResource: string;
+        };
+        rateLimit: string;
+    };
+    tools: {
+        name: string;
+        access: import("./access.js").ToolAccess;
+        replaces: readonly string[];
+    }[];
+};
+/**
+ * The tool catalogue WITHOUT standing up a transport.
+ *
+ * `registerMziziTools` is pure — it declares tools against an `McpServer`, and the
+ * registry is only read when a tool runs. So a throwaway server is a legitimate way to
+ * ask "what would an authenticated caller see?", and it is the only way that stays
+ * correct when a tool is added. The docs tools come from the same cached list the live
+ * server uses, which never throws (see `docsTools`).
+ *
+ * It registers exactly what an ANONYMOUS caller is offered on the Worker: the free
+ * tools, plus the sign-in tools, listed so the reader learns they exist. `fundi` is
+ * whether this Worker can reach fundi at all, which is when `mzizi_fundi` is listed.
+ * Each entry carries its `access` ("free" or "sign-in"); see `access.ts`.
+ */
+export declare function mziziToolCatalogue(opts?: {
+    fundi?: boolean;
+    docs?: DocsFederationOptions | false;
+}): Promise<{
+    version: string;
+    source: {
+        registry: string;
+        skills: string;
+        docs: string;
+    };
+    note: string;
+    access: {
+        model: string;
+        signIn: {
+            tools: string[];
+            how: string;
+            url: string;
+            oauthProtectedResource: string;
+        };
+        rateLimit: string;
+    };
+    tools: {
+        name: string;
+        access: import("./access.js").ToolAccess;
+        replaces: readonly string[];
+    }[];
+}>;
 export declare function createMziziMcpServer(opts?: CreateServerOptions): Promise<McpServer>;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAEnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAIzD,eAAO,MAAM,iBAAiB,UAAU,CAAA;AAExC,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB,CAAA;AAED,wBAAsB,oBAAoB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,SAAS,CAAC,CA+D7F"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,OAAO,EAAmC,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAClG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EAAkD,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAIlG,eAAO,MAAM,iBAAiB,WAAW,CAAA;AAEzC,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB,yFAAyF;IACzF,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAA;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAA;IAClC,sEAAsE;IACtE,IAAI,CAAC,EAAE,qBAAqB,GAAG,KAAK,CAAA;CACrC,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;EAgBjD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,qBAAqB,GAAG,KAAK,CAAA;CAAO;;;;;;;;;;;;;;;;;;;;;;;GAU5G;AAED,wBAAsB,oBAAoB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,SAAS,CAAC,CAmE7F"}

package/dist/server.js

@@ -1,31 +1,71 @@
 /**
  * The Mzizi MCP server.
  *
- * Backed by `mzizi.dev/api/v1` over HTTP. There is no Supabase client here.
+ * Served from files. The registry tools answer from the bundle generated at build time
+ * from mzizi-dev/mzizi-registry at the commit pinned in `registry.pin.json`
+ * (`registry.ts`); skills from this repo's skill files (`generated/skills.ts`); docs by
+ * federating the Mintlify MCP at docs.mzizi.dev (`docs-federation.ts`). Nothing here
+ * talks to a database, and no registry data is fetched at request time.
  *
- * WHAT CHANGED AND WHY. This server used to build its tool catalog at startup from the
- * `mcp_tool_registry` table and dispatch each call to a Supabase RPC, edge function or
- * table read — 62 enabled tools, defined as data. Two things were wrong with that:
- *
- *   1. Components are not rows. They are real files in `nyuchi/mzizi` that the Next.js
- *      app compiles and typechecks, so an error in one fails the build. The app serves
- *      them over `/api/v1/*`, which makes that API the source of truth and this server
- *      one of its clients. Reading the database put a second, uncompiled representation
- *      in the path — one that could disagree with the code while still looking correct.
- *
- *   2. A tool surface defined in a table changes whenever someone edits a row: no diff,
- *      no review, no test. The 10 tools live in `tools.ts` as code, so changing them is
- *      a pull request.
- *
- * The 10 are specified in `docs/mcp-tool-consolidation.md` (mzizi repo). Each carries its
- * `replaces` list in `TOOL_COVERAGE`, so coverage of the old 62 is checkable rather than
- * asserted.
+ * The tool surface is code, not data: the 10 registry tools live in `tools.ts`, each
+ * carrying its `replaces` list in `TOOL_COVERAGE`, and the `docs_*` tools mirror
+ * whatever the docs server lists.
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { MziziApiClient } from "./api-client.js";
+import { REGISTRY_PIN as REGISTRY_PIN_INFO } from "./generated/registry-pin.js";
+import { registerDocsTools, DOCS_MCP_URL } from "./docs-federation.js";
 import { registerMziziTools, TOOL_COVERAGE, TOOL_PREFIX } from "./tools.js";
 import { jsonContent } from "./tool-result.js";
-export const MZIZI_MCP_VERSION = "0.9.1";
+import { accessFor, accessSummary } from "./access.js";
+export const MZIZI_MCP_VERSION = "0.10.0";
+/**
+ * What this server exposes, computed from what was actually registered.
+ *
+ * Shared by three surfaces so they cannot disagree: the `mzizi://tools`
+ * resource, the `mzizi_mcp_describe` tool, and the unauthenticated
+ * `GET /catalogue.json` route the portal reads for its live tool count. A
+ * hand-maintained fourth copy is how the old `mcp_tool_registry` drifted from
+ * the tools it claimed to describe.
+ */
+export function describeTools(registered) {
+    return {
+        version: MZIZI_MCP_VERSION,
+        source: {
+            registry: `${REGISTRY_PIN_INFO.repository}/tree/${REGISTRY_PIN_INFO.ref}`,
+            skills: "mzizi-dev/agent-tools mzizi-skills/skills (bundled at build time)",
+            docs: DOCS_MCP_URL,
+        },
+        note: "Registry data and skills are files bundled into this build at a pinned commit; docs_* tools are forwarded to the docs.mzizi.dev MCP. This server holds no database credential.",
+        access: accessSummary(registered),
+        tools: registered.map((name) => ({
+            name: name.startsWith("docs_") ? name : `${TOOL_PREFIX}${name}`,
+            access: accessFor(name),
+            replaces: TOOL_COVERAGE[name] ?? [],
+        })),
+    };
+}
+/**
+ * The tool catalogue WITHOUT standing up a transport.
+ *
+ * `registerMziziTools` is pure — it declares tools against an `McpServer`, and the
+ * registry is only read when a tool runs. So a throwaway server is a legitimate way to
+ * ask "what would an authenticated caller see?", and it is the only way that stays
+ * correct when a tool is added. The docs tools come from the same cached list the live
+ * server uses, which never throws (see `docsTools`).
+ *
+ * It registers exactly what an ANONYMOUS caller is offered on the Worker: the free
+ * tools, plus the sign-in tools, listed so the reader learns they exist. `fundi` is
+ * whether this Worker can reach fundi at all, which is when `mzizi_fundi` is listed.
+ * Each entry carries its `access` ("free" or "sign-in"); see `access.ts`.
+ */
+export async function mziziToolCatalogue(opts = {}) {
+    const server = new McpServer({ name: "mzizi-mcp", version: MZIZI_MCP_VERSION, title: "Mzizi" }, { capabilities: { tools: {}, resources: {} } });
+    const registered = registerMziziTools(server, { anonymous: { fundi: opts.fundi === true } });
+    const docs = opts.docs === false ? [] : await registerDocsTools(server, opts.docs ?? {});
+    // Mirrors the direct registration in `createMziziMcpServer`, which is the one
+    // tool not declared in `tools.ts`.
+    return describeTools([...registered, "mcp_describe", ...docs]);
+}
 export async function createMziziMcpServer(opts = {}) {
     const server = new McpServer({
         name: "mzizi-mcp",
@@ -36,19 +76,15 @@ export async function createMziziMcpServer(opts = {}) {
             tools: { listChanged: true },
             resources: { listChanged: true },
         },
-        instructions: "Access to the Mzizi design system (a nyuchi-brand project of the Bundu ecosystem) over its public API: components, design tokens, brand, the DNA-helix architecture, Ubuntu doctrine, agent skills and releases. Ten tools. Start with mzizi_search if you do not know the name of what you want; mzizi_get_component returns a component in full in one read; mzizi_get_architecture returns the helix and takes an uncapped node number.",
+        instructions: "Access to the Mzizi design system: components, design tokens, brand, the DNA-helix architecture, Ubuntu doctrine and conventions, agent skills and releases (the mzizi_* tools, served from files bundled at a pinned registry commit), plus the documentation site (the docs_* tools, forwarded to docs.mzizi.dev). Start with mzizi_search if you do not know the name of what you want; mzizi_get_component returns a component in full in one read; mzizi_get_architecture returns the helix and takes an uncapped node number; docs_search_mzizi searches the documentation. Every tool is free without an account except mzizi_fundi and mzizi_report_issue, which act as your Mzizi console user and need sign-in; called without it they say how to sign in.",
     });
-    const api = new MziziApiClient({ baseUrl: opts.apiBaseUrl, fetchImpl: opts.fetchImpl });
-    const registered = registerMziziTools(server, { api, fundi: opts.fundi });
-    const describe = () => ({
-        version: MZIZI_MCP_VERSION,
-        source: "https://mzizi.dev/api/v1",
-        note: "Components are files in nyuchi/mzizi compiled by the Next.js app and served over /api/v1. This server reads that API and holds no database credential.",
-        tools: registered.map((name) => ({
-            name: `${TOOL_PREFIX}${name}`,
-            replaces: TOOL_COVERAGE[name] ?? [],
-        })),
+    const registered = registerMziziTools(server, {
+        registry: opts.registry,
+        fundi: opts.fundi,
+        desk: opts.desk,
+        anonymous: opts.anonymous,
     });
+    const describe = () => describeTools(registered);
     // Computed from what was actually registered, never a hand-maintained list — a
     // hardcoded catalog is how the old registry drifted from the tools it described.
     server.registerResource("mzizi-tools", "mzizi://tools", {
@@ -64,11 +100,19 @@ export async function createMziziMcpServer(opts = {}) {
             },
         ],
     }));
+    // Registered here rather than in `tools.ts` because it closes over `describe`,
+    // but it still has to land in `registered` — otherwise every catalogue surface
+    // reports one tool fewer than the server actually answers to.
+    registered.push("mcp_describe");
     server.registerTool(`${TOOL_PREFIX}mcp_describe`, {
         title: "Describe this server",
-        description: "What this MCP server exposes: its tools, what each replaces, and where its data comes from.",
+        description: "What this MCP server exposes: its tools, which are free and which need sign-in, what each replaces, and where its data comes from.",
         annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
     }, async () => jsonContent(describe()));
+    // Last, so the describe tool and resource report them too: `describe` reads
+    // `registered` when called, not when defined.
+    if (opts.docs !== false)
+        registered.push(...(await registerDocsTools(server, opts.docs ?? {})));
     return server;
 }
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAA;AASxC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAA4B,EAAE;IACvE,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,iBAAiB;QAC1B,KAAK,EAAE,OAAO;KACf,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YAC5B,SAAS,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;SACjC;QACD,YAAY,EACV,4aAA4a;KAC/a,CACF,CAAA;IAED,MAAM,GAAG,GAAG,IAAI,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;IACvF,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;IAEzE,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC;QACtB,OAAO,EAAE,iBAAiB;QAC1B,MAAM,EAAE,0BAA0B;QAClC,IAAI,EAAE,wJAAwJ;QAC9J,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAE,GAAG,WAAW,GAAG,IAAI,EAAE;YAC7B,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE;SACpC,CAAC,CAAC;KACJ,CAAC,CAAA;IAEF,+EAA+E;IAC/E,iFAAiF;IACjF,MAAM,CAAC,gBAAgB,CACrB,aAAa,EACb,eAAe,EACf;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,sEAAsE;QACnF,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;aAC1C;SACF;KACF,CAAC,CACH,CAAA;IAED,MAAM,CAAC,YAAY,CACjB,GAAG,WAAW,cAAc,EAC5B;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,6FAA6F;QAC/F,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAChF,EACD,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CACpC,CAAA;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/stdio.d.ts

@@ -3,20 +3,13 @@
  * stdio entry — for the MCP registry (`npx mzizi-mcp`) and local MCP clients
  * (Claude Code, etc.).
  *
- * Spawns the server over the stdio transport, using a long-lived Supabase
- * anon client. RLS on `component_documents` enforces read-only.
+ * Zero-config and credential-free: the registry data and skills are bundled
+ * into this package at build time (from the mzizi-registry commit pinned in
+ * `registry.pin.json`), so the registry tools need no network at all. The
+ * `docs_*` tools forward to the public docs MCP at docs.mzizi.dev.
  *
- * Zero-config: the public Mzizi registry URL + publishable key are baked in
- * as defaults (see defaults.ts — they are not secrets), so `npx mzizi-mcp`
- * works with no environment set. This is the sanctioned headless path: the
- * hosted mcp.mzizi.dev endpoint sits behind an interactive, browser-only
- * WorkOS signup gate that a headless agent cannot complete, whereas this bin
- * reads the same public registry directly.
- *
- * Env (optional — override the defaults to point at a fork / self-hosted
- * mirror):
- *   SUPABASE_URL              (or NEXT_PUBLIC_SUPABASE_URL)
- *   SUPABASE_PUBLISHABLE_KEY  (or NEXT_PUBLIC_SUPABASE_ANON_KEY)
+ * `MZIZI_API_BASE` is gone: there is no registry API to point at any more. To
+ * serve different registry content, build with a different pin.
  */
 export {};
 //# sourceMappingURL=stdio.d.ts.map

package/dist/stdio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG"}
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}