@zxyycom/vibe-check 0.0.1

package/dist/esm/package-checks/markdown-link-validation/resolver-engine.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver-engine.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/resolver-engine.ts"],"names":[],"mappings":"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","sourcesContent":["import { opendir } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport { parseMarkdownLinkFacts } from \"./markdown-parser.ts\";\nimport {\n  directoryTarget,\n  fileTargetDescriptor,\n  outsideProjectRootTarget,\n  projectTarget\n} from \"./target-descriptor.ts\";\nimport { probeEndpoint, probeRootContainedPath, readRegularFile } from \"./filesystem-probes.ts\";\nimport {\n  anchorResolution,\n  finding,\n  isMarkdownPath,\n  isRootRelativePath,\n  isWithinRoot,\n  parseLocalDestination,\n  sameRootRelativePath,\n  sourceUnavailable,\n  toSlashPath,\n  unavailable,\n  valid,\n  type MarkdownLocalResolution,\n  type MarkdownLocalResolutionRequest,\n  type MarkdownLocalResolver,\n  type MarkdownSafeTargetDescriptor,\n  type MarkdownSourceReadResult\n} from \"./local-resolution.ts\";\n\nexport class LinkLocalResolver implements MarkdownLocalResolver {\n  #targetReadCount = 0;\n  readonly #canonicalProjectRoot: string;\n  readonly #maxTargetReads: number;\n\n  constructor(canonicalProjectRoot: string, maxTargetReads: number) {\n    this.#canonicalProjectRoot = canonicalProjectRoot;\n    this.#maxTargetReads = maxTargetReads;\n  }\n\n  get targetReadCount(): number {\n    return this.#targetReadCount;\n  }\n\n  async readSource(\n    rootRelativePath: string,\n    maxMarkdownBytes: number\n  ): Promise<MarkdownSourceReadResult> {\n    if (!isRootRelativePath(this.#canonicalProjectRoot, rootRelativePath)) {\n      return sourceUnavailable();\n    }\n\n    const sourcePath = path.resolve(this.#canonicalProjectRoot, rootRelativePath);\n    const rootProbe = await probeRootContainedPath(this.#canonicalProjectRoot, sourcePath);\n    if (\n      rootProbe.kind === \"outside\" ||\n      rootProbe.kind === \"unavailable\" ||\n      rootProbe.kind === \"missing\"\n    ) {\n      return sourceUnavailable();\n    }\n\n    const sourceBytes = await readRegularFile(rootProbe.absolutePath, maxMarkdownBytes);\n    if (!sourceBytes.ok) {\n      return sourceBytes.reason === \"too-large\"\n        ? Object.freeze({ ok: false as const, reason: \"source-too-large\" as const })\n        : sourceUnavailable();\n    }\n\n    let markdown: string;\n    try {\n      markdown = new TextDecoder(\"utf-8\", { fatal: true }).decode(sourceBytes.bytes);\n    } catch {\n      return sourceUnavailable();\n    }\n\n    const parsed = parseMarkdownLinkFacts(markdown);\n    if (!parsed.ok) {\n      return Object.freeze({ ok: false as const, reason: \"markdown-parse-failed\" as const });\n    }\n\n    return Object.freeze({\n      ok: true as const,\n      source: Object.freeze({\n        path: toSlashPath(path.relative(this.#canonicalProjectRoot, sourcePath)),\n        facts: parsed.facts\n      })\n    });\n  }\n\n  async resolve(request: MarkdownLocalResolutionRequest): Promise<MarkdownLocalResolution> {\n    const destination = parseLocalDestination(request.rawDestination);\n    if (destination === \"not-local\") {\n      return Object.freeze({ kind: \"not-local\" as const });\n    }\n    if (destination === null) {\n      return unavailable(\"invalid-local-destination\");\n    }\n\n    let targetPath: string;\n    if (destination.path === \"\") {\n      targetPath = path.resolve(this.#canonicalProjectRoot, request.source.path);\n    } else if (destination.isAbsolute) {\n      targetPath = path.normalize(destination.path);\n    } else {\n      targetPath = path.resolve(\n        this.#canonicalProjectRoot,\n        path.dirname(request.source.path),\n        destination.path\n      );\n    }\n    const isSameDocument =\n      !destination.isAbsolute &&\n      sameRootRelativePath(request.source.path, targetPath, this.#canonicalProjectRoot);\n    if (isSameDocument) {\n      return this.resolveSameDocument(destination.fragment, request);\n    }\n    const lexicalTargetIsExternal =\n      destination.isAbsolute || !isWithinRoot(this.#canonicalProjectRoot, targetPath);\n\n    if (lexicalTargetIsExternal) {\n      return this.resolveExternalTarget(targetPath, destination.fragment, request);\n    }\n\n    return this.resolveRootContainedTarget(targetPath, destination.fragment, request);\n  }\n\n  async resolveRootContainedTarget(\n    targetPath: string,\n    fragment: string | null,\n    request: MarkdownLocalResolutionRequest\n  ): Promise<MarkdownLocalResolution> {\n    const rootProbe = await probeRootContainedPath(this.#canonicalProjectRoot, targetPath);\n    if (rootProbe.kind === \"outside\") {\n      return this.resolveExternalTarget(targetPath, fragment, request);\n    }\n    if (rootProbe.kind === \"unavailable\") {\n      return unavailable(\"target-unavailable\");\n    }\n    if (rootProbe.kind === \"missing\") {\n      if (!this.beginTargetValidation()) {\n        return unavailable(\"target-read-limit-exceeded\");\n      }\n      const target = projectTarget(this.#canonicalProjectRoot, targetPath, fragment);\n      return request.requireExistingTargets ? finding(\"missing-target\", target) : valid(target);\n    }\n    if (!this.beginTargetValidation()) {\n      return unavailable(\"target-read-limit-exceeded\");\n    }\n    return this.resolveEndpoint(\n      rootProbe.absolutePath,\n      fragment,\n      request,\n      projectTarget(this.#canonicalProjectRoot, targetPath, fragment)\n    );\n  }\n\n  async resolveExternalTarget(\n    targetPath: string,\n    fragment: string | null,\n    request: MarkdownLocalResolutionRequest\n  ): Promise<MarkdownLocalResolution> {\n    if (request.rootExternalTargetMode === \"ignore\") {\n      return Object.freeze({ kind: \"ignored\" as const });\n    }\n    if (request.rootExternalTargetMode === \"report\") {\n      return finding(\"target-outside-project-root\", outsideProjectRootTarget());\n    }\n    if (!this.beginTargetValidation()) {\n      return unavailable(\"target-read-limit-exceeded\");\n    }\n    return this.resolveEndpoint(targetPath, fragment, request, outsideProjectRootTarget());\n  }\n\n  async resolveEndpoint(\n    targetPath: string,\n    fragment: string | null,\n    request: MarkdownLocalResolutionRequest,\n    target: MarkdownSafeTargetDescriptor\n  ): Promise<MarkdownLocalResolution> {\n    const endpoint = await probeEndpoint(targetPath);\n    if (endpoint.kind === \"missing\") {\n      return request.requireExistingTargets ? finding(\"missing-target\", target) : valid(target);\n    }\n    if (endpoint.kind === \"unavailable\") {\n      return unavailable(\"target-unavailable\");\n    }\n    if (endpoint.kind === \"directory\") {\n      return this.resolveDirectory(targetPath, fragment, request, directoryTarget(target));\n    }\n    if (endpoint.kind === \"unsupported\") {\n      return finding(\"unsupported-target-type\", target);\n    }\n\n    return this.resolveFile(targetPath, fragment, request, fileTargetDescriptor(target));\n  }\n\n  async resolveFile(\n    targetPath: string,\n    fragment: string | null,\n    request: MarkdownLocalResolutionRequest,\n    target: MarkdownSafeTargetDescriptor\n  ): Promise<MarkdownLocalResolution> {\n    if (fragment === null || !request.validateCrossDocumentAnchors) {\n      return valid(target);\n    }\n    if (!isMarkdownPath(targetPath)) {\n      return finding(\"anchor-target-not-markdown\", target);\n    }\n\n    const targetMarkdown = await readRegularFile(targetPath, request.maxMarkdownBytes);\n    if (!targetMarkdown.ok) {\n      return unavailable(\"target-unavailable\");\n    }\n    let decodedTarget: string;\n    try {\n      decodedTarget = new TextDecoder(\"utf-8\", { fatal: true }).decode(targetMarkdown.bytes);\n    } catch {\n      return unavailable(\"target-unavailable\");\n    }\n    const parsedTarget = parseMarkdownLinkFacts(decodedTarget);\n    if (!parsedTarget.ok) {\n      return unavailable(\"target-unavailable\");\n    }\n    return anchorResolution(parsedTarget.facts.headings, fragment, target);\n  }\n\n  async resolveDirectory(\n    targetPath: string,\n    fragment: string | null,\n    request: MarkdownLocalResolutionRequest,\n    target: MarkdownSafeTargetDescriptor\n  ): Promise<MarkdownLocalResolution> {\n    if (fragment !== null) {\n      return finding(\"anchor-on-directory\", target);\n    }\n    if (!request.requireNonEmptyDirectories) {\n      return valid(target);\n    }\n    try {\n      const directory = await opendir(targetPath);\n      try {\n        return (await directory.read()) === null\n          ? finding(\"empty-directory\", target)\n          : valid(target);\n      } finally {\n        await directory.close();\n      }\n    } catch {\n      return unavailable(\"target-unavailable\");\n    }\n  }\n\n  beginTargetValidation(): boolean {\n    if (this.#targetReadCount >= this.#maxTargetReads) {\n      return false;\n    }\n    this.#targetReadCount += 1;\n    return true;\n  }\n\n  resolveSameDocument(\n    fragment: string | null,\n    request: MarkdownLocalResolutionRequest\n  ): MarkdownLocalResolution {\n    const target = Object.freeze({\n      kind: \"same-document\" as const,\n      path: request.source.path,\n      fragment\n    });\n    if (fragment === null || !request.validateSameDocumentAnchors) {\n      return valid(target);\n    }\n    return anchorResolution(request.source.facts.headings, fragment, target);\n  }\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/target-descriptor.mjs

