mewkit 1.7.1 → 1.8.0

package/dist/core/validate-install.js

@@ -0,0 +1,97 @@
+import { existsSync, readdirSync, statSync, accessSync, constants } from "node:fs";
+import { join } from "node:path";
+import pc from "picocolors";
+function check(label, pass, issues) {
+    if (pass) {
+        console.log(`  ${pc.green("PASS")} ${label}`);
+    }
+    else {
+        console.log(`  ${pc.red("FAIL")} ${label}`);
+        issues.push(label);
+    }
+    return pass;
+}
+/** Counts .md files in a directory (non-recursive) */
+function countMdFiles(dir) {
+    if (!existsSync(dir))
+        return 0;
+    try {
+        return readdirSync(dir).filter((f) => f.endsWith(".md")).length;
+    }
+    catch {
+        return 0;
+    }
+}
+/** Counts subdirectories in a directory */
+function countSubdirs(dir) {
+    if (!existsSync(dir))
+        return 0;
+    try {
+        return readdirSync(dir).filter((f) => {
+            try {
+                return statSync(join(dir, f)).isDirectory();
+            }
+            catch {
+                return false;
+            }
+        }).length;
+    }
+    catch {
+        return 0;
+    }
+}
+export function validate(targetDir) {
+    const issues = [];
+    const claude = join(targetDir, ".claude");
+    console.log(pc.bold("\nValidation Results:"));
+    // Core structure
+    check(".claude/ directory exists", existsSync(claude), issues);
+    check("CLAUDE.md exists", existsSync(join(targetDir, "CLAUDE.md")), issues);
+    check("meowkit.config.json exists", existsSync(join(claude, "meowkit.config.json")), issues);
+    // Agents (expect 10+ from real system)
+    const agentCount = countMdFiles(join(claude, "agents"));
+    check(`Agents: ${agentCount} files (need 10+)`, agentCount >= 10, issues);
+    // Skills (expect 30+ directories)
+    const skillCount = countSubdirs(join(claude, "skills"));
+    check(`Skills: ${skillCount} directories (need 30+)`, skillCount >= 30, issues);
+    // Commands
+    const cmdDir = join(claude, "commands");
+    const cmdExists = existsSync(cmdDir);
+    check("Commands directory exists", cmdExists, issues);
+    // Modes
+    const modeCount = countMdFiles(join(claude, "modes"));
+    check(`Modes: ${modeCount} files (need 5+)`, modeCount >= 5, issues);
+    // Rules
+    const ruleCount = countMdFiles(join(claude, "rules"));
+    check(`Rules: ${ruleCount} files (need 10+)`, ruleCount >= 10, issues);
+    // Hooks — all must be executable
+    const hooksDir = join(claude, "hooks");
+    if (existsSync(hooksDir)) {
+        const hookFiles = readdirSync(hooksDir);
+        for (const hookFile of hookFiles) {
+            const hookPath = join(hooksDir, hookFile);
+            let isExecutable = false;
+            try {
+                accessSync(hookPath, constants.X_OK);
+                isExecutable = true;
+            }
+            catch {
+                // Not executable
+            }
+            check(`Hook ${hookFile} is executable`, isExecutable, issues);
+        }
+    }
+    else {
+        check("Hooks directory exists", false, issues);
+    }
+    // Scripts
+    check("Scripts directory exists", existsSync(join(claude, "scripts")), issues);
+    // Settings
+    check("settings.json exists", existsSync(join(claude, "settings.json")), issues);
+    const valid = issues.length === 0;
+    console.log(valid
+        ? `\n  ${pc.green(pc.bold("All checks passed"))}`
+        : `\n  ${pc.red(pc.bold(`${issues.length} issue(s) found`))}`);
+    return { valid, issues };
+}
+//# sourceMappingURL=validate-install.js.map

