@geminixiang/mikan 1.0.0-beta.6 → 1.0.0-beta.8

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,217 @@
+/**
+ * `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 { homedir } from "node:os";
+import { basename, join, resolve } from "node:path";
+import { defaultExtensionDirs, listInstalledExtensions, validateExtension, } from "../harness/index.js";
+import { parseGitSource, resolveGitSource } from "./ext-git.js";
+function parseExtArgs(argv) {
+    let stateDir = join(homedir(), ".mikan");
+    let scope;
+    let conversationId;
+    const positional = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--global")
+            scope = "global";
+        else if (arg === "--conversation") {
+            scope = "conversation";
+            conversationId = argv[++i];
+        }
+        else if (arg.startsWith("--conversation=")) {
+            scope = "conversation";
+            conversationId = arg.slice("--conversation=".length);
+        }
+        else if (arg === "--state-dir")
+            stateDir = resolve(argv[++i] ?? "");
+        else if (arg.startsWith("--state-dir="))
+            stateDir = resolve(arg.slice("--state-dir=".length));
+        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 { homedir } from \"node:os\";\nimport { basename, join, resolve } from \"node:path\";\nimport {\n  defaultExtensionDirs,\n  listInstalledExtensions,\n  validateExtension,\n} from \"../harness/index.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  let stateDir = join(homedir(), \".mikan\");\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    if (arg === \"--global\") scope = \"global\";\n    else if (arg === \"--conversation\") {\n      scope = \"conversation\";\n      conversationId = argv[++i];\n    } else if (arg.startsWith(\"--conversation=\")) {\n      scope = \"conversation\";\n      conversationId = arg.slice(\"--conversation=\".length);\n    } else if (arg === \"--state-dir\") stateDir = resolve(argv[++i] ?? \"\");\n    else if (arg.startsWith(\"--state-dir=\")) stateDir = resolve(arg.slice(\"--state-dir=\".length));\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/harness/extensions/loader.d.ts

@@ -51,12 +51,36 @@ export interface LoadExtensionsResult {
 }
 /**
  * Filesystem-safe identifier for an extension, derived from its install
- * location (directory name for `<name>/index.mjs`, file basename otherwise).
- * The slug keys the extension's data dir, secrets vault, and schedule
- * ownership — installing the same extension globally and per-conversation
- * shares one slug and therefore one data dir.
+ * location: the directory name for a directory-form extension, or the file
+ * basename for a bare file. The slug keys the extension's data dir, secrets
+ * vault, and schedule ownership — installing the same extension globally and
+ * per-conversation shares one slug and therefore one shared data dir.
  */
 export declare function extensionSlug(entrypoint: string): string;
 /** Load and activate all extensions found in the given directories. */
 export declare function loadExtensions(options: LoadExtensionsOptions): Promise<LoadExtensionsResult>;
+export interface ExtensionValidation {
+    ok: boolean;
+    /** Slug the extension would install as (from the source dir/file name). */
+    slug: string;
+    /** Display name (manifest name, else slug). */
+    name: string;
+    version?: string;
+    description?: string;
+    /** Resolved entrypoint that would be imported. */
+    entrypoint?: string;
+    /** Skill names shipped alongside the extension. */
+    skillNames: string[];
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate an extension source path (a directory or a single file) WITHOUT
+ * activating it: resolves the entrypoint (package.json `mikan.extensions`,
+ * index file, or the file itself), imports it, and checks it exports an
+ * `activate` function. Used by `mikan ext install` as a preflight and by
+ * `mikan ext validate`. Importing runs top-level module code but not
+ * `activate`, so there are no schedule/tool side effects.
+ */
+export declare function validateExtension(sourcePath: string): Promise<ExtensionValidation>;
 //# sourceMappingURL=loader.d.ts.map

package/dist/harness/extensions/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/harness/extensions/loader.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAKlB,eAAe,EAIhB,MAAM,YAAY,CAAC;AAIpB;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,QAAQ,GAAE,MAAkC,GAC3C,MAAM,EAAE,CAKV;AAED,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,sBAAsB,EAAE,CAkBhF;AAED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAClB,aAAa,EAAE,aAAa,CAAC;KAC9B,CAAC;IACF,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,4EAA4E;IAC5E,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AA0CD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAUxD;AAgND,uEAAuE;AACvE,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAmD/B"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/harness/extensions/loader.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAKlB,eAAe,EAIhB,MAAM,YAAY,CAAC;AAiBpB;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,QAAQ,GAAE,MAAkC,GAC3C,MAAM,EAAE,CAKV;AAED,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,sBAAsB,EAAE,CAkBhF;AAED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAClB,aAAa,EAAE,aAAa,CAAC;KAC9B,CAAC;IACF,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,4EAA4E;IAC5E,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAuHD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQxD;AA0OD,uEAAuE;AACvE,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAkD/B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsDxF"}