mewkit 1.7.1 → 1.8.1

package/README.md

@@ -23,6 +23,7 @@ npx mewkit <command>      # Runtime commands
 | `meowkit status`    | Print version, channel, and config                                |
 | `meowkit task new`  | Create structured task file from template                         |
 | `meowkit task list` | List active tasks with status                                     |
+| `meowkit orchviz`   | Live web visualizer for the active Claude Code session            |
 
 ## Usage
 
@@ -53,6 +54,81 @@ npx mewkit memory --show        # Display lessons learned
 npx mewkit memory --clear       # Reset memory
 ```
 
+## Visualizer (`meowkit orchviz`)
+
+Live web visualizer for the active Claude Code session. Tails the JSONL
+transcript at `~/.claude/projects/<encoded-cwd>/<session>.jsonl`, parses it
+into structured `AgentEvent`s, and serves them at `http://127.0.0.1:<port>/`
+as a Canvas2D + d3-force interactive graph plus a live transcript panel and
+meowkit-specific overlays (Gate state, model tier, today's tokens, phase).
+
+```bash
+# Default: random port, auto-open browser
+npx mewkit orchviz
+
+# Custom flags
+npx mewkit orchviz --port 3001       # fixed port (0 = random)
+npx mewkit orchviz --no-open         # don't auto-launch browser
+npx mewkit orchviz --session <uuid>  # pin to a single session id
+npx mewkit orchviz --workspace .     # override watched workspace (default: cwd)
+npx mewkit orchviz --verbose         # print sanitized AgentEvents to stderr
+npx mewkit orchviz --log             # persist to .claude/logs/orchviz-<sid>.md
+npx mewkit orchviz --log /tmp/run.md # custom path (must end .md)
+```
+
+**Security:** server binds 127.0.0.1 only; Host-header guarded against DNS
+rebinding; SSE frames sanitized (ANSI strip + strict-prefix secret scrub on
+`sk-…`, `ghp_…`, `AKIA…`, PEM blocks); path traversal blocked.
+
+**Limitations (v1):** simplified canvas renderer (no bloom / detail panels /
+multi-session tabs); v1.1 ports the full agent-flow visualizer. Ported (in
+part) from [`patoles/agent-flow`](https://github.com/patoles/agent-flow)
+under the Apache-2.0 license — see `NOTICE`.
+
+### orchviz API Endpoints (v1.2)
+
+The orchviz server exposes these HTTP endpoints on `http://127.0.0.1:<port>`:
+
+**GET /api/plans** — list non-archived plans sorted by mtime (newest first):
+```bash
+curl http://127.0.0.1:3001/api/plans
+# { "plans": [{ "slug": "260501-my-plan", "title": "...", "status": "draft", ... }] }
+```
+
+**GET /api/plan?slug=\<slug\>** — full plan state with per-phase ETags:
+```bash
+curl "http://127.0.0.1:3001/api/plan?slug=260501-my-plan"
+# { "plan": { ... }, "phaseEtags": { "1": "<hex64>", "2": "<hex64>" }, "readonly": true }
+# Omit ?slug= to get the most-recently-modified plan.
+```
+
+**Read-only by default.** The visualizer is a viewer, not an editor — graph,
+plan tree, and todos all render read-only. The hamburger drawer browses the
+plan tree (plan → phase → todo) without exposing edit affordances. To opt
+into write mode (legacy todo-toggle endpoint), launch with
+`MEOWKIT_ORCHVIZ_WRITABLE=1`. The legacy `MEOWKIT_ORCHVIZ_READONLY=0` flag
+also opts in for backwards compatibility; `MEOWKIT_ORCHVIZ_READONLY=1`
+forces read-only as a defensive lock.
+
+**POST /api/plan/todo** — toggle a todo checkbox (write mode only):
+```bash
+# Default (no env): returns 405 { "error": "readonly" }
+MEOWKIT_ORCHVIZ_WRITABLE=1 npx mewkit orchviz   # opt in to write mode
+
+curl -X POST http://127.0.0.1:3001/api/plan/todo \
+  -H "Content-Type: application/json" \
+  -H "Origin: http://127.0.0.1:3001" \
+  -d '{"slug":"260501-my-plan","phase":1,"todoIdx":0,"checked":true,"etag":"<hex64>"}'
+# 200: { "ok": true, "changed": true, "etag": "<new-hex64>" }
+# 409: { "error": "stale", "currentEtag": "<latest-hex64>" }  → re-fetch and retry
+# 403: Origin header missing or not in allowlist
+# 405: server is in read-only mode (the default)
+```
+
+**Origin requirement:** POST requests must include `Origin: http://127.0.0.1:<port>`
+or `Origin: http://localhost:<port>`. This prevents cross-origin writes from
+browser tabs served by other origins.
+
 ## Related
 
 - [GitHub](https://github.com/ngocsangyem/MeowKit)

package/dist/commands/budget.d.ts

@@ -0,0 +1,6 @@
+interface BudgetArgs {
+    monthly?: boolean;
+}
+export declare function budget(args: BudgetArgs): Promise<void>;
+export {};
+//# sourceMappingURL=budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/commands/budget.ts"],"names":[],"mappings":"AAYA,UAAU,UAAU;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAgED,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C5D"}

package/dist/commands/budget.js

@@ -0,0 +1,95 @@
+import fs from "node:fs";
+import path from "node:path";
+import pc from "picocolors";
+function findCostLog() {
+    let current = process.cwd();
+    while (true) {
+        const candidate = path.join(current, ".claude", "memory", "cost-log.json");
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+function readCostLog(logPath) {
+    const content = fs.readFileSync(logPath, "utf-8");
+    const parsed = JSON.parse(content);
+    if (!Array.isArray(parsed)) {
+        throw new Error("cost-log.json must contain an array");
+    }
+    return parsed;
+}
+function padEnd(str, len) {
+    return str.length >= len ? str.slice(0, len) : str + " ".repeat(len - str.length);
+}
+function padStart(str, len) {
+    return str.length >= len ? str : " ".repeat(len - str.length) + str;
+}
+function printTable(entries) {
+    const header = `  ${padEnd("Date", 12)}${padEnd("Command", 16)}${padEnd("Tier", 10)}${padStart("Tokens", 12)}  ${padEnd("Task", 30)}`;
+    console.log(pc.bold(header));
+    console.log(pc.dim("  " + "-".repeat(80)));
+    for (const entry of entries) {
+        const line = `  ${padEnd(entry.date, 12)}${padEnd(entry.command, 16)}${padEnd(entry.tier, 10)}${padStart(String(entry.estimated_tokens), 12)}  ${padEnd(entry.task, 30)}`;
+        console.log(line);
+    }
+}
+function aggregateByMonth(entries) {
+    const monthly = new Map();
+    for (const entry of entries) {
+        const month = entry.date.slice(0, 7); // YYYY-MM
+        const existing = monthly.get(month) ?? { tokens: 0, count: 0 };
+        existing.tokens += entry.estimated_tokens;
+        existing.count += 1;
+        monthly.set(month, existing);
+    }
+    console.log(pc.bold(`  ${padEnd("Month", 12)}${padStart("Entries", 10)}${padStart("Tokens", 14)}`));
+    console.log(pc.dim("  " + "-".repeat(36)));
+    for (const [month, data] of monthly) {
+        console.log(`  ${padEnd(month, 12)}${padStart(String(data.count), 10)}${padStart(String(data.tokens), 14)}`);
+    }
+}
+export async function budget(args) {
+    console.log(pc.bold(pc.cyan("Token Budget & Cost Log")));
+    console.log();
+    const logPath = findCostLog();
+    if (!logPath) {
+        console.error(pc.red("Could not find .claude/memory/cost-log.json"));
+        console.log(pc.dim("Run a meowkit agent command first to generate cost data."));
+        process.exit(1);
+    }
+    console.log(`${pc.dim("Source:")} ${logPath}`);
+    console.log();
+    let entries;
+    try {
+        entries = readCostLog(logPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(pc.red(`Failed to read cost log: ${message}`));
+        process.exit(1);
+    }
+    if (entries.length === 0) {
+        console.log(pc.dim("No cost entries recorded yet."));
+        return;
+    }
+    if (args.monthly) {
+        aggregateByMonth(entries);
+    }
+    else {
+        const recent = entries.slice(-10);
+        if (entries.length > 10) {
+            console.log(pc.dim(`Showing last 10 of ${entries.length} entries`));
+            console.log();
+        }
+        printTable(recent);
+    }
+    console.log();
+    const totalTokens = entries.reduce((sum, e) => sum + e.estimated_tokens, 0);
+    console.log(`${pc.bold("Total estimated tokens:")} ${pc.cyan(totalTokens.toLocaleString())}`);
+}
+//# sourceMappingURL=budget.js.map

package/dist/commands/budget.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,4 @@
+export declare function doctor(args?: {
+    report?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AA8UA,wBAAsB,MAAM,CAAC,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+DvE"}

package/dist/commands/doctor.js

@@ -0,0 +1,365 @@
+import { execSync } from "node:child_process";
+import fs, { chmodSync } from "node:fs";
+import path from "node:path";
+import pc from "picocolors";
+import { commandExists } from "./setup.js";
+import { getRequirementsSource } from "../core/skills-dependencies.js";
+import { verifyPackages } from "../core/dependency-installer.js";
+import { listDeps, isDepCommandPresent } from "../lib/system-deps-registry.js";
+function statusIcon(status) {
+    switch (status) {
+        case "pass":
+            return pc.green("PASS");
+        case "fail":
+            return pc.red("FAIL");
+        case "warn":
+            return pc.yellow("WARN");
+    }
+}
+/** Find MeowKit project root — checks cwd only (no walk-up to avoid matching parent projects). */
+function findProjectRoot() {
+    const cwd = process.cwd();
+    const hasDotClaude = fs.existsSync(path.join(cwd, ".claude"));
+    const hasConfig = fs.existsSync(path.join(cwd, ".claude", "meowkit.config.json"));
+    const hasManifest = fs.existsSync(path.join(cwd, ".claude", "meowkit.manifest.json"));
+    const hasClaude = fs.existsSync(path.join(cwd, "CLAUDE.md"));
+    if (hasDotClaude || hasConfig || hasManifest || hasClaude) {
+        return cwd;
+    }
+    return null;
+}
+// --- Check functions: each takes projectRoot (may be null) ---
+function checkNodeVersion() {
+    const major = parseInt(process.versions.node.split(".")[0] ?? "0", 10);
+    if (major >= 20) {
+        return { name: "Node.js >= 20", status: "pass", detail: `v${process.versions.node}` };
+    }
+    return { name: "Node.js >= 20", status: "fail", detail: `v${process.versions.node} — need 20+` };
+}
+function checkPython() {
+    for (const cmd of ["python3 --version", "python --version"]) {
+        try {
+            const output = execSync(cmd, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+            const match = output.match(/Python (\d+)\.(\d+)/);
+            if (match) {
+                const major = parseInt(match[1] ?? "0", 10);
+                const minor = parseInt(match[2] ?? "0", 10);
+                if (major >= 3 && minor >= 9) {
+                    return { name: "Python 3.9+", status: "pass", detail: output };
+                }
+                return { name: "Python 3.9+", status: "fail", detail: `${output} — need 3.9+` };
+            }
+        }
+        catch {
+            /* try next */
+        }
+    }
+    return { name: "Python 3.9+", status: "warn", detail: "Not found in PATH" };
+}
+function checkGit() {
+    try {
+        const output = execSync("git --version", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+        return { name: "Git", status: "pass", detail: output };
+    }
+    catch {
+        return { name: "Git", status: "fail", detail: "Not found in PATH" };
+    }
+}
+function checkClaudeDir(root) {
+    if (!root) {
+        return {
+            name: ".claude/ directory",
+            status: "warn",
+            detail: "No MeowKit project found — run 'npm create meowkit' to scaffold",
+        };
+    }
+    const claudeDir = path.join(root, ".claude");
+    if (fs.existsSync(claudeDir)) {
+        return { name: ".claude/ directory", status: "pass", detail: claudeDir };
+    }
+    return {
+        name: ".claude/ directory",
+        status: "warn",
+        detail: "Project found but .claude/ missing — run 'npm create meowkit' to scaffold",
+        fix: "npm create meowkit",
+    };
+}
+function checkHooks(root) {
+    if (!root)
+        return { name: "Hooks", status: "warn", detail: "Skipped — no project" };
+    const hooksDir = path.join(root, ".claude", "hooks");
+    if (!fs.existsSync(hooksDir)) {
+        return { name: "Hooks", status: "warn", detail: "No hooks/ directory" };
+    }
+    const hooks = fs.readdirSync(hooksDir).filter((f) => !f.startsWith("."));
+    if (hooks.length === 0) {
+        return { name: "Hooks", status: "warn", detail: "No hook files" };
+    }
+    const nonExec = [];
+    for (const h of hooks) {
+        try {
+            fs.accessSync(path.join(hooksDir, h), fs.constants.X_OK);
+        }
+        catch {
+            nonExec.push(h);
+        }
+    }
+    if (nonExec.length === 0) {
+        return { name: "Hooks", status: "pass", detail: `${hooks.length} hook(s), all executable` };
+    }
+    // Auto-fix permissions
+    let fixed = 0;
+    for (const h of nonExec) {
+        try {
+            chmodSync(path.join(hooksDir, h), 0o755);
+            fixed++;
+        }
+        catch {
+            /* can't fix */
+        }
+    }
+    if (fixed === nonExec.length) {
+        return { name: "Hooks", status: "pass", detail: `${hooks.length} hook(s) — auto-fixed ${fixed} permission(s)` };
+    }
+    return {
+        name: "Hooks",
+        status: "fail",
+        detail: `${nonExec.length - fixed} not executable: ${nonExec.join(", ")}`,
+        fix: "chmod +x .claude/hooks/*",
+    };
+}
+function checkScripts(root) {
+    if (!root)
+        return { name: "Scripts", status: "warn", detail: "Skipped — no project" };
+    const scriptsDir = path.join(root, ".claude", "scripts");
+    if (!fs.existsSync(scriptsDir)) {
+        return { name: "Scripts", status: "warn", detail: "No scripts/ directory" };
+    }
+    const expected = ["validate.py", "security-scan.py", "checklist.py", "injection-audit.py"];
+    const missing = expected.filter((s) => !fs.existsSync(path.join(scriptsDir, s)));
+    if (missing.length === 0) {
+        return { name: "Scripts", status: "pass", detail: `${expected.length} validation scripts found` };
+    }
+    return { name: "Scripts", status: "warn", detail: `Missing: ${missing.join(", ")}` };
+}
+function checkMemory(root) {
+    if (!root)
+        return { name: "Memory", status: "warn", detail: "Skipped — no project" };
+    const memDir = path.join(root, ".claude", "memory");
+    if (!fs.existsSync(memDir)) {
+        return { name: "Memory", status: "warn", detail: "memory/ not found — will be created on first session" };
+    }
+    try {
+        const test = path.join(memDir, ".doctor-test");
+        fs.writeFileSync(test, "test", "utf-8");
+        fs.unlinkSync(test);
+        return { name: "Memory", status: "pass", detail: "Writable" };
+    }
+    catch {
+        return { name: "Memory", status: "fail", detail: `${memDir} is not writable` };
+    }
+}
+function checkMcp(root) {
+    if (!root)
+        return { name: "MCP config", status: "warn", detail: "Skipped — no project" };
+    if (fs.existsSync(path.join(root, ".mcp.json"))) {
+        return { name: "MCP config", status: "pass", detail: ".mcp.json found" };
+    }
+    return {
+        name: "MCP config",
+        status: "warn",
+        detail: "No .mcp.json",
+        fix: "meowkit setup --only=mcp",
+    };
+}
+function checkVenv(root) {
+    if (!root)
+        return { name: "Skills venv", status: "warn", detail: "Skipped — no project" };
+    const venvDir = path.join(root, ".claude", "skills", ".venv");
+    if (fs.existsSync(venvDir)) {
+        return { name: "Skills venv", status: "pass", detail: venvDir };
+    }
+    return {
+        name: "Skills venv",
+        status: "warn",
+        detail: "No Python venv for skills",
+        fix: "meowkit setup --only=venv",
+    };
+}
+function checkPipPackages(root) {
+    if (!root)
+        return { name: "Pip packages", status: "warn", detail: "Skipped — no project" };
+    const venvDir = path.join(root, ".claude", "skills", ".venv");
+    if (!fs.existsSync(venvDir)) {
+        return { name: "Pip packages", status: "warn", detail: "Skipped — no venv (run mewkit setup --only=venv)" };
+    }
+    const { packages } = getRequirementsSource(root);
+    const results = verifyPackages(root, packages);
+    const missing = results.filter((r) => !r.installed);
+    if (missing.length === 0) {
+        return { name: "Pip packages", status: "pass", detail: `${results.length} skill packages verified` };
+    }
+    return {
+        name: "Pip packages",
+        status: "warn",
+        detail: `Missing: ${missing.map((r) => r.name).join(", ")}`,
+        fix: "meowkit setup --only=deps",
+    };
+}
+function checkConfig(root) {
+    if (!root)
+        return { name: "Config", status: "warn", detail: "Skipped — no project" };
+    const configPath = path.join(root, ".claude", "meowkit.config.json");
+    if (!fs.existsSync(configPath)) {
+        return { name: "Config", status: "warn", detail: ".claude/meowkit.config.json not found" };
+    }
+    try {
+        JSON.parse(fs.readFileSync(configPath, "utf-8"));
+        return { name: "Config", status: "pass", detail: ".claude/meowkit.config.json valid" };
+    }
+    catch {
+        return { name: "Config", status: "fail", detail: ".claude/meowkit.config.json is invalid JSON" };
+    }
+}
+/**
+ * Run system dep checks from the registry.
+ * For each entry: if it has a dedicated doctorCheck, call that.
+ * Otherwise, run detectCommand and check exit code.
+ * Zero behavior change for ffmpeg/imagemagick — same pass/warn/fail semantics.
+ * Playwright gets its dedicated two-probe check (locked decision #3).
+ */
+async function checkSystemDeps(root) {
+    const ctx = { projectRoot: root ?? process.cwd() };
+    const results = [];
+    for (const dep of listDeps()) {
+        if (dep.doctorCheck) {
+            // Dedicated check (e.g. Playwright: verifies pip package + chromium binary)
+            try {
+                const result = await dep.doctorCheck(ctx);
+                if (result.status === "OK") {
+                    results.push({
+                        name: `${dep.name} (optional)`,
+                        status: "pass",
+                        detail: `${dep.name} installed and ready`,
+                    });
+                }
+                else {
+                    results.push({
+                        name: `${dep.name} (optional)`,
+                        status: "warn",
+                        detail: result.message ?? `${dep.name} not ready — ${result.status}`,
+                        fix: `npx mewkit setup --system-deps`,
+                    });
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                results.push({
+                    name: `${dep.name} (optional)`,
+                    status: "warn",
+                    detail: `Check failed: ${msg}`,
+                    fix: `npx mewkit setup --system-deps`,
+                });
+            }
+        }
+        else {
+            // Generic PATH-based check — uses detectCommands (multi-probe) when set,
+            // falling back to single detectCommand. No per-dep special-cases needed.
+            const present = isDepCommandPresent(dep, commandExists);
+            if (!present) {
+                results.push({
+                    name: `${dep.name} (optional)`,
+                    status: "warn",
+                    detail: `Not installed — ${dep.name.toLowerCase()} processing unavailable`,
+                    fix: `npx mewkit setup --system-deps`,
+                });
+                continue;
+            }
+            // Attempt to get version string for a nicer pass message.
+            // For multi-binary deps (detectCommands), use the first probe that succeeds.
+            try {
+                const probes = dep.detectCommands ?? [dep.detectCommand];
+                const availableCmd = probes.find((cmd) => commandExists(cmd)) ?? dep.detectCommand;
+                const versionFlag = dep.key === "imagemagick" ? "--version" : "-version";
+                const output = execSync(`${availableCmd} ${versionFlag}`, {
+                    encoding: "utf-8",
+                    stdio: ["pipe", "pipe", "pipe"],
+                });
+                const match = dep.key === "imagemagick" ? output.match(/ImageMagick (\S+)/) : output.match(/version (\S+)/);
+                const version = match ? match[1] : "unknown";
+                results.push({
+                    name: `${dep.name} (optional)`,
+                    status: "pass",
+                    detail: `v${version} — available`,
+                });
+            }
+            catch {
+                results.push({
+                    name: `${dep.name} (optional)`,
+                    status: "pass",
+                    detail: `Installed — available`,
+                });
+            }
+        }
+    }
+    return results;
+}
+export async function doctor(args) {
+    console.log(pc.bold(pc.cyan("MeowKit Doctor")));
+    console.log(pc.dim("Diagnosing common issues...\n"));
+    const root = findProjectRoot();
+    if (root) {
+        console.log(`  ${pc.dim("Project:")} ${root}\n`);
+    }
+    const systemDepResults = await checkSystemDeps(root);
+    const results = [
+        checkNodeVersion(),
+        checkPython(),
+        checkGit(),
+        checkClaudeDir(root),
+        checkConfig(root),
+        checkHooks(root),
+        checkScripts(root),
+        checkMemory(root),
+        checkMcp(root),
+        checkVenv(root),
+        checkPipPackages(root),
+        ...systemDepResults,
+    ];
+    for (const r of results) {
+        console.log(`  [${statusIcon(r.status)}] ${r.name}`);
+        console.log(`         ${pc.dim(r.detail)}`);
+        if (r.fix) {
+            console.log(`         ${pc.cyan(`Fix: ${r.fix}`)}`);
+        }
+    }
+    console.log();
+    const pass = results.filter((r) => r.status === "pass").length;
+    const fail = results.filter((r) => r.status === "fail").length;
+    const warn = results.filter((r) => r.status === "warn").length;
+    const parts = [pc.green(`${pass} passed`)];
+    if (warn > 0)
+        parts.push(pc.yellow(`${warn} warnings`));
+    if (fail > 0)
+        parts.push(pc.red(`${fail} failed`));
+    console.log(parts.join(", "));
+    if (args?.report) {
+        const lines = [
+            "# MeowKit Doctor Report",
+            `Date: ${new Date().toISOString()}`,
+            `Node: ${process.versions.node}`,
+            `Platform: ${process.platform} ${process.arch}`,
+            `Project: ${root ?? "not found"}`,
+            "",
+            "## Results",
+            ...results.map((r) => `- [${r.status.toUpperCase()}] ${r.name}: ${r.detail}${r.fix ? ` (fix: ${r.fix})` : ""}`),
+            "",
+            `## Summary: ${pass} passed, ${warn} warnings, ${fail} failed`,
+        ];
+        console.log(pc.dim("\n--- Report ---"));
+        console.log(lines.join("\n"));
+    }
+    if (fail > 0)
+        process.exit(1);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,13 @@
+export interface InitArgs {
+    dryRun?: boolean;
+    force?: boolean;
+    beta?: boolean;
+    /** When true, run interactive provider multiselect after init unpacks. */
+    migrate?: boolean;
+    /** CSV of provider names (e.g., "cursor,codex") or "all". When set, migration runs after init. */
+    migrateTo?: string;
+    /** When true, scope the post-init migration globally (~/.cursor/, etc.) instead of per-project. */
+    migrateGlobal?: boolean;
+}
+export declare function init(args: InitArgs): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,QAAQ;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mGAAmG;IACnG,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AA4JD,wBAAsB,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA6KxD"}