@polymorphism-tech/morph-spec 8.29.0 → 8.31.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 (170) hide show
  1. package/CLAUDE.md +6 -1
  2. package/README.md +13 -2
  3. package/bin/morph-spec.js +48 -0
  4. package/bin/validate.js +379 -379
  5. package/claude-plugin.json +1 -1
  6. package/docs/CHEATSHEET.md +1 -1
  7. package/docs/QUICKSTART.md +1 -1
  8. package/framework/CLAUDE.md +2 -0
  9. package/framework/MORPH.md +2 -1
  10. package/framework/agents.json +6 -6
  11. package/framework/commands/morph-status.md +1 -1
  12. package/framework/docs/CLI.md +18 -0
  13. package/framework/evals/rubrics/code-quality.md +17 -0
  14. package/framework/evals/rubrics/condensed.md +3 -1
  15. package/framework/hooks/claude-code/statusline.sh +11 -11
  16. package/framework/hooks/git/commit-msg/conventional-commits.sh +33 -33
  17. package/framework/hooks/git/pre-commit/agents.sh +25 -25
  18. package/framework/hooks/git/pre-commit/orchestrator.sh +64 -64
  19. package/framework/hooks/git/pre-commit/specs.sh +50 -50
  20. package/framework/hooks/git/pre-push/run-tests.sh +44 -44
  21. package/framework/hooks/shared/phase-utils.js +2 -0
  22. package/framework/hooks/shared/stdin-reader.js +26 -26
  23. package/framework/mcp/registry.json +39 -4
  24. package/framework/rubrics/backend.json +2 -2
  25. package/framework/rubrics/default.json +2 -2
  26. package/framework/rubrics/frontend.json +2 -2
  27. package/framework/schemas/tasks.schema.json +25 -0
  28. package/framework/skills/core/create-umbraco-lp/SKILL.md +1 -1
  29. package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md +1 -1
  30. package/framework/skills/core/morph-apply/SKILL.md +12 -3
  31. package/framework/skills/core/morph-brainstorming/SKILL.md +1 -1
  32. package/framework/skills/core/morph-eval/SKILL.md +1 -1
  33. package/framework/skills/core/morph-hotfix/SKILL.md +1 -1
  34. package/framework/skills/core/morph-implement/SKILL.md +12 -2
  35. package/framework/skills/core/morph-plan/SKILL.md +45 -3
  36. package/framework/skills/core/morph-proposal/SKILL.md +1 -1
  37. package/framework/skills/core/morph-review/SKILL.md +11 -3
  38. package/framework/skills/core/morph-stack-scan/SKILL.md +13 -1
  39. package/framework/skills/core/morph-standards/SKILL.md +1 -1
  40. package/framework/skills/core/morph-uiux/SKILL.md +1 -1
  41. package/framework/standards/ai-agents/agent-session.md +160 -160
  42. package/framework/standards/ai-agents/batching.md +193 -193
  43. package/framework/standards/ai-agents/context-providers.md +188 -188
  44. package/framework/standards/ai-agents/mcp-server.md +250 -250
  45. package/framework/standards/ai-agents/mcp-tools.md +197 -197
  46. package/framework/standards/ai-agents/middleware-patterns.md +207 -207
  47. package/framework/standards/ai-agents/modalities-image-gen.md +173 -173
  48. package/framework/standards/ai-agents/modalities-speech-to-text.md +171 -171
  49. package/framework/standards/ai-agents/modalities-text-to-speech.md +181 -181
  50. package/framework/standards/ai-agents/modalities-vision.md +201 -201
  51. package/framework/standards/ai-agents/multi-agent-patterns.md +155 -155
  52. package/framework/standards/ai-agents/production.md +231 -231
  53. package/framework/standards/ai-agents/prompts-in-db.md +214 -214
  54. package/framework/standards/ai-agents/providers/model-registry.md +158 -158
  55. package/framework/standards/ai-agents/service-tier-flex.md +135 -135
  56. package/framework/standards/ai-agents/structured-output.md +249 -249
  57. package/framework/standards/ai-agents/sweet-spot.md +109 -109
  58. package/framework/templates/.idea/morph-templates.xml +92 -0
  59. package/framework/templates/.vscode/morph-templates.code-snippets +186 -0
  60. package/framework/templates/IDE-SNIPPETS.md +262 -262
  61. package/framework/templates/code/dotnet/abstractions/api-endpoint.cs +7 -7
  62. package/framework/templates/code/dotnet/ai-agents/AgentBootstrap.cs.template +39 -39
  63. package/framework/templates/code/dotnet/ai-agents/EmbeddingService.cs.template +68 -68
  64. package/framework/templates/code/dotnet/ai-agents/ModelRegistry.cs.template +117 -117
  65. package/framework/templates/code/dotnet/ai-agents/PromptRepository.cs.template +95 -95
  66. package/framework/templates/code/dotnet/ai-agents/ResilientToolMiddleware.cs.template +61 -61
  67. package/framework/templates/code/dotnet/ai-agents/VectorSearchTool.cs.template +107 -107
  68. package/framework/templates/code/dotnet/ai-agents/model-registry.json.template +58 -58
  69. package/framework/templates/code/dotnet/contracts/contracts-vsa.cs +281 -281
  70. package/framework/templates/code/dotnet/database/migration.cs +83 -83
  71. package/framework/templates/code/dotnet/feature/endpoint.cs.hbs +21 -21
  72. package/framework/templates/code/dotnet/feature/request.cs.hbs +4 -4
  73. package/framework/templates/code/dotnet/feature/response.cs.hbs +4 -4
  74. package/framework/templates/code/dotnet/feature/validator.cs.hbs +15 -15
  75. package/framework/templates/code/sql/ai-agents/agent-prompts-migration.sql.template +58 -58
  76. package/framework/templates/code/sql/ai-agents/pgvector-embeddings-migration.sql.template +91 -91
  77. package/framework/templates/code/typescript/contracts.ts +167 -167
  78. package/framework/templates/context/ARCHITECTURE.md +20 -0
  79. package/framework/templates/docs/clarifications.md +253 -253
  80. package/framework/templates/docs/schema-analysis.md +119 -119
  81. package/framework/templates/docs/ui-components.md +52 -52
  82. package/framework/templates/docs/ui-design-system.md +76 -76
  83. package/framework/templates/docs/ui-flows.md +167 -167
  84. package/framework/templates/docs/ui-mockups.md +98 -98
  85. package/framework/templates/feature/decisions.md +122 -122
  86. package/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +43 -43
  87. package/framework/templates/frontend/nextjs/client-component.tsx.hbs +26 -26
  88. package/framework/templates/frontend/nextjs/env.mjs.hbs +32 -32
  89. package/framework/templates/frontend/nextjs/feature-form.tsx.hbs +56 -56
  90. package/framework/templates/frontend/nextjs/page.tsx.hbs +22 -22
  91. package/framework/templates/frontend/nextjs/tsconfig.json.hbs +26 -26
  92. package/framework/templates/frontend/nextjs/use-feature.ts.hbs +54 -54
  93. package/framework/templates/infrastructure/docker/Dockerfile.template +58 -58
  94. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  95. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  96. package/framework/templates/infrastructure/github/README.md +56 -56
  97. package/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +45 -45
  98. package/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +27 -27
  99. package/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +59 -59
  100. package/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +39 -39
  101. package/framework/templates/integrations/asaas-client.cs +387 -387
  102. package/framework/templates/integrations/asaas-webhook.cs +351 -351
  103. package/framework/templates/meta-prompts/fusion/fusion-agent.md +76 -76
  104. package/framework/templates/meta-prompts/fusion/fusion-aggregator.md +100 -100
  105. package/framework/templates/meta-prompts/validators/pre-commit-validator.md +95 -95
  106. package/framework/templates/project/validate.js +120 -120
  107. package/framework/templates/state.template.json +17 -17
  108. package/framework/templates/ui/design-system.css +226 -226
  109. package/package.json +1 -1
  110. package/src/commands/dashboard/dashboard.js +53 -53
  111. package/src/commands/graph/affected.js +89 -0
  112. package/src/commands/graph/build.js +94 -0
  113. package/src/commands/graph/explain.js +96 -0
  114. package/src/commands/graph/status.js +93 -0
  115. package/src/commands/index.js +13 -13
  116. package/src/commands/project/checkpoint.js +209 -209
  117. package/src/commands/project/doctor.js +11 -0
  118. package/src/core/paths/output-schema.js +7 -0
  119. package/src/core/state/phase-state-machine.js +197 -197
  120. package/src/core/templates/template-renderer.js +477 -477
  121. package/src/dashboard/app/components/DetailPanel.jsx +11 -11
  122. package/src/dashboard/app/components/FlowGraph.jsx +17 -17
  123. package/src/dashboard/app/components/SearchFilter.jsx +22 -22
  124. package/src/dashboard/app/hooks/useDetailPanel.js +15 -15
  125. package/src/dashboard/app/main.jsx +13 -13
  126. package/src/dashboard/app/pages/AgentMap.jsx +370 -370
  127. package/src/dashboard/app/pages/HookInspector.jsx +418 -418
  128. package/src/dashboard/app/pages/PhasePipeline.jsx +408 -408
  129. package/src/dashboard/app/pages/RulesMap.jsx +273 -273
  130. package/src/dashboard/app/pages/SkillsLibrary.jsx +366 -366
  131. package/src/dashboard/app/pages/Standards.jsx +332 -332
  132. package/src/dashboard/app/styles/index.css +47 -47
  133. package/src/dashboard/index.html +12 -12
  134. package/src/dashboard/package.json +24 -24
  135. package/src/dashboard/scanner/phases-scanner.js +15 -15
  136. package/src/dashboard/scanner/rubrics-scanner.js +12 -12
  137. package/src/dashboard/scanner/rules-scanner.js +37 -37
  138. package/src/dashboard/scanner/skills-scanner.js +43 -43
  139. package/src/dashboard/scanner/squads-scanner.js +13 -13
  140. package/src/dashboard/vite-plugin-morph-data.js +17 -17
  141. package/src/dashboard/vite.config.js +24 -24
  142. package/src/lib/detectors/design-system-detector.js +188 -188
  143. package/src/lib/detectors/index.js +217 -217
  144. package/src/lib/generators/architecture-scanner.js +45 -4
  145. package/src/lib/generators/design-system-generator.js +508 -508
  146. package/src/lib/generators/settings-generator.js +209 -209
  147. package/src/lib/graph/god-nodes.js +75 -0
  148. package/src/lib/graph/graph-health.js +61 -0
  149. package/src/lib/graph/graph-loader.js +86 -0
  150. package/src/lib/graph/graphify-runtime.js +100 -0
  151. package/src/lib/graph/graphifyignore.js +86 -0
  152. package/src/lib/graph/sanitize.js +280 -0
  153. package/src/lib/hooks/hook-executor.js +167 -167
  154. package/src/lib/installers/mcp-installer.js +719 -719
  155. package/src/lib/tasks/task-classifier.js +30 -30
  156. package/src/lib/tasks/task-parser.js +209 -209
  157. package/src/lib/tasks/tasks-json-parser.js +26 -0
  158. package/src/lib/validators/checkpoint-persistence.js +39 -39
  159. package/src/lib/validators/css/css-validator.js +340 -340
  160. package/src/lib/validators/reuse/index.js +10 -0
  161. package/src/lib/validators/reuse/reuse-validator.js +324 -0
  162. package/src/lib/validators/reuse/symbol-scanner.js +144 -0
  163. package/src/lib/validators/shared/emit-validator-dispatch.js +14 -14
  164. package/src/lib/validators/shared/issue-counter.js +14 -14
  165. package/src/lib/validators/validation-runner.js +40 -1
  166. package/src/scripts/setup-infra.js +60 -1
  167. package/src/utils/agent-id-mapper.js +11 -11
  168. package/src/utils/claude-settings-manager.js +300 -300
  169. package/src/utils/file-copier.js +40 -0
  170. package/src/utils/skills-installer.js +187 -187
