@namewta/speculo 2.0.3 → 2.0.5

package/template/workflows/specdev/common/schemas/execution-context.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:specdev:execution-context:v1",
+  "title": "SpecDev change Execution Context",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "change",
+    "workspace_policy",
+    "workspace_ref",
+    "branch",
+    "base_sha",
+    "owner",
+    "ticket_execution"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "change": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"
+    },
+    "workspace_policy": {
+      "enum": [
+        "current",
+        "worktree"
+      ]
+    },
+    "workspace_ref": {
+      "type": "string",
+      "minLength": 1
+    },
+    "branch": {
+      "type": "string",
+      "minLength": 1
+    },
+    "base_sha": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{40}(?:[a-f0-9]{24})?$"
+    },
+    "owner": {
+      "type": "string",
+      "minLength": 1
+    },
+    "ticket_execution": {
+      "enum": [
+        "auto",
+        "serial",
+        "parallel"
+      ]
+    },
+    "max_parallel_tickets": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "concurrent_implementation_limit": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "integration_attempt_limit": {
+      "type": "integer",
+      "minimum": 1
+    }
+  },
+  "additionalProperties": false
+}

package/template/workflows/specdev/common/schemas/execution-record.schema.json

@@ -0,0 +1,154 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:specdev:execution-record:v1",
+  "title": "SpecDev execution evidence",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "workspace_context",
+    "implementation_owners",
+    "status",
+    "checkpoint",
+    "verification",
+    "attempts"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "ticket_id": {
+      "type": "string",
+      "pattern": "^T-\\d{2,}$"
+    },
+    "purpose": {
+      "const": "direct-spec"
+    },
+    "change": {
+      "type": "string",
+      "minLength": 1
+    },
+    "workspace_context": {
+      "const": "README.md#execution-context"
+    },
+    "implementation_owners": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "status": {
+      "enum": [
+        "active",
+        "review",
+        "verified",
+        "blocked",
+        "cancelled"
+      ]
+    },
+    "checkpoint": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "attempts": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "verification": {
+      "type": "object",
+      "required": [
+        "status",
+        "evidence",
+        "e2e"
+      ],
+      "properties": {
+        "status": {
+          "enum": [
+            "pending",
+            "passed",
+            "failed"
+          ]
+        },
+        "evidence": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "e2e": {
+          "type": "object",
+          "required": [
+            "required",
+            "status",
+            "reason",
+            "evidence"
+          ],
+          "properties": {
+            "required": {
+              "type": "boolean"
+            },
+            "status": {
+              "enum": [
+                "pending",
+                "passed",
+                "failed",
+                "not-required"
+              ]
+            },
+            "reason": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "evidence": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "oneOf": [
+    {
+      "required": [
+        "ticket_id"
+      ],
+      "not": {
+        "anyOf": [
+          {
+            "required": [
+              "purpose"
+            ]
+          },
+          {
+            "required": [
+              "change"
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "required": [
+        "purpose",
+        "change"
+      ],
+      "not": {
+        "required": [
+          "ticket_id"
+        ]
+      }
+    }
+  ]
+}

package/template/workflows/specdev/common/schemas/goal-plan.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:speculo:specdev:goal-plan:v7",
+  "$id": "urn:speculo:specdev:goal-plan:v8",
   "title": "SpecDev Goal Plan Frontmatter",
   "type": "object",
   "required": [
@@ -11,15 +11,13 @@
     "modes",
     "orchestration",
     "lead",
-    "concurrent_implementation_limit",
     "integration_attempt_limit",
-    "ticket_workspace_policy",
-    "integration_gate",
-    "ready_for_execution"
+    "ready_for_execution",
+    "ticket_execution"
   ],
   "properties": {
     "schema_version": {
-      "const": 7
+      "const": 8
     },
     "artifact": {
       "const": "goal-plan"
@@ -64,61 +62,23 @@
       "type": "integer",
       "minimum": 1
     },
-    "ticket_workspace_policy": {
-      "enum": [
-        "current",
-        "required"
-      ]
+    "ready_for_execution": {
+      "type": "boolean"
     },
-    "integration_gate": {
+    "ticket_execution": {
       "enum": [
-        "direct-parent",
-        "candidate-merge"
-      ]
+        "auto",
+        "serial",
+        "parallel"
+      ],
+      "default": "auto"
     },
-    "ready_for_execution": {
-      "type": "boolean"
+    "max_parallel_tickets": {
+      "type": "integer",
+      "minimum": 1
     }
   },
   "allOf": [
-    {
-      "if": {
-        "properties": {
-          "ticket_workspace_policy": {
-            "const": "current"
-          }
-        },
-        "required": [
-          "ticket_workspace_policy"
-        ]
-      },
-      "then": {
-        "properties": {
-          "integration_gate": {
-            "const": "direct-parent"
-          }
-        }
-      }
-    },
-    {
-      "if": {
-        "properties": {
-          "ticket_workspace_policy": {
-            "const": "required"
-          }
-        },
-        "required": [
-          "ticket_workspace_policy"
-        ]
-      },
-      "then": {
-        "properties": {
-          "integration_gate": {
-            "const": "candidate-merge"
-          }
-        }
-      }
-    },
     {
       "if": {
         "properties": {

package/template/workflows/specdev/common/schemas/implementation-plan.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:speculo:specdev:implementation-plan:v2",
+  "$id": "urn:speculo:specdev:implementation-plan:v3",
   "title": "SpecDev Parent Implementation Plan Frontmatter",
   "type": "object",
   "required": [
@@ -11,15 +11,13 @@
     "source_map_revision",
     "orchestration",
     "lead",
-    "concurrent_implementation_limit",
     "integration_attempt_limit",
-    "ticket_workspace_policy",
-    "integration_gate",
-    "ready_for_execution"
+    "ready_for_execution",
+    "ticket_execution"
   ],
   "properties": {
     "schema_version": {
-      "const": 2
+      "const": 3
     },
     "artifact": {
       "const": "implementation-plan"
@@ -55,61 +53,23 @@
       "type": "integer",
       "minimum": 1
     },
-    "ticket_workspace_policy": {
-      "enum": [
-        "current",
-        "required"
-      ]
+    "ready_for_execution": {
+      "type": "boolean"
     },
-    "integration_gate": {
+    "ticket_execution": {
       "enum": [
-        "direct-parent",
-        "candidate-merge"
-      ]
+        "auto",
+        "serial",
+        "parallel"
+      ],
+      "default": "auto"
     },
-    "ready_for_execution": {
-      "type": "boolean"
+    "max_parallel_tickets": {
+      "type": "integer",
+      "minimum": 1
     }
   },
   "allOf": [
-    {
-      "if": {
-        "properties": {
-          "ticket_workspace_policy": {
-            "const": "current"
-          }
-        },
-        "required": [
-          "ticket_workspace_policy"
-        ]
-      },
-      "then": {
-        "properties": {
-          "integration_gate": {
-            "const": "direct-parent"
-          }
-        }
-      }
-    },
-    {
-      "if": {
-        "properties": {
-          "ticket_workspace_policy": {
-            "const": "required"
-          }
-        },
-        "required": [
-          "ticket_workspace_policy"
-        ]
-      },
-      "then": {
-        "properties": {
-          "integration_gate": {
-            "const": "candidate-merge"
-          }
-        }
-      }
-    },
     {
       "if": {
         "properties": {

package/template/workflows/specdev/common/schemas/retro-approval.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:specdev:retro-approval:v1",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "source",
+    "snapshot",
+    "sha256",
+    "quote",
+    "confirmed_at",
+    "plan_sha256"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "source": {
+      "type": "string",
+      "minLength": 1
+    },
+    "snapshot": {
+      "type": "string",
+      "minLength": 1
+    },
+    "sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "quote": {
+      "type": "string",
+      "minLength": 1
+    },
+    "confirmed_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "plan_sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    }
+  },
+  "additionalProperties": false
+}

package/template/workflows/specdev/common/schemas/retro-archive.schema.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:specdev:retro-archive:v1",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "id",
+    "owner",
+    "upgrade",
+    "source",
+    "target",
+    "plan_sha256",
+    "approval_sha256",
+    "result",
+    "time",
+    "entries"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"
+    },
+    "owner": {
+      "type": "string",
+      "minLength": 1
+    },
+    "upgrade": {
+      "type": "string",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"
+    },
+    "source": {
+      "type": "string",
+      "minLength": 1
+    },
+    "target": {
+      "type": "string",
+      "minLength": 1
+    },
+    "plan_sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "approval_sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "result": {
+      "enum": [
+        "moved",
+        "verified"
+      ]
+    },
+    "time": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "path",
+          "type",
+          "mode"
+        ],
+        "properties": {
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "type": {
+            "enum": [
+              "file",
+              "directory",
+              "symlink"
+            ]
+          },
+          "mode": {
+            "type": "integer"
+          },
+          "sha256": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{64}$"
+          },
+          "target": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "additionalProperties": false
+      },
+      "minItems": 1
+    }
+  },
+  "additionalProperties": false
+}

package/template/workflows/specdev/common/schemas/retro-execution.schema.json

@@ -0,0 +1,112 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:specdev:retro-execution:v1",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "plan_sha256",
+    "approval_sha256",
+    "status",
+    "results"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "plan_sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "approval_sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "status": {
+      "enum": [
+        "applying",
+        "blocked",
+        "verified"
+      ]
+    },
+    "results": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "path",
+          "result",
+          "sha256",
+          "evidence",
+          "evidence_sha256",
+          "method",
+          "observed",
+          "command",
+          "exit"
+        ],
+        "properties": {
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "result": {
+            "enum": [
+              "passed",
+              "failed",
+              "pending"
+            ]
+          },
+          "sha256": {
+            "anyOf": [
+              {
+                "type": "string",
+                "pattern": "^[a-f0-9]{64}$"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "evidence": {
+            "type": "string",
+            "minLength": 1
+          },
+          "evidence_sha256": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{64}$"
+          },
+          "method": {
+            "type": "string",
+            "minLength": 1
+          },
+          "observed": {
+            "type": "string",
+            "minLength": 1
+          },
+          "command": {
+            "anyOf": [
+              {
+                "type": "string",
+                "minLength": 1
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "exit": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}