@@ -0,0 +1,23 @@
+import path from "node:path";
+import { toSlashPath } from "./local-resolution.mjs";
+export function projectTarget(canonicalProjectRoot, targetPath, fragment, kind = "project-path") {
+    return Object.freeze({
+        kind,
+        path: toSlashPath(path.relative(canonicalProjectRoot, targetPath)),
+        fragment
+    });
+}
+export function outsideProjectRootTarget() {
+    return Object.freeze({ kind: "outside-project-root" });
+}
+export function fileTargetDescriptor(target) {
+    if (target.kind === "outside-project-root")
+        return target;
+    return Object.freeze({ ...target, kind: "project-file" });
+}
+export function directoryTarget(target) {
+    if (target.kind === "outside-project-root")
+        return target;
+    return Object.freeze({ ...target, kind: "project-directory" });
+}
+//# sourceMappingURL=target-descriptor.mjs.map

package/dist/esm/package-checks/markdown-link-validation/target-descriptor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-descriptor.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/target-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAqC,MAAM,uBAAuB,CAAC;AAEvF,MAAM,UAAU,aAAa,CAC3B,oBAA4B,EAC5B,UAAkB,EAClB,QAAuB,EACvB,IAAI,GAA0D,cAAc;IAE5E,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI;QACJ,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;QAClE,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,sBAA+B,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAAoC;IAEpC,IAAI,MAAM,CAAC,IAAI,KAAK,sBAAsB;QAAE,OAAO,MAAM,CAAC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,cAAuB,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,MAAoC;IAEpC,IAAI,MAAM,CAAC,IAAI,KAAK,sBAAsB;QAAE,OAAO,MAAM,CAAC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,mBAA4B,EAAE,CAAC,CAAC;AAC1E,CAAC","sourcesContent":["import path from \"node:path\";\n\nimport { toSlashPath, type MarkdownSafeTargetDescriptor } from \"./local-resolution.ts\";\n\nexport function projectTarget(\n  canonicalProjectRoot: string,\n  targetPath: string,\n  fragment: string | null,\n  kind: \"project-directory\" | \"project-file\" | \"project-path\" = \"project-path\"\n): MarkdownSafeTargetDescriptor {\n  return Object.freeze({\n    kind,\n    path: toSlashPath(path.relative(canonicalProjectRoot, targetPath)),\n    fragment\n  });\n}\n\nexport function outsideProjectRootTarget(): MarkdownSafeTargetDescriptor {\n  return Object.freeze({ kind: \"outside-project-root\" as const });\n}\n\nexport function fileTargetDescriptor(\n  target: MarkdownSafeTargetDescriptor\n): MarkdownSafeTargetDescriptor {\n  if (target.kind === \"outside-project-root\") return target;\n  return Object.freeze({ ...target, kind: \"project-file\" as const });\n}\n\nexport function directoryTarget(\n  target: MarkdownSafeTargetDescriptor\n): MarkdownSafeTargetDescriptor {\n  if (target.kind === \"outside-project-root\") return target;\n  return Object.freeze({ ...target, kind: \"project-directory\" as const });\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/traversal-result.mjs

