@zenalexa/unicli 0.220.0 → 0.220.1

package/dist/adapters/vndb/web.js

@@ -0,0 +1,321 @@
+/**
+ * @owner   src/adapters/vndb/web.ts
+ * @does    Register VNDB public visual novel, release, tag, staff, producer, and character lookup commands.
+ * @needs   VNDB Kana API JSON contract and public unauthenticated read endpoints.
+ * @feeds   ACG research workflows, visual novel discovery, game tag/type search.
+ * @breaks  VNDB field names or filter semantics drifting will hide games or metadata.
+ */
+import { USER_AGENT } from "../../constants.js";
+import { cli, Strategy } from "../../registry.js";
+const VNDB_API = "https://api.vndb.org/kana";
+function str(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function requireQuery(value) {
+    const query = str(value).trim();
+    if (!query)
+        throw new Error("VNDB query cannot be empty.");
+    return query;
+}
+function requireLimit(value, fallback = 20) {
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > 100) {
+        throw new Error("VNDB limit must be an integer in [1, 100].");
+    }
+    return n;
+}
+function normalizeId(value, prefix) {
+    const raw = str(value).trim().toLowerCase();
+    if (!raw)
+        throw new Error("VNDB id cannot be empty.");
+    return raw.startsWith(prefix) ? raw : `${prefix}${raw}`;
+}
+function joinNames(value, key = "name") {
+    return Array.isArray(value)
+        ? value
+            .map((item) => str(item[key]))
+            .join(", ")
+        : "";
+}
+function joinStrings(value) {
+    return Array.isArray(value) ? value.map(String).join(", ") : str(value);
+}
+function firstUrl(value) {
+    if (!value || typeof value !== "object")
+        return "";
+    return str(value.url);
+}
+function tagSummary(value) {
+    if (!Array.isArray(value))
+        return "";
+    return value
+        .slice()
+        .sort((a, b) => Number(b.rating ?? 0) -
+        Number(a.rating ?? 0))
+        .slice(0, 12)
+        .map((item) => str(item.name))
+        .filter(Boolean)
+        .join(", ");
+}
+function sortValue(value, allowed) {
+    const key = str(value || "relevance")
+        .toLowerCase()
+        .replace(/[\s_-]+/g, "");
+    const mapped = allowed[key];
+    if (!mapped) {
+        throw new Error(`Unsupported VNDB sort: ${value}. Supported: ${Object.keys(allowed).join(", ")}.`);
+    }
+    return mapped;
+}
+async function vndbPost(endpoint, body) {
+    const response = await fetch(`${VNDB_API}/${endpoint}`, {
+        method: "POST",
+        headers: {
+            Accept: "application/json",
+            "Content-Type": "application/json",
+            "User-Agent": USER_AGENT,
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        throw new Error(`VNDB ${endpoint} request failed with HTTP ${response.status}.`);
+    }
+    const json = (await response.json());
+    return json.results ?? [];
+}
+function rankRows(rows) {
+    return rows.map((row, index) => ({ rank: index + 1, ...row }));
+}
+export function mapVndbVisualNovels(rows) {
+    return rankRows(rows.map((item) => ({
+        id: str(item.id),
+        title: str(item.title),
+        alttitle: str(item.alttitle),
+        released: str(item.released),
+        languages: joinStrings(item.languages),
+        platforms: joinStrings(item.platforms),
+        rating: item.rating ?? "",
+        votecount: item.votecount ?? "",
+        developers: joinNames(item.developers),
+        tags: tagSummary(item.tags),
+        image: firstUrl(item.image),
+        url: `https://vndb.org/${str(item.id)}`,
+    })));
+}
+export function mapVndbReleases(rows) {
+    return rankRows(rows.map((item) => ({
+        id: str(item.id),
+        title: str(item.title),
+        released: str(item.released),
+        platforms: joinStrings(item.platforms),
+        producers: joinNames(item.producers),
+        vns: joinNames(item.vns, "title"),
+        url: `https://vndb.org/${str(item.id)}`,
+    })));
+}
+function mapSimple(rows, urlPrefix) {
+    return rankRows(rows.map((item) => ({
+        id: str(item.id),
+        name: str(item.name),
+        original: str(item.original),
+        category: str(item.category),
+        type: str(item.type),
+        lang: str(item.lang),
+        aliases: joinStrings(item.aliases),
+        description: str(item.description).replace(/\s+/g, " ").slice(0, 500),
+        url: `https://vndb.org/${urlPrefix}${str(item.id).replace(/^[a-z]+/, "")}`,
+    })));
+}
+async function searchVn(kwargs) {
+    const sort = sortValue(kwargs.sort, {
+        relevance: "searchrank",
+        rating: "rating",
+        votes: "votecount",
+        votecount: "votecount",
+        released: "released",
+        time: "released",
+        title: "title",
+    });
+    const rows = await vndbPost("vn", {
+        filters: ["search", "=", requireQuery(kwargs.query)],
+        fields: "id,title,alttitle,released,languages,platforms,rating,votecount,image.url,tags.rating,tags.name,tags.category,developers.name",
+        sort,
+        reverse: kwargs.reverse === true,
+        results: requireLimit(kwargs.limit),
+    });
+    return mapVndbVisualNovels(rows);
+}
+const VN_COLUMNS = [
+    "rank",
+    "id",
+    "title",
+    "alttitle",
+    "released",
+    "languages",
+    "platforms",
+    "rating",
+    "votecount",
+    "developers",
+    "tags",
+    "url",
+];
+cli({
+    site: "vndb",
+    name: "search",
+    description: "Search VNDB visual novels by title, alias, tag, or keyword",
+    domain: "api.vndb.org",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: "query", type: "str", required: true, positional: true },
+        { name: "limit", type: "int", default: 20 },
+        {
+            name: "sort",
+            type: "str",
+            default: "relevance",
+            description: "relevance, rating, votes, released, time, title",
+        },
+        { name: "reverse", type: "bool", default: false },
+    ],
+    columns: VN_COLUMNS,
+    func: async (_page, kwargs) => searchVn(kwargs),
+});
+cli({
+    site: "vndb",
+    name: "vn",
+    description: "Get VNDB visual novel details by v-id",
+    domain: "api.vndb.org",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [{ name: "id", type: "str", required: true, positional: true }],
+    columns: VN_COLUMNS,
+    func: async (_page, kwargs) => mapVndbVisualNovels(await vndbPost("vn", {
+        filters: ["id", "=", normalizeId(kwargs.id, "v")],
+        fields: "id,title,alttitle,released,languages,platforms,rating,votecount,image.url,tags.rating,tags.name,tags.category,developers.name",
+        results: 1,
+    })),
+});
+cli({
+    site: "vndb",
+    name: "releases",
+    description: "Search VNDB releases by title or visual novel keyword",
+    domain: "api.vndb.org",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: "query", type: "str", required: true, positional: true },
+        { name: "limit", type: "int", default: 20 },
+        {
+            name: "sort",
+            type: "str",
+            default: "released",
+            description: "released, time, title",
+        },
+        { name: "reverse", type: "bool", default: true },
+    ],
+    columns: [
+        "rank",
+        "id",
+        "title",
+        "released",
+        "platforms",
+        "producers",
+        "vns",
+        "url",
+    ],
+    func: async (_page, kwargs) => mapVndbReleases(await vndbPost("release", {
+        filters: ["search", "=", requireQuery(kwargs.query)],
+        fields: "id,title,released,platforms,producers.name,vns.title",
+        sort: sortValue(kwargs.sort, {
+            released: "released",
+            time: "released",
+            title: "title",
+        }),
+        reverse: kwargs.reverse !== false,
+        results: requireLimit(kwargs.limit),
+    })),
+});
+cli({
+    site: "vndb",
+    name: "tags",
+    description: "Search VNDB game tags and genres",
+    domain: "api.vndb.org",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: "query", type: "str", required: true, positional: true },
+        { name: "limit", type: "int", default: 20 },
+    ],
+    columns: ["rank", "id", "name", "category", "description", "url"],
+    func: async (_page, kwargs) => mapSimple(await vndbPost("tag", {
+        filters: ["search", "=", requireQuery(kwargs.query)],
+        fields: "id,name,category,description",
+        results: requireLimit(kwargs.limit),
+    }), "g"),
+});
+cli({
+    site: "vndb",
+    name: "staff",
+    description: "Search VNDB creators and staff",
+    domain: "api.vndb.org",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: "query", type: "str", required: true, positional: true },
+        { name: "limit", type: "int", default: 20 },
+    ],
+    columns: ["rank", "id", "name", "original", "lang", "description", "url"],
+    func: async (_page, kwargs) => mapSimple(await vndbPost("staff", {
+        filters: ["search", "=", requireQuery(kwargs.query)],
+        fields: "id,name,original,lang,gender,description",
+        results: requireLimit(kwargs.limit),
+    }), "s"),
+});
+cli({
+    site: "vndb",
+    name: "producers",
+    description: "Search VNDB producers, studios, brands, makers, circles, companies, and visual novel publishers such as Yuzusoft",
+    domain: "api.vndb.org",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: "query", type: "str", required: true, positional: true },
+        { name: "limit", type: "int", default: 20 },
+    ],
+    columns: [
+        "rank",
+        "id",
+        "name",
+        "aliases",
+        "lang",
+        "type",
+        "description",
+        "url",
+    ],
+    func: async (_page, kwargs) => mapSimple(await vndbPost("producer", {
+        filters: ["search", "=", requireQuery(kwargs.query)],
+        fields: "id,name,aliases,lang,type,description",
+        results: requireLimit(kwargs.limit),
+    }), "p"),
+});
+cli({
+    site: "vndb",
+    name: "characters",
+    description: "Search VNDB characters and traits",
+    domain: "api.vndb.org",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: "query", type: "str", required: true, positional: true },
+        { name: "limit", type: "int", default: 20 },
+    ],
+    columns: ["rank", "id", "name", "original", "description", "url"],
+    func: async (_page, kwargs) => mapSimple(await vndbPost("character", {
+        filters: ["search", "=", requireQuery(kwargs.query)],
+        fields: "id,name,original,sex,description,vns.title,traits.name",
+        results: requireLimit(kwargs.limit),
+    }), "c"),
+});
+//# sourceMappingURL=web.js.map

