@davidahmann/mill 0.1.4

package/dist/planning/specification.js

@@ -0,0 +1,235 @@
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { sourceManifestSchema, specificationProposalSchema, } from "../contracts/schemas.js";
+import { canonicalDigest, canonicalJson, } from "../contracts/canonical.js";
+import { ExitCode, MillError } from "../errors.js";
+import { safeReadText } from "../security/safe-path.js";
+import { textDigest } from "../runtime/inputs.js";
+function parseDocument(source, extension, schema, label) {
+    let raw;
+    try {
+        raw = extension === ".json" ? JSON.parse(source) : parseYaml(source);
+    }
+    catch (error) {
+        throw new MillError("INVALID_PLANNING_INPUT", `${label} is not valid YAML or JSON.`, ExitCode.data, { cause: String(error) });
+    }
+    const parsed = schema.safeParse(raw);
+    if (!parsed.success) {
+        throw new MillError("INVALID_PLANNING_INPUT", `${label} does not satisfy its schema.`, ExitCode.data, { issues: parsed.error.issues });
+    }
+    return parsed.data;
+}
+export async function loadPlanningSources(input) {
+    const [prd, source] = await Promise.all([
+        safeReadText(input.root, input.prdPath, 2 * 1024 * 1024),
+        safeReadText(input.root, input.sourceManifestPath, 2 * 1024 * 1024),
+    ]);
+    const sourceManifest = parseDocument(source, path.extname(input.sourceManifestPath).toLowerCase(), sourceManifestSchema, input.sourceManifestPath);
+    return {
+        prdPath: input.prdPath,
+        prd,
+        prdDigest: textDigest(prd),
+        sourceManifest,
+        sourceManifestDigest: canonicalDigest(sourceManifest),
+    };
+}
+export async function loadSpecificationProposal(root, proposalPath) {
+    const source = await safeReadText(root, proposalPath, 4 * 1024 * 1024);
+    return parseDocument(source, path.extname(proposalPath).toLowerCase(), specificationProposalSchema, proposalPath);
+}
+function duplicates(values) {
+    const seen = new Set();
+    const duplicate = new Set();
+    for (const value of values) {
+        if (seen.has(value))
+            duplicate.add(value);
+        seen.add(value);
+    }
+    return [...duplicate].sort();
+}
+function normalizedStatement(value) {
+    return value
+        .normalize("NFKC")
+        .toLowerCase()
+        .replaceAll(/[^a-z0-9]+/gu, " ")
+        .trim();
+}
+export function assessSpecificationProposal(input) {
+    const { proposal, sourceManifest } = input;
+    const blockers = [];
+    const warnings = [];
+    const sourceIds = new Set(sourceManifest.sources.map((source) => source.id));
+    const invariantIds = new Set(proposal.productContract.invariants.map((invariant) => invariant.id));
+    const acceptanceIds = new Set(proposal.productContract.acceptance.map((item) => item.id));
+    if (proposal.prd.path !== input.prdPath ||
+        proposal.prd.digest !== input.prdDigest) {
+        blockers.push("proposal PRD identity does not match the inspected input");
+    }
+    if (proposal.sourceManifestDigest !== input.sourceManifestDigest) {
+        blockers.push("proposal source-manifest identity is stale");
+    }
+    const normalizedPrdPath = path
+        .normalize(input.prdPath)
+        .split(path.sep)
+        .join("/");
+    const prdSources = sourceManifest.sources.filter((source) => {
+        const normalizedSourcePath = path
+            .normalize(source.uri)
+            .split(path.sep)
+            .join("/");
+        return (normalizedSourcePath === normalizedPrdPath &&
+            (source.revision === input.prdDigest || source.digest === input.prdDigest));
+    });
+    if (prdSources.length !== 1) {
+        blockers.push("exactly one source must bind the inspected PRD identity");
+    }
+    const prdSource = prdSources[0];
+    if (prdSources.length === 1 &&
+        prdSource !== undefined &&
+        !proposal.productContract.sourceRefs.includes(prdSource.id)) {
+        blockers.push(`product contract does not bind the inspected PRD source: ${prdSource.id}`);
+    }
+    for (const duplicate of duplicates(sourceManifest.sources.map((source) => source.id))) {
+        blockers.push(`source identity is duplicated: ${duplicate}`);
+    }
+    if (proposal.productContract.acceptance.length === 0) {
+        blockers.push("product contract has no stable acceptance items");
+    }
+    if (proposal.productContract.invariants.length === 0) {
+        blockers.push("product contract has no stable behavioral invariants");
+    }
+    for (const outcome of proposal.productContract.outcomes) {
+        for (const acceptanceRef of outcome.acceptanceIds ?? []) {
+            if (!acceptanceIds.has(acceptanceRef)) {
+                blockers.push(`outcome acceptance reference is unresolved: ${outcome.id}/${acceptanceRef}`);
+            }
+        }
+    }
+    for (const duplicate of duplicates([
+        ...proposal.productContract.outcomes.map((item) => item.id),
+        ...proposal.productContract.acceptance.map((item) => item.id),
+        ...proposal.productContract.invariants.map((item) => item.id),
+        ...proposal.productContract.decisions.map((item) => item.id),
+        ...proposal.scenarioSet.scenarios.map((item) => item.id),
+    ])) {
+        blockers.push(`stable ID is reused: ${duplicate}`);
+    }
+    for (const duplicate of duplicates(proposal.productContract.invariants.map((item) => normalizedStatement(item.statement)))) {
+        blockers.push(`invariant semantics are duplicated: ${duplicate}`);
+    }
+    const referencedSources = [
+        ...proposal.productContract.sourceRefs,
+        ...proposal.productContract.acceptance.flatMap((item) => item.sourceRefs),
+        ...proposal.productContract.invariants.flatMap((item) => item.sourceRefs),
+        ...proposal.productContract.decisions.flatMap((item) => item.sourceRefs),
+        ...proposal.assumptions.flatMap((item) => item.sourceRefs),
+        ...proposal.contradictions.flatMap((item) => item.sourceRefs),
+    ];
+    for (const sourceRef of new Set(referencedSources)) {
+        if (!sourceIds.has(sourceRef)) {
+            blockers.push(`source reference is unresolved: ${sourceRef}`);
+        }
+    }
+    for (const decision of proposal.productContract.decisions) {
+        if (decision.status !== "approved") {
+            blockers.push(`decision is not approved: ${decision.id}`);
+        }
+    }
+    for (const contradiction of proposal.contradictions) {
+        if (contradiction.blocking) {
+            blockers.push(`blocking contradiction remains: ${contradiction.id}`);
+        }
+    }
+    for (const question of proposal.questions) {
+        if (question.blocking)
+            blockers.push(`blocking question remains: ${question.id}`);
+    }
+    const productDigest = canonicalDigest(proposal.productContract);
+    for (const blueprint of proposal.blueprints) {
+        if (blueprint.productContractDigest !== productDigest) {
+            blockers.push(`blueprint is bound to another product contract: ${blueprint.id}`);
+        }
+    }
+    if (proposal.scenarioSet.productContractDigest !== productDigest) {
+        blockers.push("scenario set is bound to another product contract");
+    }
+    for (const scenario of proposal.scenarioSet.scenarios) {
+        for (const acceptanceRef of scenario.acceptanceRefs) {
+            if (!acceptanceIds.has(acceptanceRef)) {
+                blockers.push(`scenario ${scenario.id} has unresolved acceptance ${acceptanceRef}`);
+            }
+        }
+        for (const invariantRef of scenario.invariantRefs) {
+            if (!invariantIds.has(invariantRef)) {
+                blockers.push(`scenario ${scenario.id} has unresolved invariant ${invariantRef}`);
+            }
+        }
+        if (scenario.acceptanceRefs.length === 0) {
+            blockers.push(`scenario has no acceptance reference: ${scenario.id}`);
+        }
+        if (scenario.invariantRefs.length === 0) {
+            blockers.push(`scenario has no invariant reference: ${scenario.id}`);
+        }
+    }
+    for (const source of sourceManifest.sources) {
+        if (source.freshness !== "current") {
+            warnings.push(`source ${source.id} freshness is ${source.freshness}`);
+        }
+    }
+    return {
+        proposalDigest: canonicalDigest(proposal),
+        promotable: blockers.length === 0,
+        blockers: [...new Set(blockers)].sort(),
+        warnings: [...new Set(warnings)].sort(),
+    };
+}
+export function promoteSpecificationProposal(input) {
+    const proposalDigest = canonicalDigest(input.proposal);
+    if (input.approvalDigest !== proposalDigest ||
+        input.assessment.proposalDigest !== proposalDigest) {
+        throw new MillError("PLANNING_APPROVAL_MISMATCH", "Planning approval does not match the exact canonical proposal.", ExitCode.configuration);
+    }
+    if (!input.assessment.promotable) {
+        throw new MillError("PLANNING_PROMOTION_BLOCKED", "The proposal has unresolved promotion blockers.", ExitCode.configuration, { blockers: input.assessment.blockers });
+    }
+    return {
+        proposalDigest,
+        canonicalProposal: canonicalJson(input.proposal),
+        productContract: input.proposal.productContract,
+        blueprints: input.proposal.blueprints,
+        scenarioSet: input.proposal.scenarioSet,
+    };
+}
+export function semanticProposalDiff(approved, regenerated) {
+    const changed = new Set();
+    const walk = (left, right, pointer) => {
+        if (Object.is(left, right))
+            return;
+        if (typeof left !== "object" ||
+            left === null ||
+            typeof right !== "object" ||
+            right === null ||
+            Array.isArray(left) !== Array.isArray(right)) {
+            changed.add(pointer || "/");
+            return;
+        }
+        if (Array.isArray(left) && Array.isArray(right)) {
+            const length = Math.max(left.length, right.length);
+            for (let index = 0; index < length; index += 1) {
+                walk(left[index], right[index], `${pointer}/${index}`);
+            }
+            return;
+        }
+        const leftRecord = left;
+        const rightRecord = right;
+        for (const key of new Set([
+            ...Object.keys(leftRecord),
+            ...Object.keys(rightRecord),
+        ])) {
+            walk(leftRecord[key], rightRecord[key], `${pointer}/${key}`);
+        }
+    };
+    walk(approved, regenerated, "");
+    return [...changed].sort();
+}
+//# sourceMappingURL=specification.js.map

