create-yss-spec 3.0.1 → 3.1.3

package/template/docs/process/schemas/backend-delivery.schema.json

@@ -0,0 +1,301 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "delivery_id": {
+      "type": "string",
+      "pattern": "^backend-delivery\\.[a-z0-9][a-z0-9.-]*$"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^v[1-9][0-9]*$"
+    },
+    "status": {
+      "const": "verified"
+    },
+    "strategic_bundle_ref": {
+      "type": "string",
+      "minLength": 1
+    },
+    "strategic_bundle_digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "slice_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "source_ids": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "operation_ids": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "slice_id",
+        "source_ids",
+        "operation_ids"
+      ]
+    },
+    "openapi": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        },
+        "approval_ref": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "id",
+        "version",
+        "ref",
+        "digest",
+        "approval_ref"
+      ]
+    },
+    "slice_contract": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        },
+        "approval_ref": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "id",
+        "version",
+        "ref",
+        "digest",
+        "approval_ref"
+      ]
+    },
+    "build": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "source_commit": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{40}$"
+        },
+        "artifact_digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        }
+      },
+      "required": [
+        "source_commit",
+        "artifact_digest"
+      ]
+    },
+    "environment": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "base_url": {
+          "type": "string",
+          "minLength": 1
+        },
+        "deployment_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "revision_path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "revision_pointers": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "deployment_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "source_commit": {
+              "type": "string",
+              "minLength": 1
+            },
+            "openapi_digest": {
+              "type": "string",
+              "minLength": 1
+            },
+            "artifact_digest": {
+              "type": "string",
+              "minLength": 1
+            },
+            "test_data_digest": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "required": [
+            "deployment_id",
+            "source_commit",
+            "openapi_digest",
+            "artifact_digest",
+            "test_data_digest"
+          ]
+        },
+        "test_data": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ref",
+            "digest"
+          ],
+          "properties": {
+            "ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest": {
+              "type": "string",
+              "pattern": "^sha256:[0-9a-f]{64}$"
+            }
+          }
+        },
+        "authorization_env": {
+          "type": "string",
+          "pattern": "^[A-Z][A-Z0-9_]+$"
+        }
+      },
+      "required": [
+        "id",
+        "base_url",
+        "deployment_id",
+        "revision_path",
+        "revision_pointers",
+        "test_data"
+      ]
+    },
+    "verification": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "contract": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest": {
+              "type": "string",
+              "pattern": "^sha256:[0-9a-f]{64}$"
+            }
+          },
+          "required": [
+            "ref",
+            "digest"
+          ]
+        },
+        "deployment": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest": {
+              "type": "string",
+              "pattern": "^sha256:[0-9a-f]{64}$"
+            }
+          },
+          "required": [
+            "ref",
+            "digest"
+          ]
+        }
+      },
+      "required": [
+        "contract",
+        "deployment"
+      ]
+    },
+    "supporting_files": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "minItems": 0,
+      "uniqueItems": true
+    }
+  },
+  "required": [
+    "schema_version",
+    "delivery_id",
+    "version",
+    "status",
+    "strategic_bundle_ref",
+    "strategic_bundle_digest",
+    "scope",
+    "openapi",
+    "slice_contract",
+    "build",
+    "environment",
+    "verification",
+    "supporting_files"
+  ]
+}

package/template/docs/process/schemas/context-reconciliation.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.dev/schemas/context-reconciliation.schema.json",
+  "title": "YSS Context Reconciliation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "repository_mode", "stage", "work_unit", "status", "context_snapshot", "changes", "unresolved_terms", "evidence_refs"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "repository_mode": { "enum": ["template-source", "project-instance"] },
+    "stage": { "type": "string", "pattern": "^stage\\.[a-z0-9][a-z0-9-]*$" },
+    "work_unit": { "type": "string", "pattern": "^work-unit\\.[a-z0-9][a-z0-9-]*$" },
+    "status": { "enum": ["reconciled", "not-applicable", "blocked"] },
+    "reason": { "type": "string", "minLength": 1 },
+    "context_snapshot": { "$ref": "#/$defs/contextSnapshot" },
+    "changes": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["added", "updated", "deprecated"],
+      "properties": {
+        "added": { "$ref": "#/$defs/termRefs" },
+        "updated": { "$ref": "#/$defs/termRefs" },
+        "deprecated": { "$ref": "#/$defs/termRefs" }
+      }
+    },
+    "unresolved_terms": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["term", "reason", "owner", "next_action"],
+        "properties": {
+          "term": { "type": "string", "minLength": 1 },
+          "reason": { "type": "string", "minLength": 1 },
+          "owner": { "type": "string", "minLength": 1 },
+          "next_action": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+  },
+  "$defs": {
+    "termRefs": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^(Global|[A-Z][A-Za-z0-9]+)/[A-Z][A-Za-z0-9]+$" } },
+    "contextSnapshot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["context_ref", "context_schema_version", "document_digest", "referenced_terms_digest", "term_refs"],
+      "properties": {
+        "context_ref": { "const": "CONTEXT.md" },
+        "context_schema_version": { "const": 1 },
+        "document_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "referenced_terms_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "term_refs": { "$ref": "#/$defs/termRefs" }
+      }
+    }
+  }
+}

