@helix3/helix-cli 0.1.18-helix3.267 → 0.1.18-helix3.269

package/bridge-plugins/helix.bridge.unreal/bin/unreal-skeletal-mesh-extract.js

@@ -4,6 +4,7 @@
 const { spawn, spawnSync } = require('node:child_process');
 const { createHash } = require('node:crypto');
 const {
+  chmodSync,
   closeSync,
   existsSync,
   lstatSync,
@@ -13,8 +14,9 @@ const {
   readdirSync,
   realpathSync,
   statSync,
+  writeFileSync,
 } = require('node:fs');
-const { basename, extname, isAbsolute, join, relative, resolve, sep } = require('node:path');
+const { basename, dirname, extname, isAbsolute, join, relative, resolve, sep } = require('node:path');
 
 const REQUEST_SCHEMA = 'helix.bridge-plugin-request/1';
 const PROFILE_SCHEMA = 'helix.bridge.unreal-asset/1';
@@ -251,6 +253,60 @@ function findProject(sourcePath) {
   return projects[0];
 }
 
+/**
+ * A "Game Features" category plugin marked `"ExplicitlyLoaded": true` in its
+ * .uplugin (HELIX's character-content plugins all are) is deliberately
+ * excluded from Unreal's built-in game-feature startup scan
+ * (`UGameFeaturesSubsystem::LoadBuiltInGameFeaturePlugins` filters
+ * `IPluginManager::GetEnabledPlugins()` down to `GetPluginsEnabledAtStartup()`,
+ * which explicit-load plugins are not part of). Its C++ modules still load
+ * from being listed in the .uproject's `Plugins` array, but its Content
+ * folder is never mounted as a package path root — so any package path under
+ * it (e.g. `/HelixCharacterCreator/...`) fails to resolve with Unreal's own
+ * "does not map to a root" error. Normal interactive/gameplay sessions
+ * activate it through a runtime Game Feature request that a bare
+ * `-ExecutePythonScript` extraction session never makes, and no amount of
+ * waiting resolves it (measured: 6 minutes of polling every 10s never
+ * mounted it).
+ *
+ * The extract capability only reads content — it has no use for Game
+ * Feature runtime state — so on this capability's own already-immutable
+ * project snapshot (never the caller's real source), flip
+ * `ExplicitlyLoaded` to `false` for every such plugin before invoking the
+ * editor. That makes Unreal mount its Content like any ordinary enabled
+ * plugin, deterministically, with no dependency on Game Feature activation
+ * or timing.
+ */
+function mountExplicitlyLoadedGameFeaturePlugins(uprojectPath) {
+  const pluginsDir = join(dirname(uprojectPath), 'Plugins');
+  if (!existsSync(pluginsDir)) return;
+  for (const entry of readdirSync(pluginsDir, { withFileTypes: true })) {
+    if (!entry.isDirectory() || entry.isSymbolicLink()) continue;
+    const pluginDir = join(pluginsDir, entry.name);
+    for (const file of readdirSync(pluginDir, { withFileTypes: true })) {
+      if (!file.isFile() || file.isSymbolicLink() || extname(file.name).toLowerCase() !== '.uplugin') continue;
+      const upluginPath = join(pluginDir, file.name);
+      let descriptor;
+      try {
+        descriptor = JSON.parse(readFileSync(upluginPath, 'utf8'));
+      } catch {
+        continue;
+      }
+      if (descriptor.ExplicitlyLoaded !== true) continue;
+      descriptor.ExplicitlyLoaded = false;
+      try {
+        chmodSync(upluginPath, 0o644);
+        writeFileSync(upluginPath, `${JSON.stringify(descriptor, null, '\t')}\n`);
+      } catch (error) {
+        process.stderr.write(
+          `HELIX Unreal Bridge warning: could not mount explicitly-loaded plugin '${entry.name}' ` +
+          `for extraction (left as-is; its content will not resolve): ${error.message}\n`,
+        );
+      }
+    }
+  }
+}
+
 function runningInWsl() {
   if (process.platform !== 'linux') return false;
   if (process.env.WSL_DISTRO_NAME || process.env.WSL_INTEROP) return true;
@@ -274,14 +330,15 @@ function wslPath(mode, path) {
   return result.stdout.trim();
 }
 
-function editorInvocationPaths(editor, project, script, outputs) {
+function editorInvocationPaths(editor, project, script, outputs, log) {
   const wsl = runningInWsl();
-  if (!wsl) return { editor, project, script, outputs, wsl };
+  if (!wsl) return { editor, project, script, outputs, log, wsl };
   return {
     editor: WINDOWS_ABSOLUTE_PATH.test(editor) ? wslPath('-u', editor) : editor,
     project: wslPath('-w', project),
     script: wslPath('-w', script),
     outputs: outputs.map((output) => wslPath('-w', output)),
+    log: wslPath('-w', log),
     wsl,
   };
 }
@@ -359,6 +416,39 @@ async function runEditor(editor, args, environment, wsl) {
   });
 }
 
+const ENGINE_LOG_TAIL_BYTES = 64 * 1024;
+
+/**
+ * Read the trailing bytes of the real Unreal Editor engine log (written via
+ * `-abslog`), not the captured stdout/stderr tail, which is capped at
+ * LOG_TAIL_BYTES and can lose the actual Python traceback under the noise UE
+ * prints on the way to a clean `-unattended` shutdown. Returns null when the
+ * log was never written (e.g. the editor failed to start at all).
+ */
+function readEngineLogTail(path, maxBytes) {
+  let info;
+  try {
+    info = statSync(path);
+  } catch {
+    return null;
+  }
+  if (!info.isFile()) return null;
+  const length = Math.min(maxBytes, info.size);
+  const start = info.size - length;
+  const buffer = Buffer.alloc(length);
+  let descriptor;
+  try {
+    descriptor = openSync(path, 'r');
+    readSync(descriptor, buffer, 0, length, start);
+  } catch (error) {
+    return `(could not read '${path}': ${error.message})`;
+  } finally {
+    if (descriptor !== undefined) closeSync(descriptor);
+  }
+  const text = buffer.toString('utf8').trim();
+  return start > 0 ? `…(truncated, showing last ${length} of ${info.size} bytes)…\n${text}` : text;
+}
+
 function editorFailure(outcome) {
   return `Unreal Editor failed${outcome.signal ? ` with signal ${outcome.signal}` : ` with exit ${outcome.code}`}` +
     `${outcome.tail ? `: ${outcome.tail}` : ''}`;
@@ -433,7 +523,8 @@ function validateTextureBinding(value, outputRoot, label) {
   }
   const colorSpace = object(binding.colorSpace, `${label}.colorSpace`);
   const colorKeys = Object.keys(colorSpace).sort();
-  if (colorKeys.some((key) => key !== 'compressionSettings' && key !== 'srgb')) {
+  const SUPPORTED_COLOR_SPACE_KEYS = ['compressionSettings', 'flipGreenChannel', 'srgb'];
+  if (colorKeys.some((key) => !SUPPORTED_COLOR_SPACE_KEYS.includes(key))) {
     fail(`${label}.colorSpace contains unsupported metadata`);
   }
   if ('srgb' in colorSpace && typeof colorSpace.srgb !== 'boolean') {
@@ -442,6 +533,9 @@ function validateTextureBinding(value, outputRoot, label) {
   if ('compressionSettings' in colorSpace) {
     nonEmptyString(colorSpace.compressionSettings, `${label}.colorSpace.compressionSettings`);
   }
+  if ('flipGreenChannel' in colorSpace && typeof colorSpace.flipGreenChannel !== 'boolean') {
+    fail(`${label}.colorSpace.flipGreenChannel must be a boolean`);
+  }
 
   const texturePath = resolve(outputRoot, relativePath);
   containedPath(outputRoot, texturePath, label);
@@ -571,6 +665,7 @@ async function main() {
   const { sourcePath, outputDir, profilePath } = validateRequest(request);
   const profiles = validateProfile(readJsonFile(profilePath, 'Unreal asset profile'));
   const project = findProject(sourcePath);
+  mountExplicitlyLoadedGameFeaturePlugins(project);
   const outputs = profiles.map((profile) => join(outputDir, `${profile.slug}.fbx`));
   const script = resolve(__dirname, '..', 'unreal', 'export_skeletal_mesh.py');
   if (!existsSync(script)) fail(`Packaged Unreal Python exporter is missing: ${script}`);
@@ -582,7 +677,8 @@ async function main() {
   }
 
   const editorValue = nonEmptyString(process.env.HELIX_UNREAL_EDITOR, 'HELIX_UNREAL_EDITOR');
-  const paths = editorInvocationPaths(editorValue, project, script, outputs);
+  const engineLogPath = join(outputDir, 'unreal-editor-full.log');
+  const paths = editorInvocationPaths(editorValue, project, script, outputs, engineLogPath);
   const environment = {
     ...process.env,
     HELIX_UNREAL_ASSET_PATH: profiles[0].assetPath,
@@ -605,12 +701,18 @@ async function main() {
     '-nop4',
     '-nosplash',
     '-nosound',
+    '-log',
+    `-abslog=${paths.log}`,
   ], editorEnvironment(environment, paths.wsl), paths.wsl);
 
   const invalidOutputs = outputs.map(validateFbxOutput).filter(Boolean);
   if (invalidOutputs.length > 0) {
     const suffix = editorOutcome.code === 0 && !editorOutcome.signal ? '' : `; ${editorFailure(editorOutcome)}`;
-    fail(`Unreal Editor did not produce the complete reviewed export set (${invalidOutputs.join(', ')})${suffix}`);
+    const engineLogTail = readEngineLogTail(engineLogPath, ENGINE_LOG_TAIL_BYTES);
+    const logSuffix = engineLogTail
+      ? `\nUnreal Editor engine log (${engineLogPath}):\n${engineLogTail}`
+      : `\n(Unreal Editor engine log not found at ${engineLogPath})`;
+    fail(`Unreal Editor did not produce the complete reviewed export set (${invalidOutputs.join(', ')})${suffix}${logSuffix}`);
   }
   const materialSidecars = profiles.map((profile) => validateMaterialSidecar(
     join(outputDir, `${profile.slug}.materials.json`),

package/bridge-plugins/helix.bridge.unreal/test/handler.test.js

@@ -61,13 +61,19 @@ function fixture(profileOverrides = {}) {
     "  if (process.env.HELIX_TEST_SIDECAR_KIND === 'missing') continue;",
     "  const bindingSha = process.env.HELIX_TEST_SIDECAR_KIND === 'hash-mismatch' ? 'f'.repeat(64) : textureSha;",
     "  const bindingPath = process.env.HELIX_TEST_SIDECAR_KIND === 'escape' ? '../escaped.png' : 'textures/' + bindingSha + '.png';",
-    "  const sidecar = { schemaVersion: 'helix.bridge.unreal-material-sidecar/1', asset: { slug: job.slug, sourceMeshAssetPath: job.assetPath }, materials: [{ slotIndex: 0, slotName: 'Body', importedSlotName: 'Body_skin00', sourceMaterialAssetPath: '/Game/Materials/MI_Body.MI_Body', sourceRootMaterialAssetPath: '/Game/Materials/M_Body.M_Body', parameters: { scalars: { Roughness: 0.5 }, vectors: { Tint: { r: 1, g: 0.5, b: 0.25, a: 1 } }, textures: { BaseColor: { sourceAssetPath: '/Game/Textures/T_Body.T_Body', path: bindingPath, sha256: bindingSha, sizeBytes: textureBytes.length, colorSpace: { srgb: true, compressionSettings: 'TC_Default' } } } } }] };",
+    "  const colorSpace = { srgb: true, compressionSettings: 'TC_Default' };",
+    "  if (process.env.HELIX_TEST_SIDECAR_KIND === 'flip-green') colorSpace.flipGreenChannel = true;",
+    "  const sidecar = { schemaVersion: 'helix.bridge.unreal-material-sidecar/1', asset: { slug: job.slug, sourceMeshAssetPath: job.assetPath }, materials: [{ slotIndex: 0, slotName: 'Body', importedSlotName: 'Body_skin00', sourceMaterialAssetPath: '/Game/Materials/MI_Body.MI_Body', sourceRootMaterialAssetPath: '/Game/Materials/M_Body.M_Body', parameters: { scalars: { Roughness: 0.5 }, vectors: { Tint: { r: 1, g: 0.5, b: 0.25, a: 1 } }, textures: { BaseColor: { sourceAssetPath: '/Game/Textures/T_Body.T_Body', path: bindingPath, sha256: bindingSha, sizeBytes: textureBytes.length, colorSpace } } } }] };",
     "  const sidecarPath = join(dirname(job.outputPath), job.slug + '.materials.json');",
     "  if (process.env.HELIX_TEST_SIDECAR_KIND === 'corrupt') writeFileSync(sidecarPath, '{');",
     "  else if (process.env.HELIX_TEST_SIDECAR_KIND === 'symlink') symlinkSync(process.env.HELIX_TEST_INVOCATION, sidecarPath);",
     "  else writeFileSync(sidecarPath, JSON.stringify(sidecar));",
     "}",
     "if (process.env.HELIX_TEST_EDITOR_LOG) process.stderr.write(process.env.HELIX_TEST_EDITOR_LOG);",
+    "if (process.env.HELIX_TEST_ABSLOG_CONTENT) {",
+    "  const abslogArg = process.argv.slice(2).find((arg) => arg.startsWith('-abslog='));",
+    "  if (abslogArg) writeFileSync(abslogArg.slice('-abslog='.length), process.env.HELIX_TEST_ABSLOG_CONTENT);",
+    "}",
     "if (process.env.HELIX_TEST_EDITOR_SIGNAL) process.kill(process.pid, process.env.HELIX_TEST_EDITOR_SIGNAL);",
     "if (process.env.HELIX_TEST_EDITOR_EXIT) process.exit(Number(process.env.HELIX_TEST_EDITOR_EXIT));",
   ].join('\n'));
@@ -119,12 +125,50 @@ test('exports one configured skeletal mesh with the full Unreal editor script',
   assert.match(invocation.args[1], /^-ExecutePythonScript=.*export_skeletal_mesh\.py$/);
   assert.ok(invocation.args.includes('-stdout'));
   assert.ok(invocation.args.includes('-FullStdOutLogOutput'));
+  assert.ok(invocation.args.includes('-log'));
+  assert.ok(invocation.args.some((arg) => arg.startsWith('-abslog=')));
   assert.match(readFileSync(join(entry.output, 'base-male.fbx'), 'binary'), /^Kaydara FBX Binary/);
   const sidecar = JSON.parse(readFileSync(join(entry.output, 'base-male.materials.json'), 'utf8'));
   assert.equal(sidecar.materials[0].parameters.scalars.Roughness, 0.5);
   assert.deepEqual(sidecar.materials[0].parameters.vectors.Tint, { r: 1, g: 0.5, b: 0.25, a: 1 });
 });
 
+test('mounts an ExplicitlyLoaded Game Features plugin before extraction, and leaves other plugins alone', () => {
+  const entry = fixture();
+  const explicitPluginDir = join(entry.project, 'Plugins', 'HelixCharacterCreator');
+  mkdirSync(join(explicitPluginDir, 'Content'), { recursive: true });
+  const explicitPluginPath = join(explicitPluginDir, 'HelixCharacterCreator.uplugin');
+  writeFileSync(explicitPluginPath, JSON.stringify({
+    FileVersion: 3,
+    FriendlyName: 'HelixCharacterCreator',
+    Category: 'Game Features',
+    CanContainContent: true,
+    ExplicitlyLoaded: true,
+    BuiltInInitialFeatureState: 'Registered',
+  }));
+  chmodSync(explicitPluginPath, 0o444); // Perforce-style read-only, like the real content.
+
+  const implicitPluginDir = join(entry.project, 'Plugins', 'SomeOrdinaryPlugin');
+  mkdirSync(join(implicitPluginDir, 'Content'), { recursive: true });
+  const implicitPluginPath = join(implicitPluginDir, 'SomeOrdinaryPlugin.uplugin');
+  writeFileSync(implicitPluginPath, JSON.stringify({
+    FileVersion: 3,
+    FriendlyName: 'SomeOrdinaryPlugin',
+    CanContainContent: true,
+    ExplicitlyLoaded: false,
+  }));
+
+  const result = run(entry);
+  assert.equal(result.status, 0, result.stderr);
+
+  const patched = JSON.parse(readFileSync(explicitPluginPath, 'utf8'));
+  assert.equal(patched.ExplicitlyLoaded, false);
+  assert.equal(patched.Category, 'Game Features', 'only the loading gate changes, not the plugin identity');
+
+  const untouched = JSON.parse(readFileSync(implicitPluginPath, 'utf8'));
+  assert.equal(untouched.ExplicitlyLoaded, false);
+});
+
 test('accepts a structurally valid ASCII FBX export', () => {
   const entry = fixture();
   const result = run(entry, { HELIX_TEST_OUTPUT_KIND: 'ascii' });
@@ -171,6 +215,18 @@ test('rejects a corrupt file even when Unreal exits successfully', () => {
   assert.match(result.stderr, /not a structurally valid FBX/);
 });
 
+test('surfaces the real engine log tail, not just the truncated stdout tail, when the export set is incomplete', () => {
+  const entry = fixture();
+  const result = run(entry, {
+    HELIX_TEST_OUTPUT_KIND: 'missing',
+    HELIX_TEST_ABSLOG_CONTENT: 'LogPython: Error: Unable to load Unreal asset — this is the real engine log, not stdout',
+  });
+  assert.equal(result.status, 1);
+  assert.match(result.stderr, /did not produce the complete reviewed export set/);
+  assert.match(result.stderr, /Unreal Editor engine log/);
+  assert.match(result.stderr, /Unable to load Unreal asset — this is the real engine log, not stdout/);
+});
+
 test('rejects missing and empty export files', async (t) => {
   for (const outputKind of ['missing', 'empty']) {
     await t.test(outputKind, () => {
@@ -272,3 +328,15 @@ test('does not walk into Binaries/Intermediate/Saved/DerivedDataCache when findi
   const response = JSON.parse(result.stdout);
   assert.equal(response.artifacts[0].kind, 'format.fbx');
 });
+
+test('accepts a material sidecar texture binding that records flipGreenChannel', () => {
+  // export_skeletal_mesh.py (texture_color_space) has recorded flipGreenChannel for every
+  // texture since the "Flip Green Channel" DirectX/OpenGL convention was added, but this
+  // handler's own sidecar validator never learned the key — every real export failed with
+  // "colorSpace contains unsupported metadata" until now.
+  const entry = fixture();
+  const result = run(entry, { HELIX_TEST_SIDECAR_KIND: 'flip-green' });
+  assert.equal(result.status, 0, result.stderr);
+  const sidecar = JSON.parse(readFileSync(join(entry.output, 'base-male.materials.json'), 'utf8'));
+  assert.equal(sidecar.materials[0].parameters.textures.BaseColor.colorSpace.flipGreenChannel, true);
+});

package/dist/bridge/execute.js

@@ -89,10 +89,13 @@ async function importWithBridge(source, options = {}) {
     let removeSignalCleanup = () => undefined;
     let published = false;
     let outputs = [];
+    const keepStage = options.keepStage === true || process.env.HELIX_BRIDGE_KEEP_STAGE === '1';
     try {
         reservation = await (0, outputReservation_1.acquireOutputReservation)(reservationPath, reservationRecord);
         removeSignalCleanup = (0, outputReservation_1.installSignalCleanup)(reservationRecord, reservationPath, reservation, (signal) => (0, externalExecution_1.terminateActiveExternalProcesses)(`Bridge import interrupted by ${signal}`));
         await (0, promises_1.mkdir)(transactionDir);
+        if (keepStage)
+            options.onProgress?.(`debug: bridge stage will be kept at ${transactionDir} if this import fails`);
         const packageDir = (0, node_path_1.join)(transactionDir, 'package');
         const workingDir = (0, node_path_1.join)(transactionDir, 'work');
         await (0, promises_1.mkdir)(packageDir, { recursive: true });
@@ -187,8 +190,14 @@ async function importWithBridge(source, options = {}) {
     }
     finally {
         removeSignalCleanup();
-        if (!published)
-            await (0, promises_1.rm)(transactionDir, { recursive: true, force: true });
+        if (!published) {
+            if (keepStage) {
+                options.onProgress?.(`debug: bridge stage kept for inspection: ${transactionDir}`);
+            }
+            else {
+                await (0, promises_1.rm)(transactionDir, { recursive: true, force: true });
+            }
+        }
         if (reservation)
             await reservation.close().catch(() => undefined);
         await (0, outputReservation_1.removeOwnedReservation)(reservationPath, reservationRecord.reservationId);

package/dist/bridge/execute.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/bridge/execute.ts"],"names":[],"mappings":";;;AAwEA,4CAqKC;AA7OD,6CAAyC;AACzC,qCAA8D;AAC9D,+CAAqD;AAErD,qCAAmC;AACnC,yCAA6D;AAC7D,oDAAiF;AACjF,kEAA4F;AAC5F,oEAIsC;AACtC,oEAKsC;AACtC,oDAM8B;AAC9B,uCAAuE;AACvE,6CAAiD;AACjD,mCASiB;AAEjB,8EAA8E;AAC9E,6EAA6E;AAC7E,kDAI8B;AAH5B,6HAAA,gCAAgC,OAAA;AAChC,qHAAA,wBAAwB,OAAA;AACxB,sHAAA,yBAAyB,OAAA;AAG3B,KAAK,UAAU,iBAAiB,CAC9B,IAAgB,EAChB,IAAoB,EACpB,SAAiB,EACjB,OAA4B,EAC5B,OAA6B,EAC7B,KAA4B,EAC5B,UAAkB,EAClB,WAA6C;IAE7C,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,KAAK,cAAc,IAAI,CAAC,OAAO,mBAAmB,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;IACxG,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,OAAO,qCAAqC,CAAC,CAAC;IAC1G,CAAC;IACD,MAAM,MAAM,GAAG,IAAA,wCAAoB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,IAAI,IAAA,sCAAmB,EAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,OAAO,IAAA,2CAAwB,EAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9F,IAAI,CAAC,UAAU,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,UAAU,8BAA8B,CAAC,CAAC;IACxH,OAAO,IAAA,6CAAyB,EAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AAC3G,CAAC;AAEM,KAAK,UAAU,gBAAgB,CAAC,MAAc,EAAE,UAA+B,EAAE;IACtF,MAAM,OAAO,GAAG,IAAA,2BAAiB,EAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,IAAA,8BAAiB,EAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/D,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QAClD,MAAM,MAAM,GAAG,IAAA,wCAAoB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;IACrH,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,kBAAkB,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CACb,4DAA4D,IAAI,CAAC,gBAAgB,IAAI;YACrF,+BAA+B,IAAI,CAAC,gBAAgB,IAAI;YACxD,oCAAoC,IAAI,CAAC,gBAAgB,IAAI,CAC9D,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,CAAC,eAAe,KAAK,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC/F,MAAM,IAAI,KAAK,CACb,sCAAsC,OAAO,CAAC,eAAe,cAAc,IAAI,CAAC,gBAAgB,IAAI;YACpG,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;IACvE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1G,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,IAAA,wCAA4B,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACxG,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACxC,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QACzC,IAAI,KAAK,KAAK,aAAa;YAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACnH,IAAI,KAAK,KAAK,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QAChH,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACjG,MAAM,IAAI,KAAK,CAAC,qCAAqC,KAAK,mBAAmB,KAAK,UAAU,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,SAAS,GAAG,IAAA,mBAAO,EAAC,OAAO,CAAC,MAAM,IAAI,IAAA,gBAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IAC/E,MAAM,YAAY,GAAG,IAAA,mBAAO,EAAC,SAAS,CAAC,CAAC;IACxC,MAAM,IAAA,gBAAK,EAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,IAAI,IAAA,oBAAU,EAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,SAAS,EAAE,CAAC,CAAC;IAC9F,MAAM,eAAe,GAAG,IAAA,gBAAI,EAAC,YAAY,EAAE,IAAI,IAAA,oBAAQ,EAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IACzF,MAAM,cAAc,GAAG,IAAA,gBAAI,EAAC,YAAY,EAAE,IAAI,IAAA,oBAAQ,EAAC,SAAS,CAAC,iBAAiB,IAAA,wBAAU,GAAE,EAAE,CAAC,CAAC;IAClG,MAAM,iBAAiB,GAAsB;QAC3C,aAAa,EAAE,4BAA4B;QAC3C,aAAa,EAAE,IAAA,wBAAU,GAAE;QAC3B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,IAAA,kBAAQ,GAAE;QACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS;QACT,cAAc;KACf,CAAC;IACF,IAAI,WAAW,GAAsB,IAAI,CAAC;IAC1C,IAAI,mBAAmB,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC;IAChD,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,OAAO,GAAqB,EAAE,CAAC;IACnC,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,IAAA,4CAAwB,EAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;QACjF,mBAAmB,GAAG,IAAA,wCAAoB,EACxC,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,oDAAgC,EAAC,gCAAgC,MAAM,EAAE,CAAC,CACvF,CAAC;QACF,MAAM,IAAA,gBAAK,EAAC,cAAc,CAAC,CAAC;QAC5B,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,IAAA,gBAAK,EAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,MAAM,IAAA,gBAAK,EAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,IAAI,IAAA,oBAAU,EAAC,SAAS,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,SAAS,EAAE,CAAC,CAAC;QAC9F,MAAM,iBAAiB,GAAG,IAAA,kBAAQ,EAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QACrE,MAAM,cAAc,GAAG,iBAAiB;YACtC,CAAC,CAAC,MAAM,IAAA,mCAAuB,EAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC;YAC5E,CAAC,CAAC,MAAM,IAAA,8BAAkB,EAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QAC5G,MAAM,SAAS,GAAG,MAAM,IAAA,mCAAuB,EAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3E,MAAM,aAAa,GAAe;YAChC,GAAG,IAAI;YACP,cAAc,EAAE,cAAc,CAAC,QAAQ;SACxC,CAAC;QACF,MAAM,gBAAgB,GAAG,MAAM,IAAA,mCAAuB,EAAC,aAAa,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3F,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;YACvC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YACjG,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM;gBAC3D,CAAC,CAAC,IAAA,gBAAI,EAAC,UAAU,EAAE,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;gBACxC,CAAC,CAAC,UAAU,CAAC;YACf,MAAM,IAAA,gBAAK,EAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC;gBACrC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC;YACjE,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CACb,eAAe,IAAI,CAAC,KAAK,wCAAwC,cAAc,CAAC,MAAM,GAAG;oBACzF,IAAI,IAAI,CAAC,OAAO,8FAA8F,CAC/G,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;YACxC,MAAM,WAAW,GAAG,MAAM,iBAAiB,CACzC,aAAa,EACb,IAAI,EACJ,aAAa,EACb,SAAS,CAAC,OAAO,EACjB,gBAAgB,EAChB,KAAK,EACL,cAAc,CAAC,IAAI,EACnB,SAAS,CAAC,aAAa,CACxB,CAAC;YACF,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrE,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,KAAK,iCAAiC,IAAI,CAAC,QAAQ,aAAa,CAAC,CAAC;YACxG,CAAC;YACD,OAAO,GAAG,WAAW,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,uDAAuD,aAAa,CAAC,IAAI,IAAI,CAAC,CAAC;QACjG,CAAC;QACD,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnF,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAA,8BAAkB,EAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9F,MAAM,UAAU,GAAqB;YACnC,aAAa,EAAE,gCAAwB;YACvC,gBAAgB,EAAE,aAAa,CAAC,gBAAgB;YAChD,MAAM,EAAE;gBACN,IAAI,EAAE,IAAA,oBAAQ,EAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC3C,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,UAAU;gBACrC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM;gBACnC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,SAAS;gBACzC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtG,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,cAAc,KAAK,SAAS;oBACnD,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;aAC7D;YACD,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;gBAChC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAE,CAAC;gBAC3E,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;YAChF,CAAC,CAAC;YACF,YAAY,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC;YAChE,MAAM,EAAE,aAAa,CAAC,MAAM;YAC5B,QAAQ,EAAE;gBACR,WAAW,EAAE,aAAa,CAAC,WAAW;gBACtC,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;oBAClG,WAAW;oBACX;wBACE,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;wBAC7C,IAAI,EAAE,IAAA,oBAAQ,EAAC,IAAI,CAAC,UAAU,CAAC;wBAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;qBAC1B;iBACF,CAAC,CAAC;gBACH,YAAY,EAAE;oBACZ,QAAQ,EAAE,cAAc,CAAC,QAAQ;oBACjC,YAAY,EAAE,cAAc,CAAC,YAAY;iBAC1C;aACF;YACD,OAAO,EAAE,iBAAiB;YAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,MAAM,oBAAoB,GAAG,IAAA,gBAAI,EAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC;QACxE,IAAA,uBAAa,EAAC,oBAAoB,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAChF,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC9C,GAAG,QAAQ;YACX,IAAI,EAAE,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAA,iCAAqB,EAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;SACxE,CAAC,CAAC,CAAC;QACJ,MAAM,IAAA,aAAE,EAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,IAAA,iBAAM,EAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACpC,MAAM,IAAA,aAAE,EAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAClF,SAAS,GAAG,IAAI,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,IAAA,gBAAI,EAAC,SAAS,EAAE,wBAAwB,CAAC,EAAE,CAAC;IACnH,CAAC;YAAS,CAAC;QACT,mBAAmB,EAAE,CAAC;QACtB,IAAI,CAAC,SAAS;YAAE,MAAM,IAAA,aAAE,EAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,IAAI,WAAW;YAAE,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAClE,MAAM,IAAA,0CAAsB,EAAC,eAAe,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAC;IACjF,CAAC;AACH,CAAC"}
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/bridge/execute.ts"],"names":[],"mappings":"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"}

package/dist/bridge/types.d.ts

@@ -222,6 +222,15 @@ export interface BridgeImportOptions extends BridgePlanOptions {
     expectedPlanKey?: string;
     approvedPermissions?: BridgePermission[];
     onProgress?: (message: string) => void;
+    /**
+     * Preserve the `.{output}.bridge-stage-<uuid>/` transaction directory (raw
+     * step outputs, snapshots, and any external-tool working files) after a
+     * failed import instead of deleting it. Also honored via the
+     * `HELIX_BRIDGE_KEEP_STAGE=1` environment variable. Debug-only: never set
+     * this for a normal import, since a kept stage is not cleaned up by Bridge
+     * and accumulates on disk across retries.
+     */
+    keepStage?: boolean;
 }
 export interface BridgeImportResult {
     plan: BridgePlan;

package/dist/index.js

@@ -262,6 +262,7 @@ bridge
     .option('--expect-plan-key <sha256>', 'execute only if the freshly resolved plan has this exact key')
     .option('--allow-permission <permissions...>', 'permissions approved for community/local plugins; repeat or comma-separate')
     .option('--dry-run', 'plan only; write and execute nothing')
+    .option('--keep-stage', 'debug only: preserve the .bridge-stage-<uuid> transaction directory on failure instead of deleting it (also HELIX_BRIDGE_KEEP_STAGE=1)')
     .option('--json', 'print the machine-readable result')
     .action(async (source, opts) => {
     try {
@@ -280,6 +281,7 @@ bridge
             expectedPlanKey: opts.expectPlanKey,
             approvedPermissions: bridgePermissions(opts.allowPermission),
             dryRun: opts.dryRun,
+            keepStage: opts.keepStage,
             onProgress: (message) => console.error(`  ${message}`),
         });
         if (opts.json)