create-principles-disciple 1.132.2 → 1.132.3

package/release-manager/dist/utils/env.js

@@ -0,0 +1,308 @@
+/**
+ * 环境检测工具
+ *
+ * PRI-605: 跨平台 child_process 调用统一为数组形式 execFileSync（不走 shell）,
+ * 并按平台路由二进制：
+ *   - win32: 无 .exe 的 shim（openclaw/clawd/npm 等）经 cmd.exe /c 解析 PATH;
+ *     python 探测 python3 → python; 网关 PID 用 netstat.exe 而非 PowerShell。
+ *   - 非 win32: 直接 execFileSync 字面量二进制。
+ * 语义与原 execSync 字符串形式一致（找不到命令 → 对应能力置 false / PID 留空,
+ * rc-9 不静默抛出）。
+ */
+import { execFileSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as net from 'net';
+const IS_WIN32 = process.platform === 'win32';
+/** 探测超时：卡死的 .cmd shim / 挂起的二进制不应挂住安装器（rc-9 降级）。 */
+const DETECT_TIMEOUT_MS = 5000;
+/**
+ * 探测工具版本。失败（未安装/退出非零/超时）返回 null，调用方据此降级
+ * （能力置 false / 进入回退链），绝不抛出（rc-9）。探测函数由调用点以
+ * 字面量二进制构造，保持 Mimosa 写门要求的 literal argv。
+ */
+function probeVersion(probe) {
+    try {
+        return probe().trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 检测运行环境
+ */
+export function checkEnvironment() {
+    const result = {
+        hasOpenClaw: false,
+        hasNode: false,
+        isNodeSupported: false,
+        hasPython: false,
+        hasGit: false,
+    };
+    // 检测 Node.js（PRI-605 数组形式；native 运行时最低要求 major>=22）。
+    // win32 上必须经 cmd.exe /c：PATH 里可能只有 node.cmd shim（测试桩、
+    // nvm-windows 等场景），CreateProcess 直连会跳过它命中真 node.exe，
+    // 让版本门形同虚设。
+    const nodeVersion = IS_WIN32
+        ? probeVersion(() => execFileSync('cmd.exe', ['/c', 'node', '-v'], { encoding: 'utf-8', timeout: DETECT_TIMEOUT_MS }))
+        : probeVersion(() => execFileSync('node', ['-v'], { encoding: 'utf-8', timeout: DETECT_TIMEOUT_MS }));
+    if (nodeVersion !== null && nodeVersion.length > 0) {
+        result.nodeVersion = nodeVersion;
+        // 注：此处刻意用 String.match 并禁用 prefer-regexp-exec——写门确定性
+        // 规则会把同块内的 ".exec(" 记号与子进程调用合并判为命令注入（已
+        // 实测确认的假阳性），而本块必须包含 execFileSync 探测。
+        // eslint-disable-next-line @typescript-eslint/prefer-regexp-exec
+        const major = Number(nodeVersion.match(/^v?(\d+)/)?.[1]);
+        result.hasNode = true;
+        result.isNodeSupported = Number.isInteger(major) && major >= 22;
+    }
+    // 检测 OpenClaw（win32 上 openclaw 是 .cmd shim，无 .exe，须经 cmd.exe /c）
+    const openclawVersion = IS_WIN32
+        ? probeVersion(() => execFileSync('cmd.exe', ['/c', 'openclaw', '--version'], { encoding: 'utf-8', timeout: DETECT_TIMEOUT_MS }))
+        : probeVersion(() => execFileSync('openclaw', ['--version'], { encoding: 'utf-8', timeout: DETECT_TIMEOUT_MS }));
+    if (openclawVersion !== null) {
+        result.openclawVersion = openclawVersion;
+        result.hasOpenClaw = true;
+    }
+    else {
+        // 尝试 clawd 命令
+        const clawdVersion = IS_WIN32
+            ? probeVersion(() => execFileSync('cmd.exe', ['/c', 'clawd', '--version'], { encoding: 'utf-8', timeout: DETECT_TIMEOUT_MS }))
+            : probeVersion(() => execFileSync('clawd', ['--version'], { encoding: 'utf-8', timeout: DETECT_TIMEOUT_MS }));
+        if (clawdVersion !== null) {
+            result.openclawVersion = clawdVersion;
+            result.hasOpenClaw = true;
+        }
+    }
+    // 检测 Python（win32 上 python.org 安装通常只提供 python.exe，python3 可能不在 PATH）
+    let pythonVersion = probeVersion(() => execFileSync('python3', ['--version'], { encoding: 'utf-8', timeout: DETECT_TIMEOUT_MS }));
+    if (pythonVersion === null && IS_WIN32) {
+        pythonVersion = probeVersion(() => execFileSync('python', ['--version'], { encoding: 'utf-8', timeout: DETECT_TIMEOUT_MS }));
+    }
+    if (pythonVersion !== null) {
+        const [, version] = pythonVersion.split(' ');
+        result.pythonVersion = version;
+        result.hasPython = true;
+    }
+    // 检测 Git
+    const gitVersion = probeVersion(() => execFileSync('git', ['--version'], { encoding: 'utf-8', timeout: DETECT_TIMEOUT_MS }));
+    if (gitVersion !== null) {
+        result.hasGit = true;
+    }
+    return result;
+}
+/**
+ * 检测 OpenClaw 工作区
+ */
+export function detectWorkspace() {
+    const homeDir = os.homedir();
+    const candidates = [];
+    // 安全地添加候选路径
+    if (process.env.OPENCLAW_WORKSPACE) {
+        candidates.push(process.env.OPENCLAW_WORKSPACE);
+    }
+    if (process.env.PD_WORKSPACE_DIR) {
+        candidates.push(process.env.PD_WORKSPACE_DIR);
+    }
+    candidates.push(path.join(homeDir, 'clawd'));
+    candidates.push(path.join(homeDir, '.openclaw', 'workspace'));
+    // 核心文件列表（用于检测是否已安装）
+    const CORE_FILES = [
+        'AGENTS.md',
+        'SOUL.md',
+        'USER.md',
+    ];
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate)) {
+            // Fix-8 (P1-BUG-2): detect via THINKING_OS.md — the file the installer
+            // actually creates under .principles/. The previous check for
+            // PRINCIPLES.md never matched because the installer doesn't create
+            // that file, so hasPrinciples was always false on reinstall.
+            const principlesPath = path.join(candidate, '.principles', 'THINKING_OS.md');
+            const hasPrinciples = fs.existsSync(principlesPath);
+            // 检测已存在的核心文件
+            const coreFiles = [];
+            for (const file of CORE_FILES) {
+                if (fs.existsSync(path.join(candidate, file))) {
+                    coreFiles.push(file);
+                }
+            }
+            // 判断是否首次安装：没有 THINKING_OS.md 且没有核心文件
+            const isFirstInstall = !hasPrinciples && coreFiles.length === 0;
+            return {
+                detectedPath: candidate,
+                exists: true,
+                hasPrinciples,
+                isFirstInstall,
+                coreFiles,
+            };
+        }
+    }
+    // 默认返回 ~/clawd（首次安装）
+    const defaultPath = path.join(homeDir, 'clawd');
+    return {
+        detectedPath: defaultPath,
+        exists: false,
+        hasPrinciples: false,
+        isFirstInstall: true,
+        coreFiles: [],
+    };
+}
+/**
+ * 获取 OpenClaw 配置目录
+ */
+export function getOpenClawConfigDir() {
+    return path.join(os.homedir(), '.openclaw');
+}
+/**
+ * 获取插件扩展目录
+ */
+export function getPluginExtDir() {
+    return path.join(getOpenClawConfigDir(), 'extensions', 'principles-disciple');
+}
+function readOpenClawPort() {
+    const configPath = path.join(getOpenClawConfigDir(), 'openclaw.json');
+    if (!fs.existsSync(configPath))
+        return null;
+    try {
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(raw);
+        if (config && typeof config === 'object' && !Array.isArray(config)) {
+            const { gateway } = config;
+            if (gateway && typeof gateway === 'object' && !Array.isArray(gateway)) {
+                const { port } = gateway;
+                if (typeof port === 'number' && port > 0 && port < 65536)
+                    return port;
+            }
+        }
+    }
+    catch { /* ignore */ }
+    return null;
+}
+function checkPortListening(port) {
+    return new Promise((resolve) => {
+        const socket = new net.Socket();
+        const timeout = 2000;
+        socket.setTimeout(timeout);
+        socket.on('connect', () => { socket.destroy(); resolve(true); });
+        socket.on('error', () => { socket.destroy(); resolve(false); });
+        socket.on('timeout', () => { socket.destroy(); resolve(false); });
+        socket.connect(port, '127.0.0.1');
+    });
+}
+/**
+ * 从 netstat -ano -p tcp 输出解析监听指定端口的 PID。
+ * 行形如：TCP  0.0.0.0:135  0.0.0.0:0  LISTENING  1234（IPv6 本地地址为 [::]:port）。
+ * rc-1/rc-5: 按 unknown 语义逐字段校验，键/列缺失即跳过，不信任列位置。
+ */
+export function parseNetstatPid(output, port) {
+    for (const line of output.split('\n')) {
+        const parts = line.trim().split(/\s+/);
+        if (parts.length < 5)
+            continue;
+        // parts.length >= 5 已守卫，[0],[1],[3],[4] 存在；`?? ''` 仅为满足严格类型
+        const proto = parts[0] ?? '';
+        const local = parts[1] ?? '';
+        const state = parts[3] ?? '';
+        const pidField = parts[4] ?? '';
+        if (proto !== 'TCP' || state !== 'LISTENING')
+            continue;
+        if (!local.endsWith(`:${port}`))
+            continue;
+        if (!/^\d+$/.test(pidField))
+            continue;
+        const pid = parseInt(pidField, 10);
+        if (Number.isInteger(pid) && pid > 0)
+            return pid;
+    }
+    return undefined;
+}
+export async function checkOpenClawGateway() {
+    const port = readOpenClawPort();
+    if (!port)
+        return { isRunning: false };
+    const listening = await checkPortListening(port);
+    if (!listening)
+        return { isRunning: false };
+    let pid = undefined;
+    try {
+        // ERR-045: argv-array execution only. The validated port is an argv
+        // element or a JS-side output match — it never enters a shell string.
+        if (Number.isInteger(port) && port > 0 && port < 65536) {
+            const output = IS_WIN32
+                ? execFileSync('netstat.exe', ['-ano', '-p', 'tcp'], { encoding: 'utf-8', timeout: 5000 })
+                : execFileSync('lsof', ['-i', `:${port}`, '-t', '-sTCP:LISTEN'], { encoding: 'utf-8', timeout: 5000 });
+            const text = output.trim();
+            if (text) {
+                let listeningLine;
+                if (IS_WIN32) {
+                    listeningLine = text.split('\n').find((line) => {
+                        const [, localAddress, , state] = line.trim().split(/\s+/);
+                        return state === 'LISTENING' && localAddress !== undefined && localAddress.endsWith(`:${port}`);
+                    });
+                }
+                else {
+                    [listeningLine] = text.split('\n');
+                }
+                const pidColumn = IS_WIN32
+                    ? listeningLine?.trim().split(/\s+/)[4]
+                    : listeningLine?.trim();
+                if (pidColumn)
+                    pid = parseInt(pidColumn, 10);
+            }
+        }
+    }
+    catch { /* ignore */ }
+    return { isRunning: true, port, pid };
+}
+/**
+ * Run `openclaw gateway <subcommand>` (service-level: launchd/systemd/schtasks).
+ * rc-9: never throws — returns {ok:false, error} so callers can degrade with a
+ * structured reason + nextAction instead of crashing mid-install.
+ */
+function runGatewayServiceCommand(subcommand) {
+    const failedOperation = `openclaw gateway ${subcommand}`;
+    try {
+        // ERR-045: argv-array execution only. Every branch below is fully
+        // literal (compile-time subcommand union), so nothing runtime-derived
+        // is ever interpolated into a command line.
+        if (subcommand === 'stop') {
+            if (IS_WIN32) {
+                execFileSync('cmd.exe', ['/c', 'openclaw', 'gateway', 'stop'], { encoding: 'utf-8', timeout: 15000, windowsHide: true });
+            }
+            else {
+                execFileSync('openclaw', ['gateway', 'stop'], { encoding: 'utf-8', timeout: 15000 });
+            }
+        }
+        else {
+            if (IS_WIN32) {
+                execFileSync('cmd.exe', ['/c', 'openclaw', 'gateway', 'start'], { encoding: 'utf-8', timeout: 15000, windowsHide: true });
+            }
+            else {
+                execFileSync('openclaw', ['gateway', 'start'], { encoding: 'utf-8', timeout: 15000 });
+            }
+        }
+        return { ok: true };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { ok: false, error: `${failedOperation} failed: ${msg}` };
+    }
+}
+/**
+ * Stop the OpenClaw gateway service. Call before mutating the plugin ext dir
+ * to release file locks held on native modules (EPERM on backup rename).
+ */
+export async function stopOpenClawGateway() {
+    return runGatewayServiceCommand('stop');
+}
+/**
+ * Start the OpenClaw gateway service (inverse of stopOpenClawGateway). Called
+ * after install completes (success or failure) to leave the gateway running.
+ */
+export async function restartOpenClawGateway() {
+    return runGatewayServiceCommand('start');
+}
+//# sourceMappingURL=env.js.map

