@zigrivers/scaffold 2.1.0

package/dist/core/assembly/instruction-loader.test.js

@@ -0,0 +1,109 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { loadInstructions } from './instruction-loader.js';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+let tmpDir;
+let instructionsDir;
+beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'instruction-loader-test-'));
+    instructionsDir = path.join(tmpDir, '.scaffold', 'instructions');
+    fs.mkdirSync(instructionsDir, { recursive: true });
+});
+afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+});
+describe('loadInstructions', () => {
+    it('loads global.md when present', () => {
+        fs.writeFileSync(path.join(instructionsDir, 'global.md'), '# Global instructions', 'utf8');
+        const { instructions } = loadInstructions(tmpDir, 'create-prd');
+        expect(instructions.global).toBe('# Global instructions');
+    });
+    it('loads <step>.md when present', () => {
+        fs.writeFileSync(path.join(instructionsDir, 'create-prd.md'), '# Step instructions', 'utf8');
+        const { instructions } = loadInstructions(tmpDir, 'create-prd');
+        expect(instructions.perStep).toBe('# Step instructions');
+    });
+    it('accepts inline instructions string', () => {
+        const { instructions } = loadInstructions(tmpDir, 'create-prd', 'Focus on mobile');
+        expect(instructions.inline).toBe('Focus on mobile');
+    });
+    it('returns null for global when global.md missing (no error)', () => {
+        // No global.md created
+        const { instructions, warnings } = loadInstructions(tmpDir, 'create-prd');
+        expect(instructions.global).toBeNull();
+        expect(warnings.filter(w => w.code !== 'ASM_INSTRUCTION_EMPTY')).toHaveLength(0);
+    });
+    it('returns null for perStep when step file missing (no error)', () => {
+        // No create-prd.md created
+        const { instructions } = loadInstructions(tmpDir, 'create-prd');
+        expect(instructions.perStep).toBeNull();
+    });
+    it('silently skips missing files (no error for absent global.md)', () => {
+        // No files at all
+        const { instructions, warnings } = loadInstructions(tmpDir, 'review-prd');
+        expect(instructions.global).toBeNull();
+        expect(instructions.perStep).toBeNull();
+        expect(instructions.inline).toBeNull();
+        // No warnings for missing files (only for empty files)
+        expect(warnings).toHaveLength(0);
+    });
+    it('warns on empty instruction file (ASM_INSTRUCTION_EMPTY)', () => {
+        fs.writeFileSync(path.join(instructionsDir, 'global.md'), '', 'utf8');
+        const { instructions, warnings } = loadInstructions(tmpDir, 'create-prd');
+        expect(instructions.global).toBeNull();
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].code).toBe('ASM_INSTRUCTION_EMPTY');
+        expect(warnings[0].message).toContain('global');
+    });
+    it('returns all three layers separately (for display with provenance)', () => {
+        fs.writeFileSync(path.join(instructionsDir, 'global.md'), 'Global rule', 'utf8');
+        fs.writeFileSync(path.join(instructionsDir, 'create-prd.md'), 'Step rule', 'utf8');
+        const { instructions } = loadInstructions(tmpDir, 'create-prd', 'Inline rule');
+        expect(instructions.global).toBe('Global rule');
+        expect(instructions.perStep).toBe('Step rule');
+        expect(instructions.inline).toBe('Inline rule');
+        // All three are distinct strings — not merged
+        expect(instructions.global).not.toBe(instructions.perStep);
+        expect(instructions.perStep).not.toBe(instructions.inline);
+    });
+    it('returns null for inline when inline is undefined', () => {
+        const { instructions } = loadInstructions(tmpDir, 'create-prd', undefined);
+        expect(instructions.inline).toBeNull();
+    });
+    it('returns null for inline when inline is empty string', () => {
+        const { instructions } = loadInstructions(tmpDir, 'create-prd', '');
+        expect(instructions.inline).toBeNull();
+    });
+    it('returns null for inline when inline is whitespace only', () => {
+        const { instructions } = loadInstructions(tmpDir, 'create-prd', '   ');
+        expect(instructions.inline).toBeNull();
+    });
+    it('warns on empty per-step instruction file (ASM_INSTRUCTION_EMPTY)', () => {
+        fs.writeFileSync(path.join(instructionsDir, 'create-prd.md'), '  \n  ', 'utf8');
+        const { instructions, warnings } = loadInstructions(tmpDir, 'create-prd');
+        expect(instructions.perStep).toBeNull();
+        expect(warnings.some(w => w.code === 'ASM_INSTRUCTION_EMPTY')).toBe(true);
+        const warn = warnings.find(w => w.code === 'ASM_INSTRUCTION_EMPTY');
+        expect(warn?.message).toContain('create-prd');
+    });
+    it('trims whitespace from loaded instruction content', () => {
+        fs.writeFileSync(path.join(instructionsDir, 'global.md'), '  \n# Instructions\n  ', 'utf8');
+        const { instructions } = loadInstructions(tmpDir, 'create-prd');
+        expect(instructions.global).toBe('# Instructions');
+    });
+    it('returns warnings array for all empty files found', () => {
+        fs.writeFileSync(path.join(instructionsDir, 'global.md'), '', 'utf8');
+        fs.writeFileSync(path.join(instructionsDir, 'create-prd.md'), '', 'utf8');
+        const { warnings } = loadInstructions(tmpDir, 'create-prd');
+        expect(warnings.filter(w => w.code === 'ASM_INSTRUCTION_EMPTY')).toHaveLength(2);
+    });
+    it('includes file path in warning context', () => {
+        const emptyFile = path.join(instructionsDir, 'global.md');
+        fs.writeFileSync(emptyFile, '', 'utf8');
+        const { warnings } = loadInstructions(tmpDir, 'create-prd');
+        const warn = warnings.find(w => w.code === 'ASM_INSTRUCTION_EMPTY');
+        expect(warn?.context?.file).toBe(emptyFile);
+    });
+});
+//# sourceMappingURL=instruction-loader.test.js.map