package/dist/adapters/vndb/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../src/adapters/vndb/web.ts"],"names":[],"mappings":"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"}

package/dist/agents/codex-pack.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @owner Uni-CLI Agents
+ * @does Builds the compact Codex install pack from CommandContract metadata.
+ * @needs Adapter registry snapshots and command-contract projection.
+ * @feeds `unicli agents generate --for codex`, docs, and F4 release gates.
+ * @breaks Codex onboarding when it enumerates the catalog or exposes expanded MCP by default.
+ */
+import type { AdapterManifest } from "../types.js";
+export interface CodexPackInput {
+    version: string;
+    date: string;
+    adapters: AdapterManifest[];
+}
+export interface CodexSmokeTask {
+    name: string;
+    command: string;
+    proves: string;
+}
+export interface CodexPack {
+    schema_version: "codex-pack.v1";
+    package: string;
+    version: string;
+    date: string;
+    default_surface: "native_cli_plus_deferred_mcp";
+    counts: {
+        sites: number;
+        commands: number;
+    };
+    mcp_config: {
+        command: "npx";
+        args: string[];
+    };
+    tool_exposure: {
+        default_tools: number;
+        deferred_stubs: number;
+        expanded_tools: number;
+        expanded_opt_in: true;
+    };
+    contract_summary: {
+        schema_version: "command-contract.v1";
+        read_only: number;
+        write_or_destructive: number;
+        auth_required: number;
+        browser_backed: number;
+        artifact_producers: number;
+    };
+    deferred_toolsearch: {
+        source: "CommandContract";
+        tool_name_pattern: "unicli_<site>_<command>";
+        loaded_fields: string[];
+        full_schema_resolution: "tools/call via expandedRegistry";
+    };
+    smoke_tasks: CodexSmokeTask[];
+    token_budget: {
+        method: "heuristic-o200k";
+        estimated_tokens: number;
+        chars: number;
+    };
+}
+export declare function formatCodexPack(pack: CodexPack): string;
+export declare function buildCodexPack(input: CodexPackInput): CodexPack;
+//# sourceMappingURL=codex-pack.d.ts.map

