@zxyycom/vibe-check 0.0.1

package/dist/esm/package-checks/project-files/gitlink-worktree.mjs

@@ -0,0 +1,72 @@
+/** Canonical Git worktree checks for gitlink traversal. */
+import { realpathSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+import { errorMessage } from "../host-environment/error-message.mjs";
+import { processFailed } from "../host-environment/process/command.mjs";
+import { runGit } from "../host-environment/git.mjs";
+export function canonicalRepositoryPath(repository) {
+    return realpathSync(resolve(repository));
+}
+export function inspectGitlinkWorktree({ gitlinkPath, repository }) {
+    const submoduleRepository = resolve(repository, gitlinkPath);
+    let canonicalSubmoduleRepository;
+    try {
+        if (!statSync(submoduleRepository).isDirectory())
+            return { kind: "missing" };
+        canonicalSubmoduleRepository = canonicalRepositoryPath(submoduleRepository);
+    }
+    catch (error) {
+        return missingPath(error)
+            ? { kind: "missing" }
+            : inspectionFailure(`could not inspect submodule worktree ${gitlinkPath}`, error);
+    }
+    const topLevelResult = runGit({
+        args: ["rev-parse", "--show-toplevel"],
+        cwd: canonicalSubmoduleRepository
+    });
+    if (processFailed(topLevelResult)) {
+        const topLevelFailureDetail = topLevelResult.error?.message ||
+            topLevelResult.stderr.trim() ||
+            `exit ${topLevelResult.status}`;
+        return {
+            kind: "inspection-failed",
+            error: `git rev-parse --show-toplevel failed while inspecting submodule ${gitlinkPath}: ${topLevelFailureDetail}`
+        };
+    }
+    const topLevel = topLevelResult.stdout.trim();
+    if (!topLevel) {
+        return {
+            kind: "inspection-failed",
+            error: `git rev-parse --show-toplevel returned no repository path for submodule ${gitlinkPath}`
+        };
+    }
+    try {
+        return canonicalRepositoryPath(resolve(canonicalSubmoduleRepository, topLevel)) ===
+            canonicalSubmoduleRepository
+            ? { kind: "initialized", repository: canonicalSubmoduleRepository }
+            : { kind: "not-independent" };
+    }
+    catch (error) {
+        return inspectionFailure(`could not resolve Git top-level for submodule ${gitlinkPath}`, error);
+    }
+}
+export function resolveDescendableGitlinkRepository({ gitlinkPath, repository, visitedRepositories }) {
+    const inspection = inspectGitlinkWorktree({ gitlinkPath, repository });
+    if (inspection.kind === "inspection-failed") {
+        throw new Error(inspection.error);
+    }
+    return inspection.kind === "initialized" && !visitedRepositories.has(inspection.repository)
+        ? inspection.repository
+        : null;
+}
+export function visitRepository({ repository, visitedRepositories }) {
+    return new Set([...visitedRepositories, repository]);
+}
+function missingPath(error) {
+    const code = error instanceof Error && "code" in error ? error.code : undefined;
+    return code === "ENOENT" || code === "ENOTDIR";
+}
+function inspectionFailure(message, error) {
+    return { kind: "inspection-failed", error: `${message}: ${errorMessage(error)}` };
+}
+//# sourceMappingURL=gitlink-worktree.mjs.map

package/dist/esm/package-checks/project-files/gitlink-worktree.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlink-worktree.mjs","sourceRoot":"","sources":["../../../../src/package-checks/project-files/gitlink-worktree.ts"],"names":[],"mappings":"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","sourcesContent":["/** Canonical Git worktree checks for gitlink traversal. */\n\nimport { realpathSync, statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nimport { errorMessage } from \"../host-environment/error-message.ts\";\nimport { processFailed } from \"../host-environment/process/command.ts\";\nimport { runGit } from \"../host-environment/git.ts\";\n\nexport type GitlinkWorktreeInspection =\n  | { readonly kind: \"initialized\"; readonly repository: string }\n  | { readonly kind: \"inspection-failed\"; readonly error: string }\n  | { readonly kind: \"missing\" }\n  | { readonly kind: \"not-independent\" };\n\nexport function canonicalRepositoryPath(repository: string): string {\n  return realpathSync(resolve(repository));\n}\n\nexport function inspectGitlinkWorktree({\n  gitlinkPath,\n  repository\n}: Readonly<{\n  readonly gitlinkPath: string;\n  readonly repository: string;\n}>): GitlinkWorktreeInspection {\n  const submoduleRepository = resolve(repository, gitlinkPath);\n  let canonicalSubmoduleRepository: string;\n  try {\n    if (!statSync(submoduleRepository).isDirectory()) return { kind: \"missing\" };\n    canonicalSubmoduleRepository = canonicalRepositoryPath(submoduleRepository);\n  } catch (error: unknown) {\n    return missingPath(error)\n      ? { kind: \"missing\" }\n      : inspectionFailure(`could not inspect submodule worktree ${gitlinkPath}`, error);\n  }\n\n  const topLevelResult = runGit({\n    args: [\"rev-parse\", \"--show-toplevel\"],\n    cwd: canonicalSubmoduleRepository\n  });\n  if (processFailed(topLevelResult)) {\n    const topLevelFailureDetail =\n      topLevelResult.error?.message ||\n      topLevelResult.stderr.trim() ||\n      `exit ${topLevelResult.status}`;\n    return {\n      kind: \"inspection-failed\",\n      error: `git rev-parse --show-toplevel failed while inspecting submodule ${gitlinkPath}: ${topLevelFailureDetail}`\n    };\n  }\n\n  const topLevel = topLevelResult.stdout.trim();\n  if (!topLevel) {\n    return {\n      kind: \"inspection-failed\",\n      error: `git rev-parse --show-toplevel returned no repository path for submodule ${gitlinkPath}`\n    };\n  }\n\n  try {\n    return canonicalRepositoryPath(resolve(canonicalSubmoduleRepository, topLevel)) ===\n      canonicalSubmoduleRepository\n      ? { kind: \"initialized\", repository: canonicalSubmoduleRepository }\n      : { kind: \"not-independent\" };\n  } catch (error: unknown) {\n    return inspectionFailure(`could not resolve Git top-level for submodule ${gitlinkPath}`, error);\n  }\n}\n\nexport function resolveDescendableGitlinkRepository({\n  gitlinkPath,\n  repository,\n  visitedRepositories\n}: Readonly<{\n  readonly gitlinkPath: string;\n  readonly repository: string;\n  readonly visitedRepositories: ReadonlySet<string>;\n}>): string | null {\n  const inspection = inspectGitlinkWorktree({ gitlinkPath, repository });\n  if (inspection.kind === \"inspection-failed\") {\n    throw new Error(inspection.error);\n  }\n  return inspection.kind === \"initialized\" && !visitedRepositories.has(inspection.repository)\n    ? inspection.repository\n    : null;\n}\n\nexport function visitRepository({\n  repository,\n  visitedRepositories\n}: Readonly<{\n  readonly repository: string;\n  readonly visitedRepositories: ReadonlySet<string>;\n}>): ReadonlySet<string> {\n  return new Set([...visitedRepositories, repository]);\n}\n\nfunction missingPath(error: unknown): boolean {\n  const code = error instanceof Error && \"code\" in error ? error.code : undefined;\n  return code === \"ENOENT\" || code === \"ENOTDIR\";\n}\n\nfunction inspectionFailure(message: string, error: unknown): GitlinkWorktreeInspection {\n  return { kind: \"inspection-failed\", error: `${message}: ${errorMessage(error)}` };\n}\n"]}