package/dist/core/assembly/instruction-loader.test.js.map

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

package/dist/core/assembly/knowledge-loader.d.ts

@@ -0,0 +1,34 @@
+import type { KnowledgeEntry } from '../../types/index.js';
+import type { ScaffoldWarning } from '../../types/index.js';
+interface KBFrontmatter {
+    name: string;
+    description: string;
+    topics: string[];
+}
+/**
+ * Extract and parse YAML frontmatter from knowledge base file content.
+ * Returns null if frontmatter is missing or has no name field.
+ */
+export declare function extractKBFrontmatter(content: string): KBFrontmatter | null;
+/**
+ * Scan knowledgeDir recursively for .md files.
+ * Returns a map of entry name → absolute file path.
+ * Gracefully returns an empty map if the directory does not exist.
+ */
+export declare function buildIndex(knowledgeDir: string): Map<string, string>;
+/**
+ * Like buildIndex(), but checks <projectRoot>/.scaffold/knowledge/ first.
+ * Local overrides take precedence over global entries by the same name.
+ * Emits a stderr warning for duplicate names within the local override dir.
+ */
+export declare function buildIndexWithOverrides(projectRoot: string, globalKnowledgeDir: string): Map<string, string>;
+/**
+ * Load the named knowledge base entries from the index.
+ * Missing entries produce FRONTMATTER_KB_ENTRY_MISSING warnings (non-fatal).
+ */
+export declare function loadEntries(index: Map<string, string>, names: string[]): {
+    entries: KnowledgeEntry[];
+    warnings: ScaffoldWarning[];
+};
+export {};
+//# sourceMappingURL=knowledge-loader.d.ts.map

package/dist/core/assembly/knowledge-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-loader.d.ts","sourceRoot":"","sources":["../../../src/core/assembly/knowledge-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAM3D,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA6C1E;AA2BD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAiCpE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,GACzB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAgDrB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,KAAK,EAAE,MAAM,EAAE,GACd;IAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IAAC,QAAQ,EAAE,eAAe,EAAE,CAAA;CAAE,CA+C5D"}

package/dist/core/assembly/knowledge-loader.js

