speccore 5.11.2 → 5.13.0

package/dist/core/next-steps.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showNextSteps = showNextSteps;
+/**
+ * next-steps — 每个阶段完成时提示下一步操作
+ */
+const logger_1 = require("../utils/logger");
+function showNextSteps(stage, context = {}) {
+    const hints = getHints(stage, context);
+    if (hints.length === 0)
+        return;
+    logger_1.logger.info('\n📋 下一步:');
+    for (const h of hints) {
+        logger_1.logger.info(`  ${h.action}`);
+        logger_1.logger.info(`     ${h.desc}`);
+        if (h.args)
+            logger_1.logger.info(`     常用参数: ${h.args}`);
+    }
+    logger_1.logger.info('');
+}
+function getHints(stage, ctx) {
+    const iter = ctx.iteration || '';
+    switch (stage) {
+        case 'init':
+            return [
+                { action: 'speccore iteration create --name=Q3', desc: '创建第一个期次', args: '--from/--to 指定时间范围' },
+                { action: 'speccore import --project=backend --path=./src', desc: '导入现有代码到全量层', args: '--type backend|frontend|shell' },
+            ];
+        case 'word2spec':
+            return [
+                { action: `speccore analyze${iter ? ` --iteration=${iter}` : ''}`, desc: '分析需求：完整性 + 源码对标 + 架构影响 → ANALYSIS.md', args: '--auto 跳过交互直接生成报告' },
+                { action: 'cat 期次-' + (iter || 'X') + '/00-需求文档/ANALYSIS.md', desc: '查看分析报告，填写技术方案部分' },
+            ];
+        case 'analyze':
+            return [
+                { action: `├─ 阻断问题 → 修复后再继续`, desc: '' },
+                { action: `└─ 无阻断 → speccore iteration split${iter ? ` --iteration=${iter}` : ''}`, desc: '拆分需求为 Task', args: '--strict 逐 Task 预览确认' },
+                { action: `补全技术方案:`, desc: '编辑 ANALYSIS.md 中的「技术方案」部分（选型/DB变更/接口依赖）' },
+            ];
+        case 'split':
+            return [
+                { action: `cat 期次-${iter || 'X'}/IMPACT.md`, desc: '查看风险评分 + 任务依赖关系' },
+                { action: `speccore execute --task=Task-001 --strict --force${iter ? ` --iteration=${iter}` : ''}`, desc: '严格模式开发：逐项确认后再生成代码' },
+                { action: `speccore execute --all --force${iter ? ` --iteration=${iter}` : ''}`, desc: '快速模式开发：AI 自动生成所有 Task 代码' },
+                { action: `speccore lifecycle --all${iter ? ` --iteration=${iter}` : ''}`, desc: '查看任务看板' },
+            ];
+        case 'execute':
+            return [
+                { action: `speccore lifecycle --task=${ctx.task || 'Task-001'} --status=testing`, desc: '推进到测试阶段' },
+                { action: `speccore lifecycle --task=${ctx.task || 'Task-001'} --check`, desc: '检查 TEST.md / REVIEW.md 进度' },
+                { action: `speccore validate --task=${ctx.task || 'Task-001'}`, desc: '校验 Spec 一致性' },
+            ];
+        case 'lifecycle':
+            return [
+                { action: '参照 backend/TEST.md 逐项验证', desc: '测试通过后推进', args: `speccore lifecycle --task=${ctx.task || 'Task-001'} --status=review` },
+                { action: '对照 backend/REVIEW.md 审查', desc: '审查通过后推进', args: `speccore lifecycle --task=${ctx.task || 'Task-001'} --status=done` },
+                { action: `speccore archive --task=${ctx.task || 'Task-001'}`, desc: '归档完成的任务' },
+            ];
+        case 'archive':
+            return [
+                { action: `speccore sync-global --iteration=${iter || 'Q3'} --direction=to_global`, desc: '同步到全量层' },
+                { action: 'speccore dashboard', desc: '查看全景仪表盘' },
+                { action: 'speccore retro', desc: '迭代回顾' },
+            ];
+        default:
+            return [];
+    }
+}
+//# sourceMappingURL=next-steps.js.map

package/dist/core/next-steps.js.map

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

package/dist/core/risk-scorer.d.ts

@@ -0,0 +1,14 @@
+/**
+ * risk-scorer — 任务风险评分 + 标签
+ */
+export interface RiskScore {
+    level: '🔴 high' | '🟡 medium' | '🟢 low';
+    score: number;
+    tags: string[];
+    reasons: string[];
+}
+/**
+ * 根据任务需求内容自动评分
+ */
+export declare function scoreRisk(content: string, taskName: string): RiskScore;
+//# sourceMappingURL=risk-scorer.d.ts.map

package/dist/core/risk-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-scorer.d.ts","sourceRoot":"","sources":["../../src/core/risk-scorer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CA2DtE"}

