@geminixiang/mikan 1.0.0-beta.2 → 1.0.0-beta.21

package/dist/cli/arg-grammar.js

@@ -0,0 +1,59 @@
+/**
+ * Shared pieces of the CLI flag grammar.
+ *
+ * `resolveBoot` (cli/boot.ts) is the daemon's only full argv parser. This
+ * module holds what other scanners must agree with it on: the value-flag
+ * spelling (`--flag value` / `--flag=value`) via `takeValueFlag`, the default
+ * state dir, and an early `--state-dir` probe for import-time consumers
+ * (Sentry instrumentation) that must not load the boot path.
+ */
+import { homedir } from "os";
+import { join, resolve } from "path";
+import { readEnv } from "../utils/env.js";
+export function defaultStateDir() {
+    return join(homedir(), ".mikan");
+}
+/**
+ * Match `args[i]` against a value flag, accepting both `--name value` and
+ * `--name=value`. Returns the raw value and the index of the last argv slot
+ * consumed, or undefined when `args[i]` is not this flag.
+ */
+export function takeValueFlag(args, i, name) {
+    const arg = args[i];
+    if (arg === name)
+        return { value: args[i + 1] ?? "", lastIndex: i + 1 };
+    if (arg.startsWith(name + "="))
+        return { value: arg.slice(name.length + 1), lastIndex: i };
+    return undefined;
+}
+/**
+ * Effective state dir — the ONE place its precedence is decided:
+ * `--state-dir` flag (last occurrence wins) > STATE_DIR / MIKAN_STATE_DIR
+ * env > `~/.mikan`. Boot writes the resolved value back into the env
+ * (setEnvAliases) purely as a compatibility channel for code that runs
+ * without access to the boot plan — see `effectiveStateDir`.
+ */
+export function resolveStateDir(args = process.argv.slice(2), envValue = readEnv("STATE_DIR")) {
+    let flagValue;
+    for (let i = 0; i < args.length; i++) {
+        const taken = takeValueFlag(args, i, "--state-dir");
+        if (taken) {
+            flagValue = taken.value;
+            i = taken.lastIndex;
+        }
+    }
+    if (flagValue !== undefined)
+        return resolve(flagValue);
+    if (envValue)
+        return resolve(envValue);
+    return defaultStateDir();
+}
+/**
+ * State dir for post-boot readers: the env channel (which boot populated
+ * from the resolved plan) with the shared default. Never re-reads argv —
+ * by the time this runs, any `--state-dir` flag is already folded in.
+ */
+export function effectiveStateDir() {
+    return resolveStateDir([]);
+}
+//# sourceMappingURL=arg-grammar.js.map

package/dist/cli/arg-grammar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-grammar.js","sourceRoot":"","sources":["../../src/cli/arg-grammar.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAc,EACd,CAAS,EACT,IAAY;IAEZ,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IACxE,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAC3F,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAI,GAAa,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EACtC,QAAQ,GAAuB,OAAO,CAAC,WAAW,CAAC;IAEnD,IAAI,SAA6B,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC;QACpD,IAAI,KAAK,EAAE,CAAC;YACV,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC;YACxB,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;QACtB,CAAC;IACH,CAAC;IACD,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC","sourcesContent":["/**\n * Shared pieces of the CLI flag grammar.\n *\n * `resolveBoot` (cli/boot.ts) is the daemon's only full argv parser. This\n * module holds what other scanners must agree with it on: the value-flag\n * spelling (`--flag value` / `--flag=value`) via `takeValueFlag`, the default\n * state dir, and an early `--state-dir` probe for import-time consumers\n * (Sentry instrumentation) that must not load the boot path.\n */\nimport { homedir } from \"os\";\nimport { join, resolve } from \"path\";\nimport { readEnv } from \"../utils/env.js\";\n\nexport function defaultStateDir(): string {\n  return join(homedir(), \".mikan\");\n}\n\n/**\n * Match `args[i]` against a value flag, accepting both `--name value` and\n * `--name=value`. Returns the raw value and the index of the last argv slot\n * consumed, or undefined when `args[i]` is not this flag.\n */\nexport function takeValueFlag(\n  args: string[],\n  i: number,\n  name: string,\n): { value: string; lastIndex: number } | undefined {\n  const arg = args[i];\n  if (arg === name) return { value: args[i + 1] ?? \"\", lastIndex: i + 1 };\n  if (arg.startsWith(name + \"=\")) return { value: arg.slice(name.length + 1), lastIndex: i };\n  return undefined;\n}\n\n/**\n * Effective state dir — the ONE place its precedence is decided:\n * `--state-dir` flag (last occurrence wins) > STATE_DIR / MIKAN_STATE_DIR\n * env > `~/.mikan`. Boot writes the resolved value back into the env\n * (setEnvAliases) purely as a compatibility channel for code that runs\n * without access to the boot plan — see `effectiveStateDir`.\n */\nexport function resolveStateDir(\n  args: string[] = process.argv.slice(2),\n  envValue: string | undefined = readEnv(\"STATE_DIR\"),\n): string {\n  let flagValue: string | undefined;\n  for (let i = 0; i < args.length; i++) {\n    const taken = takeValueFlag(args, i, \"--state-dir\");\n    if (taken) {\n      flagValue = taken.value;\n      i = taken.lastIndex;\n    }\n  }\n  if (flagValue !== undefined) return resolve(flagValue);\n  if (envValue) return resolve(envValue);\n  return defaultStateDir();\n}\n\n/**\n * State dir for post-boot readers: the env channel (which boot populated\n * from the resolved plan) with the shared default. Never re-reads argv —\n * by the time this runs, any `--state-dir` flag is already folded in.\n */\nexport function effectiveStateDir(): string {\n  return resolveStateDir([]);\n}\n"]}

package/dist/cli/boot.d.ts

