@stacksjs/defaults 0.75.361 → 0.75.366

package/ai/skills/stacks-technical-diagrams/examples/archify-dev-activity.timeline.json

@@ -0,0 +1,176 @@
+{
+  "schema_version": 1,
+  "diagram_type": "timeline",
+  "meta": {
+    "title": "Archify dev branch activity, 28 Sep \u2013 4 Oct 2026",
+    "subtitle": "Observed from this repository's git history: tag creation dates and merge commit times on origin/dev.",
+    "output": "archify-dev-activity-timeline.html",
+    "evidence": "observed",
+    "timezone": "Asia/Shanghai",
+    "quality_profile": "showcase"
+  },
+  "layout": {
+    "width": 1400
+  },
+  "lanes": [
+    {
+      "id": "release",
+      "label": "Releases"
+    },
+    {
+      "id": "merge",
+      "label": "PR merges"
+    },
+    {
+      "id": "sync",
+      "label": "Branch syncs"
+    }
+  ],
+  "events": [
+    {
+      "id": "v3_0_0",
+      "at": "2026-09-28T19:13:16+08:00",
+      "title": "Tag v3.0.0",
+      "lane": "release",
+      "kind": "change",
+      "detail": "git tag v3.0.0"
+    },
+    {
+      "id": "v3_0_1",
+      "at": "2026-09-28T23:16:27+08:00",
+      "title": "Tag v3.0.1",
+      "lane": "release",
+      "kind": "change",
+      "detail": "git tag v3.0.1"
+    },
+    {
+      "id": "pr627",
+      "at": "2026-09-29T14:16:30+08:00",
+      "title": "Merge #627 restore Kimi poster",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr628",
+      "at": "2026-09-29T14:17:35+08:00",
+      "title": "Merge #628 restore Kimi poster",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr629",
+      "at": "2026-09-29T14:28:59+08:00",
+      "title": "Merge #629 README sponsor name",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr635",
+      "at": "2026-09-30T00:15:40+08:00",
+      "title": "Merge #635 README launch v4",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr636",
+      "at": "2026-09-30T00:23:38+08:00",
+      "title": "Merge #636 README support section",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr634",
+      "at": "2026-09-30T00:23:57+08:00",
+      "title": "Merge #634 repair-rounds bench",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr637",
+      "at": "2026-09-30T00:42:24+08:00",
+      "title": "Merge #637 README Alipay support",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "sync_main",
+      "at": "2026-09-30T14:36:59+08:00",
+      "title": "Merge main into dev",
+      "lane": "sync",
+      "kind": "action",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr615",
+      "at": "2026-09-30T18:19:15+08:00",
+      "title": "Merge #615 stable manifest v3.0.1",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "sync_upstream",
+      "at": "2026-10-01T16:28:51+05:30",
+      "title": "Merge upstream dev and regenerate artifacts",
+      "lane": "sync",
+      "kind": "action",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr655",
+      "at": "2026-10-02T20:49:57+08:00",
+      "title": "Merge #655 locale catalogs",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr587",
+      "at": "2026-10-02T21:13:51+08:00",
+      "title": "Merge #587 brand ICO bounds",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr399",
+      "at": "2026-10-02T21:36:46+08:00",
+      "title": "Merge #399 ERD diagrams",
+      "lane": "merge",
+      "kind": "recovery",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr632",
+      "at": "2026-10-02T22:08:03+08:00",
+      "title": "Merge #632 card note overflow",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr672",
+      "at": "2026-10-04T09:57:08+08:00",
+      "title": "Merge #672 repair-rounds blind spots",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr677",
+      "at": "2026-10-04T10:14:55+08:00",
+      "title": "Merge #677 release subscriptions",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr674",
+      "at": "2026-10-04T10:17:01+08:00",
+      "title": "Merge #674 community registry v0",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    },
+    {
+      "id": "pr668",
+      "at": "2026-10-04T13:18:18+08:00",
+      "title": "Merge #668 MCO artifact refresh",
+      "lane": "merge",
+      "detail": "Merge commit on dev"
+    }
+  ]
+}

package/ai/skills/stacks-technical-diagrams/examples/archify-repository.tree.json