package/dist/agents/codex-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-pack.d.ts","sourceRoot":"","sources":["../../src/agents/codex-pack.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,eAAe,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,8BAA8B,CAAC;IAChD,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,UAAU,EAAE;QACV,OAAO,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IACF,aAAa,EAAE;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,IAAI,CAAC;KACvB,CAAC;IACF,gBAAgB,EAAE;QAChB,cAAc,EAAE,qBAAqB,CAAC;QACtC,SAAS,EAAE,MAAM,CAAC;QAClB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,mBAAmB,EAAE;QACnB,MAAM,EAAE,iBAAiB,CAAC;QAC1B,iBAAiB,EAAE,yBAAyB,CAAC;QAC7C,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,sBAAsB,EAAE,iCAAiC,CAAC;KAC3D,CAAC;IACF,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,EAAE;QACZ,MAAM,EAAE,iBAAiB,CAAC;QAC1B,gBAAgB,EAAE,MAAM,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AA8GD,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CA6CvD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAO/D"}

package/dist/agents/codex-pack.js

@@ -0,0 +1,163 @@
+/**
+ * @owner Uni-CLI Agents
+ * @does Builds the compact Codex install pack from CommandContract metadata.
+ * @needs Adapter registry snapshots and command-contract projection.
+ * @feeds `unicli agents generate --for codex`, docs, and F4 release gates.
+ * @breaks Codex onboarding when it enumerates the catalog or exposes expanded MCP by default.
+ */
+import { buildCommandContract } from "../core/command-contract.js";
+function estimateTokens(input) {
+    const chars = input.length;
+    const words = input.trim().length === 0 ? 0 : input.trim().split(/\s+/).length;
+    return {
+        method: "heuristic-o200k",
+        estimated_tokens: Math.max(Math.ceil(chars / 3.6), Math.ceil(words / 0.75)),
+        chars,
+    };
+}
+function commandEntries(adapters) {
+    return adapters.flatMap((adapter) => {
+        return Object.keys(adapter.commands).map((commandName) => ({
+            adapter,
+            commandName,
+        }));
+    });
+}
+function buildContractSummary(adapters) {
+    const summary = {
+        schema_version: "command-contract.v1",
+        read_only: 0,
+        write_or_destructive: 0,
+        auth_required: 0,
+        browser_backed: 0,
+        artifact_producers: 0,
+    };
+    for (const { adapter, commandName } of commandEntries(adapters)) {
+        const command = adapter.commands[commandName];
+        if (!command)
+            continue;
+        const contract = buildCommandContract({ adapter, commandName, command });
+        if (contract.effect.read_only)
+            summary.read_only++;
+        else
+            summary.write_or_destructive++;
+        if (contract.auth.required)
+            summary.auth_required++;
+        if (contract.effect.browser)
+            summary.browser_backed++;
+        if (contract.artifacts.produces_files)
+            summary.artifact_producers++;
+    }
+    return summary;
+}
+function codexPackWithoutBudget(input) {
+    const commands = commandEntries(input.adapters).length;
+    return {
+        schema_version: "codex-pack.v1",
+        package: "@zenalexa/unicli",
+        version: input.version,
+        date: input.date,
+        default_surface: "native_cli_plus_deferred_mcp",
+        counts: {
+            sites: input.adapters.length,
+            commands,
+        },
+        mcp_config: {
+            command: "npx",
+            args: ["-y", "@zenalexa/unicli", "mcp", "serve", "--profile", "deferred"],
+        },
+        tool_exposure: {
+            default_tools: 4,
+            deferred_stubs: commands,
+            expanded_tools: commands + 4,
+            expanded_opt_in: true,
+        },
+        contract_summary: buildContractSummary(input.adapters),
+        deferred_toolsearch: {
+            source: "CommandContract",
+            tool_name_pattern: "unicli_<site>_<command>",
+            loaded_fields: [
+                "identity.site",
+                "identity.command",
+                "description",
+                "schemas.input",
+                "effect",
+                "auth",
+                "repair",
+            ],
+            full_schema_resolution: "tools/call via expandedRegistry",
+        },
+        smoke_tasks: [
+            {
+                name: "catalog discovery",
+                command: 'unicli search "hackernews top stories"',
+                proves: "native CLI remains the primary low-context entry point",
+            },
+            {
+                name: "mcp health",
+                command: "unicli mcp health --json",
+                proves: "local registry loads before Codex attaches MCP",
+            },
+            {
+                name: "deferred MCP",
+                command: "npx -y @zenalexa/unicli mcp serve --profile deferred",
+                proves: "Codex sees ToolSearch-ready stubs instead of expanded schemas",
+            },
+        ],
+    };
+}
+export function formatCodexPack(pack) {
+    const tomlArgs = `[${pack.mcp_config.args
+        .map((arg) => JSON.stringify(arg))
+        .join(", ")}]`;
+    const lines = [
+        "# Codex Uni-CLI Pack",
+        "",
+        "Use native CLI first for command execution; attach deferred MCP for ToolSearch discovery.",
+        "",
+        "```toml",
+        "[mcp_servers.unicli]",
+        `command = ${JSON.stringify(pack.mcp_config.command)}`,
+        `args = ${tomlArgs}`,
+        "```",
+        "",
+        "## Contract",
+        "",
+        `- Source: CommandContract (${pack.contract_summary.schema_version})`,
+        `- Sites: ${pack.counts.sites}`,
+        `- Commands: ${pack.counts.commands}`,
+        `- Read-only: ${pack.contract_summary.read_only}`,
+        `- Write/destructive: ${pack.contract_summary.write_or_destructive}`,
+        `- Auth required: ${pack.contract_summary.auth_required}`,
+        `- Browser-backed: ${pack.contract_summary.browser_backed}`,
+        "",
+        "## Tool Exposure",
+        "",
+        `- Default tools: ${pack.tool_exposure.default_tools}`,
+        `- Deferred stubs: ${pack.tool_exposure.deferred_stubs}`,
+        `- Expanded tools: ${pack.tool_exposure.expanded_tools} (explicit opt-in only)`,
+        `- Tool pattern: ${pack.deferred_toolsearch.tool_name_pattern}`,
+        "",
+        "## Smoke",
+        "",
+        ...pack.smoke_tasks.map((task) => {
+            return `- ${task.command} — ${task.proves}`;
+        }),
+        "",
+        "## Budget",
+        "",
+        `- Estimated pack tokens: ${pack.token_budget.estimated_tokens}`,
+        `- Method: ${pack.token_budget.method}`,
+        "",
+    ];
+    return lines.join("\n");
+}
+export function buildCodexPack(input) {
+    const base = codexPackWithoutBudget(input);
+    const content = formatCodexPack({
+        ...base,
+        token_budget: { method: "heuristic-o200k", estimated_tokens: 0, chars: 0 },
+    });
+    return { ...base, token_budget: estimateTokens(content) };
+}
+//# sourceMappingURL=codex-pack.js.map