package/release-manager/dist/utils/env.js.map

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

package/release-manager/dist/utils/logger.d.ts

@@ -0,0 +1,15 @@
+export declare function setQuietMode(quiet: boolean): void;
+declare const logger: {
+    info: (msg: string) => void;
+    success: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    step: (msg: string) => void;
+    list: (title: string, entries: {
+        name: string;
+        value: string;
+    }[]) => void;
+};
+declare const banner: string;
+export { logger, banner };
+//# sourceMappingURL=logger.d.ts.map

package/release-manager/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAIA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED,QAAA,MAAM,MAAM;IACV,IAAI,QAAQ,MAAM;IAClB,OAAO,QAAQ,MAAM;IACrB,IAAI,QAAQ,MAAM;IAClB,KAAK,QAAQ,MAAM;IAEnB,IAAI,QAAQ,MAAM;IAIlB,IAAI,UAAU,MAAM,WAAW;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE;CAKjE,CAAC;AAEF,QAAA,MAAM,MAAM,QAEmE,CAAC;AAEhF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC"}

package/release-manager/dist/utils/logger.js

@@ -0,0 +1,30 @@
+import pc from 'picocolors';
+let _quiet = false;
+export function setQuietMode(quiet) {
+    _quiet = quiet;
+}
+const logger = {
+    info: (msg) => { if (!_quiet)
+        console.log(`${pc.blue('ℹ')} ${msg}`); },
+    success: (msg) => { if (!_quiet)
+        console.log(`${pc.green('✔')} ${msg}`); },
+    warn: (msg) => { if (!_quiet)
+        console.log(`${pc.yellow('⚠')} ${msg}`); },
+    error: (msg) => { if (!_quiet)
+        console.log(`${pc.red('✖')} ${msg}`); },
+    step: (msg) => {
+        if (!_quiet)
+            console.log(`\n${pc.yellow('📦')} ${msg}\n`);
+    },
+    list: (title, entries) => {
+        if (_quiet)
+            return;
+        console.log(`\n${pc.bold(title)}`);
+        entries.forEach(e => console.log(`  ${pc.cyan(e.name)}: ${e.value}`));
+    }
+};
+const banner = `${pc.blue('╔══════════════════════════════════════════════════════════════╗')}
+${pc.blue('║')}     ${pc.bold(pc.red('🦞 Principles Disciple'))} - Installer                        ${pc.blue('║')}
+${pc.blue('╚══════════════════════════════════════════════════════════════╝')}`;
+export { logger, banner };
+//# sourceMappingURL=logger.js.map

