create-yss-spec 3.3.7 → 3.4.1

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/implementation-repository-preparation-result.schema.json

@@ -1,38 +1,94 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://yss.example/schemas/implementation-repository-preparation-result.schema.json",
-  "title": "Implementation Repository Preparation Result",
+  "title": "Implementation Repository Preparation Result v2",
   "type": "object",
   "additionalProperties": false,
   "required": ["schema_version", "kind", "result", "current_version", "projects", "evidence_refs"],
   "properties": {
-    "schema_version": { "const": 1 },
+    "schema_version": { "const": 2 },
     "kind": { "const": "implementation-repository-preparation-result" },
     "result": { "const": "completed" },
     "current_version": { "const": true },
-    "projects": {
-      "type": "array",
-      "minItems": 2,
-      "items": {
-        "type": "object",
-        "required": ["project_id", "delivery_role", "status"],
-        "properties": {
-          "project_id": { "type": "string", "minLength": 1 },
-          "delivery_role": { "enum": ["backend", "frontend"] },
-          "status": { "enum": ["existing-and-onboarded", "initialized-and-verified", "not-applicable"] },
-          "reason": { "type": "string" },
-          "repository_ref": { "type": "string" },
-          "project_root": { "type": "string" },
-          "repository_scope": { "enum": ["external-repository", "harness-apps", "git-submodule"] },
-          "onboarding_result": { "type": "object" },
-          "scaffold_contract": { "type": "object" },
-          "scaffold_manifest_ref": { "type": "string" },
-          "scaffold_verification": { "type": "object" },
-          "template_available": { "type": "boolean" },
-          "architecture_family": { "type": "string" }
-        }
+    "projects": { "type": "array", "minItems": 2, "items": { "$ref": "#/$defs/project" } },
+    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+  },
+  "$defs": {
+    "artifactBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref", "version", "digest"],
+      "properties": {
+        "ref": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "pattern": "^v[1-9][0-9]*$" },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "impact": { "enum": ["required", "not-applicable"] }
       }
     },
-    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+    "designPrerequisites": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["technical_design", "data_architecture_decision", "api_contract_decision", "engineering_contract_approval_ref"],
+      "properties": {
+        "technical_design": { "$ref": "#/$defs/artifactBinding" },
+        "data_architecture_decision": { "$ref": "#/$defs/artifactBinding" },
+        "api_contract_decision": { "$ref": "#/$defs/artifactBinding" },
+        "engineering_contract_approval_ref": { "type": "string", "minLength": 1 }
+      }
+    },
+    "legacyReconciliation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema_version", "status", "manifest_ref", "manifest_digest", "ownership_check_ref", "ownership_state", "premature_implementation", "recovery_approval_ref"],
+      "properties": {
+        "schema_version": { "const": 1 },
+        "status": { "const": "approved" },
+        "manifest_ref": { "type": "string", "minLength": 1 },
+        "manifest_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "ownership_check_ref": { "type": "string", "minLength": 1 },
+        "ownership_state": { "const": "unchanged-mechanical-scaffold" },
+        "premature_implementation": { "const": false },
+        "recovery_approval_ref": { "type": "string", "minLength": 1 }
+      }
+    },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["project_id", "delivery_role", "status"],
+      "properties": {
+        "project_id": { "type": "string", "minLength": 1 },
+        "delivery_role": { "enum": ["backend", "frontend"] },
+        "status": { "enum": ["existing-and-onboarded", "initialized-and-verified", "not-applicable"] },
+        "reason": { "type": "string", "minLength": 1 },
+        "repository_ref": { "type": "string", "minLength": 1 },
+        "project_root": { "type": "string", "minLength": 1 },
+        "repository_scope": { "enum": ["external-repository", "harness-apps", "git-submodule"] },
+        "onboarding_result": { "type": "object" },
+        "scaffold_contract": {
+          "type": "object",
+          "required": ["schema_version", "status", "persisted", "current_version"],
+          "properties": {
+            "schema_version": { "enum": [3, 4] },
+            "status": { "const": "approved" },
+            "persisted": { "const": true },
+            "current_version": { "const": true }
+          }
+        },
+        "scaffold_manifest_ref": { "type": "string", "minLength": 1 },
+        "scaffold_verification": { "type": "object" },
+        "template_available": { "type": "boolean" },
+        "architecture_family": { "type": "string", "minLength": 1 },
+        "design_prerequisites": { "$ref": "#/$defs/designPrerequisites" },
+        "legacy_reconciliation": { "$ref": "#/$defs/legacyReconciliation" }
+      },
+      "allOf": [
+        { "if": { "properties": { "status": { "const": "not-applicable" } }, "required": ["status"] }, "then": { "required": ["reason"] } },
+        { "if": { "properties": { "status": { "enum": ["existing-and-onboarded", "initialized-and-verified"] } }, "required": ["status"] }, "then": { "required": ["repository_ref", "project_root", "repository_scope"] } },
+        { "if": { "properties": { "status": { "const": "existing-and-onboarded" } }, "required": ["status"] }, "then": { "required": ["onboarding_result"] } },
+        { "if": { "properties": { "status": { "const": "initialized-and-verified" } }, "required": ["status"] }, "then": { "required": ["scaffold_contract", "scaffold_manifest_ref", "scaffold_verification"] } },
+        { "if": { "properties": { "delivery_role": { "const": "backend" }, "status": { "enum": ["existing-and-onboarded", "initialized-and-verified"] } }, "required": ["delivery_role", "status"] }, "then": { "required": ["architecture_family", "design_prerequisites"] } },
+        { "if": { "properties": { "delivery_role": { "const": "backend" }, "status": { "const": "initialized-and-verified" }, "scaffold_contract": { "properties": { "schema_version": { "const": 3 } }, "required": ["schema_version"] } }, "required": ["delivery_role", "status", "scaffold_contract"] }, "then": { "required": ["legacy_reconciliation"] } }
+      ]
+    }
   }
 }

