@stacksjs/defaults 0.75.361 → 0.75.366

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

@@ -0,0 +1,345 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/tt-a1i/archify/schemas/class.schema.json",
+  "title": "Archify Class and Interface Diagram",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "diagram_type",
+    "meta",
+    "types"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "diagram_type": {
+      "const": "class"
+    },
+    "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"
+        },
+        "legend": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "mode": {
+              "$ref": "common.schema.json#/$defs/legendMode"
+            },
+            "entries": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "dependency": {
+                  "$ref": "common.schema.json#/$defs/legendEntry"
+                },
+                "association": {
+                  "$ref": "common.schema.json#/$defs/legendEntry"
+                },
+                "inheritance": {
+                  "$ref": "common.schema.json#/$defs/legendEntry"
+                },
+                "realization": {
+                  "$ref": "common.schema.json#/$defs/legendEntry"
+                },
+                "composition": {
+                  "$ref": "common.schema.json#/$defs/legendEntry"
+                },
+                "aggregation": {
+                  "$ref": "common.schema.json#/$defs/legendEntry"
+                }
+              }
+            }
+          }
+        },
+        "viewBox": {
+          "type": "array",
+          "prefixItems": [
+            {
+              "type": "number",
+              "minimum": 320
+            },
+            {
+              "type": "number",
+              "minimum": 240
+            }
+          ],
+          "items": false,
+          "minItems": 2,
+          "maxItems": 2
+        }
+      }
+    },
+    "layout": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mode"
+      ],
+      "properties": {
+        "mode": {
+          "enum": [
+            "grid"
+          ]
+        },
+        "origin": {
+          "$ref": "common.schema.json#/$defs/point"
+        },
+        "gapX": {
+          "type": "number",
+          "minimum": 0
+        },
+        "gapY": {
+          "type": "number",
+          "minimum": 0
+        },
+        "typeW": {
+          "type": "number",
+          "minimum": 120
+        },
+        "typeMaxW": {
+          "type": "number",
+          "minimum": 160
+        }
+      }
+    },
+    "types": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "label",
+          "kind"
+        ],
+        "properties": {
+          "id": {
+            "$ref": "common.schema.json#/$defs/id"
+          },
+          "label": {
+            "type": "string",
+            "minLength": 1
+          },
+          "kind": {
+            "enum": [
+              "class",
+              "abstract",
+              "interface",
+              "enum",
+              "record"
+            ]
+          },
+          "sublabel": {
+            "type": "string"
+          },
+          "row": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 12
+          },
+          "col": {
+            "type": "number",
+            "multipleOf": 0.5,
+            "minimum": 0,
+            "maximum": 12,
+            "description": "Grid column. A half step (e.g. 1.5) centres the type between two columns, such as a supertype over two subtypes."
+          },
+          "pos": {
+            "$ref": "common.schema.json#/$defs/point"
+          },
+          "width": {
+            "type": "number",
+            "minimum": 120
+          },
+          "attributes": {
+            "type": "array",
+            "items": {
+              "$ref": "#/$defs/attribute"
+            }
+          },
+          "methods": {
+            "type": "array",
+            "items": {
+              "$ref": "#/$defs/method"
+            }
+          },
+          "sources": {
+            "$ref": "common.schema.json#/$defs/sourceReferences"
+          }
+        }
+      }
+    },
+    "relationships": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "from",
+          "to",
+          "kind"
+        ],
+        "properties": {
+          "id": {
+            "$ref": "common.schema.json#/$defs/id"
+          },
+          "from": {
+            "$ref": "common.schema.json#/$defs/id"
+          },
+          "to": {
+            "$ref": "common.schema.json#/$defs/id"
+          },
+          "kind": {
+            "enum": [
+              "dependency",
+              "association",
+              "inheritance",
+              "realization",
+              "composition",
+              "aggregation"
+            ]
+          },
+          "label": {
+            "type": "string"
+          },
+          "fromSide": {
+            "$ref": "common.schema.json#/$defs/side"
+          },
+          "toSide": {
+            "$ref": "common.schema.json#/$defs/side"
+          },
+          "route": {
+            "enum": [
+              "auto",
+              "straight",
+              "orthogonal-h",
+              "orthogonal-v"
+            ]
+          },
+          "via": {
+            "type": "array",
+            "items": {
+              "$ref": "common.schema.json#/$defs/point"
+            }
+          },
+          "labelAt": {
+            "$ref": "common.schema.json#/$defs/point"
+          },
+          "labelDx": {
+            "type": "number"
+          },
+          "labelDy": {
+            "type": "number"
+          },
+          "labelSegment": {
+            "type": "integer",
+            "minimum": 0
+          }
+        }
+      }
+    },
+    "cards": {
+      "$ref": "common.schema.json#/$defs/cards"
+    }
+  },
+  "$defs": {
+    "visibility": {
+      "enum": [
+        "public",
+        "protected",
+        "package",
+        "private"
+      ]
+    },
+    "attribute": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "type": "string",
+          "minLength": 1
+        },
+        "visibility": {
+          "$ref": "#/$defs/visibility"
+        },
+        "static": {
+          "type": "boolean"
+        }
+      }
+    },
+    "method": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "parameters": {
+          "type": "string"
+        },
+        "returns": {
+          "type": "string",
+          "minLength": 1
+        },
+        "visibility": {
+          "$ref": "#/$defs/visibility"
+        },
+        "static": {
+          "type": "boolean"
+        },
+        "abstract": {
+          "type": "boolean"
+        }
+      }
+    }
+  }
+}

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

