@zxyycom/vibe-check 0.0.1 → 0.0.3

package/dist/esm/package-checks/code-quality-findings/policy.mjs

@@ -1,3 +1,5 @@
+import { snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { isNonEmptyString } from "../../data-boundary/value-shapes.mjs";
 export const FINDING_POLICIES = Object.freeze(["blocking", "non-blocking"]);
 export const DEFAULT_FINDING_POLICY = "non-blocking";
 export function resolveFindingPolicy(value, fallback = DEFAULT_FINDING_POLICY) {
@@ -8,6 +10,24 @@ export function resolveFindingPolicy(value, fallback = DEFAULT_FINDING_POLICY) {
 export function validFindingPolicy(value) {
     return FINDING_POLICIES.some((policy) => policy === value);
 }
+/** Resolves the closed, non-empty named area map shared by code-quality Checks. */
+export function resolveCodeAreaPolicyMap(value, defaultArea, resolveArea) {
+    if (value === undefined)
+        return Object.freeze({ project: defaultArea() });
+    const areas = snapshotClosedRecord(value);
+    if (areas === undefined || Object.keys(areas).length === 0)
+        return undefined;
+    const resolvedEntries = [];
+    for (const [areaId, candidate] of Object.entries(areas)) {
+        if (!isNonEmptyString(areaId))
+            return undefined;
+        const area = resolveArea(candidate);
+        if (area === undefined)
+            return undefined;
+        resolvedEntries.push([areaId, area]);
+    }
+    return Object.freeze(Object.fromEntries(resolvedEntries));
+}
 export function isBlockingFinding(policies) {
     return policies.some((policy) => policy === "blocking");
 }

package/dist/esm/package-checks/code-quality-findings/policy.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"policy.mjs","sourceRoot":"","sources":["../../../../src/package-checks/code-quality-findings/policy.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,cAAc,CAAU,CAAC,CAAC;AAKrF,MAAM,CAAC,MAAM,sBAAsB,GAAkB,cAAc,CAAC;AAepE,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,QAAQ,GAAkB,sBAAsB;IAEhD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACzC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAkC;IAClE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,QAAsC;IAEtC,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAC1C,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,QAAQ,CACpD,CAAC,MAAM,CAAC;IACT,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;IACrC,MAAM,iCAAiC,GAAG,QAAQ,CAAC,MAAM,CACvD,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,QAAQ,CACrD,CAAC,MAAM,CAAC;IACT,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,iCAAiC,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAC9F,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,oBAAoB,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;QACtD,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAClB,oBAAoB;YACpB,YAAY;SACb,CAAC;QACF,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACtB,OAGE;IAEF,IAAI,OAAO,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC;gBACZ,IAAI,EAAE,mBAAmB;gBACzB,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,2IAA2I;aACpL,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,CAAC,iCAAiC,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC;gBACZ,IAAI,EAAE,uBAAuB;gBAC7B,KAAK,EAAE,SAAS;gBAChB,OAAO,EAAE,GAAG,OAAO,CAAC,iCAAiC,2IAA2I;aACjM,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC","sourcesContent":["import type { CheckMessage, CheckResult } from \"../../check/check.ts\";\n\nexport const FINDING_POLICIES = Object.freeze([\"blocking\", \"non-blocking\"] as const);\n\n/** package-provided Check 用于结算 normal finding 的阻断策略。 */\nexport type FindingPolicy = (typeof FINDING_POLICIES)[number];\n\nexport const DEFAULT_FINDING_POLICY: FindingPolicy = \"non-blocking\";\n\n/** 三个代码质量 Check 正常完成时返回的精确 finding 计数。 */\nexport interface FindingSummary {\n  readonly blockingFindingCount: number;\n  readonly findingCount: number;\n}\n\n/** 一项 finding 在 Check 自己结算前的领域中性处置。 */\nexport interface FindingSettlement {\n  /** 该 finding 是否仍需要进入该 Check 的正常 finding 结算。 */\n  readonly actionable: boolean;\n  readonly blocking: boolean;\n}\n\nexport function resolveFindingPolicy(\n  value: unknown,\n  fallback: FindingPolicy = DEFAULT_FINDING_POLICY\n): FindingPolicy | undefined {\n  if (value === undefined) return fallback;\n  return FINDING_POLICIES.find((policy) => policy === value);\n}\n\nexport function validFindingPolicy(value: unknown): value is FindingPolicy {\n  return FINDING_POLICIES.some((policy) => policy === value);\n}\n\nexport function isBlockingFinding(policies: readonly FindingPolicy[]): boolean {\n  return policies.some((policy) => policy === \"blocking\");\n}\n\nexport function settleFindings(\n  findings: readonly FindingSettlement[]\n): CheckResult<FindingSummary> {\n  const blockingFindingCount = findings.filter(\n    (finding) => finding.actionable && finding.blocking\n  ).length;\n  const findingCount = findings.length;\n  const actionableNonBlockingFindingCount = findings.filter(\n    (finding) => finding.actionable && !finding.blocking\n  ).length;\n  const messages = findingMessages({ actionableNonBlockingFindingCount, blockingFindingCount });\n  return Object.freeze({\n    status: blockingFindingCount > 0 ? \"failed\" : \"passed\",\n    data: Object.freeze({\n      blockingFindingCount,\n      findingCount\n    }),\n    ...(messages.length === 0 ? {} : { messages })\n  });\n}\n\nfunction findingMessages(\n  summary: Readonly<{\n    readonly actionableNonBlockingFindingCount: number;\n    readonly blockingFindingCount: number;\n  }>\n): readonly CheckMessage[] {\n  if (summary.blockingFindingCount > 0) {\n    return Object.freeze([\n      Object.freeze({\n        code: \"blocking-findings\",\n        level: \"error\",\n        message: `${summary.blockingFindingCount} blocking finding(s) require attention; inspect this Check's Records for affected paths and measurements, then update the code or policy.`\n      })\n    ]);\n  }\n  if (summary.actionableNonBlockingFindingCount > 0) {\n    return Object.freeze([\n      Object.freeze({\n        code: \"non-blocking-findings\",\n        level: \"warning\",\n        message: `${summary.actionableNonBlockingFindingCount} non-blocking finding(s) were recorded; inspect this Check's Records for affected paths and measurements, then update the code or policy.`\n      })\n    ]);\n  }\n  return Object.freeze([]);\n}\n"]}
+{"version":3,"file":"policy.mjs","sourceRoot":"","sources":["../../../../src/package-checks/code-quality-findings/policy.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckMessage, CheckResult } from \"../../check/check.ts\";\nimport { snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { isNonEmptyString } from \"../../data-boundary/value-shapes.ts\";\n\nexport const FINDING_POLICIES = Object.freeze([\"blocking\", \"non-blocking\"] as const);\n\n/** package-provided Check 用于结算 normal finding 的阻断策略。 */\nexport type FindingPolicy = (typeof FINDING_POLICIES)[number];\n\nexport const DEFAULT_FINDING_POLICY: FindingPolicy = \"non-blocking\";\n\n/** 三个代码质量 Check 正常完成时返回的精确 finding 计数。 */\nexport interface FindingSummary {\n  /** 仍可处置且采用 blocking policy 的 finding 数；waived finding 不计入。 */\n  readonly blockingFindingCount: number;\n  /** Check 发现的全部 finding 数，包括已 waived 或 non-blocking 的 finding。 */\n  readonly findingCount: number;\n}\n\n/** 一项 finding 在 Check 自己结算前的领域中性处置。 */\nexport interface FindingSettlement {\n  /** 该 finding 是否仍需要进入该 Check 的正常 finding 结算。 */\n  readonly actionable: boolean;\n  readonly blocking: boolean;\n}\n\nexport function resolveFindingPolicy(\n  value: unknown,\n  fallback: FindingPolicy = DEFAULT_FINDING_POLICY\n): FindingPolicy | undefined {\n  if (value === undefined) return fallback;\n  return FINDING_POLICIES.find((policy) => policy === value);\n}\n\nexport function validFindingPolicy(value: unknown): value is FindingPolicy {\n  return FINDING_POLICIES.some((policy) => policy === value);\n}\n\n/** Resolves the closed, non-empty named area map shared by code-quality Checks. */\nexport function resolveCodeAreaPolicyMap<Area>(\n  value: unknown,\n  defaultArea: () => Area,\n  resolveArea: (candidate: unknown) => Area | undefined\n): Readonly<Record<string, Area>> | undefined {\n  if (value === undefined) return Object.freeze({ project: defaultArea() });\n  const areas = snapshotClosedRecord(value);\n  if (areas === undefined || Object.keys(areas).length === 0) return undefined;\n  const resolvedEntries: Array<readonly [string, Area]> = [];\n  for (const [areaId, candidate] of Object.entries(areas)) {\n    if (!isNonEmptyString(areaId)) return undefined;\n    const area = resolveArea(candidate);\n    if (area === undefined) return undefined;\n    resolvedEntries.push([areaId, area]);\n  }\n  return Object.freeze(Object.fromEntries(resolvedEntries));\n}\n\nexport function isBlockingFinding(policies: readonly FindingPolicy[]): boolean {\n  return policies.some((policy) => policy === \"blocking\");\n}\n\nexport function settleFindings(\n  findings: readonly FindingSettlement[]\n): CheckResult<FindingSummary> {\n  const blockingFindingCount = findings.filter(\n    (finding) => finding.actionable && finding.blocking\n  ).length;\n  const findingCount = findings.length;\n  const actionableNonBlockingFindingCount = findings.filter(\n    (finding) => finding.actionable && !finding.blocking\n  ).length;\n  const messages = findingMessages({ actionableNonBlockingFindingCount, blockingFindingCount });\n  return Object.freeze({\n    status: blockingFindingCount > 0 ? \"failed\" : \"passed\",\n    data: Object.freeze({\n      blockingFindingCount,\n      findingCount\n    }),\n    ...(messages.length === 0 ? {} : { messages })\n  });\n}\n\nfunction findingMessages(\n  summary: Readonly<{\n    readonly actionableNonBlockingFindingCount: number;\n    readonly blockingFindingCount: number;\n  }>\n): readonly CheckMessage[] {\n  if (summary.blockingFindingCount > 0) {\n    return Object.freeze([\n      Object.freeze({\n        code: \"blocking-findings\",\n        level: \"error\",\n        message: `${summary.blockingFindingCount} blocking finding(s) require attention; inspect this Check's Records for affected paths and measurements, then update the code or policy.`\n      })\n    ]);\n  }\n  if (summary.actionableNonBlockingFindingCount > 0) {\n    return Object.freeze([\n      Object.freeze({\n        code: \"non-blocking-findings\",\n        level: \"warning\",\n        message: `${summary.actionableNonBlockingFindingCount} non-blocking finding(s) were recorded; inspect this Check's Records for affected paths and measurements, then update the code or policy.`\n      })\n    ]);\n  }\n  return Object.freeze([]);\n}\n"]}

package/dist/esm/package-checks/command-check/command-check.mjs

@@ -0,0 +1,55 @@
+import { executeCommandCheck } from "./execution.mjs";
+import { resolveCommandCheckInput } from "./options.mjs";
+export function commandCheck(input) {
+    const commandInput = input;
+    const resolved = resolveCommandCheckInput(input);
+    if (resolved === undefined) {
+        throw new TypeError("commandCheck input must match the documented closed command and ordinary Check authoring policy");
+    }
+    return {
+        ...(commandInput.admissionPriority === undefined
+            ? {}
+            : { admissionPriority: commandInput.admissionPriority }),
+        ...(commandInput.checks === undefined ? {} : { checks: commandInput.checks }),
+        ...(commandInput.dependsOn === undefined ? {} : { dependsOn: commandInput.dependsOn }),
+        ...(commandInput.enabledByFlags === undefined
+            ? {}
+            : { enabledByFlags: commandInput.enabledByFlags }),
+        ...(commandInput.maxParallel === undefined ? {} : { maxParallel: commandInput.maxParallel }),
+        ...(commandInput.mutex === undefined ? {} : { mutex: commandInput.mutex }),
+        ...(commandInput.observes === undefined ? {} : { observes: commandInput.observes }),
+        ...(commandInput.omitQuietPassedRow === undefined
+            ? {}
+            : { omitQuietPassedRow: commandInput.omitQuietPassedRow }),
+        ...(commandInput.resourceClaims === undefined
+            ? {}
+            : { resourceClaims: commandInput.resourceClaims }),
+        checkId: commandInput.checkId,
+        displayName: commandInput.displayName,
+        execute: (context) => executeCommandCheck(context, {
+            afterCommand: resolved.afterCommand,
+            resolveEnvironment: resolved.resolveEnvironment
+        }),
+        options: resolved.options,
+        prepare: (options) => isRevalidatedCommandOptions(options, commandInput.checkId, commandInput.displayName)
+            ? { status: "success", preparedOptions: options }
+            : { status: "failure", action: "block", reason: { code: "invalid-options" } },
+        ...(resolved.afterCommand?.parseData === undefined
+            ? {}
+            : { parseData: resolved.afterCommand.parseData })
+    };
+}
+function isRevalidatedCommandOptions(options, checkId, displayName) {
+    return (resolveCommandCheckInput({
+        checkId,
+        displayName,
+        executable: options.executable,
+        arguments: options.arguments,
+        environment: options.environment,
+        output: options.output,
+        outputByteLimit: options.outputByteLimit,
+        timeoutMs: options.timeoutMs,
+        ...(options.workingDirectory === null ? {} : { workingDirectory: options.workingDirectory })
+    }) !== undefined);
+}
+//# sourceMappingURL=command-check.mjs.map

package/dist/esm/package-checks/command-check/command-check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-check.mjs","sourceRoot":"","sources":["../../../../src/package-checks/command-check/command-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAuFxD,MAAM,UAAU,YAAY,CAAC,KAAsC;IACjE,MAAM,YAAY,GAAG,KAAK,CAAC;IAC3B,MAAM,QAAQ,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,SAAS,CACjB,iGAAiG,CAClG,CAAC;IACJ,CAAC;IACD,OAAO;QACL,GAAG,CAAC,YAAY,CAAC,iBAAiB,KAAK,SAAS;YAC9C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,YAAY,CAAC,iBAAiB,EAAE,CAAC;QAC1D,GAAG,CAAC,YAAY,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC;QAC7E,GAAG,CAAC,YAAY,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC;QACtF,GAAG,CAAC,YAAY,CAAC,cAAc,KAAK,SAAS;YAC3C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,cAAc,EAAE,YAAY,CAAC,cAAc,EAAE,CAAC;QACpD,GAAG,CAAC,YAAY,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,WAAW,EAAE,CAAC;QAC5F,GAAG,CAAC,YAAY,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1E,GAAG,CAAC,YAAY,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC;QACnF,GAAG,CAAC,YAAY,CAAC,kBAAkB,KAAK,SAAS;YAC/C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,kBAAkB,EAAE,YAAY,CAAC,kBAAkB,EAAE,CAAC;QAC5D,GAAG,CAAC,YAAY,CAAC,cAAc,KAAK,SAAS;YAC3C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,cAAc,EAAE,YAAY,CAAC,cAAc,EAAE,CAAC;QACpD,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,OAAO,EAAE,CAAC,OAA+C,EAAE,EAAE,CAC3D,mBAAmB,CAAC,OAAO,EAAE;YAC3B,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;SAChD,CAAC;QACJ,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,OAAO,EAAE,CAAC,OAAoC,EAAE,EAAE,CAChD,2BAA2B,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC;YAClF,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,OAAO,EAAE;YACjD,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE;QACjF,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,SAAS,KAAK,SAAS;YAChD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAClC,OAAoC,EACpC,OAAW,EACX,WAAmB;IAEnB,OAAO,CACL,wBAAwB,CAAC;QACvB,OAAO;QACP,WAAW;QACX,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,CAAC,OAAO,CAAC,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC;KAC7F,CAAC,KAAK,SAAS,CACjB,CAAC;AACJ,CAAC","sourcesContent":["import { executeCommandCheck } from \"./execution.ts\";\nimport type { Check, CheckDataParser } from \"../../check/check.ts\";\nimport { resolveCommandCheckInput } from \"./options.ts\";\nimport type {\n  AfterCommand,\n  AfterCommandExecution,\n  CommandCheck,\n  CommandCheckInput,\n  CommandCheckWithAfterCommand,\n  ResolvedCommandCheckOptions,\n  TypedCommandCheck\n} from \"./contract.ts\";\n\nexport type {\n  AfterCommand,\n  AfterCommandContext,\n  AfterCommandExecution,\n  CommandCheckWithAfterCommand,\n  CommandEnvironmentContext,\n  CommandEnvironmentResolver,\n  CompletedCommand,\n  CommandCheck,\n  CommandCheckEnvironment,\n  CommandCheckFinalData,\n  CommandCheckInput,\n  CommandCheckOutput,\n  CommandCheckUnavailableReasonCode,\n  TypedCommandCheck\n} from \"./contract.ts\";\n\ntype CommandCheckImplementationInput = CommandCheckInput<string, AfterCommand | undefined>;\n\n/**\n * 构造一个单一 no-shell executable 的 ordinary Check。\n *\n * @remarks constructor 会闭合并冻结 command-owned options；ordinary selection、relation 与 scheduling fields 仍按普通 Check lifecycle 传递。默认 exact-empty environment 与 discard output 不会把 ambient variables、child stdout/stderr 或 native error text 发布到 Check facts。`output: { mode: \"transcript\" }` 仅在 invocation 授予此 Check artifact directory 时，将 raw stdout/stderr 写入固定 `process.log`。\n * @example 以 process.execPath 构造无 shell command Check\n * ```ts\n * import { commandCheck, defineConfig, run } from \"@zxyycom/vibe-check\";\n *\n * const nodeProbe = commandCheck({\n *   checkId: \"node-probe\",\n *   displayName: \"Node probe\",\n *   executable: process.execPath,\n *   arguments: [\"--eval\", \"process.exit(0)\"],\n *   timeoutMs: 5_000,\n *   outputByteLimit: 64 * 1024\n * });\n *\n * const definition = defineConfig({\n *   checks: [nodeProbe],\n *   outputs: {\n *     diagnosticLogging: { enabled: false },\n *     machinePublication: { enabled: false },\n *     progressRendering: { enabled: false }\n *   }\n * });\n *\n * const result = await run(definition);\n * if (result.kind !== \"completed\") throw new Error(`Run did not complete: ${result.kind}`);\n * const outcome = result.snapshot.checks.find(\n *   ({ checkId }) => checkId === nodeProbe.checkId\n * )?.outcome;\n * if (outcome?.status !== \"passed\" || outcome.data.exitCode !== 0) {\n *   throw new Error(\"Node probe did not produce the expected passed outcome\");\n * }\n * ```\n */\nexport function commandCheck<const Id extends string, const FinalData extends object>(\n  input: CommandCheckInput<\n    Id,\n    Readonly<{\n      readonly execute: AfterCommandExecution<FinalData>;\n      readonly parseData?: never;\n    }>\n  >\n): CommandCheckWithAfterCommand<Id, FinalData>;\nexport function commandCheck<const Id extends string, const Parser extends CheckDataParser>(\n  input: CommandCheckInput<\n    Id,\n    Readonly<{\n      readonly execute: AfterCommandExecution<NoInfer<ReturnType<Parser>>>;\n      readonly parseData: Parser;\n    }>\n  >\n): TypedCommandCheck<Id, Parser>;\nexport function commandCheck<const Id extends string>(\n  input: CommandCheckInput<Id>\n): CommandCheck<Id>;\nexport function commandCheck(input: CommandCheckImplementationInput): Check {\n  const commandInput = input;\n  const resolved = resolveCommandCheckInput(input);\n  if (resolved === undefined) {\n    throw new TypeError(\n      \"commandCheck input must match the documented closed command and ordinary Check authoring policy\"\n    );\n  }\n  return {\n    ...(commandInput.admissionPriority === undefined\n      ? {}\n      : { admissionPriority: commandInput.admissionPriority }),\n    ...(commandInput.checks === undefined ? {} : { checks: commandInput.checks }),\n    ...(commandInput.dependsOn === undefined ? {} : { dependsOn: commandInput.dependsOn }),\n    ...(commandInput.enabledByFlags === undefined\n      ? {}\n      : { enabledByFlags: commandInput.enabledByFlags }),\n    ...(commandInput.maxParallel === undefined ? {} : { maxParallel: commandInput.maxParallel }),\n    ...(commandInput.mutex === undefined ? {} : { mutex: commandInput.mutex }),\n    ...(commandInput.observes === undefined ? {} : { observes: commandInput.observes }),\n    ...(commandInput.omitQuietPassedRow === undefined\n      ? {}\n      : { omitQuietPassedRow: commandInput.omitQuietPassedRow }),\n    ...(commandInput.resourceClaims === undefined\n      ? {}\n      : { resourceClaims: commandInput.resourceClaims }),\n    checkId: commandInput.checkId,\n    displayName: commandInput.displayName,\n    execute: (context: Parameters<CommandCheck[\"execute\"]>[0]) =>\n      executeCommandCheck(context, {\n        afterCommand: resolved.afterCommand,\n        resolveEnvironment: resolved.resolveEnvironment\n      }),\n    options: resolved.options,\n    prepare: (options: ResolvedCommandCheckOptions) =>\n      isRevalidatedCommandOptions(options, commandInput.checkId, commandInput.displayName)\n        ? { status: \"success\", preparedOptions: options }\n        : { status: \"failure\", action: \"block\", reason: { code: \"invalid-options\" } },\n    ...(resolved.afterCommand?.parseData === undefined\n      ? {}\n      : { parseData: resolved.afterCommand.parseData })\n  };\n}\n\nfunction isRevalidatedCommandOptions<Id extends string>(\n  options: ResolvedCommandCheckOptions,\n  checkId: Id,\n  displayName: string\n): boolean {\n  return (\n    resolveCommandCheckInput({\n      checkId,\n      displayName,\n      executable: options.executable,\n      arguments: options.arguments,\n      environment: options.environment,\n      output: options.output,\n      outputByteLimit: options.outputByteLimit,\n      timeoutMs: options.timeoutMs,\n      ...(options.workingDirectory === null ? {} : { workingDirectory: options.workingDirectory })\n    }) !== undefined\n  );\n}\n"]}

package/dist/esm/package-checks/command-check/contract.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contract.mjs.map

package/dist/esm/package-checks/command-check/contract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.mjs","sourceRoot":"","sources":["../../../../src/package-checks/command-check/contract.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  Check,\n  CheckDataParser,\n  CheckDependencies,\n  CheckExecutionContext,\n  CheckFlagEnablement,\n  CheckProjectContext,\n  CheckResourceClaims,\n  CheckResult,\n  CheckWithOptions,\n  DeepReadonly,\n  InheritableCheckCollection,\n  TypedCheckWithOptions\n} from \"../../check/check.ts\";\n\n/** command Check 的显式环境策略；默认 exact-empty，避免定义时读取 ambient environment。 */\nexport type CommandCheckEnvironment =\n  | Readonly<{\n      readonly mode: \"exact\";\n      readonly variables?: Readonly<Record<string, string>>;\n    }>\n  | Readonly<{\n      readonly mode: \"inherit\";\n      readonly overrides?: Readonly<Record<string, string | null>>;\n    }>;\n\n/** child stdout/stderr 的处理边界；默认 discard。 */\nexport type CommandCheckOutput = Readonly<{ readonly mode: \"discard\" | \"transcript\" }>;\n\n/** command 以 numeric exit status 结束时发布的唯一 final data。 */\nexport interface CommandCheckFinalData {\n  /** child process 的 numeric exit status。 */\n  readonly exitCode: number;\n}\n\n/** 已完整结束且只在 invocation-local callback 中可见的 child material。 */\nexport interface CompletedCommand {\n  readonly exitCode: number;\n  readonly stderr: string;\n  readonly stdout: string;\n}\n\n/** spawn 前 environment resolver 可读取的最小 invocation context。 */\nexport interface CommandEnvironmentContext {\n  readonly dependencies: CheckDependencies;\n  readonly options: DeepReadonly<ResolvedCommandCheckOptions>;\n  readonly project: CheckProjectContext;\n  readonly signal: AbortSignal;\n}\n\n/** 完整 command 后 caller-owned settlement 可读取的 context。 */\nexport type AfterCommandContext = CheckExecutionContext<ResolvedCommandCheckOptions> &\n  Readonly<{ readonly command: CompletedCommand }>;\n\n/** 完整 command 的 caller-owned settlement callback。 */\nexport type AfterCommandExecution<FinalData extends object = object> = (\n  this: void,\n  context: AfterCommandContext\n) => CheckResult<FinalData> | Promise<CheckResult<FinalData>>;\n\n/** command 完成后的可选 caller-owned settlement 与 typed-provider parser。 */\nexport type AfterCommand<FinalData extends object = object> = Readonly<{\n  readonly execute: AfterCommandExecution<FinalData>;\n  readonly parseData?: CheckDataParser | undefined;\n}>;\n\n/** spawn 前解析此次 command closed environment policy 的 callback。 */\nexport type CommandEnvironmentResolver = (\n  this: void,\n  context: CommandEnvironmentContext\n) => CommandCheckEnvironment | Promise<CommandCheckEnvironment>;\n\n/** command Check 自己产生的 stable unavailable reason code。 */\nexport type CommandCheckUnavailableReasonCode =\n  | \"command-environment-resolution-failed\"\n  | \"command-output-limit-exceeded\"\n  | \"command-start-failed\"\n  | \"command-terminated-by-signal\"\n  | \"command-timeout\"\n  | \"command-transcript-unavailable\"\n  | \"invalid-options\";\n\n/** `commandCheck` 的 closed authoring input；ordinary Check composition fields 原样交由 Core 处理。 */\ninterface CommandCheckBaseInput<Id extends string> {\n  readonly checkId: Id;\n  readonly displayName: string;\n  readonly executable: string;\n  readonly arguments?: readonly string[];\n  readonly workingDirectory?: string;\n  readonly timeoutMs: number;\n  readonly outputByteLimit: number;\n  readonly output?: CommandCheckOutput;\n  readonly enabledByFlags?: CheckFlagEnablement;\n  readonly checks?: readonly Check[];\n  readonly dependsOn?: InheritableCheckCollection<string>;\n  readonly observes?: InheritableCheckCollection<string>;\n  readonly maxParallel?: number;\n  readonly admissionPriority?: number;\n  readonly mutex?: InheritableCheckCollection<string>;\n  readonly resourceClaims?: CheckResourceClaims;\n  readonly omitQuietPassedRow?: true;\n}\n\n/** Static environment 与 invocation-time resolver 互斥；两者都省略时使用 exact-empty。 */\nexport type CommandCheckInput<\n  Id extends string = string,\n  After extends AfterCommand | undefined = undefined\n> = CommandCheckBaseInput<Id> &\n  (\n    | Readonly<{\n        readonly environment?: CommandCheckEnvironment;\n        readonly resolveEnvironment?: never;\n      }>\n    | Readonly<{\n        readonly environment?: never;\n        readonly resolveEnvironment: CommandEnvironmentResolver;\n      }>\n  ) &\n  (After extends undefined\n    ? Readonly<{ readonly afterCommand?: undefined }>\n    : Readonly<{ readonly afterCommand: After }>);\n\n/** command constructor materializes、冻结并在 preparation 再次验证的内部完整 options。 */\nexport interface ResolvedCommandCheckOptions {\n  readonly arguments: readonly string[];\n  readonly environment:\n    | Readonly<{ readonly mode: \"exact\"; readonly variables: Readonly<Record<string, string>> }>\n    | Readonly<{\n        readonly mode: \"inherit\";\n        readonly overrides: Readonly<Record<string, string | null>>;\n      }>;\n  readonly executable: string;\n  readonly output: Readonly<{ readonly mode: \"discard\" | \"transcript\" }>;\n  readonly outputByteLimit: number;\n  readonly timeoutMs: number;\n  /** `null` 表示 execution 时使用 invocation project root。 */\n  readonly workingDirectory: string | null;\n}\n\n/** 可放入普通 Project Definition 的 process-backed Check。 */\nexport type CommandCheck<Id extends string = string> = CheckWithOptions<\n  Id,\n  ResolvedCommandCheckOptions\n> &\n  Readonly<{\n    execute(\n      this: void,\n      context: CheckExecutionContext<ResolvedCommandCheckOptions>\n    ): CheckResult<CommandCheckFinalData> | Promise<CheckResult<CommandCheckFinalData>>;\n  }>;\n\n/** 带 caller-owned completion callback 的 ordinary command Check。 */\nexport type CommandCheckWithAfterCommand<Id extends string, FinalData extends object> = Omit<\n  CheckWithOptions<Id, ResolvedCommandCheckOptions>,\n  \"execute\"\n> &\n  Readonly<{\n    execute(\n      this: void,\n      context: CheckExecutionContext<ResolvedCommandCheckOptions>\n    ): CheckResult<FinalData> | Promise<CheckResult<FinalData>>;\n  }>;\n\n/** 带 caller-owned completion callback 与 parser 的 typed-provider command Check。 */\nexport type TypedCommandCheck<\n  Id extends string,\n  Parser extends CheckDataParser\n> = TypedCheckWithOptions<Id, ResolvedCommandCheckOptions, Parser>;\n"]}

