@winspan/claude-forge 0.4.2 → 0.4.3

package/dist/utils/artifact-manager.js

@@ -0,0 +1,164 @@
+/**
+ * 统一产物管理器
+ *
+ * 负责将所有产物（复盘报告、阶段产物、计划文档、质量报告）
+ * 统一输出到 docs/YYYY-MM-DD_HH-MM-SS/ 目录，并维护 docs/INDEX.md 索引
+ */
+import fs from 'fs';
+import path from 'path';
+import { logger } from './logger.js';
+export class ArtifactManager {
+    projectPath;
+    docsDir;
+    indexPath;
+    currentSessionDir = null;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+        this.docsDir = path.join(projectPath, 'docs');
+        this.indexPath = path.join(this.docsDir, 'INDEX.md');
+        // 确保 docs 目录存在
+        if (!fs.existsSync(this.docsDir)) {
+            fs.mkdirSync(this.docsDir, { recursive: true });
+        }
+    }
+    /**
+     * 创建新的产物会话目录
+     * 格式：docs/YYYY-MM-DD_HH-MM-SS/
+     */
+    createSession() {
+        const now = new Date();
+        const timestamp = this.formatTimestamp(now);
+        const sessionDir = path.join(this.docsDir, timestamp);
+        if (!fs.existsSync(sessionDir)) {
+            fs.mkdirSync(sessionDir, { recursive: true });
+            logger.debug(`[Forge:产物管理] 创建会话目录: ${timestamp}`);
+        }
+        this.currentSessionDir = sessionDir;
+        return sessionDir;
+    }
+    /**
+     * 获取当前会话目录（若不存在则创建）
+     */
+    getCurrentSessionDir() {
+        if (!this.currentSessionDir) {
+            return this.createSession();
+        }
+        return this.currentSessionDir;
+    }
+    /**
+     * 写入产物文件
+     */
+    writeArtifact(type, filename, content, description) {
+        const sessionDir = this.getCurrentSessionDir();
+        const filePath = path.join(sessionDir, filename);
+        fs.writeFileSync(filePath, content, 'utf-8');
+        logger.info(`[Forge:产物管理] 写入 ${type} 产物: ${filename}`);
+        // 更新索引
+        this.updateIndex(type, filename, description);
+        return filePath;
+    }
+    /**
+     * 更新 docs/INDEX.md 索引文件
+     */
+    updateIndex(type, filename, description) {
+        const sessionTimestamp = path.basename(this.getCurrentSessionDir());
+        let indexContent = '';
+        if (fs.existsSync(this.indexPath)) {
+            indexContent = fs.readFileSync(this.indexPath, 'utf-8');
+        }
+        else {
+            indexContent = '# 产物索引\n\n本文件记录所有生成的产物会话。\n\n';
+        }
+        // 查找当前会话的条目
+        const sessionHeader = `## ${sessionTimestamp}`;
+        const sessionIndex = indexContent.indexOf(sessionHeader);
+        if (sessionIndex === -1) {
+            // 新会话，追加到文件末尾
+            indexContent += `\n${sessionHeader}\n\n`;
+            indexContent += `- [${this.getTypeLabel(type)}] [${filename}](./${sessionTimestamp}/${filename}) — ${description}\n`;
+        }
+        else {
+            // 已有会话，追加产物条目
+            const lines = indexContent.split('\n');
+            const headerLineIndex = lines.findIndex(l => l === sessionHeader);
+            // 找到下一个会话标题或文件末尾
+            let insertIndex = headerLineIndex + 1;
+            while (insertIndex < lines.length && !lines[insertIndex].startsWith('## ')) {
+                insertIndex++;
+            }
+            // 在会话块末尾插入新条目
+            const newEntry = `- [${this.getTypeLabel(type)}] [${filename}](./${sessionTimestamp}/${filename}) — ${description}`;
+            lines.splice(insertIndex, 0, newEntry);
+            indexContent = lines.join('\n');
+        }
+        fs.writeFileSync(this.indexPath, indexContent, 'utf-8');
+    }
+    /**
+     * 格式化时间戳为 YYYY-MM-DD_HH-MM-SS
+     */
+    formatTimestamp(date) {
+        const year = date.getFullYear();
+        const month = String(date.getMonth() + 1).padStart(2, '0');
+        const day = String(date.getDate()).padStart(2, '0');
+        const hour = String(date.getHours()).padStart(2, '0');
+        const minute = String(date.getMinutes()).padStart(2, '0');
+        const second = String(date.getSeconds()).padStart(2, '0');
+        return `${year}-${month}-${day}_${hour}-${minute}-${second}`;
+    }
+    /**
+     * 获取产物类型的中文标签
+     */
+    getTypeLabel(type) {
+        const labels = {
+            'retrospective': '复盘报告',
+            'phase-artifact': '阶段产物',
+            'plan': '计划文档',
+            'quality-report': '质量报告',
+        };
+        return labels[type];
+    }
+    /**
+     * 列出所有产物会话
+     */
+    listSessions() {
+        if (!fs.existsSync(this.docsDir)) {
+            return [];
+        }
+        const entries = fs.readdirSync(this.docsDir, { withFileTypes: true });
+        const sessions = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name === 'design')
+                continue; // 跳过设计文档目录
+            const sessionDir = path.join(this.docsDir, entry.name);
+            const files = fs.readdirSync(sessionDir);
+            const artifacts = files.map(filename => ({
+                type: this.inferType(filename),
+                filename,
+                description: '',
+            }));
+            sessions.push({
+                timestamp: entry.name,
+                directory: sessionDir,
+                artifacts,
+            });
+        }
+        return sessions.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+    }
+    /**
+     * 根据文件名推断产物类型
+     */
+    inferType(filename) {
+        if (filename.includes('retrospective'))
+            return 'retrospective';
+        if (filename.includes('phase-'))
+            return 'phase-artifact';
+        if (filename.includes('plan'))
+            return 'plan';
+        if (filename.includes('quality'))
+            return 'quality-report';
+        return 'phase-artifact';
+    }
+}
+//# sourceMappingURL=artifact-manager.js.map

package/dist/utils/artifact-manager.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@winspan/claude-forge",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "SDLC intelligent orchestration engine for Claude Code",
   "main": "dist/cli/index.js",
   "type": "module",