geneseed 4.27.1 → 4.29.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (143) hide show
  1. package/CHANGELOG.md +53 -0
  2. package/README.md +7 -4
  3. package/SHIPPED.md +2 -2
  4. package/adapters/bob/README.md +1 -1
  5. package/adapters/claude-code/README.md +4 -2
  6. package/adapters/opencode/HOW-OPENCODE-LOADS.md +2 -2
  7. package/adapters/opencode/README.md +18 -2
  8. package/adapters/opencode/plugins/geneseed-context.js +155 -18
  9. package/adapters/opencode/plugins/geneseed-guard.js +59 -8
  10. package/adapters/opencode/plugins/geneseed-workflow.js +27 -8
  11. package/adapters/opencode/workflows/_runtime.js +14 -3
  12. package/docs/concepts/enforcement-table.md +5 -4
  13. package/docs/concepts/exclusions.md +3 -3
  14. package/docs/concepts/hooks.md +11 -3
  15. package/docs/concepts/ownership.md +7 -6
  16. package/docs/concepts/skills.md +1 -0
  17. package/docs/guides/set-up-ownership.md +22 -6
  18. package/docs/reference/environment.md +1 -0
  19. package/docs/reference/plugin-context.md +3 -1
  20. package/docs/reference/plugin-guard.md +1 -1
  21. package/docs/understand/enforced-vs-asked.md +3 -3
  22. package/docs/understand/machine-bob.md +1 -1
  23. package/docs/understand/machine-claude.md +1 -1
  24. package/docs/understand/machine-opencode.md +1 -1
  25. package/harness.config.json +1 -1
  26. package/js/README.md +3 -1
  27. package/js/build/driver.mjs +29 -9
  28. package/js/build/emit-opencode.mjs +12 -10
  29. package/js/build/render.mjs +9 -0
  30. package/js/hosts/done-checks.mjs +134 -0
  31. package/js/hosts/geneseed-dir.mjs +116 -0
  32. package/js/hosts/hooks-context.mjs +19 -0
  33. package/js/hosts/hooks-done.mjs +82 -38
  34. package/js/hosts/hooks-learn.mjs +9 -2
  35. package/js/hosts/hooks-prims.mjs +4 -0
  36. package/js/hosts/hooks.mjs +139 -6
  37. package/js/hosts/hosts.mjs +6 -0
  38. package/js/hosts/native.mjs +1 -1
  39. package/js/hosts/owned.mjs +19 -0
  40. package/js/hosts/ownership-gate.mjs +64 -10
  41. package/js/hosts/settings.mjs +115 -74
  42. package/js/inspect/checks-constitution.mjs +5 -1
  43. package/js/inspect/cost.mjs +1 -1
  44. package/js/inspect/doctor.mjs +2 -1
  45. package/js/inspect/inventory.mjs +1 -1
  46. package/js/inspect/status.mjs +2 -1
  47. package/js/inspect/validate.mjs +2 -1
  48. package/js/lib/json.mjs +70 -0
  49. package/js/maintain/uninstall.mjs +18 -5
  50. package/js/web/gates-api.mjs +2 -2
  51. package/package.json +1 -1
  52. package/registry.json +14 -0
  53. package/src/AGENT.md.tmpl +2 -2
  54. package/src/doctrines/comms.md +9 -2
  55. package/src/licenses/i-have-adhd.txt +21 -0
  56. package/src/skills/_checkpoints.md +15 -2
  57. package/src/skills/adhd.md +40 -0
  58. package/src/skills/diagram-design/LICENSE +21 -0
  59. package/src/skills/diagram-design/SKILL.md +392 -0
  60. package/src/skills/diagram-design/THIRD_PARTY_LICENSES.md +134 -0
  61. package/src/skills/diagram-design/VENDOR.md +81 -0
  62. package/src/skills/diagram-design/assets/example-architecture.html +183 -0
  63. package/src/skills/diagram-design/assets/example-venn.html +110 -0
  64. package/src/skills/diagram-design/assets/template-dark.html +99 -0
  65. package/src/skills/diagram-design/assets/template-full.html +421 -0
  66. package/src/skills/diagram-design/assets/template-motion.html +448 -0
  67. package/src/skills/diagram-design/assets/template-terminal.html +188 -0
  68. package/src/skills/diagram-design/assets/template.html +100 -0
  69. package/src/skills/diagram-design/references/animation.md +135 -0
  70. package/src/skills/diagram-design/references/layout-budget.md +97 -0
  71. package/src/skills/diagram-design/references/onboarding.md +368 -0
  72. package/src/skills/diagram-design/references/output-spec.md +277 -0
  73. package/src/skills/diagram-design/references/primitive-annotation.md +36 -0
  74. package/src/skills/diagram-design/references/primitive-icons.md +782 -0
  75. package/src/skills/diagram-design/references/primitive-sketchy.md +43 -0
  76. package/src/skills/diagram-design/references/primitive-terminal.md +76 -0
  77. package/src/skills/diagram-design/references/primitives-core.md +144 -0
  78. package/src/skills/diagram-design/references/profiles.md +183 -0
  79. package/src/skills/diagram-design/references/semantic-patterns.md +154 -0
  80. package/src/skills/diagram-design/references/style-guide.md +232 -0
  81. package/src/skills/diagram-design/references/type-architecture-delta.md +143 -0
  82. package/src/skills/diagram-design/references/type-architecture.md +117 -0
  83. package/src/skills/diagram-design/references/type-axonometric-plan.md +83 -0
  84. package/src/skills/diagram-design/references/type-bar.md +108 -0
  85. package/src/skills/diagram-design/references/type-data-flow.md +371 -0
  86. package/src/skills/diagram-design/references/type-db-schema.md +48 -0
  87. package/src/skills/diagram-design/references/type-dependency.md +44 -0
  88. package/src/skills/diagram-design/references/type-deployment.md +45 -0
  89. package/src/skills/diagram-design/references/type-dp-integration.md +407 -0
  90. package/src/skills/diagram-design/references/type-dp-security-matrix.md +379 -0
  91. package/src/skills/diagram-design/references/type-er.md +25 -0
  92. package/src/skills/diagram-design/references/type-exploded.md +115 -0
  93. package/src/skills/diagram-design/references/type-fishbone.md +75 -0
  94. package/src/skills/diagram-design/references/type-flowchart.md +23 -0
  95. package/src/skills/diagram-design/references/type-gantt.md +45 -0
  96. package/src/skills/diagram-design/references/type-heatmap.md +80 -0
  97. package/src/skills/diagram-design/references/type-high-level.md +470 -0
  98. package/src/skills/diagram-design/references/type-it-state.md +468 -0
  99. package/src/skills/diagram-design/references/type-journey.md +55 -0
  100. package/src/skills/diagram-design/references/type-kanban.md +49 -0
  101. package/src/skills/diagram-design/references/type-layers.md +26 -0
  102. package/src/skills/diagram-design/references/type-line.md +337 -0
  103. package/src/skills/diagram-design/references/type-loop.md +223 -0
  104. package/src/skills/diagram-design/references/type-medallion.md +356 -0
  105. package/src/skills/diagram-design/references/type-nested.md +22 -0
  106. package/src/skills/diagram-design/references/type-org-chart.md +44 -0
  107. package/src/skills/diagram-design/references/type-polar.md +136 -0
  108. package/src/skills/diagram-design/references/type-process.md +490 -0
  109. package/src/skills/diagram-design/references/type-pyramid.md +33 -0
  110. package/src/skills/diagram-design/references/type-quadrant.md +81 -0
  111. package/src/skills/diagram-design/references/type-radar.md +82 -0
  112. package/src/skills/diagram-design/references/type-sankey.md +75 -0
  113. package/src/skills/diagram-design/references/type-scatter.md +276 -0
  114. package/src/skills/diagram-design/references/type-sequence.md +130 -0
  115. package/src/skills/diagram-design/references/type-service-blueprint.md +103 -0
  116. package/src/skills/diagram-design/references/type-state.md +30 -0
  117. package/src/skills/diagram-design/references/type-story-map.md +46 -0
  118. package/src/skills/diagram-design/references/type-swimlane.md +22 -0
  119. package/src/skills/diagram-design/references/type-timeline.md +20 -0
  120. package/src/skills/diagram-design/references/type-tree.md +24 -0
  121. package/src/skills/diagram-design/references/type-treemap.md +137 -0
  122. package/src/skills/diagram-design/references/type-uml-class.md +65 -0
  123. package/src/skills/diagram-design/references/type-venn.md +26 -0
  124. package/src/skills/diagram-design/references/type-wardley.md +39 -0
  125. package/src/skills/diagram-design/references/type-waterfall.md +75 -0
  126. package/src/skills/document-project.md +4 -1
  127. package/src/skills/ownership.md +26 -4
  128. package/src/upstreams.json +14 -0
  129. package/themes/_TEMPLATE.json +1 -0
  130. package/themes/biker.json +1 -0
  131. package/themes/commentator.json +1 -0
  132. package/themes/cyberpunk.json +1 -0
  133. package/themes/gamer.json +1 -0
  134. package/themes/imperial.json +1 -0
  135. package/themes/joker.json +1 -0
  136. package/themes/marvin.json +1 -0
  137. package/themes/mean.json +1 -0
  138. package/themes/military.json +1 -0
  139. package/themes/neutral.json +1 -0
  140. package/themes/pirate.json +1 -0
  141. package/themes/sports.json +1 -0
  142. package/themes/verstappen.json +1 -0
  143. package/themes/wizard.json +1 -0