@@ -0,0 +1,197 @@
+{
+  "schema_version": 1,
+  "diagram_type": "tree",
+  "meta": {
+    "title": "Archify repository layout",
+    "subtitle": "Observed directory structure of this repository (selected files). Runs of three or more files are listed; the viewer/ branch starts collapsed.",
+    "output": "archify-repository-tree.html",
+    "quality_profile": "showcase"
+  },
+  "layout": {
+    "direction": "down"
+  },
+  "nodes": [
+    {
+      "id": "repo",
+      "label": "archify repository",
+      "sublabel": "Skill, viewer, and site"
+    },
+    {
+      "id": "skill",
+      "label": "archify/",
+      "parent": "repo",
+      "sublabel": "Installable Skill package"
+    },
+    {
+      "id": "viewer",
+      "label": "viewer/",
+      "parent": "repo",
+      "sublabel": "Inlined into the template",
+      "collapsed": true
+    },
+    {
+      "id": "site",
+      "label": "website/",
+      "parent": "repo",
+      "sublabel": "Astro project site"
+    },
+    {
+      "id": "scripts",
+      "label": "scripts/",
+      "parent": "repo",
+      "sublabel": "Build and freshness tools"
+    },
+    {
+      "id": "renderers",
+      "label": "renderers/",
+      "parent": "skill",
+      "sublabel": "One per diagram type"
+    },
+    {
+      "id": "schemas",
+      "label": "schemas/",
+      "parent": "skill",
+      "sublabel": "Typed JSON contracts"
+    },
+    {
+      "id": "bin",
+      "label": "bin/",
+      "parent": "skill",
+      "sublabel": "CLI entry points"
+    },
+    {
+      "id": "references",
+      "label": "references/",
+      "parent": "skill",
+      "sublabel": "Authoring contracts"
+    },
+    {
+      "id": "r_arch",
+      "label": "architecture/",
+      "parent": "renderers",
+      "sublabel": "Boundaries and router"
+    },
+    {
+      "id": "r_workflow",
+      "label": "workflow/",
+      "parent": "renderers",
+      "sublabel": "Workflow compiler"
+    },
+    {
+      "id": "r_sequence",
+      "label": "sequence/",
+      "parent": "renderers"
+    },
+    {
+      "id": "r_dataflow",
+      "label": "dataflow/",
+      "parent": "renderers"
+    },
+    {
+      "id": "r_lifecycle",
+      "label": "lifecycle/",
+      "parent": "renderers"
+    },
+    {
+      "id": "r_erd",
+      "label": "erd/",
+      "parent": "renderers",
+      "sublabel": "Crow's foot markers"
+    },
+    {
+      "id": "r_tree",
+      "label": "tree/",
+      "parent": "renderers",
+      "sublabel": "This renderer"
+    },
+    {
+      "id": "r_shared",
+      "label": "shared/",
+      "parent": "renderers",
+      "sublabel": "Shared helpers"
+    },
+    {
+      "id": "s_cli",
+      "label": "cli.mjs",
+      "parent": "r_shared",
+      "sublabel": "Load, validate, write"
+    },
+    {
+      "id": "s_geometry",
+      "label": "geometry.mjs",
+      "parent": "r_shared",
+      "sublabel": "Composition gates"
+    },
+    {
+      "id": "s_i18n",
+      "label": "i18n.mjs",
+      "parent": "r_shared",
+      "sublabel": "Locale catalogs"
+    },
+    {
+      "id": "s_validators",
+      "label": "generated-validators.mjs",
+      "parent": "r_shared",
+      "sublabel": "Schema validators"
+    },
+    {
+      "id": "b_archify",
+      "label": "archify.mjs",
+      "parent": "bin",
+      "sublabel": "CLI: validate, finalize"
+    },
+    {
+      "id": "b_finalize",
+      "label": "finalize.mjs",
+      "parent": "bin",
+      "sublabel": "Render, check, deliver"
+    },
+    {
+      "id": "b_preview",
+      "label": "preview.mjs",
+      "parent": "bin",
+      "sublabel": "Live preview server"
+    },
+    {
+      "id": "v_focus",
+      "label": "focus.js",
+      "parent": "viewer",
+      "sublabel": "Semantic passport"
+    },
+    {
+      "id": "v_export",
+      "label": "export.js",
+      "parent": "viewer",
+      "sublabel": "SVG, PNG, WebM export"
+    },
+    {
+      "id": "v_tree",
+      "label": "tree-branches.js",
+      "parent": "viewer",
+      "sublabel": "Expand and collapse"
+    },
+    {
+      "id": "v_camera",
+      "label": "viewer-camera.js",
+      "parent": "viewer",
+      "sublabel": "Pan, zoom, reveal"
+    },
+    {
+      "id": "sc_viewer",
+      "label": "generate-viewer.mjs",
+      "parent": "scripts",
+      "sublabel": "Inlines viewer/"
+    },
+    {
+      "id": "sc_zip",
+      "label": "build-zip.sh",
+      "parent": "scripts",
+      "sublabel": "Deterministic archive"
+    },
+    {
+      "id": "sc_gallery",
+      "label": "build-gallery.mjs",
+      "parent": "scripts"
+    }
+  ]
+}

package/ai/skills/stacks-technical-diagrams/examples/async-job-roundtrip.sequence.json

@@ -7,12 +7,7 @@
     "viewBox": [820, 920],
     "animation": "trace",
     "visual_preset": "signal-flow",