@@ -1,14 +1,22 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://github.com/tt-a1i/archify/schemas/common.schema.json",
-  "title": "Technical Diagram Shared Definitions",
+  "title": "Archify Shared Definitions",
   "$defs": {
     "id": {
       "type": "string",
       "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$"
     },
     "locale": {
-      "enum": ["en", "zh-CN"]
+      "type": "string",
+      "pattern": "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
+      "maxLength": 35
+    },
+    "translations": {
+      "type": "object",
+      "propertyNames": { "pattern": "^[a-z][a-zA-Z0-9]*(\\.[a-z][a-zA-Z0-9]*)*$" },
+      "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 400 },
+      "maxProperties": 600
     },
     "animation": {
       "enum": ["trace", "none"]
@@ -19,6 +27,30 @@
     "qualityProfile": {
       "enum": ["standard", "showcase"]
     },
+    "portableOutputPath": {
+      "description": "A portable POSIX-relative HTML output path. It must be safe to interpret identically on every supported host filesystem.",
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[^/]+(?:/[^/]+)*$",
+      "allOf": [
+        { "pattern": "(?:^|/)[^/]+[.][Hh][Tt][Mm][Ll]$" },
+        { "not": { "pattern": "[\\\\<>:\"|?*\\u0000-\\u001F\\u007F-\\u009F]" } },
+        { "not": { "pattern": "[\\uD800-\\uDFFF]" } },
+        { "not": { "pattern": "(^|/)[.]{1,2}(/|$)" } },
+        { "not": { "pattern": "[. ](/|$)" } },
+        { "not": { "pattern": "(^|/)[^/]{256}" } },
+        {
+          "not": {
+            "pattern": "(^|/)(?:[Cc][Oo][Nn]|[Pp][Rr][Nn]|[Aa][Uu][Xx]|[Nn][Uu][Ll]|[Cc][Oo][Nn][Ii][Nn][$]|[Cc][Oo][Nn][Oo][Uu][Tt][$]|[Cc][Oo][Mm][1-9¹²³]|[Ll][Pp][Tt][1-9¹²³])(?:[.]|/|$)"
+          }
+        },
+        {
+          "not": {
+            "pattern": "(^|/)[^/]*~[1-9][0-9]*(?:[.]|/|$)"
+          }
+        }
+      ]
+    },
     "side": {
       "enum": ["left", "right", "top", "bottom"]
     },
@@ -39,6 +71,10 @@
     "componentType": {
       "enum": ["frontend", "backend", "database", "cloud", "security", "messagebus", "external"]
     },
+    "nodeIcon": {
+      "description": "Decorative corner icon. Omit the icon field for the type default; none hides it. Does not change type, color, or legend grouping.",
+      "enum": ["calendar", "clock", "person", "briefcase", "flag", "moon", "frontend", "backend", "database", "cloud", "security", "messagebus", "external", "start", "active", "waiting", "decision", "success", "failure", "stop", "neutral", "none"]
+    },
     "brandMark": {
       "oneOf": [
         {
@@ -95,6 +131,36 @@
         }
       }
     },
+    "repository": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["url", "revision"],
+      "properties": {
+        "url": {
+          "type": "string",
+          "minLength": 1
+        },
+        "provider": { "enum": ["github", "gitee", "gitlab"] },
+        "link_mode": { "enum": ["web", "local-only"] },
+        "revision": { "type": "string", "pattern": "^[a-fA-F0-9]{40}$" }
+      }
+    },
+    "sourceReferences": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 3,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1, "maxLength": 240 },
+          "line": { "type": "integer", "minimum": 1 },
+          "end_line": { "type": "integer", "minimum": 1 },
+          "label": { "type": "string", "minLength": 1, "maxLength": 48 }
+        }
+      }
+    },
     "cards": {
       "type": "array",
       "items": {

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

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://github.com/tt-a1i/archify/schemas/dataflow.schema.json",
-  "title": "Technical Data Flow Diagram",
+  "title": "Archify Data Flow Diagram",
   "type": "object",
   "additionalProperties": false,
   "required": [
@@ -23,7 +23,8 @@
       "type": "object",
       "additionalProperties": false,
       "required": [
-        "title"
+        "title",
+        "output"
       ],
       "properties": {
         "title": {
@@ -33,11 +34,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 +52,9 @@
         "quality_profile": {
           "$ref": "common.schema.json#/$defs/qualityProfile"
         },
+        "repository": {
+          "$ref": "common.schema.json#/$defs/repository"
+        },
         "views": {
           "$ref": "common.schema.json#/$defs/guidedViews"
         },
@@ -135,9 +142,13 @@
           "tag": {
             "type": "string"
           },
+          "icon": { "$ref": "common.schema.json#/$defs/nodeIcon" },
           "brand": {
             "$ref": "common.schema.json#/$defs/brandMark"
           },
+          "sources": {
+            "$ref": "common.schema.json#/$defs/sourceReferences"
+          },
           "stage": {
             "type": "integer",
             "minimum": 0