@@ -0,0 +1,421 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>[PROJECT NAME] Architecture</title>
7
+ <link href="https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500;600&family=Noto+Serif:ital@0;1&family=Noto+Sans+KR:wght@400;500;600&family=Noto+Serif+KR:wght@400&family=Noto+Sans+TC:wght@400;500;600&family=Noto+Serif+TC:wght@400&display=swap" rel="stylesheet">
8
+ <style>
9
+ *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
10
+
11
+ /* ── Tokens ─────────────────────────────────────────────────── */
12
+ :root {
13
+ --color-paper: #f5f5f5;
14
+ --color-paper-2: #ececec;
15
+ --color-ink: #2d3142;
16
+ --color-muted: #4f5d75;
17
+ --color-soft: #5a6580;
18
+ --color-rule: rgba(45,49,66,0.12);
19
+ --color-rule-solid: rgba(79,93,117,0.25);
20
+ --color-accent: #bf4520;
21
+ --color-accent-tint: rgba(191,69,32,0.08);
22
+ --color-link: #2e5aa8;
23
+ --font-sans: 'Geist', system-ui, sans-serif;
24
+ --font-serif: 'Instrument Serif', 'Noto Serif', 'Noto Serif KR', 'Times New Roman', serif;
25
+ --font-mono: 'Geist Mono', ui-monospace, Menlo, monospace;
26
+ }
27
+
28
+ body {
29
+ font-family: var(--font-sans);
30
+ background: var(--color-paper);
31
+ min-height: 100vh;
32
+ padding: 3rem 2rem;
33
+ color: var(--color-ink);
34
+ }
35
+
36
+ .container { max-width: 1200px; margin: 0 auto; }
37
+
38
+ /* ── Header ─────────────────────────────────────────────────── */
39
+ .header { margin-bottom: 2.5rem; }
40
+
41
+ .header-eyebrow {
42
+ font-family: var(--font-mono);
43
+ font-size: 0.66rem;
44
+ font-weight: 500;
45
+ letter-spacing: 0.18em;
46
+ text-transform: uppercase;
47
+ color: var(--color-muted);
48
+ margin-bottom: 0.75rem;
49
+ }
50
+
51
+ h1 {
52
+ font-family: var(--font-serif);
53
+ font-size: clamp(1.75rem, 3vw + 1rem, 2.5rem);
54
+ font-weight: 400;
55
+ letter-spacing: -0.02em;
56
+ line-height: 1.1;
57
+ color: var(--color-ink);
58
+ margin-bottom: 0.5rem;
59
+ }
60
+
61
+ .subtitle {
62
+ font-family: var(--font-sans);
63
+ font-size: 1rem;
64
+ line-height: 1.55;
65
+ color: var(--color-muted);
66
+ max-width: 52ch;
67
+ }
68
+
69
+ /* ── Diagram container ────────────────────────────────────────── */
70
+ /* Default: clean, borderless — diagram sits directly on the page paper.
71
+ For the framed/boxed variant, uncomment the background/border/padding below. */
72
+ .diagram-container {
73
+ background: transparent;
74
+ border: none;
75
+ padding: 0;
76
+ overflow-x: auto;
77
+ /* background: var(--color-paper-2); */
78
+ /* border: 1px solid var(--color-rule); */
79
+ /* border-radius: 8px; */
80
+ /* padding: 1.5rem; */
81
+ }
82
+
83
+ svg { width: 100%; min-width: 1000px; display: block; } /* == viewBox width: never scale the type ramp down */
84
+ /* Paper has no scrollbar, so the local scroller would clip instead of
85
+ scroll. Let the diagram scale down to the sheet: smaller but whole
86
+ beats sharp but cut off. Must come after the svg rule above - a media
87
+ query adds no specificity, so a later plain rule would win. */
88
+ @media print {
89
+ .diagram-container { overflow-x: visible; }
90
+ svg { min-width: 0; }
91
+ }
92
+
93
+ /* ── Info cards ───────────────────────────────────────────────── */
94
+ .cards {
95
+ display: grid;
96
+ grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
97
+ gap: 1rem;
98
+ margin-top: 1.5rem;
99
+ }
100
+
101
+ .card {
102
+ background: #ffffff;
103
+ border-radius: 6px;
104
+ border: 1px solid var(--color-rule);
105
+ padding: 1.25rem;
106
+ }
107
+
108
+ .card-header {
109
+ display: flex;
110
+ align-items: center;
111
+ gap: 0.6rem;
112
+ margin-bottom: 0.875rem;
113
+ padding-bottom: 0.875rem;
114
+ border-bottom: 1px solid rgba(45,49,66,0.08);
115
+ }
116
+
117
+ .card-dot {
118
+ width: 7px; height: 7px;
119
+ border-radius: 50%;
120
+ flex-shrink: 0;
121
+ }
122
+ .card-dot.ink { background: var(--color-ink); }
123
+ .card-dot.muted { background: var(--color-muted); }
124
+ .card-dot.coral { background: var(--color-accent); }
125
+ .card-dot.link { background: var(--color-link); }
126
+ .card-dot.soft { background: var(--color-soft); }
127
+
128
+ .card h3 {
129
+ font-family: var(--font-sans);
130
+ font-size: 0.875rem;
131
+ font-weight: 600;
132
+ color: var(--color-ink);
133
+ letter-spacing: -0.005em;
134
+ }
135
+
136
+ .card ul {
137
+ list-style: none;
138
+ color: var(--color-muted);
139
+ font-size: 0.8125rem;
140
+ line-height: 1.55;
141
+ }
142
+
143
+ .card li {
144
+ margin-bottom: 0.3rem;
145
+ padding-left: 0.875rem;
146
+ position: relative;
147
+ }
148
+
149
+ .card li::before {
150
+ content: '—';
151
+ position: absolute;
152
+ left: 0;
153
+ color: rgba(45,49,66,0.25);
154
+ font-size: 0.75rem;
155
+ }
156
+
157
+ /* ── Footer ─────────────────────────────────────────────────── */
158
+ .footer {
159
+ margin-top: 2rem;
160
+ padding-top: 1.5rem;
161
+ border-top: 1px solid rgba(45,49,66,0.10);
162
+ font-family: var(--font-mono);
163
+ font-size: 0.72rem;
164
+ letter-spacing: 0.06em;
165
+ color: var(--color-soft);
166
+ display: flex;
167
+ justify-content: space-between;
168
+ align-items: center;
169
+ flex-wrap: wrap;
170
+ gap: 0.5rem;
171
+ }
172
+ </style>
173
+ </head>
174
+ <body>
175
+ <div class="container">
176
+
177
+ <!-- Header -->
178
+ <div class="header">
179
+ <p class="header-eyebrow">Architecture · [Date]</p>
180
+ <h1>[Project Name]</h1>
181
+ <p class="subtitle">[One-sentence description of what this diagram shows.]</p>
182
+ </div>
183
+
184
+ <!-- Main Diagram -->
185
+ <div class="diagram-container">
186
+ <!-- Replace [diagram-slug] with a unique slug for this diagram before export. -->
187
+ <svg viewBox="0 0 1000 720" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="[diagram-slug]-title [diagram-slug]-desc">
188
+ <title id="[diagram-slug]-title">[Diagram title]</title>
189
+ <desc id="[diagram-slug]-desc">[One sentence describing what the diagram shows]</desc>
190
+ <defs>
191
+
192
+ <!-- OPTIONAL: dot-pattern background. Uncomment the <pattern> below and the second <rect> in the bg section to enable. -->
193
+ <!--
194
+ <pattern id="dots" width="22" height="22" patternUnits="userSpaceOnUse">
195
+ <circle cx="1" cy="1" r="0.9" fill="rgba(45,49,66,0.10)"/>
196
+ </pattern>
197
+ -->
198
+
199
+ <!-- Arrow: muted (default — generic / internal connections) -->
200
+ <marker id="arrow" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
201
+ <polygon points="0 0, 8 3, 0 6" fill="#4f5d75"/>
202
+ </marker>
203
+
204
+ <!-- Arrow: coral (accent — primary / highlighted flows) -->
205
+ <marker id="arrow-accent" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
206
+ <polygon points="0 0, 8 3, 0 6" fill="#bf4520"/>
207
+ </marker>
208
+
209
+ <!-- Arrow: link-blue (#2e5aa8 — HTTP/API / external calls) -->
210
+ <marker id="arrow-link" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
211
+ <polygon points="0 0, 8 3, 0 6" fill="#2e5aa8"/>
212
+ </marker>
213
+
214
+ </defs>
215
+
216
+ <!-- Background: paper + dot grid -->
217
+ <rect width="100%" height="100%" fill="#f5f5f5"/>
218
+ <!-- <rect width="100%" height="100%" fill="url(#dots)" opacity="0.6"/> -->
219
+
220
+ <!-- =================================================================
221
+ DRAW ARROWS FIRST — they paint behind boxes (SVG document order).
222
+ ================================================================= -->
223
+
224
+ <!-- HTTP/API arrow (link-blue) with label -->
225
+ <line x1="130" y1="305" x2="195" y2="305" stroke="#2e5aa8" stroke-width="1.2" marker-end="url(#arrow-link)"/>
226
+ <text x="162" y="297" fill="#2e5aa8" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.06em">HTTPS</text>
227
+
228
+ <!-- Generic internal arrow -->
229
+ <line x1="310" y1="305" x2="356" y2="305" stroke="#4f5d75" stroke-width="1.2" marker-end="url(#arrow)"/>
230
+
231
+ <!-- Vertical arrow -->
232
+ <line x1="253" y1="332" x2="253" y2="376" stroke="#4f5d75" stroke-width="1.2" marker-end="url(#arrow)"/>
233
+
234
+ <!-- Auth / security flow (dashed coral) -->
235
+ <path d="M 80 140 L 80 200 Q 80 218 98 218 L 200 218 Q 218 218 218 236 L 218 276"
236
+ fill="none" stroke="#bf4520" stroke-width="1.2" stroke-dasharray="5,4"
237
+ marker-end="url(#arrow-accent)"/>
238
+ <text x="148" y="212" fill="#bf4520" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.06em">JWT</text>
239
+
240
+ <!-- Primary data flow (coral) -->
241
+ <line x1="620" y1="305" x2="696" y2="305" stroke="#bf4520" stroke-width="1.2" marker-end="url(#arrow-accent)"/>
242
+ <text x="655" y="297" fill="#bf4520" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.06em">TLS</text>
243
+
244
+
245
+ <!-- =================================================================
246
+ COMPONENT BOXES
247
+ Pattern: opaque paper rect first (masks arrows), then styled rect.
248
+ Mono type labels use Geist Mono — mono is dominant in tool/data.
249
+ ================================================================= -->
250
+
251
+ <!-- ── External / User ──────────────────────────────────────── -->
252
+ <rect x="30" y="278" width="100" height="54" rx="6" fill="#f5f5f5"/>
253
+ <rect x="30" y="278" width="100" height="54" rx="6" fill="rgba(79,93,117,0.10)" stroke="#5a6580" stroke-width="1"/>
254
+ <!-- Rectangular type tag (not rounded — brand rule) -->
255
+ <rect x="38" y="284" width="26" height="12" rx="2" fill="transparent" stroke="rgba(90,101,128,0.4)" stroke-width="0.8"/>
256
+ <text x="51" y="293" fill="#5a6580" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">EXT</text>
257
+ <!-- Main label -->
258
+ <text x="80" y="308" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Users</text>
259
+ <text x="80" y="323" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">Browser / Mobile</text>
260
+
261
+ <!-- ── Security / Auth ──────────────────────────────────────── -->
262
+ <rect x="30" y="78" width="100" height="56" rx="6" fill="#f5f5f5"/>
263
+ <rect x="30" y="78" width="100" height="56" rx="6" fill="rgba(191,69,32,0.06)" stroke="rgba(191,69,32,0.50)" stroke-width="1"/>
264
+ <rect x="38" y="84" width="28" height="12" rx="2" fill="transparent" stroke="rgba(191,69,32,0.40)" stroke-width="0.8"/>
265
+ <text x="52" y="93" fill="rgba(191,69,32,0.8)" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.06em">AUTH</text>
266
+ <text x="80" y="110" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Auth Provider</text>
267
+ <text x="80" y="125" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">OAuth 2.0</text>
268
+
269
+ <!-- ── Region boundary (dashed) ─────────────────────────────── -->
270
+ <rect x="158" y="38" width="822" height="624" rx="8" fill="transparent" stroke="rgba(45,49,66,0.18)" stroke-width="1" stroke-dasharray="6,4"/>
271
+ <text x="170" y="55" fill="#4f5d75" font-size="8" font-weight="500" font-family="'Geist Mono', monospace" letter-spacing="0.12em">AWS REGION · US-WEST-2</text>
272
+
273
+ <!-- ── Cloud / CDN (with faded watermark numeral — slide card pattern) -->
274
+ <rect x="198" y="278" width="112" height="54" rx="6" fill="#f5f5f5"/>
275
+ <rect x="198" y="278" width="112" height="54" rx="6" fill="rgba(45,49,66,0.03)" stroke="rgba(45,49,66,0.30)" stroke-width="1"/>
276
+ <!-- Faded mono watermark numeral (background) -->
277
+ <text x="294" y="323" fill="rgba(45,49,66,0.06)" font-size="40" font-weight="600" font-family="'Geist Mono', monospace" text-anchor="end">01</text>
278
+ <rect x="206" y="284" width="24" height="12" rx="2" fill="transparent" stroke="rgba(45,49,66,0.22)" stroke-width="0.8"/>
279
+ <text x="218" y="293" fill="#5a6580" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">CDN</text>
280
+ <text x="254" y="308" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">CloudFront</text>
281
+ <text x="254" y="323" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">AWS CDN</text>
282
+
283
+ <!-- ── Cloud / Storage ───────────────────────────────────────── -->
284
+ <rect x="198" y="378" width="112" height="102" rx="6" fill="#f5f5f5"/>
285
+ <rect x="198" y="378" width="112" height="102" rx="6" fill="rgba(45,49,66,0.03)" stroke="rgba(45,49,66,0.30)" stroke-width="1"/>
286
+ <text x="294" y="468" fill="rgba(45,49,66,0.06)" font-size="40" font-weight="600" font-family="'Geist Mono', monospace" text-anchor="end">02</text>
287
+ <rect x="206" y="384" width="22" height="12" rx="2" fill="transparent" stroke="rgba(45,49,66,0.22)" stroke-width="0.8"/>
288
+ <text x="217" y="393" fill="#5a6580" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">S3</text>
289
+ <text x="254" y="408" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">S3 Buckets</text>
290
+ <text x="254" y="426" fill="#4f5d75" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle">bucket-assets</text>
291
+ <text x="254" y="440" fill="#4f5d75" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle">bucket-uploads</text>
292
+ <text x="254" y="466" fill="#bf4520" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">OAI PROTECTED</text>
293
+
294
+ <!-- ── Security group boundary ───────────────────────────────── -->
295
+ <rect x="348" y="264" width="120" height="80" rx="6" fill="transparent" stroke="rgba(191,69,32,0.45)" stroke-width="1" stroke-dasharray="4,4"/>
296
+ <text x="356" y="278" fill="rgba(191,69,32,0.7)" font-size="8" font-family="'Geist Mono', monospace" letter-spacing="0.08em">SG · :443</text>
297
+
298
+ <!-- ── Load Balancer (inside security group) ──────────────────── -->
299
+ <rect x="358" y="282" width="100" height="54" rx="6" fill="#f5f5f5"/>
300
+ <rect x="358" y="282" width="100" height="54" rx="6" fill="rgba(45,49,66,0.03)" stroke="rgba(45,49,66,0.30)" stroke-width="1"/>
301
+ <rect x="366" y="288" width="22" height="12" rx="2" fill="transparent" stroke="rgba(45,49,66,0.22)" stroke-width="0.8"/>
302
+ <text x="377" y="297" fill="#5a6580" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.06em">LB</text>
303
+ <text x="408" y="311" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Load Balancer</text>
304
+ <text x="408" y="326" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">HTTPS :443</text>
305
+
306
+ <!-- ── Backend / API ─────────────────────────────────────────── -->
307
+ <rect x="508" y="278" width="112" height="54" rx="6" fill="#f5f5f5"/>
308
+ <rect x="508" y="278" width="112" height="54" rx="6" fill="#ffffff" stroke="#2d3142" stroke-width="1"/>
309
+ <rect x="516" y="284" width="26" height="12" rx="2" fill="transparent" stroke="rgba(45,49,66,0.40)" stroke-width="0.8"/>
310
+ <text x="529" y="293" fill="#2d3142" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">API</text>
311
+ <text x="564" y="308" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">API Server</text>
312
+ <text x="564" y="323" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">FastAPI :8000</text>
313
+
314
+ <!-- ── Database ───────────────────────────────────────────────── -->
315
+ <rect x="698" y="278" width="120" height="54" rx="6" fill="#f5f5f5"/>
316
+ <rect x="698" y="278" width="120" height="54" rx="6" fill="rgba(45,49,66,0.05)" stroke="#4f5d75" stroke-width="1"/>
317
+ <rect x="706" y="284" width="22" height="12" rx="2" fill="transparent" stroke="rgba(79,93,117,0.50)" stroke-width="0.8"/>
318
+ <text x="717" y="293" fill="#4f5d75" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">DB</text>
319
+ <text x="758" y="308" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Database</text>
320
+ <text x="758" y="323" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">PostgreSQL</text>
321
+
322
+ <!-- ── Frontend / UI ─────────────────────────────────────────── -->
323
+ <rect x="198" y="518" width="200" height="112" rx="6" fill="#f5f5f5"/>
324
+ <rect x="198" y="518" width="200" height="112" rx="6" fill="rgba(191,69,32,0.08)" stroke="#bf4520" stroke-width="1"/>
325
+ <rect x="206" y="524" width="22" height="12" rx="2" fill="transparent" stroke="rgba(191,69,32,0.50)" stroke-width="0.8"/>
326
+ <text x="217" y="533" fill="#bf4520" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">UI</text>
327
+ <text x="298" y="550" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Web App</text>
328
+ <text x="298" y="567" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">React + TypeScript</text>
329
+ <text x="298" y="581" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">Astro SSG</text>
330
+ <!-- Link-blue URL label -->
331
+ <text x="298" y="614" fill="#2e5aa8" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.04em">app.example.com</text>
332
+
333
+
334
+ <!-- =================================================================
335
+ LEGEND — OUTSIDE all boundary boxes.
336
+ Region boundary ends at y=662 → legend starts at y=682.
337
+ ================================================================= -->
338
+ <text x="510" y="544" fill="#2d3142" font-size="9" font-weight="500" font-family="'Geist Mono', monospace" letter-spacing="0.12em">LEGEND</text>
339
+
340
+ <rect x="510" y="558" width="14" height="10" rx="2" fill="rgba(191,69,32,0.08)" stroke="#bf4520" stroke-width="1"/>
341
+ <text x="530" y="567" fill="#4f5d75" font-size="9" font-family="'Geist', sans-serif">Frontend / UI</text>
342
+
343
+ <rect x="510" y="576" width="14" height="10" rx="2" fill="#ffffff" stroke="#2d3142" stroke-width="1"/>
344
+ <text x="530" y="585" fill="#4f5d75" font-size="9" font-family="'Geist', sans-serif">Backend / API</text>
345
+
346
+ <rect x="510" y="594" width="14" height="10" rx="2" fill="rgba(45,49,66,0.03)" stroke="rgba(45,49,66,0.30)" stroke-width="1"/>
347
+ <text x="530" y="603" fill="#4f5d75" font-size="9" font-family="'Geist', sans-serif">Cloud / Service</text>
348
+
349
+ <rect x="510" y="612" width="14" height="10" rx="2" fill="rgba(45,49,66,0.05)" stroke="#4f5d75" stroke-width="1"/>
350
+ <text x="530" y="621" fill="#4f5d75" font-size="9" font-family="'Geist', sans-serif">Database</text>
351
+
352
+ <rect x="510" y="630" width="14" height="10" rx="2" fill="rgba(79,93,117,0.10)" stroke="#5a6580" stroke-width="1"/>
353
+ <text x="530" y="639" fill="#4f5d75" font-size="9" font-family="'Geist', sans-serif">External / User</text>
354
+
355
+ <!-- Arrow types -->
356
+ <line x1="510" y1="655" x2="524" y2="655" stroke="#2e5aa8" stroke-width="1.2" marker-end="url(#arrow-link)"/>
357
+ <text x="530" y="659" fill="#4f5d75" font-size="9" font-family="'Geist', sans-serif">HTTP / API call</text>
358
+
359
+ <line x1="510" y1="671" x2="524" y2="671" stroke="#bf4520" stroke-width="1.2" stroke-dasharray="4,3" marker-end="url(#arrow-accent)"/>
360
+ <text x="530" y="675" fill="#4f5d75" font-size="9" font-family="'Geist', sans-serif">Auth flow</text>
361
+
362
+ <line x1="510" y1="687" x2="524" y2="687" stroke="#4f5d75" stroke-width="1.2" marker-end="url(#arrow)"/>
363
+ <text x="530" y="691" fill="#4f5d75" font-size="9" font-family="'Geist', sans-serif">Internal connection</text>
364
+
365
+ <rect x="510" y="698" width="14" height="10" rx="2" fill="transparent" stroke="rgba(191,69,32,0.45)" stroke-width="1" stroke-dasharray="3,3"/>
366
+ <text x="530" y="707" fill="#4f5d75" font-size="9" font-family="'Geist', sans-serif">Security group</text>
367
+
368
+ </svg>
369
+ </div>
370
+
371
+ <!-- Info Cards -->
372
+ <div class="cards">
373
+ <div class="card">
374
+ <div class="card-header">
375
+ <span class="card-dot coral"></span>
376
+ <h3>Card Title 1</h3>
377
+ </div>
378
+ <ul>
379
+ <li>Item one</li>
380
+ <li>Item two</li>
381
+ <li>Item three</li>
382
+ <li>Item four</li>
383
+ </ul>
384
+ </div>
385
+
386
+ <div class="card">
387
+ <div class="card-header">
388
+ <span class="card-dot ink"></span>
389
+ <h3>Card Title 2</h3>
390
+ </div>
391
+ <ul>
392
+ <li>Item one</li>
393
+ <li>Item two</li>
394
+ <li>Item three</li>
395
+ <li>Item four</li>
396
+ </ul>
397
+ </div>
398
+
399
+ <div class="card">
400
+ <div class="card-header">
401
+ <span class="card-dot muted"></span>
402
+ <h3>Card Title 3</h3>
403
+ </div>
404
+ <ul>
405
+ <li>Item one</li>
406
+ <li>Item two</li>
407
+ <li>Item three</li>
408
+ <li>Item four</li>
409
+ </ul>
410
+ </div>
411
+ </div>
412
+
413
+ <!-- Footer -->
414
+ <div class="footer">
415
+ <span>[Project Name] · Architecture Overview</span>
416
+ <span>[Date]</span>
417
+ </div>
418
+
419
+ </div>
420
+ </body>
421
+ </html>