package/dist/esm/package-checks/project-files/input-eligibility.mjs

@@ -0,0 +1,13 @@
+/** 保持输入顺序，将每个 selected path 恰好分配给 accepted 或 rejected。 */
+export function partitionProjectFilesByEligibility(selectedPaths, accepts) {
+    const acceptedPaths = [];
+    const rejectedPaths = [];
+    for (const path of selectedPaths) {
+        (accepts(path) ? acceptedPaths : rejectedPaths).push(path);
+    }
+    return Object.freeze({
+        acceptedPaths: Object.freeze(acceptedPaths),
+        rejectedPaths: Object.freeze(rejectedPaths)
+    });
+}
+//# sourceMappingURL=input-eligibility.mjs.map

package/dist/esm/package-checks/project-files/input-eligibility.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-eligibility.mjs","sourceRoot":"","sources":["../../../../src/package-checks/project-files/input-eligibility.ts"],"names":[],"mappings":"AAMA,0DAA0D;AAC1D,MAAM,UAAU,kCAAkC,CAChD,aAAgC,EAChC,OAAkC;IAElC,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3C,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;KAC5C,CAAC,CAAC;AACL,CAAC","sourcesContent":["/** 一个 Check 对完整 selected path set 做 eligibility 分类后的结果。 */\nexport interface ProjectFileEligibilityPartition {\n  readonly acceptedPaths: readonly string[];\n  readonly rejectedPaths: readonly string[];\n}\n\n/** 保持输入顺序，将每个 selected path 恰好分配给 accepted 或 rejected。 */\nexport function partitionProjectFilesByEligibility(\n  selectedPaths: readonly string[],\n  accepts: (path: string) => boolean\n): ProjectFileEligibilityPartition {\n  const acceptedPaths: string[] = [];\n  const rejectedPaths: string[] = [];\n  for (const path of selectedPaths) {\n    (accepts(path) ? acceptedPaths : rejectedPaths).push(path);\n  }\n  return Object.freeze({\n    acceptedPaths: Object.freeze(acceptedPaths),\n    rejectedPaths: Object.freeze(rejectedPaths)\n  });\n}\n"]}

package/dist/esm/package-checks/project-files/reported-path.mjs

@@ -0,0 +1,30 @@
+import path from "node:path";
+import { toSlashPath } from "../host-environment/path.mjs";
+export function normalizeScannerReportedPath(reportedPath, projectRoot) {
+    const normalizedReportedPath = stripWindowsExtendedPathPrefix(reportedPath);
+    const normalizedProjectRoot = stripWindowsExtendedPathPrefix(projectRoot);
+    const pathApi = pathApiForScannerPath(normalizedReportedPath, normalizedProjectRoot);
+    const nativePath = pathApi.normalize(normalizedReportedPath);
+    const projectRelativePath = pathApi.isAbsolute(nativePath)
+        ? pathApi.relative(pathApi.normalize(normalizedProjectRoot), nativePath)
+        : nativePath;
+    return toSlashPath(projectRelativePath);
+}
+function stripWindowsExtendedPathPrefix(filePath) {
+    if (filePath.startsWith("\\\\?\\UNC\\")) {
+        return `\\\\${filePath.slice(8)}`;
+    }
+    if (filePath.startsWith("\\\\?\\")) {
+        return filePath.slice(4);
+    }
+    return filePath;
+}
+function pathApiForScannerPath(reportedPath, projectRoot) {
+    return isWindowsAbsolutePath(reportedPath) || isWindowsAbsolutePath(projectRoot)
+        ? path.win32
+        : path;
+}
+function isWindowsAbsolutePath(filePath) {
+    return /^[A-Za-z]:[\\/]/u.test(filePath) || filePath.startsWith("\\\\");
+}
+//# sourceMappingURL=reported-path.mjs.map

package/dist/esm/package-checks/project-files/reported-path.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reported-path.mjs","sourceRoot":"","sources":["../../../../src/package-checks/project-files/reported-path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,UAAU,4BAA4B,CAAC,YAAoB,EAAE,WAAmB;IACpF,MAAM,sBAAsB,GAAG,8BAA8B,CAAC,YAAY,CAAC,CAAC;IAC5E,MAAM,qBAAqB,GAAG,8BAA8B,CAAC,WAAW,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,qBAAqB,CAAC,sBAAsB,EAAE,qBAAqB,CAAC,CAAC;IACrF,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;IAC7D,MAAM,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC;QACxD,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,qBAAqB,CAAC,EAAE,UAAU,CAAC;QACxE,CAAC,CAAC,UAAU,CAAC;IAEf,OAAO,WAAW,CAAC,mBAAmB,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,8BAA8B,CAAC,QAAgB;IACtD,IAAI,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACxC,OAAO,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,qBAAqB,CAAC,YAAoB,EAAE,WAAmB;IACtE,OAAO,qBAAqB,CAAC,YAAY,CAAC,IAAI,qBAAqB,CAAC,WAAW,CAAC;QAC9E,CAAC,CAAC,IAAI,CAAC,KAAK;QACZ,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAgB;IAC7C,OAAO,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAC1E,CAAC","sourcesContent":["import path from \"node:path\";\n\nimport { toSlashPath } from \"../host-environment/path.ts\";\n\nexport function normalizeScannerReportedPath(reportedPath: string, projectRoot: string): string {\n  const normalizedReportedPath = stripWindowsExtendedPathPrefix(reportedPath);\n  const normalizedProjectRoot = stripWindowsExtendedPathPrefix(projectRoot);\n  const pathApi = pathApiForScannerPath(normalizedReportedPath, normalizedProjectRoot);\n  const nativePath = pathApi.normalize(normalizedReportedPath);\n  const projectRelativePath = pathApi.isAbsolute(nativePath)\n    ? pathApi.relative(pathApi.normalize(normalizedProjectRoot), nativePath)\n    : nativePath;\n\n  return toSlashPath(projectRelativePath);\n}\n\nfunction stripWindowsExtendedPathPrefix(filePath: string): string {\n  if (filePath.startsWith(\"\\\\\\\\?\\\\UNC\\\\\")) {\n    return `\\\\\\\\${filePath.slice(8)}`;\n  }\n  if (filePath.startsWith(\"\\\\\\\\?\\\\\")) {\n    return filePath.slice(4);\n  }\n  return filePath;\n}\n\nfunction pathApiForScannerPath(reportedPath: string, projectRoot: string): path.PlatformPath {\n  return isWindowsAbsolutePath(reportedPath) || isWindowsAbsolutePath(projectRoot)\n    ? path.win32\n    : path;\n}\n\nfunction isWindowsAbsolutePath(filePath: string): boolean {\n  return /^[A-Za-z]:[\\\\/]/u.test(filePath) || filePath.startsWith(\"\\\\\\\\\");\n}\n"]}