package/dist/core/validate-install.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import minimist from "minimist";
+import pc from "picocolors";
+import { init } from "./commands/init.js";
+import { upgrade } from "./commands/upgrade.js";
+import { validate } from "./commands/validate.js";
+import { budget } from "./commands/budget.js";
+import { memory } from "./commands/memory.js";
+import { doctor } from "./commands/doctor.js";
+import { migrate } from "./commands/migrate.js";
+import { setup } from "./commands/setup.js";
+import { task } from "./commands/task.js";
+import { orchviz } from "./commands/orchviz.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkgJson = JSON.parse(fs.readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+const VERSION = pkgJson.version;
+function printHelp() {
+    console.log(`
+${pc.bold(pc.cyan("meowkit"))} ${pc.dim(`v${VERSION}`)} — MeowKit runtime CLI
+
+${pc.bold("Usage:")}
+  meowkit <command> [options]
+
+${pc.bold("Commands:")}
+  ${pc.green("init")}       Scaffold or update MeowKit in the current project
+  ${pc.green("upgrade")}    Upgrade MeowKit to the latest version
+  ${pc.green("validate")}   Validate .claude/ project structure
+  ${pc.green("budget")}     View token usage and cost log
+  ${pc.green("memory")}     Manage agent memory (lessons & patterns)
+  ${pc.green("setup")}      Guided post-scaffold configuration
+  ${pc.green("doctor")}     Diagnose common environment issues
+  ${pc.green("status")}     Print version and config summary
+  ${pc.green("task")}       Create and list task files (new, list)
+  ${pc.green("migrate")}    Export MeowKit to external coding-agent tools (cursor, codex, ...)
+  ${pc.green("orchviz")}    Live web visualizer for the active Claude Code session
+
+${pc.bold("Options:")}
+  --help, -h       Show help
+  --version, -v    Show version
+
+${pc.bold("Init flags for post-init migration:")}
+  --migrate                  After unpack, prompt for providers to export to (interactive)
+  --migrate-to <csv|all>     After unpack, export to listed providers (e.g. cursor,codex)
+  --migrate-global           Use global install paths (~/.cursor/, etc.) instead of project-local
+
+${pc.bold("orchviz flags:")}
+  --port <number>            Bind to fixed port (default: random)
+  --open / --no-open         Auto-launch browser (default: --open)
+  --session <id>             Pin to a single Claude Code session id
+  --workspace <path>         Override watched workspace (default: cwd)
+  --verbose                  Print sanitized AgentEvents to stderr
+  --log [path]               Persist events to markdown (default: .claude/logs/orchviz-<sid>.md)
+`);
+}
+async function printStatus() {
+    const channel = VERSION.includes("-beta") || VERSION.includes("-rc") ? "beta" : "stable";
+    console.log(`${pc.bold(pc.cyan("meowkit"))} ${pc.dim(`v${VERSION}`)} ${pc.dim(`(${channel})`)}`);
+    console.log();
+    const configPath = ".claude/meowkit.config.json";
+    try {
+        const content = fs.readFileSync(configPath, "utf-8");
+        const config = JSON.parse(content);
+        console.log(`${pc.bold("Config:")} ${configPath}`);
+        for (const [key, value] of Object.entries(config)) {
+            console.log(`  ${pc.dim(key)}: ${String(value)}`);
+        }
+    }
+    catch {
+        console.log(`${pc.dim("No .claude/meowkit.config.json found.")}`);
+    }
+}
+async function main() {
+    const args = minimist(process.argv.slice(2), {
+        boolean: [
+            "help",
+            "version",
+            "check",
+            "beta",
+            "list",
+            "monthly",
+            "clear",
+            "show",
+            "stats",
+            "report",
+            "all",
+            "dry-run",
+            "force",
+            "system-deps",
+            "yes",
+            "global",
+            "skip-config",
+            "skip-rules",
+            "skip-hooks",
+            "install",
+            "reconcile",
+            "reinstall-empty-dirs",
+            "respect-deletions",
+            "prefer-agents-md",
+            "migrate",
+            "migrate-global",
+            "open",
+            "no-open",
+            "no-color",
+            "verbose",
+        ],
+        string: [
+            "only",
+            "type",
+            "priority",
+            "status",
+            "source",
+            "source-version",
+            "migrate-to",
+            "port",
+            "session",
+            "workspace",
+            "log",
+        ],
+        alias: { h: "help", v: "version", y: "yes" },
+    });
+    if (args.version) {
+        console.log(VERSION);
+        return;
+    }
+    const command = args._[0];
+    if (args.help && !command) {
+        printHelp();
+        return;
+    }
+    switch (command) {
+        case "init":
+            await init({
+                dryRun: args["dry-run"],
+                force: args.force,
+                beta: args.beta,
+                migrate: args.migrate,
+                migrateTo: args["migrate-to"],
+                migrateGlobal: args["migrate-global"],
+            });
+            break;
+        case "upgrade":
+            await upgrade({
+                check: args.check,
+                beta: args.beta,
+                list: args.list,
+            });
+            break;
+        case "validate":
+            await validate();
+            break;
+        case "budget":
+            await budget({ monthly: args.monthly });
+            break;
+        case "memory":
+            await memory({
+                clear: args.clear,
+                show: args.show,
+                stats: args.stats,
+            });
+            break;
+        case "setup":
+            await setup({ only: args.only, systemDeps: args["system-deps"] });
+            break;
+        case "doctor":
+            await doctor({ report: args.report });
+            break;
+        case "status":
+            await printStatus();
+            break;
+        case "task": {
+            const subcommand = args._[1];
+            // positional description: everything after the subcommand that isn't a flag
+            const description = args._.slice(2).join(" ");
+            task({
+                subcommand,
+                type: args.type,
+                priority: args.priority,
+                all: args.all,
+                status: args.status,
+                description: description || undefined,
+            });
+            break;
+        }
+        case "orchviz": {
+            const portRaw = args.port;
+            let port;
+            if (portRaw !== undefined) {
+                const parsed = typeof portRaw === "number" ? portRaw : parseInt(String(portRaw), 10);
+                if (!Number.isInteger(parsed) || parsed < 0 || parsed > 65535) {
+                    console.error(pc.red(`Invalid --port value: ${String(portRaw)} (must be 0-65535; 0 = random)`));
+                    process.exit(2);
+                }
+                port = parsed;
+            }
+            await orchviz({
+                port,
+                open: args.open,
+                noOpen: args["no-open"],
+                session: args.session,
+                workspace: args.workspace,
+                noColor: args["no-color"],
+                verbose: args.verbose,
+                log: args.log,
+            });
+            break;
+        }
+        case "migrate": {
+            const exitCode = await migrate({
+                _: args._.map(String),
+                all: args.all,
+                global: args.global,
+                yes: args.yes,
+                "dry-run": args["dry-run"],
+                force: args.force,
+                source: args.source,
+                only: args.only,
+                "skip-config": args["skip-config"],
+                "skip-rules": args["skip-rules"],
+                "skip-hooks": args["skip-hooks"],
+                install: args.install,
+                reconcile: args.reconcile,
+                "reinstall-empty-dirs": args["reinstall-empty-dirs"],
+                "respect-deletions": args["respect-deletions"],
+                "prefer-agents-md": args["prefer-agents-md"],
+                "source-version": args["source-version"],
+            });
+            if (exitCode !== 0)
+                process.exit(exitCode);
+            break;
+        }
+        default:
+            if (command) {
+                console.error(pc.red(`Unknown command: ${command}`));
+                console.log();
+            }
+            printHelp();
+            break;
+    }
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(pc.red(`Fatal: ${message}`));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/system-deps-registry.d.ts

@@ -0,0 +1,117 @@
+/**
+ * system-deps-registry.ts
+ *
+ * Single source of truth for installable system dependencies.
+ *
+ * WHY THIS FILE EXISTS (Q4 / locked decision #2):
+ * The mewkit CLI used to hardcode ffmpeg + imagemagick directly in setup.ts and
+ * doctor.ts. This refactor extracts them into a typed registry so:
+ *   1. Skills can declare opt-in system deps via SKILL.md metadata (schema-driven).
+ *   2. The CLI iterates the registry instead of hardcoded if/else branches.
+ *   3. New deps (e.g. playwright-chromium) are registered here — not scattered.
+ *
+ * PARSE CONTRACT (optional_system_deps HTML comment):
+ * Claude Code's native frontmatter schema does NOT support custom fields like
+ * optional_system_deps — they are silently dropped. Skills instead declare deps in
+ * a MEOWKIT METADATA HTML comment block inside SKILL.md:
+ *
+ *   <!--
+ *   MEOWKIT METADATA ...:
+ *     optional_system_deps: [playwright-chromium]
+ *   -->
+ *
+ * parseOptionalSystemDepsFromSkillMd() finds this comment and extracts the list.
+ * validateSkillDeclaredKeys() then checks each key against SYSTEM_DEPS — unknown
+ * keys are rejected so no skill can request arbitrary package installs.
+ *
+ * Playwright version: 1.58.0 (pinned from PyPI on 2026-04-09 via WebFetch).
+ */
+export interface DoctorContext {
+    /** Absolute path to the project root (contains .claude/) */
+    projectRoot: string;
+}
+export interface DoctorResult {
+    status: "OK" | "MISSING_PACKAGE" | "MISSING_BINARY" | "ERROR";
+    message?: string;
+}
+export interface SystemDepEntry {
+    /** Registry key — referenced in SKILL.md optional_system_deps */
+    key: string;
+    /** Human-readable name shown in prompts */
+    name: string;
+    /**
+     * Shell command whose exit code 0 means the dep is present.
+     * For PATH-based deps with a single binary (e.g. ffmpeg), this is the canonical probe.
+     * When the dep may ship under multiple binary names (e.g. ImageMagick 6 uses "convert",
+     * ImageMagick 7+ uses "magick"), use detectCommands instead.
+     */
+    detectCommand: string;
+    /**
+     * Optional fallback probes for deps that ship under multiple binary names.
+     * If ANY entry exits 0, the dep is considered present.
+     * When set, takes precedence over detectCommand for presence checks.
+     * Example: ImageMagick 6 ships "convert", IM 7+ ships "magick" (no "convert" shim).
+     */
+    detectCommands?: string[];
+    /** Per-OS ordered list of install commands */
+    installCommands: Partial<Record<NodeJS.Platform, string[]>>;
+    /** Link shown to users when auto-install is unavailable */
+    manualUrl: string;
+    /** Approximate download size in bytes — shown as ~NMB in prompts */
+    sizeBytes: number;
+    /** Optional dedicated doctor check (overrides generic detectCommand probe) */
+    doctorCheck?: (ctx: DoctorContext) => Promise<DoctorResult>;
+}
+/**
+ * All registered system dependencies.
+ * Insertion order = display order in prompts (ffmpeg, imagemagick, playwright-chromium).
+ */
+export declare const SYSTEM_DEPS: Record<string, SystemDepEntry>;
+/** Return all registered entries in insertion order */
+export declare function listDeps(): SystemDepEntry[];
+/**
+ * Check whether a PATH-based dep's binary (or any of its aliases) is present.
+ * Uses detectCommands when set (multi-probe); falls back to single detectCommand probe.
+ *
+ * NOT suitable for venv-based deps (playwright-chromium) — callers must handle
+ * those separately (detectCommand includes ".venv").
+ */
+export declare function isDepCommandPresent(dep: SystemDepEntry, commandAvailableFn: (cmd: string) => boolean): boolean;
+/** Look up a single entry by key */
+export declare function getDep(key: string): SystemDepEntry | undefined;
+/**
+ * Validate keys declared in a skill's optional_system_deps against the registry.
+ * Unknown keys are rejected to prevent skills from requesting arbitrary installs.
+ *
+ * @param declared  Keys parsed from SKILL.md optional_system_deps comment
+ * @param skillName Used in warning messages for traceability
+ */
+export declare function validateSkillDeclaredKeys(declared: string[], skillName: string): {
+    valid: string[];
+    invalid: string[];
+};
+/**
+ * Parse optional_system_deps from a SKILL.md HTML comment block.
+ *
+ * PARSE CONTRACT:
+ * The parser looks for a comment starting with "MEOWKIT METADATA" and extracts
+ * the "optional_system_deps:" line from it. Handles both single-line and
+ * multi-line YAML-ish list formats:
+ *
+ *   optional_system_deps: [playwright-chromium]
+ *   optional_system_deps: [playwright-chromium, ffmpeg]
+ *
+ * Multi-line YAML block format (not currently used but handled):
+ *   optional_system_deps:
+ *     - playwright-chromium
+ *
+ * Returns an empty array if the comment or field is absent.
+ *
+ * WHY NOT NATIVE FRONTMATTER (Q4 decision):
+ * Claude Code's frontmatter schema only supports a fixed set of native fields.
+ * Custom fields like optional_system_deps are silently dropped. The HTML comment
+ * approach is the agreed MeowKit convention for skill metadata that the CLI needs
+ * but Claude Code should ignore.
+ */
+export declare function parseOptionalSystemDepsFromSkillMd(skillMdContent: string): string[];
+//# sourceMappingURL=system-deps-registry.d.ts.map

package/dist/lib/system-deps-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-deps-registry.d.ts","sourceRoot":"","sources":["../../src/lib/system-deps-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AASH,MAAM,WAAW,aAAa;IAC7B,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,IAAI,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,OAAO,CAAC;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC9B,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,8CAA8C;IAC9C,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5D,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5D;AAuDD;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CA2DtD,CAAC;AAMF,uDAAuD;AACvD,wBAAgB,QAAQ,IAAI,cAAc,EAAE,CAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAG9G;AAED,oCAAoC;AACpC,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBxC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kCAAkC,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CA+BnF"}