create-principles-disciple 1.104.0 → 1.104.2

package/dist/installers/codex-host-installer.js

@@ -0,0 +1,445 @@
+/**
+ * CodexHostInstaller — implements HostInstaller for OpenAI Codex CLI (ADR-0020 §2.3, SPEC v4.1 §5.7)
+ *
+ * Writes/merges `~/.codex/hooks.json` pointing to the codex-adapter's pd-hook.js
+ * entry. Codex spawns pd-hook.js as a subprocess for each hook event.
+ *
+ * Install layout (does NOT mix with OpenClaw's ~/.openclaw/ tree):
+ *   ~/.pd/codex/
+ *   ├── pd-hook-entry.cjs     # wrapper: sets env vars + imports codex-adapter
+ *   └── .pd-hooks.marker      # sidecar marker for precise uninstall
+ *
+ * hooks.json entries (SPEC v4.1 §5.7):
+ *   ~/.codex/hooks.json (merged — append, never overwrite)
+ *
+ * Runtime Contract Rules:
+ * - rc-1-treat-as-unknown: hooks.json parsed as unknown, validated.
+ * - rc-2-no-as-bypass: uses Object.hasOwn + typeof guards.
+ * - rc-3-fail-loud-missing: malformed hooks.json throws.
+ * - rc-5-object-hasown-not-in: uses Object.hasOwn for untrusted keys.
+ * - rc-9-no-silent-fallback: every result includes reason + nextAction.
+ *
+ * EP-06 (Source of Truth): hooks.json is the canonical hook config — we
+ * merge into it, never overwrite. The marker file is our own bookkeeping
+ * for precise uninstall.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { createRequire } from 'module';
+const requireFromModule = createRequire(import.meta.url);
+// ─── Codex hook event names (SPEC v4.1 §5.7) ────────────────────────────────
+const CODEX_EVENTS = ['PreToolUse', 'PostToolUse', 'UserPromptSubmit', 'SessionStart'];
+const PD_HOOK_MARKER = 'pd-hooks.marker';
+// ─── Type guards (rc-2: no `as` bypass) ─────────────────────────────────────
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isUnknownArray(value) {
+    return Array.isArray(value);
+}
+/**
+ * Type guard: extracts `.code` from a thrown error without `as NodeJS.ErrnoException`.
+ * ESLint `no-undef` flags the `NodeJS` namespace; this helper avoids it.
+ */
+function getErrorCode(err) {
+    if (err !== null && typeof err === 'object' && Object.hasOwn(err, 'code')) {
+        const { code } = err;
+        return typeof code === 'string' ? code : undefined;
+    }
+    return undefined;
+}
+// ─── Path helpers ───────────────────────────────────────────────────────────
+function getCodexDir() {
+    return path.join(os.homedir(), '.codex');
+}
+function getCodexHooksJsonPath() {
+    return path.join(getCodexDir(), 'hooks.json');
+}
+function getPdCodexDir() {
+    return path.join(os.homedir(), '.pd', 'codex');
+}
+function getPdHookMarkerPath() {
+    return path.join(getPdCodexDir(), PD_HOOK_MARKER);
+}
+/**
+ * Resolve the path to the codex-adapter's pd-hook.js entry.
+ *
+ * Strategy:
+ * 1. Try require.resolve('@principles/codex-adapter/pd-hook') — works if
+ *    the package is installed locally or globally resolvable.
+ * 2. Fall back to undefined — installer reports the missing dependency.
+ */
+function resolvePdHookPath() {
+    try {
+        const entry = requireFromModule.resolve('@principles/codex-adapter/pd-hook');
+        return entry;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Build the hook command string for hooks.json.
+ *
+ * The wrapper script sets PD_HOST_CODEX_ENABLED=1 and PD_WORKSPACE_DIR before
+ * invoking pd-hook.js. This is cross-platform (no shell-specific env var syntax).
+ */
+function buildHookCommand(entryScriptPath, _workspaceDir) {
+    // Unix command: node <entry>
+    // workspaceDir is injected by the wrapper script (pd-hook-entry.cjs), not here.
+    void _workspaceDir;
+    return `node "${entryScriptPath}"`;
+}
+function buildHookCommandWindows(entryScriptPath, _workspaceDir) {
+    // Windows command — same node invocation; the entry script handles env internally
+    void _workspaceDir;
+    return `node "${entryScriptPath}"`;
+}
+function buildMatcherGroup(eventName, entryScriptPath, workspaceDir) {
+    const command = buildHookCommand(entryScriptPath, workspaceDir);
+    const commandWindows = buildHookCommandWindows(entryScriptPath, workspaceDir);
+    switch (eventName) {
+        case 'PreToolUse':
+            return {
+                matcher: 'Bash|apply_patch',
+                hooks: [{
+                        type: 'command',
+                        command,
+                        commandWindows,
+                        timeout: 5,
+                        statusMessage: 'PD: checking tool call',
+                    }],
+            };
+        case 'PostToolUse':
+            return {
+                matcher: '.*',
+                hooks: [{
+                        type: 'command',
+                        command,
+                        commandWindows,
+                        timeout: 5,
+                        async: true,
+                        statusMessage: 'PD: capturing pain signal',
+                    }],
+            };
+        case 'UserPromptSubmit':
+            return {
+                hooks: [{
+                        type: 'command',
+                        command,
+                        commandWindows,
+                        timeout: 5,
+                        additionalContextLimit: 10000,
+                        statusMessage: 'PD: injecting principles',
+                    }],
+            };
+        case 'SessionStart':
+            return {
+                hooks: [{
+                        type: 'command',
+                        command,
+                        commandWindows,
+                        timeout: 600,
+                        additionalContextLimit: 10000,
+                        statusMessage: 'PD: hydrating state',
+                    }],
+            };
+    }
+}
+// ─── Wrapper script content ─────────────────────────────────────────────────
+/**
+ * Generate the wrapper script that sets env vars and imports pd-hook.js.
+ *
+ * This is a CommonJS file so it can use process.env mutation before the
+ * ESM pd-hook.js is dynamically imported. Cross-platform (no shell syntax).
+ */
+function buildWrapperScriptContent(pdHookPath, workspaceDir) {
+    return [
+        '#!/usr/bin/env node',
+        '// Auto-generated by create-principles-disciple installer (CodexHostInstaller).',
+        '// Sets PD env vars, then imports the codex-adapter pd-hook entry.',
+        '// DO NOT edit manually — re-run the installer to regenerate.',
+        '',
+        'process.env.PD_HOST_CODEX_ENABLED = "1";',
+        `process.env.PD_WORKSPACE_DIR = ${JSON.stringify(workspaceDir)};`,
+        '',
+        '// Import the codex-adapter pd-hook entry (ESM).',
+        '// pd-hook.js reads stdin, processes the hook, writes stdout, exits.',
+        `import(${JSON.stringify('file://' + pdHookPath.replace(/\\/g, '/'))});`,
+        '',
+    ].join('\n');
+}
+// ─── CodexHostInstaller ─────────────────────────────────────────────────────
+export class CodexHostInstaller {
+    hostId = 'codex';
+    async install(ctx) {
+        const pdCodexDir = getPdCodexDir();
+        const hooksJsonPath = getCodexHooksJsonPath();
+        const markerPath = getPdHookMarkerPath();
+        // 1. Resolve codex-adapter pd-hook.js
+        const pdHookPath = resolvePdHookPath();
+        if (!pdHookPath) {
+            return {
+                success: false,
+                hostId: this.hostId,
+                configPath: hooksJsonPath,
+                configAction: 'skipped',
+                reason: '@principles/codex-adapter is not installed. The codex-adapter package provides the pd-hook.js entry Codex spawns.',
+                nextAction: 'Install it first: npm install -g @principles/codex-adapter, then re-run: npx create-principles-disciple install --host codex',
+            };
+        }
+        // 2. Write wrapper script to ~/.pd/codex/pd-hook-entry.cjs
+        //    (marker file is written AFTER mergeHooksJson succeeds — see step 3.
+        //    Writing the marker before the merge would make detect() report a
+        //    failed install as installed, violating rc-3-fail-loud-missing.)
+        try {
+            if (!existsSync(pdCodexDir)) {
+                mkdirSync(pdCodexDir, { recursive: true });
+            }
+            const wrapperPath = path.join(pdCodexDir, 'pd-hook-entry.cjs');
+            const wrapperContent = buildWrapperScriptContent(pdHookPath, ctx.workspaceDir);
+            writeFileSync(wrapperPath, wrapperContent, { encoding: 'utf-8' });
+            // 3. Merge PD hook entries into ~/.codex/hooks.json (append, never overwrite).
+            //    If hooks.json is malformed, mergeHooksJson returns 'preserved' without
+            //    writing any PD entries. This MUST surface as a failure (rc-3 / rc-9)
+            //    — otherwise the user would see "install succeeded" while Codex never
+            //    triggers PD hooks. The marker is NOT written in this branch, so
+            //    detect() correctly reports "not installed".
+            const configAction = this.mergeHooksJson(hooksJsonPath, wrapperPath, ctx.workspaceDir);
+            if (configAction === 'preserved') {
+                return {
+                    success: false,
+                    hostId: this.hostId,
+                    configPath: hooksJsonPath,
+                    configAction,
+                    reason: `${hooksJsonPath} is malformed (not a JSON object). PD did not write any hook entries to avoid overwriting the user's config.`,
+                    nextAction: `Manually fix ${hooksJsonPath} (must be a JSON object), then re-run: npx create-principles-disciple install --host codex`,
+                };
+            }
+            // 4. Merge succeeded — now safe to record the marker. detect() will
+            //    only report installed when hooks.json actually contains PD entries.
+            writeFileSync(markerPath, JSON.stringify({
+                installedAt: new Date().toISOString(),
+                workspaceDir: ctx.workspaceDir,
+                pdHookPath,
+                wrapperPath,
+                events: CODEX_EVENTS,
+            }, null, 2), { encoding: 'utf-8' });
+            return {
+                success: true,
+                hostId: this.hostId,
+                configPath: hooksJsonPath,
+                configAction,
+                nextAction: 'Open Codex and run /hooks to trust PD hooks before they execute. Verify with: codex doctor (hooks feature should be ON).',
+            };
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                hostId: this.hostId,
+                configPath: hooksJsonPath,
+                configAction: 'skipped',
+                reason: `Failed to write Codex hook config: ${reason}`,
+                nextAction: `Check write permissions on ${pdCodexDir} and ${hooksJsonPath}, then re-run installer.`,
+            };
+        }
+    }
+    /**
+     * Merge PD hook entries into ~/.codex/hooks.json.
+     * - If file doesn't exist: create it with PD entries (configAction = 'created').
+     * - If file exists: merge PD entries into existing event arrays (configAction = 'updated').
+     * - Idempotent: re-running install replaces PD entries (matched by marker), not duplicates.
+     */
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    mergeHooksJson(hooksJsonPath, wrapperPath, workspaceDir) {
+        const codexDir = getCodexDir();
+        if (!existsSync(codexDir)) {
+            mkdirSync(codexDir, { recursive: true });
+        }
+        let existing = {};
+        let action = 'created';
+        // CodeQL TOCTOU fix: try/catch read instead of existsSync+readFileSync.
+        // ENOENT → 'created' (file doesn't exist yet); other parse errors → 'preserved'.
+        try {
+            const raw = readFileSync(hooksJsonPath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (isRecord(parsed)) {
+                existing = { ...parsed };
+                action = 'updated';
+            }
+            else {
+                // Malformed — back off, don't overwrite
+                action = 'preserved';
+            }
+        }
+        catch (err) {
+            const code = getErrorCode(err);
+            if (code === 'ENOENT') {
+                // File doesn't exist — 'created' (default action stays)
+            }
+            else {
+                // Malformed JSON — back off
+                action = 'preserved';
+            }
+        }
+        if (action === 'preserved') {
+            return action;
+        }
+        // For each Codex event, replace any existing PD-owned matcher groups
+        // with our fresh set (idempotent — re-install doesn't duplicate).
+        const PD_MARKER = 'pd-owned';
+        for (const eventName of CODEX_EVENTS) {
+            const group = buildMatcherGroup(eventName, wrapperPath, workspaceDir);
+            // Tag the group so uninstall can find PD-owned entries precisely.
+            group.__pd_marker = PD_MARKER;
+            const existingGroups = existing[eventName];
+            if (isUnknownArray(existingGroups)) {
+                // Filter out previously-PD-owned groups, then append the new one.
+                // rc-2: no `as` bypass — use Object.hasOwn to check marker presence.
+                const filtered = existingGroups.filter((g) => !(isRecord(g) && Object.hasOwn(g, '__pd_marker') && g.__pd_marker === PD_MARKER));
+                filtered.push(group);
+                existing[eventName] = filtered;
+            }
+            else {
+                existing[eventName] = [group];
+            }
+        }
+        writeFileSync(hooksJsonPath, JSON.stringify(existing, null, 2), { encoding: 'utf-8' });
+        return action;
+    }
+    async uninstall(_ctx) {
+        const hooksJsonPath = getCodexHooksJsonPath();
+        const markerPath = getPdHookMarkerPath();
+        const pdCodexDir = getPdCodexDir();
+        const removedPaths = [];
+        const preservedPaths = [];
+        // 1. Remove PD-owned entries from hooks.json.
+        //    CodeQL TOCTOU fix: try/catch read instead of existsSync+readFileSync.
+        try {
+            const raw = readFileSync(hooksJsonPath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (isRecord(parsed)) {
+                const config = { ...parsed };
+                let modified = false;
+                const PD_MARKER = 'pd-owned';
+                for (const eventName of CODEX_EVENTS) {
+                    const groups = config[eventName];
+                    if (isUnknownArray(groups)) {
+                        const before = groups.length;
+                        // rc-2: use Object.hasOwn instead of `as` cast for marker check.
+                        const filtered = groups.filter((g) => !(isRecord(g) && Object.hasOwn(g, '__pd_marker') && g.__pd_marker === PD_MARKER));
+                        if (filtered.length === 0) {
+                            delete config[eventName];
+                        }
+                        else {
+                            config[eventName] = filtered;
+                        }
+                        if (filtered.length !== before)
+                            modified = true;
+                    }
+                }
+                if (modified) {
+                    writeFileSync(hooksJsonPath, JSON.stringify(config, null, 2), { encoding: 'utf-8' });
+                    removedPaths.push(hooksJsonPath);
+                }
+            }
+        }
+        catch (err) {
+            const code = getErrorCode(err);
+            if (code === 'ENOENT') {
+                // hooks.json not found — nothing to clean, proceed to marker cleanup.
+            }
+            else {
+                // Malformed hooks.json — can't safely merge. Leave it alone.
+                preservedPaths.push(hooksJsonPath);
+            }
+        }
+        // 2. Remove wrapper script + marker file
+        const wrapperPath = path.join(pdCodexDir, 'pd-hook-entry.cjs');
+        if (existsSync(wrapperPath)) {
+            try {
+                const fs = await import('fs');
+                await fs.promises.rm(wrapperPath, { force: true });
+                removedPaths.push(wrapperPath);
+            }
+            catch {
+                preservedPaths.push(wrapperPath);
+            }
+        }
+        if (existsSync(markerPath)) {
+            try {
+                const fs = await import('fs');
+                await fs.promises.rm(markerPath, { force: true });
+                removedPaths.push(markerPath);
+            }
+            catch {
+                preservedPaths.push(markerPath);
+            }
+        }
+        return {
+            success: preservedPaths.length === 0,
+            hostId: this.hostId,
+            removedPaths,
+            preservedPaths,
+            reason: preservedPaths.length > 0
+                ? `Some files could not be removed: ${preservedPaths.join(', ')}`
+                : undefined,
+            nextAction: preservedPaths.length > 0
+                ? `Manually inspect: ${preservedPaths.join(', ')}`
+                : 'Codex hooks uninstalled. Verify: open ~/.codex/hooks.json (should have no __pd_marker entries).',
+        };
+    }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    detect() {
+        const markerPath = getPdHookMarkerPath();
+        const hooksJsonPath = getCodexHooksJsonPath();
+        const wrapperPath = path.join(getPdCodexDir(), 'pd-hook-entry.cjs');
+        const paths = [
+            {
+                exists: existsSync(markerPath),
+                path: markerPath,
+                name: 'PD Codex install marker',
+                type: 'file',
+            },
+            {
+                exists: existsSync(wrapperPath),
+                path: wrapperPath,
+                name: 'PD Codex hook entry script',
+                type: 'file',
+            },
+            {
+                exists: existsSync(hooksJsonPath),
+                path: hooksJsonPath,
+                name: 'Codex hooks.json',
+                type: 'file',
+            },
+        ];
+        // PD is "installed" for Codex if the marker exists OR hooks.json has PD entries
+        let installed = existsSync(markerPath);
+        if (!installed && existsSync(hooksJsonPath)) {
+            try {
+                const raw = readFileSync(hooksJsonPath, 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (isRecord(parsed)) {
+                    for (const eventName of CODEX_EVENTS) {
+                        const groups = parsed[eventName];
+                        if (isUnknownArray(groups)) {
+                            const hasPd = groups.some((g) => isRecord(g) && Object.hasOwn(g, '__pd_marker') && g.__pd_marker === 'pd-owned');
+                            if (hasPd) {
+                                installed = true;
+                                break;
+                            }
+                        }
+                    }
+                }
+            }
+            catch {
+                // Malformed hooks.json — treat as not installed (will be cleaned on uninstall)
+            }
+        }
+        return { installed, paths };
+    }
+}
+//# sourceMappingURL=codex-host-installer.js.map

package/dist/installers/codex-host-installer.js.map

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

package/dist/installers/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Host installers barrel (ADR-0020 §2.3)
+ *
+ * Exports HostTarget type + factory for selecting host installers by CLI --host.
+ *
+ * MVP hosts:
+ * - 'openclaw' (default) — OpenClawHostInstaller writes ~/.openclaw/openclaw.json.
+ * - 'codex'              — CodexHostInstaller writes ~/.codex/hooks.json.
+ * - 'all'                — both installers run (for operators using multiple hosts).
+ *
+ * Runtime Contract Rules:
+ * - rc-1-treat-as-unknown: --host CLI value is `unknown` until validated here.
+ * - rc-3-fail-loud-missing: invalid --host value throws with valid options.
+ * - rc-9-no-silent-fallback: factory returns concrete installers, not nulls.
+ */
+import type { HostInstaller } from '@principles/core/host';
+export { OpenClawHostInstaller } from './openclaw-host-installer.js';
+export { CodexHostInstaller } from './codex-host-installer.js';
+/**
+ * Host target selector. 'all' runs every registered installer.
+ * Add new host IDs here when new HostInstaller implementations land.
+ */
+export type HostTarget = 'openclaw' | 'codex' | 'all';
+export declare const HOST_TARGETS: readonly HostTarget[];
+/**
+ * Validate a CLI --host value. rc-1/rc-3: treat input as unknown, fail loud.
+ */
+export declare function isHostTarget(value: unknown): value is HostTarget;
+/**
+ * Factory: return the concrete HostInstaller instances for a given target.
+ *
+ * - 'openclaw' → [OpenClawHostInstaller]
+ * - 'codex'    → [CodexHostInstaller]
+ * - 'all'      → [OpenClawHostInstaller, CodexHostInstaller]
+ *
+ * Callers iterate the returned array and call install()/uninstall()/detect()
+ * on each. This keeps the CLI install/uninstall flow host-agnostic.
+ */
+export declare function getHostInstallers(target: HostTarget): HostInstaller[];
+//# sourceMappingURL=index.d.ts.map

package/dist/installers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/installers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC;AAEtD,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAAiC,CAAC;AAEhF;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,EAAE,CAYrE"}

package/dist/installers/index.js

@@ -0,0 +1,35 @@
+import { OpenClawHostInstaller } from './openclaw-host-installer.js';
+import { CodexHostInstaller } from './codex-host-installer.js';
+export { OpenClawHostInstaller } from './openclaw-host-installer.js';
+export { CodexHostInstaller } from './codex-host-installer.js';
+export const HOST_TARGETS = ['openclaw', 'codex', 'all'];
+/**
+ * Validate a CLI --host value. rc-1/rc-3: treat input as unknown, fail loud.
+ */
+export function isHostTarget(value) {
+    return typeof value === 'string' && HOST_TARGETS.includes(value);
+}
+/**
+ * Factory: return the concrete HostInstaller instances for a given target.
+ *
+ * - 'openclaw' → [OpenClawHostInstaller]
+ * - 'codex'    → [CodexHostInstaller]
+ * - 'all'      → [OpenClawHostInstaller, CodexHostInstaller]
+ *
+ * Callers iterate the returned array and call install()/uninstall()/detect()
+ * on each. This keeps the CLI install/uninstall flow host-agnostic.
+ */
+export function getHostInstallers(target) {
+    if (!isHostTarget(target)) {
+        throw new Error(`Invalid host target: ${JSON.stringify(target)}. Valid: ${HOST_TARGETS.join(', ')}`);
+    }
+    switch (target) {
+        case 'openclaw':
+            return [new OpenClawHostInstaller()];
+        case 'codex':
+            return [new CodexHostInstaller()];
+        case 'all':
+            return [new OpenClawHostInstaller(), new CodexHostInstaller()];
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/installers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/installers/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQ/D,MAAM,CAAC,MAAM,YAAY,GAA0B,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,YAAkC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC;IACD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU;YACb,OAAO,CAAC,IAAI,qBAAqB,EAAE,CAAC,CAAC;QACvC,KAAK,OAAO;YACV,OAAO,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC;QACpC,KAAK,KAAK;YACR,OAAO,CAAC,IAAI,qBAAqB,EAAE,EAAE,IAAI,kBAAkB,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/installers/openclaw-host-installer.d.ts

@@ -0,0 +1,18 @@
+import type { HostInstaller, HostInstallContext, HostInstallResult, HostUninstallContext, HostUninstallResult, HostDetectResult } from '@principles/core/host';
+/**
+ * OpenClaw host installer — writes/merges ~/.openclaw/openclaw.json and
+ * ~/.openclaw/plugins/installs.json. Does NOT install bundled components
+ * (core/pd-cli/console) — that's the shared installer's job.
+ */
+export declare class OpenClawHostInstaller implements HostInstaller {
+    readonly hostId = "openclaw";
+    install(_ctx: HostInstallContext): Promise<HostInstallResult>;
+    /**
+     * Write install record to ~/.openclaw/plugins/installs.json.
+     * Non-fatal on failure — OpenClaw manages this file and will self-heal.
+     */
+    private writeInstallRecord;
+    uninstall(_ctx: HostUninstallContext): Promise<HostUninstallResult>;
+    detect(): HostDetectResult;
+}
+//# sourceMappingURL=openclaw-host-installer.d.ts.map

package/dist/installers/openclaw-host-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-host-installer.d.ts","sourceRoot":"","sources":["../../src/installers/openclaw-host-installer.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAgE/B;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,QAAQ,CAAC,MAAM,cAAc;IAEvB,OAAO,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqIlE;IAED;;;OAGG;IAEH,OAAO,CAAC,kBAAkB;IAmEpB,SAAS,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAwGxE;IAGD,MAAM,IAAI,gBAAgB,CAsBzB;CACF"}