@zxyycom/vibe-check 0.0.1 → 0.0.3

package/dist/esm/project-run/aggregation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"aggregation.mjs","sourceRoot":"","sources":["../../../src/project-run/aggregation.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  RunControlDiagnostic,\n  RunControlValidationResult\n} from \"./controls/validation-result.ts\";\nimport type { CheckAggregate, CheckAggregation } from \"./controls/contract.ts\";\nimport type { CoreCheck, CoreSnapshot } from \"../check-settlement/facts.ts\";\n\ntype AggregateStatus = Exclude<CheckAggregate, \"not-applicable\">;\n\n/** Validates that aggregation selects only normalized executable Check IDs. */\nexport function validateCheckAggregationSelection(\n  aggregation: CheckAggregation | undefined,\n  checkIds: readonly string[]\n): RunControlValidationResult<CheckAggregation | undefined> {\n  if (aggregation === undefined) return Object.freeze({ ok: true, value: undefined });\n  if (aggregation.checks === \"all\") return Object.freeze({ ok: true, value: aggregation });\n  const knownCheckIds = new Set(checkIds);\n  const selectedCheckIds = new Set<string>();\n  for (const checkId of aggregation.checks) {\n    if (!knownCheckIds.has(checkId) || selectedCheckIds.has(checkId)) {\n      return invalidControls(\"controls.checkAggregation.checks\");\n    }\n    selectedCheckIds.add(checkId);\n  }\n  return Object.freeze({ ok: true, value: aggregation });\n}\n\n/** Derives one explicit consumer-selected aggregate from settled Check statuses only. */\nexport function aggregateCheckOutcomes(\n  snapshot: CoreSnapshot,\n  aggregation: CheckAggregation\n): CheckAggregate {\n  const statuses = selectedChecks(snapshot, aggregation.checks).map((check) =>\n    aggregateStatus(check, aggregation)\n  );\n  if (statuses.includes(\"unavailable\")) return \"unavailable\";\n  return aggregateSelectedStatuses(\n    statuses.filter(\n      (status): status is Exclude<AggregateStatus, \"unavailable\"> =>\n        status !== null && status !== \"unavailable\"\n    ),\n    aggregation\n  );\n}\n\nfunction selectedChecks(\n  snapshot: CoreSnapshot,\n  selection: CheckAggregation[\"checks\"]\n): readonly CoreCheck[] {\n  if (selection === \"all\") return snapshot.checks;\n  return selection.map((checkId) => {\n    const check = snapshot.checks.find((candidate) => candidate.checkId === checkId);\n    if (check === undefined) throw new TypeError(\"Aggregation selection was not validated\");\n    return check;\n  });\n}\n\nfunction aggregateStatus(check: CoreCheck, aggregation: CheckAggregation): AggregateStatus | null {\n  switch (check.outcome.status) {\n    case \"passed\":\n    case \"failed\":\n      return check.outcome.status;\n    case \"unavailable\": {\n      if (aggregation.unavailable === \"propagate\") return \"unavailable\";\n      return aggregation.unavailable === \"fail\" ? \"failed\" : null;\n    }\n    case \"not-applicable\": {\n      if (aggregation.notApplicable === \"pass\") return \"passed\";\n      return aggregation.notApplicable === \"fail\" ? \"failed\" : null;\n    }\n  }\n}\n\nfunction aggregateSelectedStatuses(\n  statuses: readonly Exclude<AggregateStatus, \"unavailable\">[],\n  aggregation: CheckAggregation\n): CheckAggregate {\n  if (statuses.length === 0) return aggregation.empty;\n  if (aggregation.mode === \"all\") return statuses.includes(\"failed\") ? \"failed\" : \"passed\";\n  return statuses.includes(\"passed\") ? \"passed\" : \"failed\";\n}\n\nfunction invalidControls(path: string): RunControlValidationResult<never> {\n  const error: RunControlDiagnostic = Object.freeze({\n    kind: \"invalid-run-controls\",\n    path,\n    reason: \"invalid-value\"\n  });\n  return Object.freeze({ ok: false, error });\n}\n"]}
+{"version":3,"file":"aggregation.mjs","sourceRoot":"","sources":["../../../src/project-run/aggregation.ts"],"names":[],"mappings":"AAGA,uGAAuG;AACvG,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,aAAa,CAAQ;IAE9B,YAAmB,aAAoB;QACrC,KAAK,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAED,yGAAyG;AACzG,MAAM,UAAU,wBAAwB,CACtC,QAAsB,EACtB,iBAAoC,EACpC,WAAyC;IAEzC,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAC5D,OAAO,WAAW,KAAK,SAAS;QAC9B,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC;QACzB,CAAC,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,eAAe,CACtB,QAAsB,EACtB,iBAAoC;IAEpC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,SAAS,eAAe,CAAC,MAA4B;IACnD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC;QACpF,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CACxB,WAA6B,EAC7B,MAA4B;IAE5B,IAAI,SAAkB,CAAC;IACvB,IAAI,CAAC;QACH,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,uBAAuB,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,gBAAgB,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAClD,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,IAAI,uBAAuB,CAC/B,IAAI,SAAS,CAAC,8DAA8D,CAAC,CAC9E,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,CACL,KAAK,KAAK,QAAQ;QAClB,KAAK,KAAK,QAAQ;QAClB,KAAK,KAAK,gBAAgB;QAC1B,KAAK,KAAK,aAAa,CACxB,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,IAAI,KAAK,YAAY,OAAO;QAAE,KAAK,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;AACjG,CAAC","sourcesContent":["import type { CoreCheck, CoreSnapshot } from \"../check-settlement/facts.ts\";\nimport type { CheckAggregate, CheckAggregation } from \"./controls/contract.ts\";\n\n/** Identifies a callback failure so the invocation boundary can close outputs before rethrowing it. */\nexport class CheckAggregationFailure extends Error {\n  readonly originalError: Error;\n\n  public constructor(originalError: Error) {\n    super(\"Check aggregation failed\", { cause: originalError });\n    this.originalError = originalError;\n  }\n}\n\n/** Builds the canonical ordered, read-only effective Check list and derives its invocation aggregate. */\nexport function aggregateEffectiveChecks(\n  snapshot: CoreSnapshot,\n  effectiveCheckIds: readonly string[],\n  aggregation: CheckAggregation | undefined\n): CheckAggregate {\n  const checks = effectiveChecks(snapshot, effectiveCheckIds);\n  return aggregation === undefined\n    ? strictAggregate(checks)\n    : invokeAggregation(aggregation, checks);\n}\n\nfunction effectiveChecks(\n  snapshot: CoreSnapshot,\n  effectiveCheckIds: readonly string[]\n): readonly CoreCheck[] {\n  const effectiveCheckIdSet = new Set(effectiveCheckIds);\n  return Object.freeze(snapshot.checks.filter((check) => effectiveCheckIdSet.has(check.checkId)));\n}\n\nfunction strictAggregate(checks: readonly CoreCheck[]): CheckAggregate {\n  return checks.length > 0 && checks.every((check) => check.outcome.status === \"passed\")\n    ? \"passed\"\n    : \"failed\";\n}\n\nfunction invokeAggregation(\n  aggregation: CheckAggregation,\n  checks: readonly CoreCheck[]\n): CheckAggregate {\n  let aggregate: unknown;\n  try {\n    aggregate = aggregation(checks);\n  } catch (error) {\n    throw new CheckAggregationFailure(errorFromThrownValue(error));\n  }\n  if (isCheckAggregate(aggregate)) return aggregate;\n  discardPromiseRejection(aggregate);\n  throw new CheckAggregationFailure(\n    new TypeError(\"Check aggregation must synchronously return a CheckAggregate\")\n  );\n}\n\nfunction isCheckAggregate(value: unknown): value is CheckAggregate {\n  return (\n    value === \"passed\" ||\n    value === \"failed\" ||\n    value === \"not-applicable\" ||\n    value === \"unavailable\"\n  );\n}\n\nfunction discardPromiseRejection(value: unknown): void {\n  if (value instanceof Promise) void value.catch(() => undefined);\n}\n\nfunction errorFromThrownValue(value: unknown): Error {\n  return value instanceof Error ? value : new Error(\"Check aggregation threw a non-Error value\");\n}\n"]}

