@a1hvdy/cc-openclaw 0.11.0 → 0.12.0

package/dist/src/cli/checks/bridge-wiring.js

@@ -0,0 +1,64 @@
+/**
+ * `check_bridge_wiring` — verifies the openai-compat bridge factory is
+ * structurally composed (Phase 5 Bridge Plane v0.11.0 contract).
+ *
+ * Dual-shape support:
+ *   - Modern: `factory.ts` exports `makeToolBridge` + `activeToolMode`
+ *   - Legacy: `factory.ts` exports `Embedded`/`PerMessage`/`NativeStream`/
+ *     `OpenClawNative` directly (preserves pre-existing test mocks)
+ *
+ * Extracted from `doctor.ts` 2026-05-13 to keep that file under the
+ * 500-LOC ceiling.
+ */
+const EXPECTED_FACTORY_EXPORTS = ['makeToolBridge', 'activeToolMode'];
+const LEGACY_BRIDGE_MODES = ['Embedded', 'PerMessage', 'NativeStream', 'OpenClawNative'];
+export async function checkBridgeWiring() {
+    const id = 'check_bridge_wiring';
+    let factory;
+    try {
+        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) },
+        };
+    }
+    // Modern factory shape: makeToolBridge + activeToolMode.
+    const presentFactory = EXPECTED_FACTORY_EXPORTS.filter((n) => n in factory);
+    if (presentFactory.length === EXPECTED_FACTORY_EXPORTS.length) {
+        return {
+            id,
+            status: 'pass',
+            detail: { factoryExports: presentFactory, missingBridges: [] },
+        };
+    }
+    // Legacy shape: all 4 bridge-mode names as direct exports.
+    const presentLegacyModes = LEGACY_BRIDGE_MODES.filter((m) => m in factory);
+    const missingBridges = LEGACY_BRIDGE_MODES.filter((m) => !(m in factory));
+    if (presentLegacyModes.length === LEGACY_BRIDGE_MODES.length) {
+        return { id, status: 'pass', detail: { bridges: presentLegacyModes, missingBridges: [] } };
+    }
+    return {
+        id,
+        status: 'fail',
+        detail: {
+            factoryExports: presentFactory,
+            bridges: presentLegacyModes,
+            missingBridges,
+            remediation: `factory.ts must export either ${EXPECTED_FACTORY_EXPORTS.join('+')} (modern) ` +
+                `or all of ${LEGACY_BRIDGE_MODES.join(',')} (legacy test shape)`,
+        },
+    };
+}
+//# sourceMappingURL=bridge-wiring.js.map

package/dist/src/cli/checks/bridge-wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-wiring.js","sourceRoot":"","sources":["../../../../src/cli/checks/bridge-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,wBAAwB,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,CAAU,CAAC;AAC/E,MAAM,mBAAmB,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,CAAU,CAAC;AAElG,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,EAAE,GAAG,qBAAqB,CAAC;IAEjC,IAAI,OAAgC,CAAC;IACrC,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,MAAM,MAAM,CAAC,wCAAwC,CAAC,CAA4B,CAAC;IAChG,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,eAAe,GAAG,CAAC,CAAU,EAAW,EAAE,CAC9C,CAAC,YAAY,KAAK;YAClB,CAAC,MAAM,IAAI,CAAC;gBACV,CAAC,CAAE,CAA2B,CAAC,IAAI,KAAK,sBAAsB;gBAC9D,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;oBACxC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAClD,MAAM,UAAU,GACd,eAAe,CAAC,GAAG,CAAC,IAAI,eAAe,CAAE,GAA2B,CAAC,KAAK,CAAC,CAAC;QAC9E,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,+BAA+B,EAAE,EAAE,CAAC;QACxF,CAAC;QACD,OAAO;YACL,EAAE;YACF,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SACpE,CAAC;IACJ,CAAC;IAED,yDAAyD;IACzD,MAAM,cAAc,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC;IAC5E,IAAI,cAAc,CAAC,MAAM,KAAK,wBAAwB,CAAC,MAAM,EAAE,CAAC;QAC9D,OAAO;YACL,EAAE;YACF,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,EAAE,EAAE;SAC/D,CAAC;IACJ,CAAC;IAED,2DAA2D;IAC3D,MAAM,kBAAkB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC;IAC3E,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC;IAC1E,IAAI,kBAAkB,CAAC,MAAM,KAAK,mBAAmB,CAAC,MAAM,EAAE,CAAC;QAC7D,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,EAAE,EAAE,EAAE,CAAC;IAC7F,CAAC;IAED,OAAO;QACL,EAAE;QACF,MAAM,EAAE,MAAM;QACd,MAAM,EAAE;YACN,cAAc,EAAE,cAAc;YAC9B,OAAO,EAAE,kBAAkB;YAC3B,cAAc;YACd,WAAW,EACT,iCAAiC,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY;gBAC/E,aAAa,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAsB;SACnE;KACF,CAAC;AACJ,CAAC"}