package/dist/esm/package-checks/project-files/revision-paths.mjs

@@ -0,0 +1,19 @@
+/** Path and Git-output projections shared by revision traversal helpers. */
+import { toSlashPath } from "../host-environment/path.mjs";
+import { matchesAnyConfigGlob } from "./config-glob.mjs";
+export function uniqueSortedPaths(files) {
+    return [...new Set(files.map(toSlashPath))].sort();
+}
+export function prefixAndFilter({ files, prefix, scanInputPaths }) {
+    return files
+        .map((file) => joinSlash({ path: file, prefix }))
+        .filter((file) => scanInputPaths.length === 0 || matchesAnyConfigGlob(file, scanInputPaths));
+}
+export function joinSlash({ path, prefix }) {
+    return prefix ? `${toSlashPath(prefix)}/${toSlashPath(path)}` : toSlashPath(path);
+}
+export function nonEmptyGitOutput(stdout) {
+    const value = (stdout || "").trim();
+    return value || null;
+}
+//# sourceMappingURL=revision-paths.mjs.map

package/dist/esm/package-checks/project-files/revision-paths.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision-paths.mjs","sourceRoot":"","sources":["../../../../src/package-checks/project-files/revision-paths.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,UAAU,iBAAiB,CAAC,KAAwB;IACxD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAC9B,KAAK,EACL,MAAM,EACN,cAAc,EAKd;IACA,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;SAChD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,oBAAoB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EACxB,IAAI,EACJ,MAAM,EACuD;IAC7D,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAiC;IACjE,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC","sourcesContent":["/** Path and Git-output projections shared by revision traversal helpers. */\n\nimport { toSlashPath } from \"../host-environment/path.ts\";\nimport { matchesAnyConfigGlob } from \"./config-glob.ts\";\n\nexport function uniqueSortedPaths(files: readonly string[]): string[] {\n  return [...new Set(files.map(toSlashPath))].sort();\n}\n\nexport function prefixAndFilter({\n  files,\n  prefix,\n  scanInputPaths\n}: Readonly<{\n  readonly files: readonly string[];\n  readonly prefix: string;\n  readonly scanInputPaths: readonly string[];\n}>): string[] {\n  return files\n    .map((file) => joinSlash({ path: file, prefix }))\n    .filter((file) => scanInputPaths.length === 0 || matchesAnyConfigGlob(file, scanInputPaths));\n}\n\nexport function joinSlash({\n  path,\n  prefix\n}: Readonly<{ readonly path: string; readonly prefix: string }>): string {\n  return prefix ? `${toSlashPath(prefix)}/${toSlashPath(path)}` : toSlashPath(path);\n}\n\nexport function nonEmptyGitOutput(stdout: string | null | undefined): string | null {\n  const value = (stdout || \"\").trim();\n  return value || null;\n}\n"]}

package/dist/esm/package-checks/project-files/revision-worktree-files.mjs

@@ -0,0 +1,102 @@
+/** Enumerates files from initialized, non-cyclic submodule working trees. */
+import { processFailed } from "../host-environment/process/command.mjs";
+import { runGit, splitNulDelimitedGitFileList } from "../host-environment/git.mjs";
+import { canonicalRepositoryPath, resolveDescendableGitlinkRepository, visitRepository } from "./gitlink-worktree.mjs";
+import { gitlinksAtRevision } from "./gitlink-revision.mjs";
+import { joinSlash, nonEmptyGitOutput, prefixAndFilter, uniqueSortedPaths } from "./revision-paths.mjs";
+export function collectSubmoduleWorktreeFiles({ repository, scanInputPaths }) {
+    const files = [];
+    const visitedRepositories = new Set([canonicalRepositoryPath(repository)]);
+    const revision = worktreeRevision(repository);
+    if (revision === null)
+        return files;
+    for (const gitlink of gitlinksAtRevision({ repository, revision })) {
+        const submoduleRepository = resolveDescendableGitlinkRepository({
+            gitlinkPath: gitlink.path,
+            repository,
+            visitedRepositories
+        });
+        if (!submoduleRepository)
+            continue;
+        files.push(...collectWorktreeFiles({
+            prefix: gitlink.path,
+            repository: submoduleRepository,
+            scanInputPaths,
+            visitedRepositories: visitRepository({
+                repository: submoduleRepository,
+                visitedRepositories
+            })
+        }));
+    }
+    return uniqueSortedPaths(files);
+}
+function collectWorktreeFiles({ prefix, repository, scanInputPaths, visitedRepositories }) {
+    const result = runGit({
+        args: ["ls-files", "-z", "--cached", "--others", "--exclude-standard", "--"],
+        cwd: repository
+    });
+    if (processFailed(result)) {
+        const detail = result.stderr.trim() ||
+            result.error?.message ||
+            (result.signal === null ? `exit status ${result.status}` : `signal ${result.signal}`);
+        throw new Error(`could not enumerate git-worktree files in ${repository}: ${detail}`);
+    }
+    const files = prefixAndFilter({
+        files: splitNulDelimitedGitFileList(result.stdout),
+        prefix,
+        scanInputPaths
+    });
+    const revision = worktreeRevision(repository);
+    if (revision === null)
+        return uniqueSortedPaths(files);
+    files.push(...collectNestedWorktreeFiles({
+        prefix,
+        repository,
+        revision,
+        scanInputPaths,
+        visitedRepositories
+    }));
+    return uniqueSortedPaths(files);
+}
+function collectNestedWorktreeFiles({ prefix, repository, revision, scanInputPaths, visitedRepositories }) {
+    const files = [];
+    for (const gitlink of gitlinksAtRevision({ repository, revision })) {
+        const submoduleRepository = resolveDescendableGitlinkRepository({
+            gitlinkPath: gitlink.path,
+            repository,
+            visitedRepositories
+        });
+        if (!submoduleRepository)
+            continue;
+        files.push(...collectWorktreeFiles({
+            prefix: joinSlash({ path: gitlink.path, prefix }),
+            repository: submoduleRepository,
+            scanInputPaths,
+            visitedRepositories: visitRepository({
+                repository: submoduleRepository,
+                visitedRepositories
+            })
+        }));
+    }
+    return files;
+}
+function worktreeRevision(repository) {
+    const result = runGit({ args: ["rev-parse", "--verify", "--quiet", "HEAD"], cwd: repository });
+    if (!processFailed(result)) {
+        const revision = nonEmptyGitOutput(result.stdout);
+        if (revision !== null)
+            return revision;
+        throw new Error(`git-worktree revision inspection returned no revision in ${repository}`);
+    }
+    const headDoesNotExist = result.error === undefined &&
+        result.signal === null &&
+        result.status === 1 &&
+        result.stderr.trim() === "";
+    if (headDoesNotExist)
+        return null;
+    const detail = result.stderr.trim() ||
+        result.error?.message ||
+        (result.signal === null ? `exit status ${result.status}` : `signal ${result.signal}`);
+    throw new Error(`could not inspect git-worktree revision in ${repository}: ${detail}`);
+}
+//# sourceMappingURL=revision-worktree-files.mjs.map

