knitto 0.0.1

package/dist/src/snapshots/canonical.js

@@ -0,0 +1,150 @@
+import { createHash } from "node:crypto";
+import path from "node:path";
+import { chmod, cp, lstat, mkdir, readdir, readFile, rename, rm, stat, } from "node:fs/promises";
+import { KnittoError } from "../errors.js";
+import { loadTemplateManifest } from "../template/manifest.js";
+async function collectEntries(root, directory = root) {
+    const entries = [];
+    const children = await readdir(directory, { withFileTypes: true });
+    for (const child of children) {
+        if (child.name === ".git")
+            continue;
+        const absolute = path.join(directory, child.name);
+        const relative = path.relative(root, absolute).split(path.sep).join("/");
+        const metadata = await lstat(absolute);
+        if (metadata.isSymbolicLink()) {
+            throw new KnittoError(`Template snapshots cannot contain symlinks: ${relative}`, "TEMPLATE");
+        }
+        if (metadata.isDirectory()) {
+            entries.push(...(await collectEntries(root, absolute)));
+            continue;
+        }
+        if (!metadata.isFile()) {
+            throw new KnittoError(`Unsupported template entry: ${relative}`, "TEMPLATE");
+        }
+        entries.push({
+            path: relative,
+            mode: metadata.mode & 0o111 ? 0o755 : 0o644,
+            contents: await readFile(absolute),
+        });
+    }
+    return entries;
+}
+function frame(value) {
+    const buffer = typeof value === "string" ? Buffer.from(value) : value;
+    return Buffer.concat([Buffer.from(`${buffer.length}:`), buffer]);
+}
+export async function digestDirectory(root) {
+    let metadata;
+    try {
+        metadata = await stat(root);
+    }
+    catch (error) {
+        throw new KnittoError(`Template directory does not exist: ${root}`, "SOURCE", { cause: error });
+    }
+    if (!metadata.isDirectory()) {
+        throw new KnittoError(`Template source is not a directory: ${root}`, "SOURCE");
+    }
+    const entries = await collectEntries(root);
+    entries.sort((left, right) => left.path.localeCompare(right.path));
+    const hash = createHash("sha256");
+    for (const entry of entries) {
+        hash.update(frame(entry.path));
+        hash.update(frame(entry.mode.toString(8)));
+        hash.update(frame(entry.contents));
+    }
+    return `sha256:${hash.digest("hex")}`;
+}
+export function cacheRoot() {
+    const configured = process.env.XDG_CACHE_HOME;
+    const base = configured
+        ? path.resolve(configured)
+        : path.join(process.env.HOME ?? process.cwd(), ".cache");
+    return path.join(base, "knitto", "snapshots");
+}
+export function cachePath(digest) {
+    const value = digest.replace(/^sha256:/, "");
+    if (!/^[a-f0-9]{64}$/.test(value)) {
+        throw new KnittoError(`Invalid snapshot digest: ${digest}`, "CONFIG");
+    }
+    return path.join(cacheRoot(), value);
+}
+export async function cacheSnapshot(sourceDirectory, digest) {
+    const destination = cachePath(digest);
+    try {
+        const metadata = await stat(destination);
+        if (metadata.isDirectory()) {
+            const actualDigest = await digestDirectory(destination);
+            if (actualDigest !== digest) {
+                throw new KnittoError(`Cached snapshot is corrupt: expected ${digest}, found ${actualDigest}`, "SOURCE");
+            }
+            return destination;
+        }
+    }
+    catch (error) {
+        if (typeof error !== "object" ||
+            error === null ||
+            !("code" in error) ||
+            error.code !== "ENOENT") {
+            throw error;
+        }
+    }
+    await mkdir(path.dirname(destination), { recursive: true });
+    const temporary = `${destination}.tmp-${process.pid}-${Date.now()}`;
+    try {
+        await cp(sourceDirectory, temporary, {
+            recursive: true,
+            errorOnExist: true,
+            force: false,
+        });
+        await chmod(temporary, 0o755);
+        await rename(temporary, destination);
+    }
+    catch (error) {
+        try {
+            const metadata = await stat(destination);
+            if (!metadata.isDirectory())
+                throw error;
+        }
+        catch {
+            throw error;
+        }
+    }
+    finally {
+        await rm(temporary, { recursive: true, force: true });
+    }
+    return destination;
+}
+export async function loadCachedSnapshot(digest, provenance) {
+    const directory = cachePath(digest);
+    try {
+        await stat(directory);
+    }
+    catch (error) {
+        if (typeof error === "object" &&
+            error !== null &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+    try {
+        const actualDigest = await digestDirectory(directory);
+        if (actualDigest !== digest) {
+            throw new KnittoError(`Cached snapshot is corrupt: expected ${digest}, found ${actualDigest}`, "SOURCE");
+        }
+        return {
+            digest,
+            directory,
+            manifest: await loadTemplateManifest(directory),
+            provenance,
+        };
+    }
+    catch (error) {
+        throw new KnittoError(`Unable to load cached snapshot: ${digest}`, "SOURCE", {
+            cause: error,
+        });
+    }
+}
+//# sourceMappingURL=canonical.js.map

package/dist/src/snapshots/canonical.js.map

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

package/dist/src/sources/process.d.ts

@@ -0,0 +1,3 @@
+export declare function run(command: string, args: string[], options?: {
+    cwd?: string;
+}): Promise<string>;

package/dist/src/sources/process.js

@@ -0,0 +1,28 @@
+import { spawn } from "node:child_process";
+import { KnittoError } from "../errors.js";
+export async function run(command, args, options = {}) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            env: process.env,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const stdout = [];
+        const stderr = [];
+        child.stdout.on("data", (chunk) => stdout.push(chunk));
+        child.stderr.on("data", (chunk) => stderr.push(chunk));
+        child.on("error", (error) => {
+            reject(new KnittoError(`Unable to run ${command}`, "SOURCE", {
+                cause: error,
+            }));
+        });
+        child.on("close", (code) => {
+            if (code === 0) {
+                resolve(Buffer.concat(stdout).toString("utf8").trim());
+                return;
+            }
+            reject(new KnittoError(`${command} failed with exit code ${code}: ${Buffer.concat(stderr).toString("utf8").trim()}`, "SOURCE"));
+        });
+    });
+}
+//# sourceMappingURL=process.js.map

