@polymorphism-tech/morph-spec 7.7.3 → 7.8.1

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 (187) hide show
  1. package/README.md +2 -2
  2. package/bin/validate.js +379 -379
  3. package/claude-plugin.json +1 -1
  4. package/docs/CHEATSHEET.md +1 -1
  5. package/docs/QUICKSTART.md +1 -1
  6. package/framework/CLAUDE.md +1 -1
  7. package/framework/MORPH.md +3 -2
  8. package/framework/agents.json +1 -1
  9. package/framework/commands/commit.md +166 -166
  10. package/framework/commands/morph-infra.md +215 -215
  11. package/framework/commands/morph-preflight.md +205 -205
  12. package/framework/commands/morph-troubleshoot.md +124 -124
  13. package/framework/evals/scenarios/dotnet-crud.yaml +1 -1
  14. package/framework/hooks/claude-code/statusline.py +679 -679
  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/activity-logger.js +160 -160
  22. package/framework/hooks/shared/hook-response.js +45 -45
  23. package/framework/hooks/shared/payload-utils.js +78 -78
  24. package/framework/hooks/shared/stdin-reader.js +26 -26
  25. package/framework/rubrics/backend.json +41 -41
  26. package/framework/rules/ai-agents-standards.md +45 -45
  27. package/framework/rules/dotnet-templates.md +86 -87
  28. package/framework/rules/frontend-standards.md +13 -13
  29. package/framework/rules/infrastructure-standards.md +27 -27
  30. package/framework/rules/neon-standards.md +25 -25
  31. package/framework/rules/nextjs-standards.md +20 -20
  32. package/framework/rules/nextjs-templates.md +40 -40
  33. package/framework/skills/core/create-umbraco-lp/SKILL.md +1 -1
  34. package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md +1 -1
  35. package/framework/skills/core/morph-apply/SKILL.md +1 -1
  36. package/framework/skills/core/morph-brainstorming/SKILL.md +9 -5
  37. package/framework/skills/core/morph-eval/SKILL.md +1 -1
  38. package/framework/skills/core/morph-implement/SKILL.md +1 -1
  39. package/framework/skills/core/morph-plan/SKILL.md +11 -6
  40. package/framework/skills/core/morph-proposal/SKILL.md +1 -1
  41. package/framework/skills/core/morph-review/SKILL.md +13 -7
  42. package/framework/skills/core/morph-stack-scan/SKILL.md +5 -5
  43. package/framework/skills/core/morph-standards/SKILL.md +1 -1
  44. package/framework/standards/STANDARDS.json +1 -1
  45. package/framework/standards/ai-agents/agent-session.md +160 -160
  46. package/framework/standards/ai-agents/batching.md +193 -193
  47. package/framework/standards/ai-agents/context-providers.md +188 -188
  48. package/framework/standards/ai-agents/mcp-server.md +250 -250
  49. package/framework/standards/ai-agents/mcp-tools.md +197 -197
  50. package/framework/standards/ai-agents/middleware-patterns.md +207 -207
  51. package/framework/standards/ai-agents/modalities-image-gen.md +173 -173
  52. package/framework/standards/ai-agents/modalities-speech-to-text.md +171 -171
  53. package/framework/standards/ai-agents/modalities-text-to-speech.md +181 -181
  54. package/framework/standards/ai-agents/modalities-vision.md +201 -201
  55. package/framework/standards/ai-agents/multi-agent-patterns.md +155 -155
  56. package/framework/standards/ai-agents/production.md +275 -275
  57. package/framework/standards/ai-agents/prompts-in-db.md +214 -214
  58. package/framework/standards/ai-agents/providers/model-registry.md +158 -158
  59. package/framework/standards/ai-agents/service-tier-flex.md +135 -135
  60. package/framework/standards/ai-agents/structured-output.md +249 -249
  61. package/framework/standards/ai-agents/sweet-spot.md +109 -109
  62. package/framework/standards/architecture/vertical-slice/vertical-slice.md +34 -35
  63. package/framework/standards/backend/api/validation.md +2 -2
  64. package/framework/standards/backend/dotnet/scrutor.md +1 -3
  65. package/framework/standards/backend/dotnet/vsa-handler-patterns.md +42 -37
  66. package/framework/standards/data/nosql/cache/redis.md +2 -2
  67. package/framework/templates/CLAUDE.md.core.template +1 -1
  68. package/framework/templates/IDE-SNIPPETS.md +262 -262
  69. package/framework/templates/README.md +0 -1
  70. package/framework/templates/REGISTRY.json +0 -21
  71. package/framework/templates/code/dotnet/abstractions/api-endpoint.cs +7 -7
  72. package/framework/templates/code/dotnet/abstractions/handler.cs +0 -3
  73. package/framework/templates/code/dotnet/ai-agents/AgentBootstrap.cs.template +39 -39
  74. package/framework/templates/code/dotnet/ai-agents/EmbeddingService.cs.template +68 -68
  75. package/framework/templates/code/dotnet/ai-agents/ModelRegistry.cs.template +117 -117
  76. package/framework/templates/code/dotnet/ai-agents/PromptRepository.cs.template +95 -95
  77. package/framework/templates/code/dotnet/ai-agents/ResilientToolMiddleware.cs.template +61 -61
  78. package/framework/templates/code/dotnet/ai-agents/VectorSearchTool.cs.template +107 -107
  79. package/framework/templates/code/dotnet/ai-agents/model-registry.json.template +58 -58
  80. package/framework/templates/code/dotnet/constants/api-tags.cs +1 -1
  81. package/framework/templates/code/dotnet/contracts/contracts-vsa.cs +281 -282
  82. package/framework/templates/code/dotnet/database/migration.cs +83 -83
  83. package/framework/templates/code/dotnet/feature/endpoint.cs.hbs +21 -21
  84. package/framework/templates/code/dotnet/feature/handler.cs.hbs +23 -24
  85. package/framework/templates/code/dotnet/feature/request.cs.hbs +4 -4
  86. package/framework/templates/code/dotnet/feature/response.cs.hbs +4 -4
  87. package/framework/templates/code/dotnet/feature/validator.cs.hbs +15 -15
  88. package/framework/templates/code/dotnet/jobs/job.cs +15 -15
  89. package/framework/templates/code/dotnet/test.cs +72 -101
  90. package/framework/templates/code/sql/ai-agents/agent-prompts-migration.sql.template +58 -58
  91. package/framework/templates/code/sql/ai-agents/pgvector-embeddings-migration.sql.template +91 -91
  92. package/framework/templates/code/typescript/contracts.ts +167 -167
  93. package/framework/templates/docs/clarifications.md +253 -253
  94. package/framework/templates/docs/schema-analysis.md +119 -119
  95. package/framework/templates/docs/ui-components.md +52 -52
  96. package/framework/templates/docs/ui-design-system.md +76 -76
  97. package/framework/templates/docs/ui-flows.md +167 -167
  98. package/framework/templates/docs/ui-mockups.md +98 -98
  99. package/framework/templates/feature/decisions.md +122 -122
  100. package/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +43 -43
  101. package/framework/templates/frontend/nextjs/client-component.tsx.hbs +26 -26
  102. package/framework/templates/frontend/nextjs/env.mjs.hbs +32 -32
  103. package/framework/templates/frontend/nextjs/feature-form.tsx.hbs +56 -56
  104. package/framework/templates/frontend/nextjs/page.tsx.hbs +22 -22
  105. package/framework/templates/frontend/nextjs/tsconfig.json.hbs +26 -26
  106. package/framework/templates/frontend/nextjs/use-feature.ts.hbs +54 -54
  107. package/framework/templates/infrastructure/docker/Dockerfile.template +58 -58
  108. package/framework/templates/infrastructure/docker/docker-compose.template.yml +50 -50
  109. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  110. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  111. package/framework/templates/infrastructure/github/README.md +56 -56
  112. package/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +45 -45
  113. package/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +27 -27
  114. package/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +59 -59
  115. package/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +39 -39
  116. package/framework/templates/integrations/asaas-client.cs +387 -387
  117. package/framework/templates/integrations/asaas-webhook.cs +351 -351
  118. package/framework/templates/meta-prompts/fusion/fusion-agent.md +76 -76
  119. package/framework/templates/meta-prompts/fusion/fusion-aggregator.md +100 -100
  120. package/framework/templates/meta-prompts/parallel-workers/parallel-coordinator.md +113 -113
  121. package/framework/templates/meta-prompts/validators/pre-commit-validator.md +95 -95
  122. package/framework/templates/project/validate.js +120 -120
  123. package/framework/templates/state.template.json +17 -17
  124. package/framework/templates/ui/design-system.css +226 -226
  125. package/package.json +1 -1
  126. package/src/commands/dashboard/dashboard.js +53 -53
  127. package/src/commands/index.js +13 -13
  128. package/src/commands/mcp/mcp-setup.js +519 -519
  129. package/src/commands/project/checkpoint.js +209 -209
  130. package/src/commands/project/update.js +7 -4
  131. package/src/core/state/phase-state-machine.js +197 -197
  132. package/src/core/templates/template-renderer.js +477 -477
  133. package/src/dashboard/app/components/DetailPanel.jsx +11 -11
  134. package/src/dashboard/app/components/FlowGraph.jsx +17 -17
  135. package/src/dashboard/app/components/SearchFilter.jsx +22 -22
  136. package/src/dashboard/app/hooks/useDetailPanel.js +15 -15
  137. package/src/dashboard/app/main.jsx +13 -13
  138. package/src/dashboard/app/pages/AgentMap.jsx +370 -370
  139. package/src/dashboard/app/pages/HookInspector.jsx +418 -418
  140. package/src/dashboard/app/pages/LiveState.jsx +239 -239
  141. package/src/dashboard/app/pages/PhasePipeline.jsx +408 -408
  142. package/src/dashboard/app/pages/RulesMap.jsx +273 -273
  143. package/src/dashboard/app/pages/SkillsLibrary.jsx +366 -366
  144. package/src/dashboard/app/pages/Standards.jsx +332 -332
  145. package/src/dashboard/app/styles/index.css +47 -47
  146. package/src/dashboard/index.html +12 -12
  147. package/src/dashboard/package.json +24 -24
  148. package/src/dashboard/scanner/hooks-scanner.js +41 -41
  149. package/src/dashboard/scanner/phases-scanner.js +15 -15
  150. package/src/dashboard/scanner/rubrics-scanner.js +12 -12
  151. package/src/dashboard/scanner/rules-scanner.js +37 -37
  152. package/src/dashboard/scanner/skills-scanner.js +43 -43
  153. package/src/dashboard/scanner/squads-scanner.js +13 -13
  154. package/src/dashboard/scanner/standards-scanner.js +26 -26
  155. package/src/dashboard/vite-plugin-morph-data.js +17 -17
  156. package/src/dashboard/vite.config.js +24 -24
  157. package/src/lib/agents/metrics-aggregator.js +56 -56
  158. package/src/lib/agents/metrics-calculator.js +125 -125
  159. package/src/lib/agents/output-collector.js +73 -73
  160. package/src/lib/detectors/claude-config-detector.js +152 -152
  161. package/src/lib/detectors/design-system-detector.js +231 -231
  162. package/src/lib/detectors/index.js +217 -217
  163. package/src/lib/generators/architecture-scanner.js +639 -639
  164. package/src/lib/generators/design-system-generator.js +508 -508
  165. package/src/lib/generators/index.js +13 -13
  166. package/src/lib/generators/settings-generator.js +209 -209
  167. package/src/lib/hooks/hook-executor.js +167 -167
  168. package/src/lib/installers/mcp-installer.js +719 -719
  169. package/src/lib/tasks/task-classifier.js +30 -30
  170. package/src/lib/tasks/task-parser.js +209 -209
  171. package/src/lib/tasks/test-runner.js +81 -81
  172. package/src/lib/validators/architecture/architecture-validator.js +259 -259
  173. package/src/lib/validators/checkpoint-persistence.js +39 -39
  174. package/src/lib/validators/contracts/contract-compliance-validator.js +274 -274
  175. package/src/lib/validators/css/css-validator.js +340 -340
  176. package/src/lib/validators/packages/package-validator.js +347 -347
  177. package/src/lib/validators/shared/emit-validator-dispatch.js +14 -14
  178. package/src/lib/validators/shared/issue-counter.js +14 -14
  179. package/src/lib/validators/validation-runner.js +349 -349
  180. package/src/scripts/setup-infra.js +383 -383
  181. package/src/utils/agent-id-mapper.js +11 -11
  182. package/src/utils/banner.js +52 -43
  183. package/src/utils/claude-settings-manager.js +300 -300
  184. package/src/utils/skills-installer.js +172 -172
  185. package/framework/templates/.idea/morph-templates.xml +0 -92
  186. package/framework/templates/.vscode/morph-templates.code-snippets +0 -186
  187. package/framework/templates/code/dotnet/backend/repository.cs +0 -141
