@stacksjs/defaults 0.75.361 → 0.75.366

package/ai/skills/stacks-technical-diagrams/schemas/lifecycle.schema.json

@@ -1,20 +1,21 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://github.com/tt-a1i/archify/schemas/lifecycle.schema.json",
-  "title": "Technical Lifecycle Diagram",
+  "title": "Archify Lifecycle Diagram",
   "type": "object",
   "additionalProperties": false,
   "required": [
     "schema_version",
     "diagram_type",
     "meta",
-    "lanes",
+    "mainPath",
     "states",
     "transitions"
   ],
   "properties": {
     "schema_version": {
-      "const": 1
+      "description": "Lifecycle uses version 3: an automatic main-path layout.",
+      "const": 3
     },
     "diagram_type": {
       "const": "lifecycle"
@@ -23,7 +24,8 @@
       "type": "object",
       "additionalProperties": false,
       "required": [
-        "title"
+        "title",
+        "output"
       ],
       "properties": {
         "title": {
@@ -33,11 +35,14 @@
         "locale": {
           "$ref": "common.schema.json#/$defs/locale"
         },
+        "translations": {
+          "$ref": "common.schema.json#/$defs/translations"
+        },
         "subtitle": {
           "type": "string"
         },
         "output": {
-          "type": "string"
+          "$ref": "common.schema.json#/$defs/portableOutputPath"
         },
         "animation": {
           "$ref": "common.schema.json#/$defs/animation"
@@ -48,6 +53,9 @@
         "quality_profile": {
           "$ref": "common.schema.json#/$defs/qualityProfile"
         },
+        "repository": {
+          "$ref": "common.schema.json#/$defs/repository"
+        },
         "views": {
           "$ref": "common.schema.json#/$defs/guidedViews"
         },
@@ -71,45 +79,15 @@
               }
             }
           }
-        },
-        "viewBox": {
-          "type": "array",
-          "prefixItems": [
-            {
-              "type": "number",
-              "minimum": 420
-            },
-            {
-              "type": "number",
-              "minimum": 566
-            }
-          ],
-          "items": false,
-          "minItems": 2,
-          "maxItems": 2
         }
       }
     },
-    "lanes": {
+    "mainPath": {
+      "description": "The happy path from the initial state, left to right. Each consecutive pair needs a transition. Every other state is placed below the state it branches from; transitions back to an earlier main-path state are drawn as loops above.",
       "type": "array",
-      "minItems": 1,
-      "maxItems": 4,
+      "minItems": 2,
       "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": [
-          "id",
-          "label"
-        ],
-        "properties": {
-          "id": {
-            "$ref": "common.schema.json#/$defs/id"
-          },
-          "label": {
-            "type": "string",
-            "minLength": 1
-          }
-        }
+        "$ref": "common.schema.json#/$defs/id"
       }
     },
     "states": {
@@ -121,15 +99,14 @@
         "required": [
           "id",
           "type",
-          "label",
-          "lane",
-          "col"
+          "label"
         ],
         "properties": {
           "id": {
             "$ref": "common.schema.json#/$defs/id"
           },
           "type": {
+            "description": "start: the initial state. active: work in progress. waiting: paused for a person, time, or input. decision: a review or branch point (Mermaid <<choice>>). success / failure: a good or bad outcome. neutral: parked, or ended without success or failure. external: handled by an outside party. Color and the default corner sigil follow the type.",
             "enum": [
               "start",
               "active",
@@ -151,30 +128,15 @@
           "tag": {
             "type": "string"
           },
+          "icon": { "$ref": "common.schema.json#/$defs/nodeIcon" },
           "brand": {
             "$ref": "common.schema.json#/$defs/brandMark"
           },
+          "sources": {
+            "$ref": "common.schema.json#/$defs/sourceReferences"
+          },
           "step": {
             "type": "string"
-          },
-          "lane": {
-            "$ref": "common.schema.json#/$defs/id"
-          },
-          "col": {
-            "type": "integer",
-            "minimum": 0,
-            "maximum": 4
-          },
-          "width": {
-            "type": "number",
-            "minimum": 48
-          },
-          "height": {
-            "type": "number",
-            "minimum": 36
-          },
-          "yOffset": {
-            "type": "number"
           }
         }
       }
@@ -206,55 +168,6 @@
           },
           "variant": {
             "$ref": "common.schema.json#/$defs/variant"
-          },
-          "route": {
-            "enum": [
-              "auto",
-              "straight",
-              "drop",
-              "bottom-channel",
-              "top-channel",
-              "right-channel",
-              "left-channel"
-            ]
-          },
-          "fromSide": {
-            "$ref": "common.schema.json#/$defs/side"
-          },
-          "toSide": {
-            "$ref": "common.schema.json#/$defs/side"
-          },
-          "channelX": {
-            "type": "number"
-          },
-          "channelY": {
-            "type": "number"
-          },
-          "cornerRadius": {
-            "type": "number",
-            "minimum": 0
-          },
-          "labelAt": {
-            "$ref": "common.schema.json#/$defs/point"
-          },
-          "labelDx": {
-            "type": "number"
-          },
-          "labelDy": {
-            "type": "number"
-          },
-          "labelSegment": {
-            "type": "integer",
-            "minimum": 0
-          },
-          "via": {
-            "type": "array",
-            "items": {
-              "$ref": "common.schema.json#/$defs/point"
-            }
-          },
-          "width": {
-            "$ref": "common.schema.json#/$defs/relationshipWidth"
           }
         }
       }

