forgeprint 0.1.1

package/LICENSE

@@ -0,0 +1,16 @@
+PolyForm Shield License 1.0.0
+
+<https://polyformproject.org/licenses/shield/1.0.0>
+
+Required Notice: Copyright 2026 Forgeprint (https://github.com/forgeprint)
+
+You may use, modify and contribute to this software. You may not use it to
+provide a product that competes with Forgeprint. The full licence text is at
+the URL above and in the LICENSE file of the repository:
+
+    https://github.com/forgeprint/forgeprint/blob/main/LICENSE
+
+Catalog content (blueprints, schema, skills) is licensed separately under
+CC BY 4.0. The Forgeprint name and logo are covered by TRADEMARK.md.
+
+Forgeprint is source-available, not OSI open source.

package/README.md

@@ -0,0 +1,41 @@
+# forgeprint
+
+The [Forgeprint](https://github.com/forgeprint/forgeprint) catalog tooling.
+Every check that runs in CI is a command here, so a contributor gets the same
+answer on a laptop that the pipeline gives on a pull request — by design, not
+by luck ([ADR 0002](https://github.com/forgeprint/forgeprint/blob/main/docs/decisions/0002-actions-optional.md)).
+
+```bash
+npx forgeprint validate
+```
+
+## Commands
+
+| Command                        | What it does                                                                                                                                                                           |
+| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `forgeprint validate`          | Schema, taxonomy, required files, and the catalog-wide rules: one blueprint per stack + project type + requirements, a CHANGELOG entry per version, generated files that are not stale |
+| `forgeprint lint-setup <slug>` | Holds `setup.md` to a script's standards: numbered steps, a verification per step, pinned versions, no privileged or unpinned commands, option guards that resolve                     |
+| `forgeprint similarity <slug>` | Duplicate report — tag overlap plus TF-IDF similarity of `AGENTS.md` and `setup.md` against every other blueprint                                                                      |
+| `forgeprint build-index`       | Regenerate `docs/index.json`                                                                                                                                                           |
+| `forgeprint build-schema`      | Regenerate `schema/manifest.schema.json` from the taxonomy                                                                                                                             |
+| `forgeprint build-codeowners`  | Regenerate `.github/CODEOWNERS` from the manifests                                                                                                                                     |
+
+Run them from anywhere inside a Forgeprint checkout; the repository root is
+found the way git finds it.
+
+## As a library
+
+The catalog reader, the manifest schema, the setup linter, the option resolver
+and the similarity report are all exported, which is what
+[`forgeprint-mcp`](https://www.npmjs.com/package/forgeprint-mcp) is built on.
+
+```ts
+import { lintSetup, resolveSetupOptions, validateCatalog } from 'forgeprint';
+```
+
+`forgeprint/testing` exposes the fixture helpers used by the test suite.
+
+## Licence
+
+PolyForm Shield 1.0.0 — see `LICENSE`. Forgeprint is source-available, not OSI
+open source. The blueprints in the catalog are CC BY 4.0.

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { createProgram } from './cli.js';
+try {
+    createProgram().parse(process.argv);
+}
+catch (error) {
+    console.error(`error  ${error instanceof Error ? error.message : String(error)}`);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,IAAI,CAAC;IACH,aAAa,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/build-codeowners.d.ts

@@ -0,0 +1,8 @@
+import type { Blueprint } from './catalog.js';
+/**
+ * Render `.github/CODEOWNERS` from the `maintainers` field of every manifest.
+ * `coreMaintainer` owns the repository root, so that the Code Owners review
+ * requirement always reaches them.
+ */
+export declare function renderCodeowners(blueprints: readonly Blueprint[], coreMaintainer: string): string;
+//# sourceMappingURL=build-codeowners.d.ts.map

package/dist/build-codeowners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-codeowners.d.ts","sourceRoot":"","sources":["../src/build-codeowners.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAU9C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAYjG"}

package/dist/build-codeowners.js

@@ -0,0 +1,26 @@
+const HEADER = [
+    '# Generated by `forgeprint build-codeowners`. Do not edit by hand.',
+    '#',
+    '# The root owner reviews everything: merge decisions stay with the core',
+    '# maintainer (CLAUDE.md rule 12). Blueprint maintainers own their own folder',
+    '# and approve changes to it; they do not merge.',
+];
+/**
+ * Render `.github/CODEOWNERS` from the `maintainers` field of every manifest.
+ * `coreMaintainer` owns the repository root, so that the Code Owners review
+ * requirement always reaches them.
+ */
+export function renderCodeowners(blueprints, coreMaintainer) {
+    const lines = [...HEADER, '', `* @${coreMaintainer}`, ''];
+    const owned = [...blueprints].sort((a, b) => a.slug.localeCompare(b.slug));
+    if (owned.length > 0) {
+        lines.push('# One line per blueprint, ordered by slug.');
+        for (const blueprint of owned) {
+            const owners = blueprint.manifest.maintainers.map((handle) => `@${handle}`).join(' ');
+            lines.push(`/blueprints/${blueprint.slug}/ ${owners}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=build-codeowners.js.map

package/dist/build-codeowners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-codeowners.js","sourceRoot":"","sources":["../src/build-codeowners.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG;IACb,oEAAoE;IACpE,GAAG;IACH,yEAAyE;IACzE,8EAA8E;IAC9E,iDAAiD;CAClD,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAgC,EAAE,cAAsB;IACvF,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,EAAE,EAAE,EAAE,MAAM,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QACzD,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtF,KAAK,CAAC,IAAI,CAAC,eAAe,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/build-index.d.ts

@@ -0,0 +1,45 @@
+import { type Blueprint } from './catalog.js';
+import type { Taxonomy } from './taxonomy.js';
+/**
+ * The published catalog index. It is committed to the repository so that GitHub
+ * Pages can serve it from the branch without a build service (ADR 0002).
+ *
+ * The index carries no timestamp on purpose: a generated file that changes on
+ * every run cannot be checked for drift.
+ */
+export interface CatalogIndex {
+    readonly schema: 1;
+    readonly taxonomy: Taxonomy;
+    readonly blueprints: readonly IndexEntry[];
+}
+export interface IndexEntry {
+    readonly slug: string;
+    readonly name: string;
+    readonly version: string;
+    readonly tier: string;
+    readonly maintainers: readonly string[];
+    readonly summary: string;
+    readonly stack: readonly string[];
+    readonly languages: readonly string[];
+    readonly platforms: readonly string[];
+    readonly distribution: readonly string[];
+    readonly project_type: string;
+    readonly audience: readonly string[];
+    readonly requirements: readonly string[];
+    readonly agents: readonly string[];
+    readonly options: Record<string, string[]>;
+    readonly provides: {
+        readonly mcp: string[];
+        readonly skills: string[];
+    };
+    readonly requires_tools: readonly string[];
+    readonly deprecated: boolean;
+    readonly supersedes: string | null;
+    readonly files: readonly string[];
+    readonly i18n: readonly string[];
+}
+export declare function loadBlueprints(root: string, taxonomy: Taxonomy): Blueprint[];
+export declare function indexEntry(blueprint: Blueprint): IndexEntry;
+export declare function buildIndex(blueprints: readonly Blueprint[], taxonomy: Taxonomy): CatalogIndex;
+export declare function renderIndex(blueprints: readonly Blueprint[], taxonomy: Taxonomy): string;
+//# sourceMappingURL=build-index.d.ts.map

package/dist/build-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-index.d.ts","sourceRoot":"","sources":["../src/build-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,UAAU,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,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,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACzE,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAAE,CAK5E;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAyB3D;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,YAAY,CAE7F;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAExF"}

package/dist/build-index.js

@@ -0,0 +1,41 @@
+import { listBlueprintSlugs, readBlueprintFolder, readManifest, translations, } from './catalog.js';
+import { stableJson } from './json.js';
+export function loadBlueprints(root, taxonomy) {
+    return listBlueprintSlugs(root).map((slug) => {
+        const folder = readBlueprintFolder(root, slug);
+        return { ...folder, manifest: readManifest(taxonomy, folder) };
+    });
+}
+export function indexEntry(blueprint) {
+    const m = blueprint.manifest;
+    return {
+        slug: m.slug,
+        name: m.name,
+        version: m.version,
+        tier: m.tier,
+        maintainers: m.maintainers,
+        summary: m.summary,
+        stack: m.stack,
+        languages: m.languages,
+        platforms: m.platforms,
+        distribution: m.distribution,
+        project_type: m.project_type,
+        audience: m.audience,
+        requirements: m.requirements,
+        agents: m.agents,
+        options: m.options ?? {},
+        provides: { mcp: m.provides?.mcp ?? [], skills: m.provides?.skills ?? [] },
+        requires_tools: m.requires_tools ?? [],
+        deprecated: m.deprecated,
+        supersedes: m.supersedes,
+        files: blueprint.files,
+        i18n: translations(blueprint),
+    };
+}
+export function buildIndex(blueprints, taxonomy) {
+    return { schema: 1, taxonomy, blueprints: blueprints.map(indexEntry) };
+}
+export function renderIndex(blueprints, taxonomy) {
+    return stableJson(buildIndex(blueprints, taxonomy));
+}
+//# sourceMappingURL=build-index.js.map

package/dist/build-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-index.js","sourceRoot":"","sources":["../src/build-index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,YAAY,GAEb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAwCvC,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,QAAkB;IAC7D,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/C,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,SAAoB;IAC7C,MAAM,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC;IAC7B,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;QACxB,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE;QAC1E,cAAc,EAAE,CAAC,CAAC,cAAc,IAAI,EAAE;QACtC,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,UAAgC,EAAE,QAAkB;IAC7E,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAAgC,EAAE,QAAkB;IAC9E,OAAO,UAAU,CAAC,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/build-schema.d.ts

@@ -0,0 +1,4 @@
+import type { Taxonomy } from './taxonomy.js';
+/** Render the manifest schema as JSON Schema text, for editors and other tools. */
+export declare function buildManifestJsonSchema(taxonomy: Taxonomy): string;
+//# sourceMappingURL=build-schema.d.ts.map

package/dist/build-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-schema.d.ts","sourceRoot":"","sources":["../src/build-schema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAW9C,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAUlE"}

package/dist/build-schema.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { manifestObjectSchema } from './manifest.js';
+import { stableJson } from './json.js';
+const HEADER = {
+    title: 'Forgeprint blueprint manifest',
+    description: 'Generated from schema/taxonomy.yaml by `forgeprint build-schema`. Do not edit by hand. ' +
+        'Rules that JSON Schema cannot express — the option field limit, the uniqueness of the ' +
+        'stack/project_type/requirements combination, and CHANGELOG consistency — are enforced by ' +
+        '`forgeprint validate`.',
+};
+/** Render the manifest schema as JSON Schema text, for editors and other tools. */
+export function buildManifestJsonSchema(taxonomy) {
+    const generated = z.toJSONSchema(manifestObjectSchema(taxonomy), {
+        target: 'draft-2020-12',
+    });
+    const { $schema, ...rest } = generated;
+    return stableJson({
+        $schema: $schema ?? 'https://json-schema.org/draft/2020-12/schema',
+        ...HEADER,
+        ...markArraysUnique(rest),
+    });
+}
+/**
+ * Every array field in a manifest rejects duplicates. That rule lives in a Zod
+ * refinement, which has no JSON Schema equivalent, so it is restored here.
+ */
+function markArraysUnique(node) {
+    if (Array.isArray(node))
+        return node.map(markArraysUnique);
+    if (node === null || typeof node !== 'object')
+        return node;
+    const entries = Object.entries(node).map(([key, value]) => [key, markArraysUnique(value)]);
+    const result = Object.fromEntries(entries);
+    if (result['type'] === 'array')
+        result['uniqueItems'] = true;
+    return result;
+}
+//# sourceMappingURL=build-schema.js.map

package/dist/build-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-schema.js","sourceRoot":"","sources":["../src/build-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,MAAM,MAAM,GAAG;IACb,KAAK,EAAE,+BAA+B;IACtC,WAAW,EACT,yFAAyF;QACzF,wFAAwF;QACxF,2FAA2F;QAC3F,wBAAwB;CAC3B,CAAC;AAEF,mFAAmF;AACnF,MAAM,UAAU,uBAAuB,CAAC,QAAkB;IACxD,MAAM,SAAS,GAAG,CAAC,CAAC,YAAY,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE;QAC/D,MAAM,EAAE,eAAe;KACxB,CAA4B,CAAC;IAC9B,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC;IACvC,OAAO,UAAU,CAAC;QAChB,OAAO,EAAE,OAAO,IAAI,8CAA8C;QAClE,GAAG,MAAM;QACT,GAAI,gBAAgB,CAAC,IAAI,CAA6B;KACvD,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,IAAa;IACrC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC3D,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,CAAC,GAAG,CACjE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAU,CAC1D,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,OAAO;QAAE,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/catalog.d.ts

@@ -0,0 +1,23 @@
+import { type Manifest } from './manifest.js';
+import { type Taxonomy } from './taxonomy.js';
+export interface BlueprintFolder {
+    /** Folder name under `blueprints/`. */
+    readonly slug: string;
+    readonly dir: string;
+    /** Every file in the folder, as forward-slash paths relative to it, sorted. */
+    readonly files: readonly string[];
+}
+export interface Blueprint extends BlueprintFolder {
+    readonly manifest: Manifest;
+}
+/** Blueprint folder names, sorted, so that every generated file is stable. */
+export declare function listBlueprintSlugs(root: string): string[];
+export declare function readBlueprintFolder(root: string, slug: string): BlueprintFolder;
+export declare function missingRequiredFiles(folder: BlueprintFolder): string[];
+/** Parse and validate one manifest. Throws with a readable message on failure. */
+export declare function parseManifest(taxonomy: Taxonomy, source: string): Manifest;
+export declare function readManifest(taxonomy: Taxonomy, folder: BlueprintFolder): Manifest;
+export declare function readBlueprintFile(folder: BlueprintFolder, file: string): string;
+/** Community translations of overview.md, as language codes, sorted. */
+export declare function translations(folder: BlueprintFolder): string[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,SAAU,SAAQ,eAAe;IAChD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOzD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAU/E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAEtE;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAI1E;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,GAAG,QAAQ,CAElF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAM9D"}

package/dist/catalog.js

@@ -0,0 +1,55 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+import { parse } from 'yaml';
+import { repoPaths, REQUIRED_BLUEPRINT_FILES } from './paths.js';
+import { manifestSchema } from './manifest.js';
+import { describeError } from './taxonomy.js';
+/** Blueprint folder names, sorted, so that every generated file is stable. */
+export function listBlueprintSlugs(root) {
+    const dir = repoPaths.blueprintsDir(root);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort();
+}
+export function readBlueprintFolder(root, slug) {
+    const dir = repoPaths.blueprintDir(root, slug);
+    if (!existsSync(dir) || !statSync(dir).isDirectory()) {
+        throw new Error(`No such blueprint: ${slug}`);
+    }
+    const files = readdirSync(dir, { recursive: true, withFileTypes: true })
+        .filter((entry) => entry.isFile())
+        .map((entry) => toPosix(relative(dir, join(entry.parentPath, entry.name))))
+        .sort();
+    return { slug, dir, files };
+}
+export function missingRequiredFiles(folder) {
+    return REQUIRED_BLUEPRINT_FILES.filter((file) => !folder.files.includes(file));
+}
+/** Parse and validate one manifest. Throws with a readable message on failure. */
+export function parseManifest(taxonomy, source) {
+    const result = manifestSchema(taxonomy).safeParse(parse(source));
+    if (!result.success)
+        throw new Error(describeError(result.error));
+    return result.data;
+}
+export function readManifest(taxonomy, folder) {
+    return parseManifest(taxonomy, readFileSync(join(folder.dir, 'manifest.yaml'), 'utf8'));
+}
+export function readBlueprintFile(folder, file) {
+    return readFileSync(join(folder.dir, ...file.split('/')), 'utf8');
+}
+/** Community translations of overview.md, as language codes, sorted. */
+export function translations(folder) {
+    return folder.files
+        .filter((file) => file.startsWith('i18n/') && file.endsWith('/overview.md'))
+        .map((file) => file.split('/')[1] ?? '')
+        .filter((lang) => lang.length > 0)
+        .sort();
+}
+function toPosix(path) {
+    return sep === '/' ? path : path.split(sep).join('/');
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+export declare const VERSION = "0.1.0";
+/**
+ * Every pipeline step is a command here, so that contributors and maintainers
+ * get the same result locally that CI produces (ADR 0002).
+ */
+export declare function createProgram(): Command;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,eAAO,MAAM,OAAO,UAAU,CAAC;AAM/B;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAmHvC"}

package/dist/cli.js

@@ -0,0 +1,128 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { Command } from 'commander';
+import { renderCodeowners } from './build-codeowners.js';
+import { loadBlueprints, renderIndex } from './build-index.js';
+import { buildManifestJsonSchema } from './build-schema.js';
+import { readBlueprintFile, readBlueprintFolder, readManifest } from './catalog.js';
+import { CONFIG_FILE, loadConfig } from './config.js';
+import { lintSetup } from './lint-setup.js';
+import { compareBlueprints, DEFAULT_THRESHOLD, renderReport } from './similarity.js';
+import { findRepoRoot, repoPaths } from './paths.js';
+import { loadTaxonomy } from './taxonomy.js';
+import { validateCatalog } from './validate.js';
+export const VERSION = '0.1.0';
+/**
+ * Every pipeline step is a command here, so that contributors and maintainers
+ * get the same result locally that CI produces (ADR 0002).
+ */
+export function createProgram() {
+    const program = new Command();
+    program
+        .name('forgeprint')
+        .description('Forgeprint catalog tooling')
+        .version(VERSION)
+        .option('--root <dir>', 'repository root (default: nearest one above the working directory)');
+    const rootOf = () => findRepoRoot(program.opts().root);
+    program
+        .command('validate')
+        .description('check every blueprint against the schema, the taxonomy and the catalog rules')
+        .action(() => {
+        const root = rootOf();
+        const report = validateCatalog(root);
+        for (const problem of report.problems) {
+            const where = problem.blueprint === undefined ? '' : `${problem.blueprint}: `;
+            console.error(`error  ${where}${problem.message}`);
+        }
+        if (report.ok) {
+            console.log(`ok  ${report.checked} blueprint(s) valid`);
+            return;
+        }
+        console.error(`\n${report.problems.length} problem(s) in ${report.checked} blueprint(s)`);
+        process.exitCode = 1;
+    });
+    program
+        .command('lint-setup')
+        .argument('<slug>', 'blueprint to check')
+        .description('check a blueprint setup.md against the structure and safety rules')
+        .action((slug) => {
+        const root = rootOf();
+        const folder = readBlueprintFolder(root, slug);
+        const manifest = readManifest(loadTaxonomy(root), folder);
+        const problems = lintSetup(readBlueprintFile(folder, 'setup.md'), {
+            options: manifest.options ?? {},
+        });
+        for (const problem of problems) {
+            console.error(`error  setup.md:${problem.line}  ${problem.rule}: ${problem.message}`);
+        }
+        if (problems.length === 0) {
+            console.log(`ok  ${slug}/setup.md passes the setup rules`);
+            return;
+        }
+        console.error(`
+${problems.length} problem(s) in ${slug}/setup.md`);
+        process.exitCode = 1;
+    });
+    program
+        .command('similarity')
+        .argument('<slug>', 'blueprint to compare against the rest of the catalog')
+        .option('--threshold <ratio>', 'flag above this similarity', String(DEFAULT_THRESHOLD))
+        .option('--fail-on-flag', 'exit non-zero on a red flag, not only on a rule 9 rejection')
+        .description('report how close a blueprint is to the ones already in the catalog')
+        .action((slug, options) => {
+        const root = rootOf();
+        const taxonomy = loadTaxonomy(root);
+        const blueprints = loadBlueprints(root, taxonomy);
+        const subject = blueprints.find((blueprint) => blueprint.slug === slug);
+        if (subject === undefined)
+            throw new Error(`No such blueprint: ${slug}`);
+        const threshold = Number(options.threshold);
+        if (!Number.isFinite(threshold) || threshold <= 0 || threshold > 1) {
+            throw new Error('--threshold must be a ratio between 0 and 1');
+        }
+        const report = compareBlueprints(subject, blueprints.filter((blueprint) => blueprint.slug !== slug), threshold);
+        console.log(renderReport(report));
+        // A red flag is a question for the reviewer, which the pull request
+        // template makes them answer (rule 11). Only the objective rule — one
+        // blueprint per stack + project_type + requirements — fails the command.
+        if (report.closest?.sameCombination === true || options.failOnFlag === true) {
+            if (report.flagged || report.closest?.sameCombination === true)
+                process.exitCode = 1;
+        }
+    });
+    program
+        .command('build-index')
+        .description('regenerate docs/index.json from the catalog')
+        .action(() => {
+        const root = rootOf();
+        const taxonomy = loadTaxonomy(root);
+        write(repoPaths.index(root), renderIndex(loadBlueprints(root, taxonomy), taxonomy));
+    });
+    program
+        .command('build-schema')
+        .description('regenerate schema/manifest.schema.json from the taxonomy')
+        .action(() => {
+        const root = rootOf();
+        write(repoPaths.manifestSchema(root), buildManifestJsonSchema(loadTaxonomy(root)));
+    });
+    program
+        .command('build-codeowners')
+        .description('regenerate .github/CODEOWNERS from every manifest maintainers field')
+        .option('--owner <handle>', `core maintainer (default: core_maintainer in ${CONFIG_FILE})`)
+        .action((options) => {
+        const root = rootOf();
+        const owner = options.owner ?? loadConfig(root).core_maintainer;
+        if (owner === undefined) {
+            throw new Error(`No core maintainer: pass --owner or set core_maintainer in ${CONFIG_FILE}`);
+        }
+        const taxonomy = loadTaxonomy(root);
+        write(repoPaths.codeowners(root), renderCodeowners(loadBlueprints(root, taxonomy), owner));
+    });
+    return program;
+}
+function write(file, contents) {
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, contents, 'utf8');
+    console.log(`wrote  ${file}`);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+/**
+ * Repository-level settings that the tooling cannot infer. Optional: every
+ * command that needs a value also accepts it as a flag.
+ */
+export declare const configSchema: z.ZodObject<{
+    core_maintainer: z.ZodOptional<z.ZodString>;
+    repository: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type Config = z.infer<typeof configSchema>;
+export declare const CONFIG_FILE = "forgeprint.json";
+export declare function loadConfig(root: string): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,YAAY;;;kBAQd,CAAC;AAEZ,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,WAAW,oBAAoB,CAAC;AAE7C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ/C"}

package/dist/config.js

@@ -0,0 +1,30 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { describeError } from './taxonomy.js';
+/**
+ * Repository-level settings that the tooling cannot infer. Optional: every
+ * command that needs a value also accepts it as a flag.
+ */
+export const configSchema = z
+    .object({
+    /** GitHub login that owns the repository root in CODEOWNERS (rule 12). */
+    core_maintainer: z.string().min(1),
+    /** `owner/repo`, used in generated links. */
+    repository: z.string().regex(/^[^/\s]+\/[^/\s]+$/),
+})
+    .partial()
+    .strict();
+export const CONFIG_FILE = 'forgeprint.json';
+export function loadConfig(root) {
+    const file = join(root, CONFIG_FILE);
+    if (!existsSync(file))
+        return {};
+    try {
+        return configSchema.parse(JSON.parse(readFileSync(file, 'utf8')));
+    }
+    catch (error) {
+        throw new Error(`Invalid ${CONFIG_FILE}: ${describeError(error)}`, { cause: error });
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,0EAA0E;IAC1E,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,6CAA6C;IAC7C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC;CACnD,CAAC;KACD,OAAO,EAAE;KACT,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAE7C,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,KAAK,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACvF,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export * from './build-codeowners.js';
+export * from './build-index.js';
+export * from './build-schema.js';
+export * from './catalog.js';
+export * from './cli.js';
+export * from './config.js';
+export * from './json.js';
+export * from './lint-setup.js';
+export * from './manifest.js';
+export * from './options.js';
+export * from './paths.js';
+export * from './similarity.js';
+export * from './taxonomy.js';
+export * from './validate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export * from './build-codeowners.js';
+export * from './build-index.js';
+export * from './build-schema.js';
+export * from './catalog.js';
+export * from './cli.js';
+export * from './config.js';
+export * from './json.js';
+export * from './lint-setup.js';
+export * from './manifest.js';
+export * from './options.js';
+export * from './paths.js';
+export * from './similarity.js';
+export * from './taxonomy.js';
+export * from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/json.d.ts

@@ -0,0 +1,5 @@
+/** Serialize a generated artifact: 2-space JSON with a trailing newline. */
+export declare function stableJson(value: unknown): string;
+/** Normalize line endings so drift checks do not fire on checkout differences. */
+export declare function normalizeNewlines(text: string): string;
+//# sourceMappingURL=json.d.ts.map