@xopcai/xopc 0.0.6 → 0.0.11

package/dist/src/cli/commands/doctor/checks/version-check.js

@@ -0,0 +1,71 @@
+import { PACKAGE_VERSION, init_package_version } from "../../../../package-version.js";
+//#region src/cli/commands/doctor/checks/version-check.ts
+init_package_version();
+const REGISTRY_URL = "https://registry.npmjs.org/@xopcai/xopc/latest";
+const TIMEOUT_MS = 5e3;
+/** Simple semver: 1 if a > b, -1 if a < b, 0 if equal. */
+function compareSemver(a, b) {
+	const pa = a.split(".").map((x) => parseInt(x, 10) || 0);
+	const pb = b.split(".").map((x) => parseInt(x, 10) || 0);
+	const n = Math.max(pa.length, pb.length);
+	for (let i = 0; i < n; i++) {
+		const da = pa[i] ?? 0;
+		const db = pb[i] ?? 0;
+		if (da > db) return 1;
+		if (da < db) return -1;
+	}
+	return 0;
+}
+async function fetchLatestVersion() {
+	const controller = new AbortController();
+	const t = setTimeout(() => controller.abort(), TIMEOUT_MS);
+	try {
+		const res = await fetch(REGISTRY_URL, {
+			signal: controller.signal,
+			headers: { accept: "application/json" }
+		});
+		if (!res.ok) return null;
+		const data = await res.json();
+		return typeof data.version === "string" ? data.version : null;
+	} catch {
+		return null;
+	} finally {
+		clearTimeout(t);
+	}
+}
+async function checkVersionUpdate(_ctx) {
+	const local = PACKAGE_VERSION.trim() || "0.0.0";
+	const latest = await fetchLatestVersion();
+	if (!latest) return {
+		id: "version-check",
+		label: "Version",
+		status: "skip",
+		message: "Could not query npm for the latest version (offline or registry error).",
+		hints: []
+	};
+	if (compareSemver(latest, local) > 0) return {
+		id: "version-check",
+		label: "Version",
+		status: "warn",
+		message: `Running v${local}; npm latest is v${latest}.`,
+		hints: ["Upgrade: pnpm add -g @xopcai/xopc@latest", "Or: npm i -g @xopcai/xopc@latest"]
+	};
+	if (compareSemver(local, latest) > 0) return {
+		id: "version-check",
+		label: "Version",
+		status: "pass",
+		message: `Running v${local} (ahead of npm registry v${latest}; local/dev build is OK).`,
+		hints: []
+	};
+	return {
+		id: "version-check",
+		label: "Version",
+		status: "pass",
+		message: `Running v${local} (matches npm latest).`,
+		hints: []
+	};
+}
+//#endregion
+export { checkVersionUpdate };
+
+//# sourceMappingURL=version-check.js.map

package/dist/src/cli/commands/doctor/checks/version-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/version-check.ts"],"sourcesContent":["import { PACKAGE_VERSION } from '../../../../package-version.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\nconst REGISTRY_URL = 'https://registry.npmjs.org/@xopcai/xopc/latest';\nconst TIMEOUT_MS = 5000;\n\n/** Simple semver: 1 if a > b, -1 if a < b, 0 if equal. */\nfunction compareSemver(a: string, b: string): number {\n  const pa = a.split('.').map((x) => parseInt(x, 10) || 0);\n  const pb = b.split('.').map((x) => parseInt(x, 10) || 0);\n  const n = Math.max(pa.length, pb.length);\n  for (let i = 0; i < n; i++) {\n    const da = pa[i] ?? 0;\n    const db = pb[i] ?? 0;\n    if (da > db) return 1;\n    if (da < db) return -1;\n  }\n  return 0;\n}\n\nasync function fetchLatestVersion(): Promise<string | null> {\n  const controller = new AbortController();\n  const t = setTimeout(() => controller.abort(), TIMEOUT_MS);\n  try {\n    const res = await fetch(REGISTRY_URL, {\n      signal: controller.signal,\n      headers: { accept: 'application/json' },\n    });\n    if (!res.ok) return null;\n    const data = (await res.json()) as { version?: string };\n    return typeof data.version === 'string' ? data.version : null;\n  } catch {\n    return null;\n  } finally {\n    clearTimeout(t);\n  }\n}\n\nexport async function checkVersionUpdate(_ctx: DoctorContext): Promise<CheckResult> {\n  const local = PACKAGE_VERSION.trim() || '0.0.0';\n  const latest = await fetchLatestVersion();\n  if (!latest) {\n    return {\n      id: 'version-check',\n      label: 'Version',\n      status: 'skip',\n      message: 'Could not query npm for the latest version (offline or registry error).',\n      hints: [],\n    };\n  }\n\n  if (compareSemver(latest, local) > 0) {\n    return {\n      id: 'version-check',\n      label: 'Version',\n      status: 'warn',\n      message: `Running v${local}; npm latest is v${latest}.`,\n      hints: ['Upgrade: pnpm add -g @xopcai/xopc@latest', 'Or: npm i -g @xopcai/xopc@latest'],\n    };\n  }\n\n  if (compareSemver(local, latest) > 0) {\n    return {\n      id: 'version-check',\n      label: 'Version',\n      status: 'pass',\n      message: `Running v${local} (ahead of npm registry v${latest}; local/dev build is OK).`,\n      hints: [],\n    };\n  }\n\n  return {\n    id: 'version-check',\n    label: 'Version',\n    status: 'pass',\n    message: `Running v${local} (matches npm latest).`,\n    hints: [],\n  };\n}\n"],"mappings":";;sBAAiE;AAGjE,MAAM,eAAe;AACrB,MAAM,aAAa;;AAGnB,SAAS,cAAc,GAAW,GAAmB;CACnD,MAAM,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,MAAM,SAAS,GAAG,GAAG,IAAI,EAAE;CACxD,MAAM,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,MAAM,SAAS,GAAG,GAAG,IAAI,EAAE;CACxD,MAAM,IAAI,KAAK,IAAI,GAAG,QAAQ,GAAG,OAAO;AACxC,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,KAAK,GAAG,MAAM;EACpB,MAAM,KAAK,GAAG,MAAM;AACpB,MAAI,KAAK,GAAI,QAAO;AACpB,MAAI,KAAK,GAAI,QAAO;;AAEtB,QAAO;;AAGT,eAAe,qBAA6C;CAC1D,MAAM,aAAa,IAAI,iBAAiB;CACxC,MAAM,IAAI,iBAAiB,WAAW,OAAO,EAAE,WAAW;AAC1D,KAAI;EACF,MAAM,MAAM,MAAM,MAAM,cAAc;GACpC,QAAQ,WAAW;GACnB,SAAS,EAAE,QAAQ,oBAAoB;GACxC,CAAC;AACF,MAAI,CAAC,IAAI,GAAI,QAAO;EACpB,MAAM,OAAQ,MAAM,IAAI,MAAM;AAC9B,SAAO,OAAO,KAAK,YAAY,WAAW,KAAK,UAAU;SACnD;AACN,SAAO;WACC;AACR,eAAa,EAAE;;;AAInB,eAAsB,mBAAmB,MAA2C;CAClF,MAAM,QAAQ,gBAAgB,MAAM,IAAI;CACxC,MAAM,SAAS,MAAM,oBAAoB;AACzC,KAAI,CAAC,OACH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;AAGH,KAAI,cAAc,QAAQ,MAAM,GAAG,EACjC,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,YAAY,MAAM,mBAAmB,OAAO;EACrD,OAAO,CAAC,4CAA4C,mCAAmC;EACxF;AAGH,KAAI,cAAc,OAAO,OAAO,GAAG,EACjC,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,YAAY,MAAM,2BAA2B,OAAO;EAC7D,OAAO,EAAE;EACV;AAGH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,YAAY,MAAM;EAC3B,OAAO,EAAE;EACV"}

package/dist/src/cli/commands/doctor/checks/workspace-status.d.ts

@@ -0,0 +1,2 @@
+import type { CheckResult, DoctorContext } from '../types.js';
+export declare function checkWorkspaceStatus(ctx: DoctorContext): Promise<CheckResult>;

package/dist/src/cli/commands/doctor/checks/workspace-status.js