package/dist/planning/specification.js.map

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

package/dist/qualification/public-alpha.d.ts

@@ -0,0 +1,16 @@
+import type { z } from "zod";
+import { publicAlphaQualificationSchema } from "../contracts/schemas.js";
+export type PublicAlphaQualification = z.infer<typeof publicAlphaQualificationSchema>;
+export interface PublicAlphaQualificationAssessment {
+    report: PublicAlphaQualification;
+    reportDigest: string;
+    passed: boolean;
+    blockers: string[];
+}
+export declare function assessPublicAlphaQualification(report: PublicAlphaQualification, now?: Date): PublicAlphaQualificationAssessment;
+export declare function loadPublicAlphaQualification(input: {
+    root: string;
+    file: string;
+    now?: Date;
+}): Promise<PublicAlphaQualificationAssessment>;
+//# sourceMappingURL=public-alpha.d.ts.map

package/dist/qualification/public-alpha.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-alpha.d.ts","sourceRoot":"","sources":["../../src/qualification/public-alpha.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAEL,8BAA8B,EAC/B,MAAM,yBAAyB,CAAC;AAKjC,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC;AAEF,MAAM,WAAW,kCAAkC;IACjD,MAAM,EAAE,wBAAwB,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAoCD,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,wBAAwB,EAChC,GAAG,OAAa,GACf,kCAAkC,CAuHpC;AAED,wBAAsB,4BAA4B,CAAC,KAAK,EAAE;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,OAAO,CAAC,kCAAkC,CAAC,CAM9C"}

