@namewta/speculo 2.0.4 → 2.0.6

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
+}

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

@@ -0,0 +1,163 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:specdev:retro-upgrade:v1",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "artifact",
+    "id",
+    "owner",
+    "created_at",
+    "inputs",
+    "decisions",
+    "changes",
+    "archive_reports"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "artifact": {
+      "const": "retro-upgrade"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"
+    },
+    "owner": {
+      "type": "string",
+      "minLength": 1
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "inputs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "report",
+          "sha256"
+        ],
+        "properties": {
+          "report": {
+            "type": "string",
+            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "sha256": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{64}$"
+          }
+        },
+        "additionalProperties": false
+      },
+      "minItems": 1
+    },
+    "decisions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "report",
+          "finding",
+          "disposition",
+          "reason",
+          "targets"
+        ],
+        "properties": {
+          "report": {
+            "type": "string",
+            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "finding": {
+            "type": "string",
+            "pattern": "^F-[0-9]{3,}$"
+          },
+          "disposition": {
+            "enum": [
+              "adopt",
+              "reject",
+              "defer"
+            ]
+          },
+          "reason": {
+            "type": "string",
+            "minLength": 1
+          },
+          "targets": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "uniqueItems": true
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "changes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "path",
+          "action",
+          "owner",
+          "before_sha256",
+          "after_sha256",
+          "candidate"
+        ],
+        "properties": {
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "action": {
+            "enum": [
+              "create",
+              "update",
+              "retain"
+            ]
+          },
+          "owner": {
+            "enum": [
+              "project",
+              "engineering-standards-builder"
+            ]
+          },
+          "before_sha256": {
+            "anyOf": [
+              {
+                "type": "string",
+                "pattern": "^[a-f0-9]{64}$"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "after_sha256": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{64}$"
+          },
+          "candidate": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "archive_reports": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"
+      },
+      "uniqueItems": true
+    }
+  },
+  "additionalProperties": false
+}

package/template/workflows/specdev/common/schemas/retrospective.schema.json

@@ -1,36 +1,36 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:speculo:specdev:retrospective:v1",
+  "$id": "urn:speculo:specdev:retrospective:v2",
   "type": "object",
   "required": [
     "schema_version",
     "artifact",
-    "change",
     "id",
+    "owner",
     "status",
     "outcome",
+    "updated_at",
     "sources",
-    "updated_at"
+    "findings"
   ],
   "properties": {
     "schema_version": {
-      "const": 1
+      "const": 2
     },
     "artifact": {
       "const": "retrospective"
     },
-    "change": {
+    "id": {
       "type": "string",
       "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"
     },
-    "id": {
+    "owner": {
       "type": "string",
-      "pattern": "^RETRO-[0-9]{3,}$"
+      "minLength": 1
     },
     "status": {
       "enum": [
         "draft",
-        "blocked",
         "completed"
       ]
     },
@@ -41,17 +41,122 @@
         "insufficient-evidence"
       ]
     },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
     "sources": {
       "type": "array",
-      "minItems": 1,
       "items": {
-        "type": "string",
-        "minLength": 1
+        "type": "object",
+        "required": [
+          "id",
+          "kind",
+          "change",
+          "locator",
+          "snapshot",
+          "sha256",
+          "quote"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^E-[0-9]{3,}$"
+          },
+          "kind": {
+            "enum": [
+              "change",
+              "project",
+              "session"
+            ]
+          },
+          "change": {
+            "anyOf": [
+              {
+                "type": "string",
+                "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "locator": {
+            "type": "string",
+            "minLength": 1
+          },
+          "snapshot": {
+            "type": "string",
+            "minLength": 1
+          },
+          "sha256": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{64}$"
+          },
+          "quote": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "additionalProperties": false
       }
     },
-    "updated_at": {
-      "type": "string",
-      "format": "date-time"
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "category",
+          "severity",
+          "evidence",
+          "remediation_axis"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^F-[0-9]{3,}$"
+          },
+          "category": {
+            "enum": [
+              "navigation",
+              "automated-checks",
+              "coding-standards",
+              "global-instructions",
+              "tool-economy",
+              "no-ops",
+              "information-access"
+            ]
+          },
+          "severity": {
+            "enum": [
+              "critical",
+              "high",
+              "medium",
+              "low"
+            ]
+          },
+          "evidence": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^E-[0-9]{3,}$"
+            },
+            "minItems": 1,
+            "uniqueItems": true
+          },
+          "remediation_axis": {
+            "enum": [
+              "code-defect",
+              "deterministic-check-gap",
+              "context-pointer",
+              "judgment-rule",
+              "environment-discovery"
+            ]
+          }
+        },
+        "additionalProperties": false
+      }
     }
   },
   "additionalProperties": false

package/template/workflows/specdev/common/schemas/session-locator.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:specdev:session-locator",
+  "type": "object",
+  "required": [
+    "path"
+  ],
+  "properties": {
+    "path": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "additionalProperties": false
+}