package/dist/core/risk-scorer.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * risk-scorer — 任务风险评分 + 标签
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scoreRisk = scoreRisk;
+/**
+ * 根据任务需求内容自动评分
+ */
+function scoreRisk(content, taskName) {
+    let score = 0;
+    const tags = [];
+    const reasons = [];
+    // ── 高风险: 支付/资金 ──
+    if (content.match(/支付|退款|转账|提现|余额|钱包|金额|价格|账单/)) {
+        score += 30;
+        tags.push('💰 支付');
+        reasons.push('涉及支付/资金操作');
+    }
+    // ── 高风险: 权限/认证 ──
+    if (content.match(/权限|角色|RBAC|认证|授权|登录|token|OAuth|JWT|鉴权/)) {
+        score += 25;
+        tags.push('🔐 权限');
+        reasons.push('涉及权限/认证变更');
+    }
+    // ── 中风险: 批量操作 ──
+    if (content.match(/批量删除|批量操作|批量导入|批量更新|全选/)) {
+        score += 20;
+        tags.push('📦 批量');
+        reasons.push('批量操作有数据风险');
+    }
+    // ── 中风险: 导出/报表 ──
+    if (content.match(/导出|报表|Excel|CSV|下载|文件生成/)) {
+        score += 15;
+        tags.push('📊 导出');
+        reasons.push('大数据量导出需注意性能');
+    }
+    // ── 中风险: 涉及数据库变更 ──
+    if (content.match(/数据表|ALTER|建表|索引|迁移|数据迁移|DDL/)) {
+        score += 15;
+        tags.push('🗄️ DB');
+        reasons.push('涉及数据库结构变更');
+    }
+    // ── 中风险: 外部依赖 ──
+    if (content.match(/第三方|外部API|回调|webhook|消息队列|Kafka|MQ/)) {
+        score += 10;
+        tags.push('🔗 外部依赖');
+        reasons.push('涉及外部系统集成');
+    }
+    // ── 低风险标记 ──
+    const crud = content.match(/\| (GET|POST|PUT|DELETE) \|/) || [];
+    if (crud.length >= 2 && score < 20) {
+        tags.push('📋 CRUD');
+    }
+    if (score < 15) {
+        tags.push('🟢 低风险');
+    }
+    const level = score >= 30 ? '🔴 high' : score >= 15 ? '🟡 medium' : '🟢 low';
+    return { level, score, tags, reasons };
+}
+//# sourceMappingURL=risk-scorer.js.map

package/dist/core/risk-scorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-scorer.js","sourceRoot":"","sources":["../../src/core/risk-scorer.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAYH,8BA2DC;AA9DD;;GAEG;AACH,SAAgB,SAAS,CAAC,OAAe,EAAE,QAAgB;IACzD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,mBAAmB;IACnB,IAAI,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,EAAE,CAAC;QAChD,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,mBAAmB;IACnB,IAAI,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,EAAE,CAAC;QAC5D,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC;QAC5C,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,mBAAmB;IACnB,IAAI,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC;QAC7C,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;IAED,qBAAqB;IACrB,IAAI,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,EAAE,CAAC;QACjD,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,EAAE,CAAC;QACxD,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IAED,cAAc;IACd,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,IAAI,EAAE,CAAC;IAChE,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACzC,CAAC"}

package/dist/locales/en-US.json

@@ -1,5 +1,8 @@
 {
-  "_meta": { "locale": "en-US", "name": "English" },
+  "_meta": {
+    "locale": "en-US",
+    "name": "English"
+  },
   "cmd": {
     "init": {
       "start": "Initializing SpecCore project...",
@@ -132,5 +135,19 @@
     "usage": "Usage: {cmd}",
     "loading": "Loading...",
     "done": "Done"
+  },
+  "task": {
+    "status": {
+      "pending": "Pending",
+      "in_progress": "In Progress",
+      "completed": "Completed",
+      "blocked": "Blocked",
+      "archived": "Archived"
+    },
+    "type": {
+      "feature": "Feature",
+      "bugfix": "Bug Fix",
+      "research": "Research"
+    }
   }
-}
+}

package/dist/locales/zh-CN.json

@@ -1,5 +1,8 @@
 {
-  "_meta": { "locale": "zh-CN", "name": "中文" },
+  "_meta": {
+    "locale": "zh-CN",
+    "name": "中文"
+  },
   "cmd": {
     "init": {
       "start": "初始化 SpecCore 项目...",
@@ -132,5 +135,19 @@
     "usage": "用法: {cmd}",
     "loading": "加载中...",
     "done": "完成"
+  },
+  "task": {
+    "status": {
+      "pending": "待开发",
+      "in_progress": "开发中",
+      "completed": "已完成",
+      "blocked": "已阻塞",
+      "archived": "已归档"
+    },
+    "type": {
+      "feature": "功能",
+      "bugfix": "修复",
+      "research": "调研"
+    }
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccore",
-  "version": "5.11.2",
+  "version": "5.13.0",
   "description": "SpecCore - Code by Spec, Not by Vibe.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",