@gluecharm-lab/easyspecs-cli 0.0.3

package/resources/schemas/srs-impact.schema.json

@@ -0,0 +1,187 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://easyspecs.ai/schemas/srs-impact.schema.json",
+  "title": "srs-impact",
+  "description": "Change-request `impact.json` under `.gluecharm/docs/srs/<CR-id>/`. Same five-scope tree and node shape as `index-application-context` (optional `detailMarkdownPaths` / `detailMarkdownFile` with paths relative to the CR folder). Do **not** store root `driftCount` — UI derives it from `drift` flags.",
+  "$defs": {
+    "srsRelativeMarkdownPath": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Path relative to the directory containing `impact.json` (the CR folder). Forward slashes only; no backslashes; must end with `.md`. At most one `..` segment (e.g. `../CR-001-voice-input.md`); must not contain `../..` or more.",
+      "pattern": "^(?!/)(?!.*\\.\\./\\.\\./)[^\\\\\\u0000-\\u001f]+\\.md$"
+    },
+    "impactNodeType": {
+      "type": "string",
+      "enum": [
+        "Feature",
+        "UseCase",
+        "Scenario",
+        "View",
+        "Interaction",
+        "Service",
+        "Method",
+        "Entity",
+        "Field",
+        "Relationship",
+        "Tool"
+      ],
+      "description": "Node kind; must match the scope and the code prefix (see allOf rules on impactNode)."
+    },
+    "impactNode": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "name", "code"],
+      "properties": {
+        "type": { "$ref": "#/$defs/impactNodeType" },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Human-readable label (do not duplicate the code token in name)."
+        },
+        "code": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Stable id; prefix must match type (enforced below)."
+        },
+        "drift": {
+          "type": "boolean",
+          "description": "When true, UI shows a Drift tag and includes this node in the computed drift count."
+        },
+        "detailMarkdownPaths": {
+          "type": "array",
+          "description": "Optional pointers to detail markdown relative to the CR folder (same idea as srs-10 paths under context).",
+          "items": { "$ref": "#/$defs/srsRelativeMarkdownPath" }
+        },
+        "detailMarkdownFile": {
+          "description": "Single detail markdown reference. Legacy: `filename` + `path`. Aligned with index-application-context srs-26: `path` with optional `srsDiscoveryId`.",
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["filename", "path"],
+              "properties": {
+                "filename": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Markdown filename (typically basename of `path`)."
+                },
+                "path": {
+                  "$ref": "#/$defs/srsRelativeMarkdownPath",
+                  "description": "Path relative to the CR folder (directory of `impact.json`)."
+                }
+              }
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["path"],
+              "properties": {
+                "path": {
+                  "$ref": "#/$defs/srsRelativeMarkdownPath",
+                  "description": "Path relative to the CR folder (directory of `impact.json`)."
+                },
+                "srsDiscoveryId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
+                }
+              }
+            }
+          ]
+        },
+        "children": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/impactNode" }
+        }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "type": { "const": "Feature" } }, "required": ["type"] },
+          "then": { "properties": { "code": { "pattern": "^FE-\\d+$" } } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "UseCase" } }, "required": ["type"] },
+          "then": { "properties": { "code": { "pattern": "^UC-\\d+$" } } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "Scenario" } }, "required": ["type"] },
+          "then": { "properties": { "code": { "pattern": "^SC-\\d+$" } } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "View" } }, "required": ["type"] },
+          "then": { "properties": { "code": { "pattern": "^XP-\\d+$" } } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "Interaction" } }, "required": ["type"] },
+          "then": { "properties": { "code": { "pattern": "^BH-\\d+$" } } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "Service" } }, "required": ["type"] },
+          "then": { "properties": { "code": { "pattern": "^SV-\\d+$" } } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "Method" } }, "required": ["type"] },
+          "then": { "properties": { "code": { "pattern": "^ME-\\d+$" } } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "Entity" } }, "required": ["type"] },
+          "then": { "properties": { "code": { "pattern": "^DM-\\d+$" } } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "Field" } }, "required": ["type"] },
+          "then": { "properties": { "code": { "pattern": "^FD-\\d+$" } } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "Relationship" } }, "required": ["type"] },
+          "then": { "properties": { "code": { "pattern": "^RL-\\d+$" } } }
+        },
+        {
+          "if": { "properties": { "type": { "const": "Tool" } }, "required": ["type"] },
+          "then": { "properties": { "code": { "pattern": "^TS-\\d+$" } } }
+        }
+      ]
+    },
+    "scopeBlock": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["nodes"],
+      "properties": {
+        "nodes": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/impactNode" }
+        }
+      }
+    }
+  },
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["cr", "title"],
+  "properties": {
+    "cr": {
+      "type": "string",
+      "pattern": "^CR-[0-9]+$",
+      "description": "Change-request id matching the CR folder name (e.g. CR-001)."
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable change-request title."
+    },
+    "status": {
+      "type": "string",
+      "description": "Optional workflow status (e.g. draft, in_progress, review)."
+    },
+    "scopes": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Optional scope buckets; each present block lists root impact nodes for that dimension.",
+      "properties": {
+        "Feature": { "$ref": "#/$defs/scopeBlock" },
+        "Experience": { "$ref": "#/$defs/scopeBlock" },
+        "Service": { "$ref": "#/$defs/scopeBlock" },
+        "DataModel": { "$ref": "#/$defs/scopeBlock" },
+        "TechStack": { "$ref": "#/$defs/scopeBlock" }
+      }
+    }
+  }
+}