create-yss-spec 3.0.1 → 3.1.3

package/template/docs/process/schemas/frontend-implementation-evidence.schema.json

@@ -1,39 +1,75 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://yss.dev/schemas/frontend-implementation-evidence.schema.json",
+  "$id": "https://yss.dev/schemas/frontend-implementation-evidence-v2.json",
   "title": "YSS 前端实现还原证据",
   "type": "object",
-  "additionalProperties": true,
-  "required": ["schema_version", "kind", "template", "status", "prototype_ref", "spec_ref", "route_and_page_inventory"],
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "template", "status", "prototype_ref", "spec_ref", "visual_baseline", "route_and_page_inventory", "pnpm_commands"],
   "properties": {
-    "schema_version": { "const": 1 },
-    "kind": { "enum": ["plan", "verification"] },
-    "template": { "type": "boolean" },
-    "status": { "enum": ["draft", "approved", "blocked"] },
-    "prototype_ref": { "type": "string", "minLength": 1 },
-    "spec_ref": { "type": "string", "minLength": 1 },
-    "route_and_page_inventory": { "type": "array", "minItems": 1 },
-    "visual_acceptance_cases": { "type": "array", "minItems": 1 },
-    "desktop_viewport": { "type": "string", "minLength": 3 },
-    "narrow_viewport": { "type": "string", "minLength": 3 },
-    "state_cases": { "type": "array", "minItems": 1 },
-    "pnpm_commands": { "type": "array", "minItems": 1 },
-    "desktop_visual_evidence": { "type": "array", "minItems": 1 },
-    "narrow_view_visual_evidence": { "type": "array", "minItems": 1 },
-    "interaction_results": { "type": "array", "minItems": 1 },
-    "console_warning_check": { "enum": ["pass", "blocked"] },
-    "uncovered_differences": { "type": "array" },
-    "difference_owner": { "type": ["string", "null"] },
-    "independent_review": { "type": "object" }
+    "frontend_delivery": {"type":"object","additionalProperties":false,"required":["acceptance_ref","digest"],"properties":{"acceptance_ref":{"type":"string","minLength":1},"digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}}},
+    "slice_id": {"type":"string","minLength":1},
+    "slice_contract_ref": {"type":"string","minLength":1},
+    "schema_version": {"const": 2},
+    "kind": {"enum": ["plan", "verification"]},
+    "template": {"type": "boolean"},
+    "status": {"enum": ["draft", "approved", "blocked", "stale"]},
+    "prototype_ref": {"type": "string", "minLength": 1},
+    "spec_ref": {"type": "string", "minLength": 1},
+    "visual_baseline": {"$ref": "#/$defs/visualBaseline"},
+    "route_and_page_inventory": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/routePage"}},
+    "baseline_case_ids": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/$defs/caseId"}},
+    "desktop_viewport": {"const": "1440x900"},
+    "narrow_viewport": {"const": "390x844"},
+    "state_cases": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
+    "pnpm_commands": {"type": "array", "minItems": 1, "items": {"type": "string", "pattern": "^pnpm(?: |$)"}},
+    "case_results": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/caseResult"}},
+    "interaction_results": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
+    "console_warning_check": {"enum": ["pass", "blocked"]},
+    "actual_verification": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/verification"}},
+    "uncovered_differences": {"type": "array", "items": {"type": "string", "minLength": 1}},
+    "difference_owner": {"type": ["string", "null"]},
+    "independent_review": {"$ref": "#/$defs/review"}
   },
   "allOf": [
-    {
-      "if": { "properties": { "kind": { "const": "plan" } } },
-      "then": { "required": ["visual_acceptance_cases", "desktop_viewport", "narrow_viewport", "state_cases", "pnpm_commands"] }
+    {"if": {"properties": {"kind": {"const": "plan"}}, "required": ["kind"]}, "then": {"required": ["baseline_case_ids", "desktop_viewport", "narrow_viewport", "state_cases"]}},
+    {"if": {"properties": {"kind": {"const": "verification"}}, "required": ["kind"]}, "then": {"required": ["case_results", "interaction_results", "console_warning_check", "actual_verification", "uncovered_differences", "difference_owner", "independent_review"]}}
+  ],
+  "$defs": {
+    "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
+    "caseId": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"},
+    "visualBaseline": {
+      "type": "object", "additionalProperties": false,
+      "required": ["baseline_id", "version", "digest", "manifest_ref", "status", "case_ids"],
+      "properties": {
+        "baseline_id": {"type": "string", "pattern": "^visual-baseline\\.[a-z0-9][a-z0-9-]*$"},
+        "version": {"type": "string", "pattern": "^v[1-9][0-9]*$"},
+        "digest": {"$ref": "#/$defs/digest"}, "manifest_ref": {"type": "string", "minLength": 1}, "status": {"const": "approved"},
+        "case_ids": {"type": "array", "minItems": 2, "uniqueItems": true, "items": {"$ref": "#/$defs/caseId"}}
+      }
     },
-    {
-      "if": { "properties": { "kind": { "const": "verification" } } },
-      "then": { "required": ["desktop_visual_evidence", "narrow_view_visual_evidence", "interaction_results", "console_warning_check", "pnpm_commands", "uncovered_differences", "difference_owner", "independent_review"] }
+    "routePage": {
+      "type": "object", "additionalProperties": false,
+      "required": ["route", "page", "case_ids"],
+      "properties": {"route": {"type": "string", "minLength": 1}, "page": {"type": "string", "minLength": 1}, "case_ids": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/$defs/caseId"}}}
+    },
+    "caseResult": {
+      "type": "object", "additionalProperties": false,
+      "required": ["case_id", "baseline_image_ref", "implementation_image_ref", "diff_ref", "mask_ref", "result", "uncovered_difference", "explanation"],
+      "properties": {
+        "case_id": {"$ref": "#/$defs/caseId"}, "baseline_image_ref": {"type": "string", "minLength": 1}, "implementation_image_ref": {"type": "string", "minLength": 1},
+        "diff_ref": {"type": "string", "minLength": 1}, "mask_ref": {"type": "string", "minLength": 1}, "result": {"enum": ["pass", "blocked"]},
+        "uncovered_difference": {"type": "boolean"}, "explanation": {"type": "string"}
+      }
+    },
+    "verification": {
+      "type": "object", "additionalProperties": false,
+      "required": ["command", "exit_code", "executed_at", "evidence_ref"],
+      "properties": {"command": {"type": "string", "minLength": 1}, "exit_code": {"type": "integer"}, "executed_at": {"type": "string", "minLength": 1}, "evidence_ref": {"type": "string", "minLength": 1}}
+    },
+    "review": {
+      "type": "object", "additionalProperties": false,
+      "required": ["reviewer", "candidate_digest", "status", "findings_ref"],
+      "properties": {"reviewer": {"type": "string", "minLength": 1}, "candidate_digest": {"$ref": "#/$defs/digest"}, "status": {"enum": ["pending", "approved", "blocked"]}, "findings_ref": {"type": "string", "minLength": 1}}
     }
-  ]
+  }
 }

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

@@ -4,9 +4,10 @@
   "title": "YSS 生命周期 Checkpoint",
   "type": "object",
   "additionalProperties": false,
-  "required": ["schema_version", "mode", "status", "stage", "artifacts", "gates", "next_work_unit", "ticket_sync", "verification", "human_review", "git_checkpoint", "blockers", "rollback"],
+  "required": ["schema_version", "repository_mode", "mode", "status", "stage", "artifacts", "gates", "context_reconciliation", "next_work_unit", "ticket_sync", "verification", "human_review", "git_checkpoint", "blockers", "rollback"],
   "properties": {
     "schema_version": { "const": 1 },
+    "repository_mode": { "enum": ["template-source", "project-instance"] },
     "mode": { "enum": ["route", "orchestrate", "resume", "audit"] },
     "status": { "enum": ["routing", "running", "paused-human-gate", "blocked", "completed"] },
     "stage": { "type": "string", "pattern": "^stage\\.[a-z0-9][a-z0-9-]*$" },
@@ -38,12 +39,25 @@
             "status": { "enum": ["not-evaluated", "blocked", "ready-for-human", "approved", "stale", "not-applicable"] },
             "reason": { "type": "string" },
             "evidence_refs": { "type": "array", "items": { "type": "string" } },
-            "approval_ref": { "type": ["string", "null"] }
+            "approval_ref": { "type": ["string", "null"] },
+            "subject_ref": { "type": "string", "minLength": 1 },
+            "approval_scope": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
           }
         }
       },
       "additionalProperties": false
     },
