create-principles-disciple 1.144.2 → 1.144.6

package/dist/installer.d.ts

@@ -298,6 +298,49 @@ export declare function tryUpgradePdCliFromNpm(installedPdCliDir: string): void;
  * payload or a call-order regression, which fails the install loudly.
  */
 export declare function ensureCodexAdapterResolution(): void;
+/**
+ * PRI-912 (SPEC-P1′-A): canonical junction reconciliation for the plugin's
+ * bundled @principles/core copy. The self-contained release asset must ship
+ * node_modules materialized (the asset builder refuses symlinks), so every
+ * deployed plugin carries a full physical duplicate of the runtime root core
+ * (~119MB / 17k files on a real install). This pass runs once ALL components
+ * are deployed and BEFORE the journal 'staged' transition — a conversion that
+ * breaks runtime resolution must surface through the EXISTING console-probe →
+ * rollback channel, not a new one.
+ *
+ * The ONLY candidate is <pluginDir>/node_modules/@principles/core with the
+ * runtime root core (<runtime>/core) as canonical source. A materialized copy
+ * is converted to a junction (Windows) / relative symlink (Unix) only when
+ * ALL three gates hold:
+ *   1. package identity — the copy's and the source's package.json `name`
+ *      agree (evidence-based; never name-matching alone),
+ *   2. declared relationship — the plugin manifest declares
+ *      `@principles/core` as a `file:` dependency whose declared path stays
+ *      inside the plugin dir (rc-1) and RESOLVES to the canonical runtime
+ *      core (the <plugin>/core slot installPluginToStaging creates),
+ *   3. content digest — digestDirectory(copy) === digestDirectory(source).
+ * Any gate failure (or an unreadable/partial state) SKIPS the copy with a
+ * structured reason (rc-9) and never mutates it — dedup must never make an
+ * install worse. Conversion is rename-swap with verification and restore:
+ * a failed link creation/verification puts the materialized copy back; only
+ * a restore failure (which WOULD break resolution) fails the install loud
+ * into the existing fail → rollback channel. Idempotent: an existing link
+ * that already resolves to the canonical core is a no-op. The canonical
+ * target itself is never deleted: removing a converted tree unlinks the
+ * junction, it does not follow it (rmSync/fse.remove symlink semantics).
+ */
+export interface CoreJunctionReconciliation {
+    /** Materialized copies replaced by a verified canonical junction. */
+    readonly converted: readonly string[];
+    /** Existing links already resolving to the canonical core (idempotent no-op). */
+    readonly alreadyCanonical: readonly string[];
+    /** Structured skip records — every non-conversion carries a reason (rc-9). */
+    readonly skipped: readonly {
+        dir: string;
+        reason: string;
+    }[];
+}
+export declare function reconcilePluginCoreCanonicalJunction(): CoreJunctionReconciliation;
 export interface InstallResult {
     success: boolean;
     workspaceDir: string;

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

@@ -832,6 +832,7 @@ const INSTALL_STEPS = [
     { name: 'Installing pd-console', weight: 8 },
     { name: 'Preparing core library for console', weight: 3 },
     { name: 'Validating bundled console dependencies', weight: 5 },
+    { name: 'Reconciling canonical core junction', weight: 1 },
     { name: 'Verifying pd-console', weight: 3 },
     { name: 'Copying templates', weight: 3 },
     { name: 'Generating config.yaml', weight: 2 },
@@ -2101,6 +2102,221 @@ export function ensureCodexAdapterResolution() {
         }
     }
 }
