@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,170 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 工件依赖图
|
|
3
|
+
*
|
|
4
|
+
* 核心数据结构:管理工件之间的依赖关系
|
|
5
|
+
* 支持拓扑排序,确定构建顺序
|
|
6
|
+
*/
|
|
7
|
+
export class ArtifactGraph {
|
|
8
|
+
artifacts = new Map();
|
|
9
|
+
schemaName;
|
|
10
|
+
applyRequires;
|
|
11
|
+
constructor(schemaName, artifacts, applyRequires) {
|
|
12
|
+
this.schemaName = schemaName;
|
|
13
|
+
this.applyRequires = applyRequires;
|
|
14
|
+
for (const artifact of artifacts) {
|
|
15
|
+
this.artifacts.set(artifact.id, artifact);
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* 获取工件
|
|
20
|
+
*/
|
|
21
|
+
getArtifact(id) {
|
|
22
|
+
return this.artifacts.get(id);
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* 获取所有工件
|
|
26
|
+
*/
|
|
27
|
+
getAllArtifacts() {
|
|
28
|
+
return Array.from(this.artifacts.values());
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* 获取工件的直接依赖
|
|
32
|
+
*/
|
|
33
|
+
getDependencies(id) {
|
|
34
|
+
const artifact = this.artifacts.get(id);
|
|
35
|
+
if (!artifact)
|
|
36
|
+
return [];
|
|
37
|
+
return artifact.requires
|
|
38
|
+
.map(depId => this.artifacts.get(depId))
|
|
39
|
+
.filter((a) => a !== undefined);
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* 获取工件的所有传递依赖(递归)
|
|
43
|
+
*/
|
|
44
|
+
getTransitiveDependencies(id) {
|
|
45
|
+
const visited = new Set();
|
|
46
|
+
const stack = [id];
|
|
47
|
+
while (stack.length > 0) {
|
|
48
|
+
const current = stack.pop();
|
|
49
|
+
const artifact = this.artifacts.get(current);
|
|
50
|
+
if (!artifact)
|
|
51
|
+
continue;
|
|
52
|
+
for (const depId of artifact.requires) {
|
|
53
|
+
if (!visited.has(depId)) {
|
|
54
|
+
visited.add(depId);
|
|
55
|
+
stack.push(depId);
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
return visited;
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* 拓扑排序 - 返回工件的构建顺序
|
|
63
|
+
* 依赖少的排在前面
|
|
64
|
+
*
|
|
65
|
+
* 使用三色标记法检测循环依赖:
|
|
66
|
+
* - visited: 已完成处理
|
|
67
|
+
* - inStack: 当前递归路径中(若再次遇到则存在环)
|
|
68
|
+
*/
|
|
69
|
+
topologicalSort() {
|
|
70
|
+
const visited = new Set();
|
|
71
|
+
const inStack = new Set();
|
|
72
|
+
const result = [];
|
|
73
|
+
const path = [];
|
|
74
|
+
const visit = (id) => {
|
|
75
|
+
// 在当前递归路径中再次遇到 → 循环依赖
|
|
76
|
+
if (inStack.has(id)) {
|
|
77
|
+
const cycleStart = path.indexOf(id);
|
|
78
|
+
const cycle = [...path.slice(cycleStart), id];
|
|
79
|
+
throw new Error(`Circular dependency detected: ${cycle.join(' → ')}`);
|
|
80
|
+
}
|
|
81
|
+
if (visited.has(id))
|
|
82
|
+
return;
|
|
83
|
+
inStack.add(id);
|
|
84
|
+
path.push(id);
|
|
85
|
+
const artifact = this.artifacts.get(id);
|
|
86
|
+
if (!artifact) {
|
|
87
|
+
inStack.delete(id);
|
|
88
|
+
path.pop();
|
|
89
|
+
return;
|
|
90
|
+
}
|
|
91
|
+
// 先访问所有依赖
|
|
92
|
+
for (const depId of artifact.requires) {
|
|
93
|
+
visit(depId);
|
|
94
|
+
}
|
|
95
|
+
inStack.delete(id);
|
|
96
|
+
path.pop();
|
|
97
|
+
visited.add(id);
|
|
98
|
+
result.push(artifact);
|
|
99
|
+
};
|
|
100
|
+
for (const id of this.artifacts.keys()) {
|
|
101
|
+
visit(id);
|
|
102
|
+
}
|
|
103
|
+
return result;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* 获取 apply 阶段需要的所有工件(传递闭包)
|
|
107
|
+
* 从 applyRequires 出发,沿 requires 边反向遍历
|
|
108
|
+
*/
|
|
109
|
+
getApplyRequiredSet() {
|
|
110
|
+
const required = new Set();
|
|
111
|
+
const addWithDeps = (id) => {
|
|
112
|
+
if (required.has(id))
|
|
113
|
+
return;
|
|
114
|
+
required.add(id);
|
|
115
|
+
const artifact = this.artifacts.get(id);
|
|
116
|
+
if (!artifact)
|
|
117
|
+
return;
|
|
118
|
+
for (const depId of artifact.requires) {
|
|
119
|
+
addWithDeps(depId);
|
|
120
|
+
}
|
|
121
|
+
};
|
|
122
|
+
for (const id of this.applyRequires) {
|
|
123
|
+
addWithDeps(id);
|
|
124
|
+
}
|
|
125
|
+
return required;
|
|
126
|
+
}
|
|
127
|
+
/**
|
|
128
|
+
* 计算当前构建状态
|
|
129
|
+
*/
|
|
130
|
+
computeState(changeName, changeRoot, planningHome, existingFiles) {
|
|
131
|
+
const artifactStates = [];
|
|
132
|
+
for (const artifact of this.topologicalSort()) {
|
|
133
|
+
// 检查文件是否存在
|
|
134
|
+
const isDone = artifact.output
|
|
135
|
+
? existingFiles.has(artifact.output)
|
|
136
|
+
: false;
|
|
137
|
+
// 检查依赖是否满足
|
|
138
|
+
const missingDeps = artifact.requires.filter(depId => {
|
|
139
|
+
const depState = artifactStates.find(s => s.artifact.id === depId);
|
|
140
|
+
return !depState || (depState.status !== 'done' && depState.status !== 'skipped');
|
|
141
|
+
});
|
|
142
|
+
let status;
|
|
143
|
+
if (isDone) {
|
|
144
|
+
status = 'done';
|
|
145
|
+
}
|
|
146
|
+
else if (missingDeps.length > 0) {
|
|
147
|
+
status = 'blocked';
|
|
148
|
+
}
|
|
149
|
+
else {
|
|
150
|
+
status = 'ready';
|
|
151
|
+
}
|
|
152
|
+
artifactStates.push({
|
|
153
|
+
artifact,
|
|
154
|
+
status,
|
|
155
|
+
outputPath: artifact.output,
|
|
156
|
+
missingDeps,
|
|
157
|
+
});
|
|
158
|
+
}
|
|
159
|
+
return {
|
|
160
|
+
schemaName: this.schemaName,
|
|
161
|
+
changeName,
|
|
162
|
+
changeRoot,
|
|
163
|
+
planningHome,
|
|
164
|
+
artifacts: artifactStates,
|
|
165
|
+
applyRequires: this.applyRequires,
|
|
166
|
+
actionContext: changeRoot,
|
|
167
|
+
};
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
//# sourceMappingURL=graph.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../src/core/artifact-graph/graph.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 工件图模块 - 导出
|
|
3
|
+
*
|
|
4
|
+
* 管理工件之间的依赖关系,控制构建顺序
|
|
5
|
+
* 核心概念:proposal → specs → design → tasks → apply
|
|
6
|
+
*/
|
|
7
|
+
export { ArtifactGraph } from './graph.js';
|
|
8
|
+
export { SchemaResolver } from './resolver.js';
|
|
9
|
+
export { StateDetector } from './state.js';
|
|
10
|
+
export { InstructionLoader } from './instruction-loader.js';
|
|
11
|
+
export { OutputResolver } from './outputs.js';
|
|
12
|
+
export type { Artifact, SchemaYaml, ArtifactStatus, ApplyPhase } from './types.js';
|
|
13
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/artifact-graph/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 工件图模块 - 导出
|
|
3
|
+
*
|
|
4
|
+
* 管理工件之间的依赖关系,控制构建顺序
|
|
5
|
+
* 核心概念:proposal → specs → design → tasks → apply
|
|
6
|
+
*/
|
|
7
|
+
export { ArtifactGraph } from './graph.js';
|
|
8
|
+
export { SchemaResolver } from './resolver.js';
|
|
9
|
+
export { StateDetector } from './state.js';
|
|
10
|
+
export { InstructionLoader } from './instruction-loader.js';
|
|
11
|
+
export { OutputResolver } from './outputs.js';
|
|
12
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/artifact-graph/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 指令加载器
|
|
3
|
+
*
|
|
4
|
+
* 加载模板并生成 AI 指令
|
|
5
|
+
* 将 Schema 中定义的模板和指令组合成完整的 AI 生成指导
|
|
6
|
+
*
|
|
7
|
+
* P1-7: 支持项目级 context 和 per-artifact rules 注入
|
|
8
|
+
*/
|
|
9
|
+
import type { Artifact } from './types.js';
|
|
10
|
+
export interface InstructionResult {
|
|
11
|
+
template: string;
|
|
12
|
+
instruction: string;
|
|
13
|
+
context: string;
|
|
14
|
+
rules: string[];
|
|
15
|
+
resolvedOutputPath: string;
|
|
16
|
+
dependencies: Record<string, string>;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* P1-7: 项目级配置接口(context + per-artifact rules)
|
|
20
|
+
*/
|
|
21
|
+
export interface InstructionLoaderConfig {
|
|
22
|
+
/** 项目级上下文描述 */
|
|
23
|
+
context?: string;
|
|
24
|
+
/** 每个工件的定制规则 */
|
|
25
|
+
rules?: Record<string, string[]>;
|
|
26
|
+
}
|
|
27
|
+
export declare class InstructionLoader {
|
|
28
|
+
private schemasDir;
|
|
29
|
+
private config;
|
|
30
|
+
constructor(schemasDir: string, config?: InstructionLoaderConfig);
|
|
31
|
+
/**
|
|
32
|
+
* 加载工件的指令
|
|
33
|
+
*/
|
|
34
|
+
loadInstructions(artifact: Artifact, schemaName: string, changeRoot: string, projectContext?: string, completedDeps?: Map<string, string>): InstructionResult;
|
|
35
|
+
/**
|
|
36
|
+
* P1-7: 构建增强的上下文
|
|
37
|
+
*
|
|
38
|
+
* 将项目级 context 与依赖工件内容组合
|
|
39
|
+
*/
|
|
40
|
+
private buildEnhancedContext;
|
|
41
|
+
/**
|
|
42
|
+
* 从 Schema 配置和默认规则文件中提取规则
|
|
43
|
+
*
|
|
44
|
+
* 多来源规则聚合:
|
|
45
|
+
* 1. Artifact 指令中的内联规则
|
|
46
|
+
* 2. Schema 级规则文件
|
|
47
|
+
* 3. 全局约束文件
|
|
48
|
+
*/
|
|
49
|
+
private extractRules;
|
|
50
|
+
/**
|
|
51
|
+
* 从 Artifact 的 instruction 文本中提取规则
|
|
52
|
+
*
|
|
53
|
+
* 识别的模式:
|
|
54
|
+
* - 以 "规则:" / "Rule:" 开头的行
|
|
55
|
+
* - 以 "约束:" / "Constraint:" 开头的行
|
|
56
|
+
* - 以 "- " 或 "* " 开头的列表行(在 instruction 上下文中)
|
|
57
|
+
*/
|
|
58
|
+
private extractRulesFromInstruction;
|
|
59
|
+
}
|
|
60
|
+
//# sourceMappingURL=instruction-loader.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"instruction-loader.d.ts","sourceRoot":"","sources":["../../../src/core/artifact-graph/instruction-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAClC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAA0B;gBAE5B,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,uBAAuB;IAKhE;;OAEG;IACH,gBAAgB,CACd,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,iBAAiB;IA4CpB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;IA4DpB;;;;;;;OAOG;IACH,OAAO,CAAC,2BAA2B;CAsBpC"}
|
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 指令加载器
|
|
3
|
+
*
|
|
4
|
+
* 加载模板并生成 AI 指令
|
|
5
|
+
* 将 Schema 中定义的模板和指令组合成完整的 AI 生成指导
|
|
6
|
+
*
|
|
7
|
+
* P1-7: 支持项目级 context 和 per-artifact rules 注入
|
|
8
|
+
*/
|
|
9
|
+
import { readFileSync, existsSync } from 'fs';
|
|
10
|
+
import { resolve } from 'path';
|
|
11
|
+
export class InstructionLoader {
|
|
12
|
+
schemasDir;
|
|
13
|
+
config;
|
|
14
|
+
constructor(schemasDir, config) {
|
|
15
|
+
this.schemasDir = schemasDir;
|
|
16
|
+
this.config = config || {};
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* 加载工件的指令
|
|
20
|
+
*/
|
|
21
|
+
loadInstructions(artifact, schemaName, changeRoot, projectContext, completedDeps) {
|
|
22
|
+
// 加载模板
|
|
23
|
+
let template = '';
|
|
24
|
+
if (artifact.template) {
|
|
25
|
+
const templatePath = resolve(this.schemasDir, schemaName, 'templates', artifact.template);
|
|
26
|
+
if (existsSync(templatePath)) {
|
|
27
|
+
template = readFileSync(templatePath, 'utf-8');
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
// 解析输出路径
|
|
31
|
+
const resolvedOutputPath = artifact.output
|
|
32
|
+
? resolve(changeRoot, artifact.output)
|
|
33
|
+
: '';
|
|
34
|
+
// 收集已完成的依赖文件
|
|
35
|
+
const dependencies = {};
|
|
36
|
+
if (completedDeps) {
|
|
37
|
+
for (const [depId, depPath] of completedDeps) {
|
|
38
|
+
dependencies[depId] = depPath;
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
// 从 schema 配置中提取规则
|
|
42
|
+
const rules = this.extractRules(artifact, schemaName);
|
|
43
|
+
// P1-7: 合并来自 config 的 per-artifact rules
|
|
44
|
+
if (this.config.rules && this.config.rules[artifact.id]) {
|
|
45
|
+
rules.push(...this.config.rules[artifact.id]);
|
|
46
|
+
}
|
|
47
|
+
// P1-7: 构建增强的上下文(项目级 context + 依赖上下文)
|
|
48
|
+
const enhancedContext = this.buildEnhancedContext(projectContext);
|
|
49
|
+
return {
|
|
50
|
+
template,
|
|
51
|
+
instruction: artifact.instruction || '',
|
|
52
|
+
context: enhancedContext,
|
|
53
|
+
rules,
|
|
54
|
+
resolvedOutputPath,
|
|
55
|
+
dependencies,
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* P1-7: 构建增强的上下文
|
|
60
|
+
*
|
|
61
|
+
* 将项目级 context 与依赖工件内容组合
|
|
62
|
+
*/
|
|
63
|
+
buildEnhancedContext(projectContext) {
|
|
64
|
+
const parts = [];
|
|
65
|
+
// 1. 项目级上下文(来自 config.yaml 的 context 字段)
|
|
66
|
+
if (this.config.context) {
|
|
67
|
+
parts.push(this.config.context);
|
|
68
|
+
}
|
|
69
|
+
// 2. 外部传入的项目上下文
|
|
70
|
+
if (projectContext) {
|
|
71
|
+
parts.push(projectContext);
|
|
72
|
+
}
|
|
73
|
+
return parts.join('\n\n');
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* 从 Schema 配置和默认规则文件中提取规则
|
|
77
|
+
*
|
|
78
|
+
* 多来源规则聚合:
|
|
79
|
+
* 1. Artifact 指令中的内联规则
|
|
80
|
+
* 2. Schema 级规则文件
|
|
81
|
+
* 3. 全局约束文件
|
|
82
|
+
*/
|
|
83
|
+
extractRules(artifact, schemaName) {
|
|
84
|
+
const rules = [];
|
|
85
|
+
// 1. 从 Artifact 的 instruction 中提取内联规则
|
|
86
|
+
if (artifact.instruction) {
|
|
87
|
+
const inlineRules = this.extractRulesFromInstruction(artifact.instruction);
|
|
88
|
+
rules.push(...inlineRules);
|
|
89
|
+
}
|
|
90
|
+
// 2. Schema 级规则文件
|
|
91
|
+
const schemaRuleFiles = [
|
|
92
|
+
resolve(this.schemasDir, schemaName, 'rules.md'),
|
|
93
|
+
resolve(this.schemasDir, schemaName, 'constraints.md'),
|
|
94
|
+
];
|
|
95
|
+
for (const ruleFile of schemaRuleFiles) {
|
|
96
|
+
if (existsSync(ruleFile)) {
|
|
97
|
+
try {
|
|
98
|
+
const content = readFileSync(ruleFile, 'utf-8');
|
|
99
|
+
// 以行为单位提取规则(- 或 * 开头或数字列表)
|
|
100
|
+
const ruleLines = content
|
|
101
|
+
.split('\n')
|
|
102
|
+
.map(l => l.trim())
|
|
103
|
+
.filter(l => l.startsWith('-') || l.startsWith('*') || /^\d+\./.test(l))
|
|
104
|
+
.map(l => l.replace(/^[-*\d.]\s*/, '').trim());
|
|
105
|
+
rules.push(...ruleLines);
|
|
106
|
+
}
|
|
107
|
+
catch {
|
|
108
|
+
// 读取失败,跳过
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
// 3. 全局约束文件
|
|
113
|
+
const globalConstraintFiles = [
|
|
114
|
+
resolve('.specpow', 'constraints.md'),
|
|
115
|
+
'CLAUDE.md',
|
|
116
|
+
'AGENTS.md',
|
|
117
|
+
];
|
|
118
|
+
for (const constraintFile of globalConstraintFiles) {
|
|
119
|
+
if (existsSync(constraintFile)) {
|
|
120
|
+
try {
|
|
121
|
+
const content = readFileSync(constraintFile, 'utf-8');
|
|
122
|
+
// 提取 "禁止"、"必须"、"应当" 行
|
|
123
|
+
const constraintLines = content
|
|
124
|
+
.split('\n')
|
|
125
|
+
.filter(l => /禁止|必须|应当|never|must|should|forbidden/i.test(l))
|
|
126
|
+
.map(l => l.trim())
|
|
127
|
+
.slice(0, 10); // 限制数量
|
|
128
|
+
rules.push(...constraintLines);
|
|
129
|
+
}
|
|
130
|
+
catch {
|
|
131
|
+
// 读取失败,跳过
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
// 去重
|
|
136
|
+
return [...new Set(rules)];
|
|
137
|
+
}
|
|
138
|
+
/**
|
|
139
|
+
* 从 Artifact 的 instruction 文本中提取规则
|
|
140
|
+
*
|
|
141
|
+
* 识别的模式:
|
|
142
|
+
* - 以 "规则:" / "Rule:" 开头的行
|
|
143
|
+
* - 以 "约束:" / "Constraint:" 开头的行
|
|
144
|
+
* - 以 "- " 或 "* " 开头的列表行(在 instruction 上下文中)
|
|
145
|
+
*/
|
|
146
|
+
extractRulesFromInstruction(instruction) {
|
|
147
|
+
const rules = [];
|
|
148
|
+
for (const line of instruction.split('\n')) {
|
|
149
|
+
const trimmed = line.trim();
|
|
150
|
+
if (!trimmed)
|
|
151
|
+
continue;
|
|
152
|
+
// 显式规则标记
|
|
153
|
+
const ruleMatch = trimmed.match(/^(?:规则|规则:|Rule:|Rule:|约束|约束:|Constraint:|Constraint:)\s*(.+)/i);
|
|
154
|
+
if (ruleMatch) {
|
|
155
|
+
rules.push(ruleMatch[1].trim());
|
|
156
|
+
continue;
|
|
157
|
+
}
|
|
158
|
+
// 列表格式的规则(仅当行包含约束性关键词时)
|
|
159
|
+
if (/^[-*]\s/.test(trimmed) && /禁止|必须|应当|确保|不要|must|should|ensure|never|forbidden|required/i.test(trimmed)) {
|
|
160
|
+
rules.push(trimmed.replace(/^[-*]\s*/, '').trim());
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
return rules;
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
//# sourceMappingURL=instruction-loader.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"instruction-loader.js","sourceRoot":"","sources":["../../../src/core/artifact-graph/instruction-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAsB/B,MAAM,OAAO,iBAAiB;IACpB,UAAU,CAAS;IACnB,MAAM,CAA0B;IAExC,YAAY,UAAkB,EAAE,MAAgC;QAC9D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,QAAkB,EAClB,UAAkB,EAClB,UAAkB,EAClB,cAAuB,EACvB,aAAmC;QAEnC,OAAO;QACP,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC1F,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC7B,QAAQ,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAED,SAAS;QACT,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM;YACxC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC;YACtC,CAAC,CAAC,EAAE,CAAC;QAEP,aAAa;QACb,MAAM,YAAY,GAA2B,EAAE,CAAC;QAChD,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,aAAa,EAAE,CAAC;gBAC7C,YAAY,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;YAChC,CAAC;QACH,CAAC;QAED,mBAAmB;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAEtD,yCAAyC;QACzC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACxD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,sCAAsC;QACtC,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;QAElE,OAAO;YACL,QAAQ;YACR,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,EAAE;YACvC,OAAO,EAAE,eAAe;YACxB,KAAK;YACL,kBAAkB;YAClB,YAAY;SACb,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,oBAAoB,CAAC,cAAuB;QAClD,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,yCAAyC;QACzC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QAED,gBAAgB;QAChB,IAAI,cAAc,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;;OAOG;IACK,YAAY,CAAC,QAAkB,EAAE,UAAkB;QACzD,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,sCAAsC;QACtC,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,IAAI,CAAC,2BAA2B,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC3E,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;QAC7B,CAAC;QAED,kBAAkB;QAClB,MAAM,eAAe,GAAG;YACtB,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,gBAAgB,CAAC;SACvD,CAAC;QAEF,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,CAAC;YACvC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;oBAChD,2BAA2B;oBAC3B,MAAM,SAAS,GAAG,OAAO;yBACtB,KAAK,CAAC,IAAI,CAAC;yBACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;yBAClB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;yBACvE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;oBACjD,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;gBAC3B,CAAC;gBAAC,MAAM,CAAC;oBACP,UAAU;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;QAED,YAAY;QACZ,MAAM,qBAAqB,GAAG;YAC5B,OAAO,CAAC,UAAU,EAAE,gBAAgB,CAAC;YACrC,WAAW;YACX,WAAW;SACZ,CAAC;QAEF,KAAK,MAAM,cAAc,IAAI,qBAAqB,EAAE,CAAC;YACnD,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;oBACtD,sBAAsB;oBACtB,MAAM,eAAe,GAAG,OAAO;yBAC5B,KAAK,CAAC,IAAI,CAAC;yBACX,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,uCAAuC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;yBAC5D,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;yBAClB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO;oBACxB,KAAK,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;gBACjC,CAAC;gBAAC,MAAM,CAAC;oBACP,UAAU;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK;QACL,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;OAOG;IACK,2BAA2B,CAAC,WAAmB;QACrD,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,SAAS;YACT,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;YAClG,IAAI,SAAS,EAAE,CAAC;gBACd,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBAChC,SAAS;YACX,CAAC;YAED,wBAAwB;YACxB,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,6DAA6D,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3G,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 输出路径解析器
|
|
3
|
+
*
|
|
4
|
+
* 解析工件的输出路径,支持 glob 模式和变量替换
|
|
5
|
+
*/
|
|
6
|
+
export declare class OutputResolver {
|
|
7
|
+
/**
|
|
8
|
+
* 解析输出路径
|
|
9
|
+
* 支持变量替换: <change-name>, <artifact-id> 等
|
|
10
|
+
*/
|
|
11
|
+
resolve(outputPattern: string, changeRoot: string, variables?: Record<string, string>): string;
|
|
12
|
+
/**
|
|
13
|
+
* 检查路径是否为 glob 模式
|
|
14
|
+
*/
|
|
15
|
+
isGlob(pattern: string): boolean;
|
|
16
|
+
}
|
|
17
|
+
//# sourceMappingURL=outputs.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"outputs.d.ts","sourceRoot":"","sources":["../../../src/core/artifact-graph/outputs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,qBAAa,cAAc;IACzB;;;OAGG;IACH,OAAO,CACL,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACrC,MAAM;IAWT;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGjC"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 输出路径解析器
|
|
3
|
+
*
|
|
4
|
+
* 解析工件的输出路径,支持 glob 模式和变量替换
|
|
5
|
+
*/
|
|
6
|
+
import { resolve } from 'path';
|
|
7
|
+
export class OutputResolver {
|
|
8
|
+
/**
|
|
9
|
+
* 解析输出路径
|
|
10
|
+
* 支持变量替换: <change-name>, <artifact-id> 等
|
|
11
|
+
*/
|
|
12
|
+
resolve(outputPattern, changeRoot, variables = {}) {
|
|
13
|
+
let resolved = outputPattern;
|
|
14
|
+
// 变量替换
|
|
15
|
+
for (const [key, value] of Object.entries(variables)) {
|
|
16
|
+
resolved = resolved.replaceAll(`<${key}>`, value);
|
|
17
|
+
}
|
|
18
|
+
return resolve(changeRoot, resolved);
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* 检查路径是否为 glob 模式
|
|
22
|
+
*/
|
|
23
|
+
isGlob(pattern) {
|
|
24
|
+
return pattern.includes('*') || pattern.includes('?') || pattern.includes('{');
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
//# sourceMappingURL=outputs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"outputs.js","sourceRoot":"","sources":["../../../src/core/artifact-graph/outputs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,OAAO,cAAc;IACzB;;;OAGG;IACH,OAAO,CACL,aAAqB,EACrB,UAAkB,EAClB,YAAoC,EAAE;QAEtC,IAAI,QAAQ,GAAG,aAAa,CAAC;QAE7B,OAAO;QACP,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACrD,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAe;QACpB,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACjF,CAAC;CACF"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Schema 解析器
|
|
3
|
+
*
|
|
4
|
+
* 查找并加载项目/用户/包级别的 Schema 定义
|
|
5
|
+
* 支持三层 Schema 查找:项目级 → 用户级 → 包内置级
|
|
6
|
+
*/
|
|
7
|
+
import { type SchemaYaml } from './types.js';
|
|
8
|
+
import { ArtifactGraph } from './graph.js';
|
|
9
|
+
export declare class SchemaResolver {
|
|
10
|
+
private builtinSchemasDir;
|
|
11
|
+
constructor(builtinSchemasDir: string);
|
|
12
|
+
/**
|
|
13
|
+
* 解析 Schema - 按优先级查找
|
|
14
|
+
* 1. 项目级: <project-root>/schemas/<name>/schema.yaml
|
|
15
|
+
* 2. 用户级: ~/.specpow/schemas/<name>/schema.yaml
|
|
16
|
+
* 3. 包内置: <package>/schemas/<name>/schema.yaml
|
|
17
|
+
*/
|
|
18
|
+
resolve(schemaName: string, projectRoot?: string): SchemaYaml;
|
|
19
|
+
/**
|
|
20
|
+
* 加载并验证 Schema YAML
|
|
21
|
+
*/
|
|
22
|
+
private loadSchema;
|
|
23
|
+
/**
|
|
24
|
+
* 从 Schema 创建工件图
|
|
25
|
+
* @param schema - 已解析的 Schema 定义
|
|
26
|
+
* @param schemaId - Schema 标识符(目录名),用于文件系统操作和状态快照
|
|
27
|
+
*/
|
|
28
|
+
createGraph(schema: SchemaYaml, schemaId: string): ArtifactGraph;
|
|
29
|
+
/**
|
|
30
|
+
* 列出所有可用 Schema
|
|
31
|
+
*/
|
|
32
|
+
listAvailable(projectRoot?: string): string[];
|
|
33
|
+
}
|
|
34
|
+
//# sourceMappingURL=resolver.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/core/artifact-graph/resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,qBAAa,cAAc;IACzB,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,iBAAiB,EAAE,MAAM;IAIrC;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU;IAyB7D;;OAEG;IACH,OAAO,CAAC,UAAU;IAMlB;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa;IAQhE;;OAEG;IACH,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;CA0C9C"}
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Schema 解析器
|
|
3
|
+
*
|
|
4
|
+
* 查找并加载项目/用户/包级别的 Schema 定义
|
|
5
|
+
* 支持三层 Schema 查找:项目级 → 用户级 → 包内置级
|
|
6
|
+
*/
|
|
7
|
+
import { readFileSync, existsSync, readdirSync } from 'fs';
|
|
8
|
+
import { join } from 'path';
|
|
9
|
+
import { homedir } from 'os';
|
|
10
|
+
import { parse as parseYaml } from 'yaml';
|
|
11
|
+
import { SchemaYamlSchema } from './types.js';
|
|
12
|
+
import { ArtifactGraph } from './graph.js';
|
|
13
|
+
export class SchemaResolver {
|
|
14
|
+
builtinSchemasDir;
|
|
15
|
+
constructor(builtinSchemasDir) {
|
|
16
|
+
this.builtinSchemasDir = builtinSchemasDir;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* 解析 Schema - 按优先级查找
|
|
20
|
+
* 1. 项目级: <project-root>/schemas/<name>/schema.yaml
|
|
21
|
+
* 2. 用户级: ~/.specpow/schemas/<name>/schema.yaml
|
|
22
|
+
* 3. 包内置: <package>/schemas/<name>/schema.yaml
|
|
23
|
+
*/
|
|
24
|
+
resolve(schemaName, projectRoot) {
|
|
25
|
+
const candidates = [];
|
|
26
|
+
if (projectRoot) {
|
|
27
|
+
candidates.push(join(projectRoot, 'schemas', schemaName, 'schema.yaml'));
|
|
28
|
+
}
|
|
29
|
+
// 用户级 Schema
|
|
30
|
+
const userSchemaPath = join(homedir(), '.specpow', 'schemas', schemaName, 'schema.yaml');
|
|
31
|
+
candidates.push(userSchemaPath);
|
|
32
|
+
candidates.push(join(this.builtinSchemasDir, schemaName, 'schema.yaml'));
|
|
33
|
+
for (const candidate of candidates) {
|
|
34
|
+
if (existsSync(candidate)) {
|
|
35
|
+
return this.loadSchema(candidate);
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
throw new Error(`Schema "${schemaName}" not found. Searched:\n` +
|
|
39
|
+
candidates.map(c => ` - ${c}`).join('\n'));
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* 加载并验证 Schema YAML
|
|
43
|
+
*/
|
|
44
|
+
loadSchema(filePath) {
|
|
45
|
+
const content = readFileSync(filePath, 'utf-8');
|
|
46
|
+
const raw = parseYaml(content);
|
|
47
|
+
return SchemaYamlSchema.parse(raw);
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* 从 Schema 创建工件图
|
|
51
|
+
* @param schema - 已解析的 Schema 定义
|
|
52
|
+
* @param schemaId - Schema 标识符(目录名),用于文件系统操作和状态快照
|
|
53
|
+
*/
|
|
54
|
+
createGraph(schema, schemaId) {
|
|
55
|
+
return new ArtifactGraph(schemaId, schema.artifacts, schema.apply.requires);
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* 列出所有可用 Schema
|
|
59
|
+
*/
|
|
60
|
+
listAvailable(projectRoot) {
|
|
61
|
+
const schemas = new Set();
|
|
62
|
+
// 包内置
|
|
63
|
+
if (existsSync(this.builtinSchemasDir)) {
|
|
64
|
+
const dirs = readdirSync(this.builtinSchemasDir, { withFileTypes: true });
|
|
65
|
+
for (const dir of dirs) {
|
|
66
|
+
if (dir.isDirectory()) {
|
|
67
|
+
const schemaFile = join(this.builtinSchemasDir, dir.name, 'schema.yaml');
|
|
68
|
+
if (existsSync(schemaFile)) {
|
|
69
|
+
schemas.add(dir.name);
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
// 用户级
|
|
75
|
+
const userSchemasDir = join(homedir(), '.specpow', 'schemas');
|
|
76
|
+
if (existsSync(userSchemasDir)) {
|
|
77
|
+
const dirs = readdirSync(userSchemasDir, { withFileTypes: true });
|
|
78
|
+
for (const dir of dirs) {
|
|
79
|
+
if (dir.isDirectory()) {
|
|
80
|
+
schemas.add(dir.name);
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
// 项目级
|
|
85
|
+
if (projectRoot) {
|
|
86
|
+
const projectSchemasDir = join(projectRoot, 'schemas');
|
|
87
|
+
if (existsSync(projectSchemasDir)) {
|
|
88
|
+
const dirs = readdirSync(projectSchemasDir, { withFileTypes: true });
|
|
89
|
+
for (const dir of dirs) {
|
|
90
|
+
if (dir.isDirectory()) {
|
|
91
|
+
schemas.add(dir.name);
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
return Array.from(schemas);
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
//# sourceMappingURL=resolver.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../src/core/artifact-graph/resolver.ts"],"names":[],"mappings":"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"}
|