package/dist/qualification/public-alpha.js

@@ -0,0 +1,128 @@
+import { parse as parseYaml } from "yaml";
+import { auditCategorySchema, publicAlphaQualificationSchema, } from "../contracts/schemas.js";
+import { canonicalDigest } from "../contracts/canonical.js";
+import { ExitCode, MillError } from "../errors.js";
+import { safeReadText } from "../security/safe-path.js";
+const requiredAuditCategories = auditCategorySchema.options;
+function sameMembers(actual, expected) {
+    return (actual.length === expected.length &&
+        new Set(actual).size === actual.length &&
+        actual.every((item) => expected.includes(item)));
+}
+function parseQualification(source) {
+    let raw;
+    try {
+        raw = parseYaml(source);
+    }
+    catch (error) {
+        throw new MillError("INVALID_PUBLIC_ALPHA_QUALIFICATION", "The public-alpha qualification record is not valid YAML or JSON.", ExitCode.data, { cause: String(error) });
+    }
+    const parsed = publicAlphaQualificationSchema.safeParse(raw);
+    if (!parsed.success) {
+        throw new MillError("INVALID_PUBLIC_ALPHA_QUALIFICATION", "The public-alpha qualification record does not satisfy its schema.", ExitCode.data, { issues: parsed.error.issues });
+    }
+    return parsed.data;
+}
+export function assessPublicAlphaQualification(report, now = new Date()) {
+    const blockers = [];
+    const nowTime = now.getTime();
+    const testedAt = Date.parse(report.supportTuple.testedAt);
+    const expiresAt = Date.parse(report.supportTuple.expiresAt);
+    const generatedAt = Date.parse(report.generatedAt);
+    if (report.supportTuple.status !== "qualified") {
+        blockers.push("support tuple is not qualified");
+    }
+    if (testedAt > nowTime || generatedAt > nowTime) {
+        blockers.push("qualification evidence is future-dated");
+    }
+    if (expiresAt <= testedAt || expiresAt <= nowTime) {
+        blockers.push("support tuple qualification is expired or has no valid window");
+    }
+    const steps = report.sequence.steps;
+    const stepIds = steps.map((step) => step.id);
+    if (new Set(stepIds).size !== stepIds.length) {
+        blockers.push("longitudinal step IDs are duplicated");
+    }
+    const candidateCommits = steps.map((step) => step.candidateCommit);
+    if (new Set(candidateCommits).size !== candidateCommits.length) {
+        blockers.push("accepted sequence reuses a candidate commit");
+    }
+    for (const [index, step] of steps.entries()) {
+        const previous = steps[index - 1];
+        if (index === 0) {
+            if (step.dependsOn.length !== 0) {
+                blockers.push(`${step.id} must be the dependency-free sequence root`);
+            }
+        }
+        else if (previous === undefined ||
+            step.dependsOn.length !== 1 ||
+            step.dependsOn[0] !== previous.id ||
+            step.baseCommit !== previous.candidateCommit) {
+            blockers.push(`${step.id} does not start from the prior accepted output`);
+        }
+        if (step.baseCommit === step.candidateCommit) {
+            blockers.push(`${step.id} did not produce a new candidate identity`);
+        }
+        if (step.status !== "accepted") {
+            blockers.push(`${step.id} is not accepted`);
+        }
+        if (!sameMembers(step.newBehavior.passedIds, step.newBehavior.requiredIds)) {
+            blockers.push(`${step.id} does not close every new-behavior item`);
+        }
+        if (!sameMembers(step.preservation.passedIds, step.preservation.requiredIds)) {
+            blockers.push(`${step.id} does not preserve every required prior item`);
+        }
+        if (step.usage.source === "unavailable" &&
+            (step.usage.inputTokens !== null ||
+                step.usage.outputTokens !== null ||
+                step.usage.currencyCost !== null)) {
+            blockers.push(`${step.id} reports usage while declaring it unavailable`);
+        }
+        if (step.usage.source === "operator-declared" &&
+            step.usage.inputTokens === null &&
+            step.usage.outputTokens === null &&
+            step.usage.currencyCost === null) {
+            blockers.push(`${step.id} has no operator-declared usage value`);
+        }
+    }
+    const acceptedIdentities = new Set([
+        steps[0]?.baseCommit,
+        ...candidateCommits,
+    ]);
+    const fault = report.sequence.seededFault;
+    if (!acceptedIdentities.has(fault.baseCommit)) {
+        blockers.push("seeded fault does not branch from an accepted identity");
+    }
+    if (fault.baseCommit === fault.candidateCommit ||
+        fault.status === "passed" ||
+        !fault.rejected ||
+        !fault.recovered ||
+        fault.enteredAcceptedSequence ||
+        candidateCommits.includes(fault.candidateCommit)) {
+        blockers.push("seeded fault was not rejected and recovered outside the accepted sequence");
+    }
+    for (const [name, status] of Object.entries(report.canaries)) {
+        if (status !== "passed")
+            blockers.push(`required canary did not pass: ${name}`);
+    }
+    const auditCategories = report.audits.map((audit) => audit.category);
+    if (!sameMembers(auditCategories, requiredAuditCategories)) {
+        blockers.push("qualification does not contain exactly one result for every audit category");
+    }
+    for (const audit of report.audits) {
+        if (audit.status !== "passed") {
+            blockers.push(`required audit did not pass: ${audit.category}`);
+        }
+    }
+    return {
+        report,
+        reportDigest: canonicalDigest(report),
+        passed: blockers.length === 0,
+        blockers: [...new Set(blockers)].sort(),
+    };
+}
+export async function loadPublicAlphaQualification(input) {
+    const source = await safeReadText(input.root, input.file, 2 * 1024 * 1024);
+    return assessPublicAlphaQualification(parseQualification(source), input.now ?? new Date());
+}
+//# sourceMappingURL=public-alpha.js.map