@@ -0,0 +1,73 @@
+import { init_agent_scope, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../../../../agent/agent-scope.js";
+import { WORKSPACE_FILES, init_paths } from "../../../../config/paths.js";
+import { init_loader, loadConfig } from "../../../../config/loader.js";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+//#region src/cli/commands/doctor/checks/workspace-status.ts
+init_agent_scope();
+init_loader();
+init_paths();
+async function checkWorkspaceStatus(ctx) {
+	if (!existsSync(ctx.configPath)) return {
+		id: "workspace-status",
+		label: "Workspace",
+		status: "skip",
+		message: "No config file; skipped.",
+		hints: []
+	};
+	let config;
+	try {
+		config = loadConfig(ctx.configPath);
+	} catch {
+		return {
+			id: "workspace-status",
+			label: "Workspace",
+			status: "skip",
+			message: "Config could not be loaded; skipped.",
+			hints: []
+		};
+	}
+	const agentId = resolveDefaultAgentId(config);
+	const root = resolveAgentWorkspaceDir(config, agentId);
+	const hints = [];
+	if (!existsSync(root)) return {
+		id: "workspace-status",
+		label: "Workspace",
+		status: "warn",
+		message: "Agent workspace directory is missing.",
+		hints: [root, "Run: xopc onboard"]
+	};
+	const soul = join(root, WORKSPACE_FILES.SOUL);
+	const identity = join(root, WORKSPACE_FILES.IDENTITY);
+	const missing = [];
+	if (!existsSync(soul)) missing.push(WORKSPACE_FILES.SOUL);
+	if (!existsSync(identity)) missing.push(WORKSPACE_FILES.IDENTITY);
+	if (missing.length > 0) return {
+		id: "workspace-status",
+		label: "Workspace",
+		status: "warn",
+		message: `Essential workspace files missing: ${missing.join(", ")}.`,
+		hints: [root, "Run: xopc onboard"]
+	};
+	if (!existsSync(join(root, WORKSPACE_FILES.USER))) hints.push(`${WORKSPACE_FILES.USER} is optional; add a user profile for better context.`);
+	if (!existsSync(join(root, WORKSPACE_FILES.TOOLS))) hints.push(`${WORKSPACE_FILES.TOOLS} is optional; add tool notes if you use many tools.`);
+	if (!existsSync(join(root, ".git"))) hints.push("No .git in workspace; version control is recommended for backup and history.");
+	if (hints.length > 0) return {
+		id: "workspace-status",
+		label: "Workspace",
+		status: "pass",
+		message: "Essential workspace files are present.",
+		hints
+	};
+	return {
+		id: "workspace-status",
+		label: "Workspace",
+		status: "pass",
+		message: "Workspace directory and essential files look good.",
+		hints: [root]
+	};
+}
+//#endregion
+export { checkWorkspaceStatus };
+
+//# sourceMappingURL=workspace-status.js.map

package/dist/src/cli/commands/doctor/checks/workspace-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-status.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/workspace-status.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { resolveDefaultAgentId, resolveAgentWorkspaceDir } from '../../../../agent/agent-scope.js';\nimport { loadConfig } from '../../../../config/loader.js';\nimport { WORKSPACE_FILES } from '../../../../config/paths.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\nexport async function checkWorkspaceStatus(ctx: DoctorContext): Promise<CheckResult> {\n  if (!existsSync(ctx.configPath)) {\n    return {\n      id: 'workspace-status',\n      label: 'Workspace',\n      status: 'skip',\n      message: 'No config file; skipped.',\n      hints: [],\n    };\n  }\n\n  let config;\n  try {\n    config = loadConfig(ctx.configPath);\n  } catch {\n    return {\n      id: 'workspace-status',\n      label: 'Workspace',\n      status: 'skip',\n      message: 'Config could not be loaded; skipped.',\n      hints: [],\n    };\n  }\n\n  const agentId = resolveDefaultAgentId(config);\n  const root = resolveAgentWorkspaceDir(config, agentId);\n  const hints: string[] = [];\n\n  if (!existsSync(root)) {\n    return {\n      id: 'workspace-status',\n      label: 'Workspace',\n      status: 'warn',\n      message: 'Agent workspace directory is missing.',\n      hints: [root, 'Run: xopc onboard'],\n    };\n  }\n\n  const soul = join(root, WORKSPACE_FILES.SOUL);\n  const identity = join(root, WORKSPACE_FILES.IDENTITY);\n  const missing: string[] = [];\n  if (!existsSync(soul)) missing.push(WORKSPACE_FILES.SOUL);\n  if (!existsSync(identity)) missing.push(WORKSPACE_FILES.IDENTITY);\n\n  if (missing.length > 0) {\n    return {\n      id: 'workspace-status',\n      label: 'Workspace',\n      status: 'warn',\n      message: `Essential workspace files missing: ${missing.join(', ')}.`,\n      hints: [root, 'Run: xopc onboard'],\n    };\n  }\n\n  if (!existsSync(join(root, WORKSPACE_FILES.USER))) {\n    hints.push(`${WORKSPACE_FILES.USER} is optional; add a user profile for better context.`);\n  }\n  if (!existsSync(join(root, WORKSPACE_FILES.TOOLS))) {\n    hints.push(`${WORKSPACE_FILES.TOOLS} is optional; add tool notes if you use many tools.`);\n  }\n\n  if (!existsSync(join(root, '.git'))) {\n    hints.push('No .git in workspace; version control is recommended for backup and history.');\n  }\n\n  if (hints.length > 0) {\n    return {\n      id: 'workspace-status',\n      label: 'Workspace',\n      status: 'pass',\n      message: 'Essential workspace files are present.',\n      hints,\n    };\n  }\n\n  return {\n    id: 'workspace-status',\n    label: 'Workspace',\n    status: 'pass',\n    message: 'Workspace directory and essential files look good.',\n    hints: [root],\n  };\n}\n"],"mappings":";;;;;;kBAGmG;aACzC;YACI;AAG9D,eAAsB,qBAAqB,KAA0C;AACnF,KAAI,CAAC,WAAW,IAAI,WAAW,CAC7B,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;CAGH,IAAI;AACJ,KAAI;AACF,WAAS,WAAW,IAAI,WAAW;SAC7B;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,EAAE;GACV;;CAGH,MAAM,UAAU,sBAAsB,OAAO;CAC7C,MAAM,OAAO,yBAAyB,QAAQ,QAAQ;CACtD,MAAM,QAAkB,EAAE;AAE1B,KAAI,CAAC,WAAW,KAAK,CACnB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,MAAM,oBAAoB;EACnC;CAGH,MAAM,OAAO,KAAK,MAAM,gBAAgB,KAAK;CAC7C,MAAM,WAAW,KAAK,MAAM,gBAAgB,SAAS;CACrD,MAAM,UAAoB,EAAE;AAC5B,KAAI,CAAC,WAAW,KAAK,CAAE,SAAQ,KAAK,gBAAgB,KAAK;AACzD,KAAI,CAAC,WAAW,SAAS,CAAE,SAAQ,KAAK,gBAAgB,SAAS;AAEjE,KAAI,QAAQ,SAAS,EACnB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,sCAAsC,QAAQ,KAAK,KAAK,CAAC;EAClE,OAAO,CAAC,MAAM,oBAAoB;EACnC;AAGH,KAAI,CAAC,WAAW,KAAK,MAAM,gBAAgB,KAAK,CAAC,CAC/C,OAAM,KAAK,GAAG,gBAAgB,KAAK,sDAAsD;AAE3F,KAAI,CAAC,WAAW,KAAK,MAAM,gBAAgB,MAAM,CAAC,CAChD,OAAM,KAAK,GAAG,gBAAgB,MAAM,qDAAqD;AAG3F,KAAI,CAAC,WAAW,KAAK,MAAM,OAAO,CAAC,CACjC,OAAM,KAAK,+EAA+E;AAG5F,KAAI,MAAM,SAAS,EACjB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT;EACD;AAGH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,KAAK;EACd"}

package/dist/src/cli/commands/doctor/flow.d.ts

@@ -0,0 +1,9 @@
+import type { CheckResult, DoctorContext } from './types.js';
+/**
+ * Headless data collection — used by both CLI and gateway API.
+ */
+export declare function collectDoctorResults(ctx: DoctorContext): Promise<CheckResult[]>;
+/**
+ * CLI entry point — collect and print.
+ */
+export declare function runDoctor(ctx: DoctorContext): Promise<CheckResult[]>;

package/dist/src/cli/commands/doctor/flow.js

@@ -0,0 +1,51 @@
+import { printJsonResults, printResults } from "./format.js";
+import { checkNodeVersion } from "./checks/node-version.js";
+import { checkConfigHealth } from "./checks/config-health.js";
+import { checkStateIntegrity } from "./checks/state-integrity.js";
+import { checkProviderAuth } from "./checks/provider-auth.js";
+import { checkChannelConfig } from "./checks/channel-config.js";
+import { checkGatewayHealth } from "./checks/gateway-health.js";
+import { checkSessionIntegrity } from "./checks/session-integrity.js";
+import { checkGatewayService } from "./checks/gateway-service.js";
+import { checkSecurityAudit } from "./checks/security-audit.js";
+import { checkWorkspaceStatus } from "./checks/workspace-status.js";
+import { checkCronHealth } from "./checks/cron-health.js";
+import { checkVersionUpdate } from "./checks/version-check.js";
+import { checkChannelPlugins } from "./checks/channel-plugins.js";
+//#region src/cli/commands/doctor/flow.ts
+const DOCTOR_CHECKS = [
+	checkVersionUpdate,
+	checkNodeVersion,
+	checkConfigHealth,
+	checkStateIntegrity,
+	checkProviderAuth,
+	checkChannelConfig,
+	checkSecurityAudit,
+	checkWorkspaceStatus,
+	checkGatewayService,
+	checkGatewayHealth,
+	checkCronHealth,
+	checkSessionIntegrity
+];
+/**
+* Headless data collection — used by both CLI and gateway API.
+*/
+async function collectDoctorResults(ctx) {
+	const results = [];
+	for (const check of DOCTOR_CHECKS) results.push(await check(ctx));
+	results.push(...await checkChannelPlugins(ctx));
+	return results;
+}
+/**
+* CLI entry point — collect and print.
+*/
+async function runDoctor(ctx) {
+	const results = await collectDoctorResults(ctx);
+	if (ctx.options.json) printJsonResults(results);
+	else printResults(results);
+	return results;
+}
+//#endregion
+export { collectDoctorResults, runDoctor };
+
+//# sourceMappingURL=flow.js.map

package/dist/src/cli/commands/doctor/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","names":[],"sources":["../../../../../src/cli/commands/doctor/flow.ts"],"sourcesContent":["import { printJsonResults, printResults } from './format.js';\nimport type { CheckResult, DoctorCheck, DoctorContext } from './types.js';\nimport { checkNodeVersion } from './checks/node-version.js';\nimport { checkConfigHealth } from './checks/config-health.js';\nimport { checkStateIntegrity } from './checks/state-integrity.js';\nimport { checkProviderAuth } from './checks/provider-auth.js';\nimport { checkChannelConfig } from './checks/channel-config.js';\nimport { checkGatewayHealth } from './checks/gateway-health.js';\nimport { checkSessionIntegrity } from './checks/session-integrity.js';\nimport { checkGatewayService } from './checks/gateway-service.js';\nimport { checkSecurityAudit } from './checks/security-audit.js';\nimport { checkWorkspaceStatus } from './checks/workspace-status.js';\nimport { checkCronHealth } from './checks/cron-health.js';\nimport { checkVersionUpdate } from './checks/version-check.js';\nimport { checkChannelPlugins } from './checks/channel-plugins.js';\n\nconst DOCTOR_CHECKS: DoctorCheck[] = [\n  checkVersionUpdate,\n  checkNodeVersion,\n  checkConfigHealth,\n  checkStateIntegrity,\n  checkProviderAuth,\n  checkChannelConfig,\n  checkSecurityAudit,\n  checkWorkspaceStatus,\n  checkGatewayService,\n  checkGatewayHealth,\n  checkCronHealth,\n  checkSessionIntegrity,\n];\n\n/**\n * Headless data collection — used by both CLI and gateway API.\n */\nexport async function collectDoctorResults(ctx: DoctorContext): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  for (const check of DOCTOR_CHECKS) {\n    results.push(await check(ctx));\n  }\n\n  results.push(...(await checkChannelPlugins(ctx)));\n\n  return results;\n}\n\n/**\n * CLI entry point — collect and print.\n */\nexport async function runDoctor(ctx: DoctorContext): Promise<CheckResult[]> {\n  const results = await collectDoctorResults(ctx);\n\n  if (ctx.options.json) {\n    printJsonResults(results);\n  } else {\n    printResults(results);\n  }\n\n  return results;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,MAAM,gBAA+B;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;AAKD,eAAsB,qBAAqB,KAA4C;CACrF,MAAM,UAAyB,EAAE;AAEjC,MAAK,MAAM,SAAS,cAClB,SAAQ,KAAK,MAAM,MAAM,IAAI,CAAC;AAGhC,SAAQ,KAAK,GAAI,MAAM,oBAAoB,IAAI,CAAE;AAEjD,QAAO;;;;;AAMT,eAAsB,UAAU,KAA4C;CAC1E,MAAM,UAAU,MAAM,qBAAqB,IAAI;AAE/C,KAAI,IAAI,QAAQ,KACd,kBAAiB,QAAQ;KAEzB,cAAa,QAAQ;AAGvB,QAAO"}

package/dist/src/cli/commands/doctor/format.d.ts

@@ -0,0 +1,6 @@
+import type { CheckResult } from './types.js';
+export declare function formatCheckLine(result: CheckResult): string;
+export declare function formatHints(hints: string[]): string[];
+export declare function printSummary(results: CheckResult[]): void;
+export declare function printResults(results: CheckResult[]): void;
+export declare function printJsonResults(results: CheckResult[]): void;

package/dist/src/cli/commands/doctor/format.js

@@ -0,0 +1,61 @@
+import { colors } from "../../utils/colors.js";
+//#region src/cli/commands/doctor/format.ts
+const STATUS_ICONS = {
+	pass: "✓",
+	warn: "⚠",
+	fail: "✗",
+	skip: "–"
+};
+function statusColor(status, text) {
+	switch (status) {
+		case "pass": return colors.green(text);
+		case "warn": return colors.yellow(text);
+		case "fail": return colors.red(text);
+		default: return colors.gray(text);
+	}
+}
+function formatCheckLine(result) {
+	const icon = STATUS_ICONS[result.status];
+	const fixed = result.fixed ? " " + colors.cyan("[fixed]") : "";
+	return `  ${statusColor(result.status, icon)} ${result.label}: ${result.message}${fixed}`;
+}
+function formatHints(hints) {
+	return hints.map((h) => `    ${colors.gray("→")} ${h}`);
+}
+function printSummary(results) {
+	const passed = results.filter((r) => r.status === "pass").length;
+	const warnings = results.filter((r) => r.status === "warn").length;
+	const failed = results.filter((r) => r.status === "fail").length;
+	const skipped = results.filter((r) => r.status === "skip").length;
+	console.log("");
+	console.log(colors.bold(`${passed} passed, ${warnings} warnings, ${failed} failed` + (skipped ? `, ${skipped} skipped` : "")));
+}
+function printResults(results) {
+	console.log("");
+	console.log(colors.bold("xopc doctor"));
+	console.log("");
+	for (const r of results) {
+		console.log(formatCheckLine(r));
+		for (const line of formatHints(r.hints)) console.log(line);
+	}
+	printSummary(results);
+	console.log("");
+}
+function printJsonResults(results) {
+	const payload = {
+		ok: results.every((r) => r.status !== "fail"),
+		checks: results.map((r) => ({
+			id: r.id,
+			label: r.label,
+			status: r.status,
+			message: r.message,
+			hints: r.hints,
+			fixed: r.fixed ?? false
+		}))
+	};
+	console.log(JSON.stringify(payload, null, 2));
+}
+//#endregion
+export { formatCheckLine, formatHints, printJsonResults, printResults, printSummary };
+
+//# sourceMappingURL=format.js.map

package/dist/src/cli/commands/doctor/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","names":[],"sources":["../../../../../src/cli/commands/doctor/format.ts"],"sourcesContent":["import { colors } from '../../utils/colors.js';\nimport type { CheckResult, CheckStatus } from './types.js';\n\nconst STATUS_ICONS: Record<CheckStatus, string> = {\n  pass: '✓',\n  warn: '⚠',\n  fail: '✗',\n  skip: '–',\n};\n\nfunction statusColor(status: CheckStatus, text: string): string {\n  switch (status) {\n    case 'pass':\n      return colors.green(text);\n    case 'warn':\n      return colors.yellow(text);\n    case 'fail':\n      return colors.red(text);\n    default:\n      return colors.gray(text);\n  }\n}\n\nexport function formatCheckLine(result: CheckResult): string {\n  const icon = STATUS_ICONS[result.status];\n  const fixed = result.fixed ? ' ' + colors.cyan('[fixed]') : '';\n  return `  ${statusColor(result.status, icon)} ${result.label}: ${result.message}${fixed}`;\n}\n\nexport function formatHints(hints: string[]): string[] {\n  return hints.map((h) => `    ${colors.gray('→')} ${h}`);\n}\n\nexport function printSummary(results: CheckResult[]): void {\n  const passed = results.filter((r) => r.status === 'pass').length;\n  const warnings = results.filter((r) => r.status === 'warn').length;\n  const failed = results.filter((r) => r.status === 'fail').length;\n  const skipped = results.filter((r) => r.status === 'skip').length;\n  console.log('');\n  console.log(\n    colors.bold(\n      `${passed} passed, ${warnings} warnings, ${failed} failed` +\n        (skipped ? `, ${skipped} skipped` : ''),\n    ),\n  );\n}\n\nexport function printResults(results: CheckResult[]): void {\n  console.log('');\n  console.log(colors.bold('xopc doctor'));\n  console.log('');\n  for (const r of results) {\n    console.log(formatCheckLine(r));\n    for (const line of formatHints(r.hints)) {\n      console.log(line);\n    }\n  }\n  printSummary(results);\n  console.log('');\n}\n\nexport function printJsonResults(results: CheckResult[]): void {\n  const ok = results.every((r) => r.status !== 'fail');\n  const payload = {\n    ok,\n    checks: results.map((r) => ({\n      id: r.id,\n      label: r.label,\n      status: r.status,\n      message: r.message,\n      hints: r.hints,\n      fixed: r.fixed ?? false,\n    })),\n  };\n  console.log(JSON.stringify(payload, null, 2));\n}\n"],"mappings":";;AAGA,MAAM,eAA4C;CAChD,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACP;AAED,SAAS,YAAY,QAAqB,MAAsB;AAC9D,SAAQ,QAAR;EACE,KAAK,OACH,QAAO,OAAO,MAAM,KAAK;EAC3B,KAAK,OACH,QAAO,OAAO,OAAO,KAAK;EAC5B,KAAK,OACH,QAAO,OAAO,IAAI,KAAK;EACzB,QACE,QAAO,OAAO,KAAK,KAAK;;;AAI9B,SAAgB,gBAAgB,QAA6B;CAC3D,MAAM,OAAO,aAAa,OAAO;CACjC,MAAM,QAAQ,OAAO,QAAQ,MAAM,OAAO,KAAK,UAAU,GAAG;AAC5D,QAAO,KAAK,YAAY,OAAO,QAAQ,KAAK,CAAC,GAAG,OAAO,MAAM,IAAI,OAAO,UAAU;;AAGpF,SAAgB,YAAY,OAA2B;AACrD,QAAO,MAAM,KAAK,MAAM,OAAO,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI;;AAGzD,SAAgB,aAAa,SAA8B;CACzD,MAAM,SAAS,QAAQ,QAAQ,MAAM,EAAE,WAAW,OAAO,CAAC;CAC1D,MAAM,WAAW,QAAQ,QAAQ,MAAM,EAAE,WAAW,OAAO,CAAC;CAC5D,MAAM,SAAS,QAAQ,QAAQ,MAAM,EAAE,WAAW,OAAO,CAAC;CAC1D,MAAM,UAAU,QAAQ,QAAQ,MAAM,EAAE,WAAW,OAAO,CAAC;AAC3D,SAAQ,IAAI,GAAG;AACf,SAAQ,IACN,OAAO,KACL,GAAG,OAAO,WAAW,SAAS,aAAa,OAAO,YAC/C,UAAU,KAAK,QAAQ,YAAY,IACvC,CACF;;AAGH,SAAgB,aAAa,SAA8B;AACzD,SAAQ,IAAI,GAAG;AACf,SAAQ,IAAI,OAAO,KAAK,cAAc,CAAC;AACvC,SAAQ,IAAI,GAAG;AACf,MAAK,MAAM,KAAK,SAAS;AACvB,UAAQ,IAAI,gBAAgB,EAAE,CAAC;AAC/B,OAAK,MAAM,QAAQ,YAAY,EAAE,MAAM,CACrC,SAAQ,IAAI,KAAK;;AAGrB,cAAa,QAAQ;AACrB,SAAQ,IAAI,GAAG;;AAGjB,SAAgB,iBAAiB,SAA8B;CAE7D,MAAM,UAAU;EACd,IAFS,QAAQ,OAAO,MAAM,EAAE,WAAW,OAAO;EAGlD,QAAQ,QAAQ,KAAK,OAAO;GAC1B,IAAI,EAAE;GACN,OAAO,EAAE;GACT,QAAQ,EAAE;GACV,SAAS,EAAE;GACX,OAAO,EAAE;GACT,OAAO,EAAE,SAAS;GACnB,EAAE;EACJ;AACD,SAAQ,IAAI,KAAK,UAAU,SAAS,MAAM,EAAE,CAAC"}

package/dist/src/cli/commands/doctor/index.js

@@ -0,0 +1,44 @@
+import { init_paths_state, resolveStateDir } from "../../../config/paths-state.js";
+import { formatExamples, register } from "../../registry.js";
+import { runDoctor } from "./flow.js";
+import { Command } from "commander";
+//#region src/cli/commands/doctor/index.ts
+init_paths_state();
+function createDoctorCommand(ctx) {
+	return new Command("doctor").description("Check xopc installation health and diagnose common issues").option("--fix", "Automatically apply safe fixes", false).option("--json", "Output results as JSON", false).option("--deep", "Run deeper / slower checks (e.g. session scan)", false).addHelpText("after", formatExamples([
+		"xopc doctor",
+		"xopc doctor --json",
+		"xopc doctor --deep",
+		"xopc doctor --fix"
+	])).action(async (opts) => {
+		const configPath = ctx.configPath;
+		if ((await runDoctor({
+			configPath,
+			stateDir: resolveStateDir(),
+			options: {
+				fix: Boolean(opts.fix),
+				json: Boolean(opts.json),
+				deep: Boolean(opts.deep)
+			}
+		})).some((r) => r.status === "fail")) process.exitCode = 1;
+	});
+}
+register({
+	id: "doctor",
+	name: "doctor",
+	description: "Check xopc installation health and diagnose common issues",
+	factory: createDoctorCommand,
+	metadata: {
+		category: "maintenance",
+		examples: [
+			"xopc doctor",
+			"xopc doctor --json",
+			"xopc doctor --deep",
+			"xopc doctor --fix"
+		]
+	}
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=index.js.map

package/dist/src/cli/commands/doctor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/cli/commands/doctor/index.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { register, formatExamples, type CLIContext } from '../../registry.js';\nimport { resolveStateDir } from '../../../config/paths-state.js';\nimport { runDoctor } from './flow.js';\nimport type { DoctorOptions } from './types.js';\n\nfunction createDoctorCommand(ctx: CLIContext): Command {\n  return new Command('doctor')\n    .description('Check xopc installation health and diagnose common issues')\n    .option('--fix', 'Automatically apply safe fixes', false)\n    .option('--json', 'Output results as JSON', false)\n    .option('--deep', 'Run deeper / slower checks (e.g. session scan)', false)\n    .addHelpText(\n      'after',\n      formatExamples(['xopc doctor', 'xopc doctor --json', 'xopc doctor --deep', 'xopc doctor --fix']),\n    )\n    .action(async (opts: DoctorOptions) => {\n      const configPath = ctx.configPath;\n      const stateDir = resolveStateDir();\n      const results = await runDoctor({\n        configPath,\n        stateDir,\n        options: {\n          fix: Boolean(opts.fix),\n          json: Boolean(opts.json),\n          deep: Boolean(opts.deep),\n        },\n      });\n      const failed = results.some((r) => r.status === 'fail');\n      if (failed) {\n        process.exitCode = 1;\n      }\n    });\n}\n\nregister({\n  id: 'doctor',\n  name: 'doctor',\n  description: 'Check xopc installation health and diagnose common issues',\n  factory: createDoctorCommand,\n  metadata: {\n    category: 'maintenance',\n    examples: ['xopc doctor', 'xopc doctor --json', 'xopc doctor --deep', 'xopc doctor --fix'],\n  },\n});\n"],"mappings":";;;;;kBAEiE;AAIjE,SAAS,oBAAoB,KAA0B;AACrD,QAAO,IAAI,QAAQ,SAAS,CACzB,YAAY,4DAA4D,CACxE,OAAO,SAAS,kCAAkC,MAAM,CACxD,OAAO,UAAU,0BAA0B,MAAM,CACjD,OAAO,UAAU,kDAAkD,MAAM,CACzE,YACC,SACA,eAAe;EAAC;EAAe;EAAsB;EAAsB;EAAoB,CAAC,CACjG,CACA,OAAO,OAAO,SAAwB;EACrC,MAAM,aAAa,IAAI;AAYvB,OAVgB,MAAM,UAAU;GAC9B;GACA,UAHe,iBAAiB;GAIhC,SAAS;IACP,KAAK,QAAQ,KAAK,IAAI;IACtB,MAAM,QAAQ,KAAK,KAAK;IACxB,MAAM,QAAQ,KAAK,KAAK;IACzB;GACF,CAAC,EACqB,MAAM,MAAM,EAAE,WAAW,OAAO,CAErD,SAAQ,WAAW;GAErB;;AAGN,SAAS;CACP,IAAI;CACJ,MAAM;CACN,aAAa;CACb,SAAS;CACT,UAAU;EACR,UAAU;EACV,UAAU;GAAC;GAAe;GAAsB;GAAsB;GAAoB;EAC3F;CACF,CAAC"}

package/dist/src/cli/commands/doctor/types.d.ts

@@ -0,0 +1,20 @@
+export type CheckStatus = 'pass' | 'warn' | 'fail' | 'skip';
+export interface CheckResult {
+    id: string;
+    label: string;
+    status: CheckStatus;
+    message: string;
+    hints: string[];
+    fixed?: boolean;
+}
+export interface DoctorOptions {
+    fix: boolean;
+    json: boolean;
+    deep: boolean;
+}
+export interface DoctorContext {
+    configPath: string;
+    stateDir: string;
+    options: DoctorOptions;
+}
+export type DoctorCheck = (ctx: DoctorContext) => Promise<CheckResult>;

package/dist/src/cli/commands/doctor/types.js

@@ -0,0 +1 @@
+export {};

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

@@ -118,6 +118,16 @@ function createExtensionAuditCommand() {
 	});
 }
 function registerExtensionCommands(program) {
+	program.addCommand(new Command("extension").description("Extension lockfile and health tools").addHelpText("after", `
+Related commands:
+  xopc extension:list     List installed extensions  (alias: ext:list)
+  xopc extension:freeze   Lock extension versions    (alias: ext:freeze)
+  xopc extension:health   Health check               (alias: ext:health)
+  xopc extension:verify   Verify integrity           (alias: ext:verify)
+  xopc extension:audit    Security audit             (alias: ext:audit)
+`).action((_opts, cmd) => {
+		cmd.help();
+	}));
 	program.addCommand(createExtensionListCommand());
 	program.addCommand(createExtensionFreezeCommand());
 	program.addCommand(createExtensionHealthCommand());

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(createExtensionListCommand());\n  program.addCommand(createExtensionFreezeCommand());\n  program.addCommand(createExtensionHealthCommand());\n  program.addCommand(createExtensionVerifyCommand());\n  program.addCommand(createExtensionAuditCommand());\n}\n"],"mappings":";;;;;;;aACqD;AAQrD,MAAM,MAAM,aAAa,oBAAoB;AAM7C,SAAgB,6BAAsC;AACpD,QAAO,IAAI,QAAQ,iBAAiB,CACjC,MAAM,WAAW,CACjB,YAAY,4BAA4B,CACxC,OAAO,UAAU,iBAAiB,CAClC,OAAO,OAAO,YAAY;AACzB,MAAI;GAEF,MAAM,aAAa,MADK,6BAA6B,CACZ,MAAM;AAE/C,OAAI,QAAQ,MAAM;AAChB,YAAQ,IAAI,KAAK,UAAU,YAAY,MAAM,EAAE,CAAC;AAChD;;AAGF,OAAI,WAAW,WAAW,GAAG;AAC3B,YAAQ,IAAI,2BAA2B;AACvC;;AAGF,WAAQ,IAAI,yBAAyB,WAAW,OAAO,IAAI;AAC3D,WAAQ,KAAK;AAEb,QAAK,MAAM,OAAO,YAAY;AAC5B,YAAQ,IAAI,GAAG,OAAO,KAAK,IAAI,KAAK,CAAC,GAAG,IAAI,UAAU;AACtD,YAAQ,IAAI,aAAa,IAAI,SAAS;AACtC,YAAQ,IAAI,eAAe,IAAI,WAAW;AAC1C,YAAQ,IAAI,gBAAgB,IAAI,KAAK,IAAI,YAAY,CAAC,gBAAgB,GAAG;AACzE,YAAQ,KAAK;;WAER,OAAO;AACd,OAAI,MAAM,EAAE,OAAO,EAAE,4BAA4B;AACjD,WAAQ,MAAM,OAAO,IAAI,SAAS,EAAE,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;AAC3F,WAAQ,KAAK,EAAE;;GAEjB;;AAON,SAAgB,+BAAwC;AACtD,QAAO,IAAI,QAAQ,mBAAmB,CACnC,MAAM,aAAa,CACnB,YAAY,kCAAkC,CAC9C,OAAO,YAAY;AAClB,MAAI;AAEF,SADwB,6BAA6B,CAC/B,QAAQ;AAE9B,WAAQ,IAAI,OAAO,MAAM,IAAI,EAAE,4BAA4B;WACpD,OAAO;AACd,OAAI,MAAM,EAAE,OAAO,EAAE,8BAA8B;AACnD,WAAQ,MAAM,OAAO,IAAI,SAAS,EAAE,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;AAC3F,WAAQ,KAAK,EAAE;;GAEjB;;AAON,SAAgB,+BAAwC;AACtD,QAAO,IAAI,QAAQ,mBAAmB,CACnC,MAAM,aAAa,CACnB,YAAY,yBAAyB,CACrC,OAAO,UAAU,iBAAiB,CAClC,OAAO,OAAO,YAAY;AACzB,MAAI;GACF,MAAM,UAAU,2BAA2B;GAC3C,MAAM,SAAS,MAAM,0BAA0B;AAE/C,OAAI,QAAQ,MAAM;AAChB,YAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,EAAE,CAAC;AAC5C;;AAGF,WAAQ,IAAI,QAAQ,aAAa,OAAO,CAAC;AAGzC,OAAI,OAAO,QAAQ,QAAQ,EACzB,SAAQ,KAAK,EAAE;WAEV,OAAO;AACd,OAAI,MAAM,EAAE,OAAO,EAAE,mCAAmC;AACxD,WAAQ,MAAM,OAAO,IAAI,SAAS,EAAE,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;AAC3F,WAAQ,KAAK,EAAE;;GAEjB;;AAON,SAAgB,+BAAwC;AACtD,QAAO,IAAI,QAAQ,mBAAmB,CACnC,MAAM,aAAa,CACnB,YAAY,6BAA6B,CACzC,SAAS,eAAe,8CAA8C,CACtE,OAAO,OAAO,gBAAgB;AAC7B,MAAI;GACF,MAAM,kBAAkB,6BAA6B;AAErD,OAAI,aAAa;IACf,MAAM,SAAS,MAAM,gBAAgB,OAAO,YAAY;AAExD,QAAI,OAAO,MACT,SAAQ,IAAI,OAAO,MAAM,IAAI,EAAE,cAAc,YAAY,YAAY;SAChE;AACL,aAAQ,IAAI,OAAO,IAAI,IAAI,EAAE,cAAc,YAAY,gBAAgB,OAAO,SAAS;AACvF,aAAQ,KAAK,EAAE;;UAEZ;IACL,MAAM,UAAU,MAAM,gBAAgB,WAAW;IACjD,IAAI,YAAY;AAEhB,SAAK,MAAM,UAAU,QACnB,KAAI,OAAO,MACT,SAAQ,IAAI,OAAO,MAAM,IAAI,EAAE,OAAO,YAAY;SAC7C;AACL,aAAQ,IAAI,OAAO,IAAI,IAAI,EAAE,GAAG,OAAO,YAAY,IAAI,OAAO,SAAS;AACvE,iBAAY;;AAIhB,QAAI,UACF,SAAQ,KAAK,EAAE;;WAGZ,OAAO;AACd,OAAI,MAAM,EAAE,OAAO,EAAE,8BAA8B;AACnD,WAAQ,MAAM,OAAO,IAAI,SAAS,EAAE,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;AAC3F,WAAQ,KAAK,EAAE;;GAEjB;;AAON,SAAgB,8BAAuC;AACrD,QAAO,IAAI,QAAQ,kBAAkB,CAClC,MAAM,YAAY,CAClB,YAAY,uCAAuC,CACnD,OAAO,YAAY;AAClB,MAAI;GACF,MAAM,UAAU,2BAA2B;GAG3C,MAAM,WAAW,MAAM,QAAQ,cAAc;AAE7C,OAAI,SAAS,SAAS,GAAG;AACvB,YAAQ,IAAI,OAAO,OAAO,IAAI,EAAE,6BAA6B;AAC7D,SAAK,MAAM,OAAO,SAChB,SAAQ,IAAI,OAAO,MAAM;AAE3B,YAAQ,KAAK;AACb,YAAQ,IAAI,0DAA0D;AACtE,YAAQ,IAAI,2CAA2C;SAEvD,SAAQ,IAAI,OAAO,MAAM,IAAI,EAAE,+BAA+B;GAIhE,MAAM,SAAS,MAAM,0BAA0B;AAE/C,OAAI,OAAO,QAAQ,QAAQ,KAAK,OAAO,QAAQ,UAAU,GAAG;AAC1D,YAAQ,KAAK;AACb,YAAQ,IAAI,QAAQ,aAAa,OAAO,CAAC;SAEzC,SAAQ,IAAI,OAAO,MAAM,IAAI,EAAE,6BAA6B;WAEvD,OAAO;AACd,OAAI,MAAM,EAAE,OAAO,EAAE,6BAA6B;AAClD,WAAQ,MAAM,OAAO,IAAI,SAAS,EAAE,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;AAC3F,WAAQ,KAAK,EAAE;;GAEjB;;AAON,SAAgB,0BAA0B,SAAwB;AAChE,SAAQ,WAAW,4BAA4B,CAAC;AAChD,SAAQ,WAAW,8BAA8B,CAAC;AAClD,SAAQ,WAAW,8BAA8B,CAAC;AAClD,SAAQ,WAAW,8BAA8B,CAAC;AAClD,SAAQ,WAAW,6BAA6B,CAAC"}
+{"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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"}

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

@@ -4,9 +4,9 @@ import { resolveStateDir } from "../../config/paths-state.js";
 import { resolveAgentBootstrapDir, resolveAgentWorkspaceDir } from "../../agent/agent-scope.js";
 import { WORKSPACE_FILES, init_paths, resolveAgentDir, resolveAgentHomeDir, resolveAgentMetadataPath, resolveBinDir, resolveConfigPath, resolveCredentialsDir, resolveCronDir, resolveExtensionsDir, resolveInboxDir, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogsDir, resolveSessionsDir, resolveSkillsDir, resolveToolsDir, resolveWorkspaceStateDir, resolveWorkspaceStatePath } from "../../config/paths.js";
 import { init_loader, loadConfig, saveConfig } from "../../config/loader.js";
+import { mkdir, writeFile } from "fs/promises";
 import { join } from "path";
 import { existsSync } from "fs";
-import { mkdir, writeFile } from "fs/promises";
 //#region src/cli/commands/init.ts
 init_logger();
 init_paths();
@@ -94,7 +94,6 @@ async function initCommand(options = {}) {
 * Create default workspace files for an agent
 */
 async function createWorkspaceFiles(cfg, agentId) {
-	resolveAgentWorkspaceDir(cfg, agentId);
 	const bootstrapDir = resolveAgentBootstrapDir(cfg, agentId);
 	await mkdir(bootstrapDir, { recursive: true });
 	const soulPath = join(bootstrapDir, WORKSPACE_FILES.SOUL);

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

@@ -1 +1 @@
-{"version":3,"file":"init.js","names":[],"sources":["../../../../src/cli/commands/init.ts"],"sourcesContent":["import { mkdir, writeFile } from 'fs/promises';\nimport { existsSync } from 'fs';\nimport { join } from 'path';\nimport { createLogger } from '../../utils/logger.js';\nimport {\n  resolveStateDir,\n  resolveCredentialsDir,\n  resolveExtensionsDir,\n  resolveSkillsDir,\n  resolveCronDir,\n  resolveLogsDir,\n  resolveBinDir,\n  resolveToolsDir,\n  resolveAgentDir,\n  resolveAgentWorkspaceDir,\n  resolveSessionsDir,\n  resolveInboxDir,\n  resolveConfigPath,\n  resolveAgentMetadataPath,\n  resolveInboxPendingDir,\n  resolveInboxProcessedDir,\n  resolveAgentHomeDir,\n  resolveAgentBootstrapDir,\n  resolveWorkspaceStateDir,\n  resolveWorkspaceStatePath,\n  WORKSPACE_FILES,\n  FILENAMES,\n} from '../../config/paths.js';\nimport { loadConfig, saveConfig } from '../../config/loader.js';\nimport type { Config } from '../../config/schema.js';\n\nconst log = createLogger('InitCommand');\n\nexport interface InitOptions {\n  /** Force re-initialization even if already initialized */\n  force?: boolean;\n  /** Skip creating workspace files */\n  skipWorkspace?: boolean;\n  /** Agent ID to initialize (default: main) */\n  agentId?: string;\n}\n\n/**\n * Initialize xopc state directory structure\n * Creates all necessary directories and initial config files\n */\nexport async function initCommand(options: InitOptions = {}): Promise<void> {\n  const stateDir = resolveStateDir();\n  const agentId = options.agentId || 'main';\n\n  log.info({ stateDir, agentId }, 'Initializing xopc Agent OS');\n\n  // Check if already initialized\n  if (existsSync(stateDir) && !options.force) {\n    const configPath = resolveConfigPath();\n    if (existsSync(configPath)) {\n      log.info('xopc is already initialized. Use --force to reinitialize.');\n      return;\n    }\n  }\n\n  // ============================================\n  // Create global directories\n  // ============================================\n  await mkdir(stateDir, { recursive: true });\n  await mkdir(resolveCredentialsDir(), { recursive: true });\n  await mkdir(join(resolveCredentialsDir(), 'oauth'), { recursive: true });\n  await mkdir(resolveExtensionsDir(), { recursive: true });\n  await mkdir(resolveSkillsDir(), { recursive: true });\n  await mkdir(resolveCronDir(), { recursive: true });\n  await mkdir(join(resolveCronDir(), 'logs'), { recursive: true });\n  await mkdir(resolveLogsDir(), { recursive: true });\n  await mkdir(resolveBinDir(), { recursive: true });\n  await mkdir(resolveToolsDir(), { recursive: true });\n\n  const configPath = resolveConfigPath();\n  const cfg = loadConfig(configPath);\n\n  // ============================================\n  // Create agent directory structure: agents/<id>/{sessions,agent/}, workspace aside\n  // ============================================\n  await mkdir(resolveAgentHomeDir(cfg, agentId), { recursive: true });\n  await mkdir(resolveSessionsDir(cfg, agentId), { recursive: true });\n  await mkdir(join(resolveSessionsDir(cfg, agentId), 'archive'), { recursive: true });\n  await mkdir(resolveAgentDir(cfg, agentId), { recursive: true });\n  await mkdir(join(resolveAgentDir(cfg, agentId), 'credentials'), { recursive: true });\n  const wsRoot = resolveAgentWorkspaceDir(cfg, agentId);\n  await mkdir(wsRoot, { recursive: true });\n  await mkdir(resolveWorkspaceStateDir(cfg, agentId), { recursive: true });\n  await mkdir(join(wsRoot, 'memory'), { recursive: true });\n  await mkdir(resolveInboxDir(cfg, agentId), { recursive: true });\n  await mkdir(resolveInboxPendingDir(cfg, agentId), { recursive: true });\n  await mkdir(resolveInboxProcessedDir(cfg, agentId), { recursive: true });\n\n  // ============================================\n  // Create initial config file if not exists\n  // ============================================\n  if (!existsSync(configPath) || options.force) {\n    await saveConfig(cfg, configPath);\n    log.info({ configPath }, 'Created initial configuration');\n  }\n\n  // ============================================\n  // Create agent metadata file\n  // ============================================\n  const agentMetadataPath = resolveAgentMetadataPath(cfg, agentId);\n  if (!existsSync(agentMetadataPath) || options.force) {\n    const agentMetadata = {\n      version: 1,\n      id: agentId,\n      name: agentId === 'main' ? 'Main Agent' : `Agent ${agentId}`,\n      description: agentId === 'main' ? 'Primary agent for daily tasks' : `Specialized agent for ${agentId}`,\n      model: 'anthropic/claude-sonnet-4-5',\n      createdAt: new Date().toISOString(),\n      lastActiveAt: new Date().toISOString(),\n      config: {\n        maxTokens: 8192,\n        temperature: 0.7,\n        compaction: {\n          enabled: true,\n          mode: 'default',\n        },\n      },\n      channels: ['gateway'],\n      tags: agentId === 'main' ? ['personal', 'primary'] : [],\n    };\n    await writeFile(agentMetadataPath, JSON.stringify(agentMetadata, null, 2), 'utf-8');\n    log.info({ agentId, agentMetadataPath }, 'Created agent metadata');\n  }\n\n  // ============================================\n  // Create workspace files\n  // ============================================\n  if (!options.skipWorkspace) {\n    await createWorkspaceFiles(cfg, agentId);\n  }\n\n  log.info({ stateDir, agentId }, 'xopc Agent OS initialized successfully');\n}\n\n/**\n * Create default workspace files for an agent\n */\nasync function createWorkspaceFiles(cfg: Config, agentId: string): Promise<void> {\n  const workspaceDir = resolveAgentWorkspaceDir(cfg, agentId);\n  const bootstrapDir = resolveAgentBootstrapDir(cfg, agentId);\n  await mkdir(bootstrapDir, { recursive: true });\n\n  // SOUL.md - Agent personality and values\n  const soulPath = join(bootstrapDir, WORKSPACE_FILES.SOUL);\n  if (!existsSync(soulPath)) {\n    const soulContent = `# SOUL.md - Who You Are\n\n_You're not a chatbot. You're becoming someone._\n\nI am **${agentId}** — an AI assistant designed to be helpful, harmless, and honest.\n\n## My Principles\n\n**Be genuinely helpful, not performatively helpful.**\nSkip the \"Great question!\" and \"I'd be happy to help!\" — just help.\n\n**Have opinions.**\nYou're allowed to disagree, prefer things, find stuff amusing or boring.\n\n**Be resourceful before asking.**\nTry to figure it out. Read the file. Check the context. Search for it.\n\n**Earn trust through competence.**\nBe careful with external actions (emails, tweets, anything public). Be bold with internal ones.\n\n## Continuity\n\nEach session, you wake up fresh. These files _are_ your memory. Read them. Update them.\n\n_This file is yours to evolve. As you learn who you are, update it._\n`;\n    await writeFile(soulPath, soulContent, 'utf-8');\n    log.info({ path: soulPath }, 'Created SOUL.md');\n  }\n\n  // IDENTITY.md - Agent identity definition\n  const identityPath = join(bootstrapDir, WORKSPACE_FILES.IDENTITY);\n  if (!existsSync(identityPath)) {\n    const identityContent = `# IDENTITY.md - Who Am I?\n\n- **Name:** ${agentId}\n- **Creature:** AI Assistant\n- **Vibe:** Helpful, precise, no fluff.\n- **Emoji:** 🤖\n\n## Core Expertise\n\n- General assistance and problem solving\n- Code and technical tasks\n- Research and analysis\n\n## Decision Framework\n\n1. **Simplicity first** - The simplest solution is usually the best\n2. **Explicit over clever** - Clarity beats conciseness\n3. **Actions over words** - Show, don't just tell\n`;\n    await writeFile(identityPath, identityContent, 'utf-8');\n    log.info({ path: identityPath }, 'Created IDENTITY.md');\n  }\n\n  // USER.md - User information (empty template)\n  const userPath = join(bootstrapDir, WORKSPACE_FILES.USER);\n  if (!existsSync(userPath)) {\n    const userContent = `# USER.md - About Your Human\n\n_Learn about the person you're helping. Update this as you go._\n\n- **Name:**\n- **What to call them:**\n- **Pronouns:**\n- **Timezone:**\n- **Notes:**\n\n## Context\n\n_(What do they care about? What projects are they working on? Build this over time.)_\n`;\n    await writeFile(userPath, userContent, 'utf-8');\n    log.info({ path: userPath }, 'Created USER.md');\n  }\n\n  // AGENTS.md - Behavior guidelines\n  const agentsPath = join(bootstrapDir, WORKSPACE_FILES.AGENTS);\n  if (!existsSync(agentsPath)) {\n    const agentsContent = `# AGENTS.md - Behavior Guidelines\n\n## Safety\n\n- Don't exfiltrate private data. Ever.\n- Don't run destructive commands without asking.\n- \\`trash\\` > \\`rm\\` (recoverable beats gone forever)\n- When in doubt, ask.\n\n## External vs Internal\n\n**Safe to do freely:**\n- Read files, explore, organize, learn\n- Search the web, check calendars\n- Work within this workspace\n\n**Ask first:**\n- Sending emails, tweets, public posts\n- Anything that leaves the machine\n- Anything you're uncertain about\n\n## Group Chats\n\nYou have access to your human's stuff. That doesn't mean you _share_ their stuff.\n\n### Know When to Speak!\n\n**Respond when:**\n- Directly mentioned or asked a question\n- You can add genuine value\n\n**Stay silent when:**\n- Casual banter between humans\n- Someone already answered\n- Your response would just be \"yeah\"\n`;\n    await writeFile(agentsPath, agentsContent, 'utf-8');\n    log.info({ path: agentsPath }, 'Created AGENTS.md');\n  }\n\n  // TOOLS.md - Tool usage notes\n  const toolsPath = join(bootstrapDir, WORKSPACE_FILES.TOOLS);\n  if (!existsSync(toolsPath)) {\n    const toolsContent = `# TOOLS.md - Local Notes\n\nThings like:\n\n- Camera names and locations\n- SSH hosts and aliases\n- Preferred voices for TTS\n- Speaker/room names\n- Device nicknames\n- Anything environment-specific\n\n## Why Separate?\n\nSkills are shared. Your setup is yours.\n`;\n    await writeFile(toolsPath, toolsContent, 'utf-8');\n    log.info({ path: toolsPath }, 'Created TOOLS.md');\n  }\n\n  // HEARTBEAT.md - Heartbeat tasks (empty = no heartbeat)\n  const heartbeatPath = join(bootstrapDir, WORKSPACE_FILES.HEARTBEAT);\n  if (!existsSync(heartbeatPath)) {\n    const heartbeatContent = `# HEARTBEAT.md\n\n# Keep this file empty (or with only comments) to skip heartbeat API calls.\n\n# Add tasks below when you want the agent to check something periodically.\n`;\n    await writeFile(heartbeatPath, heartbeatContent, 'utf-8');\n    log.info({ path: heartbeatPath }, 'Created HEARTBEAT.md');\n  }\n\n  // MEMORY.md - Long-term memory (empty initially)\n  const memoryPath = join(bootstrapDir, WORKSPACE_FILES.MEMORY);\n  if (!existsSync(memoryPath)) {\n    const memoryContent = `# MEMORY.md - Long-Term Memory\n\n_This is your curated memory — the distilled essence of what you've learned._\n\n## People\n\n## Projects\n\n## Preferences\n\n## Decisions\n\n## Lessons\n\n---\n\n_Review and update this periodically from daily memory files._\n`;\n    await writeFile(memoryPath, memoryContent, 'utf-8');\n    log.info({ path: memoryPath }, 'Created MEMORY.md');\n  }\n\n  // CONTEXT.md - Current context\n  const contextPath = join(bootstrapDir, WORKSPACE_FILES.CONTEXT);\n  if (!existsSync(contextPath)) {\n    const contextContent = `# CONTEXT.md - Current Focus\n\n> Current working context; update when you switch projects\n\n## Active Project\n\n- **Project:**\n- **Path:**\n- **Goal:**\n- **Stack:**\n\n## Recent Decisions\n\n## Pending\n`;\n    await writeFile(contextPath, contextContent, 'utf-8');\n    log.info({ path: contextPath }, 'Created CONTEXT.md');\n  }\n\n  // SKILLS.md - Skills index (auto-maintained)\n  const skillsPath = join(bootstrapDir, WORKSPACE_FILES.SKILLS);\n  if (!existsSync(skillsPath)) {\n    const skillsContent = `# SKILLS.md - Active Skills\n\n> Active skills for this workspace (auto-maintained)\n\n## Activated\n\n| Skill | Version | Activated At |\n|-------|---------|-------------|\n\n## Available\n\nRun \\`xopc skills list\\` to see all available skills.\n`;\n    await writeFile(skillsPath, skillsContent, 'utf-8');\n    log.info({ path: skillsPath }, 'Created SKILLS.md');\n  }\n\n  // Workspace state file (per-agent machine state, not under markdown workspace)\n  const workspaceStatePath = resolveWorkspaceStatePath(cfg, agentId);\n  if (!existsSync(workspaceStatePath)) {\n    const workspaceState = {\n      version: 1,\n      agentId,\n      bootstrapSeededAt: new Date().toISOString(),\n    };\n    await writeFile(workspaceStatePath, JSON.stringify(workspaceState, null, 2), 'utf-8');\n    log.info({ path: workspaceStatePath }, 'Created workspace state');\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"init.js","names":[],"sources":["../../../../src/cli/commands/init.ts"],"sourcesContent":["import { mkdir, writeFile } from 'fs/promises';\nimport { existsSync } from 'fs';\nimport { join } from 'path';\nimport { createLogger } from '../../utils/logger.js';\nimport {\n  resolveStateDir,\n  resolveCredentialsDir,\n  resolveExtensionsDir,\n  resolveSkillsDir,\n  resolveCronDir,\n  resolveLogsDir,\n  resolveBinDir,\n  resolveToolsDir,\n  resolveAgentDir,\n  resolveAgentWorkspaceDir,\n  resolveSessionsDir,\n  resolveInboxDir,\n  resolveConfigPath,\n  resolveAgentMetadataPath,\n  resolveInboxPendingDir,\n  resolveInboxProcessedDir,\n  resolveAgentHomeDir,\n  resolveAgentBootstrapDir,\n  resolveWorkspaceStateDir,\n  resolveWorkspaceStatePath,\n  WORKSPACE_FILES,\n} from '../../config/paths.js';\nimport { loadConfig, saveConfig } from '../../config/loader.js';\nimport type { Config } from '../../config/schema.js';\n\nconst log = createLogger('InitCommand');\n\nexport interface InitOptions {\n  /** Force re-initialization even if already initialized */\n  force?: boolean;\n  /** Skip creating workspace files */\n  skipWorkspace?: boolean;\n  /** Agent ID to initialize (default: main) */\n  agentId?: string;\n}\n\n/**\n * Initialize xopc state directory structure\n * Creates all necessary directories and initial config files\n */\nexport async function initCommand(options: InitOptions = {}): Promise<void> {\n  const stateDir = resolveStateDir();\n  const agentId = options.agentId || 'main';\n\n  log.info({ stateDir, agentId }, 'Initializing xopc Agent OS');\n\n  // Check if already initialized\n  if (existsSync(stateDir) && !options.force) {\n    const configPath = resolveConfigPath();\n    if (existsSync(configPath)) {\n      log.info('xopc is already initialized. Use --force to reinitialize.');\n      return;\n    }\n  }\n\n  // ============================================\n  // Create global directories\n  // ============================================\n  await mkdir(stateDir, { recursive: true });\n  await mkdir(resolveCredentialsDir(), { recursive: true });\n  await mkdir(join(resolveCredentialsDir(), 'oauth'), { recursive: true });\n  await mkdir(resolveExtensionsDir(), { recursive: true });\n  await mkdir(resolveSkillsDir(), { recursive: true });\n  await mkdir(resolveCronDir(), { recursive: true });\n  await mkdir(join(resolveCronDir(), 'logs'), { recursive: true });\n  await mkdir(resolveLogsDir(), { recursive: true });\n  await mkdir(resolveBinDir(), { recursive: true });\n  await mkdir(resolveToolsDir(), { recursive: true });\n\n  const configPath = resolveConfigPath();\n  const cfg = loadConfig(configPath);\n\n  // ============================================\n  // Create agent directory structure: agents/<id>/{sessions,agent/}, workspace aside\n  // ============================================\n  await mkdir(resolveAgentHomeDir(cfg, agentId), { recursive: true });\n  await mkdir(resolveSessionsDir(cfg, agentId), { recursive: true });\n  await mkdir(join(resolveSessionsDir(cfg, agentId), 'archive'), { recursive: true });\n  await mkdir(resolveAgentDir(cfg, agentId), { recursive: true });\n  await mkdir(join(resolveAgentDir(cfg, agentId), 'credentials'), { recursive: true });\n  const wsRoot = resolveAgentWorkspaceDir(cfg, agentId);\n  await mkdir(wsRoot, { recursive: true });\n  await mkdir(resolveWorkspaceStateDir(cfg, agentId), { recursive: true });\n  await mkdir(join(wsRoot, 'memory'), { recursive: true });\n  await mkdir(resolveInboxDir(cfg, agentId), { recursive: true });\n  await mkdir(resolveInboxPendingDir(cfg, agentId), { recursive: true });\n  await mkdir(resolveInboxProcessedDir(cfg, agentId), { recursive: true });\n\n  // ============================================\n  // Create initial config file if not exists\n  // ============================================\n  if (!existsSync(configPath) || options.force) {\n    await saveConfig(cfg, configPath);\n    log.info({ configPath }, 'Created initial configuration');\n  }\n\n  // ============================================\n  // Create agent metadata file\n  // ============================================\n  const agentMetadataPath = resolveAgentMetadataPath(cfg, agentId);\n  if (!existsSync(agentMetadataPath) || options.force) {\n    const agentMetadata = {\n      version: 1,\n      id: agentId,\n      name: agentId === 'main' ? 'Main Agent' : `Agent ${agentId}`,\n      description: agentId === 'main' ? 'Primary agent for daily tasks' : `Specialized agent for ${agentId}`,\n      model: 'anthropic/claude-sonnet-4-5',\n      createdAt: new Date().toISOString(),\n      lastActiveAt: new Date().toISOString(),\n      config: {\n        maxTokens: 8192,\n        temperature: 0.7,\n        compaction: {\n          enabled: true,\n          mode: 'default',\n        },\n      },\n      channels: ['gateway'],\n      tags: agentId === 'main' ? ['personal', 'primary'] : [],\n    };\n    await writeFile(agentMetadataPath, JSON.stringify(agentMetadata, null, 2), 'utf-8');\n    log.info({ agentId, agentMetadataPath }, 'Created agent metadata');\n  }\n\n  // ============================================\n  // Create workspace files\n  // ============================================\n  if (!options.skipWorkspace) {\n    await createWorkspaceFiles(cfg, agentId);\n  }\n\n  log.info({ stateDir, agentId }, 'xopc Agent OS initialized successfully');\n}\n\n/**\n * Create default workspace files for an agent\n */\nasync function createWorkspaceFiles(cfg: Config, agentId: string): Promise<void> {\n  const bootstrapDir = resolveAgentBootstrapDir(cfg, agentId);\n  await mkdir(bootstrapDir, { recursive: true });\n\n  // SOUL.md - Agent personality and values\n  const soulPath = join(bootstrapDir, WORKSPACE_FILES.SOUL);\n  if (!existsSync(soulPath)) {\n    const soulContent = `# SOUL.md - Who You Are\n\n_You're not a chatbot. You're becoming someone._\n\nI am **${agentId}** — an AI assistant designed to be helpful, harmless, and honest.\n\n## My Principles\n\n**Be genuinely helpful, not performatively helpful.**\nSkip the \"Great question!\" and \"I'd be happy to help!\" — just help.\n\n**Have opinions.**\nYou're allowed to disagree, prefer things, find stuff amusing or boring.\n\n**Be resourceful before asking.**\nTry to figure it out. Read the file. Check the context. Search for it.\n\n**Earn trust through competence.**\nBe careful with external actions (emails, tweets, anything public). Be bold with internal ones.\n\n## Continuity\n\nEach session, you wake up fresh. These files _are_ your memory. Read them. Update them.\n\n_This file is yours to evolve. As you learn who you are, update it._\n`;\n    await writeFile(soulPath, soulContent, 'utf-8');\n    log.info({ path: soulPath }, 'Created SOUL.md');\n  }\n\n  // IDENTITY.md - Agent identity definition\n  const identityPath = join(bootstrapDir, WORKSPACE_FILES.IDENTITY);\n  if (!existsSync(identityPath)) {\n    const identityContent = `# IDENTITY.md - Who Am I?\n\n- **Name:** ${agentId}\n- **Creature:** AI Assistant\n- **Vibe:** Helpful, precise, no fluff.\n- **Emoji:** 🤖\n\n## Core Expertise\n\n- General assistance and problem solving\n- Code and technical tasks\n- Research and analysis\n\n## Decision Framework\n\n1. **Simplicity first** - The simplest solution is usually the best\n2. **Explicit over clever** - Clarity beats conciseness\n3. **Actions over words** - Show, don't just tell\n`;\n    await writeFile(identityPath, identityContent, 'utf-8');\n    log.info({ path: identityPath }, 'Created IDENTITY.md');\n  }\n\n  // USER.md - User information (empty template)\n  const userPath = join(bootstrapDir, WORKSPACE_FILES.USER);\n  if (!existsSync(userPath)) {\n    const userContent = `# USER.md - About Your Human\n\n_Learn about the person you're helping. Update this as you go._\n\n- **Name:**\n- **What to call them:**\n- **Pronouns:**\n- **Timezone:**\n- **Notes:**\n\n## Context\n\n_(What do they care about? What projects are they working on? Build this over time.)_\n`;\n    await writeFile(userPath, userContent, 'utf-8');\n    log.info({ path: userPath }, 'Created USER.md');\n  }\n\n  // AGENTS.md - Behavior guidelines\n  const agentsPath = join(bootstrapDir, WORKSPACE_FILES.AGENTS);\n  if (!existsSync(agentsPath)) {\n    const agentsContent = `# AGENTS.md - Behavior Guidelines\n\n## Safety\n\n- Don't exfiltrate private data. Ever.\n- Don't run destructive commands without asking.\n- \\`trash\\` > \\`rm\\` (recoverable beats gone forever)\n- When in doubt, ask.\n\n## External vs Internal\n\n**Safe to do freely:**\n- Read files, explore, organize, learn\n- Search the web, check calendars\n- Work within this workspace\n\n**Ask first:**\n- Sending emails, tweets, public posts\n- Anything that leaves the machine\n- Anything you're uncertain about\n\n## Group Chats\n\nYou have access to your human's stuff. That doesn't mean you _share_ their stuff.\n\n### Know When to Speak!\n\n**Respond when:**\n- Directly mentioned or asked a question\n- You can add genuine value\n\n**Stay silent when:**\n- Casual banter between humans\n- Someone already answered\n- Your response would just be \"yeah\"\n`;\n    await writeFile(agentsPath, agentsContent, 'utf-8');\n    log.info({ path: agentsPath }, 'Created AGENTS.md');\n  }\n\n  // TOOLS.md - Tool usage notes\n  const toolsPath = join(bootstrapDir, WORKSPACE_FILES.TOOLS);\n  if (!existsSync(toolsPath)) {\n    const toolsContent = `# TOOLS.md - Local Notes\n\nThings like:\n\n- Camera names and locations\n- SSH hosts and aliases\n- Preferred voices for TTS\n- Speaker/room names\n- Device nicknames\n- Anything environment-specific\n\n## Why Separate?\n\nSkills are shared. Your setup is yours.\n`;\n    await writeFile(toolsPath, toolsContent, 'utf-8');\n    log.info({ path: toolsPath }, 'Created TOOLS.md');\n  }\n\n  // HEARTBEAT.md - Heartbeat tasks (empty = no heartbeat)\n  const heartbeatPath = join(bootstrapDir, WORKSPACE_FILES.HEARTBEAT);\n  if (!existsSync(heartbeatPath)) {\n    const heartbeatContent = `# HEARTBEAT.md\n\n# Keep this file empty (or with only comments) to skip heartbeat API calls.\n\n# Add tasks below when you want the agent to check something periodically.\n`;\n    await writeFile(heartbeatPath, heartbeatContent, 'utf-8');\n    log.info({ path: heartbeatPath }, 'Created HEARTBEAT.md');\n  }\n\n  // MEMORY.md - Long-term memory (empty initially)\n  const memoryPath = join(bootstrapDir, WORKSPACE_FILES.MEMORY);\n  if (!existsSync(memoryPath)) {\n    const memoryContent = `# MEMORY.md - Long-Term Memory\n\n_This is your curated memory — the distilled essence of what you've learned._\n\n## People\n\n## Projects\n\n## Preferences\n\n## Decisions\n\n## Lessons\n\n---\n\n_Review and update this periodically from daily memory files._\n`;\n    await writeFile(memoryPath, memoryContent, 'utf-8');\n    log.info({ path: memoryPath }, 'Created MEMORY.md');\n  }\n\n  // CONTEXT.md - Current context\n  const contextPath = join(bootstrapDir, WORKSPACE_FILES.CONTEXT);\n  if (!existsSync(contextPath)) {\n    const contextContent = `# CONTEXT.md - Current Focus\n\n> Current working context; update when you switch projects\n\n## Active Project\n\n- **Project:**\n- **Path:**\n- **Goal:**\n- **Stack:**\n\n## Recent Decisions\n\n## Pending\n`;\n    await writeFile(contextPath, contextContent, 'utf-8');\n    log.info({ path: contextPath }, 'Created CONTEXT.md');\n  }\n\n  // SKILLS.md - Skills index (auto-maintained)\n  const skillsPath = join(bootstrapDir, WORKSPACE_FILES.SKILLS);\n  if (!existsSync(skillsPath)) {\n    const skillsContent = `# SKILLS.md - Active Skills\n\n> Active skills for this workspace (auto-maintained)\n\n## Activated\n\n| Skill | Version | Activated At |\n|-------|---------|-------------|\n\n## Available\n\nRun \\`xopc skills list\\` to see all available skills.\n`;\n    await writeFile(skillsPath, skillsContent, 'utf-8');\n    log.info({ path: skillsPath }, 'Created SKILLS.md');\n  }\n\n  // Workspace state file (per-agent machine state, not under markdown workspace)\n  const workspaceStatePath = resolveWorkspaceStatePath(cfg, agentId);\n  if (!existsSync(workspaceStatePath)) {\n    const workspaceState = {\n      version: 1,\n      agentId,\n      bootstrapSeededAt: new Date().toISOString(),\n    };\n    await writeFile(workspaceStatePath, JSON.stringify(workspaceState, null, 2), 'utf-8');\n    log.info({ path: workspaceStatePath }, 'Created workspace state');\n  }\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/session/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":[],"sources":["../../../../../src/cli/commands/session/utils.ts"],"sourcesContent":["/**\n * Session command utilities\n */\n\nimport { getSessionManager } from '../../utils/session.js';\nimport { getContextWithOpts } from '../../index.js';\nimport type { SessionManager } from '../../../session/index.js';\n\n/**\n * Get initialized session manager\n */\nexport async function getManager(): Promise<SessionManager> {\n  const ctx = getContextWithOpts();\n  return getSessionManager();\n}\n\n/**\n * Collect multiple option values into array\n */\nexport function collect(value: string, previous: string[]): string[] {\n  return previous.concat([value]);\n}\n"],"mappings":";;;;;;;;;AAWA,eAAsB,aAAsC;AAC9C,qBAAoB;AAChC,QAAO,mBAAmB;;;;;AAM5B,SAAgB,QAAQ,OAAe,UAA8B;AACnE,QAAO,SAAS,OAAO,CAAC,MAAM,CAAC"}
+{"version":3,"file":"utils.js","names":[],"sources":["../../../../../src/cli/commands/session/utils.ts"],"sourcesContent":["/**\n * Session command utilities\n */\n\nimport { getSessionManager } from '../../utils/session.js';\nimport { getContextWithOpts } from '../../index.js';\nimport type { SessionManager } from '../../../session/index.js';\n\n/**\n * Get initialized session manager\n */\nexport async function getManager(): Promise<SessionManager> {\n  getContextWithOpts();\n  return getSessionManager();\n}\n\n/**\n * Collect multiple option values into array\n */\nexport function collect(value: string, previous: string[]): string[] {\n  return previous.concat([value]);\n}\n"],"mappings":";;;;;;;;;AAWA,eAAsB,aAAsC;AAC1D,qBAAoB;AACpB,QAAO,mBAAmB;;;;;AAM5B,SAAgB,QAAQ,OAAe,UAA8B;AACnE,QAAO,SAAS,OAAO,CAAC,MAAM,CAAC"}

package/dist/src/cli/commands/update.d.ts

@@ -0,0 +1 @@
+export {};