qfai 1.7.6 → 1.7.7

package/dist/index.mjs

@@ -455,6 +455,15 @@ function normalizeUiux(raw, configPath, issues) {
       );
     }
   }
+  if (raw.phase1ReleaseDate !== void 0) {
+    if (typeof raw.phase1ReleaseDate === "string" && !isNaN(new Date(raw.phase1ReleaseDate).getTime())) {
+      result.phase1ReleaseDate = raw.phase1ReleaseDate;
+    } else {
+      issues.push(
+        configIssue(configPath, "uiux.phase1ReleaseDate \u306F\u6709\u52B9\u306A\u65E5\u4ED8\u6587\u5B57\u5217\u3067\u3042\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059\u3002")
+      );
+    }
+  }
   if (raw.warning_as_error_override !== void 0) {
     if (Array.isArray(raw.warning_as_error_override) && raw.warning_as_error_override.every((v) => typeof v === "string")) {
       result.warning_as_error_override = raw.warning_as_error_override;
@@ -479,6 +488,12 @@ function normalizeUiux(raw, configPath, issues) {
       result.audit = audit;
     }
   }
+  if (raw.migration !== void 0) {
+    const migration = normalizeUiuxMigration(raw.migration, configPath, issues);
+    if (migration) {
+      result.migration = migration;
+    }
+  }
   return Object.keys(result).length > 0 ? result : void 0;
 }
 function normalizeUiuxAudit(raw, configPath, issues) {
@@ -538,6 +553,23 @@ function normalizeUiuxAudit(raw, configPath, issues) {
   }
   return Object.keys(result).length > 0 ? result : void 0;
 }
