create-principles-disciple 1.132.2 → 1.132.3

package/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/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/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/install-layout/dist/index.d.ts

@@ -31,6 +31,11 @@ export interface InstallLayoutPaths {
     codexDir: string;
     openClawDir: string;
     openClawExtensionDir: string;
+    /**
+     * PRI-672: the ReleaseManager authority component (payload dir
+     * release-manager/, npm name create-principles-disciple).
+     */
+    releaseManagerDir: string;
 }
 export interface LayoutResolution {
     mode: InstallLayoutMode | 'missing';

package/install-layout/dist/index.js

@@ -76,6 +76,7 @@ export function getInstallLayoutPaths(homeDir) {
         codexDir: path.join(pdDir, 'codex'),
         openClawDir,
         openClawExtensionDir: path.join(openClawDir, 'extensions', 'principles-disciple'),
+        releaseManagerDir: path.join(runtimeDir, 'release-manager'),
     };
 }
 export function resolveInstallLayout(options) {

package/install-layout/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principles/install-layout",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-principles-disciple",
-  "version": "1.132.2",
+  "version": "1.132.3",
   "description": "Interactive CLI installer for Principles Disciple OpenClaw plugin",
   "type": "module",
   "bin": {
@@ -14,6 +14,7 @@
     "core",
     "host-runtime",
     "install-layout",
+    "release-manager",
     "README.md",
     "LICENSE"
   ],
@@ -72,6 +73,6 @@
     "directory": "packages/create-principles-disciple"
   },
   "pd": {
-    "bundledPluginVersion": "1.230.0"
+    "bundledPluginVersion": "1.230.2"
   }
 }