@robotaccomplice/architext 1.0.0

package/docs/architext/data/risks.json

@@ -0,0 +1,59 @@
+{
+  "risks": [
+    {
+      "id": "migration-data-loss",
+      "title": "Migration removes target-owned files by mistake",
+      "category": "operational",
+      "severity": "critical",
+      "status": "mitigating",
+      "summary": "The 1.0 migration deletes copied package-owned files from target repositories. A bad file list could remove project-owned content.",
+      "mitigations": ["Preserve docs/architext/data/*.json by default", "Expose removals in --dry-run", "Limit cleanup to known copied install paths"],
+      "relatedNodes": ["architext-cli", "target-repository", "target-data-files"],
+      "relatedFlows": ["copied-install-migration"]
+    },
+    {
+      "id": "outdated-agent-instructions",
+      "title": "Agents keep following copied-template instructions",
+      "category": "technical",
+      "severity": "high",
+      "status": "mitigating",
+      "summary": "Existing AGENTS.md or CLAUDE.md sections may tell agents to edit copied viewer/schema/tool files or run target-local npm commands.",
+      "mitigations": ["Replace the managed Architext section during migration", "Make doctor report outdated instruction sections", "Prompt agents to edit only docs/architext/data/*.json"],
+      "relatedNodes": ["llm-agent", "target-repository", "architext-cli"],
+      "relatedFlows": ["copied-install-migration", "architecture-maintenance"]
+    },
+    {
+      "id": "schema-version-mismatch",
+      "title": "Installed CLI schema differs from target data expectations",
+      "category": "technical",
+      "severity": "medium",
+      "status": "open",
+      "summary": "Target data created by an older CLI may fail validation under a newer package-owned schema.",
+      "mitigations": ["Report CLI and metadata versions in doctor", "Keep data migrations explicit and dry-runnable", "Do not rewrite architecture facts silently"],
+      "relatedNodes": ["schema-validator", "package-schemas", "target-data-files"],
+      "relatedFlows": ["architecture-maintenance", "copied-install-migration"]
+    },
+    {
+      "id": "package-runtime-drift",
+      "title": "Package contents miss runtime files",
+      "category": "operational",
+      "severity": "high",
+      "status": "mitigating",
+      "summary": "The global CLI depends on package-owned viewer assets, schemas, and tools. A bad package file list can break serve, build, or validate.",
+      "mitigations": ["Run npm pack --dry-run before release", "Keep package files explicit", "Validate serve/build/package workflows before publishing"],
+      "relatedNodes": ["package-artifacts", "viewer-runtime", "schema-validator"],
+      "relatedFlows": ["release-packaging", "local-review", "static-export"]
+    },
+    {
+      "id": "stale-static-export",
+      "title": "Static export becomes stale after data edits",
+      "category": "operational",
+      "severity": "low",
+      "status": "accepted",
+      "summary": "architext build copies target data into dist/data. Later JSON edits are not reflected until build runs again.",
+      "mitigations": ["Keep docs/architext/dist ignored by default", "Prefer architext serve for active review", "Rebuild before publishing static output"],
+      "relatedNodes": ["static-dist", "target-data-files"],
+      "relatedFlows": ["static-export"]
+    }
+  ]
+}

package/docs/architext/data/views.json