+    "context_reconciliation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "ref", "evidence_refs"],
+      "properties": {
+        "status": { "enum": ["pending", "reconciled", "not-applicable", "blocked"] },
+        "ref": { "type": ["string", "null"] },
+        "reason": { "type": "string" },
+        "evidence_refs": { "type": "array", "items": { "type": "string" } }
+      }
+    },
     "next_work_unit": { "type": ["string", "null"], "pattern": "^work-unit\\.[a-z0-9][a-z0-9-]*$" },
     "phase_boundary": { "type": "object" },
     "stage_trace": { "type": "object" },

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

@@ -27,9 +27,9 @@
   },
   "$defs": {
     "id": { "type": "string", "pattern": "^(stage|gate|artifact|work-unit|evidence)\\.[a-z0-9][a-z0-9-]*$" },
-    "stages": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "goal", "exit_criteria"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "goal": { "type": "string", "minLength": 1 }, "exit_criteria": { "type": "string", "minLength": 1 } } } },
-    "objects": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "stage", "trigger"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "stage": { "type": "string", "pattern": "^stage\\." }, "trigger": { "type": "string", "minLength": 1 }, "evidence": { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "^evidence\\." } }, "requires_gates": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^gate\\." } } } } },
-    "workUnits": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "scope", "input", "output", "completion"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "scope": { "enum": ["template-source", "project-instance"] }, "input": { "type": "string", "minLength": 1 }, "output": { "type": "string", "minLength": 1 }, "completion": { "type": "string", "minLength": 1 } } } },
-    "evidence": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "description"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "description": { "type": "string", "minLength": 1 } } } }
+    "stages": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "goal", "exit_criteria"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "goal": { "type": "string", "minLength": 1 }, "exit_criteria": { "type": "string", "minLength": 1 }, "public_name": { "type": "string", "minLength": 1 }, "public_goal": { "type": "string", "minLength": 1 }, "public_exit_criteria": { "type": "string", "minLength": 1 } } } },
+    "objects": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "stage", "trigger"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "stage": { "type": "string", "pattern": "^stage\\." }, "trigger": { "type": "string", "minLength": 1 }, "public_name": { "type": "string", "minLength": 1 }, "public_trigger": { "type": "string", "minLength": 1 }, "evidence": { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "^evidence\\." } }, "requires_gates": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^gate\\." } } } } },
+    "workUnits": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "scope", "input", "output", "completion"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "scope": { "enum": ["template-source", "project-instance"] }, "input": { "type": "string", "minLength": 1 }, "output": { "type": "string", "minLength": 1 }, "completion": { "type": "string", "minLength": 1 }, "public_name": { "type": "string", "minLength": 1 }, "public_input": { "type": "string", "minLength": 1 }, "public_output": { "type": "string", "minLength": 1 }, "public_completion": { "type": "string", "minLength": 1 } } } },
+    "evidence": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "description"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "description": { "type": "string", "minLength": 1 }, "public_name": { "type": "string", "minLength": 1 }, "public_description": { "type": "string", "minLength": 1 } } } }
   }
 }