package/dist/esm/package-checks/command-check/execution.mjs

@@ -0,0 +1,134 @@
+import { isAbsolute, resolve } from "node:path";
+import { runProcess } from "../host-environment/process.mjs";
+import { isValidResolvedCommandCheckOptions, resolveCommandCheckEnvironment } from "./options.mjs";
+import { closedTranscript, runningTranscript, writeCommandTranscript } from "./transcript.mjs";
+/** Executes one validated no-shell command and releases all child material after optional transcript persistence. */
+export async function executeCommandCheck(context, executionExtensions = {}) {
+    if (!isValidResolvedCommandCheckOptions(context.options))
+        return unavailable("invalid-options");
+    const environment = await resolveExecutionEnvironment(context, executionExtensions.resolveEnvironment);
+    if (environment === undefined)
+        return unavailable("command-environment-resolution-failed");
+    return executeResolvedCommand(context, environment, executionExtensions.afterCommand);
+}
+/** Runs one resolved command, preserving requested transcripts before caller-owned settlement. */
+async function executeResolvedCommand(context, environment, afterCommand) {
+    const { options } = context;
+    if (!(await writeRunningCommandTranscript(context.artifactDirectory, options.output.mode))) {
+        return unavailable("command-transcript-unavailable");
+    }
+    const result = await runProcess({
+        args: options.arguments,
+        cancelSignal: context.signal,
+        command: options.executable,
+        cwd: resolveWorkingDirectory(options.workingDirectory, context.project.root),
+        env: executionEnvironment(environment),
+        extendEnv: false,
+        label: "command Check",
+        maxBuffer: options.outputByteLimit,
+        timeout: options.timeoutMs
+    });
+    const terminal = terminalResult(result);
+    if (!(await writeClosedCommandTranscript(context.artifactDirectory, options.output.mode, terminal.status, result))) {
+        return unavailable("command-transcript-unavailable");
+    }
+    return settleCommandResult(context, result, terminal.result, afterCommand);
+}
+/** Writes the running marker only where output policy and artifact capability both allow it. */
+async function writeRunningCommandTranscript(artifactDirectory, outputMode) {
+    if (outputMode === "discard")
+        return true;
+    return (artifactDirectory !== null && writeCommandTranscript(artifactDirectory, runningTranscript()));
+}
+/** Replaces the running marker with final child material before any caller-owned callback observes it. */
+async function writeClosedCommandTranscript(artifactDirectory, outputMode, status, result) {
+    if (outputMode === "discard")
+        return true;
+    return (artifactDirectory !== null &&
+        writeCommandTranscript(artifactDirectory, closedTranscript({ status, stderr: result.stderr, stdout: result.stdout })));
+}
+/** Lets the caller settle only complete numeric exits; all other terminal causes remain Product-owned. */
+function settleCommandResult(context, result, defaultResult, afterCommand) {
+    if (afterCommand === undefined || !isCompleteCommandResult(result))
+        return defaultResult;
+    return afterCommand.execute(Object.freeze({
+        ...context,
+        command: Object.freeze({
+            exitCode: result.status,
+            stderr: result.stderr,
+            stdout: result.stdout
+        })
+    }));
+}
+async function resolveExecutionEnvironment(context, resolver) {
+    if (resolver === undefined)
+        return context.options.environment;
+    try {
+        const environment = await resolver(Object.freeze({
+            dependencies: context.dependencies,
+            options: context.options,
+            project: context.project,
+            signal: context.signal
+        }));
+        return resolveCommandCheckEnvironment(environment);
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveWorkingDirectory(workingDirectory, projectRoot) {
+    if (workingDirectory === null)
+        return projectRoot;
+    if (isAbsolute(workingDirectory))
+        return workingDirectory;
+    return resolve(projectRoot, workingDirectory);
+}
+function executionEnvironment(environment) {
+    if (environment.mode === "exact")
+        return { ...environment.variables };
+    const inherited = { ...process.env };
+    for (const [name, value] of Object.entries(environment.overrides)) {
+        if (value === null)
+            delete inherited[name];
+        else
+            inherited[name] = value;
+    }
+    return inherited;
+}
+function isCompleteCommandResult(result) {
+    return (typeof result.status === "number" &&
+        result.isCanceled !== true &&
+        result.isMaxBuffer !== true &&
+        result.timedOut !== true &&
+        result.signal === null);
+}
+function terminalResult(result) {
+    if (typeof result.status === "number" && result.status !== 0) {
+        return completedTerminal("failed", result.status);
+    }
+    if (result.isCanceled === true)
+        return unavailableTerminal("command-terminated-by-signal");
+    if (result.timedOut === true)
+        return unavailableTerminal("command-timeout");
+    if (result.isMaxBuffer === true)
+        return unavailableTerminal("command-output-limit-exceeded");
+    if (result.signal !== null)
+        return unavailableTerminal("command-terminated-by-signal");
+    if (result.status === 0) {
+        return completedTerminal("passed", 0);
+    }
+    return unavailableTerminal("command-start-failed");
+}
+function completedTerminal(status, exitCode) {
+    const result = status === "passed"
+        ? Object.freeze({ status: "passed", data: Object.freeze({ exitCode }) })
+        : Object.freeze({ status: "failed", data: Object.freeze({ exitCode }) });
+    return Object.freeze({ result, status });
+}
+function unavailableTerminal(code) {
+    return Object.freeze({ result: unavailable(code), status: "unavailable" });
+}
+function unavailable(code) {
+    return Object.freeze({ status: "unavailable", reason: Object.freeze({ code }) });
+}
+//# sourceMappingURL=execution.mjs.map

package/dist/esm/package-checks/command-check/execution.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/command-check/execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGhD,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,kCAAkC,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAClG,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAY9F,qHAAqH;AACrH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAA2D,EAC3D,mBAAmB,GAGd,EAAE;IAEP,IAAI,CAAC,kCAAkC,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAEhG,MAAM,WAAW,GAAG,MAAM,2BAA2B,CACnD,OAAO,EACP,mBAAmB,CAAC,kBAAkB,CACvC,CAAC;IACF,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC,uCAAuC,CAAC,CAAC;IAE3F,OAAO,sBAAsB,CAAC,OAAO,EAAE,WAAW,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAC;AACxF,CAAC;AAED,kGAAkG;AAClG,KAAK,UAAU,sBAAsB,CACnC,OAA2D,EAC3D,WAAuD,EACvD,YAAsC;IAEtC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC5B,IAAI,CAAC,CAAC,MAAM,6BAA6B,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC3F,OAAO,WAAW,CAAC,gCAAgC,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,IAAI,EAAE,OAAO,CAAC,SAAS;QACvB,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,OAAO,EAAE,OAAO,CAAC,UAAU;QAC3B,GAAG,EAAE,uBAAuB,CAAC,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAC5E,GAAG,EAAE,oBAAoB,CAAC,WAAW,CAAC;QACtC,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,OAAO,CAAC,eAAe;QAClC,OAAO,EAAE,OAAO,CAAC,SAAS;KAC3B,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,IACE,CAAC,CAAC,MAAM,4BAA4B,CAClC,OAAO,CAAC,iBAAiB,EACzB,OAAO,CAAC,MAAM,CAAC,IAAI,EACnB,QAAQ,CAAC,MAAM,EACf,MAAM,CACP,CAAC,EACF,CAAC;QACD,OAAO,WAAW,CAAC,gCAAgC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAC7E,CAAC;AAED,gGAAgG;AAChG,KAAK,UAAU,6BAA6B,CAC1C,iBAAgC,EAChC,UAAyD;IAEzD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,CACL,iBAAiB,KAAK,IAAI,IAAI,sBAAsB,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,CAAC,CAC7F,CAAC;AACJ,CAAC;AAED,0GAA0G;AAC1G,KAAK,UAAU,4BAA4B,CACzC,iBAAgC,EAChC,UAAyD,EACzD,MAA2C,EAC3C,MAA4B;IAE5B,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,CACL,iBAAiB,KAAK,IAAI;QAC1B,sBAAsB,CACpB,iBAAiB,EACjB,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAC3E,CACF,CAAC;AACJ,CAAC;AAED,0GAA0G;AAC1G,SAAS,mBAAmB,CAC1B,OAA2D,EAC3D,MAA4B,EAC5B,aAAiD,EACjD,YAAsC;IAEtC,IAAI,YAAY,KAAK,SAAS,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC;QAAE,OAAO,aAAa,CAAC;IACzF,OAAO,YAAY,CAAC,OAAO,CACzB,MAAM,CAAC,MAAM,CAAC;QACZ,GAAG,OAAO;QACV,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;YACrB,QAAQ,EAAE,MAAM,CAAC,MAAM;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;KACH,CAAC,CACH,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,2BAA2B,CACxC,OAA2D,EAC3D,QAAgD;IAEhD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;IAC/D,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,QAAQ,CAChC,MAAM,CAAC,MAAM,CAAC;YACZ,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CACH,CAAC;QACF,OAAO,8BAA8B,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,gBAA+B,EAAE,WAAmB;IACnF,IAAI,gBAAgB,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAClD,IAAI,UAAU,CAAC,gBAAgB,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC1D,OAAO,OAAO,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,oBAAoB,CAC3B,WAAuD;IAEvD,IAAI,WAAW,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;IACtE,MAAM,SAAS,GAAsB,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;QAClE,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;;YACtC,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC/B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,uBAAuB,CAAC,MAA4B;IAG3D,OAAO,CACL,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;QACjC,MAAM,CAAC,UAAU,KAAK,IAAI;QAC1B,MAAM,CAAC,WAAW,KAAK,IAAI;QAC3B,MAAM,CAAC,QAAQ,KAAK,IAAI;QACxB,MAAM,CAAC,MAAM,KAAK,IAAI,CACvB,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,MAA4B;IAIlD,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7D,OAAO,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,mBAAmB,CAAC,8BAA8B,CAAC,CAAC;IAC3F,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IAC5E,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI;QAAE,OAAO,mBAAmB,CAAC,+BAA+B,CAAC,CAAC;IAC7F,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,mBAAmB,CAAC,8BAA8B,CAAC,CAAC;IACvF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,iBAAiB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,mBAAmB,CAAC,sBAAsB,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,iBAAiB,CACxB,MAA2B,EAC3B,QAAgB;IAKhB,MAAM,MAAM,GACV,MAAM,KAAK,QAAQ;QACjB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAiB,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACjF,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAiB,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IACtF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAuC;IAIlE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,WAAW,CAAC,IAAuC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AACnF,CAAC","sourcesContent":["import { isAbsolute, resolve } from \"node:path\";\n\nimport type { CheckExecutionContext, CheckResult } from \"../../check/check.ts\";\nimport { runProcess } from \"../host-environment/process.ts\";\nimport { isValidResolvedCommandCheckOptions, resolveCommandCheckEnvironment } from \"./options.ts\";\nimport { closedTranscript, runningTranscript, writeCommandTranscript } from \"./transcript.ts\";\nimport type {\n  AfterCommand,\n  CommandCheckFinalData,\n  CommandEnvironmentResolver,\n  CommandCheckUnavailableReasonCode,\n  ResolvedCommandCheckOptions\n} from \"./contract.ts\";\n\ntype CommandProcessResult = Awaited<ReturnType<typeof runProcess>> &\n  Readonly<{ readonly isCanceled?: true; readonly isMaxBuffer?: true; readonly timedOut?: true }>;\n\n/** Executes one validated no-shell command and releases all child material after optional transcript persistence. */\nexport async function executeCommandCheck(\n  context: CheckExecutionContext<ResolvedCommandCheckOptions>,\n  executionExtensions: Readonly<{\n    readonly afterCommand?: AfterCommand | undefined;\n    readonly resolveEnvironment?: CommandEnvironmentResolver | undefined;\n  }> = {}\n): Promise<CheckResult> {\n  if (!isValidResolvedCommandCheckOptions(context.options)) return unavailable(\"invalid-options\");\n\n  const environment = await resolveExecutionEnvironment(\n    context,\n    executionExtensions.resolveEnvironment\n  );\n  if (environment === undefined) return unavailable(\"command-environment-resolution-failed\");\n\n  return executeResolvedCommand(context, environment, executionExtensions.afterCommand);\n}\n\n/** Runs one resolved command, preserving requested transcripts before caller-owned settlement. */\nasync function executeResolvedCommand(\n  context: CheckExecutionContext<ResolvedCommandCheckOptions>,\n  environment: ResolvedCommandCheckOptions[\"environment\"],\n  afterCommand: AfterCommand | undefined\n): Promise<CheckResult> {\n  const { options } = context;\n  if (!(await writeRunningCommandTranscript(context.artifactDirectory, options.output.mode))) {\n    return unavailable(\"command-transcript-unavailable\");\n  }\n\n  const result = await runProcess({\n    args: options.arguments,\n    cancelSignal: context.signal,\n    command: options.executable,\n    cwd: resolveWorkingDirectory(options.workingDirectory, context.project.root),\n    env: executionEnvironment(environment),\n    extendEnv: false,\n    label: \"command Check\",\n    maxBuffer: options.outputByteLimit,\n    timeout: options.timeoutMs\n  });\n  const terminal = terminalResult(result);\n  if (\n    !(await writeClosedCommandTranscript(\n      context.artifactDirectory,\n      options.output.mode,\n      terminal.status,\n      result\n    ))\n  ) {\n    return unavailable(\"command-transcript-unavailable\");\n  }\n  return settleCommandResult(context, result, terminal.result, afterCommand);\n}\n\n/** Writes the running marker only where output policy and artifact capability both allow it. */\nasync function writeRunningCommandTranscript(\n  artifactDirectory: string | null,\n  outputMode: ResolvedCommandCheckOptions[\"output\"][\"mode\"]\n): Promise<boolean> {\n  if (outputMode === \"discard\") return true;\n  return (\n    artifactDirectory !== null && writeCommandTranscript(artifactDirectory, runningTranscript())\n  );\n}\n\n/** Replaces the running marker with final child material before any caller-owned callback observes it. */\nasync function writeClosedCommandTranscript(\n  artifactDirectory: string | null,\n  outputMode: ResolvedCommandCheckOptions[\"output\"][\"mode\"],\n  status: \"passed\" | \"failed\" | \"unavailable\",\n  result: CommandProcessResult\n): Promise<boolean> {\n  if (outputMode === \"discard\") return true;\n  return (\n    artifactDirectory !== null &&\n    writeCommandTranscript(\n      artifactDirectory,\n      closedTranscript({ status, stderr: result.stderr, stdout: result.stdout })\n    )\n  );\n}\n\n/** Lets the caller settle only complete numeric exits; all other terminal causes remain Product-owned. */\nfunction settleCommandResult(\n  context: CheckExecutionContext<ResolvedCommandCheckOptions>,\n  result: CommandProcessResult,\n  defaultResult: CheckResult<CommandCheckFinalData>,\n  afterCommand: AfterCommand | undefined\n): CheckResult | Promise<CheckResult> {\n  if (afterCommand === undefined || !isCompleteCommandResult(result)) return defaultResult;\n  return afterCommand.execute(\n    Object.freeze({\n      ...context,\n      command: Object.freeze({\n        exitCode: result.status,\n        stderr: result.stderr,\n        stdout: result.stdout\n      })\n    })\n  );\n}\n\nasync function resolveExecutionEnvironment(\n  context: CheckExecutionContext<ResolvedCommandCheckOptions>,\n  resolver: CommandEnvironmentResolver | undefined\n): Promise<ResolvedCommandCheckOptions[\"environment\"] | undefined> {\n  if (resolver === undefined) return context.options.environment;\n  try {\n    const environment = await resolver(\n      Object.freeze({\n        dependencies: context.dependencies,\n        options: context.options,\n        project: context.project,\n        signal: context.signal\n      })\n    );\n    return resolveCommandCheckEnvironment(environment);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction resolveWorkingDirectory(workingDirectory: string | null, projectRoot: string): string {\n  if (workingDirectory === null) return projectRoot;\n  if (isAbsolute(workingDirectory)) return workingDirectory;\n  return resolve(projectRoot, workingDirectory);\n}\n\nfunction executionEnvironment(\n  environment: ResolvedCommandCheckOptions[\"environment\"]\n): NodeJS.ProcessEnv {\n  if (environment.mode === \"exact\") return { ...environment.variables };\n  const inherited: NodeJS.ProcessEnv = { ...process.env };\n  for (const [name, value] of Object.entries(environment.overrides)) {\n    if (value === null) delete inherited[name];\n    else inherited[name] = value;\n  }\n  return inherited;\n}\n\nfunction isCompleteCommandResult(result: CommandProcessResult): result is CommandProcessResult & {\n  readonly status: number;\n} {\n  return (\n    typeof result.status === \"number\" &&\n    result.isCanceled !== true &&\n    result.isMaxBuffer !== true &&\n    result.timedOut !== true &&\n    result.signal === null\n  );\n}\n\nfunction terminalResult(result: CommandProcessResult): Readonly<{\n  readonly result: CheckResult<CommandCheckFinalData>;\n  readonly status: \"passed\" | \"failed\" | \"unavailable\";\n}> {\n  if (typeof result.status === \"number\" && result.status !== 0) {\n    return completedTerminal(\"failed\", result.status);\n  }\n  if (result.isCanceled === true) return unavailableTerminal(\"command-terminated-by-signal\");\n  if (result.timedOut === true) return unavailableTerminal(\"command-timeout\");\n  if (result.isMaxBuffer === true) return unavailableTerminal(\"command-output-limit-exceeded\");\n  if (result.signal !== null) return unavailableTerminal(\"command-terminated-by-signal\");\n  if (result.status === 0) {\n    return completedTerminal(\"passed\", 0);\n  }\n  return unavailableTerminal(\"command-start-failed\");\n}\n\nfunction completedTerminal(\n  status: \"passed\" | \"failed\",\n  exitCode: number\n): Readonly<{\n  readonly result: CheckResult<CommandCheckFinalData>;\n  readonly status: \"passed\" | \"failed\";\n}> {\n  const result: CheckResult<CommandCheckFinalData> =\n    status === \"passed\"\n      ? Object.freeze({ status: \"passed\" as const, data: Object.freeze({ exitCode }) })\n      : Object.freeze({ status: \"failed\" as const, data: Object.freeze({ exitCode }) });\n  return Object.freeze({ result, status });\n}\n\nfunction unavailableTerminal(code: CommandCheckUnavailableReasonCode): Readonly<{\n  readonly result: CheckResult<CommandCheckFinalData>;\n  readonly status: \"unavailable\";\n}> {\n  return Object.freeze({ result: unavailable(code), status: \"unavailable\" });\n}\n\nfunction unavailable(code: CommandCheckUnavailableReasonCode): CheckResult<CommandCheckFinalData> {\n  return Object.freeze({ status: \"unavailable\", reason: Object.freeze({ code }) });\n}\n"]}