-    "quality_profile": "showcase",
-    "views": [
-      { "id": "accept-and-enqueue", "label": "Accept without blocking", "focus": ["client", "api", "queue"], "note": "The API acknowledges quickly after durable enqueue." },
-      { "id": "work-and-retry", "label": "Background work and retry", "focus": ["queue", "worker", "provider"], "note": "Timeouts re-enter the queue instead of holding the original request open." },
-      { "id": "observe-final-state", "label": "Observe final consistency", "focus": ["worker", "store", "notify", "client", "api"], "note": "Webhook delivery is primary; polling remains a bounded fallback." }
-    ]
+    "quality_profile": "showcase"
   },
   "participants": [
     { "id": "client", "type": "external", "label": "Client", "sublabel": "mobile app" },

package/ai/skills/stacks-technical-diagrams/examples/brand-aware-delivery.architecture.json

@@ -3,22 +3,9 @@
   "diagram_type": "architecture",
   "meta": {
     "title": "Brand-aware AI delivery",
+    "output": "brand-aware-delivery.html",
     "quality_profile": "showcase",
-    "viewBox": [1120, 640],
-    "views": [
-      {
-        "id": "delivery-path",
-        "label": "Delivery path",
-        "focus": ["request", "claude", "github", "container", "edge", "customer"],
-        "note": "Follow one delivery from the request through the model, repository, container, and edge."
-      },
-      {
-        "id": "business-data",
-        "label": "Business and data",
-        "focus": ["container", "database", "billing"],
-        "note": "Inspect durable state and billing without losing the main delivery path."
-      }
-    ]
+    "viewBox": [1120, 640]
   },
   "components": [
     { "id": "request", "type": "external", "label": "Product request", "sublabel": "Owner brief", "pos": [38, 260], "size": [138, 68] },
@@ -42,6 +29,6 @@
   ],
   "cards": [
     { "dot": "cyan", "title": "Identity at a glance", "items": ["Semantic color still explains technical role", "Brand badges identify the actual products"] },
-    { "dot": "amber", "title": "Portable by default", "items": ["Preset marks ship inside the skill", "Every visual export keeps the same badge"] }
+    { "dot": "amber", "title": "Portable by default", "items": ["Preset marks ship inside Archify", "Every visual export keeps the same badge"] }
   ]
 }

package/ai/skills/stacks-technical-diagrams/examples/cache-miss-request.sequence.json

@@ -4,15 +4,10 @@
   "meta": {
     "title": "Cache Miss Request Sequence",
     "output": "examples/sequence-cache-miss-request.html",
-    "viewBox": [1080, 560],
+    "viewBox": [1080, 580],
     "column_fit": "spread",
     "animation": "trace",
-    "quality_profile": "showcase",
-    "views": [
-      { "id": "request-and-auth", "label": "Request and identity", "focus": ["user", "web", "api", "auth"], "note": "Follow the user request through the authentication check." },
-      { "id": "cache-fallback", "label": "Cache fallback", "focus": ["api", "redis", "db"], "note": "See the cache miss and the source-of-truth query it triggers." },
-      { "id": "return-and-trace", "label": "Return and trace", "focus": ["db", "api", "redis", "trace", "web", "user"], "note": "Separate response latency from the non-blocking observability write." }
-    ]
+    "quality_profile": "showcase"
   },
   "participants": [
     { "id": "user", "type": "external", "label": "User", "sublabel": "browser session" },

package/ai/skills/stacks-technical-diagrams/examples/checkout-platform.base.architecture.json

@@ -2,7 +2,8 @@
   "schema_version": 1,
   "diagram_type": "architecture",
   "meta": {
-    "title": "Checkout Platform - Baseline",
+    "title": "Checkout Platform — Baseline",
+    "output": "checkout-platform.base.html",
     "visual_preset": "signal-flow"
   },
   "components": [

package/ai/skills/stacks-technical-diagrams/examples/checkout-platform.head.architecture.json

@@ -2,7 +2,8 @@
   "schema_version": 1,
   "diagram_type": "architecture",
   "meta": {
-    "title": "Checkout Platform - Fraud Gate",
+    "title": "Checkout Platform — Fraud Gate",
+    "output": "checkout-platform.head.html",
     "visual_preset": "signal-flow"
   },
   "components": [

package/ai/skills/stacks-technical-diagrams/examples/checkout-request.waterfall.json

@@ -0,0 +1,20 @@
+{
+  "schema_version": 1,
+  "diagram_type": "waterfall",
+  "meta": {
+    "title": "Checkout request execution",
+    "subtitle": "Illustrative timing: inventory lookup and discount calculation run concurrently; payment follows.",
+    "output": "checkout-request-waterfall.html",
+    "evidence": "illustrative",
+    "unit": "ms",
+    "quality_profile": "showcase"
+  },
+  "spans": [
+    { "id": "request", "name": "POST /checkout", "service": "checkout-api", "start": 0, "end": 1200, "detail": "Parent of every step below; its duration is not added to theirs." },
+    { "id": "auth", "name": "Authenticate caller", "service": "identity", "start": 0, "duration": 100, "parent": "request" },
+    { "id": "inventory", "name": "Look up inventory", "service": "inventory", "start": 100, "duration": 300, "parent": "request" },
+    { "id": "discount", "name": "Calculate discount", "service": "checkout-api", "start": 100, "duration": 200, "parent": "request" },
+    { "id": "payment", "name": "Charge payment", "service": "payments", "start": 400, "duration": 650, "parent": "request" },
+    { "id": "save", "name": "Write order", "service": "checkout-api", "start": 1050, "duration": 150, "parent": "request" }
+  ]
+}