@@ -0,0 +1,16 @@
+import { type SandboxConfig } from "../sandbox/index.js";
+export interface BootPlan {
+    mode: "ext" | "env" | "help" | "version" | "worker-token" | "onboard" | "download" | "run";
+    /** argv after `ext`, handed to runExtCommand. Only set for mode "ext". */
+    extArgs?: string[];
+    stateDir: string;
+    /** Resolved working directory; defaults to `<stateDir>/workspace`. */
+    workingDir: string;
+    /** True when the working directory came from argv (then it is not auto-created). */
+    workingDirExplicit: boolean;
+    sandbox: SandboxConfig;
+    downloadChannel?: string;
+}
+export declare function resolveBoot(args?: string[]): BootPlan;
+export declare function helpText(): string;
+//# sourceMappingURL=boot.d.ts.map

package/dist/cli/boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../src/cli/boot.ts"],"names":[],"mappings":"AAWA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG1E,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IAC3F,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,kBAAkB,EAAE,OAAO,CAAC;IAC5B,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,WAAW,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,QAAQ,CAmE5E;AAED,wBAAgB,QAAQ,IAAI,MAAM,CA+BjC"}

package/dist/cli/boot.js

@@ -0,0 +1,119 @@
+/**
+ * Boot resolution for the `mikan` binary: argv → a BootPlan saying which mode
+ * to run and with what configuration. Pure — no side effects, no exits — so
+ * the grammar that actually drives the daemon is testable without spawning a
+ * process; main.ts just executes the plan.
+ *
+ * Modes, highest priority first: `ext` (own grammar, never flag-parsed here),
+ * `help`, `version`, `worker-token`, `onboard`, `download`, `run`.
+ */
+import { join, resolve } from "path";
+import { envSummaryLines } from "../env-manifest.js";
+import { parseSandboxArg } from "../sandbox/index.js";
+import { defaultStateDir, resolveStateDir, takeValueFlag } from "./arg-grammar.js";
+export function resolveBoot(args = process.argv.slice(2)) {
+    if (args[0] === "ext" || args[0] === "env") {
+        return {
+            mode: args[0],
+            ...(args[0] === "ext" ? { extArgs: args.slice(1) } : {}),
+            stateDir: defaultStateDir(),
+            workingDir: join(defaultStateDir(), "workspace"),
+            workingDirExplicit: false,
+            sandbox: { type: "host" },
+        };
+    }
+    let sandbox = { type: "host" };
+    let workingDirArg;
+    let downloadChannel;
+    let help = false;
+    let version = false;
+    let onboard = false;
+    let workerToken = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        let taken;
+        if (arg === "--help" || arg === "-h") {
+            help = true;
+        }
+        else if (arg === "--version" || arg === "-v" || arg === "-V") {
+            version = true;
+        }
+        else if (arg === "--onboard") {
+            onboard = true;
+        }
+        else if (arg === "--worker-token") {
+            workerToken = true;
+        }
+        else if ((taken = takeValueFlag(args, i, "--sandbox"))) {
+            sandbox = parseSandboxArg(taken.value);
+            i = taken.lastIndex;
+        }
+        else if ((taken = takeValueFlag(args, i, "--state-dir"))) {
+            // Consumed here so its value never reads as the positional working
+            // dir; the value itself is resolved by resolveStateDir below.
+            i = taken.lastIndex;
+        }
+        else if ((taken = takeValueFlag(args, i, "--download"))) {
+            downloadChannel = taken.value;
+            i = taken.lastIndex;
+        }
+        else if (!arg.startsWith("-")) {
+            workingDirArg = arg;
+        }
+        else {
+            throw new Error(`Unknown flag: ${arg}. Run \`mikan --help\` for usage.`);
+        }
+    }
+    const stateDir = resolveStateDir(args);
+    return {
+        mode: help
+            ? "help"
+            : version
+                ? "version"
+                : workerToken
+                    ? "worker-token"
+                    : onboard
+                        ? "onboard"
+                        : downloadChannel
+                            ? "download"
+                            : "run",
+        stateDir,
+        workingDir: workingDirArg ? resolve(workingDirArg) : join(stateDir, "workspace"),
+        workingDirExplicit: workingDirArg !== undefined,
+        sandbox,
+        downloadChannel,
+    };
+}
+export function helpText() {
+    return `mikan — multi-platform chat agent daemon
+
+Usage:
+  mikan [options] [working-directory]
+      Start the daemon. The working directory defaults to <state-dir>/workspace.
+  mikan ext <install|validate|list|remove> …
+      Manage extensions (run \`mikan ext\` for details).
+  mikan env
+      Show the full environment-variable inventory and what is currently set.
+
+Options:
+  --state-dir <dir>      State directory (settings.json, vaults, extensions).
+                         Default: ~/.mikan
+  --sandbox <spec>       Execution sandbox. One of:
+                           host
+                           container:<existing-container-name>
+                           image:<image[:tag]>
+                           gondolin:default | gondolin:remote
+                           firecracker:<vm-id>:<host-path>[:<ssh-user>[:<ssh-port>]]
+                           cloudflare:<sandbox-id>
+                         Default: host
+  --onboard              Create <state-dir>/settings.json from a template, then exit.
+  --worker-token         Mint a one-time gondolin worker join token, then exit.
+  --download <channel>   Dump a Slack channel's history (Slack only), then exit.
+  --version, -v          Print the version.
+  --help, -h             Show this help.
+
+Environment (platform tokens select which chat adapters start):
+${envSummaryLines().join("\n")}
+Run \`mikan env\` for the full inventory.`;
+}
+//# sourceMappingURL=boot.js.map