package/dist/esm/package-checks/project-files/revision-worktree-files.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision-worktree-files.mjs","sourceRoot":"","sources":["../../../../src/package-checks/project-files/revision-worktree-files.ts"],"names":[],"mappings":"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","sourcesContent":["/** Enumerates files from initialized, non-cyclic submodule working trees. */\n\nimport { processFailed } from \"../host-environment/process/command.ts\";\nimport { runGit, splitNulDelimitedGitFileList } from \"../host-environment/git.ts\";\nimport {\n  canonicalRepositoryPath,\n  resolveDescendableGitlinkRepository,\n  visitRepository\n} from \"./gitlink-worktree.ts\";\nimport { gitlinksAtRevision } from \"./gitlink-revision.ts\";\nimport {\n  joinSlash,\n  nonEmptyGitOutput,\n  prefixAndFilter,\n  uniqueSortedPaths\n} from \"./revision-paths.ts\";\n\nexport function collectSubmoduleWorktreeFiles({\n  repository,\n  scanInputPaths\n}: Readonly<{\n  readonly repository: string;\n  readonly scanInputPaths: readonly string[];\n}>): string[] {\n  const files: string[] = [];\n  const visitedRepositories = new Set([canonicalRepositoryPath(repository)]);\n  const revision = worktreeRevision(repository);\n  if (revision === null) return files;\n\n  for (const gitlink of gitlinksAtRevision({ repository, revision })) {\n    const submoduleRepository = resolveDescendableGitlinkRepository({\n      gitlinkPath: gitlink.path,\n      repository,\n      visitedRepositories\n    });\n    if (!submoduleRepository) continue;\n    files.push(\n      ...collectWorktreeFiles({\n        prefix: gitlink.path,\n        repository: submoduleRepository,\n        scanInputPaths,\n        visitedRepositories: visitRepository({\n          repository: submoduleRepository,\n          visitedRepositories\n        })\n      })\n    );\n  }\n  return uniqueSortedPaths(files);\n}\n\nfunction collectWorktreeFiles({\n  prefix,\n  repository,\n  scanInputPaths,\n  visitedRepositories\n}: Readonly<{\n  readonly prefix: string;\n  readonly repository: string;\n  readonly scanInputPaths: readonly string[];\n  readonly visitedRepositories: ReadonlySet<string>;\n}>): string[] {\n  const result = runGit({\n    args: [\"ls-files\", \"-z\", \"--cached\", \"--others\", \"--exclude-standard\", \"--\"],\n    cwd: repository\n  });\n  if (processFailed(result)) {\n    const detail =\n      result.stderr.trim() ||\n      result.error?.message ||\n      (result.signal === null ? `exit status ${result.status}` : `signal ${result.signal}`);\n    throw new Error(`could not enumerate git-worktree files in ${repository}: ${detail}`);\n  }\n\n  const files = prefixAndFilter({\n    files: splitNulDelimitedGitFileList(result.stdout),\n    prefix,\n    scanInputPaths\n  });\n  const revision = worktreeRevision(repository);\n  if (revision === null) return uniqueSortedPaths(files);\n  files.push(\n    ...collectNestedWorktreeFiles({\n      prefix,\n      repository,\n      revision,\n      scanInputPaths,\n      visitedRepositories\n    })\n  );\n  return uniqueSortedPaths(files);\n}\n\nfunction collectNestedWorktreeFiles({\n  prefix,\n  repository,\n  revision,\n  scanInputPaths,\n  visitedRepositories\n}: Readonly<{\n  readonly prefix: string;\n  readonly repository: string;\n  readonly revision: string;\n  readonly scanInputPaths: readonly string[];\n  readonly visitedRepositories: ReadonlySet<string>;\n}>): string[] {\n  const files: string[] = [];\n  for (const gitlink of gitlinksAtRevision({ repository, revision })) {\n    const submoduleRepository = resolveDescendableGitlinkRepository({\n      gitlinkPath: gitlink.path,\n      repository,\n      visitedRepositories\n    });\n    if (!submoduleRepository) continue;\n    files.push(\n      ...collectWorktreeFiles({\n        prefix: joinSlash({ path: gitlink.path, prefix }),\n        repository: submoduleRepository,\n        scanInputPaths,\n        visitedRepositories: visitRepository({\n          repository: submoduleRepository,\n          visitedRepositories\n        })\n      })\n    );\n  }\n  return files;\n}\n\nfunction worktreeRevision(repository: string): string | null {\n  const result = runGit({ args: [\"rev-parse\", \"--verify\", \"--quiet\", \"HEAD\"], cwd: repository });\n  if (!processFailed(result)) {\n    const revision = nonEmptyGitOutput(result.stdout);\n    if (revision !== null) return revision;\n    throw new Error(`git-worktree revision inspection returned no revision in ${repository}`);\n  }\n  const headDoesNotExist =\n    result.error === undefined &&\n    result.signal === null &&\n    result.status === 1 &&\n    result.stderr.trim() === \"\";\n  if (headDoesNotExist) return null;\n  const detail =\n    result.stderr.trim() ||\n    result.error?.message ||\n    (result.signal === null ? `exit status ${result.status}` : `signal ${result.signal}`);\n  throw new Error(`could not inspect git-worktree revision in ${repository}: ${detail}`);\n}\n"]}

