@specforge/cli 0.1.0 → 0.2.4

package/node_modules/@specforge/spec-types/dist/json-schema/v1.1/openspec.schema.json

@@ -0,0 +1,1129 @@
+{
+  "$ref": "#/definitions/OpenSpec",
+  "definitions": {
+    "OpenSpec": {
+      "type": "object",
+      "properties": {
+        "schemaVersion": {
+          "type": "string",
+          "const": "1.1"
+        },
+        "id": {
+          "type": "string"
+        },
+        "projectId": {
+          "type": "string"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string"
+        },
+        "goals": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "title": {
+                "type": "string",
+                "minLength": 1
+              },
+              "description": {
+                "type": "string",
+                "minLength": 1
+              },
+              "type": {
+                "type": "string",
+                "enum": [
+                  "business",
+                  "technical",
+                  "user",
+                  "operational"
+                ]
+              },
+              "successCriteria": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "minItems": 1
+              },
+              "kpi": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "title",
+              "description",
+              "type",
+              "successCriteria"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 3
+        },
+        "requirements": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "title": {
+                "type": "string",
+                "minLength": 1
+              },
+              "description": {
+                "type": "string",
+                "minLength": 1
+              },
+              "type": {
+                "type": "string",
+                "enum": [
+                  "functional",
+                  "business-rule",
+                  "integration"
+                ]
+              },
+              "source": {
+                "type": "string"
+              },
+              "acceptanceCriteria": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "given": {
+                      "type": "string"
+                    },
+                    "when": {
+                      "type": "string"
+                    },
+                    "then": {
+                      "type": "string"
+                    },
+                    "order": {
+                      "type": "integer",
+                      "minimum": 1
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "given",
+                    "when",
+                    "then",
+                    "order"
+                  ],
+                  "additionalProperties": false
+                },
+                "minItems": 1
+              },
+              "dependsOn": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "constraints": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "id",
+              "title",
+              "description",
+              "type",
+              "acceptanceCriteria"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 3
+        },
+        "architecture": {
+          "type": "string"
+        },
+        "scope": {
+          "type": "object",
+          "properties": {
+            "inScope": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              },
+              "minItems": 3
+            },
+            "outOfScope": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              },
+              "minItems": 1
+            },
+            "assumptions": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "externalDependencies": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "required": [
+            "inScope",
+            "outOfScope"
+          ],
+          "additionalProperties": false
+        },
+        "techStack": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "name": {
+                "type": "string",
+                "minLength": 1
+              },
+              "version": {
+                "type": "string"
+              },
+              "layer": {
+                "type": "string",
+                "enum": [
+                  "database",
+                  "backend",
+                  "frontend",
+                  "infrastructure",
+                  "devops",
+                  "observability",
+                  "auth",
+                  "integration",
+                  "testing"
+                ]
+              },
+              "rationale": {
+                "type": "string"
+              },
+              "alternativesConsidered": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "id",
+              "name",
+              "layer"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "folderStructures": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "scope": {
+                "type": "string",
+                "minLength": 1
+              },
+              "description": {
+                "type": "string"
+              },
+              "content": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "required": [
+              "id",
+              "scope",
+              "content"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        },
+        "acceptanceCriteria": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/OpenSpec/properties/requirements/items/properties/acceptanceCriteria/items"
+          }
+        },
+        "nonFunctionalRequirements": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "description": {
+                "type": "string",
+                "minLength": 1
+              },
+              "category": {
+                "type": "string",
+                "enum": [
+                  "performance",
+                  "security",
+                  "scalability",
+                  "reliability",
+                  "availability",
+                  "usability",
+                  "maintainability",
+                  "observability",
+                  "compliance",
+                  "accessibility"
+                ]
+              },
+              "metric": {
+                "type": "string",
+                "minLength": 1
+              },
+              "target": {
+                "type": "string",
+                "minLength": 1
+              },
+              "measurementMethod": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "description",
+              "category",
+              "metric",
+              "target"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "sharedPatterns": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "name": {
+                "type": "string",
+                "minLength": 1
+              },
+              "description": {
+                "type": "string",
+                "minLength": 1
+              },
+              "codeStandards": {
+                "type": "object",
+                "properties": {
+                  "errorHandling": {
+                    "type": "string"
+                  },
+                  "naming": {
+                    "type": "string"
+                  },
+                  "language": {
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": {
+                  "type": "string"
+                }
+              },
+              "commonImports": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "returnTypes": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                }
+              },
+              "additionalImports": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "commonFiles": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "id",
+              "name",
+              "description"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "guardrails": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "description": {
+                "type": "string",
+                "minLength": 1
+              },
+              "category": {
+                "type": "string",
+                "enum": [
+                  "technical",
+                  "business",
+                  "regulatory",
+                  "ethical",
+                  "operational"
+                ]
+              },
+              "rationale": {
+                "type": "string",
+                "minLength": 1
+              },
+              "consequence": {
+                "type": "string",
+                "minLength": 1
+              },
+              "scope": {
+                "type": "string",
+                "enum": [
+                  "spec",
+                  "epic",
+                  "ticket"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "description",
+              "category",
+              "rationale",
+              "consequence"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "background": {
+          "type": "string"
+        },
+        "epics": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "specificationId": {
+                "type": "string"
+              },
+              "title": {
+                "type": "string",
+                "minLength": 1
+              },
+              "description": {
+                "type": "string"
+              },
+              "objective": {
+                "type": "string"
+              },
+              "order": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "estimatedMinutes": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "architecture": {
+                "type": "string"
+              },
+              "scope": {
+                "$ref": "#/definitions/OpenSpec/properties/scope"
+              },
+              "goals": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/definitions/OpenSpec/properties/goals/items"
+                }
+              },
+              "acceptanceCriteria": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/definitions/OpenSpec/properties/requirements/items/properties/acceptanceCriteria/items"
+                }
+              },
+              "validationCommands": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "apiContracts": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "type": {
+                      "type": "string",
+                      "enum": [
+                        "rest",
+                        "graphql",
+                        "rpc",
+                        "event",
+                        "cli"
+                      ]
+                    },
+                    "description": {
+                      "type": "string"
+                    },
+                    "blueprintReferences": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "blueprintId": {
+                            "type": "string"
+                          },
+                          "context": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "section": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "blueprintId"
+                        ],
+                        "additionalProperties": false
+                      }
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "name",
+                    "type"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "sharedPatterns": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/definitions/OpenSpec/properties/sharedPatterns/items"
+                }
+              },
+              "fileStructures": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/definitions/OpenSpec/properties/folderStructures/items"
+                }
+              },
+              "requirementsCovered": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "nfrsCovered": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "goalsCovered": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "tickets": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "epicId": {
+                      "type": "string"
+                    },
+                    "ticketNumber": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0
+                    },
+                    "title": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "description": {
+                      "type": "string"
+                    },
+                    "ticketType": {
+                      "type": "string",
+                      "enum": [
+                        "implementation",
+                        "verification"
+                      ]
+                    },
+                    "complexity": {
+                      "type": "string",
+                      "enum": [
+                        "small",
+                        "medium",
+                        "large",
+                        "xlarge"
+                      ]
+                    },
+                    "estimatedMinutes": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "order": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "tags": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "acceptanceCriteria": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/definitions/OpenSpec/properties/requirements/items/properties/acceptanceCriteria/items"
+                      }
+                    },
+                    "implementationSteps": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string"
+                          },
+                          "text": {
+                            "type": "string"
+                          },
+                          "order": {
+                            "type": "integer",
+                            "minimum": 1
+                          },
+                          "files": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "path": {
+                                  "type": "string"
+                                },
+                                "role": {
+                                  "type": "string"
+                                },
+                                "symbol": {
+                                  "type": "string"
+                                },
+                                "why": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "path",
+                                "role"
+                              ],
+                              "additionalProperties": false
+                            }
+                          },
+                          "linkedFileIds": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "linkedCodeSnippetIds": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "linkedTypeSnippetIds": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "text",
+                          "order"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "testSpecification": {
+                      "type": "object",
+                      "properties": {
+                        "testTypes": {
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "enum": [
+                              "unit",
+                              "integration",
+                              "e2e",
+                              "typecheck",
+                              "lint",
+                              "build",
+                              "contract",
+                              "structural",
+                              "layout",
+                              "a11y",
+                              "performance"
+                            ]
+                          }
+                        },
+                        "qualityGates": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        "testCommands": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        "coverageTarget": {
+                          "anyOf": [
+                            {
+                              "type": "number",
+                              "minimum": 0,
+                              "maximum": 100
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        }
+                      },
+                      "required": [
+                        "testTypes",
+                        "qualityGates",
+                        "testCommands"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "guardrails": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "codeSnippets": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string"
+                          },
+                          "language": {
+                            "type": "string"
+                          },
+                          "description": {
+                            "type": "string"
+                          },
+                          "content": {
+                            "type": "string"
+                          },
+                          "order": {
+                            "type": "integer",
+                            "minimum": 0
+                          },
+                          "sourcePath": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "language",
+                          "content"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "typeSnippets": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string"
+                          },
+                          "language": {
+                            "type": "string"
+                          },
+                          "description": {
+                            "type": "string"
+                          },
+                          "content": {
+                            "type": "string"
+                          },
+                          "order": {
+                            "type": "integer",
+                            "minimum": 0
+                          },
+                          "sourcePath": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "language",
+                          "content"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "blueprintReferences": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/definitions/OpenSpec/properties/epics/items/properties/apiContracts/items/properties/blueprintReferences/items"
+                      }
+                    },
+                    "dependencies": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "ticketId": {
+                            "type": "string"
+                          },
+                          "type": {
+                            "type": "string",
+                            "enum": [
+                              "requires",
+                              "blocks"
+                            ]
+                          },
+                          "origin": {
+                            "type": "object",
+                            "properties": {
+                              "provenance": {
+                                "type": "boolean"
+                              },
+                              "scaffold": {
+                                "type": "boolean"
+                              },
+                              "semantic": {
+                                "type": "boolean"
+                              }
+                            },
+                            "additionalProperties": false
+                          }
+                        },
+                        "required": [
+                          "ticketId",
+                          "type"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "fieldDeclarations": {
+                      "type": "object",
+                      "additionalProperties": {
+                        "type": "object",
+                        "properties": {
+                          "value": {
+                            "type": "string",
+                            "const": "N/A"
+                          },
+                          "reason": {
+                            "type": "string",
+                            "minLength": 20
+                          }
+                        },
+                        "required": [
+                          "value",
+                          "reason"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "fileChangeRefs": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string"
+                          },
+                          "path": {
+                            "type": "string"
+                          },
+                          "kind": {
+                            "type": "string"
+                          },
+                          "symbol": {
+                            "type": "string"
+                          },
+                          "why": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "path",
+                          "kind"
+                        ],
+                        "additionalProperties": false
+                      }
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "epicId",
+                    "title",
+                    "ticketType",
+                    "complexity",
+                    "estimatedMinutes",
+                    "acceptanceCriteria",
+                    "implementationSteps",
+                    "guardrails",
+                    "blueprintReferences",
+                    "dependencies"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "fieldDeclarations": {
+                "type": "object",
+                "additionalProperties": {
+                  "$ref": "#/definitions/OpenSpec/properties/epics/items/properties/tickets/items/properties/fieldDeclarations/additionalProperties"
+                }
+              },
+              "category": {
+                "type": "string",
+                "enum": [
+                  "foundation",
+                  "functional",
+                  "non_functional",
+                  "verification"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "specificationId",
+              "title",
+              "description",
+              "objective",
+              "tickets"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "blueprints": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "title": {
+                "type": "string",
+                "minLength": 1
+              },
+              "description": {
+                "type": "string"
+              },
+              "slug": {
+                "type": "string"
+              },
+              "category": {
+                "type": "string",
+                "enum": [
+                  "flowchart",
+                  "architecture",
+                  "state",
+                  "sequence",
+                  "erd",
+                  "mockup",
+                  "adr",
+                  "component",
+                  "deployment",
+                  "api",
+                  "algorithm",
+                  "protocol",
+                  "glossary",
+                  "design_system"
+                ]
+              },
+              "format": {
+                "type": "string",
+                "enum": [
+                  "markdown",
+                  "mermaid",
+                  "ascii",
+                  "mixed",
+                  "html",
+                  "svg",
+                  "image"
+                ]
+              },
+              "coverageType": {
+                "type": "string",
+                "enum": [
+                  "ticket",
+                  "all"
+                ],
+                "default": "ticket"
+              },
+              "content": {
+                "type": "string"
+              },
+              "notes": {
+                "type": "string"
+              },
+              "version": {
+                "type": "string"
+              },
+              "order": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "tags": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "id",
+              "title",
+              "category",
+              "content"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "fieldDeclarations": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/OpenSpec/properties/epics/items/properties/tickets/items/properties/fieldDeclarations/additionalProperties"
+          }
+        },
+        "epicTargets": {
+          "type": "object",
+          "properties": {
+            "foundation": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "functional": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "nonFunctional": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "verification": {
+              "type": "integer",
+              "minimum": 0
+            }
+          },
+          "required": [
+            "foundation",
+            "functional",
+            "nonFunctional",
+            "verification"
+          ],
+          "additionalProperties": false
+        },
+        "estimatedMinutes": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "schemaVersion",
+        "id",
+        "projectId",
+        "title",
+        "status",
+        "goals",
+        "requirements",
+        "architecture",
+        "scope",
+        "techStack",
+        "folderStructures",
+        "acceptanceCriteria",
+        "nonFunctionalRequirements",
+        "guardrails",
+        "epics",
+        "blueprints"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}