@specpow/framework 0.6.1 → 0.7.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/package.json

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