mewkit 1.11.2 → 1.12.0

package/dist/wiki/infrastructure/wiki-query.js

@@ -0,0 +1,46 @@
+import fs from "node:fs";
+import { DatabaseSync } from "node:sqlite";
+/** ~4 chars per token — a cheap budget hint, not an exact tokenizer. */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/** Full-text search over page title + body. Returns provenance (slug/path via the
+ * page id) and a snippet with a token-budget estimate. */
+export function searchWiki(dbFile, query, limit = 10) {
+    if (!fs.existsSync(dbFile))
+        return [];
+    const db = new DatabaseSync(dbFile, { readOnly: true });
+    try {
+        const rows = db
+            .prepare("SELECT f.page_id AS pageId, f.slug AS slug, f.title AS title, snippet(wiki_fts, 3, '[', ']', '…', 12) AS snippet, p.content AS content FROM wiki_fts f JOIN wiki_page p ON p.id = f.page_id WHERE wiki_fts MATCH ? ORDER BY rank LIMIT ?")
+            .all(query, limit);
+        return rows.map((r) => ({
+            pageId: r.pageId,
+            slug: r.slug,
+            title: r.title,
+            snippet: r.snippet,
+            tokenEstimate: estimateTokens(r.content ?? ""),
+        }));
+    }
+    finally {
+        db.close();
+    }
+}
+/** List committed/approved pages for a slug (or all slugs when omitted). */
+export function listWikiPages(dbFile, slug) {
+    if (!fs.existsSync(dbFile))
+        return [];
+    const db = new DatabaseSync(dbFile, { readOnly: true });
+    try {
+        const sql = "SELECT id, slug, title, path, state FROM wiki_page" +
+            (slug ? " WHERE slug = ?" : "") +
+            " ORDER BY slug, title";
+        const stmt = db.prepare(sql);
+        const rows = (slug ? stmt.all(slug) : stmt.all());
+        return rows;
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=wiki-query.js.map

package/dist/wiki/infrastructure/wiki-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-query.js","sourceRoot":"","sources":["../../../src/wiki/infrastructure/wiki-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiB3C,wEAAwE;AACxE,SAAS,cAAc,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACnC,CAAC;AAED;0DAC0D;AAC1D,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,KAAa,EAAE,KAAK,GAAG,EAAE;IACnE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,EAAE;aACb,OAAO,CACP,0OAA0O,CAC1O;aACA,GAAG,CAAC,KAAK,EAAE,KAAK,CAAwF,CAAC;QAC3G,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;SAC9C,CAAC,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACV,EAAE,CAAC,KAAK,EAAE,CAAC;IACZ,CAAC;AACF,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,IAAa;IAC1D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC;QACJ,MAAM,GAAG,GACR,oDAAoD;YACpD,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,uBAAuB,CAAC;QACzB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAkB,CAAC;QACnE,OAAO,IAAI,CAAC;IACb,CAAC;YAAS,CAAC;QACV,EAAE,CAAC,KAAK,EAAE,CAAC;IACZ,CAAC;AACF,CAAC"}

package/dist/wiki/infrastructure/wiki-schema.d.ts

@@ -0,0 +1,3 @@
+export declare const WIKI_TABLES: readonly string[];
+export declare const WIKI_MIGRATION_SQL: string;
+//# sourceMappingURL=wiki-schema.d.ts.map

package/dist/wiki/infrastructure/wiki-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-schema.d.ts","sourceRoot":"","sources":["../../../src/wiki/infrastructure/wiki-schema.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAaxC,CAAC;AAuBF,eAAO,MAAM,kBAAkB,EAAE,MAAuC,CAAC"}

package/dist/wiki/infrastructure/wiki-schema.js

@@ -0,0 +1,43 @@
+// Wiki DDL for the consolidated derived index (report section 5). Applied as the
+// derived-index migration v2. Columns mirror the domain types. Every
+// statement here is a compile-time constant with no interpolation. wiki_fts is a
+// standalone FTS5 table kept in sync with wiki_page by triggers; the full-rebuild
+// ingest stays the source of truth.
+// Tables cleared (FK-safe order) before a full wiki re-ingest. These names are
+// hard-coded constants, never user input, so they are safe to use in a clear loop.
+export const WIKI_TABLES = [
+    "wiki_fts",
+    "wiki_link",
+    "wiki_salience",
+    "wiki_candidate",
+    "wiki_seed",
+    "wiki_claim",
+    "wiki_source",
+    "wiki_page_version",
+    "wiki_page",
+    "wiki_write_event",
+    "wiki_intervention",
+    "wiki",
+];
+// One DDL statement per element, joined into a single migration script. Plain
+// string literals (no template strings) keep this provably interpolation-free.
+const WIKI_DDL_STATEMENTS = [
+    "CREATE TABLE wiki (slug TEXT PRIMARY KEY, title TEXT NOT NULL, created_at TEXT, updated_at TEXT);",
+    "CREATE TABLE wiki_page (id TEXT PRIMARY KEY, slug TEXT NOT NULL, title TEXT NOT NULL, path TEXT NOT NULL, content TEXT NOT NULL, state TEXT NOT NULL, origin TEXT NOT NULL, created_at TEXT, updated_at TEXT);",
+    "CREATE INDEX idx_wiki_page_slug ON wiki_page(slug);",
+    "CREATE TABLE wiki_page_version (id INTEGER PRIMARY KEY, page_id TEXT NOT NULL, version INTEGER NOT NULL, content TEXT NOT NULL, created_at TEXT);",
+    "CREATE TABLE wiki_source (id TEXT PRIMARY KEY, kind TEXT NOT NULL, url TEXT NOT NULL, title TEXT, fetched_at TEXT, content_hash TEXT);",
+    "CREATE TABLE wiki_claim (id TEXT PRIMARY KEY, text TEXT NOT NULL, external INTEGER NOT NULL, source_id TEXT, page_id TEXT);",
+    "CREATE TABLE wiki_seed (id TEXT PRIMARY KEY, query TEXT NOT NULL, kind TEXT NOT NULL, status TEXT NOT NULL, created_at TEXT);",
+    "CREATE TABLE wiki_candidate (id TEXT PRIMARY KEY, slug TEXT NOT NULL, origin TEXT NOT NULL, title TEXT NOT NULL, content TEXT NOT NULL, why_save TEXT, evidence TEXT, novelty_delta REAL, reuse_scope TEXT, verification_state TEXT, risk_score REAL, salience_total REAL, state TEXT NOT NULL, created_at TEXT, review_after TEXT);",
+    "CREATE TABLE wiki_salience (candidate_id TEXT PRIMARY KEY, explicit_user_intent REAL, verified_outcome REAL, recurrence_or_friction REAL, novelty_vs_existing_wiki REAL, future_reuse_likelihood REAL, source_quality REAL, blast_radius REAL, security_risk_penalty REAL, staleness_penalty REAL, total REAL);",
+    "CREATE TABLE wiki_write_event (id INTEGER PRIMARY KEY, ts TEXT, decision_kind TEXT NOT NULL, candidate_id TEXT, page_id TEXT, reason TEXT);",
+    "CREATE TABLE wiki_intervention (id TEXT PRIMARY KEY, kind TEXT NOT NULL, candidate_id TEXT, reason TEXT, actor TEXT, created_at TEXT);",
+    "CREATE TABLE wiki_link (from_page_id TEXT NOT NULL, to_page_id TEXT NOT NULL, PRIMARY KEY (from_page_id, to_page_id));",
+    "CREATE VIRTUAL TABLE wiki_fts USING fts5(page_id UNINDEXED, slug UNINDEXED, title, body);",
+    "CREATE TRIGGER wiki_page_ai AFTER INSERT ON wiki_page BEGIN INSERT INTO wiki_fts(page_id, slug, title, body) VALUES (new.id, new.slug, new.title, new.content); END;",
+    "CREATE TRIGGER wiki_page_ad AFTER DELETE ON wiki_page BEGIN DELETE FROM wiki_fts WHERE page_id = old.id; END;",
+    "CREATE TRIGGER wiki_page_au AFTER UPDATE ON wiki_page BEGIN DELETE FROM wiki_fts WHERE page_id = old.id; INSERT INTO wiki_fts(page_id, slug, title, body) VALUES (new.id, new.slug, new.title, new.content); END;",
+];
+export const WIKI_MIGRATION_SQL = WIKI_DDL_STATEMENTS.join("\n");
+//# sourceMappingURL=wiki-schema.js.map

package/dist/wiki/infrastructure/wiki-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-schema.js","sourceRoot":"","sources":["../../../src/wiki/infrastructure/wiki-schema.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,qEAAqE;AACrE,iFAAiF;AACjF,kFAAkF;AAClF,oCAAoC;AAEpC,+EAA+E;AAC/E,mFAAmF;AACnF,MAAM,CAAC,MAAM,WAAW,GAAsB;IAC7C,UAAU;IACV,WAAW;IACX,eAAe;IACf,gBAAgB;IAChB,WAAW;IACX,YAAY;IACZ,aAAa;IACb,mBAAmB;IACnB,WAAW;IACX,kBAAkB;IAClB,mBAAmB;IACnB,MAAM;CACN,CAAC;AAEF,8EAA8E;AAC9E,+EAA+E;AAC/E,MAAM,mBAAmB,GAAsB;IAC9C,mGAAmG;IACnG,gNAAgN;IAChN,qDAAqD;IACrD,mJAAmJ;IACnJ,wIAAwI;IACxI,6HAA6H;IAC7H,+HAA+H;IAC/H,sUAAsU;IACtU,iTAAiT;IACjT,6IAA6I;IAC7I,wIAAwI;IACxI,wHAAwH;IACxH,2FAA2F;IAC3F,sKAAsK;IACtK,+GAA+G;IAC/G,mNAAmN;CACnN,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAW,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/dist/wiki/interface/cli.d.ts

@@ -0,0 +1,7 @@
+export interface WikiCliOptions {
+    subcommand?: string;
+    rest: string[];
+    flags: Record<string, unknown>;
+}
+export declare function wikiCommand(opts: WikiCliOptions): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/wiki/interface/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/wiki/interface/cli.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,cAAc;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAuCD,wBAAsB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA0GrE"}

package/dist/wiki/interface/cli.js

@@ -0,0 +1,160 @@
+import fs from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { MarkdownWikiRepository } from "../infrastructure/markdown-repository.js";
+import { ScannerAdapter } from "../infrastructure/scanner-adapter.js";
+import { SqliteWikiIndex } from "../infrastructure/sqlite-index.js";
+import { TraceAdapter } from "../infrastructure/trace-adapter.js";
+import { FetcherAdapter } from "../infrastructure/fetcher-adapter.js";
+import { WikiService } from "../application/service.js";
+import { listWikiPages, searchWiki } from "../application/queries.js";
+import { renderWiki } from "../render.js";
+import { dbPath } from "../../core/derived-index.js";
+import { makeWikiSlug } from "../domain/index.js";
+function findClaudeDir() {
+    let cur = process.cwd();
+    for (;;) {
+        const candidate = path.join(cur, ".claude");
+        if (fs.existsSync(candidate))
+            return candidate;
+        const parent = path.dirname(cur);
+        if (parent === cur)
+            return null;
+        cur = parent;
+    }
+}
+function buildService(claudeDir) {
+    return new WikiService({
+        repo: new MarkdownWikiRepository(path.dirname(claudeDir)),
+        scanner: new ScannerAdapter(),
+        index: new SqliteWikiIndex(dbPath(claudeDir)),
+        tracer: new TraceAdapter(claudeDir),
+        fetcher: new FetcherAdapter(),
+    });
+}
+const CLI_SALIENCE = {
+    explicit_user_intent: 3, // a human ran the command = explicit intent
+    verified_outcome: 0,
+    recurrence_or_friction: 0,
+    novelty_vs_existing_wiki: 2,
+    future_reuse_likelihood: 2,
+    source_quality: 2,
+    blast_radius: 1,
+    security_risk_penalty: 0,
+    staleness_penalty: 0,
+};
+function str(v) {
+    return typeof v === "string" ? v : undefined;
+}
+export async function wikiCommand(opts) {
+    const claudeDir = findClaudeDir();
+    if (!claudeDir) {
+        console.error("Could not find a .claude/ directory.");
+        process.exit(0);
+    }
+    const projectRoot = path.dirname(claudeDir);
+    const { subcommand, rest, flags } = opts;
+    const svc = buildService(claudeDir);
+    switch (subcommand) {
+        case "init": {
+            const slug = makeWikiSlug(rest[0] ?? "");
+            svc.createWiki(slug, str(flags["title"]) ?? rest[1] ?? rest[0] ?? slug);
+            console.log("created wiki: " + slug);
+            return;
+        }
+        case "search": {
+            const hits = searchWiki(new SqliteWikiIndex(dbPath(claudeDir)), rest.join(" "));
+            if (flags["json"])
+                return void console.log(JSON.stringify(hits, null, 2));
+            for (const h of hits)
+                console.log(`${h.title} [${h.slug}] ~${h.tokenEstimate}tok\n  ${h.snippet}`);
+            if (!hits.length)
+                console.log("(no results)");
+            return;
+        }
+        case "hint": {
+            // Context-discipline surface: title + score + path ONLY, never content.
+            const hits = searchWiki(new SqliteWikiIndex(dbPath(claudeDir)), rest.join(" "), 5);
+            const hints = hits.map((h) => ({ title: h.title, score: h.tokenEstimate, path: h.pageId }));
+            console.log(JSON.stringify(hints));
+            return;
+        }
+        case "list": {
+            for (const p of listWikiPages(new MarkdownWikiRepository(projectRoot), makeWikiSlug(rest[0] ?? "")))
+                console.log(p);
+            return;
+        }
+        case "render": {
+            const html = renderWiki(projectRoot, rest[0] ?? "");
+            const out = str(flags["out"]);
+            if (out) {
+                fs.writeFileSync(out, html, "utf-8");
+                console.log("wrote " + out);
+            }
+            else {
+                console.log(html);
+            }
+            return;
+        }
+        case "reindex": {
+            const r = svc.reindexWiki(claudeDir);
+            console.log(`reindexed: ${r.wiki.pages} page(s)`);
+            return;
+        }
+        case "enqueue": {
+            const seed = {
+                id: "seed-" + randomUUID().slice(0, 8),
+                query: rest.slice(1).join(" "),
+                kind: str(flags["kind"]) ?? "web",
+                status: "queued",
+                createdAt: new Date().toISOString(),
+            };
+            svc.enqueueSeed(makeWikiSlug(rest[0] ?? ""), seed);
+            console.log("enqueued seed: " + seed.id);
+            return;
+        }
+        case "research": {
+            const slug = makeWikiSlug(rest[0] ?? "");
+            const seed = {
+                id: "seed-" + randomUUID().slice(0, 8),
+                query: rest.slice(1).join(" "),
+                kind: str(flags["kind"]) ?? "web",
+                status: "queued",
+                createdAt: new Date().toISOString(),
+            };
+            const outcome = await svc.runResearchStep(slug, seed);
+            console.log(`research → ${outcome.decision}${outcome.candidateId ? " (" + outcome.candidateId + ")" : ""}`);
+            return;
+        }
+        case "propose": {
+            const file = str(flags["file"]);
+            const content = file ? fs.readFileSync(file, "utf-8") : (str(flags["content"]) ?? "");
+            const result = svc.proposeCandidate({
+                slug: makeWikiSlug(rest[0] ?? ""),
+                title: str(flags["title"]) ?? (rest.slice(1).join(" ") || "Untitled"),
+                content,
+                origin: "human",
+                whySave: str(flags["why"]) ?? "cli propose",
+                evidence: str(flags["evidence"]) ?? "",
+                sourceIds: [],
+                salience: CLI_SALIENCE,
+            });
+            console.log(`propose → ${result.decision.kind}${result.candidate ? " (" + result.candidate.id + ")" : ""}`);
+            return;
+        }
+        case "approve": {
+            const page = svc.approveCandidate(makeWikiSlug(rest[0] ?? ""), rest[1] ?? "", str(flags["by"]) ?? "cli-user");
+            console.log("approved → " + page.path);
+            return;
+        }
+        case "reject": {
+            svc.rejectCandidate(makeWikiSlug(rest[0] ?? ""), rest[1] ?? "", str(flags["reason"]) ?? "rejected via cli");
+            console.log("rejected: " + (rest[1] ?? ""));
+            return;
+        }
+        default:
+            console.log("usage: mewkit wiki <init|propose|approve|reject|search|hint|list|render|reindex|enqueue|research>");
+            return;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/wiki/interface/cli.js.map

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

package/dist/wiki/render.d.ts

@@ -0,0 +1,3 @@
+/** Render a wiki to a single self-contained HTML string. */
+export declare function renderWiki(projectRoot: string, slugStr: string): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/wiki/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/wiki/render.ts"],"names":[],"mappings":"AAyBA,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAuCvE"}

package/dist/wiki/render.js

@@ -0,0 +1,58 @@
+import fs from "node:fs";
+import path from "node:path";
+import { MarkdownWikiRepository } from "./infrastructure/markdown-repository.js";
+import { makeWikiSlug } from "./domain/index.js";
+// Self-contained HTML snapshot of a wiki (no CDN, no remote assets).
+// Page content is DATA → HTML-escaped before embedding (no script execution from wiki content).
+// Provenance (origin / approvedBy / source URL) renders as escaped TEXT, never as a live <a href>
+// or <img src>, so the artifact opens offline with zero network requests.
+function esc(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+const STYLE = "body{font:16px/1.6 system-ui,sans-serif;max-width:48rem;margin:2rem auto;padding:0 1rem;color:#1a1a1a}" +
+    "h1{border-bottom:2px solid #333;padding-bottom:.3rem}" +
+    "article{margin:2rem 0;padding:1rem;border:1px solid #ddd;border-radius:8px}" +
+    ".prov{font-size:.8rem;color:#666;margin-top:.5rem}" +
+    "pre{white-space:pre-wrap;word-wrap:break-word;background:#f6f6f6;padding:.75rem;border-radius:6px}";
+/** Render a wiki to a single self-contained HTML string. */
+export function renderWiki(projectRoot, slugStr) {
+    const slug = makeWikiSlug(slugStr);
+    const repo = new MarkdownWikiRepository(projectRoot);
+    const wikiJson = path.join(projectRoot, "tasks", "wikis", slug, "wiki.json");
+    let title = slug;
+    if (fs.existsSync(wikiJson)) {
+        try {
+            const meta = JSON.parse(fs.readFileSync(wikiJson, "utf-8"));
+            if (typeof meta.title === "string")
+                title = meta.title;
+        }
+        catch {
+            // fall back to slug
+        }
+    }
+    const articles = repo
+        .listPages(slug)
+        .map((file) => {
+        const page = repo.readPage(slug, file);
+        if (!page)
+            return "";
+        const prov = "origin: " + esc(page.provenance.origin) +
+            (page.provenance.approvedBy ? " · approved by " + esc(page.provenance.approvedBy) : "") +
+            (page.provenance.sourceIds.length ? " · sources: " + esc(page.provenance.sourceIds.join(", ")) : "");
+        return ("<article><h2>" + esc(page.title) + "</h2>" +
+            "<pre>" + esc(page.content) + "</pre>" +
+            '<div class="prov">' + prov + "</div></article>");
+    })
+        .join("\n");
+    return ("<!doctype html><html lang=\"en\"><head><meta charset=\"utf-8\">" +
+        '<meta name="viewport" content="width=device-width,initial-scale=1">' +
+        "<title>" + esc(title) + "</title><style>" + STYLE + "</style></head>" +
+        "<body><h1>" + esc(title) + "</h1>" +
+        (articles || "<p>No pages yet.</p>") +
+        "</body></html>\n");
+}
+//# sourceMappingURL=render.js.map

package/dist/wiki/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/wiki/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,qEAAqE;AACrE,gGAAgG;AAChG,kGAAkG;AAClG,0EAA0E;AAE1E,SAAS,GAAG,CAAC,CAAS;IACrB,OAAO,CAAC;SACN,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,KAAK,GACV,wGAAwG;IACxG,uDAAuD;IACvD,6EAA6E;IAC7E,oDAAoD;IACpD,oGAAoG,CAAC;AAEtG,4DAA4D;AAC5D,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,OAAe;IAC9D,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAC7E,IAAI,KAAK,GAAG,IAAc,CAAC;IAC3B,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAuB,CAAC;YAClF,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;gBAAE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACR,oBAAoB;QACrB,CAAC;IACF,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI;SACnB,SAAS,CAAC,IAAI,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,GACT,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YACxC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvF,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtG,OAAO,CACN,eAAe,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,OAAO;YAC3C,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,QAAQ;YACtC,oBAAoB,GAAG,IAAI,GAAG,kBAAkB,CAChD,CAAC;IACH,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO,CACN,iEAAiE;QACjE,qEAAqE;QACrE,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,iBAAiB,GAAG,KAAK,GAAG,iBAAiB;QACtE,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,OAAO;QACnC,CAAC,QAAQ,IAAI,sBAAsB,CAAC;QACpC,kBAAkB,CAClB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mewkit",
-  "version": "1.11.2",
+  "version": "1.12.0",
   "description": "MeowKit CLI — scaffold, upgrade, and manage your AI agent toolkit",
   "type": "module",
   "bin": {