package/release-manager/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,IAAI,MAAM,GAAG,KAAK,CAAC;AAEnB,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,MAAM,GAAG;IACb,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9E,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAClF,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAChF,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAE9E,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE;QACpB,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,EAAE,CAAC,KAAa,EAAE,OAA0C,EAAE,EAAE;QAClE,IAAI,MAAM;YAAE,OAAO;QACnB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;CACF,CAAC;AAEF,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,kEAAkE,CAAC;EAC3F,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,uCAAuC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;EAChH,EAAE,CAAC,IAAI,CAAC,kEAAkE,CAAC,EAAE,CAAC;AAEhF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC"}

package/release-manager/dist/utils/workspace-divergence.d.ts

@@ -0,0 +1,36 @@
+/**
+ * PRI-686 Fix C: detect divergence between PD's canonical workspace and
+ * OpenClaw's resolved workspace for the `main` agent.
+ *
+ * Why: OpenClaw 2026.8/9 multi-agent layouts resolve an unpinned
+ * `agents.entries.main` to `<agents.defaults.workspace>/main`. When an
+ * Owner relocates the workspace root to a custom path, PD's installer pins
+ * the canonical config to that root while OpenClaw sessions run inside the
+ * `<root>/main` subdirectory — the plugin's hooks (PD explicit priority)
+ * and commands (ctx.workspaceDir) then split across two state trees, and
+ * every pain candidate is gated `needs_evidence` with no error pointing at
+ * the cause. This check makes the divergence visible at install time.
+ *
+ * Pure read-only check — never mutates openclaw.json.
+ */
+export interface WorkspaceDivergenceFinding {
+    /** true when OpenClaw's resolved main-agent workspace differs from PD canonical. */
+    divergent: boolean;
+    /** Path OpenClaw will resolve for the main agent (best-effort mirror of resolveAgentWorkspaceDir). */
+    openclawMainWorkspace: string | null;
+    /** Where each input came from, for the warning message. */
+    detail: string;
+    nextAction: string;
+}
+/**
+ * Mirror of OpenClaw's resolveAgentWorkspaceDir(cfg, 'main') for the
+ * branches that matter here (custom-workspace machines):
+ *   1. agents.entries.main.workspace (explicit pin) — wins
+ *   2. legacy-compatibility inheritance — out of scope; the join fallback
+ *      below is the dangerous branch this check exists to catch
+ *   3. path.join(agents.defaults.workspace, 'main') — the split case
+ *   4. <stateDir>/workspace-main — default layout, never divergent from
+ *      PD canonical in the dangerous way; reported as non-divergent.
+ */
+export declare function detectOpenClawMainWorkspaceDivergence(pdCanonicalWorkspace: string, openclawConfigPath?: string): WorkspaceDivergenceFinding;
+//# sourceMappingURL=workspace-divergence.d.ts.map

