@auraindustry/aurajs 0.1.3 → 0.1.5

package/src/conformance.mjs

@@ -61,10 +61,7 @@ export const STAGE_143_PARTIAL_PROOF_REFRESH_V1 = Object.freeze([
         ]),
       }),
     ]),
-    exampleDirs: Object.freeze([
-      'starter-3d',
-      'procedural-geometry-shader-showcase',
-    ]),
+    exampleDirs: Object.freeze([]),
   }),
   Object.freeze({
     category: 'navmesh_pathfinding',
@@ -78,9 +75,7 @@ export const STAGE_143_PARTIAL_PROOF_REFRESH_V1 = Object.freeze([
         ]),
       }),
     ]),
-    exampleDirs: Object.freeze([
-      'navmesh-crowd-proof',
-    ]),
+    exampleDirs: Object.freeze([]),
   }),
   Object.freeze({
     category: 'spatial_audio_3d',
@@ -94,9 +89,7 @@ export const STAGE_143_PARTIAL_PROOF_REFRESH_V1 = Object.freeze([
         ]),
       }),
     ]),
-    exampleDirs: Object.freeze([
-      'media-presentation-proof',
-    ]),
+    exampleDirs: Object.freeze([]),
   }),
   Object.freeze({
     category: 'custom_shaders',
@@ -111,9 +104,7 @@ export const STAGE_143_PARTIAL_PROOF_REFRESH_V1 = Object.freeze([
         ]),
       }),
     ]),
-    exampleDirs: Object.freeze([
-      'shader-kit-proof',
-    ]),
+    exampleDirs: Object.freeze([]),
   }),
   Object.freeze({
     category: 'sprite3d_billboards',
@@ -135,10 +126,7 @@ export const STAGE_143_PARTIAL_PROOF_REFRESH_V1 = Object.freeze([
         ]),
       }),
     ]),
-    exampleDirs: Object.freeze([
-      'billboard-runtime-proof',
-      'worldspace-ui-proof',
-    ]),
+    exampleDirs: Object.freeze([]),
   }),
   Object.freeze({
     category: 'gltf_scene_import',
@@ -153,9 +141,7 @@ export const STAGE_143_PARTIAL_PROOF_REFRESH_V1 = Object.freeze([
         ]),
       }),
     ]),
-    exampleDirs: Object.freeze([
-      'billboard-runtime-proof',
-    ]),
+    exampleDirs: Object.freeze([]),
   }),
   Object.freeze({
     category: 'skinned_mesh_instancing',
@@ -169,9 +155,7 @@ export const STAGE_143_PARTIAL_PROOF_REFRESH_V1 = Object.freeze([
         ]),
       }),
     ]),
-    exampleDirs: Object.freeze([
-      'crowd-skinning-proof',
-    ]),
+    exampleDirs: Object.freeze([]),
   }),
   Object.freeze({
     category: 'video_textures',
@@ -193,10 +177,7 @@ export const STAGE_143_PARTIAL_PROOF_REFRESH_V1 = Object.freeze([
         ]),
       }),
     ]),
