@specpow/framework 0.2.0

package/dist/core/validation/index.js

@@ -0,0 +1,153 @@
+/**
+ * 验证模块 — 工件完整性校验
+ *
+ * 职责：
+ *   1. 验证 Schema YAML 格式正确性
+ *   2. 验证工件依赖关系无环
+ *   3. 验证模板文件存在且格式合法
+ *   4. 验证输出路径可写
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { parse as parseYaml } from 'yaml';
+import { SchemaYamlSchema } from '../artifact-graph/types.js';
+/**
+ * 验证 Schema YAML
+ */
+export function validateSchema(schemaPath) {
+    const result = { valid: true, errors: [], warnings: [] };
+    if (!fs.existsSync(schemaPath)) {
+        result.valid = false;
+        result.errors.push({
+            code: 'SCHEMA_NOT_FOUND',
+            message: `Schema 文件不存在: ${schemaPath}`,
+        });
+        return result;
+    }
+    try {
+        const content = fs.readFileSync(schemaPath, 'utf-8');
+        const parsed = parseYaml(content);
+        // Zod 验证
+        const parseResult = SchemaYamlSchema.safeParse(parsed);
+        if (!parseResult.success) {
+            result.valid = false;
+            for (const issue of parseResult.error.issues) {
+                result.errors.push({
+                    code: 'SCHEMA_VALIDATION',
+                    message: `${issue.path.join('.')}: ${issue.message}`,
+                    file: schemaPath,
+                });
+            }
+            return result;
+        }
+        const schema = parseResult.data;
+        // 检查工件依赖无环
+        const cycleResult = checkDependencyCycles(schema);
+        if (cycleResult.hasCycle) {
+            result.valid = false;
+            result.errors.push({
+                code: 'DEPENDENCY_CYCLE',
+                message: `工件依赖存在环: ${cycleResult.cycle.join(' → ')}`,
+                file: schemaPath,
+            });
+        }
+        // 检查模板文件存在性
+        const schemaDir = path.dirname(schemaPath);
+        for (const artifact of schema.artifacts) {
+            if (artifact.template) {
+                const templatePath = path.join(schemaDir, artifact.template);
+                if (!fs.existsSync(templatePath)) {
+                    result.warnings.push({
+                        code: 'TEMPLATE_MISSING',
+                        message: `模板文件不存在: ${artifact.template} (工件: ${artifact.id})`,
+                        file: templatePath,
+                    });
+                }
+            }
+        }
+    }
+    catch (err) {
+        result.valid = false;
+        result.errors.push({
+            code: 'SCHEMA_PARSE_ERROR',
+            message: `Schema 解析失败: ${err.message}`,
+            file: schemaPath,
+        });
+    }
+    return result;
+}
+/**
+ * 检查工件依赖是否有环
+ */
+function checkDependencyCycles(schema) {
+    const graph = new Map();
+    for (const artifact of schema.artifacts) {
+        graph.set(artifact.id, artifact.requires || []);
+    }
+    const visited = new Set();
+    const inStack = new Set();
+    function dfs(node, pathSoFar) {
+        if (inStack.has(node)) {
+            const cycleStart = pathSoFar.indexOf(node);
+            return { hasCycle: true, cycle: [...pathSoFar.slice(cycleStart), node] };
+        }
+        if (visited.has(node))
+            return { hasCycle: false, cycle: [] };
+        visited.add(node);
+        inStack.add(node);
+        const deps = graph.get(node) || [];
+        for (const dep of deps) {
+            const result = dfs(dep, [...pathSoFar, node]);
+            if (result.hasCycle)
+                return result;
+        }
+        inStack.delete(node);
+        return { hasCycle: false, cycle: [] };
+    }
+    for (const nodeId of graph.keys()) {
+        const result = dfs(nodeId, []);
+        if (result.hasCycle)
+            return result;
+    }
+    return { hasCycle: false, cycle: [] };
+}
+/**
+ * 验证变更目录结构
+ */
+export function validateChangeDir(changeDir) {
+    const result = { valid: true, errors: [], warnings: [] };
+    if (!fs.existsSync(changeDir)) {
+        result.valid = false;
+        result.errors.push({
+            code: 'CHANGE_DIR_NOT_FOUND',
+            message: `变更目录不存在: ${changeDir}`,
+        });
+        return result;
+    }
+    // 检查必要文件
+    const requiredFiles = ['proposal.md'];
+    const optionalFiles = ['specs/spec.md', 'design.md', 'tasks.md'];
+    for (const file of requiredFiles) {
+        const filePath = path.join(changeDir, file);
+        if (!fs.existsSync(filePath)) {
+            result.valid = false;
+            result.errors.push({
+                code: 'REQUIRED_FILE_MISSING',
+                message: `缺少必要文件: ${file}`,
+                file: filePath,
+            });
+        }
+    }
+    for (const file of optionalFiles) {
+        const filePath = path.join(changeDir, file);
+        if (!fs.existsSync(filePath)) {
+            result.warnings.push({
+                code: 'OPTIONAL_FILE_MISSING',
+                message: `缺少可选文件: ${file}`,
+                file: filePath,
+            });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/core/workflow-state.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 工作流状态标签
+ *
+ * P2-14: 借鉴 Trellis 的 [workflow-state:xxx] 标签
+ *
+ * 功能：
+ * - 解析工作流状态标签
+ * - 生成状态标签
+ * - 状态标签格式化
+ */
+export type WorkflowStage = 'explore' | 'propose' | 'apply' | 'verify' | 'archive' | 'idle';
+export interface WorkflowState {
+    /** 当前阶段 */
+    stage: WorkflowStage;
+    /** 变更名称（如果有） */
+    changeName?: string;
+    /** 任务进度（如果有） */
+    taskProgress?: {
+        current: number;
+        total: number;
+    };
+    /** 阻塞原因（如果有） */
+    blocked?: string;
+    /** 最后更新时间 */
+    updatedAt: number;
+}
+/**
+ * 解析工作流状态标签
+ *
+ * 格式: [workflow-state:stage] 或 [workflow-state:stage:details]
+ *
+ * 示例:
+ * - [workflow-state:explore]
+ * - [workflow-state:apply:task-3-of-5]
+ * - [workflow-state:verify:blocked]
+ */
+export declare function parseWorkflowStateTag(text: string): WorkflowState | null;
+/**
+ * 生成工作流状态标签
+ */
+export declare function generateWorkflowStateTag(state: WorkflowState): string;
+/**
+ * 从阶段生成简单的状态标签
+ */
+export declare function stageToTag(stage: WorkflowStage): string;
+/**
+ * 从文本中提取所有工作流状态标签
+ */
+export declare function extractWorkflowStateTags(text: string): WorkflowState[];
+/**
+ * 检查文本是否包含工作流状态标签
+ */
+export declare function hasWorkflowStateTag(text: string): boolean;
+/**
+ * 移除文本中的工作流状态标签
+ */
+export declare function removeWorkflowStateTags(text: string): string;
+/**
+ * 获取阶段的图标
+ */
+export declare function getStageIcon(stage: WorkflowStage): string;
+/**
+ * 获取阶段的描述
+ */
+export declare function getStageDescription(stage: WorkflowStage): string;
+/**
+ * 生成带图标的阶段标签
+ */
+export declare function formatStageLabel(stage: WorkflowStage): string;
+/**
+ * 从文件路径推断工作流阶段
+ */
+export declare function inferStageFromPath(filePath: string): WorkflowStage | null;
+/**
+ * 从内容推断工作流阶段
+ */
+export declare function inferStageFromContent(content: string): WorkflowStage | null;
+/**
+ * 检测当前工作流阶段（共享函数）
+ *
+ * 基于 openspec/changes 目录结构推断当前阶段
+ */
+export declare function detectCurrentStage(projectRoot: string): WorkflowStage;
+/**
+ * 保存工作流状态到持久化文件
+ */
+export declare function saveWorkflowState(projectRoot: string, state: WorkflowState): void;
+/**
+ * 加载持久化的工作流状态
+ */
+export declare function loadWorkflowState(projectRoot: string): WorkflowState | null;
+/**
+ * 清除持久化的工作流状态
+ */
+export declare function clearWorkflowState(projectRoot: string): void;
+//# sourceMappingURL=workflow-state.d.ts.map

package/dist/core/workflow-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-state.d.ts","sourceRoot":"","sources":["../../src/core/workflow-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,SAAS,GACT,OAAO,GACP,QAAQ,GACR,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,KAAK,EAAE,aAAa,CAAC;IACrB,gBAAgB;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,YAAY,CAAC,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA6CxE;AAeD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAwBrE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEvD;AAID;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAatE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAID;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAUzD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAUhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAE7D;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAgBzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAgB3E;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAgCrE;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAajF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAa3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAU5D"}

package/dist/core/workflow-state.js

@@ -0,0 +1,284 @@
+/**
+ * 工作流状态标签
+ *
+ * P2-14: 借鉴 Trellis 的 [workflow-state:xxx] 标签
+ *
+ * 功能：
+ * - 解析工作流状态标签
+ * - 生成状态标签
+ * - 状态标签格式化
+ */
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, unlinkSync } from 'fs';
+import { join } from 'path';
+// ─── 状态标签解析 ───────────────────────────────────────────
+/**
+ * 解析工作流状态标签
+ *
+ * 格式: [workflow-state:stage] 或 [workflow-state:stage:details]
+ *
+ * 示例:
+ * - [workflow-state:explore]
+ * - [workflow-state:apply:task-3-of-5]
+ * - [workflow-state:verify:blocked]
+ */
+export function parseWorkflowStateTag(text) {
+    // 匹配 [workflow-state:stage] 或 [workflow-state:stage:details]
+    const match = text.match(/\[workflow-state:([a-z]+)(?::([^\]]+))?\]/i);
+    if (!match) {
+        return null;
+    }
+    const stageStr = match[1].toLowerCase();
+    const details = match[2];
+    const stage = parseStage(stageStr);
+    if (!stage) {
+        return null;
+    }
+    const state = {
+        stage,
+        updatedAt: Date.now(),
+    };
+    // 解析详情
+    if (details) {
+        // 解析任务进度: task-3-of-5
+        const taskMatch = details.match(/task-(\d+)-of-(\d+)/);
+        if (taskMatch) {
+            state.taskProgress = {
+                current: parseInt(taskMatch[1]),
+                total: parseInt(taskMatch[2]),
+            };
+        }
+        // 解析阻塞: blocked:reason
+        if (details.startsWith('blocked')) {
+            const reasonMatch = details.match(/blocked:(.+)/);
+            state.blocked = reasonMatch ? reasonMatch[1] : 'unknown';
+        }
+        // 解析变更名称: change:name
+        const changeMatch = details.match(/change:([^\s]+)/);
+        if (changeMatch) {
+            state.changeName = changeMatch[1];
+        }
+    }
+    return state;
+}
+/**
+ * 解析阶段字符串
+ */
+function parseStage(stageStr) {
+    const validStages = ['explore', 'propose', 'apply', 'verify', 'archive', 'idle'];
+    if (validStages.includes(stageStr)) {
+        return stageStr;
+    }
+    return null;
+}
+// ─── 状态标签生成 ───────────────────────────────────────────
+/**
+ * 生成工作流状态标签
+ */
+export function generateWorkflowStateTag(state) {
+    let tag = `[workflow-state:${state.stage}`;
+    // 添加详情
+    const details = [];
+    if (state.changeName) {
+        details.push(`change:${state.changeName}`);
+    }
+    if (state.taskProgress) {
+        details.push(`task-${state.taskProgress.current}-of-${state.taskProgress.total}`);
+    }
+    if (state.blocked) {
+        details.push(`blocked:${state.blocked}`);
+    }
+    if (details.length > 0) {
+        tag += `:${details.join(',')}`;
+    }
+    tag += ']';
+    return tag;
+}
+/**
+ * 从阶段生成简单的状态标签
+ */
+export function stageToTag(stage) {
+    return `[workflow-state:${stage}]`;
+}
+// ─── 状态标签提取 ───────────────────────────────────────────
+/**
+ * 从文本中提取所有工作流状态标签
+ */
+export function extractWorkflowStateTags(text) {
+    const tags = [];
+    const regex = /\[workflow-state:[^\]]+\]/gi;
+    const matches = text.match(regex) || [];
+    for (const match of matches) {
+        const state = parseWorkflowStateTag(match);
+        if (state) {
+            tags.push(state);
+        }
+    }
+    return tags;
+}
+/**
+ * 检查文本是否包含工作流状态标签
+ */
+export function hasWorkflowStateTag(text) {
+    return /\[workflow-state:[^\]]+\]/i.test(text);
+}
+/**
+ * 移除文本中的工作流状态标签
+ */
+export function removeWorkflowStateTags(text) {
+    return text.replace(/\[workflow-state:[^\]]+\]\s*/gi, '').trim();
+}
+// ─── 阶段图标 ───────────────────────────────────────────────
+/**
+ * 获取阶段的图标
+ */
+export function getStageIcon(stage) {
+    const icons = {
+        explore: '🔍',
+        propose: '📝',
+        apply: '⚙️',
+        verify: '✅',
+        archive: '📦',
+        idle: '💤',
+    };
+    return icons[stage] || '❓';
+}
+/**
+ * 获取阶段的描述
+ */
+export function getStageDescription(stage) {
+    const descriptions = {
+        explore: '探索需求，理解问题',
+        propose: '创建变更提案',
+        apply: '实现代码',
+        verify: '验证实现',
+        archive: '归档变更',
+        idle: '空闲状态',
+    };
+    return descriptions[stage] || '未知阶段';
+}
+/**
+ * 生成带图标的阶段标签
+ */
+export function formatStageLabel(stage) {
+    return `${getStageIcon(stage)} ${stage.toUpperCase()}`;
+}
+// ─── 状态推断 ───────────────────────────────────────────────
+/**
+ * 从文件路径推断工作流阶段
+ */
+export function inferStageFromPath(filePath) {
+    const patterns = [
+        { pattern: /explore|探索/i, stage: 'explore' },
+        { pattern: /propose|提案|proposal/i, stage: 'propose' },
+        { pattern: /apply|实现|implementation/i, stage: 'apply' },
+        { pattern: /verify|验证|verification/i, stage: 'verify' },
+        { pattern: /archive|归档/i, stage: 'archive' },
+    ];
+    for (const { pattern, stage } of patterns) {
+        if (pattern.test(filePath)) {
+            return stage;
+        }
+    }
+    return null;
+}
+/**
+ * 从内容推断工作流阶段
+ */
+export function inferStageFromContent(content) {
+    const patterns = [
+        { pattern: /探索|理解|分析|调研|explore/i, stage: 'explore' },
+        { pattern: /提案|proposal| propose/i, stage: 'propose' },
+        { pattern: /实现|apply|执行|开发|编码/i, stage: 'apply' },
+        { pattern: /验证|verify|测试|检查/i, stage: 'verify' },
+        { pattern: /归档|archive|合并|merge/i, stage: 'archive' },
+    ];
+    for (const { pattern, stage } of patterns) {
+        if (pattern.test(content)) {
+            return stage;
+        }
+    }
+    return null;
+}
+// ─── 共享阶段检测 ───────────────────────────────────────────
+/**
+ * 检测当前工作流阶段（共享函数）
+ *
+ * 基于 openspec/changes 目录结构推断当前阶段
+ */
+export function detectCurrentStage(projectRoot) {
+    const changesDir = join(projectRoot, 'openspec', 'changes');
+    if (!existsSync(changesDir)) {
+        return 'idle';
+    }
+    try {
+        const entries = readdirSync(changesDir, { withFileTypes: true });
+        const changeDirs = entries.filter((e) => e.isDirectory() && e.name !== 'archive');
+        if (changeDirs.length === 0) {
+            return 'idle';
+        }
+        const changeDir = join(changesDir, changeDirs[0].name);
+        const files = readdirSync(changeDir);
+        // 推断阶段
+        if (files.some((f) => f.includes('verify') || f.includes('review'))) {
+            return 'verify';
+        }
+        if (files.some((f) => f.includes('tasks'))) {
+            return 'apply';
+        }
+        if (files.some((f) => f.includes('spec') || f.includes('design'))) {
+            return 'propose';
+        }
+        return 'explore';
+    }
+    catch {
+        return 'idle';
+    }
+}
+// ─── 工作流状态持久化 ───────────────────────────────────────
+/**
+ * 保存工作流状态到持久化文件
+ */
+export function saveWorkflowState(projectRoot, state) {
+    const stateDir = join(projectRoot, '.specpow', 'state');
+    try {
+        if (!existsSync(stateDir)) {
+            mkdirSync(stateDir, { recursive: true });
+        }
+        const stateFile = join(stateDir, 'workflow-state.json');
+        writeFileSync(stateFile, JSON.stringify(state, null, 2), 'utf-8');
+    }
+    catch {
+        // 静默失败
+    }
+}
+/**
+ * 加载持久化的工作流状态
+ */
+export function loadWorkflowState(projectRoot) {
+    const stateFile = join(projectRoot, '.specpow', 'state', 'workflow-state.json');
+    if (!existsSync(stateFile)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(stateFile, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 清除持久化的工作流状态
+ */
+export function clearWorkflowState(projectRoot) {
+    const stateFile = join(projectRoot, '.specpow', 'state', 'workflow-state.json');
+    try {
+        if (existsSync(stateFile)) {
+            unlinkSync(stateFile);
+        }
+    }
+    catch {
+        // 静默失败
+    }
+}
+//# sourceMappingURL=workflow-state.js.map

package/dist/core/workflow-state.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SpecPow Framework - 主入口
+ *
+ * 融合 OpenSpec 规范驱动 + Superpowers 执行引擎
+ */
+export { runCli } from './cli/index.js';
+export * as artifactGraph from './core/artifact-graph/index.js';
+export * as sddEngine from './core/sdd-engine/index.js';
+export * as commandGeneration from './core/command-generation/index.js';
+export * as store from './core/store/index.js';
+export * as parsers from './core/parsers/index.js';
+export * as validation from './core/validation/index.js';
+export * as templates from './core/templates/index.js';
+export * as hooks from './core/hooks/index.js';
+export * as memory from './core/memory/index.js';
+export * as channel from './core/channel/index.js';
+export * as workflowState from './core/workflow-state.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,OAAO,KAAK,aAAa,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,iBAAiB,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,KAAK,MAAM,uBAAuB,CAAC;AAC/C,OAAO,KAAK,OAAO,MAAM,yBAAyB,CAAC;AACnD,OAAO,KAAK,UAAU,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,SAAS,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,KAAK,MAAM,uBAAuB,CAAC;AAC/C,OAAO,KAAK,MAAM,MAAM,wBAAwB,CAAC;AACjD,OAAO,KAAK,OAAO,MAAM,yBAAyB,CAAC;AAGnD,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * SpecPow Framework - 主入口
+ *
+ * 融合 OpenSpec 规范驱动 + Superpowers 执行引擎
+ */
+// CLI 模块
+export { runCli } from './cli/index.js';
+// 核心模块
+export * as artifactGraph from './core/artifact-graph/index.js';
+export * as sddEngine from './core/sdd-engine/index.js';
+export * as commandGeneration from './core/command-generation/index.js';
+export * as store from './core/store/index.js';
+export * as parsers from './core/parsers/index.js';
+export * as validation from './core/validation/index.js';
+export * as templates from './core/templates/index.js';
+export * as hooks from './core/hooks/index.js';
+export * as memory from './core/memory/index.js';
+export * as channel from './core/channel/index.js';
+// 工作流状态
+export * as workflowState from './core/workflow-state.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,SAAS;AACT,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,OAAO;AACP,OAAO,KAAK,aAAa,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,iBAAiB,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,KAAK,MAAM,uBAAuB,CAAC;AAC/C,OAAO,KAAK,OAAO,MAAM,yBAAyB,CAAC;AACnD,OAAO,KAAK,UAAU,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,SAAS,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,KAAK,MAAM,uBAAuB,CAAC;AAC/C,OAAO,KAAK,MAAM,MAAM,wBAAwB,CAAC;AACjD,OAAO,KAAK,OAAO,MAAM,yBAAyB,CAAC;AAEnD,QAAQ;AACR,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 通用工具函数
+ */
+/**
+ * 查找项目根目录（包含 package.json 或 .git 的最近父目录）
+ */
+export declare function findProjectRoot(startDir?: string): string;
+/**
+ * 安全读取 JSON 文件
+ */
+export declare function readJsonSafe<T>(filePath: string): T | null;
+/**
+ * 确保目录存在
+ */
+export declare function ensureDir(dirPath: string): void;
+/**
+ * 复制目录（递归）
+ */
+export declare function copyDir(src: string, dest: string): void;
+/**
+ * 列出目录下所有文件（递归）
+ */
+export declare function listFilesRecursive(dir: string, pattern?: RegExp): string[];
+/**
+ * 生成变更 ID（基于标题的 slug）
+ */
+export declare function generateChangeId(title: string): string;
+/**
+ * 格式化时间戳
+ */
+export declare function formatTimestamp(date?: Date): string;
+/**
+ * 打印成功消息
+ */
+export declare function success(msg: string): void;
+/**
+ * 打印错误消息
+ */
+export declare function error(msg: string): void;
+/**
+ * 打印警告消息
+ */
+export declare function warn(msg: string): void;
+/**
+ * 打印信息消息
+ */
+export declare function info(msg: string): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAYxE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAO1D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAYvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAc1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtC;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtC"}