package/dist/qualification/public-alpha.js.map

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

package/dist/recipes/node-typescript-next-web.d.ts

@@ -0,0 +1,19 @@
+import type { z } from "zod";
+import { recipeManifestSchema } from "../contracts/schemas.js";
+export type RecipeManifest = z.infer<typeof recipeManifestSchema>;
+export type FileOwnership = "mill_only" | "generated_once" | "managed";
+export interface RecipeFile {
+    path: string;
+    content: string;
+    contentDigest: string;
+    ownership: FileOwnership;
+}
+export declare function loadNodeWebRecipe(): Promise<{
+    manifest: RecipeManifest;
+    digest: string;
+}>;
+export declare function renderNodeWebRecipe(input: {
+    projectName: string;
+    productTitle: string;
+}): Promise<RecipeFile[]>;
+//# sourceMappingURL=node-typescript-next-web.d.ts.map

package/dist/recipes/node-typescript-next-web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-typescript-next-web.d.ts","sourceRoot":"","sources":["../../src/recipes/node-typescript-next-web.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG/D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,aAAa,CAAC;CAC1B;AAoGD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC;IACjD,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAmCD;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAqCxB"}

package/dist/recipes/node-typescript-next-web.js

@@ -0,0 +1,136 @@
+import { createHash } from "node:crypto";
+import { lstat, opendir, readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { canonicalDigest } from "../contracts/canonical.js";
+import { recipeManifestSchema } from "../contracts/schemas.js";
+import { ExitCode, MillError } from "../errors.js";
+const recipeRoot = fileURLToPath(new URL("../../recipes/node-typescript-next-web/", import.meta.url));
+const ignoredDirectories = new Set([
+    ".next",
+    "coverage",
+    "node_modules",
+    "playwright-report",
+    "test-results",
+]);
+const ignoredFiles = new Set([".DS_Store"]);
+function digest(content) {
+    return `sha256:${createHash("sha256").update(content, "utf8").digest("hex")}`;
+}
+function ownership(relativePath) {
+    if (["mill.yaml", "mill.lock"].includes(relativePath))
+        return "mill_only";
+    if (relativePath === ".github/workflows/ci.yml")
+        return "managed";
+    return "generated_once";
+}
+function packageName(value) {
+    const normalized = value
+        .toLowerCase()
+        .normalize("NFKD")
+        .replaceAll(/[^a-z0-9._-]+/gu, "-")
+        .replaceAll(/^-+|-+$/gu, "")
+        .slice(0, 214);
+    return normalized.length === 0 ? "mill-web-product" : normalized;
+}
+function markdownTitle(value) {
+    return value
+        .replaceAll(/[\r\n\t]+/gu, " ")
+        .replaceAll(/\s+/gu, " ")
+        .trim()
+        .replaceAll(/[\u0021-\u002F\u003A-\u0040\u005B-\u0060\u007B-\u007E]/gu, "\\$&");
+}
+async function walk(directory, relative = ".") {
+    const handle = await opendir(path.join(directory, relative));
+    const entries = [];
+    for await (const entry of handle)
+        entries.push(entry);
+    const files = [];
+    for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+        if (ignoredFiles.has(entry.name) ||
+            (entry.isDirectory() && ignoredDirectories.has(entry.name))) {
+            continue;
+        }
+        const child = path.join(relative, entry.name);
+        const information = await lstat(path.join(directory, child));
+        if (information.isSymbolicLink()) {
+            throw new MillError("RECIPE_SYMLINK_FORBIDDEN", "Recipe assets cannot contain symbolic links.", ExitCode.data, { path: child });
+        }
+        if (information.isDirectory())
+            files.push(...(await walk(directory, child)));
+        else if (information.isFile()) {
+            if (information.size > 8 * 1024 * 1024) {
+                throw new MillError("RECIPE_ASSET_TOO_LARGE", "A bundled recipe asset exceeds the per-file size limit.", ExitCode.data, { path: child });
+            }
+            files.push(child);
+        }
+        else {
+            throw new MillError("RECIPE_ASSET_UNSUPPORTED", "A bundled recipe asset has an unsupported filesystem type.", ExitCode.data, { path: child });
+        }
+    }
+    if (files.length > 128) {
+        throw new MillError("RECIPE_ASSET_LIMIT_EXCEEDED", "The bundled recipe exceeds its file-count limit.", ExitCode.data);
+    }
+    return files;
+}
+export async function loadNodeWebRecipe() {
+    const source = await readFile(path.join(recipeRoot, "recipe.yaml"), "utf8");
+    let raw;
+    try {
+        raw = parseYaml(source);
+    }
+    catch (error) {
+        throw new MillError("RECIPE_MANIFEST_INVALID", "The bundled recipe manifest is invalid YAML.", ExitCode.data, { cause: String(error) });
+    }
+    const manifest = recipeManifestSchema.parse(raw);
+    if (manifest.status !== "supported") {
+        throw new MillError("RECIPE_NOT_SUPPORTED", "The selected recipe is not qualified for apply.", ExitCode.configuration, { status: manifest.status });
+    }
+    const assets = await walk(recipeRoot);
+    const assetDigests = await Promise.all(assets
+        .filter((asset) => asset.split(path.sep).join("/") !== "recipe.yaml")
+        .map(async (asset) => ({
+        path: asset.split(path.sep).join("/").replace(/^\.\//u, ""),
+        digest: digest(await readFile(path.join(recipeRoot, asset), "utf8")),
+    })));
+    return {
+        manifest,
+        digest: canonicalDigest({ manifest, assets: assetDigests }),
+    };
+}
+export async function renderNodeWebRecipe(input) {
+    const files = await walk(recipeRoot);
+    const rendered = [];
+    for (const file of files) {
+        const assetPath = file.split(path.sep).join("/").replace(/^\.\//u, "");
+        if (assetPath === "recipe.yaml")
+            continue;
+        const normalized = assetPath === "gitignore.template" ? ".gitignore" : assetPath;
+        let content = await readFile(path.join(recipeRoot, file), "utf8");
+        if (normalized === "package.json" || normalized === "package-lock.json") {
+            const parsed = JSON.parse(content);
+            parsed.name = packageName(input.projectName);
+            if (normalized === "package-lock.json") {
+                const packages = parsed.packages;
+                if (packages?.[""] !== undefined) {
+                    packages[""].name = packageName(input.projectName);
+                }
+            }
+            content = `${JSON.stringify(parsed, undefined, 2)}\n`;
+        }
+        else {
+            content = content.replace(/__MILL_PRODUCT_TITLE_LITERAL__|MILL_PRODUCT_TITLE_MARKDOWN_TOKEN/gu, (token) => token === "__MILL_PRODUCT_TITLE_LITERAL__"
+                ? JSON.stringify(input.productTitle)
+                : markdownTitle(input.productTitle));
+        }
+        rendered.push({
+            path: normalized,
+            content,
+            contentDigest: digest(content),
+            ownership: ownership(normalized),
+        });
+    }
+    return rendered.sort((left, right) => left.path.localeCompare(right.path));
+}
+//# sourceMappingURL=node-typescript-next-web.js.map

package/dist/recipes/node-typescript-next-web.js.map

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

package/dist/repository/integration.d.ts

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { repositoryIntegrationPlanSchema } from "../contracts/schemas.js";
+import { type RecipeFile } from "../recipes/node-typescript-next-web.js";
+export type RepositoryIntegrationPlan = z.infer<typeof repositoryIntegrationPlanSchema>;
+interface IntegrationOptions {
+    sourceRoot: string;
+    prdPath: string;
+    sourceManifestPath: string;
+    proposalPath: string;
+    productApprovalDigest: string;
+    repositoryId: string;
+    approvedBy: string;
+    approvedAt: string;
+    authorName: string;
+    authorEmail: string;
+}
+interface PlannedIntegration {
+    plan: RepositoryIntegrationPlan;
+    approvalDigest: string;
+    files: RecipeFile[];
+}
+export declare function planGreenfieldIntegration(input: IntegrationOptions & {
+    targetDirectory: string;
+}): Promise<PlannedIntegration>;
+export declare function planAdoptionIntegration(input: IntegrationOptions & {
+    repositoryRoot: string;
+}): Promise<PlannedIntegration>;
+export declare function applyGreenfieldIntegration(input: IntegrationOptions & {
+    targetDirectory: string;
+    planApprovalDigest: string;
+    attended: boolean;
+    signal?: AbortSignal;
+}): Promise<{
+    repository: string;
+    commit: string;
+    planDigest: string;
+    baseline: "unverified";
+}>;
+export declare function applyAdoptionIntegration(input: IntegrationOptions & {
+    repositoryRoot: string;
+    planApprovalDigest: string;
+    attended: boolean;
+    signal?: AbortSignal;
+}): Promise<{
+    branch: string;
+    commit: string;
+    planDigest: string;
+    baseline: "unverified";
+}>;
+export declare function planDetach(root: string): Promise<{
+    mode: "manual";
+    remove: string[];
+    retain: string[];
+    changed: string[];
+    stateAction: string;
+}>;
+export {};
+//# sourceMappingURL=integration.d.ts.map

package/dist/repository/integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../src/repository/integration.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAGL,+BAA+B,EAGhC,MAAM,yBAAyB,CAAC;AAUjC,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,wCAAwC,CAAC;AAchD,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,+BAA+B,CACvC,CAAC;AAEF,UAAU,kBAAkB;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,kBAAkB;IAC1B,IAAI,EAAE,yBAAyB,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AA0sCD,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,kBAAkB,GAAG;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB,GACA,OAAO,CAAC,kBAAkB,CAAC,CAoE7B;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,kBAAkB,GAAG;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB,GACA,OAAO,CAAC,kBAAkB,CAAC,CAoH7B;AAkaD,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,kBAAkB,GAAG;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GACA,OAAO,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;CACxB,CAAC,CAUD;AAmGD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,kBAAkB,GAAG;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GACA,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;CACxB,CAAC,CAUD;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACtD,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CA0CD"}