package/dist/esm/project-run/changes/git.mjs

@@ -0,0 +1,161 @@
+import { isAbsolute, relative, resolve, sep } from "node:path";
+import { execaSync } from "execa";
+import { matchesAnyConfigGlob } from "../../data-boundary/config-glob.mjs";
+import { isNormalizedProjectRelativePath } from "../../data-boundary/project-path.mjs";
+export const CHANGE_FLAG_PREFIX = "vibe-check:change:";
+export const GIT_CHANGES_UNAVAILABLE_CODE = "git-changes-unavailable";
+/** Prepares one configured Git change snapshot before Run flag selection. */
+export function prepareProjectChanges(input) {
+    const declaredFlags = declaredChangeFlags(input.changes);
+    try {
+        const paths = collectGitChangedPaths(input.projectRoot, input.changes.source.compareWith);
+        const projectChanges = matchedProjectChanges(paths, input.changes);
+        return Object.freeze({
+            effectiveFlags: combineFlags(input.callerFlags, projectChanges.files.flatMap(({ flags }) => flags)),
+            projectChanges
+        });
+    }
+    catch {
+        return Object.freeze({
+            effectiveFlags: combineFlags(input.callerFlags, declaredFlags),
+            projectChanges: Object.freeze({
+                ok: false,
+                reason: Object.freeze({ code: GIT_CHANGES_UNAVAILABLE_CODE })
+            })
+        });
+    }
+}
+function declaredChangeFlags(changes) {
+    return Object.freeze(Object.keys(changes.flags)
+        .sort(compareText)
+        .map((flagId) => `${CHANGE_FLAG_PREFIX}${flagId}`));
+}
+function collectGitChangedPaths(projectRoot, compareWith) {
+    const root = resolve(projectRoot);
+    const repositoryRoot = gitText(root, ["rev-parse", "--show-toplevel"]);
+    if (!isProjectRootInRepository(root, resolve(repositoryRoot))) {
+        throw new Error("project root is outside the Git repository");
+    }
+    const committed = gitNameStatus(root, [
+        "diff",
+        "--relative",
+        "--name-status",
+        "-z",
+        "--find-renames",
+        `${compareWith}...HEAD`
+    ]);
+    const staged = gitNameStatus(root, [
+        "diff",
+        "--cached",
+        "--relative",
+        "--name-status",
+        "-z",
+        "--find-renames"
+    ]);
+    const unstaged = gitNameStatus(root, [
+        "diff",
+        "--relative",
+        "--name-status",
+        "-z",
+        "--find-renames"
+    ]);
+    const untracked = gitNulPaths(root, [
+        "ls-files",
+        "--others",
+        "--exclude-standard",
+        "-z",
+        "--",
+        "."
+    ]);
+    return Object.freeze([
+        ...new Set([...committed, ...staged, ...unstaged, ...untracked].map(normalizedChangedPath))
+    ].sort(compareText));
+}
+function isProjectRootInRepository(projectRoot, repositoryRoot) {
+    const fromRepository = relative(repositoryRoot, projectRoot);
+    return (!isAbsolute(fromRepository) && fromRepository !== ".." && !fromRepository.startsWith(`..${sep}`));
+}
+function gitText(cwd, args) {
+    const text = gitOutput(cwd, args).trim();
+    if (text.length === 0)
+        throw new Error("Git command returned no text");
+    return text;
+}
+function gitOutput(cwd, args) {
+    const result = execaSync("git", args, {
+        cwd,
+        encoding: "utf8",
+        reject: false,
+        stripFinalNewline: false,
+        windowsHide: true
+    });
+    if (result.failed || result.exitCode !== 0)
+        throw new Error("Git command failed");
+    if (typeof result.stdout !== "string")
+        throw new Error("Git command returned non-text output");
+    return result.stdout;
+}
+function gitNameStatus(cwd, args) {
+    return parseGitNameStatus(gitOutput(cwd, args));
+}
+function gitNulPaths(cwd, args) {
+    return gitOutput(cwd, args)
+        .split("\0")
+        .filter((path) => path.length > 0);
+}
+/** Parses Git's `--name-status -z` protocol without line or tab splitting. */
+function parseGitNameStatus(stdout) {
+    const tokens = stdout.split("\0");
+    if (tokens.at(-1) === "")
+        tokens.pop();
+    const paths = [];
+    for (let index = 0; index < tokens.length;) {
+        const entry = parseGitNameStatusEntry(tokens, index);
+        paths.push(...entry.paths);
+        index = entry.nextIndex;
+    }
+    return Object.freeze(paths);
+}
+function parseGitNameStatusEntry(tokens, statusIndex) {
+    const status = tokens[statusIndex];
+    if (status === undefined || !isNameStatus(status))
+        throw new Error("invalid Git name-status output");
+    const pathCount = nameStatusPathCount(status);
+    const paths = tokens.slice(statusIndex + 1, statusIndex + 1 + pathCount);
+    if (paths.length !== pathCount || paths.some((path) => path.length === 0))
+        throw new Error("missing Git changed path");
+    return Object.freeze({ nextIndex: statusIndex + 1 + pathCount, paths: Object.freeze(paths) });
+}
+function nameStatusPathCount(status) {
+    return status.startsWith("R") || status.startsWith("C") ? 2 : 1;
+}
+function isNameStatus(value) {
+    return /^(?:[ACDMRTUXB][0-9]*|[RC][0-9]+)$/u.test(value);
+}
+function normalizedChangedPath(path) {
+    if (!isNormalizedProjectRelativePath(path))
+        throw new Error("invalid Git project-relative path");
+    return path;
+}
+function matchedProjectChanges(paths, changes) {
+    const regions = Object.entries(changes.flags).sort(([left], [right]) => compareText(left, right));
+    const files = paths.flatMap((path) => {
+        const flags = regions.flatMap(([flagId, region]) => matchesRegion(path, region) ? [`${CHANGE_FLAG_PREFIX}${flagId}`] : []);
+        return flags.length === 0 ? [] : [Object.freeze({ flags: Object.freeze(flags), path })];
+    });
+    return Object.freeze({ ok: true, files: Object.freeze(files) });
+}
+function matchesRegion(path, region) {
+    return matchesAnyConfigGlob(path, region.include) && !matchesAnyConfigGlob(path, region.exclude);
+}
+function combineFlags(...sets) {
+    return Object.freeze([...new Set(sets.flat())].sort(compareText));
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=git.mjs.map

package/dist/esm/project-run/changes/git.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.mjs","sourceRoot":"","sources":["../../../../src/project-run/changes/git.ts"],"names":[],"mappings":"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","sourcesContent":["import { isAbsolute, relative, resolve, sep } from \"node:path\";\n\nimport { execaSync } from \"execa\";\n\nimport { matchesAnyConfigGlob } from \"../../data-boundary/config-glob.ts\";\nimport { isNormalizedProjectRelativePath } from \"../../data-boundary/project-path.ts\";\nimport type { ProjectChanges } from \"../../check/check.ts\";\nimport type { NormalizedProjectChangesConfiguration } from \"../../project-definition/project-changes.ts\";\n\nexport const CHANGE_FLAG_PREFIX = \"vibe-check:change:\";\nexport const GIT_CHANGES_UNAVAILABLE_CODE = \"git-changes-unavailable\";\n\nexport type PreparedProjectChanges = Readonly<{\n  readonly effectiveFlags: readonly string[];\n  readonly projectChanges: ProjectChanges;\n}>;\n\n/** Prepares one configured Git change snapshot before Run flag selection. */\nexport function prepareProjectChanges(\n  input: Readonly<{\n    readonly callerFlags: readonly string[];\n    readonly changes: NormalizedProjectChangesConfiguration;\n    readonly projectRoot: string;\n  }>\n): PreparedProjectChanges {\n  const declaredFlags = declaredChangeFlags(input.changes);\n  try {\n    const paths = collectGitChangedPaths(input.projectRoot, input.changes.source.compareWith);\n    const projectChanges = matchedProjectChanges(paths, input.changes);\n    return Object.freeze({\n      effectiveFlags: combineFlags(\n        input.callerFlags,\n        projectChanges.files.flatMap(({ flags }) => flags)\n      ),\n      projectChanges\n    });\n  } catch {\n    return Object.freeze({\n      effectiveFlags: combineFlags(input.callerFlags, declaredFlags),\n      projectChanges: Object.freeze({\n        ok: false,\n        reason: Object.freeze({ code: GIT_CHANGES_UNAVAILABLE_CODE })\n      })\n    });\n  }\n}\n\nfunction declaredChangeFlags(changes: NormalizedProjectChangesConfiguration): readonly string[] {\n  return Object.freeze(\n    Object.keys(changes.flags)\n      .sort(compareText)\n      .map((flagId) => `${CHANGE_FLAG_PREFIX}${flagId}`)\n  );\n}\n\nfunction collectGitChangedPaths(projectRoot: string, compareWith: string): readonly string[] {\n  const root = resolve(projectRoot);\n  const repositoryRoot = gitText(root, [\"rev-parse\", \"--show-toplevel\"]);\n  if (!isProjectRootInRepository(root, resolve(repositoryRoot))) {\n    throw new Error(\"project root is outside the Git repository\");\n  }\n\n  const committed = gitNameStatus(root, [\n    \"diff\",\n    \"--relative\",\n    \"--name-status\",\n    \"-z\",\n    \"--find-renames\",\n    `${compareWith}...HEAD`\n  ]);\n  const staged = gitNameStatus(root, [\n    \"diff\",\n    \"--cached\",\n    \"--relative\",\n    \"--name-status\",\n    \"-z\",\n    \"--find-renames\"\n  ]);\n  const unstaged = gitNameStatus(root, [\n    \"diff\",\n    \"--relative\",\n    \"--name-status\",\n    \"-z\",\n    \"--find-renames\"\n  ]);\n  const untracked = gitNulPaths(root, [\n    \"ls-files\",\n    \"--others\",\n    \"--exclude-standard\",\n    \"-z\",\n    \"--\",\n    \".\"\n  ]);\n  return Object.freeze(\n    [\n      ...new Set([...committed, ...staged, ...unstaged, ...untracked].map(normalizedChangedPath))\n    ].sort(compareText)\n  );\n}\n\nfunction isProjectRootInRepository(projectRoot: string, repositoryRoot: string): boolean {\n  const fromRepository = relative(repositoryRoot, projectRoot);\n  return (\n    !isAbsolute(fromRepository) && fromRepository !== \"..\" && !fromRepository.startsWith(`..${sep}`)\n  );\n}\n\nfunction gitText(cwd: string, args: readonly string[]): string {\n  const text = gitOutput(cwd, args).trim();\n  if (text.length === 0) throw new Error(\"Git command returned no text\");\n  return text;\n}\n\nfunction gitOutput(cwd: string, args: readonly string[]): string {\n  const result = execaSync(\"git\", args, {\n    cwd,\n    encoding: \"utf8\",\n    reject: false,\n    stripFinalNewline: false,\n    windowsHide: true\n  });\n  if (result.failed || result.exitCode !== 0) throw new Error(\"Git command failed\");\n  if (typeof result.stdout !== \"string\") throw new Error(\"Git command returned non-text output\");\n  return result.stdout;\n}\n\nfunction gitNameStatus(cwd: string, args: readonly string[]): readonly string[] {\n  return parseGitNameStatus(gitOutput(cwd, args));\n}\n\nfunction gitNulPaths(cwd: string, args: readonly string[]): readonly string[] {\n  return gitOutput(cwd, args)\n    .split(\"\\0\")\n    .filter((path) => path.length > 0);\n}\n\n/** Parses Git's `--name-status -z` protocol without line or tab splitting. */\nfunction parseGitNameStatus(stdout: string): readonly string[] {\n  const tokens = stdout.split(\"\\0\");\n  if (tokens.at(-1) === \"\") tokens.pop();\n  const paths: string[] = [];\n  for (let index = 0; index < tokens.length;) {\n    const entry = parseGitNameStatusEntry(tokens, index);\n    paths.push(...entry.paths);\n    index = entry.nextIndex;\n  }\n  return Object.freeze(paths);\n}\n\nfunction parseGitNameStatusEntry(\n  tokens: readonly string[],\n  statusIndex: number\n): Readonly<{ readonly nextIndex: number; readonly paths: readonly string[] }> {\n  const status = tokens[statusIndex];\n  if (status === undefined || !isNameStatus(status))\n    throw new Error(\"invalid Git name-status output\");\n  const pathCount = nameStatusPathCount(status);\n  const paths = tokens.slice(statusIndex + 1, statusIndex + 1 + pathCount);\n  if (paths.length !== pathCount || paths.some((path) => path.length === 0))\n    throw new Error(\"missing Git changed path\");\n  return Object.freeze({ nextIndex: statusIndex + 1 + pathCount, paths: Object.freeze(paths) });\n}\n\nfunction nameStatusPathCount(status: string): 1 | 2 {\n  return status.startsWith(\"R\") || status.startsWith(\"C\") ? 2 : 1;\n}\n\nfunction isNameStatus(value: string): boolean {\n  return /^(?:[ACDMRTUXB][0-9]*|[RC][0-9]+)$/u.test(value);\n}\n\nfunction normalizedChangedPath(path: string): string {\n  if (!isNormalizedProjectRelativePath(path)) throw new Error(\"invalid Git project-relative path\");\n  return path;\n}\n\nfunction matchedProjectChanges(\n  paths: readonly string[],\n  changes: NormalizedProjectChangesConfiguration\n): Extract<ProjectChanges, { readonly ok: true }> {\n  const regions = Object.entries(changes.flags).sort(([left], [right]) => compareText(left, right));\n  const files = paths.flatMap((path) => {\n    const flags = regions.flatMap(([flagId, region]) =>\n      matchesRegion(path, region) ? [`${CHANGE_FLAG_PREFIX}${flagId}`] : []\n    );\n    return flags.length === 0 ? [] : [Object.freeze({ flags: Object.freeze(flags), path })];\n  });\n  return Object.freeze({ ok: true, files: Object.freeze(files) });\n}\n\nfunction matchesRegion(\n  path: string,\n  region: NormalizedProjectChangesConfiguration[\"flags\"][string]\n): boolean {\n  return matchesAnyConfigGlob(path, region.include) && !matchesAnyConfigGlob(path, region.exclude);\n}\n\nfunction combineFlags(...sets: readonly (readonly string[])[]): readonly string[] {\n  return Object.freeze([...new Set(sets.flat())].sort(compareText));\n}\n\nfunction compareText(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n"]}

