specky-sdd 1.0.0

package/dist/services/ears-validator.js.map

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

package/dist/services/file-manager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * FileManager — All disk I/O goes through here.
+ * Path sanitization, atomic writes, directory scanning.
+ */
+import type { DirectoryTree, FeatureInfo } from "../types.js";
+export declare class FileManager {
+    private readonly root;
+    constructor(workspaceRoot: string);
+    get workspaceRoot(): string;
+    /**
+     * Sanitize a relative path — rejects ".." traversal and absolute paths.
+     * Returns resolved absolute path within workspace.
+     */
+    sanitizePath(relativePath: string): string;
+    /**
+     * Ensure the spec directory exists, creating it if needed.
+     */
+    ensureSpecDir(specDir?: string): Promise<string>;
+    /**
+     * Write a spec file atomically (temp file + rename).
+     * Creates parent directories as needed.
+     * Refuses to overwrite unless force=true.
+     */
+    writeSpecFile(featureDir: string, fileName: string, content: string, force?: boolean): Promise<string>;
+    /**
+     * Read a spec file from a feature directory.
+     */
+    readSpecFile(featureDir: string, fileName: string): Promise<string>;
+    /**
+     * Check if a relative path exists.
+     */
+    fileExists(relativePath: string): Promise<boolean>;
+    /**
+     * List all files in a feature directory.
+     */
+    listSpecFiles(featureDir: string): Promise<string[]>;
+    /**
+     * List all feature directories in a spec dir.
+     */
+    listFeatures(specDir?: string): Promise<FeatureInfo[]>;
+    /**
+     * Scan a directory recursively up to a depth limit.
+     */
+    scanDirectory(dir?: string, depth?: number, exclude?: readonly string[]): Promise<DirectoryTree>;
+    /**
+     * Read a project file by relative path.
+     */
+    readProjectFile(relativePath: string): Promise<string>;
+    /**
+     * List files in a directory matching given extensions.
+     */
+    listFilesByExtension(dir: string, extensions: readonly string[]): Promise<string[]>;
+    private pathExists;
+    private scanRecursive;
+}
+//# sourceMappingURL=file-manager.d.ts.map

package/dist/services/file-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-manager.d.ts","sourceRoot":"","sources":["../../src/services/file-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE9D,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,aAAa,EAAE,MAAM;IAIjC,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;OAGG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAc1C;;OAEG;IACG,aAAa,CAAC,OAAO,GAAE,MAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxE;;;;OAIG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,MAAM,CAAC;IAiClB;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKzE;;OAEG;IACG,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxD;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAU1D;;OAEG;IACG,YAAY,CAAC,OAAO,GAAE,MAAyB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA4B9E;;OAEG;IACG,aAAa,CACjB,GAAG,GAAE,MAAY,EACjB,KAAK,GAAE,MAA2B,EAClC,OAAO,GAAE,SAAS,MAAM,EAA6B,GACpD,OAAO,CAAC,aAAa,CAAC;IAMzB;;OAEG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK5D;;OAEG;IACG,oBAAoB,CACxB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC;YAqBN,UAAU;YASV,aAAa;CAoC5B"}

package/dist/services/file-manager.js