-    exampleDirs: Object.freeze([
-      'native-mp4-proof',
-      'media-presentation-proof',
-    ]),
+    exampleDirs: Object.freeze([]),
   }),
 ]);
 const PHASER_VERTICAL_SLICE_PERF_BUDGETS = Object.freeze({
@@ -1469,6 +1450,44 @@ function normalizeRuntimeInspectorPhase2(phase2) {
   };
 }
 
+function normalizeRuntimeInspectorDraw2dRuntime(draw2dRuntime) {
+  const source = draw2dRuntime && typeof draw2dRuntime === 'object' ? draw2dRuntime : {};
+  return {
+    fx: {
+      pendingFxCommandCount: numericOr(source?.fx?.pendingFxCommandCount),
+      lastSubmittedFxCommandCount: numericOr(source?.fx?.lastSubmittedFxCommandCount),
+      lastExecutedFxCommandCount: numericOr(source?.fx?.lastExecutedFxCommandCount),
+      lastReasonCode: typeof source?.fx?.lastReasonCode === 'string' ? source.fx.lastReasonCode : 'draw2d_fx_idle',
+      lastOk: source?.fx?.lastOk !== false,
+    },
+    masking: {
+      pendingPassCount: numericOr(source?.masking?.pendingPassCount),
+      pendingAdvancedPassCount: numericOr(source?.masking?.pendingAdvancedPassCount),
+      lastSubmittedPassCount: numericOr(source?.masking?.lastSubmittedPassCount),
+      lastExecutedPassCount: numericOr(source?.masking?.lastExecutedPassCount),
+      lastSubmittedCommandCount: numericOr(source?.masking?.lastSubmittedCommandCount),
+      lastReasonCode: typeof source?.masking?.lastReasonCode === 'string' ? source.masking.lastReasonCode : 'draw2d_mask_idle',
+      lastOk: source?.masking?.lastOk !== false,
+      lastRequestedMaskKind: typeof source?.masking?.lastRequestedMaskKind === 'string' ? source.masking.lastRequestedMaskKind : 'none',
+      lastRequestedMaskShape: typeof source?.masking?.lastRequestedMaskShape === 'string' ? source.masking.lastRequestedMaskShape : 'none',
+      lastRequestedMaskFeather: normalizeRuntimeInspectorTiming(source?.masking?.lastRequestedMaskFeather, RUNTIME_INSPECTOR_TIMING_PRECISION.scalarDigits),
+    },
+    compositor: {
+      knownGraphCount: numericOr(source?.compositor?.knownGraphCount),
+      knownStageCount: numericOr(source?.compositor?.knownStageCount),
+      lastGraphName: typeof source?.compositor?.lastGraphName === 'string' ? source.compositor.lastGraphName : '',
+      lastGraphStageCount: numericOr(source?.compositor?.lastGraphStageCount),
+      lastGraphCommandCount: numericOr(source?.compositor?.lastGraphCommandCount),
+      lastGraphReasonCode: typeof source?.compositor?.lastGraphReasonCode === 'string' ? source.compositor.lastGraphReasonCode : 'draw2d_compositor_idle',
+      lastGraphOk: source?.compositor?.lastGraphOk !== false,
+      pendingExportCount: numericOr(source?.compositor?.pendingExportCount),
+      lastSubmittedExportCount: numericOr(source?.compositor?.lastSubmittedExportCount),
+      lastExecutedExportCount: numericOr(source?.compositor?.lastExecutedExportCount),
+      lastExportReasonCode: typeof source?.compositor?.lastExportReasonCode === 'string' ? source.compositor.lastExportReasonCode : 'draw2d_export_idle',
+      lastExportOk: source?.compositor?.lastExportOk !== false,
+    },
+  };
+}
 function normalizeRuntimeInspectorVec3(value) {
   return {
     x: normalizeRuntimeInspectorTiming(value?.x, RUNTIME_INSPECTOR_TIMING_PRECISION.scalarDigits),
@@ -1752,7 +1771,7 @@ function normalizeRuntimeInspectorSample(sample) {
     window: normalizeRuntimeInspectorWindow(sample.window),
     queues: normalizeRuntimeInspectorQueues(sample.queues),
     phase2: normalizeRuntimeInspectorPhase2(sample.phase2),
-    draw2dRuntime: sample.draw2dRuntime || null,
+    draw2dRuntime: normalizeRuntimeInspectorDraw2dRuntime(sample.draw2dRuntime),
     scene3dRuntime: normalizeRuntimeInspectorScene3dRuntime(sample.scene3dRuntime),
   };
 }
@@ -1930,7 +1949,6 @@ export function buildRuntimeObservabilityReport({
     lastResetSequenceBefore: numericOr(vectors?.audioLastResetSequenceBeforeReset),
     lastResetSequenceAfter: numericOr(vectors?.audioLastResetSequenceAfterReset),
   };
-
   return {
     schemaVersion: 'aurajs.runtime-observability.v1',
     generatedAt,
@@ -1961,7 +1979,6 @@ export function buildRuntimeObservabilityReport({
     vectors,
   };
 }
-
 export function buildRuntimeInspectorSnapshotReport({
   generatedAt,
   mode,
@@ -1971,8 +1988,10 @@ export function buildRuntimeInspectorSnapshotReport({
   authoringState = null,
 }) {
   const snapshot = runtimeInspectorSnapshot?.snapshot || null;
+  const draw2dSource = snapshot?.draw2dRuntime || snapshot?.raw?.active?.draw2dRuntime || null;
   const scene3dSource = snapshot?.scene3dRuntime || snapshot?.raw?.active?.scene3dRuntime || null;
   const phase2 = normalizeRuntimeInspectorPhase2(snapshot?.phase2);
+  const draw2dRuntime = normalizeRuntimeInspectorDraw2dRuntime(draw2dSource);
   const scene3dRuntime = normalizeRuntimeInspectorScene3dRuntime(scene3dSource);
   const authoring3d = normalizeRuntimeInspectorAuthoringState(
     authoringState || runtimeInspectorSnapshot?.authoringState || snapshot?.authoring3d || null,
@@ -2003,6 +2022,7 @@ export function buildRuntimeInspectorSnapshotReport({
     queues: normalizeRuntimeInspectorQueues(snapshot?.queues),
     resetAfterDisable: normalizeRuntimeInspectorResetAfterDisable(snapshot?.resetAfterDisable),
     phase2,
+    draw2dRuntime,
     scene3dRuntime,
     authoring3d,
     raw: normalizeRuntimeInspectorRaw(snapshot?.raw),
@@ -2300,7 +2320,9 @@ export function buildNativeProbeSource(conformanceCase, options = {}) {
         const queues = stats.queues || {};
         const phase2 = stats.phase2 || {};
         const draw2dRuntime = stats.draw2dRuntime || {};
+        const draw2dFx = draw2dRuntime.fx || {};
         const draw2dMasking = draw2dRuntime.masking || {};
+        const draw2dCompositor = draw2dRuntime.compositor || {};
         const scene3dRuntime = stats.scene3dRuntime || {};
         const scene3dSubmission = scene3dRuntime.submission || {};
         const scene3dCamera = scene3dRuntime.camera || {};
@@ -2348,8 +2370,18 @@ export function buildNativeProbeSource(conformanceCase, options = {}) {
             particles: toPhase2Row(phase2.particles),
           },
           draw2dRuntime: {
+            fx: {
+              pendingFxCommandCount: __num(draw2dFx.pendingFxCommandCount),
+              lastSubmittedFxCommandCount: __num(draw2dFx.lastSubmittedFxCommandCount),
+              lastExecutedFxCommandCount: __num(draw2dFx.lastExecutedFxCommandCount),
+              lastReasonCode: typeof draw2dFx.lastReasonCode === 'string'
+                ? draw2dFx.lastReasonCode
+                : 'draw2d_fx_idle',
+              lastOk: draw2dFx.lastOk !== false,
+            },
             masking: {
               pendingPassCount: __num(draw2dMasking.pendingPassCount),
+              pendingAdvancedPassCount: __num(draw2dMasking.pendingAdvancedPassCount),
               lastSubmittedPassCount: __num(draw2dMasking.lastSubmittedPassCount),
               lastExecutedPassCount: __num(draw2dMasking.lastExecutedPassCount),
               lastSubmittedCommandCount: __num(draw2dMasking.lastSubmittedCommandCount),
@@ -2357,6 +2389,33 @@ export function buildNativeProbeSource(conformanceCase, options = {}) {
                 ? draw2dMasking.lastReasonCode
                 : 'draw2d_mask_idle',
               lastOk: draw2dMasking.lastOk !== false,
+              lastRequestedMaskKind: typeof draw2dMasking.lastRequestedMaskKind === 'string'
+                ? draw2dMasking.lastRequestedMaskKind
+                : 'none',
+              lastRequestedMaskShape: typeof draw2dMasking.lastRequestedMaskShape === 'string'
+                ? draw2dMasking.lastRequestedMaskShape
+                : 'none',
+              lastRequestedMaskFeather: __num(draw2dMasking.lastRequestedMaskFeather),
+            },
+            compositor: {
+              knownGraphCount: __num(draw2dCompositor.knownGraphCount),
+              knownStageCount: __num(draw2dCompositor.knownStageCount),
+              lastGraphName: typeof draw2dCompositor.lastGraphName === 'string'
+                ? draw2dCompositor.lastGraphName
+                : '',
+              lastGraphStageCount: __num(draw2dCompositor.lastGraphStageCount),
+              lastGraphCommandCount: __num(draw2dCompositor.lastGraphCommandCount),
+              lastGraphReasonCode: typeof draw2dCompositor.lastGraphReasonCode === 'string'
+                ? draw2dCompositor.lastGraphReasonCode
+                : 'draw2d_compositor_idle',
+              lastGraphOk: draw2dCompositor.lastGraphOk !== false,
+              pendingExportCount: __num(draw2dCompositor.pendingExportCount),
+              lastSubmittedExportCount: __num(draw2dCompositor.lastSubmittedExportCount),
+              lastExecutedExportCount: __num(draw2dCompositor.lastExecutedExportCount),
+              lastExportReasonCode: typeof draw2dCompositor.lastExportReasonCode === 'string'
+                ? draw2dCompositor.lastExportReasonCode
+                : 'draw2d_export_idle',
+              lastExportOk: draw2dCompositor.lastExportOk !== false,
             },
           },
           scene3dRuntime: {

package/src/evidence-bundle.mjs

@@ -0,0 +1,242 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+
+import { buildRuntimeInspectorSnapshotReport } from './conformance.mjs';
+import {
+  advanceSessionFrames,
+  bootSessionRuntime,
+  exportSessionInspect,
+  exportSessionState,
+} from './session-runtime.mjs';
+import { runHeadlessReplay } from './replay-runtime.mjs';
+
+export const EVIDENCE_BUNDLE_SCHEMA_VERSION = 'aurajs.evidence-bundle.v1';
+export const EVIDENCE_PERF_SUMMARY_SCHEMA_VERSION = 'aurajs.evidence-perf-summary.v1';
+
+export class EvidenceBundleError extends Error {
+  constructor(reasonCode, message, details = {}) {
+    super(message);
+    this.name = 'EvidenceBundleError';
+    this.reasonCode = reasonCode;
+    this.details = details;
+  }
+}
+
+function writeJsonFile(filePath, payload) {
+  mkdirSync(dirname(filePath), { recursive: true });
+  writeFileSync(filePath, `${JSON.stringify(payload, null, 2)}\n`, 'utf8');
+}
+
+function buildPerfSummary({ runtime, inspectReport, captureKind }) {
+  return {
+    schemaVersion: EVIDENCE_PERF_SUMMARY_SCHEMA_VERSION,
+    kind: 'headless-runtime-profile',
+    captureKind,
+    frame: inspectReport?.frame || null,
+    window: inspectReport?.window || null,
+    queues: inspectReport?.queues || null,
+    counters: {
+      assertionsPassed: runtime.testState.passes,
+      drawCalls: runtime.testState.drawCalls,
+      audioCalls: runtime.testState.audioCalls,
+      moduleCount: runtime.bundle.moduleCount,
+      framesExecuted: runtime.frameIndex,
+      elapsedSeconds: runtime.elapsedSeconds,
+    },
+  };
+}
+
+export async function captureHeadlessEvidenceBundle(options = {}) {
+  const projectRoot = resolve(options.projectRoot || process.cwd());
+  const outDir = resolve(projectRoot, options.outDir || '.aura/evidence/latest');
+  const capturedAt = new Date().toISOString();
+  const frames = Number.isInteger(Number(options.frames)) && Number(options.frames) >= 0
+    ? Number(options.frames)
+    : 1;
+  const mode = 'headless';
+  const captureKind = options.replayPayload ? 'replay' : 'frame-advance';
+  let replayBundle = null;
+  let activeRuntime = null;
+  if (options.replayPayload) {
+    replayBundle = await runHeadlessReplay({
+      projectRoot,
+      file: options.file,
+      width: options.width,
+      height: options.height,
+      payload: options.replayPayload,
+    });
+    activeRuntime = replayBundle.runtime;
+    if (frames > 0 && replayBundle.report.ok === true) {
+      await advanceSessionFrames(activeRuntime, frames);
+    }
+  } else {
+    activeRuntime = await bootSessionRuntime({
+      projectRoot,
+      file: options.file,
+      width: options.width,
+      height: options.height,
+    });
+    if (frames > 0) {
+      await advanceSessionFrames(activeRuntime, frames);
+    }
+  }
+
+  const stateResult = exportSessionState(activeRuntime, {
+    mode,
+    seed: replayBundle?.report?.seed || null,
+    capturedAt,
+  });
+  if (!stateResult || typeof stateResult !== 'object' || stateResult.ok !== true || !stateResult.payload) {
+    throw new EvidenceBundleError(
+      typeof stateResult?.reasonCode === 'string' ? stateResult.reasonCode : 'evidence_state_export_failed',
+      stateResult?.detail
+        ? `Evidence state export failed: ${stateResult.detail}`
+        : 'Evidence state export failed.',
+      { stateResult: stateResult || null },
+    );
+  }
+
+  const runtimeInspectorSnapshot = await exportSessionInspect(activeRuntime, {
+    frames: 0,
+    mode,
+  });
+  const inspectReport = buildRuntimeInspectorSnapshotReport({
+    generatedAt: capturedAt,
+    mode,
+    conformanceReportPath: null,
+    runtimeInspectorSnapshot,
+    hostBinary: null,
+  });
+  if (!inspectReport || typeof inspectReport !== 'object') {
+    throw new EvidenceBundleError(
+      'evidence_inspect_export_failed',
+      'Evidence inspect export returned an invalid report payload.',
+      { runtimeInspectorSnapshot },
+    );
+  }
+  if (inspectReport.status !== 'pass') {
+    throw new EvidenceBundleError(
+      typeof inspectReport.reasonCode === 'string' ? inspectReport.reasonCode : 'evidence_inspect_export_failed',
+      inspectReport.error
+        ? `Evidence inspect export failed: ${inspectReport.error}`
+        : 'Evidence inspect export failed.',
+      { inspectReport },
+    );
+  }
+
+  const perfSummary = buildPerfSummary({
+    runtime: activeRuntime,
+    inspectReport,
+    captureKind,
+  });
+  const replayReasonCode = replayBundle?.report?.ok === false
+    ? 'evidence_capture_replay_diverged'
+    : 'evidence_capture_ok';
+  const summary = {
+    schemaVersion: 'aurajs.evidence-summary.v1',
+    ok: replayBundle ? replayBundle.report.ok !== false : true,
+    reasonCode: replayReasonCode,
+    mode,
+    captureKind,
+    capturedAt,
+    projectRoot,
+    entryFile: activeRuntime.entryFile,
+    runtime: {
+      width: activeRuntime.width,
+      height: activeRuntime.height,
+      framesExecuted: activeRuntime.frameIndex,
+      elapsedSeconds: activeRuntime.elapsedSeconds,
+      bundleOutFile: activeRuntime.bundle.outFile,
+      moduleCount: activeRuntime.bundle.moduleCount,
+      assertionsPassed: activeRuntime.testState.passes,
+      drawCalls: activeRuntime.testState.drawCalls,
+      audioCalls: activeRuntime.testState.audioCalls,
+    },
+    state: {
+      schemaVersion: stateResult.payload.schemaVersion,
+      fingerprint: stateResult.payload.export?.fingerprint || null,
+    },
+    inspect: {
+      schemaVersion: inspectReport.schemaVersion,
+      status: inspectReport.status,
+      reasonCode: inspectReport.reasonCode,
+    },
+    perf: perfSummary,
+  };
+  if (replayBundle) {
+    summary.replay = {
+      schemaVersion: replayBundle.report.schemaVersion,
+      ok: replayBundle.report.ok,
+      reasonCode: replayBundle.report.reasonCode,
+      seed: replayBundle.report.seed,
+      totalSteps: replayBundle.report.totalSteps,
+      executedFrames: replayBundle.report.executedFrames,
+      divergence: replayBundle.report.divergence || null,
+    };
+  }
+
+  const manifest = {
+    schemaVersion: EVIDENCE_BUNDLE_SCHEMA_VERSION,
+    ok: summary.ok,
+    reasonCode: summary.reasonCode,
+    mode,
+    captureKind,
+    capturedAt,
+    projectRoot,
+    entryFile: activeRuntime.entryFile,
+    outDir,
+    artifacts: {
+      summary: 'summary.json',
+      state: 'state.json',
+      inspect: 'inspect.json',
+      perf: 'perf.json',
+    },
+    runtime: summary.runtime,
+    replay: replayBundle
+      ? {
+          enabled: true,
+          ok: replayBundle.report.ok,
+          reasonCode: replayBundle.report.reasonCode,
+        }
+      : {
+          enabled: false,
+          ok: null,
+          reasonCode: null,
+        },
+  };
+  if (replayBundle) {
+    manifest.artifacts.replay = 'replay.json';
+    manifest.artifacts.replayReport = 'replay-report.json';
+  }
+
+  writeJsonFile(resolve(outDir, 'summary.json'), summary);
+  writeJsonFile(resolve(outDir, 'state.json'), stateResult.payload);
+  writeJsonFile(resolve(outDir, 'inspect.json'), inspectReport);
+  writeJsonFile(resolve(outDir, 'perf.json'), perfSummary);
+  if (replayBundle) {
+    writeJsonFile(resolve(outDir, 'replay.json'), replayBundle.replay);
+    writeJsonFile(resolve(outDir, 'replay-report.json'), replayBundle.report);
+  }
+  writeJsonFile(resolve(outDir, 'manifest.json'), manifest);
+
+  return {
+    manifest,
+    summary,
+    state: stateResult.payload,
+    inspect: inspectReport,
+    perf: perfSummary,
+    replay: replayBundle
+      ? {
+          input: replayBundle.replay,
+          report: replayBundle.report,
+        }
+      : null,
+    outDir,
+  };
+}
+
+export function serializeEvidenceManifest(payload, compact = false) {
+  return compact
+    ? `${JSON.stringify(payload)}\n`
+    : `${JSON.stringify(payload, null, 2)}\n`;
+}