@xopcai/xopc 0.0.23 → 0.0.25

package/dist/src/cli/commands/extension-dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-dev.js","names":[],"sources":["../../../../src/cli/commands/extension-dev.ts"],"sourcesContent":["import {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  symlinkSync,\n  unlinkSync,\n  watch,\n  type FSWatcher,\n} from 'node:fs';\nimport { join, resolve } from 'node:path';\n\nimport { Command } from 'commander';\n\nimport { resolveDefaultAgentId } from '../../agent/agent-scope.js';\nimport { loadConfig } from '../../config/loader.js';\nimport { resolveConfigPath } from '../../config/paths.js';\nimport { resolveWorkspaceExtensionsDir } from '../../config/paths.js';\nimport { checkEngineCompatibility } from '../../extensions/engine-check.js';\nimport type { ExtensionManifest } from '../../extensions/types/index.js';\nimport { normalizeExtensionManifest } from '../../extensions/normalize-manifest.js';\nimport { GatewayServer } from '../../gateway/index.js';\nimport { runGatewayLoop } from '../../gateway/run-loop.js';\nimport { PACKAGE_VERSION } from '../../package-version.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { colors } from '../utils/colors.js';\nimport { getContextWithOpts } from '../index.js';\nimport { initWorkspace } from '../utils/init-workspace.js';\nimport { seedMainAgentBootstrap } from '../../agent/context/workspace-seed.js';\n\nconst log = createLogger('ExtensionDev');\nconst MANIFEST = 'xopc.extension.json';\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nasync function ensureGatewayReady(\n  configPath: string,\n  workspacePath: string,\n  gatewayHost: string,\n  gatewayPort: number,\n): Promise<void> {\n  const result = await initWorkspace({\n    configPath,\n    workspacePath,\n    gatewayHost,\n    gatewayPort,\n  });\n\n  if (result.configCreated || result.workspaceCreated) {\n    console.log('');\n    console.log('👋 First-time setup before starting the gateway...');\n    console.log('');\n    console.log('✅ Setup complete.');\n    console.log(`   Config:    ${configPath}`);\n    console.log(`   Workspace: ${workspacePath}`);\n    console.log('');\n    seedMainAgentBootstrap(result.config);\n  }\n}\n\nfunction loadAndValidateManifest(extensionDir: string): ExtensionManifest | null {\n  const manifestPath = join(extensionDir, MANIFEST);\n  if (!existsSync(manifestPath)) {\n    console.error(colors.red('error:'), `Missing ${MANIFEST} in ${extensionDir}`);\n    return null;\n  }\n  try {\n    const raw = JSON.parse(readFileSync(manifestPath, 'utf-8') as string) as unknown;\n    if (!isRecord(raw)) {\n      console.error(colors.red('error:'), 'Manifest must be a JSON object');\n      return null;\n    }\n    const manifest = normalizeExtensionManifest(raw);\n    if (!manifest.id?.trim()) {\n      console.error(colors.red('error:'), 'Manifest \"id\" is required');\n      return null;\n    }\n    if (manifest.engines?.xopc) {\n      const r = checkEngineCompatibility(PACKAGE_VERSION, manifest.engines.xopc);\n      if (r.parseWarning) {\n        console.log(\n          colors.yellow('warning:'),\n          r.reason ?? 'engines.xopc could not be fully parsed — continuing',\n        );\n      } else if (!r.compatible) {\n        console.log(\n          colors.yellow('warning:'),\n          r.reason ?? `engines.xopc may not match xopc ${PACKAGE_VERSION} — continuing`,\n        );\n      }\n    }\n    return manifest;\n  } catch (e) {\n    log.error({ err: e }, 'Failed to read manifest');\n    console.error(\n      colors.red('error:'),\n      e instanceof Error ? e.message : String(e),\n    );\n    return null;\n  }\n}\n\nfunction setupDevSymlink(extensionDir: string, extensionsDir: string, extensionId: string): string {\n  mkdirSync(extensionsDir, { recursive: true });\n  const symlinkPath = join(extensionsDir, extensionId);\n  if (existsSync(symlinkPath)) {\n    unlinkSync(symlinkPath);\n  }\n  symlinkSync(extensionDir, symlinkPath, 'dir');\n  return symlinkPath;\n}\n\nfunction cleanupSymlink(symlinkPath: string | null): void {\n  if (!symlinkPath) return;\n  try {\n    if (existsSync(symlinkPath)) {\n      unlinkSync(symlinkPath);\n    }\n  } catch (e) {\n    log.warn({ err: e, symlinkPath }, 'Failed to remove dev symlink');\n  }\n}\n\nfunction shouldIgnorePath(relativePath: string): boolean {\n  const parts = relativePath.split(/[/\\\\]/);\n  if (parts.some((p) => p === 'node_modules')) return true;\n  if (parts.some((p) => p.startsWith('.'))) return true;\n  return false;\n}\n\nexport function createExtensionDevCommand(): Command {\n  return new Command('extension:dev')\n    .alias('ext:dev')\n    .description('Symlink an extension into the workspace for live development (optional file watch + gateway)')\n    .argument('[dir]', 'Extension directory (default: current working directory)', '.')\n    .option('--port <number>', 'Gateway port', '18790')\n    .option('--host <address>', 'Gateway host', '127.0.0.1')\n    .option('--no-gateway', 'Do not start the gateway (symlink only)')\n    .option('--no-watch', 'Do not watch files for changes')\n    .action(\n      async (\n        dir: string,\n        options: { port: string; host: string; gateway: boolean; watch: boolean },\n      ) => {\n        const extensionDir = resolve(dir || '.');\n        const manifest = loadAndValidateManifest(extensionDir);\n        if (!manifest) {\n          process.exit(1);\n        }\n\n        const ctx = getContextWithOpts();\n        const config = loadConfig(ctx.configPath);\n        const agentId = resolveDefaultAgentId(config);\n        const extensionsDir = resolveWorkspaceExtensionsDir(config, agentId);\n        const symlinkPath = setupDevSymlink(extensionDir, extensionsDir, manifest.id);\n\n        console.log(\n          colors.green('✓'),\n          `Dev symlink: ${symlinkPath} → ${extensionDir}`,\n        );\n        console.log(\n          colors.cyan('Note:'),\n          'restart the gateway or trigger config hot-reload so the extension reload picks up changes.',\n        );\n\n        let debounce: ReturnType<typeof setTimeout> | null = null;\n        let watcher: FSWatcher | null = null;\n\n        if (options.watch) {\n          try {\n            watcher = watch(\n              extensionDir,\n              { recursive: true },\n              (_event, filename) => {\n                const rel = filename ? String(filename) : '';\n                if (rel && shouldIgnorePath(rel)) return;\n                if (debounce) clearTimeout(debounce);\n                debounce = setTimeout(() => {\n                  const label = rel || '(unknown)';\n                  if (/(^|[\\\\/])xopc\\.extension\\.json$/.test(rel) || rel === MANIFEST) {\n                    console.log(colors.cyan('[watch]'), `manifest: ${label}`);\n                  } else if (/\\.(html?|css|mjs|js|tsx?|jsx|json)$/i.test(label)) {\n                    if (/^ui[\\\\/]/.test(rel) || /[\\\\/]ui[\\\\/]/.test(label)) {\n                      console.log(colors.cyan('[watch]'), `ui: ${label}`);\n                    } else {\n                      console.log(colors.cyan('[watch]'), `source: ${label}`);\n                    }\n                  } else {\n                    console.log(colors.cyan('[watch]'), `changed: ${label}`);\n                  }\n                }, 300);\n              },\n            );\n          } catch (e) {\n            log.warn({ err: e }, 'fs.watch failed; continuing without watch');\n          }\n        }\n\n        let cleaned = false;\n        const cleanup = () => {\n          if (cleaned) return;\n          cleaned = true;\n          if (debounce) clearTimeout(debounce);\n          if (watcher) {\n            try {\n              watcher.close();\n            } catch (e) {\n              log.warn({ err: e }, 'watcher close failed');\n            }\n          }\n          cleanupSymlink(symlinkPath);\n        };\n\n        for (const sig of ['SIGINT', 'SIGTERM'] as const) {\n          process.on(sig, () => {\n            cleanup();\n            process.exit(0);\n          });\n        }\n\n        if (!options.gateway) {\n          if (options.watch) {\n            console.log(colors.cyan('Watching…'), 'Ctrl+C to stop and remove symlink');\n          } else {\n            console.log(\n              colors.cyan('Holding process…'),\n              'Ctrl+C to stop and remove symlink (no file watch)',\n            );\n          }\n          await new Promise(() => {\n            /* until SIGINT / SIGTERM */\n          });\n          return;\n        }\n\n        const port = parseInt(options.port, 10);\n        const host = options.host;\n        await ensureGatewayReady(ctx.configPath, ctx.workspacePath, host, port);\n        const cfg = loadConfig(ctx.configPath);\n\n        if (Number.isNaN(port)) {\n          console.error(colors.red('error:'), 'Invalid --port');\n          cleanup();\n          process.exit(1);\n        }\n\n        console.log('');\n        console.log('🚀 Starting gateway (extension dev)…');\n        console.log(`   Host: ${host}`);\n        console.log(`   Port: ${port}`);\n        console.log('');\n\n        try {\n          await runGatewayLoop({\n            configPath: ctx.configPath || resolveConfigPath(),\n            port,\n            start: async () => {\n              const server = new GatewayServer({\n                host,\n                port,\n                token: cfg?.gateway?.auth?.token,\n                verbose: ctx.isVerbose,\n                configPath: ctx.configPath,\n                enableHotReload: true,\n              });\n              await server.start();\n              const displayHost = host === '0.0.0.0' ? 'localhost' : host;\n              const token = cfg?.gateway?.auth?.token;\n              console.log('✅ Gateway started');\n              console.log(`   URL: http://${displayHost}:${port}`);\n              if (token) {\n                console.log(\n                  `   Token: ${String(token).slice(0, 8)}...${String(token).slice(-8)}`,\n                );\n              }\n              console.log('');\n              return server;\n            },\n          });\n        } finally {\n          cleanup();\n        }\n      },\n    );\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/extension-marketplace.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+export declare function createExtensionSearchCommand(): Command;
+export declare function createExtensionPublishCommand(): Command;
+export declare function createExtensionUpdateCommand(): Command;

