forgeprint 0.1.1

package/dist/options.js

@@ -0,0 +1,127 @@
+/**
+ * Resolving `setup.md` option guards.
+ *
+ * A recipe is written with every branch present:
+ *
+ * ```markdown
+ * <!-- if options.database == postgres -->
+ * ...
+ * <!-- endif -->
+ * ```
+ *
+ * A caller who has chosen `database: postgres` should receive the recipe with
+ * that branch inlined and the others gone, because a step list with branches in
+ * it is a document, and the point of `setup.md` is that it is a script.
+ */
+const IF_PATTERN = /^\s*<!--\s*if\s+options\.([a-z0-9-]+)\s*==\s*([a-z0-9-]+)\s*-->\s*$/;
+const ENDIF_PATTERN = /^\s*<!--\s*endif\s*-->\s*$/;
+export class UnknownOptionError extends Error {
+}
+/**
+ * Validate a caller's option selection against what the manifest declares.
+ * Throws rather than guessing: a typo that silently selects the default would
+ * hand somebody a recipe for a database they did not ask for.
+ */
+export function checkOptions(manifest, chosen) {
+    const declared = manifest.options ?? {};
+    for (const [field, value] of Object.entries(chosen)) {
+        const values = declared[field];
+        if (values === undefined) {
+            const known = Object.keys(declared);
+            throw new UnknownOptionError(known.length === 0
+                ? `Blueprint "${manifest.slug}" declares no options, but "${field}" was given`
+                : `"${field}" is not an option of "${manifest.slug}" (${known.join(', ')})`);
+        }
+        if (!values.includes(value)) {
+            throw new UnknownOptionError(`"${value}" is not a value of ${manifest.slug}.options.${field} (${values.join(', ')})`);
+        }
+    }
+}
+/**
+ * Inline the chosen branches and drop the rest.
+ *
+ * A guard on a field the caller did not choose is left exactly as written, and
+ * the field is reported in `unresolved`, so the caller can be asked rather than
+ * handed a recipe with a branch silently removed.
+ */
+export function resolveSetupOptions(markdown, chosen = {}) {
+    const lines = markdown.split(/\r?\n/);
+    const output = [];
+    const unresolved = new Set();
+    let skipping = false;
+    let keepingGuarded = false;
+    let inFence = false;
+    for (const line of lines) {
+        if (/^\s*(?:```|~~~)/.test(line)) {
+            inFence = !inFence;
+            if (!skipping)
+                output.push(line);
+            continue;
+        }
+        if (inFence) {
+            if (!skipping)
+                output.push(line);
+            continue;
+        }
+        const guard = IF_PATTERN.exec(line);
+        if (guard !== null) {
+            const [, field = '', value = ''] = guard;
+            const selection = chosen[field];
+            if (selection === undefined) {
+                // Not chosen: leave the guard intact and say so.
+                unresolved.add(field);
+                output.push(line);
+                keepingGuarded = false;
+                skipping = false;
+            }
+            else if (selection === value) {
+                keepingGuarded = true;
+                skipping = false;
+            }
+            else {
+                skipping = true;
+                keepingGuarded = false;
+            }
+            continue;
+        }
+        if (ENDIF_PATTERN.test(line)) {
+            if (!skipping && !keepingGuarded)
+                output.push(line);
+            skipping = false;
+            keepingGuarded = false;
+            continue;
+        }
+        if (!skipping)
+            output.push(line);
+    }
+    return {
+        markdown: collapseBlankRuns(output).join('\n'),
+        unresolved: [...unresolved].sort(),
+    };
+}
+/** Removing a branch leaves blank lines behind; two in a row is enough. */
+function collapseBlankRuns(lines) {
+    const result = [];
+    let blanks = 0;
+    for (const line of lines) {
+        if (line.trim().length === 0) {
+            blanks += 1;
+            if (blanks > 1)
+                continue;
+        }
+        else {
+            blanks = 0;
+        }
+        result.push(line);
+    }
+    while (result.length > 0 && result[result.length - 1]?.trim().length === 0)
+        result.pop();
+    return result;
+}
+/** Option fields a caller still has to choose, given what they have chosen. */
+export function missingOptions(manifest, chosen = {}) {
+    return Object.entries(manifest.options ?? {})
+        .filter(([field]) => chosen[field] === undefined)
+        .map(([field, values]) => ({ field, values }));
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Walk upwards from `startDir` until a Forgeprint repository root is found, so
+ * that every command works from any subdirectory the way git does.
+ */
+export declare function findRepoRoot(startDir?: string): string;
+export declare const repoPaths: {
+    taxonomy: (root: string) => string;
+    manifestSchema: (root: string) => string;
+    blueprintsDir: (root: string) => string;
+    blueprintDir: (root: string, slug: string) => string;
+    index: (root: string) => string;
+    codeowners: (root: string) => string;
+};
+/** Files every blueprint folder must contain. */
+export declare const REQUIRED_BLUEPRINT_FILES: readonly ["manifest.yaml", "AGENTS.md", "overview.md", "setup.md", "CHANGELOG.md"];
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAYrE;AAED,eAAO,MAAM,SAAS;qBACH,MAAM,KAAG,MAAM;2BACT,MAAM,KAAG,MAAM;0BAChB,MAAM,KAAG,MAAM;yBAChB,MAAM,QAAQ,MAAM,KAAG,MAAM;kBACpC,MAAM,KAAG,MAAM;uBACV,MAAM,KAAG,MAAM;CACnC,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,wBAAwB,oFAM3B,CAAC"}

package/dist/paths.js

@@ -0,0 +1,37 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+/** File that marks the root of a Forgeprint repository. */
+const ROOT_MARKER = join('schema', 'taxonomy.yaml');
+/**
+ * Walk upwards from `startDir` until a Forgeprint repository root is found, so
+ * that every command works from any subdirectory the way git does.
+ */
+export function findRepoRoot(startDir = process.cwd()) {
+    let dir = resolve(startDir);
+    for (;;) {
+        if (existsSync(join(dir, ROOT_MARKER)))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir) {
+            throw new Error(`Not inside a Forgeprint repository: no ${ROOT_MARKER} found at or above ${resolve(startDir)}`);
+        }
+        dir = parent;
+    }
+}
+export const repoPaths = {
+    taxonomy: (root) => join(root, 'schema', 'taxonomy.yaml'),
+    manifestSchema: (root) => join(root, 'schema', 'manifest.schema.json'),
+    blueprintsDir: (root) => join(root, 'blueprints'),
+    blueprintDir: (root, slug) => join(root, 'blueprints', slug),
+    index: (root) => join(root, 'docs', 'index.json'),
+    codeowners: (root) => join(root, '.github', 'CODEOWNERS'),
+};
+/** Files every blueprint folder must contain. */
+export const REQUIRED_BLUEPRINT_FILES = [
+    'manifest.yaml',
+    'AGENTS.md',
+    'overview.md',
+    'setup.md',
+    'CHANGELOG.md',
+];
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEnD,2DAA2D;AAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;AAEpD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAC3D,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5B,SAAS,CAAC;QACR,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,0CAA0C,WAAW,sBAAsB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAC/F,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,QAAQ,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,CAAC;IACzE,cAAc,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,sBAAsB,CAAC;IACtF,aAAa,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC;IACjE,YAAY,EAAE,CAAC,IAAY,EAAE,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC;IACpF,KAAK,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC;IACjE,UAAU,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,CAAC;CAC1E,CAAC;AAEF,iDAAiD;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,eAAe;IACf,WAAW;IACX,aAAa;IACb,UAAU;IACV,cAAc;CACN,CAAC"}

package/dist/similarity.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Duplicate report (rule 10).
+ *
+ * The catalog is curated, so the question asked of every new blueprint is not
+ * "is it good" but "is it already here". This compares one blueprint against
+ * every other by tag overlap and by the wording of its `AGENTS.md` and
+ * `setup.md`, and names the closest match.
+ */
+import { type Blueprint } from './catalog.js';
+/**
+ * What comparing needs: the tag fields, and the text of the two files whose
+ * wording gives a copy away. Decoupled from the file system so that the MCP
+ * server can compare a contributor's draft it has never seen on disk.
+ */
+export interface SimilaritySubject {
+    readonly slug: string;
+    readonly name: string;
+    readonly project_type: string;
+    readonly stack: readonly string[];
+    readonly languages: readonly string[];
+    readonly platforms: readonly string[];
+    readonly distribution: readonly string[];
+    readonly requirements: readonly string[];
+    readonly agentsMarkdown: string;
+    readonly setupMarkdown: string;
+}
+/** Read a blueprint on disk into a comparable subject. */
+export declare function subjectFromBlueprint(blueprint: Blueprint): SimilaritySubject;
+/** Above this, a reviewer is asked to justify the blueprint's existence. */
+export declare const DEFAULT_THRESHOLD = 0.7;
+export interface SimilarityScore {
+    readonly slug: string;
+    readonly name: string;
+    /** Jaccard overlap of the tag sets, 0–1. */
+    readonly tags: number;
+    /** Cosine similarity of the TF-IDF vectors of AGENTS.md, 0–1. */
+    readonly agents: number;
+    /** Cosine similarity of the TF-IDF vectors of setup.md, 0–1. */
+    readonly setup: number;
+    /** The highest of the three: what the threshold is applied to. */
+    readonly highest: number;
+    /** Tags only the subject has, and tags only the other one has. */
+    readonly onlyHere: readonly string[];
+    readonly onlyThere: readonly string[];
+    /** True when the two claim the same stack, project type and requirements. */
+    readonly sameCombination: boolean;
+}
+export interface SimilarityReport {
+    readonly slug: string;
+    readonly threshold: number;
+    /** Every other blueprint, most similar first. */
+    readonly scores: readonly SimilarityScore[];
+    readonly closest: SimilarityScore | undefined;
+    /** True when the closest blueprint is above the threshold. */
+    readonly flagged: boolean;
+}
+export declare function compareBlueprints(subject: Blueprint, others: readonly Blueprint[], threshold?: number): SimilarityReport;
+export declare function compareSubjects(subject: SimilaritySubject, others: readonly SimilaritySubject[], threshold?: number): SimilarityReport;
+/** Render the report the way a reviewer reads it. */
+export declare function renderReport(report: SimilarityReport): string;
+//# sourceMappingURL=similarity.d.ts.map

package/dist/similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../src/similarity.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,iBAAiB,CAc5E;AAED,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,6EAA6E;IAC7E,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAAC;IAC9C,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,SAAS,GAAE,MAA0B,GACpC,gBAAgB,CAMlB;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,SAAS,iBAAiB,EAAE,EACpC,SAAS,GAAE,MAA0B,GACpC,gBAAgB,CAqClB;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA0C7D"}

package/dist/similarity.js

@@ -0,0 +1,184 @@
+/**
+ * Duplicate report (rule 10).
+ *
+ * The catalog is curated, so the question asked of every new blueprint is not
+ * "is it good" but "is it already here". This compares one blueprint against
+ * every other by tag overlap and by the wording of its `AGENTS.md` and
+ * `setup.md`, and names the closest match.
+ */
+import { readBlueprintFile } from './catalog.js';
+/** Read a blueprint on disk into a comparable subject. */
+export function subjectFromBlueprint(blueprint) {
+    const m = blueprint.manifest;
+    return {
+        slug: blueprint.slug,
+        name: m.name,
+        project_type: m.project_type,
+        stack: m.stack,
+        languages: m.languages,
+        platforms: m.platforms,
+        distribution: m.distribution,
+        requirements: m.requirements,
+        agentsMarkdown: fileOf(blueprint, 'AGENTS.md'),
+        setupMarkdown: fileOf(blueprint, 'setup.md'),
+    };
+}
+/** Above this, a reviewer is asked to justify the blueprint's existence. */
+export const DEFAULT_THRESHOLD = 0.7;
+export function compareBlueprints(subject, others, threshold = DEFAULT_THRESHOLD) {
+    return compareSubjects(subjectFromBlueprint(subject), others.map(subjectFromBlueprint), threshold);
+}
+export function compareSubjects(subject, others, threshold = DEFAULT_THRESHOLD) {
+    const corpus = [subject, ...others];
+    const agentsIdf = inverseDocumentFrequency(corpus.map((b) => tokens(b.agentsMarkdown)));
+    const setupIdf = inverseDocumentFrequency(corpus.map((b) => tokens(b.setupMarkdown)));
+    const subjectAgents = vector(tokens(subject.agentsMarkdown), agentsIdf);
+    const subjectSetup = vector(tokens(subject.setupMarkdown), setupIdf);
+    const subjectTags = tagSet(subject);
+    const scores = others
+        .map((other) => {
+        const otherTags = tagSet(other);
+        const tags = jaccard(subjectTags, otherTags);
+        const agents = cosine(subjectAgents, vector(tokens(other.agentsMarkdown), agentsIdf));
+        const setup = cosine(subjectSetup, vector(tokens(other.setupMarkdown), setupIdf));
+        return {
+            slug: other.slug,
+            name: other.name,
+            tags,
+            agents,
+            setup,
+            highest: Math.max(tags, agents, setup),
+            onlyHere: [...subjectTags].filter((tag) => !otherTags.has(tag)).sort(),
+            onlyThere: [...otherTags].filter((tag) => !subjectTags.has(tag)).sort(),
+            sameCombination: combination(subject) === combination(other),
+        };
+    })
+        .sort((a, b) => b.highest - a.highest || a.slug.localeCompare(b.slug));
+    const closest = scores[0];
+    return {
+        slug: subject.slug,
+        threshold,
+        scores,
+        closest,
+        flagged: closest !== undefined && closest.highest > threshold,
+    };
+}
+/** Render the report the way a reviewer reads it. */
+export function renderReport(report) {
+    const lines = [`similarity report for ${report.slug}`];
+    if (report.scores.length === 0) {
+        lines.push('  no other blueprint in the catalog to compare against');
+        return lines.join('\n');
+    }
+    lines.push('');
+    lines.push('  blueprint                        tags   AGENTS.md   setup.md');
+    for (const score of report.scores) {
+        lines.push(`  ${score.slug.padEnd(30)}  ${percent(score.tags)}  ${percent(score.agents).padStart(9)}  ${percent(score.setup).padStart(8)}`);
+    }
+    const closest = report.closest;
+    if (closest === undefined)
+        return lines.join('\n');
+    lines.push('');
+    lines.push(`  closest: ${closest.slug} (${closest.name})`);
+    lines.push(`  only in ${report.slug}: ${closest.onlyHere.join(', ') || '(nothing)'}`);
+    lines.push(`  only in ${closest.slug}: ${closest.onlyThere.join(', ') || '(nothing)'}`);
+    if (closest.sameCombination) {
+        lines.push('');
+        lines.push(`  REJECTED: ${closest.slug} claims the same stack + project_type + requirements (rule 9).`);
+        lines.push('           Improve it, add an option to it, or supersede it.');
+    }
+    else if (report.flagged) {
+        lines.push('');
+        lines.push(`  RED FLAG: ${percent(closest.highest)} similar to ${closest.slug}, over the ${percent(report.threshold)} threshold.`);
+        lines.push('           State in the pull request what is different and why this is not a');
+        lines.push('           change to that blueprint instead.');
+    }
+    return lines.join('\n');
+}
+function percent(value) {
+    return `${(value * 100).toFixed(0).padStart(3)}%`;
+}
+function fileOf(blueprint, file) {
+    return blueprint.files.includes(file) ? readBlueprintFile(blueprint, file) : '';
+}
+function combination(subject) {
+    return [
+        [...subject.stack].sort().join(','),
+        subject.project_type,
+        [...subject.requirements].sort().join(','),
+    ].join('|');
+}
+/** Every tag, namespaced so that `docker` as a platform and as a stack differ. */
+function tagSet(subject) {
+    const tags = new Set([`type:${subject.project_type}`]);
+    const add = (prefix, values) => {
+        for (const value of values)
+            tags.add(`${prefix}:${value}`);
+    };
+    add('stack', subject.stack);
+    add('lang', subject.languages);
+    add('platform', subject.platforms);
+    add('dist', subject.distribution);
+    add('req', subject.requirements);
+    return tags;
+}
+function jaccard(a, b) {
+    if (a.size === 0 && b.size === 0)
+        return 0;
+    let shared = 0;
+    for (const value of a)
+        if (b.has(value))
+            shared += 1;
+    return shared / (a.size + b.size - shared);
+}
+/**
+ * Words worth comparing: markdown syntax, code punctuation and the most common
+ * English filler are dropped, because every blueprint contains them.
+ */
+const STOPWORDS = new Set(('a an the and or but if then than that this these those is are was were be been being ' +
+    'to of in on at for with from by as it its use uses using you your we our they them ' +
+    'not no yes do does done can may will shall should would could there here when while ' +
+    'each every any all one two some more most other same such only also just into out up ' +
+    'down over under again further once about after before between during').split(' '));
+function tokens(text) {
+    return text
+        .toLowerCase()
+        .split(/[^a-z0-9.+#-]+/)
+        .map((token) => token.replace(/^[.+#-]+|[.+#-]+$/g, ''))
+        .filter((token) => token.length > 2 && !STOPWORDS.has(token));
+}
+function inverseDocumentFrequency(documents) {
+    const count = new Map();
+    for (const document of documents) {
+        for (const token of new Set(document)) {
+            count.set(token, (count.get(token) ?? 0) + 1);
+        }
+    }
+    const idf = new Map();
+    const total = documents.length;
+    for (const [token, seen] of count) {
+        idf.set(token, Math.log((total + 1) / (seen + 1)) + 1);
+    }
+    return idf;
+}
+function vector(document, idf) {
+    const frequency = new Map();
+    for (const token of document)
+        frequency.set(token, (frequency.get(token) ?? 0) + 1);
+    const weighted = new Map();
+    for (const [token, count] of frequency) {
+        weighted.set(token, (count / document.length) * (idf.get(token) ?? 1));
+    }
+    return weighted;
+}
+function cosine(a, b) {
+    if (a.size === 0 || b.size === 0)
+        return 0;
+    let dot = 0;
+    for (const [token, weight] of a)
+        dot += weight * (b.get(token) ?? 0);
+    const magnitude = (vec) => Math.sqrt([...vec.values()].reduce((sum, value) => sum + value * value, 0));
+    const scale = magnitude(a) * magnitude(b);
+    return scale === 0 ? 0 : Math.min(1, dot / scale);
+}
+//# sourceMappingURL=similarity.js.map

package/dist/similarity.js.map

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

package/dist/taxonomy.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+/** Identifiers used in manifests: lower kebab-case, ASCII only. */
+export declare const SLUG_PATTERN: RegExp;
+export declare const taxonomySchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    languages: z.ZodRecord<z.ZodString, z.ZodString>;
+    stack: z.ZodRecord<z.ZodString, z.ZodString>;
+    platforms: z.ZodRecord<z.ZodString, z.ZodString>;
+    distribution: z.ZodRecord<z.ZodString, z.ZodString>;
+    project_type: z.ZodRecord<z.ZodString, z.ZodString>;
+    audience: z.ZodRecord<z.ZodString, z.ZodString>;
+    requirements: z.ZodRecord<z.ZodString, z.ZodString>;
+    agents: z.ZodRecord<z.ZodString, z.ZodString>;
+    tier: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+export type Taxonomy = z.infer<typeof taxonomySchema>;
+/** Vocabulary names a manifest field can draw from. */
+export type Vocabulary = Exclude<keyof Taxonomy, 'version'>;
+export declare function parseTaxonomy(source: string): Taxonomy;
+export declare function loadTaxonomy(root: string): Taxonomy;
+/** Sorted identifiers of one vocabulary. Sorted so generated output is stable. */
+export declare function terms(taxonomy: Taxonomy, vocabulary: Vocabulary): string[];
+export declare function describeError(error: unknown): string;
+//# sourceMappingURL=taxonomy.d.ts.map

package/dist/taxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy.d.ts","sourceRoot":"","sources":["../src/taxonomy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,mEAAmE;AACnE,eAAO,MAAM,YAAY,QAA+B,CAAC;AAIzD,eAAO,MAAM,cAAc;;;;;;;;;;;kBAahB,CAAC;AAEZ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,uDAAuD;AACvD,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,QAAQ,EAAE,SAAS,CAAC,CAAC;AAE5D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAEtD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAOnD;AAED,kFAAkF;AAClF,wBAAgB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,CAE1E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOpD"}

package/dist/taxonomy.js

@@ -0,0 +1,46 @@
+import { readFileSync } from 'node:fs';
+import { parse } from 'yaml';
+import { z } from 'zod';
+import { repoPaths } from './paths.js';
+/** Identifiers used in manifests: lower kebab-case, ASCII only. */
+export const SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const termMap = z.record(z.string().regex(SLUG_PATTERN), z.string().min(1));
+export const taxonomySchema = z
+    .object({
+    version: z.literal(1),
+    languages: termMap,
+    stack: termMap,
+    platforms: termMap,
+    distribution: termMap,
+    project_type: termMap,
+    audience: termMap,
+    requirements: termMap,
+    agents: termMap,
+    tier: termMap,
+})
+    .strict();
+export function parseTaxonomy(source) {
+    return taxonomySchema.parse(parse(source));
+}
+export function loadTaxonomy(root) {
+    const file = repoPaths.taxonomy(root);
+    try {
+        return parseTaxonomy(readFileSync(file, 'utf8'));
+    }
+    catch (error) {
+        throw new Error(`Invalid taxonomy at ${file}: ${describeError(error)}`, { cause: error });
+    }
+}
+/** Sorted identifiers of one vocabulary. Sorted so generated output is stable. */
+export function terms(taxonomy, vocabulary) {
+    return Object.keys(taxonomy[vocabulary]).sort();
+}
+export function describeError(error) {
+    if (error instanceof z.ZodError) {
+        return error.issues
+            .map((issue) => `${issue.path.join('.') || '<root>'}: ${issue.message}`)
+            .join('; ');
+    }
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=taxonomy.js.map

package/dist/taxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy.js","sourceRoot":"","sources":["../src/taxonomy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,mEAAmE;AACnE,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAEzD,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,SAAS,EAAE,OAAO;IAClB,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,OAAO;IAClB,YAAY,EAAE,OAAO;IACrB,YAAY,EAAE,OAAO;IACrB,QAAQ,EAAE,OAAO;IACjB,YAAY,EAAE,OAAO;IACrB,MAAM,EAAE,OAAO;IACf,IAAI,EAAE,OAAO;CACd,CAAC;KACD,MAAM,EAAE,CAAC;AAOZ,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,KAAK,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,KAAK,CAAC,QAAkB,EAAE,UAAsB;IAC9D,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,MAAM;aAChB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aACvE,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,23 @@
+/** A taxonomy small enough to read in a test failure message. */
+export declare const TEST_TAXONOMY = "\nversion: 1\nlanguages:\n  csharp: C#\n  typescript: TypeScript\nstack:\n  aspnetcore: ASP.NET Core\n  postgres: PostgreSQL\n  node: Node.js\nplatforms:\n  linux: Linux\n  docker: Docker\ndistribution:\n  saas: SaaS\n  free: Free\nproject_type:\n  api: API service\n  cli: Command-line tool\naudience:\n  intermediate: Intermediate\nrequirements:\n  auth: Authentication\n  ci: Continuous integration\nagents:\n  claude-code: Claude Code\ntier:\n  community: Community\n  official: Official\n";
+export interface ManifestFields {
+    [key: string]: unknown;
+}
+/** A manifest that passes validation, so a test only states what it changes. */
+export declare function validManifest(overrides?: ManifestFields): ManifestFields;
+export interface BlueprintFixture {
+    readonly slug: string;
+    readonly manifest?: ManifestFields | null;
+    /** Extra or replacement files, keyed by path relative to the folder. */
+    readonly files?: Record<string, string>;
+    /** Required files to leave out, to exercise the missing-file check. */
+    readonly omit?: readonly string[];
+}
+/**
+ * Create a throwaway repository on disk. Generated artifacts are written too,
+ * so that `validateCatalog` starts from a clean state.
+ */
+export declare function makeRepo(blueprints?: readonly BlueprintFixture[]): string;
+/** Write the generated artifacts so drift checks pass. */
+export declare function regenerate(root: string): void;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAUA,iEAAiE;AACjE,eAAO,MAAM,aAAa,kfA4BzB,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,SAAS,GAAE,cAAmB,GAAG,cAAc,CAmB5E;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C,wEAAwE;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,uEAAuE;IACvE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,UAAU,GAAE,SAAS,gBAAgB,EAAO,GAAG,MAAM,CA8B7E;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAW7C"}