@outcomeeng/spx 0.5.0 → 0.5.2

package/dist/cli.js

@@ -234,7 +234,7 @@ async function runVerifyPipeline(filePath, productDir) {
   return { lines: [], exitCode: 0, verdict: verdict.header?.verdict };
 }
 
-// src/domains/audit/cli.ts
+// src/commands/audit/verify.ts
 async function runVerifyCommand(filePath, productDir, writeLine) {
   const result = await runVerifyPipeline(filePath, productDir);
   if (result.exitCode === 0) {
@@ -246,6 +246,8 @@ async function runVerifyCommand(filePath, productDir, writeLine) {
   }
   return result.exitCode;
 }
+
+// src/interfaces/cli/audit.ts
 var auditDomain = {
   name: "audit",
   description: "Audit verdict verification",
@@ -272,7 +274,7 @@ async function initCommand(options = {}) {
     if (!exists) {
       await execa(
         "claude",
-        ["plugin", "marketplace", "add", "outcomeeng/claude"],
+        ["plugin", "marketplace", "add", "outcomeeng/plugins"],
         { cwd }
       );
       return "\u2713 outcomeeng marketplace installed successfully\n\nRun 'claude plugin marketplace list' to view all marketplaces.";
@@ -839,7 +841,7 @@ Searched for: **/.claude/settings.local.json`;
   return formatReport(result, previewOnly, globalSettingsPath, outputFile);
 }
 
-// src/domains/claude/index.ts
+// src/interfaces/cli/claude.ts
 function registerClaudeCommands(claudeCmd) {
   claudeCmd.command("init").description("Initialize or update outcomeeng marketplace plugin").action(async () => {
     try {
@@ -2729,7 +2731,7 @@ function resolveProductDir(cwd = process.cwd()) {
   };
 }
 
-// src/domains/config/index.ts
+// src/interfaces/cli/config.ts
 function buildDefaultDeps() {
   return {
     resolveConfig,
@@ -2778,7 +2780,7 @@ var configDomain = {
 };
 
 // src/commands/session/archive.ts
-import { mkdir, readFile as readFile3, rename, stat } from "fs/promises";
+import { mkdir, rename, stat } from "fs/promises";
 import { dirname as dirname2, join as join4 } from "path";
 
 // src/domains/session/archive.ts
@@ -2892,10 +2894,12 @@ var SessionInvalidNextStepError = class extends SessionError {
     this.name = "SessionInvalidNextStepError";
   }
 };
-var SessionInvalidResultError = class extends SessionError {
-  constructor(sessionId) {
-    super(`Invalid session result for ${sessionId}: result must be a non-empty string before archive.`);
-    this.name = "SessionInvalidResultError";
+var SessionHandoffBaseError = class extends SessionError {
+  constructor() {
+    super(
+      "Cannot create a handoff session from this git work context. Run handoff from the root worktree, or from a linked worktree with a clean working tree detached at the tip of origin/<default branch>."
+    );
+    this.name = "SessionHandoffBaseError";
   }
 };
 var SessionNotClaimedError = class extends SessionError {
@@ -2913,179 +2917,27 @@ var NoSessionsAvailableError = class extends SessionError {
     this.name = "NoSessionsAvailableError";
   }
 };
+var SessionLegacyFrontmatterInputError = class extends SessionError {
+  constructor() {
+    super(
+      `Invalid handoff input: stdin opens with the YAML-frontmatter delimiter \`---\`. Use the JSON-prefix wire format: a single JSON object holding caller-supplied fields followed by the body bytes verbatim. Example:
 
-// src/domains/session/list.ts
-import { parse as parseYaml2 } from "yaml";
-
-// src/domains/session/timestamp.ts
-var SESSION_ID_PATTERN = /^(\d{4})-(\d{2})-(\d{2})_(\d{2})-(\d{2})-(\d{2})$/;
-var SESSION_ID_SEPARATOR = "_";
-function generateSessionId(options = {}) {
-  const now = options.now ?? (() => /* @__PURE__ */ new Date());
-  const date = now();
-  const year = date.getFullYear();
-  const month = String(date.getMonth() + 1).padStart(2, "0");
-  const day = String(date.getDate()).padStart(2, "0");
-  const hours = String(date.getHours()).padStart(2, "0");
-  const minutes = String(date.getMinutes()).padStart(2, "0");
-  const seconds = String(date.getSeconds()).padStart(2, "0");
-  return `${year}-${month}-${day}${SESSION_ID_SEPARATOR}${hours}-${minutes}-${seconds}`;
-}
-function parseSessionId(id) {
-  const match = SESSION_ID_PATTERN.exec(id);
-  if (!match) {
-    return null;
+  printf '%s\\n' '{"priority":"high","goal":"...","next_step":"..."}' '# Body' | spx session handoff`
+    );
+    this.name = "SessionLegacyFrontmatterInputError";
   }
-  const [, yearStr, monthStr, dayStr, hoursStr, minutesStr, secondsStr] = match;
-  const year = parseInt(yearStr, 10);
-  const month = parseInt(monthStr, 10) - 1;
-  const day = parseInt(dayStr, 10);
-  const hours = parseInt(hoursStr, 10);
-  const minutes = parseInt(minutesStr, 10);
-  const seconds = parseInt(secondsStr, 10);
-  if (month < 0 || month > 11) return null;
-  if (day < 1 || day > 31) return null;
-  if (hours < 0 || hours > 23) return null;
-  if (minutes < 0 || minutes > 59) return null;
-  if (seconds < 0 || seconds > 59) return null;
-  return new Date(year, month, day, hours, minutes, seconds);
-}
-
-// src/domains/session/types.ts
-var SESSION_PRIORITY = {
-  HIGH: "high",
-  MEDIUM: "medium",
-  LOW: "low"
-};
-var SESSION_STATUSES = ["todo", "doing", "archive"];
-var DEFAULT_LIST_STATUSES = ["doing", "todo"];
-var PRIORITY_ORDER = {
-  [SESSION_PRIORITY.HIGH]: 0,
-  [SESSION_PRIORITY.MEDIUM]: 1,
-  [SESSION_PRIORITY.LOW]: 2
-};
-var DEFAULT_PRIORITY = SESSION_PRIORITY.MEDIUM;
-var SESSION_FRONT_MATTER = {
-  PRIORITY: "priority",
-  ID: "id",
-  BRANCH: "branch",
-  WORKTREE: "worktree",
-  GOAL: "goal",
-  NEXT_STEP: "next_step",
-  RESULT: "result",
-  CREATED_AT: "created_at",
-  AGENT_SESSION_ID: "agent_session_id",
-  SPECS: "specs",
-  FILES: "files"
-};
-
-// src/domains/session/list.ts
-var FRONT_MATTER_PATTERN = /^---\r?\n([\s\S]*?)\r?\n(?:---|\.\.\.)\r?\n?/;
-var SESSION_PRIORITY_VALUES = Object.values(SESSION_PRIORITY);
-var DEFAULT_SESSION_METADATA = {
-  priority: DEFAULT_PRIORITY,
-  branch: "",
-  worktree: "",
-  goal: "",
-  next_step: "",
-  result: "",
-  specs: [],
-  files: []
 };
-function defaultSessionMetadata() {
-  return {
-    ...DEFAULT_SESSION_METADATA,
-    specs: [],
-    files: []
-  };
-}
-function isValidPriority(value) {
-  return typeof value === "string" && SESSION_PRIORITY_VALUES.some((priority) => priority === value);
-}
-function parseSessionMetadata(content) {
-  const match = FRONT_MATTER_PATTERN.exec(content);
-  if (!match) {
-    return defaultSessionMetadata();
-  }
-  try {
-    const parsed = parseYaml2(match[1]);
-    if (!parsed || typeof parsed !== "object") {
-      return defaultSessionMetadata();
-    }
-    const rawPriority = parsed[SESSION_FRONT_MATTER.PRIORITY];
-    const priority = isValidPriority(rawPriority) ? rawPriority : DEFAULT_PRIORITY;
-    const metadata = {
-      ...defaultSessionMetadata(),
-      priority
-    };
-    const id = parsed[SESSION_FRONT_MATTER.ID];
-    if (typeof id === "string") metadata.id = id;
-    const branch = parsed[SESSION_FRONT_MATTER.BRANCH];
-    metadata.branch = typeof branch === "string" ? branch : DEFAULT_SESSION_METADATA.branch;
-    const worktree = parsed[SESSION_FRONT_MATTER.WORKTREE];
-    metadata.worktree = typeof worktree === "string" ? worktree : DEFAULT_SESSION_METADATA.worktree;
-    const goal = parsed[SESSION_FRONT_MATTER.GOAL];
-    metadata.goal = typeof goal === "string" ? goal : DEFAULT_SESSION_METADATA.goal;
-    const nextStep = parsed[SESSION_FRONT_MATTER.NEXT_STEP];
-    metadata.next_step = typeof nextStep === "string" ? nextStep : DEFAULT_SESSION_METADATA.next_step;
-    const result = parsed[SESSION_FRONT_MATTER.RESULT];
-    metadata.result = typeof result === "string" ? result : DEFAULT_SESSION_METADATA.result;
-    const createdAt = parsed[SESSION_FRONT_MATTER.CREATED_AT];
-    if (typeof createdAt === "string") metadata.created_at = createdAt;
-    const agentSessionId = parsed[SESSION_FRONT_MATTER.AGENT_SESSION_ID];
-    if (typeof agentSessionId === "string") metadata.agent_session_id = agentSessionId;
-    const specs = parsed[SESSION_FRONT_MATTER.SPECS];
-    if (Array.isArray(specs)) {
-      metadata.specs = specs.filter((s) => typeof s === "string");
-    }
-    const files = parsed[SESSION_FRONT_MATTER.FILES];
-    if (Array.isArray(files)) {
-      metadata.files = files.filter((f) => typeof f === "string");
-    }
-    return metadata;
-  } catch {
-    return defaultSessionMetadata();
+var SessionInvalidJsonHeaderError = class extends SessionError {
+  constructor(reason) {
+    super(`Invalid JSON header for handoff: ${reason}`);
+    this.name = "SessionInvalidJsonHeaderError";
   }
-}
-function sortSessions(sessions) {
-  return [...sessions].sort((a, b) => {
-    const priorityA = PRIORITY_ORDER[a.metadata.priority];
-    const priorityB = PRIORITY_ORDER[b.metadata.priority];
-    if (priorityA !== priorityB) {
-      return priorityA - priorityB;
-    }
-    const dateA = parseSessionId(a.id);
-    const dateB = parseSessionId(b.id);
-    if (!dateA && !dateB) return 0;
-    if (!dateA) return 1;
-    if (!dateB) return -1;
-    return dateB.getTime() - dateA.getTime();
-  });
-}
+};
 
 // src/git/root.ts
 import { execa as execa2 } from "execa";
 import { dirname, isAbsolute, join as join3, relative as relative2, resolve as resolve3 } from "path";
 
-// src/git/errors.ts
-var SESSION_GIT_CONTEXT_ERROR_MESSAGE = {
-  BRANCH_UNAVAILABLE: "Cannot create a handoff session because the current Git branch could not be detected.",
-  EMPTY_BRANCH: "Cannot create a handoff session because Git returned an empty branch name.",
-  DETACHED_HEAD: "Cannot create a handoff session from a detached HEAD."
-};
-var SessionGitContextError = class extends Error {
-  constructor(message = SESSION_GIT_CONTEXT_ERROR_MESSAGE.BRANCH_UNAVAILABLE) {
-    super(message);
-    this.name = "SessionGitContextError";
-  }
-};
-var SessionDetachedHeadError = class extends SessionGitContextError {
-  constructor() {
-    super(SESSION_GIT_CONTEXT_ERROR_MESSAGE.DETACHED_HEAD);
-    this.name = "SessionDetachedHeadError";
-  }
-};
-
 // src/config/defaults.ts
 var DEFAULT_CONFIG = {
   sessions: {
@@ -3131,14 +2983,22 @@ var GIT_ROOT_COMMAND = {
   ABBREV_REF: "--abbrev-ref",
   GIT_COMMON_DIR: "--git-common-dir",
   HEAD: "HEAD",
-  SHOW_TOPLEVEL: "--show-toplevel"
+  SHOW_TOPLEVEL: "--show-toplevel",
+  SYMBOLIC_REF: "symbolic-ref",
+  SHORT: "--short",
+  ORIGIN_HEAD_REF: "refs/remotes/origin/HEAD",
+  STATUS: "status",
+  PORCELAIN: "--porcelain",
+  PATH_FORMAT_ABSOLUTE: "--path-format=absolute"
 };
+var ORIGIN_REF_PREFIX = "origin/";
 var GIT_SHOW_TOPLEVEL_ARGS = [
   GIT_ROOT_COMMAND.REV_PARSE,
   GIT_ROOT_COMMAND.SHOW_TOPLEVEL
 ];
 var GIT_COMMON_DIR_ARGS = [
   GIT_ROOT_COMMAND.REV_PARSE,
+  GIT_ROOT_COMMAND.PATH_FORMAT_ABSOLUTE,
   GIT_ROOT_COMMAND.GIT_COMMON_DIR
 ];
 var GIT_CURRENT_BRANCH_ARGS = [
@@ -3146,6 +3006,19 @@ var GIT_CURRENT_BRANCH_ARGS = [
   GIT_ROOT_COMMAND.ABBREV_REF,
   GIT_ROOT_COMMAND.HEAD
 ];
+var GIT_HEAD_SHA_ARGS = [
+  GIT_ROOT_COMMAND.REV_PARSE,
+  GIT_ROOT_COMMAND.HEAD
+];
+var GIT_ORIGIN_HEAD_REF_ARGS = [
+  GIT_ROOT_COMMAND.SYMBOLIC_REF,
+  GIT_ROOT_COMMAND.SHORT,
+  GIT_ROOT_COMMAND.ORIGIN_HEAD_REF
+];
+var GIT_STATUS_PORCELAIN_ARGS = [
+  GIT_ROOT_COMMAND.STATUS,
+  GIT_ROOT_COMMAND.PORCELAIN
+];
 async function detectWorktreeProductRoot(cwd = process.cwd(), deps = defaultDeps) {
   try {
     const result = await deps.execa(
@@ -3224,36 +3097,68 @@ function computeRelativeWorktreePath(commonDir, toplevel) {
   const worktreePath = relative2(commonDirProductRoot, toplevel);
   return worktreePath === "" ? "" : worktreePath;
 }
-async function detectSessionWorkContext(cwd = process.cwd(), deps = defaultDeps) {
-  const branchResult = await deps.execa(
+async function resolveDefaultBranch(cwd = process.cwd(), deps = defaultDeps) {
+  const result = await deps.execa(
+    GIT_ROOT_COMMAND.EXECUTABLE,
+    [...GIT_ORIGIN_HEAD_REF_ARGS],
+    { cwd, reject: false }
+  );
+  if (result.exitCode !== 0) return null;
+  const ref = extractStdout(result.stdout);
+  if (!ref.startsWith(ORIGIN_REF_PREFIX)) return null;
+  const branch = ref.slice(ORIGIN_REF_PREFIX.length);
+  return branch.length === 0 ? null : branch;
+}
+async function getCurrentBranch(cwd = process.cwd(), deps = defaultDeps) {
+  const result = await deps.execa(
     GIT_ROOT_COMMAND.EXECUTABLE,
     [...GIT_CURRENT_BRANCH_ARGS],
     { cwd, reject: false }
   );
-  const branch = extractStdout(branchResult.stdout);
-  if (branchResult.exitCode !== 0) {
-    throw new SessionGitContextError(SESSION_GIT_CONTEXT_ERROR_MESSAGE.BRANCH_UNAVAILABLE);
-  }
-  if (branch.length === 0) {
-    throw new SessionGitContextError(SESSION_GIT_CONTEXT_ERROR_MESSAGE.EMPTY_BRANCH);
-  }
-  if (branch === GIT_ROOT_COMMAND.HEAD) {
-    throw new SessionDetachedHeadError();
-  }
-  const toplevelResult = await deps.execa(
+  if (result.exitCode !== 0) return null;
+  const branch = extractStdout(result.stdout);
+  if (branch.length === 0 || branch === GIT_ROOT_COMMAND.HEAD) return null;
+  return branch;
+}
+async function getHeadSha(cwd = process.cwd(), deps = defaultDeps) {
+  const result = await deps.execa(
+    GIT_ROOT_COMMAND.EXECUTABLE,
+    [...GIT_HEAD_SHA_ARGS],
+    { cwd, reject: false }
+  );
+  if (result.exitCode !== 0) return null;
+  const sha = extractStdout(result.stdout);
+  return sha.length === 0 ? null : sha;
+}
+async function resolveRefSha(ref, cwd = process.cwd(), deps = defaultDeps) {
+  const result = await deps.execa(
     GIT_ROOT_COMMAND.EXECUTABLE,
-    [...GIT_SHOW_TOPLEVEL_ARGS],
+    [GIT_ROOT_COMMAND.REV_PARSE, ref],
     { cwd, reject: false }
   );
-  const commonDirResult = await deps.execa(
+  if (result.exitCode !== 0) return null;
+  const sha = extractStdout(result.stdout);
+  return sha.length === 0 ? null : sha;
+}
+async function isWorkingTreeClean(cwd = process.cwd(), deps = defaultDeps) {
+  const result = await deps.execa(
     GIT_ROOT_COMMAND.EXECUTABLE,
-    [...GIT_COMMON_DIR_ARGS],
+    [...GIT_STATUS_PORCELAIN_ARGS],
     { cwd, reject: false }
   );
+  if (result.exitCode !== 0) return false;
+  return extractStdout(result.stdout).length === 0;
+}
+async function isRootWorktree(cwd = process.cwd(), deps = defaultDeps) {
+  const [toplevelResult, commonDirResult] = await Promise.all([
+    deps.execa(GIT_ROOT_COMMAND.EXECUTABLE, [...GIT_SHOW_TOPLEVEL_ARGS], { cwd, reject: false }),
+    deps.execa(GIT_ROOT_COMMAND.EXECUTABLE, [...GIT_COMMON_DIR_ARGS], { cwd, reject: false })
+  ]);
+  if (toplevelResult.exitCode !== 0) return false;
+  if (commonDirResult.exitCode !== 0) return true;
   const toplevel = extractStdout(toplevelResult.stdout);
   const commonDir = extractStdout(commonDirResult.stdout);
-  const worktree = toplevelResult.exitCode === 0 && commonDirResult.exitCode === 0 ? computeRelativeWorktreePath(commonDir, toplevel) : "";
-  return { branch, worktree };
+  return computeRelativeWorktreePath(commonDir, toplevel) === "";
 }
 async function resolveSessionConfig(options = {}) {
   const { sessionsDir, cwd, deps } = options;
@@ -3326,11 +3231,6 @@ async function resolveArchivePaths(sessionId, config) {
 }
 async function archiveSingle(sessionId, config) {
   const { source, target } = await resolveArchivePaths(sessionId, config);
-  const content = await readFile3(source, "utf-8");
-  const metadata = parseSessionMetadata(content);
-  if (metadata.result.trim().length === 0) {
-    throw new SessionInvalidResultError(sessionId);
-  }
   await mkdir(dirname2(target), { recursive: true });
   await rename(source, target);
   return `${SESSION_ARCHIVE_OUTPUT.ARCHIVED}: ${sessionId}
@@ -3355,63 +3255,197 @@ function resolveDeletePath(sessionId, existingPaths) {
 
 // src/domains/session/show.ts
 import { join as join5 } from "path";
-var SESSION_SHOW_LABEL = {
-  ID: "ID",
-  STATUS: "Status",
-  PRIORITY: "Priority",
-  BRANCH: "Branch",
-  WORKTREE: "Worktree",
-  GOAL: "Goal",
-  NEXT_STEP: "Next step",
-  RESULT: "Result",
-  CREATED: "Created",
-  AGENT_SESSION: "Agent session"
-};
-var SESSION_SHOW_SEPARATOR_CHAR = "\u2500";
-var SESSION_SHOW_SEPARATOR_WIDTH = 40;
-var { dir: sessionsBaseDir, statusDirs } = DEFAULT_CONFIG.sessions;
-var DEFAULT_SESSION_CONFIG = {
-  todoDir: join5(sessionsBaseDir, statusDirs.todo),
-  doingDir: join5(sessionsBaseDir, statusDirs.doing),
-  archiveDir: join5(sessionsBaseDir, statusDirs.archive)
-};
-var SEARCH_ORDER = [...SESSION_STATUSES];
-function resolveSessionPaths(id, config = DEFAULT_SESSION_CONFIG) {
-  const filename = `${id}.md`;
-  return [
-    `${config.todoDir}/${filename}`,
-    `${config.doingDir}/${filename}`,
-    `${config.archiveDir}/${filename}`
-  ];
+
+// src/domains/session/list.ts
+import { parse as parseYaml2 } from "yaml";
+
+// src/domains/session/timestamp.ts
+var SESSION_ID_PATTERN = /^(\d{4})-(\d{2})-(\d{2})_(\d{2})-(\d{2})-(\d{2})$/;
+var SESSION_ID_SEPARATOR = "_";
+function generateSessionId(options = {}) {
+  const now = options.now ?? (() => /* @__PURE__ */ new Date());
+  const date = now();
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  const hours = String(date.getHours()).padStart(2, "0");
+  const minutes = String(date.getMinutes()).padStart(2, "0");
+  const seconds = String(date.getSeconds()).padStart(2, "0");
+  return `${year}-${month}-${day}${SESSION_ID_SEPARATOR}${hours}-${minutes}-${seconds}`;
 }
-function formatShowOutput(content, options) {
-  const metadata = parseSessionMetadata(content);
-  const headerLines = [
-    `${SESSION_SHOW_LABEL.ID}: ${metadata.id ?? ""}`,
-    `${SESSION_SHOW_LABEL.STATUS}: ${options.status}`,
-    `${SESSION_SHOW_LABEL.PRIORITY}: ${metadata.priority}`,
-    `${SESSION_SHOW_LABEL.BRANCH}: ${metadata.branch}`,
-    `${SESSION_SHOW_LABEL.WORKTREE}: ${metadata.worktree}`,
-    `${SESSION_SHOW_LABEL.GOAL}: ${metadata.goal}`,
-    `${SESSION_SHOW_LABEL.NEXT_STEP}: ${metadata.next_step}`,
-    `${SESSION_SHOW_LABEL.RESULT}: ${metadata.result}`,
-    `${SESSION_SHOW_LABEL.CREATED}: ${metadata.created_at ?? ""}`,
-    `${SESSION_SHOW_LABEL.AGENT_SESSION}: ${metadata.agent_session_id ?? ""}`
-  ];
-  const header = headerLines.join("\n");
-  const separator = "\n" + SESSION_SHOW_SEPARATOR_CHAR.repeat(SESSION_SHOW_SEPARATOR_WIDTH) + "\n\n";
-  return header + separator + content;
+function parseSessionId(id) {
+  const match = SESSION_ID_PATTERN.exec(id);
+  if (!match) {
+    return null;
+  }
+  const [, yearStr, monthStr, dayStr, hoursStr, minutesStr, secondsStr] = match;
+  const year = parseInt(yearStr, 10);
+  const month = parseInt(monthStr, 10) - 1;
+  const day = parseInt(dayStr, 10);
+  const hours = parseInt(hoursStr, 10);
+  const minutes = parseInt(minutesStr, 10);
+  const seconds = parseInt(secondsStr, 10);
+  if (month < 0 || month > 11) return null;
+  if (day < 1 || day > 31) return null;
+  if (hours < 0 || hours > 23) return null;
+  if (minutes < 0 || minutes > 59) return null;
+  if (seconds < 0 || seconds > 59) return null;
+  return new Date(year, month, day, hours, minutes, seconds);
 }
 
-// src/commands/session/delete.ts
-var SESSION_DELETE_OUTPUT = {
-  DELETED: "Deleted session"
+// src/domains/session/types.ts
+var SESSION_PRIORITY = {
+  HIGH: "high",
+  MEDIUM: "medium",
+  LOW: "low"
 };
-async function findExistingPaths(paths) {
-  const existing = [];
-  for (const path6 of paths) {
-    try {
-      const stats = await stat2(path6);
+var SESSION_STATUSES = ["todo", "doing", "archive"];
+var DEFAULT_LIST_STATUSES = ["doing", "todo"];
+var PRIORITY_ORDER = {
+  [SESSION_PRIORITY.HIGH]: 0,
+  [SESSION_PRIORITY.MEDIUM]: 1,
+  [SESSION_PRIORITY.LOW]: 2
+};
+var DEFAULT_PRIORITY = SESSION_PRIORITY.MEDIUM;
+var SESSION_FRONT_MATTER = {
+  PRIORITY: "priority",
+  GIT_REF: "git_ref",
+  GOAL: "goal",
+  NEXT_STEP: "next_step",
+  CREATED_AT: "created_at",
+  AGENT_SESSION_ID: "agent_session_id",
+  SPECS: "specs",
+  FILES: "files"
+};
+
+// src/domains/session/list.ts
+var FRONT_MATTER_PATTERN = /^---\r?\n([\s\S]*?)\r?\n(?:---|\.\.\.)\r?\n?/;
+var SESSION_PRIORITY_VALUES = Object.values(SESSION_PRIORITY);
+var DEFAULT_SESSION_METADATA = {
+  priority: DEFAULT_PRIORITY,
+  git_ref: "",
+  goal: "",
+  next_step: "",
+  specs: [],
+  files: []
+};
+function defaultSessionMetadata() {
+  return {
+    ...DEFAULT_SESSION_METADATA,
+    specs: [],
+    files: []
+  };
+}
+function isValidPriority(value) {
+  return typeof value === "string" && SESSION_PRIORITY_VALUES.some((priority) => priority === value);
+}
+function parseSessionMetadata(content) {
+  const match = FRONT_MATTER_PATTERN.exec(content);
+  if (!match) {
+    return defaultSessionMetadata();
+  }
+  try {
+    const parsed = parseYaml2(match[1]);
+    if (!parsed || typeof parsed !== "object") {
+      return defaultSessionMetadata();
+    }
+    const rawPriority = parsed[SESSION_FRONT_MATTER.PRIORITY];
+    const priority = isValidPriority(rawPriority) ? rawPriority : DEFAULT_PRIORITY;
+    const metadata = {
+      ...defaultSessionMetadata(),
+      priority
+    };
+    const gitRef = parsed[SESSION_FRONT_MATTER.GIT_REF];
+    metadata.git_ref = typeof gitRef === "string" ? gitRef : DEFAULT_SESSION_METADATA.git_ref;
+    const goal = parsed[SESSION_FRONT_MATTER.GOAL];
+    metadata.goal = typeof goal === "string" ? goal : DEFAULT_SESSION_METADATA.goal;
+    const nextStep = parsed[SESSION_FRONT_MATTER.NEXT_STEP];
+    metadata.next_step = typeof nextStep === "string" ? nextStep : DEFAULT_SESSION_METADATA.next_step;
+    const createdAt = parsed[SESSION_FRONT_MATTER.CREATED_AT];
+    if (typeof createdAt === "string") metadata.created_at = createdAt;
+    const agentSessionId = parsed[SESSION_FRONT_MATTER.AGENT_SESSION_ID];
+    if (typeof agentSessionId === "string") metadata.agent_session_id = agentSessionId;
+    const specs = parsed[SESSION_FRONT_MATTER.SPECS];
+    if (Array.isArray(specs)) {
+      metadata.specs = specs.filter((s) => typeof s === "string");
+    }
+    const files = parsed[SESSION_FRONT_MATTER.FILES];
+    if (Array.isArray(files)) {
+      metadata.files = files.filter((f) => typeof f === "string");
+    }
+    return metadata;
+  } catch {
+    return defaultSessionMetadata();
+  }
+}
+function sortSessions(sessions) {
+  return [...sessions].sort((a, b) => {
+    const priorityA = PRIORITY_ORDER[a.metadata.priority];
+    const priorityB = PRIORITY_ORDER[b.metadata.priority];
+    if (priorityA !== priorityB) {
+      return priorityA - priorityB;
+    }
+    const dateA = parseSessionId(a.id);
+    const dateB = parseSessionId(b.id);
+    if (!dateA && !dateB) return 0;
+    if (!dateA) return 1;
+    if (!dateB) return -1;
+    return dateB.getTime() - dateA.getTime();
+  });
+}
+
+// src/domains/session/show.ts
+var SESSION_SHOW_LABEL = {
+  STATUS: "Status",
+  PRIORITY: "Priority",
+  GIT_REF: "Git ref",
+  GOAL: "Goal",
+  NEXT_STEP: "Next step",
+  CREATED: "Created",
+  AGENT_SESSION: "Agent session"
+};
+var SESSION_SHOW_SEPARATOR_CHAR = "\u2500";
+var SESSION_SHOW_SEPARATOR_WIDTH = 40;
+var { dir: sessionsBaseDir, statusDirs } = DEFAULT_CONFIG.sessions;
+var DEFAULT_SESSION_CONFIG = {
+  todoDir: join5(sessionsBaseDir, statusDirs.todo),
+  doingDir: join5(sessionsBaseDir, statusDirs.doing),
+  archiveDir: join5(sessionsBaseDir, statusDirs.archive)
+};
+var SEARCH_ORDER = [...SESSION_STATUSES];
+function resolveSessionPaths(id, config = DEFAULT_SESSION_CONFIG) {
+  const filename = `${id}.md`;
+  return [
+    `${config.todoDir}/${filename}`,
+    `${config.doingDir}/${filename}`,
+    `${config.archiveDir}/${filename}`
+  ];
+}
+function formatShowOutput(content, options) {
+  const metadata = parseSessionMetadata(content);
+  const headerLines = [
+    `${SESSION_SHOW_LABEL.STATUS}: ${options.status}`,
+    `${SESSION_SHOW_LABEL.PRIORITY}: ${metadata.priority}`,
+    `${SESSION_SHOW_LABEL.GIT_REF}: ${metadata.git_ref}`,
+    `${SESSION_SHOW_LABEL.GOAL}: ${metadata.goal}`,
+    `${SESSION_SHOW_LABEL.NEXT_STEP}: ${metadata.next_step}`,
+    `${SESSION_SHOW_LABEL.CREATED}: ${metadata.created_at ?? ""}`,
+    `${SESSION_SHOW_LABEL.AGENT_SESSION}: ${metadata.agent_session_id ?? ""}`
+  ];
+  const header = headerLines.join("\n");
+  const separator = "\n" + SESSION_SHOW_SEPARATOR_CHAR.repeat(SESSION_SHOW_SEPARATOR_WIDTH) + "\n\n";
+  return header + separator + content;
+}
+
+// src/commands/session/delete.ts
+var SESSION_DELETE_OUTPUT = {
+  DELETED: "Deleted session"
+};
+async function findExistingPaths(paths) {
+  const existing = [];
+  for (const path6 of paths) {
+    try {
+      const stats = await stat2(path6);
       if (stats.isFile()) {
         existing.push(path6);
       }
@@ -3435,49 +3469,186 @@ async function deleteCommand(options) {
 // src/commands/session/handoff.ts
 import { mkdir as mkdir2, writeFile } from "fs/promises";
 import { join as join6, resolve as resolve4 } from "path";
+import { stringify as stringifyYaml3 } from "yaml";
 
 // src/domains/session/create.ts
-import { parse as parseYaml3, stringify as stringifyYaml2 } from "yaml";
+import { stringify as stringifyYaml2 } from "yaml";
 var SESSION_FRONT_MATTER_DELIMITER = "---";
 var SESSION_FRONT_MATTER_OPEN = `${SESSION_FRONT_MATTER_DELIMITER}
 `;
 var SESSION_FRONT_MATTER_CLOSE = `
 ${SESSION_FRONT_MATTER_DELIMITER}
 `;
-var FRONT_MATTER_BLOCK = /^---\r?\n([\s\S]*?)\r?\n(?:---|\.\.\.)\r?\n?/;
-function preFillSessionContent(content, params) {
-  const match = FRONT_MATTER_BLOCK.exec(content);
-  if (!match) return content;
-  const parsed = parseYaml3(match[1]);
-  const frontMatter = parsed && typeof parsed === "object" ? parsed : {};
-  frontMatter[SESSION_FRONT_MATTER.CREATED_AT] = params.createdAt.toISOString();
-  frontMatter[SESSION_FRONT_MATTER.BRANCH] = params.branch;
-  frontMatter[SESSION_FRONT_MATTER.WORKTREE] = params.worktree;
-  if (params.agentSessionId !== void 0) {
-    frontMatter[SESSION_FRONT_MATTER.AGENT_SESSION_ID] = params.agentSessionId;
-  } else {
-    delete frontMatter[SESSION_FRONT_MATTER.AGENT_SESSION_ID];
+
+// src/domains/session/handoff-base.ts
+function resolveHandoffGitRef(facts) {
+  if (facts.isRootWorktree) {
+    if (facts.branch !== null) return facts.branch;
+    if (facts.headSha !== null) return facts.headSha;
+    throw new SessionHandoffBaseError();
+  }
+  if (facts.branch !== null) {
+    throw new SessionHandoffBaseError();
+  }
+  if (!facts.isClean) {
+    throw new SessionHandoffBaseError();
+  }
+  if (facts.headSha === null || facts.defaultTipSha === null || facts.headSha !== facts.defaultTipSha) {
+    throw new SessionHandoffBaseError();
+  }
+  return facts.headSha;
+}
+
+// src/domains/session/parse-handoff-input.ts
+var LEGACY_FRONTMATTER_PREFIX = /^---\r?\n/;
+var JSON_OBJECT_OPEN_CHAR = "{";
+var CARRIAGE_RETURN_CHAR_CODE = "\r".charCodeAt(0);
+var NEWLINE_CHAR_CODE = "\n".charCodeAt(0);
+var BACKSLASH_CHAR_CODE = "\\".charCodeAt(0);
+var DOUBLE_QUOTE_CHAR_CODE = '"'.charCodeAt(0);
+var OPEN_BRACE_CHAR_CODE = "{".charCodeAt(0);
+var CLOSE_BRACE_CHAR_CODE = "}".charCodeAt(0);
+var UNBALANCED_HEADER_END = -1;
+var LF_SEPARATOR_LENGTH = 1;
+var CRLF_SEPARATOR_LENGTH = 2;
+var SESSION_PRIORITY_VALUES2 = new Set(Object.values(SESSION_PRIORITY));
+function parseHandoffInput(stdin) {
+  if (LEGACY_FRONTMATTER_PREFIX.test(stdin)) {
+    throw new SessionLegacyFrontmatterInputError();
+  }
+  if (!stdin.startsWith(JSON_OBJECT_OPEN_CHAR)) {
+    throw new SessionInvalidJsonHeaderError(
+      "stdin must begin with a JSON object opening with '{'"
+    );
   }
-  return `${SESSION_FRONT_MATTER_OPEN}${stringifyYaml2(frontMatter).trimEnd()}
-${SESSION_FRONT_MATTER_DELIMITER}
-${content.slice(match[0].length)}`;
+  const headerEnd = findJsonObjectEnd(stdin);
+  if (headerEnd === UNBALANCED_HEADER_END) {
+    throw new SessionInvalidJsonHeaderError(
+      "unbalanced JSON object \u2014 opening brace has no matching close"
+    );
+  }
+  const headerText = stdin.slice(0, headerEnd + 1);
+  let parsed;
+  try {
+    parsed = JSON.parse(headerText);
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : "JSON.parse failed";
+    throw new SessionInvalidJsonHeaderError(detail);
+  }
+  const header = validateHandoffHeader(parsed);
+  const bodyStart = consumeOptionalBodySeparator(stdin, headerEnd + 1);
+  return { header, body: stdin.slice(bodyStart) };
+}
+function consumeOptionalBodySeparator(stdin, bodyStart) {
+  if (stdin.charCodeAt(bodyStart) === CARRIAGE_RETURN_CHAR_CODE && stdin.charCodeAt(bodyStart + LF_SEPARATOR_LENGTH) === NEWLINE_CHAR_CODE) {
+    return bodyStart + CRLF_SEPARATOR_LENGTH;
+  }
+  if (stdin.charCodeAt(bodyStart) === NEWLINE_CHAR_CODE) {
+    return bodyStart + LF_SEPARATOR_LENGTH;
+  }
+  return bodyStart;
+}
+function findJsonObjectEnd(stdin) {
+  let depth = 0;
+  let inString = false;
+  for (let i = 0; i < stdin.length; i++) {
+    const code = stdin.charCodeAt(i);
+    if (inString) {
+      if (code === BACKSLASH_CHAR_CODE) {
+        i += 1;
+        continue;
+      }
+      if (code === DOUBLE_QUOTE_CHAR_CODE) {
+        inString = false;
+      }
+      continue;
+    }
+    if (code === DOUBLE_QUOTE_CHAR_CODE) {
+      inString = true;
+      continue;
+    }
+    if (code === OPEN_BRACE_CHAR_CODE) {
+      depth += 1;
+      continue;
+    }
+    if (code === CLOSE_BRACE_CHAR_CODE) {
+      depth -= 1;
+      if (depth === 0) return i;
+    }
+  }
+  return UNBALANCED_HEADER_END;
 }
-
-// src/commands/session/handoff.ts
-function buildSessionContent(content) {
-  if (!content || content.trim().length === 0) {
-    throw new SessionInvalidContentError("Session content cannot be empty");
+function validateHandoffHeader(parsed) {
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new SessionInvalidJsonHeaderError("header must be a JSON object");
   }
-  return content;
+  const obj = parsed;
+  const priority = ensurePriorityOrDefault(obj[SESSION_FRONT_MATTER.PRIORITY]);
+  const goal = ensureStringOrEmpty(obj[SESSION_FRONT_MATTER.GOAL], SESSION_FRONT_MATTER.GOAL);
+  const nextStep = ensureStringOrEmpty(obj[SESSION_FRONT_MATTER.NEXT_STEP], SESSION_FRONT_MATTER.NEXT_STEP);
+  const specs = ensureStringArrayOrDefault(obj[SESSION_FRONT_MATTER.SPECS], SESSION_FRONT_MATTER.SPECS);
+  const files = ensureStringArrayOrDefault(obj[SESSION_FRONT_MATTER.FILES], SESSION_FRONT_MATTER.FILES);
+  return {
+    priority,
+    goal,
+    next_step: nextStep,
+    specs,
+    files
+  };
 }
-function validateRequiredMetadata(content) {
-  const metadata = parseSessionMetadata(content);
-  if (metadata.goal.trim().length === 0) {
-    throw new SessionInvalidGoalError();
+function ensurePriorityOrDefault(value) {
+  if (value === void 0) return DEFAULT_PRIORITY;
+  if (typeof value !== "string" || !SESSION_PRIORITY_VALUES2.has(value)) {
+    throw new SessionInvalidJsonHeaderError(
+      `${SESSION_FRONT_MATTER.PRIORITY} must be one of ${[...SESSION_PRIORITY_VALUES2].join(", ")}`
+    );
   }
-  if (metadata.next_step.trim().length === 0) {
-    throw new SessionInvalidNextStepError();
+  return value;
+}
+function ensureStringOrEmpty(value, fieldName) {
+  if (value === void 0) return "";
+  if (typeof value !== "string") {
+    throw new SessionInvalidJsonHeaderError(`${fieldName} must be a string`);
+  }
+  return value;
+}
+function ensureStringArrayOrDefault(value, fieldName) {
+  if (value === void 0) return [];
+  if (!Array.isArray(value)) {
+    throw new SessionInvalidJsonHeaderError(`${fieldName} must be an array of strings`);
+  }
+  for (const item of value) {
+    if (typeof item !== "string") {
+      throw new SessionInvalidJsonHeaderError(`${fieldName} must be an array of strings`);
+    }
   }
+  return value;
+}
+
+// src/commands/session/handoff.ts
+async function resolveSessionGitRef(cwd, deps) {
+  const [isRoot, branch, headSha] = await Promise.all([
+    isRootWorktree(cwd, deps),
+    getCurrentBranch(cwd, deps),
+    getHeadSha(cwd, deps)
+  ]);
+  let isClean = false;
+  let defaultTipSha = null;
+  if (!isRoot && branch === null) {
+    const [clean, defaultBranch] = await Promise.all([
+      isWorkingTreeClean(cwd, deps),
+      resolveDefaultBranch(cwd, deps)
+    ]);
+    isClean = clean;
+    defaultTipSha = defaultBranch === null ? null : await resolveRefSha(`${ORIGIN_REF_PREFIX}${defaultBranch}`, cwd, deps);
+  }
+  return resolveHandoffGitRef({
+    isRootWorktree: isRoot,
+    branch,
+    headSha,
+    isClean,
+    defaultTipSha
+  });
 }
 async function handoffCommand(options) {
   const { config, warning } = await resolveSessionConfig({
@@ -3485,32 +3656,47 @@ async function handoffCommand(options) {
     cwd: options.cwd,
     deps: options.deps
   });
-  const baseContent = buildSessionContent(options.content);
-  const workContext = await detectSessionWorkContext(options.cwd, options.deps);
+  const content = options.content;
+  if (content === void 0 || content.trim().length === 0) {
+    throw new SessionInvalidContentError("Session content cannot be empty");
+  }
+  const { header, body } = parseHandoffInput(content);
+  if (header.goal.length === 0) {
+    throw new SessionInvalidGoalError();
+  }
+  if (header.next_step.length === 0) {
+    throw new SessionInvalidNextStepError();
+  }
+  const gitRef = await resolveSessionGitRef(options.cwd, options.deps);
   const sessionId = generateSessionId();
   const agentSessionId = process.env.CLAUDE_SESSION_ID ?? process.env.CODEX_THREAD_ID;
-  const fullContent = preFillSessionContent(baseContent, {
-    createdAt: /* @__PURE__ */ new Date(),
-    agentSessionId,
-    branch: workContext.branch,
-    worktree: workContext.worktree
-  });
-  validateRequiredMetadata(fullContent);
+  const createdAt = (/* @__PURE__ */ new Date()).toISOString();
+  const frontMatterObject = {
+    [SESSION_FRONT_MATTER.PRIORITY]: header.priority,
+    [SESSION_FRONT_MATTER.CREATED_AT]: createdAt,
+    [SESSION_FRONT_MATTER.GIT_REF]: gitRef,
+    [SESSION_FRONT_MATTER.GOAL]: header.goal,
+    [SESSION_FRONT_MATTER.NEXT_STEP]: header.next_step,
+    [SESSION_FRONT_MATTER.SPECS]: [...header.specs],
+    [SESSION_FRONT_MATTER.FILES]: [...header.files]
+  };
+  if (agentSessionId !== void 0) {
+    frontMatterObject[SESSION_FRONT_MATTER.AGENT_SESSION_ID] = agentSessionId;
+  }
+  const yaml = stringifyYaml3(frontMatterObject, { defaultStringType: "QUOTE_DOUBLE" }).trimEnd();
+  const fullContent = `${SESSION_FRONT_MATTER_OPEN}${yaml}${SESSION_FRONT_MATTER_CLOSE}${body}`;
   const filename = `${sessionId}.md`;
   const sessionPath = join6(config.todoDir, filename);
   const absolutePath = resolve4(sessionPath);
   await mkdir2(config.todoDir, { recursive: true });
   await writeFile(sessionPath, fullContent, "utf-8");
-  if (warning) {
-    process.stderr.write(`${warning}
-`);
-  }
-  return `Created handoff session <HANDOFF_ID>${sessionId}</HANDOFF_ID>
+  const output = `Created handoff session <HANDOFF_ID>${sessionId}</HANDOFF_ID>
 <SESSION_FILE>${absolutePath}</SESSION_FILE>`;
+  return warning ? { output, warning } : { output };
 }
 
 // src/commands/session/list.ts
-import { readdir, readFile as readFile4 } from "fs/promises";
+import { readdir, readFile as readFile3 } from "fs/promises";
 import { join as join7 } from "path";
 var SESSION_LIST_FORMAT = {
   TEXT: "text",
@@ -3526,7 +3712,7 @@ async function loadSessionsFromDir(dir, status) {
       if (!file.endsWith(".md")) continue;
       const id = file.replace(".md", "");
       const filePath = join7(dir, file);
-      const content = await readFile4(filePath, "utf-8");
+      const content = await readFile3(filePath, "utf-8");
       const metadata = parseSessionMetadata(content);
       sessions.push({
         id,
@@ -3588,7 +3774,7 @@ async function listCommand(options) {
 }
 
 // src/commands/session/pickup.ts
-import { mkdir as mkdir3, readdir as readdir2, readFile as readFile5, rename as rename2 } from "fs/promises";
+import { mkdir as mkdir3, readdir as readdir2, readFile as readFile4, rename as rename2 } from "fs/promises";
 import { join as join8 } from "path";
 
 // src/domains/session/pickup.ts
@@ -3635,7 +3821,7 @@ async function loadTodoSessions(config) {
       if (!file.endsWith(".md")) continue;
       const id = file.replace(".md", "");
       const filePath = join8(config.todoDir, file);
-      const content = await readFile5(filePath, "utf-8");
+      const content = await readFile4(filePath, "utf-8");
       const metadata = parseSessionMetadata(content);
       sessions.push({
         id,
@@ -3652,21 +3838,7 @@ async function loadTodoSessions(config) {
     throw error;
   }
 }
-async function pickupCommand(options) {
-  const { config } = await resolveSessionConfig({ sessionsDir: options.sessionsDir });
-  let sessionId;
-  if (options.auto) {
-    const sessions = await loadTodoSessions(config);
-    const selected = selectBestSession(sessions);
-    if (!selected) {
-      throw new NoSessionsAvailableError();
-    }
-    sessionId = selected.id;
-  } else if (options.sessionId) {
-    sessionId = options.sessionId;
-  } else {
-    throw new Error("Either session ID or --auto flag is required");
-  }
+async function pickupSingle(sessionId, config) {
   const paths = buildClaimPaths(sessionId, config);
   await mkdir3(config.doingDir, { recursive: true });
   try {
@@ -3674,15 +3846,36 @@ async function pickupCommand(options) {
   } catch (error) {
     throw classifyClaimError(error, sessionId);
   }
-  const content = await readFile5(paths.target, "utf-8");
+  const content = await readFile4(paths.target, "utf-8");
   const output = formatShowOutput(content, { status: PICKUP_TARGET_STATUS });
   return `Claimed session <PICKUP_ID>${sessionId}</PICKUP_ID>
 
 ${output}`;
 }
+async function pickupCommand(options) {
+  const { config } = await resolveSessionConfig({ sessionsDir: options.sessionsDir });
+  if (options.auto) {
+    if (options.sessionIds.length > 0) {
+      throw new Error("Session IDs cannot be combined with --auto");
+    }
+    const sessions = await loadTodoSessions(config);
+    const selected = selectBestSession(sessions);
+    if (!selected) {
+      throw new NoSessionsAvailableError();
+    }
+    return pickupSingle(selected.id, config);
+  }
+  if (options.sessionIds.length === 0) {
+    throw new Error("Either session ID or --auto flag is required");
+  }
+  if (options.sessionIds.length === 1) {
+    return pickupSingle(options.sessionIds[0], config);
+  }
+  return processBatch(options.sessionIds, (id) => pickupSingle(id, config));
+}
 
 // src/commands/session/prune.ts
-import { readdir as readdir3, readFile as readFile6, unlink as unlink2 } from "fs/promises";
+import { readdir as readdir3, readFile as readFile5, unlink as unlink2 } from "fs/promises";
 import { join as join9 } from "path";
 
 // src/domains/session/prune.ts
@@ -3733,7 +3926,7 @@ async function loadArchiveSessions(config) {
       if (!file.endsWith(".md")) continue;
       const id = file.replace(".md", "");
       const filePath = join9(config.archiveDir, file);
-      const content = await readFile6(filePath, "utf-8");
+      const content = await readFile5(filePath, "utf-8");
       const metadata = parseSessionMetadata(content);
       sessions.push({
         id,
@@ -3850,7 +4043,7 @@ async function releaseCommand(options) {
 }
 
 // src/commands/session/show.ts
-import { readFile as readFile7, stat as stat3 } from "fs/promises";
+import { readFile as readFile6, stat as stat3 } from "fs/promises";
 async function findExistingPath(paths, _config) {
   for (let i = 0; i < paths.length; i++) {
     const filePath = paths[i];
@@ -3870,7 +4063,7 @@ async function showSingle(sessionId, config) {
   if (!found) {
     throw new SessionNotFoundError(sessionId);
   }
-  const content = await readFile7(found.path, "utf-8");
+  const content = await readFile6(found.path, "utf-8");
   return formatShowOutput(content, { status: found.status });
 }
 async function showCommand2(options) {
@@ -3885,9 +4078,9 @@ Session File Format:
 
   ---
   priority: high
+  git_ref: main
   goal: Fix the failing release check
   next_step: Run the focused session tests
-  result: Local validation passed
   specs: []
   files: []
   ---
@@ -3896,43 +4089,47 @@ Session File Format:
   Session content...
 
 Workflow:
-  1. handoff  - Create session (todo)
+  1. handoff  - Create session (todo) \u2014 JSON header + body on stdin
   2. pickup   - Claim session (todo -> doing)
   3. release  - Return session (doing -> todo)
-  4. archive  - Move session with a result to archive
+  4. archive  - Move session to archive
   5. delete   - Remove session permanently
 `;
 var HANDOFF_FRONTMATTER_HELP = `
 Usage:
-  Pipe content with frontmatter via stdin
+  Pipe a JSON header followed by the body bytes to stdin.
 
-Frontmatter Format:
-  ---
-  priority: high      # high | medium | low (default: medium)
-  goal: Fix login     # required
-  next_step: Run validation  # required
-  specs: []           # optional pickup context
-  files: []           # optional pickup context
-  ---
-  # Your session content here...
+  The header is a single JSON object holding caller-supplied structured fields.
+  A single LF or CRLF after the header is consumed as a separator. The body
+  is the remaining bytes verbatim \u2014 no YAML, no escape rules, no ambiguity
+  from leading characters like '#' or '---'.
+
+JSON Header Fields:
+  priority    "high" | "medium" | "low" (default: medium)
+  goal        required, non-empty string
+  next_step   required, non-empty string
+  specs       optional string[], for pickup auto-injection
+  files       optional string[], for pickup auto-injection
 
 Prefilled by the CLI:
-  created_at, branch, worktree, agent_session_id when an agent session ID is available
+  created_at, git_ref, and agent_session_id when an agent session ID is
+  available.
 
-Before archive:
-  Add a non-empty result field to the frontmatter.
+  git_ref records the branch name (root worktree on a branch), the HEAD SHA
+  (detached), or the origin/<default> tip SHA (clean detached linked worktree).
+  Handoff is refused from any other linked-worktree state.
 
 Output Tags (for automation):
-  <HANDOFF_ID>session-id</HANDOFF_ID>     - Session identifier
-  <SESSION_FILE>/path/to/file</SESSION_FILE> - Absolute path to created file
-
-Examples:
-  echo '---
-  priority: high
-  goal: Fix login
-  next_step: Run validation
-  ---
-  # Fix login' | spx session handoff
+  <HANDOFF_ID>session-id</HANDOFF_ID>          Session identifier
+  <SESSION_FILE>/path/to/file</SESSION_FILE>   Absolute path to created file
+
+Canonical Invocation:
+  printf '%s\\n' \\
+    '{"priority":"high","goal":"Fix login","next_step":"Run validation","specs":[],"files":[]}' \\
+    '# Fix login' \\
+    '' \\
+    'Body text \u2014 # symbols, --- delimiters, and code fences are literal.' \\
+    | spx session handoff
 `;
 var PICKUP_SELECTION_HELP = `
 Selection Logic (--auto):
@@ -3943,10 +4140,10 @@ Selection Logic (--auto):
     4. Within same priority: oldest session first
 
 Output:
-  <PICKUP_ID>session-id</PICKUP_ID> tag for automation parsing
+  <PICKUP_ID>session-id</PICKUP_ID> tag for each claimed session
 `;
 
-// src/domains/session/index.ts
+// src/interfaces/cli/session.ts
 async function readStdin() {
   if (process.stdin.isTTY) {
     return void 0;
@@ -3958,7 +4155,7 @@ async function readStdin() {
       data += chunk;
     });
     process.stdin.on("end", () => {
-      resolve6(data.trim() || void 0);
+      resolve6(data.length === 0 ? void 0 : data);
     });
     process.stdin.on("error", () => {
       resolve6(void 0);
@@ -4005,14 +4202,14 @@ function registerSessionCommands(sessionCmd) {
       handleError(error);
     }
   });
-  sessionCmd.command("pickup [id]").description("Claim a session (move from todo to doing)").option("--auto", "Auto-select highest priority session").option("--sessions-dir <path>", "Custom sessions directory").addHelpText("after", PICKUP_SELECTION_HELP).action(async (id, options) => {
+  sessionCmd.command("pickup [ids...]").description("Claim one or more sessions (move from todo to doing)").option("--auto", "Auto-select highest priority session").option("--sessions-dir <path>", "Custom sessions directory").addHelpText("after", PICKUP_SELECTION_HELP).action(async (ids, options) => {
     try {
-      if (!id && !options.auto) {
+      if (ids.length === 0 && !options.auto) {
         console.error("Error: Either session ID or --auto flag is required");
         process.exit(1);
       }
       const output = await pickupCommand({
-        sessionId: id,
+        sessionIds: ids,
         auto: options.auto,
         sessionsDir: options.sessionsDir
       });
@@ -4032,14 +4229,18 @@ function registerSessionCommands(sessionCmd) {
       handleError(error);
     }
   });
-  sessionCmd.command("handoff").description("Create a handoff session (reads content with frontmatter from stdin)").option("--sessions-dir <path>", "Custom sessions directory").addHelpText("after", HANDOFF_FRONTMATTER_HELP).action(async (options) => {
+  sessionCmd.command("handoff").description("Create a handoff session (reads JSON header + body from stdin)").option("--sessions-dir <path>", "Custom sessions directory").addHelpText("after", HANDOFF_FRONTMATTER_HELP).action(async (options) => {
     try {
       const content = await readStdin();
-      const output = await handoffCommand({
+      const result = await handoffCommand({
         content,
         sessionsDir: options.sessionsDir
       });
-      console.log(output);
+      if (result.warning !== void 0) {
+        process.stderr.write(`${result.warning}
+`);
+      }
+      console.log(result.output);
     } catch (error) {
       handleError(error);
     }
@@ -4098,7 +4299,7 @@ var sessionDomain = {
 };
 
 // src/lib/spec-tree/index.ts
-import { readdir as readdir5, readFile as readFile8 } from "fs/promises";
+import { readdir as readdir5, readFile as readFile7 } from "fs/promises";
 import { join as join10 } from "path";
 var SPEC_TREE_FIELD_KEY = {
   VERSION: "version",
@@ -4191,7 +4392,7 @@ function createFilesystemSpecTreeSource(options) {
       if (ref.path === void 0) {
         throw new Error("Filesystem source refs require a path");
       }
-      return readFile8(join10(options.productDir, ref.path), SPEC_TREE_TEXT_ENCODING);
+      return readFile7(join10(options.productDir, ref.path), SPEC_TREE_TEXT_ENCODING);
     }
   };
 }
@@ -4690,7 +4891,7 @@ function formatNodeLabel(node) {
   ].join(STATUS_SEPARATOR);
 }
 
-// src/domains/spec/index.ts
+// src/interfaces/cli/spec.ts
 var SPEC_DOMAIN_CLI = {
   COMMAND: "spec",
   STATUS_COMMAND: "status",
@@ -4760,6 +4961,9 @@ var specDomain = {
   }
 };
 
+// src/commands/validation/markdown.ts
+import { relative as relative4 } from "path";
+
 // src/validation/config/path-filter.ts
 import { isAbsolute as isAbsolute2, relative as relative3 } from "path";
 var PATH_PREFIX_SEPARATOR = "/";
@@ -4855,28 +5059,313 @@ function applyValidationPathFilterToScope(scopeConfig, filter) {
   };
 }
 
-// node_modules/.pnpm/jsonc-parser@3.3.1/node_modules/jsonc-parser/lib/esm/impl/scanner.js
-function createScanner(text, ignoreTrivia = false) {
-  const len = text.length;
-  let pos = 0, value = "", tokenOffset = 0, token = 16, lineNumber = 0, lineStartOffset = 0, tokenLineStartOffset = 0, prevTokenLineStartOffset = 0, scanError = 0;
-  function scanHexDigits(count, exact) {
-    let digits = 0;
-    let value2 = 0;
-    while (digits < count || !exact) {
-      let ch = text.charCodeAt(pos);
-      if (ch >= 48 && ch <= 57) {
-        value2 = value2 * 16 + ch - 48;
-      } else if (ch >= 65 && ch <= 70) {
-        value2 = value2 * 16 + ch - 65 + 10;
-      } else if (ch >= 97 && ch <= 102) {
-        value2 = value2 * 16 + ch - 97 + 10;
-      } else {
-        break;
-      }
-      pos++;
-      digits++;
-    }
-    if (digits < count) {
+// src/validation/steps/markdown.ts
+import { existsSync as existsSync2, statSync } from "fs";
+import { basename, dirname as dirname3, join as join11, relative as pathRelative } from "path";
+import { main as markdownlintMain } from "markdownlint-cli2";
+import relativeLinksRule from "markdownlint-rule-relative-links";
+var MARKDOWN_DEFAULT_DIRECTORY_NAMES = ["spx", "docs"];
+var MARKDOWN_FILE_EXTENSIONS = /* @__PURE__ */ new Set([".md", ".markdown"]);
+var MARKDOWN_DIRECTORY_GLOB = "**/*.md";
+var ENABLED_RULES = {
+  MD001: true,
+  MD003: true,
+  MD009: true,
+  MD010: true,
+  MD025: true,
+  MD047: true
+};
+var MD024_DISABLED_DIRECTORIES = ["docs"];
+var MARKDOWN_CUSTOM_RULE_NAMES = relativeLinksRule.names;
+var MARKDOWN_VALIDATION_TARGET_KIND = {
+  DIRECTORY: "directory",
+  FILE: "file"
+};
+var MARKDOWN_VALIDATION_TARGET_DIAGNOSTICS = {
+  MISSING_OR_UNRELATED_SCOPE: "not an existing directory or markdown file"
+};
+var ERROR_LINE_PATTERN = /^(.+?):(\d+)(?::\d+)?\s+(.+)$/;
+var defaultMarkdownValidationTargetDeps = {
+  statSync
+};
+function buildMarkdownlintConfig(directoryName) {
+  const md024Disabled = MD024_DISABLED_DIRECTORIES.includes(
+    directoryName
+  );
+  return {
+    default: false,
+    ...ENABLED_RULES,
+    MD024: md024Disabled ? false : { siblings_only: true },
+    customRules: [relativeLinksRule]
+  };
+}
+function getDefaultDirectories(projectRoot) {
+  return MARKDOWN_DEFAULT_DIRECTORY_NAMES.map((name) => join11(projectRoot, name)).filter((dir) => existsSync2(dir));
+}
+function resolveMarkdownValidationTarget(path6, deps = defaultMarkdownValidationTargetDeps) {
+  if (isExistingDirectory(path6, deps)) {
+    return { target: { kind: MARKDOWN_VALIDATION_TARGET_KIND.DIRECTORY, path: path6 } };
+  }
+  if (hasMarkdownExtension(path6) && isExistingFile(path6, deps)) {
+    return { target: { kind: MARKDOWN_VALIDATION_TARGET_KIND.FILE, path: path6 } };
+  }
+  return {
+    skipped: {
+      path: path6,
+      reason: MARKDOWN_VALIDATION_TARGET_DIAGNOSTICS.MISSING_OR_UNRELATED_SCOPE
+    }
+  };
+}
+function getExcludeGlobs(projectRoot) {
+  if (projectRoot === void 0) return [];
+  const reader = createIgnoreSourceReader(projectRoot, {
+    ignoreSourceFilename: IGNORE_SOURCE_FILENAME_DEFAULT,
+    specTreeRootSegment: SPEC_TREE_CONFIG.ROOT_DIRECTORY
+  });
+  return reader.entries().map((entry) => `${entry.segment}/**`);
+}
+var DATA_URI_PATTERN = /\bdata:/;
+function parseErrorLine(line) {
+  if (DATA_URI_PATTERN.test(line)) {
+    return null;
+  }
+  const match = ERROR_LINE_PATTERN.exec(line);
+  if (!match) {
+    return null;
+  }
+  const [, file, lineStr, detail] = match;
+  return {
+    file,
+    line: parseInt(lineStr, 10),
+    detail
+  };
+}
+async function validateMarkdown(options) {
+  const { targets, projectRoot } = options;
+  const errors = [];
+  const excludeGlobs = getExcludeGlobs(projectRoot);
+  for (const target of targets) {
+    const directory = targetDirectory(target);
+    const dirName = markdownlintConfigDirectoryName(directory, projectRoot);
+    const config = buildMarkdownlintConfig(dirName);
+    const dirErrors = await validateTarget(target, config, projectRoot, excludeGlobs);
+    errors.push(...dirErrors);
+  }
+  return {
+    success: errors.length === 0,
+    errors
+  };
+}
+async function validateTarget(target, config, projectRoot, ignoreGlobs = []) {
+  const errors = [];
+  const directory = targetDirectory(target);
+  const argv = target.kind === MARKDOWN_VALIDATION_TARGET_KIND.FILE ? [basename(target.path)] : [MARKDOWN_DIRECTORY_GLOB];
+  const { customRules, ...markdownlintConfig } = config;
+  const optionsOverride = {
+    config: {
+      ...markdownlintConfig,
+      "relative-links": projectRoot ? { root_path: projectRoot } : true
+    },
+    customRules,
+    noProgress: true,
+    noBanner: true,
+    ...ignoreGlobs.length > 0 ? { ignores: ignoreGlobs } : {}
+  };
+  await markdownlintMain({
+    directory,
+    argv,
+    optionsOverride,
+    noImport: true,
+    logMessage: () => {
+    },
+    logError: (message) => {
+      const parsed = parseErrorLine(message);
+      if (parsed) {
+        errors.push({
+          ...parsed,
+          file: join11(directory, parsed.file)
+        });
+      }
+    }
+  });
+  return errors;
+}
+function targetDirectory(target) {
+  return target.kind === MARKDOWN_VALIDATION_TARGET_KIND.FILE ? dirname3(target.path) : target.path;
+}
+function hasMarkdownExtension(path6) {
+  const lastDot = path6.lastIndexOf(".");
+  if (lastDot < 0) return false;
+  return MARKDOWN_FILE_EXTENSIONS.has(path6.slice(lastDot).toLowerCase());
+}
+function isExistingDirectory(path6, deps) {
+  try {
+    return deps.statSync(path6).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function isExistingFile(path6, deps) {
+  try {
+    return deps.statSync(path6).isFile();
+  } catch {
+    return false;
+  }
+}
+function markdownlintConfigDirectoryName(directory, projectRoot) {
+  if (projectRoot !== void 0) {
+    const [rootSegment] = pathRelative(projectRoot, directory).split(/[\\/]/);
+    if (MD024_DISABLED_DIRECTORIES.includes(rootSegment)) {
+      return rootSegment;
+    }
+  }
+  return basename(directory);
+}
+
+// src/commands/validation/messages.ts
+var VALIDATION_STAGE_DISPLAY_NAMES = {
+  CIRCULAR: "Circular dependencies",
+  KNIP: "Knip",
+  ESLINT: "ESLint",
+  TYPESCRIPT: "TypeScript",
+  MARKDOWN: "Markdown",
+  LITERAL: "Literal"
+};
+var VALIDATION_SKIP_LABELS = {
+  VERB: "Skipping",
+  LITERAL_REASON: "skip-literal",
+  TYPESCRIPT_ABSENT_REASON: "TypeScript not detected in project",
+  VALIDATION_PATHS_NO_TARGETS_REASON: "validation paths matched no files",
+  MARKDOWN_NO_SCOPE_REASON: "no markdown files in --files scope",
+  MARKDOWN_NO_DEFAULT_DIRECTORIES_REASON: "no spx/ or docs/ directories found"
+};
+var VALIDATION_COMMAND_OUTPUT = {
+  CIRCULAR_FOUND: `${VALIDATION_STAGE_DISPLAY_NAMES.CIRCULAR} found`,
+  CIRCULAR_NONE_FOUND: `${VALIDATION_STAGE_DISPLAY_NAMES.CIRCULAR}: \u2713 None found`,
+  KNIP_CONFIG_ERROR: `${VALIDATION_STAGE_DISPLAY_NAMES.KNIP}: \u2717 config error`,
+  KNIP_DISABLED: `${VALIDATION_STAGE_DISPLAY_NAMES.KNIP}: skipped (disabled by validation.knip.enabled)`,
+  KNIP_SUCCESS: `${VALIDATION_STAGE_DISPLAY_NAMES.KNIP}: \u2713 No unused code found`,
+  KNIP_FAILURE: "Unused code found",
+  ESLINT_SUCCESS: `${VALIDATION_STAGE_DISPLAY_NAMES.ESLINT}: \u2713 No errors found`,
+  ESLINT_FAILURE: `${VALIDATION_STAGE_DISPLAY_NAMES.ESLINT} validation failed`,
+  ESLINT_MISSING_CONFIG: "ESLint config not found: project has tsconfig.json but no eslint.config.{ts,js,mjs,cjs}",
+  TYPESCRIPT_SUCCESS: `${VALIDATION_STAGE_DISPLAY_NAMES.TYPESCRIPT}: \u2713 No type errors`,
+  TYPESCRIPT_FAILURE: `${VALIDATION_STAGE_DISPLAY_NAMES.TYPESCRIPT} validation failed`,
+  MARKDOWN_NO_ISSUES: `${VALIDATION_STAGE_DISPLAY_NAMES.MARKDOWN}: No issues found`,
+  MARKDOWN_ERROR_SUMMARY_SUFFIX: "error(s) found"
+};
+var LITERAL_SKIP_OUTPUT = `${VALIDATION_STAGE_DISPLAY_NAMES.LITERAL}: skipped (--${VALIDATION_SKIP_LABELS.LITERAL_REASON})`;
+var LITERAL_SKIP_JSON_OUTPUT = JSON.stringify({
+  skipped: true,
+  reason: VALIDATION_SKIP_LABELS.LITERAL_REASON
+});
+function formatTypeScriptAbsentSkipMessage(stageName) {
+  return `\u23ED ${VALIDATION_SKIP_LABELS.VERB} ${stageName} (${VALIDATION_SKIP_LABELS.TYPESCRIPT_ABSENT_REASON})`;
+}
+function formatValidationPathsNoTargetsSkipMessage(stageName) {
+  return `\u23ED ${VALIDATION_SKIP_LABELS.VERB} ${stageName} (${VALIDATION_SKIP_LABELS.VALIDATION_PATHS_NO_TARGETS_REASON})`;
+}
+
+// src/commands/validation/markdown.ts
+var MARKDOWN_COMMAND_OUTPUT = {
+  ERROR_SUMMARY_SUFFIX: VALIDATION_COMMAND_OUTPUT.MARKDOWN_ERROR_SUMMARY_SUFFIX,
+  NO_ISSUES: VALIDATION_COMMAND_OUTPUT.MARKDOWN_NO_ISSUES,
+  SKIPPED_FILE_SCOPE_PREFIX: "Markdown skipped file scope"
+};
+var MARKDOWN_CONFIG_ERROR_MESSAGE = `${VALIDATION_STAGE_DISPLAY_NAMES.MARKDOWN}: \u2717 config error`;
+async function markdownCommand(options) {
+  const { cwd, files, quiet } = options;
+  const startTime = Date.now();
+  const loaded = await resolveConfig(cwd, [validationConfigDescriptor]);
+  if (!loaded.ok) {
+    return {
+      exitCode: 1,
+      output: `${MARKDOWN_CONFIG_ERROR_MESSAGE} \u2014 ${loaded.error}`,
+      durationMs: Date.now() - startTime
+    };
+  }
+  const validationConfig = loaded.value[validationConfigDescriptor.section];
+  const pathFilter = validationPathFilterForTool(
+    validationConfig.paths,
+    VALIDATION_PATH_TOOL_SUBSECTIONS.MARKDOWN
+  );
+  const targetResolutions = files && files.length > 0 ? files.map((filePath) => resolveMarkdownValidationTarget(filePath)) : void 0;
+  const unfilteredTargets = targetResolutions !== void 0 ? targetResolutions.map((resolution) => resolution.target).filter((target) => target !== void 0) : getDefaultDirectories(cwd).map((path6) => ({
+    kind: MARKDOWN_VALIDATION_TARGET_KIND.DIRECTORY,
+    path: path6
+  }));
+  const targets = unfilteredTargets.filter(
+    (target) => pathPassesValidationFilter(relative4(cwd, target.path), pathFilter)
+  );
+  const skippedTargets = targetResolutions === void 0 ? [] : targetResolutions.map((resolution) => resolution.skipped).filter((skipped) => skipped !== void 0);
+  const skippedOutput = quiet ? [] : skippedTargets.map(formatSkippedFileScope);
+  if (targets.length === 0) {
+    const reason = files && files.length > 0 ? VALIDATION_SKIP_LABELS.MARKDOWN_NO_SCOPE_REASON : VALIDATION_SKIP_LABELS.MARKDOWN_NO_DEFAULT_DIRECTORIES_REASON;
+    const output = quiet ? "" : [
+      ...skippedOutput,
+      `${VALIDATION_STAGE_DISPLAY_NAMES.MARKDOWN}: skipped (${reason})`
+    ].join("\n");
+    return { exitCode: 0, output, durationMs: Date.now() - startTime };
+  }
+  const result = await validateMarkdown({
+    targets,
+    projectRoot: cwd
+  });
+  const durationMs = Date.now() - startTime;
+  if (result.success) {
+    const output = quiet ? "" : [...skippedOutput, MARKDOWN_COMMAND_OUTPUT.NO_ISSUES].join("\n");
+    return { exitCode: 0, output, durationMs };
+  } else {
+    const errorLines = result.errors.map(
+      (error) => `  ${error.file}:${error.line} ${error.detail}`
+    );
+    const output = [
+      ...skippedOutput,
+      `Markdown: ${result.errors.length} ${MARKDOWN_COMMAND_OUTPUT.ERROR_SUMMARY_SUFFIX}`,
+      ...errorLines
+    ].join("\n");
+    return { exitCode: 1, output, durationMs };
+  }
+}
+function formatSkippedFileScope(target) {
+  return `${MARKDOWN_COMMAND_OUTPUT.SKIPPED_FILE_SCOPE_PREFIX}: ${target.path} (${target.reason})`;
+}
+
+// src/validation/languages/markdown.ts
+var MARKDOWN_LANGUAGE_NAME = "markdown";
+var markdownValidationLanguage = {
+  name: MARKDOWN_LANGUAGE_NAME,
+  stages: [
+    {
+      name: VALIDATION_STAGE_DISPLAY_NAMES.MARKDOWN,
+      failsPipeline: true,
+      run: (context) => markdownCommand({ cwd: context.cwd, files: context.files, quiet: context.quiet })
+    }
+  ]
+};
+
+// node_modules/.pnpm/jsonc-parser@3.3.1/node_modules/jsonc-parser/lib/esm/impl/scanner.js
+function createScanner(text, ignoreTrivia = false) {
+  const len = text.length;
+  let pos = 0, value = "", tokenOffset = 0, token = 16, lineNumber = 0, lineStartOffset = 0, tokenLineStartOffset = 0, prevTokenLineStartOffset = 0, scanError = 0;
+  function scanHexDigits(count, exact) {
+    let digits = 0;
+    let value2 = 0;
+    while (digits < count || !exact) {
+      let ch = text.charCodeAt(pos);
+      if (ch >= 48 && ch <= 57) {
+        value2 = value2 * 16 + ch - 48;
+      } else if (ch >= 65 && ch <= 70) {
+        value2 = value2 * 16 + ch - 65 + 10;
+      } else if (ch >= 97 && ch <= 102) {
+        value2 = value2 * 16 + ch - 97 + 10;
+      } else {
+        break;
+      }
+      pos++;
+      digits++;
+    }
+    if (digits < count) {
       value2 = -1;
     }
     return value2;
@@ -5715,8 +6204,8 @@ var ParseErrorCode;
 })(ParseErrorCode || (ParseErrorCode = {}));
 
 // src/validation/config/scope.ts
-import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync2 } from "fs";
-import { isAbsolute as isAbsolute3, join as join11 } from "path";
+import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync2 } from "fs";
+import { isAbsolute as isAbsolute3, join as join12 } from "path";
 var TSCONFIG_FILES = {
   full: "tsconfig.json",
   production: "tsconfig.production.json"
@@ -5726,11 +6215,11 @@ var GLOB_MARKER = "*";
 var HIDDEN_PATH_PREFIX = ".";
 var defaultScopeDeps = {
   readFileSync: readFileSync2,
-  existsSync: existsSync2,
+  existsSync: existsSync3,
   readdirSync
 };
 function resolveProjectPath(projectRoot, path6) {
-  return isAbsolute3(path6) ? path6 : join11(projectRoot, path6);
+  return isAbsolute3(path6) ? path6 : join12(projectRoot, path6);
 }
 function parseTypeScriptConfig(configPath, deps = defaultScopeDeps) {
   try {
@@ -5774,7 +6263,7 @@ function hasTypeScriptFilesRecursive(dirPath, maxDepth = 2, deps = defaultScopeD
     if (hasDirectTsFiles) return true;
     const subdirs = items.filter((item) => item.isDirectory() && !item.name.startsWith("."));
     for (const subdir of subdirs.slice(0, 5)) {
-      if (hasTypeScriptFilesRecursive(join11(dirPath, subdir.name), maxDepth - 1, deps)) {
+      if (hasTypeScriptFilesRecursive(join12(dirPath, subdir.name), maxDepth - 1, deps)) {
         return true;
       }
     }
@@ -5797,7 +6286,7 @@ function getTopLevelDirectoriesWithTypeScript(config, projectRoot, deps = defaul
     });
     if (!isExcluded) {
       try {
-        const hasTypeScriptFiles = hasTypeScriptFilesRecursive(join11(projectRoot, dir), 2, deps);
+        const hasTypeScriptFiles = hasTypeScriptFilesRecursive(join12(projectRoot, dir), 2, deps);
         if (hasTypeScriptFiles) {
           directories.add(dir);
         }
@@ -5828,13 +6317,13 @@ function getLiteralTopLevelPatternDirectory(pattern) {
 function filterActiveIncludePatterns(patterns, excludePatterns, projectRoot, deps) {
   return patterns.filter((pattern) => {
     const topLevelDir = getLiteralTopLevelPatternDirectory(pattern);
-    return topLevelDir === null || deps.existsSync(join11(projectRoot, topLevelDir));
+    return topLevelDir === null || deps.existsSync(join12(projectRoot, topLevelDir));
   }).filter((pattern) => pathPassesValidationFilter(pattern, { exclude: excludePatterns }));
 }
 function getValidationDirectories(scope, projectRoot, deps = defaultScopeDeps) {
   const config = resolveTypeScriptConfig(scope, projectRoot, deps);
   const configDirectories = getTopLevelDirectoriesWithTypeScript(config, projectRoot, deps);
-  const existingDirectories = configDirectories.filter((dir) => deps.existsSync(join11(projectRoot, dir)));
+  const existingDirectories = configDirectories.filter((dir) => deps.existsSync(join12(projectRoot, dir)));
   return existingDirectories;
 }
 function getTypeScriptScope(scope, projectRoot, deps = defaultScopeDeps) {
@@ -5991,7 +6480,7 @@ function detectTypeScript(projectRoot, deps = defaultLanguageDetectionDeps) {
 
 // src/validation/steps/circular.ts
 import madge from "madge";
-import { join as join12 } from "path";
+import { join as join13 } from "path";
 var CIRCULAR_DEPS_KEYS = {
   MADGE: "madge"
 };
@@ -6000,87 +6489,36 @@ var defaultCircularDeps = {
 };
 async function validateCircularDependencies(scope, typescriptScope, projectRoot, deps = defaultCircularDeps) {
   try {
-    const analyzeDirectories = typescriptScope.directories.map((directory) => join12(projectRoot, directory));
-    if (analyzeDirectories.length === 0) {
-      return { success: true };
-    }
-    const tsConfigFile = join12(projectRoot, TSCONFIG_FILES[scope]);
-    const excludeRegExps = typescriptScope.excludePatterns.map((pattern) => {
-      const cleanPattern = pattern.replace(/\/\*\*?\/\*$/, "");
-      const escaped = cleanPattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-      return new RegExp(escaped);
-    });
-    const result = await deps.madge(analyzeDirectories, {
-      baseDir: projectRoot,
-      fileExtensions: ["ts", "tsx"],
-      tsConfig: tsConfigFile,
-      excludeRegExp: excludeRegExps
-    });
-    const circular = result.circular();
-    if (circular.length === 0) {
-      return { success: true };
-    } else {
-      return {
-        success: false,
-        error: `Found ${circular.length} circular dependency cycle(s)`,
-        circularDependencies: circular
-      };
-    }
-  } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    return { success: false, error: errorMessage };
-  }
-}
-
-// src/commands/validation/messages.ts
-var VALIDATION_PIPELINE = {
-  TOTAL_STEPS: 6
-};
-var VALIDATION_STAGE_DISPLAY_NAMES = {
-  CIRCULAR: "Circular dependencies",
-  KNIP: "Knip",
-  ESLINT: "ESLint",
-  TYPESCRIPT: "TypeScript",
-  MARKDOWN: "Markdown",
-  LITERAL: "Literal"
-};
-var VALIDATION_SKIP_LABELS = {
-  VERB: "Skipping",
-  LITERAL_REASON: "skip-literal",
-  TYPESCRIPT_ABSENT_REASON: "TypeScript not detected in project",
-  VALIDATION_PATHS_NO_TARGETS_REASON: "validation paths matched no files",
-  MARKDOWN_NO_SCOPE_REASON: "no markdown files in --files scope",
-  MARKDOWN_NO_DEFAULT_DIRECTORIES_REASON: "no spx/ or docs/ directories found"
-};
-var VALIDATION_COMMAND_OUTPUT = {
-  CIRCULAR_FOUND: `${VALIDATION_STAGE_DISPLAY_NAMES.CIRCULAR} found`,
-  CIRCULAR_NONE_FOUND: `${VALIDATION_STAGE_DISPLAY_NAMES.CIRCULAR}: \u2713 None found`,
-  KNIP_CONFIG_ERROR: `${VALIDATION_STAGE_DISPLAY_NAMES.KNIP}: \u2717 config error`,
-  KNIP_DISABLED: `${VALIDATION_STAGE_DISPLAY_NAMES.KNIP}: skipped (disabled by validation.knip.enabled)`,
-  KNIP_SUCCESS: `${VALIDATION_STAGE_DISPLAY_NAMES.KNIP}: \u2713 No unused code found`,
-  KNIP_FAILURE: "Unused code found",
-  ESLINT_SUCCESS: `${VALIDATION_STAGE_DISPLAY_NAMES.ESLINT}: \u2713 No errors found`,
-  ESLINT_FAILURE: `${VALIDATION_STAGE_DISPLAY_NAMES.ESLINT} validation failed`,
-  ESLINT_MISSING_CONFIG: "ESLint config not found: project has tsconfig.json but no eslint.config.{ts,js,mjs,cjs}",
-  TYPESCRIPT_SUCCESS: `${VALIDATION_STAGE_DISPLAY_NAMES.TYPESCRIPT}: \u2713 No type errors`,
-  TYPESCRIPT_FAILURE: `${VALIDATION_STAGE_DISPLAY_NAMES.TYPESCRIPT} validation failed`,
-  MARKDOWN_NO_ISSUES: `${VALIDATION_STAGE_DISPLAY_NAMES.MARKDOWN}: No issues found`,
-  MARKDOWN_ERROR_SUMMARY_SUFFIX: "error(s) found"
-};
-var LITERAL_SKIP_OUTPUT = `${VALIDATION_STAGE_DISPLAY_NAMES.LITERAL}: skipped (--${VALIDATION_SKIP_LABELS.LITERAL_REASON})`;
-var LITERAL_SKIP_JSON_OUTPUT = JSON.stringify({
-  skipped: true,
-  reason: VALIDATION_SKIP_LABELS.LITERAL_REASON
-});
-var VALIDATION_STEP_LINE_PATTERN = new RegExp(
-  String.raw`^\[(\d+)\/${VALIDATION_PIPELINE.TOTAL_STEPS}\]`,
-  "gm"
-);
-function formatTypeScriptAbsentSkipMessage(stageName) {
-  return `\u23ED ${VALIDATION_SKIP_LABELS.VERB} ${stageName} (${VALIDATION_SKIP_LABELS.TYPESCRIPT_ABSENT_REASON})`;
-}
-function formatValidationPathsNoTargetsSkipMessage(stageName) {
-  return `\u23ED ${VALIDATION_SKIP_LABELS.VERB} ${stageName} (${VALIDATION_SKIP_LABELS.VALIDATION_PATHS_NO_TARGETS_REASON})`;
+    const analyzeDirectories = typescriptScope.directories.map((directory) => join13(projectRoot, directory));
+    if (analyzeDirectories.length === 0) {
+      return { success: true };
+    }
+    const tsConfigFile = join13(projectRoot, TSCONFIG_FILES[scope]);
+    const excludeRegExps = typescriptScope.excludePatterns.map((pattern) => {
+      const cleanPattern = pattern.replace(/\/\*\*?\/\*$/, "");
+      const escaped = cleanPattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      return new RegExp(escaped);
+    });
+    const result = await deps.madge(analyzeDirectories, {
+      baseDir: projectRoot,
+      fileExtensions: ["ts", "tsx"],
+      tsConfig: tsConfigFile,
+      excludeRegExp: excludeRegExps
+    });
+    const circular = result.circular();
+    if (circular.length === 0) {
+      return { success: true };
+    } else {
+      return {
+        success: false,
+        error: `Found ${circular.length} circular dependency cycle(s)`,
+        circularDependencies: circular
+      };
+    }
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return { success: false, error: errorMessage };
+  }
 }
 
 // src/commands/validation/circular.ts
@@ -6134,36 +6572,11 @@ ${cycles}`;
   }
 }
 
-// src/commands/validation/format.ts
-var DURATION_THRESHOLD_MS = 1e3;
-var VALIDATION_SYMBOLS = {
-  SUCCESS: "\u2713",
-  FAILURE: "\u2717"
-};
-var VALIDATION_SUMMARY_STATUS = {
-  PASSED: "passed",
-  FAILED: "failed"
-};
-function formatDuration(ms) {
-  if (ms < DURATION_THRESHOLD_MS) {
-    return `${ms}ms`;
-  }
-  const seconds = ms / 1e3;
-  return `${seconds.toFixed(1)}s`;
-}
-function formatSummary(options) {
-  const { success, totalDurationMs } = options;
-  const symbol = success ? VALIDATION_SYMBOLS.SUCCESS : VALIDATION_SYMBOLS.FAILURE;
-  const status = success ? VALIDATION_SUMMARY_STATUS.PASSED : VALIDATION_SUMMARY_STATUS.FAILED;
-  const duration = formatDuration(totalDurationMs);
-  return `${symbol} Validation ${status} (${duration} total)`;
-}
-
 // src/validation/steps/knip.ts
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync4 } from "fs";
 import { mkdtemp, rm, writeFile as writeFile2 } from "fs/promises";
 import { tmpdir } from "os";
-import { isAbsolute as isAbsolute4, join as join13 } from "path";
+import { isAbsolute as isAbsolute4, join as join14 } from "path";
 
 // src/lib/process-lifecycle/exit-codes.ts
 var SIGINT_EXIT_CODE = 130;
@@ -6317,7 +6730,7 @@ var KNIP_COMMAND_TOKENS = {
   USE_TSCONFIG_FILES_FLAG: "--use-tsconfig-files"
 };
 var defaultKnipDeps = {
-  existsSync: existsSync3,
+  existsSync: existsSync4,
   mkdtemp,
   rm,
   writeFile: writeFile2
@@ -6337,7 +6750,7 @@ async function validateKnip2(context, runner = defaultKnipProcessRunner, deps =
 }
 async function runKnipSubprocess(projectRoot, typescriptScope, runner, deps) {
   const scopedTsconfig = typescriptScope.filteredByValidationPaths ? await createScopedKnipTsconfig(projectRoot, typescriptScope, deps) : void 0;
-  const localBin = join13(projectRoot, "node_modules", ".bin", "knip");
+  const localBin = join14(projectRoot, "node_modules", ".bin", "knip");
   const binary = deps.existsSync(localBin) ? localBin : "npx";
   const baseArgs = scopedTsconfig === void 0 ? [] : [
     KNIP_COMMAND_TOKENS.USE_TSCONFIG_FILES_FLAG,
@@ -6392,12 +6805,12 @@ async function runKnipSubprocess(projectRoot, typescriptScope, runner, deps) {
   });
 }
 async function createScopedKnipTsconfig(projectRoot, typescriptScope, deps) {
-  const tempDir = await deps.mkdtemp(join13(tmpdir(), "validate-knip-"));
-  const configPath = join13(tempDir, TSCONFIG_FILES.full);
-  const toProjectPathPattern = (pattern) => isAbsolute4(pattern) ? pattern : join13(projectRoot, pattern);
+  const tempDir = await deps.mkdtemp(join14(tmpdir(), "validate-knip-"));
+  const configPath = join14(tempDir, TSCONFIG_FILES.full);
+  const toProjectPathPattern = (pattern) => isAbsolute4(pattern) ? pattern : join14(projectRoot, pattern);
   const project = typescriptScope.filePatterns.length > 0 ? typescriptScope.filePatterns : typescriptScope.directories.map((directory) => `${directory}/**/*.{js,ts,tsx}`);
   const config = {
-    extends: join13(projectRoot, TSCONFIG_FILES.full),
+    extends: join14(projectRoot, TSCONFIG_FILES.full),
     include: project.map(toProjectPathPattern),
     exclude: typescriptScope.excludePatterns.map(toProjectPathPattern)
   };
@@ -6446,13 +6859,13 @@ async function knipCommand(options) {
 }
 
 // src/validation/steps/eslint.ts
-import { existsSync as existsSync5 } from "fs";
-import { join as join15 } from "path";
+import { existsSync as existsSync6 } from "fs";
+import { join as join16 } from "path";
 
 // src/validation/lint-policy.ts
 import { execFileSync } from "child_process";
-import { existsSync as existsSync4, readdirSync as readdirSync2, readFileSync as readFileSync3, statSync } from "fs";
-import { join as join14 } from "path";
+import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync3, statSync as statSync2 } from "fs";
+import { join as join15 } from "path";
 
 // src/validation/lint-policy-constants.ts
 var LINT_POLICY_MANIFESTS = {
@@ -6499,17 +6912,17 @@ var DEPRECATED_SPEC_NODE_SUFFIX_PATTERN = /\.(capability|feature|story)$/;
 var BASE_BRANCH_REFS = [LINT_POLICY_BASE_REFS.REMOTE_MAIN, LINT_POLICY_BASE_REFS.LOCAL_MAIN];
 function readManifest(productDir, file, key) {
   return parseLintPolicyManifest(
-    readFileSync3(join14(productDir, file), "utf-8"),
+    readFileSync3(join15(productDir, file), "utf-8"),
     file,
     key
   );
 }
 function manifestExists(productDir, file) {
-  return existsSync4(join14(productDir, file));
+  return existsSync5(join15(productDir, file));
 }
 function findDeprecatedSpecNodePath(productDir) {
   function visit2(relativeDirectory) {
-    const absoluteDirectory = join14(productDir, relativeDirectory);
+    const absoluteDirectory = join15(productDir, relativeDirectory);
     for (const entry of readdirSync2(absoluteDirectory, { withFileTypes: true })) {
       if (!entry.isDirectory()) {
         continue;
@@ -6525,8 +6938,8 @@ function findDeprecatedSpecNodePath(productDir) {
     }
     return void 0;
   }
-  const specTreeRootPath = join14(productDir, SPEC_TREE_ROOT);
-  if (!existsSync4(specTreeRootPath)) {
+  const specTreeRootPath = join15(productDir, SPEC_TREE_ROOT);
+  if (!existsSync5(specTreeRootPath)) {
     return void 0;
   }
   return visit2(SPEC_TREE_ROOT);
@@ -6551,8 +6964,8 @@ function assertManifestEntries(productDir, file, entries, suffixPattern, suffixD
     if (!suffixPattern.test(entry)) {
       throw new Error(`${file} entry must ${suffixDescription}: ${entry}`);
     }
-    const absoluteEntry = join14(productDir, entry);
-    if (!existsSync4(absoluteEntry) || !statSync(absoluteEntry).isDirectory()) {
+    const absoluteEntry = join15(productDir, entry);
+    if (!existsSync5(absoluteEntry) || !statSync2(absoluteEntry).isDirectory()) {
       throw new Error(`${file} entry does not exist as a directory: ${entry}`);
     }
   }
@@ -6811,8 +7224,8 @@ async function validateESLint(context, runner = defaultEslintProcessRunner, outp
     scopeConfig: context.scopeConfig
   });
   return new Promise((resolve6) => {
-    const localBin = join15(projectRoot, ...ESLINT_LOCAL_BIN_SEGMENTS);
-    const binary = existsSync5(localBin) ? localBin : "npx";
+    const localBin = join16(projectRoot, ...ESLINT_LOCAL_BIN_SEGMENTS);
+    const binary = existsSync6(localBin) ? localBin : "npx";
     const spawnArgs = binary === "npx" ? eslintArgs : eslintArgs.slice(1);
     const eslintProcess = spawnManagedSubprocess(runner, binary, spawnArgs, {
       cwd: projectRoot
@@ -6912,8 +7325,8 @@ async function lintCommand(options) {
 }
 
 // src/validation/literal/index.ts
-import { readFile as readFile9 } from "fs/promises";
-import { isAbsolute as isAbsolute5, relative as relative5, resolve as resolve5 } from "path";
+import { readFile as readFile8 } from "fs/promises";
+import { isAbsolute as isAbsolute5, relative as relative6, resolve as resolve5 } from "path";
 
 // src/lib/file-inclusion/predicates/ignore-source.ts
 var IGNORE_SOURCE_LAYER = "ignore-source";
@@ -6948,7 +7361,7 @@ var ignoreSourceLayer = makeLayer(
 
 // src/lib/file-inclusion/pipeline.ts
 import { readdir as readdir6 } from "fs/promises";
-import { join as join16, relative as relative4, sep } from "path";
+import { join as join17, relative as relative5, sep } from "path";
 var EXPLICIT_OVERRIDE_LAYER = "explicit-override";
 function isNodeError2(err) {
   return err instanceof Error && "code" in err;
@@ -6966,11 +7379,11 @@ async function collectPaths(absoluteDir, projectRoot, result, artifactDirs) {
   for (const entry of dirEntries) {
     if (entry.isDirectory()) {
       if (artifactDirs.has(entry.name)) continue;
-      const absolutePath = join16(absoluteDir, entry.name);
+      const absolutePath = join17(absoluteDir, entry.name);
       await collectPaths(absolutePath, projectRoot, result, artifactDirs);
     } else if (entry.isFile()) {
-      const absolutePath = join16(absoluteDir, entry.name);
-      const rel = relative4(projectRoot, absolutePath);
+      const absolutePath = join17(absoluteDir, entry.name);
+      const rel = relative5(projectRoot, absolutePath);
       result.push(sep === "/" ? rel : rel.split(sep).join("/"));
     }
   }
@@ -7079,782 +7492,551 @@ function collectLiterals(source, filename, options) {
     loc: true,
     range: true,
     comment: false,
-    jsx: true,
-    ecmaVersion: "latest",
-    sourceType: "module"
-  });
-  const out = [];
-  const ancestors = [];
-  walk(ast, { filename, isTestFixtureFile: isTestLikeFile(filename) }, ancestors, options, out);
-  return out;
-}
-function walk(node, context, ancestors, options, out) {
-  emitLiteral(node, context, ancestors, options, out);
-  const keys = options.visitorKeys[node.type];
-  if (!keys) {
-    return;
-  }
-  const skip = MODULE_NAMING_SKIP[node.type] ?? EMPTY_SKIP;
-  for (const key of keys) {
-    if (skip.has(key)) continue;
-    const child = node[key];
-    if (Array.isArray(child)) {
-      for (const item of child) {
-        if (isNode(item)) walkChild(item, node, context, ancestors, options, out);
-      }
-    } else if (isNode(child)) {
-      walkChild(child, node, context, ancestors, options, out);
-    }
-  }
-}
-function walkChild(node, parent, context, ancestors, options, out) {
-  ancestors.push({ node: parent });
-  try {
-    walk(node, context, ancestors, options, out);
-  } finally {
-    ancestors.pop();
-  }
-}
-function isNode(value) {
-  return typeof value === "object" && value !== null && typeof value.type === "string";
-}
-function emitLiteral(node, context, ancestors, options, out) {
-  if (node.type !== LITERAL_TYPE && node.type !== TEMPLATE_ELEMENT_TYPE) {
-    return;
-  }
-  if (isFixtureDataLiteral(context, ancestors)) {
-    return;
-  }
-  const line = node.loc?.start?.line ?? 0;
-  if (node.type === LITERAL_TYPE) {
-    if (typeof node.value === "string") {
-      if (node.value.length >= options.minStringLength) {
-        out.push({ kind: "string", value: node.value, loc: { file: context.filename, line } });
-      }
-    } else if (typeof node.value === "number") {
-      const raw = typeof node.raw === "string" ? node.raw : String(node.value);
-      if (isMeaningfulNumber(raw, options.minNumberDigits)) {
-        out.push({ kind: "number", value: String(node.value), loc: { file: context.filename, line } });
-      }
-    }
-    return;
-  }
-  if (node.type === TEMPLATE_ELEMENT_TYPE) {
-    const value = node.value;
-    const cooked = value?.cooked ?? "";
-    if (cooked.length >= options.minStringLength) {
-      out.push({ kind: "string", value: cooked, loc: { file: context.filename, line } });
-    }
-  }
-}
-function isTestLikeFile(filename) {
-  return filename.includes(TEST_PATH_SEGMENT) || filename.includes(WINDOWS_TEST_PATH_SEGMENT) || filename.includes(TEST_FILE_MARKER);
-}
-function isFixtureDataLiteral(context, ancestors) {
-  if (!context.isTestFixtureFile) {
-    return false;
-  }
-  return isInsideFixtureWriterArgument(ancestors) || isInsideFixtureDataVariable(ancestors);
-}
-function isInsideFixtureWriterArgument(ancestors) {
-  for (let index = ancestors.length - 1; index >= 0; index -= 1) {
-    const ancestor = ancestors[index];
-    if (ancestor.node.type !== CALL_EXPRESSION_TYPE) {
-      continue;
-    }
-    const callName = getCallName(ancestor.node);
-    if (callName === void 0 || !isFixtureWriterCall(callName)) {
-      continue;
-    }
-    if (hasNestedFunctionBetween(ancestors, index)) {
-      continue;
-    }
-    return true;
-  }
-  return false;
-}
-function isFixtureWriterCall(callName) {
-  return FIXTURE_WRITER_CALLS.has(callName);
-}
-function isInsideFixtureDataVariable(ancestors) {
-  for (let index = ancestors.length - 1; index >= 0; index -= 1) {
-    const ancestor = ancestors[index];
-    if (ancestor.node.type !== VARIABLE_DECLARATOR_TYPE) {
-      continue;
-    }
-    if (hasNestedFunctionBetween(ancestors, index)) {
-      continue;
-    }
-    const variableName = getFixtureDataDeclaratorName(ancestor.node);
-    if (variableName !== void 0 && isFixtureDataVariableName(variableName)) {
-      return true;
-    }
-  }
-  return false;
-}
-function hasNestedFunctionBetween(ancestors, ancestorIndex) {
-  for (let index = ancestorIndex + 1; index < ancestors.length; index += 1) {
-    if (FUNCTION_NODE_TYPES.has(ancestors[index].node.type)) {
-      return true;
-    }
-  }
-  return false;
-}
-function getFixtureDataDeclaratorName(node) {
-  const bindingName = getIdentifierName(node.id);
-  if (bindingName !== void 0) {
-    return bindingName;
-  }
-  return getIdentifierName(node.init);
-}
-function isFixtureDataVariableName(variableName) {
-  const segments = splitIdentifierName(variableName);
-  if (segments.length === 0) {
-    return false;
-  }
-  if (segments.some((segment) => FIXTURE_DATA_DIRECT_SEGMENTS.has(segment))) {
-    return true;
-  }
-  if (!segments.some((segment) => FIXTURE_DATA_ROLE_SEGMENTS.has(segment))) {
-    return false;
-  }
-  if (segments.every((segment) => FIXTURE_DATA_ROLE_SEGMENTS.has(segment))) {
-    return true;
-  }
-  const finalSegment = segments[segments.length - 1];
-  return finalSegment !== void 0 && FIXTURE_DATA_CONTEXT_SEGMENTS.has(finalSegment);
-}
-function splitIdentifierName(variableName) {
-  return variableName.split("_").flatMap((part) => part.match(IDENTIFIER_SEGMENT_PATTERN) ?? []).map((segment) => segment.toLowerCase());
-}
-function getCallName(node) {
-  const callee = node.callee;
-  if (!isNode(callee)) {
-    return void 0;
-  }
-  if (callee.type === IDENTIFIER_TYPE) {
-    return getIdentifierName(callee);
-  }
-  if (callee.type !== MEMBER_EXPRESSION_TYPE) {
-    return void 0;
-  }
-  const property = callee.property;
-  if (isNode(property)) {
-    return property.type === IDENTIFIER_TYPE ? getIdentifierName(property) : getLiteralString(property);
-  }
-  return void 0;
-}
-function getIdentifierName(value) {
-  if (!isNode(value) || value.type !== IDENTIFIER_TYPE) {
-    return void 0;
-  }
-  return typeof value.name === "string" ? value.name : void 0;
-}
-function getLiteralString(value) {
-  if (!isNode(value) || value.type !== LITERAL_TYPE) {
-    return void 0;
-  }
-  return typeof value.value === "string" ? value.value : void 0;
-}
-function isMeaningfulNumber(raw, minDigits) {
-  const digits = raw.replace(/[^0-9]/g, "");
-  return digits.length >= minDigits;
-}
-function buildIndex(occurrences) {
-  const map = /* @__PURE__ */ new Map();
-  for (const occ of occurrences) {
-    const key = makeKey(occ.kind, occ.value);
-    const existing = map.get(key);
-    if (existing) {
-      existing.push(occ.loc);
-    } else {
-      map.set(key, [occ.loc]);
-    }
-  }
-  return map;
-}
-function makeKey(kind, value) {
-  return `${kind}\0${value}`;
-}
-function splitKey(key) {
-  const idx = key.indexOf("\0");
-  return { kind: key.slice(0, idx), value: key.slice(idx + 1) };
+    jsx: true,
+    ecmaVersion: "latest",
+    sourceType: "module"
+  });
+  const out = [];
+  const ancestors = [];
+  walk(ast, { filename, isTestFixtureFile: isTestLikeFile(filename) }, ancestors, options, out);
+  return out;
 }
-function detectReuse(input) {
-  const srcReuse = [];
-  const testDupe = [];
-  const testIndex = /* @__PURE__ */ new Map();
-  for (const [file, occurrences] of input.testOccurrencesByFile) {
-    for (const occ of occurrences) {
-      if (input.allowlist.has(occ.value)) continue;
-      const key = makeKey(occ.kind, occ.value);
-      let byFile = testIndex.get(key);
-      if (!byFile) {
-        byFile = /* @__PURE__ */ new Map();
-        testIndex.set(key, byFile);
-      }
-      const locsInFile = byFile.get(file);
-      if (locsInFile) locsInFile.push(occ.loc);
-      else byFile.set(file, [occ.loc]);
-    }
+function walk(node, context, ancestors, options, out) {
+  emitLiteral(node, context, ancestors, options, out);
+  const keys = options.visitorKeys[node.type];
+  if (!keys) {
+    return;
   }
-  for (const [key, byFile] of testIndex) {
-    const { kind, value } = splitKey(key);
-    const srcLocs = input.srcIndex.get(key);
-    const allTestLocs = [];
-    for (const locs of byFile.values()) allTestLocs.push(...locs);
-    if (srcLocs && srcLocs.length > 0) {
-      for (const testLoc of allTestLocs) {
-        srcReuse.push({
-          test: testLoc,
-          kind,
-          value,
-          src: srcLocs,
-          remediation: REMEDIATION.IMPORT_FROM_SOURCE
-        });
-      }
-    } else if (byFile.size >= 2) {
-      for (let i = 0; i < allTestLocs.length; i += 1) {
-        const otherTests = [...allTestLocs.slice(0, i), ...allTestLocs.slice(i + 1)];
-        testDupe.push({
-          test: allTestLocs[i],
-          kind,
-          value,
-          otherTests,
-          remediation: REMEDIATION.REFACTOR_TO_SOURCE_OR_GENERATOR
-        });
+  const skip = MODULE_NAMING_SKIP[node.type] ?? EMPTY_SKIP;
+  for (const key of keys) {
+    if (skip.has(key)) continue;
+    const child = node[key];
+    if (Array.isArray(child)) {
+      for (const item of child) {
+        if (isNode(item)) walkChild(item, node, context, ancestors, options, out);
       }
+    } else if (isNode(child)) {
+      walkChild(child, node, context, ancestors, options, out);
     }
   }
-  return { srcReuse, testDupe };
-}
-
-// src/validation/literal/walker.ts
-var TYPESCRIPT_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".tsx"]);
-var DECLARATION_SUFFIX = ".d.ts";
-function isTypescriptSource(path6) {
-  if (path6.endsWith(DECLARATION_SUFFIX)) return false;
-  const ext = extensionOf(path6);
-  return TYPESCRIPT_EXTENSIONS.has(ext);
-}
-function extensionOf(name) {
-  const idx = name.lastIndexOf(".");
-  return idx === -1 ? "" : name.slice(idx);
 }
-function isTestFile(relPath) {
-  return /\.test\.tsx?$/.test(relPath);
+function walkChild(node, parent, context, ancestors, options, out) {
+  ancestors.push({ node: parent });
+  try {
+    walk(node, context, ancestors, options, out);
+  } finally {
+    ancestors.pop();
+  }
 }
-
-// src/validation/literal/index.ts
-var PATH_PREFIX_SEPARATOR2 = "/";
-var DEFAULT_LITERAL_COLLECT_OPTIONS = {
-  visitorKeys: defaultVisitorKeys,
-  minStringLength: literalConfigDescriptor.defaults.minStringLength,
-  minNumberDigits: literalConfigDescriptor.defaults.minNumberDigits
-};
-function normalizePathPrefix2(prefix) {
-  const posix = prefix.split(/[\\/]/g).join(PATH_PREFIX_SEPARATOR2);
-  return posix.endsWith(PATH_PREFIX_SEPARATOR2) ? posix : `${posix}${PATH_PREFIX_SEPARATOR2}`;
+function isNode(value) {
+  return typeof value === "object" && value !== null && typeof value.type === "string";
 }
-function applyPathFilter(entries, pathConfig) {
-  if (pathConfig === void 0) {
-    return entries;
+function emitLiteral(node, context, ancestors, options, out) {
+  if (node.type !== LITERAL_TYPE && node.type !== TEMPLATE_ELEMENT_TYPE) {
+    return;
   }
-  const includePrefixes = (pathConfig.include ?? []).map(normalizePathPrefix2);
-  const excludePrefixes = (pathConfig.exclude ?? []).map(normalizePathPrefix2);
-  return entries.filter((entry) => {
-    if (includePrefixes.length > 0 && !includePrefixes.some((p) => entry.path.startsWith(p))) {
-      return false;
-    }
-    if (excludePrefixes.some((p) => entry.path.startsWith(p))) {
-      return false;
-    }
-    return true;
-  });
-}
-async function validateLiteralReuse(input) {
-  const config = input.config ?? literalConfigDescriptor.defaults;
-  const request = input.files ? {
-    explicit: input.files.map((f) => {
-      const abs = isAbsolute5(f) ? f : resolve5(input.productDir, f);
-      return relative5(input.productDir, abs).split(/[\\/]/g).join("/");
-    })
-  } : { walkRoot: input.productDir };
-  const scope = await runPipeline(
-    [artifactDirectoryLayer, hiddenPrefixLayer],
-    input.productDir,
-    request,
-    DEFAULT_SCOPE_CONFIG,
-    EMPTY_IGNORE_READER
-  );
-  const filtered = applyPathFilter(scope.included, input.pathConfig);
-  const candidateFiles = filtered.filter((entry) => isTypescriptSource(entry.path)).map((entry) => resolve5(input.productDir, entry.path));
-  const collectOptions = {
-    visitorKeys: defaultVisitorKeys,
-    minStringLength: config.minStringLength,
-    minNumberDigits: config.minNumberDigits
-  };
-  const srcOccurrences = [];
-  const testOccurrencesByFile = /* @__PURE__ */ new Map();
-  const indexedOccurrencesByFile = /* @__PURE__ */ new Map();
-  for (const abs of candidateFiles) {
-    const rel = relative5(input.productDir, abs).split(/[\\/]/g).join("/");
-    const content = await readSafe(abs);
-    if (content === null) continue;
-    const occurrences = collectLiterals(content, rel, collectOptions);
-    indexedOccurrencesByFile.set(rel, occurrences);
-    if (isTestFile(rel)) {
-      testOccurrencesByFile.set(rel, occurrences);
-    } else {
-      srcOccurrences.push(...occurrences);
+  if (isFixtureDataLiteral(context, ancestors)) {
+    return;
+  }
+  const line = node.loc?.start?.line ?? 0;
+  if (node.type === LITERAL_TYPE) {
+    if (typeof node.value === "string") {
+      if (node.value.length >= options.minStringLength) {
+        out.push({ kind: "string", value: node.value, loc: { file: context.filename, line } });
+      }
+    } else if (typeof node.value === "number") {
+      const raw = typeof node.raw === "string" ? node.raw : String(node.value);
+      if (isMeaningfulNumber(raw, options.minNumberDigits)) {
+        out.push({ kind: "number", value: String(node.value), loc: { file: context.filename, line } });
+      }
     }
+    return;
   }
-  const srcIndex = buildIndex(srcOccurrences);
-  const findings = detectReuse({
-    srcIndex,
-    testOccurrencesByFile,
-    allowlist: resolveAllowlist(config)
-  });
-  return { findings, indexedOccurrencesByFile };
-}
-async function readSafe(path6) {
-  try {
-    return await readFile9(path6, "utf8");
-  } catch (err) {
-    if (typeof err === "object" && err !== null && "code" in err) {
-      const code = err.code;
-      if (code === "ENOENT" || code === "EISDIR") return null;
+  if (node.type === TEMPLATE_ELEMENT_TYPE) {
+    const value = node.value;
+    const cooked = value?.cooked ?? "";
+    if (cooked.length >= options.minStringLength) {
+      out.push({ kind: "string", value: cooked, loc: { file: context.filename, line } });
     }
-    throw err;
   }
 }
-
-// src/commands/validation/literal.ts
-var LITERAL_PROBLEM_KIND = {
-  REUSE: "reuse",
-  DUPE: "dupe"
-};
-var OUTPUT_MODE_NAME = {
-  TEXT: "text",
-  VERBOSE: "verbose",
-  FILES_WITH_PROBLEMS: "filesWithProblems",
-  LITERALS: "literals",
-  JSON: "json"
-};
-var OUTPUT_MODE_NAMES = Object.values(OUTPUT_MODE_NAME);
-var LITERAL_EXIT_CODES = {
-  OK: 0,
-  FINDINGS: 1,
-  CONFIG_ERROR: 2
-};
-var TYPESCRIPT_ABSENT_MESSAGE3 = "\u23ED Skipping Literal (TypeScript not detected in project)";
-var LITERAL_DISABLED_MESSAGE = "\u23ED Skipping Literal (disabled by validation.literal.enabled)";
-var NO_PROBLEMS_MESSAGE = "Literal: \u2713 No problems";
-function formatNoProblemsOfKind(kind) {
-  return `Literal: No problems of type ${kind}`;
+function isTestLikeFile(filename) {
+  return filename.includes(TEST_PATH_SEGMENT) || filename.includes(WINDOWS_TEST_PATH_SEGMENT) || filename.includes(TEST_FILE_MARKER);
 }
-async function literalCommand(options) {
-  const start = Date.now();
-  const tsDetection = detectTypeScript(options.cwd);
-  if (!tsDetection.present) {
-    return {
-      exitCode: LITERAL_EXIT_CODES.OK,
-      output: options.quiet ? "" : TYPESCRIPT_ABSENT_MESSAGE3,
-      durationMs: Date.now() - start
-    };
-  }
-  let resolvedEnabled;
-  let resolvedLiteralConfig;
-  let resolvedPathConfig;
-  if (options.config !== void 0) {
-    resolvedEnabled = options.enabled ?? validationConfigDescriptor.defaults.literal.enabled;
-    resolvedLiteralConfig = options.config;
-    resolvedPathConfig = options.pathConfig ?? validationConfigDescriptor.defaults.paths;
-  } else {
-    const loaded = await resolveConfig(options.cwd, [validationConfigDescriptor]);
-    if (!loaded.ok) {
-      return {
-        exitCode: LITERAL_EXIT_CODES.CONFIG_ERROR,
-        output: `Literal: \u2717 config error \u2014 ${loaded.error}`,
-        durationMs: Date.now() - start
-      };
-    }
-    const validationConfig = loaded.value[validationConfigDescriptor.section];
-    resolvedEnabled = validationConfig.literal.enabled;
-    resolvedLiteralConfig = validationConfig.literal.values;
-    resolvedPathConfig = validationPathFilterForTool(
-      validationConfig.paths,
-      VALIDATION_PATH_TOOL_SUBSECTIONS.LITERAL
-    );
+function isFixtureDataLiteral(context, ancestors) {
+  if (!context.isTestFixtureFile) {
+    return false;
   }
-  if (!resolvedEnabled) {
-    return {
-      exitCode: LITERAL_EXIT_CODES.OK,
-      output: options.quiet ? "" : LITERAL_DISABLED_MESSAGE,
-      durationMs: Date.now() - start
-    };
+  return isInsideFixtureWriterArgument(ancestors) || isInsideFixtureDataVariable(ancestors);
+}
+function isInsideFixtureWriterArgument(ancestors) {
+  for (let index = ancestors.length - 1; index >= 0; index -= 1) {
+    const ancestor = ancestors[index];
+    if (ancestor.node.type !== CALL_EXPRESSION_TYPE) {
+      continue;
+    }
+    const callName = getCallName(ancestor.node);
+    if (callName === void 0 || !isFixtureWriterCall(callName)) {
+      continue;
+    }
+    if (hasNestedFunctionBetween(ancestors, index)) {
+      continue;
+    }
+    return true;
   }
-  const result = await validateLiteralReuse({
-    productDir: options.cwd,
-    files: options.files,
-    config: resolvedLiteralConfig,
-    pathConfig: resolvedPathConfig
-  });
-  const filteredFindings = filterLiteralFindings(result.findings, options.kind);
-  const totalProblems = countLiteralProblems(filteredFindings);
-  const exitCode = totalProblems === 0 ? LITERAL_EXIT_CODES.OK : LITERAL_EXIT_CODES.FINDINGS;
-  const output = options.json ? JSON.stringify(filteredFindings) : options.quiet ? "" : formatLiteralCommandOutput(filteredFindings, options);
-  return { exitCode, output, durationMs: Date.now() - start };
+  return false;
 }
-function filterLiteralFindings(findings, kind) {
-  return {
-    srcReuse: kind === LITERAL_PROBLEM_KIND.DUPE ? [] : sortReuseFindings(findings.srcReuse),
-    testDupe: kind === LITERAL_PROBLEM_KIND.REUSE ? [] : sortDupeFindings(findings.testDupe)
-  };
+function isFixtureWriterCall(callName) {
+  return FIXTURE_WRITER_CALLS.has(callName);
 }
-function countLiteralProblems(findings) {
-  return findings.srcReuse.length + findings.testDupe.length;
+function isInsideFixtureDataVariable(ancestors) {
+  for (let index = ancestors.length - 1; index >= 0; index -= 1) {
+    const ancestor = ancestors[index];
+    if (ancestor.node.type !== VARIABLE_DECLARATOR_TYPE) {
+      continue;
+    }
+    if (hasNestedFunctionBetween(ancestors, index)) {
+      continue;
+    }
+    const variableName = getFixtureDataDeclaratorName(ancestor.node);
+    if (variableName !== void 0 && isFixtureDataVariableName(variableName)) {
+      return true;
+    }
+  }
+  return false;
 }
-function formatDefaultLiteralProblems(findings) {
-  return toLiteralProblems(findings).map(
-    (problem) => `[${problem.problemKind}] ${formatLiteralValue(problem.literalKind, problem.value)} ${formatLoc(problem.test)}`
-  ).join("\n");
+function hasNestedFunctionBetween(ancestors, ancestorIndex) {
+  for (let index = ancestorIndex + 1; index < ancestors.length; index += 1) {
+    if (FUNCTION_NODE_TYPES.has(ancestors[index].node.type)) {
+      return true;
+    }
+  }
+  return false;
 }
-function formatVerboseLiteralProblems(findings) {
-  const lines = [
-    `Literal: ${countLiteralProblems(findings)} problems (reuse: ${findings.srcReuse.length}, dupe: ${findings.testDupe.length})`
-  ];
-  appendVerboseSection(
-    lines,
-    "REUSE",
-    findings.srcReuse.map((finding) => ({
-      problemKind: LITERAL_PROBLEM_KIND.REUSE,
-      literalKind: finding.kind,
-      value: finding.value,
-      test: finding.test,
-      related: finding.src
-    }))
-  );
-  appendVerboseSection(
-    lines,
-    "DUPE",
-    findings.testDupe.map((finding) => ({
-      problemKind: LITERAL_PROBLEM_KIND.DUPE,
-      literalKind: finding.kind,
-      value: finding.value,
-      test: finding.test,
-      related: finding.otherTests
-    }))
-  );
-  return lines.join("\n");
+function getFixtureDataDeclaratorName(node) {
+  const bindingName = getIdentifierName(node.id);
+  if (bindingName !== void 0) {
+    return bindingName;
+  }
+  return getIdentifierName(node.init);
 }
-function formatFilesWithProblems(findings) {
-  return [...new Set(toLiteralProblems(findings).map((problem) => problem.test.file))].sort().join("\n");
+function isFixtureDataVariableName(variableName) {
+  const segments = splitIdentifierName(variableName);
+  if (segments.length === 0) {
+    return false;
+  }
+  if (segments.some((segment) => FIXTURE_DATA_DIRECT_SEGMENTS.has(segment))) {
+    return true;
+  }
+  if (!segments.some((segment) => FIXTURE_DATA_ROLE_SEGMENTS.has(segment))) {
+    return false;
+  }
+  if (segments.every((segment) => FIXTURE_DATA_ROLE_SEGMENTS.has(segment))) {
+    return true;
+  }
+  const finalSegment = segments[segments.length - 1];
+  return finalSegment !== void 0 && FIXTURE_DATA_CONTEXT_SEGMENTS.has(finalSegment);
 }
-function formatLiteralValues(findings) {
-  const values = /* @__PURE__ */ new Map();
-  for (const problem of toLiteralProblems(findings)) {
-    values.set(`${problem.literalKind}\0${problem.value}`, {
-      kind: problem.literalKind,
-      value: problem.value
-    });
+function splitIdentifierName(variableName) {
+  return variableName.split("_").flatMap((part) => part.match(IDENTIFIER_SEGMENT_PATTERN) ?? []).map((segment) => segment.toLowerCase());
+}
+function getCallName(node) {
+  const callee = node.callee;
+  if (!isNode(callee)) {
+    return void 0;
   }
-  return [...values.values()].sort((left, right) => left.value.localeCompare(right.value) || left.kind.localeCompare(right.kind)).map((entry) => formatLiteralValue(entry.kind, entry.value)).join("\n");
+  if (callee.type === IDENTIFIER_TYPE) {
+    return getIdentifierName(callee);
+  }
+  if (callee.type !== MEMBER_EXPRESSION_TYPE) {
+    return void 0;
+  }
+  const property = callee.property;
+  if (isNode(property)) {
+    return property.type === IDENTIFIER_TYPE ? getIdentifierName(property) : getLiteralString(property);
+  }
+  return void 0;
 }
-function formatLiteralCommandOutput(findings, options) {
-  const totalProblems = countLiteralProblems(findings);
-  if (totalProblems === 0 && options.kind !== void 0) {
-    return formatNoProblemsOfKind(options.kind);
+function getIdentifierName(value) {
+  if (!isNode(value) || value.type !== IDENTIFIER_TYPE) {
+    return void 0;
   }
-  if (totalProblems === 0) {
-    return options.filesWithProblems || options.literals || options.verbose ? "" : NO_PROBLEMS_MESSAGE;
+  return typeof value.name === "string" ? value.name : void 0;
+}
+function getLiteralString(value) {
+  if (!isNode(value) || value.type !== LITERAL_TYPE) {
+    return void 0;
   }
-  if (options.filesWithProblems) return formatFilesWithProblems(findings);
-  if (options.literals) return formatLiteralValues(findings);
-  if (options.verbose) return formatVerboseLiteralProblems(findings);
-  return formatDefaultLiteralProblems(findings);
+  return typeof value.value === "string" ? value.value : void 0;
 }
-function toLiteralProblems(findings) {
-  return [
-    ...sortReuseFindings(findings.srcReuse).map((finding) => ({
-      problemKind: LITERAL_PROBLEM_KIND.REUSE,
-      literalKind: finding.kind,
-      value: finding.value,
-      test: finding.test,
-      related: finding.src
-    })),
-    ...sortDupeFindings(findings.testDupe).map((finding) => ({
-      problemKind: LITERAL_PROBLEM_KIND.DUPE,
-      literalKind: finding.kind,
-      value: finding.value,
-      test: finding.test,
-      related: finding.otherTests
-    }))
-  ];
+function isMeaningfulNumber(raw, minDigits) {
+  const digits = raw.replace(/[^0-9]/g, "");
+  return digits.length >= minDigits;
 }
-function appendVerboseSection(lines, heading, problems) {
-  const sortedProblems = [...problems].sort(compareLiteralProblems);
-  if (sortedProblems.length === 0) return;
-  lines.push(heading);
-  let currentFile;
-  for (const problem of sortedProblems) {
-    if (problem.test.file !== currentFile) {
-      lines.push(problem.test.file);
-      currentFile = problem.test.file;
+function buildIndex(occurrences) {
+  const map = /* @__PURE__ */ new Map();
+  for (const occ of occurrences) {
+    const key = makeKey(occ.kind, occ.value);
+    const existing = map.get(key);
+    if (existing) {
+      existing.push(occ.loc);
+    } else {
+      map.set(key, [occ.loc]);
     }
-    lines.push(
-      `  line ${problem.test.line}: ${formatLiteralValue(problem.literalKind, problem.value)} also in ${problem.related.map(formatLoc).join(", ")}`
-    );
   }
+  return map;
 }
-function sortReuseFindings(findings) {
-  return [...findings].sort(compareFindings);
+function makeKey(kind, value) {
+  return `${kind}\0${value}`;
 }
-function sortDupeFindings(findings) {
-  return [...findings].sort(compareFindings);
+function splitKey(key) {
+  const idx = key.indexOf("\0");
+  return { kind: key.slice(0, idx), value: key.slice(idx + 1) };
 }
-function compareFindings(left, right) {
-  return left.test.file.localeCompare(right.test.file) || left.test.line - right.test.line || left.kind.localeCompare(right.kind) || left.value.localeCompare(right.value);
+function detectReuse(input) {
+  const srcReuse = [];
+  const testDupe = [];
+  const testIndex = /* @__PURE__ */ new Map();
+  for (const [file, occurrences] of input.testOccurrencesByFile) {
+    for (const occ of occurrences) {
+      if (input.allowlist.has(occ.value)) continue;
+      const key = makeKey(occ.kind, occ.value);
+      let byFile = testIndex.get(key);
+      if (!byFile) {
+        byFile = /* @__PURE__ */ new Map();
+        testIndex.set(key, byFile);
+      }
+      const locsInFile = byFile.get(file);
+      if (locsInFile) locsInFile.push(occ.loc);
+      else byFile.set(file, [occ.loc]);
+    }
+  }
+  for (const [key, byFile] of testIndex) {
+    const { kind, value } = splitKey(key);
+    const srcLocs = input.srcIndex.get(key);
+    const allTestLocs = [];
+    for (const locs of byFile.values()) allTestLocs.push(...locs);
+    if (srcLocs && srcLocs.length > 0) {
+      for (const testLoc of allTestLocs) {
+        srcReuse.push({
+          test: testLoc,
+          kind,
+          value,
+          src: srcLocs,
+          remediation: REMEDIATION.IMPORT_FROM_SOURCE
+        });
+      }
+    } else if (byFile.size >= 2) {
+      for (let i = 0; i < allTestLocs.length; i += 1) {
+        const otherTests = [...allTestLocs.slice(0, i), ...allTestLocs.slice(i + 1)];
+        testDupe.push({
+          test: allTestLocs[i],
+          kind,
+          value,
+          otherTests,
+          remediation: REMEDIATION.REFACTOR_TO_SOURCE_OR_GENERATOR
+        });
+      }
+    }
+  }
+  return { srcReuse, testDupe };
 }
-function compareLiteralProblems(left, right) {
-  return left.test.file.localeCompare(right.test.file) || left.test.line - right.test.line || left.literalKind.localeCompare(right.literalKind) || left.value.localeCompare(right.value);
+
+// src/validation/literal/walker.ts
+var TYPESCRIPT_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".tsx"]);
+var DECLARATION_SUFFIX = ".d.ts";
+function isTypescriptSource(path6) {
+  if (path6.endsWith(DECLARATION_SUFFIX)) return false;
+  const ext = extensionOf(path6);
+  return TYPESCRIPT_EXTENSIONS.has(ext);
 }
-function formatLiteralValue(kind, value) {
-  return kind === "string" ? `"${value}"` : value;
+function extensionOf(name) {
+  const idx = name.lastIndexOf(".");
+  return idx === -1 ? "" : name.slice(idx);
 }
-function formatLoc(loc) {
-  return `${loc.file}:${loc.line}`;
+function isTestFile(relPath) {
+  return /\.test\.tsx?$/.test(relPath);
 }
 
-// src/commands/validation/markdown.ts
-import { relative as relative6 } from "path";
-
-// src/validation/steps/markdown.ts
-import { existsSync as existsSync6, statSync as statSync2 } from "fs";
-import { basename, dirname as dirname3, join as join17, relative as pathRelative } from "path";
-import { main as markdownlintMain } from "markdownlint-cli2";
-import relativeLinksRule from "markdownlint-rule-relative-links";
-var MARKDOWN_DEFAULT_DIRECTORY_NAMES = ["spx", "docs"];
-var MARKDOWN_FILE_EXTENSIONS = /* @__PURE__ */ new Set([".md", ".markdown"]);
-var MARKDOWN_DIRECTORY_GLOB = "**/*.md";
-var ENABLED_RULES = {
-  MD001: true,
-  MD003: true,
-  MD009: true,
-  MD010: true,
-  MD025: true,
-  MD047: true
-};
-var MD024_DISABLED_DIRECTORIES = ["docs"];
-var MARKDOWN_CUSTOM_RULE_NAMES = relativeLinksRule.names;
-var MARKDOWN_VALIDATION_TARGET_KIND = {
-  DIRECTORY: "directory",
-  FILE: "file"
-};
-var MARKDOWN_VALIDATION_TARGET_DIAGNOSTICS = {
-  MISSING_OR_UNRELATED_SCOPE: "not an existing directory or markdown file"
-};
-var ERROR_LINE_PATTERN = /^(.+?):(\d+)(?::\d+)?\s+(.+)$/;
-var defaultMarkdownValidationTargetDeps = {
-  statSync: statSync2
+// src/validation/literal/index.ts
+var PATH_PREFIX_SEPARATOR2 = "/";
+var DEFAULT_LITERAL_COLLECT_OPTIONS = {
+  visitorKeys: defaultVisitorKeys,
+  minStringLength: literalConfigDescriptor.defaults.minStringLength,
+  minNumberDigits: literalConfigDescriptor.defaults.minNumberDigits
 };
-function buildMarkdownlintConfig(directoryName) {
-  const md024Disabled = MD024_DISABLED_DIRECTORIES.includes(
-    directoryName
-  );
-  return {
-    default: false,
-    ...ENABLED_RULES,
-    MD024: md024Disabled ? false : { siblings_only: true },
-    customRules: [relativeLinksRule]
-  };
-}
-function getDefaultDirectories(projectRoot) {
-  return MARKDOWN_DEFAULT_DIRECTORY_NAMES.map((name) => join17(projectRoot, name)).filter((dir) => existsSync6(dir));
+function normalizePathPrefix2(prefix) {
+  const posix = prefix.split(/[\\/]/g).join(PATH_PREFIX_SEPARATOR2);
+  return posix.endsWith(PATH_PREFIX_SEPARATOR2) ? posix : `${posix}${PATH_PREFIX_SEPARATOR2}`;
 }
-function resolveMarkdownValidationTarget(path6, deps = defaultMarkdownValidationTargetDeps) {
-  if (isExistingDirectory(path6, deps)) {
-    return { target: { kind: MARKDOWN_VALIDATION_TARGET_KIND.DIRECTORY, path: path6 } };
-  }
-  if (hasMarkdownExtension(path6) && isExistingFile(path6, deps)) {
-    return { target: { kind: MARKDOWN_VALIDATION_TARGET_KIND.FILE, path: path6 } };
+function applyPathFilter(entries, pathConfig) {
+  if (pathConfig === void 0) {
+    return entries;
   }
-  return {
-    skipped: {
-      path: path6,
-      reason: MARKDOWN_VALIDATION_TARGET_DIAGNOSTICS.MISSING_OR_UNRELATED_SCOPE
+  const includePrefixes = (pathConfig.include ?? []).map(normalizePathPrefix2);
+  const excludePrefixes = (pathConfig.exclude ?? []).map(normalizePathPrefix2);
+  return entries.filter((entry) => {
+    if (includePrefixes.length > 0 && !includePrefixes.some((p) => entry.path.startsWith(p))) {
+      return false;
     }
-  };
-}
-function getExcludeGlobs(projectRoot) {
-  if (projectRoot === void 0) return [];
-  const reader = createIgnoreSourceReader(projectRoot, {
-    ignoreSourceFilename: IGNORE_SOURCE_FILENAME_DEFAULT,
-    specTreeRootSegment: SPEC_TREE_CONFIG.ROOT_DIRECTORY
+    if (excludePrefixes.some((p) => entry.path.startsWith(p))) {
+      return false;
+    }
+    return true;
   });
-  return reader.entries().map((entry) => `${entry.segment}/**`);
 }
-var DATA_URI_PATTERN = /\bdata:/;
-function parseErrorLine(line) {
-  if (DATA_URI_PATTERN.test(line)) {
-    return null;
-  }
-  const match = ERROR_LINE_PATTERN.exec(line);
-  if (!match) {
-    return null;
-  }
-  const [, file, lineStr, detail] = match;
-  return {
-    file,
-    line: parseInt(lineStr, 10),
-    detail
+async function validateLiteralReuse(input) {
+  const config = input.config ?? literalConfigDescriptor.defaults;
+  const request = input.files ? {
+    explicit: input.files.map((f) => {
+      const abs = isAbsolute5(f) ? f : resolve5(input.productDir, f);
+      return relative6(input.productDir, abs).split(/[\\/]/g).join("/");
+    })
+  } : { walkRoot: input.productDir };
+  const scope = await runPipeline(
+    [artifactDirectoryLayer, hiddenPrefixLayer],
+    input.productDir,
+    request,
+    DEFAULT_SCOPE_CONFIG,
+    EMPTY_IGNORE_READER
+  );
+  const filtered = applyPathFilter(scope.included, input.pathConfig);
+  const candidateFiles = filtered.filter((entry) => isTypescriptSource(entry.path)).map((entry) => resolve5(input.productDir, entry.path));
+  const collectOptions = {
+    visitorKeys: defaultVisitorKeys,
+    minStringLength: config.minStringLength,
+    minNumberDigits: config.minNumberDigits
   };
+  const srcOccurrences = [];
+  const testOccurrencesByFile = /* @__PURE__ */ new Map();
+  const indexedOccurrencesByFile = /* @__PURE__ */ new Map();
+  for (const abs of candidateFiles) {
+    const rel = relative6(input.productDir, abs).split(/[\\/]/g).join("/");
+    const content = await readSafe(abs);
+    if (content === null) continue;
+    const occurrences = collectLiterals(content, rel, collectOptions);
+    indexedOccurrencesByFile.set(rel, occurrences);
+    if (isTestFile(rel)) {
+      testOccurrencesByFile.set(rel, occurrences);
+    } else {
+      srcOccurrences.push(...occurrences);
+    }
+  }
+  const srcIndex = buildIndex(srcOccurrences);
+  const findings = detectReuse({
+    srcIndex,
+    testOccurrencesByFile,
+    allowlist: resolveAllowlist(config)
+  });
+  return { findings, indexedOccurrencesByFile };
 }
-async function validateMarkdown(options) {
-  const { targets, projectRoot } = options;
-  const errors = [];
-  const excludeGlobs = getExcludeGlobs(projectRoot);
-  for (const target of targets) {
-    const directory = targetDirectory(target);
-    const dirName = markdownlintConfigDirectoryName(directory, projectRoot);
-    const config = buildMarkdownlintConfig(dirName);
-    const dirErrors = await validateTarget(target, config, projectRoot, excludeGlobs);
-    errors.push(...dirErrors);
+async function readSafe(path6) {
+  try {
+    return await readFile8(path6, "utf8");
+  } catch (err) {
+    if (typeof err === "object" && err !== null && "code" in err) {
+      const code = err.code;
+      if (code === "ENOENT" || code === "EISDIR") return null;
+    }
+    throw err;
   }
-  return {
-    success: errors.length === 0,
-    errors
-  };
 }
-async function validateTarget(target, config, projectRoot, ignoreGlobs = []) {
-  const errors = [];
-  const directory = targetDirectory(target);
-  const argv = target.kind === MARKDOWN_VALIDATION_TARGET_KIND.FILE ? [basename(target.path)] : [MARKDOWN_DIRECTORY_GLOB];
-  const { customRules, ...markdownlintConfig } = config;
-  const optionsOverride = {
-    config: {
-      ...markdownlintConfig,
-      "relative-links": projectRoot ? { root_path: projectRoot } : true
-    },
-    customRules,
-    noProgress: true,
-    noBanner: true,
-    ...ignoreGlobs.length > 0 ? { ignores: ignoreGlobs } : {}
-  };
-  await markdownlintMain({
-    directory,
-    argv,
-    optionsOverride,
-    noImport: true,
-    logMessage: () => {
-    },
-    logError: (message) => {
-      const parsed = parseErrorLine(message);
-      if (parsed) {
-        errors.push({
-          ...parsed,
-          file: join17(directory, parsed.file)
-        });
-      }
+
+// src/commands/validation/literal.ts
+var LITERAL_PROBLEM_KIND = {
+  REUSE: "reuse",
+  DUPE: "dupe"
+};
+var OUTPUT_MODE_NAME = {
+  TEXT: "text",
+  VERBOSE: "verbose",
+  FILES_WITH_PROBLEMS: "filesWithProblems",
+  LITERALS: "literals",
+  JSON: "json"
+};
+var OUTPUT_MODE_NAMES = Object.values(OUTPUT_MODE_NAME);
+var LITERAL_EXIT_CODES = {
+  OK: 0,
+  FINDINGS: 1,
+  CONFIG_ERROR: 2
+};
+var TYPESCRIPT_ABSENT_MESSAGE3 = "\u23ED Skipping Literal (TypeScript not detected in project)";
+var LITERAL_DISABLED_MESSAGE = "\u23ED Skipping Literal (disabled by validation.literal.enabled)";
+var NO_PROBLEMS_MESSAGE = "Literal: \u2713 No problems";
+function formatNoProblemsOfKind(kind) {
+  return `Literal: No problems of type ${kind}`;
+}
+async function literalCommand(options) {
+  const start = Date.now();
+  const tsDetection = detectTypeScript(options.cwd);
+  if (!tsDetection.present) {
+    return {
+      exitCode: LITERAL_EXIT_CODES.OK,
+      output: options.quiet ? "" : TYPESCRIPT_ABSENT_MESSAGE3,
+      durationMs: Date.now() - start
+    };
+  }
+  let resolvedEnabled;
+  let resolvedLiteralConfig;
+  let resolvedPathConfig;
+  if (options.config !== void 0) {
+    resolvedEnabled = options.enabled ?? validationConfigDescriptor.defaults.literal.enabled;
+    resolvedLiteralConfig = options.config;
+    resolvedPathConfig = options.pathConfig ?? validationConfigDescriptor.defaults.paths;
+  } else {
+    const loaded = await resolveConfig(options.cwd, [validationConfigDescriptor]);
+    if (!loaded.ok) {
+      return {
+        exitCode: LITERAL_EXIT_CODES.CONFIG_ERROR,
+        output: `Literal: \u2717 config error \u2014 ${loaded.error}`,
+        durationMs: Date.now() - start
+      };
     }
+    const validationConfig = loaded.value[validationConfigDescriptor.section];
+    resolvedEnabled = validationConfig.literal.enabled;
+    resolvedLiteralConfig = validationConfig.literal.values;
+    resolvedPathConfig = validationPathFilterForTool(
+      validationConfig.paths,
+      VALIDATION_PATH_TOOL_SUBSECTIONS.LITERAL
+    );
+  }
+  if (!resolvedEnabled) {
+    return {
+      exitCode: LITERAL_EXIT_CODES.OK,
+      output: options.quiet ? "" : LITERAL_DISABLED_MESSAGE,
+      durationMs: Date.now() - start
+    };
+  }
+  const result = await validateLiteralReuse({
+    productDir: options.cwd,
+    files: options.files,
+    config: resolvedLiteralConfig,
+    pathConfig: resolvedPathConfig
   });
-  return errors;
+  const filteredFindings = filterLiteralFindings(result.findings, options.kind);
+  const totalProblems = countLiteralProblems(filteredFindings);
+  const exitCode = totalProblems === 0 ? LITERAL_EXIT_CODES.OK : LITERAL_EXIT_CODES.FINDINGS;
+  const output = options.json ? JSON.stringify(filteredFindings) : options.quiet ? "" : formatLiteralCommandOutput(filteredFindings, options);
+  return { exitCode, output, durationMs: Date.now() - start };
 }
-function targetDirectory(target) {
-  return target.kind === MARKDOWN_VALIDATION_TARGET_KIND.FILE ? dirname3(target.path) : target.path;
+function filterLiteralFindings(findings, kind) {
+  return {
+    srcReuse: kind === LITERAL_PROBLEM_KIND.DUPE ? [] : sortReuseFindings(findings.srcReuse),
+    testDupe: kind === LITERAL_PROBLEM_KIND.REUSE ? [] : sortDupeFindings(findings.testDupe)
+  };
 }
-function hasMarkdownExtension(path6) {
-  const lastDot = path6.lastIndexOf(".");
-  if (lastDot < 0) return false;
-  return MARKDOWN_FILE_EXTENSIONS.has(path6.slice(lastDot).toLowerCase());
+function countLiteralProblems(findings) {
+  return findings.srcReuse.length + findings.testDupe.length;
 }
-function isExistingDirectory(path6, deps) {
-  try {
-    return deps.statSync(path6).isDirectory();
-  } catch {
-    return false;
-  }
+function formatDefaultLiteralProblems(findings) {
+  return toLiteralProblems(findings).map(
+    (problem) => `[${problem.problemKind}] ${formatLiteralValue(problem.literalKind, problem.value)} ${formatLoc(problem.test)}`
+  ).join("\n");
 }
-function isExistingFile(path6, deps) {
-  try {
-    return deps.statSync(path6).isFile();
-  } catch {
-    return false;
-  }
+function formatVerboseLiteralProblems(findings) {
+  const lines = [
+    `Literal: ${countLiteralProblems(findings)} problems (reuse: ${findings.srcReuse.length}, dupe: ${findings.testDupe.length})`
+  ];
+  appendVerboseSection(
+    lines,
+    "REUSE",
+    findings.srcReuse.map((finding) => ({
+      problemKind: LITERAL_PROBLEM_KIND.REUSE,
+      literalKind: finding.kind,
+      value: finding.value,
+      test: finding.test,
+      related: finding.src
+    }))
+  );
+  appendVerboseSection(
+    lines,
+    "DUPE",
+    findings.testDupe.map((finding) => ({
+      problemKind: LITERAL_PROBLEM_KIND.DUPE,
+      literalKind: finding.kind,
+      value: finding.value,
+      test: finding.test,
+      related: finding.otherTests
+    }))
+  );
+  return lines.join("\n");
 }
-function markdownlintConfigDirectoryName(directory, projectRoot) {
-  if (projectRoot !== void 0) {
-    const [rootSegment] = pathRelative(projectRoot, directory).split(/[\\/]/);
-    if (MD024_DISABLED_DIRECTORIES.includes(rootSegment)) {
-      return rootSegment;
-    }
+function formatFilesWithProblems(findings) {
+  return [...new Set(toLiteralProblems(findings).map((problem) => problem.test.file))].sort().join("\n");
+}
+function formatLiteralValues(findings) {
+  const values = /* @__PURE__ */ new Map();
+  for (const problem of toLiteralProblems(findings)) {
+    values.set(`${problem.literalKind}\0${problem.value}`, {
+      kind: problem.literalKind,
+      value: problem.value
+    });
   }
-  return basename(directory);
+  return [...values.values()].sort((left, right) => left.value.localeCompare(right.value) || left.kind.localeCompare(right.kind)).map((entry) => formatLiteralValue(entry.kind, entry.value)).join("\n");
 }
-
-// src/commands/validation/markdown.ts
-var MARKDOWN_COMMAND_OUTPUT = {
-  ERROR_SUMMARY_SUFFIX: VALIDATION_COMMAND_OUTPUT.MARKDOWN_ERROR_SUMMARY_SUFFIX,
-  NO_ISSUES: VALIDATION_COMMAND_OUTPUT.MARKDOWN_NO_ISSUES,
-  SKIPPED_FILE_SCOPE_PREFIX: "Markdown skipped file scope"
-};
-var MARKDOWN_CONFIG_ERROR_MESSAGE = `${VALIDATION_STAGE_DISPLAY_NAMES.MARKDOWN}: \u2717 config error`;
-async function markdownCommand(options) {
-  const { cwd, files, quiet } = options;
-  const startTime = Date.now();
-  const loaded = await resolveConfig(cwd, [validationConfigDescriptor]);
-  if (!loaded.ok) {
-    return {
-      exitCode: 1,
-      output: `${MARKDOWN_CONFIG_ERROR_MESSAGE} \u2014 ${loaded.error}`,
-      durationMs: Date.now() - startTime
-    };
+function formatLiteralCommandOutput(findings, options) {
+  const totalProblems = countLiteralProblems(findings);
+  if (totalProblems === 0 && options.kind !== void 0) {
+    return formatNoProblemsOfKind(options.kind);
   }
-  const validationConfig = loaded.value[validationConfigDescriptor.section];
-  const pathFilter = validationPathFilterForTool(
-    validationConfig.paths,
-    VALIDATION_PATH_TOOL_SUBSECTIONS.MARKDOWN
-  );
-  const targetResolutions = files && files.length > 0 ? files.map((filePath) => resolveMarkdownValidationTarget(filePath)) : void 0;
-  const unfilteredTargets = targetResolutions !== void 0 ? targetResolutions.map((resolution) => resolution.target).filter((target) => target !== void 0) : getDefaultDirectories(cwd).map((path6) => ({
-    kind: MARKDOWN_VALIDATION_TARGET_KIND.DIRECTORY,
-    path: path6
-  }));
-  const targets = unfilteredTargets.filter(
-    (target) => pathPassesValidationFilter(relative6(cwd, target.path), pathFilter)
-  );
-  const skippedTargets = targetResolutions === void 0 ? [] : targetResolutions.map((resolution) => resolution.skipped).filter((skipped) => skipped !== void 0);
-  const skippedOutput = quiet ? [] : skippedTargets.map(formatSkippedFileScope);
-  if (targets.length === 0) {
-    const reason = files && files.length > 0 ? VALIDATION_SKIP_LABELS.MARKDOWN_NO_SCOPE_REASON : VALIDATION_SKIP_LABELS.MARKDOWN_NO_DEFAULT_DIRECTORIES_REASON;
-    const output = quiet ? "" : [
-      ...skippedOutput,
-      `${VALIDATION_STAGE_DISPLAY_NAMES.MARKDOWN}: skipped (${reason})`
-    ].join("\n");
-    return { exitCode: 0, output, durationMs: Date.now() - startTime };
+  if (totalProblems === 0) {
+    return options.filesWithProblems || options.literals || options.verbose ? "" : NO_PROBLEMS_MESSAGE;
   }
-  const result = await validateMarkdown({
-    targets,
-    projectRoot: cwd
-  });
-  const durationMs = Date.now() - startTime;
-  if (result.success) {
-    const output = quiet ? "" : [...skippedOutput, MARKDOWN_COMMAND_OUTPUT.NO_ISSUES].join("\n");
-    return { exitCode: 0, output, durationMs };
-  } else {
-    const errorLines = result.errors.map(
-      (error) => `  ${error.file}:${error.line} ${error.detail}`
+  if (options.filesWithProblems) return formatFilesWithProblems(findings);
+  if (options.literals) return formatLiteralValues(findings);
+  if (options.verbose) return formatVerboseLiteralProblems(findings);
+  return formatDefaultLiteralProblems(findings);
+}
+function toLiteralProblems(findings) {
+  return [
+    ...sortReuseFindings(findings.srcReuse).map((finding) => ({
+      problemKind: LITERAL_PROBLEM_KIND.REUSE,
+      literalKind: finding.kind,
+      value: finding.value,
+      test: finding.test,
+      related: finding.src
+    })),
+    ...sortDupeFindings(findings.testDupe).map((finding) => ({
+      problemKind: LITERAL_PROBLEM_KIND.DUPE,
+      literalKind: finding.kind,
+      value: finding.value,
+      test: finding.test,
+      related: finding.otherTests
+    }))
+  ];
+}
+function appendVerboseSection(lines, heading, problems) {
+  const sortedProblems = [...problems].sort(compareLiteralProblems);
+  if (sortedProblems.length === 0) return;
+  lines.push(heading);
+  let currentFile;
+  for (const problem of sortedProblems) {
+    if (problem.test.file !== currentFile) {
+      lines.push(problem.test.file);
+      currentFile = problem.test.file;
+    }
+    lines.push(
+      `  line ${problem.test.line}: ${formatLiteralValue(problem.literalKind, problem.value)} also in ${problem.related.map(formatLoc).join(", ")}`
     );
-    const output = [
-      ...skippedOutput,
-      `Markdown: ${result.errors.length} ${MARKDOWN_COMMAND_OUTPUT.ERROR_SUMMARY_SUFFIX}`,
-      ...errorLines
-    ].join("\n");
-    return { exitCode: 1, output, durationMs };
   }
 }
-function formatSkippedFileScope(target) {
-  return `${MARKDOWN_COMMAND_OUTPUT.SKIPPED_FILE_SCOPE_PREFIX}: ${target.path} (${target.reason})`;
+function sortReuseFindings(findings) {
+  return [...findings].sort(compareFindings);
+}
+function sortDupeFindings(findings) {
+  return [...findings].sort(compareFindings);
+}
+function compareFindings(left, right) {
+  return left.test.file.localeCompare(right.test.file) || left.test.line - right.test.line || left.kind.localeCompare(right.kind) || left.value.localeCompare(right.value);
+}
+function compareLiteralProblems(left, right) {
+  return left.test.file.localeCompare(right.test.file) || left.test.line - right.test.line || left.literalKind.localeCompare(right.literalKind) || left.value.localeCompare(right.value);
+}
+function formatLiteralValue(kind, value) {
+  return kind === "string" ? `"${value}"` : value;
+}
+function formatLoc(loc) {
+  return `${loc.file}:${loc.line}`;
 }
 
 // src/validation/steps/typescript.ts
@@ -8082,42 +8264,119 @@ async function typescriptCommand(options) {
   }
 }
 
+// src/validation/languages/typescript.ts
+var TYPESCRIPT_LANGUAGE_NAME = "typescript";
+async function runLiteralStage(context) {
+  if (context.skipLiteral) {
+    const skipOutput = context.json ? LITERAL_SKIP_JSON_OUTPUT : LITERAL_SKIP_OUTPUT;
+    return { exitCode: 0, output: context.quiet ? "" : skipOutput };
+  }
+  return literalCommand({
+    cwd: context.cwd,
+    files: context.files,
+    quiet: context.quiet,
+    json: context.json
+  });
+}
+var typescriptValidationLanguage = {
+  name: TYPESCRIPT_LANGUAGE_NAME,
+  stages: [
+    {
+      name: VALIDATION_STAGE_DISPLAY_NAMES.CIRCULAR,
+      failsPipeline: true,
+      run: (context) => circularCommand({ cwd: context.cwd, quiet: context.quiet, json: context.json })
+    },
+    {
+      name: VALIDATION_STAGE_DISPLAY_NAMES.KNIP,
+      // Knip is informational: unused-code findings never fail the pipeline.
+      failsPipeline: false,
+      run: (context) => knipCommand({ cwd: context.cwd, quiet: context.quiet, json: context.json })
+    },
+    {
+      name: VALIDATION_STAGE_DISPLAY_NAMES.ESLINT,
+      failsPipeline: true,
+      run: (context) => lintCommand({
+        cwd: context.cwd,
+        scope: context.scope,
+        files: context.files,
+        fix: context.fix,
+        quiet: context.quiet,
+        json: context.json
+      })
+    },
+    {
+      name: VALIDATION_STAGE_DISPLAY_NAMES.TYPESCRIPT,
+      failsPipeline: true,
+      run: (context) => typescriptCommand({
+        cwd: context.cwd,
+        scope: context.scope,
+        files: context.files,
+        quiet: context.quiet,
+        json: context.json
+      })
+    },
+    {
+      name: VALIDATION_STAGE_DISPLAY_NAMES.LITERAL,
+      failsPipeline: true,
+      run: runLiteralStage
+    }
+  ]
+};
+
+// src/validation/registry.ts
+var validationRegistry = {
+  languages: [typescriptValidationLanguage, markdownValidationLanguage]
+};
+var validationPipelineStages = validationRegistry.languages.flatMap(
+  (language) => language.stages
+);
+var VALIDATION_PIPELINE_TOTAL_STEPS = validationPipelineStages.length;
+
+// src/commands/validation/format.ts
+var DURATION_THRESHOLD_MS = 1e3;
+var VALIDATION_SYMBOLS = {
+  SUCCESS: "\u2713",
+  FAILURE: "\u2717"
+};
+var VALIDATION_SUMMARY_STATUS = {
+  PASSED: "passed",
+  FAILED: "failed"
+};
+function formatDuration(ms) {
+  if (ms < DURATION_THRESHOLD_MS) {
+    return `${ms}ms`;
+  }
+  const seconds = ms / 1e3;
+  return `${seconds.toFixed(1)}s`;
+}
+function formatSummary(options) {
+  const { success, totalDurationMs } = options;
+  const symbol = success ? VALIDATION_SYMBOLS.SUCCESS : VALIDATION_SYMBOLS.FAILURE;
+  const status = success ? VALIDATION_SUMMARY_STATUS.PASSED : VALIDATION_SUMMARY_STATUS.FAILED;
+  const duration = formatDuration(totalDurationMs);
+  return `${symbol} Validation ${status} (${duration} total)`;
+}
+
 // src/commands/validation/all.ts
-var TOTAL_STEPS = VALIDATION_PIPELINE.TOTAL_STEPS;
 function formatStepWithTiming(stepNumber, result, quiet) {
   if (quiet || !result.output) return "";
   const timing = result.durationMs === void 0 ? "" : ` (${formatDuration(result.durationMs)})`;
-  return `[${stepNumber}/${TOTAL_STEPS}] ${result.output}${timing}`;
+  return `[${stepNumber}/${VALIDATION_PIPELINE_TOTAL_STEPS}] ${result.output}${timing}`;
 }
 async function allCommand(options) {
   const { cwd, scope, files, fix, quiet = false, json, skipLiteral = false } = options;
   const startTime = Date.now();
   const outputs = [];
   let hasFailure = false;
-  const circularResult = await circularCommand({ cwd, quiet, json });
-  const circularOutput = formatStepWithTiming(1, circularResult, quiet);
-  if (circularOutput) outputs.push(circularOutput);
-  if (circularResult.exitCode !== 0) hasFailure = true;
-  const knipResult = await knipCommand({ cwd, quiet, json });
-  const knipOutput = formatStepWithTiming(2, knipResult, quiet);
-  if (knipOutput) outputs.push(knipOutput);
-  const lintResult = await lintCommand({ cwd, scope, files, fix, quiet, json });
-  const lintOutput = formatStepWithTiming(3, lintResult, quiet);
-  if (lintOutput) outputs.push(lintOutput);
-  if (lintResult.exitCode !== 0) hasFailure = true;
-  const tsResult = await typescriptCommand({ cwd, scope, files, quiet, json });
-  const tsOutput = formatStepWithTiming(4, tsResult, quiet);
-  if (tsOutput) outputs.push(tsOutput);
-  if (tsResult.exitCode !== 0) hasFailure = true;
-  const markdownResult = await markdownCommand({ cwd, files, quiet });
-  const markdownOutput = formatStepWithTiming(5, markdownResult, quiet);
-  if (markdownOutput) outputs.push(markdownOutput);
-  if (markdownResult.exitCode !== 0) hasFailure = true;
-  const literalSkipOutput = json ? LITERAL_SKIP_JSON_OUTPUT : LITERAL_SKIP_OUTPUT;
-  const literalResult = skipLiteral ? { exitCode: 0, output: quiet ? "" : literalSkipOutput } : await literalCommand({ cwd, files, quiet, json });
-  const literalOutput = formatStepWithTiming(6, literalResult, quiet);
-  if (literalOutput) outputs.push(literalOutput);
-  if (literalResult.exitCode !== 0) hasFailure = true;
+  const context = { cwd, scope, files, fix, quiet, json, skipLiteral };
+  let stepNumber = 0;
+  for (const stage of validationPipelineStages) {
+    stepNumber += 1;
+    const result = await stage.run(context);
+    const stepOutput = formatStepWithTiming(stepNumber, result, quiet);
+    if (stepOutput) outputs.push(stepOutput);
+    if (stage.failsPipeline && result.exitCode !== 0) hasFailure = true;
+  }
   const totalDurationMs = Date.now() - startTime;
   if (!quiet) {
     const summary = formatSummary({ success: !hasFailure, totalDurationMs });
@@ -8268,7 +8527,7 @@ function serializeWithUpdatedInclude(target, include) {
   return serializeConfigFileSectionsWithSetIn(target, ALLOWLIST_INCLUDE_PATH, [...include]);
 }
 
-// src/domains/validation/index.ts
+// src/interfaces/cli/validation.ts
 var validationCliDefinition = {
   domain: {
     commandName: "validation",
@@ -8517,17 +8776,24 @@ var validationDomain = {
   }
 };
 
+// src/interfaces/cli/registry.ts
+var CLI_DOMAINS = [
+  auditDomain,
+  claudeDomain,
+  configDomain,
+  sessionDomain,
+  specDomain,
+  validationDomain
+];
+
 // src/cli.ts
 installLifecycle();
 var require3 = createRequire2(import.meta.url);
 var { version } = require3("../package.json");
 var program = new Command();
 program.name("spx").description("Fast, deterministic CLI tool for spec workflow management").version(version);
-auditDomain.register(program);
-claudeDomain.register(program);
-configDomain.register(program);
-sessionDomain.register(program);
-specDomain.register(program);
-validationDomain.register(program);
+for (const domain of CLI_DOMAINS) {
+  domain.register(program);
+}
 program.parse();
 //# sourceMappingURL=cli.js.map