@specpow/framework 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +307 -0
- package/LICENSE +21 -0
- package/README.md +557 -0
- package/agents/controller/sdd-controller.md +55 -0
- package/agents/execution/java-codegen-agent.md +39 -0
- package/agents/execution/ui-codegen-agent.md +32 -0
- package/agents/ops/deploy-agent.md +181 -0
- package/agents/planning/db-designer-agent.md +30 -0
- package/agents/planning/prd-agent.md +31 -0
- package/agents/quality/review-agent.md +36 -0
- package/agents/quality/test-agent.md +33 -0
- package/bin/specpow.js +10 -0
- package/dist/cli/index.d.ts +7 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +444 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/commands/apply.d.ts +14 -0
- package/dist/commands/apply.d.ts.map +1 -0
- package/dist/commands/apply.js +195 -0
- package/dist/commands/apply.js.map +1 -0
- package/dist/commands/archive.d.ts +30 -0
- package/dist/commands/archive.d.ts.map +1 -0
- package/dist/commands/archive.js +141 -0
- package/dist/commands/archive.js.map +1 -0
- package/dist/commands/channel.d.ts +61 -0
- package/dist/commands/channel.d.ts.map +1 -0
- package/dist/commands/channel.js +613 -0
- package/dist/commands/channel.js.map +1 -0
- package/dist/commands/config.d.ts +40 -0
- package/dist/commands/config.d.ts.map +1 -0
- package/dist/commands/config.js +130 -0
- package/dist/commands/config.js.map +1 -0
- package/dist/commands/debug.d.ts +45 -0
- package/dist/commands/debug.d.ts.map +1 -0
- package/dist/commands/debug.js +167 -0
- package/dist/commands/debug.js.map +1 -0
- package/dist/commands/doctor.d.ts +20 -0
- package/dist/commands/doctor.d.ts.map +1 -0
- package/dist/commands/doctor.js +121 -0
- package/dist/commands/doctor.js.map +1 -0
- package/dist/commands/execute.d.ts +25 -0
- package/dist/commands/execute.d.ts.map +1 -0
- package/dist/commands/execute.js +120 -0
- package/dist/commands/execute.js.map +1 -0
- package/dist/commands/explore.d.ts +71 -0
- package/dist/commands/explore.d.ts.map +1 -0
- package/dist/commands/explore.js +481 -0
- package/dist/commands/explore.js.map +1 -0
- package/dist/commands/init.d.ts +20 -0
- package/dist/commands/init.d.ts.map +1 -0
- package/dist/commands/init.js +146 -0
- package/dist/commands/init.js.map +1 -0
- package/dist/commands/memory.d.ts +32 -0
- package/dist/commands/memory.d.ts.map +1 -0
- package/dist/commands/memory.js +455 -0
- package/dist/commands/memory.js.map +1 -0
- package/dist/commands/propose.d.ts +13 -0
- package/dist/commands/propose.d.ts.map +1 -0
- package/dist/commands/propose.js +193 -0
- package/dist/commands/propose.js.map +1 -0
- package/dist/commands/review.d.ts +50 -0
- package/dist/commands/review.d.ts.map +1 -0
- package/dist/commands/review.js +198 -0
- package/dist/commands/review.js.map +1 -0
- package/dist/commands/schema.d.ts +22 -0
- package/dist/commands/schema.d.ts.map +1 -0
- package/dist/commands/schema.js +79 -0
- package/dist/commands/schema.js.map +1 -0
- package/dist/commands/status.d.ts +11 -0
- package/dist/commands/status.d.ts.map +1 -0
- package/dist/commands/status.js +130 -0
- package/dist/commands/status.js.map +1 -0
- package/dist/commands/store.d.ts +31 -0
- package/dist/commands/store.d.ts.map +1 -0
- package/dist/commands/store.js +109 -0
- package/dist/commands/store.js.map +1 -0
- package/dist/commands/update.d.ts +42 -0
- package/dist/commands/update.d.ts.map +1 -0
- package/dist/commands/update.js +239 -0
- package/dist/commands/update.js.map +1 -0
- package/dist/commands/verify.d.ts +39 -0
- package/dist/commands/verify.d.ts.map +1 -0
- package/dist/commands/verify.js +386 -0
- package/dist/commands/verify.js.map +1 -0
- package/dist/commands/workflow/index.d.ts +12 -0
- package/dist/commands/workflow/index.d.ts.map +1 -0
- package/dist/commands/workflow/index.js +435 -0
- package/dist/commands/workflow/index.js.map +1 -0
- package/dist/core/agent-contract.d.ts +133 -0
- package/dist/core/agent-contract.d.ts.map +1 -0
- package/dist/core/agent-contract.js +71 -0
- package/dist/core/agent-contract.js.map +1 -0
- package/dist/core/archive/delta-merger.d.ts +101 -0
- package/dist/core/archive/delta-merger.d.ts.map +1 -0
- package/dist/core/archive/delta-merger.js +398 -0
- package/dist/core/archive/delta-merger.js.map +1 -0
- package/dist/core/archive/delta-parser.d.ts +48 -0
- package/dist/core/archive/delta-parser.d.ts.map +1 -0
- package/dist/core/archive/delta-parser.js +193 -0
- package/dist/core/archive/delta-parser.js.map +1 -0
- package/dist/core/archive/engine.d.ts +136 -0
- package/dist/core/archive/engine.d.ts.map +1 -0
- package/dist/core/archive/engine.js +506 -0
- package/dist/core/archive/engine.js.map +1 -0
- package/dist/core/archive/index.d.ts +11 -0
- package/dist/core/archive/index.d.ts.map +1 -0
- package/dist/core/archive/index.js +9 -0
- package/dist/core/archive/index.js.map +1 -0
- package/dist/core/artifact-graph/graph.d.ts +48 -0
- package/dist/core/artifact-graph/graph.d.ts.map +1 -0
- package/dist/core/artifact-graph/graph.js +170 -0
- package/dist/core/artifact-graph/graph.js.map +1 -0
- package/dist/core/artifact-graph/index.d.ts +13 -0
- package/dist/core/artifact-graph/index.d.ts.map +1 -0
- package/dist/core/artifact-graph/index.js +12 -0
- package/dist/core/artifact-graph/index.js.map +1 -0
- package/dist/core/artifact-graph/instruction-loader.d.ts +60 -0
- package/dist/core/artifact-graph/instruction-loader.d.ts.map +1 -0
- package/dist/core/artifact-graph/instruction-loader.js +166 -0
- package/dist/core/artifact-graph/instruction-loader.js.map +1 -0
- package/dist/core/artifact-graph/outputs.d.ts +17 -0
- package/dist/core/artifact-graph/outputs.d.ts.map +1 -0
- package/dist/core/artifact-graph/outputs.js +27 -0
- package/dist/core/artifact-graph/outputs.js.map +1 -0
- package/dist/core/artifact-graph/resolver.d.ts +34 -0
- package/dist/core/artifact-graph/resolver.d.ts.map +1 -0
- package/dist/core/artifact-graph/resolver.js +99 -0
- package/dist/core/artifact-graph/resolver.js.map +1 -0
- package/dist/core/artifact-graph/state.d.ts +54 -0
- package/dist/core/artifact-graph/state.d.ts.map +1 -0
- package/dist/core/artifact-graph/state.js +149 -0
- package/dist/core/artifact-graph/state.js.map +1 -0
- package/dist/core/artifact-graph/types.d.ts +151 -0
- package/dist/core/artifact-graph/types.d.ts.map +1 -0
- package/dist/core/artifact-graph/types.js +44 -0
- package/dist/core/artifact-graph/types.js.map +1 -0
- package/dist/core/channel/channel-event-log.d.ts +81 -0
- package/dist/core/channel/channel-event-log.d.ts.map +1 -0
- package/dist/core/channel/channel-event-log.js +177 -0
- package/dist/core/channel/channel-event-log.js.map +1 -0
- package/dist/core/channel/channel-inbox.d.ts +70 -0
- package/dist/core/channel/channel-inbox.d.ts.map +1 -0
- package/dist/core/channel/channel-inbox.js +122 -0
- package/dist/core/channel/channel-inbox.js.map +1 -0
- package/dist/core/channel/channel-runtime.d.ts +81 -0
- package/dist/core/channel/channel-runtime.d.ts.map +1 -0
- package/dist/core/channel/channel-runtime.js +291 -0
- package/dist/core/channel/channel-runtime.js.map +1 -0
- package/dist/core/channel/channel-supervisor.d.ts +72 -0
- package/dist/core/channel/channel-supervisor.d.ts.map +1 -0
- package/dist/core/channel/channel-supervisor.js +189 -0
- package/dist/core/channel/channel-supervisor.js.map +1 -0
- package/dist/core/channel/channel-types.d.ts +169 -0
- package/dist/core/channel/channel-types.d.ts.map +1 -0
- package/dist/core/channel/channel-types.js +26 -0
- package/dist/core/channel/channel-types.js.map +1 -0
- package/dist/core/channel/index.d.ts +21 -0
- package/dist/core/channel/index.d.ts.map +1 -0
- package/dist/core/channel/index.js +23 -0
- package/dist/core/channel/index.js.map +1 -0
- package/dist/core/command-generation/index.d.ts +225 -0
- package/dist/core/command-generation/index.d.ts.map +1 -0
- package/dist/core/command-generation/index.js +462 -0
- package/dist/core/command-generation/index.js.map +1 -0
- package/dist/core/config/config-schema.d.ts +745 -0
- package/dist/core/config/config-schema.d.ts.map +1 -0
- package/dist/core/config/config-schema.js +108 -0
- package/dist/core/config/config-schema.js.map +1 -0
- package/dist/core/config/global-config.d.ts +73 -0
- package/dist/core/config/global-config.d.ts.map +1 -0
- package/dist/core/config/global-config.js +225 -0
- package/dist/core/config/global-config.js.map +1 -0
- package/dist/core/config/index.d.ts +8 -0
- package/dist/core/config/index.d.ts.map +1 -0
- package/dist/core/config/index.js +8 -0
- package/dist/core/config/index.js.map +1 -0
- package/dist/core/hooks/hook-registry.d.ts +55 -0
- package/dist/core/hooks/hook-registry.d.ts.map +1 -0
- package/dist/core/hooks/hook-registry.js +172 -0
- package/dist/core/hooks/hook-registry.js.map +1 -0
- package/dist/core/hooks/hook-types.d.ts +87 -0
- package/dist/core/hooks/hook-types.d.ts.map +1 -0
- package/dist/core/hooks/hook-types.js +11 -0
- package/dist/core/hooks/hook-types.js.map +1 -0
- package/dist/core/hooks/index.d.ts +28 -0
- package/dist/core/hooks/index.d.ts.map +1 -0
- package/dist/core/hooks/index.js +28 -0
- package/dist/core/hooks/index.js.map +1 -0
- package/dist/core/hooks/post-tool-call-hook.d.ts +21 -0
- package/dist/core/hooks/post-tool-call-hook.d.ts.map +1 -0
- package/dist/core/hooks/post-tool-call-hook.js +191 -0
- package/dist/core/hooks/post-tool-call-hook.js.map +1 -0
- package/dist/core/hooks/pre-tool-call-hook.d.ts +31 -0
- package/dist/core/hooks/pre-tool-call-hook.d.ts.map +1 -0
- package/dist/core/hooks/pre-tool-call-hook.js +122 -0
- package/dist/core/hooks/pre-tool-call-hook.js.map +1 -0
- package/dist/core/hooks/session-start-hook.d.ts +25 -0
- package/dist/core/hooks/session-start-hook.d.ts.map +1 -0
- package/dist/core/hooks/session-start-hook.js +226 -0
- package/dist/core/hooks/session-start-hook.js.map +1 -0
- package/dist/core/hooks/workflow-state-hook.d.ts +18 -0
- package/dist/core/hooks/workflow-state-hook.d.ts.map +1 -0
- package/dist/core/hooks/workflow-state-hook.js +181 -0
- package/dist/core/hooks/workflow-state-hook.js.map +1 -0
- package/dist/core/init/engine.d.ts +69 -0
- package/dist/core/init/engine.d.ts.map +1 -0
- package/dist/core/init/engine.js +211 -0
- package/dist/core/init/engine.js.map +1 -0
- package/dist/core/init/template-hash.d.ts +86 -0
- package/dist/core/init/template-hash.d.ts.map +1 -0
- package/dist/core/init/template-hash.js +228 -0
- package/dist/core/init/template-hash.js.map +1 -0
- package/dist/core/memory/adapters/json-adapter.d.ts +50 -0
- package/dist/core/memory/adapters/json-adapter.d.ts.map +1 -0
- package/dist/core/memory/adapters/json-adapter.js +273 -0
- package/dist/core/memory/adapters/json-adapter.js.map +1 -0
- package/dist/core/memory/adapters/sqlite-adapter.d.ts +26 -0
- package/dist/core/memory/adapters/sqlite-adapter.d.ts.map +1 -0
- package/dist/core/memory/adapters/sqlite-adapter.js +230 -0
- package/dist/core/memory/adapters/sqlite-adapter.js.map +1 -0
- package/dist/core/memory/index.d.ts +38 -0
- package/dist/core/memory/index.d.ts.map +1 -0
- package/dist/core/memory/index.js +40 -0
- package/dist/core/memory/index.js.map +1 -0
- package/dist/core/memory/memory-indexer.d.ts +39 -0
- package/dist/core/memory/memory-indexer.d.ts.map +1 -0
- package/dist/core/memory/memory-indexer.js +213 -0
- package/dist/core/memory/memory-indexer.js.map +1 -0
- package/dist/core/memory/memory-manager.d.ts +59 -0
- package/dist/core/memory/memory-manager.d.ts.map +1 -0
- package/dist/core/memory/memory-manager.js +194 -0
- package/dist/core/memory/memory-manager.js.map +1 -0
- package/dist/core/memory/memory-store.d.ts +31 -0
- package/dist/core/memory/memory-store.d.ts.map +1 -0
- package/dist/core/memory/memory-store.js +148 -0
- package/dist/core/memory/memory-store.js.map +1 -0
- package/dist/core/memory/memory-types.d.ts +154 -0
- package/dist/core/memory/memory-types.d.ts.map +1 -0
- package/dist/core/memory/memory-types.js +13 -0
- package/dist/core/memory/memory-types.js.map +1 -0
- package/dist/core/migration/index.d.ts +80 -0
- package/dist/core/migration/index.d.ts.map +1 -0
- package/dist/core/migration/index.js +361 -0
- package/dist/core/migration/index.js.map +1 -0
- package/dist/core/parsers/index.d.ts +95 -0
- package/dist/core/parsers/index.d.ts.map +1 -0
- package/dist/core/parsers/index.js +367 -0
- package/dist/core/parsers/index.js.map +1 -0
- package/dist/core/sdd-engine/ai-caller.d.ts +118 -0
- package/dist/core/sdd-engine/ai-caller.d.ts.map +1 -0
- package/dist/core/sdd-engine/ai-caller.js +624 -0
- package/dist/core/sdd-engine/ai-caller.js.map +1 -0
- package/dist/core/sdd-engine/controller.d.ts +107 -0
- package/dist/core/sdd-engine/controller.d.ts.map +1 -0
- package/dist/core/sdd-engine/controller.js +357 -0
- package/dist/core/sdd-engine/controller.js.map +1 -0
- package/dist/core/sdd-engine/dispatcher.d.ts +69 -0
- package/dist/core/sdd-engine/dispatcher.d.ts.map +1 -0
- package/dist/core/sdd-engine/dispatcher.js +146 -0
- package/dist/core/sdd-engine/dispatcher.js.map +1 -0
- package/dist/core/sdd-engine/git-ops.d.ts +73 -0
- package/dist/core/sdd-engine/git-ops.d.ts.map +1 -0
- package/dist/core/sdd-engine/git-ops.js +326 -0
- package/dist/core/sdd-engine/git-ops.js.map +1 -0
- package/dist/core/sdd-engine/index.d.ts +17 -0
- package/dist/core/sdd-engine/index.d.ts.map +1 -0
- package/dist/core/sdd-engine/index.js +15 -0
- package/dist/core/sdd-engine/index.js.map +1 -0
- package/dist/core/sdd-engine/ledger.d.ts +92 -0
- package/dist/core/sdd-engine/ledger.d.ts.map +1 -0
- package/dist/core/sdd-engine/ledger.js +273 -0
- package/dist/core/sdd-engine/ledger.js.map +1 -0
- package/dist/core/sdd-engine/model-selector.d.ts +49 -0
- package/dist/core/sdd-engine/model-selector.d.ts.map +1 -0
- package/dist/core/sdd-engine/model-selector.js +76 -0
- package/dist/core/sdd-engine/model-selector.js.map +1 -0
- package/dist/core/sdd-engine/parallel-dispatcher.d.ts +99 -0
- package/dist/core/sdd-engine/parallel-dispatcher.d.ts.map +1 -0
- package/dist/core/sdd-engine/parallel-dispatcher.js +350 -0
- package/dist/core/sdd-engine/parallel-dispatcher.js.map +1 -0
- package/dist/core/sdd-engine/review-loop.d.ts +61 -0
- package/dist/core/sdd-engine/review-loop.d.ts.map +1 -0
- package/dist/core/sdd-engine/review-loop.js +139 -0
- package/dist/core/sdd-engine/review-loop.js.map +1 -0
- package/dist/core/sdd-engine/types.d.ts +104 -0
- package/dist/core/sdd-engine/types.d.ts.map +1 -0
- package/dist/core/sdd-engine/types.js +7 -0
- package/dist/core/sdd-engine/types.js.map +1 -0
- package/dist/core/store/index.d.ts +78 -0
- package/dist/core/store/index.d.ts.map +1 -0
- package/dist/core/store/index.js +182 -0
- package/dist/core/store/index.js.map +1 -0
- package/dist/core/templates/index.d.ts +58 -0
- package/dist/core/templates/index.d.ts.map +1 -0
- package/dist/core/templates/index.js +158 -0
- package/dist/core/templates/index.js.map +1 -0
- package/dist/core/validation/index.d.ts +34 -0
- package/dist/core/validation/index.d.ts.map +1 -0
- package/dist/core/validation/index.js +153 -0
- package/dist/core/validation/index.js.map +1 -0
- package/dist/core/workflow-state.d.ts +96 -0
- package/dist/core/workflow-state.d.ts.map +1 -0
- package/dist/core/workflow-state.js +284 -0
- package/dist/core/workflow-state.js.map +1 -0
- package/dist/index.d.ts +18 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +21 -0
- package/dist/index.js.map +1 -0
- package/dist/utils/index.d.ts +48 -0
- package/dist/utils/index.d.ts.map +1 -0
- package/dist/utils/index.js +119 -0
- package/dist/utils/index.js.map +1 -0
- package/hooks/hooks.json +30 -0
- package/hooks/run-hook.cmd +19 -0
- package/hooks/session-start +62 -0
- package/hooks/workflow-state +150 -0
- package/package.json +122 -0
- package/schemas/bug-fix/schema.yaml +64 -0
- package/schemas/bug-fix/templates/analysis.md +43 -0
- package/schemas/bug-fix/templates/fix-plan.md +19 -0
- package/schemas/bug-fix/templates/proposal.md +30 -0
- package/schemas/crud-module/schema.yaml +65 -0
- package/schemas/crud-module/templates/design.md +36 -0
- package/schemas/crud-module/templates/proposal.md +30 -0
- package/schemas/crud-module/templates/spec.md +33 -0
- package/schemas/crud-module/templates/tasks.md +57 -0
- package/schemas/spec-driven/schema.yaml +87 -0
- package/schemas/spec-driven/templates/design.md +54 -0
- package/schemas/spec-driven/templates/proposal.md +31 -0
- package/schemas/spec-driven/templates/spec.md +44 -0
- package/schemas/spec-driven/templates/tasks.md +98 -0
- package/skills/business-code-review/SKILL.md +78 -0
- package/skills/business-db-design/SKILL.md +74 -0
- package/skills/business-deploy-check/SKILL.md +72 -0
- package/skills/business-doc-sync/SKILL.md +72 -0
- package/skills/business-java-codegen/SKILL.md +97 -0
- package/skills/business-menu-register/SKILL.md +63 -0
- package/skills/business-prd-writer/SKILL.md +80 -0
- package/skills/business-test-gen/SKILL.md +82 -0
- package/skills/business-ui-codegen/SKILL.md +104 -0
- package/skills/execution-finish-branch/SKILL.md +58 -0
- package/skills/execution-git-worktrees/SKILL.md +48 -0
- package/skills/execution-parallel-agents/SKILL.md +51 -0
- package/skills/execution-receiving-review/SKILL.md +47 -0
- package/skills/execution-requesting-review/SKILL.md +51 -0
- package/skills/execution-subagent-driven-dev/SKILL.md +148 -0
- package/skills/execution-systematic-debugging/SKILL.md +95 -0
- package/skills/execution-tdd/SKILL.md +74 -0
- package/skills/execution-verification-before-completion/SKILL.md +75 -0
- package/skills/meta-create-skill/SKILL.md +374 -0
- package/skills/meta-using-skills/SKILL.md +97 -0
- package/skills/meta-writing-skills/SKILL.md +66 -0
- package/skills/planning-apply-change/SKILL.md +199 -0
- package/skills/planning-archive-change/SKILL.md +43 -0
- package/skills/planning-explore/SKILL.md +108 -0
- package/skills/planning-onboard/SKILL.md +60 -0
- package/skills/planning-propose/SKILL.md +145 -0
- package/skills/planning-update-change/SKILL.md +45 -0
- package/skills/planning-verify-change/SKILL.md +58 -0
- package/skills/planning-write-design/SKILL.md +59 -0
- package/skills/planning-write-plans/SKILL.md +55 -0
- package/skills/planning-write-specs/SKILL.md +73 -0
|
@@ -0,0 +1,506 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Archive Engine — 移植自 OpenSpec archive.ts (82KB)
|
|
3
|
+
*
|
|
4
|
+
* 事务性归档引擎,核心特性:
|
|
5
|
+
* - 三态决策:write / retire / skip
|
|
6
|
+
* - 并发安全的指纹验证机制
|
|
7
|
+
* - 预览-验证-写入-移动-回滚多阶段流程
|
|
8
|
+
* - 支持批量归档和并行处理
|
|
9
|
+
*
|
|
10
|
+
* **I/O 策略**: 当前全部使用 fs *Sync 变体。
|
|
11
|
+
* 对于 CLI 工具这是可接受的(单用户、阻塞主线程无副作用)。
|
|
12
|
+
* 如需迁移为 API/Server 模式,需将以下方法改为 async 并使用 fs.promises:
|
|
13
|
+
* archive(), archiveBatch(), rollback(), captureSnapshot(), restoreSnapshot()
|
|
14
|
+
*/
|
|
15
|
+
import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, renameSync, unlinkSync } from 'fs';
|
|
16
|
+
import { join, relative, dirname } from 'path';
|
|
17
|
+
import { randomBytes } from 'crypto';
|
|
18
|
+
import { mergeDeltaSpec } from './delta-merger.js';
|
|
19
|
+
// ============================================================
|
|
20
|
+
// 常量
|
|
21
|
+
// ============================================================
|
|
22
|
+
const ARCHIVE_DATE_PREFIX = /^\d{4}-\d{2}-\d{2}-/;
|
|
23
|
+
// ============================================================
|
|
24
|
+
// 辅助函数
|
|
25
|
+
// ============================================================
|
|
26
|
+
function formatArchiveDirName(changeName) {
|
|
27
|
+
// 安全过滤:移除路径分隔符、穿越字符和 Windows 非法字符
|
|
28
|
+
const safeName = changeName
|
|
29
|
+
.replace(/[\\/]/g, '-') // 路径分隔符 → 连字符
|
|
30
|
+
.replace(/\.\./g, '_') // 路径穿越 → 下划线
|
|
31
|
+
.replace(/[<>:"|?*]/g, '_') // Windows 非法字符 → 下划线
|
|
32
|
+
.replace(/^\.+|-+$/g, ''); // 移除首尾点号和连字符
|
|
33
|
+
if (!safeName) {
|
|
34
|
+
throw new Error(`Invalid archive name: ${changeName}`);
|
|
35
|
+
}
|
|
36
|
+
const dateStr = new Date().toISOString().split('T')[0]; // YYYY-MM-DD
|
|
37
|
+
return ARCHIVE_DATE_PREFIX.test(safeName) ? safeName : `${dateStr}-${safeName}`;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* 原子声明归档目标(通过文件锁)
|
|
41
|
+
*/
|
|
42
|
+
function claimArchiveDestination(archiveDir, claimFile) {
|
|
43
|
+
const claimPath = join(archiveDir, claimFile);
|
|
44
|
+
try {
|
|
45
|
+
const handle = randomBytes(8).toString('hex');
|
|
46
|
+
writeFileSync(claimPath, handle, { flag: 'wx' });
|
|
47
|
+
return { handle, contents: handle };
|
|
48
|
+
}
|
|
49
|
+
catch {
|
|
50
|
+
// 文件已存在 = 已被其他进程声明
|
|
51
|
+
return null;
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* 递归读取目录中所有 Markdown 文件
|
|
56
|
+
*/
|
|
57
|
+
function readAllMarkdown(dir, baseDir) {
|
|
58
|
+
const results = [];
|
|
59
|
+
const root = baseDir || dir;
|
|
60
|
+
function walk(current) {
|
|
61
|
+
if (!existsSync(current))
|
|
62
|
+
return;
|
|
63
|
+
const entries = readdirSync(current, { withFileTypes: true });
|
|
64
|
+
for (const entry of entries) {
|
|
65
|
+
const fullPath = join(current, entry.name);
|
|
66
|
+
if (entry.isDirectory()) {
|
|
67
|
+
walk(fullPath);
|
|
68
|
+
}
|
|
69
|
+
else if (entry.name.endsWith('.md')) {
|
|
70
|
+
results.push(relative(root, fullPath));
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
walk(dir);
|
|
75
|
+
return results;
|
|
76
|
+
}
|
|
77
|
+
// ============================================================
|
|
78
|
+
// Archive Engine
|
|
79
|
+
// ============================================================
|
|
80
|
+
export class ArchiveEngine {
|
|
81
|
+
projectRoot;
|
|
82
|
+
warnings = [];
|
|
83
|
+
constructor(projectRoot) {
|
|
84
|
+
this.projectRoot = projectRoot;
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* 执行归档
|
|
88
|
+
*
|
|
89
|
+
* 六阶段事务流程:
|
|
90
|
+
* 1. PREVIEW — 发现变更,预览操作
|
|
91
|
+
* 2. VALIDATE — 验证完整性
|
|
92
|
+
* 3. CONFIRM — 用户确认
|
|
93
|
+
* 4. WRITE — 写入合并结果
|
|
94
|
+
* 5. MOVE — 移动变更到归档
|
|
95
|
+
* 6. VERIFY — 最终验证
|
|
96
|
+
*
|
|
97
|
+
* 注:当前实现为纯同步操作,保留 async 签名以确保 Promise 接口一致性
|
|
98
|
+
* (测试使用 .rejects.toThrow,调用方使用 await)
|
|
99
|
+
*/
|
|
100
|
+
async archive(changeName, options = {}) {
|
|
101
|
+
this.warnings = [];
|
|
102
|
+
const changesDir = join(this.projectRoot, 'openspec', 'changes');
|
|
103
|
+
const archiveDir = join(changesDir, 'archive');
|
|
104
|
+
const mainSpecsDir = join(this.projectRoot, 'openspec', 'specs');
|
|
105
|
+
const changeDir = join(changesDir, changeName);
|
|
106
|
+
// ============================================================
|
|
107
|
+
// Phase 1: PREVIEW
|
|
108
|
+
// ============================================================
|
|
109
|
+
if (!existsSync(changeDir)) {
|
|
110
|
+
throw new Error(`Change "${changeName}" not found at ${changeDir}`);
|
|
111
|
+
}
|
|
112
|
+
if (!existsSync(archiveDir)) {
|
|
113
|
+
mkdirSync(archiveDir, { recursive: true });
|
|
114
|
+
}
|
|
115
|
+
const archiveName = formatArchiveDirName(changeName);
|
|
116
|
+
const destArchiveDir = join(archiveDir, archiveName);
|
|
117
|
+
// 检查目标是否已存在
|
|
118
|
+
if (existsSync(destArchiveDir) && !options.force) {
|
|
119
|
+
throw new Error(`Archive destination already exists: ${archiveName}. Use --force to overwrite.`);
|
|
120
|
+
}
|
|
121
|
+
// ============================================================
|
|
122
|
+
// Phase 2: 发现 Spec 变更
|
|
123
|
+
// ============================================================
|
|
124
|
+
const mutations = options.skipSpecs ? [] : this.findSpecMutations(changeDir, mainSpecsDir);
|
|
125
|
+
// 从原始 delta 文件计算标记数(合并后标记会被替换,必须在合并前计算)
|
|
126
|
+
const changeSpecsDir = join(changeDir, 'specs');
|
|
127
|
+
const deltaCounts = { added: 0, modified: 0, removed: 0 };
|
|
128
|
+
if (existsSync(changeSpecsDir)) {
|
|
129
|
+
const deltaFiles = readAllMarkdown(changeSpecsDir);
|
|
130
|
+
for (const relPath of deltaFiles) {
|
|
131
|
+
const fullPath = join(changeSpecsDir, relPath);
|
|
132
|
+
const content = readFileSync(fullPath, 'utf-8');
|
|
133
|
+
deltaCounts.added += (content.match(/##\s+ADDED[:\s]/gi) || []).length;
|
|
134
|
+
deltaCounts.modified += (content.match(/##\s+MODIFIED[:\s]/gi) || []).length;
|
|
135
|
+
deltaCounts.removed += (content.match(/##\s+REMOVED[:\s]/gi) || []).length;
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
const totals = {
|
|
139
|
+
added: deltaCounts.added,
|
|
140
|
+
modified: deltaCounts.modified,
|
|
141
|
+
removed: deltaCounts.removed,
|
|
142
|
+
total: mutations.length,
|
|
143
|
+
};
|
|
144
|
+
// Preview
|
|
145
|
+
if (!options.yes) {
|
|
146
|
+
console.log(`\n📋 预览归档操作:`);
|
|
147
|
+
console.log(` 变更: ${changeName}`);
|
|
148
|
+
console.log(` 归档为: ${archiveName}`);
|
|
149
|
+
console.log(` Specs: ${totals.total} 个 (${totals.added} 新增, ${totals.modified} 修改, ${totals.removed} 退休)`);
|
|
150
|
+
console.log(` 目标: ${relative(this.projectRoot, destArchiveDir)}\n`);
|
|
151
|
+
}
|
|
152
|
+
// ============================================================
|
|
153
|
+
// Phase 3: 保存 Spec 快照
|
|
154
|
+
// ============================================================
|
|
155
|
+
const snapshot = this.captureSnapshot(mainSpecsDir);
|
|
156
|
+
try {
|
|
157
|
+
// ============================================================
|
|
158
|
+
// Phase 4: WRITE
|
|
159
|
+
// ============================================================
|
|
160
|
+
let specsUpdated = 0;
|
|
161
|
+
for (const mutation of mutations) {
|
|
162
|
+
const targetDir = dirname(mutation.target);
|
|
163
|
+
if (!existsSync(targetDir)) {
|
|
164
|
+
mkdirSync(targetDir, { recursive: true });
|
|
165
|
+
}
|
|
166
|
+
switch (mutation.outcome) {
|
|
167
|
+
case 'write':
|
|
168
|
+
writeFileSync(mutation.target, mutation.content, 'utf-8');
|
|
169
|
+
specsUpdated++;
|
|
170
|
+
break;
|
|
171
|
+
case 'retire':
|
|
172
|
+
// 退休:标记为已删除(重命名为 .retired)
|
|
173
|
+
if (existsSync(mutation.target)) {
|
|
174
|
+
renameSync(mutation.target, mutation.target + '.retired');
|
|
175
|
+
specsUpdated++;
|
|
176
|
+
}
|
|
177
|
+
break;
|
|
178
|
+
case 'skip':
|
|
179
|
+
break;
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
// ============================================================
|
|
183
|
+
// Phase 5: MOVE — 原子移动变更到归档
|
|
184
|
+
// ============================================================
|
|
185
|
+
if (options.force && existsSync(destArchiveDir)) {
|
|
186
|
+
// 强制模式:重命名已存在的归档
|
|
187
|
+
const backupName = `${archiveName}.bak-${Date.now().toString(36)}`;
|
|
188
|
+
renameSync(destArchiveDir, join(archiveDir, backupName));
|
|
189
|
+
// 清理旧 claim 文件以允许重新声明
|
|
190
|
+
const oldClaimPath = join(archiveDir, `.claim-${archiveName}`);
|
|
191
|
+
if (existsSync(oldClaimPath)) {
|
|
192
|
+
unlinkSync(oldClaimPath);
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
// 原子声明目标
|
|
196
|
+
const claim = claimArchiveDestination(archiveDir, `.claim-${archiveName}`);
|
|
197
|
+
if (!claim) {
|
|
198
|
+
throw new Error(`Archive destination "${archiveName}" is being claimed by another process.`);
|
|
199
|
+
}
|
|
200
|
+
renameSync(changeDir, destArchiveDir);
|
|
201
|
+
// ============================================================
|
|
202
|
+
// Phase 6: 持久化 Spec 快照 + 写归档元数据
|
|
203
|
+
// ============================================================
|
|
204
|
+
this.saveSnapshotToArchive(destArchiveDir, snapshot);
|
|
205
|
+
const metadata = {
|
|
206
|
+
change: changeName,
|
|
207
|
+
archivedAt: new Date().toISOString(),
|
|
208
|
+
specsUpdated,
|
|
209
|
+
totals,
|
|
210
|
+
warnings: this.warnings,
|
|
211
|
+
};
|
|
212
|
+
writeFileSync(join(destArchiveDir, '_ARCHIVE_METADATA.json'), JSON.stringify(metadata, null, 2), 'utf-8');
|
|
213
|
+
// P2-9: 清理 claim 文件,避免残留
|
|
214
|
+
const claimPath = join(archiveDir, `.claim-${archiveName}`);
|
|
215
|
+
if (existsSync(claimPath)) {
|
|
216
|
+
try {
|
|
217
|
+
unlinkSync(claimPath);
|
|
218
|
+
}
|
|
219
|
+
catch (e) {
|
|
220
|
+
console.warn(`Warning: failed to clean up claim file: ${e.message}`);
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
return {
|
|
224
|
+
change: changeName,
|
|
225
|
+
archivedAs: archiveName,
|
|
226
|
+
path: destArchiveDir,
|
|
227
|
+
specsUpdated,
|
|
228
|
+
totals,
|
|
229
|
+
warnings: this.warnings,
|
|
230
|
+
};
|
|
231
|
+
}
|
|
232
|
+
catch (err) {
|
|
233
|
+
// Rollback: 恢复 spec 快照
|
|
234
|
+
this.restoreSnapshot(snapshot);
|
|
235
|
+
throw err;
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
/**
|
|
239
|
+
* 批量归档
|
|
240
|
+
*
|
|
241
|
+
* 支持并行处理多个独立的变更
|
|
242
|
+
*/
|
|
243
|
+
async archiveBatch(changeNames, options = {}) {
|
|
244
|
+
const results = [];
|
|
245
|
+
for (const name of changeNames) {
|
|
246
|
+
try {
|
|
247
|
+
const result = await this.archive(name, options);
|
|
248
|
+
results.push(result);
|
|
249
|
+
}
|
|
250
|
+
catch (err) {
|
|
251
|
+
results.push({
|
|
252
|
+
change: name,
|
|
253
|
+
archivedAs: '',
|
|
254
|
+
path: '',
|
|
255
|
+
specsUpdated: 0,
|
|
256
|
+
totals: { added: 0, modified: 0, removed: 0, total: 0 },
|
|
257
|
+
warnings: [`Archive failed: ${err.message}`],
|
|
258
|
+
});
|
|
259
|
+
}
|
|
260
|
+
}
|
|
261
|
+
return results;
|
|
262
|
+
}
|
|
263
|
+
/**
|
|
264
|
+
* 回滚归档
|
|
265
|
+
*
|
|
266
|
+
* 从归档目录恢复变更
|
|
267
|
+
*/
|
|
268
|
+
async rollback(archiveName) {
|
|
269
|
+
const archiveDir = join(this.projectRoot, 'openspec', 'changes', 'archive');
|
|
270
|
+
const archivedPath = join(archiveDir, archiveName);
|
|
271
|
+
const changesDir = join(this.projectRoot, 'openspec', 'changes');
|
|
272
|
+
if (!existsSync(archivedPath)) {
|
|
273
|
+
throw new Error(`Archive "${archiveName}" not found`);
|
|
274
|
+
}
|
|
275
|
+
const changeName = archiveName.replace(ARCHIVE_DATE_PREFIX, '');
|
|
276
|
+
const targetPath = join(changesDir, changeName);
|
|
277
|
+
if (existsSync(targetPath)) {
|
|
278
|
+
throw new Error(`Change "${changeName}" already exists. Remove it first.`);
|
|
279
|
+
}
|
|
280
|
+
// 读取元数据
|
|
281
|
+
const metadataPath = join(archivedPath, '_ARCHIVE_METADATA.json');
|
|
282
|
+
if (!existsSync(metadataPath)) {
|
|
283
|
+
this.warnings.push(`No metadata found at ${metadataPath}, performing file-only rollback`);
|
|
284
|
+
}
|
|
285
|
+
// 恢复主 specs 目录(从归档中保存的快照)
|
|
286
|
+
const snapshot = this.loadSnapshotFromArchive(archivedPath);
|
|
287
|
+
if (snapshot) {
|
|
288
|
+
this.restoreSnapshot(snapshot);
|
|
289
|
+
}
|
|
290
|
+
else {
|
|
291
|
+
this.warnings.push(`No spec snapshot found in archive — main specs/ directory was NOT restored. Check ${metadataPath} for original state.`);
|
|
292
|
+
}
|
|
293
|
+
renameSync(archivedPath, targetPath);
|
|
294
|
+
}
|
|
295
|
+
/**
|
|
296
|
+
* 列出所有归档
|
|
297
|
+
*/
|
|
298
|
+
listArchives() {
|
|
299
|
+
const archiveDir = join(this.projectRoot, 'openspec', 'changes', 'archive');
|
|
300
|
+
if (!existsSync(archiveDir))
|
|
301
|
+
return [];
|
|
302
|
+
return readdirSync(archiveDir, { withFileTypes: true })
|
|
303
|
+
.filter(d => d.isDirectory() && ARCHIVE_DATE_PREFIX.test(d.name))
|
|
304
|
+
.map(d => {
|
|
305
|
+
const metaPath = join(archiveDir, d.name, '_ARCHIVE_METADATA.json');
|
|
306
|
+
let archivedAt = '';
|
|
307
|
+
if (existsSync(metaPath)) {
|
|
308
|
+
try {
|
|
309
|
+
const meta = JSON.parse(readFileSync(metaPath, 'utf-8'));
|
|
310
|
+
archivedAt = meta.archivedAt || '';
|
|
311
|
+
}
|
|
312
|
+
catch { }
|
|
313
|
+
}
|
|
314
|
+
return {
|
|
315
|
+
name: d.name,
|
|
316
|
+
path: join(archiveDir, d.name),
|
|
317
|
+
archivedAt,
|
|
318
|
+
};
|
|
319
|
+
})
|
|
320
|
+
.sort((a, b) => b.name.localeCompare(a.name)); // 最新的在前
|
|
321
|
+
}
|
|
322
|
+
// ============================================================
|
|
323
|
+
// 私有方法
|
|
324
|
+
// ============================================================
|
|
325
|
+
/**
|
|
326
|
+
* 发现 spec 变更
|
|
327
|
+
*
|
|
328
|
+
* 扫描 change/specs/ 目录,与主 specs/ 目录比较,
|
|
329
|
+
* 使用 ADDED/MODIFIED/REMOVED 标记决定处理方式
|
|
330
|
+
*/
|
|
331
|
+
findSpecMutations(changeDir, mainSpecsDir) {
|
|
332
|
+
const changeSpecsDir = join(changeDir, 'specs');
|
|
333
|
+
const mutations = [];
|
|
334
|
+
if (!existsSync(changeSpecsDir)) {
|
|
335
|
+
return mutations;
|
|
336
|
+
}
|
|
337
|
+
// 读取变更中的 spec 文件
|
|
338
|
+
const deltaFiles = readAllMarkdown(changeSpecsDir);
|
|
339
|
+
for (const relPath of deltaFiles) {
|
|
340
|
+
const sourcePath = join(changeSpecsDir, relPath);
|
|
341
|
+
const targetPath = join(mainSpecsDir, relPath);
|
|
342
|
+
const content = readFileSync(sourcePath, 'utf-8');
|
|
343
|
+
// 解析 delta 标记
|
|
344
|
+
const hasRemoved = /##\s+REMOVED:/i.test(content);
|
|
345
|
+
const hasAdded = /##\s+ADDED:/i.test(content);
|
|
346
|
+
const hasModified = /##\s+MODIFIED:/i.test(content);
|
|
347
|
+
if (hasRemoved && !hasAdded && !hasModified) {
|
|
348
|
+
// 纯退休标记
|
|
349
|
+
mutations.push({
|
|
350
|
+
source: sourcePath,
|
|
351
|
+
target: targetPath,
|
|
352
|
+
outcome: 'retire',
|
|
353
|
+
content: '',
|
|
354
|
+
});
|
|
355
|
+
}
|
|
356
|
+
else if (existsSync(targetPath) && (hasAdded || hasModified)) {
|
|
357
|
+
// 修改现有 spec
|
|
358
|
+
mutations.push({
|
|
359
|
+
source: sourcePath,
|
|
360
|
+
target: targetPath,
|
|
361
|
+
outcome: 'write',
|
|
362
|
+
content: this.mergeDelta(content, readFileSync(targetPath, 'utf-8')),
|
|
363
|
+
});
|
|
364
|
+
}
|
|
365
|
+
else if (!existsSync(targetPath) && (hasAdded || hasModified || hasRemoved)) {
|
|
366
|
+
// 新 spec(必须有 delta 标记才写入)
|
|
367
|
+
mutations.push({
|
|
368
|
+
source: sourcePath,
|
|
369
|
+
target: targetPath,
|
|
370
|
+
outcome: 'write',
|
|
371
|
+
content,
|
|
372
|
+
});
|
|
373
|
+
}
|
|
374
|
+
else {
|
|
375
|
+
// 无变更标记 → 跳过
|
|
376
|
+
mutations.push({
|
|
377
|
+
source: sourcePath,
|
|
378
|
+
target: targetPath,
|
|
379
|
+
outcome: 'skip',
|
|
380
|
+
content,
|
|
381
|
+
});
|
|
382
|
+
}
|
|
383
|
+
}
|
|
384
|
+
return mutations;
|
|
385
|
+
}
|
|
386
|
+
/**
|
|
387
|
+
* 合并 delta 到已有内容
|
|
388
|
+
*
|
|
389
|
+
* 使用结构化合并算法(移植自 OpenSpec),支持:
|
|
390
|
+
* - 四阶段合并顺序:RENAMED → REMOVED → MODIFIED → ADDED
|
|
391
|
+
* - 冲突检测与报告
|
|
392
|
+
* - 幂等性检查(已同步则跳过)
|
|
393
|
+
* - 场景丢失守卫(默认启用)
|
|
394
|
+
* - 能力退休(REMOVED 默认标记为 [RETIRED])
|
|
395
|
+
* - 未计入内容检测(默认启用)
|
|
396
|
+
* - 代码围栏掩码(防止代码块内容被误匹配)
|
|
397
|
+
*/
|
|
398
|
+
mergeDelta(delta, existing) {
|
|
399
|
+
const result = mergeDeltaSpec(existing, delta, { force: false });
|
|
400
|
+
// 如果有冲突,记录警告但继续合并
|
|
401
|
+
if (result.conflicts.length > 0) {
|
|
402
|
+
for (const conflict of result.conflicts) {
|
|
403
|
+
this.warnings.push(`Merge conflict: ${conflict}`);
|
|
404
|
+
}
|
|
405
|
+
}
|
|
406
|
+
// 记录未计入内容警告
|
|
407
|
+
if (result.unaccountedWarnings.length > 0) {
|
|
408
|
+
for (const warning of result.unaccountedWarnings) {
|
|
409
|
+
this.warnings.push(`Unaccounted content: ${warning}`);
|
|
410
|
+
}
|
|
411
|
+
}
|
|
412
|
+
return result.content;
|
|
413
|
+
}
|
|
414
|
+
/**
|
|
415
|
+
* 将 spec 快照持久化到归档目录,供 rollback 使用
|
|
416
|
+
*/
|
|
417
|
+
saveSnapshotToArchive(archiveDirPath, snapshot) {
|
|
418
|
+
const snapshotDir = join(archiveDirPath, '_SPEC_SNAPSHOT');
|
|
419
|
+
mkdirSync(snapshotDir, { recursive: true });
|
|
420
|
+
const manifest = [];
|
|
421
|
+
for (const [relPath, content] of snapshot.files) {
|
|
422
|
+
const fullPath = join(snapshotDir, relPath);
|
|
423
|
+
const dir = dirname(fullPath);
|
|
424
|
+
if (!existsSync(dir)) {
|
|
425
|
+
mkdirSync(dir, { recursive: true });
|
|
426
|
+
}
|
|
427
|
+
writeFileSync(fullPath, content, 'utf-8');
|
|
428
|
+
manifest.push({ relPath });
|
|
429
|
+
}
|
|
430
|
+
writeFileSync(join(snapshotDir, '_MANIFEST.json'), JSON.stringify({ basePath: snapshot.path, files: manifest }, null, 2), 'utf-8');
|
|
431
|
+
}
|
|
432
|
+
/**
|
|
433
|
+
* 从归档目录加载 spec 快照
|
|
434
|
+
*/
|
|
435
|
+
loadSnapshotFromArchive(archiveDirPath) {
|
|
436
|
+
const snapshotDir = join(archiveDirPath, '_SPEC_SNAPSHOT');
|
|
437
|
+
const manifestPath = join(snapshotDir, '_MANIFEST.json');
|
|
438
|
+
if (!existsSync(manifestPath)) {
|
|
439
|
+
return null;
|
|
440
|
+
}
|
|
441
|
+
try {
|
|
442
|
+
const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
|
|
443
|
+
const files = new Map();
|
|
444
|
+
const basePath = manifest.basePath;
|
|
445
|
+
for (const entry of manifest.files) {
|
|
446
|
+
const fullPath = join(snapshotDir, entry.relPath);
|
|
447
|
+
if (existsSync(fullPath)) {
|
|
448
|
+
files.set(entry.relPath, readFileSync(fullPath, 'utf-8'));
|
|
449
|
+
}
|
|
450
|
+
}
|
|
451
|
+
return { files, path: basePath };
|
|
452
|
+
}
|
|
453
|
+
catch {
|
|
454
|
+
return null;
|
|
455
|
+
}
|
|
456
|
+
}
|
|
457
|
+
/**
|
|
458
|
+
* 捕获 spec 目录快照
|
|
459
|
+
*
|
|
460
|
+
* 记录所有已有文件的内容,以及文件列表(用于回滚时删除新建文件)
|
|
461
|
+
*/
|
|
462
|
+
captureSnapshot(specsDir) {
|
|
463
|
+
const files = new Map();
|
|
464
|
+
if (existsSync(specsDir)) {
|
|
465
|
+
const mdFiles = readAllMarkdown(specsDir);
|
|
466
|
+
for (const relPath of mdFiles) {
|
|
467
|
+
const fullPath = join(specsDir, relPath);
|
|
468
|
+
files.set(relPath, readFileSync(fullPath, 'utf-8'));
|
|
469
|
+
}
|
|
470
|
+
}
|
|
471
|
+
return { files, path: specsDir };
|
|
472
|
+
}
|
|
473
|
+
/**
|
|
474
|
+
* 恢复 spec 快照(回滚)
|
|
475
|
+
*
|
|
476
|
+
* 1. 恢复快照中已有文件的内容
|
|
477
|
+
* 2. 删除快照之后新建的文件(不在快照中的文件)
|
|
478
|
+
*/
|
|
479
|
+
restoreSnapshot(snapshot) {
|
|
480
|
+
// 恢复已有文件
|
|
481
|
+
for (const [relPath, content] of snapshot.files) {
|
|
482
|
+
const fullPath = join(snapshot.path, relPath);
|
|
483
|
+
const dir = dirname(fullPath);
|
|
484
|
+
if (!existsSync(dir)) {
|
|
485
|
+
mkdirSync(dir, { recursive: true });
|
|
486
|
+
}
|
|
487
|
+
writeFileSync(fullPath, content, 'utf-8');
|
|
488
|
+
}
|
|
489
|
+
// 删除快照之后新建的文件
|
|
490
|
+
if (existsSync(snapshot.path)) {
|
|
491
|
+
const currentFiles = readAllMarkdown(snapshot.path);
|
|
492
|
+
for (const relPath of currentFiles) {
|
|
493
|
+
if (!snapshot.files.has(relPath)) {
|
|
494
|
+
const fullPath = join(snapshot.path, relPath);
|
|
495
|
+
try {
|
|
496
|
+
unlinkSync(fullPath);
|
|
497
|
+
}
|
|
498
|
+
catch {
|
|
499
|
+
// 删除失败不阻塞回滚
|
|
500
|
+
}
|
|
501
|
+
}
|
|
502
|
+
}
|
|
503
|
+
}
|
|
504
|
+
}
|
|
505
|
+
}
|
|
506
|
+
//# sourceMappingURL=engine.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/core/archive/engine.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Archive 模块 — Delta Spec 解析与合并
|
|
3
|
+
*
|
|
4
|
+
* P1-5: 借鉴 OpenSpec 的结构化合并算法
|
|
5
|
+
*/
|
|
6
|
+
export { parseDelta, normalizeBlockContent, extractRequirementBlock, isBlockIdentical } from './delta-parser.js';
|
|
7
|
+
export type { DeltaAction, DeltaBlock, RenameMapping, ParsedDelta } from './delta-parser.js';
|
|
8
|
+
export { mergeDeltaSpec, buildCodeFenceMask, maskCodeFences, unmaskCodeFences, extractScenarios, findMissingScenarios, detectUnaccountedContent, } from './delta-merger.js';
|
|
9
|
+
export type { MergeResult, MergeOptions } from './delta-merger.js';
|
|
10
|
+
export { ArchiveEngine } from './engine.js';
|
|
11
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/archive/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACjH,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Archive 模块 — Delta Spec 解析与合并
|
|
3
|
+
*
|
|
4
|
+
* P1-5: 借鉴 OpenSpec 的结构化合并算法
|
|
5
|
+
*/
|
|
6
|
+
export { parseDelta, normalizeBlockContent, extractRequirementBlock, isBlockIdentical } from './delta-parser.js';
|
|
7
|
+
export { mergeDeltaSpec, buildCodeFenceMask, maskCodeFences, unmaskCodeFences, extractScenarios, findMissingScenarios, detectUnaccountedContent, } from './delta-merger.js';
|
|
8
|
+
export { ArchiveEngine } from './engine.js';
|
|
9
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/archive/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEjH,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 工件依赖图
|
|
3
|
+
*
|
|
4
|
+
* 核心数据结构:管理工件之间的依赖关系
|
|
5
|
+
* 支持拓扑排序,确定构建顺序
|
|
6
|
+
*/
|
|
7
|
+
import type { Artifact, GraphState } from './types.js';
|
|
8
|
+
export declare class ArtifactGraph {
|
|
9
|
+
private artifacts;
|
|
10
|
+
private schemaName;
|
|
11
|
+
private applyRequires;
|
|
12
|
+
constructor(schemaName: string, artifacts: Artifact[], applyRequires: string[]);
|
|
13
|
+
/**
|
|
14
|
+
* 获取工件
|
|
15
|
+
*/
|
|
16
|
+
getArtifact(id: string): Artifact | undefined;
|
|
17
|
+
/**
|
|
18
|
+
* 获取所有工件
|
|
19
|
+
*/
|
|
20
|
+
getAllArtifacts(): Artifact[];
|
|
21
|
+
/**
|
|
22
|
+
* 获取工件的直接依赖
|
|
23
|
+
*/
|
|
24
|
+
getDependencies(id: string): Artifact[];
|
|
25
|
+
/**
|
|
26
|
+
* 获取工件的所有传递依赖(递归)
|
|
27
|
+
*/
|
|
28
|
+
getTransitiveDependencies(id: string): Set<string>;
|
|
29
|
+
/**
|
|
30
|
+
* 拓扑排序 - 返回工件的构建顺序
|
|
31
|
+
* 依赖少的排在前面
|
|
32
|
+
*
|
|
33
|
+
* 使用三色标记法检测循环依赖:
|
|
34
|
+
* - visited: 已完成处理
|
|
35
|
+
* - inStack: 当前递归路径中(若再次遇到则存在环)
|
|
36
|
+
*/
|
|
37
|
+
topologicalSort(): Artifact[];
|
|
38
|
+
/**
|
|
39
|
+
* 获取 apply 阶段需要的所有工件(传递闭包)
|
|
40
|
+
* 从 applyRequires 出发,沿 requires 边反向遍历
|
|
41
|
+
*/
|
|
42
|
+
getApplyRequiredSet(): Set<string>;
|
|
43
|
+
/**
|
|
44
|
+
* 计算当前构建状态
|
|
45
|
+
*/
|
|
46
|
+
computeState(changeName: string, changeRoot: string, planningHome: string, existingFiles: Set<string>): GraphState;
|
|
47
|
+
}
|
|
48
|
+
//# sourceMappingURL=graph.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/core/artifact-graph/graph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAsB,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3E,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAW;gBAEpB,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE;IAQ9E;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI7C;;OAEG;IACH,eAAe,IAAI,QAAQ,EAAE;IAI7B;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,EAAE;IAQvC;;OAEG;IACH,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAoBlD;;;;;;;OAOG;IACH,eAAe,IAAI,QAAQ,EAAE;IA4C7B;;;OAGG;IACH,mBAAmB,IAAI,GAAG,CAAC,MAAM,CAAC;IAoBlC;;OAEG;IACH,YAAY,CACV,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GACzB,UAAU;CA0Cd"}
|