@outcomeeng/spx 0.6.1 → 0.6.2

package/dist/cli.js

@@ -1598,6 +1598,18 @@ import { join as join5 } from "path";
 import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
 import { parse as parseYaml, parseDocument as parseYamlDocument, stringify as stringifyYaml } from "yaml";
 
+// src/lib/error-message.ts
+function toMessage(error) {
+  if (error instanceof Error) return error.message;
+  if (typeof error === "string") return error;
+  const fallback = `[${typeof error}]`;
+  try {
+    return JSON.stringify(error) ?? fallback;
+  } catch {
+    return fallback;
+  }
+}
+
 // src/domains/agent-environment/config.ts
 var AGENT_ENVIRONMENT_SECTION = "agentEnvironment";
 var AGENT_RUNTIME = {
@@ -1794,15 +1806,15 @@ function validateRuntimes(raw) {
   }
   return { ok: true, value: runtimes };
 }
-function validateRuntimeConfig(path7, raw, defaults4) {
+function validateRuntimeConfig(path7, raw, defaults5) {
   if (!isRecord(raw)) return { ok: false, error: `${path7} must be an object` };
   const unknown = rejectUnknownFields(path7, raw, AGENT_ENVIRONMENT_RUNTIME_CONFIG_ALLOWED_FIELDS);
   if (!unknown.ok) return unknown;
   const enabledRaw = raw[AGENT_ENVIRONMENT_CONFIG_FIELDS.ENABLED];
-  if (enabledRaw === void 0) return { ok: true, value: defaults4 };
+  if (enabledRaw === void 0) return { ok: true, value: defaults5 };
   const enabled = validateBoolean(`${path7}.${AGENT_ENVIRONMENT_CONFIG_FIELDS.ENABLED}`, enabledRaw);
   if (!enabled.ok) return enabled;
-  return { ok: true, value: { ...defaults4, enabled: enabled.value } };
+  return { ok: true, value: { ...defaults5, enabled: enabled.value } };
 }
 function validatePluginBootstrap(raw) {
   const sectionPath = `${AGENT_ENVIRONMENT_SECTION}.${AGENT_ENVIRONMENT_CONFIG_FIELDS.PLUGIN_BOOTSTRAP}`;
@@ -1866,8 +1878,8 @@ function validatePluginBootstrap(raw) {
     }
   };
 }