@@ -0,0 +1,41 @@
+/** Materializes one completed source traversal into its Check-owned final result. */
+export function settledMarkdownTraversalResult(input) {
+    const data = Object.freeze({
+        sourceFileCount: input.sourceFileCount,
+        occurrenceCount: input.occurrenceCount,
+        targetReadCount: input.targetReadCount,
+        findingCount: input.findingCount + input.rejectedInputCount,
+        rejectedInputCount: input.rejectedInputCount
+    });
+    const messages = [];
+    if (input.findingCount > 0)
+        messages.push(linkFindingMessage(input));
+    if (input.rejectedInputCount > 0)
+        messages.push(rejectedInputMessage(input.rejectedInputCount));
+    if (messages.length === 0)
+        return Object.freeze({ data, status: "passed" });
+    const isBlocking = input.findingPolicy === "blocking";
+    return Object.freeze({
+        data,
+        messages: Object.freeze(messages),
+        status: isBlocking && input.findingCount > 0 ? "failed" : "passed"
+    });
+}
+function linkFindingMessage(input) {
+    const isBlocking = input.findingPolicy === "blocking";
+    return Object.freeze({
+        code: "invalid-local-links",
+        level: isBlocking ? "error" : "warning",
+        message: isBlocking
+            ? `${input.findingCount} local Markdown link finding(s) require attention; inspect this Check's Records for source ranges, targets, and reasons.`
+            : `${input.findingCount} local Markdown link finding(s) were recorded as non-blocking; inspect this Check's Records for source ranges, targets, and reasons.`
+    });
+}
+function rejectedInputMessage(rejectedInputCount) {
+    return Object.freeze({
+        code: "input-rejected",
+        level: "warning",
+        message: `${rejectedInputCount} selected markdownLinkValidation input file(s) were rejected because only .md/.markdown paths are supported; inspect this Check's Records and narrow files.include/exclude.`
+    });
+}
+//# sourceMappingURL=traversal-result.mjs.map

package/dist/esm/package-checks/markdown-link-validation/traversal-result.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"traversal-result.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/traversal-result.ts"],"names":[],"mappings":"AAKA,qFAAqF;AACrF,MAAM,UAAU,8BAA8B,CAC5C,KAOE;IAEF,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;QACzB,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,YAAY,EAAE,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,kBAAkB;QAC3D,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;KAC7C,CAAC,CAAC;IACH,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAChG,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,KAAK,UAAU,CAAC;IACtD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI;QACJ,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjC,MAAM,EAAE,UAAU,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;KACnE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CACzB,KAGE;IAEF,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,KAAK,UAAU,CAAC;IACtD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,UAAU,CAAC,CAAC,CAAE,OAAiB,CAAC,CAAC,CAAE,SAAmB;QAC7D,OAAO,EAAE,UAAU;YACjB,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,0HAA0H;YACjJ,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,sIAAsI;KAChK,CAAC,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB,CAAC,kBAA0B;IACtD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,SAAkB;QACzB,OAAO,EAAE,GAAG,kBAAkB,6KAA6K;KAC5M,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckMessage, CheckResult } from \"../../check/check.ts\";\n\nimport type { MarkdownLinkValidationFinalData } from \"./final-data.ts\";\nimport type { ResolvedMarkdownLinkValidationOptions } from \"./options.ts\";\n\n/** Materializes one completed source traversal into its Check-owned final result. */\nexport function settledMarkdownTraversalResult(\n  input: Readonly<{\n    readonly findingCount: number;\n    readonly findingPolicy: ResolvedMarkdownLinkValidationOptions[\"findingPolicy\"];\n    readonly occurrenceCount: number;\n    readonly rejectedInputCount: number;\n    readonly sourceFileCount: number;\n    readonly targetReadCount: number;\n  }>\n): CheckResult<MarkdownLinkValidationFinalData> {\n  const data = Object.freeze({\n    sourceFileCount: input.sourceFileCount,\n    occurrenceCount: input.occurrenceCount,\n    targetReadCount: input.targetReadCount,\n    findingCount: input.findingCount + input.rejectedInputCount,\n    rejectedInputCount: input.rejectedInputCount\n  });\n  const messages: CheckMessage[] = [];\n  if (input.findingCount > 0) messages.push(linkFindingMessage(input));\n  if (input.rejectedInputCount > 0) messages.push(rejectedInputMessage(input.rejectedInputCount));\n  if (messages.length === 0) return Object.freeze({ data, status: \"passed\" });\n  const isBlocking = input.findingPolicy === \"blocking\";\n  return Object.freeze({\n    data,\n    messages: Object.freeze(messages),\n    status: isBlocking && input.findingCount > 0 ? \"failed\" : \"passed\"\n  });\n}\n\nfunction linkFindingMessage(\n  input: Readonly<{\n    readonly findingCount: number;\n    readonly findingPolicy: ResolvedMarkdownLinkValidationOptions[\"findingPolicy\"];\n  }>\n): CheckMessage {\n  const isBlocking = input.findingPolicy === \"blocking\";\n  return Object.freeze({\n    code: \"invalid-local-links\",\n    level: isBlocking ? (\"error\" as const) : (\"warning\" as const),\n    message: isBlocking\n      ? `${input.findingCount} local Markdown link finding(s) require attention; inspect this Check's Records for source ranges, targets, and reasons.`\n      : `${input.findingCount} local Markdown link finding(s) were recorded as non-blocking; inspect this Check's Records for source ranges, targets, and reasons.`\n  });\n}\n\nfunction rejectedInputMessage(rejectedInputCount: number): CheckMessage {\n  return Object.freeze({\n    code: \"input-rejected\",\n    level: \"warning\" as const,\n    message: `${rejectedInputCount} selected markdownLinkValidation input file(s) were rejected because only .md/.markdown paths are supported; inspect this Check's Records and narrow files.include/exclude.`\n  });\n}\n"]}

package/dist/esm/package-checks/project-files/collection.mjs

