@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,92 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 进度账本
|
|
3
|
+
*
|
|
4
|
+
* 来自 Superpowers 的核心机制:
|
|
5
|
+
* 对话记忆在上下文压缩后不存活,账本是恢复进度的唯一可靠来源。
|
|
6
|
+
*
|
|
7
|
+
* 账本记录每个任务的执行历史,包括:
|
|
8
|
+
* - 完成状态和 commit range
|
|
9
|
+
* - 修复轮次详情
|
|
10
|
+
* - 停放的发现(parked findings)
|
|
11
|
+
*
|
|
12
|
+
* 关键原则:
|
|
13
|
+
* - 每个计划拥有独立的工作区目录
|
|
14
|
+
* - 账本第一行必须是计划文件路径(身份标识)
|
|
15
|
+
* - 压缩后信任账本和 git log,而非自己的记忆
|
|
16
|
+
*/
|
|
17
|
+
import type { LedgerEntry, FixRoundRecord, Finding } from './types.js';
|
|
18
|
+
import type { WorkflowState, WorkflowStage } from '../workflow-state.js';
|
|
19
|
+
export declare class Ledger {
|
|
20
|
+
private entries;
|
|
21
|
+
private planFile;
|
|
22
|
+
private ledgerPath;
|
|
23
|
+
private maxFixRounds;
|
|
24
|
+
constructor(workspaceDir: string, planFile: string, maxFixRounds?: number);
|
|
25
|
+
/**
|
|
26
|
+
* 加载已有账本(如果存在)
|
|
27
|
+
* 返回是否可以恢复(账本存在且匹配当前计划)
|
|
28
|
+
*
|
|
29
|
+
* 解析所有日志行,恢复完整状态(commits、fixRounds、parkedFindings),
|
|
30
|
+
* 而不仅仅是 status。避免崩溃恢复丢失数据。
|
|
31
|
+
*/
|
|
32
|
+
load(): boolean;
|
|
33
|
+
/**
|
|
34
|
+
* 初始化账本
|
|
35
|
+
*/
|
|
36
|
+
initialize(): void;
|
|
37
|
+
/**
|
|
38
|
+
* 记录任务完成
|
|
39
|
+
*/
|
|
40
|
+
recordComplete(taskNumber: number, commits: string, reviewClean: boolean): void;
|
|
41
|
+
/**
|
|
42
|
+
* 记录修复轮次
|
|
43
|
+
*/
|
|
44
|
+
recordFixRound(taskNumber: number, round: FixRoundRecord): void;
|
|
45
|
+
/**
|
|
46
|
+
* 记录停放的发现
|
|
47
|
+
*/
|
|
48
|
+
recordParkedFinding(taskNumber: number, finding: Finding, ruling: string): void;
|
|
49
|
+
/**
|
|
50
|
+
* 记录阻塞
|
|
51
|
+
*/
|
|
52
|
+
recordBlocked(taskNumber: number, reason: string): void;
|
|
53
|
+
/**
|
|
54
|
+
* 记录次要发现(延迟处理)
|
|
55
|
+
*/
|
|
56
|
+
recordMinorDeferred(taskNumber: number, description: string): void;
|
|
57
|
+
/**
|
|
58
|
+
* 获取任务状态
|
|
59
|
+
*/
|
|
60
|
+
getTaskStatus(taskNumber: number): LedgerEntry | undefined;
|
|
61
|
+
/**
|
|
62
|
+
* 检查任务是否已完成
|
|
63
|
+
*/
|
|
64
|
+
isTaskComplete(taskNumber: number): boolean;
|
|
65
|
+
/**
|
|
66
|
+
* 获取下一个待执行的任务号
|
|
67
|
+
*/
|
|
68
|
+
getNextPendingTask(totalTasks: number): number | null;
|
|
69
|
+
/**
|
|
70
|
+
* 获取所有延迟的次要发现(供最终审查参考)
|
|
71
|
+
*/
|
|
72
|
+
getDeferredMinors(): string[];
|
|
73
|
+
/**
|
|
74
|
+
* 追加一行到账本文件
|
|
75
|
+
*/
|
|
76
|
+
private appendLine;
|
|
77
|
+
/**
|
|
78
|
+
* 记录工作流状态标签
|
|
79
|
+
*
|
|
80
|
+
* P2-14: 借鉴 Trellis 的 [workflow-state:xxx] 标签
|
|
81
|
+
*/
|
|
82
|
+
recordWorkflowState(state: WorkflowState): void;
|
|
83
|
+
/**
|
|
84
|
+
* 获取最新的工作流状态
|
|
85
|
+
*/
|
|
86
|
+
getLatestWorkflowState(): WorkflowState | null;
|
|
87
|
+
/**
|
|
88
|
+
* 记录阶段转换
|
|
89
|
+
*/
|
|
90
|
+
recordStageTransition(stage: WorkflowStage, reason?: string): void;
|
|
91
|
+
}
|
|
92
|
+
//# sourceMappingURL=ledger.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../../src/core/sdd-engine/ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGzE,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAE,MAAU;IAM5E;;;;;;OAMG;IACH,IAAI,IAAI,OAAO;IA+Ff;;OAEG;IACH,UAAU,IAAI,IAAI;IAUlB;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI;IAc/E;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAU/D;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ/E;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIvD;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAIlE;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI1D;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAK3C;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IASrD;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAgB7B;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACH,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAK/C;;OAEG;IACH,sBAAsB,IAAI,aAAa,GAAG,IAAI;IAoB9C;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;CAMnE"}
|
|
@@ -0,0 +1,273 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 进度账本
|
|
3
|
+
*
|
|
4
|
+
* 来自 Superpowers 的核心机制:
|
|
5
|
+
* 对话记忆在上下文压缩后不存活,账本是恢复进度的唯一可靠来源。
|
|
6
|
+
*
|
|
7
|
+
* 账本记录每个任务的执行历史,包括:
|
|
8
|
+
* - 完成状态和 commit range
|
|
9
|
+
* - 修复轮次详情
|
|
10
|
+
* - 停放的发现(parked findings)
|
|
11
|
+
*
|
|
12
|
+
* 关键原则:
|
|
13
|
+
* - 每个计划拥有独立的工作区目录
|
|
14
|
+
* - 账本第一行必须是计划文件路径(身份标识)
|
|
15
|
+
* - 压缩后信任账本和 git log,而非自己的记忆
|
|
16
|
+
*/
|
|
17
|
+
import { readFileSync, writeFileSync, appendFileSync, existsSync, mkdirSync } from 'fs';
|
|
18
|
+
import { join, dirname } from 'path';
|
|
19
|
+
import { generateWorkflowStateTag, parseWorkflowStateTag } from '../workflow-state.js';
|
|
20
|
+
export class Ledger {
|
|
21
|
+
entries = new Map();
|
|
22
|
+
planFile;
|
|
23
|
+
ledgerPath;
|
|
24
|
+
maxFixRounds;
|
|
25
|
+
constructor(workspaceDir, planFile, maxFixRounds = 5) {
|
|
26
|
+
this.planFile = planFile;
|
|
27
|
+
this.ledgerPath = join(workspaceDir, 'progress.md');
|
|
28
|
+
this.maxFixRounds = maxFixRounds;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* 加载已有账本(如果存在)
|
|
32
|
+
* 返回是否可以恢复(账本存在且匹配当前计划)
|
|
33
|
+
*
|
|
34
|
+
* 解析所有日志行,恢复完整状态(commits、fixRounds、parkedFindings),
|
|
35
|
+
* 而不仅仅是 status。避免崩溃恢复丢失数据。
|
|
36
|
+
*/
|
|
37
|
+
load() {
|
|
38
|
+
if (!existsSync(this.ledgerPath)) {
|
|
39
|
+
return false;
|
|
40
|
+
}
|
|
41
|
+
const content = readFileSync(this.ledgerPath, 'utf-8');
|
|
42
|
+
const lines = content.split('\n');
|
|
43
|
+
// 第一行必须精确匹配计划文件路径
|
|
44
|
+
const firstLine = lines[0];
|
|
45
|
+
if (firstLine.trim() !== `# SDD ledger — plan: ${this.planFile}`) {
|
|
46
|
+
// 这是另一个计划的账本,不加载
|
|
47
|
+
return false;
|
|
48
|
+
}
|
|
49
|
+
// 解析后续条目 — 逐行匹配各种记录类型
|
|
50
|
+
for (const line of lines) {
|
|
51
|
+
// ── 完成记录: Task N: complete (commits RANGE, review clean|with parked) ──
|
|
52
|
+
const completeMatch = line.match(/^Task (\d+): complete \(commits ([^,]+), review (clean|with parked)\)/);
|
|
53
|
+
if (completeMatch) {
|
|
54
|
+
const taskNum = parseInt(completeMatch[1]);
|
|
55
|
+
if (isNaN(taskNum))
|
|
56
|
+
continue;
|
|
57
|
+
this.entries.set(taskNum, {
|
|
58
|
+
taskNumber: taskNum,
|
|
59
|
+
status: 'done',
|
|
60
|
+
commits: completeMatch[2],
|
|
61
|
+
fixRounds: this.entries.get(taskNum)?.fixRounds || [],
|
|
62
|
+
parkedFindings: this.entries.get(taskNum)?.parkedFindings || [],
|
|
63
|
+
reviewClean: completeMatch[3] === 'clean',
|
|
64
|
+
timestamp: new Date().toISOString(),
|
|
65
|
+
});
|
|
66
|
+
continue;
|
|
67
|
+
}
|
|
68
|
+
// ── 修复轮次: Task N: fix round R/MAX (A addressed, O open — summaries; commits RANGE) ──
|
|
69
|
+
const fixMatch = line.match(/^Task (\d+): fix round (\d+)\/(\d+) \((\d+) addressed, (\d+) open — (.+?); commits (.+)\)/);
|
|
70
|
+
if (fixMatch) {
|
|
71
|
+
const taskNum = parseInt(fixMatch[1]);
|
|
72
|
+
if (isNaN(taskNum))
|
|
73
|
+
continue;
|
|
74
|
+
const entry = this.entries.get(taskNum);
|
|
75
|
+
if (entry) {
|
|
76
|
+
const summaries = fixMatch[6].split('; ').filter(s => s.length > 0);
|
|
77
|
+
entry.fixRounds.push({
|
|
78
|
+
round: parseInt(fixMatch[2]),
|
|
79
|
+
addressed: parseInt(fixMatch[4]),
|
|
80
|
+
open: parseInt(fixMatch[5]),
|
|
81
|
+
findingSummaries: summaries,
|
|
82
|
+
commits: fixMatch[7],
|
|
83
|
+
});
|
|
84
|
+
}
|
|
85
|
+
continue;
|
|
86
|
+
}
|
|
87
|
+
// ── 停放的发现: Task N: parked — DESCRIPTION — ruling: RULING ──
|
|
88
|
+
const parkedMatch = line.match(/^Task (\d+): parked — (.+?) — ruling: (.+)/);
|
|
89
|
+
if (parkedMatch) {
|
|
90
|
+
const taskNum = parseInt(parkedMatch[1]);
|
|
91
|
+
if (isNaN(taskNum))
|
|
92
|
+
continue;
|
|
93
|
+
const entry = this.entries.get(taskNum);
|
|
94
|
+
if (entry) {
|
|
95
|
+
entry.parkedFindings.push({
|
|
96
|
+
id: `F-recovered-${entry.parkedFindings.length + 1}`,
|
|
97
|
+
severity: 'important',
|
|
98
|
+
description: parkedMatch[2],
|
|
99
|
+
file: '',
|
|
100
|
+
addressed: false,
|
|
101
|
+
isLoadBearing: false,
|
|
102
|
+
});
|
|
103
|
+
}
|
|
104
|
+
continue;
|
|
105
|
+
}
|
|
106
|
+
// ── 阻塞记录: Task N: BLOCKED — REASON ──
|
|
107
|
+
const blockedMatch = line.match(/^Task (\d+): BLOCKED/);
|
|
108
|
+
if (blockedMatch) {
|
|
109
|
+
const taskNum = parseInt(blockedMatch[1]);
|
|
110
|
+
if (isNaN(taskNum))
|
|
111
|
+
continue;
|
|
112
|
+
if (!this.entries.has(taskNum)) {
|
|
113
|
+
this.entries.set(taskNum, {
|
|
114
|
+
taskNumber: taskNum,
|
|
115
|
+
status: 'blocked',
|
|
116
|
+
commits: '',
|
|
117
|
+
fixRounds: [],
|
|
118
|
+
parkedFindings: [],
|
|
119
|
+
reviewClean: false,
|
|
120
|
+
timestamp: new Date().toISOString(),
|
|
121
|
+
});
|
|
122
|
+
}
|
|
123
|
+
continue;
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
return true;
|
|
127
|
+
}
|
|
128
|
+
/**
|
|
129
|
+
* 初始化账本
|
|
130
|
+
*/
|
|
131
|
+
initialize() {
|
|
132
|
+
const dir = dirname(this.ledgerPath);
|
|
133
|
+
if (!existsSync(dir)) {
|
|
134
|
+
mkdirSync(dir, { recursive: true });
|
|
135
|
+
}
|
|
136
|
+
const header = `# SDD ledger — plan: ${this.planFile}\n`;
|
|
137
|
+
writeFileSync(this.ledgerPath, header, 'utf-8');
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
* 记录任务完成
|
|
141
|
+
*/
|
|
142
|
+
recordComplete(taskNumber, commits, reviewClean) {
|
|
143
|
+
const entry = {
|
|
144
|
+
taskNumber,
|
|
145
|
+
status: 'done',
|
|
146
|
+
commits,
|
|
147
|
+
fixRounds: [],
|
|
148
|
+
parkedFindings: [],
|
|
149
|
+
reviewClean,
|
|
150
|
+
timestamp: new Date().toISOString(),
|
|
151
|
+
};
|
|
152
|
+
this.entries.set(taskNumber, entry);
|
|
153
|
+
this.appendLine(`Task ${taskNumber}: complete (commits ${commits}, review ${reviewClean ? 'clean' : 'with parked'})`);
|
|
154
|
+
}
|
|
155
|
+
/**
|
|
156
|
+
* 记录修复轮次
|
|
157
|
+
*/
|
|
158
|
+
recordFixRound(taskNumber, round) {
|
|
159
|
+
const entry = this.entries.get(taskNumber);
|
|
160
|
+
if (entry) {
|
|
161
|
+
entry.fixRounds.push(round);
|
|
162
|
+
}
|
|
163
|
+
this.appendLine(`Task ${taskNumber}: fix round ${round.round}/${this.maxFixRounds} (${round.addressed} addressed, ${round.open} open — ${round.findingSummaries.join('; ')}; commits ${round.commits})`);
|
|
164
|
+
}
|
|
165
|
+
/**
|
|
166
|
+
* 记录停放的发现
|
|
167
|
+
*/
|
|
168
|
+
recordParkedFinding(taskNumber, finding, ruling) {
|
|
169
|
+
const entry = this.entries.get(taskNumber);
|
|
170
|
+
if (entry) {
|
|
171
|
+
entry.parkedFindings.push(finding);
|
|
172
|
+
}
|
|
173
|
+
this.appendLine(`Task ${taskNumber}: parked — ${finding.description} — ruling: ${ruling}`);
|
|
174
|
+
}
|
|
175
|
+
/**
|
|
176
|
+
* 记录阻塞
|
|
177
|
+
*/
|
|
178
|
+
recordBlocked(taskNumber, reason) {
|
|
179
|
+
this.appendLine(`Task ${taskNumber}: BLOCKED — ${reason}`);
|
|
180
|
+
}
|
|
181
|
+
/**
|
|
182
|
+
* 记录次要发现(延迟处理)
|
|
183
|
+
*/
|
|
184
|
+
recordMinorDeferred(taskNumber, description) {
|
|
185
|
+
this.appendLine(`Task ${taskNumber}: minor (deferred): ${description}`);
|
|
186
|
+
}
|
|
187
|
+
/**
|
|
188
|
+
* 获取任务状态
|
|
189
|
+
*/
|
|
190
|
+
getTaskStatus(taskNumber) {
|
|
191
|
+
return this.entries.get(taskNumber);
|
|
192
|
+
}
|
|
193
|
+
/**
|
|
194
|
+
* 检查任务是否已完成
|
|
195
|
+
*/
|
|
196
|
+
isTaskComplete(taskNumber) {
|
|
197
|
+
const entry = this.entries.get(taskNumber);
|
|
198
|
+
return entry?.status === 'done';
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
* 获取下一个待执行的任务号
|
|
202
|
+
*/
|
|
203
|
+
getNextPendingTask(totalTasks) {
|
|
204
|
+
for (let i = 1; i <= totalTasks; i++) {
|
|
205
|
+
if (!this.isTaskComplete(i)) {
|
|
206
|
+
return i;
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
return null;
|
|
210
|
+
}
|
|
211
|
+
/**
|
|
212
|
+
* 获取所有延迟的次要发现(供最终审查参考)
|
|
213
|
+
*/
|
|
214
|
+
getDeferredMinors() {
|
|
215
|
+
const result = [];
|
|
216
|
+
// minor deferred 仅记录在日志行中(未存入 entries Map),需从文件解析
|
|
217
|
+
if (existsSync(this.ledgerPath)) {
|
|
218
|
+
const content = readFileSync(this.ledgerPath, 'utf-8');
|
|
219
|
+
const lines = content.split('\n');
|
|
220
|
+
for (const line of lines) {
|
|
221
|
+
const match = line.match(/minor \(deferred\): (.+)/);
|
|
222
|
+
if (match) {
|
|
223
|
+
result.push(match[1]);
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
return result;
|
|
228
|
+
}
|
|
229
|
+
/**
|
|
230
|
+
* 追加一行到账本文件
|
|
231
|
+
*/
|
|
232
|
+
appendLine(line) {
|
|
233
|
+
appendFileSync(this.ledgerPath, line + '\n', 'utf-8');
|
|
234
|
+
}
|
|
235
|
+
/**
|
|
236
|
+
* 记录工作流状态标签
|
|
237
|
+
*
|
|
238
|
+
* P2-14: 借鉴 Trellis 的 [workflow-state:xxx] 标签
|
|
239
|
+
*/
|
|
240
|
+
recordWorkflowState(state) {
|
|
241
|
+
const tag = generateWorkflowStateTag(state);
|
|
242
|
+
this.appendLine(`Workflow state: ${tag}`);
|
|
243
|
+
}
|
|
244
|
+
/**
|
|
245
|
+
* 获取最新的工作流状态
|
|
246
|
+
*/
|
|
247
|
+
getLatestWorkflowState() {
|
|
248
|
+
if (!existsSync(this.ledgerPath)) {
|
|
249
|
+
return null;
|
|
250
|
+
}
|
|
251
|
+
const content = readFileSync(this.ledgerPath, 'utf-8');
|
|
252
|
+
const lines = content.split('\n');
|
|
253
|
+
// 从后往前查找最新的 workflow state 标签
|
|
254
|
+
for (let i = lines.length - 1; i >= 0; i--) {
|
|
255
|
+
const line = lines[i];
|
|
256
|
+
const match = line.match(/Workflow state: (\[workflow-state:[^\]]+\])/i);
|
|
257
|
+
if (match) {
|
|
258
|
+
return parseWorkflowStateTag(match[1]);
|
|
259
|
+
}
|
|
260
|
+
}
|
|
261
|
+
return null;
|
|
262
|
+
}
|
|
263
|
+
/**
|
|
264
|
+
* 记录阶段转换
|
|
265
|
+
*/
|
|
266
|
+
recordStageTransition(stage, reason) {
|
|
267
|
+
const message = reason
|
|
268
|
+
? `Stage transition: ${stage}${reason ? ` (${reason})` : ''}`
|
|
269
|
+
: `Stage transition: ${stage}`;
|
|
270
|
+
this.appendLine(message);
|
|
271
|
+
}
|
|
272
|
+
}
|
|
273
|
+
//# sourceMappingURL=ledger.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../../../src/core/sdd-engine/ledger.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 模型选择器
|
|
3
|
+
*
|
|
4
|
+
* 来自 Superpowers 的成本优化策略:
|
|
5
|
+
* 使用能胜任的最低级别模型,节省成本和提升速度。
|
|
6
|
+
*
|
|
7
|
+
* 模型分级:
|
|
8
|
+
* - cheap: 机械性实现任务(单文件、明确规范)
|
|
9
|
+
* - standard: 集成和判断任务(多文件协调)
|
|
10
|
+
* - capable: 架构设计和最终审查
|
|
11
|
+
*/
|
|
12
|
+
export type ModelTier = 'cheap' | 'standard' | 'capable';
|
|
13
|
+
export interface ModelConfig {
|
|
14
|
+
cheap: string;
|
|
15
|
+
standard: string;
|
|
16
|
+
capable: string;
|
|
17
|
+
}
|
|
18
|
+
export declare class ModelSelector {
|
|
19
|
+
private config;
|
|
20
|
+
constructor(config?: Partial<ModelConfig>);
|
|
21
|
+
/**
|
|
22
|
+
* 为任务选择实现者模型
|
|
23
|
+
*
|
|
24
|
+
* 复杂度信号:
|
|
25
|
+
* - 涉及 1-2 个文件 + 完整规范 → cheap
|
|
26
|
+
* - 涉及多文件 + 集成关注 → standard
|
|
27
|
+
* - 需要设计判断 + 广泛代码库理解 → capable
|
|
28
|
+
*/
|
|
29
|
+
selectImplementerModel(fileCount: number, hasCompleteSpec: boolean, requiresDesignJudgment: boolean): string;
|
|
30
|
+
/**
|
|
31
|
+
* 为审查者选择模型
|
|
32
|
+
*
|
|
33
|
+
* 根据 diff 的大小、复杂度和风险选择
|
|
34
|
+
*/
|
|
35
|
+
selectReviewerModel(diffSize: number, isComplexChange: boolean): string;
|
|
36
|
+
/**
|
|
37
|
+
* 最终审查始终使用最强模型
|
|
38
|
+
*/
|
|
39
|
+
getFinalReviewModel(): string;
|
|
40
|
+
/**
|
|
41
|
+
* 修复轮次 4-5 升级模型
|
|
42
|
+
*/
|
|
43
|
+
getEscalatedModel(currentModel: string): string;
|
|
44
|
+
/**
|
|
45
|
+
* 获取模型配置
|
|
46
|
+
*/
|
|
47
|
+
getConfig(): ModelConfig;
|
|
48
|
+
}
|
|
49
|
+
//# sourceMappingURL=model-selector.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"model-selector.d.ts","sourceRoot":"","sources":["../../../src/core/sdd-engine/model-selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAQzC;;;;;;;OAOG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,sBAAsB,EAAE,OAAO,GAAG,MAAM;IAU5G;;;;OAIG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,GAAG,MAAM;IAUvE;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAQ/C;;OAEG;IACH,SAAS,IAAI,WAAW;CAGzB"}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 模型选择器
|
|
3
|
+
*
|
|
4
|
+
* 来自 Superpowers 的成本优化策略:
|
|
5
|
+
* 使用能胜任的最低级别模型,节省成本和提升速度。
|
|
6
|
+
*
|
|
7
|
+
* 模型分级:
|
|
8
|
+
* - cheap: 机械性实现任务(单文件、明确规范)
|
|
9
|
+
* - standard: 集成和判断任务(多文件协调)
|
|
10
|
+
* - capable: 架构设计和最终审查
|
|
11
|
+
*/
|
|
12
|
+
export class ModelSelector {
|
|
13
|
+
config;
|
|
14
|
+
constructor(config) {
|
|
15
|
+
this.config = {
|
|
16
|
+
cheap: config?.cheap || 'haiku',
|
|
17
|
+
standard: config?.standard || 'sonnet',
|
|
18
|
+
capable: config?.capable || 'opus',
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* 为任务选择实现者模型
|
|
23
|
+
*
|
|
24
|
+
* 复杂度信号:
|
|
25
|
+
* - 涉及 1-2 个文件 + 完整规范 → cheap
|
|
26
|
+
* - 涉及多文件 + 集成关注 → standard
|
|
27
|
+
* - 需要设计判断 + 广泛代码库理解 → capable
|
|
28
|
+
*/
|
|
29
|
+
selectImplementerModel(fileCount, hasCompleteSpec, requiresDesignJudgment) {
|
|
30
|
+
if (requiresDesignJudgment) {
|
|
31
|
+
return this.config.capable;
|
|
32
|
+
}
|
|
33
|
+
if (fileCount <= 2 && hasCompleteSpec) {
|
|
34
|
+
return this.config.cheap;
|
|
35
|
+
}
|
|
36
|
+
return this.config.standard;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* 为审查者选择模型
|
|
40
|
+
*
|
|
41
|
+
* 根据 diff 的大小、复杂度和风险选择
|
|
42
|
+
*/
|
|
43
|
+
selectReviewerModel(diffSize, isComplexChange) {
|
|
44
|
+
if (diffSize < 100 && !isComplexChange) {
|
|
45
|
+
return this.config.cheap;
|
|
46
|
+
}
|
|
47
|
+
if (isComplexChange) {
|
|
48
|
+
return this.config.capable;
|
|
49
|
+
}
|
|
50
|
+
return this.config.standard;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* 最终审查始终使用最强模型
|
|
54
|
+
*/
|
|
55
|
+
getFinalReviewModel() {
|
|
56
|
+
return this.config.capable;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* 修复轮次 4-5 升级模型
|
|
60
|
+
*/
|
|
61
|
+
getEscalatedModel(currentModel) {
|
|
62
|
+
const tiers = [this.config.cheap, this.config.standard, this.config.capable];
|
|
63
|
+
const currentIndex = tiers.indexOf(currentModel);
|
|
64
|
+
if (currentIndex === -1)
|
|
65
|
+
return this.config.standard;
|
|
66
|
+
const nextIndex = Math.min(currentIndex + 1, tiers.length - 1);
|
|
67
|
+
return tiers[nextIndex];
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* 获取模型配置
|
|
71
|
+
*/
|
|
72
|
+
getConfig() {
|
|
73
|
+
return { ...this.config };
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
//# sourceMappingURL=model-selector.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"model-selector.js","sourceRoot":"","sources":["../../../src/core/sdd-engine/model-selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAc;IAE5B,YAAY,MAA6B;QACvC,IAAI,CAAC,MAAM,GAAG;YACZ,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,OAAO;YAC/B,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,QAAQ;YACtC,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,MAAM;SACnC,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,sBAAsB,CAAC,SAAiB,EAAE,eAAwB,EAAE,sBAA+B;QACjG,IAAI,sBAAsB,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,CAAC;QACD,IAAI,SAAS,IAAI,CAAC,IAAI,eAAe,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,QAAgB,EAAE,eAAwB;QAC5D,IAAI,QAAQ,GAAG,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,CAAC;QACD,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,YAAoB;QACpC,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7E,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACjD,IAAI,YAAY,KAAK,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/D,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF"}
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 并行代理分发器
|
|
3
|
+
*
|
|
4
|
+
* 来自 Superpowers 的并行执行策略:
|
|
5
|
+
* 当任务之间无依赖关系时,同时分发多个子代理并行执行。
|
|
6
|
+
*
|
|
7
|
+
* 适用场景:
|
|
8
|
+
* - 3+ 个独立测试失败(不同测试文件,无共享依赖)
|
|
9
|
+
* - 多个子系统独立损坏
|
|
10
|
+
* - 多文件非依赖变更
|
|
11
|
+
*
|
|
12
|
+
* 核心原则:
|
|
13
|
+
* - 每个代理获得聚焦范围 + 明确约束 + 具体输出要求
|
|
14
|
+
* - 通过依赖图分析识别可并行的任务
|
|
15
|
+
* - 集成阶段:审查摘要 → 冲突检查 → 全量套件
|
|
16
|
+
*
|
|
17
|
+
* 并行隔离策略(修复 P0-2):
|
|
18
|
+
* - 每个任务在独立的 Git worktree 中执行
|
|
19
|
+
* - worktree 拥有独立的 HEAD / 工作目录,消除竞态条件
|
|
20
|
+
* - 所有任务完成后按序合并分支到主分支
|
|
21
|
+
* - 合并冲突作为并行代价显式报告,而非静默丢失
|
|
22
|
+
*
|
|
23
|
+
* @experimental 此模块实现完整但尚未集成到任何 CLI 命令中。
|
|
24
|
+
* 建议在未来版本中为 `specpow apply` 添加 `--parallel` 选项以启用此功能。
|
|
25
|
+
* 集成前需要:
|
|
26
|
+
* 1. 在 CLI 命令入口添加并行模式开关
|
|
27
|
+
* 2. 配置 worktree 合并策略
|
|
28
|
+
* 3. 添加并行执行的日志和进度报告
|
|
29
|
+
*/
|
|
30
|
+
import type { PlanTask } from '../sdd-engine/controller.js';
|
|
31
|
+
import type { TaskReport, ReviewResult, SDDConfig } from './types.js';
|
|
32
|
+
export interface TaskDependency {
|
|
33
|
+
taskNumber: number;
|
|
34
|
+
dependsOn: number[];
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* 分析任务依赖关系
|
|
38
|
+
*
|
|
39
|
+
* 基于两个维度判断:
|
|
40
|
+
* 1. 文件级:不同任务是否修改相同文件
|
|
41
|
+
* 2. 逻辑级:解析 tasks.md 中显式声明的依赖
|
|
42
|
+
*/
|
|
43
|
+
export declare function analyzeDependencies(tasks: PlanTask[]): TaskDependency[];
|
|
44
|
+
/**
|
|
45
|
+
* 构建任务依赖图(拓扑排序)
|
|
46
|
+
*
|
|
47
|
+
* 返回可并行执行的层:
|
|
48
|
+
* 每层中的任务彼此独立,可以同时分发
|
|
49
|
+
*/
|
|
50
|
+
export declare function buildParallelLayers(tasks: PlanTask[]): PlanTask[][];
|
|
51
|
+
export interface ParallelResult {
|
|
52
|
+
taskNumber: number;
|
|
53
|
+
outcome: 'complete' | 'blocked';
|
|
54
|
+
report: TaskReport;
|
|
55
|
+
review: ReviewResult;
|
|
56
|
+
commitRange: string;
|
|
57
|
+
branchName: string;
|
|
58
|
+
worktreePath?: string;
|
|
59
|
+
}
|
|
60
|
+
export interface ParallelDispatchResult {
|
|
61
|
+
success: boolean;
|
|
62
|
+
results: ParallelResult[];
|
|
63
|
+
conflicts: string[];
|
|
64
|
+
mergeFailures: number[];
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* 并行分发执行器
|
|
68
|
+
*
|
|
69
|
+
* 每个任务在独立的 Git worktree 中执行,消除并行竞态条件。
|
|
70
|
+
* 完成后按序将各分支合并回主分支。
|
|
71
|
+
*/
|
|
72
|
+
export declare class ParallelDispatcher {
|
|
73
|
+
private aiCaller;
|
|
74
|
+
private workspaceDir;
|
|
75
|
+
private specConstraints;
|
|
76
|
+
constructor(config: SDDConfig);
|
|
77
|
+
/**
|
|
78
|
+
* 并行分发生成层
|
|
79
|
+
*
|
|
80
|
+
* 一层中的所有任务彼此独立:
|
|
81
|
+
* 1. 为每个任务创建独立 worktree
|
|
82
|
+
* 2. 在各自 worktree 中并行执行实现 + 审查
|
|
83
|
+
* 3. 所有任务完成后按序合并分支
|
|
84
|
+
* 4. 清理 worktree
|
|
85
|
+
*/
|
|
86
|
+
dispatchLayer(tasks: PlanTask[], projectContext: string): Promise<ParallelDispatchResult>;
|
|
87
|
+
/**
|
|
88
|
+
* 全图并行执行
|
|
89
|
+
*
|
|
90
|
+
* 按层顺序执行,每层内部并行分发
|
|
91
|
+
* 层与层之间是串行的(前一层合并完成后才开始下一层)
|
|
92
|
+
*/
|
|
93
|
+
dispatchAll(tasks: PlanTask[], projectContext: string): Promise<ParallelDispatchResult>;
|
|
94
|
+
/**
|
|
95
|
+
* 创建任务简报,包含 worktree 路径和工作目录指令
|
|
96
|
+
*/
|
|
97
|
+
private createBrief;
|
|
98
|
+
}
|
|
99
|
+
//# sourceMappingURL=parallel-dispatcher.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"parallel-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/core/sdd-engine/parallel-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAa,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAajF,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE,CAmCvE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,EAAE,CA6CnE;AAMD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AASD;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAS;gBAEpB,MAAM,EAAE,SAAS;IAM7B;;;;;;;;OAQG;IACG,aAAa,CACjB,KAAK,EAAE,QAAQ,EAAE,EACjB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,sBAAsB,CAAC;IA2KlC;;;;;OAKG;IACG,WAAW,CACf,KAAK,EAAE,QAAQ,EAAE,EACjB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,sBAAsB,CAAC;IAoClC;;OAEG;IACH,OAAO,CAAC,WAAW;CAwBpB"}
|