package/dist/cli/boot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.js","sourceRoot":"","sources":["../../src/cli/boot.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAsB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAenF,MAAM,UAAU,WAAW,CAAC,IAAI,GAAa,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;QAC3C,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,QAAQ,EAAE,eAAe,EAAE;YAC3B,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,WAAW,CAAC;YAChD,kBAAkB,EAAE,KAAK;YACzB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SAC1B,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,GAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC9C,IAAI,aAAiC,CAAC;IACtC,IAAI,eAAmC,CAAC;IACxC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,KAAK,CAAC;QACV,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC/D,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YAC/B,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;YACpC,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;aAAM,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;YACzD,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACvC,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;QACtB,CAAC;aAAM,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC;YAC3D,mEAAmE;YACnE,8DAA8D;YAC9D,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;QACtB,CAAC;aAAM,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC;YAC1D,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC;YAC9B,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;QACtB,CAAC;aAAM,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,aAAa,GAAG,GAAG,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,mCAAmC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO;QACL,IAAI,EAAE,IAAI;YACR,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,OAAO;gBACP,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,WAAW;oBACX,CAAC,CAAC,cAAc;oBAChB,CAAC,CAAC,OAAO;wBACP,CAAC,CAAC,SAAS;wBACX,CAAC,CAAC,eAAe;4BACf,CAAC,CAAC,UAAU;4BACZ,CAAC,CAAC,KAAK;QACjB,QAAQ;QACR,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;QAChF,kBAAkB,EAAE,aAAa,KAAK,SAAS;QAC/C,OAAO;QACP,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BP,eAAe,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;0CACY,CAAC;AAC3C,CAAC","sourcesContent":["/**\n * Boot resolution for the `mikan` binary: argv → a BootPlan saying which mode\n * to run and with what configuration. Pure — no side effects, no exits — so\n * the grammar that actually drives the daemon is testable without spawning a\n * process; main.ts just executes the plan.\n *\n * Modes, highest priority first: `ext` (own grammar, never flag-parsed here),\n * `help`, `version`, `worker-token`, `onboard`, `download`, `run`.\n */\nimport { join, resolve } from \"path\";\nimport { envSummaryLines } from \"../env-manifest.js\";\nimport { parseSandboxArg, type SandboxConfig } from \"../sandbox/index.js\";\nimport { defaultStateDir, resolveStateDir, takeValueFlag } from \"./arg-grammar.js\";\n\nexport interface BootPlan {\n  mode: \"ext\" | \"env\" | \"help\" | \"version\" | \"worker-token\" | \"onboard\" | \"download\" | \"run\";\n  /** argv after `ext`, handed to runExtCommand. Only set for mode \"ext\". */\n  extArgs?: string[];\n  stateDir: string;\n  /** Resolved working directory; defaults to `<stateDir>/workspace`. */\n  workingDir: string;\n  /** True when the working directory came from argv (then it is not auto-created). */\n  workingDirExplicit: boolean;\n  sandbox: SandboxConfig;\n  downloadChannel?: string;\n}\n\nexport function resolveBoot(args: string[] = process.argv.slice(2)): BootPlan {\n  if (args[0] === \"ext\" || args[0] === \"env\") {\n    return {\n      mode: args[0],\n      ...(args[0] === \"ext\" ? { extArgs: args.slice(1) } : {}),\n      stateDir: defaultStateDir(),\n      workingDir: join(defaultStateDir(), \"workspace\"),\n      workingDirExplicit: false,\n      sandbox: { type: \"host\" },\n    };\n  }\n\n  let sandbox: SandboxConfig = { type: \"host\" };\n  let workingDirArg: string | undefined;\n  let downloadChannel: string | undefined;\n  let help = false;\n  let version = false;\n  let onboard = false;\n  let workerToken = false;\n\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n    let taken;\n    if (arg === \"--help\" || arg === \"-h\") {\n      help = true;\n    } else if (arg === \"--version\" || arg === \"-v\" || arg === \"-V\") {\n      version = true;\n    } else if (arg === \"--onboard\") {\n      onboard = true;\n    } else if (arg === \"--worker-token\") {\n      workerToken = true;\n    } else if ((taken = takeValueFlag(args, i, \"--sandbox\"))) {\n      sandbox = parseSandboxArg(taken.value);\n      i = taken.lastIndex;\n    } else if ((taken = takeValueFlag(args, i, \"--state-dir\"))) {\n      // Consumed here so its value never reads as the positional working\n      // dir; the value itself is resolved by resolveStateDir below.\n      i = taken.lastIndex;\n    } else if ((taken = takeValueFlag(args, i, \"--download\"))) {\n      downloadChannel = taken.value;\n      i = taken.lastIndex;\n    } else if (!arg.startsWith(\"-\")) {\n      workingDirArg = arg;\n    } else {\n      throw new Error(`Unknown flag: ${arg}. Run \\`mikan --help\\` for usage.`);\n    }\n  }\n\n  const stateDir = resolveStateDir(args);\n  return {\n    mode: help\n      ? \"help\"\n      : version\n        ? \"version\"\n        : workerToken\n          ? \"worker-token\"\n          : onboard\n            ? \"onboard\"\n            : downloadChannel\n              ? \"download\"\n              : \"run\",\n    stateDir,\n    workingDir: workingDirArg ? resolve(workingDirArg) : join(stateDir, \"workspace\"),\n    workingDirExplicit: workingDirArg !== undefined,\n    sandbox,\n    downloadChannel,\n  };\n}\n\nexport function helpText(): string {\n  return `mikan — multi-platform chat agent daemon\n\nUsage:\n  mikan [options] [working-directory]\n      Start the daemon. The working directory defaults to <state-dir>/workspace.\n  mikan ext <install|validate|list|remove> …\n      Manage extensions (run \\`mikan ext\\` for details).\n  mikan env\n      Show the full environment-variable inventory and what is currently set.\n\nOptions:\n  --state-dir <dir>      State directory (settings.json, vaults, extensions).\n                         Default: ~/.mikan\n  --sandbox <spec>       Execution sandbox. One of:\n                           host\n                           container:<existing-container-name>\n                           image:<image[:tag]>\n                           gondolin:default | gondolin:remote\n                           firecracker:<vm-id>:<host-path>[:<ssh-user>[:<ssh-port>]]\n                           cloudflare:<sandbox-id>\n                         Default: host\n  --onboard              Create <state-dir>/settings.json from a template, then exit.\n  --worker-token         Mint a one-time gondolin worker join token, then exit.\n  --download <channel>   Dump a Slack channel's history (Slack only), then exit.\n  --version, -v          Print the version.\n  --help, -h             Show this help.\n\nEnvironment (platform tokens select which chat adapters start):\n${envSummaryLines().join(\"\\n\")}\nRun \\`mikan env\\` for the full inventory.`;\n}\n"]}

package/dist/cli/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/cli/download.ts"],"names":[],"mappings":"AA6BA,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuFxF"}

