forgecraft-mcp 0.1.0

package/dist/registry/composer.js

@@ -0,0 +1,169 @@
+/**
+ * Template composer.
+ *
+ * Given a set of active tags, composes CLAUDE.md blocks, folder structures,
+ * hooks, and NFRs from all matching templates into unified outputs.
+ * Handles merge, deduplication, ordering, and tier-based filtering.
+ */
+import { createLogger } from "../shared/logger/index.js";
+const logger = createLogger("registry/composer");
+/**
+ * Tier inclusion hierarchy.
+ * "core" → includes only core blocks.
+ * "recommended" → includes core + recommended.
+ * "optional" → includes core + recommended + optional.
+ * Blocks without a tier field are treated as "core" (always included).
+ */
+const TIER_HIERARCHY = {
+    core: ["core"],
+    recommended: ["core", "recommended"],
+    optional: ["core", "recommended", "optional"],
+};
+/** Default tier when none is specified in config. */
+const DEFAULT_TIER = "recommended";
+/**
+ * Check if a block should be included based on the tier filter.
+ * Blocks without a tier are treated as "core" (always included).
+ *
+ * @param blockTier - The tier of the block (undefined = core)
+ * @param allowedTiers - The set of allowed tiers
+ * @returns true if the block should be included
+ */
+function isTierAllowed(blockTier, allowedTiers) {
+    const effective = blockTier ?? "core";
+    return allowedTiers.has(effective);
+}
+/**
+ * Check if a block ID is included/excluded by the config lists.
+ *
+ * @param blockId - The block identifier
+ * @param include - Explicit include list (if set, only these are included)
+ * @param exclude - Explicit exclude list (always excluded)
+ * @returns true if the block should be included
+ */
+function isBlockAllowed(blockId, include, exclude) {
+    if (exclude?.includes(blockId)) {
+        return false;
+    }
+    if (include && include.length > 0) {
+        return include.includes(blockId);
+    }
+    return true;
+}
+/**
+ * Compose templates for a given set of active tags.
+ * UNIVERSAL is always included first regardless of whether it's in the tags list.
+ *
+ * @param activeTags - Tags to compose for
+ * @param allTemplates - Full template map from the loader
+ * @param options - Optional composition config (tier filtering, include/exclude)
+ * @returns Composed and filtered templates
+ */
+export function composeTemplates(activeTags, allTemplates, options) {
+    const config = options?.config;
+    const tierLevel = config?.tier ?? DEFAULT_TIER;
+    const allowedTiers = new Set(TIER_HIERARCHY[tierLevel]);
+    const includeList = config?.include;
+    const excludeList = config?.exclude;
+    // Ensure UNIVERSAL is first and present
+    const orderedTags = normalizeTagOrder(activeTags);
+    const claudeMdBlocks = [];
+    const structureEntries = [];
+    const nfrBlocks = [];
+    const hooks = [];
+    const reviewBlocks = [];
+    const seenBlockIds = new Set();
+    const seenPaths = new Set();
+    const seenHookNames = new Set();
+    const seenNfrIds = new Set();
+    const seenReviewIds = new Set();
+    for (const tag of orderedTags) {
+        const templateSet = allTemplates.get(tag);
+        if (!templateSet) {
+            logger.warn("No templates found for tag", { tag });
+            continue;
+        }
+        // Compose CLAUDE.md blocks (deduplicate by id, filter by tier)
+        if (templateSet.claudeMd?.blocks) {
+            for (const block of templateSet.claudeMd.blocks) {
+                if (!seenBlockIds.has(block.id) &&
+                    isTierAllowed(block.tier, allowedTiers) &&
+                    isBlockAllowed(block.id, includeList, excludeList)) {
+                    seenBlockIds.add(block.id);
+                    claudeMdBlocks.push(block);
+                }
+            }
+        }
+        // Compose structure entries (deduplicate by path — not tier-filtered)
+        if (templateSet.structure?.entries) {
+            for (const entry of templateSet.structure.entries) {
+                if (!seenPaths.has(entry.path)) {
+                    seenPaths.add(entry.path);
+                    structureEntries.push(entry);
+                }
+            }
+        }
+        // Compose NFR blocks (deduplicate by id, filter by tier)
+        if (templateSet.nfr?.blocks) {
+            for (const block of templateSet.nfr.blocks) {
+                if (!seenNfrIds.has(block.id) &&
+                    isTierAllowed(block.tier, allowedTiers) &&
+                    isBlockAllowed(block.id, includeList, excludeList)) {
+                    seenNfrIds.add(block.id);
+                    nfrBlocks.push(block);
+                }
+            }
+        }
+        // Compose hooks (deduplicate by name — not tier-filtered)
+        if (templateSet.hooks) {
+            for (const hook of templateSet.hooks) {
+                if (!seenHookNames.has(hook.name)) {
+                    seenHookNames.add(hook.name);
+                    hooks.push(hook);
+                }
+            }
+        }
+        // Compose review blocks (deduplicate by id, filter by tier)
+        if (templateSet.review?.blocks) {
+            for (const block of templateSet.review.blocks) {
+                if (!seenReviewIds.has(block.id) &&
+                    isTierAllowed(block.tier, allowedTiers) &&
+                    isBlockAllowed(block.id, includeList, excludeList)) {
+                    seenReviewIds.add(block.id);
+                    reviewBlocks.push(block);
+                }
+            }
+        }
+    }
+    logger.info("Templates composed", {
+        tags: orderedTags,
+        tier: tierLevel,
+        claudeMdBlocks: claudeMdBlocks.length,
+        structureEntries: structureEntries.length,
+        nfrBlocks: nfrBlocks.length,
+        hooks: hooks.length,
+        reviewBlocks: reviewBlocks.length,
+    });
+    return { claudeMdBlocks, structureEntries, nfrBlocks, hooks, reviewBlocks };
+}
+/**
+ * Ensure UNIVERSAL is always first in the tag list.
+ * Remove duplicates. Preserve user order for other tags.
+ */
+function normalizeTagOrder(tags) {
+    const seen = new Set();
+    const result = [];
+    // UNIVERSAL always first
+    if (!tags.includes("UNIVERSAL")) {
+        result.push("UNIVERSAL");
+        seen.add("UNIVERSAL");
+    }
+    for (const tag of tags) {
+        if (!seen.has(tag)) {
+            seen.add(tag);
+            result.push(tag);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=composer.js.map

package/dist/registry/composer.js.map

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

package/dist/registry/loader.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Template registry loader.
+ *
+ * Loads YAML template files from the templates/ directory (shipped with the package)
+ * and merges with any user overrides from .forgecraft.json.
+ */
+import type { Tag, TagTemplateSet, ForgeCraftConfig } from "../shared/types.js";
+/**
+ * Resolve the templates directory path.
+ * Uses FORGECRAFT_TEMPLATE_DIR env var if set, otherwise the package's built-in templates.
+ */
+export declare function resolveTemplatesDir(): string;
+/**
+ * Load all template sets from the templates directory.
+ * Returns a map of tag → TagTemplateSet.
+ */
+export declare function loadAllTemplates(templatesDir?: string): Map<Tag, TagTemplateSet>;
+/**
+ * Convert a Tag to its directory name.
+ */
+export declare function tagToDirName(tag: Tag): string;
+/**
+ * Load user overrides from forgecraft.yaml or .forgecraft.json in the project directory.
+ * Prefers forgecraft.yaml over .forgecraft.json.
+ * Returns null if no config file exists.
+ */
+export declare function loadUserOverrides(projectDir: string): ForgeCraftConfig | null;
+/**
+ * Load templates from multiple directories and merge them.
+ * Later directories override earlier ones (community/local override built-in).
+ *
+ * @param builtInDir - The built-in templates directory
+ * @param extraDirs - Additional template directories from config
+ * @returns Merged map of tag → TagTemplateSet
+ */
+export declare function loadAllTemplatesWithExtras(builtInDir?: string, extraDirs?: string[]): Map<Tag, TagTemplateSet>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/registry/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/registry/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EACV,GAAG,EACH,cAAc,EAMd,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAW5B;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAuB5C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,CAAC,EAAE,MAAM,GACpB,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CA0B1B;AA8FD;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,GACjB,gBAAgB,GAAG,IAAI,CA4BzB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CAuC1B"}

package/dist/registry/loader.js

@@ -0,0 +1,278 @@
+/**
+ * Template registry loader.
+ *
+ * Loads YAML template files from the templates/ directory (shipped with the package)
+ * and merges with any user overrides from .forgecraft.json.
+ */
+import { readFileSync, readdirSync, existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import yaml from "js-yaml";
+import { createLogger } from "../shared/logger/index.js";
+import { TemplateNotFoundError, TemplateParseError } from "../shared/errors/index.js";
+const logger = createLogger("registry/loader");
+/**
+ * Resolve the templates directory path.
+ * Uses FORGECRAFT_TEMPLATE_DIR env var if set, otherwise the package's built-in templates.
+ */
+export function resolveTemplatesDir() {
+    const envDir = process.env["FORGECRAFT_TEMPLATE_DIR"];
+    if (envDir && existsSync(envDir)) {
+        return resolve(envDir);
+    }
+    // Resolve relative to this file's location in the package
+    const thisDir = fileURLToPath(new URL(".", import.meta.url));
+    // In dist/registry/loader.js → go up 2 levels to package root, then templates/
+    const packageRoot = resolve(thisDir, "..", "..");
+    const templatesDir = join(packageRoot, "templates");
+    if (existsSync(templatesDir)) {
+        return templatesDir;
+    }
+    // Fallback: maybe we're running from src/ during development
+    const devTemplatesDir = join(packageRoot, "..", "templates");
+    if (existsSync(devTemplatesDir)) {
+        return devTemplatesDir;
+    }
+    throw new TemplateNotFoundError("templates", "Could not locate templates directory");
+}
+/**
+ * Load all template sets from the templates directory.
+ * Returns a map of tag → TagTemplateSet.
+ */
+export function loadAllTemplates(templatesDir) {
+    const dir = templatesDir ?? resolveTemplatesDir();
+    const result = new Map();
+    const tagDirs = readdirSync(dir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name);
+    for (const tagDirName of tagDirs) {
+        const tag = tagDirNameToTag(tagDirName);
+        if (!tag) {
+            logger.warn("Unknown tag directory, skipping", { dir: tagDirName });
+            continue;
+        }
+        const tagDir = join(dir, tagDirName);
+        const templateSet = loadTagTemplateSet(tag, tagDir);
+        result.set(tag, templateSet);
+    }
+    logger.info("Templates loaded", {
+        tagCount: result.size,
+        tags: Array.from(result.keys()),
+    });
+    return result;
+}
+/**
+ * Load a single tag's template set from its directory.
+ */
+function loadTagTemplateSet(tag, tagDir) {
+    let claudeMd;
+    let nfr;
+    let structure;
+    let hooks;
+    let review;
+    // Load claude-md.yaml
+    const claudeMdPath = join(tagDir, "claude-md.yaml");
+    if (existsSync(claudeMdPath)) {
+        claudeMd = loadYamlFile(claudeMdPath);
+    }
+    // Load nfr.yaml
+    const nfrPath = join(tagDir, "nfr.yaml");
+    if (existsSync(nfrPath)) {
+        nfr = loadYamlFile(nfrPath);
+    }
+    // Load structure.yaml
+    const structurePath = join(tagDir, "structure.yaml");
+    if (existsSync(structurePath)) {
+        structure = loadYamlFile(structurePath);
+    }
+    // Load hooks.yaml
+    const hooksPath = join(tagDir, "hooks.yaml");
+    if (existsSync(hooksPath)) {
+        const hooksFile = loadYamlFile(hooksPath);
+        hooks = hooksFile.hooks;
+    }
+    // Load review.yaml
+    const reviewPath = join(tagDir, "review.yaml");
+    if (existsSync(reviewPath)) {
+        review = loadYamlFile(reviewPath);
+    }
+    return { tag, claudeMd, nfr, structure, hooks, review };
+}
+/**
+ * Load and parse a single YAML template file.
+ */
+function loadYamlFile(filePath) {
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        const parsed = yaml.load(content);
+        if (!parsed) {
+            throw new TemplateParseError(filePath, "YAML parsed to null/undefined");
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error instanceof TemplateParseError) {
+            throw error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new TemplateParseError(filePath, message);
+    }
+}
+/**
+ * Convert a directory name to a Tag enum value.
+ * Directory names use lowercase-kebab (e.g., "web-react"), tags use UPPER-KEBAB.
+ */
+function tagDirNameToTag(dirName) {
+    const mapping = {
+        universal: "UNIVERSAL",
+        "web-react": "WEB-REACT",
+        "web-static": "WEB-STATIC",
+        api: "API",
+        "data-pipeline": "DATA-PIPELINE",
+        ml: "ML",
+        healthcare: "HEALTHCARE",
+        fintech: "FINTECH",
+        web3: "WEB3",
+        realtime: "REALTIME",
+        "state-machine": "STATE-MACHINE",
+        game: "GAME",
+        social: "SOCIAL",
+        cli: "CLI",
+        library: "LIBRARY",
+        infra: "INFRA",
+        mobile: "MOBILE",
+        analytics: "ANALYTICS",
+    };
+    return mapping[dirName] ?? null;
+}
+/**
+ * Convert a Tag to its directory name.
+ */
+export function tagToDirName(tag) {
+    return tag.toLowerCase();
+}
+/**
+ * Load user overrides from forgecraft.yaml or .forgecraft.json in the project directory.
+ * Prefers forgecraft.yaml over .forgecraft.json.
+ * Returns null if no config file exists.
+ */
+export function loadUserOverrides(projectDir) {
+    // Prefer YAML config
+    const yamlPath = join(projectDir, "forgecraft.yaml");
+    if (existsSync(yamlPath)) {
+        try {
+            const content = readFileSync(yamlPath, "utf-8");
+            return yaml.load(content);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.warn("Failed to parse forgecraft.yaml", { error: message });
+            return null;
+        }
+    }
+    // Fallback to JSON config
+    const configPath = join(projectDir, ".forgecraft.json");
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(configPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warn("Failed to parse .forgecraft.json", { error: message });
+        return null;
+    }
+}
+/**
+ * Load templates from multiple directories and merge them.
+ * Later directories override earlier ones (community/local override built-in).
+ *
+ * @param builtInDir - The built-in templates directory
+ * @param extraDirs - Additional template directories from config
+ * @returns Merged map of tag → TagTemplateSet
+ */
+export function loadAllTemplatesWithExtras(builtInDir, extraDirs) {
+    const base = loadAllTemplates(builtInDir);
+    if (!extraDirs || extraDirs.length === 0) {
+        return base;
+    }
+    for (const dir of extraDirs) {
+        const resolvedDir = resolve(dir);
+        if (!existsSync(resolvedDir)) {
+            logger.warn("Community template directory not found, skipping", { dir: resolvedDir });
+            continue;
+        }
+        logger.info("Loading community templates", { dir: resolvedDir });
+        const extra = loadAllTemplates(resolvedDir);
+        // Merge: extra templates extend base templates (additive for blocks)
+        for (const [tag, extraSet] of extra) {
+            const baseSet = base.get(tag);
+            if (!baseSet) {
+                base.set(tag, extraSet);
+                continue;
+            }
+            // Merge each template section additively
+            const merged = {
+                tag,
+                claudeMd: mergeClaudeMdTemplates(baseSet.claudeMd, extraSet.claudeMd),
+                nfr: mergeNfrTemplates(baseSet.nfr, extraSet.nfr),
+                structure: extraSet.structure ?? baseSet.structure,
+                hooks: mergeHookTemplates(baseSet.hooks, extraSet.hooks),
+                review: mergeReviewTemplates(baseSet.review, extraSet.review),
+            };
+            base.set(tag, merged);
+        }
+    }
+    return base;
+}
+/**
+ * Merge two ClaudeMdTemplates, appending non-duplicate blocks from the extra template.
+ */
+function mergeClaudeMdTemplates(base, extra) {
+    if (!extra)
+        return base;
+    if (!base)
+        return extra;
+    const seenIds = new Set(base.blocks.map((b) => b.id));
+    const newBlocks = extra.blocks.filter((b) => !seenIds.has(b.id));
+    return { ...base, blocks: [...base.blocks, ...newBlocks] };
+}
+/**
+ * Merge two NfrTemplates, appending non-duplicate blocks.
+ */
+function mergeNfrTemplates(base, extra) {
+    if (!extra)
+        return base;
+    if (!base)
+        return extra;
+    const seenIds = new Set(base.blocks.map((b) => b.id));
+    const newBlocks = extra.blocks.filter((b) => !seenIds.has(b.id));
+    return { ...base, blocks: [...base.blocks, ...newBlocks] };
+}
+/**
+ * Merge two hook template arrays, appending non-duplicate hooks.
+ */
+function mergeHookTemplates(base, extra) {
+    if (!extra)
+        return base;
+    if (!base)
+        return extra;
+    const seenNames = new Set(base.map((h) => h.name));
+    const newHooks = extra.filter((h) => !seenNames.has(h.name));
+    return [...base, ...newHooks];
+}
+/**
+ * Merge two ReviewTemplates, appending non-duplicate blocks.
+ */
+function mergeReviewTemplates(base, extra) {
+    if (!extra)
+        return base;
+    if (!base)
+        return extra;
+    const seenIds = new Set(base.blocks.map((b) => b.id));
+    const newBlocks = extra.blocks.filter((b) => !seenIds.has(b.id));
+    return { ...base, blocks: [...base.blocks, ...newBlocks] };
+}
+//# sourceMappingURL=loader.js.map

package/dist/registry/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/registry/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAYtF,MAAM,MAAM,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;AAS/C;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACtD,IAAI,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IAED,0DAA0D;IAC1D,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D,+EAA+E;IAC/E,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAEpD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,6DAA6D;IAC7D,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAC7D,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,MAAM,IAAI,qBAAqB,CAAC,WAAW,EAAE,sCAAsC,CAAC,CAAC;AACvF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,YAAqB;IAErB,MAAM,GAAG,GAAG,YAAY,IAAI,mBAAmB,EAAE,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE9C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACtD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;SACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE9B,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;YACpE,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACrC,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE;QAC9B,QAAQ,EAAE,MAAM,CAAC,IAAI;QACrB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;KAChC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,GAAQ,EAAE,MAAc;IAClD,IAAI,QAAsC,CAAC;IAC3C,IAAI,GAA4B,CAAC;IACjC,IAAI,SAAwC,CAAC;IAC7C,IAAI,KAAiC,CAAC;IACtC,IAAI,MAAkC,CAAC;IAEvC,sBAAsB;IACtB,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,QAAQ,GAAG,YAAY,CAAmB,YAAY,CAAC,CAAC;IAC1D,CAAC;IAED,gBAAgB;IAChB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,GAAG,GAAG,YAAY,CAAc,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,sBAAsB;IACtB,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACrD,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,SAAS,GAAG,YAAY,CAAoB,aAAa,CAAC,CAAC;IAC7D,CAAC;IAED,kBAAkB;IAClB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,YAAY,CAAgB,SAAS,CAAC,CAAC;QACzD,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,mBAAmB;IACnB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC/C,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,YAAY,CAAiB,UAAU,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAI,QAAgB;IACvC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAM,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,kBAAkB,CAAC,QAAQ,EAAE,+BAA+B,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;YACxC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,OAAO,GAAwB;QACnC,SAAS,EAAE,WAAW;QACtB,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,YAAY;QAC1B,GAAG,EAAE,KAAK;QACV,eAAe,EAAE,eAAe;QAChC,EAAE,EAAE,IAAI;QACR,UAAU,EAAE,YAAY;QACxB,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,UAAU;QACpB,eAAe,EAAE,eAAe;QAChC,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,QAAQ;QAChB,GAAG,EAAE,KAAK;QACV,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,QAAQ;QAChB,SAAS,EAAE,WAAW;KACvB,CAAC;IACF,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAQ;IACnC,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAkB;IAElB,qBAAqB;IACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IACrD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAqB,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACnE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqB,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAmB,EACnB,SAAoB;IAEpB,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAE1C,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,kDAAkD,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;YACtF,SAAS;QACX,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAE5C,qEAAqE;QACrE,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,yCAAyC;YACzC,MAAM,MAAM,GAAmB;gBAC7B,GAAG;gBACH,QAAQ,EAAE,sBAAsB,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;gBACrE,GAAG,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC;gBACjD,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS;gBAClD,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC;gBACxD,MAAM,EAAE,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;aAC9D,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAC7B,IAAkC,EAClC,KAAmC;IAEnC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjE,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,IAA6B,EAC7B,KAA8B;IAE9B,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjE,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CACzB,IAAgC,EAChC,KAAiC;IAEjC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAC3B,IAAgC,EAChC,KAAiC;IAEjC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjE,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;AAC7D,CAAC"}

package/dist/registry/renderer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Template renderer.
+ *
+ * Renders composed template content with project-specific variable substitution.
+ * Handles {{variable}} and {{variable | default: value}} syntax.
+ */
+import type { ClaudeMdBlock, NfrBlock, ReviewBlock, Tag } from "../shared/types.js";
+/** Variables available for template rendering. */
+export interface RenderContext {
+    readonly projectName: string;
+    readonly language: string;
+    readonly framework?: string;
+    readonly domain?: string;
+    readonly repoUrl?: string;
+    readonly sensitiveData?: string;
+    readonly tags: Tag[];
+    readonly [key: string]: unknown;
+}
+/**
+ * Render a CLAUDE.md from composed blocks and project context.
+ * Returns the full CLAUDE.md content as a string.
+ */
+export declare function renderClaudeMd(blocks: ClaudeMdBlock[], context: RenderContext): string;
+/**
+ * Render NFR sections from composed blocks.
+ */
+export declare function renderNfrs(blocks: NfrBlock[], context: RenderContext): string;
+/**
+ * Render review checklist blocks grouped by dimension.
+ *
+ * @param blocks - Composed review blocks from all active tags.
+ * @param scope  - "comprehensive" renders all items; "focused" limits to critical items.
+ * @returns Formatted markdown review checklist.
+ */
+export declare function renderReviewChecklist(blocks: ReviewBlock[], scope: "comprehensive" | "focused"): string;
+/**
+ * Render a Status.md skeleton with project info.
+ */
+export declare function renderStatusMd(context: RenderContext): string;
+/**
+ * Render a PRD skeleton.
+ */
+export declare function renderPrdSkeleton(context: RenderContext): string;
+/**
+ * Render a Tech Spec skeleton.
+ */
+export declare function renderTechSpecSkeleton(context: RenderContext): string;
+/**
+ * Render a template string by substituting {{variable}} placeholders.
+ * Supports {{variable | default: value}} syntax.
+ */
+export declare function renderTemplate(template: string, context: RenderContext): string;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/registry/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/registry/renderer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAmB,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAIrG,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IACrB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,EAAE,aAAa,GACrB,MAAM,CAUR;AA0BD;;GAEG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,QAAQ,EAAE,EAClB,OAAO,EAAE,aAAa,GACrB,MAAM,CAQR;AAkBD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,eAAe,GAAG,SAAS,GACjC,MAAM,CAuDR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAsC7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CA6BhE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CA+BrE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,GACrB,MAAM,CA2BR"}