package/ai/skills/stacks-technical-diagrams/schemas/sequence.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://github.com/tt-a1i/archify/schemas/sequence.schema.json",
-  "title": "Technical Sequence Diagram",
+  "title": "Archify Sequence Diagram",
   "type": "object",
   "additionalProperties": false,
   "required": [
@@ -22,7 +22,8 @@
       "type": "object",
       "additionalProperties": false,
       "required": [
-        "title"
+        "title",
+        "output"
       ],
       "properties": {
         "title": {
@@ -32,11 +33,14 @@
         "locale": {
           "$ref": "common.schema.json#/$defs/locale"
         },
+        "translations": {
+          "$ref": "common.schema.json#/$defs/translations"
+        },
         "subtitle": {
           "type": "string"
         },
         "output": {
-          "type": "string"
+          "$ref": "common.schema.json#/$defs/portableOutputPath"
         },
         "animation": {
           "$ref": "common.schema.json#/$defs/animation"
@@ -48,9 +52,12 @@
           "$ref": "common.schema.json#/$defs/qualityProfile"
         },
         "column_fit": {
-          "description": "Horizontal participant layout. Omit this field or use fixed for the stable 86px boxes and 108px gap. Use spread when a wide viewBox would leave unused horizontal space or meaningful participant labels do not fit the fixed boxes; spread derives wider boxes and gaps from the viewBox without changing participant order or message semantics.",
+          "description": "Horizontal participant layout. Defaults to spread whether or not meta.viewBox is supplied. Explicit fixed preserves the historical 86px boxes and 108px column gap. Use spread when a wide viewBox would leave unused horizontal space or meaningful participant labels do not fit the fixed boxes; spread derives box width and column distance from the viewBox with at least a 16px gap between participant cards without changing participant order or message semantics.",
           "enum": ["fixed", "spread"]
         },
+        "repository": {
+          "$ref": "common.schema.json#/$defs/repository"
+        },
         "views": {
           "$ref": "common.schema.json#/$defs/guidedViews"
         },
@@ -115,8 +122,12 @@
           "sublabel": {
             "type": "string"
           },
+          "icon": { "$ref": "common.schema.json#/$defs/nodeIcon" },
           "brand": {
             "$ref": "common.schema.json#/$defs/brandMark"
+          },
+          "sources": {
+            "$ref": "common.schema.json#/$defs/sourceReferences"
           }
         }
       }

package/ai/skills/stacks-technical-diagrams/schemas/timeline.schema.json

@@ -0,0 +1,160 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/tt-a1i/archify/schemas/timeline.schema.json",
+  "title": "Archify Event Timeline",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "diagram_type",
+    "meta",
+    "events"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "diagram_type": {
+      "const": "timeline"
+    },
+    "meta": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "title",
+        "evidence"
+      ],
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "locale": {
+          "$ref": "common.schema.json#/$defs/locale"
+        },
+        "translations": {
+          "$ref": "common.schema.json#/$defs/translations"
+        },
+        "subtitle": {
+          "type": "string"
+        },
+        "output": {
+          "type": "string"
+        },
+        "animation": {
+          "$ref": "common.schema.json#/$defs/animation"
+        },
+        "visual_preset": {
+          "$ref": "common.schema.json#/$defs/visualPreset"
+        },
+        "quality_profile": {
+          "$ref": "common.schema.json#/$defs/qualityProfile"
+        },
+        "repository": {
+          "$ref": "common.schema.json#/$defs/repository"
+        },
+        "views": {
+          "$ref": "common.schema.json#/$defs/guidedViews"
+        },
+        "evidence": {
+          "enum": [
+            "observed",
+            "illustrative"
+          ],
+          "description": "Whether the events are recorded observations or illustrative input; drawn on the canvas."
+        },
+        "timezone": {
+          "type": "string",
+          "minLength": 1,
+          "description": "IANA time zone used for axis and event labels; defaults to UTC."
+        }
+      }
+    },
+    "layout": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "width": {
+          "type": "number",
+          "minimum": 480,
+          "description": "Drawing width of the time axis in px."
+        },
+        "breaks": {
+          "enum": [
+            "auto",
+            "none"
+          ],
+          "description": "auto compresses long quiet periods into disclosed axis breaks."
+        }
+      }
+    },
+    "lanes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "label"
+        ],
+        "properties": {
+          "id": {
+            "$ref": "common.schema.json#/$defs/id"
+          },
+          "label": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "events": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "at",
+          "title"
+        ],
+        "properties": {
+          "id": {
+            "$ref": "common.schema.json#/$defs/id"
+          },
+          "at": {
+            "type": "string",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})$",
+            "description": "ISO 8601 timestamp with an explicit Z or ±HH:MM offset."
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "detail": {
+            "type": "string"
+          },
+          "lane": {
+            "$ref": "common.schema.json#/$defs/id"
+          },
+          "kind": {
+            "enum": [
+              "default",
+              "change",
+              "alert",
+              "action",
+              "recovery"
+            ]
+          },
+          "sources": {
+            "$ref": "common.schema.json#/$defs/sourceReferences"
+          }
+        }
+      }
+    },
+    "cards": {
+      "$ref": "common.schema.json#/$defs/cards"
+    }
+  }
+}