package/dist/esm/project-run/check-execution/admitted-check-execution.mjs

@@ -0,0 +1,41 @@
+/** Handles one admitted Check's preparation boundary and ready callback handoff. */
+import { checkIdentity } from "./execution-finalization.mjs";
+import { recordSettledCheck } from "./execution-settlement.mjs";
+import { prepareCheck } from "./preparation.mjs";
+import { executeReadyCheck } from "./ready-check-execution.mjs";
+export async function executeAdmittedCheck(input) {
+    observeAdmittedCheck(input);
+    const preparation = await prepareCheck({
+        check: input.check,
+        diagnosticLogger: input.diagnosticLogger,
+        project: input.project,
+        signal: input.signal
+    });
+    if (preparation.kind === "blocked") {
+        settleBlockedPreparation(input, preparation);
+        return false;
+    }
+    return executeReadyCheck({ ...input, prepare: preparation });
+}
+function settleBlockedPreparation(state, prepare) {
+    const scope = state.session.openCheckScope(prepare.check.definition.checkId);
+    const outcome = scope.settleProduct(prepare.outcome);
+    recordSettledCheck({
+        check: checkIdentity(prepare.check),
+        durationMs: null,
+        messages: prepare.check.preparationMessages,
+        outcome,
+        phase: "preparation",
+        state
+    });
+}
+/** Diagnostic observation belongs to the invocation; it cannot revise admitted Task facts. */
+function observeAdmittedCheck(input) {
+    try {
+        input.onAdmittedCheck?.(input.check);
+    }
+    catch {
+        // Learned diagnostic output is best-effort and has no execution consequence.
+    }
+}
+//# sourceMappingURL=admitted-check-execution.mjs.map