package/dist/esm/project-definition/check-tree/authoring.mjs

@@ -0,0 +1,242 @@
+import { isInheritedCheckCollection, snapshotInheritedCheckCollection } from "../../check/check.mjs";
+import { snapshotClosedArray, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { validateCheckDescriptor } from "../../check/descriptor-validation.mjs";
+import { snapshotJsonObject } from "../../check/options-snapshot.mjs";
+const CHECK_KEYS = [
+    "checkId",
+    "checks",
+    "dependsOn",
+    "displayName",
+    "execution",
+    "maxParallel",
+    "mutex",
+    "options",
+    "parseData",
+    "preflight",
+    "visibility"
+];
+const CONTAINER_CHECK_FIELDS = Object.freeze({
+    definition: null,
+    execution: null,
+    options: null,
+    parseData: null,
+    preflight: null,
+    visibility: null
+});
+/**
+ * Parses only the closed recursive authoring grammar. Execution callbacks are
+ * trusted project code, while every declarative field is copied and validated.
+ */
+export function parseCheckTreeAuthoring(value) {
+    const roots = snapshotClosedArray(value);
+    if (roots === undefined)
+        return undefined;
+    const state = { warnings: [] };
+    const checks = [];
+    for (let index = 0; index < roots.length; index += 1) {
+        const check = parseCheck(roots[index], `definition.checks[${index}]`, state);
+        if (check === undefined)
+            return undefined;
+        checks.push(check);
+    }
+    return Object.freeze({
+        checks: Object.freeze(checks),
+        warnings: Object.freeze(state.warnings)
+    });
+}
+function parseCheck(value, path, state) {
+    const data = parseCheckData(value);
+    if (data === undefined)
+        return undefined;
+    const execution = parseExecution(data);
+    if (execution === undefined)
+        return undefined;
+    const parseData = parseDataParser(data);
+    if (parseData === undefined)
+        return undefined;
+    const preflight = parsePreflight(data);
+    if (preflight === undefined)
+        return undefined;
+    const checks = parseChildren(data, path, state);
+    if (checks === undefined)
+        return undefined;
+    const scheduling = parseScheduling(data);
+    if (scheduling === undefined)
+        return undefined;
+    const fields = parseCheckFields(data, execution, parseData, preflight);
+    if (fields === undefined)
+        return undefined;
+    warnForMeaninglessCheck(data, checks, fields, path, state);
+    return Object.freeze({
+        checkId: data.checkId,
+        checks,
+        definition: fields.definition,
+        dependsOn: scheduling.dependsOn,
+        displayName: data.displayName,
+        execution: fields.execution,
+        maxParallel: scheduling.maxParallel,
+        mutex: scheduling.mutex,
+        options: fields.options,
+        path,
+        parseData: fields.parseData,
+        preflight: fields.preflight,
+        visibility: fields.visibility
+    });
+}
+function parseCheckData(value) {
+    const data = snapshotClosedRecord(value);
+    if (data === undefined)
+        return undefined;
+    return hasValidCheckIdentity(data) ? data : undefined;
+}
+function hasValidCheckIdentity(data) {
+    return (hasOnlyCheckKeys(data) &&
+        typeof data.checkId === "string" &&
+        data.checkId.length > 0 &&
+        typeof data.displayName === "string" &&
+        data.displayName.length > 0);
+}
+function hasOnlyCheckKeys(data) {
+    return Object.keys(data).every((key) => CHECK_KEYS.some((checkKey) => checkKey === key));
+}
+function parseExecution(data) {
+    if (!Object.hasOwn(data, "execution"))
+        return null;
+    return isTrustedFunction(data.execution) ? data.execution : undefined;
+}
+function parseDataParser(data) {
+    if (!Object.hasOwn(data, "parseData") || data.parseData === undefined)
+        return null;
+    return isTrustedFunction(data.parseData) ? data.parseData : undefined;
+}
+function parsePreflight(data) {
+    if (!Object.hasOwn(data, "preflight"))
+        return null;
+    return isTrustedFunction(data.preflight) ? data.preflight : undefined;
+}
+function isTrustedFunction(value) {
+    return typeof value === "function";
+}
+function parseChildren(data, path, state) {
+    if (!Object.hasOwn(data, "checks"))
+        return Object.freeze([]);
+    const values = snapshotClosedArray(data.checks);
+    if (values === undefined)
+        return undefined;
+    const checks = [];
+    for (let index = 0; index < values.length; index += 1) {
+        const check = parseCheck(values[index], `${path}.checks[${index}]`, state);
+        if (check === undefined)
+            return undefined;
+        checks.push(check);
+    }
+    return Object.freeze(checks);
+}
+function parseDefinition(data) {
+    const definition = validateCheckDescriptor({
+        checkId: data.checkId,
+        displayName: data.displayName
+    });
+    return definition.ok ? definition.value : undefined;
+}
+function parseOptions(data) {
+    if (!Object.hasOwn(data, "options"))
+        return Object.freeze({});
+    const options = snapshotClosedRecord(data.options);
+    if (options === undefined)
+        return undefined;
+    return snapshotJsonObject(options);
+}
+function parseCheckFields(data, execution, parseData, preflight) {
+    if (execution === null) {
+        return Object.hasOwn(data, "options") ||
+            Object.hasOwn(data, "visibility") ||
+            parseData !== null ||
+            preflight !== null
+            ? undefined
+            : CONTAINER_CHECK_FIELDS;
+    }
+    const definition = parseDefinition(data);
+    if (definition === undefined)
+        return undefined;
+    const options = parseOptions(data);
+    if (options === undefined)
+        return undefined;
+    const visibility = parseVisibility(data);
+    if (visibility === undefined)
+        return undefined;
+    return Object.freeze({
+        definition,
+        execution,
+        options,
+        parseData,
+        preflight,
+        visibility
+    });
+}
+function parseVisibility(data) {
+    if (!Object.hasOwn(data, "visibility"))
+        return "always";
+    const visibility = data.visibility;
+    return visibility === undefined || visibility === "always" || visibility === "attention"
+        ? (visibility ?? "always")
+        : undefined;
+}
+function warnForMeaninglessCheck(data, checks, fields, path, state) {
+    if (fields.execution !== null || checks.length > 0)
+        return;
+    state.warnings.push(Object.freeze({ code: "meaningless-check", path, checkId: data.checkId }));
+}
+function parseScheduling(data) {
+    const dependsOn = parseCollection(data, "dependsOn");
+    const mutex = parseCollection(data, "mutex");
+    const maxParallel = data.maxParallel;
+    if (dependsOn === null ||
+        mutex === null ||
+        (maxParallel !== undefined &&
+            (typeof maxParallel !== "number" || !Number.isSafeInteger(maxParallel) || maxParallel <= 0)))
+        return undefined;
+    return Object.freeze({
+        dependsOn: dependsOn ?? undefined,
+        maxParallel,
+        mutex: mutex ?? undefined
+    });
+}
+function parseCollection(data, field) {
+    if (!Object.hasOwn(data, field))
+        return undefined;
+    const value = data[field];
+    if (isInheritedCheckCollection(value))
+        return parseInheritedCollection(value);
+    const values = parseCollectionItems(value);
+    return values === undefined ? null : Object.freeze({ kind: "exact", values });
+}
+function parseInheritedCollection(value) {
+    const data = snapshotInheritedCheckCollection(value);
+    if (data === undefined || !hasExactInheritedKeys(data))
+        return null;
+    const add = data.add === undefined ? Object.freeze([]) : parseCollectionItems(data.add);
+    const remove = data.remove === undefined ? Object.freeze([]) : parseCollectionItems(data.remove);
+    if (add === undefined || remove === undefined)
+        return null;
+    return Object.freeze({ kind: "inherit", add, remove });
+}
+function hasExactInheritedKeys(data) {
+    const keys = Object.keys(data);
+    return keys.length > 0 && keys.every((key) => key === "add" || key === "remove");
+}
+function parseCollectionItems(value) {
+    const items = snapshotClosedArray(value);
+    if (items === undefined)
+        return undefined;
+    const values = [];
+    for (const item of items) {
+        const valid = typeof item === "string" && item.length > 0;
+        if (!valid)
+            return undefined;
+        if (!values.includes(item))
+            values.push(item);
+    }
+    return Object.freeze(values);
+}
+//# sourceMappingURL=authoring.mjs.map

package/dist/esm/project-definition/check-tree/authoring.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.mjs","sourceRoot":"","sources":["../../../../src/project-definition/check-tree/authoring.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckDescriptor } from \"../../check/descriptor.ts\";\nimport {\n  isInheritedCheckCollection,\n  snapshotInheritedCheckCollection,\n  type CheckVisibility,\n  type CheckExecution,\n  type CheckPreflight,\n  type InheritedCheckCollection\n} from \"../../check/check.ts\";\nimport { snapshotClosedArray, snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { validateCheckDescriptor } from \"../../check/descriptor-validation.ts\";\nimport { snapshotJsonObject } from \"../../check/options-snapshot.ts\";\n\ntype TrustedDataParser = (this: void, ...parameters: never[]) => unknown;\n\nexport type ParsedCheckCollection = Readonly<\n  | { readonly kind: \"exact\"; readonly values: readonly string[] }\n  | {\n      readonly kind: \"inherit\";\n      readonly add: readonly string[];\n      readonly remove: readonly string[];\n    }\n>;\n\nexport interface ParsedCheck {\n  readonly checkId: string;\n  readonly checks: readonly ParsedCheck[];\n  readonly definition: CheckDescriptor | null;\n  readonly dependsOn: ParsedCheckCollection | undefined;\n  readonly displayName: string;\n  readonly execution: CheckExecution | null;\n  readonly maxParallel: number | undefined;\n  readonly mutex: ParsedCheckCollection | undefined;\n  readonly options: object | null;\n  readonly path: string;\n  readonly parseData: TrustedDataParser | null;\n  readonly preflight: CheckPreflight | null;\n  readonly visibility: CheckVisibility | null;\n}\n\nexport interface ParsedCheckTree {\n  readonly checks: readonly ParsedCheck[];\n  readonly warnings: readonly MeaninglessCheckWarning[];\n}\n\nexport interface MeaninglessCheckWarning {\n  readonly code: \"meaningless-check\";\n  readonly path: string;\n  readonly checkId: string;\n}\n\ninterface ParseState {\n  readonly warnings: MeaninglessCheckWarning[];\n}\n\ninterface CheckAuthoringData extends Readonly<Record<string, unknown>> {\n  readonly checkId: string;\n  readonly displayName: string;\n}\n\ninterface ParsedCheckFields {\n  readonly definition: CheckDescriptor | null;\n  readonly execution: CheckExecution | null;\n  readonly options: object | null;\n  readonly parseData: TrustedDataParser | null;\n  readonly preflight: CheckPreflight | null;\n  readonly visibility: CheckVisibility | null;\n}\n\nconst CHECK_KEYS = [\n  \"checkId\",\n  \"checks\",\n  \"dependsOn\",\n  \"displayName\",\n  \"execution\",\n  \"maxParallel\",\n  \"mutex\",\n  \"options\",\n  \"parseData\",\n  \"preflight\",\n  \"visibility\"\n] as const;\n\nconst CONTAINER_CHECK_FIELDS: ParsedCheckFields = Object.freeze({\n  definition: null,\n  execution: null,\n  options: null,\n  parseData: null,\n  preflight: null,\n  visibility: null\n});\n\n/**\n * Parses only the closed recursive authoring grammar. Execution callbacks are\n * trusted project code, while every declarative field is copied and validated.\n */\nexport function parseCheckTreeAuthoring(value: unknown): ParsedCheckTree | undefined {\n  const roots = snapshotClosedArray(value);\n  if (roots === undefined) return undefined;\n  const state: ParseState = { warnings: [] };\n  const checks: ParsedCheck[] = [];\n  for (let index = 0; index < roots.length; index += 1) {\n    const check = parseCheck(roots[index], `definition.checks[${index}]`, state);\n    if (check === undefined) return undefined;\n    checks.push(check);\n  }\n  return Object.freeze({\n    checks: Object.freeze(checks),\n    warnings: Object.freeze(state.warnings)\n  });\n}\n\nfunction parseCheck(value: unknown, path: string, state: ParseState): ParsedCheck | undefined {\n  const data = parseCheckData(value);\n  if (data === undefined) return undefined;\n  const execution = parseExecution(data);\n  if (execution === undefined) return undefined;\n  const parseData = parseDataParser(data);\n  if (parseData === undefined) return undefined;\n  const preflight = parsePreflight(data);\n  if (preflight === undefined) return undefined;\n  const checks = parseChildren(data, path, state);\n  if (checks === undefined) return undefined;\n  const scheduling = parseScheduling(data);\n  if (scheduling === undefined) return undefined;\n  const fields = parseCheckFields(data, execution, parseData, preflight);\n  if (fields === undefined) return undefined;\n  warnForMeaninglessCheck(data, checks, fields, path, state);\n\n  return Object.freeze({\n    checkId: data.checkId,\n    checks,\n    definition: fields.definition,\n    dependsOn: scheduling.dependsOn,\n    displayName: data.displayName,\n    execution: fields.execution,\n    maxParallel: scheduling.maxParallel,\n    mutex: scheduling.mutex,\n    options: fields.options,\n    path,\n    parseData: fields.parseData,\n    preflight: fields.preflight,\n    visibility: fields.visibility\n  });\n}\n\nfunction parseCheckData(value: unknown): CheckAuthoringData | undefined {\n  const data = snapshotClosedRecord(value);\n  if (data === undefined) return undefined;\n  return hasValidCheckIdentity(data) ? data : undefined;\n}\n\nfunction hasValidCheckIdentity(\n  data: Readonly<Record<string, unknown>>\n): data is CheckAuthoringData {\n  return (\n    hasOnlyCheckKeys(data) &&\n    typeof data.checkId === \"string\" &&\n    data.checkId.length > 0 &&\n    typeof data.displayName === \"string\" &&\n    data.displayName.length > 0\n  );\n}\n\nfunction hasOnlyCheckKeys(data: Readonly<Record<string, unknown>>): boolean {\n  return Object.keys(data).every((key) => CHECK_KEYS.some((checkKey) => checkKey === key));\n}\n\nfunction parseExecution(data: CheckAuthoringData): CheckExecution | null | undefined {\n  if (!Object.hasOwn(data, \"execution\")) return null;\n  return isTrustedFunction<CheckExecution>(data.execution) ? data.execution : undefined;\n}\n\nfunction parseDataParser(data: CheckAuthoringData): TrustedDataParser | null | undefined {\n  if (!Object.hasOwn(data, \"parseData\") || data.parseData === undefined) return null;\n  return isTrustedFunction<TrustedDataParser>(data.parseData) ? data.parseData : undefined;\n}\n\nfunction parsePreflight(data: CheckAuthoringData): CheckPreflight | null | undefined {\n  if (!Object.hasOwn(data, \"preflight\")) return null;\n  return isTrustedFunction<CheckPreflight>(data.preflight) ? data.preflight : undefined;\n}\n\nfunction isTrustedFunction<FunctionType extends (...parameters: never[]) => unknown>(\n  value: unknown\n): value is FunctionType {\n  return typeof value === \"function\";\n}\n\nfunction parseChildren(\n  data: CheckAuthoringData,\n  path: string,\n  state: ParseState\n): readonly ParsedCheck[] | undefined {\n  if (!Object.hasOwn(data, \"checks\")) return Object.freeze([]);\n  const values = snapshotClosedArray(data.checks);\n  if (values === undefined) return undefined;\n  const checks: ParsedCheck[] = [];\n  for (let index = 0; index < values.length; index += 1) {\n    const check = parseCheck(values[index], `${path}.checks[${index}]`, state);\n    if (check === undefined) return undefined;\n    checks.push(check);\n  }\n  return Object.freeze(checks);\n}\n\nfunction parseDefinition(data: CheckAuthoringData): CheckDescriptor | undefined {\n  const definition = validateCheckDescriptor({\n    checkId: data.checkId,\n    displayName: data.displayName\n  });\n  return definition.ok ? definition.value : undefined;\n}\n\nfunction parseOptions(data: CheckAuthoringData): object | undefined {\n  if (!Object.hasOwn(data, \"options\")) return Object.freeze({});\n  const options = snapshotClosedRecord(data.options);\n  if (options === undefined) return undefined;\n  return snapshotJsonObject(options);\n}\n\nfunction parseCheckFields(\n  data: CheckAuthoringData,\n  execution: CheckExecution | null,\n  parseData: TrustedDataParser | null,\n  preflight: CheckPreflight | null\n): ParsedCheckFields | undefined {\n  if (execution === null) {\n    return Object.hasOwn(data, \"options\") ||\n      Object.hasOwn(data, \"visibility\") ||\n      parseData !== null ||\n      preflight !== null\n      ? undefined\n      : CONTAINER_CHECK_FIELDS;\n  }\n  const definition = parseDefinition(data);\n  if (definition === undefined) return undefined;\n  const options = parseOptions(data);\n  if (options === undefined) return undefined;\n  const visibility = parseVisibility(data);\n  if (visibility === undefined) return undefined;\n  return Object.freeze({\n    definition,\n    execution,\n    options,\n    parseData,\n    preflight,\n    visibility\n  });\n}\n\nfunction parseVisibility(data: CheckAuthoringData): CheckVisibility | undefined {\n  if (!Object.hasOwn(data, \"visibility\")) return \"always\";\n  const visibility = data.visibility;\n  return visibility === undefined || visibility === \"always\" || visibility === \"attention\"\n    ? (visibility ?? \"always\")\n    : undefined;\n}\n\nfunction warnForMeaninglessCheck(\n  data: CheckAuthoringData,\n  checks: readonly ParsedCheck[],\n  fields: ParsedCheckFields,\n  path: string,\n  state: ParseState\n): void {\n  if (fields.execution !== null || checks.length > 0) return;\n  state.warnings.push(Object.freeze({ code: \"meaningless-check\", path, checkId: data.checkId }));\n}\n\nfunction parseScheduling(data: CheckAuthoringData):\n  | Readonly<{\n      readonly dependsOn: ParsedCheckCollection | undefined;\n      readonly maxParallel: number | undefined;\n      readonly mutex: ParsedCheckCollection | undefined;\n    }>\n  | undefined {\n  const dependsOn = parseCollection(data, \"dependsOn\");\n  const mutex = parseCollection(data, \"mutex\");\n  const maxParallel = data.maxParallel;\n  if (\n    dependsOn === null ||\n    mutex === null ||\n    (maxParallel !== undefined &&\n      (typeof maxParallel !== \"number\" || !Number.isSafeInteger(maxParallel) || maxParallel <= 0))\n  )\n    return undefined;\n  return Object.freeze({\n    dependsOn: dependsOn ?? undefined,\n    maxParallel,\n    mutex: mutex ?? undefined\n  });\n}\n\nfunction parseCollection(\n  data: CheckAuthoringData,\n  field: \"dependsOn\" | \"mutex\"\n): ParsedCheckCollection | null | undefined {\n  if (!Object.hasOwn(data, field)) return undefined;\n  const value = data[field];\n  if (isInheritedCheckCollection(value)) return parseInheritedCollection(value);\n  const values = parseCollectionItems(value);\n  return values === undefined ? null : Object.freeze({ kind: \"exact\", values });\n}\n\nfunction parseInheritedCollection(\n  value: InheritedCheckCollection<unknown>\n): ParsedCheckCollection | null {\n  const data = snapshotInheritedCheckCollection(value);\n  if (data === undefined || !hasExactInheritedKeys(data)) return null;\n  const add = data.add === undefined ? Object.freeze([]) : parseCollectionItems(data.add);\n  const remove = data.remove === undefined ? Object.freeze([]) : parseCollectionItems(data.remove);\n  if (add === undefined || remove === undefined) return null;\n  return Object.freeze({ kind: \"inherit\", add, remove });\n}\n\nfunction hasExactInheritedKeys(data: Readonly<Record<string, unknown>>): boolean {\n  const keys = Object.keys(data);\n  return keys.length > 0 && keys.every((key) => key === \"add\" || key === \"remove\");\n}\n\nfunction parseCollectionItems(value: unknown): readonly string[] | undefined {\n  const items = snapshotClosedArray(value);\n  if (items === undefined) return undefined;\n  const values: string[] = [];\n  for (const item of items) {\n    const valid = typeof item === \"string\" && item.length > 0;\n    if (!valid) return undefined;\n    if (!values.includes(item)) values.push(item);\n  }\n  return Object.freeze(values);\n}\n"]}

