create-principles-disciple 1.134.3 → 1.134.4

package/console/dist/server/feedback/ingest-adapter.js

@@ -34,7 +34,7 @@ export async function probeIngestHealth(ingestUrl, deps) {
         return {
             available: false,
             reason: '当前运行环境不支持 fetch',
-            nextAction: '使用 Node 18+ 运行 console,或改用导出文件通道',
+            nextAction: '使用 Node 22+ 运行 console,或改用导出文件通道',
         };
     }
     try {

package/dist/i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;AAiPnC,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAEhD;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,wBAAgB,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;AAqPnC,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAEhD;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,wBAAgB,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D"}

package/dist/i18n.js

@@ -115,6 +115,8 @@ const translations = {
         rollback_fresh_clean_failed: 'The install failed before activation, and some partially deployed files could NOT be removed: {dirs}. They are not activated (no install manifest), but should be removed manually.',
         next_fresh_cleaned: 'Fix the error above and re-run the installer.',
         next_fresh_clean_failed: 'Remove the listed directories manually (they are not activated), then re-run the installer.',
+        // PRI-697 review P1: global pd shim files this run created survived the rollback.
+        rollback_global_shim_residue: 'Global pd shim files this run created could not be removed ({files}) — remove them manually.',
     },
     zh: {
         select_language: '选择语言',
@@ -232,6 +234,8 @@ const translations = {
         rollback_fresh_clean_failed: '安装未激活即失败，且部分已部署文件无法移除：{dirs}。它们未被激活（无安装清单），但应手动移除。',
         next_fresh_cleaned: '请修复上方错误后重新运行安装器。',
         next_fresh_clean_failed: '请手动移除上述目录（它们未被激活），然后重新运行安装器。',
+        // PRI-697 评审 P1：本次安装创建的全局 pd shim 文件在回滚后仍残留。
+        rollback_global_shim_residue: '本次安装创建的全局 pd shim 文件未能移除（{files}）——请手动移除。',
     },
 };
 let currentLanguage = 'zh';

package/dist/i18n.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAA6C;IAC7D,EAAE,EAAE;QACF,eAAe,EAAE,iBAAiB;QAClC,YAAY,EAAE,qBAAqB;QACnC,eAAe,EAAE,wDAAwD;QACzE,eAAe,EAAE,uDAAuD;QACxE,aAAa,EAAE,qBAAqB;QACpC,YAAY,EAAE,wBAAwB;QACtC,UAAU,EAAE,kBAAkB;QAC9B,UAAU,EAAE,sBAAsB;QAClC,gBAAgB,EAAE,sBAAsB;QACxC,YAAY,EAAE,oEAAoE;QAClF,eAAe,EAAE,kBAAkB;QACnC,cAAc,EAAE,wBAAwB;QACxC,QAAQ,EAAE,UAAU;QACpB,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,WAAW;QACtB,oBAAoB,EAAE,mBAAmB;QACzC,eAAe,EAAE,iBAAiB;QAClC,WAAW,EAAE,aAAa;QAC1B,cAAc,EAAE,mBAAmB;QACnC,aAAa,EAAE,qDAAqD;QACpE,wBAAwB,EAAE,gEAAgE;QAC1F,iBAAiB,EAAE,4CAA4C;QAC/D,qBAAqB,EAAE,qEAAqE;QAC5F,mBAAmB,EAAE,mEAAmE;QACxF,sBAAsB,EAAE,mDAAmD;QAC3E,yBAAyB,EAAE,uDAAuD;QAClF,mBAAmB,EAAE,sBAAsB;QAC3C,gBAAgB,EAAE,mBAAmB;QACrC,yBAAyB,EAAE,2BAA2B;QACtD,qBAAqB,EAAE,uBAAuB;QAC9C,qBAAqB,EAAE,mCAAmC;QAC1D,yBAAyB,EAAE,uCAAuC;QAClE,UAAU,EAAE,eAAe;QAC3B,yBAAyB,EAAE,2BAA2B;QACtD,mBAAmB,EAAE,qBAAqB;QAC1C,YAAY,EAAE,cAAc;QAC5B,cAAc,EAAE,gBAAgB;QAChC,oBAAoB,EAAE,sBAAsB;QAC5C,YAAY,EAAE,cAAc;QAC5B,aAAa,EAAE,eAAe;QAC9B,YAAY,EAAE,mBAAmB;QACjC,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,aAAa;QAC1B,wBAAwB,EAAE,gGAAgG;QAC1H,qBAAqB,EAAE,uFAAuF;QAC9G,cAAc,EAAE,gBAAgB;QAChC,WAAW,EAAE,aAAa;QAC1B,uBAAuB,EAAE,uBAAuB;QAChD,qBAAqB,EAAE,kFAAkF;QACzG,yBAAyB,EAAE,kDAAkD;QAC7E,mBAAmB,EAAE,qBAAqB;QAC1C,kBAAkB,EAAE,oDAAoD;QACxE,wBAAwB,EAAE,gDAAgD;QAC1E,mBAAmB,EAAE,gDAAgD;QACrE,wBAAwB,EAAE,6CAA6C;QACvE,iBAAiB,EAAE,sDAAsD;QACzE,mBAAmB,EAAE,qBAAqB;QAC1C,+BAA+B,EAAE,8EAA8E;QAC/G,2BAA2B,EAAE,oFAAoF;QACjH,kBAAkB,EAAE,uBAAuB;QAC3C,uBAAuB,EAAE,sEAAsE;QAC/F,mBAAmB,EAAE,gEAAgE;QACrF,mBAAmB,EAAE,8CAA8C;QACnE,gBAAgB,EAAE,kBAAkB;QACpC,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,SAAS;QAClB,aAAa,EAAE,eAAe;QAC9B,wBAAwB,EAAE,gCAAgC;QAC1D,sBAAsB,EAAE,wBAAwB;QAChD,4BAA4B,EAAE,iCAAiC;QAC/D,6BAA6B,EAAE,0CAA0C;QACzE,wBAAwB,EAAE,yEAAyE;QACnG,cAAc,EAAE,iBAAiB;QACjC,iBAAiB,EAAE,IAAI;QACvB,sBAAsB,EAAE,SAAS;QACjC,YAAY,EAAE,kCAAkC;QAChD,gBAAgB,EAAE,sCAAsC;QACxD,YAAY,EAAE,eAAe;QAC7B,kBAAkB;QAClB,wBAAwB,EAAE,sMAAsM;QAChO,0BAA0B,EAAE,+EAA+E;QAC3G,mBAAmB,EAAE,+DAA+D;QACpF,mBAAmB,EAAE,uDAAuD;QAC5E,uFAAuF;QACvF,eAAe,EAAE,6BAA6B;QAC9C,oBAAoB,EAAE,gFAAgF;QACtG,oBAAoB,EAAE,+DAA+D;QACrF,mBAAmB,EAAE,4BAA4B;QACjD,sBAAsB,EAAE,2BAA2B;QACnD,oBAAoB,EAAE,OAAO;QAC7B,gBAAgB,EAAE,qBAAqB;QACvC,eAAe,EAAE,kBAAkB;QACnC,mBAAmB,EAAE,uCAAuC;QAC5D,kBAAkB,EAAE,uBAAuB;QAC3C,iBAAiB,EAAE,oBAAoB;QACvC,sBAAsB,EAAE,kFAAkF;QAC1G,sBAAsB,EAAE,yEAAyE;QACjG,oBAAoB,EAAE,gEAAgE;QACtF,0BAA0B,EAAE,2CAA2C;QACvE,wBAAwB,EAAE,qFAAqF;QAC/G,oBAAoB,EAAE,mGAAmG;QACzH,kEAAkE;QAClE,mBAAmB,EAAE,uFAAuF;QAC5G,iBAAiB,EAAE,qCAAqC;QACxD,eAAe,EAAE,mIAAmI;QACpJ,oBAAoB,EAAE,qIAAqI;QAC3J,qBAAqB,EAAE,sFAAsF;QAC7G,aAAa,EAAE,oGAAoG;QACnH,mBAAmB,EAAE,mGAAmG;QACxH,oFAAoF;QACpF,sBAAsB,EAAE,sHAAsH;QAC9I,6BAA6B,EAAE,0JAA0J;QACzL,2BAA2B,EAAE,qLAAqL;QAClN,kBAAkB,EAAE,+CAA+C;QACnE,uBAAuB,EAAE,6FAA6F;QACtH,kFAAkF;QAClF,4BAA4B,EAAE,8FAA8F;KAC7H;IACD,EAAE,EAAE;QACF,eAAe,EAAE,MAAM;QACvB,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,gBAAgB;QACjC,eAAe,EAAE,gBAAgB;QACjC,aAAa,EAAE,OAAO;QACtB,YAAY,EAAE,UAAU;QACxB,UAAU,EAAE,OAAO;QACnB,UAAU,EAAE,SAAS;QACrB,gBAAgB,EAAE,QAAQ;QAC1B,YAAY,EAAE,wBAAwB;QACtC,eAAe,EAAE,OAAO;QACxB,cAAc,EAAE,OAAO;QACvB,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,KAAK;QAChB,oBAAoB,EAAE,UAAU;QAChC,eAAe,EAAE,MAAM;QACvB,WAAW,EAAE,MAAM;QACnB,cAAc,EAAE,OAAO;QACvB,aAAa,EAAE,kCAAkC;QACjD,wBAAwB,EAAE,8BAA8B;QACxD,iBAAiB,EAAE,uBAAuB;QAC1C,qBAAqB,EAAE,qDAAqD;QAC5E,mBAAmB,EAAE,mDAAmD;QACxE,sBAAsB,EAAE,mBAAmB;QAC3C,yBAAyB,EAAE,qBAAqB;QAChD,mBAAmB,EAAE,SAAS;QAC9B,gBAAgB,EAAE,OAAO;QACzB,yBAAyB,EAAE,wBAAwB;QACnD,qBAAqB,EAAE,MAAM;QAC7B,qBAAqB,EAAE,kBAAkB;QACzC,yBAAyB,EAAE,mBAAmB;QAC9C,UAAU,EAAE,aAAa;QACzB,yBAAyB,EAAE,aAAa;QACxC,mBAAmB,EAAE,OAAO;QAC5B,YAAY,EAAE,OAAO;QACrB,cAAc,EAAE,OAAO;QACvB,oBAAoB,EAAE,QAAQ;QAC9B,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,IAAI;QACnB,YAAY,EAAE,MAAM;QACpB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,MAAM;QACnB,wBAAwB,EAAE,oCAAoC;QAC9D,qBAAqB,EAAE,8BAA8B;QACrD,cAAc,EAAE,MAAM;QACtB,WAAW,EAAE,OAAO;QACpB,uBAAuB,EAAE,WAAW;QACpC,qBAAqB,EAAE,2BAA2B;QAClD,yBAAyB,EAAE,cAAc;QACzC,mBAAmB,EAAE,OAAO;QAC5B,kBAAkB,EAAE,6CAA6C;QACjE,wBAAwB,EAAE,wBAAwB;QAClD,mBAAmB,EAAE,qBAAqB;QAC1C,wBAAwB,EAAE,aAAa;QACvC,iBAAiB,EAAE,oBAAoB;QACvC,mBAAmB,EAAE,OAAO;QAC5B,+BAA+B,EAAE,wBAAwB;QACzD,2BAA2B,EAAE,oCAAoC;QACjE,kBAAkB,EAAE,SAAS;QAC7B,uBAAuB,EAAE,oBAAoB;QAC7C,mBAAmB,EAAE,mBAAmB;QACxC,mBAAmB,EAAE,8BAA8B;QACnD,gBAAgB,EAAE,MAAM;QACxB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,KAAK;QACd,aAAa,EAAE,MAAM;QACrB,wBAAwB,EAAE,aAAa;QACvC,sBAAsB,EAAE,SAAS;QACjC,4BAA4B,EAAE,UAAU;QACxC,6BAA6B,EAAE,iBAAiB;QAChD,wBAAwB,EAAE,6BAA6B;QACvD,cAAc,EAAE,OAAO;QACvB,iBAAiB,EAAE,IAAI;QACvB,sBAAsB,EAAE,SAAS;QACjC,YAAY,EAAE,yBAAyB;QACvC,gBAAgB,EAAE,yBAAyB;QAC3C,YAAY,EAAE,WAAW;QACzB,WAAW;QACX,wBAAwB,EAAE,wJAAwJ;QAClL,0BAA0B,EAAE,2BAA2B;QACvD,mBAAmB,EAAE,mBAAmB;QACxC,mBAAmB,EAAE,gDAAgD;QACrE,8CAA8C;QAC9C,eAAe,EAAE,uBAAuB;QACxC,oBAAoB,EAAE,8BAA8B;QACpD,oBAAoB,EAAE,2BAA2B;QACjD,mBAAmB,EAAE,gBAAgB;QACrC,sBAAsB,EAAE,YAAY;QACpC,oBAAoB,EAAE,IAAI;QAC1B,gBAAgB,EAAE,iBAAiB;QACnC,eAAe,EAAE,cAAc;QAC/B,mBAAmB,EAAE,iBAAiB;QACtC,kBAAkB,EAAE,iBAAiB;QACrC,iBAAiB,EAAE,cAAc;QACjC,sBAAsB,EAAE,4CAA4C;QACpE,sBAAsB,EAAE,oCAAoC;QAC5D,oBAAoB,EAAE,oDAAoD;QAC1E,0BAA0B,EAAE,0BAA0B;QACtD,wBAAwB,EAAE,2DAA2D;QACrF,oBAAoB,EAAE,iDAAiD;QACvE,iCAAiC;QACjC,mBAAmB,EAAE,4BAA4B;QACjD,iBAAiB,EAAE,YAAY;QAC/B,eAAe,EAAE,qEAAqE;QACtF,oBAAoB,EAAE,yFAAyF;QAC/G,qBAAqB,EAAE,2BAA2B;QAClD,aAAa,EAAE,iCAAiC;QAChD,mBAAmB,EAAE,qDAAqD;QAC1E,gCAAgC;QAChC,sBAAsB,EAAE,uCAAuC;QAC/D,6BAA6B,EAAE,8CAA8C;QAC7E,2BAA2B,EAAE,oDAAoD;QACjF,kBAAkB,EAAE,kBAAkB;QACtC,uBAAuB,EAAE,8BAA8B;QACvD,6CAA6C;QAC7C,4BAA4B,EAAE,2CAA2C;KAC1E;CACF,CAAC;AAEF,IAAI,eAAe,GAAa,IAAI,CAAC;AAErC,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,CAAC,CAAC,GAAW;IAC3B,OAAO,YAAY,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC;AAC1C,CAAC"}

package/dist/installer.d.ts

@@ -209,6 +209,19 @@ export declare function ensureBundledPdCliResolution(pdCliRoot: string): void;
 export declare function runLegacyRuleContractPreflight(pluginDir: string, workspaceDir: string, runScan?: LegacyRulePreflightRunner): Promise<LegacyRulePreflightOutcome>;
 export declare function checkBuiltPlugin(pluginDir: string): Promise<void>;
 export declare function installPluginToStaging(pluginDir: string, language: SkillLanguage): Promise<void>;
+/** Outcome of one global-shim discovery/install attempt (PRI-697 review P1). */
+export interface GlobalPdShimResult {
+    /** true when PD-owned shim files are in place in the npm global bin dir. */
+    installed: boolean;
+    /** Shim files this run CREATED (absent before) — the rollback set. */
+    createdPaths: string[];
+    /** PD-owned shim files that already existed and were overwritten in place. */
+    replacedPaths: string[];
+    /** Foreign-owned `pd` entries found — never written, never rolled back. */
+    skippedForeignPaths: string[];
+}
+export declare function installGlobalPdShim(): GlobalPdShimResult | boolean;
+export declare function tryUpgradePdCliFromNpm(installedPdCliDir: string): void;
 /**
  * PRI-711: materialize node_modules links for the INSTALLED codex-adapter so
  * its declared `file:../<component>` dependencies resolve under ESM realpath

package/dist/installer.d.ts.map

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

package/dist/installer.js

@@ -727,6 +727,33 @@ function cleanupBackup(backupDir, runtimeBackupDir) {
         }
     }
 }
+/**
+ * PRI-697 review P1: undo the global `pd` shim side effect when the
+ * install transaction fails. Exactly the files THIS run created are
+ * removed; PD-owned shims that already existed before the run (a
+ * pre-existing install's global command) are left in place — rolling back
+ * to the pre-run state, not to "no PD anywhere". Best-effort with every
+ * residue named (rc-9); never throws.
+ */
+function rollbackGlobalPdShim(record) {
+    const removed = [];
+    const failed = [];
+    for (const shimPath of record.createdPaths) {
+        if (!existsSync(shimPath))
+            continue;
+        try {
+            rmSync(shimPath, { force: true });
+            removed.push(shimPath);
+        }
+        catch (e) {
+            failed.push(`${shimPath} (${e instanceof Error ? e.message : String(e)})`);
+        }
+    }
+    if (failed.length > 0) {
+        logger.warn(`Failed to remove global pd shim files created by this run: ${failed.join(', ')} — remove them manually.`);
+    }
+    return { removed, failed };
+}
 /**
  * Decide how to handle a running gateway.
  * - --stop-gateway flag → 'stop' (auto-stop, no prompt, even in interactive).
@@ -1094,8 +1121,59 @@ function getNpmGlobalBinDir() {
         return null;
     }
 }
-function installGlobalPdShim() {
-    if (!legacyNpmInstallEnabled()) {
+/** Fixed filename whitelist for global-shim targets (no caller input). */
+const GLOBAL_PD_SHIM_BASENAMES = isWindows() ? ['pd.cmd', 'pd.ps1'] : ['pd'];
+/** Resolve a whitelisted shim basename under the npm global bin dir. */
+function globalShimPath(globalBin, basename) {
+    if (!GLOBAL_PD_SHIM_BASENAMES.includes(basename)) {
+        throw new Error(`Refusing to touch non-whitelisted global shim name: ${basename}`);
+    }
+    const target = path.resolve(globalBin, basename);
+    if (path.dirname(target) !== path.resolve(globalBin)) {
+        throw new Error(`Global shim path escaped the npm global bin dir: ${target}`);
+    }
+    return target;
+}
+/**
+ * Global `pd` shim ownership, mirroring the uninstaller's isPdOwnedShim
+ * discipline: a shim whose content points at the PD install dir belongs to
+ * us and may be updated in place; anything else (another tool's `pd`, a
+ * broken/unreadable entry) is foreign — refuse to overwrite it and surface
+ * a warning + next action instead (review P1: the pre-PRI-697 code
+ * writeFileSync'd blindly, but that path was only reachable via the
+ * explicit legacy-recovery env; the npm channel makes it default, so the
+ * write now needs the same ownership discipline the uninstaller already
+ * has).
+ */
+function classifyGlobalPdShim(globalBin, installedBinDir) {
+    const foreignPaths = [];
+    let existingPdOwned = false;
+    for (const shim of GLOBAL_PD_SHIM_BASENAMES) {
+        const shimPath = globalShimPath(globalBin, shim);
+        if (!existsSync(shimPath))
+            continue;
+        let content;
+        try {
+            content = readFileSync(shimPath, 'utf-8');
+        }
+        catch {
+            foreignPaths.push(shimPath); // unreadable → do not touch
+            continue;
+        }
+        if (content.includes(installedBinDir))
+            existingPdOwned = true;
+        else
+            foreignPaths.push(shimPath);
+    }
+    return { foreignPaths, existingPdOwned };
+}
+export function installGlobalPdShim() {
+    // Global-shim discovery consults the npm global root, so it belongs to
+    // the npm-distributed payload shape (isNpmDependencyResolutionEnabled
+    // documents "global root discovery" as its concern). Gating on the
+    // legacy env var instead fired this skip — with a self-contained-mode
+    // message — inside standard npm-channel installs (PRI-697).
+    if (!isNpmDependencyResolutionEnabled()) {
         logger.info('Skipping npm global shim discovery for the self-contained release asset.');
         return false;
     }
@@ -1110,31 +1188,80 @@ function installGlobalPdShim() {
     const globalBin = getNpmGlobalBinDir();
     if (!globalBin)
         return false;
+    const installedBinDir = getInstalledBinDir();
+    // Ownership gate before ANY write: foreign `pd` entries are never
+    // overwritten (uninstaller's isPdOwnedShim discipline, write side).
+    const { foreignPaths, existingPdOwned } = classifyGlobalPdShim(globalBin, installedBinDir);
+    if (foreignPaths.length > 0) {
+        const foreignList = foreignPaths.join(', ');
+        logger.warn(`A non-PD "pd" command already exists in the npm global bin dir (${foreignList}) — not overwriting it.`);
+        logger.warn(`The bundled PD CLI stays available at "${path.join(installedBinDir, isWindows() ? 'pd.cmd' : 'pd')}". Remove the foreign "pd" yourself if you want the global name.`);
+        if (existingPdOwned) {
+            logger.warn('PD-owned shim files in the same dir were left untouched to keep the existing installation consistent.');
+        }
+        return { installed: false, createdPaths: [], replacedPaths: [], skippedForeignPaths: foreignPaths };
+    }
+    // Rollback bookkeeping: which shim targets already existed (PD-owned)?
+    // preExisting drives the replaced-list and the partial-failure residue
+    // computation below.
+    const preExisting = new Set(GLOBAL_PD_SHIM_BASENAMES
+        .map((shim) => globalShimPath(globalBin, shim))
+        .filter((shimPath) => existsSync(shimPath)));
+    const createdPaths = [];
+    const replacedPaths = [...preExisting];
     try {
         mkdirSync(globalBin, { recursive: true });
-        const installedBinDir = getInstalledBinDir();
         if (isWindows()) {
             const pluginCmd = path.join(installedBinDir, 'pd.cmd');
-            writeFileSync(path.join(globalBin, 'pd.cmd'), `@echo off\r\ncall "${pluginCmd.replace(/"/g, '""')}" %*\r\n`, 'utf-8');
+            const globalCmdPath = globalShimPath(globalBin, 'pd.cmd');
+            writeFileSync(globalCmdPath, `@echo off\r\ncall "${pluginCmd.replace(/"/g, '""')}" %*\r\n`, 'utf-8');
             const pluginPs = path.join(installedBinDir, 'pd.ps1');
-            writeFileSync(path.join(globalBin, 'pd.ps1'), `$shim = "${pluginPs.replace(/`/g, '``').replace(/"/g, '`"')}"\r\n& $shim @args\r\nexit $LASTEXITCODE\r\n`, 'utf-8');
+            const globalPsPath = globalShimPath(globalBin, 'pd.ps1');
+            writeFileSync(globalPsPath, `$shim = "${pluginPs.replace(/`/g, '``').replace(/"/g, '`"')}"\r\n& $shim @args\r\nexit $LASTEXITCODE\r\n`, 'utf-8');
         }
         else {
             const pluginSh = path.join(installedBinDir, 'pd');
-            const globalSh = path.join(globalBin, 'pd');
+            const globalSh = globalShimPath(globalBin, 'pd');
             writeFileSync(globalSh, `#!/usr/bin/env sh\nexec "${pluginSh.replace(/"/g, '\\"')}" "$@"\n`, 'utf-8');
             chmodSync(globalSh, 0o755);
         }
-        return true;
+        // PRI-697 review P1: the success path MUST record which targets are new
+        // (created) vs pre-existing PD-owned (replaced) — rollbackGlobalPdShim
+        // removes exactly createdPaths when a LATER install step fails. The
+        // pre-fix success path left createdPaths empty, silently no-op'ing the
+        // rollback while the failure message claimed a clean cleanup.
+        for (const shim of GLOBAL_PD_SHIM_BASENAMES) {
+            const shimPath = globalShimPath(globalBin, shim);
+            if (!preExisting.has(shimPath))
+                createdPaths.push(shimPath);
+        }
+        return { installed: true, createdPaths, replacedPaths, skippedForeignPaths: [] };
     }
     catch (e) {
         logger.warn(`Global pd shim installation failed: ${e instanceof Error ? e.message : String(e)}`);
-        return false;
-    }
-}
-function tryUpgradePdCliFromNpm(installedPdCliDir) {
+        // Partial writes may have landed before the failure — hand the raw
+        // targets to the caller as createdPaths so the rollback can remove
+        // exactly this run's residue.
+        const landed = GLOBAL_PD_SHIM_BASENAMES
+            .map((shim) => globalShimPath(globalBin, shim))
+            .filter((shimPath) => existsSync(shimPath) && !preExisting.has(shimPath));
+        return { installed: false, createdPaths: landed, replacedPaths: [], skippedForeignPaths: [] };
+    }
+}
+export function tryUpgradePdCliFromNpm(installedPdCliDir) {
+    // The npm upgrade stays gated on the legacy env var (PRI-697 keeps the
+    // behavior): a registry pd-cli version can import exports the bundled
+    // core no longer has, so upgrading is only for the explicit recovery
+    // path where the whole shape is registry-resolved anyway. The skip
+    // message reports the ACTUAL payload mode — it used to claim
+    // "self-contained release asset" even in npm-distributed installs.
     if (!legacyNpmInstallEnabled()) {
-        logger.info('Skipping npm pd-cli upgrade for the self-contained release asset.');
+        if (activePayloadMode === 'npm-distributed') {
+            logger.info('Skipping npm pd-cli upgrade (bundled pd-cli is authoritative; set PD_ALLOW_LEGACY_NPM_INSTALL to enable registry upgrades).');
+        }
+        else {
+            logger.info('Skipping npm pd-cli upgrade for the self-contained release asset.');
+        }
         return;
     }
     // Allow skipping the npm upgrade in smoke tests / offline environments.
@@ -1219,6 +1346,16 @@ function tryUpgradePdCliFromNpm(installedPdCliDir) {
         logger.info(`pd-cli npm upgrade skipped (${msg}). Bundled version is functional.`);
     }
 }
+/**
+ * Deploy the bundled pd-cli into the runtime + local bin shims + (npm-
+ * distributed payload only) the global `pd` shim. Returns the global-shim
+ * transaction bookkeeping so install() can roll the global side effect back
+ * on failure (PRI-697 review P1): globalShim is null when no global write
+ * was attempted (skip gates / payload mode), otherwise it records which
+ * shim files this run CREATED (rollback removes them) vs which PD-owned
+ * files it replaced in place (rollback keeps them — a pre-existing PD
+ * install keeps its global command).
+ */
 function syncPdCli(pluginDir) {
     const pdCliSourceDir = path.join(pluginDir, 'pd-cli');
     const distDir = path.join(pdCliSourceDir, 'dist');
@@ -1335,7 +1472,13 @@ function syncPdCli(pluginDir) {
         writeFileSync(target, shShim, 'utf-8');
         chmodSync(target, 0o755);
     }
-    return installGlobalPdShim();
+    // PRI-697 review P1: propagate the structured global-shim outcome so the
+    // install transaction can roll the global side effect back on failure.
+    // Plain false (skip gates: payload mode / smoke env) carries no residue.
+    const shimResult = installGlobalPdShim();
+    if (typeof shimResult === 'boolean')
+        return { ok: shimResult, globalShim: null };
+    return { ok: shimResult.installed, globalShim: shimResult };
 }
 function verifyPdCliShim() {
     const localShim = path.join(getInstalledBinDir(), isWindows() ? 'pd.cmd' : 'pd');
@@ -2276,6 +2419,10 @@ transaction) {
     // the backup step). With no pre-existing install (no backup), a failure
     // after this point must clean up instead of claiming "not modified".
     let mutationStarted = false;
+    // PRI-697 review P1: global pd shim side effect, recorded when the
+    // npm-distributed payload wrote PD-owned shims into the npm global bin
+    // dir. Null until syncPdCli runs (or when no global write was attempted).
+    let globalShimRecord = null;
     const killConsoleChild = () => {
         if (consoleProcess) {
             try {
@@ -2414,7 +2561,11 @@ transaction) {
         stepIndex++;
         if (spinner)
             updateProgress(spinner, stepIndex, 'Installing pd CLI...');
-        syncPdCli(pluginDir);
+        // PRI-697 review P1: keep the global-shim bookkeeping — a LATER failure
+        // must undo exactly the global side effect this run caused.
+        const pdCliSync = syncPdCli(pluginDir);
+        if (pdCliSync.globalShim !== null)
+            globalShimRecord = pdCliSync.globalShim;
         await installPdCliDependencies();
         stepIndex++;
         if (spinner)
@@ -2703,6 +2854,17 @@ transaction) {
         const freshCleanup = !hasBackup && mutationStarted
             ? cleanUnactivatedFreshInstall()
             : undefined;
+        // PRI-697 review P1: the global pd shim is a side effect OUTSIDE the
+        // runtime/extension trees both cleanup paths above address. Whatever
+        // the backup state, files THIS run created in the npm global bin dir
+        // are this run's residue — remove them (rollbackGlobalPdShim keeps
+        // PD-owned shims that pre-dated the run, so a rolled-back upgrade of a
+        // previously-shimmed install keeps its old global command; the shim
+        // content targets the stable installed bin dir, which the restored
+        // backup re-populates).
+        const globalShimRollback = globalShimRecord !== null
+            ? rollbackGlobalPdShim(globalShimRecord)
+            : undefined;
         // R2 (review): after template/config steps have run (console verified →
         // templates copied → config generated), the WORKSPACE also holds this
         // run's files — but the workspace is the operator's own directory and may
@@ -2721,7 +2883,11 @@ transaction) {
                     .replace('{restoreError}', restoreResult.error ?? '')
                     .replace('{extDir}', extDir)
                     .replace('{backupDir}', backupDir ?? runtimeBackupDir ?? '');
-        const rollbackSuffixFinal = rollbackSuffix + (workspaceTouched && freshCleanup && freshCleanup.failed.length === 0 ? ` ${t('rollback_fresh_workspace_kept')}` : '');
+        const rollbackSuffixFinal = rollbackSuffix
+            + (workspaceTouched && freshCleanup && freshCleanup.failed.length === 0 ? ` ${t('rollback_fresh_workspace_kept')}` : '')
+            + (globalShimRollback !== undefined && globalShimRollback.failed.length > 0
+                ? ` ${t('rollback_global_shim_residue').replace('{files}', globalShimRollback.failed.join(', '))}`
+                : '');
         const rollbackNextAction = !hasBackup
             ? freshCleanup
                 ? (freshCleanup.failed.length === 0 ? t('next_fresh_cleaned') : t('next_fresh_clean_failed'))
@@ -2736,7 +2902,7 @@ transaction) {
                     .replace('{errorMsg}', errorMsg);
         const rollbackReason = !hasBackup
             ? freshCleanup
-                ? (freshCleanup.failed.length === 0
+                ? (freshCleanup.failed.length === 0 && (globalShimRollback === undefined || globalShimRollback.failed.length === 0)
                     ? `install_failed_unactivated_cleaned: ${errorMsg}`
                     : `install_failed_unactivated_residue: ${errorMsg}`)
                 : (isLockError ? `install_aborted_lock: ${errorMsg}` : `install_failed_before_mutation: ${errorMsg}`)