package/dist/esm/project-run/check-execution/admitted-check-execution.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"admitted-check-execution.mjs","sourceRoot":"","sources":["../../../../src/project-run/check-execution/admitted-check-execution.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAKpF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAA4B,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,YAAY,EAAmC,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAe/D,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAkC;IAC3E,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC;QACrC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;IACH,IAAI,WAAW,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACnC,wBAAwB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,iBAAiB,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,wBAAwB,CAC/B,KAA0B,EAC1B,OAA0E;IAE1E,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,kBAAkB,CAAC;QACjB,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC;QACnC,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,mBAAmB;QAC3C,OAAO;QACP,KAAK,EAAE,aAAa;QACpB,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,8FAA8F;AAC9F,SAAS,oBAAoB,CAAC,KAAkC;IAC9D,IAAI,CAAC;QACH,KAAK,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;IAC/E,CAAC;AACH,CAAC","sourcesContent":["/** Handles one admitted Check's preparation boundary and ready callback handoff. */\n\nimport type { CheckProjectContext } from \"../../check/check.ts\";\nimport type { NormalizedCheck } from \"../../project-definition/project-definition.ts\";\nimport type { ResolvedInvocationPaths } from \"../invocation/paths.ts\";\nimport { checkIdentity } from \"./execution-finalization.ts\";\nimport { recordSettledCheck, type CheckExecutionState } from \"./execution-settlement.ts\";\nimport { prepareCheck, type CheckPreparationResolution } from \"./preparation.ts\";\nimport { executeReadyCheck } from \"./ready-check-execution.ts\";\n\nexport type CheckExecutionClock = Readonly<{ now(): number }>;\n\nexport type AdmittedCheckExecutionInput = CheckExecutionState &\n  Readonly<{\n    readonly check: NormalizedCheck;\n    readonly clock: CheckExecutionClock;\n    readonly onAdmittedCheck: ((check: NormalizedCheck) => void) | undefined;\n    readonly invocationId: string;\n    readonly paths: ResolvedInvocationPaths | undefined;\n    readonly project: CheckProjectContext;\n    readonly signal: AbortSignal;\n  }>;\n\nexport async function executeAdmittedCheck(input: AdmittedCheckExecutionInput): Promise<boolean> {\n  observeAdmittedCheck(input);\n  const preparation = await prepareCheck({\n    check: input.check,\n    diagnosticLogger: input.diagnosticLogger,\n    project: input.project,\n    signal: input.signal\n  });\n  if (preparation.kind === \"blocked\") {\n    settleBlockedPreparation(input, preparation);\n    return false;\n  }\n  return executeReadyCheck({ ...input, prepare: preparation });\n}\n\nfunction settleBlockedPreparation(\n  state: CheckExecutionState,\n  prepare: Extract<CheckPreparationResolution, { readonly kind: \"blocked\" }>\n): void {\n  const scope = state.session.openCheckScope(prepare.check.definition.checkId);\n  const outcome = scope.settleProduct(prepare.outcome);\n  recordSettledCheck({\n    check: checkIdentity(prepare.check),\n    durationMs: null,\n    messages: prepare.check.preparationMessages,\n    outcome,\n    phase: \"preparation\",\n    state\n  });\n}\n\n/** Diagnostic observation belongs to the invocation; it cannot revise admitted Task facts. */\nfunction observeAdmittedCheck(input: AdmittedCheckExecutionInput): void {\n  try {\n    input.onAdmittedCheck?.(input.check);\n  } catch {\n    // Learned diagnostic output is best-effort and has no execution consequence.\n  }\n}\n"]}

