yam-flow 0.1.4 → 0.1.6

package/src/bin/yam.ts

@@ -14,8 +14,10 @@ import {
   buildMissionPatchEnvelope,
   buildRollbackHint,
   buildRuntimeBackendEvidence,
+  buildUeyeDesignCompletionGate,
   buildUeyeVisualProvenance,
   buildUeyeRunReport,
+  buildUeyeSurfaceContext,
   buildYamCompletionProof,
   detectDbSafetyText as detectTrustDbSafetyText,
   isTruthStatus
@@ -139,7 +141,7 @@ Usage:
   yam proof write [dir] [--format json|md] [--out file] [--route route] [--truth status] [--command text]
   yam ueye capture --url URL --out screenshot.png [--viewport 1440x900] [--full-page] [--json]
   yam ueye compare --reference ref.png --actual screenshot.png [--json]
-  yam ueye report [--reference ref.png] [--actual screenshot.png] [--json]
+  yam ueye report [--reference ref.png] [--actual screenshot.png] [--provider-context local] [--execution-surface in-app-browser] [--json]
   yam media proof [--requested] [--attempted] [--output file] [--json]
   yam runtime evidence [--backend terminal|in-app-browser|playwright|tmux|zellij] [--claim observed|started|stopped|cleanup-verified] [--json]
   yam mission queue [--agent-id id] [--scope text] [--changed file] [--verification-hint text] [--json]
@@ -808,7 +810,7 @@ function toolsDoctorNextActionDetails({ pack, rows, riskNotes, frameworkChecklis
   if (rows.some((row) => row.name === 'Yam skills' && row.status !== 'ready')) actions.push(nextActionDetail('install-skills', 'warning', 'skill install state is incomplete', 'run `yam install` and restart Codex before relying on installed skills', 'yam install'));
   if (riskNotes.some((note) => note.level === 'danger')) actions.push(nextActionDetail('deep-safety', 'error', 'destructive database or production write signal detected', 'use $deep before claiming destructive database or production write safety', 'yam safety "<command or SQL>"'));
   if (frameworkChecklist?.detected && !commands?.build && !commands?.typecheck) actions.push(nextActionDetail('verification-command', 'warning', 'build/typecheck command not detected', 'add or document a small build/typecheck command for implementation verification', 'yam pack .'));
-  if (frameworkChecklist?.uiLike) actions.push(nextActionDetail('ueye-evidence', 'info', 'UI-like project detected', 'for Ueye verified claims, record reference, actual screenshot, and comparison result', 'yam ueye report --reference ref.png --actual shot.png --json'));
+  if (frameworkChecklist?.uiLike) actions.push(nextActionDetail('ueye-evidence', 'info', 'UI-like project detected', 'for Ueye verified claims, record reference, actual screenshot, comparison result, and surface context', 'yam ueye report --reference ref.png --actual shot.png --provider-context local --execution-surface in-app-browser --json'));
   return uniqueNextActionDetails(actions);
 }
 
@@ -1348,18 +1350,18 @@ Opt-in visual evidence helpers. Ueye stays one skill: fast by default, capture/c
 Usage:
   yam ueye capture --url URL --out screenshot.png [--viewport 1440x900] [--full-page] [--json]
   yam ueye compare --reference ref.png --actual screenshot.png [--json]
-  yam ueye report [--reference ref.png] [--actual screenshot.png] [--review-session-id id] [--similar text] [--different text] [--missing text] [--resolved text] [--new-finding text] [--still-open text] [--regression text] [--viewport 1440x900] [--state default] [--design-quality pass|needs-polish|fails|not-checked] [--json]
+  yam ueye report [--reference ref.png] [--actual screenshot.png] [--review-session-id id] [--provider-context local] [--execution-surface in-app-browser] [--app-surface codex-app] [--browser-surface in-app-browser] [--control-mode manual|automated] [--preserved-state] [--preserved-url URL] [--completion-claim draft|needs-polish|done] [--strict] [--design-score n] [--p0 text] [--p1 text] [--states-checked] [--mobile-checked] [--contrast-checked] [--similar text] [--different text] [--missing text] [--resolved text] [--new-finding text] [--still-open text] [--regression text] [--viewport 1440x900] [--state default] [--design-quality pass|needs-polish|fails|not-checked] [--json]
 
 Notes:
   capture uses a locally available Playwright install when present. It does not download browsers or install dependencies.
   compare uses local files only and reports sha256, dimensions, comparison_result, and proof-ready visual provenance.
-  report produces a proof-ready Ueye visual run report and continuity/comparison record without requiring a new capture.
+  report produces a proof-ready Ueye visual run report, design completion gate, and continuity/comparison record without requiring a new capture.
 `);
 }
 
 async function ueyeCapture(args = []) {
   if (args[0] === 'help' || args[0] === '--help' || args[0] === '-h') return ueyeUsage();
-  const flags = parseSimpleFlags(args, new Set(['url', 'out', 'viewport', 'wait-until', 'timeout', 'full-page', 'json']));
+  const flags = parseSimpleFlags(args, new Set(['url', 'out', 'viewport', 'wait-until', 'timeout', 'full-page', 'provider-context', 'provider-badge', 'execution-surface', 'app-surface', 'browser-surface', 'control-mode', 'preserved-state', 'preserved-url', 'evidence-id', 'screenshot-id', 'json']));
   const url = String(flags.url || '');
   const out = String(flags.out || '');
   if (!url || !out) {
@@ -1384,6 +1386,24 @@ async function ueyeCapture(args = []) {
     await page.goto(url, { waitUntil, timeout });
     await page.screenshot({ path: target, fullPage: Boolean(flags.full_page) });
     const info = await imageFileInfo(target);
+    const surfaceContext = buildUeyeSurfaceContext({
+      provider_context: String(flags.provider_context || 'local-playwright'),
+      provider_badge: String(flags.provider_badge || flags.provider_context || 'local-playwright'),
+      execution_surface: String(flags.execution_surface || 'browser-capture'),
+      app_surface: String(flags.app_surface || 'local-project'),
+      browser_surface: String(flags.browser_surface || 'playwright'),
+      control_mode: String(flags.control_mode || 'automated-capture'),
+      route: 'ueye',
+      mode: 'capture',
+      url,
+      viewport: `${viewport.width}x${viewport.height}`,
+      screenshot_id: String(flags.screenshot_id || path.basename(target)),
+      evidence_id: String(flags.evidence_id || `ueye-capture-${timestampId()}`),
+      preserved_state: Boolean(flags.preserved_state),
+      preserved_url: String(flags.preserved_url || url),
+      local_only: true,
+      truth_status: 'verified'
+    });
     const result = {
       schema: 'yam.ueye-capture.v1',
       status: 'verified',
@@ -1393,6 +1413,7 @@ async function ueyeCapture(args = []) {
       full_page: Boolean(flags.full_page),
       sha256: info.sha256,
       dimensions: info.dimensions,
+      surface_context: surfaceContext,
       visual_evidence: `browser screenshot captured: ${target} (${info.dimensions}, sha256:${info.sha256})`
     };
     printJsonOrHuman(result, Boolean(flags.json), 'Ueye capture');
@@ -1415,7 +1436,7 @@ async function ueyeCapture(args = []) {
 
 async function ueyeCompare(args = []) {
   if (args[0] === 'help' || args[0] === '--help' || args[0] === '-h') return ueyeUsage();
-  const flags = parseSimpleFlags(args, new Set(['reference', 'ref', 'actual', 'screenshot', 'json', 'reference-id', 'screenshot-id']));
+  const flags = parseSimpleFlags(args, new Set(['reference', 'ref', 'actual', 'screenshot', 'json', 'reference-id', 'screenshot-id', 'provider-context', 'provider-badge', 'execution-surface', 'app-surface', 'browser-surface', 'control-mode', 'preserved-state', 'preserved-url', 'url', 'viewport', 'evidence-id']));
   const reference = String(flags.reference || flags.ref || '');
   const actual = String(flags.actual || flags.screenshot || '');
   if (!reference || !actual) {
@@ -1436,12 +1457,35 @@ async function ueyeCompare(args = []) {
     const sameDimensions = referenceInfo.dimensions === actualInfo.dimensions;
     const comparisonResult = exactMatch ? 'matched' : 'different';
     const truthStatus = exactMatch ? 'verified' : 'partial';
+    const surfaceContext = buildUeyeSurfaceContext({
+      provider_context: String(flags.provider_context || 'local-file'),
+      provider_badge: String(flags.provider_badge || flags.provider_context || 'local-file'),
+      execution_surface: String(flags.execution_surface || 'local-file-compare'),
+      app_surface: String(flags.app_surface || 'local-project'),
+      browser_surface: String(flags.browser_surface || 'not-used'),
+      control_mode: String(flags.control_mode || 'local-compare'),
+      route: 'ueye',
+      mode: 'compare',
+      url: String(flags.url || ''),
+      viewport: String(flags.viewport || ''),
+      screenshot_id: String(flags.screenshot_id || path.basename(actualPath)),
+      evidence_id: String(flags.evidence_id || `ueye-compare-${timestampId()}`),
+      preserved_state: Boolean(flags.preserved_state),
+      preserved_url: String(flags.preserved_url || flags.url || ''),
+      local_only: true,
+      truth_status: truthStatus
+    });
     const provenance = buildUeyeVisualProvenance({
       source_kind: 'implementation_screenshot',
       source_path: actualPath,
       source_hash: actualInfo.sha256,
       reference_id: String(flags.reference_id || path.basename(referencePath)),
       screenshot_id: String(flags.screenshot_id || path.basename(actualPath)),
+      provider_context: surfaceContext.provider_context,
+      provider_badge: surfaceContext.provider_badge,
+      execution_surface: surfaceContext.execution_surface,
+      app_surface: surfaceContext.app_surface,
+      browser_surface: surfaceContext.browser_surface,
       local_only: true,
       redacted: false,
       operator_provided: false,
@@ -1456,6 +1500,7 @@ async function ueyeCompare(args = []) {
       same_dimensions: sameDimensions,
       reference: referenceInfo,
       actual: actualInfo,
+      surface_context: surfaceContext,
       visual_evidence: `browser/local screenshot comparison executed: reference=${referencePath}, actual=${actualPath}, result=${comparisonResult}`,
       visual_provenance: provenance,
       proof_hint: `yam proof --route ueye --truth ${truthStatus} --visual "browser/local screenshot comparison executed: ${comparisonResult}" --visual-provenance '${JSON.stringify(provenance)}' --require-visual`
@@ -1476,7 +1521,7 @@ async function ueyeCompare(args = []) {
 
 async function ueyeReport(args = []) {
   if (args[0] === 'help' || args[0] === '--help' || args[0] === '-h') return ueyeUsage();
-  const flags = parseSimpleFlags(args, new Set(['reference', 'ref', 'actual', 'screenshot', 'capture-backend', 'compare-backend', 'design-quality', 'blocked-reason', 'next-action', 'next-visual-action', 'review-session-id', 'reference-id', 'screenshot-id', 'previous-screenshot-id', 'current-screenshot-id', 'previous-report', 'comparison-notes', 'similar', 'different', 'missing', 'resolved', 'new-finding', 'still-open', 'regression', 'viewport', 'state', 'json']));
+  const flags = parseSimpleFlags(args, new Set(['reference', 'ref', 'actual', 'screenshot', 'capture-backend', 'compare-backend', 'design-quality', 'blocked-reason', 'next-action', 'next-visual-action', 'review-session-id', 'reference-id', 'screenshot-id', 'previous-screenshot-id', 'current-screenshot-id', 'previous-report', 'comparison-notes', 'similar', 'different', 'missing', 'resolved', 'new-finding', 'still-open', 'regression', 'viewport', 'state', 'provider-context', 'provider-badge', 'execution-surface', 'app-surface', 'browser-surface', 'control-mode', 'preserved-state', 'preserved-url', 'url', 'evidence-id', 'completion-claim', 'completion-status', 'gate-mode', 'strict', 'design-score', 'min-design-score', 'p0', 'p1', 'open-p0', 'open-p1', 'states-checked', 'mobile-checked', 'responsive-checked', 'contrast-checked', 'accessibility-checked', 'cta-checked', 'direction-locked', 'reference-read', 'comparison-result', 'json']));
   const reference = String(flags.reference || flags.ref || '');
   const actual = String(flags.actual || flags.screenshot || '');
   const referenceSources = [];
@@ -1485,6 +1530,24 @@ async function ueyeReport(args = []) {
   let blockedReason = String(flags.blocked_reason || '');
   const reviewSessionId = String(flags.review_session_id || `ueye-${timestampId()}`);
   const previousReport = await readPreviousUeyeReport(flags.previous_report);
+  const surfaceContext = buildUeyeSurfaceContext({
+    provider_context: String(flags.provider_context || 'not-recorded'),
+    provider_badge: String(flags.provider_badge || flags.provider_context || 'not-recorded'),
+    execution_surface: String(flags.execution_surface || flags.capture_backend || 'not-recorded'),
+    app_surface: String(flags.app_surface || 'not-recorded'),
+    browser_surface: String(flags.browser_surface || flags.capture_backend || 'not-recorded'),
+    control_mode: String(flags.control_mode || 'not-recorded'),
+    route: 'ueye',
+    mode: 'report',
+    url: String(flags.url || flags.preserved_url || ''),
+    viewport: String(flags.viewport || ''),
+    screenshot_id: String(flags.current_screenshot_id || flags.screenshot_id || ''),
+    evidence_id: String(flags.evidence_id || reviewSessionId),
+    preserved_state: Boolean(flags.preserved_state),
+    preserved_url: String(flags.preserved_url || flags.url || ''),
+    local_only: true,
+    truth_status: actual ? 'partial' : 'assumed'
+  });
 
   try {
     if (reference) {
@@ -1494,6 +1557,11 @@ async function ueyeReport(args = []) {
         source_path: info.path,
         source_hash: info.sha256,
         reference_id: String(flags.reference_id || path.basename(info.path)),
+        provider_context: surfaceContext.provider_context,
+        provider_badge: surfaceContext.provider_badge,
+        execution_surface: surfaceContext.execution_surface,
+        app_surface: surfaceContext.app_surface,
+        browser_surface: surfaceContext.browser_surface,
         local_only: true,
         operator_provided: true,
         comparison_result: 'reference-recorded',
@@ -1508,13 +1576,20 @@ async function ueyeReport(args = []) {
         source_hash: info.sha256,
         reference_id: String(flags.reference_id || referenceSources[0]?.reference_id || ''),
         screenshot_id: String(flags.current_screenshot_id || flags.screenshot_id || path.basename(info.path)),
+        provider_context: surfaceContext.provider_context,
+        provider_badge: surfaceContext.provider_badge,
+        execution_surface: surfaceContext.execution_surface,
+        app_surface: surfaceContext.app_surface,
+        browser_surface: surfaceContext.browser_surface,
         local_only: true,
         operator_provided: false,
         comparison_result: 'implementation-recorded',
         truth_status: 'partial'
       }));
     }
-    if (reference && actual && referenceSources[0]?.source_hash === implementationSources[0]?.source_hash) {
+    if (flags.comparison_result) {
+      comparisonResult = normalizeUeyeComparisonResult(flags.comparison_result);
+    } else if (reference && actual && referenceSources[0]?.source_hash === implementationSources[0]?.source_hash) {
       comparisonResult = 'matched';
     } else if (reference && actual) {
       comparisonResult = 'different';
@@ -1526,8 +1601,29 @@ async function ueyeReport(args = []) {
   const report = buildUeyeRunReport({
     reference_sources: referenceSources,
     implementation_sources: implementationSources,
+    surface_context: {
+      ...surfaceContext,
+      screenshot_id: surfaceContext.screenshot_id || String(flags.current_screenshot_id || flags.screenshot_id || implementationSources[0]?.screenshot_id || ''),
+      truth_status: blockedReason ? 'blocked' : implementationSources.length ? 'partial' : 'assumed'
+    },
     comparison_result: comparisonResult,
     design_quality: String(flags.design_quality || 'not-checked'),
+    design_completion_gate: {
+      mode: flags.strict || flags.gate_mode === 'strict' ? 'strict' : 'fast',
+      completion_claim: flags.completion_claim || flags.completion_status || 'draft',
+      design_score: numberOrNull(flags.design_score),
+      min_design_score: numberOrNull(flags.min_design_score) ?? 8,
+      p0: [...arrayFlag(flags.p0), ...arrayFlag(flags.open_p0)],
+      p1: [...arrayFlag(flags.p1), ...arrayFlag(flags.open_p1)],
+      states_checked: Boolean(flags.states_checked),
+      mobile_checked: Boolean(flags.mobile_checked),
+      responsive_checked: Boolean(flags.responsive_checked),
+      contrast_checked: Boolean(flags.contrast_checked),
+      accessibility_checked: Boolean(flags.accessibility_checked),
+      cta_checked: Boolean(flags.cta_checked),
+      direction_locked: Boolean(flags.direction_locked),
+      reference_read: Boolean(flags.reference_read)
+    },
     blocked_reason: blockedReason,
     next_action: String(flags.next_visual_action || flags.next_action || '')
   });
@@ -1536,6 +1632,8 @@ async function ueyeReport(args = []) {
     previousReport,
     referenceSources,
     implementationSources,
+    surfaceContext: report.surface_context,
+    designCompletionGate: report.design_completion_gate,
     comparisonResult,
     designQuality: String(flags.design_quality || 'not-checked'),
     similar: arrayFlag(flags.similar),
@@ -1593,6 +1691,8 @@ function buildUeyeComparisonReport({
   previousReport,
   referenceSources,
   implementationSources,
+  surfaceContext,
+  designCompletionGate,
   comparisonResult,
   designQuality,
   similar,
@@ -1633,6 +1733,8 @@ function buildUeyeComparisonReport({
       reference_count: referenceSources.length,
       implementation_count: implementationSources.length
     },
+    surface_context: surfaceContext || buildUeyeSurfaceContext(),
+    design_completion_gate: designCompletionGate || null,
     comparison_result: comparisonResult,
     design_quality: designQuality,
     similar,
@@ -1652,6 +1754,12 @@ function buildUeyeComparisonReport({
   };
 }
 
+function normalizeUeyeComparisonResult(value = '') {
+  const text = String(value || '').toLowerCase();
+  if (['matched', 'similar', 'different', 'not-verified', 'not-applicable'].includes(text)) return text;
+  return 'not-verified';
+}
+
 async function media(args = []) {
   const subcommand = args[0] || 'help';
   if (subcommand === 'help' || subcommand === '--help' || subcommand === '-h') return mediaUsage();
@@ -1935,7 +2043,7 @@ function parseSimpleFlags(args = [], allowed = new Set<string>()) {
     const key = rawKey.slice(2);
     if (allowed.size && !allowed.has(key)) continue;
     const normalizedKey = key.replace(/-/g, '_');
-    if (['json', 'full-page', 'requested', 'attempted', 'available', 'wait-loop', 'cleanup-checked'].includes(key)) {
+    if (['json', 'full-page', 'requested', 'attempted', 'available', 'wait-loop', 'cleanup-checked', 'strict', 'preserved-state', 'states-checked', 'mobile-checked', 'responsive-checked', 'contrast-checked', 'accessibility-checked', 'cta-checked', 'direction-locked', 'reference-read'].includes(key)) {
       flags[normalizedKey] = true;
       continue;
     }
@@ -2085,6 +2193,7 @@ async function proof(args = []) {
   printProofList('Mission patch envelope', summary.missionEnvelope || []);
   printProofList('Rollback hint', summary.rollbackHint || []);
   printProofList('Media proof', summary.mediaProof || []);
+  printProofList('Design completion', summary.designCompletion || []);
   printProofList('Changed surfaces', summary.changed);
   printProofList('Skipped', summary.skipped);
   printProofList('Blocked', summary.blocked);
@@ -2180,6 +2289,10 @@ function buildProofSummary(parsed, artifact) {
       ...structuredEvidenceList(artifact.mediaProof),
       ...structuredEvidenceList(parsed.flags.media_proof)
     ],
+    designCompletion: [
+      ...structuredEvidenceList(artifact.designCompletion),
+      ...structuredEvidenceList(parsed.flags.design_completion)
+    ],
     cleanup: parsed.flags.cleanup || artifact.cleanup || '',
     changed: [...artifact.changed, ...arrayFlag(parsed.flags.changed)],
     skipped: [...artifact.skipped, ...arrayFlag(parsed.flags.skipped)],
@@ -2245,6 +2358,9 @@ function renderProofMarkdown(summary) {
     '## Media proof',
     ...renderProofMarkdownList(summary.mediaProof || []),
     '',
+    '## Design completion',
+    ...renderProofMarkdownList(summary.designCompletion || []),
+    '',
     '## Changed surfaces',
     ...renderProofMarkdownList(summary.changed),
     '',
@@ -2277,7 +2393,7 @@ function renderProofMarkdownList(values) {
 function parseProofArgs(args = []) {
   const flags: AnyRecord = {};
   const positionals: string[] = [];
-  const aliases = new Set(['goal', 'route', 'truth', 'command', 'evidence', 'visual', 'runtime', 'runtime-backend', 'runtime-claim', 'runtime-evidence-id', 'runtime-command', 'cleanup-checked', 'runtime-note', 'runtime-backend-evidence', 'visual-provenance', 'mission-envelope', 'rollback-hint', 'media-proof', 'cleanup', 'changed', 'skipped', 'blocked', 'assumed', 'assumption', 'unverified', 'from', 'format', 'out', 'file', 'json', 'require-runtime', 'require-real-runtime', 'require-tmux', 'require-visual']);
+  const aliases = new Set(['goal', 'route', 'truth', 'command', 'evidence', 'visual', 'runtime', 'runtime-backend', 'runtime-claim', 'runtime-evidence-id', 'runtime-command', 'cleanup-checked', 'runtime-note', 'runtime-backend-evidence', 'visual-provenance', 'mission-envelope', 'rollback-hint', 'media-proof', 'design-completion', 'cleanup', 'changed', 'skipped', 'blocked', 'assumed', 'assumption', 'unverified', 'from', 'format', 'out', 'file', 'json', 'require-runtime', 'require-real-runtime', 'require-tmux', 'require-visual']);
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
     if (arg.startsWith('--')) {
@@ -2291,7 +2407,7 @@ function parseProofArgs(args = []) {
       }
       const value = inlineValue ?? args[index + 1] ?? '';
       if (inlineValue === undefined) index += 1;
-      if (['command', 'evidence', 'visual', 'runtime', 'runtime-backend-evidence', 'visual-provenance', 'mission-envelope', 'rollback-hint', 'media-proof', 'changed', 'skipped', 'blocked', 'assumed', 'assumption', 'unverified'].includes(key)) {
+      if (['command', 'evidence', 'visual', 'runtime', 'runtime-backend-evidence', 'visual-provenance', 'mission-envelope', 'rollback-hint', 'media-proof', 'design-completion', 'changed', 'skipped', 'blocked', 'assumed', 'assumption', 'unverified'].includes(key)) {
         flags[normalizedKey] = [...arrayFlag(flags[normalizedKey]), value];
       } else {
         flags[normalizedKey] = value;
@@ -2334,6 +2450,7 @@ function emptyProofArtifact() {
     missionEnvelope: [],
     rollbackHint: [],
     mediaProof: [],
+    designCompletion: [],
     cleanup: '',
     changed: [],
     skipped: [],
@@ -2361,6 +2478,7 @@ async function parseProofJson(file, empty) {
       missionEnvelope: structuredEvidenceList(data.missionEnvelope || data.mission_envelope),
       rollbackHint: structuredEvidenceList(data.rollbackHint || data.rollback_hint),
       mediaProof: structuredEvidenceList(data.mediaProof || data.media_proof),
+      designCompletion: structuredEvidenceList(data.designCompletion || data.design_completion),
       cleanup: String(data.cleanup || data.cleanupStatus || ''),
       changed: arrayFlag(data.changed || data.files),
       skipped: arrayFlag(data.skipped),
@@ -2391,6 +2509,7 @@ async function parseProofMarkdown(file, empty) {
     missionEnvelope: readProofList(text, 'Mission patch envelope'),
     rollbackHint: readProofList(text, 'Rollback hint'),
     mediaProof: readProofList(text, 'Media proof'),
+    designCompletion: readProofList(text, 'Design completion'),
     cleanup: readProofField(text, 'Cleanup') || readProofField(text, 'Cleanup status'),
     changed: firstProofList(text, ['Changed surfaces', 'Files']),
     skipped: readProofList(text, 'Skipped'),
@@ -2476,6 +2595,9 @@ function formatStructuredEvidence(value) {
     if (data.schema === 'yam.media-generation-proof.v1' || data.generation_requested || data.output_hash) {
       return JSON.stringify(buildMediaGenerationProof(data));
     }
+    if (data.schema === 'yam.ueye-design-completion-gate.v1' || data.completion_claim || data.ready_to_claim_done !== undefined) {
+      return JSON.stringify(buildUeyeDesignCompletionGate(data));
+    }
     return JSON.stringify(data);
   } catch {
     return text;
@@ -2484,7 +2606,7 @@ function formatStructuredEvidence(value) {
 
 function hasProofEvidence(parsed) {
   const flags = parsed.flags || {};
-  return ['command', 'evidence', 'visual', 'runtime', 'runtime_backend_evidence', 'visual_provenance', 'mission_envelope', 'rollback_hint', 'media_proof', 'changed', 'skipped', 'blocked'].some((key) => arrayFlag(flags[key]).length > 0) || Boolean(flags.cleanup || flags.runtime_backend || flags.runtime_claim);
+  return ['command', 'evidence', 'visual', 'runtime', 'runtime_backend_evidence', 'visual_provenance', 'mission_envelope', 'rollback_hint', 'media_proof', 'design_completion', 'changed', 'skipped', 'blocked'].some((key) => arrayFlag(flags[key]).length > 0) || Boolean(flags.cleanup || flags.runtime_backend || flags.runtime_claim);
 }
 
 function printProofList(label, values) {