@@ -0,0 +1,204 @@
+import { fileExists } from '../../utils/fs.js';
+import yaml from 'js-yaml';
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Extract and parse YAML frontmatter from knowledge base file content.
+ * Returns null if frontmatter is missing or has no name field.
+ */
+export function extractKBFrontmatter(content) {
+    const lines = content.split('\n');
+    if (lines[0]?.trim() !== '---') {
+        return null;
+    }
+    let closeIdx = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === '---') {
+            closeIdx = i;
+            break;
+        }
+    }
+    if (closeIdx === -1) {
+        return null;
+    }
+    const yamlText = lines.slice(1, closeIdx).join('\n');
+    let parsed;
+    try {
+        parsed = yaml.load(yamlText);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        return null;
+    }
+    const obj = parsed;
+    if (typeof obj['name'] !== 'string' || obj['name'].trim() === '') {
+        return null;
+    }
+    return {
+        name: obj['name'].trim(),
+        description: typeof obj['description'] === 'string' ? obj['description'].trim() : '',
+        topics: Array.isArray(obj['topics'])
+            ? obj['topics'].filter((t) => typeof t === 'string')
+            : [],
+    };
+}
+/**
+ * Extract the body content after the closing frontmatter delimiter.
+ */
+function extractBody(content) {
+    const lines = content.split('\n');
+    if (lines[0]?.trim() !== '---') {
+        return content;
+    }
+    let closeIdx = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === '---') {
+            closeIdx = i;
+            break;
+        }
+    }
+    if (closeIdx === -1) {
+        return '';
+    }
+    return lines.slice(closeIdx + 1).join('\n').trim();
+}
+/**
+ * Scan knowledgeDir recursively for .md files.
+ * Returns a map of entry name → absolute file path.
+ * Gracefully returns an empty map if the directory does not exist.
+ */
+export function buildIndex(knowledgeDir) {
+    const index = new Map();
+    if (!fileExists(knowledgeDir))
+        return index;
+    function walkDir(dir) {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walkDir(fullPath);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.md')) {
+                try {
+                    const content = fs.readFileSync(fullPath, 'utf8');
+                    const fm = extractKBFrontmatter(content);
+                    if (fm?.name) {
+                        index.set(fm.name, fullPath);
+                    }
+                }
+                catch {
+                    // skip invalid files
+                }
+            }
+        }
+    }
+    walkDir(knowledgeDir);
+    return index;
+}
+/**
+ * Like buildIndex(), but checks <projectRoot>/.scaffold/knowledge/ first.
+ * Local overrides take precedence over global entries by the same name.
+ * Emits a stderr warning for duplicate names within the local override dir.
+ */
+export function buildIndexWithOverrides(projectRoot, globalKnowledgeDir) {
+    // Build global index first (lower precedence)
+    const globalIndex = buildIndex(globalKnowledgeDir);
+    // Build local override index
+    const localDir = path.join(projectRoot, '.scaffold', 'knowledge');
+    const localIndex = new Map();
+    function walkLocal(dir) {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walkLocal(fullPath);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.md')) {
+                try {
+                    const content = fs.readFileSync(fullPath, 'utf8');
+                    const fm = extractKBFrontmatter(content);
+                    if (fm?.name) {
+                        if (localIndex.has(fm.name)) {
+                            process.stderr.write(`warn: duplicate knowledge override name "${fm.name}" in ${localDir} — using last found\n`);
+                        }
+                        localIndex.set(fm.name, fullPath);
+                    }
+                }
+                catch {
+                    // skip invalid files
+                }
+            }
+        }
+    }
+    if (fileExists(localDir)) {
+        walkLocal(localDir);
+    }
+    // Merge: local overrides win
+    const merged = new Map(globalIndex);
+    for (const [name, filePath] of localIndex) {
+        merged.set(name, filePath);
+    }
+    return merged;
+}
+/**
+ * Load the named knowledge base entries from the index.
+ * Missing entries produce FRONTMATTER_KB_ENTRY_MISSING warnings (non-fatal).
+ */
+export function loadEntries(index, names) {
+    const entries = [];
+    const warnings = [];
+    for (const name of names) {
+        const filePath = index.get(name);
+        if (!filePath) {
+            warnings.push({
+                code: 'FRONTMATTER_KB_ENTRY_MISSING',
+                message: `Knowledge base entry "${name}" not found in index`,
+                context: { name },
+            });
+            continue;
+        }
+        try {
+            const content = fs.readFileSync(filePath, 'utf8');
+            const fm = extractKBFrontmatter(content);
+            if (!fm) {
+                warnings.push({
+                    code: 'FRONTMATTER_KB_ENTRY_MISSING',
+                    message: `Knowledge base entry "${name}" has invalid frontmatter`,
+                    context: { name, file: filePath },
+                });
+                continue;
+            }
+            const body = extractBody(content);
+            entries.push({
+                name: fm.name,
+                description: fm.description,
+                topics: fm.topics,
+                content: body,
+            });
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            warnings.push({
+                code: 'FRONTMATTER_KB_ENTRY_MISSING',
+                message: `Failed to load knowledge base entry "${name}": ${detail}`,
+                context: { name, file: filePath },
+            });
+        }
+    }
+    return { entries, warnings };
+}
+//# sourceMappingURL=knowledge-loader.js.map