package/dist/esm/project-run/check-execution/callback.mjs

@@ -1,30 +1,45 @@
 import { CoreInvariantFailure } from "../../check-settlement/session.mjs";
 import { diagnosticTags } from "../diagnostic-logging/logger.mjs";
+import { snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { invokeWithCapturedConsole } from "./console-capture.mjs";
+import { diagnosticCallbackResult } from "./terminal-result.mjs";
+const EMPTY_MESSAGES = Object.freeze([]);
 /** Runs one trusted callback and closes its Check-owned reporter before return. */
 export async function executeCheckCallback(input) {
     const checkId = input.check.definition.checkId;
     const checkTags = diagnosticTags(`CHECK:${checkId}`, "EXECUTION");
-    const reporter = createCheckReporter(input.scope, input.diagnosticLogger, checkTags);
+    const reporter = createCheckReporter(input.scope, input.diagnosticLogger, checkTags, checkId);
     let result;
+    let consoleMessages = EMPTY_MESSAGES;
     try {
         const context = Object.freeze({
+            artifactDirectory: input.artifactDirectory,
             dependencies: input.dependencies,
+            invocationId: input.invocationId,
             options: input.check.options,
             project: input.project,
             records: reporter.records,
             signal: input.signal
         });
-        const callbackResult = await input.check.execution(context);
+        const invocation = await invokeWithCapturedConsole(() => input.check.execute(context));
+        consoleMessages = invocation.messages;
+        if (invocation.kind === "threw")
+            throw invocation.error;
+        const callbackResult = invocation.output;
         if (input.signal.aborted) {
             input.diagnosticLogger?.observe({
                 event: "callback.cancelled",
                 tags: diagnosticTags(...checkTags, "CANCELLED"),
-                details: { result: callbackResult }
+                details: { result: diagnosticCallbackResult(callbackResult, input.check.handoff) }
             });
         }
         result = input.signal.aborted
-            ? productResult("execution-cancelled")
-            : Object.freeze({ source: "author", result: callbackResult });
+            ? productResult("execution-cancelled", consoleMessages)
+            : Object.freeze({
+                source: "author",
+                result: callbackResult,
+                consoleMessages
+            });
     }
     catch (error) {
         if (error instanceof CoreInvariantFailure)
@@ -34,14 +49,14 @@ export async function executeCheckCallback(input) {
             tags: diagnosticTags(...checkTags, input.signal.aborted ? "CANCELLED" : "THREW"),
             details: { error }
         });
-        result = productResult(input.signal.aborted ? "execution-cancelled" : "execution-threw");
+        result = productResult(input.signal.aborted ? "execution-cancelled" : "execution-threw", consoleMessages);
     }
     finally {
         reporter.close();
     }
     return result;
 }