+const CORE_JUNCTION_PACKAGE = '@principles/core';
+/** Reads a package.json `name` as untrusted input (rc-1); null when absent/malformed. */
+function readPackageJsonName(manifestPath) {
+    try {
+        const parsed = JSON.parse(readFileSync(manifestPath, 'utf8'));
+        if (!isRecord(parsed))
+            return null;
+        const { name } = parsed;
+        return typeof name === 'string' && name.length > 0 ? name : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function reconcilePluginCoreCanonicalJunction() {
+    const converted = [];
+    const alreadyCanonical = [];
+    const skipped = [];
+    const runtimeCoreDir = getInstalledCoreDir();
+    const runtimeCoreReal = (() => {
+        try {
+            return realpathSync(runtimeCoreDir);
+        }
+        catch {
+            return null;
+        }
+    })();
+    if (runtimeCoreReal === null) {
+        // No canonical source → nothing safe to link to; the copies still work.
+        for (const pluginDir of pluginInstallDirs()) {
+            skipped.push({ dir: path.join(pluginDir, 'node_modules', CORE_JUNCTION_PACKAGE), reason: 'canonical_runtime_core_missing' });
+        }
+        return { converted, alreadyCanonical, skipped };
+    }
+    // Computed at most once, only when a materialized candidate reaches gate 3.
+    let runtimeCoreDigest = null;
+    for (const pluginDir of pluginInstallDirs()) {
+        const coreSlot = path.join(pluginDir, 'node_modules', CORE_JUNCTION_PACKAGE);
+        // lstat (never existsSync): a dangling link must be reported as a link
+        // problem, not misread as an absent copy.
+        let slotStat;
+        try {
+            slotStat = lstatSync(coreSlot);
+        }
+        catch {
+            skipped.push({ dir: coreSlot, reason: 'copy_absent' });
+            continue;
+        }
+        try {
+            if (slotStat.isSymbolicLink()) {
+                try {
+                    if (realpathSync(coreSlot) === runtimeCoreReal) {
+                        alreadyCanonical.push(coreSlot);
+                    }
+                    else {
+                        skipped.push({ dir: coreSlot, reason: 'existing_link_resolves_elsewhere' });
+                    }
+                }
+                catch {
+                    skipped.push({ dir: coreSlot, reason: 'existing_link_target_unreadable' });
+                }
+                continue;
+            }
+            if (!slotStat.isDirectory()) {
+                skipped.push({ dir: coreSlot, reason: 'copy_not_a_directory' });
+                continue;
+            }
+        }
+        catch (error) {
+            // An unreadable/partial slot state is never mutated and never fails
+            // the install — dedup is an optimization over a working copy (rc-9).
+            skipped.push({ dir: coreSlot, reason: `copy_unreadable: ${error instanceof Error ? error.message : String(error)}` });
+            continue;
+        }
+        // Gate 1 — package identity from both manifests.
+        const copyName = readPackageJsonName(path.join(coreSlot, 'package.json'));
+        const sourceName = readPackageJsonName(path.join(runtimeCoreDir, 'package.json'));
+        if (copyName === null || sourceName === null || copyName !== sourceName) {
+            skipped.push({ dir: coreSlot, reason: `package_identity_mismatch: copy=${JSON.stringify(copyName)} source=${JSON.stringify(sourceName)}` });
+            continue;
+        }
+        // Gate 2 — the declared file: dependency binds the copy slot to the
+        // canonical core. The ref is untrusted (rc-1): only relative refs that
+        // stay inside the plugin dir are considered.
+        const pluginManifestPath = path.join(pluginDir, 'package.json');
+        let declaredRef;
+        try {
+            const parsed = JSON.parse(readFileSync(pluginManifestPath, 'utf8'));
+            if (!isRecord(parsed) || !isRecord(parsed.dependencies)) {
+                skipped.push({ dir: coreSlot, reason: 'plugin_manifest_dependencies_unreadable' });
+                continue;
+            }
+            declaredRef = parsed.dependencies[CORE_JUNCTION_PACKAGE];
+        }
+        catch (error) {
+            skipped.push({ dir: coreSlot, reason: `plugin_manifest_unreadable: ${error instanceof Error ? error.message : String(error)}` });
+            continue;
+        }
+        if (typeof declaredRef !== 'string' || !declaredRef.startsWith('file:')) {
+            skipped.push({ dir: coreSlot, reason: `declared_dependency_not_file_ref: ${JSON.stringify(declaredRef ?? null)}` });
+            continue;
+        }
+        const declaredDir = path.resolve(pluginDir, declaredRef.slice('file:'.length));
+        if (declaredDir !== pluginDir && !declaredDir.startsWith(pluginDir + path.sep)) {
+            skipped.push({ dir: coreSlot, reason: `declared_dependency_escapes_plugin_dir: ${declaredRef}` });
+            continue;
+        }
+        let declaredResolvesToCore;
+        try {
+            declaredResolvesToCore = existsSync(declaredDir) && realpathSync(declaredDir) === runtimeCoreReal;
+        }
+        catch {
+            // Unreadable declared slot — treat as not resolving to the canonical core.
+            declaredResolvesToCore = false;
+        }
+        if (!declaredResolvesToCore) {
+            skipped.push({ dir: coreSlot, reason: `declared_file_dep_does_not_resolve_to_runtime_core: ${declaredRef}` });
+            continue;
+        }
+        // Gate 3 — content digest equality. Either side failing to digest is a
+        // skip (rc-9), never an install failure.
+        if (runtimeCoreDigest === null) {
+            try {
+                runtimeCoreDigest = digestDirectory(runtimeCoreDir);
+            }
+            catch (error) {
+                skipped.push({ dir: coreSlot, reason: `canonical_core_unreadable: ${error instanceof Error ? error.message : String(error)}` });
+                continue;
+            }
+        }
+        let copyDigest;
+        try {
+            copyDigest = digestDirectory(coreSlot);
+        }
+        catch (error) {
+            skipped.push({ dir: coreSlot, reason: `copy_unreadable: ${error instanceof Error ? error.message : String(error)}` });
+            continue;
+        }
+        if (copyDigest !== runtimeCoreDigest) {
+            skipped.push({ dir: coreSlot, reason: 'content_digest_mismatch' });
+            continue;
+        }
+        // All gates hold: rename-swap the materialized copy for a canonical link.
+        const backupPath = `${coreSlot}.pri912-materialized`;
+        // The backup name is reserved by this pass; clear our own stale residue
+        // so the swap below can never collide with it. If the residue cannot be
+        // removed (e.g. Windows EBUSY from an AV scan holding the ~17k-file tree),
+        // the swap would collide anyway — skip with the working copy intact
+        // rather than throw out of the pass and fail a healthy install (rc-9).
+        try {
+            rmSync(backupPath, { recursive: true, force: true });
+        }
+        catch (error) {
+            skipped.push({ dir: coreSlot, reason: `stale_backup_unremovable: ${error instanceof Error ? error.message : String(error)}` });
+            continue;
+        }
+        try {
+            renameSync(coreSlot, backupPath);
+        }
+        catch (error) {
+            skipped.push({ dir: coreSlot, reason: `rename_aside_failed: ${error instanceof Error ? error.message : String(error)}` });
+            continue;
+        }
+        try {
+            if (isWindows()) {
+                symlinkSync(runtimeCoreDir, coreSlot, 'junction');
+            }
+            else {
+                symlinkSync(path.relative(path.dirname(coreSlot), runtimeCoreDir), coreSlot, 'dir');
+            }
+            if (realpathSync(coreSlot) !== runtimeCoreReal) {
+                throw new Error('fresh link does not resolve to the canonical core');
+            }
+        }
+        catch (error) {
+            // Conversion failed — put the proven-identical copy back. The slot must
+            // never be left empty or dangling; only a failed RESTORE breaks
+            // resolution and deserves the fail → rollback channel. Remove the slot
+            // unconditionally (force handles absent, lstat semantics unlinks a
+            // dangling link without following it); guarding on existsSync would MISS
+            // a dangling link — existsSync follows it to a missing target and returns
+            // false — leaving it to make the restore renameSync fail.
+            try {
+                rmSync(coreSlot, { recursive: true, force: true });
+                renameSync(backupPath, coreSlot);
+            }
+            catch (restoreError) {
+                throw new Error(`PRI-912 core junction conversion failed at ${coreSlot} AND the materialized copy could not be restored: `
+                    + `${restoreError instanceof Error ? restoreError.message : String(restoreError)}`
+                    + ` (original conversion failure: ${error instanceof Error ? error.message : String(error)})`, { cause: restoreError });
+            }
+            skipped.push({ dir: coreSlot, reason: `conversion_failed_restored: ${error instanceof Error ? error.message : String(error)}` });
+            continue;
+        }
+        // The link is created and verified — the conversion is a success. Removing
+        // the now-redundant materialized backup is only disk reclamation; if it
+        // fails (Windows EBUSY/EPERM on ~17k files) we must NOT roll back a
+        // working install. Leave the residue, warn, and keep the converted slot.
+        try {
+            rmSync(backupPath, { recursive: true, force: true });
+        }
+        catch (error) {
+            logger.warn(`PRI-912: converted ${coreSlot} to a canonical junction but could not remove the redundant materialized backup at ${backupPath}: `
+                + `${error instanceof Error ? error.message : String(error)} — reclamation deferred, install is healthy.`);
+        }
+        converted.push(coreSlot);
+    }
+    if (converted.length > 0) {
+        logger.info(`PRI-912: converted ${converted.length} materialized @principles/core plugin copy/copies to canonical junctions.`);
+    }
+    for (const skip of skipped) {
+        logger.warn(`PRI-912: core dedup skipped at ${skip.dir}: ${skip.reason}`);
+    }
+    return { converted, alreadyCanonical, skipped };
+}
 function ensureCoreDependency(_targetDir) {
     const coreDir = getInstalledCoreDir();
     if (!existsSync(coreDir)) {
@@ -3012,6 +3228,16 @@ transaction) {
             updateProgress(spinner, stepIndex, 'Validating bundled console dependencies...');
         await installConsoleDependencies();
         stepIndex++;
+        // PRI-912 (SPEC-P1′-A): dedup the plugin's bundled @principles/core copy
+        // into a canonical junction only after EVERY component is deployed, so a
+        // conversion that breaks runtime resolution fails the console probe below
+        // and lands in the EXISTING fail → restoreBackup channel (no new
+        // rollback mechanism). Runs before the journal 'staged' transition: an
+        // install that failed here is still fully covered by the backups.
+        if (spinner)
+            updateProgress(spinner, stepIndex, 'Reconciling canonical core junction...');
+        reconcilePluginCoreCanonicalJunction();
+        stepIndex++;
         // ADR-0024 D-2: all runtime content is laid down — the new installation
         // is staged (nothing has been discarded yet; backups still hold the old one).
         journalInstallerTransitionDegrading(journal, journal.lastState, 'staged', 'runtime components installed');