package/dist/cli/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../src/cli/download.ts"],"names":[],"mappings":"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","sourcesContent":["import { LogLevel, WebClient } from \"@slack/web-api\";\n\ninterface Message {\n  ts: string;\n  user?: string;\n  text?: string;\n  thread_ts?: string;\n  reply_count?: number;\n  files?: Array<{ name: string; url_private?: string }>;\n}\n\nfunction formatTs(ts: string): string {\n  const date = new Date(parseFloat(ts) * 1000);\n  return date\n    .toISOString()\n    .replace(\"T\", \" \")\n    .replace(/\\.\\d+Z$/, \"\");\n}\n\nfunction formatMessage(ts: string, user: string, text: string, indent = \"\"): string {\n  const prefix = `[${formatTs(ts)}] ${user}: `;\n  const lines = text.split(\"\\n\");\n  const firstLine = `${indent}${prefix}${lines[0]}`;\n  if (lines.length === 1) return firstLine;\n  // All continuation lines get same indent as content start\n  const contentIndent = indent + \" \".repeat(prefix.length);\n  return [firstLine, ...lines.slice(1).map((l) => contentIndent + l)].join(\"\\n\");\n}\n\nexport async function downloadChannel(channelId: string, botToken: string): Promise<void> {\n  const client = new WebClient(botToken, { logLevel: LogLevel.ERROR });\n\n  console.error(`Fetching channel info for ${channelId}...`);\n\n  // Get channel info\n  let channelName = channelId;\n  try {\n    const info = await client.conversations.info({ channel: channelId });\n    channelName = typeof info.channel?.name === \"string\" ? info.channel.name : channelId;\n  } catch {\n    // DM channels don't have names, that's fine\n  }\n\n  console.error(`Downloading history for #${channelName} (${channelId})...`);\n\n  // Fetch all messages\n  const messages: Message[] = [];\n  let cursor: string | undefined;\n\n  do {\n    const response = await client.conversations.history({\n      channel: channelId,\n      limit: 200,\n      cursor,\n    });\n\n    if (response.messages) {\n      messages.push(...(response.messages as Message[]));\n    }\n\n    cursor = response.response_metadata?.next_cursor;\n    console.error(`  Fetched ${messages.length} messages...`);\n  } while (cursor);\n\n  // Reverse to chronological order\n  messages.reverse();\n\n  // Build map of thread replies\n  const threadReplies = new Map<string, Message[]>();\n  const threadsToFetch = messages.filter((m) => m.reply_count && m.reply_count > 0);\n\n  console.error(`Fetching ${threadsToFetch.length} threads...`);\n\n  for (let i = 0; i < threadsToFetch.length; i++) {\n    const parent = threadsToFetch[i];\n    console.error(`  Thread ${i + 1}/${threadsToFetch.length} (${parent.reply_count} replies)...`);\n\n    const replies: Message[] = [];\n    let threadCursor: string | undefined;\n\n    do {\n      const response = await client.conversations.replies({\n        channel: channelId,\n        ts: parent.ts,\n        limit: 200,\n        cursor: threadCursor,\n      });\n\n      if (response.messages) {\n        // Skip the first message (it's the parent)\n        replies.push(...(response.messages as Message[]).slice(1));\n      }\n\n      threadCursor = response.response_metadata?.next_cursor;\n    } while (threadCursor);\n\n    threadReplies.set(parent.ts, replies);\n  }\n\n  // Output messages with thread replies interleaved\n  let totalReplies = 0;\n  for (const msg of messages) {\n    // Output the message\n    console.log(formatMessage(msg.ts, msg.user || \"unknown\", msg.text || \"\"));\n\n    // Output thread replies right after parent (indented)\n    const replies = threadReplies.get(msg.ts);\n    if (replies) {\n      for (const reply of replies) {\n        console.log(formatMessage(reply.ts, reply.user || \"unknown\", reply.text || \"\", \"  \"));\n        totalReplies++;\n      }\n    }\n  }\n\n  console.error(`Done! ${messages.length} messages, ${totalReplies} thread replies`);\n}\n"]}

package/dist/cli/ext-git.d.ts

@@ -0,0 +1,22 @@
+export interface ResolvedGitSource {
+    /** Local directory holding the extension (clone root or a subpath within). */
+    dir: string;
+    /** Remove the temporary clone. */
+    cleanup: () => void;
+}
+interface GitSpec {
+    url: string;
+    subpath?: string;
+}
+/**
+ * Recognize a git source and split off an optional `#subpath`:
+ *   https://host/owner/repo.git#dir/ext   → { url, subpath }
+ *   git@host:owner/repo.git               → { url }
+ *   github:owner/repo                     → expands to https clone URL
+ * Returns undefined for anything that looks like a local path.
+ */
+export declare function parseGitSource(source: string): GitSpec | undefined;
+/** Clone a git source (shallow) and resolve the extension directory within it. */
+export declare function resolveGitSource(spec: GitSpec): ResolvedGitSource;
+export {};
+//# sourceMappingURL=ext-git.d.ts.map

package/dist/cli/ext-git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext-git.d.ts","sourceRoot":"","sources":["../../src/cli/ext-git.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,UAAU,OAAO;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAkBlE;AAQD,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAuBjE"}

package/dist/cli/ext-git.js