package/dist/src/sources/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../../src/sources/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,OAAe,EACf,IAAc,EACd,UAA4B,EAAE;IAE9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,MAAM,CACJ,IAAI,WAAW,CAAC,iBAAiB,OAAO,EAAE,EAAE,QAAQ,EAAE;gBACpD,KAAK,EAAE,KAAK;aACb,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACvD,OAAO;YACT,CAAC;YACD,MAAM,CACJ,IAAI,WAAW,CACb,GAAG,OAAO,0BAA0B,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,EAC5F,QAAQ,CACT,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/sources/resolve.d.ts

@@ -0,0 +1,3 @@
+import { type ProjectLock, type Snapshot, type SourceConfig } from "../types.js";
+export declare function resolveCurrentSnapshot(source: SourceConfig, projectRoot: string): Promise<Snapshot>;
+export declare function resolveLockedSnapshot(lock: ProjectLock, projectRoot: string): Promise<Snapshot>;

package/dist/src/sources/resolve.js

@@ -0,0 +1,144 @@
+import path from "node:path";
+import os from "node:os";
+import { mkdir, mkdtemp, rm, writeFile, } from "node:fs/promises";
+import * as tar from "tar";
+import { KnittoError } from "../errors.js";
+import { resolveInside } from "../filesystem/paths.js";
+import { loadTemplateManifest } from "../template/manifest.js";
+import { cacheSnapshot, digestDirectory, loadCachedSnapshot, } from "../snapshots/canonical.js";
+import { run } from "./process.js";
+async function materializeLocal(source, projectRoot) {
+    return {
+        root: path.resolve(projectRoot, source.path),
+        provenance: {
+            sourceType: "local",
+            locator: source.path,
+        },
+    };
+}
+async function materializeHttp(source) {
+    const temporary = await mkdtemp(path.join(os.tmpdir(), "knitto-http-"));
+    const archive = path.join(temporary, "template.tar");
+    const extracted = path.join(temporary, "extracted");
+    try {
+        const response = await fetch(source.url, {
+            headers: { accept: "application/gzip, application/x-tar, application/octet-stream" },
+            redirect: "follow",
+        });
+        if (!response.ok) {
+            throw new KnittoError(`Template request failed with HTTP ${response.status}: ${source.url}`, "SOURCE");
+        }
+        await mkdir(extracted);
+        await writeFile(archive, Buffer.from(await response.arrayBuffer()));
+        await tar.x({
+            file: archive,
+            cwd: extracted,
+            strict: true,
+            preservePaths: false,
+        });
+        const etag = response.headers.get("etag");
+        const lastModified = response.headers.get("last-modified");
+        return {
+            root: source.path ? resolveInside(extracted, source.path) : extracted,
+            provenance: {
+                sourceType: "http",
+                locator: source.url,
+                ...(source.path ? { templatePath: source.path } : {}),
+                ...(etag ? { etag } : {}),
+                ...(lastModified ? { lastModified } : {}),
+            },
+            cleanup: () => rm(temporary, { recursive: true, force: true }),
+        };
+    }
+    catch (error) {
+        await rm(temporary, { recursive: true, force: true });
+        if (error instanceof KnittoError)
+            throw error;
+        throw new KnittoError(`Unable to resolve HTTP source: ${source.url}`, "SOURCE", {
+            cause: error,
+        });
+    }
+}
+async function materializeGit(source, lockedRevision) {
+    const temporary = await mkdtemp(path.join(os.tmpdir(), "knitto-git-"));
+    const checkout = path.join(temporary, "checkout");
+    const requestedRef = lockedRevision ?? source.ref ?? "HEAD";
+    try {
+        await mkdir(checkout);
+        await run("git", ["init", "--quiet"], { cwd: checkout });
+        await run("git", ["remote", "add", "origin", source.url], { cwd: checkout });
+        await run("git", ["fetch", "--quiet", "--depth=1", "origin", requestedRef], {
+            cwd: checkout,
+        });
+        await run("git", ["checkout", "--quiet", "--detach", "FETCH_HEAD"], {
+            cwd: checkout,
+        });
+        const revision = await run("git", ["rev-parse", "HEAD"], { cwd: checkout });
+        return {
+            root: source.path ? resolveInside(checkout, source.path) : checkout,
+            provenance: {
+                sourceType: "git",
+                locator: source.url,
+                ...(source.path ? { templatePath: source.path } : {}),
+                revision,
+            },
+            cleanup: () => rm(temporary, { recursive: true, force: true }),
+        };
+    }
+    catch (error) {
+        await rm(temporary, { recursive: true, force: true });
+        if (error instanceof KnittoError)
+            throw error;
+        throw new KnittoError(`Unable to resolve Git source: ${source.url}`, "SOURCE", {
+            cause: error,
+        });
+    }
+}
+async function materialize(source, projectRoot, lockedRevision) {
+    switch (source.type) {
+        case "local":
+            return materializeLocal(source, projectRoot);
+        case "http":
+            return materializeHttp(source);
+        case "git":
+            return materializeGit(source, lockedRevision);
+    }
+}
+async function snapshotMaterialized(materialized) {
+    try {
+        const manifest = await loadTemplateManifest(materialized.root);
+        const digest = await digestDirectory(materialized.root);
+        const directory = await cacheSnapshot(materialized.root, digest);
+        return {
+            digest,
+            directory,
+            manifest,
+            provenance: materialized.provenance,
+        };
+    }
+    catch (error) {
+        if (error instanceof KnittoError)
+            throw error;
+        throw new KnittoError("Unable to create template snapshot", "TEMPLATE", {
+            cause: error,
+        });
+    }
+    finally {
+        await materialized.cleanup?.();
+    }
+}
+export async function resolveCurrentSnapshot(source, projectRoot) {
+    return snapshotMaterialized(await materialize(source, projectRoot));
+}
+export async function resolveLockedSnapshot(lock, projectRoot) {
+    const cached = await loadCachedSnapshot(lock.digest, lock.provenance);
+    if (cached)
+        return cached;
+    const materialized = await materialize(lock.source, projectRoot, lock.provenance.revision);
+    const snapshot = await snapshotMaterialized(materialized);
+    if (snapshot.digest !== lock.digest) {
+        throw new KnittoError(`Locked snapshot ${lock.digest} is unavailable; source resolved to ${snapshot.digest}`, "SOURCE");
+    }
+    return snapshot;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/src/sources/resolve.js.map

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

package/dist/src/template/init.d.ts

@@ -0,0 +1 @@
+export declare function initializeTemplate(root: string, name?: string): Promise<void>;

package/dist/src/template/init.js

@@ -0,0 +1,62 @@
+import path from "node:path";
+import { access, mkdir, rm, writeFile } from "node:fs/promises";
+import { KnittoError } from "../errors.js";
+import { CONFIG_FILE, TEMPLATE_MANIFEST } from "../types.js";
+import { KNITTO_PACKAGE, KNITTO_VERSION } from "../version.js";
+async function exists(file) {
+    return access(file)
+        .then(() => true)
+        .catch(() => false);
+}
+export async function initializeTemplate(root, name = path.basename(root)) {
+    const templateRoot = path.join(root, ".knitto");
+    const configFile = path.join(root, CONFIG_FILE);
+    const existing = (await Promise.all([
+        [templateRoot, await exists(templateRoot)],
+        [configFile, await exists(configFile)],
+    ]))
+        .filter(([, present]) => present)
+        .map(([file]) => file);
+    if (existing.length > 0) {
+        throw new KnittoError(`Refusing to initialize a template because ${existing.join(", ")} already exists`, "CONFIG");
+    }
+    await mkdir(root, { recursive: true });
+    let templateCreated = false;
+    let configCreated = false;
+    try {
+        await mkdir(templateRoot);
+        templateCreated = true;
+        await mkdir(path.join(templateRoot, "files"));
+        await writeFile(path.join(templateRoot, TEMPLATE_MANIFEST), `${JSON.stringify({
+            schemaVersion: 1,
+            name,
+            engine: {
+                package: KNITTO_PACKAGE,
+                version: KNITTO_VERSION,
+            },
+            rules: [],
+        }, null, 2)}\n`, { flag: "wx" });
+        await writeFile(configFile, `${JSON.stringify({
+            source: {
+                type: "local",
+                path: ".knitto",
+            },
+            engine: {
+                package: KNITTO_PACKAGE,
+                version: KNITTO_VERSION,
+            },
+        }, null, 2)}\n`, { flag: "wx" });
+        configCreated = true;
+    }
+    catch (error) {
+        if (templateCreated) {
+            await rm(templateRoot, { recursive: true, force: true });
+        }
+        if (configCreated)
+            await rm(configFile, { force: true });
+        throw new KnittoError(`Unable to initialize template: ${root}`, "CONFIG", {
+            cause: error,
+        });
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/src/template/init.js.map

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

package/dist/src/template/manifest.d.ts

@@ -0,0 +1,2 @@
+import { type TemplateManifest } from "../types.js";
+export declare function loadTemplateManifest(root: string, manifestPath?: string, loading?: Set<string>): Promise<TemplateManifest>;

package/dist/src/template/manifest.js

@@ -0,0 +1,80 @@
+import path from "node:path";
+import { readFile } from "node:fs/promises";
+import { validateTemplateManifest } from "../config.js";
+import { KnittoError } from "../errors.js";
+import { resolveInside } from "../filesystem/paths.js";
+import { TEMPLATE_MANIFEST } from "../types.js";
+function mergeManifests(base, overlay) {
+    const rules = [...base.rules];
+    for (const rule of overlay.rules) {
+        const existing = rules.findIndex((candidate) => candidate.id === rule.id);
+        if (existing === -1)
+            rules.push(rule);
+        else
+            rules[existing] = rule;
+    }
+    return {
+        schemaVersion: 1,
+        name: overlay.name,
+        ...(overlay.engine
+            ? { engine: overlay.engine }
+            : base.engine
+                ? { engine: base.engine }
+                : {}),
+        ...(overlay.release
+            ? { release: overlay.release }
+            : base.release
+                ? { release: base.release }
+                : {}),
+        rules,
+        checks: [
+            ...(base.checks ?? []).filter((check) => !(overlay.checks ?? []).some((entry) => entry.id === check.id)),
+            ...(overlay.checks ?? []),
+        ],
+        hooks: [
+            ...(base.hooks ?? []).filter((hook) => !(overlay.hooks ?? []).some((entry) => entry.id === hook.id)),
+            ...(overlay.hooks ?? []),
+        ],
+        variables: {
+            ...(base.variables ?? {}),
+            ...(overlay.variables ?? {}),
+        },
+        inputs: [...new Set([...(base.inputs ?? []), ...(overlay.inputs ?? [])])],
+        partials: {
+            ...(base.partials ?? {}),
+            ...(overlay.partials ?? {}),
+        },
+        prompts: [
+            ...(base.prompts ?? []).filter((prompt) => !(overlay.prompts ?? []).some((entry) => entry.path === prompt.path)),
+            ...(overlay.prompts ?? []),
+        ],
+    };
+}
+export async function loadTemplateManifest(root, manifestPath = TEMPLATE_MANIFEST, loading = new Set()) {
+    const normalized = manifestPath.split(path.sep).join("/");
+    if (loading.has(normalized)) {
+        throw new KnittoError(`Template manifest inheritance cycle: ${[...loading, normalized].join(" -> ")}`, "TEMPLATE");
+    }
+    loading.add(normalized);
+    let manifest;
+    try {
+        const value = JSON.parse(await readFile(resolveInside(root, normalized), "utf8"));
+        manifest = validateTemplateManifest(value);
+    }
+    catch (error) {
+        if (error instanceof KnittoError)
+            throw error;
+        throw new KnittoError(`Unable to load template manifest: ${normalized}`, "TEMPLATE", { cause: error });
+    }
+    let resolved = {
+        schemaVersion: 1,
+        name: manifest.name,
+        rules: [],
+    };
+    for (const parent of manifest.extends ?? []) {
+        resolved = mergeManifests(resolved, await loadTemplateManifest(root, parent, new Set(loading)));
+    }
+    loading.delete(normalized);
+    return mergeManifests(resolved, manifest);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/src/template/manifest.js.map

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

package/dist/src/template/release.d.ts

@@ -0,0 +1,3 @@
+import type { TemplateManifest } from "../types.js";
+export declare const UNRELEASED_TEMPLATE_VERSION = "0.0.0";
+export declare function templateReleaseTag(release: TemplateManifest["release"]): string | undefined;

package/dist/src/template/release.js

@@ -0,0 +1,8 @@
+export const UNRELEASED_TEMPLATE_VERSION = "0.0.0";
+export function templateReleaseTag(release) {
+    if (!release || release.version === UNRELEASED_TEMPLATE_VERSION) {
+        return undefined;
+    }
+    return release.tagFormat.replaceAll("{version}", release.version);
+}
+//# sourceMappingURL=release.js.map

package/dist/src/template/release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.js","sourceRoot":"","sources":["../../../src/template/release.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,2BAA2B,GAAG,OAAO,CAAC;AAEnD,MAAM,UAAU,kBAAkB,CAChC,OAAoC;IAEpC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,2BAA2B,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;AACpE,CAAC"}

package/dist/src/template/validate.d.ts

@@ -0,0 +1,2 @@
+import type { Snapshot } from "../types.js";
+export declare function validateTemplateSnapshot(snapshot: Snapshot): Promise<void>;

package/dist/src/template/validate.js

@@ -0,0 +1,62 @@
+import { readFile, stat } from "node:fs/promises";
+import Handlebars from "handlebars";
+import { KnittoError } from "../errors.js";
+import { assertNoEscapingSymlink, resolveInside, } from "../filesystem/paths.js";
+async function validateAsset(snapshot, asset) {
+    const file = resolveInside(snapshot.directory, asset.path);
+    await assertNoEscapingSymlink(snapshot.directory, file);
+    let fileStat;
+    try {
+        fileStat = await stat(file);
+    }
+    catch (error) {
+        throw new KnittoError(`Template ${asset.kind} for ${asset.owner} does not exist: ${asset.path}`, "TEMPLATE", { cause: error });
+    }
+    if (!fileStat.isFile()) {
+        throw new KnittoError(`Template ${asset.kind} for ${asset.owner} is not a file: ${asset.path}`, "TEMPLATE");
+    }
+    if (asset.kind !== "hook") {
+        try {
+            Handlebars.parse(await readFile(file, "utf8"));
+        }
+        catch (error) {
+            throw new KnittoError(`Template ${asset.kind} for ${asset.owner} contains invalid Handlebars: ${asset.path}`, "TEMPLATE", { cause: error });
+        }
+    }
+    if (asset.kind === "hook" && (fileStat.mode & 0o111) === 0) {
+        throw new KnittoError(`Template hook ${asset.owner} is not executable: ${asset.path}`, "TEMPLATE");
+    }
+}
+export async function validateTemplateSnapshot(snapshot) {
+    const assets = [];
+    for (const [name, partial] of Object.entries(snapshot.manifest.partials ?? {})) {
+        assets.push({ path: partial, kind: "file", owner: `partial ${name}` });
+    }
+    for (const rule of snapshot.manifest.rules) {
+        if (rule.type === "delete")
+            continue;
+        assets.push({
+            path: rule.template,
+            kind: "file",
+            owner: `rule ${rule.id}`,
+        });
+        if ("schema" in rule && rule.schema) {
+            assets.push({
+                path: rule.schema,
+                kind: "schema",
+                owner: `rule ${rule.id}`,
+            });
+        }
+        if (rule.type === "content" && rule.parser === "hook") {
+            const hook = snapshot.manifest.hooks?.find((candidate) => candidate.id === rule.hook && candidate.kind === "parser");
+            if (!hook) {
+                throw new KnittoError(`Parser hook does not exist for rule ${rule.id}: ${rule.hook ?? ""}`, "TEMPLATE");
+            }
+        }
+    }
+    for (const hook of snapshot.manifest.hooks ?? []) {
+        assets.push({ path: hook.command, kind: "hook", owner: hook.id });
+    }
+    await Promise.all(assets.map((asset) => validateAsset(snapshot, asset)));
+}
+//# sourceMappingURL=validate.js.map

package/dist/src/template/validate.js.map

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