@@ -1,370 +1,370 @@
1
- import { useState, useMemo, useCallback } from 'react';
2
- import { Handle, Position } from '@xyflow/react';
3
- import dagre from '@dagrejs/dagre';
4
- import morphData from 'virtual:morph-data';
5
- import FlowGraph from '../components/FlowGraph.jsx';
6
- import DetailPanel from '../components/DetailPanel.jsx';
7
- import SearchFilter from '../components/SearchFilter.jsx';
8
- import { useDetailPanel } from '../hooks/useDetailPanel.js';
9
-
10
- // Domain persona color palette (v5 — flat, no tiers)
11
- const PERSONA_COLORS = {
12
- user: { bg: '#78350f', border: '#f59e0b', label: 'User' },
13
- 'dotnet-senior':{ bg: '#991b1b', border: '#ef4444', label: 'Backend' },
14
- 'ef-modeler': { bg: '#7c2d12', border: '#fb923c', label: 'Data' },
15
- 'maf-expert': { bg: '#1e3a5f', border: '#38bdf8', label: 'Agents' },
16
- 'nextjs-expert':{ bg: '#064e3b', border: '#34d399', label: 'Frontend' },
17
- 'ui-designer': { bg: '#4a1d96', border: '#a78bfa', label: 'Design' },
18
- 'infra-engineer':{ bg: '#1e3a5f', border: '#60a5fa', label: 'Infra' },
19
- 'evaluator': { bg: '#374151', border: '#9ca3af', label: 'Eval' },
20
- };
21
- const FALLBACK_PERSONA = { bg: '#1e40af', border: '#3b82f6', label: 'Persona' };
22
-
23
- // Custom AgentNode component
24
- function AgentNode({ data }) {
25
- const colors = data.isUser ? PERSONA_COLORS.user : (PERSONA_COLORS[data.personaId] || FALLBACK_PERSONA);
26
- return (
27
- <div
28
- className="rounded-lg px-3 py-2 min-w-[130px] max-w-[160px] cursor-pointer select-none"
29
- style={{ background: colors.bg, border: `1.5px solid ${colors.border}`, boxShadow: `0 0 8px ${colors.border}22` }}
30
- >
31
- <Handle type="target" position={Position.Top} style={{ background: colors.border, width: 8, height: 8 }} />
32
- <div className="text-white text-xs font-semibold leading-tight truncate" title={data.label}>
33
- {data.label}
34
- </div>
35
- <div className="text-gray-300 text-[10px] mt-0.5 truncate">
36
- {data.isUser ? 'Principal' : `${colors.label} · ${data.domains?.[0] || ''}`}
37
- </div>
38
- <Handle type="source" position={Position.Bottom} style={{ background: colors.border, width: 8, height: 8 }} />
39
- </div>
40
- );
41
- }
42
-
43
- const nodeTypes = { agentNode: AgentNode };
44
-
45
- // Dagre layout helpers
46
- function buildLayout(nodes, edges) {
47
- const g = new dagre.graphlib.Graph();
48
- g.setDefaultEdgeLabel(() => ({}));
49
- g.setGraph({ rankdir: 'TB', nodesep: 40, ranksep: 60, marginx: 20, marginy: 20 });
50
-
51
- nodes.forEach((n) => g.setNode(n.id, { width: 160, height: 60 }));
52
- edges.forEach((e) => g.setEdge(e.source, e.target));
53
-
54
- dagre.layout(g);
55
-
56
- return nodes.map((n) => {
57
- const pos = g.node(n.id);
58
- return { ...n, position: { x: pos.x - 80, y: pos.y - 30 } };
59
- });
60
- }
61
-
62
- // AgentDetail shown inside the panel
63
- function AgentDetail({ agent }) {
64
- const [showPrompt, setShowPrompt] = useState(false);
65
- const personaColors = PERSONA_COLORS[agent.id] || FALLBACK_PERSONA;
66
-
67
- return (
68
- <div className="text-sm text-gray-200 space-y-4">
69
- {/* Header */}
70
- <div>
71
- <div className="flex items-center gap-2 mb-1">
72
- <span className="px-2 py-0.5 rounded text-xs font-bold" style={{ background: personaColors.bg, color: personaColors.border, border: `1px solid ${personaColors.border}` }}>
73
- {personaColors.label}
74
- </span>
75
- <span className="text-gray-400 text-xs">{agent.domains?.[0] || ''}</span>
76
- </div>
77
- <p className="text-gray-400 text-xs">ID: <span className="text-gray-300 font-mono">{agent.id}</span></p>
78
- </div>
79
-
80
- {/* Active Phases */}
81
- {agent.activePhases?.length > 0 && (
82
- <div>
83
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Active Phases</p>
84
- <div className="flex flex-wrap gap-1">
85
- {agent.activePhases.map((p) => (
86
- <span key={p} className="px-2 py-0.5 bg-blue-900/50 border border-blue-700 rounded text-xs text-blue-300">{p}</span>
87
- ))}
88
- </div>
89
- </div>
90
- )}
91
-
92
- {/* Validators */}
93
- {agent.validators?.length > 0 && (
94
- <div>
95
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Validators</p>
96
- <div className="flex flex-wrap gap-1">
97
- {agent.validators.map((v) => (
98
- <span key={v} className="px-2 py-0.5 bg-purple-900/50 border border-purple-700 rounded text-xs text-purple-300">{v}</span>
99
- ))}
100
- </div>
101
- </div>
102
- )}
103
-
104
- {/* Standards */}
105
- {agent.standards?.length > 0 && (
106
- <div>
107
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Standards</p>
108
- <ul className="space-y-1">
109
- {agent.standards.map((s) => (
110
- <li key={s.id} className="flex items-center justify-between text-xs">
111
- <span className="font-mono text-gray-300">{s.id}</span>
112
- <div className="flex gap-1">
113
- {s.scope && <span className="px-1.5 py-0.5 bg-gray-800 rounded text-gray-400">{s.scope}</span>}
114
- {s.priority && <span className="px-1.5 py-0.5 bg-gray-800 rounded text-gray-400">{s.priority}</span>}
115
- </div>
116
- </li>
117
- ))}
118
- </ul>
119
- </div>
120
- )}
121
-
122
- {/* Domains */}
123
- {agent.domains?.length > 0 && (
124
- <div>
125
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Domains</p>
126
- <p className="text-gray-300 text-xs">{agent.domains.join(', ')}</p>
127
- </div>
128
- )}
129
-
130
- {/* Keywords */}
131
- {agent.keywords?.length > 0 && (
132
- <div>
133
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Keywords</p>
134
- <div className="flex flex-wrap gap-1">
135
- {agent.keywords.map((k) => (
136
- <span key={k} className="px-1.5 py-0.5 bg-gray-800 border border-gray-700 rounded text-xs text-gray-400">{k}</span>
137
- ))}
138
- </div>
139
- </div>
140
- )}
141
-
142
- {/* Stacks */}
143
- {agent.stacks?.length > 0 && (
144
- <div>
145
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Stacks</p>
146
- <div className="flex flex-wrap gap-1">
147
- {agent.stacks.map((s) => (
148
- <span key={s} className="px-1.5 py-0.5 bg-green-900/50 border border-green-700 rounded text-xs text-green-300">{s}</span>
149
- ))}
150
- </div>
151
- </div>
152
- )}
153
-
154
- {/* Full Prompt toggle */}
155
- {agent.prompt && (
156
- <div>
157
- <button
158
- onClick={() => setShowPrompt((v) => !v)}
159
- 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"
160
- >
161
- {showPrompt ? 'Hide Full Prompt' : 'Show Full Prompt'}
162
- </button>
163
- {showPrompt && (
164
- <pre className="mt-2 p-3 bg-gray-950 border border-gray-800 rounded text-[10px] text-gray-400 overflow-x-auto whitespace-pre-wrap font-mono leading-relaxed max-h-64 overflow-y-auto">
165
- {agent.prompt}
166
- </pre>
167
- )}
168
- </div>
169
- )}
170
- </div>
171
- );
172
- }
173
-
174
- export default function AgentMap() {
175
- const { agents } = morphData;
176
- const [search, setSearch] = useState('');
177
- const [domainFilter, setDomainFilter] = useState('');
178
- const [groupFilter, setGroupFilter] = useState('');
179
- const [phaseFilter, setPhaseFilter] = useState('');
180
- const [stackFilter, setStackFilter] = useState('');
181
- const { panel, openPanel, closePanel } = useDetailPanel();
182
-
183
- // Derive unique groups, tiers, phases, and stacks for filters
184
- const allGroups = useMemo(() => [...new Set(agents.list.map((a) => a.domains?.[0]).filter(Boolean))].sort(), [agents.list]);
185
- const allDomains = useMemo(() => [...new Set(agents.list.flatMap((a) => a.domains || []))].sort(), [agents.list]);
186
- const allPhases = useMemo(() => {
187
- const phases = new Set();
188
- for (const a of agents.list) {
189
- for (const p of a.activePhases || []) {
190
- if (p !== '*') phases.add(p);
191
- }
192
- }
193
- return [...phases].sort();
194
- }, [agents.list]);
195
- const allStacks = useMemo(() => {
196
- const stacks = new Set();
197
- for (const a of agents.list) {
198
- for (const s of a.stacks || []) {
199
- stacks.add(s);
200
- }
201
- }
202
- return [...stacks].sort();
203
- }, [agents.list]);
204
-
205
- // Filtered agent ids (for highlight — we always show all nodes but dim non-matching)
206
- const matchedIds = useMemo(() => {
207
- const q = search.toLowerCase();
208
- return new Set(
209
- agents.list
210
- .filter((a) => {
211
- const matchesSearch = !q || a.title.toLowerCase().includes(q) || a.id.toLowerCase().includes(q) || a.keywords?.some((k) => k.toLowerCase().includes(q));
212
- const matchesDomain = !domainFilter || (a.domains || []).includes(domainFilter);
213
- const matchesGroup = !groupFilter || (a.domains || []).includes(groupFilter);
214
- const matchesPhase = !phaseFilter || (a.activePhases || []).includes('*') || (a.activePhases || []).includes(phaseFilter);
215
- const matchesStack = !stackFilter || (a.stacks || []).includes(stackFilter);
216
- return matchesSearch && matchesDomain && matchesGroup && matchesPhase && matchesStack;
217
- })
218
- .map((a) => a.id)
219
- );
220
- }, [agents.list, search, tierFilter, groupFilter, phaseFilter, stackFilter]);
221
-
222
- const hasFilter = search || domainFilter || groupFilter || phaseFilter || stackFilter;
223
-
224
- // Build React Flow nodes and edges
225
- const { nodes: layoutNodes, edges } = useMemo(() => {
226
- const rawNodes = [];
227
- const rawEdges = [];
228
-
229
- // User node at top
230
- rawNodes.push({
231
- id: '__user__',
232
- type: 'agentNode',
233
- data: { label: 'User', isUser: true, color: '#78350f' },
234
- position: { x: 0, y: 0 },
235
- });
236
-
237
- // Agent nodes
238
- for (const agent of agents.list) {
239
- const dimmed = hasFilter && !matchedIds.has(agent.id);
240
- const personaColors = PERSONA_COLORS[agent.id] || FALLBACK_PERSONA;
241
- rawNodes.push({
242
- id: agent.id,
243
- type: 'agentNode',
244
- data: {
245
- label: agent.title,
246
- personaId: agent.id,
247
- domains: agent.domains,
248
- color: personaColors.border,
249
- agentRef: agent,
250
- },
251
- style: dimmed ? { opacity: 0.2 } : {},
252
- position: { x: 0, y: 0 },
253
- });
254
- }
255
-
256
- // user → agent edges (flat — no hierarchy in v5)
257
- for (const agent of agents.list) {
258
- const personaColors = PERSONA_COLORS[agent.id] || FALLBACK_PERSONA;
259
- rawEdges.push({
260
- id: `rt-${agent.id}`,
261
- source: '__user__',
262
- target: agent.id,
263
- type: 'smoothstep',
264
- style: { stroke: personaColors.border, strokeWidth: 1.5 },
265
- animated: false,
266
- });
267
- }
268
-
269
- // validators edges (dashed purple) — Tier 4 validator agent → validated agent
270
- // agent.validators contains runner names like "architecture", "design-system", "nextjs-component"
271
- // which map to Tier 4 agent IDs like "architecture-expert", "design-system-validator", etc.
272
- // Match by finding the Tier 4 agent whose ID contains the validator runner name.
273
- const tier4Agents = agents.list.filter((a) => a.tier === 4);
274
- for (const agent of agents.list) {
275
- for (const v of agent.validators || []) {
276
- const validatorAgent = tier4Agents.find((a) => a.id.includes(v));
277
- if (validatorAgent) {
278
- rawEdges.push({
279
- id: `val-${validatorAgent.id}-${agent.id}`,
280
- source: validatorAgent.id,
281
- target: agent.id,
282
- type: 'smoothstep',
283
- style: { stroke: '#8b5cf6', strokeWidth: 1, strokeDasharray: '4 3' },
284
- animated: false,
285
- });
286
- }
287
- }
288
- }
289
-
290
- const layouted = buildLayout(rawNodes, rawEdges);
291
- return { nodes: layouted, edges: rawEdges };
292
- }, [agents.list, matchedIds, hasFilter]);
293
-
294
- const handleNodeClick = useCallback(
295
- (_event, node) => {
296
- if (node.id === '__user__') {
297
- openPanel('User (Principal)', <div className="text-gray-400 text-sm">The human operator. All Tier 1 orchestrators report to this node.</div>);
298
- return;
299
- }
300
- const agent = node.data.agentRef;
301
- if (agent) {
302
- openPanel(agent.title, <AgentDetail agent={agent} />);
303
- }
304
- },
305
- [openPanel]
306
- );
307
-
308
- const filterConfig = [
309
- { name: 'tier', label: 'Tier', options: allTiers, value: tierFilter },
310
- { name: 'group', label: 'Group', options: allGroups, value: groupFilter },
311
- { name: 'phase', label: 'Phase', options: allPhases, value: phaseFilter },
312
- { name: 'stack', label: 'Stack', options: allStacks, value: stackFilter },
313
- ];
314
-
315
- return (
316
- <div className="flex flex-col h-full">
317
- <SearchFilter
318
- placeholder="Search agents by name or keyword..."
319
- filters={filterConfig}
320
- onSearchChange={setSearch}
321
- onFilterChange={(name, value) => {
322
- if (name === 'tier') setTierFilter(value);
323
- if (name === 'group') setGroupFilter(value);
324
- if (name === 'phase') setPhaseFilter(value);
325
- if (name === 'stack') setStackFilter(value);
326
- }}
327
- />
328
-
329
- <div className="flex-1 relative">
330
- <FlowGraph
331
- nodes={layoutNodes}
332
- edges={edges}
333
- nodeTypes={nodeTypes}
334
- onNodeClick={handleNodeClick}
335
- fitView
336
- />
337
-
338
- {/* Legend */}
339
- <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">
340
- <p className="text-gray-400 font-semibold uppercase tracking-wide text-[10px] mb-2">Legend</p>
341
- {Object.entries(TIER_COLORS).map(([key, c]) => (
342
- <div key={key} className="flex items-center gap-2">
343
- <span className="inline-block w-3 h-3 rounded-sm flex-shrink-0" style={{ background: c.bg, border: `1px solid ${c.border}` }} />
344
- <span className="text-gray-300">{key === 'user' ? 'User' : `Tier ${key} — ${c.label}`}</span>
345
- </div>
346
- ))}
347
- <div className="border-t border-gray-700 mt-2 pt-2 space-y-1">
348
- <div className="flex items-center gap-2">
349
- <span className="inline-block w-6 border-t-2 border-blue-400" />
350
- <span className="text-gray-400">reports_to</span>
351
- </div>
352
- <div className="flex items-center gap-2">
353
- <span className="inline-block w-6 border-t-2 border-purple-400 border-dashed" />
354
- <span className="text-gray-400">validates</span>
355
- </div>
356
- </div>
357
- </div>
358
-
359
- {/* Agent count badge */}
360
- <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">
361
- {hasFilter ? `${matchedIds.size} / ${agents.list.length}` : agents.list.length} agents
362
- </div>
363
- </div>
364
-
365
- <DetailPanel open={panel.open} title={panel.title} onClose={closePanel}>
366
- {panel.content}
367
- </DetailPanel>
368
- </div>
369
- );
370
- }
1
+ import { useState, useMemo, useCallback } from 'react';
2
+ import { Handle, Position } from '@xyflow/react';
3
+ import dagre from '@dagrejs/dagre';
4
+ import morphData from 'virtual:morph-data';
5
+ import FlowGraph from '../components/FlowGraph.jsx';
6
+ import DetailPanel from '../components/DetailPanel.jsx';
7
+ import SearchFilter from '../components/SearchFilter.jsx';
8
+ import { useDetailPanel } from '../hooks/useDetailPanel.js';
9
+
10
+ // Domain persona color palette (v5 — flat, no tiers)
11
+ const PERSONA_COLORS = {
12
+ user: { bg: '#78350f', border: '#f59e0b', label: 'User' },
13
+ 'dotnet-senior':{ bg: '#991b1b', border: '#ef4444', label: 'Backend' },
14
+ 'ef-modeler': { bg: '#7c2d12', border: '#fb923c', label: 'Data' },
15
+ 'maf-expert': { bg: '#1e3a5f', border: '#38bdf8', label: 'Agents' },
16
+ 'nextjs-expert':{ bg: '#064e3b', border: '#34d399', label: 'Frontend' },
17
+ 'ui-designer': { bg: '#4a1d96', border: '#a78bfa', label: 'Design' },
18
+ 'infra-engineer':{ bg: '#1e3a5f', border: '#60a5fa', label: 'Infra' },
19
+ 'evaluator': { bg: '#374151', border: '#9ca3af', label: 'Eval' },
20
+ };
21
+ const FALLBACK_PERSONA = { bg: '#1e40af', border: '#3b82f6', label: 'Persona' };
22
+
23
+ // Custom AgentNode component
24
+ function AgentNode({ data }) {
25
+ const colors = data.isUser ? PERSONA_COLORS.user : (PERSONA_COLORS[data.personaId] || FALLBACK_PERSONA);
26
+ return (
27
+ <div
28
+ className="rounded-lg px-3 py-2 min-w-[130px] max-w-[160px] cursor-pointer select-none"
29
+ style={{ background: colors.bg, border: `1.5px solid ${colors.border}`, boxShadow: `0 0 8px ${colors.border}22` }}
30
+ >
31
+ <Handle type="target" position={Position.Top} style={{ background: colors.border, width: 8, height: 8 }} />
32
+ <div className="text-white text-xs font-semibold leading-tight truncate" title={data.label}>
33
+ {data.label}
34
+ </div>
35
+ <div className="text-gray-300 text-[10px] mt-0.5 truncate">
36
+ {data.isUser ? 'Principal' : `${colors.label} · ${data.domains?.[0] || ''}`}
37
+ </div>
38
+ <Handle type="source" position={Position.Bottom} style={{ background: colors.border, width: 8, height: 8 }} />
39
+ </div>
40
+ );
41
+ }
42
+
43
+ const nodeTypes = { agentNode: AgentNode };
44
+
45
+ // Dagre layout helpers
46
+ function buildLayout(nodes, edges) {
47
+ const g = new dagre.graphlib.Graph();
48
+ g.setDefaultEdgeLabel(() => ({}));
49
+ g.setGraph({ rankdir: 'TB', nodesep: 40, ranksep: 60, marginx: 20, marginy: 20 });
50
+
51
+ nodes.forEach((n) => g.setNode(n.id, { width: 160, height: 60 }));
52
+ edges.forEach((e) => g.setEdge(e.source, e.target));
53
+
54
+ dagre.layout(g);
55
+
56
+ return nodes.map((n) => {
57
+ const pos = g.node(n.id);
58
+ return { ...n, position: { x: pos.x - 80, y: pos.y - 30 } };
59
+ });
60
+ }
61
+
62
+ // AgentDetail shown inside the panel
63
+ function AgentDetail({ agent }) {
64
+ const [showPrompt, setShowPrompt] = useState(false);
65
+ const personaColors = PERSONA_COLORS[agent.id] || FALLBACK_PERSONA;
66
+
67
+ return (
68
+ <div className="text-sm text-gray-200 space-y-4">
69
+ {/* Header */}
70
+ <div>
71
+ <div className="flex items-center gap-2 mb-1">
72
+ <span className="px-2 py-0.5 rounded text-xs font-bold" style={{ background: personaColors.bg, color: personaColors.border, border: `1px solid ${personaColors.border}` }}>
73
+ {personaColors.label}
74
+ </span>
75
+ <span className="text-gray-400 text-xs">{agent.domains?.[0] || ''}</span>
76
+ </div>
77
+ <p className="text-gray-400 text-xs">ID: <span className="text-gray-300 font-mono">{agent.id}</span></p>
78
+ </div>
79
+
80
+ {/* Active Phases */}
81
+ {agent.activePhases?.length > 0 && (
82
+ <div>
83
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Active Phases</p>
84
+ <div className="flex flex-wrap gap-1">
85
+ {agent.activePhases.map((p) => (
86
+ <span key={p} className="px-2 py-0.5 bg-blue-900/50 border border-blue-700 rounded text-xs text-blue-300">{p}</span>
87
+ ))}
88
+ </div>
89
+ </div>
90
+ )}
91
+
92
+ {/* Validators */}
93
+ {agent.validators?.length > 0 && (
94
+ <div>
95
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Validators</p>
96
+ <div className="flex flex-wrap gap-1">
97
+ {agent.validators.map((v) => (
98
+ <span key={v} className="px-2 py-0.5 bg-purple-900/50 border border-purple-700 rounded text-xs text-purple-300">{v}</span>
99
+ ))}
100
+ </div>
101
+ </div>
102
+ )}
103
+
104
+ {/* Standards */}
105
+ {agent.standards?.length > 0 && (
106
+ <div>
107
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Standards</p>
108
+ <ul className="space-y-1">
109
+ {agent.standards.map((s) => (
110
+ <li key={s.id} className="flex items-center justify-between text-xs">
111
+ <span className="font-mono text-gray-300">{s.id}</span>
112
+ <div className="flex gap-1">
113
+ {s.scope && <span className="px-1.5 py-0.5 bg-gray-800 rounded text-gray-400">{s.scope}</span>}
114
+ {s.priority && <span className="px-1.5 py-0.5 bg-gray-800 rounded text-gray-400">{s.priority}</span>}
115
+ </div>
116
+ </li>
117
+ ))}
118
+ </ul>
119
+ </div>
120
+ )}
121
+
122
+ {/* Domains */}
123
+ {agent.domains?.length > 0 && (
124
+ <div>
125
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Domains</p>
126
+ <p className="text-gray-300 text-xs">{agent.domains.join(', ')}</p>
127
+ </div>
128
+ )}
129
+
130
+ {/* Keywords */}
131
+ {agent.keywords?.length > 0 && (
132
+ <div>
133
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Keywords</p>
134
+ <div className="flex flex-wrap gap-1">
135
+ {agent.keywords.map((k) => (
136
+ <span key={k} className="px-1.5 py-0.5 bg-gray-800 border border-gray-700 rounded text-xs text-gray-400">{k}</span>
137
+ ))}
138
+ </div>
139
+ </div>
140
+ )}
141
+
142
+ {/* Stacks */}
143
+ {agent.stacks?.length > 0 && (
144
+ <div>
145
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Stacks</p>
146
+ <div className="flex flex-wrap gap-1">
147
+ {agent.stacks.map((s) => (
148
+ <span key={s} className="px-1.5 py-0.5 bg-green-900/50 border border-green-700 rounded text-xs text-green-300">{s}</span>
149
+ ))}
150
+ </div>
151
+ </div>
152
+ )}
153
+
154
+ {/* Full Prompt toggle */}
155
+ {agent.prompt && (
156
+ <div>
157
+ <button
158
+ onClick={() => setShowPrompt((v) => !v)}
159
+ 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"
160
+ >
161
+ {showPrompt ? 'Hide Full Prompt' : 'Show Full Prompt'}
162
+ </button>
163
+ {showPrompt && (
164
+ <pre className="mt-2 p-3 bg-gray-950 border border-gray-800 rounded text-[10px] text-gray-400 overflow-x-auto whitespace-pre-wrap font-mono leading-relaxed max-h-64 overflow-y-auto">
165
+ {agent.prompt}
166
+ </pre>
167
+ )}
168
+ </div>
169
+ )}
170
+ </div>
171
+ );
172
+ }
173
+
174
+ export default function AgentMap() {
175
+ const { agents } = morphData;
176
+ const [search, setSearch] = useState('');
177
+ const [domainFilter, setDomainFilter] = useState('');
178
+ const [groupFilter, setGroupFilter] = useState('');
179
+ const [phaseFilter, setPhaseFilter] = useState('');
180
+ const [stackFilter, setStackFilter] = useState('');
181
+ const { panel, openPanel, closePanel } = useDetailPanel();
182
+
183
+ // Derive unique groups, tiers, phases, and stacks for filters
184
+ const allGroups = useMemo(() => [...new Set(agents.list.map((a) => a.domains?.[0]).filter(Boolean))].sort(), [agents.list]);
185
+ const allDomains = useMemo(() => [...new Set(agents.list.flatMap((a) => a.domains || []))].sort(), [agents.list]);
186
+ const allPhases = useMemo(() => {
187
+ const phases = new Set();
188
+ for (const a of agents.list) {
189
+ for (const p of a.activePhases || []) {
190
+ if (p !== '*') phases.add(p);
191
+ }
192
+ }
193
+ return [...phases].sort();
194
+ }, [agents.list]);
195
+ const allStacks = useMemo(() => {
196
+ const stacks = new Set();
197
+ for (const a of agents.list) {
198
+ for (const s of a.stacks || []) {
199
+ stacks.add(s);
200
+ }
201
+ }
202
+ return [...stacks].sort();
203
+ }, [agents.list]);
204
+
205
+ // Filtered agent ids (for highlight — we always show all nodes but dim non-matching)
206
+ const matchedIds = useMemo(() => {
207
+ const q = search.toLowerCase();
208
+ return new Set(
209
+ agents.list
210
+ .filter((a) => {
211
+ const matchesSearch = !q || a.title.toLowerCase().includes(q) || a.id.toLowerCase().includes(q) || a.keywords?.some((k) => k.toLowerCase().includes(q));
212
+ const matchesDomain = !domainFilter || (a.domains || []).includes(domainFilter);
213
+ const matchesGroup = !groupFilter || (a.domains || []).includes(groupFilter);
214
+ const matchesPhase = !phaseFilter || (a.activePhases || []).includes('*') || (a.activePhases || []).includes(phaseFilter);
215
+ const matchesStack = !stackFilter || (a.stacks || []).includes(stackFilter);
216
+ return matchesSearch && matchesDomain && matchesGroup && matchesPhase && matchesStack;
217
+ })
218
+ .map((a) => a.id)
219
+ );
220
+ }, [agents.list, search, tierFilter, groupFilter, phaseFilter, stackFilter]);
221
+
222
+ const hasFilter = search || domainFilter || groupFilter || phaseFilter || stackFilter;
223
+
224
+ // Build React Flow nodes and edges
225
+ const { nodes: layoutNodes, edges } = useMemo(() => {
226
+ const rawNodes = [];
227
+ const rawEdges = [];
228
+
229
+ // User node at top
230
+ rawNodes.push({
231
+ id: '__user__',
232
+ type: 'agentNode',
233
+ data: { label: 'User', isUser: true, color: '#78350f' },
234
+ position: { x: 0, y: 0 },
235
+ });
236
+
237
+ // Agent nodes
238
+ for (const agent of agents.list) {
239
+ const dimmed = hasFilter && !matchedIds.has(agent.id);
240
+ const personaColors = PERSONA_COLORS[agent.id] || FALLBACK_PERSONA;
241
+ rawNodes.push({
242
+ id: agent.id,
243
+ type: 'agentNode',
244
+ data: {
245
+ label: agent.title,
246
+ personaId: agent.id,
247
+ domains: agent.domains,
248
+ color: personaColors.border,
249
+ agentRef: agent,
250
+ },
251
+ style: dimmed ? { opacity: 0.2 } : {},
252
+ position: { x: 0, y: 0 },
253
+ });
254
+ }
255
+
256
+ // user → agent edges (flat — no hierarchy in v5)
257
+ for (const agent of agents.list) {
258
+ const personaColors = PERSONA_COLORS[agent.id] || FALLBACK_PERSONA;
259
+ rawEdges.push({
260
+ id: `rt-${agent.id}`,
261
+ source: '__user__',
262
+ target: agent.id,
263
+ type: 'smoothstep',
264
+ style: { stroke: personaColors.border, strokeWidth: 1.5 },
265
+ animated: false,
266
+ });
267
+ }
268
+
269
+ // validators edges (dashed purple) — Tier 4 validator agent → validated agent
270
+ // agent.validators contains runner names like "architecture", "design-system", "nextjs-component"
271
+ // which map to Tier 4 agent IDs like "architecture-expert", "design-system-validator", etc.
272
+ // Match by finding the Tier 4 agent whose ID contains the validator runner name.
273
+ const tier4Agents = agents.list.filter((a) => a.tier === 4);
274
+ for (const agent of agents.list) {
275
+ for (const v of agent.validators || []) {
276
+ const validatorAgent = tier4Agents.find((a) => a.id.includes(v));
277
+ if (validatorAgent) {
278
+ rawEdges.push({
279
+ id: `val-${validatorAgent.id}-${agent.id}`,
280
+ source: validatorAgent.id,
281
+ target: agent.id,
282
+ type: 'smoothstep',
283
+ style: { stroke: '#8b5cf6', strokeWidth: 1, strokeDasharray: '4 3' },
284
+ animated: false,
285
+ });
286
+ }
287
+ }
288
+ }
289
+
290
+ const layouted = buildLayout(rawNodes, rawEdges);
291
+ return { nodes: layouted, edges: rawEdges };
292
+ }, [agents.list, matchedIds, hasFilter]);
293
+
294
+ const handleNodeClick = useCallback(
295
+ (_event, node) => {
296
+ if (node.id === '__user__') {
297
+ openPanel('User (Principal)', <div className="text-gray-400 text-sm">The human operator. All Tier 1 orchestrators report to this node.</div>);
298
+ return;
299
+ }
300
+ const agent = node.data.agentRef;
301
+ if (agent) {
302
+ openPanel(agent.title, <AgentDetail agent={agent} />);
303
+ }
304
+ },
305
+ [openPanel]
306
+ );
307
+
308
+ const filterConfig = [
309
+ { name: 'tier', label: 'Tier', options: allTiers, value: tierFilter },
310
+ { name: 'group', label: 'Group', options: allGroups, value: groupFilter },
311
+ { name: 'phase', label: 'Phase', options: allPhases, value: phaseFilter },
312
+ { name: 'stack', label: 'Stack', options: allStacks, value: stackFilter },
313
+ ];
314
+
315
+ return (
316
+ <div className="flex flex-col h-full">
317
+ <SearchFilter
318
+ placeholder="Search agents by name or keyword..."
319
+ filters={filterConfig}
320
+ onSearchChange={setSearch}
321
+ onFilterChange={(name, value) => {
322
+ if (name === 'tier') setTierFilter(value);
323
+ if (name === 'group') setGroupFilter(value);
324
+ if (name === 'phase') setPhaseFilter(value);
325
+ if (name === 'stack') setStackFilter(value);
326
+ }}
327
+ />
328
+
329
+ <div className="flex-1 relative">
330
+ <FlowGraph
331
+ nodes={layoutNodes}
332
+ edges={edges}
333
+ nodeTypes={nodeTypes}
334
+ onNodeClick={handleNodeClick}
335
+ fitView
336
+ />
337
+
338
+ {/* Legend */}
339
+ <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">
340
+ <p className="text-gray-400 font-semibold uppercase tracking-wide text-[10px] mb-2">Legend</p>
341
+ {Object.entries(TIER_COLORS).map(([key, c]) => (
342
+ <div key={key} className="flex items-center gap-2">
343
+ <span className="inline-block w-3 h-3 rounded-sm flex-shrink-0" style={{ background: c.bg, border: `1px solid ${c.border}` }} />
344
+ <span className="text-gray-300">{key === 'user' ? 'User' : `Tier ${key} — ${c.label}`}</span>
345
+ </div>
346
+ ))}
347
+ <div className="border-t border-gray-700 mt-2 pt-2 space-y-1">
348
+ <div className="flex items-center gap-2">
349
+ <span className="inline-block w-6 border-t-2 border-blue-400" />
350
+ <span className="text-gray-400">reports_to</span>
351
+ </div>
352
+ <div className="flex items-center gap-2">
353
+ <span className="inline-block w-6 border-t-2 border-purple-400 border-dashed" />
354
+ <span className="text-gray-400">validates</span>
355
+ </div>
356
+ </div>
357
+ </div>
358
+
359
+ {/* Agent count badge */}
360
+ <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">
361
+ {hasFilter ? `${matchedIds.size} / ${agents.list.length}` : agents.list.length} agents
362
+ </div>
363
+ </div>
364
+
365
+ <DetailPanel open={panel.open} title={panel.title} onClose={closePanel}>
366
+ {panel.content}
367
+ </DetailPanel>
368
+ </div>
369
+ );
370
+ }