create-yss-spec 3.3.6 → 3.3.8

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

@@ -0,0 +1,308 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": {
+      "const": 3
+    },
+    "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_preflight": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ref",
+        "digest"
+      ],
+      "properties": {
+        "ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        }
+      }
+    },
+    "backend_dependency": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mode",
+        "route_id"
+      ],
+      "properties": {
+        "mode": {
+          "enum": [
+            "required",
+            "not-applicable"
+          ]
+        },
+        "route_id": {
+          "type": "string",
+          "pattern": "^route\\.[a-z0-9][a-z0-9-]*$"
+        },
+        "impact_refs": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1
+        },
+        "evidence_refs": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "strategic_handoff": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "import_receipt_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "bundle_digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        },
+        "route_id": {
+          "type": "string",
+          "pattern": "^route\\.[a-z0-9][a-z0-9-]*$"
+        },
+        "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",
+        "route_id",
+        "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": 0,
+            "uniqueItems": true
+          },
+          "evidence_ref": {
+            "type": "string",
+            "minLength": 1
+          },
+          "evidence_digest": {
+            "type": "string",
+            "pattern": "^sha256:[a-f0-9]{64}$"
+          },
+          "baseline_case_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "minItems": 1,
+            "uniqueItems": true
+          }
+        },
+        "required": [
+          "case_id",
+          "source_ids",
+          "outcome",
+          "operation_ids",
+          "baseline_case_ids",
+          "evidence_ref",
+          "evidence_digest"
+        ]
+      },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "ui_baseline_kind": {
+      "enum": [
+        "prototype",
+        "existing-ui-baseline"
+      ]
+    }
+  },
+  "required": [
+    "schema_version",
+    "status",
+    "slice_id",
+    "strategic_preflight",
+    "backend_dependency",
+    "strategic_handoff",
+    "frontend_cases",
+    "ui_baseline_kind"
+  ],
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "backend_dependency": {
+            "properties": {
+              "mode": {
+                "const": "required"
+              }
+            }
+          }
+        },
+        "required": [
+          "backend_dependency"
+        ]
+      },
+      "then": {
+        "required": [
+          "backend_delivery"
+        ]
+      },
+      "else": {
+        "properties": {
+          "backend_dependency": {
+            "required": [
+              "reason",
+              "impact_refs",
+              "evidence_refs"
+            ]
+          }
+        }
+      }
+    }
+  ],
+  "$id": "https://yss.dev/schemas/frontend-delivery-acceptance-v3.schema.json"
+}

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

@@ -4,7 +4,7 @@
   "additionalProperties": false,
   "properties": {
     "schema_version": {
-      "const": 1
+      "const": 2
     },
     "status": {
       "const": "accepted"
@@ -31,6 +31,27 @@
         "bundle_digest"
       ]
     },
+    "strategic_preflight": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref", "digest"],
+      "properties": {
+        "ref": {"type": "string", "minLength": 1},
+        "digest": {"type": "string", "pattern": "^sha256:[0-9a-f]{64}$"}
+      }
+    },
+    "backend_dependency": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "route_id"],
+      "properties": {
+        "mode": {"enum": ["required", "not-applicable"]},
+        "route_id": {"const": "route.backend"},
+        "impact_refs": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
+        "reason": {"type": "string", "minLength": 1},
+        "evidence_refs": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}}
+      }
+    },
     "strategic_handoff": {
       "type": "object",
       "additionalProperties": false,
@@ -43,6 +64,10 @@
           "type": "string",
           "pattern": "^sha256:[0-9a-f]{64}$"
         },
+        "route_id": {
+          "type": "string",
+          "pattern": "^route\\.[a-z0-9][a-z0-9-]*$"
+        },
         "context_reconciliation_ref": {
           "type": "string",
           "minLength": 1
@@ -119,6 +144,7 @@
       "required": [
         "import_receipt_ref",
         "bundle_digest",
+        "route_id",
         "context_reconciliation_ref",
         "rows"
       ]
@@ -154,7 +180,7 @@
               "type": "string",
               "minLength": 1
             },
-            "minItems": 1,
+            "minItems": 0,
             "uniqueItems": true
           },
           "visual_case_ids": {
@@ -193,8 +219,16 @@
     "schema_version",
     "status",
     "slice_id",
-    "backend_delivery",
+    "strategic_preflight",
+    "backend_dependency",
     "strategic_handoff",
     "frontend_cases"
+  ],
+  "allOf": [
+    {
+      "if": {"properties": {"backend_dependency": {"properties": {"mode": {"const": "required"}}}}, "required": ["backend_dependency"]},
+      "then": {"required": ["backend_delivery"]},
+      "else": {"properties": {"backend_dependency": {"required": ["reason", "impact_refs", "evidence_refs"]}}}
+    }
   ]
 }

package/template/docs/process/schemas/frontend-strategic-preflight-v2.schema.json