package/template/docs/process/schemas/project-scaffold-contract.schema.json

@@ -17,8 +17,8 @@
     "persisted_ref": { "type": "string", "minLength": 1 },
     "current_version": { "const": true },
     "delivery_role": { "enum": ["backend", "frontend"] },
-    "scaffold_kind": { "enum": ["backend-ddd", "backend-layered-mvc", "frontend-yss-vue3"] },
-    "generator_skill": { "enum": ["yss-ddd-scaffold-generator", "yss-layered-mvc-scaffold-generator", "yss-frontend-scaffold-generator"] },
+    "scaffold_kind": { "enum": ["backend-ddd", "backend-layered-mvc", "backend-mvc-data-analysis", "frontend-yss-vue3"] },
+    "generator_skill": { "enum": ["yss-ddd-scaffold-generator", "yss-layered-mvc-scaffold-generator", "yss-mvc-data-analysis-project-initializer", "yss-frontend-scaffold-generator"] },
     "implementation_repository": { "type": "string", "minLength": 1 },
     "backend_repository": { "type": "string", "minLength": 1 },
     "scaffold_status": { "const": "required" },
@@ -35,6 +35,8 @@
     "maven_coordinates": { "type": "object" },
     "profiles": { "type": "object" },
     "module_profile": { "type": "object" },
+    "context_handoff_ref": { "type": "string", "minLength": 1 },
+    "context_handoff_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
     "frontend": {
       "type": "object",
       "additionalProperties": false,
@@ -45,13 +47,47 @@
         "base_route": { "type": "string", "pattern": "^/" },
         "package_manager": { "const": "pnpm" },
         "template": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["repository", "commit"],
-          "properties": {
-            "repository": { "type": "string", "minLength": 1 },
-            "commit": { "type": "string", "pattern": "^[a-f0-9]{40}$" }
-          }
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "repository",
+                "commit"
+              ],
+              "properties": {
+                "repository": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "commit": {
+                  "type": "string",
+                  "pattern": "^[a-f0-9]{40}$"
+                }
+              }
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "kind",
+                "baseline_id",
+                "manifest_digest"
+              ],
+              "properties": {
+                "kind": {
+                  "const": "bundled"
+                },
+                "baseline_id": {
+                  "const": "data-quality-v1"
+                },
+                "manifest_digest": {
+                  "type": "string",
+                  "pattern": "^sha256:[a-f0-9]{64}$"
+                }
+              }
+            }
+          ]
         },
         "openapi_impact": { "enum": ["frozen", "not-applicable"] },
         "openapi_json_ref": { "type": "string", "minLength": 1 },
@@ -84,6 +120,17 @@
         "template_upgrade": { "const": "unsupported" }
       }
     },
+    "design_prerequisites": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["technical_design", "data_architecture_decision", "api_contract_decision", "engineering_contract_approval_ref"],
+      "properties": {
+        "technical_design": { "$ref": "#/$defs/versionedArtifactBinding" },
+        "data_architecture_decision": { "$ref": "#/$defs/impactArtifactBinding" },
+        "api_contract_decision": { "$ref": "#/$defs/impactArtifactBinding" },
+        "engineering_contract_approval_ref": { "type": "string", "minLength": 1 }
+      }
+    },
     "work_unit": {
       "type": "object",
       "required": ["id", "behavior", "primary_skill", "supporting_skills", "tdd_mode", "allowed_write_paths", "expected_evidence", "verification_commands", "controlled_generation"],
@@ -107,7 +154,34 @@
     },
     {
       "if": { "properties": { "delivery_role": { "const": "backend" } } },
-      "then": { "required": ["scaffold_request_id", "compiler_draft_ref", "lifecycle_approval_ref", "backend_repository", "scaffold_status", "project_name", "base_package", "architecture_family", "decision_ref", "decision_id", "decision_digest", "maven_coordinates", "profiles", "module_profile", "work_unit"] }
+      "then": { "required": ["scaffold_request_id", "compiler_draft_ref", "lifecycle_approval_ref", "backend_repository", "scaffold_status", "project_name", "base_package", "architecture_family", "decision_ref", "decision_id", "decision_digest", "maven_coordinates", "profiles", "module_profile", "work_unit", "design_prerequisites"] }
+    },
+    {
+      "if": { "properties": { "generator_skill": { "const": "yss-mvc-data-analysis-project-initializer" } }, "required": ["generator_skill"] },
+      "then": { "required": ["context_handoff_ref", "context_handoff_digest"], "properties": { "scaffold_kind": { "const": "backend-mvc-data-analysis" }, "architecture_family": { "const": "layered-mvc" } } }
+    }
+  ],
+  "$defs": {
+    "versionedArtifactBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref", "version", "digest"],
+      "properties": {
+        "ref": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "pattern": "^v[1-9][0-9]*$" },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "impact": { "enum": ["required", "not-applicable"] }
+      }
+    },
+    "impactArtifactBinding": {
+      "allOf": [
+        { "$ref": "#/$defs/versionedArtifactBinding" },
+        {
+          "type": "object",
+          "required": ["impact"],
+          "properties": { "impact": { "enum": ["required", "not-applicable"] } }
+        }
+      ]
     }
-  ]
+  }
 }