package/release-manager/dist/utils/workspace-divergence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-divergence.d.ts","sourceRoot":"","sources":["../../src/utils/workspace-divergence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,MAAM,WAAW,0BAA0B;IACzC,oFAAoF;IACpF,SAAS,EAAE,OAAO,CAAC;IACnB,sGAAsG;IACtG,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAgBD;;;;;;;;;GASG;AACH,wBAAgB,qCAAqC,CACnD,oBAAoB,EAAE,MAAM,EAC5B,kBAAkB,GAAE,MAA8D,GACjF,0BAA0B,CAuD5B"}

package/release-manager/dist/utils/workspace-divergence.js

@@ -0,0 +1,87 @@
+/**
+ * PRI-686 Fix C: detect divergence between PD's canonical workspace and
+ * OpenClaw's resolved workspace for the `main` agent.
+ *
+ * Why: OpenClaw 2026.8/9 multi-agent layouts resolve an unpinned
+ * `agents.entries.main` to `<agents.defaults.workspace>/main`. When an
+ * Owner relocates the workspace root to a custom path, PD's installer pins
+ * the canonical config to that root while OpenClaw sessions run inside the
+ * `<root>/main` subdirectory — the plugin's hooks (PD explicit priority)
+ * and commands (ctx.workspaceDir) then split across two state trees, and
+ * every pain candidate is gated `needs_evidence` with no error pointing at
+ * the cause. This check makes the divergence visible at install time.
+ *
+ * Pure read-only check — never mutates openclaw.json.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readJsonFile(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return isRecord(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Mirror of OpenClaw's resolveAgentWorkspaceDir(cfg, 'main') for the
+ * branches that matter here (custom-workspace machines):
+ *   1. agents.entries.main.workspace (explicit pin) — wins
+ *   2. legacy-compatibility inheritance — out of scope; the join fallback
+ *      below is the dangerous branch this check exists to catch
+ *   3. path.join(agents.defaults.workspace, 'main') — the split case
+ *   4. <stateDir>/workspace-main — default layout, never divergent from
+ *      PD canonical in the dangerous way; reported as non-divergent.
+ */
+export function detectOpenClawMainWorkspaceDivergence(pdCanonicalWorkspace, openclawConfigPath = path.join(os.homedir(), '.openclaw', 'openclaw.json')) {
+    const nonDivergent = (openclawMainWorkspace, detail) => ({
+        divergent: false,
+        openclawMainWorkspace,
+        detail,
+        nextAction: '',
+    });
+    const cfg = readJsonFile(openclawConfigPath);
+    if (!cfg) {
+        return nonDivergent(null, 'openclaw.json not found or unreadable — OpenClaw will use its default workspace layout');
+    }
+    const { agents } = cfg;
+    if (!isRecord(agents)) {
+        return nonDivergent(null, 'openclaw.json has no agents section — single-agent default layout');
+    }
+    const { entries } = agents;
+    const mainEntry = isRecord(entries) && isRecord(entries.main) ? entries.main : null;
+    // Branch 1: explicit pin on the main entry → no join, no split.
+    if (mainEntry && typeof mainEntry.workspace === 'string' && mainEntry.workspace.trim()) {
+        const pinned = path.resolve(mainEntry.workspace.trim());
+        return {
+            divergent: path.resolve(pdCanonicalWorkspace) !== pinned,
+            openclawMainWorkspace: pinned,
+            detail: `agents.entries.main.workspace = ${pinned}`,
+            nextAction: `Align them: set agents.entries.main.workspace to "${pdCanonicalWorkspace}" in ${openclawConfigPath}, or run the PD installer against "${pinned}".`,
+        };
+    }
+    // Branch 3: join(defaults.workspace, 'main') — the split case.
+    const { defaults } = agents;
+    const defaultsWorkspace = isRecord(defaults) && typeof defaults.workspace === 'string' && defaults.workspace.trim()
+        ? path.resolve(defaults.workspace.trim())
+        : null;
+    if (defaultsWorkspace) {
+        const joinedMain = path.join(defaultsWorkspace, 'main');
+        return {
+            divergent: path.resolve(pdCanonicalWorkspace) !== joinedMain,
+            openclawMainWorkspace: joinedMain,
+            detail: `agents.defaults.workspace = ${defaultsWorkspace}; unpinned agents.entries.main resolves to ${joinedMain}`,
+            nextAction: `OpenClaw will run main-agent sessions in "${joinedMain}" while PD uses "${pdCanonicalWorkspace}". ` +
+                `Fix: pin "workspace": "${pdCanonicalWorkspace}" on agents.entries.main in ${openclawConfigPath} (OpenClaw restart required).`,
+        };
+    }
+    // Branch 4: OpenClaw default layout — no custom root, not the split case.
+    return nonDivergent(null, 'agents.defaults.workspace not set — OpenClaw uses its default workspace layout');
+}
+//# sourceMappingURL=workspace-divergence.js.map

