gh-inari 0.1.0

package/dist/github/transport.js

@@ -0,0 +1,54 @@
+import { spawn } from "node:child_process";
+export class ProcessGhTransport {
+    executable;
+    constructor(executable = "gh") {
+        this.executable = executable;
+    }
+    run(args, options = {}) {
+        return new Promise((resolve, reject) => {
+            let child;
+            try {
+                child = spawn(this.executable, [...args], {
+                    cwd: options.cwd,
+                    stdio: ["ignore", "pipe", "pipe"],
+                });
+            }
+            catch (error) {
+                reject(error);
+                return;
+            }
+            if (child.stdout === null || child.stderr === null) {
+                reject(new Error("gh transport did not provide stdout and stderr pipes"));
+                return;
+            }
+            let stdout = "";
+            let stderr = "";
+            child.stdout.setEncoding("utf8");
+            child.stderr.setEncoding("utf8");
+            child.stdout.on("data", (chunk) => {
+                stdout += chunk;
+            });
+            child.stderr.on("data", (chunk) => {
+                stderr += chunk;
+            });
+            child.once("error", reject);
+            const timer = options.timeoutMs === undefined
+                ? undefined
+                : setTimeout(() => {
+                    child.kill("SIGTERM");
+                }, options.timeoutMs);
+            timer?.unref();
+            child.once("close", (exitCode, signal) => {
+                if (timer !== undefined)
+                    clearTimeout(timer);
+                resolve({
+                    exitCode: exitCode ?? 1,
+                    stdout,
+                    stderr,
+                    ...(signal === null ? {} : { signal }),
+                });
+            });
+        });
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/github/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/github/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAmB3C,MAAM,OAAO,kBAAkB;IACpB,UAAU,CAAS;IAE5B,YAAY,UAAU,GAAG,IAAI;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,IAAuB,EAAE,UAA8B,EAAE;QAC3D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,KAA+B,CAAC;YACpC,IAAI,CAAC;gBACH,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE;oBACxC,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;iBAClC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;gBACd,OAAO;YACT,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;gBACnD,MAAM,CAAC,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC,CAAC;gBAC1E,OAAO;YACT,CAAC;YAED,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACxC,MAAM,IAAI,KAAK,CAAC;YAClB,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACxC,MAAM,IAAI,KAAK,CAAC;YAClB,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5B,MAAM,KAAK,GACT,OAAO,CAAC,SAAS,KAAK,SAAS;gBAC7B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;oBACd,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAC5B,KAAK,EAAE,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,QAAuB,EAAE,MAA6B,EAAE,EAAE;gBAC7E,IAAI,KAAK,KAAK,SAAS;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC7C,OAAO,CAAC;oBACN,QAAQ,EAAE,QAAQ,IAAI,CAAC;oBACvB,MAAM;oBACN,MAAM;oBACN,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;iBACvC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/github/types.d.ts

@@ -0,0 +1,62 @@
+export declare const VALIDATED_RENDERED_PHASE: "validated-rendered";
+export type ValidatedRenderedPhase = typeof VALIDATED_RENDERED_PHASE;
+/**
+ * This discriminator is the handoff contract from Inari's compiler/validator.
+ * The adapter checks the handoff shape but does not compile, validate, or render it.
+ */
+export interface ValidatedRenderedIssueArtifact {
+    readonly phase: ValidatedRenderedPhase;
+    readonly kind: "issue";
+    readonly title: string;
+    readonly body: string;
+    readonly labels?: readonly string[];
+    readonly assignees?: readonly string[];
+}
+export interface ValidatedRenderedPullRequestArtifact {
+    readonly phase: ValidatedRenderedPhase;
+    readonly kind: "pull_request";
+    readonly title: string;
+    readonly body: string;
+    readonly head: string;
+    readonly base: string;
+    readonly draft?: boolean;
+    readonly maintainerCanModify?: boolean;
+}
+export type ValidatedRenderedArtifact = ValidatedRenderedIssueArtifact | ValidatedRenderedPullRequestArtifact;
+/**
+ * Creates the explicit compiler-to-adapter handoff marker. Callers must invoke
+ * this only after their own contract validation and canonical rendering.
+ */
+export declare function markValidatedRenderedIssueArtifact(artifact: Omit<ValidatedRenderedIssueArtifact, "phase">): ValidatedRenderedIssueArtifact;
+/**
+ * Creates the explicit compiler-to-adapter handoff marker. Callers must invoke
+ * this only after their own contract validation and canonical rendering.
+ */
+export declare function markValidatedRenderedPullRequestArtifact(artifact: Omit<ValidatedRenderedPullRequestArtifact, "phase">): ValidatedRenderedPullRequestArtifact;
+export interface RepositoryContext {
+    readonly hostname: string;
+    readonly host: string;
+    readonly owner: string;
+    readonly name: string;
+    readonly nameWithOwner: string;
+    readonly url: string;
+}
+export interface GitHubIssue {
+    readonly number: number;
+    readonly title: string;
+    readonly body: string | null;
+    readonly state: "open" | "closed";
+    readonly url: string;
+    readonly labels: readonly string[];
+    readonly assignees: readonly string[];
+}
+export interface GitHubPullRequest {
+    readonly number: number;
+    readonly title: string;
+    readonly body: string | null;
+    readonly state: "open" | "closed";
+    readonly url: string;
+    readonly draft: boolean;
+    readonly head: string;
+    readonly base: string;
+}

package/dist/github/types.js

@@ -0,0 +1,16 @@
+export const VALIDATED_RENDERED_PHASE = "validated-rendered";
+/**
+ * Creates the explicit compiler-to-adapter handoff marker. Callers must invoke
+ * this only after their own contract validation and canonical rendering.
+ */
+export function markValidatedRenderedIssueArtifact(artifact) {
+    return { ...artifact, phase: VALIDATED_RENDERED_PHASE };
+}
+/**
+ * Creates the explicit compiler-to-adapter handoff marker. Callers must invoke
+ * this only after their own contract validation and canonical rendering.
+ */
+export function markValidatedRenderedPullRequestArtifact(artifact) {
+    return { ...artifact, phase: VALIDATED_RENDERED_PHASE };
+}
+//# sourceMappingURL=types.js.map

package/dist/github/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/github/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,oBAA6B,CAAC;AA8BtE;;;GAGG;AACH,MAAM,UAAU,kCAAkC,CAChD,QAAuD;IAEvD,OAAO,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wCAAwC,CACtD,QAA6D;IAE7D,OAAO,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;AAC1D,CAAC"}

package/dist/github.d.ts

@@ -0,0 +1 @@
+export * from "./github/index.js";

package/dist/github.js

@@ -0,0 +1,2 @@
+export * from "./github/index.js";
+//# sourceMappingURL=github.js.map

package/dist/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { runCli } from "./cli.js";
+export { runCli };
+export * from "./artifact.js";
+export * from "./pr-policy.js";
+export * from "./contract/index.js";
+export * from "./github/index.js";
+export * from "./pull-request-template.js";
+export { discoverTemplates, discoverTemplatesSync, selectTemplate, selectIssueTemplate, selectPullRequestTemplate, TemplateDiscoveryError, TemplateFilesystemError, TemplateNotFoundError, TemplateSelectionAmbiguousError, TemplateNameConflictError, InvalidTemplateSelectorError, } from "./template-discovery.js";
+export type { TemplateDiscoveryResult, TemplateSelector, TemplateType, TemplateKind, TemplateDiscoveryErrorCode, TemplateDiscoveryErrorDetails, } from "./template-discovery.js";

package/dist/index.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import path from "node:path";
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { runCli } from "./cli.js";
+export { runCli };
+export * from "./artifact.js";
+export * from "./pr-policy.js";
+export * from "./contract/index.js";
+export * from "./github/index.js";
+export * from "./pull-request-template.js";
+export { discoverTemplates, discoverTemplatesSync, selectTemplate, selectIssueTemplate, selectPullRequestTemplate, TemplateDiscoveryError, TemplateFilesystemError, TemplateNotFoundError, TemplateSelectionAmbiguousError, TemplateNameConflictError, InvalidTemplateSelectorError, } from "./template-discovery.js";
+let invokedPath;
+try {
+    invokedPath = process.argv[1] === undefined ? undefined : realpathSync(path.resolve(process.argv[1]));
+}
+catch {
+    invokedPath = undefined;
+}
+if (invokedPath === fileURLToPath(import.meta.url)) {
+    runCli(process.argv.slice(2))
+        .then((exitCode) => {
+        process.exitCode = exitCode;
+    })
+        .catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        if (process.exitCode === undefined || process.exitCode === 0) {
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,CAAC;AAClB,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,+BAA+B,EAC/B,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AAUjC,IAAI,WAA+B,CAAC;AACpC,IAAI,CAAC;IACH,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC;AAAC,MAAM,CAAC;IACP,WAAW,GAAG,SAAS,CAAC;AAC1B,CAAC;AACD,IAAI,WAAW,KAAK,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACnD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC1B,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QACjB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC9B,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC7D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/pr-policy.d.ts

@@ -0,0 +1,39 @@
+import { type CanonicalContract } from "./contract/ir.js";
+export declare const PULL_REQUEST_POLICY_VERSION: 1;
+export type PullRequestPolicyErrorCode = "PR_POLICY_INVALID_YAML" | "PR_POLICY_INVALID_ROOT" | "PR_POLICY_UNSUPPORTED_VERSION" | "PR_POLICY_UNKNOWN_PROPERTY" | "PR_POLICY_INVALID_VALUE" | "PR_POLICY_TEMPLATE_MISMATCH" | "PR_POLICY_UNKNOWN_REFERENCE" | "PR_POLICY_AMBIGUOUS_REFERENCE" | "PR_POLICY_UNSUPPORTED_CONSTRAINT" | "PR_POLICY_CONFLICT";
+export declare class PullRequestPolicyError extends Error {
+    readonly code: PullRequestPolicyErrorCode;
+    readonly path: string;
+    constructor(code: PullRequestPolicyErrorCode, message: string, path?: string);
+    toJSON(): {
+        code: PullRequestPolicyErrorCode;
+        path: string;
+        message: string;
+    };
+}
+export interface PullRequestPolicyOverlay {
+    readonly version: typeof PULL_REQUEST_POLICY_VERSION;
+    readonly template?: string | PullRequestPolicyTemplateSelector;
+    readonly sections: readonly PullRequestPolicySectionRule[];
+}
+export interface PullRequestPolicyTemplateSelector {
+    readonly id?: string;
+    readonly path?: string;
+    readonly name?: string;
+}
+export interface PullRequestPolicySectionRule {
+    readonly fieldId: string;
+    readonly required?: boolean;
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly pattern?: string;
+    readonly minItems?: number;
+    readonly maxItems?: number;
+    readonly linkedIssue?: boolean;
+    readonly checklistMinCompleted?: number;
+    readonly checklistRequireComplete?: boolean;
+}
+/** Compile a small, data-only PR overlay into the shared canonical contract. */
+export declare function compilePullRequestPolicyOverlay(contractInput: unknown, source: string | PullRequestPolicyOverlay): CanonicalContract;
+export declare function parsePullRequestPolicyOverlay(source: string): PullRequestPolicyOverlay;
+export declare function compilePullRequestPolicyFile(contract: unknown, filePath: string): Promise<CanonicalContract>;

package/dist/pr-policy.js

@@ -0,0 +1,313 @@
+import { readFile } from "node:fs/promises";
+import { parse as parseYaml } from "yaml";
+import { assertCanonicalContract, } from "./contract/ir.js";
+export const PULL_REQUEST_POLICY_VERSION = 1;
+export class PullRequestPolicyError extends Error {
+    code;
+    path;
+    constructor(code, message, path = "$") {
+        super(message);
+        this.name = "PullRequestPolicyError";
+        this.code = code;
+        this.path = path;
+    }
+    toJSON() {
+        return { code: this.code, path: this.path, message: this.message };
+    }
+}
+/** Compile a small, data-only PR overlay into the shared canonical contract. */
+export function compilePullRequestPolicyOverlay(contractInput, source) {
+    assertCanonicalContract(contractInput);
+    const contract = contractInput;
+    if (contract.artifactKind !== "pull_request") {
+        throw new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", "PR policy overlays apply only to pull request contracts.");
+    }
+    const overlay = typeof source === "string" ? parsePullRequestPolicyOverlay(source) : source;
+    assertOverlayVersion(overlay);
+    assertTemplateMatch(overlay.template, contract);
+    const mergedFields = [...contract.supplementalConstraints.fields];
+    overlay.sections.forEach((rule, ruleIndex) => {
+        const field = resolveField(contract, rule.fieldId);
+        const rulePath = `$.sections[${ruleIndex}]`;
+        const constraint = ruleToConstraint(rule, field, rulePath);
+        const existingIndex = mergedFields.findIndex((entry) => entry.fieldId === field.id);
+        if (existingIndex < 0)
+            mergedFields.push(constraint);
+        else
+            mergedFields[existingIndex] = mergeConstraints(mergedFields[existingIndex], constraint, rulePath);
+    });
+    const merged = {
+        ...contract,
+        supplementalConstraints: {
+            fields: mergedFields,
+        },
+    };
+    try {
+        assertCanonicalContract(merged);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Compiled PR policy is not a valid canonical contract.";
+        throw new PullRequestPolicyError("PR_POLICY_CONFLICT", message, "$.sections");
+    }
+    return merged;
+}
+function mergeConstraints(previous, next, path) {
+    const keys = [
+        "required",
+        "minLength",
+        "maxLength",
+        "pattern",
+        "minItems",
+        "maxItems",
+        "linkedIssue",
+        "checklistMinCompleted",
+        "checklistRequireComplete",
+    ];
+    for (const key of keys) {
+        if (previous[key] !== undefined && next[key] !== undefined && previous[key] !== next[key]) {
+            throw new PullRequestPolicyError("PR_POLICY_CONFLICT", `Overlay constraint for field "${previous.fieldId}" conflicts with an existing supplemental constraint.`, `${path}.${String(key)}`);
+        }
+    }
+    return { ...previous, ...next };
+}
+export function parsePullRequestPolicyOverlay(source) {
+    let value;
+    try {
+        value = parseYaml(source);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Invalid YAML.";
+        throw new PullRequestPolicyError("PR_POLICY_INVALID_YAML", message);
+    }
+    if (!isRecord(value))
+        throw new PullRequestPolicyError("PR_POLICY_INVALID_ROOT", "PR policy must be a mapping.");
+    assertKeys(value, ["version", "template", "templates", "sections", "fields"], "$");
+    if (value.template !== undefined && value.templates !== undefined) {
+        throw new PullRequestPolicyError("PR_POLICY_CONFLICT", "Cannot specify both 'template' and 'templates'.", "$.template");
+    }
+    if (value.sections !== undefined && value.fields !== undefined) {
+        throw new PullRequestPolicyError("PR_POLICY_CONFLICT", "Cannot specify both 'sections' and 'fields'.", "$.sections");
+    }
+    const version = value.version;
+    if (version !== PULL_REQUEST_POLICY_VERSION) {
+        throw new PullRequestPolicyError("PR_POLICY_UNSUPPORTED_VERSION", `Only PR policy version ${PULL_REQUEST_POLICY_VERSION} is supported.`, "$.version");
+    }
+    if (Array.isArray(value.templates)) {
+        if (value.templates.length !== 1) {
+            throw new PullRequestPolicyError("PR_POLICY_UNSUPPORTED_CONSTRAINT", "A standalone overlay must contain exactly one template entry; use a repository policy file to hold multiple entries.", "$.templates");
+        }
+        const entry = value.templates[0];
+        if (!isRecord(entry))
+            throw new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", "Template entries must be objects.", "$.templates[0]");
+        assertKeys(entry, ["template", "sections", "fields"], "$.templates[0]");
+        if (entry.sections !== undefined && entry.fields !== undefined) {
+            throw new PullRequestPolicyError("PR_POLICY_CONFLICT", "Cannot specify both 'sections' and 'fields'.", "$.templates[0].sections");
+        }
+        const sections = parseRules(entry.sections ?? entry.fields, "$.templates[0].sections");
+        return {
+            version: PULL_REQUEST_POLICY_VERSION,
+            template: parseSelector(entry.template, "$.templates[0].template"),
+            sections,
+        };
+    }
+    return {
+        version: PULL_REQUEST_POLICY_VERSION,
+        ...(value.template === undefined ? {} : { template: parseSelector(value.template, "$.template") }),
+        sections: parseRules(value.sections ?? value.fields, "$.sections"),
+    };
+}
+export async function compilePullRequestPolicyFile(contract, filePath) {
+    let source;
+    try {
+        source = await readFile(filePath, "utf8");
+    }
+    catch (cause) {
+        const error = new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", `Cannot read PR policy file "${filePath}".`);
+        if (cause instanceof Error)
+            error.cause = cause;
+        throw error;
+    }
+    return compilePullRequestPolicyOverlay(contract, source);
+}
+function parseRules(value, path) {
+    if (!Array.isArray(value))
+        throw new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", "sections must be an array.", path);
+    return value.map((entry, index) => parseRule(entry, `${path}[${index}]`));
+}
+function parseRule(value, path) {
+    if (!isRecord(value))
+        throw new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", "Section rules must be objects.", path);
+    assertKeys(value, [
+        "id",
+        "fieldId",
+        "section",
+        "sectionId",
+        "required",
+        "minLength",
+        "maxLength",
+        "pattern",
+        "minItems",
+        "maxItems",
+        "linkedIssue",
+        "checklistMinCompleted",
+        "checklistRequireComplete",
+        "checklist",
+    ], path);
+    const references = ["id", "fieldId", "section", "sectionId"].filter((key) => value[key] !== undefined);
+    if (references.length !== 1 || typeof value[references[0]] !== "string") {
+        throw new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", "Each rule must contain exactly one string field identity using id, fieldId, section, or sectionId.", path);
+    }
+    const fieldId = value[references[0]];
+    const required = optionalBoolean(value, "required", path);
+    const minLength = optionalInteger(value, "minLength", path);
+    const maxLength = optionalInteger(value, "maxLength", path);
+    const directPattern = optionalString(value, "pattern", path);
+    const minItems = optionalInteger(value, "minItems", path);
+    const maxItems = optionalInteger(value, "maxItems", path);
+    const linkedIssue = optionalBoolean(value, "linkedIssue", path);
+    let checklistMinCompleted = optionalInteger(value, "checklistMinCompleted", path);
+    let checklistRequireComplete = optionalBoolean(value, "checklistRequireComplete", path);
+    if (value.checklist !== undefined) {
+        if (!isRecord(value.checklist))
+            throw new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", "checklist must be an object.", `${path}.checklist`);
+        assertKeys(value.checklist, ["minCompleted", "requireComplete"], `${path}.checklist`);
+        if (checklistMinCompleted !== undefined || checklistRequireComplete !== undefined) {
+            throw new PullRequestPolicyError("PR_POLICY_CONFLICT", "Use either checklist shorthand or checklist object, not both.", path);
+        }
+        checklistMinCompleted = optionalInteger(value.checklist, "minCompleted", `${path}.checklist`);
+        checklistRequireComplete = optionalBoolean(value.checklist, "requireComplete", `${path}.checklist`);
+    }
+    if (linkedIssue === true && directPattern !== undefined) {
+        throw new PullRequestPolicyError("PR_POLICY_CONFLICT", "linkedIssue cannot be combined with pattern.", path);
+    }
+    if (minLength !== undefined && maxLength !== undefined && minLength > maxLength) {
+        throw new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", "minLength cannot exceed maxLength.", path);
+    }
+    if (minItems !== undefined && maxItems !== undefined && minItems > maxItems) {
+        throw new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", "minItems cannot exceed maxItems.", path);
+    }
+    return {
+        fieldId,
+        ...(required === undefined ? {} : { required }),
+        ...(minLength === undefined ? {} : { minLength }),
+        ...(maxLength === undefined ? {} : { maxLength }),
+        ...(directPattern === undefined ? {} : { pattern: directPattern }),
+        ...(minItems === undefined ? {} : { minItems }),
+        ...(maxItems === undefined ? {} : { maxItems }),
+        ...(linkedIssue === undefined ? {} : { linkedIssue }),
+        ...(checklistMinCompleted === undefined ? {} : { checklistMinCompleted }),
+        ...(checklistRequireComplete === undefined ? {} : { checklistRequireComplete }),
+    };
+}
+function ruleToConstraint(rule, field, path) {
+    if (rule.linkedIssue === true && field.type !== "string" && field.type !== "enum") {
+        throw new PullRequestPolicyError("PR_POLICY_UNSUPPORTED_CONSTRAINT", "linkedIssue requires a string-like section.", path);
+    }
+    if ((rule.checklistMinCompleted !== undefined || rule.checklistRequireComplete !== undefined) &&
+        field.type !== "checklist") {
+        throw new PullRequestPolicyError("PR_POLICY_UNSUPPORTED_CONSTRAINT", "Checklist constraints require a checklist section.", path);
+    }
+    if (rule.pattern !== undefined) {
+        try {
+            new RegExp(rule.pattern, "u");
+        }
+        catch {
+            throw new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", "pattern must be a valid regular expression.", path);
+        }
+    }
+    if (rule.linkedIssue === true && rule.required === false) {
+        throw new PullRequestPolicyError("PR_POLICY_CONFLICT", "linkedIssue cannot be combined with required=false.", path);
+    }
+    return {
+        fieldId: field.id,
+        ...(rule.required === undefined && rule.linkedIssue !== true ? {} : { required: rule.required ?? true }),
+        ...(rule.minLength === undefined ? {} : { minLength: rule.minLength }),
+        ...(rule.maxLength === undefined ? {} : { maxLength: rule.maxLength }),
+        ...(rule.pattern === undefined ? {} : { pattern: rule.pattern }),
+        ...(rule.minItems === undefined ? {} : { minItems: rule.minItems }),
+        ...(rule.maxItems === undefined ? {} : { maxItems: rule.maxItems }),
+        ...(rule.linkedIssue === undefined ? {} : { linkedIssue: rule.linkedIssue }),
+        ...(rule.checklistMinCompleted === undefined ? {} : { checklistMinCompleted: rule.checklistMinCompleted }),
+        ...(rule.checklistRequireComplete === undefined ? {} : { checklistRequireComplete: rule.checklistRequireComplete }),
+    };
+}
+function resolveField(contract, reference) {
+    const matches = contract.sections
+        .flatMap((section) => [...section.fields])
+        .filter((field) => field.id === reference || field.nativeMetadata.sourceId === reference);
+    if (matches.length === 0) {
+        throw new PullRequestPolicyError("PR_POLICY_UNKNOWN_REFERENCE", `No native PR section matches "${reference}".`, reference);
+    }
+    if (matches.length > 1) {
+        throw new PullRequestPolicyError("PR_POLICY_AMBIGUOUS_REFERENCE", `Multiple native PR sections match "${reference}".`, reference);
+    }
+    return matches[0];
+}
+function assertOverlayVersion(overlay) {
+    if (overlay.version !== PULL_REQUEST_POLICY_VERSION) {
+        throw new PullRequestPolicyError("PR_POLICY_UNSUPPORTED_VERSION", "Unsupported PR policy version.", "$.version");
+    }
+}
+function assertTemplateMatch(selector, contract) {
+    if (selector === undefined)
+        return;
+    const matches = typeof selector === "string"
+        ? selector === contract.templateIdentity.id ||
+            selector === contract.templateIdentity.path ||
+            selector.toLocaleLowerCase("en-US") === contract.templateIdentity.name.toLocaleLowerCase("en-US")
+        : (selector.id === undefined || selector.id === contract.templateIdentity.id) &&
+            (selector.path === undefined || selector.path === contract.templateIdentity.path) &&
+            (selector.name === undefined ||
+                selector.name.toLocaleLowerCase("en-US") === contract.templateIdentity.name.toLocaleLowerCase("en-US"));
+    if (!matches) {
+        throw new PullRequestPolicyError("PR_POLICY_TEMPLATE_MISMATCH", "PR policy does not target the selected native template.", "$.template");
+    }
+}
+function parseSelector(value, path) {
+    if (typeof value === "string" && value.trim().length > 0)
+        return value;
+    if (!isRecord(value))
+        throw new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", "template must be a non-empty string or selector object.", path);
+    assertKeys(value, ["id", "path", "name"], path);
+    const selector = {
+        ...(typeof value.id === "string" ? { id: value.id } : {}),
+        ...(typeof value.path === "string" ? { path: value.path } : {}),
+        ...(typeof value.name === "string" ? { name: value.name } : {}),
+    };
+    if (Object.keys(selector).length === 0)
+        throw new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", "template selector must not be empty.", path);
+    return selector;
+}
+function assertKeys(record, allowed, path) {
+    const allowedSet = new Set(allowed);
+    const unknown = Object.keys(record).filter((key) => !allowedSet.has(key));
+    if (unknown.length > 0) {
+        throw new PullRequestPolicyError("PR_POLICY_UNKNOWN_PROPERTY", `Unknown property "${unknown[0]}".`, `${path}.${unknown[0]}`);
+    }
+}
+function optionalString(record, key, path) {
+    if (record[key] === undefined)
+        return undefined;
+    if (typeof record[key] !== "string")
+        throw new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", `${key} must be a string.`, `${path}.${key}`);
+    return record[key];
+}
+function optionalBoolean(record, key, path) {
+    if (record[key] === undefined)
+        return undefined;
+    if (typeof record[key] !== "boolean")
+        throw new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", `${key} must be a boolean.`, `${path}.${key}`);
+    return record[key];
+}
+function optionalInteger(record, key, path) {
+    if (record[key] === undefined)
+        return undefined;
+    if (!Number.isSafeInteger(record[key]) || typeof record[key] !== "number" || record[key] < 0) {
+        throw new PullRequestPolicyError("PR_POLICY_INVALID_VALUE", `${key} must be a non-negative integer.`, `${path}.${key}`);
+    }
+    return record[key];
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=pr-policy.js.map

package/dist/pr-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-policy.js","sourceRoot":"","sources":["../src/pr-policy.ts"],"names":[],"mappings":"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"}

package/dist/pull-request-template.d.ts

@@ -0,0 +1,42 @@
+import { type CanonicalContract } from "./contract/ir.js";
+import { type TemplateIdentity as DiscoveredTemplateIdentity, type TemplateSelector } from "./template-discovery.js";
+export type PullRequestTemplateErrorCode = "PR_TEMPLATE_EMPTY" | "PR_TEMPLATE_UNSUPPORTED_CONSTRUCT" | "PR_TEMPLATE_AMBIGUOUS_STRUCTURE" | "PR_TEMPLATE_NOT_PULL_REQUEST" | "PR_TEMPLATE_READ_FAILED";
+export interface PullRequestTemplateErrorDetails {
+    readonly path?: string;
+    readonly line?: number;
+    readonly construct?: string;
+    readonly reason?: string;
+}
+/** A typed failure raised when the supported PR-template subset cannot be represented safely. */
+export declare class PullRequestTemplateError extends Error {
+    readonly code: PullRequestTemplateErrorCode;
+    readonly details: PullRequestTemplateErrorDetails;
+    constructor(code: PullRequestTemplateErrorCode, message: string, details?: PullRequestTemplateErrorDetails, options?: ErrorOptions);
+    toJSON(): {
+        code: PullRequestTemplateErrorCode;
+        message: string;
+        details: PullRequestTemplateErrorDetails;
+    };
+}
+/**
+ * Parse one repository-native PR template into the existing canonical IR.
+ *
+ * The identity is deliberately the discovery-layer identity. This keeps
+ * filesystem discovery and parsing as separate concerns while ensuring the
+ * compiled contract cannot be detached from a native template path.
+ */
+export declare function parsePullRequestTemplate(markdown: string, identity: DiscoveredTemplateIdentity): CanonicalContract;
+/** Compile one discovered native PR template from a repository root. */
+export declare function compilePullRequestTemplate(repositoryRoot?: string | URL, selector?: string | TemplateSelector): Promise<CanonicalContract>;
+/** Synchronous counterpart for callers that already operate synchronously. */
+export declare function compilePullRequestTemplateSync(repositoryRoot?: string | URL, selector?: string | TemplateSelector): CanonicalContract;
+/** Compile all native PR templates in the discovery layer's stable order. */
+export declare function compilePullRequestTemplates(repositoryRoot?: string | URL): Promise<readonly CanonicalContract[]>;
+/** Synchronous counterpart of compilePullRequestTemplates. */
+export declare function compilePullRequestTemplatesSync(repositoryRoot?: string | URL): readonly CanonicalContract[];
+/**
+ * Render the structural portion of a validated PR contract as canonical GFM.
+ * No placeholder, requirement, or policy is invented when the IR does not
+ * contain one.
+ */
+export declare function renderPullRequestTemplate(input: unknown): string;