@@ -0,0 +1,203 @@
+/**
+ * FileManager — All disk I/O goes through here.
+ * Path sanitization, atomic writes, directory scanning.
+ */
+import { mkdir, readFile, writeFile, readdir, stat, rename, access, unlink } from "node:fs/promises";
+import { join, resolve, relative, basename, dirname } from "node:path";
+import { randomUUID } from "node:crypto";
+import { DEFAULT_SPEC_DIR, DEFAULT_EXCLUDE_PATTERNS, DEFAULT_SCAN_DEPTH, MAX_SCAN_DEPTH } from "../constants.js";
+export class FileManager {
+    root;
+    constructor(workspaceRoot) {
+        this.root = resolve(workspaceRoot);
+    }
+    get workspaceRoot() {
+        return this.root;
+    }
+    /**
+     * Sanitize a relative path — rejects ".." traversal and absolute paths.
+     * Returns resolved absolute path within workspace.
+     */
+    sanitizePath(relativePath) {
+        if (relativePath.startsWith("/") || relativePath.startsWith("\\")) {
+            throw new Error(`Absolute paths are not allowed: ${relativePath}`);
+        }
+        if (relativePath.includes("..")) {
+            throw new Error(`Path traversal is not allowed: ${relativePath}`);
+        }
+        const resolved = resolve(this.root, relativePath);
+        if (!resolved.startsWith(this.root)) {
+            throw new Error(`Path escapes workspace root: ${relativePath}`);
+        }
+        return resolved;
+    }
+    /**
+     * Ensure the spec directory exists, creating it if needed.
+     */
+    async ensureSpecDir(specDir = DEFAULT_SPEC_DIR) {
+        const absPath = this.sanitizePath(specDir);
+        await mkdir(absPath, { recursive: true });
+        return absPath;
+    }
+    /**
+     * Write a spec file atomically (temp file + rename).
+     * Creates parent directories as needed.
+     * Refuses to overwrite unless force=true.
+     */
+    async writeSpecFile(featureDir, fileName, content, force = false) {
+        const absPath = this.sanitizePath(join(featureDir, fileName));
+        if (!force) {
+            const exists = await this.pathExists(absPath);
+            if (exists) {
+                throw new Error(`File already exists: ${relative(this.root, absPath)}. Use force: true to overwrite.`);
+            }
+        }
+        // Ensure parent directory exists
+        await mkdir(dirname(absPath), { recursive: true });
+        // Atomic write: write to temp, then rename
+        const tempPath = `${absPath}.${randomUUID()}.tmp`;
+        try {
+            await writeFile(tempPath, content, "utf-8");
+            await rename(tempPath, absPath);
+        }
+        catch (err) {
+            // Clean up temp file on failure
+            try {
+                await unlink(tempPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw err;
+        }
+        return absPath;
+    }
+    /**
+     * Read a spec file from a feature directory.
+     */
+    async readSpecFile(featureDir, fileName) {
+        const absPath = this.sanitizePath(join(featureDir, fileName));
+        return readFile(absPath, "utf-8");
+    }
+    /**
+     * Check if a relative path exists.
+     */
+    async fileExists(relativePath) {
+        const absPath = this.sanitizePath(relativePath);
+        return this.pathExists(absPath);
+    }
+    /**
+     * List all files in a feature directory.
+     */
+    async listSpecFiles(featureDir) {
+        const absPath = this.sanitizePath(featureDir);
+        try {
+            const entries = await readdir(absPath);
+            return entries.filter((e) => !e.startsWith("."));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * List all feature directories in a spec dir.
+     */
+    async listFeatures(specDir = DEFAULT_SPEC_DIR) {
+        const absPath = this.sanitizePath(specDir);
+        const features = [];
+        try {
+            const entries = await readdir(absPath, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory() && /^\d{3}-/.test(entry.name)) {
+                    const featureDir = join(specDir, entry.name);
+                    const match = entry.name.match(/^(\d{3})-(.+)$/);
+                    if (match) {
+                        const files = await this.listSpecFiles(featureDir);
+                        features.push({
+                            number: match[1],
+                            name: match[2],
+                            directory: featureDir,
+                            files,
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            // Spec dir doesn't exist yet
+        }
+        return features.sort((a, b) => a.number.localeCompare(b.number));
+    }
+    /**
+     * Scan a directory recursively up to a depth limit.
+     */
+    async scanDirectory(dir = ".", depth = DEFAULT_SCAN_DEPTH, exclude = DEFAULT_EXCLUDE_PATTERNS) {
+        const clampedDepth = Math.min(depth, MAX_SCAN_DEPTH);
+        const absPath = this.sanitizePath(dir);
+        return this.scanRecursive(absPath, basename(absPath) || ".", clampedDepth, exclude);
+    }
+    /**
+     * Read a project file by relative path.
+     */
+    async readProjectFile(relativePath) {
+        const absPath = this.sanitizePath(relativePath);
+        return readFile(absPath, "utf-8");
+    }
+    /**
+     * List files in a directory matching given extensions.
+     */
+    async listFilesByExtension(dir, extensions) {
+        const absPath = this.sanitizePath(dir);
+        try {
+            const entries = await readdir(absPath, { withFileTypes: true });
+            const matched = [];
+            for (const entry of entries) {
+                if (entry.isFile()) {
+                    const lower = entry.name.toLowerCase();
+                    if (extensions.some((ext) => lower.endsWith(ext))) {
+                        matched.push(join(dir, entry.name));
+                    }
+                }
+            }
+            return matched.sort();
+        }
+        catch {
+            return [];
+        }
+    }
+    // --- Private helpers ---
+    async pathExists(absPath) {
+        try {
+            await access(absPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async scanRecursive(absPath, name, depth, exclude) {
+        const stats = await stat(absPath);
+        if (!stats.isDirectory()) {
+            return { name, type: "file" };
+        }
+        if (depth <= 0) {
+            return { name, type: "directory" };
+        }
+        const entries = await readdir(absPath, { withFileTypes: true });
+        const children = [];
+        for (const entry of entries) {
+            if (exclude.includes(entry.name) || entry.name.startsWith(".")) {
+                continue;
+            }
+            const childPath = join(absPath, entry.name);
+            children.push(await this.scanRecursive(childPath, entry.name, depth - 1, exclude));
+        }
+        children.sort((a, b) => {
+            if (a.type !== b.type)
+                return a.type === "directory" ? -1 : 1;
+            return a.name.localeCompare(b.name);
+        });
+        return { name, type: "directory", children };
+    }
+}
+//# sourceMappingURL=file-manager.js.map

package/dist/services/file-manager.js.map

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

package/dist/services/state-machine.d.ts

@@ -0,0 +1,46 @@
+/**
+ * StateMachine — Phase tracking, transition validation, state persistence.
+ * State persists in .specs/.sdd-state.json.
+ */
+import { Phase } from "../constants.js";
+import type { SddState, TransitionResult } from "../types.js";
+import type { FileManager } from "./file-manager.js";
+export declare class StateMachine {
+    private fileManager;
+    constructor(fileManager: FileManager);
+    /**
+     * Load state from .sdd-state.json, or return a default "not initialized" state.
+     */
+    loadState(specDir?: string): Promise<SddState>;
+    /**
+     * Save state to .sdd-state.json.
+     */
+    saveState(specDir: string, state: SddState): Promise<void>;
+    /**
+     * Get current phase from persisted state.
+     */
+    getCurrentPhase(specDir?: string): Promise<Phase>;
+    /**
+     * Check if transition to target phase is allowed.
+     */
+    canTransition(specDir: string, targetPhase: Phase): Promise<TransitionResult>;
+    /**
+     * Advance to the next phase. Validates prerequisites first.
+     */
+    advancePhase(specDir: string, featureNumber: string): Promise<SddState>;
+    /**
+     * Record that a phase has started.
+     */
+    recordPhaseStart(specDir: string, phase: Phase): Promise<void>;
+    /**
+     * Record that a phase has completed.
+     */
+    recordPhaseComplete(specDir: string, phase: Phase): Promise<void>;
+    /** Get required files for a given phase */
+    getRequiredFiles(phase: Phase): string[];
+    /** Get phase order */
+    getPhaseOrder(): Phase[];
+    /** Create a fresh state object */
+    createDefaultState(projectName: string): SddState;
+}
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/services/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../src/services/state-machine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAmE,MAAM,iBAAiB,CAAC;AACzG,OAAO,KAAK,EAAE,QAAQ,EAAe,gBAAgB,EAAgB,MAAM,aAAa,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,qBAAa,YAAY;IACX,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAE5C;;OAEG;IACG,SAAS,CAAC,OAAO,GAAE,MAAyB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAUtE;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhE;;OAEG;IACG,eAAe,CAAC,OAAO,GAAE,MAAyB,GAAG,OAAO,CAAC,KAAK,CAAC;IAKzE;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmDnF;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiC7E;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvE,2CAA2C;IAC3C,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE;IAIxC,sBAAsB;IACtB,aAAa,IAAI,KAAK,EAAE;IAIxB,kCAAkC;IAClC,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ;CAelD"}

package/dist/services/state-machine.js

@@ -0,0 +1,167 @@
+/**
+ * StateMachine — Phase tracking, transition validation, state persistence.
+ * State persists in .specs/.sdd-state.json.
+ */
+import { Phase, PHASE_ORDER, PHASE_REQUIRED_FILES, STATE_FILE, DEFAULT_SPEC_DIR } from "../constants.js";
+import { join } from "node:path";
+export class StateMachine {
+    fileManager;
+    constructor(fileManager) {
+        this.fileManager = fileManager;
+    }
+    /**
+     * Load state from .sdd-state.json, or return a default "not initialized" state.
+     */
+    async loadState(specDir = DEFAULT_SPEC_DIR) {
+        const statePath = join(specDir, STATE_FILE);
+        try {
+            const raw = await this.fileManager.readProjectFile(statePath);
+            return JSON.parse(raw);
+        }
+        catch {
+            return this.createDefaultState("");
+        }
+    }
+    /**
+     * Save state to .sdd-state.json.
+     */
+    async saveState(specDir, state) {
+        const statePath = join(specDir, STATE_FILE);
+        await this.fileManager.writeSpecFile(specDir, STATE_FILE, JSON.stringify(state, null, 2), true // always overwrite state file
+        );
+    }
+    /**
+     * Get current phase from persisted state.
+     */
+    async getCurrentPhase(specDir = DEFAULT_SPEC_DIR) {
+        const state = await this.loadState(specDir);
+        return state.current_phase;
+    }
+    /**
+     * Check if transition to target phase is allowed.
+     */
+    async canTransition(specDir, targetPhase) {
+        const state = await this.loadState(specDir);
+        const currentIndex = PHASE_ORDER.indexOf(state.current_phase);
+        const targetIndex = PHASE_ORDER.indexOf(targetPhase);
+        // Can only advance to the next phase
+        if (targetIndex !== currentIndex + 1) {
+            const nextPhase = currentIndex < PHASE_ORDER.length - 1
+                ? PHASE_ORDER[currentIndex + 1]
+                : undefined;
+            return {
+                allowed: false,
+                from_phase: state.current_phase,
+                to_phase: targetPhase,
+                error_message: nextPhase
+                    ? `Cannot skip to "${targetPhase}". Next phase is "${nextPhase}".`
+                    : `Already at terminal phase "${state.current_phase}".`,
+            };
+        }
+        // Check required files for current phase
+        const requiredFiles = PHASE_REQUIRED_FILES[state.current_phase];
+        const missingFiles = [];
+        for (const fileName of requiredFiles) {
+            const featureDir = state.features[0];
+            if (featureDir) {
+                const exists = await this.fileManager.fileExists(join(featureDir, fileName));
+                if (!exists) {
+                    missingFiles.push(fileName);
+                }
+            }
+        }
+        if (missingFiles.length > 0) {
+            return {
+                allowed: false,
+                from_phase: state.current_phase,
+                to_phase: targetPhase,
+                missing_files: missingFiles,
+                error_message: `Cannot advance: missing required files: ${missingFiles.join(", ")}`,
+            };
+        }
+        return {
+            allowed: true,
+            from_phase: state.current_phase,
+            to_phase: targetPhase,
+        };
+    }
+    /**
+     * Advance to the next phase. Validates prerequisites first.
+     */
+    async advancePhase(specDir, featureNumber) {
+        const state = await this.loadState(specDir);
+        const currentIndex = PHASE_ORDER.indexOf(state.current_phase);
+        if (currentIndex >= PHASE_ORDER.length - 1) {
+            throw new Error(`Already at terminal phase "${state.current_phase}". Pipeline is complete.`);
+        }
+        const nextPhase = PHASE_ORDER[currentIndex + 1];
+        const transition = await this.canTransition(specDir, nextPhase);
+        if (!transition.allowed) {
+            throw new Error(transition.error_message || "Transition not allowed.");
+        }
+        // Mark current phase as completed
+        state.phases[state.current_phase] = {
+            ...state.phases[state.current_phase],
+            status: "completed",
+            completed_at: new Date().toISOString(),
+        };
+        // Advance to next phase
+        state.current_phase = nextPhase;
+        state.phases[nextPhase] = {
+            status: "in_progress",
+            started_at: new Date().toISOString(),
+        };
+        await this.saveState(specDir, state);
+        return state;
+    }
+    /**
+     * Record that a phase has started.
+     */
+    async recordPhaseStart(specDir, phase) {
+        const state = await this.loadState(specDir);
+        state.phases[phase] = {
+            ...state.phases[phase],
+            status: "in_progress",
+            started_at: new Date().toISOString(),
+        };
+        state.current_phase = phase;
+        await this.saveState(specDir, state);
+    }
+    /**
+     * Record that a phase has completed.
+     */
+    async recordPhaseComplete(specDir, phase) {
+        const state = await this.loadState(specDir);
+        state.phases[phase] = {
+            ...state.phases[phase],
+            status: "completed",
+            completed_at: new Date().toISOString(),
+        };
+        await this.saveState(specDir, state);
+    }
+    /** Get required files for a given phase */
+    getRequiredFiles(phase) {
+        return [...PHASE_REQUIRED_FILES[phase]];
+    }
+    /** Get phase order */
+    getPhaseOrder() {
+        return [...PHASE_ORDER];
+    }
+    /** Create a fresh state object */
+    createDefaultState(projectName) {
+        const phases = {};
+        for (const phase of PHASE_ORDER) {
+            phases[phase] = { status: "pending" };
+        }
+        return {
+            version: "3.0.0",
+            project_name: projectName,
+            current_phase: Phase.Init,
+            phases,
+            features: [],
+            amendments: [],
+            gate_decision: null,
+        };
+    }
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/services/state-machine.js.map

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

package/dist/services/template-engine.d.ts

@@ -0,0 +1,37 @@
+/**
+ * TemplateEngine — Template loading, variable replacement, YAML frontmatter.
+ */
+import type { TemplateName } from "../constants.js";
+import type { TemplateContext } from "../types.js";
+import type { FileManager } from "./file-manager.js";
+export declare class TemplateEngine {
+    private fileManager;
+    constructor(fileManager: FileManager);
+    /**
+     * Load and render a template with variable replacement.
+     */
+    render(templateName: TemplateName, context: Record<string, string | string[]>): Promise<string>;
+    /**
+     * Render a template with YAML frontmatter prepended.
+     */
+    renderWithFrontmatter(templateName: TemplateName, context: TemplateContext): Promise<string>;
+    /**
+     * Get raw template content without any processing.
+     */
+    getTemplate(templateName: TemplateName): Promise<string>;
+    /**
+     * Replace {{variable}} placeholders with context values.
+     * Unknown variables become [TODO: variable].
+     * Supports {{#each items}}...{{/each}} for arrays.
+     */
+    replaceVariables(template: string, context: Record<string, string | string[]>): string;
+    /**
+     * Generate YAML frontmatter block.
+     */
+    generateFrontmatter(context: TemplateContext): string;
+    /**
+     * Load raw template from templates/ directory.
+     */
+    private loadTemplate;
+}
+//# sourceMappingURL=template-engine.d.ts.map

package/dist/services/template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../src/services/template-engine.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD,qBAAa,cAAc;IACb,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAE5C;;OAEG;IACG,MAAM,CACV,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC;IAKlB;;OAEG;IACG,qBAAqB,CACzB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC;IAMlB;;OAEG;IACG,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D;;;;OAIG;IACH,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GACzC,MAAM;IA4BT;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM;IAyBrD;;OAEG;YACW,YAAY;CAa3B"}

package/dist/services/template-engine.js

@@ -0,0 +1,111 @@
+/**
+ * TemplateEngine — Template loading, variable replacement, YAML frontmatter.
+ */
+import { join } from "node:path";
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { dirname } from "node:path";
+import { TEMPLATE_NAMES } from "../constants.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const TEMPLATES_DIR = join(__dirname, "..", "..", "templates");
+export class TemplateEngine {
+    fileManager;
+    constructor(fileManager) {
+        this.fileManager = fileManager;
+    }
+    /**
+     * Load and render a template with variable replacement.
+     */
+    async render(templateName, context) {
+        const template = await this.loadTemplate(templateName);
+        return this.replaceVariables(template, context);
+    }
+    /**
+     * Render a template with YAML frontmatter prepended.
+     */
+    async renderWithFrontmatter(templateName, context) {
+        const frontmatter = this.generateFrontmatter(context);
+        const body = await this.render(templateName, context);
+        return `${frontmatter}\n${body}`;
+    }
+    /**
+     * Get raw template content without any processing.
+     */
+    async getTemplate(templateName) {
+        return this.loadTemplate(templateName);
+    }
+    /**
+     * Replace {{variable}} placeholders with context values.
+     * Unknown variables become [TODO: variable].
+     * Supports {{#each items}}...{{/each}} for arrays.
+     */
+    replaceVariables(template, context) {
+        let result = template;
+        // Handle {{#each key}}...{{/each}} blocks
+        const eachRegex = /\{\{#each\s+(\w+)\}\}([\s\S]*?)\{\{\/each\}\}/g;
+        result = result.replace(eachRegex, (_match, key, body) => {
+            const value = context[key];
+            if (Array.isArray(value)) {
+                return value.map((item) => body.replace(/\{\{this\}\}/g, item)).join("");
+            }
+            return `[TODO: ${key}]`;
+        });
+        // Handle {{variable}} replacements
+        result = result.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+            const value = context[key];
+            if (value === undefined) {
+                return `[TODO: ${key}]`;
+            }
+            if (Array.isArray(value)) {
+                return value.join(", ");
+            }
+            return value;
+        });
+        return result;
+    }
+    /**
+     * Generate YAML frontmatter block.
+     */
+    generateFrontmatter(context) {
+        const lines = ["---"];
+        const fields = [
+            ["title", context.title],
+            ["feature_id", context.feature_id],
+            ["version", context.version || "1.0.0"],
+            ["date", context.date || new Date().toISOString().split("T")[0]],
+            ["author", context.author || "SDD Pipeline"],
+            ["status", context.status || "Draft"],
+        ];
+        for (const [key, value] of fields) {
+            if (value !== undefined) {
+                if (Array.isArray(value)) {
+                    lines.push(`${key}: [${value.map((v) => `"${v}"`).join(", ")}]`);
+                }
+                else {
+                    lines.push(`${key}: "${value}"`);
+                }
+            }
+        }
+        lines.push("---");
+        return lines.join("\n");
+    }
+    /**
+     * Load raw template from templates/ directory.
+     */
+    async loadTemplate(name) {
+        if (!TEMPLATE_NAMES.includes(name)) {
+            throw new Error(`Unknown template: "${name}". Available: ${TEMPLATE_NAMES.join(", ")}`);
+        }
+        // Map template name to file: sync_report -> sync-report.md
+        const fileName = name.replace(/_/g, "-") + ".md";
+        const templatePath = join(TEMPLATES_DIR, fileName);
+        try {
+            return await readFile(templatePath, "utf-8");
+        }
+        catch {
+            throw new Error(`Template file not found: ${fileName}. Ensure templates/ directory exists.`);
+        }
+    }
+}
+//# sourceMappingURL=template-engine.js.map