-function createCheckReporter(scope, diagnosticLogger, checkTags) {
+function createCheckReporter(scope, diagnosticLogger, checkTags, checkId) {
     let isOpen = true;
     return Object.freeze({
         close: () => {
@@ -55,16 +70,29 @@ function createCheckReporter(scope, diagnosticLogger, checkTags) {
                 diagnosticLogger?.observe({
                     event: "record.reported",
                     tags: diagnosticTags(...checkTags, "RECORD", result.toUpperCase()),
-                    details: { data, identity, result }
+                    details: recordDiagnosticDetails(checkId, identity, result)
                 });
             }
         })
     });
 }
-function productResult(code) {
+function productResult(code, consoleMessages) {
     return Object.freeze({
+        consoleMessages,
         source: "product",
         result: Object.freeze({ status: "unavailable", reason: Object.freeze({ code }) })
     });
 }
+function recordDiagnosticDetails(checkId, identity, result) {
+    const record = snapshotClosedRecord(identity);
+    const recordId = record !== undefined &&
+        Object.keys(record).length === 1 &&
+        Object.hasOwn(record, "id") &&
+        typeof record.id === "string"
+        ? record.id
+        : null;
+    return result === "committed"
+        ? Object.freeze({ checkId, recordId, result })
+        : Object.freeze({ checkId, rejectionCategory: "record-invalid-or-conflict", result });
+}
 //# sourceMappingURL=callback.mjs.map

package/dist/esm/project-run/check-execution/callback.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"callback.mjs","sourceRoot":"","sources":["../../../../src/project-run/check-execution/callback.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CheckDependencies,\n  CheckExecutionContext,\n  CheckOutcome,\n  CheckProjectContext\n} from \"../../check/check.ts\";\nimport type { NormalizedCheck } from \"../../project-definition/project-definition.ts\";\nimport { CoreInvariantFailure, type TrustedCheckScope } from \"../../check-settlement/session.ts\";\nimport { diagnosticTags, type DiagnosticLogger } from \"../diagnostic-logging/logger.ts\";\n\nexport type CallbackExecution = Readonly<\n  | {\n      /** Raw author result; Core owns its sole validation and canonicalization. */\n      readonly source: \"author\";\n      readonly result: unknown;\n    }\n  | {\n      /** Only callback containment may create a Product-controlled outcome. */\n      readonly source: \"product\";\n      readonly result: CheckOutcome;\n    }\n>;\n\ninterface CheckCallbackInput {\n  readonly check: NormalizedCheck;\n  readonly dependencies: CheckDependencies;\n  readonly diagnosticLogger?: DiagnosticLogger;\n  readonly project: CheckProjectContext;\n  readonly scope: TrustedCheckScope;\n  readonly signal: AbortSignal;\n}\n\ninterface CheckReporterLifecycle {\n  readonly records: CheckExecutionContext<object>[\"records\"];\n  close(): void;\n}\n\n/** Runs one trusted callback and closes its Check-owned reporter before return. */\nexport async function executeCheckCallback(input: CheckCallbackInput): Promise<CallbackExecution> {\n  const checkId = input.check.definition.checkId;\n  const checkTags = diagnosticTags(`CHECK:${checkId}`, \"EXECUTION\");\n  const reporter = createCheckReporter(input.scope, input.diagnosticLogger, checkTags);\n  let result: CallbackExecution;\n  try {\n    const context = Object.freeze({\n      dependencies: input.dependencies,\n      options: input.check.options,\n      project: input.project,\n      records: reporter.records,\n      signal: input.signal\n    });\n    const callbackResult = await input.check.execution(context);\n    if (input.signal.aborted) {\n      input.diagnosticLogger?.observe({\n        event: \"callback.cancelled\",\n        tags: diagnosticTags(...checkTags, \"CANCELLED\"),\n        details: { result: callbackResult }\n      });\n    }\n    result = input.signal.aborted\n      ? productResult(\"execution-cancelled\")\n      : Object.freeze({ source: \"author\", result: callbackResult });\n  } catch (error) {\n    if (error instanceof CoreInvariantFailure) throw error;\n    input.diagnosticLogger?.observe({\n      event: input.signal.aborted ? \"callback.cancelled\" : \"callback.threw\",\n      tags: diagnosticTags(...checkTags, input.signal.aborted ? \"CANCELLED\" : \"THREW\"),\n      details: { error }\n    });\n    result = productResult(input.signal.aborted ? \"execution-cancelled\" : \"execution-threw\");\n  } finally {\n    reporter.close();\n  }\n  return result;\n}\n\nfunction createCheckReporter(\n  scope: TrustedCheckScope,\n  diagnosticLogger: DiagnosticLogger | undefined,\n  checkTags: readonly string[]\n): CheckReporterLifecycle {\n  let isOpen = true;\n  return Object.freeze({\n    close: (): void => {\n      isOpen = false;\n    },\n    records: Object.freeze({\n      report: (identity: unknown, data: unknown): void => {\n        if (!isOpen) throw new Error(\"Check record reporter is closed\");\n        const result = scope.records.report(identity, data);\n        diagnosticLogger?.observe({\n          event: \"record.reported\",\n          tags: diagnosticTags(...checkTags, \"RECORD\", result.toUpperCase()),\n          details: { data, identity, result }\n        });\n      }\n    })\n  });\n}\n\nfunction productResult(code: string): CallbackExecution {\n  return Object.freeze({\n    source: \"product\",\n    result: Object.freeze({ status: \"unavailable\", reason: Object.freeze({ code }) })\n  });\n}\n"]}
+{"version":3,"file":"callback.mjs","sourceRoot":"","sources":["../../../../src/project-run/check-execution/callback.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CheckDependencies,\n  CheckExecutionContext,\n  CheckMessage,\n  CheckOutcome,\n  CheckProjectContext\n} from \"../../check/check.ts\";\nimport type { NormalizedCheck } from \"../../project-definition/project-definition.ts\";\nimport { CoreInvariantFailure, type TrustedCheckScope } from \"../../check-settlement/session.ts\";\nimport { diagnosticTags, type DiagnosticLogger } from \"../diagnostic-logging/logger.ts\";\nimport { snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { invokeWithCapturedConsole } from \"./console-capture.ts\";\nimport { diagnosticCallbackResult } from \"./terminal-result.ts\";\n\nconst EMPTY_MESSAGES: readonly CheckMessage[] = Object.freeze([]);\n\nexport type CallbackExecution = Readonly<\n  | {\n      /** Raw author result; Core owns its sole validation and canonicalization. */\n      readonly source: \"author\";\n      readonly result: unknown;\n      readonly consoleMessages: readonly CheckMessage[];\n    }\n  | {\n      /** Only callback containment may create a Product-controlled outcome. */\n      readonly source: \"product\";\n      readonly result: CheckOutcome;\n      readonly consoleMessages: readonly CheckMessage[];\n    }\n>;\n\ninterface CheckCallbackInput {\n  readonly artifactDirectory: string | null;\n  readonly check: NormalizedCheck;\n  readonly dependencies: CheckDependencies;\n  readonly diagnosticLogger?: DiagnosticLogger;\n  readonly invocationId: string;\n  readonly project: CheckProjectContext;\n  readonly scope: TrustedCheckScope;\n  readonly signal: AbortSignal;\n}\n\ninterface CheckReporterLifecycle {\n  readonly records: CheckExecutionContext<object>[\"records\"];\n  close(): void;\n}\n\n/** Runs one trusted callback and closes its Check-owned reporter before return. */\nexport async function executeCheckCallback(input: CheckCallbackInput): Promise<CallbackExecution> {\n  const checkId = input.check.definition.checkId;\n  const checkTags = diagnosticTags(`CHECK:${checkId}`, \"EXECUTION\");\n  const reporter = createCheckReporter(input.scope, input.diagnosticLogger, checkTags, checkId);\n  let result: CallbackExecution;\n  let consoleMessages = EMPTY_MESSAGES;\n  try {\n    const context = Object.freeze({\n      artifactDirectory: input.artifactDirectory,\n      dependencies: input.dependencies,\n      invocationId: input.invocationId,\n      options: input.check.options,\n      project: input.project,\n      records: reporter.records,\n      signal: input.signal\n    });\n    const invocation = await invokeWithCapturedConsole(() => input.check.execute(context));\n    consoleMessages = invocation.messages;\n    if (invocation.kind === \"threw\") throw invocation.error;\n    const callbackResult = invocation.output;\n    if (input.signal.aborted) {\n      input.diagnosticLogger?.observe({\n        event: \"callback.cancelled\",\n        tags: diagnosticTags(...checkTags, \"CANCELLED\"),\n        details: { result: diagnosticCallbackResult(callbackResult, input.check.handoff) }\n      });\n    }\n    result = input.signal.aborted\n      ? productResult(\"execution-cancelled\", consoleMessages)\n      : Object.freeze({\n          source: \"author\",\n          result: callbackResult,\n          consoleMessages\n        });\n  } catch (error) {\n    if (error instanceof CoreInvariantFailure) throw error;\n    input.diagnosticLogger?.observe({\n      event: input.signal.aborted ? \"callback.cancelled\" : \"callback.threw\",\n      tags: diagnosticTags(...checkTags, input.signal.aborted ? \"CANCELLED\" : \"THREW\"),\n      details: { error }\n    });\n    result = productResult(\n      input.signal.aborted ? \"execution-cancelled\" : \"execution-threw\",\n      consoleMessages\n    );\n  } finally {\n    reporter.close();\n  }\n  return result;\n}\n\nfunction createCheckReporter(\n  scope: TrustedCheckScope,\n  diagnosticLogger: DiagnosticLogger | undefined,\n  checkTags: readonly string[],\n  checkId: string\n): CheckReporterLifecycle {\n  let isOpen = true;\n  return Object.freeze({\n    close: (): void => {\n      isOpen = false;\n    },\n    records: Object.freeze({\n      report: (identity: unknown, data: unknown): void => {\n        if (!isOpen) throw new Error(\"Check record reporter is closed\");\n        const result = scope.records.report(identity, data);\n        diagnosticLogger?.observe({\n          event: \"record.reported\",\n          tags: diagnosticTags(...checkTags, \"RECORD\", result.toUpperCase()),\n          details: recordDiagnosticDetails(checkId, identity, result)\n        });\n      }\n    })\n  });\n}\n\nfunction productResult(code: string, consoleMessages: readonly CheckMessage[]): CallbackExecution {\n  return Object.freeze({\n    consoleMessages,\n    source: \"product\",\n    result: Object.freeze({ status: \"unavailable\", reason: Object.freeze({ code }) })\n  });\n}\n\nfunction recordDiagnosticDetails(\n  checkId: string,\n  identity: unknown,\n  result: \"committed\" | \"rejected\"\n): Readonly<Record<string, unknown>> {\n  const record = snapshotClosedRecord(identity);\n  const recordId =\n    record !== undefined &&\n    Object.keys(record).length === 1 &&\n    Object.hasOwn(record, \"id\") &&\n    typeof record.id === \"string\"\n      ? record.id\n      : null;\n  return result === \"committed\"\n    ? Object.freeze({ checkId, recordId, result })\n    : Object.freeze({ checkId, rejectionCategory: \"record-invalid-or-conflict\", result });\n}\n"]}