-function validateEntryArray(path7, raw, validateEntry2, defaults4) {
-  if (raw === void 0) return { ok: true, value: defaults4 };
+function validateEntryArray(path7, raw, validateEntry2, defaults5) {
+  if (raw === void 0) return { ok: true, value: defaults5 };
   if (!Array.isArray(raw)) return { ok: false, error: `${path7} must be an array` };
   const entries = [];
   for (const [index, entry] of raw.entries()) {
@@ -2050,6 +2062,82 @@ var agentEnvironmentConfigDescriptor = {
   validate
 };
 
+// src/domains/diagnose/facts.ts
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.length > 0;
+}
+function isNonEmptyStringArray(value) {
+  return Array.isArray(value) && value.length > 0 && value.every(isNonEmptyString);
+}
+function validateMarketplaceIdentity(value, field) {
+  if (!isRecord2(value) || !isNonEmptyString(value.name) || !isNonEmptyString(value.source)) {
+    return { ok: false, error: `${field} must carry a non-empty \`name\` and \`source\`` };
+  }
+  return { ok: true, value: { name: value.name, source: value.source } };
+}
+
+// src/domains/diagnose/config.ts
+var DIAGNOSE_SECTION = "diagnose";
+var DIAGNOSE_CONFIG_FIELDS = {
+  SPX_FLOOR: "spxFloor",
+  MARKETPLACE: "marketplace",
+  EXPECTED_PLUGINS: "expectedPlugins",
+  CHECKS: "checks"
+};
+var defaults = {};
+function validate2(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return { ok: false, error: `${DIAGNOSE_SECTION} section must be an object` };
+  }
+  const candidate = value;
+  const resolved = {};
+  const spxFloor = candidate[DIAGNOSE_CONFIG_FIELDS.SPX_FLOOR];
+  if (spxFloor !== void 0) {
+    if (!isNonEmptyString(spxFloor)) {
+      return { ok: false, error: `${DIAGNOSE_SECTION}.${DIAGNOSE_CONFIG_FIELDS.SPX_FLOOR} must be a non-empty string` };
+    }
+    resolved.spxFloor = spxFloor;
+  }
+  const marketplace = candidate[DIAGNOSE_CONFIG_FIELDS.MARKETPLACE];
+  if (marketplace !== void 0) {
+    const result = validateMarketplaceIdentity(
+      marketplace,
+      `${DIAGNOSE_SECTION}.${DIAGNOSE_CONFIG_FIELDS.MARKETPLACE}`
+    );
+    if (!result.ok) return result;
+    resolved.marketplace = result.value;
+  }
+  const expectedPlugins = candidate[DIAGNOSE_CONFIG_FIELDS.EXPECTED_PLUGINS];
+  if (expectedPlugins !== void 0) {
+    if (!isNonEmptyStringArray(expectedPlugins)) {
+      return {
+        ok: false,
+        error: `${DIAGNOSE_SECTION}.${DIAGNOSE_CONFIG_FIELDS.EXPECTED_PLUGINS} must be a non-empty array of non-empty strings`
+      };
+    }
+    resolved.expectedPlugins = expectedPlugins;
+  }
+  const checks = candidate[DIAGNOSE_CONFIG_FIELDS.CHECKS];
+  if (checks !== void 0) {
+    if (!isNonEmptyStringArray(checks)) {
+      return {
+        ok: false,
+        error: `${DIAGNOSE_SECTION}.${DIAGNOSE_CONFIG_FIELDS.CHECKS} must be a non-empty array of non-empty strings`
+      };
+    }
+    resolved.checks = checks;
+  }
+  return { ok: true, value: resolved };
+}
+var diagnoseConfigDescriptor = {
+  section: DIAGNOSE_SECTION,
+  defaults,
+  validate: validate2
+};
+
 // src/lib/spec-tree/config.ts
 var SPEC_TREE_KIND_CATEGORY_VALUES = {
   NODE: "node",
@@ -2229,7 +2317,7 @@ var SPEC_TREE_NODE_STATE = {
 };
 var SPEC_TREE_SECTION = SPEC_TREE_CONFIG.SECTION;
 function isKind(value) {
-  return Object.prototype.hasOwnProperty.call(KIND_REGISTRY, value);
+  return Object.hasOwn(KIND_REGISTRY, value);
 }
 function buildDefaults() {
   return { kinds: { ...KIND_REGISTRY } };
@@ -2238,7 +2326,7 @@ function buildConfigFromKindNames(kindNames) {
   const entries = kindNames.map((kind) => [kind, KIND_REGISTRY[kind]]);
   return { kinds: Object.fromEntries(entries) };
 }
-function validate2(value) {
+function validate3(value) {
   if (typeof value !== "object" || value === null) {
     return { ok: false, error: `${SPEC_TREE_SECTION} section must be an object` };
   }
@@ -2337,7 +2425,7 @@ function validateKindDefinitionMap(kindEntries) {
 var specTreeConfigDescriptor = {
   section: SPEC_TREE_SECTION,
   defaults: buildDefaults(),
-  validate: validate2
+  validate: validate3
 };
 
 // src/lib/file-inclusion/adapters/eslint.ts
@@ -2513,11 +2601,11 @@ var DEFAULT_SCOPE_CONFIG = {
 var DEFAULT_TOOLS_CONFIG = Object.fromEntries(
   Object.entries(TOOL_DEFAULT_FLAGS).map(([name, flag]) => [name, { ignoreFlag: flag }])
 );
-var defaults = {
+var defaults2 = {
   scope: DEFAULT_SCOPE_CONFIG,
   tools: DEFAULT_TOOLS_CONFIG
 };
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function validateStringField(section, field, value) {
@@ -2540,7 +2628,7 @@ function rejectUnknownFields2(section, value, allowed) {
   return { ok: true, value: void 0 };
 }
 function validateScope(raw) {
-  if (!isRecord2(raw)) {
+  if (!isRecord3(raw)) {
     return {
       ok: false,
       error: `${FILE_INCLUSION_SECTION}.${FILE_INCLUSION_CONFIG_FIELDS.SCOPE} must be an object`
@@ -2597,7 +2685,7 @@ function validateScope(raw) {
   };
 }
 function validateTools(raw) {
-  if (!isRecord2(raw)) {
+  if (!isRecord3(raw)) {
     return {
       ok: false,
       error: `${FILE_INCLUSION_SECTION}.${FILE_INCLUSION_CONFIG_FIELDS.TOOLS} must be an object`
@@ -2612,7 +2700,7 @@ function validateTools(raw) {
         error: `${FILE_INCLUSION_SECTION}.${FILE_INCLUSION_CONFIG_FIELDS.TOOLS}.${toolName} is not a recognized tool`
       };
     }
-    if (!isRecord2(adapterRaw)) {
+    if (!isRecord3(adapterRaw)) {
       return {
         ok: false,
         error: `${FILE_INCLUSION_SECTION}.${FILE_INCLUSION_CONFIG_FIELDS.TOOLS}.${toolName} must be an object`
@@ -2632,7 +2720,7 @@ function validateTools(raw) {
   }
   return { ok: true, value: tools };
 }
-function validate3(value) {
+function validate4(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
     return { ok: false, error: `${FILE_INCLUSION_SECTION} section must be an object` };
   }
@@ -2659,8 +2747,8 @@ function validate3(value) {
 }
 var fileInclusionConfigDescriptor = {
   section: FILE_INCLUSION_SECTION,
-  defaults,
-  validate: validate3
+  defaults: defaults2,
+  validate: validate4
 };
 
 // src/lib/precommit/config.ts
@@ -2669,7 +2757,7 @@ var PRECOMMIT_DEFAULTS = {
   sourceDirs: ["src/"],
   testPattern: ".test.ts"
 };
-function validate4(value) {
+function validate5(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
     return { ok: false, error: `${PRECOMMIT_SECTION} section must be an object` };
   }
@@ -2699,7 +2787,7 @@ function validate4(value) {
 var precommitConfigDescriptor = {
   section: PRECOMMIT_SECTION,
   defaults: PRECOMMIT_DEFAULTS,
-  validate: validate4
+  validate: validate5
 };
 
 // src/config/primitives/path-filter.ts
@@ -2736,7 +2824,11 @@ function validatePathFilterConfig(raw, path7) {
 }
 var PATH_SEGMENT_SEPARATOR = "/";
 function normalizePathPrefix(value) {
-  return value.replace(/\/+$/, "");
+  let end = value.length;
+  while (end > 0 && value[end - 1] === PATH_SEGMENT_SEPARATOR) {
+    end--;
+  }
+  return value.slice(0, end);
 }
 function pathMatchesPrefix(path7, prefix) {
   const normalizedPath = normalizePathPrefix(path7);
@@ -2760,7 +2852,7 @@ var TESTING_CONFIG_FIELDS = {
   PASSING_SCOPE: "passingScope"
 };
 var DEFAULT_PASSING_SCOPE = resolveDefaultPassingScope();
-var defaults2 = {
+var defaults3 = {
   passingScope: DEFAULT_PASSING_SCOPE
 };
 function resolveDefaultPassingScope() {
@@ -2773,14 +2865,14 @@ function resolveDefaultPassingScope() {
   }
   return result.value;
 }
-function validate5(value) {
+function validate6(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
     return { ok: false, error: `${TESTING_SECTION} section must be an object` };
   }
   const candidate = value;
   const passingScopeRaw = candidate[TESTING_CONFIG_FIELDS.PASSING_SCOPE];
   if (passingScopeRaw === void 0) {
-    return { ok: true, value: defaults2 };
+    return { ok: true, value: defaults3 };
   }
   const passingScopeResult = validatePathFilterConfig(
     passingScopeRaw,
@@ -2796,8 +2888,8 @@ function validate5(value) {
 }
 var testingConfigDescriptor = {
   section: TESTING_SECTION,
-  defaults: defaults2,
-  validate: validate5
+  defaults: defaults3,
+  validate: validate6
 };
 
 // src/validation/literal/config.ts
@@ -2854,7 +2946,13 @@ var LITERAL_DEFAULTS = {
   minStringLength: DEFAULT_MIN_STRING_LENGTH,
   minNumberDigits: DEFAULT_MIN_NUMBER_DIGITS
 };
-function validate6(value) {
+function isStringArray(value) {
+  return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+function isNonNegativeInteger(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function validate7(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
     return { ok: false, error: `${LITERAL_SECTION} section must be an object` };
   }
@@ -2864,32 +2962,31 @@ function validate6(value) {
   }
   const presets = candidate["presets"];
   if (presets !== void 0) {
-    if (!Array.isArray(presets) || !presets.every((x) => typeof x === "string")) {
+    if (!isStringArray(presets)) {
       return { ok: false, error: `${LITERAL_SECTION}.presets must be an array of strings` };
     }
-    for (const id of presets) {
-      if (!PRESET_REGISTRY.has(id)) {
-        return { ok: false, error: `${LITERAL_SECTION}.presets: unrecognized preset "${id}"` };
-      }
+    const unknownPreset = presets.find((id) => !PRESET_REGISTRY.has(id));
+    if (unknownPreset !== void 0) {
+      return { ok: false, error: `${LITERAL_SECTION}.presets: unrecognized preset "${unknownPreset}"` };
     }
   }
   const include = candidate["include"];
-  if (include !== void 0 && (!Array.isArray(include) || !include.every((x) => typeof x === "string"))) {
+  if (include !== void 0 && !isStringArray(include)) {
     return { ok: false, error: `${LITERAL_SECTION}.include must be an array of strings` };
   }
   const exclude = candidate["exclude"];
-  if (exclude !== void 0 && (!Array.isArray(exclude) || !exclude.every((x) => typeof x === "string"))) {
+  if (exclude !== void 0 && !isStringArray(exclude)) {
     return { ok: false, error: `${LITERAL_SECTION}.exclude must be an array of strings` };
   }
   const minStringLength = candidate["minStringLength"] ?? LITERAL_DEFAULTS.minStringLength;
-  if (typeof minStringLength !== "number" || !Number.isInteger(minStringLength) || minStringLength < 0) {
+  if (!isNonNegativeInteger(minStringLength)) {
     return {
       ok: false,
       error: `${LITERAL_SECTION}.minStringLength must be a non-negative integer`
     };
   }
   const minNumberDigits = candidate["minNumberDigits"] ?? LITERAL_DEFAULTS.minNumberDigits;
-  if (typeof minNumberDigits !== "number" || !Number.isInteger(minNumberDigits) || minNumberDigits < 0) {
+  if (!isNonNegativeInteger(minNumberDigits)) {
     return {
       ok: false,
       error: `${LITERAL_SECTION}.minNumberDigits must be a non-negative integer`
@@ -2909,7 +3006,7 @@ function validate6(value) {
 var literalConfigDescriptor = {
   section: LITERAL_SECTION,
   defaults: LITERAL_DEFAULTS,
-  validate: validate6
+  validate: validate7
 };
 
 // src/validation/config/descriptor.ts
@@ -2925,9 +3022,10 @@ var VALIDATION_PATH_TOOL_SUBSECTIONS = {
   CIRCULAR: "circular",
   KNIP: "knip",
   MARKDOWN: "markdown",
-  LITERAL: "literal"
+  LITERAL: "literal",
+  FORMATTING: "formatting"
 };
-var defaults3 = {
+var defaults4 = {
   paths: {},
   literal: {
     enabled: true,
@@ -2967,7 +3065,7 @@ function validateLiteral(raw) {
     };
   }
   const candidate = raw;
-  const enabledRaw = candidate[VALIDATION_ENABLED_FIELD] ?? defaults3.literal.enabled;
+  const enabledRaw = candidate[VALIDATION_ENABLED_FIELD] ?? defaults4.literal.enabled;
   if (typeof enabledRaw !== "boolean") {
     return {
       ok: false,
@@ -2992,7 +3090,7 @@ function validateKnip(raw) {
     };
   }
   const candidate = raw;
-  const enabledRaw = candidate[VALIDATION_ENABLED_FIELD] ?? defaults3.knip.enabled;
+  const enabledRaw = candidate[VALIDATION_ENABLED_FIELD] ?? defaults4.knip.enabled;
   if (typeof enabledRaw !== "boolean") {
     return {
       ok: false,
@@ -3001,7 +3099,7 @@ function validateKnip(raw) {
   }
   return { ok: true, value: { enabled: enabledRaw } };
 }
-function validate7(value) {
+function validate8(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
     return { ok: false, error: `${VALIDATION_SECTION} section must be an object` };
   }
@@ -3019,8 +3117,8 @@ function validate7(value) {
 }
 var validationConfigDescriptor = {
   section: VALIDATION_SECTION,
-  defaults: defaults3,
-  validate: validate7
+  defaults: defaults4,
+  validate: validate8
 };
 
 // src/config/registry.ts
@@ -3030,7 +3128,8 @@ var productionRegistry = [
   testingConfigDescriptor,
   fileInclusionConfigDescriptor,
   precommitConfigDescriptor,
-  agentEnvironmentConfigDescriptor
+  agentEnvironmentConfigDescriptor,
+  diagnoseConfigDescriptor
 ];
 
 // src/config/descriptor-digest.ts
@@ -3328,7 +3427,7 @@ function setNested(target, path7, value) {
       cursor = fresh;
     }
   }
-  cursor[path7[path7.length - 1]] = value;
+  cursor[path7.at(-1)] = value;
 }
 function validateParsedSections(filename, parsed) {
   if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
@@ -3339,9 +3438,6 @@ function validateParsedSections(filename, parsed) {
 function isFileNotFound(error) {
   return error instanceof Error && "code" in error && error.code === "ENOENT";
 }
-function toMessage(error) {
-  return error instanceof Error ? error.message : String(error);
-}
 
 // src/commands/config/defaults.ts
 function defaultsCommand(options, deps) {
@@ -3576,12 +3672,6 @@ var CHECK_NAME = {
   SESSION_STORE: "session-store",
   MARKETPLACE_INSTALL: "marketplace-install"
 };
-function isRecord3(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function isNonEmptyString(value) {
-  return typeof value === "string" && value.length > 0;
-}
 function validateChecks(raw, available) {
   if (!Array.isArray(raw) || raw.length === 0) {
     return { ok: false, error: "manifest `checks` must be a non-empty array of check names" };
@@ -3595,12 +3685,6 @@ function validateChecks(raw, available) {
   }
   return { ok: true, value: raw };
 }
-function validateMarketplace2(raw) {
-  if (!isRecord3(raw) || !isNonEmptyString(raw.name) || !isNonEmptyString(raw.source)) {
-    return { ok: false, error: "manifest `marketplace` must carry a non-empty `name` and `source`" };
-  }
-  return { ok: true, value: { name: raw.name, source: raw.source } };
-}
 function parseManifest(rawJson, availableChecks) {
   let parsed;
   try {
@@ -3608,7 +3692,7 @@ function parseManifest(rawJson, availableChecks) {
   } catch (error) {
     return { ok: false, error: `manifest is not valid JSON: ${error.message}` };
   }
-  if (!isRecord3(parsed)) {
+  if (!isRecord2(parsed)) {
     return { ok: false, error: "manifest must be a JSON object" };
   }
   const checks = validateChecks(parsed.checks, new Set(availableChecks));
@@ -3621,9 +3705,9 @@ function parseManifest(rawJson, availableChecks) {
     manifest.spxFloor = parsed.spx_floor;
   }
   if (checks.value.includes(CHECK_NAME.MARKETPLACE_INSTALL)) {
-    const marketplace = validateMarketplace2(parsed.marketplace);
+    const marketplace = validateMarketplaceIdentity(parsed.marketplace, "manifest `marketplace`");
     if (!marketplace.ok) return marketplace;
-    if (!Array.isArray(parsed.expected_plugins) || !parsed.expected_plugins.every(isNonEmptyString)) {
+    if (!isNonEmptyStringArray(parsed.expected_plugins)) {
       return { ok: false, error: "manifest selects `marketplace-install` but carries no `expected_plugins`" };
     }
     manifest.marketplace = marketplace.value;
@@ -3738,21 +3822,70 @@ function renderReport(report2, format2, options) {
   return format2 === DIAGNOSE_FORMAT.JSON ? renderReportJson(report2) : renderReportText(report2, options);
 }
 
+// src/domains/diagnose/resolve.ts
+var CHECK_NAMES = new Set(Object.values(CHECK_NAME));
+function isCheckName(value) {
+  return CHECK_NAMES.has(value);
+}
+function resolveDiagnoseFacts(options) {
+  if (options.manifest !== void 0) {
+    return { ok: true, value: options.manifest };
+  }
+  const { config, availableChecks } = options;
+  const configuredChecks = config.checks;
+  let checks;
+  if (configuredChecks === void 0) {
+    checks = availableChecks;
+  } else {
+    const available = new Set(availableChecks);
+    const unavailable = configuredChecks.filter((name) => !isCheckName(name) || !available.has(name));
+    if (unavailable.length > 0) {
+      return {
+        ok: false,
+        error: `diagnose config \`checks\` names checks not available in this build: ${unavailable.join(", ")}`
+      };
+    }
+    checks = configuredChecks.filter(isCheckName);
+  }
+  return {
+    ok: true,
+    value: {
+      checks,
+      spxFloor: config.spxFloor,
+      marketplace: config.marketplace,
+      expectedPlugins: config.expectedPlugins
+    }
+  };
+}
+
 // src/commands/diagnose/index.ts
-async function diagnoseCommand(options) {
+async function resolveDiagnoseConfig(productDir) {
+  const loaded = await resolveConfig(productDir, [diagnoseConfigDescriptor]);
+  if (!loaded.ok) return loaded;
+  return { ok: true, value: loaded.value[diagnoseConfigDescriptor.section] };
+}
+async function readManifest(fs8, manifestPath, availableChecks) {
   let raw;
   try {
-    raw = await options.fs.readFile(options.manifestPath);
+    raw = await fs8.readFile(manifestPath);
   } catch (error) {
-    return {
-      ok: false,
-      error: `cannot read diagnose manifest at ${options.manifestPath}: ${error.message}`
-    };
+    return { ok: false, error: `cannot read diagnose manifest at ${manifestPath}: ${error.message}` };
   }
+  return parseManifest(raw, availableChecks);
+}
+async function diagnoseCommand(options) {
   const availableChecks = Object.keys(options.registry);
-  const manifest = parseManifest(raw, availableChecks);
-  if (!manifest.ok) return manifest;
-  const report2 = await runDiagnose(manifest.value, options.registry);
+  const manifest = options.manifestPath === void 0 ? void 0 : await readManifest(options.fs, options.manifestPath, availableChecks);
+  if (manifest !== void 0 && !manifest.ok) return manifest;
+  const config = manifest === void 0 ? await resolveDiagnoseConfig(options.productDir) : { ok: true, value: {} };
+  if (!config.ok) return config;
+  const resolved = resolveDiagnoseFacts({
+    manifest: manifest?.value,
+    config: config.value,
+    availableChecks
+  });
+  if (!resolved.ok) return resolved;
+  const report2 = await runDiagnose(resolved.value, options.registry);
   if (!report2.ok) return report2;
   return {
     ok: true,
@@ -4458,6 +4591,7 @@ function sessionStoreRunner(probe) {
 // src/domains/diagnose/checks/spx-reachability.ts
 var SPX_REACHABILITY_VERDICT = {
   REACHABLE: "reachable",
+  PRESENT: "present",
   BELOW_FLOOR: "below-floor",
   UNREACHABLE: "unreachable",
   UNKNOWN: "unknown"
@@ -4508,9 +4642,10 @@ function meetsFloor(version2, floor) {
 }
 var REMEDIATION4 = {
   [SPX_REACHABILITY_VERDICT.REACHABLE]: "spx is on PATH at or above the required floor; no action needed.",
+  [SPX_REACHABILITY_VERDICT.PRESENT]: "spx is on PATH; no version floor is configured to compare against, so only presence is reported.",
   [SPX_REACHABILITY_VERDICT.BELOW_FLOOR]: "Update spx to at least the required floor (pnpm add -g @outcomeeng/spx).",
   [SPX_REACHABILITY_VERDICT.UNREACHABLE]: "Install spx and ensure it resolves on PATH (pnpm add -g @outcomeeng/spx).",
-  [SPX_REACHABILITY_VERDICT.UNKNOWN]: "Re-run diagnose; if it persists, verify the manifest carries a valid spx_floor, that spx is on PATH, and that spx --version reports a semver version."
+  [SPX_REACHABILITY_VERDICT.UNKNOWN]: "Re-run diagnose; if it persists, verify the configured or manifest-supplied spx_floor is a valid semver, that spx is on PATH, and that spx --version reports a semver version."
 };
 function record4(verdict, bucket, reading, floor) {
   return {
@@ -4526,12 +4661,15 @@ function record4(verdict, bucket, reading, floor) {
   };
 }
 function classifySpxReachability(reading, floor) {
-  if (reading.errored || floor === void 0) {
+  if (reading.errored) {
     return record4(SPX_REACHABILITY_VERDICT.UNKNOWN, VERDICT_BUCKET.UNKNOWN, reading, floor);
   }
   if (reading.resolvedPath === null) {
     return record4(SPX_REACHABILITY_VERDICT.UNREACHABLE, VERDICT_BUCKET.BROKEN, reading, floor);
   }
+  if (floor === void 0) {
+    return record4(SPX_REACHABILITY_VERDICT.PRESENT, VERDICT_BUCKET.HEALTHY, reading, floor);
+  }
   if (reading.version === null) {
     return record4(SPX_REACHABILITY_VERDICT.UNKNOWN, VERDICT_BUCKET.UNKNOWN, reading, floor);
   }
@@ -4639,7 +4777,7 @@ var DIAGNOSE_CLI = {
   COLOR_FLAG: "--color",
   NO_COLOR_FLAG: "--no-color"
 };
-var DIAGNOSE_DOMAIN_DESCRIPTION = "Run deterministic environment-diagnostics checks from a declarative manifest";
+var DIAGNOSE_DOMAIN_DESCRIPTION = "Run deterministic environment-diagnostics checks, resolving facts from spx.config or a --manifest";
 var DEFAULT_REGISTRY = {
   [CHECK_NAME.SPX_REACHABILITY]: spxReachabilityRunner(defaultSpxReachabilityProbe),
   [CHECK_NAME.SESSION_ENVIRONMENT]: sessionEnvironmentRunner(defaultSessionEnvironmentProbe),
@@ -4655,11 +4793,15 @@ var diagnoseDomain = {
   name: DIAGNOSE_CLI.COMMAND,
   description: DIAGNOSE_DOMAIN_DESCRIPTION,
   register: (program2) => {
-    program2.command(DIAGNOSE_CLI.COMMAND).description(DIAGNOSE_DOMAIN_DESCRIPTION).requiredOption(`${DIAGNOSE_CLI.MANIFEST_FLAG} <path>`, "Path to the declarative diagnose manifest").addOption(
+    program2.command(DIAGNOSE_CLI.COMMAND).description(DIAGNOSE_DOMAIN_DESCRIPTION).option(
+      `${DIAGNOSE_CLI.MANIFEST_FLAG} <path>`,
+      "Path to a declarative diagnose manifest that fully instruments the diagnosis"
+    ).addOption(
       new Option(`${DIAGNOSE_CLI.FORMAT_FLAG} <format>`, "Output format").choices([DIAGNOSE_FORMAT.TEXT, DIAGNOSE_FORMAT.JSON]).default(DIAGNOSE_FORMAT.TEXT)
     ).addOption(new Option(`${DIAGNOSE_CLI.COLOR_FLAG}`, "Force colored output")).addOption(new Option(`${DIAGNOSE_CLI.NO_COLOR_FLAG}`, "Disable colored output")).action(async (options) => {
       const result = await diagnoseCommand({
         manifestPath: options.manifest,
+        productDir: process.cwd(),
         format: options.format,
         color: resolveColorChoice({
           flag: options.color,
@@ -5159,6 +5301,84 @@ function createJournal(backend, identity) {
   };
 }
 
+// src/lib/github-snapshot-sink/gh-api-runner.ts
+import { execa as execa5 } from "execa";
+var GH_API = {
+  executable: "gh"
+};
+var runGhApi = async (args, options) => {
+  const result = await execa5(GH_API.executable, [...args], {
+    ...options?.input === void 0 ? {} : { input: options.input }
+  });
+  return { stdout: typeof result.stdout === "string" ? result.stdout : "" };
+};
+
+// src/lib/github-snapshot-sink/pull-request-comment-client.ts
+var GITHUB_API_ERROR = {
+  SURFACE_UNSUPPORTED: "the pull-request comment client supports only the pull-request comment surface"
+};
+var GITHUB_API = {
+  apiCommand: "api",
+  fieldFlag: "-f",
+  methodFlag: "-X",
+  paginateFlag: "--paginate",
+  slurpFlag: "--slurp",
+  postMethod: "POST",
+  patchMethod: "PATCH",
+  bodyField: "body"
+};
+function githubCommentMarkerTag(marker) {
+  return `<!-- ${marker} -->`;
+}
+function issueCommentsPath(repository, pullNumber) {
+  return `repos/${repository}/issues/${pullNumber}/comments`;
+}
+function issueCommentPath(repository, commentId) {
+  return `repos/${repository}/issues/comments/${commentId}`;
+}
+function createGithubPullRequestCommentClient(options) {
+  const { run } = options;
+  return {
+    async upsertPullRequestComment({ pullNumber, marker, body }) {
+      const markedBody = `${body}
+${githubCommentMarkerTag(marker)}`;
+      const listed = await run([
+        GITHUB_API.apiCommand,
+        issueCommentsPath(options.repository, pullNumber),
+        GITHUB_API.paginateFlag,
+        GITHUB_API.slurpFlag
+      ]);
+      const comments = JSON.parse(listed.stdout).flat();
+      const existing = comments.find((comment) => comment.body.includes(githubCommentMarkerTag(marker)));
+      if (existing === void 0) {
+        await run([
+          GITHUB_API.apiCommand,
+          issueCommentsPath(options.repository, pullNumber),
+          GITHUB_API.methodFlag,
+          GITHUB_API.postMethod,
+          GITHUB_API.fieldFlag,
+          `${GITHUB_API.bodyField}=${markedBody}`
+        ]);
+        return;
+      }
+      await run([
+        GITHUB_API.apiCommand,
+        issueCommentPath(options.repository, existing.id),
+        GITHUB_API.methodFlag,
+        GITHUB_API.patchMethod,
+        GITHUB_API.fieldFlag,
+        `${GITHUB_API.bodyField}=${markedBody}`
+      ]);
+    },
+    uploadActionsArtifact() {
+      return Promise.reject(new Error(GITHUB_API_ERROR.SURFACE_UNSUPPORTED));
+    },
+    saveActionsCache() {
+      return Promise.reject(new Error(GITHUB_API_ERROR.SURFACE_UNSUPPORTED));
+    }
+  };
+}
+
 // src/lib/github-snapshot-sink/index.ts
 var SNAPSHOT_SURFACE_KIND = {
   PULL_REQUEST_COMMENT: "pull-request-comment",
@@ -5369,7 +5589,7 @@ async function appendJournalEvent(ref, input, sink, options = {}) {
   try {
     event = await bound.value.journal.append(input);
   } catch (error) {
-    return { ok: false, error: `${JOURNAL_RUNTIME_ERROR.APPEND_FAILED}: ${toMessage2(error)}` };
+    return { ok: false, error: `${JOURNAL_RUNTIME_ERROR.APPEND_FAILED}: ${toMessage(error)}` };
   }
   try {
     await sink.emit(event);
@@ -5383,7 +5603,7 @@ async function readJournalEvents(ref, fromCursor, options = {}) {
   try {
     return { ok: true, value: await bound.value.journal.read(fromCursor) };
   } catch (error) {
-    return { ok: false, error: `${JOURNAL_RUNTIME_ERROR.READ_FAILED}: ${toMessage2(error)}` };
+    return { ok: false, error: `${JOURNAL_RUNTIME_ERROR.READ_FAILED}: ${toMessage(error)}` };
   }
 }
 async function sealJournalRun(ref, options = {}) {
@@ -5393,7 +5613,7 @@ async function sealJournalRun(ref, options = {}) {
     await bound.value.journal.seal();
     return { ok: true, value: void 0 };
   } catch (error) {
-    return { ok: false, error: `${JOURNAL_RUNTIME_ERROR.SEAL_FAILED}: ${toMessage2(error)}` };
+    return { ok: false, error: `${JOURNAL_RUNTIME_ERROR.SEAL_FAILED}: ${toMessage(error)}` };
   }
 }
 async function renderJournalRun(ref, projection, options = {}) {
@@ -5402,12 +5622,9 @@ async function renderJournalRun(ref, projection, options = {}) {
   try {
     return { ok: true, value: await bound.value.journal.render(projection) };
   } catch (error) {
-    return { ok: false, error: `${JOURNAL_RUNTIME_ERROR.RENDER_FAILED}: ${toMessage2(error)}` };
+    return { ok: false, error: `${JOURNAL_RUNTIME_ERROR.RENDER_FAILED}: ${toMessage(error)}` };
   }
 }
-function toMessage2(error) {
-  return error instanceof Error ? error.message : String(error);
-}
 
 // src/commands/journal/cli.ts
 var JOURNAL_CLI_EXIT_CODE = {
@@ -5600,80 +5817,6 @@ async function journalRenderCommand(scope2, deps = {}) {
   return okResult(JSON.stringify(rendered.value));
 }
 
-// src/commands/journal/github-client.ts
-import { execa as execa5 } from "execa";
-var GITHUB_CLI_ERROR = {
-  SURFACE_UNSUPPORTED: "the pull-request comment client supports only the pull-request comment surface"
-};
-var GITHUB_CLI = {
-  executable: "gh",
-  apiCommand: "api",
-  fieldFlag: "-f",
-  methodFlag: "-X",
-  paginateFlag: "--paginate",
-  slurpFlag: "--slurp",
-  postMethod: "POST",
-  patchMethod: "PATCH",
-  bodyField: "body"
-};
-var defaultGhRunner = async (args, options) => {
-  const result = await execa5(GITHUB_CLI.executable, [...args], {
-    ...options?.input === void 0 ? {} : { input: options.input }
-  });
-  return { stdout: typeof result.stdout === "string" ? result.stdout : "" };
-};
-function githubCommentMarkerTag(marker) {
-  return `<!-- ${marker} -->`;
-}
-function issueCommentsPath(repository, pullNumber) {
-  return `repos/${repository}/issues/${pullNumber}/comments`;
-}
-function issueCommentPath(repository, commentId) {
-  return `repos/${repository}/issues/comments/${commentId}`;
-}
-function createGithubPrCommentClient(options) {
-  const run = options.run ?? defaultGhRunner;
-  return {
-    async upsertPullRequestComment({ pullNumber, marker, body }) {
-      const markedBody = `${body}
-${githubCommentMarkerTag(marker)}`;
-      const listed = await run([
-        GITHUB_CLI.apiCommand,
-        issueCommentsPath(options.repository, pullNumber),
-        GITHUB_CLI.paginateFlag,
-        GITHUB_CLI.slurpFlag
-      ]);
-      const comments = JSON.parse(listed.stdout).flat();
-      const existing = comments.find((comment) => comment.body.includes(githubCommentMarkerTag(marker)));
-      if (existing === void 0) {
-        await run([
-          GITHUB_CLI.apiCommand,
-          issueCommentsPath(options.repository, pullNumber),
-          GITHUB_CLI.methodFlag,
-          GITHUB_CLI.postMethod,
-          GITHUB_CLI.fieldFlag,
-          `${GITHUB_CLI.bodyField}=${markedBody}`
-        ]);
-        return;
-      }
-      await run([
-        GITHUB_CLI.apiCommand,
-        issueCommentPath(options.repository, existing.id),
-        GITHUB_CLI.methodFlag,
-        GITHUB_CLI.patchMethod,
-        GITHUB_CLI.fieldFlag,
-        `${GITHUB_CLI.bodyField}=${markedBody}`
-      ]);
-    },
-    uploadActionsArtifact() {
-      return Promise.reject(new Error(GITHUB_CLI_ERROR.SURFACE_UNSUPPORTED));
-    },
-    saveActionsCache() {
-      return Promise.reject(new Error(GITHUB_CLI_ERROR.SURFACE_UNSUPPORTED));
-    }
-  };
-}
-
 // src/lib/process-lifecycle/exit-codes.ts
 var SIGINT_EXIT_CODE = 130;
 var SIGTERM_EXIT_CODE = 143;
@@ -5913,7 +6056,7 @@ function streamBinding() {
   const repository = process.env[JOURNAL_CLI_ENV.GITHUB_REPOSITORY] ?? "";
   return {
     localSink: stdoutStreamSink(),
-    githubClient: createGithubPrCommentClient({ repository }),
+    githubClient: createGithubPullRequestCommentClient({ repository, run: runGhApi }),
     githubRepository: repository
   };
 }
@@ -9954,8 +10097,9 @@ function createTestingDomain(deps = defaultTestingCliDependencies) {
 }
 var testingDomain = createTestingDomain();
 
-// src/commands/validation/markdown.ts
-import { relative as relative3 } from "path";
+// src/commands/validation/formatting.ts
+import { existsSync } from "fs";
+import { isAbsolute as isAbsolute3, join as join24, relative as relative3 } from "path";
 
 // src/validation/config/path-filter.ts
 import { isAbsolute as isAbsolute2, relative as relative2 } from "path";
@@ -10052,9 +10196,180 @@ function applyValidationPathFilterToScope(scopeConfig, filter) {
   };
 }
 
+// src/validation/steps/subprocess-output.ts
+var VALIDATION_SUBPROCESS_EVENTS = {
+  CLOSE: "close",
+  DATA: "data",
+  DRAIN: "drain",
+  ERROR: "error"
+};
+var defaultValidationSubprocessOutputStreams = {
+  stdout: process.stdout,
+  stderr: process.stderr
+};
+function forwardValidationSubprocessOutput(child, streams = defaultValidationSubprocessOutputStreams) {
+  child.stdout?.on(VALIDATION_SUBPROCESS_EVENTS.DATA, (chunk) => {
+    forwardChunkWithBackpressure(child.stdout, streams.stdout, chunk);
+  });
+  child.stderr?.on(VALIDATION_SUBPROCESS_EVENTS.DATA, (chunk) => {
+    forwardChunkWithBackpressure(child.stderr, streams.stderr, chunk);
+  });
+}
+function forwardChunkWithBackpressure(source, stream, chunk) {
+  const ready = stream.write(chunk);
+  if (ready || stream.once === void 0 || source === null || source === void 0) {
+    return;
+  }
+  source.pause();
+  stream.once(VALIDATION_SUBPROCESS_EVENTS.DRAIN, () => {
+    source.resume();
+  });
+}
+
+// src/validation/steps/formatting.ts
+var DPRINT_COMMAND = "dprint";
+var DPRINT_CHECK_SUBCOMMAND = "check";
+var DPRINT_CONFIG_FILENAME = "dprint.jsonc";
+var defaultFormattingProcessRunner = lifecycleProcessRunner;
+function buildDprintCheckArgs(options) {
+  return [DPRINT_CHECK_SUBCOMMAND, ...options.files ?? []];
+}
+async function validateFormatting(context, runner = defaultFormattingProcessRunner) {
+  const args = buildDprintCheckArgs({ files: context.files });
+  return new Promise((resolve8) => {
+    const child = spawnManagedSubprocess(runner, DPRINT_COMMAND, args, { cwd: context.projectRoot });
+    const chunks = [];
+    const capture = (chunk) => {
+      chunks.push(typeof chunk === "string" ? chunk : Buffer.from(chunk).toString());
+    };
+    child.stdout?.on(VALIDATION_SUBPROCESS_EVENTS.DATA, capture);
+    child.stderr?.on(VALIDATION_SUBPROCESS_EVENTS.DATA, capture);
+    child.on(VALIDATION_SUBPROCESS_EVENTS.CLOSE, (code) => {
+      resolve8({ success: code === 0, output: chunks.join("") });
+    });
+    child.on(VALIDATION_SUBPROCESS_EVENTS.ERROR, (error) => {
+      resolve8({ success: false, output: chunks.join(""), error: error.message });
+    });
+  });
+}
+
+// src/commands/validation/messages.ts
+var VALIDATION_STAGE_DISPLAY_NAMES = {
+  CIRCULAR: "dependency-cruiser",
+  KNIP: "Knip",
+  ESLINT: "ESLint",
+  TYPESCRIPT: "TypeScript",
+  MARKDOWN: "Markdown",
+  LITERAL: "Literal",
+  FORMATTING: "Formatting"
+};
+var VALIDATION_SKIP_LABELS = {
+  VERB: "Skipping",
+  CIRCULAR_REASON: "skip-circular",
+  LITERAL_REASON: "skip-literal",
+  DISABLED_BY_PREFIX: "disabled by",
+  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}: circular dependencies found`,
+  CIRCULAR_NONE_FOUND: `${VALIDATION_STAGE_DISPLAY_NAMES.CIRCULAR}: \u2713 No circular dependencies found`,
+  KNIP_CONFIG_ERROR: `${VALIDATION_STAGE_DISPLAY_NAMES.KNIP}: \u2717 config error`,
+  KNIP_DISABLED: `${VALIDATION_STAGE_DISPLAY_NAMES.KNIP}: skipped (${VALIDATION_SKIP_LABELS.DISABLED_BY_PREFIX} 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",
+  FORMATTING_NO_ISSUES: `${VALIDATION_STAGE_DISPLAY_NAMES.FORMATTING}: \u2713 No formatting issues found`,
+  FORMATTING_FAILURE_SUMMARY: `${VALIDATION_STAGE_DISPLAY_NAMES.FORMATTING}: unformatted files found`
+};
+var CIRCULAR_SKIP_OUTPUT = `${VALIDATION_STAGE_DISPLAY_NAMES.CIRCULAR}: skipped (--${VALIDATION_SKIP_LABELS.CIRCULAR_REASON})`;
+var CIRCULAR_SKIP_JSON_OUTPUT = JSON.stringify({
+  skipped: true,
+  reason: VALIDATION_SKIP_LABELS.CIRCULAR_REASON
+});
+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/formatting.ts
+var FORMATTING_COMMAND_OUTPUT = {
+  NO_ISSUES: VALIDATION_COMMAND_OUTPUT.FORMATTING_NO_ISSUES,
+  FAILURE_SUMMARY: VALIDATION_COMMAND_OUTPUT.FORMATTING_FAILURE_SUMMARY,
+  EMPTY_SCOPE_REASON: "no files in scope",
+  NO_CONFIG_SKIP_REASON: `no ${DPRINT_CONFIG_FILENAME} at product root`
+};
+var FORMATTING_CONFIG_ERROR_MESSAGE = `${VALIDATION_STAGE_DISPLAY_NAMES.FORMATTING}: \u2717 config error`;
+async function formattingCommand(options) {
+  const { cwd, files, quiet } = options;
+  const startTime = Date.now();
+  const loaded = await resolveConfig(cwd, [validationConfigDescriptor]);
+  if (!loaded.ok) {
+    return {
+      exitCode: 1,
+      output: `${FORMATTING_CONFIG_ERROR_MESSAGE} \u2014 ${loaded.error}`,
+      durationMs: Date.now() - startTime
+    };
+  }
+  const validationConfig = loaded.value[validationConfigDescriptor.section];
+  if (!existsSync(join24(cwd, DPRINT_CONFIG_FILENAME))) {
+    const output2 = quiet ? "" : `${VALIDATION_STAGE_DISPLAY_NAMES.FORMATTING}: skipped (${FORMATTING_COMMAND_OUTPUT.NO_CONFIG_SKIP_REASON})`;
+    return { exitCode: 0, output: output2, durationMs: Date.now() - startTime };
+  }
+  const pathFilter = validationPathFilterForTool(
+    validationConfig.paths,
+    VALIDATION_PATH_TOOL_SUBSECTIONS.FORMATTING
+  );
+  const hasExplicitScope = files !== void 0 && files.length > 0;
+  const scopedFiles = hasExplicitScope ? files.map((filePath) => isAbsolute3(filePath) ? relative3(cwd, filePath) : filePath).filter((relativePath) => pathPassesValidationFilter(relativePath, pathFilter)) : void 0;
+  if (hasExplicitScope && (scopedFiles === void 0 || scopedFiles.length === 0)) {
+    const output2 = quiet ? "" : `${VALIDATION_STAGE_DISPLAY_NAMES.FORMATTING}: skipped (${FORMATTING_COMMAND_OUTPUT.EMPTY_SCOPE_REASON})`;
+    return { exitCode: 0, output: output2, durationMs: Date.now() - startTime };
+  }
+  const result = await validateFormatting({ projectRoot: cwd, files: scopedFiles });
+  const durationMs = Date.now() - startTime;
+  if (result.success) {
+    return { exitCode: 0, output: quiet ? "" : FORMATTING_COMMAND_OUTPUT.NO_ISSUES, durationMs };
+  }
+  const detail = result.error ?? result.output;
+  const output = [FORMATTING_COMMAND_OUTPUT.FAILURE_SUMMARY, detail].filter((line) => line.length > 0).join("\n");
+  return { exitCode: 1, output, durationMs };
+}
+
+// src/validation/languages/formatting.ts
+var FORMATTING_LANGUAGE_NAME = "formatting";
+var formattingValidationLanguage = {
+  name: FORMATTING_LANGUAGE_NAME,
+  stages: [
+    {
+      name: VALIDATION_STAGE_DISPLAY_NAMES.FORMATTING,
+      failsPipeline: true,
+      run: (context) => formattingCommand({ cwd: context.cwd, files: context.files, quiet: context.quiet })
+    }
+  ]
+};
+
+// src/commands/validation/markdown.ts
+import { relative as relative4 } from "path";
+
 // src/validation/steps/markdown.ts
-import { existsSync, statSync } from "fs";
-import { basename as basename4, dirname as dirname8, join as join24, relative as pathRelative } from "path";
+import { existsSync as existsSync2, statSync } from "fs";
+import { basename as basename4, dirname as dirname8, join as join25, 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"];
@@ -10093,7 +10408,7 @@ function buildMarkdownlintConfig(directoryName) {
   };
 }
 function getDefaultDirectories(projectRoot) {
-  return MARKDOWN_DEFAULT_DIRECTORY_NAMES.map((name) => join24(projectRoot, name)).filter((dir) => existsSync(dir));
+  return MARKDOWN_DEFAULT_DIRECTORY_NAMES.map((name) => join25(projectRoot, name)).filter((dir) => existsSync2(dir));
 }
 function resolveMarkdownValidationTarget(path7, deps = defaultMarkdownValidationTargetDeps) {
   if (isExistingDirectory(path7, deps)) {
@@ -10176,7 +10491,7 @@ async function validateTarget(target, config, projectRoot, ignoreGlobs = []) {
       if (parsed) {
         errors.push({
           ...parsed,
-          file: join24(directory, parsed.file)
+          file: join25(directory, parsed.file)
         });
       }
     }
@@ -10215,57 +10530,6 @@ function markdownlintConfigDirectoryName(directory, projectRoot) {
   return basename4(directory);
 }
 
-// src/commands/validation/messages.ts
-var VALIDATION_STAGE_DISPLAY_NAMES = {
-  CIRCULAR: "dependency-cruiser",
-  KNIP: "Knip",
-  ESLINT: "ESLint",
-  TYPESCRIPT: "TypeScript",
-  MARKDOWN: "Markdown",
-  LITERAL: "Literal"
-};
-var VALIDATION_SKIP_LABELS = {
-  VERB: "Skipping",
-  CIRCULAR_REASON: "skip-circular",
-  LITERAL_REASON: "skip-literal",
-  DISABLED_BY_PREFIX: "disabled by",
-  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}: circular dependencies found`,
-  CIRCULAR_NONE_FOUND: `${VALIDATION_STAGE_DISPLAY_NAMES.CIRCULAR}: \u2713 No circular dependencies found`,
-  KNIP_CONFIG_ERROR: `${VALIDATION_STAGE_DISPLAY_NAMES.KNIP}: \u2717 config error`,
-  KNIP_DISABLED: `${VALIDATION_STAGE_DISPLAY_NAMES.KNIP}: skipped (${VALIDATION_SKIP_LABELS.DISABLED_BY_PREFIX} 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 CIRCULAR_SKIP_OUTPUT = `${VALIDATION_STAGE_DISPLAY_NAMES.CIRCULAR}: skipped (--${VALIDATION_SKIP_LABELS.CIRCULAR_REASON})`;
-var CIRCULAR_SKIP_JSON_OUTPUT = JSON.stringify({
-  skipped: true,
-  reason: VALIDATION_SKIP_LABELS.CIRCULAR_REASON
-});
-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,
@@ -10295,7 +10559,7 @@ async function markdownCommand(options) {
     path: path7
   }));
   const targets = unfilteredTargets.filter(
-    (target) => pathPassesValidationFilter(relative3(cwd, target.path), pathFilter)
+    (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);
@@ -11204,8 +11468,8 @@ var ParseErrorCode;
 })(ParseErrorCode || (ParseErrorCode = {}));
 
 // src/validation/config/scope.ts
-import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync3 } from "fs";
-import { isAbsolute as isAbsolute3, join as join25, relative as relative4, resolve as resolve6 } from "path";
+import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync3 } from "fs";
+import { isAbsolute as isAbsolute4, join as join26, relative as relative5, resolve as resolve6 } from "path";
 var TSCONFIG_FILES = {
   full: "tsconfig.json",
   production: "tsconfig.production.json"
@@ -11234,7 +11498,7 @@ var TYPESCRIPT_FALLBACK_INCLUDE_PATTERNS = [
 var TEMPORARY_TSCONFIG_PARENT_SEGMENTS = ["node_modules", ".cache", "spx"];
 var defaultScopeDeps = {
   readFileSync: readFileSync3,
-  existsSync: existsSync2,
+  existsSync: existsSync3,
   readdirSync
 };
 var EXPLICIT_TYPESCRIPT_SCOPE_TARGET_KIND = {
@@ -11242,7 +11506,7 @@ var EXPLICIT_TYPESCRIPT_SCOPE_TARGET_KIND = {
   FILE: "file"
 };
 function resolveProjectPath(projectRoot, path7) {
-  return isAbsolute3(path7) ? path7 : join25(projectRoot, path7);
+  return isAbsolute4(path7) ? path7 : join26(projectRoot, path7);
 }
 function parseTypeScriptConfig(configPath, deps = defaultScopeDeps) {
   try {
@@ -11281,12 +11545,12 @@ function hasTypeScriptFilesRecursive(dirPath, maxDepth = 2, deps = defaultScopeD
   try {
     const items = deps.readdirSync(dirPath, { withFileTypes: true });
     const hasDirectTsFiles = items.some(
-      (item) => item.isFile() && pathHasTypeScriptSourceExtension(item.name) && pathPassesTypeScriptFileDiscoveryExcludes(join25(dirPath, item.name), options)
+      (item) => item.isFile() && pathHasTypeScriptSourceExtension(item.name) && pathPassesTypeScriptFileDiscoveryExcludes(join26(dirPath, item.name), options)
     );
     if (hasDirectTsFiles) return true;
     const subdirs = items.filter((item) => item.isDirectory() && !item.name.startsWith("."));
     for (const subdir of subdirs.slice(0, 5)) {
-      if (hasTypeScriptFilesRecursive(join25(dirPath, subdir.name), maxDepth - 1, deps, options)) {
+      if (hasTypeScriptFilesRecursive(join26(dirPath, subdir.name), maxDepth - 1, deps, options)) {
         return true;
       }
     }
@@ -11323,7 +11587,7 @@ function directoryContributesTypeScriptScope(dir, config, projectRoot, deps) {
     return false;
   }
   try {
-    return hasTypeScriptFilesRecursive(join25(projectRoot, dir), 2, deps, {
+    return hasTypeScriptFilesRecursive(join26(projectRoot, dir), 2, deps, {
       excludePatterns: config.exclude,
       projectRoot
     });
@@ -11552,13 +11816,13 @@ function normalizeActiveIncludePattern(pattern, projectRoot, deps) {
 function filterActiveIncludePatterns(patterns, excludePatterns, projectRoot, deps) {
   return patterns.map((pattern) => normalizeActiveIncludePattern(pattern, projectRoot, deps)).filter((pattern) => typeScriptScopePatternTargetsTypeScriptSource(pattern)).filter((pattern) => {
     const topLevelDir = getLiteralTopLevelPatternDirectory(pattern);
-    return topLevelDir === null || deps.existsSync(join25(projectRoot, topLevelDir));
+    return topLevelDir === null || deps.existsSync(join26(projectRoot, topLevelDir));
   }).filter((pattern) => pathPassesValidationFilter(pattern, { exclude: excludePatterns }));
 }
 function getValidationDirectories(scope2, projectRoot, deps = defaultScopeDeps) {
   const config = resolveTypeScriptConfig(scope2, projectRoot, deps);
   const configDirectories = getTopLevelDirectoriesWithTypeScript(config, projectRoot, deps);
-  const existingDirectories = configDirectories.filter((dir) => deps.existsSync(join25(projectRoot, dir)));
+  const existingDirectories = configDirectories.filter((dir) => deps.existsSync(join26(projectRoot, dir)));
   return existingDirectories;
 }
 function getTypeScriptScope(scope2, projectRoot, deps = defaultScopeDeps) {
@@ -11579,14 +11843,14 @@ function pathPassesTypeScriptScope(path7, scopeConfig) {
   return included && !excluded;
 }
 function pathStaysInsideTypeScriptScopeRoot(projectRoot, path7) {
-  const resolvedPath = isAbsolute3(path7) ? resolve6(path7) : resolve6(projectRoot, path7);
-  const relativePath = relative4(projectRoot, resolvedPath);
+  const resolvedPath = isAbsolute4(path7) ? resolve6(path7) : resolve6(projectRoot, path7);
+  const relativePath = relative5(projectRoot, resolvedPath);
   const segments = normalizeTypeScriptScopePath(relativePath).split(PATH_SEGMENT_SEPARATOR3);
-  return relativePath.length === 0 || !segments.includes("..") && !isAbsolute3(relativePath);
+  return relativePath.length === 0 || !segments.includes("..") && !isAbsolute4(relativePath);
 }
 function toProjectRelativeTypeScriptScopePath(projectRoot, path7) {
-  const resolvedPath = isAbsolute3(path7) ? resolve6(path7) : resolve6(projectRoot, path7);
-  const relativePath = relative4(projectRoot, resolvedPath);
+  const resolvedPath = isAbsolute4(path7) ? resolve6(path7) : resolve6(projectRoot, path7);
+  const relativePath = relative5(projectRoot, resolvedPath);
   return relativePath.length === 0 ? TYPESCRIPT_SCOPE_PROJECT_ROOT : normalizeTypeScriptScopePath(relativePath);
 }
 function toExplicitTypeScriptScopeTarget(projectRoot, originalPath, deps = defaultScopeDeps) {
@@ -11625,10 +11889,10 @@ function explicitTypeScriptScopeTargetPassesScope(target, scopeConfig) {
   if (typeScriptSourcePatterns.length > 0) {
     return typeScriptSourcePatterns.some((pattern) => typeScriptScopePatternIntersectsDirectory(pattern, target.path));
   }
-  return pathPassesTypeScriptScope(join25(target.path, TYPESCRIPT_SCOPE_DIRECTORY_PROBE_FILENAME), scopeConfig);
+  return pathPassesTypeScriptScope(join26(target.path, TYPESCRIPT_SCOPE_DIRECTORY_PROBE_FILENAME), scopeConfig);
 }
 function directoryPassesTypeScriptExcludes(directory, scopeConfig) {
-  const probePath = join25(directory, TYPESCRIPT_SCOPE_DIRECTORY_PROBE_FILENAME);
+  const probePath = join26(directory, TYPESCRIPT_SCOPE_DIRECTORY_PROBE_FILENAME);
   return !scopeConfig.excludePatterns.some(
     (pattern) => typeScriptScopePatternCoversDirectorySourceSet(pattern, directory) || pathMatchesTypeScriptPattern(probePath, pattern)
   );
@@ -11819,10 +12083,10 @@ function resolvedModulePath(resolvedPath) {
     return resolvedPath;
   }
 }
-function nearestPackageRoot(filePath, existsSync7) {
+function nearestPackageRoot(filePath, existsSync8) {
   let currentDirectory = path6.dirname(filePath);
   while (true) {
-    if (existsSync7(path6.join(currentDirectory, PACKAGE_MANIFEST_FILENAME))) {
+    if (existsSync8(path6.join(currentDirectory, PACKAGE_MANIFEST_FILENAME))) {
       return currentDirectory;
     }
     const parentDirectory = path6.dirname(currentDirectory);
@@ -11832,9 +12096,9 @@ function nearestPackageRoot(filePath, existsSync7) {
     currentDirectory = parentDirectory;
   }
 }
-function bundledToolPath(resolvedPath, existsSync7) {
+function bundledToolPath(resolvedPath, existsSync8) {
   const bundledFilePath = resolvedModulePath(resolvedPath);
-  return nearestPackageRoot(bundledFilePath, existsSync7) ?? path6.dirname(bundledFilePath);
+  return nearestPackageRoot(bundledFilePath, existsSync8) ?? path6.dirname(bundledFilePath);
 }
 async function discoverTool(tool, options = {}) {
   const { projectRoot = process.cwd(), deps = defaultToolDiscoveryDeps } = options;
@@ -11891,7 +12155,7 @@ import {
   cruise as dependencyCruiser
 } from "dependency-cruiser";
 import extractTypeScriptConfig from "dependency-cruiser/config-utl/extract-ts-config";
-import { join as join26 } from "path";
+import { join as join27 } from "path";
 var DEPENDENCY_CRUISER_MODULE_SYSTEMS = ["es6", "cjs"];
 var DEPENDENCY_CRUISER_TYPESCRIPT_SOURCE_GLOB_SUFFIXES = [...TYPESCRIPT_FALLBACK_INCLUDE_PATTERNS];
 var DEPENDENCY_CRUISER_TYPESCRIPT_SOURCE_PATTERN = String.raw`(?<!\.d)\.(?:[cm]?ts|tsx)$`;
@@ -12131,7 +12395,7 @@ async function validateCircularDependencies(scope2, typescriptScope, projectRoot
     if (analyzeSourcePatterns.length === 0) {
       return { success: true };
     }
-    const tsConfigFile = join26(projectRoot, TSCONFIG_FILES[scope2]);
+    const tsConfigFile = join27(projectRoot, TSCONFIG_FILES[scope2]);
     const result = await deps.dependencyCruiser(
       analyzeSourcePatterns,
       buildDependencyCruiserOptions(typescriptScope, projectRoot, tsConfigFile),
@@ -12251,9 +12515,9 @@ async function circularCommand(options, deps = defaultCircularCommandDeps) {
 }
 
 // src/validation/steps/knip.ts
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync4 } from "fs";
 import { mkdir as mkdir5, mkdtemp as mkdtemp2, rm, writeFile as writeFile3 } from "fs/promises";
-import { isAbsolute as isAbsolute4, join as join27 } from "path";
+import { isAbsolute as isAbsolute5, join as join28 } from "path";
 var defaultKnipProcessRunner = lifecycleProcessRunner;
 var KNIP_COMMAND_TOKENS = {
   COMMAND: "knip",
@@ -12262,7 +12526,7 @@ var KNIP_COMMAND_TOKENS = {
   USE_TSCONFIG_FILES_FLAG: "--use-tsconfig-files"
 };
 var defaultKnipDeps = {
-  existsSync: existsSync3,
+  existsSync: existsSync4,
   mkdir: mkdir5,
   mkdtemp: mkdtemp2,
   rm,
@@ -12286,7 +12550,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 = join27(projectRoot, "node_modules", ".bin", "knip");
+  const localBin = join28(projectRoot, "node_modules", ".bin", "knip");
   const binary = deps.existsSync(localBin) ? localBin : KNIP_COMMAND_TOKENS.NPX_COMMAND;
   const baseArgs = scopedTsconfig === void 0 ? [] : [
     KNIP_COMMAND_TOKENS.USE_TSCONFIG_FILES_FLAG,
@@ -12341,11 +12605,11 @@ async function runKnipSubprocess(projectRoot, typescriptScope, runner, deps) {
   });
 }
 async function createScopedKnipTsconfig(projectRoot, typescriptScope, deps) {
-  const tempParentDir = join27(projectRoot, ...TEMPORARY_TSCONFIG_PARENT_SEGMENTS);
+  const tempParentDir = join28(projectRoot, ...TEMPORARY_TSCONFIG_PARENT_SEGMENTS);
   await deps.mkdir(tempParentDir, { recursive: true });
-  const tempDir = await deps.mkdtemp(join27(tempParentDir, "validate-knip-"));
-  const configPath = join27(tempDir, TSCONFIG_FILES.full);
-  const toProjectPathPattern = (pattern) => isAbsolute4(pattern) ? pattern : join27(projectRoot, pattern);
+  const tempDir = await deps.mkdtemp(join28(tempParentDir, "validate-knip-"));
+  const configPath = join28(tempDir, TSCONFIG_FILES.full);
+  const toProjectPathPattern = (pattern) => isAbsolute5(pattern) ? pattern : join28(projectRoot, pattern);
   const project = [
     ...typescriptScope.directories.flatMap(
       (directory) => TYPESCRIPT_FALLBACK_INCLUDE_PATTERNS.map((pattern) => `${directory}/${pattern}`)
@@ -12353,7 +12617,7 @@ async function createScopedKnipTsconfig(projectRoot, typescriptScope, deps) {
     ...typescriptScope.filePatterns
   ];
   const config = {
-    extends: join27(projectRoot, TSCONFIG_FILES.full),
+    extends: join28(projectRoot, TSCONFIG_FILES.full),
     include: project.map(toProjectPathPattern),
     exclude: typescriptScope.excludePatterns.map(toProjectPathPattern)
   };
@@ -12419,13 +12683,13 @@ async function knipCommand(options, deps = defaultKnipCommandDeps) {
 }
 
 // src/validation/steps/eslint.ts
-import { existsSync as existsSync5 } from "fs";
-import { join as join29 } from "path";
+import { existsSync as existsSync6 } from "fs";
+import { join as join30 } from "path";
 
 // src/validation/lint-policy.ts
 import { execFileSync } from "child_process";
-import { existsSync as existsSync4, readdirSync as readdirSync2, readFileSync as readFileSync4, statSync as statSync2 } from "fs";
-import { join as join28 } from "path";
+import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync4, statSync as statSync2 } from "fs";
+import { join as join29 } from "path";
 
 // src/validation/lint-policy-constants.ts
 var LINT_POLICY_MANIFESTS = {
@@ -12471,19 +12735,19 @@ var BASE_BRANCH_REFS = [LINT_POLICY_BASE_REFS.REMOTE_MAIN, LINT_POLICY_BASE_REFS
 function isSpecTreeNodePath(entry) {
   return NODE_SUFFIXES.some((suffix) => entry.endsWith(suffix));
 }
-function readManifest(productDir, file, key) {
+function readManifest2(productDir, file, key) {
   return parseLintPolicyManifest(
-    readFileSync4(join28(productDir, file), "utf-8"),
+    readFileSync4(join29(productDir, file), "utf-8"),
     file,
     key
   );
 }
 function manifestExists(productDir, file) {
-  return existsSync4(join28(productDir, file));
+  return existsSync5(join29(productDir, file));
 }
 function findDeprecatedSpecNodePath(productDir) {
   function visit2(relativeDirectory) {
-    const absoluteDirectory = join28(productDir, relativeDirectory);
+    const absoluteDirectory = join29(productDir, relativeDirectory);
     for (const entry of readdirSync2(absoluteDirectory, { withFileTypes: true })) {
       if (!entry.isDirectory()) {
         continue;
@@ -12499,8 +12763,8 @@ function findDeprecatedSpecNodePath(productDir) {
     }
     return void 0;
   }
-  const specTreeRootPath = join28(productDir, SPEC_TREE_ROOT);
-  if (!existsSync4(specTreeRootPath)) {
+  const specTreeRootPath = join29(productDir, SPEC_TREE_ROOT);
+  if (!existsSync5(specTreeRootPath)) {
     return void 0;
   }
   return visit2(SPEC_TREE_ROOT);
@@ -12525,8 +12789,8 @@ function assertManifestEntries(productDir, file, entries, suffixPredicate, suffi
     if (!suffixPredicate(entry)) {
       throw new Error(`${file} entry must ${suffixDescription}: ${entry}`);
     }
-    const absoluteEntry = join28(productDir, entry);
-    if (!existsSync4(absoluteEntry) || !statSync2(absoluteEntry).isDirectory()) {
+    const absoluteEntry = join29(productDir, entry);
+    if (!existsSync5(absoluteEntry) || !statSync2(absoluteEntry).isDirectory()) {
       throw new Error(`${file} entry does not exist as a directory: ${entry}`);
     }
   }
@@ -12658,11 +12922,11 @@ function validateLintPolicy(productDir) {
     }
     validateTestLintDebtNodeManifest(
       productDir,
-      readManifest(productDir, TEST_LINT_DEBT_NODE_MANIFEST_FILE, TEST_LINT_DEBT_NODE_MANIFEST_KEY)
+      readManifest2(productDir, TEST_LINT_DEBT_NODE_MANIFEST_FILE, TEST_LINT_DEBT_NODE_MANIFEST_KEY)
     );
     validateTestOwnedConstantDebtNodeManifest(
       productDir,
-      readManifest(
+      readManifest2(
         productDir,
         TEST_OWNED_CONSTANT_DEBT_NODE_MANIFEST_FILE,
         TEST_OWNED_CONSTANT_DEBT_NODE_MANIFEST_KEY
@@ -12674,36 +12938,6 @@ function validateLintPolicy(productDir) {
   }
 }
 
-// src/validation/steps/subprocess-output.ts
-var VALIDATION_SUBPROCESS_EVENTS = {
-  CLOSE: "close",
-  DATA: "data",
-  DRAIN: "drain",
-  ERROR: "error"
-};
-var defaultValidationSubprocessOutputStreams = {
-  stdout: process.stdout,
-  stderr: process.stderr
-};
-function forwardValidationSubprocessOutput(child, streams = defaultValidationSubprocessOutputStreams) {
-  child.stdout?.on(VALIDATION_SUBPROCESS_EVENTS.DATA, (chunk) => {
-    forwardChunkWithBackpressure(child.stdout, streams.stdout, chunk);
-  });
-  child.stderr?.on(VALIDATION_SUBPROCESS_EVENTS.DATA, (chunk) => {
-    forwardChunkWithBackpressure(child.stderr, streams.stderr, chunk);
-  });
-}
-function forwardChunkWithBackpressure(source, stream, chunk) {
-  const ready = stream.write(chunk);
-  if (ready || stream.once === void 0 || source === null || source === void 0) {
-    return;
-  }
-  source.pause();
-  stream.once(VALIDATION_SUBPROCESS_EVENTS.DRAIN, () => {
-    source.resume();
-  });
-}
-
 // src/validation/steps/eslint.ts
 var defaultEslintProcessRunner = lifecycleProcessRunner;
 var DEFAULT_ESLINT_CONFIG_FILE = "eslint.config.ts";
@@ -12771,8 +13005,8 @@ async function validateESLint(context, runner = defaultEslintProcessRunner, outp
     scopeConfig: context.scopeConfig
   });
   return new Promise((resolve8) => {
-    const localBin = join29(projectRoot, ...ESLINT_LOCAL_BIN_SEGMENTS);
-    const binary = existsSync5(localBin) ? localBin : "npx";
+    const localBin = join30(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
@@ -12873,7 +13107,7 @@ async function lintCommand(options) {
 
 // src/validation/literal/index.ts
 import { readFile as readFile9 } from "fs/promises";
-import { isAbsolute as isAbsolute5, relative as relative6, resolve as resolve7 } from "path";
+import { isAbsolute as isAbsolute6, relative as relative7, resolve as resolve7 } from "path";
 
 // src/lib/file-inclusion/predicates/ignore-source.ts
 var IGNORE_SOURCE_LAYER = "ignore-source";
@@ -12908,7 +13142,7 @@ var ignoreSourceLayer = makeLayer(
 
 // src/lib/file-inclusion/pipeline.ts
 import { readdir as readdir7 } from "fs/promises";
-import { join as join30, relative as relative5, sep as sep2 } from "path";
+import { join as join31, relative as relative6, sep as sep2 } from "path";
 var EXPLICIT_OVERRIDE_LAYER = "explicit-override";
 function isNodeError3(err) {
   return err instanceof Error && "code" in err;
@@ -12926,11 +13160,11 @@ async function collectPaths(absoluteDir, projectRoot, result, artifactDirs) {
   for (const entry of dirEntries) {
     if (entry.isDirectory()) {
       if (artifactDirs.has(entry.name)) continue;
-      const absolutePath = join30(absoluteDir, entry.name);
+      const absolutePath = join31(absoluteDir, entry.name);
       await collectPaths(absolutePath, projectRoot, result, artifactDirs);
     } else if (entry.isFile()) {
-      const absolutePath = join30(absoluteDir, entry.name);
-      const rel = relative5(projectRoot, absolutePath);
+      const absolutePath = join31(absoluteDir, entry.name);
+      const rel = relative6(projectRoot, absolutePath);
       result.push(sep2 === "/" ? rel : rel.split(sep2).join("/"));
     }
   }
@@ -13336,8 +13570,8 @@ async function validateLiteralReuse(input) {
   const config = input.config ?? literalConfigDescriptor.defaults;
   const request = input.files ? {
     explicit: input.files.map((f) => {
-      const abs = isAbsolute5(f) ? f : resolve7(input.productDir, f);
-      return relative6(input.productDir, abs).split(/[\\/]/g).join("/");
+      const abs = isAbsolute6(f) ? f : resolve7(input.productDir, f);
+      return relative7(input.productDir, abs).split(/[\\/]/g).join("/");
     })
   } : { walkRoot: input.productDir };
   const scope2 = await runPipeline(
@@ -13358,7 +13592,7 @@ async function validateLiteralReuse(input) {
   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 rel = relative7(input.productDir, abs).split(/[\\/]/g).join("/");
     const content = await readSafe(abs);
     if (content === null) continue;
     const occurrences = collectLiterals(content, rel, collectOptions);
@@ -13596,23 +13830,23 @@ function formatLoc(loc) {
 }
 
 // src/validation/steps/typescript.ts
-import { existsSync as existsSync6, mkdirSync, rmSync, writeFileSync } from "fs";
+import { existsSync as existsSync7, mkdirSync, rmSync, writeFileSync } from "fs";
 import { mkdtemp as mkdtemp3 } from "fs/promises";
-import { isAbsolute as isAbsolute6, join as join31 } from "path";
+import { isAbsolute as isAbsolute7, join as join32 } from "path";
 var defaultTypeScriptProcessRunner = lifecycleProcessRunner;
 var defaultTypeScriptDeps = {
   mkdtemp: mkdtemp3,
   mkdirSync,
   writeFileSync,
   rmSync,
-  existsSync: existsSync6
+  existsSync: existsSync7
 };
 var TEMPORARY_TSCONFIG_COMPILER_OPTIONS = { noEmit: true };
 var TEMPORARY_TSCONFIG_DIR_PREFIX = "validate-ts-";
 async function createTemporaryTsconfigDir(projectRoot, deps) {
-  const parent = join31(projectRoot, ...TEMPORARY_TSCONFIG_PARENT_SEGMENTS);
+  const parent = join32(projectRoot, ...TEMPORARY_TSCONFIG_PARENT_SEGMENTS);
   deps.mkdirSync(parent, { recursive: true });
-  return deps.mkdtemp(join31(parent, TEMPORARY_TSCONFIG_DIR_PREFIX));
+  return deps.mkdtemp(join32(parent, TEMPORARY_TSCONFIG_DIR_PREFIX));
 }
 function buildTypeScriptArgs(context) {
   const { scope: scope2, configFile } = context;
@@ -13620,11 +13854,11 @@ function buildTypeScriptArgs(context) {
 }
 async function createFileSpecificTsconfig(scope2, files, projectRoot, deps = defaultTypeScriptDeps) {
   const tempDir = await createTemporaryTsconfigDir(projectRoot, deps);
-  const configPath = join31(tempDir, "tsconfig.json");
+  const configPath = join32(tempDir, "tsconfig.json");
   const baseConfigFile = TSCONFIG_FILES[scope2];
-  const absoluteFiles = files.map((file) => isAbsolute6(file) ? file : join31(projectRoot, file));
+  const absoluteFiles = files.map((file) => isAbsolute7(file) ? file : join32(projectRoot, file));
   const tempConfig = {
-    extends: join31(projectRoot, baseConfigFile),
+    extends: join32(projectRoot, baseConfigFile),
     files: absoluteFiles,
     include: [],
     exclude: [],
@@ -13641,11 +13875,11 @@ async function createFileSpecificTsconfig(scope2, files, projectRoot, deps = def
 }
 async function createScopeFilteredTsconfig(scope2, projectRoot, scopeConfig, deps = defaultTypeScriptDeps) {
   const tempDir = await createTemporaryTsconfigDir(projectRoot, deps);
-  const configPath = join31(tempDir, "tsconfig.json");
+  const configPath = join32(tempDir, "tsconfig.json");
   const baseConfigFile = TSCONFIG_FILES[scope2];
-  const toProjectPathPattern = (pattern) => isAbsolute6(pattern) ? pattern : join31(projectRoot, pattern);
+  const toProjectPathPattern = (pattern) => isAbsolute7(pattern) ? pattern : join32(projectRoot, pattern);
   const tempConfig = {
-    extends: join31(projectRoot, baseConfigFile),
+    extends: join32(projectRoot, baseConfigFile),
     include: scopeConfig.filePatterns.map(toProjectPathPattern),
     exclude: scopeConfig.excludePatterns.map(toProjectPathPattern),
     compilerOptions: TEMPORARY_TSCONFIG_COMPILER_OPTIONS
@@ -13673,7 +13907,7 @@ async function validateTypeScript(context, options = {}) {
     const { configPath, cleanup } = await createFileSpecificTsconfig(scope2, files, projectRoot, deps);
     try {
       return await new Promise((resolve8) => {
-        const tscBin = join31(projectRoot, "node_modules", ".bin", "tsc");
+        const tscBin = join32(projectRoot, "node_modules", ".bin", "tsc");
         const tscBinary = deps.existsSync(tscBin) ? tscBin : "npx";
         const tscArgs2 = tscBinary === "npx" ? ["tsc", "--project", configPath] : ["--project", configPath];
         const tscProcess = spawnManagedSubprocess(runner, tscBinary, tscArgs2, {
@@ -13706,7 +13940,7 @@ async function validateTypeScript(context, options = {}) {
       return { success: true, skipped: true };
     }
     const { configPath, cleanup } = await createScopeFilteredTsconfig(scope2, projectRoot, scopeConfig, deps);
-    const tscBin = join31(projectRoot, "node_modules", ".bin", "tsc");
+    const tscBin = join32(projectRoot, "node_modules", ".bin", "tsc");
     tool = deps.existsSync(tscBin) ? tscBin : "npx";
     tscArgs = tool === "npx" ? ["tsc", "--project", configPath] : ["--project", configPath];
     return new Promise((resolve8) => {
@@ -13728,7 +13962,7 @@ async function validateTypeScript(context, options = {}) {
       });
     });
   } else {
-    const tscBin = join31(projectRoot, "node_modules", ".bin", "tsc");
+    const tscBin = join32(projectRoot, "node_modules", ".bin", "tsc");
     tool = deps.existsSync(tscBin) ? tscBin : "npx";
     const rawArgs = buildTypeScriptArgs({ scope: scope2, configFile });
     tscArgs = tool === "npx" ? rawArgs : rawArgs.slice(1);
@@ -13905,11 +14139,12 @@ var typescriptValidationLanguage = {
 
 // src/validation/registry.ts
 var validationRegistry = {
-  languages: [typescriptValidationLanguage, markdownValidationLanguage]
+  languages: [typescriptValidationLanguage, markdownValidationLanguage, formattingValidationLanguage]
 };
-var validationPipelineStages = validationRegistry.languages.flatMap(
-  (language) => language.stages
-);
+function composeValidationPipelineStages(languages) {
+  return languages.flatMap((language) => language.stages);
+}
+var validationPipelineStages = composeValidationPipelineStages(validationRegistry.languages);
 var VALIDATION_PIPELINE_TOTAL_STEPS = validationPipelineStages.length;
 
 // src/commands/validation/format.ts
@@ -13972,7 +14207,7 @@ async function allCommand(options) {
 // src/validation/literal/allowlist-existing.ts
 import { randomBytes } from "crypto";
 import { rename as rename4, writeFile as writeFile4 } from "fs/promises";
-import { dirname as dirname9, join as join32 } from "path";
+import { dirname as dirname9, join as join33 } from "path";
 var EXIT_OK = 0;
 var EXIT_ERROR = 1;
 var INCLUDE_FIELD = "include";
@@ -13992,7 +14227,7 @@ var productionWriter = {
   async write(filePath, content) {
     const dir = dirname9(filePath);
     const random = randomBytes(RANDOM_TOKEN_BYTES).toString("hex");
-    const tmpPath = join32(dir, `${TEMP_FILE_PREFIX}${random}${TEMP_FILE_SUFFIX}`);
+    const tmpPath = join33(dir, `${TEMP_FILE_PREFIX}${random}${TEMP_FILE_SUFFIX}`);
     await writeFile4(tmpPath, content, "utf8");
     await rename4(tmpPath, filePath);
   }
@@ -14098,6 +14333,10 @@ var validationCliDefinition = {
       alias: "md",
       description: "Validate markdown link integrity and structure"
     },
+    format: {
+      commandName: "format",
+      description: "Check code formatting with dprint"
+    },
     all: {
       commandName: "all",
       description: "Run all validations"
@@ -14278,6 +14517,16 @@ function registerValidationCommands(validationCmd) {
     process.exit(result.exitCode);
   });
   addCommonOptions(markdownCmd);
+  const formatCmd = addValidationSubcommand(validationCmd, subcommands.format).action(async (options) => {
+    const result = await formattingCommand({
+      cwd: process.cwd(),
+      files: options.files,
+      quiet: options.quiet
+    });
+    if (result.output) console.log(result.output);
+    process.exit(result.exitCode);
+  });
+  addCommonOptions(formatCmd);
   const allCmd = addValidationSubcommand(validationCmd, subcommands.all).option("--fix", "Auto-fix ESLint issues").option(allValidationCliOptions.skipCircular.flag, allValidationCliOptions.skipCircular.description).option(allValidationCliOptions.skipLiteral.flag, allValidationCliOptions.skipLiteral.description).action(async (options) => {
     const result = await allCommand({
       cwd: process.cwd(),