@specpow/framework 0.2.0

package/dist/core/sdd-engine/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * SDD 引擎类型定义
+ *
+ * 定义子代理驱动开发过程中的所有数据结构
+ */
+/**
+ * 任务状态
+ */
+export type TaskStatus = 'pending' | 'in_progress' | 'done' | 'done_with_concerns' | 'blocked' | 'needs_context' | 'fix_round';
+/**
+ * 任务简报 - 从计划文件中提取的单个任务信息
+ */
+export interface TaskBrief {
+    taskNumber: number;
+    title: string;
+    description: string;
+    files: string[];
+    briefPath: string;
+    reportPath: string;
+    worktreePath?: string;
+}
+/**
+ * 任务报告 - 实现者子代理的输出
+ */
+export interface TaskReport {
+    status: TaskStatus;
+    commits: string[];
+    testSummary: string;
+    concerns?: string;
+    fixReport?: string;
+}
+/**
+ * 发现问题的严重级别
+ */
+export type FindingSeverity = 'critical' | 'important' | 'minor';
+/**
+ * 审查发现
+ */
+export interface Finding {
+    id: string;
+    severity: FindingSeverity;
+    description: string;
+    file: string;
+    line?: number;
+    addressed: boolean;
+    isLoadBearing: boolean;
+}
+/**
+ * 审查结果
+ */
+export interface ReviewResult {
+    specCompliant: boolean;
+    qualityApproved: boolean;
+    findings: Finding[];
+    cannotVerify: string[];
+}
+/**
+ * 账本条目 - 记录每个任务的执行历史
+ */
+export interface LedgerEntry {
+    taskNumber: number;
+    status: TaskStatus;
+    commits: string;
+    fixRounds: FixRoundRecord[];
+    parkedFindings: Finding[];
+    reviewClean: boolean;
+    timestamp: string;
+}
+/**
+ * 修复轮次记录
+ */
+export interface FixRoundRecord {
+    round: number;
+    addressed: number;
+    open: number;
+    findingSummaries: string[];
+    commits: string;
+}
+/**
+ * SDD 配置
+ */
+export interface SDDConfig {
+    maxFixRounds: number;
+    workspaceDir: string;
+    planFile: string;
+    implementerModel: string;
+    reviewerModel: string;
+    finalReviewModel: string;
+    specConstraints: string;
+    modelConfig?: {
+        cheap: string;
+        standard: string;
+        capable: string;
+    };
+}
+/**
+ * 子代理分发结果
+ */
+export interface DispatchResult {
+    agentId: string;
+    status: TaskStatus;
+    report: TaskReport;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/sdd-engine/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/sdd-engine/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,aAAa,GACb,MAAM,GACN,oBAAoB,GACpB,SAAS,GACT,eAAe,GACf,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,eAAe,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;CACpB"}

package/dist/core/sdd-engine/types.js

@@ -0,0 +1,7 @@
+/**
+ * SDD 引擎类型定义
+ *
+ * 定义子代理驱动开发过程中的所有数据结构
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/sdd-engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/sdd-engine/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/core/store/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 存储模块 — 变更状态持久化
+ *
+ * 职责：
+ *   1. 管理 openspec/ 目录结构
+ *   2. 读写变更状态（active/archived）
+ *   3. 管理账本（ledger）文件
+ *   4. 提供变更索引
+ */
+export interface ChangeRecord {
+    id: string;
+    title: string;
+    status: 'active' | 'archived';
+    createdAt: string;
+    updatedAt: string;
+    schemaId: string;
+    artifacts: Record<string, ArtifactRecord>;
+}
+export interface ArtifactRecord {
+    id: string;
+    status: 'pending' | 'in-progress' | 'done';
+    outputPath: string;
+    lastModified?: string;
+}
+export interface StoreConfig {
+    projectRoot: string;
+    openspecDir: string;
+}
+/**
+ * 变更存储管理器
+ */
+export declare class ChangeStore {
+    private config;
+    private changesDir;
+    private archiveDir;
+    private indexFile;
+    constructor(config: StoreConfig);
+    /**
+     * 初始化存储目录
+     */
+    init(): void;
+    /**
+     * 创建新变更
+     */
+    createChange(id: string, title: string, schemaId: string): ChangeRecord;
+    /**
+     * 获取变更
+     */
+    getChange(id: string): ChangeRecord | null;
+    /**
+     * 列出所有活跃变更
+     */
+    listActiveChanges(): ChangeRecord[];
+    /**
+     * 列出所有已归档变更
+     */
+    listArchivedChanges(): ChangeRecord[];
+    /**
+     * 更新工件状态
+     */
+    updateArtifact(changeId: string, artifactId: string, status: ArtifactRecord['status']): void;
+    /**
+     * 归档变更
+     */
+    archiveChange(id: string): void;
+    /**
+     * 删除变更
+     */
+    deleteChange(id: string): void;
+    /**
+     * 获取变更目录路径
+     */
+    getChangeDir(id: string): string;
+    private readIndex;
+    private writeIndex;
+    private copyDirRecursive;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/core/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/store/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,WAAW;IAO/B;;OAEG;IACH,IAAI,IAAI,IAAI;IAUZ;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAyBvE;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAK1C;;OAEG;IACH,iBAAiB,IAAI,YAAY,EAAE;IAKnC;;OAEG;IACH,mBAAmB,IAAI,YAAY,EAAE;IAKrC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI;IAiB5F;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAoB/B;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAW9B;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAMhC,OAAO,CAAC,SAAS;IAmBjB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,gBAAgB;CAazB"}

package/dist/core/store/index.js

@@ -0,0 +1,182 @@
+/**
+ * 存储模块 — 变更状态持久化
+ *
+ * 职责：
+ *   1. 管理 openspec/ 目录结构
+ *   2. 读写变更状态（active/archived）
+ *   3. 管理账本（ledger）文件
+ *   4. 提供变更索引
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * 变更存储管理器
+ */
+export class ChangeStore {
+    config;
+    changesDir;
+    archiveDir;
+    indexFile;
+    constructor(config) {
+        this.config = config;
+        this.changesDir = path.join(config.openspecDir, 'changes');
+        this.archiveDir = path.join(config.openspecDir, 'archive');
+        this.indexFile = path.join(config.openspecDir, 'index.json');
+    }
+    /**
+     * 初始化存储目录
+     */
+    init() {
+        fs.mkdirSync(this.changesDir, { recursive: true });
+        fs.mkdirSync(this.archiveDir, { recursive: true });
+        fs.mkdirSync(path.join(this.config.openspecDir, 'specs'), { recursive: true });
+        if (!fs.existsSync(this.indexFile)) {
+            this.writeIndex({ changes: [] });
+        }
+    }
+    /**
+     * 创建新变更
+     */
+    createChange(id, title, schemaId) {
+        const now = new Date().toISOString();
+        const record = {
+            id,
+            title,
+            status: 'active',
+            createdAt: now,
+            updatedAt: now,
+            schemaId,
+            artifacts: {},
+        };
+        // 创建变更目录
+        const changeDir = path.join(this.changesDir, id);
+        fs.mkdirSync(changeDir, { recursive: true });
+        fs.mkdirSync(path.join(changeDir, 'specs'), { recursive: true });
+        // 更新索引
+        const index = this.readIndex();
+        index.changes.push(record);
+        this.writeIndex(index);
+        return record;
+    }
+    /**
+     * 获取变更
+     */
+    getChange(id) {
+        const index = this.readIndex();
+        return index.changes.find(c => c.id === id) || null;
+    }
+    /**
+     * 列出所有活跃变更
+     */
+    listActiveChanges() {
+        const index = this.readIndex();
+        return index.changes.filter(c => c.status === 'active');
+    }
+    /**
+     * 列出所有已归档变更
+     */
+    listArchivedChanges() {
+        const index = this.readIndex();
+        return index.changes.filter(c => c.status === 'archived');
+    }
+    /**
+     * 更新工件状态
+     */
+    updateArtifact(changeId, artifactId, status) {
+        const index = this.readIndex();
+        const change = index.changes.find(c => c.id === changeId);
+        if (!change)
+            throw new Error(`变更不存在: ${changeId}`);
+        change.artifacts[artifactId] = {
+            ...change.artifacts[artifactId],
+            id: artifactId,
+            status,
+            outputPath: '',
+            lastModified: new Date().toISOString(),
+        };
+        change.updatedAt = new Date().toISOString();
+        this.writeIndex(index);
+    }
+    /**
+     * 归档变更
+     */
+    archiveChange(id) {
+        const index = this.readIndex();
+        const change = index.changes.find(c => c.id === id);
+        if (!change)
+            throw new Error(`变更不存在: ${id}`);
+        change.status = 'archived';
+        change.updatedAt = new Date().toISOString();
+        // 移动文件
+        const srcDir = path.join(this.changesDir, id);
+        const destDir = path.join(this.archiveDir, id);
+        if (fs.existsSync(srcDir)) {
+            fs.mkdirSync(destDir, { recursive: true });
+            this.copyDirRecursive(srcDir, destDir);
+            fs.rmSync(srcDir, { recursive: true, force: true });
+        }
+        this.writeIndex(index);
+    }
+    /**
+     * 删除变更
+     */
+    deleteChange(id) {
+        const index = this.readIndex();
+        index.changes = index.changes.filter(c => c.id !== id);
+        this.writeIndex(index);
+        const changeDir = path.join(this.changesDir, id);
+        if (fs.existsSync(changeDir)) {
+            fs.rmSync(changeDir, { recursive: true, force: true });
+        }
+    }
+    /**
+     * 获取变更目录路径
+     */
+    getChangeDir(id) {
+        return path.join(this.changesDir, id);
+    }
+    // ─── 内部方法 ──────────────────────────────────────────
+    readIndex() {
+        if (!fs.existsSync(this.indexFile)) {
+            return { changes: [] };
+        }
+        try {
+            return JSON.parse(fs.readFileSync(this.indexFile, 'utf-8'));
+        }
+        catch (err) {
+            // 配置文件损坏 — 输出警告并备份，避免静默丢失数据
+            console.warn(`⚠ 索引文件解析失败 (${this.indexFile}): ${err.message}。` +
+                '已备份为 .corrupted 并返回空列表。请检查文件内容。');
+            try {
+                fs.copyFileSync(this.indexFile, `${this.indexFile}.corrupted`);
+            }
+            catch { /* 备份失败不阻塞流程 */ }
+            return { changes: [] };
+        }
+    }
+    writeIndex(data) {
+        const dir = path.dirname(this.indexFile);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // 原子写入：先写临时文件，再重命名，防止写入中断导致文件损坏
+        const tmpPath = `${this.indexFile}.tmp`;
+        fs.writeFileSync(tmpPath, JSON.stringify(data, null, 2), 'utf-8');
+        fs.renameSync(tmpPath, this.indexFile);
+    }
+    copyDirRecursive(src, dest) {
+        const entries = fs.readdirSync(src, { withFileTypes: true });
+        for (const entry of entries) {
+            const srcPath = path.join(src, entry.name);
+            const destPath = path.join(dest, entry.name);
+            if (entry.isDirectory()) {
+                fs.mkdirSync(destPath, { recursive: true });
+                this.copyDirRecursive(srcPath, destPath);
+            }
+            else {
+                fs.copyFileSync(srcPath, destPath);
+            }
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/core/store/index.js.map

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

package/dist/core/templates/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 模板模块 — 工件模板管理
+ *
+ * 职责：
+ *   1. 加载 Schema 关联的模板文件
+ *   2. 变量替换（{{变量名}}）
+ *   3. 模板组合（多模板合并）
+ *   4. 生成 AI 指令（模板 + 上下文 → prompt）
+ */
+export interface TemplateContext {
+    changeId: string;
+    changeTitle: string;
+    projectRoot: string;
+    schemaId: string;
+    timestamp: string;
+    [key: string]: string | string[];
+}
+export interface TemplateResult {
+    content: string;
+    variables: string[];
+    missingVariables: string[];
+}
+/**
+ * 模板引擎
+ */
+export declare class TemplateEngine {
+    private templateDirs;
+    constructor(templateDirs: string[]);
+    /**
+     * 加载模板
+     */
+    loadTemplate(templateName: string): string | null;
+    /**
+     * 渲染模板（变量替换）
+     */
+    render(templateContent: string, context: TemplateContext): TemplateResult;
+    /**
+     * 加载并渲染模板
+     */
+    loadAndRender(templateName: string, context: TemplateContext): TemplateResult | null;
+    /**
+     * 生成 AI 指令
+     * 将模板渲染结果与上下文组合成 AI prompt
+     *
+     * P1-7: 支持 {{context}} 和 {{rules}} 占位符注入
+     */
+    generateInstruction(templateName: string, context: TemplateContext, additionalContext?: string, options?: {
+        /** 项目级上下文描述（注入到 {{context}} 占位符） */
+        projectContext?: string;
+        /** 工件定制规则（注入到 {{rules}} 占位符） */
+        rules?: string[];
+    }): string | null;
+}
+/**
+ * 创建默认模板引擎
+ */
+export declare function createTemplateEngine(projectRoot: string, schemaId: string): TemplateEngine;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAW;gBAEnB,YAAY,EAAE,MAAM,EAAE;IAIlC;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAUjD;;OAEG;IACH,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,cAAc;IAiCzE;;OAEG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,cAAc,GAAG,IAAI;IAMpF;;;;;OAKG;IACH,mBAAmB,CACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,eAAe,EACxB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE;QACR,oCAAoC;QACpC,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,gCAAgC;QAChC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,GACA,MAAM,GAAG,IAAI;CAyEjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAa1F"}

package/dist/core/templates/index.js

@@ -0,0 +1,158 @@
+/**
+ * 模板模块 — 工件模板管理
+ *
+ * 职责：
+ *   1. 加载 Schema 关联的模板文件
+ *   2. 变量替换（{{变量名}}）
+ *   3. 模板组合（多模板合并）
+ *   4. 生成 AI 指令（模板 + 上下文 → prompt）
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * 模板引擎
+ */
+export class TemplateEngine {
+    templateDirs;
+    constructor(templateDirs) {
+        this.templateDirs = templateDirs;
+    }
+    /**
+     * 加载模板
+     */
+    loadTemplate(templateName) {
+        for (const dir of this.templateDirs) {
+            const templatePath = path.join(dir, templateName);
+            if (fs.existsSync(templatePath)) {
+                return fs.readFileSync(templatePath, 'utf-8');
+            }
+        }
+        return null;
+    }
+    /**
+     * 渲染模板（变量替换）
+     */
+    render(templateContent, context) {
+        const variables = [];
+        const missingVariables = [];
+        // 提取所有 {{变量名}} 占位符
+        const varRegex = /\{\{(\w+)\}\}/g;
+        let match;
+        while ((match = varRegex.exec(templateContent)) !== null) {
+            const varName = match[1];
+            if (!variables.includes(varName)) {
+                variables.push(varName);
+            }
+        }
+        // 替换变量
+        let content = templateContent;
+        for (const varName of variables) {
+            const value = context[varName];
+            if (value === undefined) {
+                if (!missingVariables.includes(varName)) {
+                    missingVariables.push(varName);
+                }
+                continue;
+            }
+            const replacement = Array.isArray(value) ? value.join('\n') : value;
+            // 转义 $ 符号，避免正则替换特殊序列（$&, $1 等）
+            const safeReplacement = replacement.replace(/\$/g, '$$$$');
+            content = content.replace(new RegExp(`\\{\\{${varName}\\}\\}`, 'g'), safeReplacement);
+        }
+        return { content, variables, missingVariables };
+    }
+    /**
+     * 加载并渲染模板
+     */
+    loadAndRender(templateName, context) {
+        const template = this.loadTemplate(templateName);
+        if (!template)
+            return null;
+        return this.render(template, context);
+    }
+    /**
+     * 生成 AI 指令
+     * 将模板渲染结果与上下文组合成 AI prompt
+     *
+     * P1-7: 支持 {{context}} 和 {{rules}} 占位符注入
+     */
+    generateInstruction(templateName, context, additionalContext, options) {
+        const result = this.loadAndRender(templateName, context);
+        if (!result)
+            return null;
+        // P1-7: 处理 {{context}} 占位符 — 替换或追加
+        let content = result.content;
+        if (options?.projectContext) {
+            if (content.includes('{{context}}')) {
+                content = content.replace(/\{\{context\}\}/g, options.projectContext);
+            }
+            else {
+                // 模板中没有 {{context}} 占位符时，在模板顶部追加上下文块
+                content = `> **项目上下文**\n> ${options.projectContext.split('\n').join('\n> ')}\n\n${content}`;
+            }
+        }
+        // P1-7: 处理 {{rules}} 占位符 — 替换或追加
+        if (options?.rules && options.rules.length > 0) {
+            const rulesText = options.rules.map(r => `- ${r}`).join('\n');
+            if (content.includes('{{rules}}')) {
+                content = content.replace(/\{\{rules\}\}/g, rulesText);
+            }
+            else {
+                // 模板中没有 {{rules}} 占位符时，在输出要求前追加规则块
+                content = `${content}\n\n## 约束规则\n\n${rulesText}`;
+            }
+        }
+        // 清理残留的未替换占位符
+        content = content.replace(/\{\{context\}\}/g, '（无项目上下文）');
+        content = content.replace(/\{\{rules\}\}/g, '（无额外约束）');
+        const parts = [];
+        parts.push('# 任务指令');
+        parts.push('');
+        parts.push(`你需要根据以下模板和上下文，生成对应的工件内容。`);
+        parts.push('');
+        if (result.missingVariables.length > 0) {
+            parts.push(`> ⚠️ 注意：以下变量未提供值，请根据上下文推断：${result.missingVariables.join(', ')}`);
+            parts.push('');
+        }
+        parts.push('## 模板');
+        parts.push('');
+        parts.push('```markdown');
+        parts.push(content);
+        parts.push('```');
+        parts.push('');
+        parts.push('## 上下文信息');
+        parts.push('');
+        parts.push(`- 变更 ID: ${context.changeId}`);
+        parts.push(`- 变更标题: ${context.changeTitle}`);
+        parts.push(`- Schema: ${context.schemaId}`);
+        parts.push(`- 项目根目录: ${context.projectRoot}`);
+        parts.push('');
+        if (additionalContext) {
+            parts.push('## 额外上下文');
+            parts.push('');
+            parts.push(additionalContext);
+            parts.push('');
+        }
+        parts.push('## 输出要求');
+        parts.push('');
+        parts.push('1. 严格按照模板格式输出');
+        parts.push('2. 内容要具体、可执行');
+        parts.push('3. 不要输出模板之外的内容');
+        parts.push('');
+        return parts.join('\n');
+    }
+}
+/**
+ * 创建默认模板引擎
+ */
+export function createTemplateEngine(projectRoot, schemaId) {
+    const dirs = [];
+    // 项目级模板
+    dirs.push(path.join(projectRoot, 'openspec', 'templates'));
+    // Schema 级模板
+    dirs.push(path.join(projectRoot, 'schemas', schemaId, 'templates'));
+    // 包内置模板
+    dirs.push(path.join(projectRoot, 'templates'));
+    return new TemplateEngine(dirs);
+}
+//# sourceMappingURL=index.js.map

package/dist/core/templates/index.js.map

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

package/dist/core/validation/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 验证模块 — 工件完整性校验
+ *
+ * 职责：
+ *   1. 验证 Schema YAML 格式正确性
+ *   2. 验证工件依赖关系无环
+ *   3. 验证模板文件存在且格式合法
+ *   4. 验证输出路径可写
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+export interface ValidationError {
+    code: string;
+    message: string;
+    file?: string;
+    line?: number;
+}
+export interface ValidationWarning {
+    code: string;
+    message: string;
+    file?: string;
+}
+/**
+ * 验证 Schema YAML
+ */
+export declare function validateSchema(schemaPath: string): ValidationResult;
+/**
+ * 验证变更目录结构
+ */
+export declare function validateChangeDir(changeDir: string): ValidationResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAmEnE;AA6CD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAwCrE"}