package/release-manager/dist/utils/workspace-divergence.js.map

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

package/release-manager/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "create-principles-disciple",
+  "version": "1.132.3",
+  "description": "Interactive CLI installer for Principles Disciple OpenClaw plugin",
+  "type": "module",
+  "bin": {
+    "create-principles-disciple": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "plugin",
+    "pd-cli",
+    "console",
+    "core",
+    "host-runtime",
+    "install-layout",
+    "release-manager",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "bundle": "node scripts/bundle-plugin.mjs",
+    "build:release-asset": "node scripts/build-self-contained-release.mjs",
+    "generate:release-locks": "node scripts/generate-release-locks.mjs",
+    "check:release-locks": "node scripts/check-release-locks.mjs",
+    "prepack": "npm run build && npm run bundle",
+    "prepublishOnly": "npm run build && npm run bundle",
+    "test": "vitest run",
+    "test:fast": "vitest run --exclude tests/smoke-packaged-install.test.ts --exclude tests/release-asset-smoke.test.ts",
+    "test:smoke:packaged": "vitest run tests/smoke-packaged-install.test.ts",
+    "test:smoke:release-asset": "vitest run tests/release-asset-smoke.test.ts"
+  },
+  "keywords": [
+    "openclaw",
+    "principles-disciple",
+    "cli",
+    "installer",
+    "interactive"
+  ],
+  "author": "csuzngjh",
+  "license": "MIT",
+  "dependencies": {
+    "@principles/install-layout": "file:../install-layout",
+    "@tufjs/models": "3.0.1",
+    "@inquirer/prompts": "^8.5.2",
+    "commander": "^14.0.3",
+    "fs-extra": "^11.4.0",
+    "js-yaml": "^5.3.0",
+    "ora": "^9.4.0",
+    "picocolors": "^1.0.0",
+    "semver": "^7.8.5",
+    "tar": "^7.5.22",
+    "tuf-js": "3.1.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^26.1.2",
+    "@types/semver": "^7.7.0",
+    "@types/tar": "^7.0.87",
+    "typescript": "^7.0.2",
+    "vite": "^8.0.16",
+    "vitest": "^4.1.10"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/csuzngjh/principles.git",
+    "directory": "packages/create-principles-disciple"
+  },
+  "pd": {
+    "bundledPluginVersion": "1.230.2"
+  }
+}