package/ai/skills/stacks-technical-diagrams/schemas/tree.schema.json

@@ -0,0 +1,141 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/tt-a1i/archify/schemas/tree.schema.json",
+  "title": "Archify Hierarchy and Tree Diagram",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "diagram_type",
+    "meta",
+    "nodes"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "diagram_type": {
+      "const": "tree"
+    },
+    "meta": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "title"
+      ],
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "locale": {
+          "$ref": "common.schema.json#/$defs/locale"
+        },
+        "translations": {
+          "$ref": "common.schema.json#/$defs/translations"
+        },
+        "subtitle": {
+          "type": "string"
+        },
+        "output": {
+          "type": "string"
+        },
+        "animation": {
+          "$ref": "common.schema.json#/$defs/animation"
+        },
+        "visual_preset": {
+          "$ref": "common.schema.json#/$defs/visualPreset"
+        },
+        "quality_profile": {
+          "$ref": "common.schema.json#/$defs/qualityProfile"
+        },
+        "repository": {
+          "$ref": "common.schema.json#/$defs/repository"
+        },
+        "views": {
+          "$ref": "common.schema.json#/$defs/guidedViews"
+        },
+        "viewBox": {
+          "type": "array",
+          "prefixItems": [
+            {
+              "type": "number",
+              "minimum": 320
+            },
+            {
+              "type": "number",
+              "minimum": 240
+            }
+          ],
+          "items": false,
+          "minItems": 2,
+          "maxItems": 2
+        }
+      }
+    },
+    "layout": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "direction": {
+          "enum": [
+            "down",
+            "right"
+          ]
+        },
+        "gapX": {
+          "type": "number",
+          "minimum": 16
+        },
+        "gapY": {
+          "type": "number",
+          "minimum": 24
+        },
+        "nodeW": {
+          "type": "number",
+          "minimum": 96
+        },
+        "nodeMaxW": {
+          "type": "number",
+          "minimum": 120
+        }
+      }
+    },
+    "nodes": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "label"
+        ],
+        "properties": {
+          "id": {
+            "$ref": "common.schema.json#/$defs/id"
+          },
+          "label": {
+            "type": "string",
+            "minLength": 1
+          },
+          "parent": {
+            "$ref": "common.schema.json#/$defs/id"
+          },
+          "sublabel": {
+            "type": "string"
+          },
+          "collapsed": {
+            "type": "boolean"
+          },
+          "sources": {
+            "$ref": "common.schema.json#/$defs/sourceReferences"
+          }
+        }
+      }
+    },
+    "cards": {
+      "$ref": "common.schema.json#/$defs/cards"
+    }
+  }
+}