package/dist/agents/codex-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-pack.js","sourceRoot":"","sources":["../../src/agents/codex-pack.ts"],"names":[],"mappings":"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"}

package/dist/commands/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwcpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyF5D"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0ZpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyF5D"}

package/dist/commands/agents.js

@@ -22,6 +22,7 @@ import chalk from "chalk";
 import { writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { registerAgentBackendCommands } from "./agents-backends.js";
+import { buildCodexPack, formatCodexPack } from "../agents/codex-pack.js";
 import { commandRequiresAuth, commandStrategy, getAllAdapters, listCommands, } from "../registry.js";
 import { VERSION } from "../constants.js";
 import { format, detectFormat } from "../output/formatter.js";
@@ -158,49 +159,11 @@ function formatClaude(ctx) {
     return lines.join("\n");
 }
 function formatCodex(ctx) {
-    const lines = [];
-    // TOML MCP config snippet
-    lines.push("# .codex/config.toml — MCP server configuration");
-    lines.push("");
-    lines.push("[mcp_servers.unicli]");
-    lines.push('command = "npx"');
-    lines.push('args = ["-y", "@zenalexa/unicli", "mcp", "serve"]');
-    lines.push("");
-    lines.push("# ---");
-    lines.push("");
-    // AGENTS.md portion
-    lines.push(`# unicli — ${ctx.sites} sites, ${ctx.commands} commands`);
-    lines.push("");
-    lines.push("## Installation");
-    lines.push("");
-    lines.push("```bash");
-    lines.push("npm i -g @zenalexa/unicli");
-    lines.push("```");
-    lines.push("");
-    lines.push("## Usage");
-    lines.push("");
-    lines.push("```");
-    lines.push("unicli <site> <command> [args] [--json]");
-    lines.push("```");
-    lines.push("");
-    lines.push("Piped output auto-switches to JSON. Exit codes follow sysexits.h.");
-    lines.push("");
-    lines.push("## Sites");
-    lines.push("");
-    for (const adapter of ctx.adapters) {
-        lines.push(`### ${adapter.name}`);
-        for (const [cmd, info] of Object.entries(adapter.commands)) {
-            const desc = info.description ?? "";
-            lines.push(`- \`unicli ${adapter.name} ${cmd}\` — ${desc}`);
-        }
-    }
-    lines.push("");
-    lines.push("## Self-Repair");
-    lines.push("");
-    lines.push("On failure, structured JSON errors include `adapter_path` and `suggestion`.");
-    lines.push("Read the adapter file, fix, and retry. Automated: `unicli repair <site> <command>`.");
-    lines.push("");
-    return lines.join("\n");
+    return formatCodexPack(buildCodexPack({
+        version: ctx.version,
+        date: ctx.date,
+        adapters: ctx.adapters,
+    }));
 }
 function formatOpenclaw(ctx) {
     const skills = ctx.commandList.map((cmd) => ({