@a1hvdy/cc-openclaw 0.10.4 → 0.12.0

package/dist/src/cli/checks/install-path.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `check_install_path` — resolves which of the 3 known openclaw extension
+ * paths cc-openclaw was loaded from; compares installed version to this
+ * binary's built version.
+ *
+ * Extracted from `doctor.ts` 2026-05-13 along with its helpers
+ * (findProjectRoot, SELF_VERSION, INSTALL_CANDIDATES) to keep doctor.ts
+ * under the 500-LOC ceiling.
+ */
+import type { CheckResult } from './patch-scaffold.js';
+export declare function checkInstallPath(selfVersion?: string): CheckResult;

package/dist/src/cli/checks/install-path.js

@@ -0,0 +1,89 @@
+/**
+ * `check_install_path` — resolves which of the 3 known openclaw extension
+ * paths cc-openclaw was loaded from; compares installed version to this
+ * binary's built version.
+ *
+ * Extracted from `doctor.ts` 2026-05-13 along with its helpers
+ * (findProjectRoot, SELF_VERSION, INSTALL_CANDIDATES) to keep doctor.ts
+ * under the 500-LOC ceiling.
+ */
+import { existsSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+// Locate package.json by walking up from this file's directory until we find it.
+// Works in both runtime (dist/src/cli/checks/) and vitest (src/cli/checks/) contexts.
+function findProjectRoot(startDir) {
+    let dir = startDir;
+    for (let i = 0; i < 10; i++) {
+        if (existsSync(join(dir, 'package.json')))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error('cc-openclaw: could not locate project root package.json');
+}
+// Resolved lazily-at-import with a fallback so a mocked fs (vitest) or an
+// unreachable path doesn't crash the entire module load.
+let SELF_VERSION;
+try {
+    const _thisDir = dirname(fileURLToPath(import.meta.url));
+    const _projectRoot = findProjectRoot(_thisDir);
+    const selfPkg = JSON.parse(readFileSync(join(_projectRoot, 'package.json'), 'utf8'));
+    SELF_VERSION = String(selfPkg.version ?? 'unknown');
+}
+catch {
+    SELF_VERSION = 'unknown';
+}
+const INSTALL_CANDIDATES = [
+    join(homedir(), '.npm-global/lib/node_modules/openclaw/dist/extensions/cc-openclaw'),
+    '/usr/local/lib/node_modules/openclaw/dist/extensions/cc-openclaw',
+    join(homedir(), '.openclaw/extensions/cc-openclaw'),
+];
+export function checkInstallPath(selfVersion = SELF_VERSION) {
+    const id = 'check_install_path';
+    for (const candidate of INSTALL_CANDIDATES) {
+        const pkgPath = join(candidate, 'package.json');
+        if (!existsSync(pkgPath))
+            continue;
+        let installedVersion;
+        try {
+            const installedPkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+            installedVersion = String(installedPkg.version ?? 'unknown');
+        }
+        catch {
+            return {
+                id,
+                status: 'fail',
+                detail: {
+                    path: candidate,
+                    candidatesSearched: INSTALL_CANDIDATES,
+                    error: 'could not parse package.json at resolved path',
+                },
+            };
+        }
+        const mismatch = installedVersion !== selfVersion;
+        return {
+            id,
+            status: mismatch ? 'fail' : 'pass',
+            detail: {
+                path: candidate,
+                candidatesSearched: INSTALL_CANDIDATES,
+                version: installedVersion,
+                selfVersion,
+                mismatch,
+            },
+        };
+    }
+    return {
+        id,
+        status: 'fail',
+        detail: {
+            candidatesSearched: INSTALL_CANDIDATES,
+            error: 'cc-openclaw not found in any known openclaw extension path',
+        },
+    };
+}
+//# sourceMappingURL=install-path.js.map

package/dist/src/cli/checks/install-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-path.js","sourceRoot":"","sources":["../../../../src/cli/checks/install-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAGpC,iFAAiF;AACjF,sFAAsF;AACtF,SAAS,eAAe,CAAC,QAAgB;IACvC,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QACtD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;AAC7E,CAAC;AAED,0EAA0E;AAC1E,yDAAyD;AACzD,IAAI,YAAoB,CAAC;AACzB,IAAI,CAAC;IACH,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAyB,IAAI,CAAC,KAAK,CAC9C,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACzD,CAAC;IACF,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC;AACtD,CAAC;AAAC,MAAM,CAAC;IACP,YAAY,GAAG,SAAS,CAAC;AAC3B,CAAC;AAED,MAAM,kBAAkB,GAAa;IACnC,IAAI,CAAC,OAAO,EAAE,EAAE,mEAAmE,CAAC;IACpF,kEAAkE;IAClE,IAAI,CAAC,OAAO,EAAE,EAAE,kCAAkC,CAAC;CACpD,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,cAAsB,YAAY;IACjE,MAAM,EAAE,GAAG,oBAAoB,CAAC;IAEhC,KAAK,MAAM,SAAS,IAAI,kBAAkB,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,SAAS;QAEnC,IAAI,gBAAwB,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAyB,CAAC;YACvF,gBAAgB,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,EAAE;gBACF,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE;oBACN,IAAI,EAAE,SAAS;oBACf,kBAAkB,EAAE,kBAAkB;oBACtC,KAAK,EAAE,+CAA+C;iBACvD;aACF,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,gBAAgB,KAAK,WAAW,CAAC;QAClD,OAAO;YACL,EAAE;YACF,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YAClC,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,kBAAkB,EAAE,kBAAkB;gBACtC,OAAO,EAAE,gBAAgB;gBACzB,WAAW;gBACX,QAAQ;aACT;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE;QACF,MAAM,EAAE,MAAM;QACd,MAAM,EAAE;YACN,kBAAkB,EAAE,kBAAkB;YACtC,KAAK,EAAE,4DAA4D;SACpE;KACF,CAAC;AACJ,CAAC"}

package/dist/src/cli/checks/patch-scaffold.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `check_patch_scaffold` — registers all 9 Phase E#3 PatchSpec scaffolds in a
+ * PatchManifest and runs `validate()` against the live `openclaw` peer dep.
+ *
+ * Extracted from `doctor.ts` to keep that file under the 500-LOC ceiling
+ * and establish the per-check module pattern.
+ *
+ * Phase E#3 fills in real probe bodies; this check evolves with them. Today
+ * the probes verify specific upstream symbols + pure-function determinism —
+ * any catastrophic upstream API loss fails the check.
+ */
+export interface CheckResult {
+    id: string;
+    status: 'pass' | 'fail' | 'pending';
+    detail: Record<string, unknown>;
+}
+export declare function checkPatchScaffold(): Promise<CheckResult>;

package/dist/src/cli/checks/patch-scaffold.js

@@ -0,0 +1,56 @@
+/**
+ * `check_patch_scaffold` — registers all 9 Phase E#3 PatchSpec scaffolds in a
+ * PatchManifest and runs `validate()` against the live `openclaw` peer dep.
+ *
+ * Extracted from `doctor.ts` to keep that file under the 500-LOC ceiling
+ * and establish the per-check module pattern.
+ *
+ * Phase E#3 fills in real probe bodies; this check evolves with them. Today
+ * the probes verify specific upstream symbols + pure-function determinism —
+ * any catastrophic upstream API loss fails the check.
+ */
+import { PatchManifest } from '../../lifecycle/patch-manifest.js';
+export async function checkPatchScaffold() {
+    const id = 'check_patch_scaffold';
+    try {
+        const [{ syspromptStripSpec }, { cacheParityRegistrySpec }, { embeddedServerRouteSpec }, { pricingOverridesSpec }, { resumeRegistryRestoreSpec }, { sessionPidTrackingSpec }, { cwdRedirectSpec }, { toolsRestorationSpec }, { claudeMdInjectionSpec },] = await Promise.all([
+            import('../../patches/sysprompt-strip.js'),
+            import('../../patches/cache-parity-registry.js'),
+            import('../../patches/embedded-server-route.js'),
+            import('../../patches/pricing-overrides.js'),
+            import('../../patches/resume-registry-restore.js'),
+            import('../../patches/session-pid-tracking.js'),
+            import('../../patches/cwd-redirect.js'),
+            import('../../patches/tools-restoration.js'),
+            import('../../patches/claude-md-injection.js'),
+        ]);
+        const manifest = new PatchManifest();
+        manifest.register(syspromptStripSpec);
+        manifest.register(cacheParityRegistrySpec);
+        manifest.register(embeddedServerRouteSpec);
+        manifest.register(pricingOverridesSpec);
+        manifest.register(resumeRegistryRestoreSpec);
+        manifest.register(sessionPidTrackingSpec);
+        manifest.register(cwdRedirectSpec);
+        manifest.register(toolsRestorationSpec);
+        manifest.register(claudeMdInjectionSpec);
+        await manifest.validate();
+        return {
+            id,
+            status: 'pass',
+            detail: { specCount: manifest.size, ids: manifest.ids() },
+        };
+    }
+    catch (err) {
+        return {
+            id,
+            status: 'fail',
+            detail: {
+                error: err instanceof Error ? err.message : String(err),
+                remediation: 'one or more PatchSpec probes detected drift against `openclaw`; ' +
+                    'review `tests/patches/all-specs-compose.test.ts` for the failing spec',
+            },
+        };
+    }
+}
+//# sourceMappingURL=patch-scaffold.js.map

package/dist/src/cli/checks/patch-scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-scaffold.js","sourceRoot":"","sources":["../../../../src/cli/checks/patch-scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAQlE,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,EAAE,GAAG,sBAAsB,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,CACJ,EAAE,kBAAkB,EAAE,EACtB,EAAE,uBAAuB,EAAE,EAC3B,EAAE,uBAAuB,EAAE,EAC3B,EAAE,oBAAoB,EAAE,EACxB,EAAE,yBAAyB,EAAE,EAC7B,EAAE,sBAAsB,EAAE,EAC1B,EAAE,eAAe,EAAE,EACnB,EAAE,oBAAoB,EAAE,EACxB,EAAE,qBAAqB,EAAE,EAC1B,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACpB,MAAM,CAAC,kCAAkC,CAAC;YAC1C,MAAM,CAAC,wCAAwC,CAAC;YAChD,MAAM,CAAC,wCAAwC,CAAC;YAChD,MAAM,CAAC,oCAAoC,CAAC;YAC5C,MAAM,CAAC,0CAA0C,CAAC;YAClD,MAAM,CAAC,uCAAuC,CAAC;YAC/C,MAAM,CAAC,+BAA+B,CAAC;YACvC,MAAM,CAAC,oCAAoC,CAAC;YAC5C,MAAM,CAAC,sCAAsC,CAAC;SAC/C,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QACrC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QACtC,QAAQ,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;QAC3C,QAAQ,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;QAC3C,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;QACxC,QAAQ,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;QAC7C,QAAQ,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;QAC1C,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QACnC,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;QACxC,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;QAEzC,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC1B,OAAO;YACL,EAAE;YACF,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,EAAE;SAC1D,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE;YACF,MAAM,EAAE,MAAM;YACd,MAAM,EAAE;gBACN,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBACvD,WAAW,EACT,kEAAkE;oBAClE,uEAAuE;aAC1E;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * `cc-openclaw doctor` — Phase 5 Bridge Plane skeleton (v0.11.0).
+ *
+ * Checks shipped in this plane:
+ *   1. check_install_path  — resolves which of the 3 known openclaw extension
+ *      paths cc-openclaw was loaded from; compares installed version to this
+ *      binary's built version.
+ *   2. check_bridge_wiring — soft-imports the bridge factory and asserts the
+ *      4 expected bridge mode exports exist. Soft-fails with `pending` when
+ *      the factory file has not yet shipped (bridge coder is parallel).
+ *
+ * Future planes add checks via the exported `ALL_CHECKS` registry.
+ */
+import { Command } from 'commander';
+export { checkInstallPath } from './checks/install-path.js';
+export { checkBridgeWiring } from './checks/bridge-wiring.js';
+export { checkConfigSchema } from './checks/config-schema.js';
+export { checkCriticalOpenclawJsonKeys } from './checks/critical-openclaw-json-keys.js';
+export { checkPatchScaffold } from './checks/patch-scaffold.js';
+export declare function createDoctorCommand(): Command;

package/dist/src/cli/doctor.js

@@ -0,0 +1,93 @@
+/**
+ * `cc-openclaw doctor` — Phase 5 Bridge Plane skeleton (v0.11.0).
+ *
+ * Checks shipped in this plane:
+ *   1. check_install_path  — resolves which of the 3 known openclaw extension
+ *      paths cc-openclaw was loaded from; compares installed version to this
+ *      binary's built version.
+ *   2. check_bridge_wiring — soft-imports the bridge factory and asserts the
+ *      4 expected bridge mode exports exist. Soft-fails with `pending` when
+ *      the factory file has not yet shipped (bridge coder is parallel).
+ *
+ * Future planes add checks via the exported `ALL_CHECKS` registry.
+ */
+import { Command } from 'commander';
+import { checkPatchScaffold as _checkPatchScaffoldImpl } from './checks/patch-scaffold.js';
+import { checkCriticalOpenclawJsonKeys as _checkCriticalKeysImpl } from './checks/critical-openclaw-json-keys.js';
+import { checkConfigSchema as _checkConfigSchemaImpl } from './checks/config-schema.js';
+import { checkInstallPath as _checkInstallPathImpl } from './checks/install-path.js';
+import { checkBridgeWiring as _checkBridgeWiringImpl } from './checks/bridge-wiring.js';
+// `checkInstallPath` extracted to `./checks/install-path.ts` 2026-05-13
+// along with findProjectRoot, SELF_VERSION, INSTALL_CANDIDATES helpers
+// to keep doctor.ts under the 500-LOC ceiling.
+export { checkInstallPath } from './checks/install-path.js';
+// `checkBridgeWiring` extracted to `./checks/bridge-wiring.ts` 2026-05-13
+// to keep doctor.ts under the 500-LOC ceiling.
+export { checkBridgeWiring } from './checks/bridge-wiring.js';
+// `checkConfigSchema` extracted to `./checks/config-schema.ts` 2026-05-13
+// to keep doctor.ts under the 500-LOC ceiling.
+export { checkConfigSchema } from './checks/config-schema.js';
+// `checkCriticalOpenclawJsonKeys` extracted to `./checks/critical-openclaw-json-keys.ts`
+// 2026-05-13 to keep doctor.ts under the 500-LOC ceiling.
+export { checkCriticalOpenclawJsonKeys } from './checks/critical-openclaw-json-keys.js';
+// ── Check 5: patch scaffold composition ─────────────────────────────────────
+// `checkPatchScaffold` lives in `src/cli/checks/patch-scaffold.ts` (extracted
+// 2026-05-13 to keep doctor.ts under the 500-LOC ceiling). Re-exported here
+// for backward compatibility.
+export { checkPatchScaffold } from './checks/patch-scaffold.js';
+// ── Output helpers ───────────────────────────────────────────────────────────
+function symbol(status) {
+    if (status === 'pass')
+        return '✔'; // ✔
+    if (status === 'pending')
+        return '○'; // ○
+    return '✘'; // ✘
+}
+function formatDetail(detail) {
+    const lines = [];
+    for (const [k, v] of Object.entries(detail)) {
+        if (Array.isArray(v)) {
+            lines.push(`    ${k}: [${v.join(', ')}]`);
+        }
+        else {
+            lines.push(`    ${k}: ${String(v)}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ── Command factory ──────────────────────────────────────────────────────────
+export function createDoctorCommand() {
+    const cmd = new Command('doctor');
+    cmd
+        .description('diagnose cc-openclaw install-path, bridge wiring, and plugin health')
+        .option('--json', 'emit results as a single JSON line')
+        .action(async (opts) => {
+        const results = [];
+        results.push(_checkInstallPathImpl());
+        results.push(await _checkBridgeWiringImpl());
+        results.push(_checkConfigSchemaImpl());
+        results.push(_checkCriticalKeysImpl());
+        results.push(await _checkPatchScaffoldImpl());
+        const passed = results.filter((r) => r.status === 'pass').length;
+        const pending = results.filter((r) => r.status === 'pending').length;
+        const failed = results.filter((r) => r.status === 'fail').length;
+        const total = results.length;
+        const exitCode = failed > 0 ? 1 : 0;
+        if (opts.json) {
+            process.stdout.write(JSON.stringify({ checks: results, passed, pending, failed, total, exitCode }) + '\n');
+        }
+        else {
+            for (let i = 0; i < results.length; i++) {
+                const r = results[i];
+                const statusLabel = r.status === 'pending' ? 'pending' : r.status;
+                process.stdout.write(`${symbol(r.status)} check ${i + 1} (${r.id}): ${statusLabel}\n`);
+                process.stdout.write(formatDetail(r.detail) + '\n');
+            }
+            const pendingNote = pending > 0 ? ` (${pending} pending)` : '';
+            process.stdout.write(`\nResult: ${passed}/${total} checks passed${pendingNote}\n`);
+        }
+        process.exit(exitCode);
+    });
+    return cmd;
+}
+//# sourceMappingURL=doctor.js.map

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

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

package/dist/src/cli/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * cc-openclaw CLI entry point.
+ *
+ * Registers the `cc-openclaw` binary with a `doctor` subcommand.
+ * Future planes add: patch-status (v0.12), registry (v0.13), lifecycle (v0.14).
+ */
+export {};

package/dist/src/cli/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+/**
+ * cc-openclaw CLI entry point.
+ *
+ * Registers the `cc-openclaw` binary with a `doctor` subcommand.
+ * Future planes add: patch-status (v0.12), registry (v0.13), lifecycle (v0.14).
+ */
+import { Command } from 'commander';
+import { createDoctorCommand } from './doctor.js';
+import { createMigrateCommand } from './migrate.js';
+import { existsSync, readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+function findProjectRoot(startDir) {
+    let dir = startDir;
+    for (let i = 0; i < 10; i++) {
+        if (existsSync(join(dir, 'package.json')))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error('cc-openclaw: could not locate project root package.json');
+}
+const _root = findProjectRoot(dirname(fileURLToPath(import.meta.url)));
+const pkg = JSON.parse(readFileSync(join(_root, 'package.json'), 'utf8'));
+const program = new Command();
+program
+    .name('cc-openclaw')
+    .version(String(pkg.version), '-v, --version', 'print version and exit')
+    .description('A1xAI cc-openclaw plugin diagnostics');
+program.addCommand(createDoctorCommand());
+program.addCommand(createMigrateCommand());
+program.parseAsync(process.argv).catch((err) => {
+    console.error('cc-openclaw: fatal error', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,SAAS,eAAe,CAAC,QAAgB;IACvC,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QACtD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEvE,MAAM,GAAG,GAAyB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhG,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KAEnB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE,wBAAwB,CAAC;KACvE,WAAW,CAAC,sCAAsC,CAAC,CAAC;AAEvD,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC1C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAE3C,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtD,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/cli/migrate.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `cc-openclaw migrate` — legacy-persistence migration command (Q5 resolution).
+ *
+ * Default mode (no flag): READ-ONLY. Loads the four legacy JSON files into
+ * the new SessionRegistry's in-memory map, reports counts, exits 0. Legacy
+ * files remain untouched. Idempotent — safe to run repeatedly.
+ *
+ * `--commit`: DESTRUCTIVE. After successful read, deletes the four legacy
+ * files. The v1.0.0 release blocks on A1 running `--commit` on both laptops.
+ *
+ * `--dry-run`: synonym for default (no-flag) — emitted for parity with
+ * `openclaw doctor --fix` UX expectations. No deletion, no writes, only counts.
+ */
+import { Command } from 'commander';
+export interface MigrateOptions {
+    commit?: boolean;
+    dryRun?: boolean;
+}
+export interface MigrateResult {
+    readonly migratedCount: number;
+    readonly committed: boolean;
+    readonly deletedFiles: ReadonlyArray<string>;
+}
+/**
+ * Pure function — runs the migration, returns counts. Splits the side-effects
+ * (file deletion + console output) from the read so the test surface stays clean.
+ */
+export declare function runMigrate(opts?: MigrateOptions): Promise<MigrateResult>;
+export declare function createMigrateCommand(): Command;

package/dist/src/cli/migrate.js

@@ -0,0 +1,75 @@
+/**
+ * `cc-openclaw migrate` — legacy-persistence migration command (Q5 resolution).
+ *
+ * Default mode (no flag): READ-ONLY. Loads the four legacy JSON files into
+ * the new SessionRegistry's in-memory map, reports counts, exits 0. Legacy
+ * files remain untouched. Idempotent — safe to run repeatedly.
+ *
+ * `--commit`: DESTRUCTIVE. After successful read, deletes the four legacy
+ * files. The v1.0.0 release blocks on A1 running `--commit` on both laptops.
+ *
+ * `--dry-run`: synonym for default (no-flag) — emitted for parity with
+ * `openclaw doctor --fix` UX expectations. No deletion, no writes, only counts.
+ */
+import { Command } from 'commander';
+import { existsSync, unlinkSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { MigrationV0 } from '../persistence/migration-v0.js';
+import { SessionRegistry } from '../persistence/session-registry.js';
+const HOME = homedir();
+const OPENCLAW_ROOT = join(HOME, '.openclaw');
+const LEGACY_PATHS = [
+    join(OPENCLAW_ROOT, 'claude-sessions.json'),
+    join(OPENCLAW_ROOT, 'savvy-resume-registry.json'),
+    join(OPENCLAW_ROOT, 'session-pids.json'),
+    join(OPENCLAW_ROOT, 'openclaw-cache-parity-registry.json'),
+];
+/**
+ * Pure function — runs the migration, returns counts. Splits the side-effects
+ * (file deletion + console output) from the read so the test surface stays clean.
+ */
+export async function runMigrate(opts = {}) {
+    const migration = new MigrationV0();
+    const registry = new SessionRegistry();
+    const states = await migration.readLegacy();
+    for (const state of states)
+        registry.set(state);
+    if (!opts.commit) {
+        return { migratedCount: states.length, committed: false, deletedFiles: [] };
+    }
+    const deleted = [];
+    for (const path of LEGACY_PATHS) {
+        if (existsSync(path)) {
+            try {
+                unlinkSync(path);
+                deleted.push(path);
+            }
+            catch {
+                // best-effort; surface in the result for caller transparency
+            }
+        }
+    }
+    return { migratedCount: states.length, committed: true, deletedFiles: deleted };
+}
+export function createMigrateCommand() {
+    const cmd = new Command('migrate');
+    cmd.description('Migrate legacy 4-file persistence into SessionRegistry. Default is read-only; ' +
+        'pass --commit to delete the legacy files after a successful read.');
+    cmd.option('--commit', 'delete legacy files after successful read (destructive)');
+    cmd.option('--dry-run', 'read-only (synonym for default)');
+    cmd.action(async (opts) => {
+        const result = await runMigrate({ commit: opts.commit === true });
+        if (result.committed) {
+            console.log(`migrated ${result.migratedCount} session(s); deleted ${result.deletedFiles.length} legacy file(s):`);
+            for (const f of result.deletedFiles)
+                console.log(`  - ${f}`);
+        }
+        else {
+            console.log(`migrated ${result.migratedCount} session(s) (read-only; legacy files preserved).`);
+            console.log(`Re-run with --commit on both laptops to delete legacy files.`);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=migrate.js.map

package/dist/src/cli/migrate.js.map

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