@specpow/framework 0.6.1 → 0.8.0

package/dist/core/workspace/change-workspace.js

@@ -0,0 +1,75 @@
+/**
+ * ChangeWorkspace — 变更产物路径的唯一真相源
+ *
+ * ADR-001：一个变更 = 一个目录。
+ * SDD 工作区固定为变更目录下的子目录 `<changesDir>/<change>/<sddSubdir>/`，
+ * `sddSubdir` 由 `config.sdd.workspaceDir` 决定，默认 `sdd`。
+ *
+ * 归档 / 回滚 / 清理等操作一律通过 `artifacts()` 清单驱动，
+ * 新增产物类型只需在此注册，无需修改归档逻辑（ADR-002）。
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+/** 产物标识常量 */
+export const CHANGE_ROOT_ARTIFACT = 'change-root';
+export const LEGACY_SDD_ARTIFACT = 'legacy-sdd';
+/** 遗留外部 SDD 账本根目录（相对项目根） */
+export const LEGACY_SDD_ROOT = '.specpow/sdd';
+/**
+ * 解析变更目录内的 SDD 子目录名。
+ *
+ * - 旧格式（以 `.specpow` 开头，如 `.specpow/changes`）→ 回退为 `sdd`（遗留兼容）
+ * - `.` → 表示 SDD 工件直接位于变更目录根部
+ * - 其它含路径分隔符的值无法作为子目录名 → 回退默认 `sdd`
+ * - 普通子目录名 → 原样使用
+ */
+export function resolveSddSubdir(workspaceDir) {
+    const raw = (workspaceDir ?? '').trim();
+    if (!raw)
+        return 'sdd';
+    if (raw === '.')
+        return '.';
+    if (raw.startsWith('.specpow'))
+        return 'sdd';
+    if (raw.includes('/') || raw.includes('\\'))
+        return 'sdd';
+    return raw;
+}
+/**
+ * 创建变更工作区视图。
+ *
+ * @param projectRoot - 项目根目录（绝对路径）
+ * @param changeName - 变更名称
+ * @param config - 全局配置
+ */
+export function createChangeWorkspace(projectRoot, changeName, config) {
+    const changesDir = config.paths.changesDir;
+    const root = join(projectRoot, changesDir, changeName);
+    const sddSubdir = resolveSddSubdir(config.sdd?.workspaceDir);
+    const sddDir = sddSubdir === '.' ? root : join(root, sddSubdir);
+    const ledgerPath = join(sddDir, 'progress.md');
+    const legacyDir = join(projectRoot, LEGACY_SDD_ROOT, changeName);
+    return {
+        changeName,
+        root,
+        sddSubdir,
+        sddDir,
+        ledgerPath,
+        artifacts() {
+            const list = [
+                { id: CHANGE_ROOT_ARTIFACT, path: root, required: true },
+            ];
+            if (existsSync(legacyDir)) {
+                list.push({ id: LEGACY_SDD_ARTIFACT, path: legacyDir, required: false });
+            }
+            return list;
+        },
+        hasLegacySdd() {
+            return existsSync(legacyDir);
+        },
+        legacySddDir() {
+            return legacyDir;
+        },
+    };
+}
+//# sourceMappingURL=change-workspace.js.map

package/dist/core/workspace/change-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-workspace.js","sourceRoot":"","sources":["../../../src/core/workspace/change-workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,aAAa;AACb,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC;AAClD,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEhD,4BAA4B;AAC5B,MAAM,CAAC,MAAM,eAAe,GAAG,cAAc,CAAC;AA6B9C;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAuC;IACtE,MAAM,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1D,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAmB,EACnB,UAAkB,EAClB,MAAoB;IAEpB,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;IAEjE,OAAO;QACL,UAAU;QACV,IAAI;QACJ,SAAS;QACT,MAAM;QACN,UAAU;QACV,SAAS;YACP,MAAM,IAAI,GAAqB;gBAC7B,EAAE,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;aACzD,CAAC;YACF,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3E,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,YAAY;YACV,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;QACD,YAAY;YACV,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Workspace 模块 — 变更产物路径唯一真相源
+ */
+export { createChangeWorkspace, resolveSddSubdir, CHANGE_ROOT_ARTIFACT, LEGACY_SDD_ARTIFACT, LEGACY_SDD_ROOT, } from './change-workspace.js';
+export type { ChangeArtifact, ChangeWorkspace } from './change-workspace.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/workspace/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/core/workspace/index.js

@@ -0,0 +1,5 @@
+/**
+ * Workspace 模块 — 变更产物路径唯一真相源
+ */
+export { createChangeWorkspace, resolveSddSubdir, CHANGE_ROOT_ARTIFACT, LEGACY_SDD_ARTIFACT, LEGACY_SDD_ROOT, } from './change-workspace.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/workspace/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,uBAAuB,CAAC"}

package/dist/templates/claude-commands/specpow-mes.md

@@ -0,0 +1,45 @@
+# MES 功能文档转代码
+
+使用 `mes-prd-to-code` schema 从功能文档生成代码。$ARGUMENTS 为功能文档路径。
+
+## 执行步骤
+
+1. 检查当前状态：
+   ```bash
+   specpow status
+   ```
+
+2. 确认执行参数：
+   - 从 $ARGUMENTS 中提取功能文档路径
+   - 从文档名推导变更名称（如 `订单管理.md` → `order-management`）
+   - 向用户展示即将执行的命令，等待确认：
+     ```
+     即将执行：
+       变更名称: <change-name>
+       Schema: mes-prd-to-code
+       功能文档: <文档路径>
+       命令: specpow propose "<change-name>" --schema mes-prd-to-code
+
+     确认执行？(y/n)
+     ```
+   - 用户确认后执行，用户可修改变更名称
+
+3. 执行创建命令：
+   ```bash
+   specpow propose "<change-name>" --schema mes-prd-to-code
+   ```
+
+4. 按 schema 定义的工件顺序执行：
+   - parse: 读取功能文档，解析结构化信息
+   - confirm-scope: 苏格拉底式对话确认范围
+   - tech-design: 生成技术设计文档
+   - tasks: 拆分实施任务
+   - test-gen: 生成测试代码
+   - code: 生成完整代码
+
+5. 验证工件已创建：
+   ```bash
+   specpow status
+   ```
+
+6. 提示用户编辑生成的工件文件，然后运行 `/specpow-apply`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specpow/framework",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "description": "Spec-Powered AI Development Framework - 融合 OpenSpec 规范驱动 + Superpowers 执行引擎的企业级 AI 辅助编程框架",
   "type": "module",
   "main": "dist/index.js",