@@ -0,0 +1,76 @@
+/**
+ * Resolve a `mikan ext install` source that points at a git repository into a
+ * local directory: clone it, descend into an optional `#subpath`, and run
+ * `npm install --omit=dev` when the extension declares dependencies. The
+ * caller validates + copies the returned directory, then calls cleanup().
+ */
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/**
+ * Recognize a git source and split off an optional `#subpath`:
+ *   https://host/owner/repo.git#dir/ext   → { url, subpath }
+ *   git@host:owner/repo.git               → { url }
+ *   github:owner/repo                     → expands to https clone URL
+ * Returns undefined for anything that looks like a local path.
+ */
+export function parseGitSource(source) {
+    const [locator, subpath] = splitSubpath(source);
+    if (locator.startsWith("github:")) {
+        const repo = locator.slice("github:".length).replace(/\.git$/, "");
+        return { url: `https://github.com/${repo}.git`, subpath };
+    }
+    if (locator.startsWith("https://") ||
+        locator.startsWith("http://") ||
+        locator.startsWith("git://") ||
+        locator.startsWith("ssh://") ||
+        locator.startsWith("file://") ||
+        /^git@[^:]+:/.test(locator)) {
+        return { url: locator, subpath };
+    }
+    return undefined;
+}
+function splitSubpath(source) {
+    const hash = source.indexOf("#");
+    if (hash === -1)
+        return [source, undefined];
+    return [source.slice(0, hash), source.slice(hash + 1) || undefined];
+}
+/** Clone a git source (shallow) and resolve the extension directory within it. */
+export function resolveGitSource(spec) {
+    const tempRoot = mkdtempSync(join(tmpdir(), "mikan-ext-git-"));
+    const cleanup = () => rmSync(tempRoot, { recursive: true, force: true });
+    try {
+        execFileSync("git", ["clone", "--depth", "1", spec.url, tempRoot], { stdio: "inherit" });
+        const dir = spec.subpath ? join(tempRoot, spec.subpath) : tempRoot;
+        if (!existsSync(dir)) {
+            throw new Error(`Subpath not found in repository: ${spec.subpath}`);
+        }
+        // Install runtime dependencies only when the extension declares any.
+        if (hasDependencies(dir)) {
+            execFileSync("npm", ["install", "--omit=dev", "--no-audit", "--no-fund"], {
+                cwd: dir,
+                stdio: "inherit",
+            });
+        }
+        return { dir, cleanup };
+    }
+    catch (err) {
+        cleanup();
+        throw err;
+    }
+}
+function hasDependencies(dir) {
+    const packageJsonPath = join(dir, "package.json");
+    if (!existsSync(packageJsonPath))
+        return false;
+    try {
+        const pkg = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+        return Boolean(pkg.dependencies && Object.keys(pkg.dependencies).length > 0);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=ext-git.js.map

package/dist/cli/ext-git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext-git.js","sourceRoot":"","sources":["../../src/cli/ext-git.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resolve a `mikan ext install` source that points at a git repository into a\n * local directory: clone it, descend into an optional `#subpath`, and run\n * `npm install --omit=dev` when the extension declares dependencies. The\n * caller validates + copies the returned directory, then calls cleanup().\n */\nimport { execFileSync } from \"node:child_process\";\nimport { existsSync, mkdtempSync, readFileSync, rmSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\n\nexport interface ResolvedGitSource {\n  /** Local directory holding the extension (clone root or a subpath within). */\n  dir: string;\n  /** Remove the temporary clone. */\n  cleanup: () => void;\n}\n\ninterface GitSpec {\n  url: string;\n  subpath?: string;\n}\n\n/**\n * Recognize a git source and split off an optional `#subpath`:\n *   https://host/owner/repo.git#dir/ext   → { url, subpath }\n *   git@host:owner/repo.git               → { url }\n *   github:owner/repo                     → expands to https clone URL\n * Returns undefined for anything that looks like a local path.\n */\nexport function parseGitSource(source: string): GitSpec | undefined {\n  const [locator, subpath] = splitSubpath(source);\n\n  if (locator.startsWith(\"github:\")) {\n    const repo = locator.slice(\"github:\".length).replace(/\\.git$/, \"\");\n    return { url: `https://github.com/${repo}.git`, subpath };\n  }\n  if (\n    locator.startsWith(\"https://\") ||\n    locator.startsWith(\"http://\") ||\n    locator.startsWith(\"git://\") ||\n    locator.startsWith(\"ssh://\") ||\n    locator.startsWith(\"file://\") ||\n    /^git@[^:]+:/.test(locator)\n  ) {\n    return { url: locator, subpath };\n  }\n  return undefined;\n}\n\nfunction splitSubpath(source: string): [string, string | undefined] {\n  const hash = source.indexOf(\"#\");\n  if (hash === -1) return [source, undefined];\n  return [source.slice(0, hash), source.slice(hash + 1) || undefined];\n}\n\n/** Clone a git source (shallow) and resolve the extension directory within it. */\nexport function resolveGitSource(spec: GitSpec): ResolvedGitSource {\n  const tempRoot = mkdtempSync(join(tmpdir(), \"mikan-ext-git-\"));\n  const cleanup = () => rmSync(tempRoot, { recursive: true, force: true });\n  try {\n    execFileSync(\"git\", [\"clone\", \"--depth\", \"1\", spec.url, tempRoot], { stdio: \"inherit\" });\n\n    const dir = spec.subpath ? join(tempRoot, spec.subpath) : tempRoot;\n    if (!existsSync(dir)) {\n      throw new Error(`Subpath not found in repository: ${spec.subpath}`);\n    }\n\n    // Install runtime dependencies only when the extension declares any.\n    if (hasDependencies(dir)) {\n      execFileSync(\"npm\", [\"install\", \"--omit=dev\", \"--no-audit\", \"--no-fund\"], {\n        cwd: dir,\n        stdio: \"inherit\",\n      });\n    }\n    return { dir, cleanup };\n  } catch (err) {\n    cleanup();\n    throw err;\n  }\n}\n\nfunction hasDependencies(dir: string): boolean {\n  const packageJsonPath = join(dir, \"package.json\");\n  if (!existsSync(packageJsonPath)) return false;\n  try {\n    const pkg = JSON.parse(readFileSync(packageJsonPath, \"utf-8\")) as {\n      dependencies?: Record<string, string>;\n    };\n    return Boolean(pkg.dependencies && Object.keys(pkg.dependencies).length > 0);\n  } catch {\n    return false;\n  }\n}\n"]}

package/dist/cli/ext.d.ts

@@ -0,0 +1,2 @@
+export declare function runExtCommand(argv: string[]): Promise<number>;
+//# sourceMappingURL=ext.d.ts.map

package/dist/cli/ext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext.d.ts","sourceRoot":"","sources":["../../src/cli/ext.ts"],"names":[],"mappings":"AA2EA,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBnE"}

package/dist/cli/ext.js