package/dist/esm/project-definition/check-tree/materialization.mjs

@@ -0,0 +1,50 @@
+import { inherit } from "../../check/check.mjs";
+/** Rebuilds the validated public authoring shape without retaining untyped input. */
+export function materializeCheckTreeAuthoring(parsed) {
+    return materializeChecks(parsed.checks);
+}
+function materializeChecks(checks) {
+    return Object.freeze(checks.map((check) => materializeCheck(check)));
+}
+function materializeCheck(check) {
+    const checks = materializeChecks(check.checks);
+    const dependsOn = materializeCollection(check.dependsOn);
+    const mutex = materializeCollection(check.mutex);
+    const visibility = check.visibility;
+    const preflight = check.preflight;
+    const scheduling = {
+        ...(dependsOn === undefined ? {} : { dependsOn }),
+        ...(check.maxParallel === undefined ? {} : { maxParallel: check.maxParallel }),
+        ...(mutex === undefined ? {} : { mutex })
+    };
+    if (check.definition === null ||
+        check.execution === null ||
+        check.options === null ||
+        visibility === null) {
+        return Object.freeze({
+            checkId: check.checkId,
+            checks,
+            displayName: check.displayName,
+            ...scheduling
+        });
+    }
+    return Object.freeze({
+        checkId: check.checkId,
+        checks,
+        displayName: check.displayName,
+        execution: check.execution,
+        ...(check.parseData === null ? {} : { parseData: check.parseData }),
+        options: check.options,
+        ...(preflight === null ? {} : { preflight }),
+        ...scheduling,
+        visibility
+    });
+}
+function materializeCollection(collection) {
+    if (collection === undefined)
+        return undefined;
+    if (collection.kind === "exact")
+        return collection.values;
+    return inherit({ add: collection.add, remove: collection.remove });
+}
+//# sourceMappingURL=materialization.mjs.map