@@ -0,0 +1,142 @@
+/** Project-root file discovery and selection helpers. */
+import { lstatSync } from "node:fs";
+import { resolve } from "node:path";
+import { matchesAnyConfigGlob } from "./config-glob.mjs";
+import { collectSubmoduleWorktreeFiles } from "./revision-worktree-files.mjs";
+import { errorMessage } from "../host-environment/error-message.mjs";
+import { processFailed } from "../host-environment/process/command.mjs";
+import { runGit, splitNulDelimitedGitFileList } from "../host-environment/git.mjs";
+import { toSlashPath } from "../host-environment/path.mjs";
+import { walkFiles } from "../host-environment/filesystem.mjs";
+const CONFIG_GLOB_MAGIC = /[\\*?[\]{}()!+@]/u;
+/**
+ * Resolves multiple named file sets while enumerating each distinct candidate source once.
+ */
+export function collectProjectFileSets(rootDir, selections) {
+    const bySource = groupSelectionsBySource(selections);
+    const selectedFiles = new Map();
+    for (const [source, sourceSelections] of bySource) {
+        const candidates = collectSourceCandidates(rootDir, source, sourceSelections);
+        for (const { id, selection } of sourceSelections) {
+            selectedFiles.set(id, Object.freeze(filterProjectFiles(candidates, selection)));
+        }
+    }
+    return selectedFiles;
+}
+export function collectProjectFiles(rootDir, selection) {
+    return [...requireProjectFileSet(collectProjectFileSets(rootDir, { selection }), "selection")];
+}
+/** 返回已收集的命名文件集合；缺失表示收集完整性失效，不能解释为空集合。 */
+export function requireProjectFileSet(fileSets, selectionId) {
+    const selectedFiles = fileSets.get(selectionId);
+    if (selectedFiles === undefined) {
+        throw new Error(`project file collection did not produce selection ${selectionId}`);
+    }
+    return selectedFiles;
+}
+function groupSelectionsBySource(selections) {
+    const mutableGroups = new Map();
+    const entries = Object.entries(selections).sort(([left], [right]) => compareText(left, right));
+    for (const [id, selection] of entries) {
+        const group = mutableGroups.get(selection.source) ?? [];
+        group.push({ id, selection });
+        mutableGroups.set(selection.source, group);
+    }
+    return new Map([...mutableGroups].map(([source, group]) => [source, Object.freeze(group)]));
+}
+function collectSourceCandidates(rootDir, source, selections) {
+    switch (source) {
+        case "filesystem":
+            return uniqueSorted(walkFiles({
+                ignoredDirs: commonExcludedDirectoryNames(selections),
+                rootDir
+            }).map(toSlashPath));
+        case "git-worktree":
+            return collectGitWorktreeCandidates(rootDir, selections);
+        default: {
+            const unsupportedSource = source;
+            throw new TypeError(`unsupported project file source: ${String(unsupportedSource)}`);
+        }
+    }
+}
+function collectGitWorktreeCandidates(rootDir, selections) {
+    const result = runGit({
+        args: ["ls-files", "-z", "--cached", "--others", "--exclude-standard", "--"],
+        cwd: rootDir
+    });
+    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 ${rootDir}: ${detail}`);
+    }
+    const include = uniqueSorted(selections.flatMap(({ selection }) => [...selection.include]));
+    return uniqueSorted([
+        ...splitNulDelimitedGitFileList(result.stdout),
+        ...collectSubmoduleWorktreeFiles({ repository: rootDir, scanInputPaths: include })
+    ]
+        .map(toSlashPath)
+        .filter((filePath) => isGitWorktreeFile({ filePath, rootDir })));
+}
+function isGitWorktreeFile({ filePath, rootDir }) {
+    try {
+        const stats = lstatSync(resolve(rootDir, filePath));
+        return stats.isFile() || stats.isSymbolicLink();
+    }
+    catch (error) {
+        if (missingPath(error))
+            return false;
+        throw new Error(`could not inspect git-worktree candidate ${filePath} in ${rootDir}: ${errorMessage(error)}`, { cause: error });
+    }
+}
+function missingPath(error) {
+    const code = error instanceof Error && "code" in error ? error.code : undefined;
+    return code === "ENOENT" || code === "ENOTDIR";
+}
+function filterProjectFiles(candidates, selection) {
+    return uniqueSorted(candidates.filter((filePath) => isProjectFile(filePath, selection)));
+}
+function isProjectFile(filePath, selection) {
+    const normalized = toSlashPath(filePath);
+    return (matchesAnyConfigGlob(normalized, selection.include) &&
+        !matchesAnyConfigGlob(normalized, selection.exclude));
+}
+/**
+ * Recognizes only whole-directory exclusions with one literal directory segment. The
+ * intersection is a traversal optimization; public semantics remain in `isProjectFile`.
+ */
+function commonExcludedDirectoryNames(selections) {
+    let common;
+    for (const { selection } of selections) {
+        const names = new Set(selection.exclude.map(literalExcludedDirectoryName).filter(isString));
+        common =
+            common === undefined
+                ? names
+                : new Set([...common].filter((directoryName) => names.has(directoryName)));
+    }
+    return common === undefined ? [] : [...common].sort();
+}
+function literalExcludedDirectoryName(configGlob) {
+    const prefix = "**/";
+    const suffix = "/**";
+    if (!configGlob.startsWith(prefix) || !configGlob.endsWith(suffix))
+        return undefined;
+    const directoryName = configGlob.slice(prefix.length, -suffix.length);
+    if (directoryName.length === 0 || directoryName.includes("/"))
+        return undefined;
+    return CONFIG_GLOB_MAGIC.test(directoryName) ? undefined : directoryName;
+}
+function isString(value) {
+    return value !== undefined;
+}
+function uniqueSorted(files) {
+    return [...new Set(files)].sort(compareText);
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=collection.mjs.map

package/dist/esm/package-checks/project-files/collection.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.mjs","sourceRoot":"","sources":["../../../../src/package-checks/project-files/collection.ts"],"names":[],"mappings":"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","sourcesContent":["/** Project-root file discovery and selection helpers. */\n\nimport { lstatSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nimport { matchesAnyConfigGlob } from \"./config-glob.ts\";\nimport { collectSubmoduleWorktreeFiles } from \"./revision-worktree-files.ts\";\nimport { errorMessage } from \"../host-environment/error-message.ts\";\nimport { processFailed } from \"../host-environment/process/command.ts\";\nimport { runGit, splitNulDelimitedGitFileList } from \"../host-environment/git.ts\";\nimport { toSlashPath } from \"../host-environment/path.ts\";\nimport { walkFiles } from \"../host-environment/filesystem.ts\";\nimport type { ProjectFileSelection, ProjectFileSource } from \"./configuration.ts\";\n\ntype NamedProjectFileSelection = Readonly<{\n  readonly id: string;\n  readonly selection: ProjectFileSelection;\n}>;\n\nconst CONFIG_GLOB_MAGIC = /[\\\\*?[\\]{}()!+@]/u;\n\n/**\n * Resolves multiple named file sets while enumerating each distinct candidate source once.\n */\nexport function collectProjectFileSets(\n  rootDir: string,\n  selections: Readonly<Record<string, ProjectFileSelection>>\n): ReadonlyMap<string, readonly string[]> {\n  const bySource = groupSelectionsBySource(selections);\n  const selectedFiles = new Map<string, readonly string[]>();\n\n  for (const [source, sourceSelections] of bySource) {\n    const candidates = collectSourceCandidates(rootDir, source, sourceSelections);\n    for (const { id, selection } of sourceSelections) {\n      selectedFiles.set(id, Object.freeze(filterProjectFiles(candidates, selection)));\n    }\n  }\n\n  return selectedFiles;\n}\n\nexport function collectProjectFiles(rootDir: string, selection: ProjectFileSelection): string[] {\n  return [...requireProjectFileSet(collectProjectFileSets(rootDir, { selection }), \"selection\")];\n}\n\n/** 返回已收集的命名文件集合；缺失表示收集完整性失效，不能解释为空集合。 */\nexport function requireProjectFileSet(\n  fileSets: ReadonlyMap<string, readonly string[]>,\n  selectionId: string\n): readonly string[] {\n  const selectedFiles = fileSets.get(selectionId);\n  if (selectedFiles === undefined) {\n    throw new Error(`project file collection did not produce selection ${selectionId}`);\n  }\n  return selectedFiles;\n}\n\nfunction groupSelectionsBySource(\n  selections: Readonly<Record<string, ProjectFileSelection>>\n): ReadonlyMap<ProjectFileSource, readonly NamedProjectFileSelection[]> {\n  const mutableGroups = new Map<ProjectFileSource, NamedProjectFileSelection[]>();\n  const entries = Object.entries(selections).sort(([left], [right]) => compareText(left, right));\n\n  for (const [id, selection] of entries) {\n    const group = mutableGroups.get(selection.source) ?? [];\n    group.push({ id, selection });\n    mutableGroups.set(selection.source, group);\n  }\n\n  return new Map(\n    [...mutableGroups].map(([source, group]) => [source, Object.freeze(group)] as const)\n  );\n}\n\nfunction collectSourceCandidates(\n  rootDir: string,\n  source: ProjectFileSource,\n  selections: readonly NamedProjectFileSelection[]\n): readonly string[] {\n  switch (source) {\n    case \"filesystem\":\n      return uniqueSorted(\n        walkFiles({\n          ignoredDirs: commonExcludedDirectoryNames(selections),\n          rootDir\n        }).map(toSlashPath)\n      );\n    case \"git-worktree\":\n      return collectGitWorktreeCandidates(rootDir, selections);\n    default: {\n      const unsupportedSource: never = source;\n      throw new TypeError(`unsupported project file source: ${String(unsupportedSource)}`);\n    }\n  }\n}\n\nfunction collectGitWorktreeCandidates(\n  rootDir: string,\n  selections: readonly NamedProjectFileSelection[]\n): readonly string[] {\n  const result = runGit({\n    args: [\"ls-files\", \"-z\", \"--cached\", \"--others\", \"--exclude-standard\", \"--\"],\n    cwd: rootDir\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 ${rootDir}: ${detail}`);\n  }\n\n  const include = uniqueSorted(selections.flatMap(({ selection }) => [...selection.include]));\n  return uniqueSorted(\n    [\n      ...splitNulDelimitedGitFileList(result.stdout),\n      ...collectSubmoduleWorktreeFiles({ repository: rootDir, scanInputPaths: include })\n    ]\n      .map(toSlashPath)\n      .filter((filePath) => isGitWorktreeFile({ filePath, rootDir }))\n  );\n}\n\nfunction isGitWorktreeFile({\n  filePath,\n  rootDir\n}: Readonly<{ readonly filePath: string; readonly rootDir: string }>): boolean {\n  try {\n    const stats = lstatSync(resolve(rootDir, filePath));\n    return stats.isFile() || stats.isSymbolicLink();\n  } catch (error: unknown) {\n    if (missingPath(error)) return false;\n    throw new Error(\n      `could not inspect git-worktree candidate ${filePath} in ${rootDir}: ${errorMessage(error)}`,\n      { cause: error }\n    );\n  }\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 filterProjectFiles(\n  candidates: readonly string[],\n  selection: ProjectFileSelection\n): string[] {\n  return uniqueSorted(candidates.filter((filePath) => isProjectFile(filePath, selection)));\n}\n\nfunction isProjectFile(filePath: string, selection: ProjectFileSelection): boolean {\n  const normalized = toSlashPath(filePath);\n  return (\n    matchesAnyConfigGlob(normalized, selection.include) &&\n    !matchesAnyConfigGlob(normalized, selection.exclude)\n  );\n}\n\n/**\n * Recognizes only whole-directory exclusions with one literal directory segment. The\n * intersection is a traversal optimization; public semantics remain in `isProjectFile`.\n */\nfunction commonExcludedDirectoryNames(\n  selections: readonly NamedProjectFileSelection[]\n): readonly string[] {\n  let common: Set<string> | undefined;\n  for (const { selection } of selections) {\n    const names = new Set(selection.exclude.map(literalExcludedDirectoryName).filter(isString));\n    common =\n      common === undefined\n        ? names\n        : new Set([...common].filter((directoryName) => names.has(directoryName)));\n  }\n  return common === undefined ? [] : [...common].sort();\n}\n\nfunction literalExcludedDirectoryName(configGlob: string): string | undefined {\n  const prefix = \"**/\";\n  const suffix = \"/**\";\n  if (!configGlob.startsWith(prefix) || !configGlob.endsWith(suffix)) return undefined;\n  const directoryName = configGlob.slice(prefix.length, -suffix.length);\n  if (directoryName.length === 0 || directoryName.includes(\"/\")) return undefined;\n  return CONFIG_GLOB_MAGIC.test(directoryName) ? undefined : directoryName;\n}\n\nfunction isString(value: string | undefined): value is string {\n  return value !== undefined;\n}\n\nfunction uniqueSorted(files: readonly string[]): string[] {\n  return [...new Set(files)].sort(compareText);\n}\n\nfunction compareText(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n"]}