package/template/docs/process/schemas/scaffold-architecture-decisions.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.dev/schemas/scaffold-architecture-decisions-v1.json",
+  "title": "YSS 后端脚手架架构选择记录",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "template", "status", "decisions"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "kind": { "const": "scaffold-architecture-decisions" },
+    "template": { "type": "boolean" },
+    "status": { "enum": ["draft", "current", "stale", "blocked"] },
+    "decisions": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/decision" }
+    }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "architecture": { "enum": ["domain-driven", "layered-mvc"] },
+    "decision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "decision_id", "project_id", "parent_project_id", "status",
+        "recommended_architecture", "recommendation_reasons", "confirmed_architecture",
+        "override_reason", "inheritance_mode", "inherited_from", "platform_profile",
+        "architecture_profile", "verification_database", "production_database", "requested_capabilities", "resolved_modules",
+        "resolution_version", "user_confirmation", "decision_inputs_digest"
+      ],
+      "properties": {
+        "decision_id": { "type": "string", "pattern": "^scaffold-decision\\.[a-z][a-z0-9-]*$" },
+        "project_id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+        "parent_project_id": { "type": ["string", "null"], "pattern": "^[a-z][a-z0-9-]*$" },
+        "status": { "enum": ["undecided", "recommended", "awaiting-user-decision", "user-confirmed", "lifecycle-approved", "consumed", "stale"] },
+        "recommended_architecture": { "$ref": "#/$defs/architecture" },
+        "recommendation_reasons": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "confirmed_architecture": { "anyOf": [{ "$ref": "#/$defs/architecture" }, { "type": "null" }] },
+        "override_reason": { "type": ["string", "null"] },
+        "inheritance_mode": { "enum": ["root-default", "inherit", "override"] },
+        "inherited_from": { "type": ["string", "null"], "pattern": "^[a-z][a-z0-9-]*$" },
+        "platform_profile": { "const": "spring-boot-2.7-jdk8" },
+        "architecture_profile": { "enum": ["target-domain-model", "layered-mvc-service", "mvc-data-analysis-v1"] },
+        "verification_database": { "const": "h2" },
+        "production_database": { "const": "not-bound" },
+        "requested_capabilities": { "type": "array", "uniqueItems": true, "items": { "enum": ["external-integration", "published-client", "feign-client"] } },
+        "resolved_modules": { "type": "array", "minItems": 3, "uniqueItems": true, "items": { "enum": ["server", "core", "service", "repository", "adapter", "client", "feign-client", "domain", "application", "infrastructure", "bootstrap"] } },
+        "resolution_version": { "const": 1 },
+        "user_confirmation": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["confirmed_by", "channel", "confirmation_ref", "confirmed_at", "normalized_text"],
+          "properties": {
+            "user_decision_ref": { "type": ["string", "null"] },
+            "decision_subject_ref": { "type": ["string", "null"] },
+            "confirmed_by": { "type": ["string", "null"] },
+            "channel": { "type": ["string", "null"] },
+            "confirmation_ref": { "type": ["string", "null"] },
+            "confirmed_at": { "type": ["string", "null"], "format": "date-time" },
+            "normalized_text": { "type": ["string", "null"] }
+          }
+        },
+        "decision_inputs_digest": { "$ref": "#/$defs/digest" }
+      }
+    }
+  }
+}