@@ -0,0 +1,91 @@
+{
+  "views": [
+    {
+      "id": "system-map",
+      "name": "System Map",
+      "type": "system-map",
+      "summary": "Architext global CLI and data-only repository architecture.",
+      "lanes": [
+        { "id": "users", "name": "Users", "nodeIds": ["maintainer", "llm-agent"] },
+        { "id": "cli", "name": "CLI", "nodeIds": ["architext-cli", "schema-validator"] },
+        { "id": "package", "name": "Package", "nodeIds": ["viewer-runtime", "package-schemas", "package-artifacts"] },
+        { "id": "target", "name": "Target Repository", "nodeIds": ["target-repository", "target-data-files", "static-dist"] }
+      ]
+    },
+    {
+      "id": "dataflow",
+      "name": "Dataflow",
+      "type": "dataflow",
+      "summary": "Project-owned data moving through package-owned validation and viewer runtime.",
+      "lanes": [
+        { "id": "actors", "name": "Actors", "nodeIds": ["maintainer", "llm-agent"] },
+        { "id": "package-owned", "name": "Package-Owned Runtime", "nodeIds": ["architext-cli", "viewer-runtime", "schema-validator", "package-schemas"] },
+        { "id": "repo-owned", "name": "Repo-Owned Data", "nodeIds": ["target-repository", "target-data-files", "static-dist"] }
+      ]
+    },
+    {
+      "id": "sequence",
+      "name": "Sequence",
+      "type": "sequence",
+      "summary": "Ordered lifecycle command interactions for the selected Architext flow.",
+      "lanes": [
+        { "id": "participants", "name": "Participants", "nodeIds": ["maintainer", "llm-agent", "architext-cli", "schema-validator", "viewer-runtime", "target-repository", "target-data-files", "static-dist"] }
+      ]
+    },
+    {
+      "id": "deployment",
+      "name": "Deployment",
+      "type": "deployment",
+      "summary": "Runtime placement for global package code and target repository data.",
+      "lanes": [
+        { "id": "terminal", "name": "Terminal", "nodeIds": ["maintainer", "llm-agent", "architext-cli", "schema-validator"] },
+        { "id": "package-files", "name": "Installed Package", "nodeIds": ["viewer-runtime", "package-schemas", "package-artifacts"] },
+        { "id": "repository", "name": "Repository", "nodeIds": ["target-repository", "target-data-files", "static-dist"] }
+      ]
+    },
+    {
+      "id": "c4-context",
+      "name": "C4 Context",
+      "type": "c4-context",
+      "summary": "Architext as a system used by maintainers and LLM agents.",
+      "lanes": [
+        { "id": "people", "name": "People", "nodeIds": ["maintainer", "llm-agent"] },
+        { "id": "system", "name": "Architext System", "nodeIds": ["architext-cli"] },
+        { "id": "external-context", "name": "Repository Context", "nodeIds": ["target-repository"] }
+      ]
+    },
+    {
+      "id": "c4-container",
+      "name": "C4 Container",
+      "type": "c4-container",
+      "summary": "Package-owned containers and target-owned data boundaries.",
+      "lanes": [
+        { "id": "actors", "name": "Actors", "nodeIds": ["maintainer", "llm-agent"] },
+        { "id": "containers", "name": "Architext Package", "nodeIds": ["architext-cli", "viewer-runtime", "schema-validator", "package-schemas"] },
+        { "id": "data", "name": "Target Data", "nodeIds": ["target-data-files", "static-dist"] }
+      ]
+    },
+    {
+      "id": "c4-component",
+      "name": "C4 Component",
+      "type": "c4-component",
+      "summary": "CLI-adjacent components that enforce the data-only repository contract.",
+      "lanes": [
+        { "id": "entrypoint", "name": "Entrypoint", "nodeIds": ["architext-cli"] },
+        { "id": "runtime", "name": "Runtime Components", "nodeIds": ["viewer-runtime", "schema-validator"] },
+        { "id": "contracts", "name": "Contracts", "nodeIds": ["package-schemas", "target-data-files", "package-artifacts"] }
+      ]
+    },
+    {
+      "id": "risk-overlay",
+      "name": "Data/Risks",
+      "type": "risk-overlay",
+      "summary": "Upgrade, migration, and package/runtime risks for Architext itself.",
+      "lanes": [
+        { "id": "operators", "name": "Operators", "nodeIds": ["maintainer", "llm-agent"] },
+        { "id": "managed-runtime", "name": "Managed Runtime", "nodeIds": ["architext-cli", "schema-validator", "viewer-runtime"] },
+        { "id": "owned-data", "name": "Owned Data", "nodeIds": ["target-repository", "target-data-files", "static-dist"] }
+      ]
+    }
+  ]
+}