@robotaccomplice/architext 1.0.0

package/docs/architext/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "architext-template",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "dev": "vite --host 127.0.0.1 --port 4317",
+    "build": "tsc && vite build",
+    "preview": "vite preview --host 127.0.0.1 --port 4317",
+    "validate": "node tools/validate-architext.mjs"
+  },
+  "dependencies": {
+    "@vitejs/plugin-react": "^4.3.4",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "vite": "^6.0.7",
+    "typescript": "^5.7.2",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.2",
+    "@types/react-dom": "^19.0.2"
+  }
+}

package/docs/architext/public/compass.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Architext drafting compass favicon">
+  <rect width="64" height="64" rx="12" fill="#080b10"/>
+  <circle cx="32" cy="15" r="5" fill="#111620" stroke="#f5c84c" stroke-width="3"/>
+  <path d="M32 20L18 52" stroke="#e9edf4" stroke-width="4" stroke-linecap="round"/>
+  <path d="M32 20l15 32" stroke="#e9edf4" stroke-width="4" stroke-linecap="round"/>
+  <path d="M25 35h14" stroke="#58a6ff" stroke-width="3" stroke-linecap="round"/>
+  <path d="M16 55l5-1M44 54l6 1" stroke="#f5c84c" stroke-width="3" stroke-linecap="round"/>
+  <path d="M20 48a17 17 0 0 1 24 0" fill="none" stroke="#5dd39e" stroke-width="2" stroke-linecap="round"/>
+</svg>

package/docs/architext/schema/data-classification.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://architext.local/schema/data-classification.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["classes"],
+  "properties": {
+    "classes": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "name", "sensitivity", "handling"],
+        "properties": {
+          "id": { "$ref": "#/$defs/id" },
+          "name": { "type": "string", "minLength": 1 },
+          "sensitivity": { "type": "string", "enum": ["low", "medium", "high", "critical"] },
+          "handling": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" }
+  }
+}
+

package/docs/architext/schema/decisions.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://architext.local/schema/decisions.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["decisions"],
+  "properties": {
+    "decisions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "status", "title", "context", "decision", "consequences", "relatedNodes", "relatedFlows"],
+        "properties": {
+          "id": { "$ref": "#/$defs/id" },
+          "status": { "type": "string", "enum": ["planned", "accepted", "deprecated", "superseded"] },
+          "title": { "type": "string", "minLength": 1 },
+          "context": { "type": "string", "minLength": 1 },
+          "decision": { "type": "string", "minLength": 1 },
+          "consequences": { "$ref": "#/$defs/stringList" },
+          "relatedNodes": { "$ref": "#/$defs/idList" },
+          "relatedFlows": { "$ref": "#/$defs/idList" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "idList": { "type": "array", "items": { "$ref": "#/$defs/id" } },
+    "stringList": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+  }
+}
+

package/docs/architext/schema/flows.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://architext.local/schema/flows.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["flows"],
+  "properties": {
+    "flows": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "name",
+          "status",
+          "summary",
+          "trigger",
+          "actors",
+          "steps",
+          "guarantees",
+          "failureBehavior",
+          "observability",
+          "verification",
+          "knownGaps"
+        ],
+        "properties": {
+          "id": { "$ref": "#/$defs/id" },
+          "name": { "type": "string", "minLength": 1 },
+          "status": { "type": "string", "enum": ["planned", "partial", "implemented"] },
+          "summary": { "type": "string", "minLength": 1 },
+          "trigger": { "type": "string", "minLength": 1 },
+          "actors": { "$ref": "#/$defs/idList" },
+          "steps": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["id", "from", "to", "action", "summary", "data"],
+              "properties": {
+                "id": { "$ref": "#/$defs/id" },
+                "from": { "$ref": "#/$defs/id" },
+                "to": { "$ref": "#/$defs/id" },
+                "action": { "type": "string", "minLength": 1 },
+                "summary": { "type": "string", "minLength": 1 },
+                "data": { "$ref": "#/$defs/idList" }
+              }
+            }
+          },
+          "guarantees": { "$ref": "#/$defs/stringList" },
+          "failureBehavior": { "$ref": "#/$defs/stringList" },
+          "observability": { "$ref": "#/$defs/stringList" },
+          "verification": { "$ref": "#/$defs/stringList" },
+          "knownGaps": { "$ref": "#/$defs/stringList" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "idList": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/id" }
+    },
+    "stringList": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    }
+  }
+}