package/template/docs/process/schemas/digital-human-task-package.schema.json

@@ -7,6 +7,14 @@
   "required": ["schema_version", "task_id", "work_unit_id", "actor_id", "role_id", "runtime_id", "execution_state", "workflow_status", "skill_source", "contract", "inputs", "objective", "allowed_write_paths", "forbidden_actions", "expected_outputs", "expected_evidence_files", "verification_commands", "verification_results", "downstream_consumers", "convergence"],
   "properties": {
     "schema_version": { "const": 1 },
+    "frontend_delivery": {
+      "type": "object", "additionalProperties": false, "required": ["acceptance_ref"],
+      "properties": {
+        "acceptance_ref": { "type": "string", "minLength": 1 },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+      }
+    },
+    "slice_id": { "type": "string", "minLength": 1 },
     "task_id": { "type": "string", "minLength": 1, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$" },
     "work_unit_id": { "type": "string", "minLength": 1, "pattern": "^work-unit\\.[a-z0-9][a-z0-9-]*$" },
     "actor_id": { "type": "string", "minLength": 1, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$" },
@@ -48,6 +56,7 @@
         "gate_refs": { "type": "array", "items": { "type": "string", "minLength": 1 } }
       }
     },
+    "user_decisions": { "type": "array", "items": { "type": "object", "required": ["boundary", "subject_ref", "scope", "user_decision_ref"], "properties": { "boundary": { "type": "string" }, "subject_ref": { "type": "string" }, "scope": { "type": "array", "minItems": 1, "items": { "type": "string" } }, "user_decision_ref": { "type": "string" } }, "additionalProperties": false } },
     "inputs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
     "allowed_read_paths": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
     "objective": { "type": "string", "minLength": 1 },
@@ -91,6 +100,15 @@
         "work_unit": { "type": "string", "minLength": 1 },
         "workflow_reference": { "type": "string", "minLength": 1 },
         "result": { "enum": ["completed", "blocked", "needs-human", "failed"] },
+        "context_reconciliation": {
+          "type": "object", "additionalProperties": false,
+          "required": ["status", "ref"],
+          "properties": {
+            "status": { "enum": ["reconciled", "not-applicable", "blocked"] },
+            "ref": { "type": "string", "minLength": 1 },
+            "reason": { "type": "string", "minLength": 1 }
+          }
+        },
         "skill": { "type": "string", "minLength": 1 },
         "changed_files": { "type": "array", "items": { "type": "string", "minLength": 1 } },
         "changed_artifacts": { "type": "array", "items": { "type": "string", "minLength": 1 } },

package/template/docs/process/schemas/frontend-delivery-acceptance.schema.json

@@ -0,0 +1,200 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "status": {
+      "const": "accepted"
+    },
+    "slice_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "backend_delivery": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "import_receipt_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "bundle_digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        }
+      },
+      "required": [
+        "import_receipt_ref",
+        "bundle_digest"
+      ]
+    },
+    "strategic_handoff": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "import_receipt_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "bundle_digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        },
+        "context_reconciliation_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "source_id",
+              "source_digest",
+              "disposition",
+              "dependency_status",
+              "dependent_slice_refs",
+              "evidence_refs"
+            ],
+            "properties": {
+              "source_id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "source_digest": {
+                "type": "string",
+                "pattern": "^sha256:[0-9a-f]{64}$"
+              },
+              "disposition": {
+                "enum": [
+                  "mapped",
+                  "pending",
+                  "conflict",
+                  "deferred",
+                  "not-applicable"
+                ]
+              },
+              "dependency_status": {
+                "enum": [
+                  "known",
+                  "unknown"
+                ]
+              },
+              "dependent_slice_refs": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "minItems": 0,
+                "uniqueItems": true
+              },
+              "evidence_refs": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "minItems": 0,
+                "uniqueItems": true
+              },
+              "frontend_case_refs": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "minItems": 0,
+                "uniqueItems": true
+              }
+            }
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "import_receipt_ref",
+        "bundle_digest",
+        "context_reconciliation_ref",
+        "rows"
+      ]
+    },
+    "frontend_cases": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "case_id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "source_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "minItems": 1,
+            "uniqueItems": true
+          },
+          "outcome": {
+            "enum": [
+              "success",
+              "failure"
+            ]
+          },
+          "operation_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "minItems": 1,
+            "uniqueItems": true
+          },
+          "visual_case_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "minItems": 1,
+            "uniqueItems": true
+          },
+          "evidence_ref": {
+            "type": "string",
+            "minLength": 1
+          },
+          "evidence_digest": {
+            "type": "string",
+            "pattern": "^sha256:[a-f0-9]{64}$"
+          }
+        },
+        "required": [
+          "case_id",
+          "source_ids",
+          "outcome",
+          "operation_ids",
+          "visual_case_ids",
+          "evidence_ref",
+          "evidence_digest"
+        ]
+      },
+      "minItems": 1,
+      "uniqueItems": true
+    }
+  },
+  "required": [
+    "schema_version",
+    "status",
+    "slice_id",
+    "backend_delivery",
+    "strategic_handoff",
+    "frontend_cases"
+  ]
+}