package/dist/esm/package-checks/command-check/options.mjs

@@ -0,0 +1,284 @@
+import { snapshotClosedArray, snapshotClosedPolicyRecord, snapshotClosedRecord, snapshotExactClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { isNonEmptyString, isPositiveSafeInteger } from "../../data-boundary/value-shapes.mjs";
+const COMMAND_INPUT_OPTIONAL_KEYS = [
+    "admissionPriority",
+    "afterCommand",
+    "arguments",
+    "checks",
+    "dependsOn",
+    "enabledByFlags",
+    "environment",
+    "maxParallel",
+    "mutex",
+    "observes",
+    "omitQuietPassedRow",
+    "output",
+    "resourceClaims",
+    "resolveEnvironment",
+    "workingDirectory"
+];
+const COMMAND_INPUT_REQUIRED_KEYS = [
+    "checkId",
+    "displayName",
+    "executable",
+    "outputByteLimit",
+    "timeoutMs"
+];
+const RESOLVED_OPTION_KEYS = [
+    "arguments",
+    "environment",
+    "executable",
+    "output",
+    "outputByteLimit",
+    "timeoutMs",
+    "workingDirectory"
+];
+/** Snapshots one closed constructor input and materializes every command-owned omission. */
+export function resolveCommandCheckInput(input) {
+    const snapshot = snapshotClosedPolicyRecord(input, {
+        optional: COMMAND_INPUT_OPTIONAL_KEYS,
+        required: COMMAND_INPUT_REQUIRED_KEYS
+    });
+    if (snapshot === undefined)
+        return undefined;
+    const afterCommand = resolveAfterCommand(snapshot.afterCommand);
+    const environmentResolver = resolveEnvironmentResolver(snapshot.resolveEnvironment);
+    if ((snapshot.afterCommand !== undefined && afterCommand === undefined) ||
+        (snapshot.resolveEnvironment !== undefined && environmentResolver === undefined) ||
+        (snapshot.environment !== undefined && snapshot.resolveEnvironment !== undefined)) {
+        return undefined;
+    }
+    const options = resolveCommandOptions(snapshot);
+    return options === undefined
+        ? undefined
+        : Object.freeze({
+            afterCommand,
+            options,
+            resolveEnvironment: environmentResolver
+        });
+}
+/** Resolves one callback-produced environment to the same complete closed shape as static input. */
+export function resolveCommandCheckEnvironment(value) {
+    if (value === undefined)
+        return undefined;
+    return resolveEnvironment(value);
+}
+/** Revalidates the complete resolved shape before execution. */
+export function isValidResolvedCommandCheckOptions(value) {
+    const options = snapshotExactClosedRecord(value, RESOLVED_OPTION_KEYS);
+    return (options !== undefined &&
+        validCommandText(options.executable) &&
+        validArguments(options.arguments) &&
+        validWorkingDirectory(options.workingDirectory) &&
+        validEnvironment(options.environment) &&
+        validOutput(options.output) &&
+        isPositiveSafeInteger(options.timeoutMs) &&
+        isPositiveSafeInteger(options.outputByteLimit));
+}
+function resolveCommandOptions(input) {
+    if (!isNonEmptyString(input.checkId) || !isNonEmptyString(input.displayName))
+        return undefined;
+    const options = resolveCommandExecutionOptions(input);
+    if (options === undefined)
+        return undefined;
+    return isValidResolvedCommandCheckOptions(options) ? options : undefined;
+}
+function resolveAfterCommand(value) {
+    if (value === undefined)
+        return undefined;
+    const afterCommand = snapshotClosedPolicyRecord(value, {
+        optional: ["parseData"],
+        required: ["execute"]
+    });
+    if (afterCommand === undefined || !isAfterCommandExecution(afterCommand.execute))
+        return undefined;
+    if (afterCommand.parseData !== undefined && !isCheckDataParser(afterCommand.parseData)) {
+        return undefined;
+    }
+    return Object.freeze({
+        execute: afterCommand.execute,
+        ...(afterCommand.parseData === undefined ? {} : { parseData: afterCommand.parseData })
+    });
+}
+function resolveEnvironmentResolver(value) {
+    return isCommandEnvironmentResolver(value) ? value : undefined;
+}
+function isAfterCommandExecution(value) {
+    return typeof value === "function";
+}
+function isCheckDataParser(value) {
+    return typeof value === "function";
+}
+function isCommandEnvironmentResolver(value) {
+    return typeof value === "function";
+}
+/** Resolves command-owned execution fields after the ordinary Check identity is known valid. */
+function resolveCommandExecutionOptions(input) {
+    const argumentsSnapshot = resolveArguments(input.arguments);
+    const environment = resolveEnvironment(input.environment);
+    const output = resolveOutput(input.output);
+    const workingDirectory = resolveWorkingDirectory(input.workingDirectory);
+    if (!validCommandText(input.executable) ||
+        argumentsSnapshot === undefined ||
+        environment === undefined ||
+        output === undefined ||
+        workingDirectory === undefined ||
+        !isPositiveSafeInteger(input.timeoutMs) ||
+        !isPositiveSafeInteger(input.outputByteLimit)) {
+        return undefined;
+    }
+    return Object.freeze({
+        arguments: argumentsSnapshot,
+        environment,
+        executable: input.executable,
+        output,
+        outputByteLimit: input.outputByteLimit,
+        timeoutMs: input.timeoutMs,
+        workingDirectory
+    });
+}
+function resolveArguments(value) {
+    if (value === undefined)
+        return Object.freeze([]);
+    const argumentsSnapshot = snapshotClosedArray(value);
+    if (argumentsSnapshot === undefined)
+        return undefined;
+    const argumentsCopy = [];
+    for (const argument of argumentsSnapshot) {
+        if (!validArgument(argument))
+            return undefined;
+        argumentsCopy.push(argument);
+    }
+    return Object.freeze(argumentsCopy);
+}
+function validArguments(value) {
+    const argumentsSnapshot = snapshotClosedArray(value);
+    return argumentsSnapshot?.every(validArgument) === true;
+}
+function validArgument(value) {
+    return typeof value === "string" && !value.includes("\0");
+}
+function resolveWorkingDirectory(value) {
+    if (value === undefined)
+        return null;
+    return validCommandText(value) ? value : undefined;
+}
+function validWorkingDirectory(value) {
+    return value === null || validCommandText(value);
+}
+function validCommandText(value) {
+    return isNonEmptyString(value) && !value.includes("\0");
+}
+function resolveEnvironment(value) {
+    if (value === undefined)
+        return Object.freeze({ mode: "exact", variables: Object.freeze({}) });
+    const environment = snapshotClosedRecord(value);
+    if (environment === undefined || typeof environment.mode !== "string")
+        return undefined;
+    if (environment.mode === "exact")
+        return resolveExactEnvironment(environment);
+    if (environment.mode === "inherit")
+        return resolveInheritedEnvironment(environment);
+    return undefined;
+}
+function resolveExactEnvironment(environment) {
+    const exact = snapshotClosedPolicyRecord(environment, {
+        optional: ["variables"],
+        required: ["mode"]
+    });
+    if (exact === undefined)
+        return undefined;
+    const variables = Object.hasOwn(exact, "variables")
+        ? resolveExactVariables(exact.variables)
+        : Object.freeze({});
+    if (variables === undefined)
+        return undefined;
+    return Object.freeze({ mode: "exact", variables });
+}
+function resolveInheritedEnvironment(environment) {
+    const inherited = snapshotClosedPolicyRecord(environment, {
+        optional: ["overrides"],
+        required: ["mode"]
+    });
+    if (inherited === undefined)
+        return undefined;
+    const overrides = Object.hasOwn(inherited, "overrides")
+        ? resolveOverrides(inherited.overrides)
+        : Object.freeze({});
+    if (overrides === undefined)
+        return undefined;
+    return Object.freeze({ mode: "inherit", overrides });
+}
+function validEnvironment(value) {
+    const environment = snapshotClosedRecord(value);
+    if (environment === undefined || typeof environment.mode !== "string")
+        return false;
+    if (environment.mode === "exact") {
+        const exact = snapshotExactClosedRecord(environment, ["mode", "variables"]);
+        return exact !== undefined && validVariableMap(exact.variables, false);
+    }
+    if (environment.mode === "inherit") {
+        const inherited = snapshotExactClosedRecord(environment, ["mode", "overrides"]);
+        return inherited !== undefined && validVariableMap(inherited.overrides, true);
+    }
+    return false;
+}
+function resolveExactVariables(value) {
+    const variables = snapshotClosedRecord(value);
+    if (variables === undefined)
+        return undefined;
+    const copied = {};
+    for (const [name, variable] of Object.entries(variables)) {
+        if (name.includes("\0") || typeof variable !== "string" || variable.includes("\0"))
+            return undefined;
+        Object.defineProperty(copied, name, {
+            configurable: false,
+            enumerable: true,
+            value: variable,
+            writable: false
+        });
+    }
+    return Object.freeze(copied);
+}
+function resolveOverrides(value) {
+    const overrides = snapshotClosedRecord(value);
+    if (overrides === undefined)
+        return undefined;
+    const copied = {};
+    for (const [name, override] of Object.entries(overrides)) {
+        if (name.includes("\0") ||
+            (override !== null && (typeof override !== "string" || override.includes("\0")))) {
+            return undefined;
+        }
+        Object.defineProperty(copied, name, {
+            configurable: false,
+            enumerable: true,
+            value: override,
+            writable: false
+        });
+    }
+    return Object.freeze(copied);
+}
+function validVariableMap(value, acceptsNull) {
+    const variables = snapshotClosedRecord(value);
+    return variables !== undefined && validVariableEntries(variables, acceptsNull);
+}
+function validVariableEntries(variables, acceptsNull) {
+    return Object.entries(variables).every(([name, variable]) => !name.includes("\0") &&
+        (typeof variable === "string" ? !variable.includes("\0") : acceptsNull && variable === null));
+}
+function resolveOutput(value) {
+    if (value === undefined)
+        return Object.freeze({ mode: "discard" });
+    const output = snapshotExactClosedRecord(value, ["mode"]);
+    if (output === undefined)
+        return undefined;
+    if (output.mode !== "discard" && output.mode !== "transcript")
+        return undefined;
+    return Object.freeze({ mode: output.mode });
+}
+function validOutput(value) {
+    const output = snapshotExactClosedRecord(value, ["mode"]);
+    return output !== undefined && (output.mode === "discard" || output.mode === "transcript");
+}
+//# sourceMappingURL=options.mjs.map