package/dist/src/cli/checks/config-schema.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `check_config_schema` — boot phase 1 dry-run.
+ *
+ * Parses env + ~/.openclaw/openclaw.json via the v1.0.0 typed `ConfigSchema`.
+ * Surfaces zod validation issues with phase-keyed remediation.
+ *
+ * Extracted from `doctor.ts` 2026-05-13 to keep that file under the
+ * 500-LOC ceiling.
+ */
+import type { CheckResult } from './patch-scaffold.js';
+export declare function checkConfigSchema(): CheckResult;

package/dist/src/cli/checks/config-schema.js

@@ -0,0 +1,51 @@
+/**
+ * `check_config_schema` — boot phase 1 dry-run.
+ *
+ * Parses env + ~/.openclaw/openclaw.json via the v1.0.0 typed `ConfigSchema`.
+ * Surfaces zod validation issues with phase-keyed remediation.
+ *
+ * Extracted from `doctor.ts` 2026-05-13 to keep that file under the
+ * 500-LOC ceiling.
+ */
+import { ConfigSchema } from '../../config/schema.js';
+import { loadConfigSources } from '../../config/loader.js';
+export function checkConfigSchema() {
+    const id = 'check_config_schema';
+    try {
+        const raw = loadConfigSources();
+        const result = ConfigSchema.safeParse(raw);
+        if (result.success) {
+            return {
+                id,
+                status: 'pass',
+                detail: {
+                    openclawCcOpenclawActive: result.data.openclawCcOpenclawActive,
+                    openclawCcOpenclawListeners: result.data.openclawCcOpenclawListeners,
+                    nativeToolsEnabled: result.data.ccOpenclaw.nativeTools.enabled,
+                    nativeToolsAllowListSize: result.data.ccOpenclaw.nativeTools.allowList.length,
+                },
+            };
+        }
+        return {
+            id,
+            status: 'fail',
+            detail: {
+                phase: 'validate-config',
+                issues: result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`),
+                remediation: 'fix the listed config issues in ~/.openclaw/openclaw.json or env vars; ' +
+                    'see ConfigSchema in src/config/schema.ts for required shapes',
+            },
+        };
+    }
+    catch (err) {
+        return {
+            id,
+            status: 'fail',
+            detail: {
+                phase: 'validate-config',
+                error: err instanceof Error ? err.message : String(err),
+            },
+        };
+    }
+}
+//# sourceMappingURL=config-schema.js.map

package/dist/src/cli/checks/config-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../../../src/cli/checks/config-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,MAAM,UAAU,iBAAiB;IAC/B,MAAM,EAAE,GAAG,qBAAqB,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO;gBACL,EAAE;gBACF,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE;oBACN,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,wBAAwB;oBAC9D,2BAA2B,EAAE,MAAM,CAAC,IAAI,CAAC,2BAA2B;oBACpE,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO;oBAC9D,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM;iBAC9E;aACF,CAAC;QACJ,CAAC;QACD,OAAO;YACL,EAAE;YACF,MAAM,EAAE,MAAM;YACd,MAAM,EAAE;gBACN,KAAK,EAAE,iBAAiB;gBACxB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC3E,WAAW,EACT,yEAAyE;oBACzE,8DAA8D;aACjE;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE;YACF,MAAM,EAAE,MAAM;YACd,MAAM,EAAE;gBACN,KAAK,EAAE,iBAAiB;gBACxB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/cli/checks/critical-openclaw-json-keys.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `check_critical_openclaw_json_keys` — OF5 drift-detection check.
+ *
+ * Validates the 4 load-bearing operational keys that `openclaw doctor --fix`
+ * has historically pruned. Each prune has caused a P1 incident:
+ *
+ *   - models.providers["cc-openclaw"].timeoutSeconds ≥ 900
+ *     (feedback_cc_openclaw_provider_timeout.md)
+ *   - messages.tts.timeoutMs = 120000 (Chatterbox CPU ceiling)
+ *     (feedback_openclaw_tts_timeout_chatterbox.md)
+ *   - agents.defaults.model.fallbacks ends with "openai-codex/gpt-5.4"
+ *     (feedback_cc_openclaw_cross_engine_fallback.md)
+ *   - plugins.allow includes "cc-openclaw"
+ *     (feedback_openclaw_plugins_allow_trumps.md)
+ *
+ * Extracted from `doctor.ts` 2026-05-13 to keep that file under the
+ * 500-LOC ceiling. Read directly via raw JSON.parse — bypasses openclaw's
+ * loadConfig schema validation (Phase E#3 finding 4).
+ */
+import type { CheckResult } from './patch-scaffold.js';
+export declare function checkCriticalOpenclawJsonKeys(): CheckResult;

package/dist/src/cli/checks/critical-openclaw-json-keys.js

@@ -0,0 +1,106 @@
+/**
+ * `check_critical_openclaw_json_keys` — OF5 drift-detection check.
+ *
+ * Validates the 4 load-bearing operational keys that `openclaw doctor --fix`
+ * has historically pruned. Each prune has caused a P1 incident:
+ *
+ *   - models.providers["cc-openclaw"].timeoutSeconds ≥ 900
+ *     (feedback_cc_openclaw_provider_timeout.md)
+ *   - messages.tts.timeoutMs = 120000 (Chatterbox CPU ceiling)
+ *     (feedback_openclaw_tts_timeout_chatterbox.md)
+ *   - agents.defaults.model.fallbacks ends with "openai-codex/gpt-5.4"
+ *     (feedback_cc_openclaw_cross_engine_fallback.md)
+ *   - plugins.allow includes "cc-openclaw"
+ *     (feedback_openclaw_plugins_allow_trumps.md)
+ *
+ * Extracted from `doctor.ts` 2026-05-13 to keep that file under the
+ * 500-LOC ceiling. Read directly via raw JSON.parse — bypasses openclaw's
+ * loadConfig schema validation (Phase E#3 finding 4).
+ */
+import { existsSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+export function checkCriticalOpenclawJsonKeys() {
+    const id = 'check_critical_openclaw_json_keys';
+    const path = join(homedir(), '.openclaw', 'openclaw.json');
+    if (!existsSync(path)) {
+        return {
+            id,
+            status: 'fail',
+            detail: { path, error: 'openclaw.json not found' },
+        };
+    }
+    let json;
+    try {
+        json = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch (err) {
+        return {
+            id,
+            status: 'fail',
+            detail: { path, error: err instanceof Error ? err.message : String(err) },
+        };
+    }
+    if (typeof json !== 'object' || json === null) {
+        return { id, status: 'fail', detail: { path, error: 'top-level is not an object' } };
+    }
+    const root = json;
+    const issues = [];
+    // Key 1: timeoutSeconds
+    const models = root['models'];
+    const providers = models?.['providers'];
+    const ccProvider = providers?.['cc-openclaw'];
+    const timeoutSeconds = ccProvider?.['timeoutSeconds'];
+    if (typeof timeoutSeconds !== 'number' || timeoutSeconds < 900) {
+        issues.push(`models.providers["cc-openclaw"].timeoutSeconds must be ≥ 900 (got ${String(timeoutSeconds)})`);
+    }
+    // Key 2: messages.tts.timeoutMs
+    const messages = root['messages'];
+    const tts = messages?.['tts'];
+    const timeoutMs = tts?.['timeoutMs'];
+    if (typeof timeoutMs !== 'number' || timeoutMs < 120_000) {
+        issues.push(`messages.tts.timeoutMs must be ≥ 120000 (got ${String(timeoutMs)}); ` +
+            'Chatterbox CPU synthesis needs the full 120s schema cap');
+    }
+    // Key 3: fallback chain ends with gpt-5.4
+    const agents = root['agents'];
+    const defaults = agents?.['defaults'];
+    const model = defaults?.['model'];
+    const fallbacks = model?.['fallbacks'];
+    const lastFallback = Array.isArray(fallbacks) ? fallbacks[fallbacks.length - 1] : undefined;
+    if (lastFallback !== 'openai-codex/gpt-5.4') {
+        issues.push(`agents.defaults.model.fallbacks must end with "openai-codex/gpt-5.4" ` +
+            `(got "${String(lastFallback)}"); cross-engine escape required when same-pipeline cc-openclaw fails`);
+    }
+    // Key 4: plugins.allow contains cc-openclaw
+    const plugins = root['plugins'];
+    const allow = plugins?.['allow'];
+    const allowList = Array.isArray(allow) ? allow : [];
+    if (!allowList.includes('cc-openclaw')) {
+        issues.push('plugins.allow must include "cc-openclaw" (otherwise enabledByDefault is overridden)');
+    }
+    if (issues.length === 0) {
+        return {
+            id,
+            status: 'pass',
+            detail: {
+                path,
+                timeoutSeconds,
+                timeoutMs,
+                fallbackChainEndsAtGpt54: true,
+                ccOpenclawInPluginsAllow: true,
+            },
+        };
+    }
+    return {
+        id,
+        status: 'fail',
+        detail: {
+            path,
+            issues,
+            remediation: 'these keys have a history of being pruned by `openclaw doctor --fix`; ' +
+                're-apply them via direct openclaw.json edit',
+        },
+    };
+}
+//# sourceMappingURL=critical-openclaw-json-keys.js.map

package/dist/src/cli/checks/critical-openclaw-json-keys.js.map

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

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":"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"}

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

@@ -12,13 +12,9 @@
  * Future planes add checks via the exported `ALL_CHECKS` registry.
  */
 import { Command } from 'commander';
-type CheckStatus = 'pass' | 'fail' | 'pending';
-interface CheckResult {
-    id: string;
-    status: CheckStatus;
-    detail: Record<string, unknown>;
-}
-export declare function checkInstallPath(selfVersion?: string): CheckResult;
-export declare function checkBridgeWiring(): Promise<CheckResult>;
+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;
-export {};