@@ -0,0 +1,215 @@
+/**
+ * `mikan ext` — manage extensions from the CLI.
+ *
+ *   mikan ext install <source> [--global | --conversation <id>] [--state-dir <dir>]
+ *   mikan ext validate <path>
+ *   mikan ext list [--conversation <id>] [--state-dir <dir>]
+ *   mikan ext remove <slug> (--global | --conversation <id>) [--state-dir <dir>]
+ *
+ * `<source>` is a local path or a git URL (https://…, git@…, or github:owner/repo)
+ * with an optional `#subpath` for extensions inside a repo. Reinstalling over an
+ * existing extension updates it (data is preserved). Extensions install into the
+ * host-only state dir (never the workspace); see src/harness/extensions/LAYOUT.md.
+ */
+import { cpSync, existsSync, mkdirSync, rmSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+import { defaultExtensionDirs, listInstalledExtensions, validateExtension, } from "../harness/index.js";
+import { resolveStateDir, takeValueFlag } from "./arg-grammar.js";
+import { parseGitSource, resolveGitSource } from "./ext-git.js";
+function parseExtArgs(argv) {
+    // Shares the daemon's state-dir precedence: --state-dir > env > ~/.mikan.
+    const stateDir = resolveStateDir(argv);
+    let scope;
+    let conversationId;
+    const positional = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        let taken;
+        if (arg === "--global")
+            scope = "global";
+        else if ((taken = takeValueFlag(argv, i, "--conversation"))) {
+            scope = "conversation";
+            conversationId = taken.value || undefined;
+            i = taken.lastIndex;
+        }
+        else if ((taken = takeValueFlag(argv, i, "--state-dir"))) {
+            i = taken.lastIndex; // value already folded in by resolveStateDir
+        }
+        else
+            positional.push(arg);
+    }
+    return { action: positional[0], target: positional[1], stateDir, scope, conversationId };
+}
+/** Directory that extension CODE for the chosen scope lives in. */
+function scopeExtensionsDir(args) {
+    if (args.scope === "global")
+        return join(args.stateDir, "global", "extensions");
+    if (args.scope === "conversation" && args.conversationId) {
+        // defaultExtensionDirs returns [global, conversation]; take the conversation one.
+        return defaultExtensionDirs(args.conversationId, args.stateDir)[1];
+    }
+    throw new Error("Specify a scope: --global or --conversation <id>");
+}
+const USAGE = `Usage:
+  mikan ext install <source> (--global | --conversation <id>) [--state-dir <dir>]
+      <source>: a local path, or a git URL / github:owner/repo with optional #subpath
+      e.g. github:geminixiang/mikan#examples/extensions/agent-pm
+      Reinstalling over an existing extension updates it (data preserved).
+  mikan ext validate <path>
+  mikan ext list [--conversation <id>] [--state-dir <dir>]
+  mikan ext remove <slug> (--global | --conversation <id>) [--state-dir <dir>]`;
+function noop() { }
+export async function runExtCommand(argv) {
+    const args = parseExtArgs(argv);
+    switch (args.action) {
+        case "validate":
+            return validateAction(args);
+        case "install":
+            return installAction(args);
+        case "list":
+            return listAction(args);
+        case "remove":
+            return removeAction(args);
+        default:
+            console.error(USAGE);
+            return 1;
+    }
+}
+async function validateAction(args) {
+    if (!args.target) {
+        console.error("ext validate: missing <path>");
+        return 1;
+    }
+    const result = await validateExtension(resolve(args.target));
+    printValidation(result);
+    return result.ok ? 0 : 1;
+}
+async function installAction(args) {
+    if (!args.target) {
+        console.error("ext install: missing <path>");
+        return 1;
+    }
+    let destDir;
+    try {
+        destDir = scopeExtensionsDir(args);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return 1;
+    }
+    // Resolve the source: a git URL (optionally with #subpath) is cloned to a
+    // temp dir; a local path is used directly.
+    const gitSpec = parseGitSource(args.target);
+    let source;
+    let cleanup = noop;
+    if (gitSpec) {
+        try {
+            const resolved = resolveGitSource(gitSpec);
+            source = resolved.dir;
+            cleanup = resolved.cleanup;
+        }
+        catch (err) {
+            console.error(`Failed to fetch ${gitSpec.url}: ${err instanceof Error ? err.message : err}`);
+            return 1;
+        }
+    }
+    else {
+        source = resolve(args.target);
+    }
+    try {
+        return await installResolved(args, source, destDir);
+    }
+    finally {
+        cleanup();
+    }
+}
+async function installResolved(args, source, destDir) {
+    const result = await validateExtension(source);
+    printValidation(result);
+    if (!result.ok) {
+        console.error("Refusing to install: fix the errors above.");
+        return 1;
+    }
+    // Install into a named subdirectory so the slug never degenerates to the
+    // scope name. A bare file installs as <name>.<ext>; a directory as <name>/.
+    const destName = basename(source);
+    const dest = join(destDir, destName);
+    mkdirSync(destDir, { recursive: true });
+    // Reinstalling over an existing install is how updates work: replace it.
+    const replaced = existsSync(dest);
+    if (replaced)
+        rmSync(dest, { recursive: true, force: true });
+    cpSync(source, dest, { recursive: true });
+    const scopeLabel = args.scope === "global" ? "all conversations" : `conversation ${args.conversationId}`;
+    const dataDir = args.scope === "global"
+        ? join(args.stateDir, "global", "extension-data", result.slug)
+        : join(args.stateDir, "conversations", args.conversationId, "extension-data", result.slug);
+    const verb = replaced ? "Reinstalled" : "Installed";
+    console.log(`\n${verb} ${result.name} (slug: ${result.slug}) for ${scopeLabel}.`);
+    console.log(`  code: ${dest}`);
+    console.log(`  data: ${dataDir} (created on first use, preserved on reinstall)`);
+    console.log("Run /pi-new in the conversation to activate.");
+    return 0;
+}
+function listAction(args) {
+    // List the requested scope, or both when no conversation is given.
+    const dirs = args.conversationId
+        ? defaultExtensionDirs(args.conversationId, args.stateDir)
+        : [join(args.stateDir, "global", "extensions")];
+    const installed = listInstalledExtensions(dirs);
+    if (installed.length === 0) {
+        console.log("No extensions installed.");
+        return 0;
+    }
+    for (const info of installed) {
+        const scope = basename(resolve(info.dir, "..")) === "global" ? "global" : "conversation";
+        const version = info.version ? `@${info.version}` : "";
+        console.log(`${info.name}${version}  [${scope}]  slug=${info.slug}`);
+        if (info.description)
+            console.log(`  ${info.description}`);
+        if (info.skillNames.length > 0)
+            console.log(`  skills: ${info.skillNames.join(", ")}`);
+    }
+    return 0;
+}
+function removeAction(args) {
+    if (!args.target) {
+        console.error("ext remove: missing <slug>");
+        return 1;
+    }
+    let destDir;
+    try {
+        destDir = scopeExtensionsDir(args);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return 1;
+    }
+    // Match by installed slug so the caller doesn't need the exact dir name.
+    const match = listInstalledExtensions([destDir]).find((info) => info.slug === args.target);
+    if (!match) {
+        console.error(`No extension with slug '${args.target}' in ${destDir}`);
+        return 1;
+    }
+    // match.path is the entrypoint. Dir-form: its parent is the extension dir to
+    // remove. Bare-file: the parent is the scan dir, so remove the file itself.
+    const parent = resolve(match.path, "..");
+    const removeTarget = parent === resolve(destDir) ? match.path : parent;
+    rmSync(removeTarget, { recursive: true, force: true });
+    console.log(`Removed ${match.name} (slug: ${match.slug}). Data left in place.`);
+    console.log("Run /pi-new in the conversation to apply.");
+    return 0;
+}
+function printValidation(result) {
+    console.log(`${result.name}${result.version ? `@${result.version}` : ""} (slug: ${result.slug})`);
+    if (result.entrypoint)
+        console.log(`  entrypoint: ${result.entrypoint}`);
+    if (result.skillNames.length > 0)
+        console.log(`  skills: ${result.skillNames.join(", ")}`);
+    for (const warning of result.warnings)
+        console.log(`  warning: ${warning}`);
+    for (const error of result.errors)
+        console.error(`  error: ${error}`);
+    console.log(result.ok ? "  ✓ valid" : "  ✗ invalid");
+}
+//# sourceMappingURL=ext.js.map

