@jstn-sdk/rcs 0.1.0

package/dist/adapt/index.js

@@ -0,0 +1,293 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { readLatestPlanningArtifacts } from "../planning/artifacts.js";
+import { ADAPT_SCHEMA_VERSION, } from "./contracts.js";
+import { applyHermesEnvelope, applyHermesProbe, applyHermesStatus, buildHermesBootstrapMetadata, buildHermesRuntimeObservation, collectHermesEvidence, } from "./hermes.js";
+import { buildOpenClawDoctorReport, buildOpenClawEnvelope, buildOpenClawProbeReport, buildOpenClawStatusReport, initOpenClawFoundation, } from "./openclaw.js";
+import { resolveAdaptPaths } from "./paths.js";
+import { getAdaptTargetDescriptor, listAdaptTargets } from "./registry.js";
+const FOUNDATION_CONSTRAINTS = [
+    "Thin adapter surface only; no bidirectional control plane is claimed in this foundation PR.",
+    "No direct writes to .rcs/state/... or target runtime internals.",
+    "Capability reporting is asymmetric: RCS-owned, shared-contract, and target-observed surfaces are reported separately.",
+];
+function toIsoTimestamp(now = new Date()) {
+    return now.toISOString();
+}
+export function supportedAdaptTargets() {
+    return listAdaptTargets().map((descriptor) => descriptor.target);
+}
+export function buildAdaptPlanningLink(cwd) {
+    const selection = readLatestPlanningArtifacts(cwd);
+    if (!selection.prdPath) {
+        return {
+            prdPath: null,
+            testSpecPaths: [],
+            deepInterviewSpecPaths: [],
+            summary: "No canonical RCS PRD/test-spec artifacts are present in this worktree.",
+        };
+    }
+    const testSpecSummary = selection.testSpecPaths.length > 0
+        ? `${selection.testSpecPaths.length} matching test spec artifact(s) linked.`
+        : "PRD detected, but no matching test spec artifact was found for its slug.";
+    return {
+        prdPath: selection.prdPath,
+        testSpecPaths: selection.testSpecPaths,
+        deepInterviewSpecPaths: selection.deepInterviewSpecPaths,
+        summary: testSpecSummary,
+    };
+}
+export function buildAdaptEnvelope(cwd, target, now = new Date()) {
+    const descriptor = getAdaptTargetDescriptor(target);
+    if (!descriptor) {
+        throw new Error(`Unknown adapt target: ${target}`);
+    }
+    const paths = resolveAdaptPaths(cwd, target);
+    const planning = buildAdaptPlanningLink(cwd);
+    if (target === "openclaw") {
+        return buildOpenClawEnvelope(paths, planning, descriptor.capabilities, now);
+    }
+    return {
+        schemaVersion: ADAPT_SCHEMA_VERSION,
+        generatedAt: toIsoTimestamp(now),
+        target,
+        displayName: descriptor.displayName,
+        summary: descriptor.summary,
+        adapterPaths: paths,
+        planning,
+        capabilities: descriptor.capabilities,
+        constraints: FOUNDATION_CONSTRAINTS,
+    };
+}
+export async function buildAdaptEnvelopeForTarget(cwd, target, now = new Date()) {
+    const envelope = buildAdaptEnvelope(cwd, target, now);
+    if (target !== "hermes") {
+        return envelope;
+    }
+    return applyHermesEnvelope(envelope, await collectHermesEvidence(cwd));
+}
+export function buildAdaptProbeReport(cwd, target, now = new Date()) {
+    const descriptor = getAdaptTargetDescriptor(target);
+    if (!descriptor) {
+        throw new Error(`Unknown adapt target: ${target}`);
+    }
+    const paths = resolveAdaptPaths(cwd, target);
+    const planning = buildAdaptPlanningLink(cwd);
+    if (target === "openclaw") {
+        return buildOpenClawProbeReport(paths, planning, descriptor.capabilities, now);
+    }
+    return {
+        schemaVersion: ADAPT_SCHEMA_VERSION,
+        timestamp: toIsoTimestamp(now),
+        target,
+        phase: "foundation",
+        summary: `${descriptor.displayName} probe foundation is available, but target-specific runtime probing is deferred.`,
+        adapterPaths: paths,
+        planning,
+        capabilities: descriptor.capabilities,
+        targetRuntime: {
+            state: "not-implemented",
+            detail: descriptor.followupHint,
+        },
+        nextSteps: [
+            `Run rcs adapt ${target} init --write to materialize RCS-owned adapter artifacts.`,
+            descriptor.followupHint,
+        ],
+    };
+}
+export async function buildAdaptProbeReportForTarget(cwd, target, now = new Date()) {
+    const report = buildAdaptProbeReport(cwd, target, now);
+    if (target !== "hermes") {
+        return report;
+    }
+    return applyHermesProbe(report, await collectHermesEvidence(cwd));
+}
+export function buildAdaptStatusReport(cwd, target, now = new Date()) {
+    const descriptor = getAdaptTargetDescriptor(target);
+    if (!descriptor) {
+        throw new Error(`Unknown adapt target: ${target}`);
+    }
+    const paths = resolveAdaptPaths(cwd, target);
+    const initialized = existsSync(paths.configPath) && existsSync(paths.envelopePath);
+    const planning = buildAdaptPlanningLink(cwd);
+    if (target === "openclaw") {
+        return buildOpenClawStatusReport(paths, planning, descriptor.capabilities, now);
+    }
+    return {
+        schemaVersion: ADAPT_SCHEMA_VERSION,
+        timestamp: toIsoTimestamp(now),
+        target,
+        phase: "foundation",
+        summary: initialized
+            ? `${descriptor.displayName} adapter foundation is initialized under RCS-owned paths.`
+            : `${descriptor.displayName} adapter foundation has not been initialized yet.`,
+        adapter: {
+            state: initialized ? "initialized" : "not-initialized",
+            detail: initialized
+                ? "Adapter foundation artifacts exist under .rcs/adapters/<target>/..."
+                : "Run init --write to create RCS-owned adapter artifacts.",
+            configPath: paths.configPath,
+            envelopePath: paths.envelopePath,
+        },
+        targetRuntime: {
+            state: "unknown",
+            detail: descriptor.followupHint,
+        },
+        planning,
+        capabilities: descriptor.capabilities,
+    };
+}
+export async function buildAdaptStatusReportForTarget(cwd, target, now = new Date()) {
+    const report = buildAdaptStatusReport(cwd, target, now);
+    if (target !== "hermes") {
+        return report;
+    }
+    return applyHermesStatus(report, await collectHermesEvidence(cwd));
+}
+export function buildAdaptDoctorReport(cwd, target, now = new Date()) {
+    const descriptor = getAdaptTargetDescriptor(target);
+    if (!descriptor) {
+        throw new Error(`Unknown adapt target: ${target}`);
+    }
+    const status = buildAdaptStatusReport(cwd, target, now);
+    const planning = buildAdaptPlanningLink(cwd);
+    const issues = [];
+    if (target === "openclaw") {
+        return buildOpenClawDoctorReport(resolveAdaptPaths(cwd, target), planning, now);
+    }
+    if (status.adapter.state === "not-initialized") {
+        issues.push({
+            code: "adapter_not_initialized",
+            message: `No adapter foundation artifacts exist for ${target} under ${join(".rcs", "adapters", target)}.`,
+        });
+    }
+    if (!planning.prdPath) {
+        issues.push({
+            code: "planning_artifacts_missing",
+            message: "No canonical RCS PRD artifact is available to link into the adapter envelope.",
+        });
+    }
+    issues.push({
+        code: "target_specific_logic_deferred",
+        message: descriptor.followupHint,
+    });
+    return {
+        schemaVersion: ADAPT_SCHEMA_VERSION,
+        timestamp: toIsoTimestamp(now),
+        target,
+        phase: "foundation",
+        summary: `Foundation doctor for ${descriptor.displayName} reports only RCS-owned adapter readiness and shared planning linkage.`,
+        issues,
+        nextSteps: [
+            `Run rcs adapt ${target} init --write.`,
+            "Keep follow-on integration work out of .rcs/state/... and target runtime internals unless a reviewed contract exists.",
+            descriptor.followupHint,
+        ],
+    };
+}
+export async function buildAdaptDoctorReportForTarget(cwd, target, now = new Date()) {
+    const report = buildAdaptDoctorReport(cwd, target, now);
+    if (target !== "hermes") {
+        return report;
+    }
+    const evidence = await collectHermesEvidence(cwd);
+    const runtime = buildHermesRuntimeObservation(evidence);
+    const bootstrap = buildHermesBootstrapMetadata(evidence);
+    const issues = report.issues.filter((issue) => issue.code !== "target_specific_logic_deferred");
+    if (!evidence.installed) {
+        issues.push({
+            code: "hermes_runtime_missing",
+            message: `Hermes external runtime was not detected under ${evidence.hermesRoot}.`,
+        });
+    }
+    else if (!evidence.runtimeFiles.stateDbReadable) {
+        issues.push({
+            code: "hermes_session_store_unavailable",
+            message: `Hermes session store is not readable at ${evidence.runtimeFiles.stateDbPath}.`,
+        });
+    }
+    if (runtime.state === "degraded") {
+        issues.push({
+            code: "hermes_runtime_degraded",
+            message: runtime.detail,
+        });
+    }
+    return {
+        ...report,
+        summary: "Hermes doctor inspects external ACP, gateway, and session-store evidence plus RCS-owned adapter readiness.",
+        issues,
+        nextSteps: [
+            ...bootstrap.nextSteps,
+            ...report.nextSteps.filter((step) => !/follow-on integration gaps/i.test(step)),
+        ],
+    };
+}
+export function initAdaptFoundation(cwd, target, write = false, now = new Date()) {
+    const descriptor = getAdaptTargetDescriptor(target);
+    if (!descriptor) {
+        throw new Error(`Unknown adapt target: ${target}`);
+    }
+    const paths = resolveAdaptPaths(cwd, target);
+    const planning = buildAdaptPlanningLink(cwd);
+    if (target === "openclaw") {
+        return initOpenClawFoundation(paths, planning, descriptor.capabilities, write, now);
+    }
+    const envelope = buildAdaptEnvelope(cwd, target, now);
+    const envelopePaths = envelope.adapterPaths;
+    const previewPaths = [
+        envelopePaths.adapterRoot,
+        envelopePaths.configPath,
+        envelopePaths.envelopePath,
+        envelopePaths.reportsDir,
+        envelopePaths.probeReportPath,
+        envelopePaths.statusReportPath,
+    ];
+    const wrotePaths = [];
+    if (write) {
+        mkdirSync(envelopePaths.reportsDir, { recursive: true });
+        const config = {
+            schemaVersion: ADAPT_SCHEMA_VERSION,
+            target,
+            createdAt: toIsoTimestamp(now),
+            phase: "foundation",
+            summary: descriptor.summary,
+            followupHint: descriptor.followupHint,
+            constraints: FOUNDATION_CONSTRAINTS,
+        };
+        writeFileSync(envelopePaths.configPath, `${JSON.stringify(config, null, 2)}\n`, "utf-8");
+        writeFileSync(envelopePaths.envelopePath, `${JSON.stringify(envelope, null, 2)}\n`, "utf-8");
+        wrotePaths.push(envelopePaths.configPath, envelopePaths.envelopePath);
+    }
+    return {
+        schemaVersion: ADAPT_SCHEMA_VERSION,
+        timestamp: toIsoTimestamp(now),
+        target,
+        write,
+        summary: write
+            ? `${descriptor.displayName} adapter foundation was written under RCS-owned paths.`
+            : `${descriptor.displayName} adapter foundation preview is ready; rerun with --write to materialize it.`,
+        previewPaths,
+        wrotePaths,
+        envelope,
+    };
+}
+export async function initAdaptFoundationForTarget(cwd, target, write = false, now = new Date()) {
+    const result = initAdaptFoundation(cwd, target, write, now);
+    if (target !== "hermes") {
+        return result;
+    }
+    const evidence = await collectHermesEvidence(cwd);
+    const envelope = applyHermesEnvelope(result.envelope, evidence);
+    if (write) {
+        const paths = envelope.adapterPaths;
+        writeFileSync(paths.envelopePath, `${JSON.stringify(envelope, null, 2)}\n`, "utf-8");
+    }
+    return {
+        ...result,
+        envelope,
+        summary: write
+            ? "Hermes adapter metadata was written under RCS-owned paths with external runtime evidence."
+            : "Hermes adapter metadata preview includes external ACP/gateway/session-store evidence; rerun with --write to materialize it.",
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/adapt/index.js.map

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

package/dist/adapt/openclaw.d.ts

@@ -0,0 +1,7 @@
+import type { AdaptCapabilityReport, AdaptDoctorReport, AdaptEnvelope, AdaptInitResult, AdaptPathSet, AdaptPlanningLink, AdaptProbeReport, AdaptStatusReport } from "./contracts.js";
+export declare function buildOpenClawEnvelope(paths: AdaptPathSet, planning: AdaptPlanningLink, capabilities: AdaptCapabilityReport[], now: Date): AdaptEnvelope;
+export declare function buildOpenClawProbeReport(paths: AdaptPathSet, planning: AdaptPlanningLink, capabilities: AdaptCapabilityReport[], now: Date): AdaptProbeReport;
+export declare function buildOpenClawStatusReport(paths: AdaptPathSet, planning: AdaptPlanningLink, capabilities: AdaptCapabilityReport[], now: Date): AdaptStatusReport;
+export declare function buildOpenClawDoctorReport(paths: AdaptPathSet, planning: AdaptPlanningLink, now: Date): AdaptDoctorReport;
+export declare function initOpenClawFoundation(paths: AdaptPathSet, planning: AdaptPlanningLink, capabilities: AdaptCapabilityReport[], write: boolean, now: Date): AdaptInitResult;
+//# sourceMappingURL=openclaw.d.ts.map

package/dist/adapt/openclaw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw.d.ts","sourceRoot":"","sources":["../../src/adapt/openclaw.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,eAAe,EAIf,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,MAAM,gBAAgB,CAAC;AA6JxB,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,YAAY,EAAE,qBAAqB,EAAE,EACrC,GAAG,EAAE,IAAI,GACP,aAAa,CAmBf;AAED,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,YAAY,EAAE,qBAAqB,EAAE,EACrC,GAAG,EAAE,IAAI,GACP,gBAAgB,CA4BlB;AAED,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,YAAY,EAAE,qBAAqB,EAAE,EACrC,GAAG,EAAE,IAAI,GACP,iBAAiB,CA6BnB;AAED,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,GAAG,EAAE,IAAI,GACP,iBAAiB,CAgEnB;AAED,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,YAAY,EAAE,qBAAqB,EAAE,EACrC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,IAAI,GACP,eAAe,CAoDjB"}

package/dist/adapt/openclaw.js

@@ -0,0 +1,299 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { inspectOpenClawConfig, resolveGateway } from "../openclaw/config.js";
+import { ADAPT_SCHEMA_VERSION } from "./contracts.js";
+const OPENCLAW_HOOK_EVENTS = [
+    "session-start",
+    "session-end",
+    "session-idle",
+    "ask-user-question",
+    "stop",
+];
+const OPENCLAW_LIFECYCLE_BRIDGE = [
+    { rcsEvent: "session-start", openclawEvent: "session-start" },
+    { rcsEvent: "session-end", openclawEvent: "session-end" },
+    { rcsEvent: "session-idle", openclawEvent: "session-idle" },
+    { rcsEvent: "ask-user-question", openclawEvent: "ask-user-question" },
+    { rcsEvent: "session-stop", openclawEvent: "stop" },
+];
+function summarizeObservedState(metadata) {
+    switch (metadata.observedState) {
+        case "configured":
+            return `OpenClaw local adapter evidence is present with ${metadata.gateways.length} configured gateway(s) and ${metadata.hooks.filter((hook) => hook.status === "wired").length} wired hook mapping(s).`;
+        case "degraded":
+            return "OpenClaw local adapter evidence is partial; config is present but at least one mapped hook is locally blocked.";
+        case "disabled":
+            return "OpenClaw is disabled locally because RCS_OPENCLAW=1 is not set.";
+        case "missing-config":
+            return "OpenClaw is enabled, but no usable local config file was found.";
+        case "invalid-config":
+            return "OpenClaw config evidence exists, but it is invalid or incomplete.";
+        default:
+            return "OpenClaw has no local config or gateway evidence yet.";
+    }
+}
+function observeOpenClaw(paths, planning) {
+    const inspection = inspectOpenClawConfig();
+    const gateways = [];
+    const hooks = [];
+    if (inspection.config) {
+        for (const [name, gateway] of Object.entries(inspection.config.gateways)) {
+            const type = gateway.type === "command" ? "command" : "http";
+            gateways.push({
+                name,
+                type,
+                configured: type === "command"
+                    ? Boolean("command" in gateway && gateway.command)
+                    : Boolean("url" in gateway && gateway.url),
+                commandGateRequired: type === "command",
+                commandGateEnabled: type === "command" ? inspection.commandGateEnabled : false,
+                timeoutMs: typeof gateway.timeout === "number" ? gateway.timeout : null,
+            });
+        }
+        for (const event of OPENCLAW_HOOK_EVENTS) {
+            const mapping = inspection.config.hooks[event];
+            if (!mapping || !mapping.enabled) {
+                hooks.push({
+                    event,
+                    gateway: null,
+                    gatewayType: null,
+                    status: "unmapped",
+                    detail: "No enabled OpenClaw mapping exists for this event.",
+                });
+                continue;
+            }
+            const resolved = resolveGateway(inspection.config, event);
+            if (!resolved) {
+                hooks.push({
+                    event,
+                    gateway: mapping.gateway,
+                    gatewayType: null,
+                    status: "blocked",
+                    detail: "The hook mapping exists, but the referenced gateway is missing or disabled locally.",
+                });
+                continue;
+            }
+            const gatewayType = resolved.gateway.type === "command" ? "command" : "http";
+            if (gatewayType === "command" && !inspection.commandGateEnabled) {
+                hooks.push({
+                    event,
+                    gateway: resolved.gatewayName,
+                    gatewayType,
+                    status: "blocked",
+                    detail: "Mapped to a command gateway, but RCS_OPENCLAW_COMMAND=1 is not set.",
+                });
+                continue;
+            }
+            hooks.push({
+                event,
+                gateway: resolved.gatewayName,
+                gatewayType,
+                status: "wired",
+                detail: gatewayType === "command"
+                    ? "Mapped to a local command gateway with command opt-in enabled."
+                    : "Mapped to a local HTTP gateway; downstream acknowledgement is not observed here.",
+            });
+        }
+    }
+    const observedState = inspection.state === "configured" &&
+        hooks.some((hook) => hook.status === "blocked")
+        ? "degraded"
+        : inspection.state;
+    const metadata = {
+        observedState,
+        observedDetail: inspection.detail,
+        config: {
+            activationGateEnabled: inspection.activationGateEnabled,
+            commandGateEnabled: inspection.commandGateEnabled,
+            configPath: inspection.configPath,
+            configExists: inspection.configExists,
+            source: inspection.configSource,
+            explicitConfigPresent: inspection.explicitConfigPresent,
+            aliasConfigPresent: inspection.aliasConfigPresent,
+            aliasSources: inspection.aliasSources,
+            explicitOverridesAliases: inspection.explicitOverridesAliases,
+            warnings: inspection.warnings,
+        },
+        gateways,
+        hooks,
+        lifecycleBridge: OPENCLAW_LIFECYCLE_BRIDGE.map((entry) => ({ ...entry })),
+        bootstrap: {
+            adapterConfigPath: paths.configPath,
+            envelopePath: paths.envelopePath,
+            reportPaths: [paths.probeReportPath, paths.statusReportPath],
+            planningArtifactPaths: [
+                ...(planning.prdPath ? [planning.prdPath] : []),
+                ...planning.testSpecPaths,
+                ...planning.deepInterviewSpecPaths,
+            ],
+        },
+    };
+    const { bootstrap: _bootstrap, ...summaryMetadata } = metadata;
+    metadata.observedDetail = summarizeObservedState(summaryMetadata);
+    return metadata;
+}
+export function buildOpenClawEnvelope(paths, planning, capabilities, now) {
+    const openclaw = observeOpenClaw(paths, planning);
+    return {
+        schemaVersion: ADAPT_SCHEMA_VERSION,
+        generatedAt: now.toISOString(),
+        target: "openclaw",
+        displayName: "OpenClaw",
+        summary: "RCS-owned OpenClaw adapter metadata built from existing local config, gateway, and lifecycle seams.",
+        adapterPaths: paths,
+        planning,
+        capabilities,
+        constraints: [
+            "Status reflects local RCS/OpenClaw adapter evidence only; it does not claim downstream OpenClaw acknowledgement.",
+            "Bootstrap output stays under .rcs/adapters/openclaw/... and does not mutate .rcs/state or upstream OpenClaw config.",
+            "Command gateways remain gated by RCS_OPENCLAW_COMMAND=1 even when RCS_OPENCLAW=1 is enabled.",
+        ],
+        openclaw,
+    };
+}
+export function buildOpenClawProbeReport(paths, planning, capabilities, now) {
+    const openclaw = observeOpenClaw(paths, planning);
+    const blockedHooks = openclaw.hooks.filter((hook) => hook.status === "blocked");
+    return {
+        schemaVersion: ADAPT_SCHEMA_VERSION,
+        timestamp: now.toISOString(),
+        target: "openclaw",
+        phase: "foundation",
+        summary: openclaw.observedDetail,
+        adapterPaths: paths,
+        planning,
+        capabilities,
+        targetRuntime: {
+            state: "not-implemented",
+            detail: "Probe reports only local OpenClaw adapter evidence; remote runtime acceptance remains unobserved.",
+        },
+        openclaw,
+        nextSteps: blockedHooks.length > 0
+            ? blockedHooks.map((hook) => `${hook.event}: ${hook.detail}`)
+            : [
+                "Run rcs adapt openclaw init --write to materialize adapter-owned OpenClaw artifacts.",
+                "Confirm downstream OpenClaw behavior separately; this probe reports local wiring evidence only.",
+            ],
+    };
+}
+export function buildOpenClawStatusReport(paths, planning, capabilities, now) {
+    const initialized = existsSync(paths.configPath) && existsSync(paths.envelopePath);
+    const openclaw = observeOpenClaw(paths, planning);
+    return {
+        schemaVersion: ADAPT_SCHEMA_VERSION,
+        timestamp: now.toISOString(),
+        target: "openclaw",
+        phase: "foundation",
+        summary: initialized
+            ? `OpenClaw adapter artifacts exist under .rcs/adapters/openclaw/... and local runtime evidence is ${openclaw.observedState}.`
+            : `OpenClaw adapter artifacts have not been written yet; local runtime evidence is ${openclaw.observedState}.`,
+        adapter: {
+            state: initialized ? "initialized" : "not-initialized",
+            detail: initialized
+                ? "Adapter-owned OpenClaw artifacts are present under .rcs/adapters/openclaw/..."
+                : "Run init --write to create adapter-owned OpenClaw artifacts.",
+            configPath: paths.configPath,
+            envelopePath: paths.envelopePath,
+        },
+        targetRuntime: {
+            state: "unknown",
+            detail: "Status reflects local config/env/gateway wiring evidence only, not authoritative remote OpenClaw runtime health.",
+        },
+        planning,
+        capabilities,
+        openclaw,
+    };
+}
+export function buildOpenClawDoctorReport(paths, planning, now) {
+    const openclaw = observeOpenClaw(paths, planning);
+    const issues = [];
+    if (!existsSync(paths.configPath) || !existsSync(paths.envelopePath)) {
+        issues.push({
+            code: "adapter_not_initialized",
+            message: "No OpenClaw adapter artifacts exist under .rcs/adapters/openclaw.",
+        });
+    }
+    if (!openclaw.config.activationGateEnabled) {
+        issues.push({
+            code: "openclaw_disabled",
+            message: "RCS_OPENCLAW=1 is required before OpenClaw local config can be observed.",
+        });
+    }
+    else if (openclaw.observedState === "missing-config" ||
+        openclaw.observedState === "not-configured") {
+        issues.push({
+            code: "openclaw_config_missing",
+            message: `No usable OpenClaw config was found at ${openclaw.config.configPath}.`,
+        });
+    }
+    else if (openclaw.observedState === "invalid-config") {
+        issues.push({
+            code: "openclaw_config_invalid",
+            message: "OpenClaw config keys are present but do not form a valid runtime config.",
+        });
+    }
+    if (openclaw.hooks.some((hook) => hook.status === "blocked")) {
+        issues.push({
+            code: "openclaw_hook_blocked",
+            message: "At least one enabled OpenClaw hook is locally blocked by missing gateway evidence or command-gateway opt-in.",
+        });
+    }
+    if (!planning.prdPath) {
+        issues.push({
+            code: "planning_artifacts_missing",
+            message: "No canonical RCS PRD artifact is available to link into the OpenClaw adapter envelope.",
+        });
+    }
+    return {
+        schemaVersion: ADAPT_SCHEMA_VERSION,
+        timestamp: now.toISOString(),
+        target: "openclaw",
+        phase: "foundation",
+        summary: "OpenClaw doctor reports local adapter readiness and local gateway wiring evidence only.",
+        issues,
+        nextSteps: [
+            "Run rcs adapt openclaw init --write.",
+            "Set RCS_OPENCLAW=1 and configure notifications.openclaw or compatible aliases in ~/.codex/.rcs-config.json.",
+            "If command gateways are configured, also set RCS_OPENCLAW_COMMAND=1 before expecting command mappings to be locally ready.",
+        ],
+    };
+}
+export function initOpenClawFoundation(paths, planning, capabilities, write, now) {
+    const envelope = buildOpenClawEnvelope(paths, planning, capabilities, now);
+    const previewPaths = [
+        paths.adapterRoot,
+        paths.configPath,
+        paths.envelopePath,
+        paths.reportsDir,
+        paths.probeReportPath,
+        paths.statusReportPath,
+    ];
+    const wrotePaths = [];
+    if (write) {
+        mkdirSync(paths.reportsDir, { recursive: true });
+        writeFileSync(paths.configPath, `${JSON.stringify({
+            schemaVersion: ADAPT_SCHEMA_VERSION,
+            target: "openclaw",
+            createdAt: now.toISOString(),
+            phase: "openclaw-local-observation",
+            observedState: envelope.openclaw?.observedState ?? "not-configured",
+            summary: "RCS-owned OpenClaw adapter bootstrap metadata.",
+            lifecycleBridge: envelope.openclaw?.lifecycleBridge ?? [],
+            constraints: envelope.constraints,
+        }, null, 2)}\n`, "utf-8");
+        writeFileSync(paths.envelopePath, `${JSON.stringify(envelope, null, 2)}\n`, "utf-8");
+        wrotePaths.push(paths.configPath, paths.envelopePath);
+    }
+    return {
+        schemaVersion: ADAPT_SCHEMA_VERSION,
+        timestamp: now.toISOString(),
+        target: "openclaw",
+        write,
+        summary: write
+            ? "OpenClaw adapter metadata was written under .rcs/adapters/openclaw/..."
+            : "OpenClaw adapter bootstrap preview is ready; rerun with --write to materialize it.",
+        previewPaths,
+        wrotePaths,
+        envelope,
+    };
+}
+//# sourceMappingURL=openclaw.js.map

package/dist/adapt/openclaw.js.map

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

package/dist/adapt/paths.d.ts

@@ -0,0 +1,3 @@
+import { type AdaptPathSet, type AdaptTarget } from "./contracts.js";
+export declare function resolveAdaptPaths(cwd: string, target: AdaptTarget): AdaptPathSet;
+//# sourceMappingURL=paths.d.ts.map

package/dist/adapt/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/adapt/paths.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGrE,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,GAClB,YAAY,CAWd"}