package/dist/esm/package-checks/project-files/config-glob.mjs

@@ -0,0 +1,11 @@
+import { minimatch } from "minimatch";
+import { toSlashPath } from "../host-environment/path.mjs";
+/**
+ * Product config glob 的唯一 matcher boundary。
+ * Candidate 使用 slash form；dot path 只由显式 glob 决定，不附加隐式忽略规则。
+ */
+export function matchesAnyConfigGlob(candidatePath, configGlobs) {
+    const normalizedCandidatePath = toSlashPath(candidatePath);
+    return configGlobs.some((configGlob) => minimatch(normalizedCandidatePath, configGlob, { dot: true }));
+}
+//# sourceMappingURL=config-glob.mjs.map

package/dist/esm/package-checks/project-files/config-glob.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-glob.mjs","sourceRoot":"","sources":["../../../../src/package-checks/project-files/config-glob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,aAAqB,EACrB,WAA8B;IAE9B,MAAM,uBAAuB,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IAC3D,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CACrC,SAAS,CAAC,uBAAuB,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAC9D,CAAC;AACJ,CAAC","sourcesContent":["import { minimatch } from \"minimatch\";\n\nimport { toSlashPath } from \"../host-environment/path.ts\";\n\n/**\n * Product config glob 的唯一 matcher boundary。\n * Candidate 使用 slash form；dot path 只由显式 glob 决定，不附加隐式忽略规则。\n */\nexport function matchesAnyConfigGlob(\n  candidatePath: string,\n  configGlobs: readonly string[]\n): boolean {\n  const normalizedCandidatePath = toSlashPath(candidatePath);\n  return configGlobs.some((configGlob) =>\n    minimatch(normalizedCandidatePath, configGlob, { dot: true })\n  );\n}\n"]}

package/dist/esm/package-checks/project-files/configuration.mjs