package/dist/src/cli/commands/extension-marketplace.js

@@ -0,0 +1,145 @@
+import { init_agent_scope, resolveDefaultAgentId } from "../../agent/agent-scope.js";
+import { init_paths, resolveWorkspaceExtensionsDir } from "../../config/paths.js";
+import { init_loader, loadConfig } from "../../config/loader.js";
+import { normalizeExtensionManifest } from "../../extensions/normalize-manifest.js";
+import { colors } from "../utils/colors.js";
+import { fetchRegistry, findExtension, getRegistryUrl, listExtensions, searchExtensions } from "../../extensions/marketplace.js";
+import { getExtensionLockfileManager } from "../../extensions/lockfile.js";
+import { installFromNpm, resolveExtensionsDir } from "../../extensions/install.js";
+import { getContextWithOpts } from "../index.js";
+import { join, resolve } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { Command } from "commander";
+import { execSync } from "node:child_process";
+//#region src/cli/commands/extension-marketplace.ts
+init_agent_scope();
+init_loader();
+init_paths();
+const MANIFEST = "xopc.extension.json";
+function isRecord(x) {
+	return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+function hasWorkspaceDeps(pkg) {
+	const deps = pkg.dependencies;
+	const dev = pkg.devDependencies;
+	const check = (d) => {
+		if (!isRecord(d)) return false;
+		return Object.values(d).some((v) => typeof v === "string" && v.startsWith("workspace:"));
+	};
+	return check(deps) || check(dev);
+}
+function createExtensionSearchCommand() {
+	return new Command("extension:search").alias("ext:search").description("Search the curated extension registry").argument("[keyword]", "Search text (omit to list all)", "").option("--category <cat>", "Filter by category").option("--json", "JSON output").action(async (keyword, opts) => {
+		try {
+			let rows;
+			if (opts.category?.trim()) {
+				rows = await listExtensions(opts.category.trim());
+				if (keyword.trim()) {
+					const k = keyword.trim().toLowerCase();
+					rows = rows.filter((e) => e.id.toLowerCase().includes(k) || e.name.toLowerCase().includes(k) || (e.description ?? "").toLowerCase().includes(k));
+				}
+			} else if (keyword.trim()) rows = await searchExtensions(keyword.trim());
+			else rows = (await fetchRegistry()).extensions;
+			if (opts.json) {
+				console.log(JSON.stringify(rows, null, 2));
+				return;
+			}
+			if (rows.length === 0) {
+				console.log("No extensions found.");
+				return;
+			}
+			console.log(`Registry: ${getRegistryUrl()}`);
+			console.log("");
+			for (const e of rows) {
+				const badge = e.verified ? ` ${colors.green("✓")}` : "";
+				console.log(`${colors.cyan(e.name)}${badge} ${colors.gray(e.version ?? "")}`);
+				console.log(`  id: ${e.id}  npm: ${e.npmPackage}`);
+				if (e.description) console.log(`  ${e.description}`);
+				if (e.categories?.length) console.log(`  categories: ${e.categories.join(", ")}`);
+				console.log("");
+			}
+		} catch (err) {
+			console.error(colors.red("Error:"), err instanceof Error ? err.message : String(err));
+			process.exit(1);
+		}
+	});
+}
+function createExtensionPublishCommand() {
+	return new Command("extension:publish").alias("ext:publish").description("Publish extension to npm (public)").argument("[directory]", "Extension root", ".").option("--dry-run", "npm publish --dry-run", false).option("--access <level>", "npm access", "public").action((dir, opts) => {
+		const root = resolve(dir || ".");
+		const manifestPath = join(root, MANIFEST);
+		const pkgPath = join(root, "package.json");
+		if (!existsSync(manifestPath) || !existsSync(pkgPath)) {
+			console.error(colors.red("error:"), `Need ${MANIFEST} and package.json in ${root}`);
+			process.exit(1);
+		}
+		try {
+			if (hasWorkspaceDeps(JSON.parse(readFileSync(pkgPath, "utf-8")))) {
+				console.error(colors.red("error:"), "Remove workspace:* dependencies before publishing.");
+				process.exit(1);
+			}
+			if (!normalizeExtensionManifest(JSON.parse(readFileSync(manifestPath, "utf-8"))).id) {
+				console.error(colors.red("error:"), "Invalid manifest id");
+				process.exit(1);
+			}
+		} catch (e) {
+			console.error(colors.red("error:"), e instanceof Error ? e.message : String(e));
+			process.exit(1);
+		}
+		const args = ["publish", `--access=${opts.access}`];
+		if (opts.dryRun) args.push("--dry-run");
+		console.log(colors.cyan("Running:"), `npm ${args.join(" ")}`);
+		try {
+			execSync(`npm ${args.join(" ")}`, {
+				cwd: root,
+				stdio: "inherit"
+			});
+		} catch {
+			process.exit(1);
+		}
+	});
+}
+function createExtensionUpdateCommand() {
+	return new Command("extension:update").alias("ext:update").description("Re-install extension(s) from npm using the lockfile / registry").argument("[extensionId]", "Specific extension id (default: all in lockfile)").option("--global", "Use global extensions directory", false).action(async (extensionId, opts) => {
+		const ctx = getContextWithOpts();
+		const cfg = loadConfig(ctx.configPath);
+		const agentId = resolveDefaultAgentId(cfg);
+		const targetDir = opts.global ? resolveExtensionsDir(ctx.workspacePath, true) : resolveWorkspaceExtensionsDir(cfg, agentId);
+		const data = await getExtensionLockfileManager().load();
+		const ids = extensionId?.trim() ? [extensionId.trim()] : Object.keys(data.extensions);
+		if (ids.length === 0) {
+			console.log("No extensions in lockfile.");
+			return;
+		}
+		for (const id of ids) {
+			const entry = data.extensions[id];
+			if (!entry) {
+				console.log(colors.yellow("skip"), id, "(not in lockfile)");
+				continue;
+			}
+			if (entry.source !== "npm") {
+				console.log(colors.yellow("skip"), id, `(source ${entry.source})`);
+				continue;
+			}
+			const spec = entry.resolved?.trim() || await npmPackageForId(id);
+			if (!spec) {
+				console.log(colors.yellow("skip"), id, "(could not resolve npm package)");
+				continue;
+			}
+			console.log(colors.cyan("Updating"), id, "←", spec);
+			const result = await installFromNpm(spec, targetDir);
+			if (!result.ok) {
+				console.error(colors.red("error:"), result.error ?? id);
+				process.exit(1);
+			}
+			console.log(colors.green("✓"), id);
+		}
+	});
+}
+async function npmPackageForId(id) {
+	return (await findExtension(id))?.npmPackage;
+}
+//#endregion
+export { createExtensionPublishCommand, createExtensionSearchCommand, createExtensionUpdateCommand };
+
+//# sourceMappingURL=extension-marketplace.js.map

package/dist/src/cli/commands/extension-marketplace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-marketplace.js","names":["marketplace.listExtensions","marketplace.searchExtensions","marketplace.fetchRegistry","marketplace.getRegistryUrl","marketplace.findExtension"],"sources":["../../../../src/cli/commands/extension-marketplace.ts"],"sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\n\nimport { Command } from 'commander';\n\nimport { resolveDefaultAgentId } from '../../agent/agent-scope.js';\nimport { loadConfig } from '../../config/loader.js';\nimport { resolveWorkspaceExtensionsDir } from '../../config/paths.js';\nimport { installFromNpm, resolveExtensionsDir } from '../../extensions/install.js';\nimport { getExtensionLockfileManager } from '../../extensions/lockfile.js';\nimport * as marketplace from '../../extensions/marketplace.js';\nimport { normalizeExtensionManifest } from '../../extensions/normalize-manifest.js';\nimport { colors } from '../utils/colors.js';\nimport { getContextWithOpts } from '../index.js';\n\nconst MANIFEST = 'xopc.extension.json';\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction hasWorkspaceDeps(pkg: Record<string, unknown>): boolean {\n  const deps = pkg.dependencies;\n  const dev = pkg.devDependencies;\n  const check = (d: unknown) => {\n    if (!isRecord(d)) return false;\n    return Object.values(d).some((v) => typeof v === 'string' && v.startsWith('workspace:'));\n  };\n  return check(deps) || check(dev);\n}\n\nexport function createExtensionSearchCommand(): Command {\n  return new Command('extension:search')\n    .alias('ext:search')\n    .description('Search the curated extension registry')\n    .argument('[keyword]', 'Search text (omit to list all)', '')\n    .option('--category <cat>', 'Filter by category')\n    .option('--json', 'JSON output')\n    .action(async (keyword: string, opts: { category?: string; json?: boolean }) => {\n      try {\n        let rows;\n        if (opts.category?.trim()) {\n          rows = await marketplace.listExtensions(opts.category.trim());\n          if (keyword.trim()) {\n            const k = keyword.trim().toLowerCase();\n            rows = rows.filter(\n              (e) =>\n                e.id.toLowerCase().includes(k) ||\n                e.name.toLowerCase().includes(k) ||\n                (e.description ?? '').toLowerCase().includes(k),\n            );\n          }\n        } else if (keyword.trim()) {\n          rows = await marketplace.searchExtensions(keyword.trim());\n        } else {\n          const reg = await marketplace.fetchRegistry();\n          rows = reg.extensions;\n        }\n\n        if (opts.json) {\n          console.log(JSON.stringify(rows, null, 2));\n          return;\n        }\n\n        if (rows.length === 0) {\n          console.log('No extensions found.');\n          return;\n        }\n\n        console.log(`Registry: ${marketplace.getRegistryUrl()}`);\n        console.log('');\n        for (const e of rows) {\n          const badge = e.verified ? ` ${colors.green('✓')}` : '';\n          console.log(`${colors.cyan(e.name)}${badge} ${colors.gray(e.version ?? '')}`);\n          console.log(`  id: ${e.id}  npm: ${e.npmPackage}`);\n          if (e.description) console.log(`  ${e.description}`);\n          if (e.categories?.length) console.log(`  categories: ${e.categories.join(', ')}`);\n          console.log('');\n        }\n      } catch (err) {\n        console.error(colors.red('Error:'), err instanceof Error ? err.message : String(err));\n        process.exit(1);\n      }\n    });\n}\n\nexport function createExtensionPublishCommand(): Command {\n  return new Command('extension:publish')\n    .alias('ext:publish')\n    .description('Publish extension to npm (public)')\n    .argument('[directory]', 'Extension root', '.')\n    .option('--dry-run', 'npm publish --dry-run', false)\n    .option('--access <level>', 'npm access', 'public')\n    .action((dir: string, opts: { dryRun: boolean; access: string }) => {\n      const root = resolve(dir || '.');\n      const manifestPath = join(root, MANIFEST);\n      const pkgPath = join(root, 'package.json');\n      if (!existsSync(manifestPath) || !existsSync(pkgPath)) {\n        console.error(colors.red('error:'), `Need ${MANIFEST} and package.json in ${root}`);\n        process.exit(1);\n      }\n      try {\n        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8')) as Record<string, unknown>;\n        if (hasWorkspaceDeps(pkg)) {\n          console.error(\n            colors.red('error:'),\n            'Remove workspace:* dependencies before publishing.',\n          );\n          process.exit(1);\n        }\n        const raw = JSON.parse(readFileSync(manifestPath, 'utf-8')) as Record<string, unknown>;\n        const manifest = normalizeExtensionManifest(raw);\n        if (!manifest.id) {\n          console.error(colors.red('error:'), 'Invalid manifest id');\n          process.exit(1);\n        }\n      } catch (e) {\n        console.error(colors.red('error:'), e instanceof Error ? e.message : String(e));\n        process.exit(1);\n      }\n\n      const args = ['publish', `--access=${opts.access}`];\n      if (opts.dryRun) args.push('--dry-run');\n      console.log(colors.cyan('Running:'), `npm ${args.join(' ')}`);\n      try {\n        execSync(`npm ${args.join(' ')}`, { cwd: root, stdio: 'inherit' });\n      } catch {\n        process.exit(1);\n      }\n    });\n}\n\nexport function createExtensionUpdateCommand(): Command {\n  return new Command('extension:update')\n    .alias('ext:update')\n    .description('Re-install extension(s) from npm using the lockfile / registry')\n    .argument('[extensionId]', 'Specific extension id (default: all in lockfile)')\n    .option('--global', 'Use global extensions directory', false)\n    .action(async (extensionId: string | undefined, opts: { global: boolean }) => {\n      const ctx = getContextWithOpts();\n      const cfg = loadConfig(ctx.configPath);\n      const agentId = resolveDefaultAgentId(cfg);\n      const targetDir = opts.global\n        ? resolveExtensionsDir(ctx.workspacePath, true)\n        : resolveWorkspaceExtensionsDir(cfg, agentId);\n\n      const lock = getExtensionLockfileManager();\n      const data = await lock.load();\n      const ids = extensionId?.trim()\n        ? [extensionId.trim()]\n        : Object.keys(data.extensions);\n\n      if (ids.length === 0) {\n        console.log('No extensions in lockfile.');\n        return;\n      }\n\n      for (const id of ids) {\n        const entry = data.extensions[id];\n        if (!entry) {\n          console.log(colors.yellow('skip'), id, '(not in lockfile)');\n          continue;\n        }\n        if (entry.source !== 'npm') {\n          console.log(colors.yellow('skip'), id, `(source ${entry.source})`);\n          continue;\n        }\n        const spec = entry.resolved?.trim() || (await npmPackageForId(id));\n        if (!spec) {\n          console.log(colors.yellow('skip'), id, '(could not resolve npm package)');\n          continue;\n        }\n        console.log(colors.cyan('Updating'), id, '←', spec);\n        const result = await installFromNpm(spec, targetDir);\n        if (!result.ok) {\n          console.error(colors.red('error:'), result.error ?? id);\n          process.exit(1);\n        }\n        console.log(colors.green('✓'), id);\n      }\n    });\n}\n\nasync function npmPackageForId(id: string): Promise<string | undefined> {\n  const found = await marketplace.findExtension(id);\n  return found?.npmPackage;\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/extension-pack.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function createExtensionPackCommand(): Command;

package/dist/src/cli/commands/extension-pack.js

@@ -0,0 +1,242 @@
+import { PACKAGE_VERSION, init_package_version } from "../../package-version.js";
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { normalizeExtensionManifest } from "../../extensions/normalize-manifest.js";
+import { checkEngineCompatibility } from "../../extensions/engine-check.js";
+import { colors } from "../utils/colors.js";
+import { isAbsolute, join, resolve } from "node:path";
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync } from "node:fs";
+import { Command } from "commander";
+import { execSync } from "node:child_process";
+//#region src/cli/commands/extension-pack.ts
+init_package_version();
+init_logger();
+const log = createLogger("ExtensionPack");
+const MANIFEST = "xopc.extension.json";
+function isRecord(x) {
+	return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+function loadJson(path) {
+	return JSON.parse(readFileSync(path, "utf-8"));
+}
+function loadManifestAtRoot(root, diagnostics) {
+	const manifestPath = join(root, MANIFEST);
+	if (!existsSync(manifestPath)) {
+		diagnostics.push({
+			level: "error",
+			message: `Missing ${MANIFEST} in ${root}`
+		});
+		return null;
+	}
+	try {
+		const raw = loadJson(manifestPath);
+		if (!isRecord(raw)) {
+			diagnostics.push({
+				level: "error",
+				message: `${MANIFEST} must be a JSON object`
+			});
+			return null;
+		}
+		return normalizeExtensionManifest(raw);
+	} catch (e) {
+		diagnostics.push({
+			level: "error",
+			message: `Failed to parse ${MANIFEST}: ${e instanceof Error ? e.message : String(e)}`
+		});
+		return null;
+	}
+}
+function collectContributionPaths(manifest, extRoot) {
+	const out = [];
+	const ui = manifest.ui;
+	if (ui?.main) out.push(join(extRoot, ui.main));
+	if (ui?.icon) out.push(join(extRoot, ui.icon));
+	const c = ui?.contributions;
+	if (!c) return out;
+	for (const p of c.sidebarPanels ?? []) if (p.entrypoint) out.push(join(extRoot, p.entrypoint));
+	for (const p of c.settingsPanels ?? []) if (p.entrypoint) out.push(join(extRoot, p.entrypoint));
+	for (const p of c.chatWidgets ?? []) if (p.entrypoint) out.push(join(extRoot, p.entrypoint));
+	for (const p of c.pages ?? []) if (p.entrypoint) out.push(join(extRoot, p.entrypoint));
+	for (const p of c.statusBarItems ?? []) if (p.entrypoint) out.push(join(extRoot, p.entrypoint));
+	return out;
+}
+function resolveMainFile(root, main) {
+	const cands = [
+		main,
+		"index.ts",
+		"index.js",
+		"extension.ts",
+		"extension.js"
+	].filter((x) => typeof x === "string" && x.length > 0);
+	for (const c of cands) {
+		const p = join(root, c);
+		if (existsSync(p)) return p;
+	}
+	return null;
+}
+function validateManifest(ctx) {
+	const { manifest, extensionDir, diagnostics } = ctx;
+	if (!manifest.id || !String(manifest.id).trim()) diagnostics.push({
+		level: "error",
+		message: "Manifest \"id\" is required"
+	});
+	if (!resolveMainFile(extensionDir, manifest.main)) diagnostics.push({
+		level: "error",
+		message: `Main entry not found (expected main, index.ts, index.js, etc. in ${extensionDir})`
+	});
+	if (manifest.ui?.main) {
+		if (!existsSync(join(extensionDir, manifest.ui.main))) diagnostics.push({
+			level: "error",
+			message: `ui.main missing: ${manifest.ui.main}`
+		});
+	}
+	for (const p of collectContributionPaths(manifest, extensionDir)) if (!existsSync(p)) diagnostics.push({
+		level: "error",
+		message: `UI contribution entry missing: ${p}`
+	});
+	if (manifest.engines?.xopc) {
+		const r = checkEngineCompatibility(PACKAGE_VERSION, manifest.engines.xopc);
+		if (r.parseWarning) diagnostics.push({
+			level: "warning",
+			message: `engines.xopc parse issue — ${r.reason ?? "unknown"} (continuing)`
+		});
+		else if (!r.compatible) diagnostics.push({
+			level: "warning",
+			message: `engines.xopc not satisfied by current xopc ${PACKAGE_VERSION}: ${r.reason ?? manifest.engines.xopc}`
+		});
+	}
+}
+function validatePackageJson(ctx) {
+	const { packageJson, diagnostics, extensionDir } = ctx;
+	const deps = packageJson.dependencies;
+	if (isRecord(deps)) {
+		for (const [name, v] of Object.entries(deps)) if (typeof v === "string" && v.startsWith("workspace:")) diagnostics.push({
+			level: "warning",
+			message: `dependency "${name}": ${v} — will be replaced when packing from a pnpm workspace`
+		});
+	}
+	const files = packageJson.files;
+	if (Array.isArray(files)) {
+		if (!files.some((f) => f === MANIFEST || f === "**/xopc.extension.json")) diagnostics.push({
+			level: "warning",
+			message: `package.json "files" should include "${MANIFEST}" so the archive ships the manifest`
+		});
+	}
+	const keywords = packageJson.keywords;
+	if (Array.isArray(keywords) && !keywords.includes("xopc-extension")) diagnostics.push({
+		level: "info",
+		message: "Consider adding \"xopc-extension\" to package.json keywords for discoverability"
+	});
+	else if (!Array.isArray(keywords)) diagnostics.push({
+		level: "info",
+		message: "Consider adding keywords: [\"xopc-extension\", ...]"
+	});
+	if (!existsSync(join(extensionDir, "package.json"))) diagnostics.push({
+		level: "error",
+		message: "package.json is missing"
+	});
+}
+function pnpmAvailable() {
+	try {
+		execSync("pnpm --version", { stdio: "pipe" });
+		return true;
+	} catch {
+		return false;
+	}
+}
+function printDiagnostics(d) {
+	for (const x of d) if (x.level === "error") console.error(`${colors.red("error")}:`, x.message);
+	else if (x.level === "warning") console.log(`${colors.yellow("warning")}:`, x.message);
+	else console.log(`${colors.cyan("info")}:`, x.message);
+}
+function createExtensionPackCommand() {
+	return new Command("extension:pack").alias("ext:pack").description("Package an extension as a .tgz archive for distribution").argument("[dir]", "Extension directory (default: current working directory)", ".").option("--out <dir>", "Output directory for the .tgz (default: extension directory)", "").option("--no-build-ui", "Skip automatic \"npm run build:ui\" when defined").option("--dry-run", "Validate only; do not create an archive", false).action((dir, opts) => {
+		const extensionDir = resolve(dir || ".");
+		const outDir = opts.out && opts.out.length > 0 ? resolve(opts.out) : extensionDir;
+		const diagnostics = [];
+		if (!existsSync(extensionDir) || !existsSync(join(extensionDir, "package.json"))) {
+			console.error(colors.red("error:"), `Not an extension project (no package.json): ${extensionDir}`);
+			process.exit(1);
+		}
+		const manifest = loadManifestAtRoot(extensionDir, diagnostics);
+		if (!manifest) {
+			printDiagnostics(diagnostics);
+			process.exit(1);
+		}
+		let packageJson;
+		try {
+			packageJson = loadJson(join(extensionDir, "package.json"));
+			if (!isRecord(packageJson)) throw new Error("package.json must be an object");
+		} catch (e) {
+			log.error({ err: e }, "Failed to read package.json");
+			console.error(colors.red("error:"), e instanceof Error ? e.message : String(e));
+			process.exit(1);
+		}
+		const ctx = {
+			extensionDir,
+			manifest,
+			packageJson,
+			diagnostics
+		};
+		validateManifest(ctx);
+		validatePackageJson(ctx);
+		printDiagnostics(diagnostics);
+		if (diagnostics.some((d) => d.level === "error")) {
+			console.error(colors.red("Pack validation failed (fix errors above)."));
+			process.exit(1);
+		}
+		if (opts.dryRun) {
+			console.log(colors.green("OK"), " — dry run; no archive created");
+			return;
+		}
+		const scripts = isRecord(packageJson.scripts) ? packageJson.scripts : null;
+		if (opts.buildUi && scripts && typeof scripts["build:ui"] === "string") try {
+			console.log(colors.cyan("Running"), "npm run build:ui …");
+			execSync("npm run build:ui", {
+				cwd: extensionDir,
+				stdio: "inherit"
+			});
+		} catch (e) {
+			console.error(colors.red("error:"), `UI build failed: ${e instanceof Error ? e.message : String(e)}`);
+			process.exit(1);
+		}
+		let tarball;
+		try {
+			const lines = execSync(pnpmAvailable() ? "pnpm pack" : "npm pack", {
+				cwd: extensionDir,
+				encoding: "utf-8"
+			}).split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+			const line = lines.slice().reverse().find((l) => l.endsWith(".tgz") && !l.startsWith("WARN")) ?? lines.at(-1) ?? "";
+			if (line.endsWith(".tgz")) tarball = isAbsolute(line) || line.startsWith("file:") ? resolve(line.replace(/^file:/, "")) : join(extensionDir, line);
+			else tarball = "";
+			if (!tarball) {
+				const tgzs = readdirSync(extensionDir).filter((f) => f.endsWith(".tgz"));
+				tgzs.sort((a, b) => statSync(join(extensionDir, b)).mtimeMs - statSync(join(extensionDir, a)).mtimeMs);
+				const last = tgzs[0];
+				tarball = last ? join(extensionDir, last) : "";
+			}
+			if (!tarball || !existsSync(tarball)) throw new Error("Could not locate .tgz after pack; check pnpm/npm output");
+		} catch (e) {
+			log.error({ err: e }, "pack failed");
+			console.error(colors.red("error:"), e instanceof Error ? e.message : String(e));
+			process.exit(1);
+		}
+		if (outDir !== extensionDir) try {
+			mkdirSync(outDir, { recursive: true });
+			const dest = join(outDir, tarball.includes("/") ? tarball.slice(tarball.lastIndexOf("/") + 1) : tarball);
+			renameSync(tarball, dest);
+			tarball = dest;
+		} catch (e) {
+			console.error(colors.red("error:"), `Failed to move archive to --out: ${e instanceof Error ? e.message : String(e)}`);
+			process.exit(1);
+		}
+		const displayPath = tarball;
+		console.log("");
+		console.log(colors.green("Pack complete:"), displayPath);
+		console.log(colors.cyan("Next:"), "install the .tgz with your extension workflow, or extract into the global / workspace extensions directory.");
+	});
+}
+//#endregion
+export { createExtensionPackCommand };
+
+//# sourceMappingURL=extension-pack.js.map

package/dist/src/cli/commands/extension-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-pack.js","names":[],"sources":["../../../../src/cli/commands/extension-pack.ts"],"sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync, readFileSync, readdirSync, renameSync, mkdirSync, statSync } from 'node:fs';\nimport { isAbsolute, join, resolve } from 'node:path';\n\nimport { Command } from 'commander';\n\nimport { checkEngineCompatibility } from '../../extensions/engine-check.js';\nimport type { ExtensionManifest } from '../../extensions/types/index.js';\nimport { normalizeExtensionManifest } from '../../extensions/normalize-manifest.js';\nimport { PACKAGE_VERSION } from '../../package-version.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { colors } from '../utils/colors.js';\n\nconst log = createLogger('ExtensionPack');\nconst MANIFEST = 'xopc.extension.json';\n\ninterface PackContext {\n  extensionDir: string;\n  manifest: ExtensionManifest;\n  packageJson: Record<string, unknown>;\n  diagnostics: PackDiagnostic[];\n}\n\ninterface PackDiagnostic {\n  level: 'error' | 'warning' | 'info';\n  message: string;\n}\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction loadJson(path: string): unknown {\n  return JSON.parse(readFileSync(path, 'utf-8') as string) as unknown;\n}\n\nfunction loadManifestAtRoot(\n  root: string,\n  diagnostics: PackDiagnostic[],\n): ExtensionManifest | null {\n  const manifestPath = join(root, MANIFEST);\n  if (!existsSync(manifestPath)) {\n    diagnostics.push({ level: 'error', message: `Missing ${MANIFEST} in ${root}` });\n    return null;\n  }\n  try {\n    const raw = loadJson(manifestPath);\n    if (!isRecord(raw)) {\n      diagnostics.push({ level: 'error', message: `${MANIFEST} must be a JSON object` });\n      return null;\n    }\n    return normalizeExtensionManifest(raw);\n  } catch (e) {\n    diagnostics.push({\n      level: 'error',\n      message: `Failed to parse ${MANIFEST}: ${e instanceof Error ? e.message : String(e)}`,\n    });\n    return null;\n  }\n}\n\nfunction collectContributionPaths(manifest: ExtensionManifest, extRoot: string): string[] {\n  const out: string[] = [];\n  const ui = manifest.ui;\n  if (ui?.main) out.push(join(extRoot, ui.main));\n  if (ui?.icon) out.push(join(extRoot, ui.icon));\n  const c = ui?.contributions;\n  if (!c) return out;\n  for (const p of c.sidebarPanels ?? []) {\n    if (p.entrypoint) out.push(join(extRoot, p.entrypoint));\n  }\n  for (const p of c.settingsPanels ?? []) {\n    if (p.entrypoint) out.push(join(extRoot, p.entrypoint));\n  }\n  for (const p of c.chatWidgets ?? []) {\n    if (p.entrypoint) out.push(join(extRoot, p.entrypoint));\n  }\n  for (const p of c.pages ?? []) {\n    if (p.entrypoint) out.push(join(extRoot, p.entrypoint));\n  }\n  for (const p of c.statusBarItems ?? []) {\n    if (p.entrypoint) out.push(join(extRoot, p.entrypoint));\n  }\n  return out;\n}\n\nfunction resolveMainFile(root: string, main?: string): string | null {\n  const cands = [main, 'index.ts', 'index.js', 'extension.ts', 'extension.js'].filter(\n    (x): x is string => typeof x === 'string' && x.length > 0,\n  );\n  for (const c of cands) {\n    const p = join(root, c);\n    if (existsSync(p)) return p;\n  }\n  return null;\n}\n\nfunction validateManifest(ctx: PackContext): void {\n  const { manifest, extensionDir, diagnostics } = ctx;\n  if (!manifest.id || !String(manifest.id).trim()) {\n    diagnostics.push({ level: 'error', message: 'Manifest \"id\" is required' });\n  }\n  const mainFile = resolveMainFile(extensionDir, manifest.main);\n  if (!mainFile) {\n    diagnostics.push({\n      level: 'error',\n      message: `Main entry not found (expected main, index.ts, index.js, etc. in ${extensionDir})`,\n    });\n  }\n\n  if (manifest.ui?.main) {\n    const p = join(extensionDir, manifest.ui.main);\n    if (!existsSync(p)) {\n      diagnostics.push({ level: 'error', message: `ui.main missing: ${manifest.ui.main}` });\n    }\n  }\n\n  for (const p of collectContributionPaths(manifest, extensionDir)) {\n    if (!existsSync(p)) {\n      diagnostics.push({ level: 'error', message: `UI contribution entry missing: ${p}` });\n    }\n  }\n\n  if (manifest.engines?.xopc) {\n    const r = checkEngineCompatibility(PACKAGE_VERSION, manifest.engines.xopc);\n    if (r.parseWarning) {\n      diagnostics.push({\n        level: 'warning',\n        message: `engines.xopc parse issue — ${r.reason ?? 'unknown'} (continuing)`,\n      });\n    } else if (!r.compatible) {\n      diagnostics.push({\n        level: 'warning',\n        message: `engines.xopc not satisfied by current xopc ${PACKAGE_VERSION}: ${r.reason ?? manifest.engines.xopc}`,\n      });\n    }\n  }\n}\n\nfunction validatePackageJson(ctx: PackContext): void {\n  const { packageJson, diagnostics, extensionDir } = ctx;\n  const deps = packageJson.dependencies;\n  if (isRecord(deps)) {\n    for (const [name, v] of Object.entries(deps)) {\n      if (typeof v === 'string' && v.startsWith('workspace:')) {\n        diagnostics.push({\n          level: 'warning',\n          message: `dependency \"${name}\": ${v} — will be replaced when packing from a pnpm workspace`,\n        });\n      }\n    }\n  }\n\n  const files = packageJson.files;\n  if (Array.isArray(files)) {\n    if (!files.some((f) => f === MANIFEST || f === '**/xopc.extension.json')) {\n      diagnostics.push({\n        level: 'warning',\n        message: `package.json \"files\" should include \"${MANIFEST}\" so the archive ships the manifest`,\n      });\n    }\n  }\n\n  const keywords = packageJson.keywords;\n  if (Array.isArray(keywords) && !keywords.includes('xopc-extension')) {\n    diagnostics.push({\n      level: 'info',\n      message: 'Consider adding \"xopc-extension\" to package.json keywords for discoverability',\n    });\n  } else if (!Array.isArray(keywords)) {\n    diagnostics.push({ level: 'info', message: 'Consider adding keywords: [\"xopc-extension\", ...]' });\n  }\n\n  if (!existsSync(join(extensionDir, 'package.json'))) {\n    diagnostics.push({ level: 'error', message: 'package.json is missing' });\n  }\n}\n\nfunction pnpmAvailable(): boolean {\n  try {\n    execSync('pnpm --version', { stdio: 'pipe' });\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction printDiagnostics(d: PackDiagnostic[]): void {\n  for (const x of d) {\n    if (x.level === 'error') {\n      console.error(`${colors.red('error')}:`, x.message);\n    } else if (x.level === 'warning') {\n      console.log(`${colors.yellow('warning')}:`, x.message);\n    } else {\n      console.log(`${colors.cyan('info')}:`, x.message);\n    }\n  }\n}\n\nexport function createExtensionPackCommand(): Command {\n  return new Command('extension:pack')\n    .alias('ext:pack')\n    .description('Package an extension as a .tgz archive for distribution')\n    .argument('[dir]', 'Extension directory (default: current working directory)', '.')\n    .option('--out <dir>', 'Output directory for the .tgz (default: extension directory)', '')\n    .option('--no-build-ui', 'Skip automatic \"npm run build:ui\" when defined')\n    .option('--dry-run', 'Validate only; do not create an archive', false)\n    .action((dir: string, opts: { out?: string; buildUi: boolean; dryRun: boolean }) => {\n      const extensionDir = resolve(dir || '.');\n      const outDir = opts.out && opts.out.length > 0 ? resolve(opts.out) : extensionDir;\n      const diagnostics: PackDiagnostic[] = [];\n      if (!existsSync(extensionDir) || !existsSync(join(extensionDir, 'package.json'))) {\n        console.error(\n          colors.red('error:'),\n          `Not an extension project (no package.json): ${extensionDir}`,\n        );\n        process.exit(1);\n      }\n      const manifest = loadManifestAtRoot(extensionDir, diagnostics);\n      if (!manifest) {\n        printDiagnostics(diagnostics);\n        process.exit(1);\n      }\n\n      let packageJson: Record<string, unknown>;\n      try {\n        packageJson = loadJson(join(extensionDir, 'package.json')) as Record<string, unknown>;\n        if (!isRecord(packageJson)) {\n          throw new Error('package.json must be an object');\n        }\n      } catch (e) {\n        log.error({ err: e }, 'Failed to read package.json');\n        console.error(\n          colors.red('error:'),\n          e instanceof Error ? e.message : String(e),\n        );\n        process.exit(1);\n      }\n\n      const ctx: PackContext = { extensionDir, manifest, packageJson, diagnostics };\n      validateManifest(ctx);\n      validatePackageJson(ctx);\n\n      printDiagnostics(diagnostics);\n\n      const hasError = diagnostics.some((d) => d.level === 'error');\n      if (hasError) {\n        console.error(colors.red('Pack validation failed (fix errors above).'));\n        process.exit(1);\n      }\n\n      if (opts.dryRun) {\n        console.log(colors.green('OK'), ' — dry run; no archive created');\n        return;\n      }\n\n      const scripts = isRecord(packageJson.scripts) ? (packageJson.scripts as Record<string, unknown>) : null;\n      if (opts.buildUi && scripts && typeof scripts['build:ui'] === 'string') {\n        try {\n          console.log(colors.cyan('Running'), 'npm run build:ui …');\n          execSync('npm run build:ui', { cwd: extensionDir, stdio: 'inherit' });\n        } catch (e) {\n          console.error(\n            colors.red('error:'),\n            `UI build failed: ${e instanceof Error ? e.message : String(e)}`,\n          );\n          process.exit(1);\n        }\n      }\n\n      let tarball: string;\n      try {\n        const cmd = pnpmAvailable() ? 'pnpm pack' : 'npm pack';\n        const out = execSync(cmd, { cwd: extensionDir, encoding: 'utf-8' });\n        const lines = out\n          .split(/\\r?\\n/)\n          .map((l) => l.trim())\n          .filter(Boolean);\n        const line = lines\n          .slice()\n          .reverse()\n          .find((l) => l.endsWith('.tgz') && !l.startsWith('WARN')) ?? lines.at(-1) ?? '';\n        if (line.endsWith('.tgz')) {\n          tarball = isAbsolute(line) || line.startsWith('file:') ? resolve(line.replace(/^file:/, '')) : join(extensionDir, line);\n        } else {\n          tarball = '';\n        }\n        if (!tarball) {\n          const tgzs = readdirSync(extensionDir).filter((f) => f.endsWith('.tgz'));\n          tgzs.sort(\n            (a, b) => statSync(join(extensionDir, b)).mtimeMs - statSync(join(extensionDir, a)).mtimeMs,\n          );\n          const last = tgzs[0];\n          tarball = last ? join(extensionDir, last) : '';\n        }\n        if (!tarball || !existsSync(tarball)) {\n          throw new Error('Could not locate .tgz after pack; check pnpm/npm output');\n        }\n      } catch (e) {\n        log.error({ err: e }, 'pack failed');\n        console.error(\n          colors.red('error:'),\n          e instanceof Error ? e.message : String(e),\n        );\n        process.exit(1);\n      }\n\n      if (outDir !== extensionDir) {\n        try {\n          mkdirSync(outDir, { recursive: true });\n          const base = tarball.includes('/') ? tarball.slice(tarball.lastIndexOf('/') + 1) : tarball;\n          const dest = join(outDir, base);\n          renameSync(tarball, dest);\n          tarball = dest;\n        } catch (e) {\n          console.error(\n            colors.red('error:'),\n            `Failed to move archive to --out: ${e instanceof Error ? e.message : String(e)}`,\n          );\n          process.exit(1);\n        }\n      }\n\n      const displayPath = tarball;\n      console.log('');\n      console.log(colors.green('Pack complete:'), displayPath);\n      console.log(\n        colors.cyan('Next:'),\n        'install the .tgz with your extension workflow, or extract into the global / workspace extensions directory.',\n      );\n    });\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/extension.js

@@ -3,6 +3,9 @@ import { init_logger } from "../../utils/logger.js";
 import { colors } from "../utils/colors.js";
 import { getExtensionLockfileManager } from "../../extensions/lockfile.js";
 import { checkAllExtensionsHealth, getExtensionHealthChecker } from "../../extensions/health.js";
+import { createExtensionPackCommand } from "./extension-pack.js";
+import { createExtensionDevCommand } from "./extension-dev.js";
+import { createExtensionPublishCommand, createExtensionSearchCommand, createExtensionUpdateCommand } from "./extension-marketplace.js";
 import { Command } from "commander";
 //#region src/cli/commands/extension.ts
 init_logger();
@@ -125,6 +128,11 @@ Related commands:
   xopc extension:health   Health check               (alias: ext:health)
   xopc extension:verify   Verify integrity           (alias: ext:verify)
   xopc extension:audit    Security audit             (alias: ext:audit)
+  xopc extension:pack     Package extension .tgz     (alias: ext:pack)
+  xopc extension:dev      Dev mode (symlink + optional gateway) (alias: ext:dev)
+  xopc extension:search   Search extension registry   (alias: ext:search)
+  xopc extension:publish  Publish extension to npm    (alias: ext:publish)
+  xopc extension:update   Update installed extensions (alias: ext:update)
 `).action((_opts, cmd) => {
 		cmd.help();
 	}));
@@ -133,6 +141,11 @@ Related commands:
 	program.addCommand(createExtensionHealthCommand());
 	program.addCommand(createExtensionVerifyCommand());
 	program.addCommand(createExtensionAuditCommand());
+	program.addCommand(createExtensionPackCommand());
+	program.addCommand(createExtensionDevCommand());
+	program.addCommand(createExtensionSearchCommand());
+	program.addCommand(createExtensionPublishCommand());
+	program.addCommand(createExtensionUpdateCommand());
 }
 //#endregion
 export { createExtensionAuditCommand, createExtensionFreezeCommand, createExtensionHealthCommand, createExtensionListCommand, createExtensionVerifyCommand, registerExtensionCommands };

package/dist/src/cli/commands/extension.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension.js","names":[],"sources":["../../../../src/cli/commands/extension.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { createLogger } from '../../utils/logger.js';\nimport { getExtensionLockfileManager } from '../../extensions/lockfile.js';\nimport {\n  getExtensionHealthChecker,\n  checkAllExtensionsHealth,\n} from '../../extensions/health.js';\nimport { colors } from '../utils/colors.js';\n\nconst log = createLogger('ExtensionCommands');\n\n// ============================================\n// Extension List Command\n// ============================================\n\nexport function createExtensionListCommand(): Command {\n  return new Command('extension:list')\n    .alias('ext:list')\n    .description('List installed extensions')\n    .option('--json', 'Output as JSON')\n    .action(async (options) => {\n      try {\n        const lockfileManager = getExtensionLockfileManager();\n        const extensions = await lockfileManager.list();\n\n        if (options.json) {\n          console.log(JSON.stringify(extensions, null, 2));\n          return;\n        }\n\n        if (extensions.length === 0) {\n          console.log('No extensions installed.');\n          return;\n        }\n\n        console.log(`Installed extensions (${extensions.length}):`);\n        console.log();\n\n        for (const ext of extensions) {\n          console.log(`${colors.cyan(ext.name)}@${ext.version}`);\n          console.log(`  Source: ${ext.source}`);\n          console.log(`  Resolved: ${ext.resolved}`);\n          console.log(`  Installed: ${new Date(ext.installedAt).toLocaleString()}`);\n          console.log();\n        }\n      } catch (error) {\n        log.error({ error }, 'Failed to list extensions');\n        console.error(colors.red('Error:'), error instanceof Error ? error.message : String(error));\n        process.exit(1);\n      }\n    });\n}\n\n// ============================================\n// Extension Freeze Command\n// ============================================\n\nexport function createExtensionFreezeCommand(): Command {\n  return new Command('extension:freeze')\n    .alias('ext:freeze')\n    .description('Lock current extension versions')\n    .action(async () => {\n      try {\n        const lockfileManager = getExtensionLockfileManager();\n        await lockfileManager.freeze();\n\n        console.log(colors.green('✓'), 'Extension versions locked');\n      } catch (error) {\n        log.error({ error }, 'Failed to freeze extensions');\n        console.error(colors.red('Error:'), error instanceof Error ? error.message : String(error));\n        process.exit(1);\n      }\n    });\n}\n\n// ============================================\n// Extension Health Command\n// ============================================\n\nexport function createExtensionHealthCommand(): Command {\n  return new Command('extension:health')\n    .alias('ext:health')\n    .description('Check extension health')\n    .option('--json', 'Output as JSON')\n    .action(async (options) => {\n      try {\n        const checker = getExtensionHealthChecker();\n        const report = await checkAllExtensionsHealth();\n\n        if (options.json) {\n          console.log(JSON.stringify(report, null, 2));\n          return;\n        }\n\n        console.log(checker.formatReport(report));\n\n        // Exit with error code if there are errors\n        if (report.summary.error > 0) {\n          process.exit(1);\n        }\n      } catch (error) {\n        log.error({ error }, 'Failed to check extension health');\n        console.error(colors.red('Error:'), error instanceof Error ? error.message : String(error));\n        process.exit(1);\n      }\n    });\n}\n\n// ============================================\n// Extension Verify Command\n// ============================================\n\nexport function createExtensionVerifyCommand(): Command {\n  return new Command('extension:verify')\n    .alias('ext:verify')\n    .description('Verify extension integrity')\n    .argument('[extension]', 'Specific extension to verify (default: all)')\n    .action(async (extensionId) => {\n      try {\n        const lockfileManager = getExtensionLockfileManager();\n\n        if (extensionId) {\n          const result = await lockfileManager.verify(extensionId);\n\n          if (result.valid) {\n            console.log(colors.green('✓'), `Extension \"${extensionId}\" is valid`);\n          } else {\n            console.log(colors.red('✗'), `Extension \"${extensionId}\" is invalid: ${result.reason}`);\n            process.exit(1);\n          }\n        } else {\n          const results = await lockfileManager.verifyAll();\n          let hasErrors = false;\n\n          for (const result of results) {\n            if (result.valid) {\n              console.log(colors.green('✓'), result.extensionId);\n            } else {\n              console.log(colors.red('✗'), `${result.extensionId}: ${result.reason}`);\n              hasErrors = true;\n            }\n          }\n\n          if (hasErrors) {\n            process.exit(1);\n          }\n        }\n      } catch (error) {\n        log.error({ error }, 'Failed to verify extensions');\n        console.error(colors.red('Error:'), error instanceof Error ? error.message : String(error));\n        process.exit(1);\n      }\n    });\n}\n\n// ============================================\n// Extension Audit Command\n// ============================================\n\nexport function createExtensionAuditCommand(): Command {\n  return new Command('extension:audit')\n    .alias('ext:audit')\n    .description('Audit extensions for security issues')\n    .action(async () => {\n      try {\n        const checker = getExtensionHealthChecker();\n\n        // Check for orphaned extensions\n        const orphaned = await checker.findOrphaned();\n\n        if (orphaned.length > 0) {\n          console.log(colors.yellow('⚠'), 'Orphaned extensions found:');\n          for (const ext of orphaned) {\n            console.log(`  - ${ext}`);\n          }\n          console.log();\n          console.log('These extensions are installed but not in the lockfile.');\n          console.log('Run `xopc extension:freeze` to add them.');\n        } else {\n          console.log(colors.green('✓'), 'No orphaned extensions found');\n        }\n\n        // Run health check\n        const report = await checkAllExtensionsHealth();\n\n        if (report.summary.error > 0 || report.summary.warning > 0) {\n          console.log();\n          console.log(checker.formatReport(report));\n        } else {\n          console.log(colors.green('✓'), 'All extensions are healthy');\n        }\n      } catch (error) {\n        log.error({ error }, 'Failed to audit extensions');\n        console.error(colors.red('Error:'), error instanceof Error ? error.message : String(error));\n        process.exit(1);\n      }\n    });\n}\n\n// ============================================\n// Register All Commands\n// ============================================\n\nexport function registerExtensionCommands(program: Command): void {\n  program.addCommand(\n    new Command('extension')\n      .description('Extension lockfile and health tools')\n      .addHelpText(\n        'after',\n        `\nRelated commands:\n  xopc extension:list     List installed extensions  (alias: ext:list)\n  xopc extension:freeze   Lock extension versions    (alias: ext:freeze)\n  xopc extension:health   Health check               (alias: ext:health)\n  xopc extension:verify   Verify integrity           (alias: ext:verify)\n  xopc extension:audit    Security audit             (alias: ext:audit)\n`\n      )\n      .action((_opts, cmd) => {\n        cmd.help();\n      })\n  );\n  program.addCommand(createExtensionListCommand());\n  program.addCommand(createExtensionFreezeCommand());\n  program.addCommand(createExtensionHealthCommand());\n  program.addCommand(createExtensionVerifyCommand());\n  program.addCommand(createExtensionAuditCommand());\n}\n"],"mappings":"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"}
+{"version":3,"file":"extension.js","names":[],"sources":["../../../../src/cli/commands/extension.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { createLogger } from '../../utils/logger.js';\nimport { getExtensionLockfileManager } from '../../extensions/lockfile.js';\nimport {\n  getExtensionHealthChecker,\n  checkAllExtensionsHealth,\n} from '../../extensions/health.js';\nimport { colors } from '../utils/colors.js';\nimport { createExtensionPackCommand } from './extension-pack.js';\nimport { createExtensionDevCommand } from './extension-dev.js';\nimport {\n  createExtensionPublishCommand,\n  createExtensionSearchCommand,\n  createExtensionUpdateCommand,\n} from './extension-marketplace.js';\n\nconst log = createLogger('ExtensionCommands');\n\n// ============================================\n// Extension List Command\n// ============================================\n\nexport function createExtensionListCommand(): Command {\n  return new Command('extension:list')\n    .alias('ext:list')\n    .description('List installed extensions')\n    .option('--json', 'Output as JSON')\n    .action(async (options) => {\n      try {\n        const lockfileManager = getExtensionLockfileManager();\n        const extensions = await lockfileManager.list();\n\n        if (options.json) {\n          console.log(JSON.stringify(extensions, null, 2));\n          return;\n        }\n\n        if (extensions.length === 0) {\n          console.log('No extensions installed.');\n          return;\n        }\n\n        console.log(`Installed extensions (${extensions.length}):`);\n        console.log();\n\n        for (const ext of extensions) {\n          console.log(`${colors.cyan(ext.name)}@${ext.version}`);\n          console.log(`  Source: ${ext.source}`);\n          console.log(`  Resolved: ${ext.resolved}`);\n          console.log(`  Installed: ${new Date(ext.installedAt).toLocaleString()}`);\n          console.log();\n        }\n      } catch (error) {\n        log.error({ error }, 'Failed to list extensions');\n        console.error(colors.red('Error:'), error instanceof Error ? error.message : String(error));\n        process.exit(1);\n      }\n    });\n}\n\n// ============================================\n// Extension Freeze Command\n// ============================================\n\nexport function createExtensionFreezeCommand(): Command {\n  return new Command('extension:freeze')\n    .alias('ext:freeze')\n    .description('Lock current extension versions')\n    .action(async () => {\n      try {\n        const lockfileManager = getExtensionLockfileManager();\n        await lockfileManager.freeze();\n\n        console.log(colors.green('✓'), 'Extension versions locked');\n      } catch (error) {\n        log.error({ error }, 'Failed to freeze extensions');\n        console.error(colors.red('Error:'), error instanceof Error ? error.message : String(error));\n        process.exit(1);\n      }\n    });\n}\n\n// ============================================\n// Extension Health Command\n// ============================================\n\nexport function createExtensionHealthCommand(): Command {\n  return new Command('extension:health')\n    .alias('ext:health')\n    .description('Check extension health')\n    .option('--json', 'Output as JSON')\n    .action(async (options) => {\n      try {\n        const checker = getExtensionHealthChecker();\n        const report = await checkAllExtensionsHealth();\n\n        if (options.json) {\n          console.log(JSON.stringify(report, null, 2));\n          return;\n        }\n\n        console.log(checker.formatReport(report));\n\n        // Exit with error code if there are errors\n        if (report.summary.error > 0) {\n          process.exit(1);\n        }\n      } catch (error) {\n        log.error({ error }, 'Failed to check extension health');\n        console.error(colors.red('Error:'), error instanceof Error ? error.message : String(error));\n        process.exit(1);\n      }\n    });\n}\n\n// ============================================\n// Extension Verify Command\n// ============================================\n\nexport function createExtensionVerifyCommand(): Command {\n  return new Command('extension:verify')\n    .alias('ext:verify')\n    .description('Verify extension integrity')\n    .argument('[extension]', 'Specific extension to verify (default: all)')\n    .action(async (extensionId) => {\n      try {\n        const lockfileManager = getExtensionLockfileManager();\n\n        if (extensionId) {\n          const result = await lockfileManager.verify(extensionId);\n\n          if (result.valid) {\n            console.log(colors.green('✓'), `Extension \"${extensionId}\" is valid`);\n          } else {\n            console.log(colors.red('✗'), `Extension \"${extensionId}\" is invalid: ${result.reason}`);\n            process.exit(1);\n          }\n        } else {\n          const results = await lockfileManager.verifyAll();\n          let hasErrors = false;\n\n          for (const result of results) {\n            if (result.valid) {\n              console.log(colors.green('✓'), result.extensionId);\n            } else {\n              console.log(colors.red('✗'), `${result.extensionId}: ${result.reason}`);\n              hasErrors = true;\n            }\n          }\n\n          if (hasErrors) {\n            process.exit(1);\n          }\n        }\n      } catch (error) {\n        log.error({ error }, 'Failed to verify extensions');\n        console.error(colors.red('Error:'), error instanceof Error ? error.message : String(error));\n        process.exit(1);\n      }\n    });\n}\n\n// ============================================\n// Extension Audit Command\n// ============================================\n\nexport function createExtensionAuditCommand(): Command {\n  return new Command('extension:audit')\n    .alias('ext:audit')\n    .description('Audit extensions for security issues')\n    .action(async () => {\n      try {\n        const checker = getExtensionHealthChecker();\n\n        // Check for orphaned extensions\n        const orphaned = await checker.findOrphaned();\n\n        if (orphaned.length > 0) {\n          console.log(colors.yellow('⚠'), 'Orphaned extensions found:');\n          for (const ext of orphaned) {\n            console.log(`  - ${ext}`);\n          }\n          console.log();\n          console.log('These extensions are installed but not in the lockfile.');\n          console.log('Run `xopc extension:freeze` to add them.');\n        } else {\n          console.log(colors.green('✓'), 'No orphaned extensions found');\n        }\n\n        // Run health check\n        const report = await checkAllExtensionsHealth();\n\n        if (report.summary.error > 0 || report.summary.warning > 0) {\n          console.log();\n          console.log(checker.formatReport(report));\n        } else {\n          console.log(colors.green('✓'), 'All extensions are healthy');\n        }\n      } catch (error) {\n        log.error({ error }, 'Failed to audit extensions');\n        console.error(colors.red('Error:'), error instanceof Error ? error.message : String(error));\n        process.exit(1);\n      }\n    });\n}\n\n// ============================================\n// Register All Commands\n// ============================================\n\nexport function registerExtensionCommands(program: Command): void {\n  program.addCommand(\n    new Command('extension')\n      .description('Extension lockfile and health tools')\n      .addHelpText(\n        'after',\n        `\nRelated commands:\n  xopc extension:list     List installed extensions  (alias: ext:list)\n  xopc extension:freeze   Lock extension versions    (alias: ext:freeze)\n  xopc extension:health   Health check               (alias: ext:health)\n  xopc extension:verify   Verify integrity           (alias: ext:verify)\n  xopc extension:audit    Security audit             (alias: ext:audit)\n  xopc extension:pack     Package extension .tgz     (alias: ext:pack)\n  xopc extension:dev      Dev mode (symlink + optional gateway) (alias: ext:dev)\n  xopc extension:search   Search extension registry   (alias: ext:search)\n  xopc extension:publish  Publish extension to npm    (alias: ext:publish)\n  xopc extension:update   Update installed extensions (alias: ext:update)\n`\n      )\n      .action((_opts, cmd) => {\n        cmd.help();\n      })\n  );\n  program.addCommand(createExtensionListCommand());\n  program.addCommand(createExtensionFreezeCommand());\n  program.addCommand(createExtensionHealthCommand());\n  program.addCommand(createExtensionVerifyCommand());\n  program.addCommand(createExtensionAuditCommand());\n  program.addCommand(createExtensionPackCommand());\n  program.addCommand(createExtensionDevCommand());\n  program.addCommand(createExtensionSearchCommand());\n  program.addCommand(createExtensionPublishCommand());\n  program.addCommand(createExtensionUpdateCommand());\n}\n"],"mappings":"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"}

package/dist/src/cli/index.js

@@ -28,7 +28,11 @@ let parsedOpts = {};
 function getContextWithOpts(argv = process.argv) {
 	return createDefaultContext(argv, parsedOpts);
 }
-const LONG_RUNNING_COMMANDS = new Set(["gateway", "agent"]);
+const LONG_RUNNING_COMMANDS = new Set([
+	"gateway",
+	"agent",
+	"extension:dev"
+]);
 const program = new Command().name("xopc").description("Ultra-Lightweight Personal AI Assistant").version(version).option("--verbose", "Enable verbose logging", false).option("--config <path>", "Config file path").option("--workspace <path>", "Workspace directory");
 program.hook("preAction", (thisCommand) => {
 	parsedOpts = thisCommand.opts();