@a1hvdy/cc-openclaw 0.11.0 → 0.13.0

package/dist/src/cli/doctor.js

@@ -12,133 +12,29 @@
  * Future planes add checks via the exported `ALL_CHECKS` registry.
  */
 import { Command } from 'commander';
-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/) and vitest (src/cli/) 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. SELF_VERSION is
-// display-only; an 'unknown' fallback is acceptable for the doctor surface.
-let SELF_VERSION;
-try {
-    const _thisDir = dirname(fileURLToPath(import.meta.url));
-    const _projectRoot = findProjectRoot(_thisDir);
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-    const selfPkg = JSON.parse(readFileSync(join(_projectRoot, 'package.json'), 'utf8'));
-    SELF_VERSION = String(selfPkg.version ?? 'unknown');
-}
-catch {
-    SELF_VERSION = 'unknown';
-}
-// ── Install-path candidates ──────────────────────────────────────────────────
-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'),
-];
-// ── Check 1: install path resolution ────────────────────────────────────────
-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 {
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-            const installedPkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-            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: selfVersion,
-                mismatch,
-            },
-        };
-    }
-    return {
-        id,
-        status: 'fail',
-        detail: {
-            candidatesSearched: INSTALL_CANDIDATES,
-            error: 'cc-openclaw not found in any known openclaw extension path',
-        },
-    };
-}
-// ── Check 2: bridge wiring detection ────────────────────────────────────────
-const EXPECTED_BRIDGE_MODES = ['Embedded', 'PerMessage', 'NativeStream', 'OpenClawNative'];
-export async function checkBridgeWiring() {
-    const id = 'check_bridge_wiring';
-    let factory;
-    try {
-        // Dynamic import — soft-fail if the file doesn't exist yet.
-        // The bridge coder is working on this in parallel; pending is correct.
-        // The specifier is intentionally held in a variable so tsc does not
-        // attempt static resolution of the not-yet-created module.
-        factory = (await import('../openai-compat/bridges/factory.js'));
-    }
-    catch (err) {
-        const matchesNotFound = (e) => e instanceof Error &&
-            ('code' in e
-                ? e.code === 'ERR_MODULE_NOT_FOUND'
-                : e.message.includes('Cannot find module') ||
-                    e.message.includes('ERR_MODULE_NOT_FOUND'));
-        const isNotFound = matchesNotFound(err) || matchesNotFound(err.cause);
-        if (isNotFound) {
-            return {
-                id,
-                status: 'pending',
-                detail: { reason: 'bridge module not yet shipped' },
-            };
-        }
-        return {
-            id,
-            status: 'fail',
-            detail: { error: err instanceof Error ? err.message : String(err) },
-        };
-    }
-    const missingBridges = EXPECTED_BRIDGE_MODES.filter((mode) => !(mode in factory));
-    return {
-        id,
-        status: missingBridges.length === 0 ? 'pass' : 'fail',
-        detail: {
-            bridges: EXPECTED_BRIDGE_MODES.filter((m) => m in factory),
-            missingBridges,
-        },
-    };
-}
+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')
@@ -167,8 +63,11 @@ export function createDoctorCommand() {
         .option('--json', 'emit results as a single JSON line')
         .action(async (opts) => {
         const results = [];
-        results.push(checkInstallPath());
-        results.push(await checkBridgeWiring());
+        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;

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

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

package/dist/src/cli/index.js

@@ -7,6 +7,7 @@
  */
 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';
@@ -23,15 +24,14 @@ function findProjectRoot(startDir) {
     throw new Error('cc-openclaw: could not locate project root package.json');
 }
 const _root = findProjectRoot(dirname(fileURLToPath(import.meta.url)));
-// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
 const pkg = JSON.parse(readFileSync(join(_root, 'package.json'), 'utf8'));
 const program = new Command();
 program
     .name('cc-openclaw')
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
     .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);

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

@@ -1 +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,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;AACvE,mEAAmE;AACnE,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;IACpB,sEAAsE;KACrE,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;AAE1C,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"}
+{"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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"}

package/dist/src/config/drift-detector.d.ts

@@ -0,0 +1,28 @@
+/**
+ * drift-detector — snapshots the parsed Config to disk on a healthy boot;
+ * compares on subsequent boots and returns a delta list.
+ *
+ * Primary purpose: detect keys pruned by `openclaw doctor --fix`
+ * (OF5 — feedback_cc_openclaw_provider_timeout.md).
+ *
+ * Snapshot path: ~/.openclaw/workspace/memory/cc-openclaw-config-snapshot.json
+ * The file is written atomically (write-then-rename is not available in pure
+ * Node ESM without extra deps; we write directly since the worst case is a
+ * corrupted snapshot — non-fatal; falls back to empty baseline).
+ */
+import type { Config } from './schema.js';
+export interface ConfigDelta {
+    path: string;
+    previous: unknown;
+    current: unknown;
+}
+/**
+ * Compare current config against the on-disk snapshot.
+ * Returns an array of changed paths (empty = no drift).
+ */
+export declare function detectDrift(current: Config): ConfigDelta[];
+/**
+ * Persist current config as the baseline snapshot for future drift detection.
+ * Called at the end of a successful boot (after phase 7 / ready state).
+ */
+export declare function saveSnapshot(current: Config): void;

package/dist/src/config/drift-detector.js

@@ -0,0 +1,75 @@
+/**
+ * drift-detector — snapshots the parsed Config to disk on a healthy boot;
+ * compares on subsequent boots and returns a delta list.
+ *
+ * Primary purpose: detect keys pruned by `openclaw doctor --fix`
+ * (OF5 — feedback_cc_openclaw_provider_timeout.md).
+ *
+ * Snapshot path: ~/.openclaw/workspace/memory/cc-openclaw-config-snapshot.json
+ * The file is written atomically (write-then-rename is not available in pure
+ * Node ESM without extra deps; we write directly since the worst case is a
+ * corrupted snapshot — non-fatal; falls back to empty baseline).
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+const SNAPSHOT_PATH = join(homedir(), '.openclaw', 'workspace', 'memory', 'cc-openclaw-config-snapshot.json');
+// ── Internal helpers ──────────────────────────────────────────────────────────
+function flattenConfig(obj, prefix = '') {
+    if (obj === null || typeof obj !== 'object') {
+        return { [prefix]: obj };
+    }
+    const result = {};
+    for (const [k, v] of Object.entries(obj)) {
+        const key = prefix ? `${prefix}.${k}` : k;
+        if (v !== null && typeof v === 'object' && !Array.isArray(v)) {
+            Object.assign(result, flattenConfig(v, key));
+        }
+        else {
+            result[key] = v;
+        }
+    }
+    return result;
+}
+function readSnapshot() {
+    if (!existsSync(SNAPSHOT_PATH))
+        return {};
+    try {
+        const raw = readFileSync(SNAPSHOT_PATH, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+// ── Public API ────────────────────────────────────────────────────────────────
+/**
+ * Compare current config against the on-disk snapshot.
+ * Returns an array of changed paths (empty = no drift).
+ */
+export function detectDrift(current) {
+    const previous = readSnapshot();
+    const flat = flattenConfig(current);
+    const deltas = [];
+    for (const [path, value] of Object.entries(flat)) {
+        if (path in previous && JSON.stringify(previous[path]) !== JSON.stringify(value)) {
+            deltas.push({ path, previous: previous[path], current: value });
+        }
+    }
+    return deltas;
+}
+/**
+ * Persist current config as the baseline snapshot for future drift detection.
+ * Called at the end of a successful boot (after phase 7 / ready state).
+ */
+export function saveSnapshot(current) {
+    try {
+        mkdirSync(dirname(SNAPSHOT_PATH), { recursive: true });
+        const flat = flattenConfig(current);
+        writeFileSync(SNAPSHOT_PATH, JSON.stringify(flat, null, 2), 'utf8');
+    }
+    catch {
+        // Non-fatal: drift detection degrades to "no baseline" on next boot.
+    }
+}
+//# sourceMappingURL=drift-detector.js.map

package/dist/src/config/drift-detector.js.map

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

package/dist/src/config/loader.d.ts

@@ -0,0 +1,8 @@
+/**
+ * loadConfigSources — reads env vars + ~/.openclaw/openclaw.json, returns a
+ * raw object for ConfigSchema.parse().
+ *
+ * Does NOT throw on missing files — caller receives defaults via zod.
+ * Throws ConfigInvalid only when ConfigSchema.parse() rejects (via boot phase 1).
+ */
+export declare function loadConfigSources(): Record<string, unknown>;

package/dist/src/config/loader.js

@@ -0,0 +1,69 @@
+/**
+ * loadConfigSources — reads env vars + ~/.openclaw/openclaw.json, returns a
+ * raw object for ConfigSchema.parse().
+ *
+ * Does NOT throw on missing files — caller receives defaults via zod.
+ * Throws ConfigInvalid only when ConfigSchema.parse() rejects (via boot phase 1).
+ */
+import { existsSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+const OPENCLAW_JSON_PATH = join(homedir(), '.openclaw', 'openclaw.json');
+function readOpenClawJson() {
+    if (!existsSync(OPENCLAW_JSON_PATH))
+        return {};
+    try {
+        const raw = readFileSync(OPENCLAW_JSON_PATH, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+function parseBoolEnv(key, fallback = false) {
+    const val = process.env[key];
+    if (val === undefined)
+        return fallback;
+    return val === '1' || val === 'true';
+}
+function parseIntEnv(key, fallback) {
+    const val = process.env[key];
+    if (val === undefined)
+        return fallback;
+    const n = parseInt(val, 10);
+    return isNaN(n) ? fallback : n;
+}
+// ── Main ──────────────────────────────────────────────────────────────────────
+export function loadConfigSources() {
+    const oclJson = readOpenClawJson();
+    // Extract timeoutSeconds from models.providers["cc-openclaw"].timeoutSeconds
+    const ccProvider = oclJson.models?.providers?.['cc-openclaw'];
+    const timeoutSeconds = ccProvider?.timeoutSeconds ??
+        parseIntEnv('CC_OPENCLAW_TIMEOUT_SECONDS');
+    // Extract fallback chain from agents.defaults.model.fallbacks
+    const fallbackChain = oclJson.agents?.defaults?.model?.fallbacks ?? [];
+    return {
+        openclawCcOpenclawActive: parseBoolEnv('OPENCLAW_CC_OPENCLAW_ACTIVE'),
+        openclawCcOpenclawListeners: parseBoolEnv('OPENCLAW_CC_OPENCLAW_LISTENERS'),
+        ccOpenclaw: {
+            nativeTools: {
+                enabled: parseBoolEnv('CC_OPENCLAW_NATIVE_TOOLS', true),
+                // allowList not env-driven; comes from schema default (Q1)
+            },
+            stalledKillMs: parseIntEnv('CC_OPENCLAW_STALLED_KILL_MS'),
+            loopMaxSubprocs: parseIntEnv('CC_OPENCLAW_LOOP_MAX_SUBPROCS'),
+            cacheParity: parseBoolEnv('OPENCLAW_CACHE_PARITY', true),
+            ttsAutoMode: process.env['OPENCLAW_TTS_AUTO_MODE'],
+        },
+        openclawJson: {
+            timeoutSeconds,
+            messagesTts: {
+                timeoutMs: oclJson.messages?.tts?.timeoutMs,
+                maxTextLength: oclJson.messages?.tts?.maxTextLength,
+            },
+            fallbackChain,
+            pluginsAllow: oclJson.plugins?.allow ?? [],
+        },
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;AA0BzE,SAAS,gBAAgB;IACvB,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,QAAQ,GAAG,KAAK;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACvC,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,MAAM,CAAC;AACvC,CAAC;AAED,SAAS,WAAW,CAAC,GAAW,EAAE,QAAiB;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACvC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IAEnC,6EAA6E;IAC7E,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,aAAa,CAAC,CAAC;IAC9D,MAAM,cAAc,GAClB,UAAU,EAAE,cAAc;QAC1B,WAAW,CAAC,6BAA6B,CAAC,CAAC;IAE7C,8DAA8D;IAC9D,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAEvE,OAAO;QACL,wBAAwB,EAAE,YAAY,CAAC,6BAA6B,CAAC;QACrE,2BAA2B,EAAE,YAAY,CAAC,gCAAgC,CAAC;QAC3E,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,OAAO,EAAE,YAAY,CAAC,0BAA0B,EAAE,IAAI,CAAC;gBACvD,2DAA2D;aAC5D;YACD,aAAa,EAAE,WAAW,CAAC,6BAA6B,CAAC;YACzD,eAAe,EAAE,WAAW,CAAC,+BAA+B,CAAC;YAC7D,WAAW,EAAE,YAAY,CAAC,uBAAuB,EAAE,IAAI,CAAC;YACxD,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;SACnD;QACD,YAAY,EAAE;YACZ,cAAc;YACd,WAAW,EAAE;gBACX,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,SAAS;gBAC3C,aAAa,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa;aACpD;YACD,aAAa;YACb,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;SAC3C;KACF,CAAC;AACJ,CAAC"}