package/dist/cli/ext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext.js","sourceRoot":"","sources":["../../src/cli/ext.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `mikan ext` — manage extensions from the CLI.\n *\n *   mikan ext install <source> [--global | --conversation <id>] [--state-dir <dir>]\n *   mikan ext validate <path>\n *   mikan ext list [--conversation <id>] [--state-dir <dir>]\n *   mikan ext remove <slug> (--global | --conversation <id>) [--state-dir <dir>]\n *\n * `<source>` is a local path or a git URL (https://…, git@…, or github:owner/repo)\n * with an optional `#subpath` for extensions inside a repo. Reinstalling over an\n * existing extension updates it (data is preserved). Extensions install into the\n * host-only state dir (never the workspace); see src/harness/extensions/LAYOUT.md.\n */\nimport { cpSync, existsSync, mkdirSync, rmSync } from \"node:fs\";\nimport { basename, join, resolve } from \"node:path\";\nimport {\n  defaultExtensionDirs,\n  listInstalledExtensions,\n  validateExtension,\n} from \"../harness/index.js\";\nimport { resolveStateDir, takeValueFlag } from \"./arg-grammar.js\";\nimport { parseGitSource, resolveGitSource } from \"./ext-git.js\";\n\ninterface ExtArgs {\n  action?: string;\n  target?: string;\n  stateDir: string;\n  scope: \"global\" | \"conversation\" | undefined;\n  conversationId?: string;\n}\n\nfunction parseExtArgs(argv: string[]): ExtArgs {\n  // Shares the daemon's state-dir precedence: --state-dir > env > ~/.mikan.\n  const stateDir = resolveStateDir(argv);\n  let scope: ExtArgs[\"scope\"];\n  let conversationId: string | undefined;\n  const positional: string[] = [];\n\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i];\n    let taken;\n    if (arg === \"--global\") scope = \"global\";\n    else if ((taken = takeValueFlag(argv, i, \"--conversation\"))) {\n      scope = \"conversation\";\n      conversationId = taken.value || undefined;\n      i = taken.lastIndex;\n    } else if ((taken = takeValueFlag(argv, i, \"--state-dir\"))) {\n      i = taken.lastIndex; // value already folded in by resolveStateDir\n    } else positional.push(arg);\n  }\n\n  return { action: positional[0], target: positional[1], stateDir, scope, conversationId };\n}\n\n/** Directory that extension CODE for the chosen scope lives in. */\nfunction scopeExtensionsDir(args: ExtArgs): string {\n  if (args.scope === \"global\") return join(args.stateDir, \"global\", \"extensions\");\n  if (args.scope === \"conversation\" && args.conversationId) {\n    // defaultExtensionDirs returns [global, conversation]; take the conversation one.\n    return defaultExtensionDirs(args.conversationId, args.stateDir)[1];\n  }\n  throw new Error(\"Specify a scope: --global or --conversation <id>\");\n}\n\nconst USAGE = `Usage:\n  mikan ext install <source> (--global | --conversation <id>) [--state-dir <dir>]\n      <source>: a local path, or a git URL / github:owner/repo with optional #subpath\n      e.g. github:geminixiang/mikan#examples/extensions/agent-pm\n      Reinstalling over an existing extension updates it (data preserved).\n  mikan ext validate <path>\n  mikan ext list [--conversation <id>] [--state-dir <dir>]\n  mikan ext remove <slug> (--global | --conversation <id>) [--state-dir <dir>]`;\n\nfunction noop(): void {}\n\nexport async function runExtCommand(argv: string[]): Promise<number> {\n  const args = parseExtArgs(argv);\n\n  switch (args.action) {\n    case \"validate\":\n      return validateAction(args);\n    case \"install\":\n      return installAction(args);\n    case \"list\":\n      return listAction(args);\n    case \"remove\":\n      return removeAction(args);\n    default:\n      console.error(USAGE);\n      return 1;\n  }\n}\n\nasync function validateAction(args: ExtArgs): Promise<number> {\n  if (!args.target) {\n    console.error(\"ext validate: missing <path>\");\n    return 1;\n  }\n  const result = await validateExtension(resolve(args.target));\n  printValidation(result);\n  return result.ok ? 0 : 1;\n}\n\nasync function installAction(args: ExtArgs): Promise<number> {\n  if (!args.target) {\n    console.error(\"ext install: missing <path>\");\n    return 1;\n  }\n  let destDir: string;\n  try {\n    destDir = scopeExtensionsDir(args);\n  } catch (err) {\n    console.error(err instanceof Error ? err.message : String(err));\n    return 1;\n  }\n\n  // Resolve the source: a git URL (optionally with #subpath) is cloned to a\n  // temp dir; a local path is used directly.\n  const gitSpec = parseGitSource(args.target);\n  let source: string;\n  let cleanup = noop;\n  if (gitSpec) {\n    try {\n      const resolved = resolveGitSource(gitSpec);\n      source = resolved.dir;\n      cleanup = resolved.cleanup;\n    } catch (err) {\n      console.error(`Failed to fetch ${gitSpec.url}: ${err instanceof Error ? err.message : err}`);\n      return 1;\n    }\n  } else {\n    source = resolve(args.target);\n  }\n\n  try {\n    return await installResolved(args, source, destDir);\n  } finally {\n    cleanup();\n  }\n}\n\nasync function installResolved(args: ExtArgs, source: string, destDir: string): Promise<number> {\n  const result = await validateExtension(source);\n  printValidation(result);\n  if (!result.ok) {\n    console.error(\"Refusing to install: fix the errors above.\");\n    return 1;\n  }\n\n  // Install into a named subdirectory so the slug never degenerates to the\n  // scope name. A bare file installs as <name>.<ext>; a directory as <name>/.\n  const destName = basename(source);\n  const dest = join(destDir, destName);\n  mkdirSync(destDir, { recursive: true });\n  // Reinstalling over an existing install is how updates work: replace it.\n  const replaced = existsSync(dest);\n  if (replaced) rmSync(dest, { recursive: true, force: true });\n  cpSync(source, dest, { recursive: true });\n\n  const scopeLabel =\n    args.scope === \"global\" ? \"all conversations\" : `conversation ${args.conversationId}`;\n  const dataDir =\n    args.scope === \"global\"\n      ? join(args.stateDir, \"global\", \"extension-data\", result.slug)\n      : join(args.stateDir, \"conversations\", args.conversationId!, \"extension-data\", result.slug);\n  const verb = replaced ? \"Reinstalled\" : \"Installed\";\n  console.log(`\\n${verb} ${result.name} (slug: ${result.slug}) for ${scopeLabel}.`);\n  console.log(`  code: ${dest}`);\n  console.log(`  data: ${dataDir} (created on first use, preserved on reinstall)`);\n  console.log(\"Run /pi-new in the conversation to activate.\");\n  return 0;\n}\n\nfunction listAction(args: ExtArgs): number {\n  // List the requested scope, or both when no conversation is given.\n  const dirs = args.conversationId\n    ? defaultExtensionDirs(args.conversationId, args.stateDir)\n    : [join(args.stateDir, \"global\", \"extensions\")];\n  const installed = listInstalledExtensions(dirs);\n  if (installed.length === 0) {\n    console.log(\"No extensions installed.\");\n    return 0;\n  }\n  for (const info of installed) {\n    const scope = basename(resolve(info.dir, \"..\")) === \"global\" ? \"global\" : \"conversation\";\n    const version = info.version ? `@${info.version}` : \"\";\n    console.log(`${info.name}${version}  [${scope}]  slug=${info.slug}`);\n    if (info.description) console.log(`  ${info.description}`);\n    if (info.skillNames.length > 0) console.log(`  skills: ${info.skillNames.join(\", \")}`);\n  }\n  return 0;\n}\n\nfunction removeAction(args: ExtArgs): number {\n  if (!args.target) {\n    console.error(\"ext remove: missing <slug>\");\n    return 1;\n  }\n  let destDir: string;\n  try {\n    destDir = scopeExtensionsDir(args);\n  } catch (err) {\n    console.error(err instanceof Error ? err.message : String(err));\n    return 1;\n  }\n  // Match by installed slug so the caller doesn't need the exact dir name.\n  const match = listInstalledExtensions([destDir]).find((info) => info.slug === args.target);\n  if (!match) {\n    console.error(`No extension with slug '${args.target}' in ${destDir}`);\n    return 1;\n  }\n  // match.path is the entrypoint. Dir-form: its parent is the extension dir to\n  // remove. Bare-file: the parent is the scan dir, so remove the file itself.\n  const parent = resolve(match.path, \"..\");\n  const removeTarget = parent === resolve(destDir) ? match.path : parent;\n  rmSync(removeTarget, { recursive: true, force: true });\n  console.log(`Removed ${match.name} (slug: ${match.slug}). Data left in place.`);\n  console.log(\"Run /pi-new in the conversation to apply.\");\n  return 0;\n}\n\nfunction printValidation(result: {\n  ok: boolean;\n  name: string;\n  slug: string;\n  version?: string;\n  entrypoint?: string;\n  skillNames: string[];\n  errors: string[];\n  warnings: string[];\n}): void {\n  console.log(`${result.name}${result.version ? `@${result.version}` : \"\"} (slug: ${result.slug})`);\n  if (result.entrypoint) console.log(`  entrypoint: ${result.entrypoint}`);\n  if (result.skillNames.length > 0) console.log(`  skills: ${result.skillNames.join(\", \")}`);\n  for (const warning of result.warnings) console.log(`  warning: ${warning}`);\n  for (const error of result.errors) console.error(`  error: ${error}`);\n  console.log(result.ok ? \"  ✓ valid\" : \"  ✗ invalid\");\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/commands/admin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjE,qBAAa,mBAAoB,YAAW,cAAc;IAClD,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAkCzD;CACF"}
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/commands/admin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjE,qBAAa,mBAAoB,YAAW,cAAc;IAClD,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAkCzD;CACF"}