@@ -1,332 +1,332 @@
1
- import { useState, useMemo, useCallback } from 'react';
2
- import { Handle, Position } from '@xyflow/react';
3
- import morphData from 'virtual:morph-data';
4
- import FlowGraph from '../components/FlowGraph.jsx';
5
- import DetailPanel from '../components/DetailPanel.jsx';
6
- import SearchFilter from '../components/SearchFilter.jsx';
7
- import { useDetailPanel } from '../hooks/useDetailPanel.js';
8
-
9
- // ─── Category Color Palette ───────────────────────────────────────────────────
10
-
11
- const CATEGORY_COLORS = {
12
- 'ai-agents': '#34d399',
13
- 'architecture': '#f97316',
14
- 'backend': '#3b82f6',
15
- 'data': '#8b5cf6',
16
- 'frontend': '#f472b6',
17
- 'infrastructure': '#fbbf24',
18
- 'integration': '#06b6d4',
19
- };
20
-
21
- const CATEGORY_BG = {
22
- 'ai-agents': '#064e3b',
23
- 'architecture': '#431407',
24
- 'backend': '#1e3a5f',
25
- 'data': '#2e1065',
26
- 'frontend': '#500724',
27
- 'infrastructure': '#451a03',
28
- 'integration': '#083344',
29
- };
30
-
31
- function getCategoryColor(category) {
32
- return CATEGORY_COLORS[category] || '#94a3b8';
33
- }
34
- function getCategoryBg(category) {
35
- return CATEGORY_BG[category] || '#1e293b';
36
- }
37
-
38
- // ─── Node Components ──────────────────────────────────────────────────────────
39
-
40
- function StandardNode({ data }) {
41
- const color = getCategoryColor(data.category);
42
- const bg = getCategoryBg(data.category);
43
- return (
44
- <div
45
- className="rounded-lg px-3 py-2 min-w-[160px] max-w-[190px] cursor-pointer select-none"
46
- style={{
47
- background: bg,
48
- border: `1.5px solid ${data.dimmed ? bg : color}`,
49
- boxShadow: data.dimmed ? 'none' : `0 0 8px ${color}33`,
50
- opacity: data.dimmed ? 0.25 : 1,
51
- }}
52
- >
53
- <Handle type="target" position={Position.Left} style={{ background: color, width: 7, height: 7 }} />
54
- <Handle type="source" position={Position.Right} style={{ background: color, width: 7, height: 7 }} />
55
- <div className="text-white text-xs font-semibold leading-tight truncate" title={data.label}>
56
- {data.label}
57
- </div>
58
- <div className="text-[10px] mt-0.5 font-mono truncate" style={{ color }}>
59
- {data.category}
60
- {data.subcategory ? ` / ${data.subcategory}` : ''}
61
- </div>
62
- </div>
63
- );
64
- }
65
-
66
- function AgentRefNode({ data }) {
67
- return (
68
- <div
69
- className="rounded px-2 py-1 select-none cursor-default"
70
- style={{
71
- background: '#1e293b',
72
- border: '1px solid #334155',
73
- opacity: data.dimmed ? 0.2 : 1,
74
- }}
75
- >
76
- <Handle type="source" position={Position.Right} style={{ background: '#475569', width: 6, height: 6 }} />
77
- <div className="text-gray-400 text-[10px] font-mono truncate max-w-[110px]" title={data.label}>
78
- {data.label}
79
- </div>
80
- </div>
81
- );
82
- }
83
-
84
- const nodeTypes = { standardNode: StandardNode, agentRefNode: AgentRefNode };
85
-
86
- // ─── Graph Builder ────────────────────────────────────────────────────────────
87
-
88
- function buildGraph(standards, search, categoryFilter) {
89
- const nodes = [];
90
- const edges = [];
91
-
92
- const filtered = standards.filter((s) => {
93
- const q = search.toLowerCase();
94
- const matchSearch = !q || s.name.toLowerCase().includes(q) || s.id.toLowerCase().includes(q) || s.category.toLowerCase().includes(q);
95
- const matchCat = !categoryFilter || s.category === categoryFilter;
96
- return matchSearch && matchCat;
97
- });
98
- const filteredIds = new Set(filtered.map((s) => s.id));
99
- const hasFilter = search || categoryFilter;
100
-
101
- // Group by category
102
- const byCategory = {};
103
- for (const std of standards) {
104
- if (!byCategory[std.category]) byCategory[std.category] = [];
105
- byCategory[std.category].push(std);
106
- }
107
-
108
- const STD_X = 180;
109
- const AGENT_X = 0;
110
- const ROW_H = 75;
111
- const CAT_GAP = 40;
112
-
113
- let globalY = 0;
114
-
115
- // Track all agent refs that need separate nodes
116
- const agentNodeMap = {}; // agentId → { x, y }
117
- const agentYTracker = {};
118
-
119
- for (const [cat, catStandards] of Object.entries(byCategory)) {
120
- catStandards.forEach((std, i) => {
121
- const isDimmed = hasFilter && !filteredIds.has(std.id);
122
- nodes.push({
123
- id: `std-${std.id}`,
124
- type: 'standardNode',
125
- position: { x: STD_X, y: globalY + i * ROW_H },
126
- data: {
127
- label: std.name,
128
- category: std.category,
129
- subcategory: std.subcategory,
130
- stdRef: std,
131
- dimmed: isDimmed,
132
- },
133
- });
134
-
135
- // Agent ref nodes on the left
136
- std.referencedBy.forEach((ref, j) => {
137
- const agentNodeId = `agent-${ref.agentId}`;
138
- if (!agentNodeMap[agentNodeId]) {
139
- const ay = agentYTracker[ref.agentId] ?? globalY + i * ROW_H;
140
- agentYTracker[ref.agentId] = ay + 55;
141
- agentNodeMap[agentNodeId] = { x: AGENT_X, y: ay };
142
- nodes.push({
143
- id: agentNodeId,
144
- type: 'agentRefNode',
145
- position: { x: AGENT_X, y: ay },
146
- data: { label: ref.agentId, dimmed: isDimmed },
147
- });
148
- }
149
- const edgeLabel = [ref.scope, ref.priority].filter(Boolean).join('/');
150
- edges.push({
151
- id: `edge-${ref.agentId}-${std.id}-${j}`,
152
- source: agentNodeId,
153
- target: `std-${std.id}`,
154
- type: 'smoothstep',
155
- label: edgeLabel || undefined,
156
- labelStyle: { fill: '#64748b', fontSize: 9 },
157
- labelBgStyle: { fill: '#0f172a', fillOpacity: 0.85 },
158
- style: {
159
- stroke: isDimmed ? '#1e293b' : getCategoryColor(std.category),
160
- strokeWidth: 1,
161
- opacity: isDimmed ? 0.15 : 0.4,
162
- },
163
- });
164
- });
165
- });
166
-
167
- globalY += catStandards.length * ROW_H + CAT_GAP;
168
- }
169
-
170
- return { nodes, edges };
171
- }
172
-
173
- // ─── Detail Content ───────────────────────────────────────────────────────────
174
-
175
- function StandardDetail({ std }) {
176
- const [showContent, setShowContent] = useState(false);
177
- const color = getCategoryColor(std.category);
178
-
179
- return (
180
- <div className="text-sm text-gray-200 space-y-4">
181
- <div>
182
- <p className="text-gray-400 text-xs">ID: <span className="font-mono text-gray-300">{std.id}</span></p>
183
- <p className="text-gray-400 text-xs mt-0.5">Path: <span className="font-mono text-gray-300">{std.path}</span></p>
184
- </div>
185
-
186
- <div className="flex flex-wrap gap-1">
187
- <span className="px-2 py-0.5 rounded text-xs font-bold" style={{ background: getCategoryBg(std.category), color, border: `1px solid ${color}` }}>
188
- {std.category}
189
- </span>
190
- {std.subcategory && (
191
- <span className="px-2 py-0.5 rounded text-xs bg-gray-800 border border-gray-700 text-gray-400">
192
- {std.subcategory}
193
- </span>
194
- )}
195
- </div>
196
-
197
- {std.digest && (
198
- <div>
199
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Digest</p>
200
- <p className="text-gray-300 text-xs leading-relaxed">{std.digest}</p>
201
- </div>
202
- )}
203
-
204
- {std.tags?.length > 0 && (
205
- <div>
206
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Tags</p>
207
- <div className="flex flex-wrap gap-1">
208
- {std.tags.map((t) => (
209
- <span key={t} className="px-1.5 py-0.5 bg-gray-800 border border-gray-700 rounded text-xs text-gray-400">{t}</span>
210
- ))}
211
- </div>
212
- </div>
213
- )}
214
-
215
- {std.stacks?.length > 0 && (
216
- <div>
217
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Stacks</p>
218
- <div className="flex flex-wrap gap-1">
219
- {std.stacks.map((s) => (
220
- <span key={s} className="px-2 py-0.5 bg-green-900/50 border border-green-700 rounded text-xs text-green-300">{s}</span>
221
- ))}
222
- </div>
223
- </div>
224
- )}
225
-
226
- {std.referencedBy?.length > 0 && (
227
- <div>
228
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Referenced By ({std.referencedBy.length})</p>
229
- <div className="space-y-1">
230
- {std.referencedBy.map((ref, i) => (
231
- <div key={i} className="flex items-center justify-between text-xs px-2 py-1 bg-gray-800 rounded">
232
- <span className="font-mono text-gray-300 truncate">{ref.agentId}</span>
233
- <div className="flex gap-1 ml-2 flex-shrink-0">
234
- {ref.scope && <span className="px-1.5 py-0.5 bg-gray-700 rounded text-gray-400">{ref.scope}</span>}
235
- {ref.priority && <span className="px-1.5 py-0.5 bg-gray-700 rounded text-gray-400">{ref.priority}</span>}
236
- </div>
237
- </div>
238
- ))}
239
- </div>
240
- </div>
241
- )}
242
-
243
- <div>
244
- <button
245
- onClick={() => setShowContent((v) => !v)}
246
- className="w-full text-left px-3 py-1.5 bg-gray-800 hover:bg-gray-700 border border-gray-700 rounded text-xs text-gray-300 transition-colors"
247
- >
248
- {showContent ? 'Hide Content' : 'Show Full Content'}
249
- </button>
250
- {showContent && (
251
- <pre className="mt-2 p-3 bg-gray-950 border border-gray-800 rounded text-[9px] text-gray-400 overflow-x-auto whitespace-pre-wrap font-mono leading-relaxed max-h-64 overflow-y-auto">
252
- {std.content}
253
- </pre>
254
- )}
255
- </div>
256
- </div>
257
- );
258
- }
259
-
260
- // ─── Main Page ────────────────────────────────────────────────────────────────
261
-
262
- export default function Standards() {
263
- const { standards } = morphData;
264
- const [search, setSearch] = useState('');
265
- const [categoryFilter, setCategoryFilter] = useState('');
266
- const { panel, openPanel, closePanel } = useDetailPanel();
267
-
268
- const allCategories = useMemo(
269
- () => [...new Set(standards.list.map((s) => s.category))].sort(),
270
- [standards.list]
271
- );
272
-
273
- const { nodes, edges } = useMemo(
274
- () => buildGraph(standards.list, search, categoryFilter),
275
- [standards.list, search, categoryFilter]
276
- );
277
-
278
- const handleNodeClick = useCallback(
279
- (_event, node) => {
280
- if (node.type === 'standardNode') {
281
- const std = node.data.stdRef;
282
- if (std) openPanel(std.name, <StandardDetail std={std} />);
283
- }
284
- },
285
- [openPanel]
286
- );
287
-
288
- const filterConfig = [
289
- { name: 'category', label: 'Category', options: allCategories, value: categoryFilter },
290
- ];
291
-
292
- return (
293
- <div className="flex flex-col h-full">
294
- <SearchFilter
295
- placeholder="Search standards by name, ID, or category..."
296
- filters={filterConfig}
297
- onSearchChange={setSearch}
298
- onFilterChange={(name, value) => {
299
- if (name === 'category') setCategoryFilter(value);
300
- }}
301
- />
302
-
303
- <div className="flex-1 relative">
304
- <FlowGraph
305
- nodes={nodes}
306
- edges={edges}
307
- nodeTypes={nodeTypes}
308
- onNodeClick={handleNodeClick}
309
- fitView
310
- />
311
-
312
- <div className="absolute top-3 left-3 bg-gray-900/90 border border-gray-700 rounded-lg p-3 text-xs space-y-1.5 z-10">
313
- <p className="text-gray-400 font-semibold uppercase tracking-wide text-[10px] mb-2">Categories</p>
314
- {Object.entries(CATEGORY_COLORS).map(([cat, color]) => (
315
- <div key={cat} className="flex items-center gap-2">
316
- <span className="inline-block w-3 h-3 rounded-sm flex-shrink-0" style={{ background: getCategoryBg(cat), border: `1px solid ${color}` }} />
317
- <span className="text-gray-300">{cat}</span>
318
- </div>
319
- ))}
320
- </div>
321
-
322
- <div className="absolute top-3 right-3 bg-gray-900/90 border border-gray-700 rounded-lg px-3 py-1.5 text-xs text-gray-400 z-10">
323
- {standards.list.length} standards · v{standards.version}
324
- </div>
325
- </div>
326
-
327
- <DetailPanel open={panel.open} title={panel.title} onClose={closePanel}>
328
- {panel.content}
329
- </DetailPanel>
330
- </div>
331
- );
332
- }
1
+ import { useState, useMemo, useCallback } from 'react';
2
+ import { Handle, Position } from '@xyflow/react';
3
+ import morphData from 'virtual:morph-data';
4
+ import FlowGraph from '../components/FlowGraph.jsx';
5
+ import DetailPanel from '../components/DetailPanel.jsx';
6
+ import SearchFilter from '../components/SearchFilter.jsx';
7
+ import { useDetailPanel } from '../hooks/useDetailPanel.js';
8
+
9
+ // ─── Category Color Palette ───────────────────────────────────────────────────
10
+
11
+ const CATEGORY_COLORS = {
12
+ 'ai-agents': '#34d399',
13
+ 'architecture': '#f97316',
14
+ 'backend': '#3b82f6',
15
+ 'data': '#8b5cf6',
16
+ 'frontend': '#f472b6',
17
+ 'infrastructure': '#fbbf24',
18
+ 'integration': '#06b6d4',
19
+ };
20
+
21
+ const CATEGORY_BG = {
22
+ 'ai-agents': '#064e3b',
23
+ 'architecture': '#431407',
24
+ 'backend': '#1e3a5f',
25
+ 'data': '#2e1065',
26
+ 'frontend': '#500724',
27
+ 'infrastructure': '#451a03',
28
+ 'integration': '#083344',
29
+ };
30
+
31
+ function getCategoryColor(category) {
32
+ return CATEGORY_COLORS[category] || '#94a3b8';
33
+ }
34
+ function getCategoryBg(category) {
35
+ return CATEGORY_BG[category] || '#1e293b';
36
+ }
37
+
38
+ // ─── Node Components ──────────────────────────────────────────────────────────
39
+
40
+ function StandardNode({ data }) {
41
+ const color = getCategoryColor(data.category);
42
+ const bg = getCategoryBg(data.category);
43
+ return (
44
+ <div
45
+ className="rounded-lg px-3 py-2 min-w-[160px] max-w-[190px] cursor-pointer select-none"
46
+ style={{
47
+ background: bg,
48
+ border: `1.5px solid ${data.dimmed ? bg : color}`,
49
+ boxShadow: data.dimmed ? 'none' : `0 0 8px ${color}33`,
50
+ opacity: data.dimmed ? 0.25 : 1,
51
+ }}
52
+ >
53
+ <Handle type="target" position={Position.Left} style={{ background: color, width: 7, height: 7 }} />
54
+ <Handle type="source" position={Position.Right} style={{ background: color, width: 7, height: 7 }} />
55
+ <div className="text-white text-xs font-semibold leading-tight truncate" title={data.label}>
56
+ {data.label}
57
+ </div>
58
+ <div className="text-[10px] mt-0.5 font-mono truncate" style={{ color }}>
59
+ {data.category}
60
+ {data.subcategory ? ` / ${data.subcategory}` : ''}
61
+ </div>
62
+ </div>
63
+ );
64
+ }
65
+
66
+ function AgentRefNode({ data }) {
67
+ return (
68
+ <div
69
+ className="rounded px-2 py-1 select-none cursor-default"
70
+ style={{
71
+ background: '#1e293b',
72
+ border: '1px solid #334155',
73
+ opacity: data.dimmed ? 0.2 : 1,
74
+ }}
75
+ >
76
+ <Handle type="source" position={Position.Right} style={{ background: '#475569', width: 6, height: 6 }} />
77
+ <div className="text-gray-400 text-[10px] font-mono truncate max-w-[110px]" title={data.label}>
78
+ {data.label}
79
+ </div>
80
+ </div>
81
+ );
82
+ }
83
+
84
+ const nodeTypes = { standardNode: StandardNode, agentRefNode: AgentRefNode };
85
+
86
+ // ─── Graph Builder ────────────────────────────────────────────────────────────
87
+
88
+ function buildGraph(standards, search, categoryFilter) {
89
+ const nodes = [];
90
+ const edges = [];
91
+
92
+ const filtered = standards.filter((s) => {
93
+ const q = search.toLowerCase();
94
+ const matchSearch = !q || s.name.toLowerCase().includes(q) || s.id.toLowerCase().includes(q) || s.category.toLowerCase().includes(q);
95
+ const matchCat = !categoryFilter || s.category === categoryFilter;
96
+ return matchSearch && matchCat;
97
+ });
98
+ const filteredIds = new Set(filtered.map((s) => s.id));
99
+ const hasFilter = search || categoryFilter;
100
+
101
+ // Group by category
102
+ const byCategory = {};
103
+ for (const std of standards) {
104
+ if (!byCategory[std.category]) byCategory[std.category] = [];
105
+ byCategory[std.category].push(std);
106
+ }
107
+
108
+ const STD_X = 180;
109
+ const AGENT_X = 0;
110
+ const ROW_H = 75;
111
+ const CAT_GAP = 40;
112
+
113
+ let globalY = 0;
114
+
115
+ // Track all agent refs that need separate nodes
116
+ const agentNodeMap = {}; // agentId → { x, y }
117
+ const agentYTracker = {};
118
+
119
+ for (const [cat, catStandards] of Object.entries(byCategory)) {
120
+ catStandards.forEach((std, i) => {
121
+ const isDimmed = hasFilter && !filteredIds.has(std.id);
122
+ nodes.push({
123
+ id: `std-${std.id}`,
124
+ type: 'standardNode',
125
+ position: { x: STD_X, y: globalY + i * ROW_H },
126
+ data: {
127
+ label: std.name,
128
+ category: std.category,
129
+ subcategory: std.subcategory,
130
+ stdRef: std,
131
+ dimmed: isDimmed,
132
+ },
133
+ });
134
+
135
+ // Agent ref nodes on the left
136
+ std.referencedBy.forEach((ref, j) => {
137
+ const agentNodeId = `agent-${ref.agentId}`;
138
+ if (!agentNodeMap[agentNodeId]) {
139
+ const ay = agentYTracker[ref.agentId] ?? globalY + i * ROW_H;
140
+ agentYTracker[ref.agentId] = ay + 55;
141
+ agentNodeMap[agentNodeId] = { x: AGENT_X, y: ay };
142
+ nodes.push({
143
+ id: agentNodeId,
144
+ type: 'agentRefNode',
145
+ position: { x: AGENT_X, y: ay },
146
+ data: { label: ref.agentId, dimmed: isDimmed },
147
+ });
148
+ }
149
+ const edgeLabel = [ref.scope, ref.priority].filter(Boolean).join('/');
150
+ edges.push({
151
+ id: `edge-${ref.agentId}-${std.id}-${j}`,
152
+ source: agentNodeId,
153
+ target: `std-${std.id}`,
154
+ type: 'smoothstep',
155
+ label: edgeLabel || undefined,
156
+ labelStyle: { fill: '#64748b', fontSize: 9 },
157
+ labelBgStyle: { fill: '#0f172a', fillOpacity: 0.85 },
158
+ style: {
159
+ stroke: isDimmed ? '#1e293b' : getCategoryColor(std.category),
160
+ strokeWidth: 1,
161
+ opacity: isDimmed ? 0.15 : 0.4,
162
+ },
163
+ });
164
+ });
165
+ });
166
+
167
+ globalY += catStandards.length * ROW_H + CAT_GAP;
168
+ }
169
+
170
+ return { nodes, edges };
171
+ }
172
+
173
+ // ─── Detail Content ───────────────────────────────────────────────────────────
174
+
175
+ function StandardDetail({ std }) {
176
+ const [showContent, setShowContent] = useState(false);
177
+ const color = getCategoryColor(std.category);
178
+
179
+ return (
180
+ <div className="text-sm text-gray-200 space-y-4">
181
+ <div>
182
+ <p className="text-gray-400 text-xs">ID: <span className="font-mono text-gray-300">{std.id}</span></p>
183
+ <p className="text-gray-400 text-xs mt-0.5">Path: <span className="font-mono text-gray-300">{std.path}</span></p>
184
+ </div>
185
+
186
+ <div className="flex flex-wrap gap-1">
187
+ <span className="px-2 py-0.5 rounded text-xs font-bold" style={{ background: getCategoryBg(std.category), color, border: `1px solid ${color}` }}>
188
+ {std.category}
189
+ </span>
190
+ {std.subcategory && (
191
+ <span className="px-2 py-0.5 rounded text-xs bg-gray-800 border border-gray-700 text-gray-400">
192
+ {std.subcategory}
193
+ </span>
194
+ )}
195
+ </div>
196
+
197
+ {std.digest && (
198
+ <div>
199
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Digest</p>
200
+ <p className="text-gray-300 text-xs leading-relaxed">{std.digest}</p>
201
+ </div>
202
+ )}
203
+
204
+ {std.tags?.length > 0 && (
205
+ <div>
206
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Tags</p>
207
+ <div className="flex flex-wrap gap-1">
208
+ {std.tags.map((t) => (
209
+ <span key={t} className="px-1.5 py-0.5 bg-gray-800 border border-gray-700 rounded text-xs text-gray-400">{t}</span>
210
+ ))}
211
+ </div>
212
+ </div>
213
+ )}
214
+
215
+ {std.stacks?.length > 0 && (
216
+ <div>
217
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Stacks</p>
218
+ <div className="flex flex-wrap gap-1">
219
+ {std.stacks.map((s) => (
220
+ <span key={s} className="px-2 py-0.5 bg-green-900/50 border border-green-700 rounded text-xs text-green-300">{s}</span>
221
+ ))}
222
+ </div>
223
+ </div>
224
+ )}
225
+
226
+ {std.referencedBy?.length > 0 && (
227
+ <div>
228
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Referenced By ({std.referencedBy.length})</p>
229
+ <div className="space-y-1">
230
+ {std.referencedBy.map((ref, i) => (
231
+ <div key={i} className="flex items-center justify-between text-xs px-2 py-1 bg-gray-800 rounded">
232
+ <span className="font-mono text-gray-300 truncate">{ref.agentId}</span>
233
+ <div className="flex gap-1 ml-2 flex-shrink-0">
234
+ {ref.scope && <span className="px-1.5 py-0.5 bg-gray-700 rounded text-gray-400">{ref.scope}</span>}
235
+ {ref.priority && <span className="px-1.5 py-0.5 bg-gray-700 rounded text-gray-400">{ref.priority}</span>}
236
+ </div>
237
+ </div>
238
+ ))}
239
+ </div>
240
+ </div>
241
+ )}
242
+
243
+ <div>
244
+ <button
245
+ onClick={() => setShowContent((v) => !v)}
246
+ className="w-full text-left px-3 py-1.5 bg-gray-800 hover:bg-gray-700 border border-gray-700 rounded text-xs text-gray-300 transition-colors"
247
+ >
248
+ {showContent ? 'Hide Content' : 'Show Full Content'}
249
+ </button>
250
+ {showContent && (
251
+ <pre className="mt-2 p-3 bg-gray-950 border border-gray-800 rounded text-[9px] text-gray-400 overflow-x-auto whitespace-pre-wrap font-mono leading-relaxed max-h-64 overflow-y-auto">
252
+ {std.content}
253
+ </pre>
254
+ )}
255
+ </div>
256
+ </div>
257
+ );
258
+ }
259
+
260
+ // ─── Main Page ────────────────────────────────────────────────────────────────
261
+
262
+ export default function Standards() {
263
+ const { standards } = morphData;
264
+ const [search, setSearch] = useState('');
265
+ const [categoryFilter, setCategoryFilter] = useState('');
266
+ const { panel, openPanel, closePanel } = useDetailPanel();
267
+
268
+ const allCategories = useMemo(
269
+ () => [...new Set(standards.list.map((s) => s.category))].sort(),
270
+ [standards.list]
271
+ );
272
+
273
+ const { nodes, edges } = useMemo(
274
+ () => buildGraph(standards.list, search, categoryFilter),
275
+ [standards.list, search, categoryFilter]
276
+ );
277
+
278
+ const handleNodeClick = useCallback(
279
+ (_event, node) => {
280
+ if (node.type === 'standardNode') {
281
+ const std = node.data.stdRef;
282
+ if (std) openPanel(std.name, <StandardDetail std={std} />);
283
+ }
284
+ },
285
+ [openPanel]
286
+ );
287
+
288
+ const filterConfig = [
289
+ { name: 'category', label: 'Category', options: allCategories, value: categoryFilter },
290
+ ];
291
+
292
+ return (
293
+ <div className="flex flex-col h-full">
294
+ <SearchFilter
295
+ placeholder="Search standards by name, ID, or category..."
296
+ filters={filterConfig}
297
+ onSearchChange={setSearch}
298
+ onFilterChange={(name, value) => {
299
+ if (name === 'category') setCategoryFilter(value);
300
+ }}
301
+ />
302
+
303
+ <div className="flex-1 relative">
304
+ <FlowGraph
305
+ nodes={nodes}
306
+ edges={edges}
307
+ nodeTypes={nodeTypes}
308
+ onNodeClick={handleNodeClick}
309
+ fitView
310
+ />
311
+
312
+ <div className="absolute top-3 left-3 bg-gray-900/90 border border-gray-700 rounded-lg p-3 text-xs space-y-1.5 z-10">
313
+ <p className="text-gray-400 font-semibold uppercase tracking-wide text-[10px] mb-2">Categories</p>
314
+ {Object.entries(CATEGORY_COLORS).map(([cat, color]) => (
315
+ <div key={cat} className="flex items-center gap-2">
316
+ <span className="inline-block w-3 h-3 rounded-sm flex-shrink-0" style={{ background: getCategoryBg(cat), border: `1px solid ${color}` }} />
317
+ <span className="text-gray-300">{cat}</span>
318
+ </div>
319
+ ))}
320
+ </div>
321
+
322
+ <div className="absolute top-3 right-3 bg-gray-900/90 border border-gray-700 rounded-lg px-3 py-1.5 text-xs text-gray-400 z-10">
323
+ {standards.list.length} standards · v{standards.version}
324
+ </div>
325
+ </div>
326
+
327
+ <DetailPanel open={panel.open} title={panel.title} onClose={closePanel}>
328
+ {panel.content}
329
+ </DetailPanel>
330
+ </div>
331
+ );
332
+ }