package/dist/esm/project-definition/check-tree/materialization.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialization.mjs","sourceRoot":"","sources":["../../../../src/project-definition/check-tree/materialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA+C,MAAM,sBAAsB,CAAC;AAG5F,qFAAqF;AACrF,MAAM,UAAU,6BAA6B,CAAC,MAAuB;IACnE,OAAO,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,iBAAiB,CAAC,MAA8B;IACvD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAkB;IAC1C,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACpC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,MAAM,UAAU,GAAG;QACjB,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;QACjD,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;QAC9E,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC;IACF,IACE,KAAK,CAAC,UAAU,KAAK,IAAI;QACzB,KAAK,CAAC,SAAS,KAAK,IAAI;QACxB,KAAK,CAAC,OAAO,KAAK,IAAI;QACtB,UAAU,KAAK,IAAI,EACnB,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM;YACN,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,GAAG,UAAU;SACd,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM;QACN,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;QACnE,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;QAC5C,GAAG,UAAU;QACb,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAC5B,UAA6C;IAE7C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,UAAU,CAAC,MAAM,CAAC;IAC1D,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;AACrE,CAAC","sourcesContent":["import { inherit, type Check, type InheritableCheckCollection } from \"../../check/check.ts\";\nimport type { ParsedCheck, ParsedCheckCollection, ParsedCheckTree } from \"./authoring.ts\";\n\n/** Rebuilds the validated public authoring shape without retaining untyped input. */\nexport function materializeCheckTreeAuthoring(parsed: ParsedCheckTree): readonly Check[] {\n  return materializeChecks(parsed.checks);\n}\n\nfunction materializeChecks(checks: readonly ParsedCheck[]): readonly Check[] {\n  return Object.freeze(checks.map((check) => materializeCheck(check)));\n}\n\nfunction materializeCheck(check: ParsedCheck): Check {\n  const checks = materializeChecks(check.checks);\n  const dependsOn = materializeCollection(check.dependsOn);\n  const mutex = materializeCollection(check.mutex);\n  const visibility = check.visibility;\n  const preflight = check.preflight;\n  const scheduling = {\n    ...(dependsOn === undefined ? {} : { dependsOn }),\n    ...(check.maxParallel === undefined ? {} : { maxParallel: check.maxParallel }),\n    ...(mutex === undefined ? {} : { mutex })\n  };\n  if (\n    check.definition === null ||\n    check.execution === null ||\n    check.options === null ||\n    visibility === null\n  ) {\n    return Object.freeze({\n      checkId: check.checkId,\n      checks,\n      displayName: check.displayName,\n      ...scheduling\n    });\n  }\n  return Object.freeze({\n    checkId: check.checkId,\n    checks,\n    displayName: check.displayName,\n    execution: check.execution,\n    ...(check.parseData === null ? {} : { parseData: check.parseData }),\n    options: check.options,\n    ...(preflight === null ? {} : { preflight }),\n    ...scheduling,\n    visibility\n  });\n}\n\nfunction materializeCollection(\n  collection: ParsedCheckCollection | undefined\n): InheritableCheckCollection<string> | undefined {\n  if (collection === undefined) return undefined;\n  if (collection.kind === \"exact\") return collection.values;\n  return inherit({ add: collection.add, remove: collection.remove });\n}\n"]}