@@ -0,0 +1,114 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.dev/schemas/frontend-strategic-preflight-v2.schema.json",
+  "title": "YSS Frontend Strategic Preflight v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "status",
+    "route_id",
+    "capability",
+    "import_receipt_ref",
+    "bundle_digest",
+    "context_reconciliation_ref",
+    "source_rule_refs",
+    "backend_dependency",
+    "ready_for_agent",
+    "ui_baseline_kind",
+    "ui_baseline_ref"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 2
+    },
+    "status": {
+      "enum": [
+        "draft",
+        "verified",
+        "blocked",
+        "stale"
+      ]
+    },
+    "route_id": {
+      "type": "string",
+      "pattern": "^route\\.[a-z0-9][a-z0-9-]*$"
+    },
+    "capability": {
+      "const": "frontend-engineering-design"
+    },
+    "import_receipt_ref": {
+      "type": "string",
+      "minLength": 1
+    },
+    "bundle_digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "context_reconciliation_ref": {
+      "type": "string"
+    },
+    "source_rule_refs": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^(rule|scenario|invariant)\\.[a-z0-9][a-z0-9-]*$"
+      }
+    },
+    "backend_dependency": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mode",
+        "route_id"
+      ],
+      "properties": {
+        "mode": {
+          "enum": [
+            "required",
+            "not-applicable"
+          ]
+        },
+        "route_id": {
+          "type": "string",
+          "pattern": "^route\\.[a-z0-9][a-z0-9-]*$"
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1
+        },
+        "impact_refs": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "evidence_refs": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "ready_for_agent": {
+      "const": false
+    },
+    "ui_baseline_kind": {
+      "enum": [
+        "prototype",
+        "existing-ui-baseline"
+      ]
+    },
+    "ui_baseline_ref": {
+      "type": "string",
+      "minLength": 1
+    }
+  }
+}

package/template/docs/process/schemas/frontend-strategic-preflight.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.local/schemas/frontend-strategic-preflight-v1.json",
+  "title": "YSS Frontend Strategic Preflight v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "status", "route_id", "capability", "import_receipt_ref", "bundle_digest", "context_reconciliation_ref", "visual_baseline_ref", "source_rule_refs", "backend_dependency", "ready_for_agent"],
+  "properties": {
+    "schema_version": {"const": 1},
+    "status": {"enum": ["draft", "verified", "blocked", "stale"]},
+    "route_id": {"type": "string", "pattern": "^route\\.[a-z0-9][a-z0-9-]*$"},
+    "capability": {"const": "frontend-engineering-design"},
+    "import_receipt_ref": {"type": "string", "minLength": 1},
+    "bundle_digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
+    "context_reconciliation_ref": {"type": "string"},
+    "visual_baseline_ref": {"type": "string", "minLength": 1},
+    "source_rule_refs": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "pattern": "^(rule|scenario|invariant)\\.[a-z0-9][a-z0-9-]*$"}},
+    "backend_dependency": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "route_id"],
+      "properties": {
+        "mode": {"enum": ["required", "not-applicable"]},
+        "route_id": {"const": "route.backend"},
+        "reason": {"type": "string", "minLength": 1},
+        "impact_refs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
+        "evidence_refs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}}
+      }
+    },
+    "ready_for_agent": {"const": false}
+  }
+}

package/template/docs/process/schemas/lifecycle-checkpoint.schema.json

@@ -221,7 +221,8 @@
       "type": "object"
     },
     "ticket_sync": {
-      "type": "object"
+      "type": "object",
+      "description": "Ticket 仅保存追踪同步状态；refs 关联消费者 Import Receipt、Consumer Feedback、Feedback Adjudication 与 Delivery Acceptance 等权威资产，不复制其机器状态。"
     },
     "verification": {
       "type": "object"

package/template/docs/process/schemas/strategic-consumer-feedback.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.local/schemas/strategic-consumer-feedback-v1.json",
+  "title": "YSS Strategic Consumer Feedback v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "feedback_id", "status", "import_receipt_ref", "bundle", "route_id", "source", "issue_type", "severity", "suggestion", "raised_by", "evidence_refs", "created_at"],
+  "properties": {
+    "schema_version": {"const": 1},
+    "feedback_id": {"type": "string", "pattern": "^consumer-feedback\\.[a-z0-9][a-z0-9-]*$"},
+    "status": {"const": "submitted"},
+    "import_receipt_ref": {"type": "string", "minLength": 1},
+    "bundle": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version", "digest"],
+      "properties": {
+        "id": {"type": "string", "pattern": "^strategic-design-handoff\\.[a-z0-9][a-z0-9-]*$"},
+        "version": {"type": "string", "pattern": "^v[1-9][0-9]*$"},
+        "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"}
+      }
+    },
+    "route_id": {"type": "string", "pattern": "^route\\.[a-z0-9][a-z0-9-]*$"},
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "digest"],
+      "properties": {
+        "id": {"type": "string", "pattern": "^(rule|scenario|invariant)\\.[a-z0-9][a-z0-9-]*$"},
+        "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"}
+      }
+    },
+    "issue_type": {"enum": ["rule-conflict", "scenario-gap", "impact-mismatch", "context-conflict", "design-baseline", "other"]},
+    "severity": {"enum": ["blocking", "non-blocking"]},
+    "suggestion": {"type": "string", "minLength": 1},
+    "raised_by": {"type": "string", "minLength": 1},
+    "evidence_refs": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
+    "created_at": {"type": "string", "format": "date-time"}
+  }
+}