@namewta/speculo 0.7.2 → 0.7.4
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/dist/src/migrations.js +755 -23
- package/dist/src/migrations.js.map +1 -1
- package/package.json +1 -1
- package/template/canonical/canonical-specdev-engineering-cognitive-mentor.md +200 -448
- package/template/canonical/canonical-specdev-goal-plan.md +744 -1108
- package/template/canonical/canonical-specdev-grill-with-docs.md +201 -449
- package/template/canonical/canonical-specdev-spec.md +232 -486
- package/template/canonical/canonical-specdev-tickets.md +411 -590
- package/template/canonical/canonical-specdev-wayfinder.md +199 -447
- package/template/skills/migrate-runtime-state/SKILL.md +6 -6
- package/template/skills/migrate-runtime-state/references/migration-contract.md +9 -3
- package/template/skills/migrate-runtime-state/scripts/migrate-runtime-state.mjs +404 -33
- package/template/workflows/specdev/I-implement/I-implement.md +98 -143
- package/template/workflows/specdev/I-implement/evidence-template.md +66 -48
- package/template/workflows/specdev/I-implement/execution-preflight.md +31 -21
- package/template/workflows/specdev/I-implement/merge-conflict-protocol.md +12 -12
- package/template/workflows/specdev/I-init-setup/I-init-setup.md +4 -5
- package/template/workflows/specdev/I-init-setup/change-status-template.json +14 -1
- package/template/workflows/specdev/I-init-setup/config-template.json +7 -6
- package/template/workflows/specdev/I-init-setup/status-template.json +1 -1
- package/template/workflows/specdev/INDEX.md +11 -8
- package/template/workflows/specdev/P-goal-plan/P-goal-plan.md +76 -102
- package/template/workflows/specdev/P-goal-plan/completion-control.md +26 -44
- package/template/workflows/specdev/P-goal-plan/goal-plan-template.md +46 -37
- package/template/workflows/specdev/P-goal-plan/lead-orchestration.md +34 -0
- package/template/workflows/specdev/P-goal-plan/orchestration-protocol.md +31 -46
- package/template/workflows/specdev/P-goal-plan/planning-modes.md +67 -89
- package/template/workflows/specdev/P-prototype/ui-prototype.md +1 -1
- package/template/workflows/specdev/T-tickets/T-tickets.md +6 -3
- package/template/workflows/specdev/T-tickets/ticket-readiness.md +5 -3
- package/template/workflows/specdev/T-tickets/ticket-template.md +8 -1
- package/template/workflows/specdev/T-tickets/tickets-map-template.md +5 -4
- package/template/workflows/specdev/_state/status.json +1 -1
- package/template/workflows/specdev/common/README.md +2 -2
- package/template/workflows/specdev/common/rules/change-completion.md +17 -20
- package/template/workflows/specdev/common/rules/deviation-control.md +1 -1
- package/template/workflows/specdev/common/rules/evidence-and-verification.md +31 -37
- package/template/workflows/specdev/common/rules/path-ownership.md +21 -23
- package/template/workflows/specdev/common/rules/readiness-and-depth.md +1 -1
- package/template/workflows/specdev/common/schemas/change-status.schema.json +153 -363
- package/template/workflows/specdev/common/schemas/config.schema.json +17 -13
- package/template/workflows/specdev/common/schemas/goal-plan.schema.json +33 -16
- package/template/workflows/specdev/common/schemas/status.schema.json +7 -63
- package/template/workflows/specdev/common/skills/dev-worktree/SKILL.md +42 -21
- package/template/workflows/specdev/common/skills/dev-worktree/references/create.md +36 -21
- package/template/workflows/specdev/common/skills/dev-worktree/references/finalize.md +46 -18
- package/template/workflows/specdev/common/skills/subagent-delivery/SKILL.md +34 -31
- package/template/workflows/specdev/common/skills/subagent-delivery/references/external-web-subagent.md +10 -23
- package/template/workflows/specdev/common/skills/subagent-delivery/references/native-subagent.md +15 -25
- package/template/workflows/specdev/common/tools/README.md +2 -1
- package/template/workflows/specdev/common/tools/validate-specdev.mjs +591 -219
- package/template/workflows/specdev/I-implement/delegated-evidence-template.md +0 -12
- package/template/workflows/specdev/P-goal-plan/delegated-execution-template.md +0 -35
- package/template/workflows/specdev/P-goal-plan/delegated-execution.md +0 -59
- package/template/workflows/specdev/P-goal-plan/workspace-execution-template.md +0 -24
|
@@ -513,7 +513,7 @@ Ticket 告诉执行者:做什么、为什么、不能改变什么、按什么
|
|
|
513
513
|
|
|
514
514
|
### Deep
|
|
515
515
|
|
|
516
|
-
任一条件触发:公共 API、schema、wire format、数据迁移、认证授权、隐私、资金、不可逆操作、expand-contract
|
|
516
|
+
任一条件触发:公共 API、schema、wire format、数据迁移、认证授权、隐私、资金、不可逆操作、expand-contract、共享核心路径、多个 implementation owner 的跨 Ticket 写入协调、多个实质架构方案或高事故半径。
|
|
517
517
|
|
|
518
518
|
额外要求:数据流或状态转换、兼容窗口、迁移顺序、可观测性、回滚、风险缓解、收缩条件和人工批准点。
|
|
519
519
|
|
|
@@ -593,7 +593,7 @@ Ticket 只有同时满足以下适用条件才可设置 `ready: true`:
|
|
|
593
593
|
|
|
594
594
|
- 未批准的 ticket、spec、architecture 或 release 偏差不得继续实现。
|
|
595
595
|
- 不得通过扩大 `writable_paths`、删除测试、降低断言或把风险改写成“已知限制”来绕过停止。
|
|
596
|
-
-
|
|
596
|
+
- 偏差影响并行执行、source checkpoint 或 candidate 集成时,Lead 必须暂停受影响 Wave,重新计算路径所有权、依赖、Gate 与父分支顺序;任何 subagent 都不能自行改写上层合同。
|
|
597
597
|
|
|
598
598
|
</deviation-control>
|
|
599
599
|
|
|
@@ -656,16 +656,15 @@ Ticket 只有同时满足以下适用条件才可设置 `ready: true`:
|
|
|
656
656
|
|
|
657
657
|
```json
|
|
658
658
|
{
|
|
659
|
-
"schema_version":
|
|
659
|
+
"schema_version": 5,
|
|
660
660
|
"interaction_language": "zh-CN",
|
|
661
661
|
"artifact_language": "zh-CN",
|
|
662
662
|
"git": {
|
|
663
|
-
"
|
|
664
|
-
"default_branch": null,
|
|
665
|
-
"worktree_for_parallel": true
|
|
663
|
+
"default_branch": null
|
|
666
664
|
},
|
|
667
665
|
"execution": {
|
|
668
|
-
"
|
|
666
|
+
"max_implementation_agents": 3,
|
|
667
|
+
"max_integration_attempts": 3,
|
|
669
668
|
"deep_ticket_human_approval": true,
|
|
670
669
|
"shared_path_owner": "explicit"
|
|
671
670
|
},
|
|
@@ -678,7 +677,9 @@ Ticket 只有同时满足以下适用条件才可设置 `ready: true`:
|
|
|
678
677
|
"planning": {
|
|
679
678
|
"default_depth": "standard",
|
|
680
679
|
"require_ready_gate": true,
|
|
681
|
-
"require_evidence": true
|
|
680
|
+
"require_evidence": true,
|
|
681
|
+
"ui_prototype_default_variants": 3,
|
|
682
|
+
"ui_prototype_max_variants": 5
|
|
682
683
|
}
|
|
683
684
|
}
|
|
684
685
|
```
|
|
@@ -690,33 +691,32 @@ Ticket 只有同时满足以下适用条件才可设置 `ready: true`:
|
|
|
690
691
|
```json
|
|
691
692
|
{
|
|
692
693
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
693
|
-
"$id": "urn:speculo:specdev:config:
|
|
694
|
+
"$id": "urn:speculo:specdev:config:v5",
|
|
694
695
|
"title": "SpecDev Configuration",
|
|
695
696
|
"type": "object",
|
|
696
697
|
"required": ["schema_version", "interaction_language", "artifact_language", "git", "execution", "verification", "planning"],
|
|
697
698
|
"properties": {
|
|
698
|
-
"schema_version": {"const":
|
|
699
|
+
"schema_version": {"const": 5},
|
|
699
700
|
"interaction_language": {"type": "string", "minLength": 1},
|
|
700
701
|
"artifact_language": {"type": "string", "minLength": 1},
|
|
701
702
|
"git": {
|
|
702
703
|
"type": "object",
|
|
703
|
-
"required": ["
|
|
704
|
+
"required": ["default_branch"],
|
|
704
705
|
"properties": {
|
|
705
|
-
"
|
|
706
|
-
"default_branch": {"type": ["string", "null"]},
|
|
707
|
-
"worktree_for_parallel": {"type": "boolean"}
|
|
706
|
+
"default_branch": {"type": ["string", "null"]}
|
|
708
707
|
},
|
|
709
|
-
"additionalProperties":
|
|
708
|
+
"additionalProperties": false
|
|
710
709
|
},
|
|
711
710
|
"execution": {
|
|
712
711
|
"type": "object",
|
|
713
|
-
"required": ["
|
|
712
|
+
"required": ["max_implementation_agents", "max_integration_attempts", "deep_ticket_human_approval", "shared_path_owner"],
|
|
714
713
|
"properties": {
|
|
715
|
-
"
|
|
714
|
+
"max_implementation_agents": {"type": "integer", "minimum": 1},
|
|
715
|
+
"max_integration_attempts": {"type": "integer", "minimum": 1},
|
|
716
716
|
"deep_ticket_human_approval": {"type": "boolean"},
|
|
717
717
|
"shared_path_owner": {"type": "string", "minLength": 1}
|
|
718
718
|
},
|
|
719
|
-
"additionalProperties":
|
|
719
|
+
"additionalProperties": false
|
|
720
720
|
},
|
|
721
721
|
"verification": {
|
|
722
722
|
"type": "object",
|
|
@@ -731,16 +731,21 @@ Ticket 只有同时满足以下适用条件才可设置 `ready: true`:
|
|
|
731
731
|
},
|
|
732
732
|
"planning": {
|
|
733
733
|
"type": "object",
|
|
734
|
-
"required": ["default_depth", "require_ready_gate", "require_evidence"],
|
|
734
|
+
"required": ["default_depth", "require_ready_gate", "require_evidence", "ui_prototype_default_variants", "ui_prototype_max_variants"],
|
|
735
735
|
"properties": {
|
|
736
736
|
"default_depth": {"enum": ["lite", "standard", "deep"]},
|
|
737
737
|
"require_ready_gate": {"type": "boolean"},
|
|
738
|
-
"require_evidence": {"type": "boolean"}
|
|
738
|
+
"require_evidence": {"type": "boolean"},
|
|
739
|
+
"ui_prototype_default_variants": {"type": "integer", "minimum": 1},
|
|
740
|
+
"ui_prototype_max_variants": {"type": "integer", "minimum": 1}
|
|
739
741
|
},
|
|
740
742
|
"additionalProperties": true
|
|
741
743
|
}
|
|
742
744
|
},
|
|
743
|
-
"
|
|
745
|
+
"allOf": [{
|
|
746
|
+
"$comment": "ui_prototype_default_variants <= ui_prototype_max_variants is enforced by validate-specdev.mjs because JSON Schema cannot compare sibling numeric values."
|
|
747
|
+
}],
|
|
748
|
+
"additionalProperties": false
|
|
744
749
|
}
|
|
745
750
|
```
|
|
746
751
|
|
|
@@ -750,7 +755,7 @@ Ticket 只有同时满足以下适用条件才可设置 `ready: true`:
|
|
|
750
755
|
|
|
751
756
|
```json
|
|
752
757
|
{
|
|
753
|
-
"schema_version":
|
|
758
|
+
"schema_version": 5,
|
|
754
759
|
"workflow": "specdev",
|
|
755
760
|
"active": [],
|
|
756
761
|
"archived": []
|
|
@@ -764,83 +769,27 @@ Ticket 只有同时满足以下适用条件才可设置 `ready: true`:
|
|
|
764
769
|
```json
|
|
765
770
|
{
|
|
766
771
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
767
|
-
"$id": "urn:speculo:specdev:status:
|
|
772
|
+
"$id": "urn:speculo:specdev:status:v5",
|
|
768
773
|
"title": "SpecDev Global Status",
|
|
769
774
|
"type": "object",
|
|
770
|
-
"required": [
|
|
771
|
-
"schema_version",
|
|
772
|
-
"workflow",
|
|
773
|
-
"active",
|
|
774
|
-
"archived"
|
|
775
|
-
],
|
|
775
|
+
"required": ["schema_version", "workflow", "active", "archived"],
|
|
776
776
|
"properties": {
|
|
777
|
-
"schema_version": {
|
|
778
|
-
|
|
779
|
-
},
|
|
780
|
-
"workflow": {
|
|
781
|
-
"const": "specdev"
|
|
782
|
-
},
|
|
777
|
+
"schema_version": {"const": 5},
|
|
778
|
+
"workflow": {"const": "specdev"},
|
|
783
779
|
"active": {
|
|
784
780
|
"type": "array",
|
|
785
781
|
"items": {
|
|
786
782
|
"type": "object",
|
|
787
|
-
"required": [
|
|
788
|
-
"change",
|
|
789
|
-
"current_work",
|
|
790
|
-
"works_run"
|
|
791
|
-
],
|
|
783
|
+
"required": ["change"],
|
|
792
784
|
"properties": {
|
|
793
785
|
"change": {
|
|
794
786
|
"type": "string",
|
|
795
787
|
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"
|
|
796
|
-
},
|
|
797
|
-
"current_work": {
|
|
798
|
-
"type": [
|
|
799
|
-
"string",
|
|
800
|
-
"null"
|
|
801
|
-
],
|
|
802
|
-
"pattern": "^specdev/"
|
|
803
|
-
},
|
|
804
|
-
"works_run": {
|
|
805
|
-
"type": "array",
|
|
806
|
-
"items": {
|
|
807
|
-
"type": "string",
|
|
808
|
-
"pattern": "^specdev/"
|
|
809
|
-
},
|
|
810
|
-
"uniqueItems": true
|
|
811
|
-
},
|
|
812
|
-
"claimed_investigations": {
|
|
813
|
-
"type": "array",
|
|
814
|
-
"items": {
|
|
815
|
-
"type": "object",
|
|
816
|
-
"required": [
|
|
817
|
-
"id",
|
|
818
|
-
"owner",
|
|
819
|
-
"claimed_at"
|
|
820
|
-
],
|
|
821
|
-
"properties": {
|
|
822
|
-
"id": {
|
|
823
|
-
"type": "string"
|
|
824
|
-
},
|
|
825
|
-
"owner": {
|
|
826
|
-
"type": "string"
|
|
827
|
-
},
|
|
828
|
-
"session": {
|
|
829
|
-
"type": [
|
|
830
|
-
"string",
|
|
831
|
-
"null"
|
|
832
|
-
]
|
|
833
|
-
},
|
|
834
|
-
"claimed_at": {
|
|
835
|
-
"type": "string"
|
|
836
|
-
}
|
|
837
|
-
},
|
|
838
|
-
"additionalProperties": false
|
|
839
|
-
}
|
|
840
788
|
}
|
|
841
789
|
},
|
|
842
790
|
"additionalProperties": false
|
|
843
|
-
}
|
|
791
|
+
},
|
|
792
|
+
"uniqueItems": true
|
|
844
793
|
},
|
|
845
794
|
"archived": {
|
|
846
795
|
"type": "array",
|
|
@@ -861,11 +810,24 @@ Ticket 只有同时满足以下适用条件才可设置 `ready: true`:
|
|
|
861
810
|
|
|
862
811
|
```json
|
|
863
812
|
{
|
|
864
|
-
"schema_version":
|
|
813
|
+
"schema_version": 6,
|
|
865
814
|
"artifact": "change-status",
|
|
866
815
|
"change": "<YYYY-MM-DD-topic>",
|
|
867
816
|
"change_status": "active",
|
|
868
817
|
"current_work": null,
|
|
818
|
+
"works_run": [],
|
|
819
|
+
"claimed_investigations": [],
|
|
820
|
+
"execution_authorization": {
|
|
821
|
+
"implementation_commit": {"status": "not-authorized", "source": null, "granted_at": null, "scope": "Ticket implementation commits"},
|
|
822
|
+
"local_candidate_integration": {"status": "not-authorized", "source": null, "granted_at": null, "scope": "Lead-owned local direct-parent or candidate integration and parent update"},
|
|
823
|
+
"source_cleanup": {"status": "not-authorized", "source": null, "granted_at": null, "scope": "Source worktree and branch cleanup"}
|
|
824
|
+
},
|
|
825
|
+
"leadership": {
|
|
826
|
+
"current": "<owner-or-session-locator>",
|
|
827
|
+
"epoch": 1,
|
|
828
|
+
"assigned_at": "<ISO-8601>",
|
|
829
|
+
"history": []
|
|
830
|
+
},
|
|
869
831
|
"created_at": "<ISO-8601>",
|
|
870
832
|
"updated_at": "<ISO-8601>",
|
|
871
833
|
"completed_at": null,
|
|
@@ -884,394 +846,184 @@ Ticket 只有同时满足以下适用条件才可设置 `ready: true`:
|
|
|
884
846
|
```json
|
|
885
847
|
{
|
|
886
848
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
887
|
-
"$id": "urn:speculo:specdev:change-status:
|
|
849
|
+
"$id": "urn:speculo:specdev:change-status:v6",
|
|
888
850
|
"title": "SpecDev Change Status",
|
|
889
851
|
"type": "object",
|
|
890
852
|
"required": [
|
|
891
|
-
"schema_version",
|
|
892
|
-
"
|
|
893
|
-
"
|
|
894
|
-
"change_status",
|
|
895
|
-
"current_work",
|
|
896
|
-
"created_at",
|
|
897
|
-
"updated_at",
|
|
898
|
-
"completed_at",
|
|
899
|
-
"archived",
|
|
900
|
-
"archive_path",
|
|
901
|
-
"blockers",
|
|
902
|
-
"deviations"
|
|
853
|
+
"schema_version", "artifact", "change", "change_status", "current_work", "works_run",
|
|
854
|
+
"claimed_investigations", "execution_authorization", "leadership", "created_at", "updated_at",
|
|
855
|
+
"completed_at", "archived", "archive_path", "blockers", "deviations", "worktrees"
|
|
903
856
|
],
|
|
904
857
|
"properties": {
|
|
905
|
-
"schema_version": {
|
|
906
|
-
|
|
907
|
-
},
|
|
908
|
-
"
|
|
909
|
-
|
|
910
|
-
},
|
|
911
|
-
"
|
|
912
|
-
|
|
913
|
-
|
|
914
|
-
},
|
|
915
|
-
"
|
|
916
|
-
|
|
917
|
-
|
|
918
|
-
|
|
919
|
-
|
|
920
|
-
|
|
921
|
-
|
|
858
|
+
"schema_version": {"const": 6},
|
|
859
|
+
"artifact": {"const": "change-status"},
|
|
860
|
+
"change": {"type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"},
|
|
861
|
+
"change_status": {"enum": ["active", "blocked", "completed", "archived"]},
|
|
862
|
+
"current_work": {"type": ["string", "null"], "pattern": "^specdev/"},
|
|
863
|
+
"works_run": {"type": "array", "items": {"type": "string", "pattern": "^specdev/"}, "uniqueItems": true},
|
|
864
|
+
"claimed_investigations": {"type": "array", "items": {"$ref": "#/$defs/claim"}},
|
|
865
|
+
"execution_authorization": {"$ref": "#/$defs/authorization"},
|
|
866
|
+
"leadership": {"$ref": "#/$defs/leadership"},
|
|
867
|
+
"created_at": {"type": "string", "minLength": 1},
|
|
868
|
+
"updated_at": {"type": "string", "minLength": 1},
|
|
869
|
+
"completed_at": {"type": ["string", "null"]},
|
|
870
|
+
"archived": {"type": "boolean"},
|
|
871
|
+
"archive_path": {"anyOf": [{"type": "null"}, {"type": "string", "pattern": "^specdev/archive/[0-9]{4}-[0-9]{2}/.+/$"}]},
|
|
872
|
+
"blockers": {"type": "array", "items": {"type": "string"}},
|
|
873
|
+
"deviations": {"type": "array", "items": {"type": "string"}},
|
|
874
|
+
"worktrees": {"type": "array", "items": {"$ref": "#/$defs/worktree"}}
|
|
875
|
+
},
|
|
876
|
+
"$defs": {
|
|
877
|
+
"claim": {
|
|
878
|
+
"type": "object",
|
|
879
|
+
"required": ["id", "owner", "session", "claimed_at"],
|
|
880
|
+
"properties": {
|
|
881
|
+
"id": {"type": "string", "minLength": 1},
|
|
882
|
+
"owner": {"type": "string", "minLength": 1},
|
|
883
|
+
"session": {"type": ["string", "null"]},
|
|
884
|
+
"claimed_at": {"type": "string", "minLength": 1}
|
|
885
|
+
},
|
|
886
|
+
"additionalProperties": false
|
|
922
887
|
},
|
|
923
|
-
"
|
|
924
|
-
"type":
|
|
925
|
-
|
|
926
|
-
|
|
927
|
-
|
|
888
|
+
"authorization-entry": {
|
|
889
|
+
"type": "object",
|
|
890
|
+
"required": ["status", "source", "granted_at", "scope"],
|
|
891
|
+
"properties": {
|
|
892
|
+
"status": {"enum": ["authorized", "not-authorized", "revoked"]},
|
|
893
|
+
"source": {"type": ["string", "null"]},
|
|
894
|
+
"granted_at": {"type": ["string", "null"]},
|
|
895
|
+
"scope": {"type": "string", "minLength": 1}
|
|
896
|
+
},
|
|
897
|
+
"allOf": [{
|
|
898
|
+
"if": {"properties": {"status": {"const": "authorized"}}, "required": ["status"]},
|
|
899
|
+
"then": {"properties": {"source": {"type": "string", "minLength": 1}, "granted_at": {"type": "string", "minLength": 1}}}
|
|
900
|
+
}],
|
|
901
|
+
"additionalProperties": false
|
|
928
902
|
},
|
|
929
|
-
"
|
|
930
|
-
"type": "
|
|
931
|
-
"
|
|
903
|
+
"authorization": {
|
|
904
|
+
"type": "object",
|
|
905
|
+
"required": ["implementation_commit", "local_candidate_integration", "source_cleanup"],
|
|
906
|
+
"properties": {
|
|
907
|
+
"implementation_commit": {"$ref": "#/$defs/authorization-entry"},
|
|
908
|
+
"local_candidate_integration": {"$ref": "#/$defs/authorization-entry"},
|
|
909
|
+
"source_cleanup": {"$ref": "#/$defs/authorization-entry"}
|
|
910
|
+
},
|
|
911
|
+
"additionalProperties": false
|
|
932
912
|
},
|
|
933
|
-
"
|
|
934
|
-
"type": "
|
|
935
|
-
"
|
|
913
|
+
"leadership-history": {
|
|
914
|
+
"type": "object",
|
|
915
|
+
"required": ["owner", "epoch", "assigned_at", "ended_at"],
|
|
916
|
+
"properties": {
|
|
917
|
+
"owner": {"type": "string", "minLength": 1},
|
|
918
|
+
"epoch": {"type": "integer", "minimum": 1},
|
|
919
|
+
"assigned_at": {"type": "string", "minLength": 1},
|
|
920
|
+
"ended_at": {"type": "string", "minLength": 1}
|
|
921
|
+
},
|
|
922
|
+
"additionalProperties": false
|
|
936
923
|
},
|
|
937
|
-
"
|
|
938
|
-
"type":
|
|
939
|
-
|
|
940
|
-
|
|
941
|
-
|
|
924
|
+
"leadership": {
|
|
925
|
+
"type": "object",
|
|
926
|
+
"required": ["current", "epoch", "assigned_at", "history"],
|
|
927
|
+
"properties": {
|
|
928
|
+
"current": {"type": "string", "minLength": 1},
|
|
929
|
+
"epoch": {"type": "integer", "minimum": 1},
|
|
930
|
+
"assigned_at": {"type": "string", "minLength": 1},
|
|
931
|
+
"history": {"type": "array", "items": {"$ref": "#/$defs/leadership-history"}}
|
|
932
|
+
},
|
|
933
|
+
"additionalProperties": false
|
|
942
934
|
},
|
|
943
|
-
"
|
|
944
|
-
"type": "
|
|
935
|
+
"full-suite": {
|
|
936
|
+
"type": "object",
|
|
937
|
+
"required": ["required", "status", "reason", "evidence"],
|
|
938
|
+
"properties": {
|
|
939
|
+
"required": {"type": "boolean"},
|
|
940
|
+
"status": {"enum": ["not-required", "pending", "passed", "failed"]},
|
|
941
|
+
"reason": {"type": ["string", "null"]},
|
|
942
|
+
"evidence": {"type": ["string", "null"]}
|
|
943
|
+
},
|
|
944
|
+
"allOf": [{
|
|
945
|
+
"if": {"properties": {"required": {"const": false}}, "required": ["required"]},
|
|
946
|
+
"then": {"properties": {"status": {"const": "not-required"}, "reason": {"type": "string", "minLength": 1}}}
|
|
947
|
+
}],
|
|
948
|
+
"additionalProperties": false
|
|
945
949
|
},
|
|
946
|
-
"
|
|
947
|
-
"
|
|
948
|
-
|
|
949
|
-
|
|
950
|
-
},
|
|
950
|
+
"worktree": {
|
|
951
|
+
"type": "object",
|
|
952
|
+
"required": ["ticket_id", "owner", "implementation_owner", "integration_owner", "provider", "base_sha", "parent_branch", "branch", "workspace_ref", "source_checkpoint", "integration", "status", "updated_at"],
|
|
953
|
+
"properties": {
|
|
954
|
+
"ticket_id": {"type": "string", "pattern": "^T-[0-9]{2,}$"},
|
|
955
|
+
"owner": {"type": "string", "minLength": 1},
|
|
956
|
+
"implementation_owner": {"type": "string", "minLength": 1},
|
|
957
|
+
"integration_owner": {"type": "string", "minLength": 1},
|
|
958
|
+
"provider": {"const": "git"},
|
|
959
|
+
"base_sha": {"type": "string", "minLength": 1},
|
|
960
|
+
"parent_branch": {"type": "string", "minLength": 1},
|
|
961
|
+
"branch": {"type": "string", "minLength": 1},
|
|
962
|
+
"workspace_ref": {"type": "string", "pattern": "^(?:current|specdev-worktree/[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*/T-[0-9]{2,})$"},
|
|
963
|
+
"source_checkpoint": {"type": ["string", "null"]},
|
|
964
|
+
"integration": {"$ref": "#/$defs/integration"},
|
|
965
|
+
"status": {"enum": ["planned", "active", "review", "integrating", "integrated", "removed", "blocked"]},
|
|
966
|
+
"updated_at": {"type": "string", "minLength": 1}
|
|
967
|
+
},
|
|
968
|
+
"allOf": [
|
|
951
969
|
{
|
|
952
|
-
"
|
|
953
|
-
"
|
|
954
|
-
}
|
|
955
|
-
]
|
|
956
|
-
},
|
|
957
|
-
"blockers": {
|
|
958
|
-
"type": "array",
|
|
959
|
-
"items": {
|
|
960
|
-
"type": "string"
|
|
961
|
-
}
|
|
962
|
-
},
|
|
963
|
-
"deviations": {
|
|
964
|
-
"type": "array",
|
|
965
|
-
"items": {
|
|
966
|
-
"type": "string"
|
|
967
|
-
}
|
|
968
|
-
},
|
|
969
|
-
"worktrees": {
|
|
970
|
-
"type": "array",
|
|
971
|
-
"items": {
|
|
972
|
-
"type": "object",
|
|
973
|
-
"required": [
|
|
974
|
-
"ticket_id",
|
|
975
|
-
"owner",
|
|
976
|
-
"provider",
|
|
977
|
-
"base_sha",
|
|
978
|
-
"branch",
|
|
979
|
-
"workspace_ref",
|
|
980
|
-
"status",
|
|
981
|
-
"updated_at"
|
|
982
|
-
],
|
|
983
|
-
"properties": {
|
|
984
|
-
"ticket_id": {
|
|
985
|
-
"type": "string",
|
|
986
|
-
"pattern": "^T-[0-9]{2,}$"
|
|
987
|
-
},
|
|
988
|
-
"owner": {
|
|
989
|
-
"type": "string",
|
|
990
|
-
"minLength": 1
|
|
991
|
-
},
|
|
992
|
-
"integration_owner": {
|
|
993
|
-
"type": "string",
|
|
994
|
-
"minLength": 1
|
|
995
|
-
},
|
|
996
|
-
"provider": {
|
|
997
|
-
"enum": [
|
|
998
|
-
"native",
|
|
999
|
-
"git",
|
|
1000
|
-
"external"
|
|
1001
|
-
]
|
|
1002
|
-
},
|
|
1003
|
-
"base_sha": {
|
|
1004
|
-
"type": "string",
|
|
1005
|
-
"minLength": 1
|
|
1006
|
-
},
|
|
1007
|
-
"parent_branch": {
|
|
1008
|
-
"type": "string",
|
|
1009
|
-
"minLength": 1
|
|
1010
|
-
},
|
|
1011
|
-
"branch": {
|
|
1012
|
-
"type": "string",
|
|
1013
|
-
"minLength": 1
|
|
1014
|
-
},
|
|
1015
|
-
"workspace_ref": {
|
|
1016
|
-
"type": "string",
|
|
1017
|
-
"minLength": 1,
|
|
1018
|
-
"pattern": "^(?!/)(?![A-Za-z]:[\\\\/]).+"
|
|
1019
|
-
},
|
|
1020
|
-
"terminal_action": {
|
|
1021
|
-
"enum": [
|
|
1022
|
-
"integrate",
|
|
1023
|
-
"retain"
|
|
1024
|
-
]
|
|
1025
|
-
},
|
|
1026
|
-
"source_checkpoint": {
|
|
1027
|
-
"type": [
|
|
1028
|
-
"string",
|
|
1029
|
-
"null"
|
|
1030
|
-
]
|
|
1031
|
-
},
|
|
1032
|
-
"integration": {
|
|
1033
|
-
"type": "object",
|
|
1034
|
-
"required": [
|
|
1035
|
-
"status",
|
|
1036
|
-
"parent_before_sha",
|
|
1037
|
-
"source_sha",
|
|
1038
|
-
"result_sha",
|
|
1039
|
-
"method",
|
|
1040
|
-
"conflict_paths",
|
|
1041
|
-
"verification",
|
|
1042
|
-
"evidence",
|
|
1043
|
-
"attempts"
|
|
1044
|
-
],
|
|
970
|
+
"if": {"properties": {"workspace_ref": {"const": "current"}}, "required": ["workspace_ref"]},
|
|
971
|
+
"then": {
|
|
1045
972
|
"properties": {
|
|
1046
|
-
"
|
|
1047
|
-
"
|
|
1048
|
-
"pending",
|
|
1049
|
-
"running",
|
|
1050
|
-
"passed",
|
|
1051
|
-
"blocked"
|
|
1052
|
-
]
|
|
1053
|
-
},
|
|
1054
|
-
"parent_before_sha": {
|
|
1055
|
-
"type": ["string", "null"]
|
|
1056
|
-
},
|
|
1057
|
-
"source_sha": {
|
|
1058
|
-
"type": ["string", "null"]
|
|
1059
|
-
},
|
|
1060
|
-
"result_sha": {
|
|
1061
|
-
"type": ["string", "null"]
|
|
1062
|
-
},
|
|
1063
|
-
"method": {
|
|
1064
|
-
"enum": [null, "fast-forward", "merge-commit"]
|
|
1065
|
-
},
|
|
1066
|
-
"conflict_paths": {
|
|
1067
|
-
"type": "array",
|
|
1068
|
-
"items": {"type": "string"}
|
|
1069
|
-
},
|
|
1070
|
-
"verification": {
|
|
1071
|
-
"enum": ["pending", "passed", "failed"]
|
|
1072
|
-
},
|
|
1073
|
-
"evidence": {
|
|
1074
|
-
"type": "string",
|
|
1075
|
-
"pattern": "^\\{roots\\.state\\}/specdev/changes/[^<]+/evidence/T-[0-9]{2,}\\.md$"
|
|
1076
|
-
},
|
|
1077
|
-
"attempts": {
|
|
1078
|
-
"type": "integer",
|
|
1079
|
-
"minimum": 0
|
|
1080
|
-
}
|
|
1081
|
-
},
|
|
1082
|
-
"additionalProperties": true
|
|
1083
|
-
},
|
|
1084
|
-
"status": {
|
|
1085
|
-
"enum": [
|
|
1086
|
-
"planned",
|
|
1087
|
-
"active",
|
|
1088
|
-
"review",
|
|
1089
|
-
"integrating",
|
|
1090
|
-
"integrated",
|
|
1091
|
-
"removed",
|
|
1092
|
-
"blocked"
|
|
1093
|
-
]
|
|
1094
|
-
},
|
|
1095
|
-
"updated_at": {
|
|
1096
|
-
"type": "string",
|
|
1097
|
-
"minLength": 1
|
|
1098
|
-
}
|
|
1099
|
-
},
|
|
1100
|
-
"dependentRequired": {
|
|
1101
|
-
"terminal_action": [
|
|
1102
|
-
"integration_owner",
|
|
1103
|
-
"parent_branch",
|
|
1104
|
-
"source_checkpoint",
|
|
1105
|
-
"integration"
|
|
1106
|
-
]
|
|
1107
|
-
},
|
|
1108
|
-
"allOf": [
|
|
1109
|
-
{
|
|
1110
|
-
"if": {
|
|
1111
|
-
"properties": {
|
|
1112
|
-
"status": {"const": "integrating"}
|
|
1113
|
-
},
|
|
1114
|
-
"required": ["status"]
|
|
1115
|
-
},
|
|
1116
|
-
"then": {
|
|
1117
|
-
"required": [
|
|
1118
|
-
"terminal_action",
|
|
1119
|
-
"integration_owner",
|
|
1120
|
-
"parent_branch",
|
|
1121
|
-
"source_checkpoint",
|
|
1122
|
-
"integration"
|
|
1123
|
-
],
|
|
1124
|
-
"properties": {
|
|
1125
|
-
"terminal_action": {"const": "integrate"}
|
|
1126
|
-
}
|
|
1127
|
-
}
|
|
1128
|
-
},
|
|
1129
|
-
{
|
|
1130
|
-
"if": {
|
|
1131
|
-
"properties": {
|
|
1132
|
-
"status": {"enum": ["integrating", "integrated"]},
|
|
1133
|
-
"terminal_action": {"const": "integrate"}
|
|
1134
|
-
},
|
|
1135
|
-
"required": ["status", "terminal_action"]
|
|
1136
|
-
},
|
|
1137
|
-
"then": {
|
|
1138
|
-
"properties": {
|
|
1139
|
-
"source_checkpoint": {"type": "string", "minLength": 1},
|
|
1140
|
-
"integration": {
|
|
1141
|
-
"properties": {
|
|
1142
|
-
"parent_before_sha": {"type": "string", "minLength": 1},
|
|
1143
|
-
"source_sha": {"type": "string", "minLength": 1},
|
|
1144
|
-
"attempts": {"type": "integer", "minimum": 1}
|
|
1145
|
-
}
|
|
1146
|
-
}
|
|
1147
|
-
}
|
|
1148
|
-
}
|
|
1149
|
-
},
|
|
1150
|
-
{
|
|
1151
|
-
"if": {
|
|
1152
|
-
"properties": {
|
|
1153
|
-
"status": {"const": "integrating"},
|
|
1154
|
-
"terminal_action": {"const": "integrate"}
|
|
1155
|
-
},
|
|
1156
|
-
"required": ["status", "terminal_action"]
|
|
1157
|
-
},
|
|
1158
|
-
"then": {
|
|
1159
|
-
"properties": {
|
|
1160
|
-
"integration": {
|
|
1161
|
-
"properties": {
|
|
1162
|
-
"status": {"const": "running"}
|
|
1163
|
-
}
|
|
1164
|
-
}
|
|
1165
|
-
}
|
|
1166
|
-
}
|
|
1167
|
-
},
|
|
1168
|
-
{
|
|
1169
|
-
"if": {
|
|
1170
|
-
"properties": {
|
|
1171
|
-
"status": {"const": "integrated"},
|
|
1172
|
-
"terminal_action": {"const": "integrate"}
|
|
1173
|
-
},
|
|
1174
|
-
"required": ["status", "terminal_action"]
|
|
1175
|
-
},
|
|
1176
|
-
"then": {
|
|
1177
|
-
"properties": {
|
|
1178
|
-
"integration": {
|
|
973
|
+
"integration": {
|
|
974
|
+
"allOf": [{
|
|
1179
975
|
"properties": {
|
|
1180
|
-
"
|
|
1181
|
-
"
|
|
1182
|
-
"
|
|
1183
|
-
"
|
|
976
|
+
"candidate_sha": {"const": null},
|
|
977
|
+
"candidate_tree_sha": {"const": null},
|
|
978
|
+
"candidate_branch": {"const": null},
|
|
979
|
+
"candidate_workspace_ref": {"const": null},
|
|
980
|
+
"method": {"enum": [null, "direct-parent"]}
|
|
1184
981
|
}
|
|
1185
|
-
}
|
|
982
|
+
}]
|
|
1186
983
|
}
|
|
1187
984
|
}
|
|
1188
985
|
},
|
|
1189
|
-
{
|
|
1190
|
-
"
|
|
1191
|
-
"
|
|
1192
|
-
"
|
|
1193
|
-
},
|
|
1194
|
-
"required": ["terminal_action"]
|
|
1195
|
-
},
|
|
1196
|
-
"then": {
|
|
1197
|
-
"properties": {
|
|
1198
|
-
"status": {
|
|
1199
|
-
"not": {"enum": ["integrating", "integrated"]}
|
|
1200
|
-
}
|
|
1201
|
-
}
|
|
1202
|
-
}
|
|
1203
|
-
}
|
|
1204
|
-
],
|
|
1205
|
-
"additionalProperties": true
|
|
1206
|
-
}
|
|
1207
|
-
}
|
|
1208
|
-
},
|
|
1209
|
-
"allOf": [
|
|
1210
|
-
{
|
|
1211
|
-
"if": {
|
|
1212
|
-
"properties": {
|
|
1213
|
-
"worktrees": {
|
|
1214
|
-
"contains": {
|
|
1215
|
-
"properties": {
|
|
1216
|
-
"provider": {
|
|
1217
|
-
"const": "git"
|
|
1218
|
-
}
|
|
1219
|
-
},
|
|
1220
|
-
"required": [
|
|
1221
|
-
"provider"
|
|
1222
|
-
]
|
|
1223
|
-
}
|
|
1224
|
-
}
|
|
1225
|
-
}
|
|
1226
|
-
},
|
|
1227
|
-
"then": {
|
|
1228
|
-
"properties": {
|
|
1229
|
-
"worktrees": {
|
|
1230
|
-
"items": {
|
|
1231
|
-
"if": {
|
|
1232
|
-
"properties": {
|
|
1233
|
-
"provider": {
|
|
1234
|
-
"const": "git"
|
|
1235
|
-
}
|
|
1236
|
-
},
|
|
1237
|
-
"required": [
|
|
1238
|
-
"provider"
|
|
1239
|
-
]
|
|
1240
|
-
},
|
|
1241
|
-
"then": {
|
|
1242
|
-
"properties": {
|
|
1243
|
-
"workspace_ref": {
|
|
1244
|
-
"pattern": "^specdev-worktree/T-[0-9]{2,}$"
|
|
1245
|
-
}
|
|
1246
|
-
}
|
|
986
|
+
"else": {
|
|
987
|
+
"properties": {
|
|
988
|
+
"integration": {
|
|
989
|
+
"allOf": [{"properties": {"method": {"enum": [null, "fast-forward", "merge-commit"]}}}]
|
|
1247
990
|
}
|
|
1248
991
|
}
|
|
1249
992
|
}
|
|
1250
993
|
}
|
|
1251
|
-
|
|
994
|
+
],
|
|
995
|
+
"additionalProperties": false
|
|
1252
996
|
},
|
|
1253
|
-
{
|
|
1254
|
-
"
|
|
1255
|
-
|
|
1256
|
-
|
|
1257
|
-
|
|
1258
|
-
|
|
1259
|
-
}
|
|
997
|
+
"integration": {
|
|
998
|
+
"type": "object",
|
|
999
|
+
"required": ["status", "parent_ref", "parent_before_sha", "source_sha", "candidate_sha", "candidate_tree_sha", "candidate_branch", "candidate_workspace_ref", "result_sha", "method", "conflict_paths", "verification", "full_suite", "e2e", "evidence", "attempts", "promotion_status"],
|
|
1000
|
+
"properties": {
|
|
1001
|
+
"status": {"enum": ["pending", "candidate", "passed", "failed", "stale"]},
|
|
1002
|
+
"parent_ref": {"type": ["string", "null"]},
|
|
1003
|
+
"parent_before_sha": {"type": ["string", "null"]},
|
|
1004
|
+
"source_sha": {"type": ["string", "null"]},
|
|
1005
|
+
"candidate_sha": {"type": ["string", "null"]},
|
|
1006
|
+
"candidate_tree_sha": {"type": ["string", "null"]},
|
|
1007
|
+
"candidate_branch": {"type": ["string", "null"]},
|
|
1008
|
+
"candidate_workspace_ref": {"anyOf": [{"type": "null"}, {"type": "string", "pattern": "^specdev-worktree/\\.integration/[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*/T-[0-9]{2,}$"}]},
|
|
1009
|
+
"result_sha": {"type": ["string", "null"]},
|
|
1010
|
+
"method": {"enum": [null, "direct-parent", "fast-forward", "merge-commit"]},
|
|
1011
|
+
"conflict_paths": {"type": "array", "items": {"type": "string"}},
|
|
1012
|
+
"verification": {"enum": ["pending", "passed", "failed"]},
|
|
1013
|
+
"full_suite": {"$ref": "#/$defs/full-suite"},
|
|
1014
|
+
"e2e": {"$ref": "#/$defs/full-suite"},
|
|
1015
|
+
"evidence": {"type": "string", "pattern": "^\\{roots\\.state\\}/specdev/changes/[^<]+/evidence/T-[0-9]{2,}\\.md$"},
|
|
1016
|
+
"attempts": {"type": "integer", "minimum": 0},
|
|
1017
|
+
"promotion_status": {"enum": ["pending", "applying", "applied", "failed", "stale"]}
|
|
1260
1018
|
},
|
|
1261
|
-
"
|
|
1262
|
-
"properties": {
|
|
1263
|
-
"archived": {
|
|
1264
|
-
"const": true
|
|
1265
|
-
},
|
|
1266
|
-
"archive_path": {
|
|
1267
|
-
"type": "string",
|
|
1268
|
-
"pattern": "^specdev/archive/[0-9]{4}-[0-9]{2}/.+/$"
|
|
1269
|
-
}
|
|
1270
|
-
}
|
|
1271
|
-
}
|
|
1019
|
+
"additionalProperties": false
|
|
1272
1020
|
}
|
|
1273
|
-
|
|
1274
|
-
"
|
|
1021
|
+
},
|
|
1022
|
+
"allOf": [{
|
|
1023
|
+
"if": {"properties": {"change_status": {"const": "archived"}}, "required": ["change_status"]},
|
|
1024
|
+
"then": {"properties": {"archived": {"const": true}, "archive_path": {"type": "string", "pattern": "^specdev/archive/[0-9]{4}-[0-9]{2}/.+/$"}}}
|
|
1025
|
+
}],
|
|
1026
|
+
"additionalProperties": false
|
|
1275
1027
|
}
|
|
1276
1028
|
```
|
|
1277
1029
|
|