qfai 1.7.6 → 1.7.7

package/dist/index.cjs

@@ -33,6 +33,8 @@ __export(src_exports, {
   ID_PREFIXES: () => ID_PREFIXES,
   RUNTIME_HEAVY_CHECKS: () => RUNTIME_HEAVY_CHECKS,
   STATIC_OBLIGATIONS: () => STATIC_OBLIGATIONS,
+  VALID_MODE_SOURCES: () => VALID_MODE_SOURCES,
+  adaptSurfaceEvidence: () => adaptSurfaceEvidence,
   autogenerateUiFidelity: () => autogenerateUiFidelity,
   buildUiFidelityScreens: () => buildUiFidelityScreens,
   checkDecisionGuardrails: () => checkDecisionGuardrails,
@@ -58,6 +60,7 @@ __export(src_exports, {
   filterDecisionGuardrailsByKeyword: () => filterDecisionGuardrailsByKeyword,
   findConfigRoot: () => findConfigRoot,
   formatGuardrailsForLlm: () => formatGuardrailsForLlm,
+  formatModeLog: () => formatModeLog,
   formatReportJson: () => formatReportJson,
   formatReportMarkdown: () => formatReportMarkdown,
   getConfigPath: () => getConfigPath,
@@ -65,9 +68,11 @@ __export(src_exports, {
   loadConfig: () => loadConfig,
   loadDecisionGuardrails: () => loadDecisionGuardrails,
   normalizeDecisionGuardrails: () => normalizeDecisionGuardrails,
+  readDiscussionRecommendation: () => readDiscussionRecommendation,
   resolveObligations: () => resolveObligations,
   resolveObligationsWithOptIn: () => resolveObligationsWithOptIn,
   resolvePath: () => resolvePath,
+  resolvePrecedence: () => resolvePrecedence,
   resolveToolVersion: () => resolveToolVersion,
   runMockPaths: () => runMockPaths,
   runSddPreflight: () => runSddPreflight,
@@ -540,6 +545,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;
@@ -564,6 +578,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) {
@@ -623,6 +643,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(
@@ -3680,18 +3717,125 @@ function resolveObligationsWithOptIn(mode, optIn) {
   return [.../* @__PURE__ */ new Set([...base, ...validOptIns])];
 }
 
+// src/core/prototyping/discussionReader.ts
+var import_promises13 = require("fs/promises");
+var import_node_path12 = __toESM(require("path"), 1);
+var import_yaml3 = require("yaml");
+var VALID_MODES = /* @__PURE__ */ new Set(["low-cost", "standard", "full-harness"]);
+var SIDECAR_FILENAME = "prototyping.yaml";
+async function readDiscussionRecommendation(discussionPackDir) {
+  const filePath = import_node_path12.default.join(discussionPackDir, SIDECAR_FILENAME);
+  let raw;
+  try {
+    raw = await (0, import_promises13.readFile)(filePath, "utf-8");
+  } catch {
+    return { recommended_mode: null, rationale: null };
+  }
+  let doc;
+  try {
+    doc = (0, import_yaml3.parse)(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
-var import_promises52 = require("fs/promises");
-var import_node_path54 = __toESM(require("path"), 1);
+var import_promises55 = require("fs/promises");
+var import_node_path57 = __toESM(require("path"), 1);
 
 // src/core/contractIndex.ts
-var import_promises13 = require("fs/promises");
-var import_node_path12 = __toESM(require("path"), 1);
+var import_promises14 = require("fs/promises");
+var import_node_path13 = __toESM(require("path"), 1);
 async function buildContractIndex(root, config) {
   const contractsRoot = resolvePath(root, config, "contractsDir");
-  const uiRoot = import_node_path12.default.join(contractsRoot, "ui");
-  const apiRoot = import_node_path12.default.join(contractsRoot, "api");
-  const dbRoot = import_node_path12.default.join(contractsRoot, "db");
+  const uiRoot = import_node_path13.default.join(contractsRoot, "ui");
+  const apiRoot = import_node_path13.default.join(contractsRoot, "api");
+  const dbRoot = import_node_path13.default.join(contractsRoot, "db");
   const [uiFiles, themaFiles, apiFiles, dbFiles] = await Promise.all([
     collectUiContractFiles(uiRoot),
     collectThemaContractFiles(),
@@ -3711,7 +3855,7 @@ async function buildContractIndex(root, config) {
 }
 async function indexContractFiles(files, index) {
   for (const file of files) {
-    const text = await (0, import_promises13.readFile)(file, "utf-8");
+    const text = await (0, import_promises14.readFile)(file, "utf-8");
     extractDeclaredContractIds(text).forEach((id) => {
       record(index, id, file);
     });
@@ -3981,15 +4125,15 @@ function resolveParentTcId(tcRef) {
 }
 
 // src/core/paths.ts
-var import_node_path13 = __toESM(require("path"), 1);
+var import_node_path14 = __toESM(require("path"), 1);
 function toRelativePath(root, target) {
   if (!target) {
     return target;
   }
-  if (!import_node_path13.default.isAbsolute(target)) {
+  if (!import_node_path14.default.isAbsolute(target)) {
     return toPosixPath2(target);
   }
-  const relative = import_node_path13.default.relative(root, target);
+  const relative = import_node_path14.default.relative(root, target);
   if (!relative) {
     return ".";
   }
@@ -4160,7 +4304,7 @@ function parseSpec(md, file) {
 }
 
 // src/core/deltaV1.ts
-var import_yaml3 = require("yaml");
+var import_yaml4 = require("yaml");
 var REQUIRED_DELTA_META_KEYS = [
   "id",
   "date",
@@ -4315,7 +4459,7 @@ function parseYamlMeta(block) {
     return { value: null, error: null };
   }
   try {
-    const parsed = (0, import_yaml3.parse)(sanitizeMetaYaml(block));
+    const parsed = (0, import_yaml4.parse)(sanitizeMetaYaml(block));
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
       return {
         value: null,
@@ -4349,7 +4493,7 @@ function parseVerificationPlan(body) {
     return { planHeadingLine: planHeading.line, parseError: null, items: [] };
   }
   try {
-    const parsed = (0, import_yaml3.parse)(yamlSource);
+    const parsed = (0, import_yaml4.parse)(yamlSource);
     if (!Array.isArray(parsed)) {
       return {
         planHeadingLine: planHeading.line,
@@ -4436,16 +4580,16 @@ function asTagArray(value) {
 }
 
 // src/core/version.ts
-var import_promises14 = require("fs/promises");
-var import_node_path14 = __toESM(require("path"), 1);
+var import_promises15 = require("fs/promises");
+var import_node_path15 = __toESM(require("path"), 1);
 var import_node_url = require("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 (0, import_promises14.readFile)(packagePath, "utf-8");
+    const raw = await (0, import_promises15.readFile)(packagePath, "utf-8");
     const parsed = JSON.parse(raw);
     const version = typeof parsed.version === "string" ? parsed.version : "";
     return version.length > 0 ? version : "unknown";
@@ -4456,13 +4600,13 @@ async function resolveToolVersion() {
 function resolvePackageJsonPath() {
   const base = __filename;
   const basePath = base.startsWith("file:") ? (0, import_node_url.fileURLToPath)(base) : base;
-  return import_node_path14.default.resolve(import_node_path14.default.dirname(basePath), "../../package.json");
+  return import_node_path15.default.resolve(import_node_path15.default.dirname(basePath), "../../package.json");
 }
 
 // src/core/waivers.ts
-var import_promises15 = require("fs/promises");
-var import_node_path15 = __toESM(require("path"), 1);
-var import_yaml4 = require("yaml");
+var import_promises16 = require("fs/promises");
+var import_node_path16 = __toESM(require("path"), 1);
+var import_yaml5 = require("yaml");
 
 // src/core/regex.ts
 function escapeRegExp(value) {
@@ -4470,12 +4614,12 @@ function escapeRegExp(value) {
 }
 
 // src/core/waivers.ts
-var WAIVER_FILE = import_node_path15.default.join(".qfai", "waivers.yml");
-var UNSUPPORTED_WAIVER_FILE = import_node_path15.default.join(".qfai", "waivers.yaml");
+var WAIVER_FILE = import_node_path16.default.join(".qfai", "waivers.yml");
+var UNSUPPORTED_WAIVER_FILE = import_node_path16.default.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 = import_node_path15.default.resolve(root);
+  const resolvedRoot = import_node_path16.default.resolve(root);
   const ruleSeverityIndex = buildRuleSeverityIndex(findings);
   const loaded = await loadWaivers(resolvedRoot, ruleSeverityIndex);
   const applied = applyWaiversToFindings(resolvedRoot, findings, loaded.applicableWaivers);
@@ -4488,8 +4632,8 @@ async function applyWaivers(root, findings) {
   };
 }
 async function loadWaivers(root, ruleSeverityIndex) {
-  const waiverPath = import_node_path15.default.join(root, WAIVER_FILE);
-  const unsupportedPath = import_node_path15.default.join(root, UNSUPPORTED_WAIVER_FILE);
+  const waiverPath = import_node_path16.default.join(root, WAIVER_FILE);
+  const unsupportedPath = import_node_path16.default.join(root, UNSUPPORTED_WAIVER_FILE);
   const validationIssues = [];
   if (await exists6(unsupportedPath)) {
     validationIssues.push(
@@ -4513,7 +4657,7 @@ async function loadWaivers(root, ruleSeverityIndex) {
   }
   let rawText;
   try {
-    rawText = await (0, import_promises15.readFile)(waiverPath, "utf-8");
+    rawText = await (0, import_promises16.readFile)(waiverPath, "utf-8");
   } catch (error) {
     validationIssues.push(
       issue(
@@ -4534,7 +4678,7 @@ async function loadWaivers(root, ruleSeverityIndex) {
   }
   let parsed;
   try {
-    parsed = (0, import_yaml4.parse)(rawText);
+    parsed = (0, import_yaml5.parse)(rawText);
   } catch (error) {
     validationIssues.push(
       issue(
@@ -5172,7 +5316,7 @@ function toErrorMessage(error) {
 }
 async function exists6(targetPath) {
   try {
-    await (0, import_promises15.access)(targetPath);
+    await (0, import_promises16.access)(targetPath);
     return true;
   } catch {
     return false;
@@ -5206,8 +5350,8 @@ var STATIC_RULE_SEVERITY = {
 };
 
 // src/core/validators/contracts.ts
-var import_promises16 = require("fs/promises");
-var import_node_path16 = __toESM(require("path"), 1);
+var import_promises17 = require("fs/promises");
+var import_node_path17 = __toESM(require("path"), 1);
 var SQL_DANGEROUS_PATTERNS = [
   { pattern: /\bDROP\s+TABLE\b/i, label: "DROP TABLE" },
   { pattern: /\bDROP\s+DATABASE\b/i, label: "DROP DATABASE" },
@@ -5220,9 +5364,9 @@ var SQL_DANGEROUS_PATTERNS = [
 async function validateContracts(root, config) {
   const issues = [];
   const contractsRoot = resolvePath(root, config, "contractsDir");
-  const uiRoot = import_node_path16.default.join(contractsRoot, "ui");
-  const apiRoot = import_node_path16.default.join(contractsRoot, "api");
-  const dbRoot = import_node_path16.default.join(contractsRoot, "db");
+  const uiRoot = import_node_path17.default.join(contractsRoot, "ui");
+  const apiRoot = import_node_path17.default.join(contractsRoot, "api");
+  const dbRoot = import_node_path17.default.join(contractsRoot, "db");
   const [uiFiles, apiFiles, dbFiles] = await Promise.all([
     collectUiContractFiles(uiRoot),
     collectApiContractFiles(apiRoot),
@@ -5276,7 +5420,7 @@ async function validateContracts(root, config) {
 }
 async function validateContractFile(file, kind) {
   const issues = [];
-  const text = await (0, import_promises16.readFile)(file, "utf-8");
+  const text = await (0, import_promises17.readFile)(file, "utf-8");
   const declaredIds = extractDeclaredContractIds(text);
   issues.push(...validateDeclaredContractIds(declaredIds, file, kind));
   if (kind === "DB") {
@@ -5397,23 +5541,23 @@ function formatError5(error) {
 }
 
 // src/core/validators/discussMermaid.ts
-var import_promises17 = require("fs/promises");
-var import_node_path17 = __toESM(require("path"), 1);
+var import_promises18 = require("fs/promises");
+var import_node_path18 = __toESM(require("path"), 1);
 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 = import_node_path17.default.join(root, ".qfai", "discussion");
+  const discussionRootDir = import_node_path18.default.join(root, ".qfai", "discussion");
   const discussionPackMarkdownFiles = await collectFiles(discussionRootDir, {
     extensions: [".md"]
   });
   const discussionPackFiles = [];
   for (const file of discussionPackMarkdownFiles) {
-    const fileName = import_node_path17.default.basename(file);
+    const fileName = import_node_path18.default.basename(file);
     if (fileName !== DISCUSSION_PACK_FLOW_FILE) {
       continue;
     }
-    const discussionDirName = import_node_path17.default.basename(import_node_path17.default.dirname(file));
+    const discussionDirName = import_node_path18.default.basename(import_node_path18.default.dirname(file));
     const nameValidation = validatePackName("discussion", discussionDirName);
     if (nameValidation.isCanonical) {
       discussionPackFiles.push({ file, kind: "current" });
@@ -5443,7 +5587,7 @@ async function validateDiscussionMermaid(root) {
     );
   }
   for (const { file } of discussionPackFiles) {
-    const text = await (0, import_promises17.readFile)(file, "utf-8");
+    const text = await (0, import_promises18.readFile)(file, "utf-8");
     if (containsMermaidFlowDiagram(text)) {
       continue;
     }
@@ -5493,17 +5637,17 @@ function containsMermaidFlowDiagram(text) {
 }
 
 // src/core/validators/assistantAssets.ts
-var import_promises18 = require("fs/promises");
-var import_node_path18 = __toESM(require("path"), 1);
+var import_promises19 = require("fs/promises");
+var import_node_path19 = __toESM(require("path"), 1);
 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 = import_node_path18.default.dirname(skillsDir);
-  const skillsLocalDir = import_node_path18.default.join(import_node_path18.default.dirname(skillsDir), `${import_node_path18.default.basename(skillsDir)}.local`);
-  const driftProtocolPath = import_node_path18.default.join(assistantDir, "instructions", "drift-protocol.md");
-  const testLayersPath = import_node_path18.default.join(assistantDir, "steering", "test-layers.md");
+  const assistantDir = import_node_path19.default.dirname(skillsDir);
+  const skillsLocalDir = import_node_path19.default.join(import_node_path19.default.dirname(skillsDir), `${import_node_path19.default.basename(skillsDir)}.local`);
+  const driftProtocolPath = import_node_path19.default.join(assistantDir, "instructions", "drift-protocol.md");
+  const testLayersPath = import_node_path19.default.join(assistantDir, "steering", "test-layers.md");
   const issues = [];
   if (!await exists7(driftProtocolPath)) {
     issues.push(
@@ -5529,7 +5673,7 @@ async function validateAssistantAssets(root, config) {
   }
   const skillFiles = await collectSkillFiles([skillsDir, skillsLocalDir]);
   for (const skillFile of skillFiles) {
-    const content = await (0, import_promises18.readFile)(skillFile, "utf-8");
+    const content = await (0, import_promises19.readFile)(skillFile, "utf-8");
     if (!content.includes(DRIFT_PROTOCOL_MARKER)) {
       issues.push(
         issue(
@@ -5571,7 +5715,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) => import_node_path18.default.basename(filePath) === "SKILL.md").sort((a, b) => a.localeCompare(b));
+  return files.flat().filter((filePath) => import_node_path19.default.basename(filePath) === "SKILL.md").sort((a, b) => a.localeCompare(b));
 }
 function extractReviewerGateSection(content) {
   const headingMatch = REVIEWER_GATE_HEADING_PATTERN.exec(content);
@@ -5604,7 +5748,7 @@ function collectMissingReviewerGateTerms(section) {
 }
 async function exists7(target) {
   try {
-    await (0, import_promises18.access)(target);
+    await (0, import_promises19.access)(target);
     return true;
   } catch {
     return false;
@@ -5612,20 +5756,20 @@ async function exists7(target) {
 }
 
 // src/core/skillsIntegrity.ts
-var import_promises19 = require("fs/promises");
-var import_node_path20 = __toESM(require("path"), 1);
+var import_promises20 = require("fs/promises");
+var import_node_path21 = __toESM(require("path"), 1);
 
 // src/shared/assets.ts
 var import_node_fs = require("fs");
-var import_node_path19 = __toESM(require("path"), 1);
+var import_node_path20 = __toESM(require("path"), 1);
 var import_node_url2 = require("url");
 function getInitAssetsDir() {
   const base = __filename;
   const basePath = base.startsWith("file:") ? (0, import_node_url2.fileURLToPath)(base) : base;
-  const baseDir = import_node_path19.default.dirname(basePath);
+  const baseDir = import_node_path20.default.dirname(basePath);
   const candidates = [
-    import_node_path19.default.resolve(baseDir, "../../../assets/init"),
-    import_node_path19.default.resolve(baseDir, "../../assets/init")
+    import_node_path20.default.resolve(baseDir, "../../../assets/init"),
+    import_node_path20.default.resolve(baseDir, "../../assets/init")
   ];
   for (const candidate of candidates) {
     if ((0, import_node_fs.existsSync)(candidate)) {
@@ -5644,10 +5788,10 @@ function getInitAssetsDir() {
 // src/core/skillsIntegrity.ts
 async function diffProjectSkillsAgainstInitAssets(root, config) {
   const skillsDirConfig = config.paths.skillsDir;
-  const skillsDir = import_node_path20.default.isAbsolute(skillsDirConfig) ? skillsDirConfig : import_node_path20.default.resolve(root, skillsDirConfig);
+  const skillsDir = import_node_path21.default.isAbsolute(skillsDirConfig) ? skillsDirConfig : import_node_path21.default.resolve(root, skillsDirConfig);
   let templateDir;
   try {
-    const rel = import_node_path20.default.isAbsolute(skillsDirConfig) ? import_node_path20.default.relative(root, skillsDirConfig) : skillsDirConfig;
+    const rel = import_node_path21.default.isAbsolute(skillsDirConfig) ? import_node_path21.default.relative(root, skillsDirConfig) : skillsDirConfig;
     const normalized = rel.replace(/^[\\/]+/, "");
     if (normalized.length === 0 || normalized.startsWith("..")) {
       return {
@@ -5659,7 +5803,7 @@ async function diffProjectSkillsAgainstInitAssets(root, config) {
         changed: []
       };
     }
-    templateDir = import_node_path20.default.join(getInitAssetsDir(), normalized);
+    templateDir = import_node_path21.default.join(getInitAssetsDir(), normalized);
   } catch {
     return {
       status: "skipped_missing_assets",
@@ -5712,8 +5856,8 @@ async function diffProjectSkillsAgainstInitAssets(root, config) {
     }
     try {
       const [a, b] = await Promise.all([
-        (0, import_promises19.readFile)(templateAbs, "utf-8"),
-        (0, import_promises19.readFile)(projectAbs, "utf-8")
+        (0, import_promises20.readFile)(templateAbs, "utf-8"),
+        (0, import_promises20.readFile)(projectAbs, "utf-8")
       ]);
       if (normalizeNewlines(a) !== normalizeNewlines(b)) {
         changed.push(rel);
@@ -5736,7 +5880,7 @@ function normalizeNewlines(text) {
   return text.replace(/\r\n/g, "\n");
 }
 function toRel(base, abs) {
-  const rel = import_node_path20.default.relative(base, abs);
+  const rel = import_node_path21.default.relative(base, abs);
   return rel.replace(/[\\/]+/g, "/");
 }
 function intersectKeys(a, b) {
@@ -5781,8 +5925,8 @@ async function validateSkillsIntegrity(root, config) {
 }
 
 // src/core/validators/ids.ts
-var import_promises20 = require("fs/promises");
-var import_node_path21 = __toESM(require("path"), 1);
+var import_promises21 = require("fs/promises");
+var import_node_path22 = __toESM(require("path"), 1);
 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;
@@ -5898,7 +6042,7 @@ async function collectSpecDefinitionIds(files, out) {
 }
 async function readSafe5(file) {
   try {
-    return await (0, import_promises20.readFile)(file, "utf-8");
+    return await (0, import_promises21.readFile)(file, "utf-8");
   } catch {
     return "";
   }
@@ -5929,23 +6073,23 @@ function recordId(out, id, file) {
 }
 function formatFileList(files, root) {
   return files.map((file) => {
-    const relative = import_node_path21.default.relative(root, file);
+    const relative = import_node_path22.default.relative(root, file);
     return relative.length > 0 ? relative : file;
   }).join(", ");
 }
 
 // src/core/validators/reviewArtifacts.ts
-var import_promises21 = require("fs/promises");
-var import_node_path22 = __toESM(require("path"), 1);
+var import_promises22 = require("fs/promises");
+var import_node_path23 = __toESM(require("path"), 1);
 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 = import_node_path22.default.join(root, ".qfai", "review");
+  const reviewRoot = import_node_path23.default.join(root, ".qfai", "review");
   const issues = [];
-  const gitignorePath = import_node_path22.default.join(reviewRoot, ".gitignore");
+  const gitignorePath = import_node_path23.default.join(reviewRoot, ".gitignore");
   if (!await isFile(gitignorePath)) {
     issues.push(
       issue(
@@ -5983,8 +6127,8 @@ async function validateReviewArtifacts(root) {
 }
 async function validateReviewPack(reviewPackDir) {
   const issues = [];
-  const reviewRequestPath = import_node_path22.default.join(reviewPackDir, "review_request.md");
-  const summaryPath = import_node_path22.default.join(reviewPackDir, "summary.json");
+  const reviewRequestPath = import_node_path23.default.join(reviewPackDir, "review_request.md");
+  const summaryPath = import_node_path23.default.join(reviewPackDir, "summary.json");
   if (!await isFile(reviewRequestPath)) {
     issues.push(
       issue(
@@ -6027,7 +6171,7 @@ async function validateReviewPack(reviewPackDir) {
 async function validateSummarySchema(summaryPath) {
   let parsed;
   try {
-    parsed = JSON.parse(await (0, import_promises21.readFile)(summaryPath, "utf-8"));
+    parsed = JSON.parse(await (0, import_promises22.readFile)(summaryPath, "utf-8"));
   } catch (error) {
     return [
       issue(
@@ -6111,16 +6255,16 @@ async function validateSummarySchema(summaryPath) {
 async function listReviewPackDirs(reviewRoot) {
   let entries = [];
   try {
-    const dirEntries = await (0, import_promises21.readdir)(reviewRoot, { withFileTypes: true });
+    const dirEntries = await (0, import_promises22.readdir)(reviewRoot, { withFileTypes: true });
     entries = dirEntries.filter((entry) => entry.isDirectory() && REVIEW_PACK_DIR_RE.test(entry.name)).map((entry) => entry.name).sort((left, right) => right.localeCompare(left));
   } catch {
     return [];
   }
-  return entries.map((name) => import_node_path22.default.join(reviewRoot, name));
+  return entries.map((name) => import_node_path23.default.join(reviewRoot, name));
 }
 async function listReviewerFiles(reviewPackDir) {
   try {
-    const entries = await (0, import_promises21.readdir)(reviewPackDir, { withFileTypes: true });
+    const entries = await (0, import_promises22.readdir)(reviewPackDir, { withFileTypes: true });
     return entries.filter((entry) => entry.isFile() && REVIEWER_FILE_RE.test(entry.name)).map((entry) => entry.name).sort((left, right) => left.localeCompare(right));
   } catch {
     return [];
@@ -6128,7 +6272,7 @@ async function listReviewerFiles(reviewPackDir) {
 }
 async function isFile(target) {
   try {
-    const stats = await (0, import_promises21.stat)(target);
+    const stats = await (0, import_promises22.stat)(target);
     return stats.isFile();
   } catch {
     return false;
@@ -6164,8 +6308,8 @@ function formatError6(error) {
 }
 
 // src/core/validators/specPack.ts
-var import_promises22 = require("fs/promises");
-var import_node_path23 = __toESM(require("path"), 1);
+var import_promises23 = require("fs/promises");
+var import_node_path24 = __toESM(require("path"), 1);
 var LEDGER_REQUIRED_COLUMNS = [
   "trace_id",
   "obj_id",
@@ -6583,7 +6727,7 @@ function validateLayeredNamespace(entry, filePath, ids, prefix) {
       "specPack.layered.namespace",
       mismatched,
       "compatibility",
-      `${import_node_path23.default.basename(filePath)} \u306E ${prefix} ID \u3092 spec-${entry.specNumber} \u306B\u5408\u308F\u305B\u3066\u4FEE\u6B63\u3057\u3066\u304F\u3060\u3055\u3044\u3002`
+      `${import_node_path24.default.basename(filePath)} \u306E ${prefix} ID \u3092 spec-${entry.specNumber} \u306B\u5408\u308F\u305B\u3066\u4FEE\u6B63\u3057\u3066\u304F\u3060\u3055\u3044\u3002`
     )
   ];
 }
@@ -6591,7 +6735,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(import_node_path23.default.basename(candidate))) {
+    if (!/(?:^|_)delta\.md$/i.test(import_node_path24.default.basename(candidate))) {
       continue;
     }
     if (await fileExists(candidate)) {
@@ -6602,7 +6746,7 @@ async function collectExistingLayeredDeltaFiles(entry) {
 }
 async function fileExists(target) {
   try {
-    await (0, import_promises22.readFile)(target, "utf-8");
+    await (0, import_promises23.readFile)(target, "utf-8");
     return true;
   } catch {
     return false;
@@ -6763,7 +6907,7 @@ async function validateTraceabilityLedger(entry, contractIds) {
   const issues = [];
   let ledgerText;
   try {
-    ledgerText = await (0, import_promises22.readFile)(entry.traceabilityLedgerPath, "utf-8");
+    ledgerText = await (0, import_promises23.readFile)(entry.traceabilityLedgerPath, "utf-8");
   } catch {
     return issues;
   }
@@ -7161,10 +7305,10 @@ async function loadExistingRequiredTexts(entry, missingFiles) {
 }
 async function loadLayerPolicy(root, config) {
   const skillsDir = resolvePath(root, config, "skillsDir");
-  const assistantRoot = import_node_path23.default.dirname(skillsDir);
-  const policyPath = import_node_path23.default.join(assistantRoot, "steering", "test-layers.md");
+  const assistantRoot = import_node_path24.default.dirname(skillsDir);
+  const policyPath = import_node_path24.default.join(assistantRoot, "steering", "test-layers.md");
   try {
-    const policyText = await (0, import_promises22.readFile)(policyPath, "utf-8");
+    const policyText = await (0, import_promises23.readFile)(policyPath, "utf-8");
     return {
       tags: resolveAllowedLayerTagsFromPolicy(policyText),
       issues: []
@@ -7272,15 +7416,15 @@ function extractMarkdownSection(text, heading) {
 }
 async function readSafe6(filePath) {
   try {
-    return await (0, import_promises22.readFile)(filePath, "utf-8");
+    return await (0, import_promises23.readFile)(filePath, "utf-8");
   } catch {
     return "";
   }
 }
 
 // src/core/validators/traceability.ts
-var import_promises23 = require("fs/promises");
-var import_node_path24 = __toESM(require("path"), 1);
+var import_promises24 = require("fs/promises");
+var import_node_path25 = __toESM(require("path"), 1);
 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}$/;
@@ -7297,8 +7441,8 @@ async function validateTraceability(root, config, phase) {
   if (layeredEntries.length === 0) {
     return issues;
   }
-  const policiesDir = layeredEntries[0]?.sharedDir ?? import_node_path24.default.join(specsRoot, "_policies");
-  const capabilitiesPath = import_node_path24.default.join(policiesDir, "03_Capabilities.md");
+  const policiesDir = layeredEntries[0]?.sharedDir ?? import_node_path25.default.join(specsRoot, "_policies");
+  const capabilitiesPath = import_node_path25.default.join(policiesDir, "03_Capabilities.md");
   const capabilitiesExists = await exists8(capabilitiesPath);
   const capabilitiesText = await readSafe7(capabilitiesPath);
   const capIds = new Set(extractIds(capabilitiesText, "CAP"));
@@ -7379,7 +7523,7 @@ async function validatePoliciesLayerDownRef(policiesDir) {
     "04_Business-flow.md"
   ];
   for (const fileName of targets) {
-    const targetPath = import_node_path24.default.join(policiesDir, fileName);
+    const targetPath = import_node_path25.default.join(policiesDir, fileName);
     const text = await readSafe7(targetPath);
     if (text.length === 0) {
       continue;
@@ -7838,14 +7982,14 @@ function cloneGlobal3(re) {
 }
 async function readSafe7(target) {
   try {
-    return await (0, import_promises23.readFile)(target, "utf-8");
+    return await (0, import_promises24.readFile)(target, "utf-8");
   } catch {
     return "";
   }
 }
 async function exists8(target) {
   try {
-    await (0, import_promises23.access)(target);
+    await (0, import_promises24.access)(target);
     return true;
   } catch {
     return false;
@@ -7853,8 +7997,8 @@ async function exists8(target) {
 }
 
 // src/core/validators/atddCodeTraceability.ts
-var import_promises24 = require("fs/promises");
-var import_node_path25 = __toESM(require("path"), 1);
+var import_promises25 = require("fs/promises");
+var import_node_path26 = __toESM(require("path"), 1);
 async function validateAtddCodeTraceability(root, config) {
   const result = await evaluateAtddCodeTraceability(root, config);
   const issues = [];
@@ -7937,7 +8081,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",
-        import_node_path25.default.join(resolvePath(root, config, "outDir"), "atdd-traceability"),
+        import_node_path26.default.join(resolvePath(root, config, "outDir"), "atdd-traceability"),
         "atddCodeTraceability.report"
       )
     );
@@ -8003,8 +8147,8 @@ function buildUnknownIssues(unknown) {
   });
 }
 async function writeAtddTraceabilityReport(root, config, result) {
-  const outputDir = import_node_path25.default.join(resolvePath(root, config, "outDir"), "atdd-traceability");
-  await (0, import_promises24.mkdir)(outputDir, { recursive: true });
+  const outputDir = import_node_path26.default.join(resolvePath(root, config, "outDir"), "atdd-traceability");
+  await (0, import_promises25.mkdir)(outputDir, { recursive: true });
   const summary = {
     missing: {
       us: result.missing.us,
@@ -8026,13 +8170,13 @@ async function writeAtddTraceabilityReport(root, config, result) {
       globs: result.scan.globs
     }
   };
-  await (0, import_promises24.writeFile)(
-    import_node_path25.default.join(outputDir, "summary.json"),
+  await (0, import_promises25.writeFile)(
+    import_node_path26.default.join(outputDir, "summary.json"),
     `${JSON.stringify(summary, null, 2)}
 `,
     "utf-8"
   );
-  await (0, import_promises24.writeFile)(import_node_path25.default.join(outputDir, "summary.md"), buildSummaryMarkdown(summary), "utf-8");
+  await (0, import_promises25.writeFile)(import_node_path26.default.join(outputDir, "summary.md"), buildSummaryMarkdown(summary), "utf-8");
 }
 function buildSummaryMarkdown(summary) {
   const lines = [];
@@ -8097,8 +8241,8 @@ function formatError7(error) {
 }
 
 // src/core/validators/discussionPack.ts
-var import_promises25 = require("fs/promises");
-var import_node_path26 = __toESM(require("path"), 1);
+var import_promises26 = require("fs/promises");
+var import_node_path27 = __toESM(require("path"), 1);
 async function validateDiscussionPackReadiness(root, config) {
   const discussionRoot = resolvePath(root, config, "discussionDir");
   const readiness = await inspectLatestDiscussionPack(discussionRoot);
@@ -8190,7 +8334,7 @@ async function validateDiscussionPackReadiness(root, config) {
     );
   }
   if (readiness.blockingOqIds.length > 0) {
-    const oqPath = import_node_path26.default.join(readiness.latestPackDir, "11_OQ-Register.md");
+    const oqPath = import_node_path27.default.join(readiness.latestPackDir, "11_OQ-Register.md");
     issues.push(
       issue(
         "QFAI-DPACK-004",
@@ -8205,7 +8349,7 @@ async function validateDiscussionPackReadiness(root, config) {
     );
   }
   if (readiness.deferredWithoutDetails.length > 0) {
-    const deferredPath = import_node_path26.default.join(readiness.latestPackDir, "13_Deferred.md");
+    const deferredPath = import_node_path27.default.join(readiness.latestPackDir, "13_Deferred.md");
     issues.push(
       issue(
         "QFAI-DPACK-007",
@@ -8219,7 +8363,7 @@ async function validateDiscussionPackReadiness(root, config) {
       )
     );
   }
-  const storyWorkshopPath = import_node_path26.default.join(readiness.latestPackDir, "03_Story-Workshop.md");
+  const storyWorkshopPath = import_node_path27.default.join(readiness.latestPackDir, "03_Story-Workshop.md");
   const storyWorkshopText = await readSafe8(storyWorkshopPath);
   if (storyWorkshopText !== null && !containsMermaidBlock(storyWorkshopText)) {
     issues.push(
@@ -8242,32 +8386,32 @@ function containsMermaidBlock(text) {
 }
 async function readSafe8(filePath) {
   try {
-    const stats = await (0, import_promises25.stat)(filePath);
+    const stats = await (0, import_promises26.stat)(filePath);
     if (!stats.isFile()) {
       return null;
     }
-    return await (0, import_promises25.readFile)(filePath, "utf-8");
+    return await (0, import_promises26.readFile)(filePath, "utf-8");
   } catch {
     return null;
   }
 }
 
 // src/core/validators/discussionVisuals.ts
-var import_promises26 = require("fs/promises");
-var import_node_path27 = __toESM(require("path"), 1);
+var import_promises27 = require("fs/promises");
+var import_node_path28 = __toESM(require("path"), 1);
 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 = import_node_path27.default.join(root, ".qfai", "discussion");
+  const discussionRoot = import_node_path28.default.join(root, ".qfai", "discussion");
   const latestPackDir = await findLatestDiscussionPackDir(discussionRoot);
   if (!latestPackDir) {
     return [];
   }
   const issues = [];
-  const inceptionPath = import_node_path27.default.join(latestPackDir, "02_Inception-Deck.md");
+  const inceptionPath = import_node_path28.default.join(latestPackDir, "02_Inception-Deck.md");
   const inceptionText = await readSafe9(inceptionPath);
   if (inceptionText !== null && !MERMAID_FENCE_RE.test(inceptionText)) {
     issues.push(
@@ -8283,7 +8427,7 @@ async function validateDiscussionVisuals(root) {
       )
     );
   }
-  const storyWorkshopPath = import_node_path27.default.join(latestPackDir, "03_Story-Workshop.md");
+  const storyWorkshopPath = import_node_path28.default.join(latestPackDir, "03_Story-Workshop.md");
   const storyWorkshopText = await readSafe9(storyWorkshopPath);
   const storyWorkshopPlainText = storyWorkshopText === null ? null : stripFencedCodeBlocks(storyWorkshopText);
   if (storyWorkshopText === null || storyWorkshopPlainText === null) {
@@ -8347,14 +8491,14 @@ function escapeRegExp2(value) {
 }
 async function readSafe9(filePath) {
   try {
-    return await (0, import_promises26.readFile)(filePath, "utf-8");
+    return await (0, import_promises27.readFile)(filePath, "utf-8");
   } catch {
     return null;
   }
 }
 
 // src/core/validators/densityHints.ts
-var import_promises27 = require("fs/promises");
+var import_promises28 = require("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;
@@ -8453,19 +8597,19 @@ function isSeparatorRow(line) {
 }
 async function readSafe10(filePath) {
   try {
-    return await (0, import_promises27.readFile)(filePath, "utf-8");
+    return await (0, import_promises28.readFile)(filePath, "utf-8");
   } catch {
     return "";
   }
 }
 
 // src/core/validators/importLite.ts
-var import_promises28 = require("fs/promises");
-var import_node_path28 = __toESM(require("path"), 1);
-
-// src/core/validators/layerCoverage.ts
 var import_promises29 = require("fs/promises");
 var import_node_path29 = __toESM(require("path"), 1);
+
+// src/core/validators/layerCoverage.ts
+var import_promises30 = require("fs/promises");
+var import_node_path30 = __toESM(require("path"), 1);
 var ID_PATTERNS = {
   us: /^US-\d{4}(?:-\d{4})?$/,
   ac: /^AC-\d{4}(?:-\d{4})?$/,
@@ -8486,7 +8630,7 @@ async function validateLayerCoverage(root, config) {
   if (layeredEntries.length === 0) {
     return issues;
   }
-  const coverageRoot = import_node_path29.default.join(resolvePath(root, config, "outDir"), "specs-coverage");
+  const coverageRoot = import_node_path30.default.join(resolvePath(root, config, "outDir"), "specs-coverage");
   for (const entry of layeredEntries) {
     if (isV1421LayeredEntry(entry)) {
       const coverageResult = await validateV1421Coverage(entry);
@@ -8521,7 +8665,7 @@ async function validateLayerCoverage(root, config) {
 }
 async function validatePlanArtifacts(specsRoot, entries) {
   const issues = [];
-  const deprecatedPlanPath = import_node_path29.default.join(specsRoot, "plan.md");
+  const deprecatedPlanPath = import_node_path30.default.join(specsRoot, "plan.md");
   if (await exists5(deprecatedPlanPath)) {
     issues.push(
       issue(
@@ -8537,7 +8681,7 @@ async function validatePlanArtifacts(specsRoot, entries) {
     );
   }
   for (const entry of entries) {
-    const planFileName = import_node_path29.default.basename(entry.planPath).toLowerCase();
+    const planFileName = import_node_path30.default.basename(entry.planPath).toLowerCase();
     if (planFileName !== "10_plan.md") {
       continue;
     }
@@ -8918,8 +9062,8 @@ function buildSignalRows(prefix, counts, target) {
   return Array.from(counts.entries()).filter(([, count]) => count <= 1).sort((left, right) => left[0].localeCompare(right[0])).map(([id, count]) => `${prefix} signal: ${id} -> ${count} ${target}`);
 }
 async function writeCoverageReport(coverageRoot, specNumber, snapshot) {
-  await (0, import_promises29.mkdir)(coverageRoot, { recursive: true });
-  const reportPath = import_node_path29.default.join(coverageRoot, `spec-${specNumber}.md`);
+  await (0, import_promises30.mkdir)(coverageRoot, { recursive: true });
+  const reportPath = import_node_path30.default.join(coverageRoot, `spec-${specNumber}.md`);
   const lines = [];
   lines.push(`# Spec Coverage (spec-${specNumber})`);
   lines.push("");
@@ -8957,14 +9101,14 @@ async function writeCoverageReport(coverageRoot, specNumber, snapshot) {
     }
   }
   lines.push("");
-  await (0, import_promises29.writeFile)(reportPath, `${lines.join("\n")}
+  await (0, import_promises30.writeFile)(reportPath, `${lines.join("\n")}
 `, "utf-8");
 }
 function isV1421LayeredEntry(entry) {
   if (entry.layeredStyle === "v1421") {
     return true;
   }
-  return import_node_path29.default.extname(entry.examplesPath).toLowerCase() === ".md";
+  return import_node_path30.default.extname(entry.examplesPath).toLowerCase() === ".md";
 }
 function extractHeadings(text) {
   const headings = [];
@@ -9155,8 +9299,8 @@ async function validateExToTcCoverage(examplesPath, testCasesPath) {
 }
 
 // src/core/validators/layeredTraceability.ts
-var import_promises30 = require("fs/promises");
-var import_node_path30 = __toESM(require("path"), 1);
+var import_promises31 = require("fs/promises");
+var import_node_path31 = __toESM(require("path"), 1);
 var POLICIES_FILES = [
   "01_Objective.md",
   "02_Initiative.md",
@@ -9205,7 +9349,7 @@ async function validateLayeredTraceability(root, config) {
   }
   const issues = [];
   if (layeredV1417Entries.length > 0) {
-    const policiesDir = layeredV1417Entries[0]?.sharedDir ?? import_node_path30.default.join(specsRoot, "_policies");
+    const policiesDir = layeredV1417Entries[0]?.sharedDir ?? import_node_path31.default.join(specsRoot, "_policies");
     issues.push(...await validatePoliciesDownstreamReferences(policiesDir));
     for (const entry of layeredV1417Entries) {
       issues.push(...await validateSpecRootParent(entry));
@@ -9246,7 +9390,7 @@ async function validateLayeredTraceability(root, config) {
     }
   }
   if (layeredV1421Entries.length > 0) {
-    const policiesDir = layeredV1421Entries[0]?.sharedDir ?? import_node_path30.default.join(specsRoot, "_policies");
+    const policiesDir = layeredV1421Entries[0]?.sharedDir ?? import_node_path31.default.join(specsRoot, "_policies");
     issues.push(...await validatePoliciesScopeForV1421(policiesDir));
     for (const entry of layeredV1421Entries) {
       issues.push(...await validateDownstreamRefsForV1421(entry));
@@ -9257,7 +9401,7 @@ async function validateLayeredTraceability(root, config) {
 async function validatePoliciesDownstreamReferences(policiesDir) {
   const issues = [];
   for (const fileName of POLICIES_FILES) {
-    const filePath = import_node_path30.default.join(policiesDir, fileName);
+    const filePath = import_node_path31.default.join(policiesDir, fileName);
     const text = await readSafe(filePath);
     if (text.trim().length === 0) {
       continue;
@@ -9330,7 +9474,7 @@ async function validateDownstreamRefsForV1421(entry) {
     issues.push(
       issue(
         "TRACE_DOWNSTREAM_REF",
-        `${import_node_path30.default.basename(check.filePath)} \u3067\u4E0B\u4F4D\u30EC\u30A4\u30E4\u30FC\u53C2\u7167\u306F\u7981\u6B62\u3067\u3059: ${refs.join(", ")}`,
+        `${import_node_path31.default.basename(check.filePath)} \u3067\u4E0B\u4F4D\u30EC\u30A4\u30E4\u30FC\u53C2\u7167\u306F\u7981\u6B62\u3067\u3059: ${refs.join(", ")}`,
         "error",
         check.filePath,
         "layeredTraceability.downstream",
@@ -9359,14 +9503,14 @@ function resolveLayerFromId(id) {
 }
 async function collectMarkdownFiles(policiesDir) {
   try {
-    const entries = await (0, import_promises30.readdir)(policiesDir, { withFileTypes: true });
-    return entries.filter((entry) => entry.isFile() && import_node_path30.default.extname(entry.name).toLowerCase() === ".md").map((entry) => import_node_path30.default.join(policiesDir, entry.name)).sort((left, right) => left.localeCompare(right));
+    const entries = await (0, import_promises31.readdir)(policiesDir, { withFileTypes: true });
+    return entries.filter((entry) => entry.isFile() && import_node_path31.default.extname(entry.name).toLowerCase() === ".md").map((entry) => import_node_path31.default.join(policiesDir, entry.name)).sort((left, right) => left.localeCompare(right));
   } catch {
     return [];
   }
 }
 async function validateSpecRootParent(entry) {
-  const specPath = import_node_path30.default.join(entry.dir, "01_Spec.md");
+  const specPath = import_node_path31.default.join(entry.dir, "01_Spec.md");
   const text = await readSafe(specPath);
   if (text.trim().length > 0 && /\bCAP-\d{4}\b/.test(text)) {
     return [];
@@ -9466,11 +9610,11 @@ async function validateForbiddenRefs(filePath, pattern, messagePrefix) {
 }
 
 // src/core/validators/legacyStatusDir.ts
-var import_promises31 = require("fs/promises");
-var import_node_path31 = __toESM(require("path"), 1);
+var import_promises32 = require("fs/promises");
+var import_node_path32 = __toESM(require("path"), 1);
 var BASELINE_STATUS_ARTIFACTS = /* @__PURE__ */ new Set(["README.md", ".gitignore"]);
 async function validateLegacyStatusDir(root) {
-  const statusDir = import_node_path31.default.join(root, ".qfai", "status");
+  const statusDir = import_node_path32.default.join(root, ".qfai", "status");
   if (!await isDirectory(statusDir)) {
     return [];
   }
@@ -9507,7 +9651,7 @@ async function validateLegacyStatusDir(root) {
 }
 async function listStatusArtifacts(statusDir) {
   try {
-    const entries = await (0, import_promises31.readdir)(statusDir, { withFileTypes: true });
+    const entries = await (0, import_promises32.readdir)(statusDir, { withFileTypes: true });
     return entries.map((entry) => entry.isDirectory() ? `${entry.name}/` : entry.name).sort((left, right) => left.localeCompare(right));
   } catch {
     return [];
@@ -9515,22 +9659,22 @@ async function listStatusArtifacts(statusDir) {
 }
 async function isDirectory(target) {
   try {
-    return (await (0, import_promises31.stat)(target)).isDirectory();
+    return (await (0, import_promises32.stat)(target)).isDirectory();
   } catch {
     return false;
   }
 }
 
 // src/core/validators/mermaidEnforcement.ts
-var import_promises32 = require("fs/promises");
-var import_node_path32 = __toESM(require("path"), 1);
+var import_promises33 = require("fs/promises");
+var import_node_path33 = __toESM(require("path"), 1);
 var TARGETS = [
   { segments: [".qfai", "specs"], extensions: [".md", ".feature"] },
   { segments: [".qfai", "discussion"], extensions: [".md"] }
 ];
 var BUSINESS_FLOW_RELATIVE_CANDIDATES = [
-  import_node_path32.default.join(".qfai", "specs", "_policies", "04_Business-Flow.md"),
-  import_node_path32.default.join(".qfai", "specs", "_policies", "04_Business-flow.md")
+  import_node_path33.default.join(".qfai", "specs", "_policies", "04_Business-Flow.md"),
+  import_node_path33.default.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;
@@ -9540,13 +9684,13 @@ async function validateMermaidEnforcement(root) {
   const issues = [];
   const scanResults = /* @__PURE__ */ new Map();
   for (const filePath of targetFiles) {
-    const text = await (0, import_promises32.readFile)(filePath, "utf-8");
+    const text = await (0, import_promises33.readFile)(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 (0, import_promises32.readFile)(businessFlowPath, "utf-8"));
+    const businessFlowScan = scanResults.get(businessFlowPath) ?? scanMermaidUsage(businessFlowPath, await (0, import_promises33.readFile)(businessFlowPath, "utf-8"));
     if (businessFlowScan.mermaidFenceCount === 0) {
       issues.push(
         issue(
@@ -9574,7 +9718,7 @@ async function validateMermaidEnforcement(root) {
         )
       );
     }
-    if (import_node_path32.default.basename(businessFlowPath) === "04_Business-flow.md") {
+    if (import_node_path33.default.basename(businessFlowPath) === "04_Business-flow.md") {
       issues.push(
         issue(
           "QFAI-MMD-005",
@@ -9595,14 +9739,14 @@ async function validateMermaidEnforcement(root) {
 async function collectTargetFiles(root) {
   const files = [];
   for (const target of TARGETS) {
-    const targetDir = import_node_path32.default.join(root, ...target.segments);
+    const targetDir = import_node_path33.default.join(root, ...target.segments);
     files.push(
       ...await collectFiles(targetDir, {
         extensions: [...target.extensions]
       })
     );
   }
-  return Array.from(new Set(files)).filter((filePath) => import_node_path32.default.basename(filePath).toLowerCase() !== "readme.md").sort((a, b) => a.localeCompare(b));
+  return Array.from(new Set(files)).filter((filePath) => import_node_path33.default.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");
@@ -9692,13 +9836,13 @@ function parseFenceStart(line) {
   };
 }
 async function collectDeprecatedBusinessFlowFeatureWarnings(root) {
-  const policiesDir = import_node_path32.default.join(root, ".qfai", "specs", "_policies");
+  const policiesDir = import_node_path33.default.join(root, ".qfai", "specs", "_policies");
   const featureFiles = await collectFiles(policiesDir, {
     extensions: [".feature"]
   });
   const issues = [];
   for (const filePath of featureFiles) {
-    if (!/business-flow/i.test(import_node_path32.default.basename(filePath))) {
+    if (!/business-flow/i.test(import_node_path33.default.basename(filePath))) {
       continue;
     }
     issues.push(
@@ -9718,7 +9862,7 @@ async function collectDeprecatedBusinessFlowFeatureWarnings(root) {
 }
 async function resolveBusinessFlowPath(root) {
   for (const relativePath of BUSINESS_FLOW_RELATIVE_CANDIDATES) {
-    const target = import_node_path32.default.join(root, relativePath);
+    const target = import_node_path33.default.join(root, relativePath);
     if (await exists5(target)) {
       return target;
     }
@@ -9856,7 +10000,7 @@ function normalizeHeaderKey(column) {
 }
 
 // src/core/validators/orphanProhibition.ts
-var import_node_path33 = __toESM(require("path"), 1);
+var import_node_path34 = __toESM(require("path"), 1);
 async function validateOrphanProhibition(root, config) {
   const specsRoot = resolvePath(root, config, "specsDir");
   const entries = await collectSpecEntries(specsRoot);
@@ -9867,9 +10011,9 @@ async function validateOrphanProhibition(root, config) {
     return [];
   }
   const issues = [];
-  const policiesDir = layeredEntries[0]?.sharedDir ?? import_node_path33.default.join(specsRoot, "_policies");
+  const policiesDir = layeredEntries[0]?.sharedDir ?? import_node_path34.default.join(specsRoot, "_policies");
   const capIds = new Set(
-    uniqueMatches(await readSafe(import_node_path33.default.join(policiesDir, "03_Capabilities.md")), /\bCAP-\d{4}\b/g)
+    uniqueMatches(await readSafe(import_node_path34.default.join(policiesDir, "03_Capabilities.md")), /\bCAP-\d{4}\b/g)
   );
   for (const entry of layeredEntries) {
     const usItems = collectMarkdownItems(await readSafe(entry.userStoriesPath), "US");
@@ -10019,8 +10163,8 @@ function validateExParentExists(filePath, exItems, acIds, brIds) {
 }
 
 // src/core/validators/prototypingEvidence.ts
-var import_promises33 = require("fs/promises");
-var import_node_path34 = __toESM(require("path"), 1);
+var import_promises34 = require("fs/promises");
+var import_node_path35 = __toESM(require("path"), 1);
 var EVIDENCE_MARKDOWN_FILE = "prototyping.md";
 var EVIDENCE_JSON_FILE = "prototyping.json";
 async function validatePrototypingEvidence(root, config) {
@@ -10029,10 +10173,10 @@ async function validatePrototypingEvidence(root, config) {
   if (specEntries.length === 0) {
     return [];
   }
-  const qfaiRoot = import_node_path34.default.dirname(specsRoot);
-  const evidenceRoot = import_node_path34.default.join(qfaiRoot, "evidence");
-  const evidenceMarkdownPath = import_node_path34.default.join(evidenceRoot, EVIDENCE_MARKDOWN_FILE);
-  const evidenceJsonPath = import_node_path34.default.join(evidenceRoot, EVIDENCE_JSON_FILE);
+  const qfaiRoot = import_node_path35.default.dirname(specsRoot);
+  const evidenceRoot = import_node_path35.default.join(qfaiRoot, "evidence");
+  const evidenceMarkdownPath = import_node_path35.default.join(evidenceRoot, EVIDENCE_MARKDOWN_FILE);
+  const evidenceJsonPath = import_node_path35.default.join(evidenceRoot, EVIDENCE_JSON_FILE);
   const [markdownRaw, jsonRaw] = await Promise.all([
     readSafe11(evidenceMarkdownPath),
     readSafe11(evidenceJsonPath)
@@ -10209,7 +10353,7 @@ function extractSpecRefs(rows) {
 }
 async function readSafe11(filePath) {
   try {
-    return await (0, import_promises33.readFile)(filePath, "utf-8");
+    return await (0, import_promises34.readFile)(filePath, "utf-8");
   } catch {
     return null;
   }
@@ -10365,7 +10509,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(import_node_path34.default.relative(root, contractFile)) : void 0;
+    const contractRefFile = contractFile ? toPosixPath3(import_node_path35.default.relative(root, contractFile)) : void 0;
     if (!contractFiles || contractFiles.size === 0) {
       mismatches.push({
         contractId: screen.uiContractId,
@@ -11174,9 +11318,9 @@ async function collectMissingRenderArtifacts(root, render) {
     { label: "htmlPath", target: render.htmlPath }
   ];
   for (const candidate of candidates) {
-    const resolved = import_node_path34.default.isAbsolute(candidate.target) ? candidate.target : import_node_path34.default.resolve(root, candidate.target);
+    const resolved = import_node_path35.default.isAbsolute(candidate.target) ? candidate.target : import_node_path35.default.resolve(root, candidate.target);
     try {
-      await (0, import_promises33.access)(resolved);
+      await (0, import_promises34.access)(resolved);
     } catch {
       missing.push(candidate.label);
     }
@@ -11197,12 +11341,12 @@ function formatError9(error) {
 }
 
 // src/core/validators/requireIndex.ts
-var import_promises34 = require("fs/promises");
-var import_node_path35 = __toESM(require("path"), 1);
-
-// src/core/validators/repositoryHygiene.ts
 var import_promises35 = require("fs/promises");
 var import_node_path36 = __toESM(require("path"), 1);
+
+// src/core/validators/repositoryHygiene.ts
+var import_promises36 = require("fs/promises");
+var import_node_path37 = __toESM(require("path"), 1);
 var LEGACY_DIR_RULES = [
   { legacy: "discussions", canonical: "discussion" },
   { legacy: "discuss", canonical: "discussion" },
@@ -11213,11 +11357,11 @@ var LEGACY_DIR_RULES = [
 ];
 var SUSPICIOUS_TEMPLATE_NAME_RE = /^(?:_?templates?|_?sample(?:s)?|sample-template)$/i;
 async function validateRepositoryHygiene(root, config) {
-  const qfaiRoot = import_node_path36.default.join(root, ".qfai");
+  const qfaiRoot = import_node_path37.default.join(root, ".qfai");
   const specsRoot = resolvePath(root, config, "specsDir");
   const issues = [];
   for (const rule of LEGACY_DIR_RULES) {
-    const legacyPath = import_node_path36.default.join(qfaiRoot, rule.legacy);
+    const legacyPath = import_node_path37.default.join(qfaiRoot, rule.legacy);
     if (!await isDirectory2(legacyPath)) {
       continue;
     }
@@ -11264,7 +11408,7 @@ async function collectSuspiciousTemplatePaths(root) {
     }
     let entries = [];
     try {
-      entries = await (0, import_promises35.readdir)(current, {
+      entries = await (0, import_promises36.readdir)(current, {
         withFileTypes: true,
         encoding: "utf8"
       });
@@ -11272,10 +11416,10 @@ async function collectSuspiciousTemplatePaths(root) {
       continue;
     }
     for (const entry of entries) {
-      const absolute = import_node_path36.default.join(current, entry.name);
+      const absolute = import_node_path37.default.join(current, entry.name);
       if (entry.isDirectory()) {
         if (SUSPICIOUS_TEMPLATE_NAME_RE.test(entry.name)) {
-          matches.push(toPosix(import_node_path36.default.relative(root, absolute)));
+          matches.push(toPosix(import_node_path37.default.relative(root, absolute)));
         }
         queue.push(absolute);
         continue;
@@ -11283,9 +11427,9 @@ async function collectSuspiciousTemplatePaths(root) {
       if (!entry.isFile()) {
         continue;
       }
-      const baseName = import_node_path36.default.parse(entry.name).name;
+      const baseName = import_node_path37.default.parse(entry.name).name;
       if (SUSPICIOUS_TEMPLATE_NAME_RE.test(baseName)) {
-        matches.push(toPosix(import_node_path36.default.relative(root, absolute)));
+        matches.push(toPosix(import_node_path37.default.relative(root, absolute)));
       }
     }
   }
@@ -11293,7 +11437,7 @@ async function collectSuspiciousTemplatePaths(root) {
 }
 async function isDirectory2(target) {
   try {
-    return (await (0, import_promises35.stat)(target)).isDirectory();
+    return (await (0, import_promises36.stat)(target)).isDirectory();
   } catch {
     return false;
   }
@@ -11303,7 +11447,7 @@ function toPosix(value) {
 }
 
 // src/core/validators/specSplitByCapability.ts
-var import_node_path37 = __toESM(require("path"), 1);
+var import_node_path38 = __toESM(require("path"), 1);
 var CAP_ID_RE2 = /\bCAP-\d{4}\b/g;
 async function validateSpecSplitByCapability(root, config) {
   const specsRoot = resolvePath(root, config, "specsDir");
@@ -11314,8 +11458,8 @@ async function validateSpecSplitByCapability(root, config) {
   if (layeredEntries.length === 0) {
     return [];
   }
-  const policiesDir = layeredEntries[0]?.sharedDir ?? import_node_path37.default.join(specsRoot, "_policies");
-  const capabilitiesPath = import_node_path37.default.join(policiesDir, "03_Capabilities.md");
+  const policiesDir = layeredEntries[0]?.sharedDir ?? import_node_path38.default.join(specsRoot, "_policies");
+  const capabilitiesPath = import_node_path38.default.join(policiesDir, "03_Capabilities.md");
   const capabilityText = await readSafe(capabilitiesPath);
   const issues = [];
   if (!await exists5(capabilitiesPath)) {
@@ -11355,7 +11499,7 @@ async function validateSpecSplitByCapability(root, config) {
     );
   }
   const actualSpecIds = new Set(
-    layeredEntries.map((entry) => import_node_path37.default.basename(entry.dir).toLowerCase())
+    layeredEntries.map((entry) => import_node_path38.default.basename(entry.dir).toLowerCase())
   );
   const expectedSpecIds = capIds.map((_, index) => `spec-${to4(index + 1)}`);
   const missingSpecIds = expectedSpecIds.filter((specId) => !actualSpecIds.has(specId));
@@ -11392,11 +11536,11 @@ async function validateSpecSplitByCapability(root, config) {
       continue;
     }
     const specId = `spec-${to4(index + 1)}`;
-    const entry = layeredEntries.find((value) => import_node_path37.default.basename(value.dir).toLowerCase() === specId);
+    const entry = layeredEntries.find((value) => import_node_path38.default.basename(value.dir).toLowerCase() === specId);
     if (!entry) {
       continue;
     }
-    const specFilePath = import_node_path37.default.join(entry.dir, "01_Spec.md");
+    const specFilePath = import_node_path38.default.join(entry.dir, "01_Spec.md");
     const specText = await readSafe(specFilePath);
     if (specText.trim().length === 0 || !specText.includes(capId)) {
       issues.push(
@@ -11415,8 +11559,8 @@ async function validateSpecSplitByCapability(root, config) {
 }
 
 // src/core/validators/statusInSpecs.ts
-var import_promises36 = require("fs/promises");
-var import_node_path38 = __toESM(require("path"), 1);
+var import_promises37 = require("fs/promises");
+var import_node_path39 = __toESM(require("path"), 1);
 var STRONG_PATTERNS = [
   { label: "release_candidate:", pattern: /\brelease_candidate\s*:/i },
   { label: "status:", pattern: /^\s*(?:-\s*)?status\s*:/im },
@@ -11473,23 +11617,23 @@ function hasMatch(text, pattern) {
 }
 async function readSafe12(filePath) {
   try {
-    return await (0, import_promises36.readFile)(filePath, "utf-8");
+    return await (0, import_promises37.readFile)(filePath, "utf-8");
   } catch {
     return "";
   }
 }
 function isOpenQuestionsFile(filePath) {
-  return /open-questions\.md$/i.test(import_node_path38.default.basename(filePath));
+  return /open-questions\.md$/i.test(import_node_path39.default.basename(filePath));
 }
 
 // src/core/validators/designToken.ts
-var import_promises37 = require("fs/promises");
-var import_node_path39 = __toESM(require("path"), 1);
+var import_promises38 = require("fs/promises");
+var import_node_path40 = __toESM(require("path"), 1);
 var import_fast_glob2 = __toESM(require("fast-glob"), 1);
-var import_yaml6 = require("yaml");
+var import_yaml7 = require("yaml");
 
 // src/core/parse/designToken.ts
-var import_yaml5 = require("yaml");
+var import_yaml6 = require("yaml");
 var REF_PATTERN = /\{([^}]+)\}/g;
 var MAX_RESOLVE_DEPTH = 10;
 function parseDesignToken(yamlContent) {
@@ -11502,7 +11646,7 @@ function parseDesignToken(yamlContent) {
   };
   let parsed;
   try {
-    parsed = (0, import_yaml5.parse)(yamlContent);
+    parsed = (0, import_yaml6.parse)(yamlContent);
   } catch (error) {
     const msg = error instanceof Error ? error.message : String(error);
     result.errors.push({ message: `YAML parse error: ${msg}` });
@@ -11531,7 +11675,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) {
@@ -11547,9 +11691,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);
       }
     }
   }
@@ -11559,44 +11703,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];
@@ -11604,8 +11748,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;
     }
@@ -11614,7 +11758,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) {
@@ -11669,8 +11813,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 ? import_node_path39.default.resolve(root, configuredDir) : import_node_path39.default.join(root, config.paths.contractsDir, "design");
-  const pattern = import_node_path39.default.posix.join(designDir.replace(/\\/g, "/"), "design-tokens*.yaml");
+  const designDir = configuredDir ? import_node_path40.default.resolve(root, configuredDir) : import_node_path40.default.join(root, config.paths.contractsDir, "design");
+  const pattern = import_node_path40.default.posix.join(designDir.replace(/\\/g, "/"), "design-tokens*.yaml");
   const files = await (0, import_fast_glob2.default)(pattern, {
     absolute: true,
     ignore: ["**/*.schema.yaml", "**/*.schema.yml"]
@@ -11680,11 +11824,11 @@ async function validateDesignToken(root, config) {
   }
   const issues = [];
   for (const filePath of files) {
-    const rel = import_node_path39.default.relative(root, filePath).replace(/\\/g, "/");
+    const rel = import_node_path40.default.relative(root, filePath).replace(/\\/g, "/");
     let hasRootObjectError = false;
     let content;
     try {
-      content = await (0, import_promises37.readFile)(filePath, "utf-8");
+      content = await (0, import_promises38.readFile)(filePath, "utf-8");
     } catch {
       issues.push(
         issue(
@@ -11698,7 +11842,7 @@ async function validateDesignToken(root, config) {
       continue;
     }
     try {
-      const parsed = (0, import_yaml6.parse)(content);
+      const parsed = (0, import_yaml7.parse)(content);
       if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
         hasRootObjectError = true;
         issues.push(
@@ -11847,8 +11991,8 @@ function normalizePlatform(value) {
 }
 
 // src/core/validators/htmlMock.ts
-var import_promises38 = require("fs/promises");
-var import_node_path40 = __toESM(require("path"), 1);
+var import_promises39 = require("fs/promises");
+var import_node_path41 = __toESM(require("path"), 1);
 var import_fast_glob3 = __toESM(require("fast-glob"), 1);
 
 // src/core/uiux/contrastRatio.ts
@@ -12228,19 +12372,19 @@ async function validateHtmlMock(root, platform, config) {
   const startTime = performance.now();
   const budget = config.uiux?.htmlMockTimeout ?? 2e3;
   const patterns = [
-    import_node_path40.default.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md"),
-    import_node_path40.default.posix.join(root.replace(/\\/g, "/"), config.paths.specsDir, "**/*.md")
+    import_node_path41.default.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md"),
+    import_node_path41.default.posix.join(root.replace(/\\/g, "/"), config.paths.specsDir, "**/*.md")
   ];
   const files = await (0, import_fast_glob3.default)(patterns, { absolute: true });
   const mockBlocks = [];
   for (const filePath of files) {
     let content;
     try {
-      content = await (0, import_promises38.readFile)(filePath, "utf-8");
+      content = await (0, import_promises39.readFile)(filePath, "utf-8");
     } catch {
       continue;
     }
-    const rel = import_node_path40.default.relative(root, filePath).replace(/\\/g, "/");
+    const rel = import_node_path41.default.relative(root, filePath).replace(/\\/g, "/");
     for (const block of collectHtmlMockBlocks(content)) {
       mockBlocks.push({ file: rel, html: block.html, rawBlock: block.rawBlock });
     }
@@ -12406,8 +12550,8 @@ async function validateHtmlMock(root, platform, config) {
 }
 
 // src/core/validators/mermaidScreenFlow.ts
-var import_promises39 = require("fs/promises");
-var import_node_path41 = __toESM(require("path"), 1);
+var import_promises40 = require("fs/promises");
+var import_node_path42 = __toESM(require("path"), 1);
 var import_fast_glob4 = __toESM(require("fast-glob"), 1);
 
 // src/core/validators/mermaidUtils.ts
@@ -12458,18 +12602,18 @@ var FLOWCHART_RE = /^\s*flowchart\s+(TD|LR|TB|RL|BT)\b/;
 async function validateMermaidScreenFlow(root, config) {
   const issues = [];
   const patterns = [
-    import_node_path41.default.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md"),
-    import_node_path41.default.posix.join(root.replace(/\\/g, "/"), config.paths.specsDir, "**/*.md")
+    import_node_path42.default.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md"),
+    import_node_path42.default.posix.join(root.replace(/\\/g, "/"), config.paths.specsDir, "**/*.md")
   ];
   const files = await (0, import_fast_glob4.default)(patterns, { absolute: true });
   for (const filePath of files) {
     let content;
     try {
-      content = await (0, import_promises39.readFile)(filePath, "utf-8");
+      content = await (0, import_promises40.readFile)(filePath, "utf-8");
     } catch {
       continue;
     }
-    const rel = import_node_path41.default.relative(root, filePath).replace(/\\/g, "/");
+    const rel = import_node_path42.default.relative(root, filePath).replace(/\\/g, "/");
     const blocks = extractFencedCodeBlocks(content);
     for (const block of blocks) {
       if (block.language !== "mermaid") continue;
@@ -12567,10 +12711,10 @@ function parseTransitions(content) {
 }
 
 // src/core/validators/bpApDb.ts
-var import_promises40 = require("fs/promises");
-var import_node_path42 = __toESM(require("path"), 1);
+var import_promises41 = require("fs/promises");
+var import_node_path43 = __toESM(require("path"), 1);
 var import_fast_glob5 = __toESM(require("fast-glob"), 1);
-var import_yaml7 = require("yaml");
+var import_yaml8 = require("yaml");
 var BP_ID_RE = /^BP-\d{4}$/;
 var AP_ID_RE = /^AP-\d{4}$/;
 var VALID_SEVERITIES = ["critical", "major", "minor"];
@@ -12605,9 +12749,9 @@ var AP_REQUIRED_FIELDS = [
 ];
 async function validateBpApDb(root, config) {
   const issues = [];
-  const designDir = import_node_path42.default.join(root, config.paths.contractsDir, "design");
-  const bpPattern = import_node_path42.default.posix.join(designDir.replace(/\\/g, "/"), "best-practices*.yaml");
-  const apPattern = import_node_path42.default.posix.join(designDir.replace(/\\/g, "/"), "anti-patterns*.yaml");
+  const designDir = import_node_path43.default.join(root, config.paths.contractsDir, "design");
+  const bpPattern = import_node_path43.default.posix.join(designDir.replace(/\\/g, "/"), "best-practices*.yaml");
+  const apPattern = import_node_path43.default.posix.join(designDir.replace(/\\/g, "/"), "anti-patterns*.yaml");
   const globOptions = {
     absolute: true,
     ignore: ["**/*.schema.yaml", "**/*.schema.yml"]
@@ -12620,14 +12764,14 @@ async function validateBpApDb(root, config) {
   const seenBpIds = /* @__PURE__ */ new Set();
   const seenApIds = /* @__PURE__ */ new Set();
   for (const filePath of bpFiles) {
-    const rel = import_node_path42.default.relative(root, filePath).replace(/\\/g, "/");
+    const rel = import_node_path43.default.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 = import_node_path42.default.relative(root, filePath).replace(/\\/g, "/");
+    const rel = import_node_path43.default.relative(root, filePath).replace(/\\/g, "/");
     const entries = await parseRuleFile(filePath, rel, issues);
     for (const entry of entries) {
       validateApEntry(entry, rel, seenApIds, issues);
@@ -12638,7 +12782,7 @@ async function validateBpApDb(root, config) {
 async function parseRuleFile(filePath, rel, issues) {
   let content;
   try {
-    content = await (0, import_promises40.readFile)(filePath, "utf-8");
+    content = await (0, import_promises41.readFile)(filePath, "utf-8");
   } catch {
     issues.push(
       issue("QFAI-BPAP-001", `BP/AP file unreadable: ${rel}`, "error", rel, "bpApDb.readFile")
@@ -12647,7 +12791,7 @@ async function parseRuleFile(filePath, rel, issues) {
   }
   let parsed;
   try {
-    parsed = (0, import_yaml7.parse)(content);
+    parsed = (0, import_yaml8.parse)(content);
   } catch (error) {
     issues.push(
       issue(
@@ -12802,8 +12946,8 @@ function toSafeString(value) {
 }
 
 // src/core/validators/platformDetection.ts
-var import_promises41 = require("fs/promises");
-var import_node_path43 = __toESM(require("path"), 1);
+var import_promises42 = require("fs/promises");
+var import_node_path44 = __toESM(require("path"), 1);
 var KNOWN_PLATFORMS = ["web", "windows", "mobile-ios", "mobile-android", "cross-platform"];
 async function detectPlatform(root, config, cliPlatform) {
   const issues = [];
@@ -12846,13 +12990,13 @@ async function detectPlatform(root, config, cliPlatform) {
   return { platform: "web", source: "fallback", issues };
 }
 async function inferPlatform(root, issues) {
-  if (await exists5(import_node_path43.default.join(root, "pubspec.yaml"))) {
-    const hasAndroid = await exists5(import_node_path43.default.join(root, "android"));
-    const hasIos = await exists5(import_node_path43.default.join(root, "ios"));
-    const hasWeb = await exists5(import_node_path43.default.join(root, "web"));
-    const hasWindows = await exists5(import_node_path43.default.join(root, "windows"));
-    const hasMacos = await exists5(import_node_path43.default.join(root, "macos"));
-    const hasLinux = await exists5(import_node_path43.default.join(root, "linux"));
+  if (await exists5(import_node_path44.default.join(root, "pubspec.yaml"))) {
+    const hasAndroid = await exists5(import_node_path44.default.join(root, "android"));
+    const hasIos = await exists5(import_node_path44.default.join(root, "ios"));
+    const hasWeb = await exists5(import_node_path44.default.join(root, "web"));
+    const hasWindows = await exists5(import_node_path44.default.join(root, "windows"));
+    const hasMacos = await exists5(import_node_path44.default.join(root, "macos"));
+    const hasLinux = await exists5(import_node_path44.default.join(root, "linux"));
     const mobileTargets = [hasAndroid, hasIos].filter(Boolean).length;
     const desktopTargets = [hasWeb, hasWindows, hasMacos, hasLinux].filter(Boolean).length;
     if (mobileTargets + desktopTargets > 1) {
@@ -12872,10 +13016,10 @@ async function inferPlatform(root, issues) {
     }
     return null;
   }
-  const pkgJsonPath = import_node_path43.default.join(root, "package.json");
+  const pkgJsonPath = import_node_path44.default.join(root, "package.json");
   if (await exists5(pkgJsonPath)) {
     try {
-      const raw = await (0, import_promises41.readFile)(pkgJsonPath, "utf-8");
+      const raw = await (0, import_promises42.readFile)(pkgJsonPath, "utf-8");
       const pkg = JSON.parse(raw);
       const deps = {
         ...typeof pkg.dependencies === "object" && pkg.dependencies !== null ? pkg.dependencies : {},
@@ -12894,8 +13038,8 @@ async function inferPlatform(root, issues) {
         return "cross-platform";
       }
       if ("react-native" in deps) {
-        const hasAndroid = await exists5(import_node_path43.default.join(root, "android"));
-        const hasIos = await exists5(import_node_path43.default.join(root, "ios"));
+        const hasAndroid = await exists5(import_node_path44.default.join(root, "android"));
+        const hasIos = await exists5(import_node_path44.default.join(root, "ios"));
         if (hasAndroid && hasIos) {
           return "cross-platform";
         }
@@ -12917,15 +13061,15 @@ function normalizePlatformInput(platform) {
 }
 
 // src/core/validators/uiDefinitionConsistency.ts
-var import_promises42 = require("fs/promises");
-var import_node_path44 = __toESM(require("path"), 1);
+var import_promises43 = require("fs/promises");
+var import_node_path45 = __toESM(require("path"), 1);
 var import_fast_glob6 = __toESM(require("fast-glob"), 1);
-var import_yaml8 = require("yaml");
+var import_yaml9 = require("yaml");
 async function validateUiDefinitionConsistency(root, config) {
   const issues = [];
   const configuredDir = config.uiux?.designTokensDir;
-  const designDir = configuredDir ? import_node_path44.default.resolve(root, configuredDir) : import_node_path44.default.join(root, config.paths.contractsDir, "design");
-  const tokenPattern = import_node_path44.default.posix.join(designDir.replace(/\\/g, "/"), "design-tokens*.yaml");
+  const designDir = configuredDir ? import_node_path45.default.resolve(root, configuredDir) : import_node_path45.default.join(root, config.paths.contractsDir, "design");
+  const tokenPattern = import_node_path45.default.posix.join(designDir.replace(/\\/g, "/"), "design-tokens*.yaml");
   const tokenFiles = await (0, import_fast_glob6.default)(tokenPattern, {
     absolute: true,
     ignore: ["**/*.schema.yaml", "**/*.schema.yml"]
@@ -12933,7 +13077,7 @@ async function validateUiDefinitionConsistency(root, config) {
   const resolvedTokens = /* @__PURE__ */ new Map();
   for (const tokenFile of tokenFiles) {
     try {
-      const content = await (0, import_promises42.readFile)(tokenFile, "utf-8");
+      const content = await (0, import_promises43.readFile)(tokenFile, "utf-8");
       const result = parseDesignToken(content);
       for (const [key, val] of result.resolved) {
         resolvedTokens.set(key, val);
@@ -12941,14 +13085,14 @@ async function validateUiDefinitionConsistency(root, config) {
     } catch {
     }
   }
-  const uiContractDir = import_node_path44.default.join(root, config.paths.contractsDir, "ui");
-  const uiPattern = import_node_path44.default.posix.join(uiContractDir.replace(/\\/g, "/"), "**/*.yaml");
+  const uiContractDir = import_node_path45.default.join(root, config.paths.contractsDir, "ui");
+  const uiPattern = import_node_path45.default.posix.join(uiContractDir.replace(/\\/g, "/"), "**/*.yaml");
   const uiFiles = await (0, import_fast_glob6.default)(uiPattern, { absolute: true });
   const contractScreenIds = /* @__PURE__ */ new Set();
   for (const uiFile of uiFiles) {
     try {
-      const content = await (0, import_promises42.readFile)(uiFile, "utf-8");
-      const parsed = (0, import_yaml8.parse)(content);
+      const content = await (0, import_promises43.readFile)(uiFile, "utf-8");
+      const parsed = (0, import_yaml9.parse)(content);
       if (parsed && typeof parsed === "object") {
         const screens = parsed.screens;
         if (Array.isArray(screens)) {
@@ -12963,15 +13107,15 @@ async function validateUiDefinitionConsistency(root, config) {
     }
   }
   const mdPatterns = [
-    import_node_path44.default.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md"),
-    import_node_path44.default.posix.join(root.replace(/\\/g, "/"), config.paths.specsDir, "**/*.md")
+    import_node_path45.default.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md"),
+    import_node_path45.default.posix.join(root.replace(/\\/g, "/"), config.paths.specsDir, "**/*.md")
   ];
   const mdFiles = await (0, import_fast_glob6.default)(mdPatterns, { absolute: true });
   const mockScreenIds = /* @__PURE__ */ new Set();
   for (const mdFile of mdFiles) {
     try {
-      const content = await (0, import_promises42.readFile)(mdFile, "utf-8");
-      const rel = import_node_path44.default.relative(root, mdFile).replace(/\\/g, "/");
+      const content = await (0, import_promises43.readFile)(mdFile, "utf-8");
+      const rel = import_node_path45.default.relative(root, mdFile).replace(/\\/g, "/");
       const htmlBlocks = collectHtmlMockBlocks(content);
       if (resolvedTokens.size > 0) {
         for (const htmlBlock of htmlBlocks) {
@@ -13028,8 +13172,8 @@ async function validateUiDefinitionConsistency(root, config) {
 }
 
 // src/core/validators/researchSummary.ts
-var import_promises43 = require("fs/promises");
-var import_node_path45 = __toESM(require("path"), 1);
+var import_promises44 = require("fs/promises");
+var import_node_path46 = __toESM(require("path"), 1);
 var import_fast_glob7 = __toESM(require("fast-glob"), 1);
 var RESEARCH_SUMMARY_HEADING_RE = /^#{1,3}\s+Research\s+Summary/im;
 var SOURCE_ENTRY_RE = /^\s*-\s*id:\s*(\S+)/gm;
@@ -13037,17 +13181,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 = import_node_path45.default.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md");
+  const pattern = import_node_path46.default.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md");
   const files = await (0, import_fast_glob7.default)(pattern, { absolute: true });
   for (const filePath of files) {
     let content;
     try {
-      content = await (0, import_promises43.readFile)(filePath, "utf-8");
+      content = await (0, import_promises44.readFile)(filePath, "utf-8");
     } catch {
       continue;
     }
     if (!RESEARCH_SUMMARY_HEADING_RE.test(content)) continue;
-    const rel = import_node_path45.default.relative(root, filePath).replace(/\\/g, "/");
+    const rel = import_node_path46.default.relative(root, filePath).replace(/\\/g, "/");
     const section = extractResearchSummarySection(content);
     if (!section) continue;
     const sourceEntries = extractSourceEntries(section);
@@ -13278,9 +13422,9 @@ function resolveFreshnessReferenceNow() {
 }
 
 // src/core/validators/agentDefinition.ts
-var import_promises44 = require("fs/promises");
-var import_node_path46 = __toESM(require("path"), 1);
-var import_yaml9 = require("yaml");
+var import_promises45 = require("fs/promises");
+var import_node_path47 = __toESM(require("path"), 1);
+var import_yaml10 = require("yaml");
 var REQUIRED_AGENTS = [
   "uiux-expert.md",
   "design-expert.md",
@@ -13299,13 +13443,13 @@ var REQUIRED_SECTIONS = [
 var REQUIRED_PHASES = ["discussion", "SDD", "prototyping", "ATDD"];
 async function validateAgentDefinition(root, _config) {
   const issues = [];
-  const agentsDir = import_node_path46.default.join(root, ".qfai", "assistant", "agents");
+  const agentsDir = import_node_path47.default.join(root, ".qfai", "assistant", "agents");
   if (!await exists5(agentsDir)) {
     return [];
   }
   let anyAgentExists = false;
   for (const agentFile of REQUIRED_AGENTS) {
-    if (await exists5(import_node_path46.default.join(agentsDir, agentFile))) {
+    if (await exists5(import_node_path47.default.join(agentsDir, agentFile))) {
       anyAgentExists = true;
       break;
     }
@@ -13314,7 +13458,7 @@ async function validateAgentDefinition(root, _config) {
     return [];
   }
   for (const agentFile of REQUIRED_AGENTS) {
-    const filePath = import_node_path46.default.join(agentsDir, agentFile);
+    const filePath = import_node_path47.default.join(agentsDir, agentFile);
     const rel = `.qfai/assistant/agents/${agentFile}`;
     if (!await exists5(filePath)) {
       issues.push(
@@ -13330,7 +13474,7 @@ async function validateAgentDefinition(root, _config) {
     }
     let content;
     try {
-      content = await (0, import_promises44.readFile)(filePath, "utf-8");
+      content = await (0, import_promises45.readFile)(filePath, "utf-8");
     } catch {
       issues.push(
         issue(
@@ -13436,11 +13580,11 @@ async function validateAgentDefinition(root, _config) {
       }
     }
   }
-  const rosterPath = import_node_path46.default.join(root, ".qfai", "assistant", "steering", "review-roster.yml");
+  const rosterPath = import_node_path47.default.join(root, ".qfai", "assistant", "steering", "review-roster.yml");
   if (await exists5(rosterPath)) {
     try {
-      const rosterContent = await (0, import_promises44.readFile)(rosterPath, "utf-8");
-      const roster = (0, import_yaml9.parse)(rosterContent);
+      const rosterContent = await (0, import_promises45.readFile)(rosterPath, "utf-8");
+      const roster = (0, import_yaml10.parse)(rosterContent);
       if (roster && typeof roster === "object") {
         const rosterObj = roster;
         const entries = Array.isArray(rosterObj.roster) ? rosterObj.roster : [];
@@ -13484,8 +13628,8 @@ function extractPhaseBody(phaseSection, phaseName) {
 }
 
 // src/core/validators/tddList.ts
-var import_promises45 = require("fs/promises");
-var import_node_path47 = __toESM(require("path"), 1);
+var import_promises46 = require("fs/promises");
+var import_node_path48 = __toESM(require("path"), 1);
 var REQUIRED_COLUMNS = [
   "TDD-ID",
   "TC-Refs",
@@ -13499,7 +13643,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 = import_node_path47.default.join("tdd", "test-list.md");
+var TDD_LIST_REL_PATH = import_node_path48.default.join("tdd", "test-list.md");
 async function validateTddList(root, config) {
   const specsRoot = resolvePath(root, config, "specsDir");
   const entries = await collectSpecEntries(specsRoot);
@@ -13511,8 +13655,8 @@ async function validateTddList(root, config) {
   return issues;
 }
 async function validateSpecTddList(root, specDir, specNumber) {
-  const filePath = import_node_path47.default.join(specDir, TDD_LIST_REL_PATH);
-  const relPath = import_node_path47.default.relative(root, filePath).replace(/\\/g, "/");
+  const filePath = import_node_path48.default.join(specDir, TDD_LIST_REL_PATH);
+  const relPath = import_node_path48.default.relative(root, filePath).replace(/\\/g, "/");
   const issues = [];
   if (!await exists5(filePath)) {
     issues.push(
@@ -13699,9 +13843,9 @@ async function validateSpecTddList(root, specDir, specNumber) {
         continue;
       }
       const normalized = testFile.replace(/\\/g, "/");
-      const resolved = import_node_path47.default.resolve(root, normalized);
-      const relative = import_node_path47.default.relative(root, resolved);
-      if (import_node_path47.default.isAbsolute(normalized) || import_node_path47.default.win32.isAbsolute(normalized) || relative === ".." || relative.startsWith(".." + import_node_path47.default.sep)) {
+      const resolved = import_node_path48.default.resolve(root, normalized);
+      const relative = import_node_path48.default.relative(root, resolved);
+      if (import_node_path48.default.isAbsolute(normalized) || import_node_path48.default.win32.isAbsolute(normalized) || relative === ".." || relative.startsWith(".." + import_node_path48.default.sep)) {
         issues.push(
           issue(
             "TDDLIST_TEST_FILE_MISSING",
@@ -13715,7 +13859,7 @@ async function validateSpecTddList(root, specDir, specNumber) {
       }
       let isFile2 = false;
       try {
-        isFile2 = (await (0, import_promises45.stat)(resolved)).isFile();
+        isFile2 = (await (0, import_promises46.stat)(resolved)).isFile();
       } catch {
       }
       if (!isFile2) {
@@ -13764,11 +13908,11 @@ async function validateSpecTddList(root, specDir, specNumber) {
 }
 async function collectTestCaseIds(specDir) {
   const empty = { knownTcIds: /* @__PURE__ */ new Set(), unitComponentTcIds: /* @__PURE__ */ new Set() };
-  const testCasesPath = import_node_path47.default.join(specDir, "06_Test-Cases.md");
+  const testCasesPath = import_node_path48.default.join(specDir, "06_Test-Cases.md");
   if (!await exists5(testCasesPath)) return empty;
   let content;
   try {
-    content = await (0, import_promises45.readFile)(testCasesPath, "utf-8");
+    content = await (0, import_promises46.readFile)(testCasesPath, "utf-8");
   } catch {
     return empty;
   }
@@ -13794,8 +13938,8 @@ async function collectTestCaseIds(specDir) {
 }
 
 // src/core/validators/ddpValidation.ts
-var import_promises46 = require("fs/promises");
-var import_node_path48 = __toESM(require("path"), 1);
+var import_promises47 = require("fs/promises");
+var import_node_path49 = __toESM(require("path"), 1);
 var import_node_url3 = require("url");
 var import_fast_glob8 = __toESM(require("fast-glob"), 1);
 var DDP_HEADING_RE = /^#{1,3}\s+Design\s+Direction\s+Pack/im;
@@ -13813,9 +13957,9 @@ var _bannedPatterns = null;
 async function loadBannedPatterns() {
   if (_bannedPatterns !== null) return _bannedPatterns;
   try {
-    const thisDir = import_node_path48.default.dirname((0, import_node_url3.fileURLToPath)(__filename));
-    const filePath = import_node_path48.default.join(thisDir, "ddpBannedPatterns.txt");
-    const content = await (0, import_promises46.readFile)(filePath, "utf-8");
+    const thisDir = import_node_path49.default.dirname((0, import_node_url3.fileURLToPath)(__filename));
+    const filePath = import_node_path49.default.join(thisDir, "ddpBannedPatterns.txt");
+    const content = await (0, import_promises47.readFile)(filePath, "utf-8");
     _bannedPatterns = content.split(/\r?\n/).map((l) => l.trim()).filter((l) => l.length > 0 && !l.startsWith("#"));
   } catch {
     _bannedPatterns = [];
@@ -13824,15 +13968,15 @@ async function loadBannedPatterns() {
 }
 async function validateDdpFields(root, config) {
   const issues = [];
-  const pattern = import_node_path48.default.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md");
+  const pattern = import_node_path49.default.posix.join(root.replace(/\\/g, "/"), config.paths.discussionDir, "**/*.md");
   const files = await (0, import_fast_glob8.default)(pattern, { absolute: true });
   let ddpFound = false;
   let isUiBearing2 = false;
   for (const filePath of files) {
-    const basename = import_node_path48.default.basename(filePath);
+    const basename = import_node_path49.default.basename(filePath);
     if (basename === "03_Story-Workshop.md") {
       try {
-        const storyContent = await (0, import_promises46.readFile)(filePath, "utf-8");
+        const storyContent = await (0, import_promises47.readFile)(filePath, "utf-8");
         if (UI_BEARING_KEYWORDS_RE.test(storyContent)) {
           isUiBearing2 = true;
         }
@@ -13843,13 +13987,13 @@ async function validateDdpFields(root, config) {
   for (const filePath of files) {
     let content;
     try {
-      content = await (0, import_promises46.readFile)(filePath, "utf-8");
+      content = await (0, import_promises47.readFile)(filePath, "utf-8");
     } catch {
       continue;
     }
     if (!DDP_HEADING_RE.test(content)) continue;
     ddpFound = true;
-    const rel = import_node_path48.default.relative(root, filePath).replace(/\\/g, "/");
+    const rel = import_node_path49.default.relative(root, filePath).replace(/\\/g, "/");
     const section = extractDdpSection(content);
     if (!section) continue;
     for (const field of DDP_REQUIRED_FIELDS) {
@@ -14042,7 +14186,7 @@ var ANTI_PATTERN_CHECKS = [
 ];
 async function validateResearchTraceability(root, config, issues) {
   const requireResearchSummary = config.uiux?.requireResearchSummary === true;
-  const discussionPattern = import_node_path48.default.posix.join(
+  const discussionPattern = import_node_path49.default.posix.join(
     root.replace(/\\/g, "/"),
     config.paths.discussionDir,
     "**/*.md"
@@ -14051,7 +14195,7 @@ async function validateResearchTraceability(root, config, issues) {
   let hasResearchSummary = false;
   for (const filePath of discussionFiles) {
     try {
-      const content = await (0, import_promises46.readFile)(filePath, "utf-8");
+      const content = await (0, import_promises47.readFile)(filePath, "utf-8");
       if (/research_summary\s*:/m.test(content)) {
         hasResearchSummary = true;
         break;
@@ -14070,7 +14214,7 @@ async function validateResearchTraceability(root, config, issues) {
       )
     );
   }
-  const contractPattern = import_node_path48.default.posix.join(
+  const contractPattern = import_node_path49.default.posix.join(
     root.replace(/\\/g, "/"),
     config.paths.contractsDir,
     "design",
@@ -14080,11 +14224,11 @@ async function validateResearchTraceability(root, config, issues) {
   for (const filePath of contractFiles) {
     let content;
     try {
-      content = await (0, import_promises46.readFile)(filePath, "utf-8");
+      content = await (0, import_promises47.readFile)(filePath, "utf-8");
     } catch {
       continue;
     }
-    const rel = import_node_path48.default.relative(root, filePath).replace(/\\/g, "/");
+    const rel = import_node_path49.default.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);
@@ -14107,11 +14251,11 @@ async function validateStoryWorkshopTemplates(root, config, issues, discussionFi
   for (const filePath of discussionFiles) {
     let content;
     try {
-      content = await (0, import_promises46.readFile)(filePath, "utf-8");
+      content = await (0, import_promises47.readFile)(filePath, "utf-8");
     } catch {
       continue;
     }
-    const rel = import_node_path48.default.relative(root, filePath).replace(/\\/g, "/");
+    const rel = import_node_path49.default.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)) {
@@ -14211,7 +14355,7 @@ function validateQualityProfile(config, issues) {
   }
 }
 async function validateOptionComparison(root, config, issues) {
-  const contractPattern = import_node_path48.default.posix.join(
+  const contractPattern = import_node_path49.default.posix.join(
     root.replace(/\\/g, "/"),
     config.paths.contractsDir,
     "design",
@@ -14221,11 +14365,11 @@ async function validateOptionComparison(root, config, issues) {
   for (const filePath of contractFiles) {
     let content;
     try {
-      content = await (0, import_promises46.readFile)(filePath, "utf-8");
+      content = await (0, import_promises47.readFile)(filePath, "utf-8");
     } catch {
       continue;
     }
-    const rel = import_node_path48.default.relative(root, filePath).replace(/\\/g, "/");
+    const rel = import_node_path49.default.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;
@@ -14260,7 +14404,7 @@ async function validateOptionComparison(root, config, issues) {
 }
 async function validateCompetitiveRefs(root, config, issues) {
   const minRefs = config.uiux?.competitive_refs_min ?? 3;
-  const contractPattern = import_node_path48.default.posix.join(
+  const contractPattern = import_node_path49.default.posix.join(
     root.replace(/\\/g, "/"),
     config.paths.contractsDir,
     "design",
@@ -14270,11 +14414,11 @@ async function validateCompetitiveRefs(root, config, issues) {
   for (const filePath of contractFiles) {
     let content;
     try {
-      content = await (0, import_promises46.readFile)(filePath, "utf-8");
+      content = await (0, import_promises47.readFile)(filePath, "utf-8");
     } catch {
       continue;
     }
-    const rel = import_node_path48.default.relative(root, filePath).replace(/\\/g, "/");
+    const rel = import_node_path49.default.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));
@@ -14424,7 +14568,7 @@ function collectListItems(section, field) {
 }
 
 // src/core/validators/navigationFlow.ts
-var import_promises47 = require("fs/promises");
+var import_promises48 = require("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;
@@ -14703,7 +14847,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 (0, import_promises47.readFile)(file, "utf-8");
+    const content = await (0, import_promises48.readFile)(file, "utf-8");
     const blocks = extractFencedCodeBlocks(content);
     const mermaidBlocks = blocks.filter((b) => b.language === "mermaid");
     const _flowchartBlocks = mermaidBlocks.filter((b) => hasFlowchartDeclaration(b.content));
@@ -14725,8 +14869,8 @@ async function validateNavigationFlow(root, config) {
 }
 
 // src/core/validators/renderCritique.ts
-var import_node_path49 = __toESM(require("path"), 1);
-var import_promises48 = require("fs/promises");
+var import_node_path50 = __toESM(require("path"), 1);
+var import_promises49 = require("fs/promises");
 var import_fast_glob9 = __toESM(require("fast-glob"), 1);
 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;
@@ -14745,8 +14889,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 = import_node_path49.default.join(root, config.paths.discussionDir).replace(/\\/g, "/");
-  const discussionFiles = await (0, import_fast_glob9.default)(import_node_path49.default.posix.join(discussionDir, "**/*.md"), { absolute: true });
+  const discussionDir = import_node_path50.default.join(root, config.paths.discussionDir).replace(/\\/g, "/");
+  const discussionFiles = await (0, import_fast_glob9.default)(import_node_path50.default.posix.join(discussionDir, "**/*.md"), { absolute: true });
   let hasDdp = false;
   for (const df of discussionFiles) {
     const content = await readSafe(df);
@@ -14756,12 +14900,12 @@ async function validateRenderCritique(root, config) {
     }
   }
   if (!hasDdp) return issues;
-  const skillsDir = import_node_path49.default.join(root, config.paths.skillsDir).replace(/\\/g, "/");
-  const evidenceDir = import_node_path49.default.join(root, ".qfai", "evidence").replace(/\\/g, "/");
+  const skillsDir = import_node_path50.default.join(root, config.paths.skillsDir).replace(/\\/g, "/");
+  const evidenceDir = import_node_path50.default.join(root, ".qfai", "evidence").replace(/\\/g, "/");
   const renderEvidenceViewports = await collectRenderEvidenceViewports(root);
-  const skillPromptPattern = import_node_path49.default.posix.join(skillsDir, "qfai-{prototyping,implement}*/SKILL.md");
+  const skillPromptPattern = import_node_path50.default.posix.join(skillsDir, "qfai-{prototyping,implement}*/SKILL.md");
   const skillFiles = await (0, import_fast_glob9.default)(skillPromptPattern, { dot: true });
-  const evidencePattern = import_node_path49.default.posix.join(evidenceDir, "{prototyping*,critique-*}.md");
+  const evidencePattern = import_node_path50.default.posix.join(evidenceDir, "{prototyping*,critique-*}.md");
   const evidenceFiles = await (0, import_fast_glob9.default)(evidencePattern, { dot: true });
   for (const sf of skillFiles) {
     const content = await readSafe(sf);
@@ -14769,7 +14913,7 @@ async function validateRenderCritique(root, config) {
       issues.push(
         issue(
           "QFAI-CRIT-001",
-          `Skill prompt does not mention rendered/screenshot/HTML review: ${import_node_path49.default.relative(root, sf)}`,
+          `Skill prompt does not mention rendered/screenshot/HTML review: ${import_node_path50.default.relative(root, sf)}`,
           "error",
           sf,
           "renderCritique.codeOnly",
@@ -14786,7 +14930,7 @@ async function validateRenderCritique(root, config) {
       issues.push(
         issue(
           "QFAI-CRIT-002",
-          `Downstream skill prompt missing DDP reference: ${import_node_path49.default.relative(root, sf)}`,
+          `Downstream skill prompt missing DDP reference: ${import_node_path50.default.relative(root, sf)}`,
           "error",
           sf,
           "renderCritique.ddpMissing",
@@ -14832,7 +14976,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): ${import_node_path49.default.relative(root, sf)}`,
+          `Read order not specified (DDP \u2192 Design Token \u2192 UI Contract \u2192 HTML Mock \u2192 Flow): ${import_node_path50.default.relative(root, sf)}`,
           "error",
           sf,
           "renderCritique.readOrder",
@@ -14859,7 +15003,7 @@ async function validateRenderCritique(root, config) {
       issues.push(
         issue(
           "QFAI-CRIT-006",
-          `Critique evidence incomplete (missing: ${missing.join(", ")}): ${import_node_path49.default.relative(root, ef)}`,
+          `Critique evidence incomplete (missing: ${missing.join(", ")}): ${import_node_path50.default.relative(root, ef)}`,
           "error",
           ef,
           "renderCritique.incompleteEvidence",
@@ -14974,9 +15118,9 @@ async function collectContent(files) {
   return contents.join("\n---\n");
 }
 async function collectRenderEvidenceViewports(root) {
-  const prototypingJsonPath = import_node_path49.default.join(root, ".qfai", "evidence", "prototyping.json");
+  const prototypingJsonPath = import_node_path50.default.join(root, ".qfai", "evidence", "prototyping.json");
   try {
-    const raw = await (0, import_promises48.readFile)(prototypingJsonPath, "utf-8");
+    const raw = await (0, import_promises49.readFile)(prototypingJsonPath, "utf-8");
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
       return /* @__PURE__ */ new Set();
@@ -15015,8 +15159,8 @@ async function collectRenderEvidenceViewports(root) {
 }
 
 // src/core/validators/designFidelity.ts
-var import_promises49 = require("fs/promises");
-var import_node_path50 = __toESM(require("path"), 1);
+var import_promises50 = require("fs/promises");
+var import_node_path51 = __toESM(require("path"), 1);
 var import_fast_glob10 = __toESM(require("fast-glob"), 1);
 var SCORECARD_HEADING_RE = /^#{1,3}\s+Fidelity\s+Scorecard/im;
 var BASE_DIMENSIONS = ["hierarchy", "clarity", "accessibility", "responsive"];
@@ -15041,19 +15185,19 @@ async function validateDesignFidelity(root, config) {
   const evidenceDirs = [".qfai/evidence", ".qfai/review"];
   const allFiles = [];
   for (const dir of evidenceDirs) {
-    const pattern = import_node_path50.default.posix.join(root.replace(/\\/g, "/"), dir, "**/*.md");
+    const pattern = import_node_path51.default.posix.join(root.replace(/\\/g, "/"), dir, "**/*.md");
     const files = await (0, import_fast_glob10.default)(pattern, { absolute: true });
     allFiles.push(...files);
   }
   for (const filePath of allFiles) {
     let content;
     try {
-      content = await (0, import_promises49.readFile)(filePath, "utf-8");
+      content = await (0, import_promises50.readFile)(filePath, "utf-8");
     } catch {
       continue;
     }
     if (!SCORECARD_HEADING_RE.test(content)) continue;
-    const rel = import_node_path50.default.relative(root, filePath).replace(/\\/g, "/");
+    const rel = import_node_path51.default.relative(root, filePath).replace(/\\/g, "/");
     const section = extractScorecardSection(content);
     if (!section) continue;
     const dimensions = parseDimensions(section);
@@ -15345,7 +15489,7 @@ function hasAntiPatternMention(section, code) {
 }
 
 // src/core/validators/discussionDesignHardening.ts
-var import_node_path51 = __toESM(require("path"), 1);
+var import_node_path52 = __toESM(require("path"), 1);
 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";
@@ -15360,10 +15504,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 = import_node_path51.default.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = import_node_path52.default.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;
@@ -15398,7 +15549,7 @@ function extractOptionNames(optionSection) {
 }
 async function validateDdsPresence(packRoot) {
   const issues = [];
-  const storyPath = import_node_path51.default.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = import_node_path52.default.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   const relPath = "03_Story-Workshop.md";
   if (!content || !content.includes(DDS_HEADING)) {
@@ -15432,7 +15583,7 @@ async function validateDdsPresence(packRoot) {
 }
 async function validateOptionComparison2(packRoot) {
   const issues = [];
-  const storyPath = import_node_path51.default.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = import_node_path52.default.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   if (!content) return issues;
   const dds = extractDdsSection(content);
@@ -15456,7 +15607,7 @@ async function validateOptionComparison2(packRoot) {
 }
 async function validateAnchorScreen(packRoot) {
   const issues = [];
-  const storyPath = import_node_path51.default.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = import_node_path52.default.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   if (!content) return issues;
   const dds = extractDdsSection(content);
@@ -15498,7 +15649,7 @@ async function validateAnchorScreen(packRoot) {
 }
 async function validateCompetitiveRefs2(packRoot) {
   const issues = [];
-  const sourcesPath = import_node_path51.default.join(packRoot, "04_Sources.md");
+  const sourcesPath = import_node_path52.default.join(packRoot, "04_Sources.md");
   const content = await readSafe(sourcesPath);
   if (!content) return issues;
   const registryHeadingRe = /^##\s+Competitive Reference Registry\b.*$/m;
@@ -15555,7 +15706,7 @@ function fieldGuidance(field) {
 }
 async function validateCtaHierarchy(packRoot) {
   const issues = [];
-  const storyPath = import_node_path51.default.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = import_node_path52.default.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   if (!content) return issues;
   const dds = extractDdsSection(content);
@@ -15593,7 +15744,7 @@ async function validateCtaHierarchy(packRoot) {
 }
 async function validateStateCoverage(packRoot) {
   const issues = [];
-  const storyPath = import_node_path51.default.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = import_node_path52.default.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   if (!content) return issues;
   const dds = extractDdsSection(content);
@@ -15618,7 +15769,7 @@ async function validateStateCoverage(packRoot) {
 }
 async function validateDesignAntiGoals(packRoot) {
   const issues = [];
-  const storyPath = import_node_path51.default.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = import_node_path52.default.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   if (!content) return issues;
   const dds = extractDdsSection(content);
@@ -15655,7 +15806,7 @@ async function validateDesignAntiGoals(packRoot) {
   return issues;
 }
 async function validateDiscussionDesignHardening(root, config) {
-  const discussionDir = import_node_path51.default.join(root, config.paths.discussionDir);
+  const discussionDir = import_node_path52.default.join(root, config.paths.discussionDir);
   const packRoot = await findLatestDiscussionPackDir(discussionDir);
   if (!packRoot) return [];
   const uiBearing = await isUiBearing(packRoot);
@@ -15672,8 +15823,8 @@ async function validateDiscussionDesignHardening(root, config) {
 }
 
 // src/core/validators/designAudit.ts
-var import_promises50 = require("fs/promises");
-var import_node_path52 = __toESM(require("path"), 1);
+var import_promises51 = require("fs/promises");
+var import_node_path53 = __toESM(require("path"), 1);
 var COSMETIC_CATEGORIES = ["generic-shell", "stock-imagery", "placeholder-copy"];
 function resolveAuditConfig(config) {
   const audit = config.uiux?.audit;
@@ -15755,19 +15906,19 @@ 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 ? import_node_path52.default.resolve(root, configuredDir) : import_node_path52.default.join(root, cfg.paths.contractsDir, "design");
+  const tokensDir = configuredDir ? import_node_path53.default.resolve(root, configuredDir) : import_node_path53.default.join(root, cfg.paths.contractsDir, "design");
   let hasTokenFiles = false;
   try {
-    const entries = await (0, import_promises50.readdir)(tokensDir);
+    const entries = await (0, import_promises51.readdir)(tokensDir);
     hasTokenFiles = entries.some((e) => /\.ya?ml$/i.test(e));
   } catch {
     return findings;
   }
   if (!hasTokenFiles) return findings;
-  const contractsUiDir = import_node_path52.default.join(root, cfg.paths.contractsDir, "ui");
+  const contractsUiDir = import_node_path53.default.join(root, cfg.paths.contractsDir, "ui");
   let htmlFiles = [];
   try {
-    const entries = await (0, import_promises50.readdir)(contractsUiDir);
+    const entries = await (0, import_promises51.readdir)(contractsUiDir);
     htmlFiles = entries.filter((e) => /\.html?$/i.test(e));
   } catch {
     return findings;
@@ -15775,7 +15926,7 @@ async function checkTokenDrift(root, auditConfig, cfg) {
   let rawCount = 0;
   const sampleLiterals = [];
   for (const htmlFile of htmlFiles) {
-    const content = await readSafe(import_node_path52.default.join(contractsUiDir, htmlFile));
+    const content = await readSafe(import_node_path53.default.join(contractsUiDir, htmlFile));
     if (!content) continue;
     const matches = content.match(RAW_COLOR_RE);
     if (matches) {
@@ -15826,12 +15977,12 @@ function deduplicateFindings(issues, maxPerRule) {
 async function validateDesignAudit(root, config) {
   const auditConfig = resolveAuditConfig(config);
   if (!auditConfig.enabled) return [];
-  const discussionDir = import_node_path52.default.join(root, config.paths.discussionDir);
+  const discussionDir = import_node_path53.default.join(root, config.paths.discussionDir);
   const packRoot = await findLatestDiscussionPackDir(discussionDir);
   if (!packRoot) return [];
   const uiBearing = await isUiBearing(packRoot);
   if (!uiBearing) return [];
-  const storyPath = import_node_path52.default.join(packRoot, "03_Story-Workshop.md");
+  const storyPath = import_node_path53.default.join(packRoot, "03_Story-Workshop.md");
   const content = await readSafe(storyPath);
   if (!content) return [];
   const findings = [];
@@ -15843,8 +15994,8 @@ async function validateDesignAudit(root, config) {
 
 // src/core/validators/designSlop.ts
 var import_node_fs2 = require("fs");
-var import_promises51 = require("fs/promises");
-var import_node_path53 = __toESM(require("path"), 1);
+var import_promises52 = require("fs/promises");
+var import_node_path54 = __toESM(require("path"), 1);
 var import_node_url4 = require("url");
 function isValidSlopPattern(rule) {
   if (typeof rule !== "object" || rule === null) return false;
@@ -15852,7 +16003,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 (0, import_promises51.readFile)(jsonPath, "utf-8");
+  const raw = await (0, import_promises52.readFile)(jsonPath, "utf-8");
   const parsed = JSON.parse(raw);
   if (!Array.isArray(parsed)) return [];
   return parsed.filter((r) => isValidSlopPattern(r));
@@ -15860,11 +16011,11 @@ async function loadSlopPatterns(jsonPath) {
 function defaultPatternsPath() {
   const base = __filename;
   const basePath = base.startsWith("file:") ? (0, import_node_url4.fileURLToPath)(base) : base;
-  const baseDir = import_node_path53.default.dirname(basePath);
+  const baseDir = import_node_path54.default.dirname(basePath);
   const candidates = [
-    import_node_path53.default.join(baseDir, "designSlopPatterns.json"),
-    import_node_path53.default.resolve(baseDir, "../../../assets/validators/designSlopPatterns.json"),
-    import_node_path53.default.resolve(baseDir, "../../assets/validators/designSlopPatterns.json")
+    import_node_path54.default.join(baseDir, "designSlopPatterns.json"),
+    import_node_path54.default.resolve(baseDir, "../../../assets/validators/designSlopPatterns.json"),
+    import_node_path54.default.resolve(baseDir, "../../assets/validators/designSlopPatterns.json")
   ];
   for (const c of candidates) {
     if ((0, import_node_fs2.existsSync)(c)) return c;
@@ -15875,7 +16026,7 @@ async function validateDesignSlop(root, config) {
   const auditConfig = resolveAuditConfig(config);
   if (!auditConfig.enabled) return [];
   if (!auditConfig.slopDetection) return [];
-  const discussionDir = import_node_path53.default.join(root, config.paths.discussionDir);
+  const discussionDir = import_node_path54.default.join(root, config.paths.discussionDir);
   const packRoot = await findLatestDiscussionPackDir(discussionDir);
   if (!packRoot) return [];
   const uiBearing = await isUiBearing(packRoot);
@@ -15896,7 +16047,7 @@ async function validateDesignSlop(root, config) {
       continue;
     }
     for (const scope of pattern.scopes) {
-      const filePath = import_node_path53.default.join(packRoot, scope);
+      const filePath = import_node_path54.default.join(packRoot, scope);
       const content = await readSafe(filePath);
       if (!content) continue;
       if (regex.test(content) && !seenRules.has(pattern.id)) {
@@ -15917,6 +16068,460 @@ async function validateDesignSlop(root, config) {
   return findings.map((f) => findingToIssue(f, auditConfig.qualityProfile, "slop"));
 }
 
+// src/core/validators/uixValidators.ts
+var import_promises54 = require("fs/promises");
+var import_node_path56 = __toESM(require("path"), 1);
+
+// src/core/validators/uixDetection.ts
+var import_promises53 = require("fs/promises");
+var import_node_path55 = __toESM(require("path"), 1);
+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(import_node_path55.default.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 (0, import_promises53.readdir)(import_node_path55.default.join(root, "uiux"));
+    return true;
+  } catch {
+  }
+  const contractsContent = await readSafe(import_node_path55.default.join(root, "uiux", "40_contracts.md"));
+  if (contractsContent && SCREEN_CONTRACT_YAML_RE.test(contractsContent)) return true;
+  const storyContent = await readSafe(import_node_path55.default.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 (0, import_promises54.readdir)(import_node_path56.default.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 = import_node_path56.default.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 = import_node_path56.default.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(import_node_path56.default.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 = import_node_path56.default.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(import_node_path56.default.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 = import_node_path56.default.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 = import_node_path56.default.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 = import_node_path56.default.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 = import_node_path56.default.join(root, "11_OQ-Register.md");
+  const uiuxOqPath = import_node_path56.default.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 (0, import_promises54.readdir)(import_node_path56.default.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 = import_node_path56.default.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(import_node_path56.default.join(root, "01_Spec.md"));
+  if (!directSpec) {
+    const discussionDir = import_node_path56.default.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 = {}) {
@@ -15936,7 +16541,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()];
@@ -16023,15 +16629,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 = import_node_path54.default.resolve(root);
+  const resolvedRoot = import_node_path57.default.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 = import_node_path54.default.join(contractsRoot, "api");
-  const uiRoot = import_node_path54.default.join(contractsRoot, "ui");
-  const dbRoot = import_node_path54.default.join(contractsRoot, "db");
+  const apiRoot = import_node_path57.default.join(contractsRoot, "api");
+  const uiRoot = import_node_path57.default.join(contractsRoot, "ui");
+  const dbRoot = import_node_path57.default.join(contractsRoot, "db");
   const srcRoot = resolvePath(resolvedRoot, config, "srcDir");
   const testsRoot = resolvePath(resolvedRoot, config, "testsDir");
   const specEntries = await collectSpecEntries(specsRoot);
@@ -16968,7 +17574,7 @@ async function collectChangeTypeSummary(specsRoot) {
   };
   const deltaFiles = await collectDeltaFiles(specsRoot);
   for (const deltaFile of deltaFiles) {
-    const text = await (0, import_promises52.readFile)(deltaFile, "utf-8");
+    const text = await (0, import_promises55.readFile)(deltaFile, "utf-8");
     const parsed = parseDeltaV1(text);
     for (const entry of parsed.entries) {
       if (!entry.meta) {
@@ -17005,7 +17611,7 @@ async function collectSpecContractRefs(specFiles, contractIdList) {
     idToSpecs.set(contractId, /* @__PURE__ */ new Set());
   }
   for (const file of specFiles) {
-    const text = await (0, import_promises52.readFile)(file, "utf-8");
+    const text = await (0, import_promises55.readFile)(file, "utf-8");
     const parsed = parseSpec(text, file);
     const specKey = parsed.specId;
     if (!specKey) {
@@ -17042,7 +17648,7 @@ async function collectIds(files) {
     result[prefix] = /* @__PURE__ */ new Set();
   }
   for (const file of files) {
-    const text = await (0, import_promises52.readFile)(file, "utf-8");
+    const text = await (0, import_promises55.readFile)(file, "utf-8");
     for (const prefix of ID_PREFIXES) {
       const ids = extractIds(text, prefix);
       ids.forEach((id) => result[prefix].add(id));
@@ -17057,7 +17663,7 @@ async function collectIds(files) {
 async function collectUpstreamIds(files) {
   const ids = /* @__PURE__ */ new Set();
   for (const file of files) {
-    const text = await (0, import_promises52.readFile)(file, "utf-8");
+    const text = await (0, import_promises55.readFile)(file, "utf-8");
     extractAllIds(text).forEach((id) => ids.add(id));
   }
   return ids;
@@ -17078,7 +17684,7 @@ async function evaluateTraceability(upstreamIds, srcRoot, testsRoot) {
   }
   const pattern = buildIdPattern(Array.from(upstreamIds));
   for (const file of targetFiles) {
-    const text = await (0, import_promises52.readFile)(file, "utf-8");
+    const text = await (0, import_promises55.readFile)(file, "utf-8");
     if (pattern.test(text)) {
       return true;
     }
@@ -17197,7 +17803,7 @@ function normalizeScSources(root, sources) {
 async function countScenarios(scenarioFiles) {
   let total = 0;
   for (const file of scenarioFiles) {
-    const text = await (0, import_promises52.readFile)(file, "utf-8");
+    const text = await (0, import_promises55.readFile)(file, "utf-8");
     const { document, errors } = parseScenarioDocument(text, file);
     if (!document || errors.length > 0) {
       continue;
@@ -17228,7 +17834,7 @@ async function collectTestStrategy(scenarioFiles, root, config, limit) {
   let totalScenarios = 0;
   let e2eCount = 0;
   for (const file of scenarioFiles) {
-    const text = await (0, import_promises52.readFile)(file, "utf-8");
+    const text = await (0, import_promises55.readFile)(file, "utf-8");
     const { document, errors } = parseScenarioDocument(text, file);
     if (!document || errors.length > 0) {
       continue;
@@ -17316,10 +17922,10 @@ function buildHotspots(issues) {
 async function collectTddCoverage(entries) {
   const specs = [];
   for (const entry of entries) {
-    const testCasesPath = import_node_path54.default.join(entry.dir, "06_Test-Cases.md");
+    const testCasesPath = import_node_path57.default.join(entry.dir, "06_Test-Cases.md");
     let tcContent;
     try {
-      tcContent = await (0, import_promises52.readFile)(testCasesPath, "utf-8");
+      tcContent = await (0, import_promises55.readFile)(testCasesPath, "utf-8");
     } catch {
       continue;
     }
@@ -17351,10 +17957,10 @@ async function collectTddCoverage(entries) {
       });
       continue;
     }
-    const tddListPath = import_node_path54.default.join(entry.dir, "tdd", "test-list.md");
+    const tddListPath = import_node_path57.default.join(entry.dir, "tdd", "test-list.md");
     let tddContent;
     try {
-      tddContent = await (0, import_promises52.readFile)(tddListPath, "utf-8");
+      tddContent = await (0, import_promises55.readFile)(tddListPath, "utf-8");
     } catch {
       specs.push({
         specNumber: entry.specNumber,
@@ -17440,6 +18046,8 @@ async function collectTddCoverage(entries) {
   ID_PREFIXES,
   RUNTIME_HEAVY_CHECKS,
   STATIC_OBLIGATIONS,
+  VALID_MODE_SOURCES,
+  adaptSurfaceEvidence,
   autogenerateUiFidelity,
   buildUiFidelityScreens,
   checkDecisionGuardrails,
@@ -17465,6 +18073,7 @@ async function collectTddCoverage(entries) {
   filterDecisionGuardrailsByKeyword,
   findConfigRoot,
   formatGuardrailsForLlm,
+  formatModeLog,
   formatReportJson,
   formatReportMarkdown,
   getConfigPath,
@@ -17472,9 +18081,11 @@ async function collectTddCoverage(entries) {
   loadConfig,
   loadDecisionGuardrails,
   normalizeDecisionGuardrails,
+  readDiscussionRecommendation,
   resolveObligations,
   resolveObligationsWithOptIn,
   resolvePath,
+  resolvePrecedence,
   resolveToolVersion,
   runMockPaths,
   runSddPreflight,