package/docs/architext/schema/glossary.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://architext.local/schema/glossary.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["terms"],
+  "properties": {
+    "terms": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["term", "definition"],
+        "properties": {
+          "term": { "type": "string", "minLength": 1 },
+          "definition": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}
+

package/docs/architext/schema/manifest.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://architext.local/schema/manifest.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "project", "generatedAt", "defaultViewId", "files", "notes"],
+  "properties": {
+    "schemaVersion": { "type": "string", "minLength": 1 },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "name", "summary"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "name": { "type": "string", "minLength": 1 },
+        "summary": { "type": "string", "minLength": 1 }
+      }
+    },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "defaultViewId": { "$ref": "#/$defs/id" },
+    "files": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["nodes", "flows", "views", "dataClassification", "decisions", "risks", "glossary"],
+      "properties": {
+        "nodes": { "type": "string", "minLength": 1 },
+        "flows": { "type": "string", "minLength": 1 },
+        "views": { "type": "string", "minLength": 1 },
+        "dataClassification": { "type": "string", "minLength": 1 },
+        "decisions": { "type": "string", "minLength": 1 },
+        "risks": { "type": "string", "minLength": 1 },
+        "glossary": { "type": "string", "minLength": 1 }
+      }
+    },
+    "notes": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$"
+    }
+  }
+}
+

package/docs/architext/schema/nodes.schema.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://architext.local/schema/nodes.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["nodes"],
+  "properties": {
+    "nodes": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "type",
+          "name",
+          "summary",
+          "responsibilities",
+          "owner",
+          "sourcePaths",
+          "runtime",
+          "interfaces",
+          "dependencies",
+          "dataHandled",
+          "security",
+          "observability",
+          "relatedFlows",
+          "relatedDecisions",
+          "knownRisks",
+          "verification"
+        ],
+        "properties": {
+          "id": { "$ref": "#/$defs/id" },
+          "type": {
+            "type": "string",
+            "enum": ["actor", "software-system", "client", "service", "module", "worker", "queue", "data-store", "external-service", "deployment-unit", "trust-boundary"]
+          },
+          "name": { "type": "string", "minLength": 1 },
+          "summary": { "type": "string", "minLength": 1 },
+          "responsibilities": { "$ref": "#/$defs/stringList" },
+          "owner": { "type": "string", "minLength": 1 },
+          "sourcePaths": { "$ref": "#/$defs/stringList" },
+          "runtime": { "type": "string", "minLength": 1 },
+          "interfaces": { "$ref": "#/$defs/stringList" },
+          "dependencies": { "$ref": "#/$defs/idList" },
+          "dataHandled": { "$ref": "#/$defs/idList" },
+          "security": { "$ref": "#/$defs/stringList" },
+          "observability": { "$ref": "#/$defs/stringList" },
+          "relatedFlows": { "$ref": "#/$defs/idList" },
+          "relatedDecisions": { "$ref": "#/$defs/idList" },
+          "knownRisks": { "$ref": "#/$defs/idList" },
+          "verification": { "$ref": "#/$defs/stringList" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "idList": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/id" }
+    },
+    "stringList": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    }
+  }
+}

package/docs/architext/schema/risks.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://architext.local/schema/risks.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["risks"],
+  "properties": {
+    "risks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "title", "category", "severity", "status", "summary", "mitigations", "relatedNodes", "relatedFlows"],
+        "properties": {
+          "id": { "$ref": "#/$defs/id" },
+          "title": { "type": "string", "minLength": 1 },
+          "category": { "type": "string", "enum": ["technical", "operational", "security", "data"] },
+          "severity": { "type": "string", "enum": ["low", "medium", "high", "critical"] },
+          "status": { "type": "string", "enum": ["open", "planned", "mitigating", "accepted", "closed"] },
+          "summary": { "type": "string", "minLength": 1 },
+          "mitigations": { "$ref": "#/$defs/stringList" },
+          "relatedNodes": { "$ref": "#/$defs/idList" },
+          "relatedFlows": { "$ref": "#/$defs/idList" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "idList": { "type": "array", "items": { "$ref": "#/$defs/id" } },
+    "stringList": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+  }
+}
+

package/docs/architext/schema/views.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://architext.local/schema/views.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["views"],
+  "properties": {
+    "views": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "name", "type", "summary", "lanes"],
+        "properties": {
+          "id": { "$ref": "#/$defs/id" },
+          "name": { "type": "string", "minLength": 1 },
+          "type": {
+            "type": "string",
+            "enum": ["system-map", "flow-explorer", "c4-context", "c4-container", "c4-component", "dataflow", "deployment", "risk-overlay", "sequence"]
+          },
+          "summary": { "type": "string", "minLength": 1 },
+          "lanes": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["id", "name", "nodeIds"],
+              "properties": {
+                "id": { "$ref": "#/$defs/id" },
+                "name": { "type": "string", "minLength": 1 },
+                "nodeIds": { "$ref": "#/$defs/idList" }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "idList": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/id" }
+    }
+  }
+}