package/dist/esm/project-run/check-execution/console-capture.mjs

@@ -0,0 +1,220 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { Console } from "node:console";
+import { Writable } from "node:stream";
+import { formatWithOptions } from "node:util";
+const HOST_CONSOLE = globalThis.console;
+const captureContext = new AsyncLocalStorage();
+let activeRouterOwnerCount = 0;
+let installedMethods = Object.freeze([]);
+/** Installs one shared router around the complete resolved-Check execution lifecycle. */
+export async function runWithCheckConsoleRouter(operation) {
+    const release = acquireConsoleRouter();
+    try {
+        return await operation();
+    }
+    finally {
+        release();
+    }
+}
+/**
+ * Runs one author-owned Check function in an isolated console capture context. Concurrent contexts
+ * keep separate buffers; the resolved-Check lifecycle owns router installation and restoration.
+ */
+export async function invokeWithCapturedConsole(operation) {
+    const capture = new CheckConsoleCapture();
+    return captureContext.run(capture, async () => {
+        try {
+            const output = await operation();
+            return Object.freeze({ kind: "returned", messages: capture.snapshot(), output });
+        }
+        catch (error) {
+            return Object.freeze({ kind: "threw", error, messages: capture.snapshot() });
+        }
+    });
+}
+class CheckConsoleCapture {
+    #console;
+    #messages = [];
+    #activeCall;
+    constructor() {
+        this.#console = new Console({
+            colorMode: false,
+            ignoreErrors: true,
+            stderr: this.#writer("stderr"),
+            stdout: this.#writer("stdout")
+        });
+    }
+    invoke(method, arguments_) {
+        const activeCall = { chunks: [], method };
+        const previousCall = this.#activeCall;
+        this.#activeCall = activeCall;
+        try {
+            const captureMethod = Reflect.get(this.#console, method);
+            if (typeof captureMethod === "function") {
+                Reflect.apply(captureMethod, this.#console, arguments_);
+            }
+            else {
+                activeCall.chunks.push({
+                    stream: streamForMethod(method),
+                    text: fallbackConsoleText(method, arguments_)
+                });
+            }
+        }
+        catch {
+            activeCall.chunks.push({
+                stream: "stderr",
+                text: `console.${method} output could not be formatted safely`
+            });
+        }
+        finally {
+            this.#activeCall = previousCall;
+            this.#appendCall(activeCall);
+        }
+    }
+    snapshot() {
+        return this.#messages.length === 0 ? Object.freeze([]) : Object.freeze([...this.#messages]);
+    }
+    #appendCall(call) {
+        const chunks = combineAdjacentChunks(call.chunks);
+        for (const chunk of chunks) {
+            this.#messages.push(Object.freeze({
+                code: consoleMessageCode(call.method),
+                level: levelForConsoleCall(call.method, chunk.stream),
+                message: removeTerminalLineEnding(chunk.text)
+            }));
+        }
+    }
+    #writer(stream) {
+        return new Writable({
+            write: (chunk, _encoding, callback) => {
+                const activeCall = this.#activeCall;
+                if (activeCall !== undefined) {
+                    activeCall.chunks.push({ stream, text: String(chunk) });
+                }
+                callback();
+            }
+        });
+    }
+}
+function acquireConsoleRouter() {
+    if (activeRouterOwnerCount === 0)
+        installConsoleRouter();
+    activeRouterOwnerCount += 1;
+    let released = false;
+    return () => {
+        if (released)
+            return;
+        released = true;
+        activeRouterOwnerCount -= 1;
+        if (activeRouterOwnerCount === 0)
+            restoreConsoleRouter();
+    };
+}
+function installConsoleRouter() {
+    const installed = [];
+    try {
+        for (const method of consoleMethodNames(HOST_CONSOLE)) {
+            const original = Reflect.get(HOST_CONSOLE, method);
+            if (typeof original !== "function")
+                continue;
+            const descriptor = Object.getOwnPropertyDescriptor(HOST_CONSOLE, method);
+            const routed = function (...arguments_) {
+                const capture = captureContext.getStore();
+                if (capture !== undefined) {
+                    capture.invoke(method, arguments_);
+                    return undefined;
+                }
+                return Reflect.apply(original, HOST_CONSOLE, arguments_);
+            };
+            Object.defineProperty(HOST_CONSOLE, method, {
+                configurable: true,
+                enumerable: descriptor?.enumerable ?? false,
+                value: routed,
+                writable: true
+            });
+            installed.push(Object.freeze({ descriptor, method }));
+        }
+        installedMethods = Object.freeze(installed);
+    }
+    catch (error) {
+        restoreInstalledMethods(installed);
+        throw error;
+    }
+}
+function restoreConsoleRouter() {
+    restoreInstalledMethods(installedMethods);
+    installedMethods = Object.freeze([]);
+}
+function restoreInstalledMethods(methods) {
+    for (const { descriptor, method } of [...methods].reverse()) {
+        if (descriptor === undefined) {
+            Reflect.deleteProperty(HOST_CONSOLE, method);
+        }
+        else {
+            Object.defineProperty(HOST_CONSOLE, method, descriptor);
+        }
+    }
+}
+function consoleMethodNames(value) {
+    const names = new Set();
+    let current = value;
+    while (current !== null && current !== Object.prototype) {
+        for (const key of Reflect.ownKeys(current)) {
+            if (typeof key === "string" && key !== "Console" && key !== "constructor")
+                names.add(key);
+        }
+        current = Reflect.getPrototypeOf(current);
+    }
+    return Object.freeze([...names].filter((name) => typeof Reflect.get(value, name) === "function").sort(compareText));
+}
+function combineAdjacentChunks(chunks) {
+    const combined = [];
+    for (const chunk of chunks) {
+        const previous = combined.at(-1);
+        if (previous?.stream === chunk.stream) {
+            previous.text += chunk.text;
+        }
+        else {
+            combined.push({ stream: chunk.stream, text: chunk.text });
+        }
+    }
+    return combined;
+}
+function fallbackConsoleText(method, arguments_) {
+    const formatted = formatWithOptions({ colors: false }, ...arguments_);
+    return formatted.length === 0 ? `console.${method}()` : formatted;
+}
+function consoleMessageCode(method) {
+    const normalized = method
+        .replaceAll(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .replaceAll(/[^a-zA-Z0-9-]/g, "-")
+        .toLowerCase();
+    return `console-${normalized}`;
+}
+function levelForConsoleCall(method, stream) {
+    if (method === "warn")
+        return "warning";
+    if (method === "assert" || method === "error" || method === "trace")
+        return "error";
+    return stream === "stderr" ? "error" : "info";
+}
+function streamForMethod(method) {
+    return method === "assert" || method === "error" || method === "trace" || method === "warn"
+        ? "stderr"
+        : "stdout";
+}
+function removeTerminalLineEnding(text) {
+    if (text.endsWith("\r\n") && text.length > 2)
+        return text.slice(0, -2);
+    if (text.endsWith("\n") && text.length > 1)
+        return text.slice(0, -1);
+    return text;
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=console-capture.mjs.map