package/dist/core/assembly/knowledge-loader.js.map

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

package/dist/core/assembly/knowledge-loader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=knowledge-loader.test.d.ts.map

package/dist/core/assembly/knowledge-loader.test.d.ts.map

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

package/dist/core/assembly/knowledge-loader.test.js

@@ -0,0 +1,205 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { describe, it, expect, afterEach, beforeEach, vi } from 'vitest';
+import { buildIndex, buildIndexWithOverrides, loadEntries } from './knowledge-loader.js';
+const tmpDirs = [];
+function makeTmpDir() {
+    const d = path.join(os.tmpdir(), `scaffold-kbl-test-${crypto.randomUUID()}`);
+    fs.mkdirSync(d, { recursive: true });
+    tmpDirs.push(d);
+    return d;
+}
+function writeTmpFile(dir, name, content) {
+    const p = path.join(dir, name);
+    fs.writeFileSync(p, content, 'utf8');
+    return p;
+}
+afterEach(() => {
+    for (const d of tmpDirs) {
+        try {
+            fs.rmSync(d, { recursive: true, force: true });
+        }
+        catch { /* ignore */ }
+    }
+    tmpDirs.length = 0;
+});
+const prdCraftContent = `---
+name: prd-craft
+description: Best practices for writing effective PRDs
+topics:
+  - product
+  - requirements
+---
+
+This is the knowledge base content for PRD crafting.
+
+## Section One
+
+Details about section one.
+`;
+const gapAnalysisContent = `---
+name: gap-analysis
+description: Systematic approaches to finding gaps
+topics:
+  - analysis
+  - requirements
+---
+
+Gap analysis content here.
+`;
+describe('buildIndex', () => {
+    it('builds name → filepath index from directory scan', () => {
+        const dir = makeTmpDir();
+        const prdPath = writeTmpFile(dir, 'prd-craft.md', prdCraftContent);
+        const index = buildIndex(dir);
+        expect(index.size).toBe(1);
+        expect(index.has('prd-craft')).toBe(true);
+        expect(index.get('prd-craft')).toBe(prdPath);
+    });
+    it('scans subdirectories recursively', () => {
+        const dir = makeTmpDir();
+        const subDir = path.join(dir, 'product');
+        fs.mkdirSync(subDir);
+        writeTmpFile(dir, 'gap-analysis.md', gapAnalysisContent);
+        writeTmpFile(subDir, 'prd-craft.md', prdCraftContent);
+        const index = buildIndex(dir);
+        expect(index.size).toBe(2);
+        expect(index.has('gap-analysis')).toBe(true);
+        expect(index.has('prd-craft')).toBe(true);
+    });
+    it('returns empty map when directory does not exist', () => {
+        const index = buildIndex('/nonexistent/directory/xyz-abc');
+        expect(index.size).toBe(0);
+    });
+    it('skips files without valid frontmatter', () => {
+        const dir = makeTmpDir();
+        writeTmpFile(dir, 'prd-craft.md', prdCraftContent);
+        writeTmpFile(dir, 'no-frontmatter.md', 'Just plain markdown with no frontmatter');
+        writeTmpFile(dir, 'no-name.md', '---\ndescription: missing name\n---\n\nContent here.');
+        const index = buildIndex(dir);
+        expect(index.size).toBe(1);
+        expect(index.has('prd-craft')).toBe(true);
+    });
+    it('ignores non-.md files', () => {
+        const dir = makeTmpDir();
+        writeTmpFile(dir, 'prd-craft.md', prdCraftContent);
+        writeTmpFile(dir, 'readme.txt', 'Not a markdown file');
+        writeTmpFile(dir, 'config.yml', 'name: test');
+        const index = buildIndex(dir);
+        expect(index.size).toBe(1);
+        expect(index.has('prd-craft')).toBe(true);
+    });
+});
+describe('buildIndexWithOverrides', () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'scaffold-kb-test-'));
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true });
+    });
+    function writeEntry(dir, subPath, name, description = 'desc') {
+        const fullDir = path.join(dir, path.dirname(subPath));
+        fs.mkdirSync(fullDir, { recursive: true });
+        fs.writeFileSync(path.join(dir, subPath), `---\nname: ${name}\ndescription: ${description}\ntopics: []\n---\n# Body`);
+    }
+    it('returns global entry when no local override exists', () => {
+        const globalDir = path.join(tmpDir, 'knowledge');
+        writeEntry(globalDir, 'core/api-design.md', 'api-design', 'Global API design');
+        const index = buildIndexWithOverrides(tmpDir, globalDir);
+        expect(index.has('api-design')).toBe(true);
+        expect(index.get('api-design')).toContain('knowledge');
+        expect(index.get('api-design')).toContain('api-design.md');
+    });
+    it('local override wins over global entry', () => {
+        const globalDir = path.join(tmpDir, 'knowledge');
+        writeEntry(globalDir, 'core/api-design.md', 'api-design', 'Global');
+        const localDir = path.join(tmpDir, '.scaffold', 'knowledge');
+        writeEntry(localDir, 'api-design.md', 'api-design', 'Local override');
+        const index = buildIndexWithOverrides(tmpDir, globalDir);
+        expect(index.get('api-design')).toContain('.scaffold');
+    });
+    it('returns empty map when both dirs do not exist', () => {
+        const index = buildIndexWithOverrides(tmpDir, path.join(tmpDir, 'missing'));
+        expect(index.size).toBe(0);
+    });
+    it('includes global entries not overridden locally', () => {
+        const globalDir = path.join(tmpDir, 'knowledge');
+        writeEntry(globalDir, 'core/api-design.md', 'api-design');
+        writeEntry(globalDir, 'core/testing.md', 'testing-strategy');
+        const localDir = path.join(tmpDir, '.scaffold', 'knowledge');
+        writeEntry(localDir, 'api-design.md', 'api-design');
+        const index = buildIndexWithOverrides(tmpDir, globalDir);
+        expect(index.has('testing-strategy')).toBe(true);
+        expect(index.get('testing-strategy')).toContain('knowledge');
+    });
+    it('emits warning to stderr for duplicate names in local override dir', () => {
+        const globalDir = path.join(tmpDir, 'knowledge');
+        const localDir = path.join(tmpDir, '.scaffold', 'knowledge');
+        writeEntry(localDir, 'a/api-design.md', 'api-design', 'First');
+        writeEntry(localDir, 'b/api-design.md', 'api-design', 'Second');
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        buildIndexWithOverrides(tmpDir, globalDir);
+        expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining('api-design'));
+        stderrSpy.mockRestore();
+    });
+});
+describe('loadEntries', () => {
+    it('loads entries by name from index', () => {
+        const dir = makeTmpDir();
+        writeTmpFile(dir, 'prd-craft.md', prdCraftContent);
+        writeTmpFile(dir, 'gap-analysis.md', gapAnalysisContent);
+        const index = buildIndex(dir);
+        const { entries, warnings } = loadEntries(index, ['prd-craft', 'gap-analysis']);
+        expect(warnings).toHaveLength(0);
+        expect(entries).toHaveLength(2);
+        const prdEntry = entries.find(e => e.name === 'prd-craft');
+        expect(prdEntry).toBeDefined();
+        expect(prdEntry.name).toBe('prd-craft');
+        expect(prdEntry.description).toBe('Best practices for writing effective PRDs');
+        expect(prdEntry.topics).toEqual(['product', 'requirements']);
+        const gapEntry = entries.find(e => e.name === 'gap-analysis');
+        expect(gapEntry).toBeDefined();
+        expect(gapEntry.name).toBe('gap-analysis');
+    });
+    it('returns full content after frontmatter', () => {
+        const dir = makeTmpDir();
+        writeTmpFile(dir, 'prd-craft.md', prdCraftContent);
+        const index = buildIndex(dir);
+        const { entries } = loadEntries(index, ['prd-craft']);
+        expect(entries).toHaveLength(1);
+        const entry = entries[0];
+        expect(entry.content).toContain('This is the knowledge base content for PRD crafting');
+        expect(entry.content).toContain('Section One');
+        // Should not include the frontmatter delimiters
+        expect(entry.content).not.toContain('name: prd-craft');
+    });
+    it('returns warning for missing entry name', () => {
+        const dir = makeTmpDir();
+        writeTmpFile(dir, 'prd-craft.md', prdCraftContent);
+        const index = buildIndex(dir);
+        const { entries, warnings } = loadEntries(index, ['prd-craft', 'nonexistent-entry']);
+        expect(entries).toHaveLength(1);
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].code).toBe('FRONTMATTER_KB_ENTRY_MISSING');
+        expect(warnings[0].message).toContain('nonexistent-entry');
+    });
+    it('handles empty names list (returns empty entries)', () => {
+        const dir = makeTmpDir();
+        writeTmpFile(dir, 'prd-craft.md', prdCraftContent);
+        const index = buildIndex(dir);
+        const { entries, warnings } = loadEntries(index, []);
+        expect(entries).toHaveLength(0);
+        expect(warnings).toHaveLength(0);
+    });
+    it('returns all warnings for all missing entries', () => {
+        const index = new Map();
+        const { entries, warnings } = loadEntries(index, ['missing-a', 'missing-b']);
+        expect(entries).toHaveLength(0);
+        expect(warnings).toHaveLength(2);
+        expect(warnings.every(w => w.code === 'FRONTMATTER_KB_ENTRY_MISSING')).toBe(true);
+    });
+});
+//# sourceMappingURL=knowledge-loader.test.js.map