+function normalizeUiuxMigration(raw, configPath, issues) {
+  if (!isRecord(raw)) {
+    issues.push(configIssue(configPath, "uiux.migration \u306F\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u3067\u3042\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059\u3002"));
+    return void 0;
+  }
+  const result = {};
+  if (raw.strict !== void 0) {
+    if (typeof raw.strict === "boolean") {
+      result.strict = raw.strict;
+    } else {
+      issues.push(
+        configIssue(configPath, "uiux.migration.strict \u306F\u30D6\u30FC\u30EB\u5024\u3067\u3042\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059\u3002")
+      );
+    }
+  }
+  return Object.keys(result).length > 0 ? result : void 0;
+}
 function normalizeRenderEvidence(raw, configPath, issues) {
   if (!isRecord(raw)) {
     issues.push(
@@ -3595,18 +3627,125 @@ function resolveObligationsWithOptIn(mode, optIn) {
   return [.../* @__PURE__ */ new Set([...base, ...validOptIns])];
 }
 
+// src/core/prototyping/discussionReader.ts
+import { readFile as readFile10 } from "fs/promises";
+import path12 from "path";
+import { parse as parseYaml3 } from "yaml";
+var VALID_MODES = /* @__PURE__ */ new Set(["low-cost", "standard", "full-harness"]);
+var SIDECAR_FILENAME = "prototyping.yaml";
+async function readDiscussionRecommendation(discussionPackDir) {
+  const filePath = path12.join(discussionPackDir, SIDECAR_FILENAME);
+  let raw;
+  try {
+    raw = await readFile10(filePath, "utf-8");
+  } catch {
+    return { recommended_mode: null, rationale: null };
+  }
+  let doc;
+  try {
+    doc = parseYaml3(raw);
+  } catch {
+    return { recommended_mode: null, rationale: null };
+  }
+  if (!doc || typeof doc !== "object" || Array.isArray(doc)) {
+    return { recommended_mode: null, rationale: null };
+  }
+  const record2 = doc;
+  const prototyping = record2.prototyping;
+  if (!prototyping || typeof prototyping !== "object" || Array.isArray(prototyping)) {
+    return { recommended_mode: null, rationale: null };
+  }
+  const section = prototyping;
+  const rawMode = typeof section.recommended_mode === "string" ? section.recommended_mode.trim() : null;
+  const rationale = typeof section.rationale === "string" ? section.rationale.trim() : null;
+  const recommended_mode = rawMode && VALID_MODES.has(rawMode) ? rawMode : null;
+  return { recommended_mode, rationale };
+}
+
+// src/core/prototyping/precedenceResolver.ts
+var VALID_MODES2 = /* @__PURE__ */ new Set([
+  "default",
+  "standard",
+  "low-cost",
+  "full-harness"
+]);
+function isPrototypingMode(value) {
+  return VALID_MODES2.has(value);
+}
+var SYSTEM_DEFAULT_MODE = "standard";
+function resolvePrecedence(input) {
+  const { cliMode, discussion } = input;
+  const rawRecommended = discussion?.recommended_mode ?? null;
+  const recommended_mode = rawRecommended && isPrototypingMode(rawRecommended) ? rawRecommended : null;
+  if (cliMode) {
+    return {
+      effective_mode: cliMode,
+      mode_source: "cli-override",
+      recommended_mode,
+      rationale: "CLI override"
+    };
+  }
+  if (recommended_mode) {
+    return {
+      effective_mode: recommended_mode,
+      mode_source: "discussion-recommendation",
+      recommended_mode,
+      rationale: discussion?.rationale ?? "discussion recommendation"
+    };
+  }
+  return {
+    effective_mode: SYSTEM_DEFAULT_MODE,
+    mode_source: "default",
+    recommended_mode: null,
+    rationale: "system default"
+  };
+}
+
+// src/core/prototyping/modeLogger.ts
+var VALID_MODE_SOURCES = /* @__PURE__ */ new Set([
+  "cli-override",
+  "discussion-recommendation",
+  "default"
+]);
+var EVIDENCE_EXPECTATIONS = {
+  "low-cost": "L1/L2",
+  standard: "L2/L3",
+  "full-harness": "L3/L4/L5"
+};
+function formatModeLog(resolution) {
+  return {
+    mode_source: resolution.mode_source,
+    recommended_mode: resolution.recommended_mode,
+    effective_mode: resolution.effective_mode,
+    rationale: resolution.rationale,
+    evidence_expectations: EVIDENCE_EXPECTATIONS[resolution.effective_mode] ?? "L2/L3"
+  };
+}
+
+// src/core/prototyping/surfaceAdapter.ts
+var VISUAL_SURFACES = /* @__PURE__ */ new Set(["web", "mobile", "desktop"]);
+function adaptSurfaceEvidence(input) {
+  const { surfaceType, effectiveMode } = input;
+  const isVisual = VISUAL_SURFACES.has(surfaceType);
+  const isLowCost = effectiveMode === "low-cost";
+  const static_evidence = "collected";
+  const runtime_evidence = isLowCost ? "n/a" : "collected";
+  const visual_review = isVisual && !isLowCost ? "collected" : "n/a";
+  return { visual_review, static_evidence, runtime_evidence };
+}
+
 // src/core/report.ts
-import { readFile as readFile42 } from "fs/promises";
-import path54 from "path";
+import { readFile as readFile43 } from "fs/promises";
+import path57 from "path";
 
 // src/core/contractIndex.ts
-import { readFile as readFile10 } from "fs/promises";
-import path12 from "path";
+import { readFile as readFile11 } from "fs/promises";
+import path13 from "path";
 async function buildContractIndex(root, config) {
   const contractsRoot = resolvePath(root, config, "contractsDir");
-  const uiRoot = path12.join(contractsRoot, "ui");
-  const apiRoot = path12.join(contractsRoot, "api");
-  const dbRoot = path12.join(contractsRoot, "db");
+  const uiRoot = path13.join(contractsRoot, "ui");
+  const apiRoot = path13.join(contractsRoot, "api");
+  const dbRoot = path13.join(contractsRoot, "db");
   const [uiFiles, themaFiles, apiFiles, dbFiles] = await Promise.all([
     collectUiContractFiles(uiRoot),
     collectThemaContractFiles(),
@@ -3626,7 +3765,7 @@ async function buildContractIndex(root, config) {
 }
 async function indexContractFiles(files, index) {
   for (const file of files) {
-    const text = await readFile10(file, "utf-8");
+    const text = await readFile11(file, "utf-8");
     extractDeclaredContractIds(text).forEach((id) => {
       record(index, id, file);
     });
@@ -3896,15 +4035,15 @@ function resolveParentTcId(tcRef) {
 }
 
 // src/core/paths.ts
-import path13 from "path";
+import path14 from "path";
 function toRelativePath(root, target) {
   if (!target) {
     return target;
   }
-  if (!path13.isAbsolute(target)) {
+  if (!path14.isAbsolute(target)) {
     return toPosixPath2(target);
   }
-  const relative = path13.relative(root, target);
+  const relative = path14.relative(root, target);
   if (!relative) {
     return ".";
   }
@@ -4075,7 +4214,7 @@ function parseSpec(md, file) {
 }
 
 // src/core/deltaV1.ts
-import { parse as parseYaml3 } from "yaml";
+import { parse as parseYaml4 } from "yaml";
 var REQUIRED_DELTA_META_KEYS = [
   "id",
   "date",
@@ -4230,7 +4369,7 @@ function parseYamlMeta(block) {
     return { value: null, error: null };
   }
   try {
-    const parsed = parseYaml3(sanitizeMetaYaml(block));
+    const parsed = parseYaml4(sanitizeMetaYaml(block));
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
       return {
         value: null,
@@ -4264,7 +4403,7 @@ function parseVerificationPlan(body) {
     return { planHeadingLine: planHeading.line, parseError: null, items: [] };
   }
   try {
-    const parsed = parseYaml3(yamlSource);
+    const parsed = parseYaml4(yamlSource);
     if (!Array.isArray(parsed)) {
       return {
         planHeadingLine: planHeading.line,
@@ -4351,16 +4490,16 @@ function asTagArray(value) {
 }
 
 // src/core/version.ts
-import { readFile as readFile11 } from "fs/promises";
-import path14 from "path";
+import { readFile as readFile12 } from "fs/promises";
+import path15 from "path";
 import { fileURLToPath } from "url";
 async function resolveToolVersion() {
-  if ("1.7.6".length > 0) {
-    return "1.7.6";
+  if ("1.7.7".length > 0) {
+    return "1.7.7";
   }
   try {
     const packagePath = resolvePackageJsonPath();
-    const raw = await readFile11(packagePath, "utf-8");
+    const raw = await readFile12(packagePath, "utf-8");
     const parsed = JSON.parse(raw);
     const version = typeof parsed.version === "string" ? parsed.version : "";
     return version.length > 0 ? version : "unknown";
@@ -4371,13 +4510,13 @@ async function resolveToolVersion() {
 function resolvePackageJsonPath() {
   const base = import.meta.url;
   const basePath = base.startsWith("file:") ? fileURLToPath(base) : base;
-  return path14.resolve(path14.dirname(basePath), "../../package.json");
+  return path15.resolve(path15.dirname(basePath), "../../package.json");
 }
 
 // src/core/waivers.ts
-import { access as access6, readFile as readFile12 } from "fs/promises";
-import path15 from "path";
-import { parse as parseYaml4 } from "yaml";
+import { access as access6, readFile as readFile13 } from "fs/promises";
+import path16 from "path";
+import { parse as parseYaml5 } from "yaml";
 
 // src/core/regex.ts
 function escapeRegExp(value) {
@@ -4385,12 +4524,12 @@ function escapeRegExp(value) {
 }
 
 // src/core/waivers.ts
-var WAIVER_FILE = path15.join(".qfai", "waivers.yml");
-var UNSUPPORTED_WAIVER_FILE = path15.join(".qfai", "waivers.yaml");
+var WAIVER_FILE = path16.join(".qfai", "waivers.yml");
+var UNSUPPORTED_WAIVER_FILE = path16.join(".qfai", "waivers.yaml");
 var ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
 var RULE_ID_RE = /^[A-Z]+-\d{3}$/;
 async function applyWaivers(root, findings) {
-  const resolvedRoot = path15.resolve(root);
+  const resolvedRoot = path16.resolve(root);
   const ruleSeverityIndex = buildRuleSeverityIndex(findings);
   const loaded = await loadWaivers(resolvedRoot, ruleSeverityIndex);
   const applied = applyWaiversToFindings(resolvedRoot, findings, loaded.applicableWaivers);
@@ -4403,8 +4542,8 @@ async function applyWaivers(root, findings) {
   };
 }
 async function loadWaivers(root, ruleSeverityIndex) {
-  const waiverPath = path15.join(root, WAIVER_FILE);
-  const unsupportedPath = path15.join(root, UNSUPPORTED_WAIVER_FILE);
+  const waiverPath = path16.join(root, WAIVER_FILE);
+  const unsupportedPath = path16.join(root, UNSUPPORTED_WAIVER_FILE);
   const validationIssues = [];
   if (await exists6(unsupportedPath)) {
     validationIssues.push(
@@ -4428,7 +4567,7 @@ async function loadWaivers(root, ruleSeverityIndex) {
   }
   let rawText;
   try {
-    rawText = await readFile12(waiverPath, "utf-8");
+    rawText = await readFile13(waiverPath, "utf-8");
   } catch (error) {
     validationIssues.push(
       issue(
@@ -4449,7 +4588,7 @@ async function loadWaivers(root, ruleSeverityIndex) {
   }
   let parsed;
   try {
-    parsed = parseYaml4(rawText);
+    parsed = parseYaml5(rawText);
   } catch (error) {
     validationIssues.push(
       issue(
@@ -5121,8 +5260,8 @@ var STATIC_RULE_SEVERITY = {
 };
 
 // src/core/validators/contracts.ts
-import { readFile as readFile13 } from "fs/promises";
-import path16 from "path";
+import { readFile as readFile14 } from "fs/promises";
+import path17 from "path";
 var SQL_DANGEROUS_PATTERNS = [
   { pattern: /\bDROP\s+TABLE\b/i, label: "DROP TABLE" },
   { pattern: /\bDROP\s+DATABASE\b/i, label: "DROP DATABASE" },
@@ -5135,9 +5274,9 @@ var SQL_DANGEROUS_PATTERNS = [
 async function validateContracts(root, config) {
   const issues = [];
   const contractsRoot = resolvePath(root, config, "contractsDir");
-  const uiRoot = path16.join(contractsRoot, "ui");
-  const apiRoot = path16.join(contractsRoot, "api");
-  const dbRoot = path16.join(contractsRoot, "db");
+  const uiRoot = path17.join(contractsRoot, "ui");
+  const apiRoot = path17.join(contractsRoot, "api");
+  const dbRoot = path17.join(contractsRoot, "db");
   const [uiFiles, apiFiles, dbFiles] = await Promise.all([
     collectUiContractFiles(uiRoot),
     collectApiContractFiles(apiRoot),
@@ -5191,7 +5330,7 @@ async function validateContracts(root, config) {
 }
 async function validateContractFile(file, kind) {
   const issues = [];
-  const text = await readFile13(file, "utf-8");
+  const text = await readFile14(file, "utf-8");
   const declaredIds = extractDeclaredContractIds(text);
   issues.push(...validateDeclaredContractIds(declaredIds, file, kind));
   if (kind === "DB") {
@@ -5312,23 +5451,23 @@ function formatError5(error) {
 }
 
 // src/core/validators/discussMermaid.ts
-import { readFile as readFile14 } from "fs/promises";
-import path17 from "path";
+import { readFile as readFile15 } from "fs/promises";
+import path18 from "path";
 var DISCUSSION_PACK_FLOW_FILE = "03_Story-Workshop.md";
 var MERMAID_START_RE = /^\s*(`{3,}|~{3,})\s*mermaid\b/i;
 var FLOW_OR_SEQUENCE_RE = /\b(?:sequenceDiagram|flowchart)\b/;
 async function validateDiscussionMermaid(root) {
-  const discussionRootDir = path17.join(root, ".qfai", "discussion");
+  const discussionRootDir = path18.join(root, ".qfai", "discussion");
   const discussionPackMarkdownFiles = await collectFiles(discussionRootDir, {
     extensions: [".md"]
   });
   const discussionPackFiles = [];
   for (const file of discussionPackMarkdownFiles) {
-    const fileName = path17.basename(file);
+    const fileName = path18.basename(file);
     if (fileName !== DISCUSSION_PACK_FLOW_FILE) {
       continue;
     }
-    const discussionDirName = path17.basename(path17.dirname(file));
+    const discussionDirName = path18.basename(path18.dirname(file));
     const nameValidation = validatePackName("discussion", discussionDirName);
     if (nameValidation.isCanonical) {
       discussionPackFiles.push({ file, kind: "current" });
@@ -5358,7 +5497,7 @@ async function validateDiscussionMermaid(root) {
     );
   }
   for (const { file } of discussionPackFiles) {
-    const text = await readFile14(file, "utf-8");
+    const text = await readFile15(file, "utf-8");
     if (containsMermaidFlowDiagram(text)) {
       continue;
     }
@@ -5408,17 +5547,17 @@ function containsMermaidFlowDiagram(text) {
 }
 
 // src/core/validators/assistantAssets.ts
-import { access as access7, readFile as readFile15 } from "fs/promises";
-import path18 from "path";
+import { access as access7, readFile as readFile16 } from "fs/promises";
+import path19 from "path";
 var DRIFT_PROTOCOL_MARKER = "[DRIFT-PROTOCOL:MANDATORY]";
 var REVIEWER_GATE_HEADING_PATTERN = /^###\s+Reviewer Gate\b.*$/im;
 var ANY_MARKDOWN_HEADING_PATTERN = /^\s*#{1,6}\s+/m;
 async function validateAssistantAssets(root, config) {
   const skillsDir = resolvePath(root, config, "skillsDir");
-  const assistantDir = path18.dirname(skillsDir);
-  const skillsLocalDir = path18.join(path18.dirname(skillsDir), `${path18.basename(skillsDir)}.local`);
-  const driftProtocolPath = path18.join(assistantDir, "instructions", "drift-protocol.md");
-  const testLayersPath = path18.join(assistantDir, "steering", "test-layers.md");
+  const assistantDir = path19.dirname(skillsDir);
+  const skillsLocalDir = path19.join(path19.dirname(skillsDir), `${path19.basename(skillsDir)}.local`);
+  const driftProtocolPath = path19.join(assistantDir, "instructions", "drift-protocol.md");
+  const testLayersPath = path19.join(assistantDir, "steering", "test-layers.md");
   const issues = [];
   if (!await exists7(driftProtocolPath)) {
     issues.push(
@@ -5444,7 +5583,7 @@ async function validateAssistantAssets(root, config) {
   }
   const skillFiles = await collectSkillFiles([skillsDir, skillsLocalDir]);
   for (const skillFile of skillFiles) {
-    const content = await readFile15(skillFile, "utf-8");
+    const content = await readFile16(skillFile, "utf-8");
     if (!content.includes(DRIFT_PROTOCOL_MARKER)) {
       issues.push(
         issue(
@@ -5486,7 +5625,7 @@ async function validateAssistantAssets(root, config) {
 }
 async function collectSkillFiles(dirs) {
   const files = await Promise.all(dirs.map((dir) => collectFiles(dir)));
-  return files.flat().filter((filePath) => path18.basename(filePath) === "SKILL.md").sort((a, b) => a.localeCompare(b));
+  return files.flat().filter((filePath) => path19.basename(filePath) === "SKILL.md").sort((a, b) => a.localeCompare(b));
 }
 function extractReviewerGateSection(content) {
   const headingMatch = REVIEWER_GATE_HEADING_PATTERN.exec(content);
@@ -5527,20 +5666,20 @@ async function exists7(target) {
 }
 
 // src/core/skillsIntegrity.ts
-import { readFile as readFile16 } from "fs/promises";
-import path20 from "path";
+import { readFile as readFile17 } from "fs/promises";
+import path21 from "path";
 
 // src/shared/assets.ts
 import { existsSync } from "fs";
-import path19 from "path";
+import path20 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function getInitAssetsDir() {
   const base = import.meta.url;
   const basePath = base.startsWith("file:") ? fileURLToPath2(base) : base;
-  const baseDir = path19.dirname(basePath);
+  const baseDir = path20.dirname(basePath);
   const candidates = [
-    path19.resolve(baseDir, "../../../assets/init"),
-    path19.resolve(baseDir, "../../assets/init")
+    path20.resolve(baseDir, "../../../assets/init"),
+    path20.resolve(baseDir, "../../assets/init")
   ];
   for (const candidate of candidates) {
     if (existsSync(candidate)) {
@@ -5559,10 +5698,10 @@ function getInitAssetsDir() {
 // src/core/skillsIntegrity.ts
 async function diffProjectSkillsAgainstInitAssets(root, config) {
   const skillsDirConfig = config.paths.skillsDir;
-  const skillsDir = path20.isAbsolute(skillsDirConfig) ? skillsDirConfig : path20.resolve(root, skillsDirConfig);
+  const skillsDir = path21.isAbsolute(skillsDirConfig) ? skillsDirConfig : path21.resolve(root, skillsDirConfig);
   let templateDir;
   try {
-    const rel = path20.isAbsolute(skillsDirConfig) ? path20.relative(root, skillsDirConfig) : skillsDirConfig;
+    const rel = path21.isAbsolute(skillsDirConfig) ? path21.relative(root, skillsDirConfig) : skillsDirConfig;
     const normalized = rel.replace(/^[\\/]+/, "");
     if (normalized.length === 0 || normalized.startsWith("..")) {
       return {
@@ -5574,7 +5713,7 @@ async function diffProjectSkillsAgainstInitAssets(root, config) {
         changed: []
       };
     }
-    templateDir = path20.join(getInitAssetsDir(), normalized);
+    templateDir = path21.join(getInitAssetsDir(), normalized);
   } catch {
     return {
       status: "skipped_missing_assets",
@@ -5627,8 +5766,8 @@ async function diffProjectSkillsAgainstInitAssets(root, config) {
     }
     try {
       const [a, b] = await Promise.all([
-        readFile16(templateAbs, "utf-8"),
-        readFile16(projectAbs, "utf-8")
+        readFile17(templateAbs, "utf-8"),
+        readFile17(projectAbs, "utf-8")
       ]);
       if (normalizeNewlines(a) !== normalizeNewlines(b)) {
         changed.push(rel);
@@ -5651,7 +5790,7 @@ function normalizeNewlines(text) {
   return text.replace(/\r\n/g, "\n");
 }
 function toRel(base, abs) {
-  const rel = path20.relative(base, abs);
+  const rel = path21.relative(base, abs);
   return rel.replace(/[\\/]+/g, "/");
 }
 function intersectKeys(a, b) {
@@ -5696,8 +5835,8 @@ async function validateSkillsIntegrity(root, config) {
 }
 
 // src/core/validators/ids.ts
-import { readFile as readFile17 } from "fs/promises";
-import path21 from "path";
+import { readFile as readFile18 } from "fs/promises";
+import path22 from "path";
 var SC_TAG_RE2 = /^SC-\d{4}-\d{4}$/;
 var AC_ID_RE2 = /\bAC-[A-Za-z0-9_-]+\b/g;
 var CASE_ID_RE = /\b(?:CASE|TC)-[A-Za-z0-9_-]+\b/g;
@@ -5813,7 +5952,7 @@ async function collectSpecDefinitionIds(files, out) {
 }
 async function readSafe5(file) {
   try {
-    return await readFile17(file, "utf-8");
+    return await readFile18(file, "utf-8");
   } catch {
     return "";
   }
@@ -5844,23 +5983,23 @@ function recordId(out, id, file) {
 }
 function formatFileList(files, root) {
   return files.map((file) => {
-    const relative = path21.relative(root, file);
+    const relative = path22.relative(root, file);
     return relative.length > 0 ? relative : file;
   }).join(", ");
 }
 
 // src/core/validators/reviewArtifacts.ts
-import { readFile as readFile18, readdir as readdir4, stat as stat3 } from "fs/promises";
-import path22 from "path";
+import { readFile as readFile19, readdir as readdir4, stat as stat3 } from "fs/promises";
+import path23 from "path";
 var REVIEW_PACK_DIR_RE = /^review-(\d{17})$/i;
 var REVIEWER_FILE_RE = /^R\d+_.+\.md$/i;
 var ALLOWED_TARGET_KINDS = /* @__PURE__ */ new Set(["spec", "discussion"]);
 var ALLOWED_ROSTER_STATUS = /* @__PURE__ */ new Set(["PASS", "FAIL", "NA"]);
 var ALLOWED_OVERALL_STATUS = /* @__PURE__ */ new Set(["PASS", "FAIL"]);
 async function validateReviewArtifacts(root) {
-  const reviewRoot = path22.join(root, ".qfai", "review");
+  const reviewRoot = path23.join(root, ".qfai", "review");
   const issues = [];
-  const gitignorePath = path22.join(reviewRoot, ".gitignore");
+  const gitignorePath = path23.join(reviewRoot, ".gitignore");
   if (!await isFile(gitignorePath)) {
     issues.push(
       issue(
@@ -5898,8 +6037,8 @@ async function validateReviewArtifacts(root) {
 }
 async function validateReviewPack(reviewPackDir) {
   const issues = [];
-  const reviewRequestPath = path22.join(reviewPackDir, "review_request.md");
-  const summaryPath = path22.join(reviewPackDir, "summary.json");
+  const reviewRequestPath = path23.join(reviewPackDir, "review_request.md");
+  const summaryPath = path23.join(reviewPackDir, "summary.json");
   if (!await isFile(reviewRequestPath)) {
     issues.push(
       issue(
@@ -5942,7 +6081,7 @@ async function validateReviewPack(reviewPackDir) {
 async function validateSummarySchema(summaryPath) {
   let parsed;
   try {
-    parsed = JSON.parse(await readFile18(summaryPath, "utf-8"));
+    parsed = JSON.parse(await readFile19(summaryPath, "utf-8"));
   } catch (error) {
     return [
       issue(
@@ -6031,7 +6170,7 @@ async function listReviewPackDirs(reviewRoot) {
   } catch {
     return [];
   }
-  return entries.map((name) => path22.join(reviewRoot, name));
+  return entries.map((name) => path23.join(reviewRoot, name));
 }
 async function listReviewerFiles(reviewPackDir) {
   try {
@@ -6079,8 +6218,8 @@ function formatError6(error) {
 }
 
 // src/core/validators/specPack.ts
-import { readFile as readFile19 } from "fs/promises";
-import path23 from "path";
+import { readFile as readFile20 } from "fs/promises";
+import path24 from "path";
 var LEDGER_REQUIRED_COLUMNS = [
   "trace_id",
   "obj_id",
@@ -6498,7 +6637,7 @@ function validateLayeredNamespace(entry, filePath, ids, prefix) {
       "specPack.layered.namespace",
       mismatched,
       "compatibility",
-      `${path23.basename(filePath)} \u306E ${prefix} ID \u3092 spec-${entry.specNumber} \u306B\u5408\u308F\u305B\u3066\u4FEE\u6B63\u3057\u3066\u304F\u3060\u3055\u3044\u3002`
+      `${path24.basename(filePath)} \u306E ${prefix} ID \u3092 spec-${entry.specNumber} \u306B\u5408\u308F\u305B\u3066\u4FEE\u6B63\u3057\u3066\u304F\u3060\u3055\u3044\u3002`
     )
   ];
 }
@@ -6506,7 +6645,7 @@ async function collectExistingLayeredDeltaFiles(entry) {
   const candidates = Array.from(new Set(entry.deltaCandidates));
   const existing = [];
   for (const candidate of candidates) {
-    if (!/(?:^|_)delta\.md$/i.test(path23.basename(candidate))) {
+    if (!/(?:^|_)delta\.md$/i.test(path24.basename(candidate))) {
       continue;
     }
     if (await fileExists(candidate)) {
@@ -6517,7 +6656,7 @@ async function collectExistingLayeredDeltaFiles(entry) {
 }
 async function fileExists(target) {
   try {
-    await readFile19(target, "utf-8");
+    await readFile20(target, "utf-8");
     return true;
   } catch {
     return false;
@@ -6678,7 +6817,7 @@ async function validateTraceabilityLedger(entry, contractIds) {
   const issues = [];
   let ledgerText;
   try {
-    ledgerText = await readFile19(entry.traceabilityLedgerPath, "utf-8");
+    ledgerText = await readFile20(entry.traceabilityLedgerPath, "utf-8");
   } catch {
     return issues;
   }
@@ -7076,10 +7215,10 @@ async function loadExistingRequiredTexts(entry, missingFiles) {
 }
 async function loadLayerPolicy(root, config) {
   const skillsDir = resolvePath(root, config, "skillsDir");
-  const assistantRoot = path23.dirname(skillsDir);
-  const policyPath = path23.join(assistantRoot, "steering", "test-layers.md");
+  const assistantRoot = path24.dirname(skillsDir);
+  const policyPath = path24.join(assistantRoot, "steering", "test-layers.md");
   try {
-    const policyText = await readFile19(policyPath, "utf-8");
+    const policyText = await readFile20(policyPath, "utf-8");
     return {
       tags: resolveAllowedLayerTagsFromPolicy(policyText),
       issues: []
@@ -7187,15 +7326,15 @@ function extractMarkdownSection(text, heading) {
 }
 async function readSafe6(filePath) {
   try {
-    return await readFile19(filePath, "utf-8");
+    return await readFile20(filePath, "utf-8");
   } catch {
     return "";
   }
 }
 
 // src/core/validators/traceability.ts
-import { access as access8, readFile as readFile20 } from "fs/promises";
-import path24 from "path";
+import { access as access8, readFile as readFile21 } from "fs/promises";
+import path25 from "path";
 var SC_TAG_RE3 = /^SC-\d{4}-\d{4}$/;
 var SC_TAG_RE_GLOBAL = /\bSC-\d{4}-\d{4}\b/g;
 var SPEC_TAG_RE = /^SPEC-\d{4}$/;
@@ -7212,8 +7351,8 @@ async function validateTraceability(root, config, phase) {
   if (layeredEntries.length === 0) {
     return issues;
   }
-  const policiesDir = layeredEntries[0]?.sharedDir ?? path24.join(specsRoot, "_policies");
-  const capabilitiesPath = path24.join(policiesDir, "03_Capabilities.md");
+  const policiesDir = layeredEntries[0]?.sharedDir ?? path25.join(specsRoot, "_policies");
+  const capabilitiesPath = path25.join(policiesDir, "03_Capabilities.md");
   const capabilitiesExists = await exists8(capabilitiesPath);
   const capabilitiesText = await readSafe7(capabilitiesPath);
   const capIds = new Set(extractIds(capabilitiesText, "CAP"));
@@ -7294,7 +7433,7 @@ async function validatePoliciesLayerDownRef(policiesDir) {
     "04_Business-flow.md"
   ];
   for (const fileName of targets) {
-    const targetPath = path24.join(policiesDir, fileName);
+    const targetPath = path25.join(policiesDir, fileName);
     const text = await readSafe7(targetPath);
     if (text.length === 0) {
       continue;
@@ -7753,7 +7892,7 @@ function cloneGlobal3(re) {
 }
 async function readSafe7(target) {
   try {
-    return await readFile20(target, "utf-8");
+    return await readFile21(target, "utf-8");
   } catch {
     return "";
   }
@@ -7769,7 +7908,7 @@ async function exists8(target) {
 
 // src/core/validators/atddCodeTraceability.ts
 import { mkdir as mkdir2, writeFile as writeFile2 } from "fs/promises";
-import path25 from "path";
+import path26 from "path";
 async function validateAtddCodeTraceability(root, config) {
   const result = await evaluateAtddCodeTraceability(root, config);
   const issues = [];
@@ -7852,7 +7991,7 @@ async function validateAtddCodeTraceability(root, config) {
         "QFAI-ATDD-901",
         `atdd-traceability report \u306E\u51FA\u529B\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${formatError7(error)}`,
         "warning",
-        path25.join(resolvePath(root, config, "outDir"), "atdd-traceability"),
+        path26.join(resolvePath(root, config, "outDir"), "atdd-traceability"),
         "atddCodeTraceability.report"
       )
     );
@@ -7918,7 +8057,7 @@ function buildUnknownIssues(unknown) {
   });
 }
 async function writeAtddTraceabilityReport(root, config, result) {
-  const outputDir = path25.join(resolvePath(root, config, "outDir"), "atdd-traceability");
+  const outputDir = path26.join(resolvePath(root, config, "outDir"), "atdd-traceability");
   await mkdir2(outputDir, { recursive: true });
   const summary = {
     missing: {
@@ -7942,12 +8081,12 @@ async function writeAtddTraceabilityReport(root, config, result) {
     }
   };
   await writeFile2(
-    path25.join(outputDir, "summary.json"),
+    path26.join(outputDir, "summary.json"),
     `${JSON.stringify(summary, null, 2)}
 `,
     "utf-8"
   );
-  await writeFile2(path25.join(outputDir, "summary.md"), buildSummaryMarkdown(summary), "utf-8");
+  await writeFile2(path26.join(outputDir, "summary.md"), buildSummaryMarkdown(summary), "utf-8");
 }
 function buildSummaryMarkdown(summary) {
   const lines = [];
@@ -8012,8 +8151,8 @@ function formatError7(error) {
 }
 
 // src/core/validators/discussionPack.ts
-import { readFile as readFile21, stat as stat4 } from "fs/promises";
-import path26 from "path";
+import { readFile as readFile22, stat as stat4 } from "fs/promises";
+import path27 from "path";
 async function validateDiscussionPackReadiness(root, config) {
   const discussionRoot = resolvePath(root, config, "discussionDir");
   const readiness = await inspectLatestDiscussionPack(discussionRoot);
@@ -8105,7 +8244,7 @@ async function validateDiscussionPackReadiness(root, config) {
     );
   }
   if (readiness.blockingOqIds.length > 0) {
-    const oqPath = path26.join(readiness.latestPackDir, "11_OQ-Register.md");
+    const oqPath = path27.join(readiness.latestPackDir, "11_OQ-Register.md");
     issues.push(
       issue(
         "QFAI-DPACK-004",
@@ -8120,7 +8259,7 @@ async function validateDiscussionPackReadiness(root, config) {
     );
   }
   if (readiness.deferredWithoutDetails.length > 0) {
-    const deferredPath = path26.join(readiness.latestPackDir, "13_Deferred.md");
+    const deferredPath = path27.join(readiness.latestPackDir, "13_Deferred.md");
     issues.push(
       issue(
         "QFAI-DPACK-007",
@@ -8134,7 +8273,7 @@ async function validateDiscussionPackReadiness(root, config) {
       )
     );
   }
-  const storyWorkshopPath = path26.join(readiness.latestPackDir, "03_Story-Workshop.md");
+  const storyWorkshopPath = path27.join(readiness.latestPackDir, "03_Story-Workshop.md");
   const storyWorkshopText = await readSafe8(storyWorkshopPath);
   if (storyWorkshopText !== null && !containsMermaidBlock(storyWorkshopText)) {
     issues.push(
@@ -8161,28 +8300,28 @@ async function readSafe8(filePath) {
     if (!stats.isFile()) {
       return null;
     }
-    return await readFile21(filePath, "utf-8");
+    return await readFile22(filePath, "utf-8");
   } catch {
     return null;
   }
 }
 
 // src/core/validators/discussionVisuals.ts
-import { readFile as readFile22 } from "fs/promises";
-import path27 from "path";
+import { readFile as readFile23 } from "fs/promises";
+import path28 from "path";
 var MERMAID_FENCE_RE = /^\s*(?:`{3,}|~{3,})\s*mermaid\b/im;
 var SCREEN_MOCK_HEADING_RE = /^\s*#{1,6}\s*screen mock(?:\s*[-\u2014]+\s*fallback)?\s*\(html\+css\)\s*$/im;
 var HTML_FENCE_RE = /^\s*(?:`{3,}|~{3,})\s*html\b/im;
 var CSS_FENCE_RE = /^\s*(?:`{3,}|~{3,})\s*css\b/im;
 var UI_HINT_RE = /\b(?:ui|ux|screen|screens|page|pages|layout|wireframe|mock|form|button|frontend|navigation)\b|画面|モック|遷移|フォーム|ボタン/i;
 async function validateDiscussionVisuals(root) {
-  const discussionRoot = path27.join(root, ".qfai", "discussion");
+  const discussionRoot = path28.join(root, ".qfai", "discussion");
   const latestPackDir = await findLatestDiscussionPackDir(discussionRoot);
   if (!latestPackDir) {
     return [];
   }
   const issues = [];
-  const inceptionPath = path27.join(latestPackDir, "02_Inception-Deck.md");
+  const inceptionPath = path28.join(latestPackDir, "02_Inception-Deck.md");
   const inceptionText = await readSafe9(inceptionPath);
   if (inceptionText !== null && !MERMAID_FENCE_RE.test(inceptionText)) {
     issues.push(
@@ -8198,7 +8337,7 @@ async function validateDiscussionVisuals(root) {
       )
     );
   }
-  const storyWorkshopPath = path27.join(latestPackDir, "03_Story-Workshop.md");
+  const storyWorkshopPath = path28.join(latestPackDir, "03_Story-Workshop.md");
   const storyWorkshopText = await readSafe9(storyWorkshopPath);
   const storyWorkshopPlainText = storyWorkshopText === null ? null : stripFencedCodeBlocks(storyWorkshopText);
   if (storyWorkshopText === null || storyWorkshopPlainText === null) {
@@ -8262,14 +8401,14 @@ function escapeRegExp2(value) {
 }
 async function readSafe9(filePath) {
   try {
-    return await readFile22(filePath, "utf-8");
+    return await readFile23(filePath, "utf-8");
   } catch {
     return null;
   }
 }
 
 // src/core/validators/densityHints.ts
-import { readFile as readFile23 } from "fs/promises";
+import { readFile as readFile24 } from "fs/promises";
 var BR_ID_RE = /\bBR-[A-Za-z0-9-]+\b/g;
 var SCENARIO_RE = /^\s*Scenario(?:\s+Outline)?\s*:/gim;
 var TC_OR_CASE_RE = /\b(?:TC|CASE)-[A-Za-z0-9-]+\b/g;
@@ -8368,7 +8507,7 @@ function isSeparatorRow(line) {
 }
 async function readSafe10(filePath) {
   try {
-    return await readFile23(filePath, "utf-8");
+    return await readFile24(filePath, "utf-8");
   } catch {
     return "";
   }
@@ -8376,11 +8515,11 @@ async function readSafe10(filePath) {
 
 // src/core/validators/importLite.ts
 import { readdir as readdir5 } from "fs/promises";
-import path28 from "path";
+import path29 from "path";
 
 // src/core/validators/layerCoverage.ts
 import { mkdir as mkdir3, writeFile as writeFile3 } from "fs/promises";
-import path29 from "path";
+import path30 from "path";
 var ID_PATTERNS = {
   us: /^US-\d{4}(?:-\d{4})?$/,
   ac: /^AC-\d{4}(?:-\d{4})?$/,
@@ -8401,7 +8540,7 @@ async function validateLayerCoverage(root, config) {
   if (layeredEntries.length === 0) {
     return issues;
   }
-  const coverageRoot = path29.join(resolvePath(root, config, "outDir"), "specs-coverage");
+  const coverageRoot = path30.join(resolvePath(root, config, "outDir"), "specs-coverage");
   for (const entry of layeredEntries) {
     if (isV1421LayeredEntry(entry)) {
       const coverageResult = await validateV1421Coverage(entry);
@@ -8436,7 +8575,7 @@ async function validateLayerCoverage(root, config) {
 }
 async function validatePlanArtifacts(specsRoot, entries) {
   const issues = [];
-  const deprecatedPlanPath = path29.join(specsRoot, "plan.md");
+  const deprecatedPlanPath = path30.join(specsRoot, "plan.md");
   if (await exists5(deprecatedPlanPath)) {
     issues.push(
       issue(
@@ -8452,7 +8591,7 @@ async function validatePlanArtifacts(specsRoot, entries) {
     );
   }
   for (const entry of entries) {
-    const planFileName = path29.basename(entry.planPath).toLowerCase();
+    const planFileName = path30.basename(entry.planPath).toLowerCase();
     if (planFileName !== "10_plan.md") {
       continue;
     }
@@ -8834,7 +8973,7 @@ function buildSignalRows(prefix, counts, target) {
 }
 async function writeCoverageReport(coverageRoot, specNumber, snapshot) {
   await mkdir3(coverageRoot, { recursive: true });
-  const reportPath = path29.join(coverageRoot, `spec-${specNumber}.md`);
+  const reportPath = path30.join(coverageRoot, `spec-${specNumber}.md`);
   const lines = [];
   lines.push(`# Spec Coverage (spec-${specNumber})`);
   lines.push("");
@@ -8879,7 +9018,7 @@ function isV1421LayeredEntry(entry) {
   if (entry.layeredStyle === "v1421") {
     return true;
   }
-  return path29.extname(entry.examplesPath).toLowerCase() === ".md";
+  return path30.extname(entry.examplesPath).toLowerCase() === ".md";
 }
 function extractHeadings(text) {
   const headings = [];
@@ -9071,7 +9210,7 @@ async function validateExToTcCoverage(examplesPath, testCasesPath) {
 
 // src/core/validators/layeredTraceability.ts
 import { readdir as readdir6 } from "fs/promises";
-import path30 from "path";
+import path31 from "path";
 var POLICIES_FILES = [
   "01_Objective.md",
   "02_Initiative.md",
@@ -9120,7 +9259,7 @@ async function validateLayeredTraceability(root, config) {
   }
   const issues = [];
   if (layeredV1417Entries.length > 0) {
-    const policiesDir = layeredV1417Entries[0]?.sharedDir ?? path30.join(specsRoot, "_policies");
+    const policiesDir = layeredV1417Entries[0]?.sharedDir ?? path31.join(specsRoot, "_policies");
     issues.push(...await validatePoliciesDownstreamReferences(policiesDir));
     for (const entry of layeredV1417Entries) {
       issues.push(...await validateSpecRootParent(entry));
@@ -9161,7 +9300,7 @@ async function validateLayeredTraceability(root, config) {
     }
   }
   if (layeredV1421Entries.length > 0) {
-    const policiesDir = layeredV1421Entries[0]?.sharedDir ?? path30.join(specsRoot, "_policies");
+    const policiesDir = layeredV1421Entries[0]?.sharedDir ?? path31.join(specsRoot, "_policies");
     issues.push(...await validatePoliciesScopeForV1421(policiesDir));
     for (const entry of layeredV1421Entries) {
       issues.push(...await validateDownstreamRefsForV1421(entry));
@@ -9172,7 +9311,7 @@ async function validateLayeredTraceability(root, config) {
 async function validatePoliciesDownstreamReferences(policiesDir) {
   const issues = [];
   for (const fileName of POLICIES_FILES) {
-    const filePath = path30.join(policiesDir, fileName);
+    const filePath = path31.join(policiesDir, fileName);
     const text = await readSafe(filePath);
     if (text.trim().length === 0) {
       continue;
@@ -9245,7 +9384,7 @@ async function validateDownstreamRefsForV1421(entry) {
     issues.push(
       issue(
         "TRACE_DOWNSTREAM_REF",
-        `${path30.basename(check.filePath)} \u3067\u4E0B\u4F4D\u30EC\u30A4\u30E4\u30FC\u53C2\u7167\u306F\u7981\u6B62\u3067\u3059: ${refs.join(", ")}`,
+        `${path31.basename(check.filePath)} \u3067\u4E0B\u4F4D\u30EC\u30A4\u30E4\u30FC\u53C2\u7167\u306F\u7981\u6B62\u3067\u3059: ${refs.join(", ")}`,
         "error",
         check.filePath,
         "layeredTraceability.downstream",
@@ -9275,13 +9414,13 @@ function resolveLayerFromId(id) {
 async function collectMarkdownFiles(policiesDir) {
   try {
     const entries = await readdir6(policiesDir, { withFileTypes: true });
-    return entries.filter((entry) => entry.isFile() && path30.extname(entry.name).toLowerCase() === ".md").map((entry) => path30.join(policiesDir, entry.name)).sort((left, right) => left.localeCompare(right));
+    return entries.filter((entry) => entry.isFile() && path31.extname(entry.name).toLowerCase() === ".md").map((entry) => path31.join(policiesDir, entry.name)).sort((left, right) => left.localeCompare(right));
   } catch {
     return [];
   }
 }
 async function validateSpecRootParent(entry) {
-  const specPath = path30.join(entry.dir, "01_Spec.md");
+  const specPath = path31.join(entry.dir, "01_Spec.md");
   const text = await readSafe(specPath);
   if (text.trim().length > 0 && /\bCAP-\d{4}\b/.test(text)) {
     return [];
@@ -9382,10 +9521,10 @@ async function validateForbiddenRefs(filePath, pattern, messagePrefix) {
 
 // src/core/validators/legacyStatusDir.ts
 import { readdir as readdir7, stat as stat5 } from "fs/promises";
-import path31 from "path";
+import path32 from "path";
 var BASELINE_STATUS_ARTIFACTS = /* @__PURE__ */ new Set(["README.md", ".gitignore"]);
 async function validateLegacyStatusDir(root) {
-  const statusDir = path31.join(root, ".qfai", "status");
+  const statusDir = path32.join(root, ".qfai", "status");
   if (!await isDirectory(statusDir)) {
     return [];
   }
@@ -9437,15 +9576,15 @@ async function isDirectory(target) {
 }
 
 // src/core/validators/mermaidEnforcement.ts
-import { readFile as readFile24 } from "fs/promises";
-import path32 from "path";
+import { readFile as readFile25 } from "fs/promises";
+import path33 from "path";
 var TARGETS = [
   { segments: [".qfai", "specs"], extensions: [".md", ".feature"] },
   { segments: [".qfai", "discussion"], extensions: [".md"] }
 ];
 var BUSINESS_FLOW_RELATIVE_CANDIDATES = [
-  path32.join(".qfai", "specs", "_policies", "04_Business-Flow.md"),
-  path32.join(".qfai", "specs", "_policies", "04_Business-flow.md")
+  path33.join(".qfai", "specs", "_policies", "04_Business-Flow.md"),
+  path33.join(".qfai", "specs", "_policies", "04_Business-flow.md")
 ];
 var MERMAID_DIRECTIVE_RE = /^\s*(?:sequenceDiagram|flowchart|erDiagram|classDiagram|stateDiagram(?:-v2)?|journey|gantt|graph\s+(?:TB|BT|RL|LR|TD))\b/i;
 var FLOW_OR_SEQUENCE_RE2 = /\b(?:sequenceDiagram|flowchart)\b/i;
@@ -9455,13 +9594,13 @@ async function validateMermaidEnforcement(root) {
   const issues = [];
   const scanResults = /* @__PURE__ */ new Map();
   for (const filePath of targetFiles) {
-    const text = await readFile24(filePath, "utf-8");
+    const text = await readFile25(filePath, "utf-8");
     const result = scanMermaidUsage(filePath, text);
     scanResults.set(filePath, result);
     issues.push(...result.issues);
   }
   if (businessFlowPath) {
-    const businessFlowScan = scanResults.get(businessFlowPath) ?? scanMermaidUsage(businessFlowPath, await readFile24(businessFlowPath, "utf-8"));
+    const businessFlowScan = scanResults.get(businessFlowPath) ?? scanMermaidUsage(businessFlowPath, await readFile25(businessFlowPath, "utf-8"));
     if (businessFlowScan.mermaidFenceCount === 0) {
       issues.push(
         issue(
@@ -9489,7 +9628,7 @@ async function validateMermaidEnforcement(root) {
         )
       );
     }
-    if (path32.basename(businessFlowPath) === "04_Business-flow.md") {
+    if (path33.basename(businessFlowPath) === "04_Business-flow.md") {
       issues.push(
         issue(
           "QFAI-MMD-005",
@@ -9510,14 +9649,14 @@ async function validateMermaidEnforcement(root) {
 async function collectTargetFiles(root) {
   const files = [];
   for (const target of TARGETS) {
-    const targetDir = path32.join(root, ...target.segments);
+    const targetDir = path33.join(root, ...target.segments);
     files.push(
       ...await collectFiles(targetDir, {
         extensions: [...target.extensions]
       })
     );
   }
-  return Array.from(new Set(files)).filter((filePath) => path32.basename(filePath).toLowerCase() !== "readme.md").sort((a, b) => a.localeCompare(b));
+  return Array.from(new Set(files)).filter((filePath) => path33.basename(filePath).toLowerCase() !== "readme.md").sort((a, b) => a.localeCompare(b));
 }
 function scanMermaidUsage(filePath, text) {
   const lines = text.replace(/\r\n/g, "\n").split("\n");
@@ -9607,13 +9746,13 @@ function parseFenceStart(line) {
   };
 }
 async function collectDeprecatedBusinessFlowFeatureWarnings(root) {
-  const policiesDir = path32.join(root, ".qfai", "specs", "_policies");
+  const policiesDir = path33.join(root, ".qfai", "specs", "_policies");
   const featureFiles = await collectFiles(policiesDir, {
     extensions: [".feature"]
   });
   const issues = [];
   for (const filePath of featureFiles) {
-    if (!/business-flow/i.test(path32.basename(filePath))) {
+    if (!/business-flow/i.test(path33.basename(filePath))) {
       continue;
     }
     issues.push(
@@ -9633,7 +9772,7 @@ async function collectDeprecatedBusinessFlowFeatureWarnings(root) {
 }
 async function resolveBusinessFlowPath(root) {
   for (const relativePath of BUSINESS_FLOW_RELATIVE_CANDIDATES) {
-    const target = path32.join(root, relativePath);
+    const target = path33.join(root, relativePath);
     if (await exists5(target)) {
       return target;
     }
@@ -9771,7 +9910,7 @@ function normalizeHeaderKey(column) {
 }
 
 // src/core/validators/orphanProhibition.ts
-import path33 from "path";
+import path34 from "path";
 async function validateOrphanProhibition(root, config) {
   const specsRoot = resolvePath(root, config, "specsDir");
   const entries = await collectSpecEntries(specsRoot);
@@ -9782,9 +9921,9 @@ async function validateOrphanProhibition(root, config) {
     return [];
   }
   const issues = [];
-  const policiesDir = layeredEntries[0]?.sharedDir ?? path33.join(specsRoot, "_policies");
+  const policiesDir = layeredEntries[0]?.sharedDir ?? path34.join(specsRoot, "_policies");
   const capIds = new Set(
-    uniqueMatches(await readSafe(path33.join(policiesDir, "03_Capabilities.md")), /\bCAP-\d{4}\b/g)
+    uniqueMatches(await readSafe(path34.join(policiesDir, "03_Capabilities.md")), /\bCAP-\d{4}\b/g)
   );
   for (const entry of layeredEntries) {
     const usItems = collectMarkdownItems(await readSafe(entry.userStoriesPath), "US");
@@ -9934,8 +10073,8 @@ function validateExParentExists(filePath, exItems, acIds, brIds) {
 }
 
 // src/core/validators/prototypingEvidence.ts
-import { access as access9, readFile as readFile25 } from "fs/promises";
-import path34 from "path";
+import { access as access9, readFile as readFile26 } from "fs/promises";
+import path35 from "path";
 var EVIDENCE_MARKDOWN_FILE = "prototyping.md";
 var EVIDENCE_JSON_FILE = "prototyping.json";
 async function validatePrototypingEvidence(root, config) {
@@ -9944,10 +10083,10 @@ async function validatePrototypingEvidence(root, config) {
   if (specEntries.length === 0) {
     return [];
   }
-  const qfaiRoot = path34.dirname(specsRoot);
-  const evidenceRoot = path34.join(qfaiRoot, "evidence");
-  const evidenceMarkdownPath = path34.join(evidenceRoot, EVIDENCE_MARKDOWN_FILE);
-  const evidenceJsonPath = path34.join(evidenceRoot, EVIDENCE_JSON_FILE);
+  const qfaiRoot = path35.dirname(specsRoot);
+  const evidenceRoot = path35.join(qfaiRoot, "evidence");
+  const evidenceMarkdownPath = path35.join(evidenceRoot, EVIDENCE_MARKDOWN_FILE);
+  const evidenceJsonPath = path35.join(evidenceRoot, EVIDENCE_JSON_FILE);
   const [markdownRaw, jsonRaw] = await Promise.all([
     readSafe11(evidenceMarkdownPath),
     readSafe11(evidenceJsonPath)
@@ -10124,7 +10263,7 @@ function extractSpecRefs(rows) {
 }
 async function readSafe11(filePath) {
   try {
-    return await readFile25(filePath, "utf-8");
+    return await readFile26(filePath, "utf-8");
   } catch {
     return null;
   }
@@ -10280,7 +10419,7 @@ async function validateUiFidelity(root, config, evidenceJsonPath, evidence) {
   for (const screen of uiFidelity.screens) {
     const contractFiles = contractIndex.idToFiles.get(screen.uiContractId);
     const contractFile = contractFiles ? Array.from(contractFiles).sort((left, right) => left.localeCompare(right))[0] : void 0;
-    const contractRefFile = contractFile ? toPosixPath3(path34.relative(root, contractFile)) : void 0;
+    const contractRefFile = contractFile ? toPosixPath3(path35.relative(root, contractFile)) : void 0;
     if (!contractFiles || contractFiles.size === 0) {
       mismatches.push({
         contractId: screen.uiContractId,
@@ -11089,7 +11228,7 @@ async function collectMissingRenderArtifacts(root, render) {
     { label: "htmlPath", target: render.htmlPath }
   ];
   for (const candidate of candidates) {
-    const resolved = path34.isAbsolute(candidate.target) ? candidate.target : path34.resolve(root, candidate.target);
+    const resolved = path35.isAbsolute(candidate.target) ? candidate.target : path35.resolve(root, candidate.target);
     try {
       await access9(resolved);
     } catch {
@@ -11112,12 +11251,12 @@ function formatError9(error) {
 }
 
 // src/core/validators/requireIndex.ts
-import { readFile as readFile26 } from "fs/promises";
-import path35 from "path";
+import { readFile as readFile27 } from "fs/promises";
+import path36 from "path";
 
 // src/core/validators/repositoryHygiene.ts
 import { readdir as readdir8, stat as stat6 } from "fs/promises";
-import path36 from "path";
+import path37 from "path";
 var LEGACY_DIR_RULES = [
   { legacy: "discussions", canonical: "discussion" },
   { legacy: "discuss", canonical: "discussion" },
@@ -11128,11 +11267,11 @@ var LEGACY_DIR_RULES = [
 ];
 var SUSPICIOUS_TEMPLATE_NAME_RE = /^(?:_?templates?|_?sample(?:s)?|sample-template)$/i;
 async function validateRepositoryHygiene(root, config) {
-  const qfaiRoot = path36.join(root, ".qfai");
+  const qfaiRoot = path37.join(root, ".qfai");
   const specsRoot = resolvePath(root, config, "specsDir");
   const issues = [];
   for (const rule of LEGACY_DIR_RULES) {
-    const legacyPath = path36.join(qfaiRoot, rule.legacy);
+    const legacyPath = path37.join(qfaiRoot, rule.legacy);
     if (!await isDirectory2(legacyPath)) {
       continue;
     }
@@ -11187,10 +11326,10 @@ async function collectSuspiciousTemplatePaths(root) {
       continue;
     }
     for (const entry of entries) {
-      const absolute = path36.join(current, entry.name);
+      const absolute = path37.join(current, entry.name);
       if (entry.isDirectory()) {
         if (SUSPICIOUS_TEMPLATE_NAME_RE.test(entry.name)) {
-          matches.push(toPosix(path36.relative(root, absolute)));
+          matches.push(toPosix(path37.relative(root, absolute)));
         }
         queue.push(absolute);
         continue;
@@ -11198,9 +11337,9 @@ async function collectSuspiciousTemplatePaths(root) {
       if (!entry.isFile()) {
         continue;
       }
-      const baseName = path36.parse(entry.name).name;
+      const baseName = path37.parse(entry.name).name;
       if (SUSPICIOUS_TEMPLATE_NAME_RE.test(baseName)) {
-        matches.push(toPosix(path36.relative(root, absolute)));
+        matches.push(toPosix(path37.relative(root, absolute)));
       }
     }
   }
@@ -11218,7 +11357,7 @@ function toPosix(value) {
 }
 
 // src/core/validators/specSplitByCapability.ts
-import path37 from "path";
+import path38 from "path";
 var CAP_ID_RE2 = /\bCAP-\d{4}\b/g;
 async function validateSpecSplitByCapability(root, config) {
   const specsRoot = resolvePath(root, config, "specsDir");
@@ -11229,8 +11368,8 @@ async function validateSpecSplitByCapability(root, config) {
   if (layeredEntries.length === 0) {
     return [];
   }
-  const policiesDir = layeredEntries[0]?.sharedDir ?? path37.join(specsRoot, "_policies");
-  const capabilitiesPath = path37.join(policiesDir, "03_Capabilities.md");
+  const policiesDir = layeredEntries[0]?.sharedDir ?? path38.join(specsRoot, "_policies");
+  const capabilitiesPath = path38.join(policiesDir, "03_Capabilities.md");
   const capabilityText = await readSafe(capabilitiesPath);
   const issues = [];
   if (!await exists5(capabilitiesPath)) {
@@ -11270,7 +11409,7 @@ async function validateSpecSplitByCapability(root, config) {
     );
   }
   const actualSpecIds = new Set(
-    layeredEntries.map((entry) => path37.basename(entry.dir).toLowerCase())
+    layeredEntries.map((entry) => path38.basename(entry.dir).toLowerCase())
   );
   const expectedSpecIds = capIds.map((_, index) => `spec-${to4(index + 1)}`);
   const missingSpecIds = expectedSpecIds.filter((specId) => !actualSpecIds.has(specId));
@@ -11307,11 +11446,11 @@ async function validateSpecSplitByCapability(root, config) {
       continue;
     }
     const specId = `spec-${to4(index + 1)}`;
-    const entry = layeredEntries.find((value) => path37.basename(value.dir).toLowerCase() === specId);
+    const entry = layeredEntries.find((value) => path38.basename(value.dir).toLowerCase() === specId);
     if (!entry) {
       continue;
     }
-    const specFilePath = path37.join(entry.dir, "01_Spec.md");
+    const specFilePath = path38.join(entry.dir, "01_Spec.md");
     const specText = await readSafe(specFilePath);
     if (specText.trim().length === 0 || !specText.includes(capId)) {
       issues.push(
@@ -11330,8 +11469,8 @@ async function validateSpecSplitByCapability(root, config) {
 }
 
 // src/core/validators/statusInSpecs.ts
-import { readFile as readFile27 } from "fs/promises";
-import path38 from "path";
+import { readFile as readFile28 } from "fs/promises";
+import path39 from "path";
 var STRONG_PATTERNS = [
   { label: "release_candidate:", pattern: /\brelease_candidate\s*:/i },
   { label: "status:", pattern: /^\s*(?:-\s*)?status\s*:/im },
@@ -11388,23 +11527,23 @@ function hasMatch(text, pattern) {
 }
 async function readSafe12(filePath) {
   try {
-    return await readFile27(filePath, "utf-8");
+    return await readFile28(filePath, "utf-8");
   } catch {
     return "";
   }
 }
 function isOpenQuestionsFile(filePath) {
-  return /open-questions\.md$/i.test(path38.basename(filePath));
+  return /open-questions\.md$/i.test(path39.basename(filePath));
 }
 
 // src/core/validators/designToken.ts
-import { readFile as readFile28 } from "fs/promises";
-import path39 from "path";
+import { readFile as readFile29 } from "fs/promises";
+import path40 from "path";
 import fg2 from "fast-glob";
-import { parse as parseYaml6 } from "yaml";
+import { parse as parseYaml7 } from "yaml";
 
 // src/core/parse/designToken.ts
-import { parse as parseYaml5 } from "yaml";
+import { parse as parseYaml6 } from "yaml";
 var REF_PATTERN = /\{([^}]+)\}/g;
 var MAX_RESOLVE_DEPTH = 10;
 function parseDesignToken(yamlContent) {
@@ -11417,7 +11556,7 @@ function parseDesignToken(yamlContent) {
   };
   let parsed;
   try {
-    parsed = parseYaml5(yamlContent);
+    parsed = parseYaml6(yamlContent);
   } catch (error) {
     const msg = error instanceof Error ? error.message : String(error);
     result.errors.push({ message: `YAML parse error: ${msg}` });
@@ -11446,7 +11585,7 @@ function collectLayer(layer, layerName, target, errors) {
 }
 function flattenTokens(obj, prefix, target, errors) {
   for (const [key, value] of Object.entries(obj)) {
-    const path55 = `${prefix}.${key}`;
+    const path58 = `${prefix}.${key}`;
     if (value && typeof value === "object" && !Array.isArray(value)) {
       const record2 = value;
       if ("$value" in record2) {
@@ -11462,9 +11601,9 @@ function flattenTokens(obj, prefix, target, errors) {
         if (typeof record2.platform === "string") {
           token.platform = record2.platform;
         }
-        target.set(path55, token);
+        target.set(path58, token);
       } else {
-        flattenTokens(record2, path55, target, errors);
+        flattenTokens(record2, path58, target, errors);
       }
     }
   }
@@ -11474,44 +11613,44 @@ function resolveAllReferences(result) {
   for (const [key, val] of result.primitives) allTokens.set(key, val);
   for (const [key, val] of result.semantics) allTokens.set(key, val);
   for (const [key, val] of result.components) allTokens.set(key, val);
-  for (const [path55] of allTokens) {
-    resolveTokenRef(path55, allTokens, /* @__PURE__ */ new Set(), 0, result);
+  for (const [path58] of allTokens) {
+    resolveTokenRef(path58, allTokens, /* @__PURE__ */ new Set(), 0, result);
   }
 }
-function resolveTokenRef(path55, allTokens, visited, depth, result) {
-  if (result.resolved.has(path55)) {
-    return result.resolved.get(path55);
+function resolveTokenRef(path58, allTokens, visited, depth, result) {
+  if (result.resolved.has(path58)) {
+    return result.resolved.get(path58);
   }
   if (depth > MAX_RESOLVE_DEPTH) {
     result.errors.push({
-      message: `Max reference depth exceeded at: ${path55}`,
-      path: path55
+      message: `Max reference depth exceeded at: ${path58}`,
+      path: path58
     });
     return void 0;
   }
-  if (visited.has(path55)) {
+  if (visited.has(path58)) {
     result.errors.push({
-      message: `Circular reference detected: ${path55}`,
-      path: path55
+      message: `Circular reference detected: ${path58}`,
+      path: path58
     });
     return void 0;
   }
-  const token = allTokens.get(path55);
+  const token = allTokens.get(path58);
   if (!token) {
     return void 0;
   }
   if (typeof token.$value !== "string") {
     const rawValue2 = stringifyTokenValue(token.$value);
-    result.resolved.set(path55, rawValue2);
+    result.resolved.set(path58, rawValue2);
     return rawValue2;
   }
   const rawValue = stringifyTokenValue(token.$value);
   const refs = [...rawValue.matchAll(REF_PATTERN)];
   if (refs.length === 0) {
-    result.resolved.set(path55, rawValue);
+    result.resolved.set(path58, rawValue);
     return rawValue;
   }
-  visited.add(path55);
+  visited.add(path58);
   let resolved = rawValue;
   for (const ref of refs) {
     const refPath = ref[1];
@@ -11519,8 +11658,8 @@ function resolveTokenRef(path55, allTokens, visited, depth, result) {
     const refToken = allTokens.get(refPath);
     if (!refToken) {
       result.errors.push({
-        message: `Unresolved token reference: {${refPath}} at ${path55}`,
-        path: path55
+        message: `Unresolved token reference: {${refPath}} at ${path58}`,
+        path: path58
       });
       continue;
     }
@@ -11529,7 +11668,7 @@ function resolveTokenRef(path55, allTokens, visited, depth, result) {
       resolved = resolved.split(`{${refPath}}`).join(refValue);
     }
   }
-  result.resolved.set(path55, resolved);
+  result.resolved.set(path58, resolved);
   return resolved;
 }
 function stringifyTokenValue(value) {
@@ -11584,8 +11723,8 @@ var VALID_TYPES = [
 var VALID_PLATFORMS = ["web", "windows", "mobile-ios", "mobile-android", "cross-platform"];
 async function validateDesignToken(root, config) {
   const configuredDir = config.uiux?.designTokensDir;
-  const designDir = configuredDir ? path39.resolve(root, configuredDir) : path39.join(root, config.paths.contractsDir, "design");
-  const pattern = path39.posix.join(designDir.replace(/\\/g, "/"), "design-tokens*.yaml");
+  const designDir = configuredDir ? path40.resolve(root, configuredDir) : path40.join(root, config.paths.contractsDir, "design");
+  const pattern = path40.posix.join(designDir.replace(/\\/g, "/"), "design-tokens*.yaml");
   const files = await fg2(pattern, {
     absolute: true,
     ignore: ["**/*.schema.yaml", "**/*.schema.yml"]
@@ -11595,11 +11734,11 @@ async function validateDesignToken(root, config) {
   }
   const issues = [];
   for (const filePath of files) {
-    const rel = path39.relative(root, filePath).replace(/\\/g, "/");
+    const rel = path40.relative(root, filePath).replace(/\\/g, "/");
     let hasRootObjectError = false;
     let content;
     try {
-      content = await readFile28(filePath, "utf-8");
+      content = await readFile29(filePath, "utf-8");
     } catch {
       issues.push(
         issue(
@@ -11613,7 +11752,7 @@ async function validateDesignToken(root, config) {
       continue;
     }
     try {
-      const parsed = parseYaml6(content);
+      const parsed = parseYaml7(content);
       if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
         hasRootObjectError = true;
         issues.push(
@@ -11762,8 +11901,8 @@ function normalizePlatform(value) {
 }
 
 // src/core/validators/htmlMock.ts
-import { readFile as readFile29 } from "fs/promises";
-import path40 from "path";
+import { readFile as readFile30 } from "fs/promises";
+import path41 from "path";
 import fg3 from "fast-glob";
 
 // src/core/uiux/contrastRatio.ts
@@ -12143,19 +12282,19 @@ async function validateHtmlMock(root, platform, config) {
   const startTime = performance.now();
   const budget = config.uiux?.htmlMockTimeout ?? 2e3;
   const patterns = [
-    path40.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md"),
-    path40.posix.join(root.replace(/\\/g, "/"), config.paths.specsDir, "**/*.md")
+    path41.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md"),
+    path41.posix.join(root.replace(/\\/g, "/"), config.paths.specsDir, "**/*.md")
   ];
   const files = await fg3(patterns, { absolute: true });
   const mockBlocks = [];
   for (const filePath of files) {
     let content;
     try {
-      content = await readFile29(filePath, "utf-8");
+      content = await readFile30(filePath, "utf-8");
     } catch {
       continue;
     }
-    const rel = path40.relative(root, filePath).replace(/\\/g, "/");
+    const rel = path41.relative(root, filePath).replace(/\\/g, "/");
     for (const block of collectHtmlMockBlocks(content)) {
       mockBlocks.push({ file: rel, html: block.html, rawBlock: block.rawBlock });
     }
@@ -12321,8 +12460,8 @@ async function validateHtmlMock(root, platform, config) {
 }
 
 // src/core/validators/mermaidScreenFlow.ts
-import { readFile as readFile30 } from "fs/promises";
-import path41 from "path";
+import { readFile as readFile31 } from "fs/promises";
+import path42 from "path";
 import fg4 from "fast-glob";
 
 // src/core/validators/mermaidUtils.ts
@@ -12373,18 +12512,18 @@ var FLOWCHART_RE = /^\s*flowchart\s+(TD|LR|TB|RL|BT)\b/;
 async function validateMermaidScreenFlow(root, config) {
   const issues = [];
   const patterns = [
-    path41.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md"),
-    path41.posix.join(root.replace(/\\/g, "/"), config.paths.specsDir, "**/*.md")
+    path42.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md"),
+    path42.posix.join(root.replace(/\\/g, "/"), config.paths.specsDir, "**/*.md")
   ];
   const files = await fg4(patterns, { absolute: true });
   for (const filePath of files) {
     let content;
     try {
-      content = await readFile30(filePath, "utf-8");
+      content = await readFile31(filePath, "utf-8");
     } catch {
       continue;
     }
-    const rel = path41.relative(root, filePath).replace(/\\/g, "/");
+    const rel = path42.relative(root, filePath).replace(/\\/g, "/");
     const blocks = extractFencedCodeBlocks(content);
     for (const block of blocks) {
       if (block.language !== "mermaid") continue;
@@ -12482,10 +12621,10 @@ function parseTransitions(content) {
 }
 
 // src/core/validators/bpApDb.ts
-import { readFile as readFile31 } from "fs/promises";
-import path42 from "path";
+import { readFile as readFile32 } from "fs/promises";
+import path43 from "path";
 import fg5 from "fast-glob";
-import { parse as parseYaml7 } from "yaml";
+import { parse as parseYaml8 } from "yaml";
 var BP_ID_RE = /^BP-\d{4}$/;
 var AP_ID_RE = /^AP-\d{4}$/;
 var VALID_SEVERITIES = ["critical", "major", "minor"];
@@ -12520,9 +12659,9 @@ var AP_REQUIRED_FIELDS = [
 ];
 async function validateBpApDb(root, config) {
   const issues = [];
-  const designDir = path42.join(root, config.paths.contractsDir, "design");
-  const bpPattern = path42.posix.join(designDir.replace(/\\/g, "/"), "best-practices*.yaml");
-  const apPattern = path42.posix.join(designDir.replace(/\\/g, "/"), "anti-patterns*.yaml");
+  const designDir = path43.join(root, config.paths.contractsDir, "design");
+  const bpPattern = path43.posix.join(designDir.replace(/\\/g, "/"), "best-practices*.yaml");
+  const apPattern = path43.posix.join(designDir.replace(/\\/g, "/"), "anti-patterns*.yaml");
   const globOptions = {
     absolute: true,
     ignore: ["**/*.schema.yaml", "**/*.schema.yml"]
@@ -12535,14 +12674,14 @@ async function validateBpApDb(root, config) {
   const seenBpIds = /* @__PURE__ */ new Set();
   const seenApIds = /* @__PURE__ */ new Set();
   for (const filePath of bpFiles) {
-    const rel = path42.relative(root, filePath).replace(/\\/g, "/");
+    const rel = path43.relative(root, filePath).replace(/\\/g, "/");
     const entries = await parseRuleFile(filePath, rel, issues);
     for (const entry of entries) {
       validateBpEntry(entry, rel, seenBpIds, issues);
     }
   }
   for (const filePath of apFiles) {
-    const rel = path42.relative(root, filePath).replace(/\\/g, "/");
+    const rel = path43.relative(root, filePath).replace(/\\/g, "/");
     const entries = await parseRuleFile(filePath, rel, issues);
     for (const entry of entries) {
       validateApEntry(entry, rel, seenApIds, issues);
@@ -12553,7 +12692,7 @@ async function validateBpApDb(root, config) {
 async function parseRuleFile(filePath, rel, issues) {
   let content;
   try {
-    content = await readFile31(filePath, "utf-8");
+    content = await readFile32(filePath, "utf-8");
   } catch {
     issues.push(
       issue("QFAI-BPAP-001", `BP/AP file unreadable: ${rel}`, "error", rel, "bpApDb.readFile")
@@ -12562,7 +12701,7 @@ async function parseRuleFile(filePath, rel, issues) {
   }
   let parsed;
   try {
-    parsed = parseYaml7(content);
+    parsed = parseYaml8(content);
   } catch (error) {
     issues.push(
       issue(
@@ -12717,8 +12856,8 @@ function toSafeString(value) {
 }
 
 // src/core/validators/platformDetection.ts
-import { readFile as readFile32 } from "fs/promises";
-import path43 from "path";
+import { readFile as readFile33 } from "fs/promises";
+import path44 from "path";
 var KNOWN_PLATFORMS = ["web", "windows", "mobile-ios", "mobile-android", "cross-platform"];
 async function detectPlatform(root, config, cliPlatform) {
   const issues = [];
@@ -12761,13 +12900,13 @@ async function detectPlatform(root, config, cliPlatform) {
   return { platform: "web", source: "fallback", issues };
 }
 async function inferPlatform(root, issues) {
-  if (await exists5(path43.join(root, "pubspec.yaml"))) {
-    const hasAndroid = await exists5(path43.join(root, "android"));
-    const hasIos = await exists5(path43.join(root, "ios"));
-    const hasWeb = await exists5(path43.join(root, "web"));
-    const hasWindows = await exists5(path43.join(root, "windows"));
-    const hasMacos = await exists5(path43.join(root, "macos"));
-    const hasLinux = await exists5(path43.join(root, "linux"));
+  if (await exists5(path44.join(root, "pubspec.yaml"))) {
+    const hasAndroid = await exists5(path44.join(root, "android"));
+    const hasIos = await exists5(path44.join(root, "ios"));
+    const hasWeb = await exists5(path44.join(root, "web"));
+    const hasWindows = await exists5(path44.join(root, "windows"));
+    const hasMacos = await exists5(path44.join(root, "macos"));
+    const hasLinux = await exists5(path44.join(root, "linux"));
     const mobileTargets = [hasAndroid, hasIos].filter(Boolean).length;
     const desktopTargets = [hasWeb, hasWindows, hasMacos, hasLinux].filter(Boolean).length;
     if (mobileTargets + desktopTargets > 1) {
@@ -12787,10 +12926,10 @@ async function inferPlatform(root, issues) {
     }
     return null;
   }
-  const pkgJsonPath = path43.join(root, "package.json");
+  const pkgJsonPath = path44.join(root, "package.json");
   if (await exists5(pkgJsonPath)) {
     try {
-      const raw = await readFile32(pkgJsonPath, "utf-8");
+      const raw = await readFile33(pkgJsonPath, "utf-8");
       const pkg = JSON.parse(raw);
       const deps = {
         ...typeof pkg.dependencies === "object" && pkg.dependencies !== null ? pkg.dependencies : {},
@@ -12809,8 +12948,8 @@ async function inferPlatform(root, issues) {
         return "cross-platform";
       }
       if ("react-native" in deps) {
-        const hasAndroid = await exists5(path43.join(root, "android"));
-        const hasIos = await exists5(path43.join(root, "ios"));
+        const hasAndroid = await exists5(path44.join(root, "android"));
+        const hasIos = await exists5(path44.join(root, "ios"));
         if (hasAndroid && hasIos) {
           return "cross-platform";
         }
@@ -12832,15 +12971,15 @@ function normalizePlatformInput(platform) {
 }
 
 // src/core/validators/uiDefinitionConsistency.ts
-import { readFile as readFile33 } from "fs/promises";
-import path44 from "path";
+import { readFile as readFile34 } from "fs/promises";
+import path45 from "path";
 import fg6 from "fast-glob";
-import { parse as parseYaml8 } from "yaml";
+import { parse as parseYaml9 } from "yaml";
 async function validateUiDefinitionConsistency(root, config) {
   const issues = [];
   const configuredDir = config.uiux?.designTokensDir;
-  const designDir = configuredDir ? path44.resolve(root, configuredDir) : path44.join(root, config.paths.contractsDir, "design");
-  const tokenPattern = path44.posix.join(designDir.replace(/\\/g, "/"), "design-tokens*.yaml");
+  const designDir = configuredDir ? path45.resolve(root, configuredDir) : path45.join(root, config.paths.contractsDir, "design");
+  const tokenPattern = path45.posix.join(designDir.replace(/\\/g, "/"), "design-tokens*.yaml");
   const tokenFiles = await fg6(tokenPattern, {
     absolute: true,
     ignore: ["**/*.schema.yaml", "**/*.schema.yml"]
@@ -12848,7 +12987,7 @@ async function validateUiDefinitionConsistency(root, config) {
   const resolvedTokens = /* @__PURE__ */ new Map();
   for (const tokenFile of tokenFiles) {
     try {
-      const content = await readFile33(tokenFile, "utf-8");
+      const content = await readFile34(tokenFile, "utf-8");
       const result = parseDesignToken(content);
       for (const [key, val] of result.resolved) {
         resolvedTokens.set(key, val);
@@ -12856,14 +12995,14 @@ async function validateUiDefinitionConsistency(root, config) {
     } catch {
     }
   }
-  const uiContractDir = path44.join(root, config.paths.contractsDir, "ui");
-  const uiPattern = path44.posix.join(uiContractDir.replace(/\\/g, "/"), "**/*.yaml");
+  const uiContractDir = path45.join(root, config.paths.contractsDir, "ui");
+  const uiPattern = path45.posix.join(uiContractDir.replace(/\\/g, "/"), "**/*.yaml");
   const uiFiles = await fg6(uiPattern, { absolute: true });
   const contractScreenIds = /* @__PURE__ */ new Set();
   for (const uiFile of uiFiles) {
     try {
-      const content = await readFile33(uiFile, "utf-8");
-      const parsed = parseYaml8(content);
+      const content = await readFile34(uiFile, "utf-8");
+      const parsed = parseYaml9(content);
       if (parsed && typeof parsed === "object") {
         const screens = parsed.screens;
         if (Array.isArray(screens)) {
@@ -12878,15 +13017,15 @@ async function validateUiDefinitionConsistency(root, config) {
     }
   }
   const mdPatterns = [
-    path44.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md"),
-    path44.posix.join(root.replace(/\\/g, "/"), config.paths.specsDir, "**/*.md")
+    path45.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md"),
+    path45.posix.join(root.replace(/\\/g, "/"), config.paths.specsDir, "**/*.md")
   ];
   const mdFiles = await fg6(mdPatterns, { absolute: true });
   const mockScreenIds = /* @__PURE__ */ new Set();
   for (const mdFile of mdFiles) {
     try {
-      const content = await readFile33(mdFile, "utf-8");
-      const rel = path44.relative(root, mdFile).replace(/\\/g, "/");
+      const content = await readFile34(mdFile, "utf-8");
+      const rel = path45.relative(root, mdFile).replace(/\\/g, "/");
       const htmlBlocks = collectHtmlMockBlocks(content);
       if (resolvedTokens.size > 0) {
         for (const htmlBlock of htmlBlocks) {
@@ -12943,8 +13082,8 @@ async function validateUiDefinitionConsistency(root, config) {
 }
 
 // src/core/validators/researchSummary.ts
-import { readFile as readFile34 } from "fs/promises";
-import path45 from "path";
+import { readFile as readFile35 } from "fs/promises";
+import path46 from "path";
 import fg7 from "fast-glob";
 var RESEARCH_SUMMARY_HEADING_RE = /^#{1,3}\s+Research\s+Summary/im;
 var SOURCE_ENTRY_RE = /^\s*-\s*id:\s*(\S+)/gm;
@@ -12952,17 +13091,17 @@ var REFLECTION_APPLY_RE = /action:\s*apply/i;
 var FULL_DATE_RE = /^\s+published:\s*["']?(\d{4}-\d{2}-\d{2})["']?/m;
 async function validateResearchSummary(root, config) {
   const issues = [];
-  const pattern = path45.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md");
+  const pattern = path46.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md");
   const files = await fg7(pattern, { absolute: true });
   for (const filePath of files) {
     let content;
     try {
-      content = await readFile34(filePath, "utf-8");
+      content = await readFile35(filePath, "utf-8");
     } catch {
       continue;
     }
     if (!RESEARCH_SUMMARY_HEADING_RE.test(content)) continue;
-    const rel = path45.relative(root, filePath).replace(/\\/g, "/");
+    const rel = path46.relative(root, filePath).replace(/\\/g, "/");
     const section = extractResearchSummarySection(content);
     if (!section) continue;
     const sourceEntries = extractSourceEntries(section);
@@ -13193,9 +13332,9 @@ function resolveFreshnessReferenceNow() {
 }
 
 // src/core/validators/agentDefinition.ts
-import { readFile as readFile35 } from "fs/promises";
-import path46 from "path";
-import { parse as parseYaml9 } from "yaml";
+import { readFile as readFile36 } from "fs/promises";
+import path47 from "path";
+import { parse as parseYaml10 } from "yaml";
 var REQUIRED_AGENTS = [
   "uiux-expert.md",
   "design-expert.md",
@@ -13214,13 +13353,13 @@ var REQUIRED_SECTIONS = [
 var REQUIRED_PHASES = ["discussion", "SDD", "prototyping", "ATDD"];
 async function validateAgentDefinition(root, _config) {
   const issues = [];
-  const agentsDir = path46.join(root, ".qfai", "assistant", "agents");
+  const agentsDir = path47.join(root, ".qfai", "assistant", "agents");
   if (!await exists5(agentsDir)) {
     return [];
   }
   let anyAgentExists = false;
   for (const agentFile of REQUIRED_AGENTS) {
-    if (await exists5(path46.join(agentsDir, agentFile))) {
+    if (await exists5(path47.join(agentsDir, agentFile))) {
       anyAgentExists = true;
       break;
     }
@@ -13229,7 +13368,7 @@ async function validateAgentDefinition(root, _config) {
     return [];
   }
   for (const agentFile of REQUIRED_AGENTS) {
-    const filePath = path46.join(agentsDir, agentFile);
+    const filePath = path47.join(agentsDir, agentFile);
     const rel = `.qfai/assistant/agents/${agentFile}`;
     if (!await exists5(filePath)) {
       issues.push(
@@ -13245,7 +13384,7 @@ async function validateAgentDefinition(root, _config) {
     }
     let content;
     try {
-      content = await readFile35(filePath, "utf-8");
+      content = await readFile36(filePath, "utf-8");
     } catch {
       issues.push(
         issue(
@@ -13351,11 +13490,11 @@ async function validateAgentDefinition(root, _config) {
       }
     }
   }
-  const rosterPath = path46.join(root, ".qfai", "assistant", "steering", "review-roster.yml");
+  const rosterPath = path47.join(root, ".qfai", "assistant", "steering", "review-roster.yml");
   if (await exists5(rosterPath)) {
     try {
-      const rosterContent = await readFile35(rosterPath, "utf-8");
-      const roster = parseYaml9(rosterContent);
+      const rosterContent = await readFile36(rosterPath, "utf-8");
+      const roster = parseYaml10(rosterContent);
       if (roster && typeof roster === "object") {
         const rosterObj = roster;
         const entries = Array.isArray(rosterObj.roster) ? rosterObj.roster : [];
@@ -13399,8 +13538,8 @@ function extractPhaseBody(phaseSection, phaseName) {
 }
 
 // src/core/validators/tddList.ts
-import { readFile as readFile36, stat as stat7 } from "fs/promises";
-import path47 from "path";
+import { readFile as readFile37, stat as stat7 } from "fs/promises";
+import path48 from "path";
 var REQUIRED_COLUMNS = [
   "TDD-ID",
   "TC-Refs",
@@ -13414,7 +13553,7 @@ var REQUIRED_COLUMNS = [
 var VALID_STATUSES = /* @__PURE__ */ new Set(["todo", "red", "green", "refactor", "done", "exception"]);
 var TEST_FILE_CHECK_STATUSES = /* @__PURE__ */ new Set(["green", "refactor", "done"]);
 var TDD_ID_FORMAT = /^TDD-\d{4}$/;
-var TDD_LIST_REL_PATH = path47.join("tdd", "test-list.md");
+var TDD_LIST_REL_PATH = path48.join("tdd", "test-list.md");
 async function validateTddList(root, config) {
   const specsRoot = resolvePath(root, config, "specsDir");
   const entries = await collectSpecEntries(specsRoot);
@@ -13426,8 +13565,8 @@ async function validateTddList(root, config) {
   return issues;
 }
 async function validateSpecTddList(root, specDir, specNumber) {
-  const filePath = path47.join(specDir, TDD_LIST_REL_PATH);
-  const relPath = path47.relative(root, filePath).replace(/\\/g, "/");
+  const filePath = path48.join(specDir, TDD_LIST_REL_PATH);
+  const relPath = path48.relative(root, filePath).replace(/\\/g, "/");
   const issues = [];
   if (!await exists5(filePath)) {
     issues.push(
@@ -13614,9 +13753,9 @@ async function validateSpecTddList(root, specDir, specNumber) {
         continue;
       }
       const normalized = testFile.replace(/\\/g, "/");
-      const resolved = path47.resolve(root, normalized);
-      const relative = path47.relative(root, resolved);
-      if (path47.isAbsolute(normalized) || path47.win32.isAbsolute(normalized) || relative === ".." || relative.startsWith(".." + path47.sep)) {
+      const resolved = path48.resolve(root, normalized);
+      const relative = path48.relative(root, resolved);
+      if (path48.isAbsolute(normalized) || path48.win32.isAbsolute(normalized) || relative === ".." || relative.startsWith(".." + path48.sep)) {
         issues.push(
           issue(
             "TDDLIST_TEST_FILE_MISSING",
@@ -13679,11 +13818,11 @@ async function validateSpecTddList(root, specDir, specNumber) {
 }
 async function collectTestCaseIds(specDir) {
   const empty = { knownTcIds: /* @__PURE__ */ new Set(), unitComponentTcIds: /* @__PURE__ */ new Set() };
-  const testCasesPath = path47.join(specDir, "06_Test-Cases.md");
+  const testCasesPath = path48.join(specDir, "06_Test-Cases.md");
   if (!await exists5(testCasesPath)) return empty;
   let content;
   try {
-    content = await readFile36(testCasesPath, "utf-8");
+    content = await readFile37(testCasesPath, "utf-8");
   } catch {
     return empty;
   }
@@ -13709,8 +13848,8 @@ async function collectTestCaseIds(specDir) {
 }
 
 // src/core/validators/ddpValidation.ts
-import { readFile as readFile37 } from "fs/promises";
-import path48 from "path";
+import { readFile as readFile38 } from "fs/promises";
+import path49 from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import fg8 from "fast-glob";
 var DDP_HEADING_RE = /^#{1,3}\s+Design\s+Direction\s+Pack/im;
@@ -13728,9 +13867,9 @@ var _bannedPatterns = null;
 async function loadBannedPatterns() {
   if (_bannedPatterns !== null) return _bannedPatterns;
   try {
-    const thisDir = path48.dirname(fileURLToPath3(import.meta.url));
-    const filePath = path48.join(thisDir, "ddpBannedPatterns.txt");
-    const content = await readFile37(filePath, "utf-8");
+    const thisDir = path49.dirname(fileURLToPath3(import.meta.url));
+    const filePath = path49.join(thisDir, "ddpBannedPatterns.txt");
+    const content = await readFile38(filePath, "utf-8");
     _bannedPatterns = content.split(/\r?\n/).map((l) => l.trim()).filter((l) => l.length > 0 && !l.startsWith("#"));
   } catch {
     _bannedPatterns = [];
@@ -13739,15 +13878,15 @@ async function loadBannedPatterns() {
 }
 async function validateDdpFields(root, config) {
   const issues = [];
-  const pattern = path48.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md");
+  const pattern = path49.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md");
   const files = await fg8(pattern, { absolute: true });
   let ddpFound = false;
   let isUiBearing2 = false;
   for (const filePath of files) {
-    const basename = path48.basename(filePath);
+    const basename = path49.basename(filePath);
     if (basename === "03_Story-Workshop.md") {
       try {
-        const storyContent = await readFile37(filePath, "utf-8");
+        const storyContent = await readFile38(filePath, "utf-8");
         if (UI_BEARING_KEYWORDS_RE.test(storyContent)) {
           isUiBearing2 = true;
         }
@@ -13758,13 +13897,13 @@ async function validateDdpFields(root, config) {
   for (const filePath of files) {
     let content;
     try {
-      content = await readFile37(filePath, "utf-8");
+      content = await readFile38(filePath, "utf-8");
     } catch {
       continue;
     }
     if (!DDP_HEADING_RE.test(content)) continue;
     ddpFound = true;
-    const rel = path48.relative(root, filePath).replace(/\\/g, "/");
+    const rel = path49.relative(root, filePath).replace(/\\/g, "/");
     const section = extractDdpSection(content);
     if (!section) continue;
     for (const field of DDP_REQUIRED_FIELDS) {
@@ -13957,7 +14096,7 @@ var ANTI_PATTERN_CHECKS = [
 ];
 async function validateResearchTraceability(root, config, issues) {
   const requireResearchSummary = config.uiux?.requireResearchSummary === true;
-  const discussionPattern = path48.posix.join(
+  const discussionPattern = path49.posix.join(
     root.replace(/\\/g, "/"),
     config.paths.discussionDir,
     "**/*.md"
@@ -13966,7 +14105,7 @@ async function validateResearchTraceability(root, config, issues) {
   let hasResearchSummary = false;
   for (const filePath of discussionFiles) {
     try {
-      const content = await readFile37(filePath, "utf-8");
+      const content = await readFile38(filePath, "utf-8");
       if (/research_summary\s*:/m.test(content)) {
         hasResearchSummary = true;
         break;
@@ -13985,7 +14124,7 @@ async function validateResearchTraceability(root, config, issues) {
       )
     );
   }
-  const contractPattern = path48.posix.join(
+  const contractPattern = path49.posix.join(
     root.replace(/\\/g, "/"),
     config.paths.contractsDir,
     "design",
@@ -13995,11 +14134,11 @@ async function validateResearchTraceability(root, config, issues) {
   for (const filePath of contractFiles) {
     let content;
     try {
-      content = await readFile37(filePath, "utf-8");
+      content = await readFile38(filePath, "utf-8");
     } catch {
       continue;
     }
-    const rel = path48.relative(root, filePath).replace(/\\/g, "/");
+    const rel = path49.relative(root, filePath).replace(/\\/g, "/");
     const ruleBlocks = content.split(/(?=^-\s+(?:rule|id)\s*:)/m).filter((b) => b.trim());
     for (const block of ruleBlocks) {
       const idMatch = /(?:^|\n)\s*(?:-\s+)?id\s*:\s*(\S+)/m.exec(block);
@@ -14022,11 +14161,11 @@ async function validateStoryWorkshopTemplates(root, config, issues, discussionFi
   for (const filePath of discussionFiles) {
     let content;
     try {
-      content = await readFile37(filePath, "utf-8");
+      content = await readFile38(filePath, "utf-8");
     } catch {
       continue;
     }
-    const rel = path48.relative(root, filePath).replace(/\\/g, "/");
+    const rel = path49.relative(root, filePath).replace(/\\/g, "/");
     if (/screen_type\s*:\s*list/im.test(content)) {
       for (const field of LIST_TEMPLATE_REQUIRED_FIELDS) {
         if (!hasNonEmptyField(content, field)) {
@@ -14126,7 +14265,7 @@ function validateQualityProfile(config, issues) {
   }
 }
 async function validateOptionComparison(root, config, issues) {
-  const contractPattern = path48.posix.join(
+  const contractPattern = path49.posix.join(
     root.replace(/\\/g, "/"),
     config.paths.contractsDir,
     "design",
@@ -14136,11 +14275,11 @@ async function validateOptionComparison(root, config, issues) {
   for (const filePath of contractFiles) {
     let content;
     try {
-      content = await readFile37(filePath, "utf-8");
+      content = await readFile38(filePath, "utf-8");
     } catch {
       continue;
     }
-    const rel = path48.relative(root, filePath).replace(/\\/g, "/");
+    const rel = path49.relative(root, filePath).replace(/\\/g, "/");
     const optionMatches = content.match(/(?:^|\n)\s*-\s+option\s*:/gm) ?? [];
     const numberedOptions = content.match(/(?:^|\n)\s*option_\d+\s*:/gm) ?? [];
     const totalOptions = optionMatches.length + numberedOptions.length;
@@ -14175,7 +14314,7 @@ async function validateOptionComparison(root, config, issues) {
 }
 async function validateCompetitiveRefs(root, config, issues) {
   const minRefs = config.uiux?.competitive_refs_min ?? 3;
-  const contractPattern = path48.posix.join(
+  const contractPattern = path49.posix.join(
     root.replace(/\\/g, "/"),
     config.paths.contractsDir,
     "design",
@@ -14185,11 +14324,11 @@ async function validateCompetitiveRefs(root, config, issues) {
   for (const filePath of contractFiles) {
     let content;
     try {
-      content = await readFile37(filePath, "utf-8");
+      content = await readFile38(filePath, "utf-8");
     } catch {
       continue;
     }
-    const rel = path48.relative(root, filePath).replace(/\\/g, "/");
+    const rel = path49.relative(root, filePath).replace(/\\/g, "/");
     const refsBlock = extractNestedBlock(content, "competitive_refs");
     if (refsBlock !== null) {
       const refItems = refsBlock.split(/\n/).filter((l) => /^\s*-\s/.test(l));
@@ -14339,7 +14478,7 @@ function collectListItems(section, field) {
 }
 
 // src/core/validators/navigationFlow.ts
-import { readFile as readFile38 } from "fs/promises";
+import { readFile as readFile39 } from "fs/promises";
 var NODE_DEF_RE = /([A-Za-z_][\w-]*)\s*(?:\[.*?\]|\(.*?\)|\{.*?\})/g;
 var EDGE_RE = /([A-Za-z_][\w-]*)(?:\s*(?:\[[^\]]*\]|\([^)]*\)|\{[^}]*\}))?(?:::\w+)?\s*(?:--+>|==+>|-.->|~~>)\s*(?:\|"?([^"|]*)"?\|)?\s*([A-Za-z_][\w-]*)(?:\s*(?:\[[^\]]*\]|\([^)]*\)|\{[^}]*\}))?(?:::\w+)?/g;
 var SUBGRAPH_RE = /^\s*subgraph\s+([\w-]+)/gm;
@@ -14618,7 +14757,7 @@ async function validateNavigationFlow(root, config) {
   const specFiles = allFiles.filter((f) => /[\\/]spec-\d{4}[\\/]/.test(f));
   const issues = [];
   for (const file of specFiles) {
-    const content = await readFile38(file, "utf-8");
+    const content = await readFile39(file, "utf-8");
     const blocks = extractFencedCodeBlocks(content);
     const mermaidBlocks = blocks.filter((b) => b.language === "mermaid");
     const _flowchartBlocks = mermaidBlocks.filter((b) => hasFlowchartDeclaration(b.content));
@@ -14640,8 +14779,8 @@ async function validateNavigationFlow(root, config) {
 }
 
 // src/core/validators/renderCritique.ts
-import path49 from "path";
-import { readFile as readFile39 } from "fs/promises";
+import path50 from "path";
+import { readFile as readFile40 } from "fs/promises";
 import fg9 from "fast-glob";
 var RENDERED_KEYWORDS_RE = /\b(rendered|screenshot|html\b|preview|visual\s*review)/i;
 var DDP_REFERENCE_RE = /\b(ddp|design\s*direction\s*pack)\b/i;
@@ -14660,8 +14799,8 @@ var FOUR_STATE_CHECK_RE = /\bfour_state_check\s*:/i;
 var MAX_PRIMARY_STEPS_RE = /\bmax_primary_steps\s*:\s*(\d+)/i;
 async function validateRenderCritique(root, config) {
   const issues = [];
-  const discussionDir = path49.join(root, config.paths.discussionDir).replace(/\\/g, "/");
-  const discussionFiles = await fg9(path49.posix.join(discussionDir, "**/*.md"), { absolute: true });
+  const discussionDir = path50.join(root, config.paths.discussionDir).replace(/\\/g, "/");
+  const discussionFiles = await fg9(path50.posix.join(discussionDir, "**/*.md"), { absolute: true });
   let hasDdp = false;
   for (const df of discussionFiles) {
     const content = await readSafe(df);
@@ -14671,12 +14810,12 @@ async function validateRenderCritique(root, config) {
     }
   }
   if (!hasDdp) return issues;
-  const skillsDir = path49.join(root, config.paths.skillsDir).replace(/\\/g, "/");
-  const evidenceDir = path49.join(root, ".qfai", "evidence").replace(/\\/g, "/");
+  const skillsDir = path50.join(root, config.paths.skillsDir).replace(/\\/g, "/");
+  const evidenceDir = path50.join(root, ".qfai", "evidence").replace(/\\/g, "/");
   const renderEvidenceViewports = await collectRenderEvidenceViewports(root);
-  const skillPromptPattern = path49.posix.join(skillsDir, "qfai-{prototyping,implement}*/SKILL.md");
+  const skillPromptPattern = path50.posix.join(skillsDir, "qfai-{prototyping,implement}*/SKILL.md");
   const skillFiles = await fg9(skillPromptPattern, { dot: true });
-  const evidencePattern = path49.posix.join(evidenceDir, "{prototyping*,critique-*}.md");
+  const evidencePattern = path50.posix.join(evidenceDir, "{prototyping*,critique-*}.md");
   const evidenceFiles = await fg9(evidencePattern, { dot: true });
   for (const sf of skillFiles) {
     const content = await readSafe(sf);
@@ -14684,7 +14823,7 @@ async function validateRenderCritique(root, config) {
       issues.push(
         issue(
           "QFAI-CRIT-001",
-          `Skill prompt does not mention rendered/screenshot/HTML review: ${path49.relative(root, sf)}`,
+          `Skill prompt does not mention rendered/screenshot/HTML review: ${path50.relative(root, sf)}`,
           "error",
           sf,
           "renderCritique.codeOnly",
@@ -14701,7 +14840,7 @@ async function validateRenderCritique(root, config) {
       issues.push(
         issue(
           "QFAI-CRIT-002",
-          `Downstream skill prompt missing DDP reference: ${path49.relative(root, sf)}`,
+          `Downstream skill prompt missing DDP reference: ${path50.relative(root, sf)}`,
           "error",
           sf,
           "renderCritique.ddpMissing",
@@ -14747,7 +14886,7 @@ async function validateRenderCritique(root, config) {
       issues.push(
         issue(
           "QFAI-CRIT-005",
-          `Read order not specified (DDP \u2192 Design Token \u2192 UI Contract \u2192 HTML Mock \u2192 Flow): ${path49.relative(root, sf)}`,
+          `Read order not specified (DDP \u2192 Design Token \u2192 UI Contract \u2192 HTML Mock \u2192 Flow): ${path50.relative(root, sf)}`,
           "error",
           sf,
           "renderCritique.readOrder",
@@ -14774,7 +14913,7 @@ async function validateRenderCritique(root, config) {
       issues.push(
         issue(
           "QFAI-CRIT-006",
-          `Critique evidence incomplete (missing: ${missing.join(", ")}): ${path49.relative(root, ef)}`,
+          `Critique evidence incomplete (missing: ${missing.join(", ")}): ${path50.relative(root, ef)}`,
           "error",
           ef,
           "renderCritique.incompleteEvidence",
@@ -14889,9 +15028,9 @@ async function collectContent(files) {
   return contents.join("\n---\n");
 }
 async function collectRenderEvidenceViewports(root) {
-  const prototypingJsonPath = path49.join(root, ".qfai", "evidence", "prototyping.json");
+  const prototypingJsonPath = path50.join(root, ".qfai", "evidence", "prototyping.json");
   try {
-    const raw = await readFile39(prototypingJsonPath, "utf-8");
+    const raw = await readFile40(prototypingJsonPath, "utf-8");
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
       return /* @__PURE__ */ new Set();
@@ -14930,8 +15069,8 @@ async function collectRenderEvidenceViewports(root) {
 }
 
 // src/core/validators/designFidelity.ts
-import { readFile as readFile40 } from "fs/promises";
-import path50 from "path";
+import { readFile as readFile41 } from "fs/promises";
+import path51 from "path";
 import fg10 from "fast-glob";
 var SCORECARD_HEADING_RE = /^#{1,3}\s+Fidelity\s+Scorecard/im;
 var BASE_DIMENSIONS = ["hierarchy", "clarity", "accessibility", "responsive"];
@@ -14956,19 +15095,19 @@ async function validateDesignFidelity(root, config) {
   const evidenceDirs = [".qfai/evidence", ".qfai/review"];
   const allFiles = [];
   for (const dir of evidenceDirs) {
-    const pattern = path50.posix.join(root.replace(/\\/g, "/"), dir, "**/*.md");
+    const pattern = path51.posix.join(root.replace(/\\/g, "/"), dir, "**/*.md");
     const files = await fg10(pattern, { absolute: true });
     allFiles.push(...files);
   }
   for (const filePath of allFiles) {
     let content;
     try {
-      content = await readFile40(filePath, "utf-8");
+      content = await readFile41(filePath, "utf-8");
     } catch {
       continue;
     }
     if (!SCORECARD_HEADING_RE.test(content)) continue;
-    const rel = path50.relative(root, filePath).replace(/\\/g, "/");
+    const rel = path51.relative(root, filePath).replace(/\\/g, "/");
     const section = extractScorecardSection(content);
     if (!section) continue;
     const dimensions = parseDimensions(section);
@@ -15260,7 +15399,7 @@ function hasAntiPatternMention(section, code) {
 }
 
 // src/core/validators/discussionDesignHardening.ts
-import path51 from "path";
+import path52 from "path";
 var HTML_TAG_RE = /<(?:style|div|section|span|button|input|form|header|footer|nav|main|aside)\b/i;
 var MERMAID_SCREEN_FLOW_RE = /```mermaid[\s\S]*?(?:stateDiagram|flowchart|graph)[\s\S]*?(?:Screen|Page|View|Dashboard|Login|Settings|Home)\b/i;
 var DDS_HEADING = "## Design Direction Summary";
@@ -15275,10 +15414,17 @@ var DDS_SUBSECTIONS = [
 var REQUIRED_STATES = ["empty", "loading", "error", "populated"];
 var COMPETITIVE_REF_FIELDS = ["adopted_points", "rejected_points", "local_translation"];
 var PLACEHOLDER_RE = /^(?:tbd|todo|n\/a|na|xxx|\?\?\?|placeholder)$/i;
+var SURFACE_TYPE_RE = /\|\s*Surface Type\s*\|\s*(\S+)\s*\|/i;
 async function isUiBearing(packRoot) {
-  const storyPath = path51.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = path52.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   if (!content) return false;
+  const surfaceMatch = SURFACE_TYPE_RE.exec(content);
+  if (surfaceMatch?.[1]) {
+    const surface = surfaceMatch[1].toLowerCase();
+    if (surface === "non-ui") return false;
+    if (["web-ui", "mobile-ui", "desktop-ui", "mixed"].includes(surface)) return true;
+  }
   if (HTML_TAG_RE.test(content)) return true;
   if (MERMAID_SCREEN_FLOW_RE.test(content)) return true;
   return false;
@@ -15313,7 +15459,7 @@ function extractOptionNames(optionSection) {
 }
 async function validateDdsPresence(packRoot) {
   const issues = [];
-  const storyPath = path51.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = path52.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   const relPath = "03_Story-Workshop.md";
   if (!content || !content.includes(DDS_HEADING)) {
@@ -15347,7 +15493,7 @@ async function validateDdsPresence(packRoot) {
 }
 async function validateOptionComparison2(packRoot) {
   const issues = [];
-  const storyPath = path51.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = path52.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   if (!content) return issues;
   const dds = extractDdsSection(content);
@@ -15371,7 +15517,7 @@ async function validateOptionComparison2(packRoot) {
 }
 async function validateAnchorScreen(packRoot) {
   const issues = [];
-  const storyPath = path51.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = path52.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   if (!content) return issues;
   const dds = extractDdsSection(content);
@@ -15413,7 +15559,7 @@ async function validateAnchorScreen(packRoot) {
 }
 async function validateCompetitiveRefs2(packRoot) {
   const issues = [];
-  const sourcesPath = path51.join(packRoot, "04_Sources.md");
+  const sourcesPath = path52.join(packRoot, "04_Sources.md");
   const content = await readSafe(sourcesPath);
   if (!content) return issues;
   const registryHeadingRe = /^##\s+Competitive Reference Registry\b.*$/m;
@@ -15470,7 +15616,7 @@ function fieldGuidance(field) {
 }
 async function validateCtaHierarchy(packRoot) {
   const issues = [];
-  const storyPath = path51.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = path52.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   if (!content) return issues;
   const dds = extractDdsSection(content);
@@ -15508,7 +15654,7 @@ async function validateCtaHierarchy(packRoot) {
 }
 async function validateStateCoverage(packRoot) {
   const issues = [];
-  const storyPath = path51.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = path52.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   if (!content) return issues;
   const dds = extractDdsSection(content);
@@ -15533,7 +15679,7 @@ async function validateStateCoverage(packRoot) {
 }
 async function validateDesignAntiGoals(packRoot) {
   const issues = [];
-  const storyPath = path51.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = path52.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   if (!content) return issues;
   const dds = extractDdsSection(content);
@@ -15570,7 +15716,7 @@ async function validateDesignAntiGoals(packRoot) {
   return issues;
 }
 async function validateDiscussionDesignHardening(root, config) {
-  const discussionDir = path51.join(root, config.paths.discussionDir);
+  const discussionDir = path52.join(root, config.paths.discussionDir);
   const packRoot = await findLatestDiscussionPackDir(discussionDir);
   if (!packRoot) return [];
   const uiBearing = await isUiBearing(packRoot);
@@ -15588,7 +15734,7 @@ async function validateDiscussionDesignHardening(root, config) {
 
 // src/core/validators/designAudit.ts
 import { readdir as readdir9 } from "fs/promises";
-import path52 from "path";
+import path53 from "path";
 var COSMETIC_CATEGORIES = ["generic-shell", "stock-imagery", "placeholder-copy"];
 function resolveAuditConfig(config) {
   const audit = config.uiux?.audit;
@@ -15670,7 +15816,7 @@ var RAW_COLOR_RE = /#[0-9a-fA-F]{3,8}\b|rgb\([^)]+\)|rgba\([^)]+\)|hsl\([^)]+\)|
 async function checkTokenDrift(root, auditConfig, cfg) {
   const findings = [];
   const configuredDir = cfg.uiux?.designTokensDir;
-  const tokensDir = configuredDir ? path52.resolve(root, configuredDir) : path52.join(root, cfg.paths.contractsDir, "design");
+  const tokensDir = configuredDir ? path53.resolve(root, configuredDir) : path53.join(root, cfg.paths.contractsDir, "design");
   let hasTokenFiles = false;
   try {
     const entries = await readdir9(tokensDir);
@@ -15679,7 +15825,7 @@ async function checkTokenDrift(root, auditConfig, cfg) {
     return findings;
   }
   if (!hasTokenFiles) return findings;
-  const contractsUiDir = path52.join(root, cfg.paths.contractsDir, "ui");
+  const contractsUiDir = path53.join(root, cfg.paths.contractsDir, "ui");
   let htmlFiles = [];
   try {
     const entries = await readdir9(contractsUiDir);
@@ -15690,7 +15836,7 @@ async function checkTokenDrift(root, auditConfig, cfg) {
   let rawCount = 0;
   const sampleLiterals = [];
   for (const htmlFile of htmlFiles) {
-    const content = await readSafe(path52.join(contractsUiDir, htmlFile));
+    const content = await readSafe(path53.join(contractsUiDir, htmlFile));
     if (!content) continue;
     const matches = content.match(RAW_COLOR_RE);
     if (matches) {
@@ -15741,12 +15887,12 @@ function deduplicateFindings(issues, maxPerRule) {
 async function validateDesignAudit(root, config) {
   const auditConfig = resolveAuditConfig(config);
   if (!auditConfig.enabled) return [];
-  const discussionDir = path52.join(root, config.paths.discussionDir);
+  const discussionDir = path53.join(root, config.paths.discussionDir);
   const packRoot = await findLatestDiscussionPackDir(discussionDir);
   if (!packRoot) return [];
   const uiBearing = await isUiBearing(packRoot);
   if (!uiBearing) return [];
-  const storyPath = path52.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = path53.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   if (!content) return [];
   const findings = [];
@@ -15758,8 +15904,8 @@ async function validateDesignAudit(root, config) {
 
 // src/core/validators/designSlop.ts
 import { existsSync as existsSync2 } from "fs";
-import { readFile as readFile41 } from "fs/promises";
-import path53 from "path";
+import { readFile as readFile42 } from "fs/promises";
+import path54 from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 function isValidSlopPattern(rule) {
   if (typeof rule !== "object" || rule === null) return false;
@@ -15767,7 +15913,7 @@ function isValidSlopPattern(rule) {
   return typeof r.id === "string" && typeof r.category === "string" && typeof r.tier === "number" && Array.isArray(r.scopes) && typeof r.match === "string" && typeof r.message === "string" && typeof r.guidance === "string";
 }
 async function loadSlopPatterns(jsonPath) {
-  const raw = await readFile41(jsonPath, "utf-8");
+  const raw = await readFile42(jsonPath, "utf-8");
   const parsed = JSON.parse(raw);
   if (!Array.isArray(parsed)) return [];
   return parsed.filter((r) => isValidSlopPattern(r));
@@ -15775,11 +15921,11 @@ async function loadSlopPatterns(jsonPath) {
 function defaultPatternsPath() {
   const base = import.meta.url;
   const basePath = base.startsWith("file:") ? fileURLToPath4(base) : base;
-  const baseDir = path53.dirname(basePath);
+  const baseDir = path54.dirname(basePath);
   const candidates = [
-    path53.join(baseDir, "designSlopPatterns.json"),
-    path53.resolve(baseDir, "../../../assets/validators/designSlopPatterns.json"),
-    path53.resolve(baseDir, "../../assets/validators/designSlopPatterns.json")
+    path54.join(baseDir, "designSlopPatterns.json"),
+    path54.resolve(baseDir, "../../../assets/validators/designSlopPatterns.json"),
+    path54.resolve(baseDir, "../../assets/validators/designSlopPatterns.json")
   ];
   for (const c of candidates) {
     if (existsSync2(c)) return c;
@@ -15790,7 +15936,7 @@ async function validateDesignSlop(root, config) {
   const auditConfig = resolveAuditConfig(config);
   if (!auditConfig.enabled) return [];
   if (!auditConfig.slopDetection) return [];
-  const discussionDir = path53.join(root, config.paths.discussionDir);
+  const discussionDir = path54.join(root, config.paths.discussionDir);
   const packRoot = await findLatestDiscussionPackDir(discussionDir);
   if (!packRoot) return [];
   const uiBearing = await isUiBearing(packRoot);
@@ -15811,7 +15957,7 @@ async function validateDesignSlop(root, config) {
       continue;
     }
     for (const scope of pattern.scopes) {
-      const filePath = path53.join(packRoot, scope);
+      const filePath = path54.join(packRoot, scope);
       const content = await readSafe(filePath);
       if (!content) continue;
       if (regex.test(content) && !seenRules.has(pattern.id)) {
@@ -15832,6 +15978,460 @@ async function validateDesignSlop(root, config) {
   return findings.map((f) => findingToIssue(f, auditConfig.qualityProfile, "slop"));
 }
 
+// src/core/validators/uixValidators.ts
+import { readdir as readdir11 } from "fs/promises";
+import path56 from "path";
+
+// src/core/validators/uixDetection.ts
+import { readdir as readdir10 } from "fs/promises";
+import path55 from "path";
+var UI_BEARING_SURFACES = /* @__PURE__ */ new Set(["web-ui", "mobile-ui", "desktop-ui", "mixed"]);
+var NON_UI_SURFACES = /* @__PURE__ */ new Set(["non-ui"]);
+function stripCodeBlocks(content) {
+  let stripped = content.replace(/```[\s\S]*?```/g, "");
+  stripped = stripped.replace(/`[^`]+`/g, "");
+  return stripped;
+}
+var HTML_TAG_RE2 = /<(?:style|div|section|span|button|input|form|header|footer|nav|main|aside)\b/i;
+var MERMAID_SCREEN_FLOW_RE2 = /```mermaid[\s\S]*?(?:stateDiagram)[\s\S]*?(?:Screen|Page|View|Dashboard|Login|Settings|Home)\b/i;
+var SCREEN_CONTRACT_YAML_RE = /screens:\s*\n\s*-\s*route:/;
+async function isUiBearingSpec(root) {
+  const specContent = await readSafe(path55.join(root, "01_Spec.md"));
+  const surfaceMatch = /^\s*-\s*surface:\s*(\S+)/im.exec(specContent);
+  if (surfaceMatch?.[1]) {
+    const surface = surfaceMatch[1].toLowerCase();
+    if (UI_BEARING_SURFACES.has(surface)) return true;
+    if (NON_UI_SURFACES.has(surface)) return false;
+  }
+  try {
+    await readdir10(path55.join(root, "uiux"));
+    return true;
+  } catch {
+  }
+  const contractsContent = await readSafe(path55.join(root, "uiux", "40_contracts.md"));
+  if (contractsContent && SCREEN_CONTRACT_YAML_RE.test(contractsContent)) return true;
+  const storyContent = await readSafe(path55.join(root, "03_Story-Workshop.md"));
+  if (storyContent) {
+    const stripped = stripCodeBlocks(storyContent);
+    if (HTML_TAG_RE2.test(stripped)) return true;
+    if (MERMAID_SCREEN_FLOW_RE2.test(storyContent)) return true;
+  }
+  return false;
+}
+
+// src/core/validators/uixValidators.ts
+function uixIssue(code, message, severity, file, suggestedAction) {
+  return {
+    code,
+    severity,
+    category: "compatibility",
+    message,
+    file,
+    suggested_action: suggestedAction
+  };
+}
+function parseSimpleYaml(content) {
+  const result = {};
+  const store = (rawKey, value) => {
+    const key = rawKey.trim().toLowerCase().replace(/\s+/g, "_");
+    if (key && value) result[key] = value;
+  };
+  for (const line of content.split("\n")) {
+    const yamlMatch = /^\s*(\w[\w_]*):\s*(.*)$/.exec(line);
+    if (yamlMatch?.[1] !== void 0 && yamlMatch[2] !== void 0) {
+      store(yamlMatch[1], yamlMatch[2].trim());
+      continue;
+    }
+    const bulletMatch = /^\s*-\s+([\w][\w\s]*?):\s+(.+)$/.exec(line);
+    if (bulletMatch?.[1] !== void 0 && bulletMatch[2] !== void 0) {
+      store(bulletMatch[1], bulletMatch[2].trim());
+      continue;
+    }
+    const tableMatch = /^\s*\|\s*(\w[\w\s_]*?)\s*\|\s*(.+?)\s*\|\s*$/.exec(line);
+    if (tableMatch?.[1] !== void 0 && tableMatch[2] !== void 0) {
+      if (!/^[-:]+$/.test(tableMatch[2].trim())) {
+        store(tableMatch[1], tableMatch[2].trim());
+      }
+    }
+  }
+  return result;
+}
+async function validateSidecarMissing(root, _config) {
+  if (!await isUiBearingSpec(root)) return [];
+  try {
+    await readdir11(path56.join(root, "uiux"));
+    return [];
+  } catch {
+    return [
+      uixIssue(
+        "UIX-VAL-SIDECAR-MISSING",
+        "UI-bearing spec detected but uiux/ sidecar directory is missing.",
+        "error",
+        "uiux/",
+        "Create the uiux/ directory and populate it with the sidecar template files."
+      )
+    ];
+  }
+}
+var STRATEGY_REQUIRED_FIELDS_LEGACY = [
+  "selection_required",
+  "candidate_options",
+  "chosen_option",
+  "verification_expectations",
+  "none_as_legitimate_outcome"
+];
+var STRATEGY_REQUIRED_FIELDS_CURRENT = ["surface_type", "approach", "rationale"];
+var STRATEGY_MIN_LENGTH_FIELDS = ["rationale", "approach"];
+var STRATEGY_MIN_LENGTH = 20;
+async function validateStrategyCompleteness(root, _config) {
+  if (!await isUiBearingSpec(root)) return [];
+  const strategyPath = path56.join(root, "uiux", "10_strategy.md");
+  const content = await readSafe(strategyPath);
+  if (!content) return [];
+  const parsed = parseSimpleYaml(content);
+  const issues = [];
+  const relPath = "uiux/10_strategy.md";
+  const isCurrentFormat = parsed["surface_type"] !== void 0;
+  const requiredFields = isCurrentFormat ? STRATEGY_REQUIRED_FIELDS_CURRENT : STRATEGY_REQUIRED_FIELDS_LEGACY;
+  for (const field of requiredFields) {
+    const value = parsed[field];
+    if (value === void 0 || value === "") {
+      issues.push(
+        uixIssue(
+          "UIX-VAL-STRATEGY-INCOMPLETE",
+          `Strategy field '${field}' is missing or empty in 10_strategy.md.`,
+          "error",
+          relPath,
+          `Add the '${field}' field to uiux/10_strategy.md with a valid value.`
+        )
+      );
+    }
+  }
+  for (const field of STRATEGY_MIN_LENGTH_FIELDS) {
+    const value = parsed[field];
+    if (value === void 0 || value.length < STRATEGY_MIN_LENGTH) {
+      issues.push(
+        uixIssue(
+          "UIX-VAL-STRATEGY-INCOMPLETE",
+          `Strategy field '${field}' must be at least ${STRATEGY_MIN_LENGTH} characters (current: ${value?.length ?? 0}).`,
+          "error",
+          relPath,
+          `Expand the '${field}' field in uiux/10_strategy.md to at least ${STRATEGY_MIN_LENGTH} characters.`
+        )
+      );
+    }
+  }
+  return issues;
+}
+async function validateScoringAxes(root, _config) {
+  if (!await isUiBearingSpec(root)) return [];
+  const singlePath = path56.join(root, "uiux", "20_eval_axes.md");
+  let content = await readSafe(singlePath);
+  let relPath = "uiux/20_eval_axes.md";
+  if (!content) {
+    const splitFiles = [
+      "20_eval_axis_usability.md",
+      "21_eval_axis_consistency.md",
+      "22_eval_axis_accessibility.md",
+      "23_eval_axis_delight.md"
+    ];
+    const parts = [];
+    for (const f of splitFiles) {
+      const c = await readSafe(path56.join(root, "uiux", f));
+      if (c) parts.push(c);
+    }
+    if (parts.length > 0) {
+      content = parts.join("\n");
+      relPath = "uiux/20_eval_axis_*.md";
+    }
+  }
+  if (!content) return [];
+  const issues = [];
+  const lines = content.split("\n");
+  let inTrendSection = false;
+  for (const line of lines) {
+    if (/trend[_-]derived/i.test(line)) {
+      inTrendSection = true;
+      continue;
+    }
+    if (inTrendSection && /^#+\s/.test(line)) {
+      inTrendSection = false;
+      continue;
+    }
+    const isBulletRow = /^\s*-\s/.test(line);
+    const isTableRow2 = /^\s*\|/.test(line) && !/^\s*\|[\s-:|]+\|[\s-:|]*$/.test(line);
+    if (inTrendSection && (isBulletRow || isTableRow2)) {
+      if (!/source_translation/i.test(line)) {
+        issues.push(
+          uixIssue(
+            "UIX-VAL-SCORING-AXIS-INCOMPLETE",
+            "Trend-derived scoring axis row is missing source_translation field.",
+            "error",
+            relPath,
+            "Add source_translation to each trend-derived evaluation axis row."
+          )
+        );
+      }
+    }
+  }
+  return issues;
+}
+var AGGREGATE_REQUIRED_FIELDS = ["weights", "normalization", "threshold"];
+async function validateAggregateScoringRules(root, _config) {
+  if (!await isUiBearingSpec(root)) return [];
+  const aggregatePath = path56.join(root, "uiux", "21_aggregate_scoring.md");
+  let content = await readSafe(aggregatePath);
+  let relPath = "uiux/21_aggregate_scoring.md";
+  if (!content) {
+    const delightContent = await readSafe(path56.join(root, "uiux", "23_eval_axis_delight.md"));
+    if (delightContent) {
+      const lines = delightContent.split("\n");
+      let inSection = false;
+      const sectionLines = [];
+      for (const line of lines) {
+        if (/^#+\s*Aggregate\s+Scoring/i.test(line)) {
+          inSection = true;
+          continue;
+        }
+        if (inSection && /^#+\s/.test(line)) break;
+        if (inSection) sectionLines.push(line);
+      }
+      if (sectionLines.length > 0) {
+        content = sectionLines.join("\n");
+        relPath = "uiux/23_eval_axis_delight.md";
+      }
+    }
+  }
+  if (!content) return [];
+  const parsed = parseSimpleYaml(content);
+  const issues = [];
+  for (const field of AGGREGATE_REQUIRED_FIELDS) {
+    const value = parsed[field] ?? parsed[`${field}s`];
+    if (value === void 0 || value === "") {
+      issues.push(
+        uixIssue(
+          "UIX-VAL-AGGREGATE-SCORING-INCOMPLETE",
+          `Aggregate scoring field '${field}' is missing in ${relPath}.`,
+          "error",
+          relPath,
+          `Add the '${field}' field to ${relPath}.`
+        )
+      );
+    }
+  }
+  return issues;
+}
+async function validateOptionComparison3(root, _config) {
+  if (!await isUiBearingSpec(root)) return [];
+  const issues = [];
+  const compPath = path56.join(root, "uiux", "30_comparison.md");
+  const compContent = await readSafe(compPath);
+  if (compContent) {
+    const headingOptions = compContent.match(/^##\s+Option\b/gim);
+    const tableOptions = compContent.match(/\bOption\s+[A-Z]\b/gim);
+    const uniqueTableOptions = tableOptions ? new Set(tableOptions.map((m) => m.trim().toUpperCase())).size : 0;
+    const optionCount = Math.max(headingOptions?.length ?? 0, uniqueTableOptions);
+    if (optionCount < 2) {
+      issues.push(
+        uixIssue(
+          "UIX-VAL-COMPARISON-INSUFFICIENT",
+          "30_comparison.md must contain at least 2 options for meaningful comparison.",
+          "error",
+          "uiux/30_comparison.md",
+          "Add at least 2 '## Option' sections to uiux/30_comparison.md."
+        )
+      );
+    }
+  }
+  const anchorPath = path56.join(root, "uiux", "31_anchor.md");
+  const anchorContent = await readSafe(anchorPath);
+  if (anchorContent) {
+    if (!/selected_anchor\s*:/i.test(anchorContent) && !/chosen\s*:/i.test(anchorContent) && !/source\s+option\s*:/i.test(anchorContent)) {
+      issues.push(
+        uixIssue(
+          "UIX-VAL-ANCHOR-MISSING",
+          "31_anchor.md is missing a selected anchor declaration.",
+          "error",
+          "uiux/31_anchor.md",
+          "Add a 'selected_anchor:' field to uiux/31_anchor.md."
+        )
+      );
+    }
+  }
+  return issues;
+}
+var SCREEN_CONTRACT_REQUIRED_FIELDS = [
+  "route",
+  "actor",
+  "purpose",
+  "primary_tasks",
+  "required_states",
+  "transitions",
+  "observable_outcomes"
+];
+async function validateScreenContracts(root, _config) {
+  if (!await isUiBearingSpec(root)) return [];
+  const contractsPath = path56.join(root, "uiux", "40_contracts.md");
+  const content = await readSafe(contractsPath);
+  if (!content) return [];
+  const parsed = parseSimpleYaml(content);
+  const issues = [];
+  const relPath = "uiux/40_contracts.md";
+  const sectionHeadings = {
+    primary_tasks: /^#{3,4}\s+Primary\s+Tasks/im,
+    required_states: /^#{3,4}\s+Required\s+States/im,
+    transitions: /^#{3,4}\s+Transitions/im,
+    observable_outcomes: /^#{3,4}\s+Observable\s+Outcomes/im
+  };
+  for (const field of SCREEN_CONTRACT_REQUIRED_FIELDS) {
+    const value = parsed[field];
+    const hasValue = value !== void 0 && value !== "";
+    const headingPattern = sectionHeadings[field];
+    const hasHeading = headingPattern ? headingPattern.test(content) : false;
+    if (!hasValue && !hasHeading) {
+      issues.push(
+        uixIssue(
+          "UIX-VAL-SCREEN-CONTRACT-INCOMPLETE",
+          `Screen contract field '${field}' is missing in 40_contracts.md.`,
+          "error",
+          relPath,
+          `Add the '${field}' field to screen contracts in uiux/40_contracts.md.`
+        )
+      );
+    }
+  }
+  return issues;
+}
+async function validateOqClosure(root, _config) {
+  if (!await isUiBearingSpec(root)) return [];
+  const rootOqPath = path56.join(root, "11_OQ-Register.md");
+  const uiuxOqPath = path56.join(root, "uiux", "11_OQ-Register.md");
+  const rootContent = await readSafe(rootOqPath);
+  const content = rootContent || await readSafe(uiuxOqPath);
+  if (!content) return [];
+  const issues = [];
+  const relPath = rootContent ? "11_OQ-Register.md" : "uiux/11_OQ-Register.md";
+  const oqBlocks = content.split(/(?=^##\s+OQ-\d{4})/m);
+  for (const block of oqBlocks) {
+    const idMatch = /^##\s+(OQ-\d{4})/m.exec(block);
+    if (!idMatch?.[1]) continue;
+    const oqId = idMatch[1];
+    const isOpen = /status\s*:\s*open/i.test(block);
+    const isCritical = /severity\s*:\s*(?:critical|blocking)/i.test(block);
+    if (isOpen && isCritical) {
+      issues.push(
+        uixIssue(
+          "UIX-VAL-OQ-OPEN-CRITICAL",
+          `Open critical OQ found: ${oqId}. Must be resolved before proceeding.`,
+          "error",
+          relPath,
+          `Resolve or downgrade ${oqId} in uiux/11_OQ-Register.md before validation can pass.`
+        )
+      );
+    }
+  }
+  const tableRowRegex = /^\s*\|\s*(OQ-\d{4})\s*\|/;
+  for (const line of content.split("\n")) {
+    const rowMatch = tableRowRegex.exec(line);
+    if (!rowMatch?.[1]) continue;
+    const oqId = rowMatch[1];
+    const cols = line.split("|").map((c) => c.trim()).filter(Boolean);
+    const disposition = cols[3]?.toLowerCase();
+    if (disposition === "open") {
+      const fullRow = line.toLowerCase();
+      if (/critical|blocking/i.test(fullRow)) {
+        issues.push(
+          uixIssue(
+            "UIX-VAL-OQ-OPEN-CRITICAL",
+            `Open critical OQ found: ${oqId}. Must be resolved before proceeding.`,
+            "error",
+            relPath,
+            `Resolve or downgrade ${oqId} in ${relPath} before validation can pass.`
+          )
+        );
+      }
+    }
+  }
+  return issues;
+}
+var CURRENT_SIDECAR_VERSION = "1.0.0";
+async function validateMigration(root, config) {
+  if (!await isUiBearingSpec(root)) return [];
+  const strict = config.uiux?.migration?.strict === true;
+  const issues = [];
+  try {
+    await readdir11(path56.join(root, "uiux"));
+  } catch {
+    issues.push(
+      uixIssue(
+        "UIX-VAL-MIGRATION-SIDECAR-MISSING",
+        "UI-bearing spec detected but uiux/ sidecar directory is missing. Migration required.",
+        strict ? "error" : "warning",
+        "uiux/",
+        "Run the UIX sidecar migration to create the uiux/ directory structure."
+      )
+    );
+    return issues;
+  }
+  const versionPath = path56.join(root, "uiux", ".sidecar-version");
+  const versionContent = await readSafe(versionPath);
+  if (versionContent) {
+    const version = versionContent.trim();
+    if (version && version !== CURRENT_SIDECAR_VERSION) {
+      issues.push(
+        uixIssue(
+          "UIX-VAL-MIGRATION-STALE-VERSION",
+          `Sidecar template version '${version}' is outdated (current: ${CURRENT_SIDECAR_VERSION}).`,
+          "warning",
+          "uiux/.sidecar-version",
+          `Upgrade sidecar template from ${version} to ${CURRENT_SIDECAR_VERSION}. Run the migration tool for upgrade steps.`
+        )
+      );
+    }
+  }
+  return issues;
+}
+function applyPhase1Ratchet(issues, releaseDate, now = /* @__PURE__ */ new Date()) {
+  const phase1EndMs = releaseDate.getTime() + 30 * 24 * 60 * 60 * 1e3;
+  if (now.getTime() > phase1EndMs) return issues;
+  return issues.map((iss) => {
+    if (iss.code.startsWith("UIX-VAL-") && iss.severity === "error") {
+      return { ...iss, severity: "warning" };
+    }
+    return iss;
+  });
+}
+async function runAllUixValidators(root, config) {
+  let effectiveRoot = root;
+  const directSpec = await readSafe(path56.join(root, "01_Spec.md"));
+  if (!directSpec) {
+    const discussionDir = path56.join(root, config.paths.discussionDir);
+    const packRoot = await findLatestDiscussionPackDir(discussionDir);
+    if (!packRoot) return [];
+    effectiveRoot = packRoot;
+  }
+  const validators = [
+    validateSidecarMissing,
+    validateStrategyCompleteness,
+    validateScoringAxes,
+    validateAggregateScoringRules,
+    validateOptionComparison3,
+    validateScreenContracts,
+    validateOqClosure,
+    validateMigration
+  ];
+  const results = await Promise.all(validators.map((v) => v(effectiveRoot, config)));
+  let issues = results.flat();
+  const relDateStr = config.uiux?.phase1ReleaseDate;
+  if (relDateStr) {
+    const releaseDate = new Date(relDateStr);
+    if (!isNaN(releaseDate.getTime())) {
+      issues = applyPhase1Ratchet(issues, releaseDate);
+    }
+  }
+  return issues;
+}
+
 // src/core/validate.ts
 var UIUX_VALIDATION_BUDGET_MS = 2e3;
 async function validateProject(root, configResult, options = {}) {
@@ -15851,7 +16451,8 @@ async function validateProject(root, configResult, options = {}) {
     () => validateResearchSummary(root, config),
     () => validateAgentDefinition(root, config),
     () => validateDesignAudit(root, config),
-    () => validateDesignSlop(root, config)
+    () => validateDesignSlop(root, config),
+    () => runAllUixValidators(root, config)
   ];
   const uiuxIssueGroups = await Promise.all(uiuxValidators.map((validator) => validator()));
   const uiuxIssues = [...platformResult.issues, ...uiuxIssueGroups.flat()];
@@ -15938,15 +16539,15 @@ var REPORT_GUARDRAILS_MAX = 20;
 var REPORT_TEST_STRATEGY_SAMPLE_LIMIT = 20;
 var SC_TAG_RE4 = /^SC-\d{4}-\d{4}$/;
 async function createReportData(root, validation, configResult) {
-  const resolvedRoot = path54.resolve(root);
+  const resolvedRoot = path57.resolve(root);
   const resolved = configResult ?? await loadConfig(resolvedRoot);
   const config = resolved.config;
   const configPath = resolved.configPath;
   const specsRoot = resolvePath(resolvedRoot, config, "specsDir");
   const contractsRoot = resolvePath(resolvedRoot, config, "contractsDir");
-  const apiRoot = path54.join(contractsRoot, "api");
-  const uiRoot = path54.join(contractsRoot, "ui");
-  const dbRoot = path54.join(contractsRoot, "db");
+  const apiRoot = path57.join(contractsRoot, "api");
+  const uiRoot = path57.join(contractsRoot, "ui");
+  const dbRoot = path57.join(contractsRoot, "db");
   const srcRoot = resolvePath(resolvedRoot, config, "srcDir");
   const testsRoot = resolvePath(resolvedRoot, config, "testsDir");
   const specEntries = await collectSpecEntries(specsRoot);
@@ -16883,7 +17484,7 @@ async function collectChangeTypeSummary(specsRoot) {
   };
   const deltaFiles = await collectDeltaFiles(specsRoot);
   for (const deltaFile of deltaFiles) {
-    const text = await readFile42(deltaFile, "utf-8");
+    const text = await readFile43(deltaFile, "utf-8");
     const parsed = parseDeltaV1(text);
     for (const entry of parsed.entries) {
       if (!entry.meta) {
@@ -16920,7 +17521,7 @@ async function collectSpecContractRefs(specFiles, contractIdList) {
     idToSpecs.set(contractId, /* @__PURE__ */ new Set());
   }
   for (const file of specFiles) {
-    const text = await readFile42(file, "utf-8");
+    const text = await readFile43(file, "utf-8");
     const parsed = parseSpec(text, file);
     const specKey = parsed.specId;
     if (!specKey) {
@@ -16957,7 +17558,7 @@ async function collectIds(files) {
     result[prefix] = /* @__PURE__ */ new Set();
   }
   for (const file of files) {
-    const text = await readFile42(file, "utf-8");
+    const text = await readFile43(file, "utf-8");
     for (const prefix of ID_PREFIXES) {
       const ids = extractIds(text, prefix);
       ids.forEach((id) => result[prefix].add(id));
@@ -16972,7 +17573,7 @@ async function collectIds(files) {
 async function collectUpstreamIds(files) {
   const ids = /* @__PURE__ */ new Set();
   for (const file of files) {
-    const text = await readFile42(file, "utf-8");
+    const text = await readFile43(file, "utf-8");
     extractAllIds(text).forEach((id) => ids.add(id));
   }
   return ids;
@@ -16993,7 +17594,7 @@ async function evaluateTraceability(upstreamIds, srcRoot, testsRoot) {
   }
   const pattern = buildIdPattern(Array.from(upstreamIds));
   for (const file of targetFiles) {
-    const text = await readFile42(file, "utf-8");
+    const text = await readFile43(file, "utf-8");
     if (pattern.test(text)) {
       return true;
     }
@@ -17112,7 +17713,7 @@ function normalizeScSources(root, sources) {
 async function countScenarios(scenarioFiles) {
   let total = 0;
   for (const file of scenarioFiles) {
-    const text = await readFile42(file, "utf-8");
+    const text = await readFile43(file, "utf-8");
     const { document, errors } = parseScenarioDocument(text, file);
     if (!document || errors.length > 0) {
       continue;
@@ -17143,7 +17744,7 @@ async function collectTestStrategy(scenarioFiles, root, config, limit) {
   let totalScenarios = 0;
   let e2eCount = 0;
   for (const file of scenarioFiles) {
-    const text = await readFile42(file, "utf-8");
+    const text = await readFile43(file, "utf-8");
     const { document, errors } = parseScenarioDocument(text, file);
     if (!document || errors.length > 0) {
       continue;
@@ -17231,10 +17832,10 @@ function buildHotspots(issues) {
 async function collectTddCoverage(entries) {
   const specs = [];
   for (const entry of entries) {
-    const testCasesPath = path54.join(entry.dir, "06_Test-Cases.md");
+    const testCasesPath = path57.join(entry.dir, "06_Test-Cases.md");
     let tcContent;
     try {
-      tcContent = await readFile42(testCasesPath, "utf-8");
+      tcContent = await readFile43(testCasesPath, "utf-8");
     } catch {
       continue;
     }
@@ -17266,10 +17867,10 @@ async function collectTddCoverage(entries) {
       });
       continue;
     }
-    const tddListPath = path54.join(entry.dir, "tdd", "test-list.md");
+    const tddListPath = path57.join(entry.dir, "tdd", "test-list.md");
     let tddContent;
     try {
-      tddContent = await readFile42(tddListPath, "utf-8");
+      tddContent = await readFile43(tddListPath, "utf-8");
     } catch {
       specs.push({
         specNumber: entry.specNumber,
@@ -17354,6 +17955,8 @@ export {
   ID_PREFIXES,
   RUNTIME_HEAVY_CHECKS,
   STATIC_OBLIGATIONS,
+  VALID_MODE_SOURCES,
+  adaptSurfaceEvidence,
   autogenerateUiFidelity,
   buildUiFidelityScreens,
   checkDecisionGuardrails,
@@ -17379,6 +17982,7 @@ export {
   filterDecisionGuardrailsByKeyword,
   findConfigRoot,
   formatGuardrailsForLlm,
+  formatModeLog,
   formatReportJson,
   formatReportMarkdown,
   getConfigPath,
@@ -17386,9 +17990,11 @@ export {
   loadConfig,
   loadDecisionGuardrails,
   normalizeDecisionGuardrails,
+  readDiscussionRecommendation,
   resolveObligations,
   resolveObligationsWithOptIn,
   resolvePath,
+  resolvePrecedence,
   resolveToolVersion,
   runMockPaths,
   runSddPreflight,