@@ -0,0 +1,104 @@
+import { hasRequiredAndOptionalRecordKeys, snapshotClosedArray, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+export const PROJECT_FILE_SOURCES = Object.freeze(["filesystem", "git-worktree"]);
+/**
+ * Package-provided Checks 共用的通用文件选择基线。
+ *
+ * 对象与数组均不可变；需要保留默认排除并追加项目规则时，使用对象与数组 spread 建立新值。
+ * 个别 Check 会从此 baseline 派生更精准的默认 include；显式组合此 value 仍表示通配全部路径。
+ */
+export const defaultProjectFileSelection = deepFreeze({
+    exclude: [
+        "**/.cache/**",
+        "**/.git",
+        "**/.git/**",
+        "**/.log/**",
+        "**/.pytest_cache/**",
+        "**/.tmp/**",
+        "**/.venv/**",
+        "**/.vibe-check/**",
+        "**/__pycache__/**",
+        "**/artifacts/**",
+        "**/build/**",
+        "**/coverage/**",
+        "**/dist/**",
+        "**/generated/**",
+        "**/*.generated.*",
+        "**/node_modules/**",
+        "**/target/**",
+        "**/tmp/**",
+        "**/vendor/**",
+        "**/venv/**"
+    ],
+    include: ["**/*"],
+    source: "filesystem"
+});
+/** 按 owning Check 提供的可信完整 defaults 解析并冻结一份 authoring selection。 */
+export function resolveProjectFileSelection(value, defaults = defaultProjectFileSelection) {
+    const selection = snapshotClosedRecord(value);
+    if (selection === undefined ||
+        !hasRequiredAndOptionalRecordKeys(selection, {
+            optional: ["exclude", "include", "source"],
+            required: []
+        })) {
+        return undefined;
+    }
+    const exclude = resolveStringArray(selection.exclude, defaults.exclude);
+    const include = resolveStringArray(selection.include, defaults.include);
+    const source = selection.source ?? defaults.source;
+    if (exclude === undefined || include === undefined || !isProjectFileSource(source)) {
+        return undefined;
+    }
+    return Object.freeze({ exclude, include, source });
+}
+export function snapshotDefaultProjectFileSelection() {
+    return snapshotProjectFileSelection(defaultProjectFileSelection);
+}
+/** 为 owning Check 对可信的完整 selection 建立 detached、冻结快照。 */
+export function snapshotProjectFileSelection(selection) {
+    return Object.freeze({
+        exclude: Object.freeze([...selection.exclude]),
+        include: Object.freeze([...selection.include]),
+        source: selection.source
+    });
+}
+export function validProjectFileSelection(value) {
+    const selection = exactRecord(value, ["exclude", "include", "source"]);
+    return (selection !== undefined &&
+        validStringArray(selection.exclude) &&
+        validStringArray(selection.include) &&
+        isProjectFileSource(selection.source));
+}
+function isProjectFileSource(value) {
+    return PROJECT_FILE_SOURCES.some((source) => source === value);
+}
+function resolveStringArray(value, fallback) {
+    if (value === undefined)
+        return Object.freeze([...fallback]);
+    const items = snapshotClosedArray(value);
+    if (items === undefined || !items.every(isString))
+        return undefined;
+    return Object.freeze([...items]);
+}
+function validStringArray(value) {
+    const items = snapshotClosedArray(value);
+    return items !== undefined && items.every(isString);
+}
+function isString(value) {
+    return typeof value === "string";
+}
+function exactRecord(value, keys) {
+    const record = snapshotClosedRecord(value);
+    return record !== undefined &&
+        Object.keys(record).length === keys.length &&
+        keys.every((key) => Object.hasOwn(record, key))
+        ? record
+        : undefined;
+}
+function deepFreeze(value) {
+    if (typeof value !== "object" || value === null || Object.isFrozen(value))
+        return value;
+    for (const nested of Object.values(value))
+        deepFreeze(nested);
+    return Object.freeze(value);
+}
+//# sourceMappingURL=configuration.mjs.map

package/dist/esm/package-checks/project-files/configuration.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.mjs","sourceRoot":"","sources":["../../../../src/package-checks/project-files/configuration.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  hasRequiredAndOptionalRecordKeys,\n  snapshotClosedArray,\n  snapshotClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\n\nexport const PROJECT_FILE_SOURCES = Object.freeze([\"filesystem\", \"git-worktree\"] as const);\n\n/** 文件选择可使用的显式候选来源。 */\nexport type ProjectFileSource = (typeof PROJECT_FILE_SOURCES)[number];\n\n/** 读取项目文件的 Check 所拥有的文件选择输入。 */\nexport interface ProjectFileSelectionOptions {\n  /** 候选文件来源；省略时使用 owning Check 的来源默认值，当前随包 Check 均为 `filesystem`。 */\n  readonly source?: ProjectFileSource;\n  /** 相对项目根目录且使用 `/` 的 glob；省略时使用 owning Check 的 include 默认值，显式数组完整替换。 */\n  readonly include?: readonly string[];\n  /** 优先于 `include` 的 glob；省略时使用 owning Check 的 exclude 默认值，显式数组完整替换。 */\n  readonly exclude?: readonly string[];\n}\n\n/** Check execution 消费的完整项目文件选择。 */\nexport interface ProjectFileSelection {\n  readonly exclude: readonly string[];\n  readonly include: readonly string[];\n  readonly source: ProjectFileSource;\n}\n\n/**\n * Package-provided Checks 共用的通用文件选择基线。\n *\n * 对象与数组均不可变；需要保留默认排除并追加项目规则时，使用对象与数组 spread 建立新值。\n * 个别 Check 会从此 baseline 派生更精准的默认 include；显式组合此 value 仍表示通配全部路径。\n */\nexport const defaultProjectFileSelection: ProjectFileSelection = deepFreeze({\n  exclude: [\n    \"**/.cache/**\",\n    \"**/.git\",\n    \"**/.git/**\",\n    \"**/.log/**\",\n    \"**/.pytest_cache/**\",\n    \"**/.tmp/**\",\n    \"**/.venv/**\",\n    \"**/.vibe-check/**\",\n    \"**/__pycache__/**\",\n    \"**/artifacts/**\",\n    \"**/build/**\",\n    \"**/coverage/**\",\n    \"**/dist/**\",\n    \"**/generated/**\",\n    \"**/*.generated.*\",\n    \"**/node_modules/**\",\n    \"**/target/**\",\n    \"**/tmp/**\",\n    \"**/vendor/**\",\n    \"**/venv/**\"\n  ],\n  include: [\"**/*\"],\n  source: \"filesystem\"\n});\n\n/** 按 owning Check 提供的可信完整 defaults 解析并冻结一份 authoring selection。 */\nexport function resolveProjectFileSelection(\n  value: unknown,\n  defaults: ProjectFileSelection = defaultProjectFileSelection\n): ProjectFileSelection | undefined {\n  const selection = snapshotClosedRecord(value);\n  if (\n    selection === undefined ||\n    !hasRequiredAndOptionalRecordKeys(selection, {\n      optional: [\"exclude\", \"include\", \"source\"],\n      required: []\n    })\n  ) {\n    return undefined;\n  }\n\n  const exclude = resolveStringArray(selection.exclude, defaults.exclude);\n  const include = resolveStringArray(selection.include, defaults.include);\n  const source = selection.source ?? defaults.source;\n  if (exclude === undefined || include === undefined || !isProjectFileSource(source)) {\n    return undefined;\n  }\n\n  return Object.freeze({ exclude, include, source });\n}\n\nexport function snapshotDefaultProjectFileSelection(): ProjectFileSelection {\n  return snapshotProjectFileSelection(defaultProjectFileSelection);\n}\n\n/** 为 owning Check 对可信的完整 selection 建立 detached、冻结快照。 */\nexport function snapshotProjectFileSelection(\n  selection: ProjectFileSelection\n): ProjectFileSelection {\n  return Object.freeze({\n    exclude: Object.freeze([...selection.exclude]),\n    include: Object.freeze([...selection.include]),\n    source: selection.source\n  });\n}\n\nexport function validProjectFileSelection(value: unknown): value is ProjectFileSelection {\n  const selection = exactRecord(value, [\"exclude\", \"include\", \"source\"]);\n  return (\n    selection !== undefined &&\n    validStringArray(selection.exclude) &&\n    validStringArray(selection.include) &&\n    isProjectFileSource(selection.source)\n  );\n}\n\nfunction isProjectFileSource(value: unknown): value is ProjectFileSource {\n  return PROJECT_FILE_SOURCES.some((source) => source === value);\n}\n\nfunction resolveStringArray(\n  value: unknown,\n  fallback: readonly string[]\n): readonly string[] | undefined {\n  if (value === undefined) return Object.freeze([...fallback]);\n  const items = snapshotClosedArray(value);\n  if (items === undefined || !items.every(isString)) return undefined;\n  return Object.freeze([...items]);\n}\n\nfunction validStringArray(value: unknown): boolean {\n  const items = snapshotClosedArray(value);\n  return items !== undefined && items.every(isString);\n}\n\nfunction isString(value: unknown): value is string {\n  return typeof value === \"string\";\n}\n\nfunction exactRecord(\n  value: unknown,\n  keys: readonly string[]\n): Readonly<Record<string, unknown>> | undefined {\n  const record = snapshotClosedRecord(value);\n  return record !== undefined &&\n    Object.keys(record).length === keys.length &&\n    keys.every((key) => Object.hasOwn(record, key))\n    ? record\n    : undefined;\n}\n\nfunction deepFreeze<T>(value: T): T {\n  if (typeof value !== \"object\" || value === null || Object.isFrozen(value)) return value;\n  for (const nested of Object.values(value)) deepFreeze(nested);\n  return Object.freeze(value);\n}\n"]}

package/dist/esm/package-checks/project-files/exact-input-measurement.mjs

@@ -0,0 +1,24 @@
+export function acceptExactInputMeasurements(measurements, approvedExactPaths) {
+    const approvedPathSet = new Set(approvedExactPaths);
+    for (const [index, measurement] of measurements.entries()) {
+        if (measurement.sourcePaths.length === 0) {
+            return {
+                error: `scanner measurement #${index + 1} did not declare a source path`,
+                ok: false
+            };
+        }
+        for (const sourcePath of measurement.sourcePaths) {
+            if (!approvedPathSet.has(sourcePath)) {
+                return {
+                    error: `scanner measurement #${index + 1} references unapproved input path ${JSON.stringify(sourcePath)}`,
+                    ok: false
+                };
+            }
+        }
+    }
+    return {
+        ok: true,
+        payloads: measurements.map((measurement) => measurement.payload)
+    };
+}
+//# sourceMappingURL=exact-input-measurement.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exact-input-measurement.mjs","sourceRoot":"","sources":["../../../../src/package-checks/project-files/exact-input-measurement.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,4BAA4B,CAC1C,YAAiD,EACjD,kBAAqC;IAErC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAEpD,KAAK,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1D,IAAI,WAAW,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO;gBACL,KAAK,EAAE,wBAAwB,KAAK,GAAG,CAAC,gCAAgC;gBACxE,EAAE,EAAE,KAAK;aACV,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,UAAU,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;YACjD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACrC,OAAO;oBACL,KAAK,EAAE,wBAAwB,KAAK,GAAG,CAAC,qCAAqC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE;oBACzG,EAAE,EAAE,KAAK;iBACV,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC;KACjE,CAAC;AACJ,CAAC","sourcesContent":["export type ExactInputMeasurement<T> = {\n  readonly payload: T;\n  readonly sourcePaths: readonly string[];\n};\n\nexport type ExactInputMeasurementAcceptance<T> =\n  | { readonly ok: true; readonly payloads: readonly T[] }\n  | { readonly error: string; readonly ok: false };\n\nexport function acceptExactInputMeasurements<T>(\n  measurements: readonly ExactInputMeasurement<T>[],\n  approvedExactPaths: readonly string[]\n): ExactInputMeasurementAcceptance<T> {\n  const approvedPathSet = new Set(approvedExactPaths);\n\n  for (const [index, measurement] of measurements.entries()) {\n    if (measurement.sourcePaths.length === 0) {\n      return {\n        error: `scanner measurement #${index + 1} did not declare a source path`,\n        ok: false\n      };\n    }\n\n    for (const sourcePath of measurement.sourcePaths) {\n      if (!approvedPathSet.has(sourcePath)) {\n        return {\n          error: `scanner measurement #${index + 1} references unapproved input path ${JSON.stringify(sourcePath)}`,\n          ok: false\n        };\n      }\n    }\n  }\n\n  return {\n    ok: true,\n    payloads: measurements.map((measurement) => measurement.payload)\n  };\n}\n"]}

package/dist/esm/package-checks/project-files/file-fingerprint.mjs

@@ -0,0 +1,36 @@
+import { createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+/** Fingerprints one exact path set from stable path order and normalized current file content. */
+export function fingerprintProjectFiles(rootDir, paths) {
+    const sortedPaths = [...paths].sort(compareText);
+    const inputDigest = createHash("sha256");
+    for (const path of sortedPaths) {
+        inputDigest.update(path, "utf8");
+        inputDigest.update("\0");
+        inputDigest.update(fileContentFingerprint(rootDir, path), "utf8");
+        inputDigest.update("\n");
+    }
+    return Object.freeze({
+        fileCount: sortedPaths.length,
+        fileList: Object.freeze(sortedPaths.slice(0, 200)),
+        fingerprint: `sha256:${inputDigest.digest("hex")}:${sortedPaths.length}`
+    });
+}
+function fileContentFingerprint(rootDir, path) {
+    try {
+        const content = readFileSync(resolve(rootDir, path), "utf8").replace(/\r\n?/g, "\n");
+        return createHash("sha256").update(content).digest("hex");
+    }
+    catch {
+        return "file-not-readable";
+    }
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=file-fingerprint.mjs.map

package/dist/esm/package-checks/project-files/file-fingerprint.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-fingerprint.mjs","sourceRoot":"","sources":["../../../../src/package-checks/project-files/file-fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,kGAAkG;AAClG,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,KAAwB;IAExB,MAAM,WAAW,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEzC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACjC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,WAAW,CAAC,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAClE,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,WAAW,CAAC,MAAM;QAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAClD,WAAW,EAAE,UAAU,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,EAAE;KACzE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe,EAAE,IAAY;IAC3D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,mBAAmB,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC9C,IAAI,IAAI,GAAG,KAAK;QAAE,OAAO,CAAC,CAAC,CAAC;IAC5B,IAAI,IAAI,GAAG,KAAK;QAAE,OAAO,CAAC,CAAC;IAC3B,OAAO,CAAC,CAAC;AACX,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nexport interface FileInputFingerprint {\n  readonly fileCount: number;\n  readonly fileList: readonly string[];\n  readonly fingerprint: string;\n}\n\n/** Fingerprints one exact path set from stable path order and normalized current file content. */\nexport function fingerprintProjectFiles(\n  rootDir: string,\n  paths: readonly string[]\n): FileInputFingerprint {\n  const sortedPaths = [...paths].sort(compareText);\n  const inputDigest = createHash(\"sha256\");\n\n  for (const path of sortedPaths) {\n    inputDigest.update(path, \"utf8\");\n    inputDigest.update(\"\\0\");\n    inputDigest.update(fileContentFingerprint(rootDir, path), \"utf8\");\n    inputDigest.update(\"\\n\");\n  }\n\n  return Object.freeze({\n    fileCount: sortedPaths.length,\n    fileList: Object.freeze(sortedPaths.slice(0, 200)),\n    fingerprint: `sha256:${inputDigest.digest(\"hex\")}:${sortedPaths.length}`\n  });\n}\n\nfunction fileContentFingerprint(rootDir: string, path: string): string {\n  try {\n    const content = readFileSync(resolve(rootDir, path), \"utf8\").replace(/\\r\\n?/g, \"\\n\");\n    return createHash(\"sha256\").update(content).digest(\"hex\");\n  } catch {\n    return \"file-not-readable\";\n  }\n}\n\nfunction compareText(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n"]}

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

@@ -0,0 +1,57 @@
+/** Reads canonical gitlink entries from a named Git tree revision. */
+import { processFailed } from "../host-environment/process/command.mjs";
+import { runGit } from "../host-environment/git.mjs";
+import { toSlashPath } from "../host-environment/path.mjs";
+export function gitlinksAtRevision({ repository, revision }) {
+    const result = runGit({
+        args: ["ls-tree", "-r", "-z", revision],
+        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 inspect gitlinks at ${revision} in ${repository}: ${detail}`);
+    }
+    const gitlinks = [];
+    for (const entry of result.stdout.split("\0")) {
+        if (!entry)
+            continue;
+        const gitlink = parseGitlinkEntry({ entry, repository, revision });
+        if (gitlink !== null)
+            gitlinks.push(gitlink);
+    }
+    return Object.freeze(gitlinks);
+}
+function parseGitlinkEntry({ entry, repository, revision }) {
+    const parsed = gitTreeEntryParts(entry);
+    if (parsed === undefined)
+        throw invalidTreeOutput(revision, repository);
+    const [mode, type, sha] = parsed.metadata;
+    if (!validGitTreeMetadata(mode, type, sha))
+        throw invalidTreeOutput(revision, repository);
+    if (mode !== "160000")
+        return null;
+    if (type !== "commit") {
+        throw new Error(`invalid gitlink output at ${revision} in ${repository}`);
+    }
+    return Object.freeze({ path: toSlashPath(parsed.path), sha });
+}
+function gitTreeEntryParts(entry) {
+    const separator = entry.indexOf("\t");
+    if (separator < 0)
+        return undefined;
+    const metadata = entry.slice(0, separator).split(/\s+/u);
+    const path = entry.slice(separator + 1);
+    return metadata.length === 3 && path.length > 0 ? { metadata, path } : undefined;
+}
+function validGitTreeMetadata(mode, type, sha) {
+    return mode !== undefined && type !== undefined && sha !== undefined && isFullGitObjectId(sha);
+}
+function invalidTreeOutput(revision, repository) {
+    return new Error(`invalid git tree output at ${revision} in ${repository}`);
+}
+function isFullGitObjectId(value) {
+    return /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/u.test(value);
+}
+//# sourceMappingURL=gitlink-revision.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gitlink-revision.mjs","sourceRoot":"","sources":["../../../../src/package-checks/project-files/gitlink-revision.ts"],"names":[],"mappings":"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","sourcesContent":["/** Reads canonical gitlink entries from a named Git tree revision. */\n\nimport { processFailed } from \"../host-environment/process/command.ts\";\nimport { runGit } from \"../host-environment/git.ts\";\nimport { toSlashPath } from \"../host-environment/path.ts\";\n\nexport type Gitlink = Readonly<{\n  readonly path: string;\n  readonly sha: string;\n}>;\n\nexport function gitlinksAtRevision({\n  repository,\n  revision\n}: Readonly<{\n  readonly repository: string;\n  readonly revision: string;\n}>): readonly Gitlink[] {\n  const result = runGit({\n    args: [\"ls-tree\", \"-r\", \"-z\", revision],\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 inspect gitlinks at ${revision} in ${repository}: ${detail}`);\n  }\n\n  const gitlinks: Gitlink[] = [];\n  for (const entry of result.stdout.split(\"\\0\")) {\n    if (!entry) continue;\n    const gitlink = parseGitlinkEntry({ entry, repository, revision });\n    if (gitlink !== null) gitlinks.push(gitlink);\n  }\n  return Object.freeze(gitlinks);\n}\n\nfunction parseGitlinkEntry({\n  entry,\n  repository,\n  revision\n}: Readonly<{\n  readonly entry: string;\n  readonly repository: string;\n  readonly revision: string;\n}>): Gitlink | null {\n  const parsed = gitTreeEntryParts(entry);\n  if (parsed === undefined) throw invalidTreeOutput(revision, repository);\n  const [mode, type, sha] = parsed.metadata;\n  if (!validGitTreeMetadata(mode, type, sha)) throw invalidTreeOutput(revision, repository);\n  if (mode !== \"160000\") return null;\n  if (type !== \"commit\") {\n    throw new Error(`invalid gitlink output at ${revision} in ${repository}`);\n  }\n  return Object.freeze({ path: toSlashPath(parsed.path), sha });\n}\n\nfunction gitTreeEntryParts(entry: string): { metadata: string[]; path: string } | undefined {\n  const separator = entry.indexOf(\"\\t\");\n  if (separator < 0) return undefined;\n  const metadata = entry.slice(0, separator).split(/\\s+/u);\n  const path = entry.slice(separator + 1);\n  return metadata.length === 3 && path.length > 0 ? { metadata, path } : undefined;\n}\n\nfunction validGitTreeMetadata(\n  mode: string | undefined,\n  type: string | undefined,\n  sha: string | undefined\n): sha is string {\n  return mode !== undefined && type !== undefined && sha !== undefined && isFullGitObjectId(sha);\n}\n\nfunction invalidTreeOutput(revision: string, repository: string): Error {\n  return new Error(`invalid git tree output at ${revision} in ${repository}`);\n}\n\nfunction isFullGitObjectId(value: string): boolean {\n  return /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/u.test(value);\n}\n"]}