package/dist/core/assembly/knowledge-loader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-loader.test.js","sourceRoot":"","sources":["../../../src/core/assembly/knowledge-loader.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACxE,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExF,MAAM,OAAO,GAAa,EAAE,CAAA;AAE5B,SAAS,UAAU;IACjB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,qBAAqB,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IAC5E,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACf,OAAO,CAAC,CAAA;AACV,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,IAAY,EAAE,OAAe;IAC9D,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC9B,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IACpC,OAAO,CAAC,CAAA;AACV,CAAC;AAED,SAAS,CAAC,GAAG,EAAE;IACb,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC;YAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,CAAC,MAAM,GAAG,CAAC,CAAA;AACpB,CAAC,CAAC,CAAA;AAEF,MAAM,eAAe,GAAG;;;;;;;;;;;;;CAavB,CAAA;AAED,MAAM,kBAAkB,GAAG;;;;;;;;;CAS1B,CAAA;AAED,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG,UAAU,EAAE,CAAA;QACxB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,eAAe,CAAC,CAAA;QAElE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;QAE7B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACzC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,GAAG,GAAG,UAAU,EAAE,CAAA;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;QACxC,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAEpB,YAAY,CAAC,GAAG,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAA;QACxD,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,eAAe,CAAC,CAAA;QAErD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;QAE7B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,KAAK,GAAG,UAAU,CAAC,gCAAgC,CAAC,CAAA;QAC1D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,GAAG,GAAG,UAAU,EAAE,CAAA;QACxB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,eAAe,CAAC,CAAA;QAClD,YAAY,CAAC,GAAG,EAAE,mBAAmB,EAAE,yCAAyC,CAAC,CAAA;QACjF,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,sDAAsD,CAAC,CAAA;QAEvF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;QAE7B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAA;QACxB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,eAAe,CAAC,CAAA;QAClD,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,qBAAqB,CAAC,CAAA;QACtD,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,YAAY,CAAC,CAAA;QAE7C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;QAE7B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,IAAI,MAAc,CAAA;IAElB,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAA;IACtE,CAAC,CAAC,CAAA;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,SAAS,UAAU,CAAC,GAAW,EAAE,OAAe,EAAE,IAAY,EAAE,WAAW,GAAG,MAAM;QAClF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;QACrD,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,IAAI,kBAAkB,WAAW,2BAA2B,CAAC,CAAA;IACvH,CAAC;IAED,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;QAChD,UAAU,CAAC,SAAS,EAAE,oBAAoB,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAA;QAC9E,MAAM,KAAK,GAAG,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QACxD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;QACtD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;QAChD,UAAU,CAAC,SAAS,EAAE,oBAAoB,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAA;QACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;QAC5D,UAAU,CAAC,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAA;QACrE,MAAM,KAAK,GAAG,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QACxD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,KAAK,GAAG,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;QAC3E,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;QAChD,UAAU,CAAC,SAAS,EAAE,oBAAoB,EAAE,YAAY,CAAC,CAAA;QACzD,UAAU,CAAC,SAAS,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAA;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;QAC5D,UAAU,CAAC,QAAQ,EAAE,eAAe,EAAE,YAAY,CAAC,CAAA;QACnD,MAAM,KAAK,GAAG,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QACxD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;QAC5D,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,YAAY,EAAE,OAAO,CAAC,CAAA;QAC9D,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAA;QAC/D,MAAM,SAAS,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QAClF,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QAC1C,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAA;QAC7E,SAAS,CAAC,WAAW,EAAE,CAAA;IACzB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,GAAG,GAAG,UAAU,EAAE,CAAA;QACxB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,eAAe,CAAC,CAAA;QAClD,YAAY,CAAC,GAAG,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAA;QAExD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;QAC7B,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAA;QAE/E,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAE/B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAA;QAC1D,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;QAC9B,MAAM,CAAC,QAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACxC,MAAM,CAAC,QAAS,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAA;QAC/E,MAAM,CAAC,QAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAA;QAE7D,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,CAAA;QAC7D,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;QAC9B,MAAM,CAAC,QAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAA;QACxB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,eAAe,CAAC,CAAA;QAElD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;QAC7B,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,CAAC,CAAA;QAErD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;QACxB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,qDAAqD,CAAC,CAAA;QACtF,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAA;QAC9C,gDAAgD;QAChD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAA;QACxB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,eAAe,CAAC,CAAA;QAElD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;QAC7B,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC,CAAA;QAEpF,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA;QAC7D,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG,UAAU,EAAE,CAAA;QACxB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,eAAe,CAAC,CAAA;QAElD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;QAC7B,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QAEpD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;QACvC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAA;QAE5E,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAChC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,8BAA8B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnF,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/core/assembly/meta-prompt-loader.d.ts

@@ -0,0 +1,13 @@
+import type { MetaPromptFile } from '../../types/index.js';
+/**
+ * Load and parse a single meta-prompt file.
+ * Throws on missing file or invalid frontmatter.
+ */
+export declare function loadMetaPrompt(filePath: string): MetaPromptFile;
+/**
+ * Scan pipelineDir recursively for all .md files.
+ * Returns a map of frontmatter.name → MetaPromptFile.
+ * Files that fail to load are skipped with a warning.
+ */
+export declare function discoverMetaPrompts(pipelineDir: string): Map<string, MetaPromptFile>;
+//# sourceMappingURL=meta-prompt-loader.d.ts.map

package/dist/core/assembly/meta-prompt-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-prompt-loader.d.ts","sourceRoot":"","sources":["../../../src/core/assembly/meta-prompt-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAmC1D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CA0B/D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CA+BpF"}