@polymorphism-tech/morph-spec 7.9.4 → 8.1.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 (212) hide show
  1. package/CLAUDE.md +2 -2
  2. package/README.md +31 -2
  3. package/bin/morph-spec.js +50 -2
  4. package/bin/validate.js +379 -379
  5. package/claude-plugin.json +1 -1
  6. package/docs/CHEATSHEET.md +38 -1
  7. package/docs/QUICKSTART.md +60 -1
  8. package/framework/CLAUDE.md +14 -3
  9. package/framework/MORPH.md +41 -5
  10. package/framework/agents.json +22 -3
  11. package/framework/commands/commit.md +166 -166
  12. package/framework/commands/morph-hotfix.md +39 -0
  13. package/framework/commands/morph-infra.md +215 -215
  14. package/framework/commands/morph-preflight.md +205 -205
  15. package/framework/commands/morph-troubleshoot.md +124 -124
  16. package/framework/hooks/README.md +25 -11
  17. package/framework/hooks/claude-code/core/gate-guard.js +4 -2
  18. package/framework/hooks/claude-code/core/loop-detect.js +2 -1
  19. package/framework/hooks/claude-code/core/post-edit-typecheck.js +14 -5
  20. package/framework/hooks/claude-code/core/tasks-json-guard.js +4 -2
  21. package/framework/hooks/claude-code/core/validate-completion.js +1 -1
  22. package/framework/hooks/claude-code/core/worktree-context.js +160 -0
  23. package/framework/hooks/claude-code/statusline.py +679 -679
  24. package/framework/hooks/claude-code/statusline.sh +11 -11
  25. package/framework/hooks/git/commit-msg/conventional-commits.sh +33 -33
  26. package/framework/hooks/git/pre-commit/agents.sh +25 -25
  27. package/framework/hooks/git/pre-commit/orchestrator.sh +64 -64
  28. package/framework/hooks/git/pre-commit/specs.sh +50 -50
  29. package/framework/hooks/git/pre-push/run-tests.sh +44 -44
  30. package/framework/hooks/shared/activity-logger.js +160 -160
  31. package/framework/hooks/shared/build-check.js +2 -2
  32. package/framework/hooks/shared/hook-response.js +17 -5
  33. package/framework/hooks/shared/payload-utils.js +42 -0
  34. package/framework/hooks/shared/state-reader.js +22 -2
  35. package/framework/hooks/shared/stdin-reader.js +26 -26
  36. package/framework/rubrics/backend.json +41 -41
  37. package/framework/rules/ai-agents-standards.md +45 -45
  38. package/framework/rules/dotnet-templates.md +86 -86
  39. package/framework/rules/frontend-standards.md +13 -13
  40. package/framework/rules/infrastructure-standards.md +27 -27
  41. package/framework/rules/neon-standards.md +25 -25
  42. package/framework/rules/nextjs-standards.md +20 -20
  43. package/framework/rules/nextjs-templates.md +40 -40
  44. package/framework/schemas/feature.schema.json +95 -1
  45. package/framework/skills/core/create-umbraco-lp/SKILL.md +1 -1
  46. package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md +1 -1
  47. package/framework/skills/core/morph-apply/SKILL.md +49 -27
  48. package/framework/skills/core/morph-brainstorming/SKILL.md +9 -1
  49. package/framework/skills/core/morph-eval/SKILL.md +6 -1
  50. package/framework/skills/core/morph-hotfix/SKILL.md +134 -0
  51. package/framework/skills/core/morph-implement/SKILL.md +17 -22
  52. package/framework/skills/core/morph-plan/SKILL.md +5 -1
  53. package/framework/skills/core/morph-proposal/SKILL.md +24 -1
  54. package/framework/skills/core/morph-review/SKILL.md +13 -16
  55. package/framework/skills/core/morph-stack-scan/SKILL.md +1 -1
  56. package/framework/skills/core/morph-standards/SKILL.md +1 -1
  57. package/framework/standards/ai-agents/agent-session.md +160 -160
  58. package/framework/standards/ai-agents/batching.md +193 -193
  59. package/framework/standards/ai-agents/context-providers.md +188 -188
  60. package/framework/standards/ai-agents/mcp-server.md +250 -250
  61. package/framework/standards/ai-agents/mcp-tools.md +197 -197
  62. package/framework/standards/ai-agents/middleware-patterns.md +207 -207
  63. package/framework/standards/ai-agents/modalities-image-gen.md +173 -173
  64. package/framework/standards/ai-agents/modalities-speech-to-text.md +171 -171
  65. package/framework/standards/ai-agents/modalities-text-to-speech.md +181 -181
  66. package/framework/standards/ai-agents/modalities-vision.md +201 -201
  67. package/framework/standards/ai-agents/multi-agent-patterns.md +155 -155
  68. package/framework/standards/ai-agents/production.md +275 -275
  69. package/framework/standards/ai-agents/prompts-in-db.md +214 -214
  70. package/framework/standards/ai-agents/providers/model-registry.md +158 -158
  71. package/framework/standards/ai-agents/service-tier-flex.md +135 -135
  72. package/framework/standards/ai-agents/structured-output.md +249 -249
  73. package/framework/standards/ai-agents/sweet-spot.md +109 -109
  74. package/framework/templates/.idea/morph-templates.xml +92 -0
  75. package/framework/templates/.vscode/morph-templates.code-snippets +186 -0
  76. package/framework/templates/IDE-SNIPPETS.md +262 -262
  77. package/framework/templates/REGISTRY.json +0 -62
  78. package/framework/templates/code/dotnet/abstractions/api-endpoint.cs +7 -7
  79. package/framework/templates/code/dotnet/ai-agents/AgentBootstrap.cs.template +39 -39
  80. package/framework/templates/code/dotnet/ai-agents/EmbeddingService.cs.template +68 -68
  81. package/framework/templates/code/dotnet/ai-agents/ModelRegistry.cs.template +117 -117
  82. package/framework/templates/code/dotnet/ai-agents/PromptRepository.cs.template +95 -95
  83. package/framework/templates/code/dotnet/ai-agents/ResilientToolMiddleware.cs.template +61 -61
  84. package/framework/templates/code/dotnet/ai-agents/VectorSearchTool.cs.template +107 -107
  85. package/framework/templates/code/dotnet/ai-agents/model-registry.json.template +58 -58
  86. package/framework/templates/code/dotnet/contracts/contracts-vsa.cs +281 -281
  87. package/framework/templates/code/dotnet/database/migration.cs +83 -83
  88. package/framework/templates/code/dotnet/feature/endpoint.cs.hbs +21 -21
  89. package/framework/templates/code/dotnet/feature/request.cs.hbs +4 -4
  90. package/framework/templates/code/dotnet/feature/response.cs.hbs +4 -4
  91. package/framework/templates/code/dotnet/feature/validator.cs.hbs +15 -15
  92. package/framework/templates/code/sql/ai-agents/agent-prompts-migration.sql.template +58 -58
  93. package/framework/templates/code/sql/ai-agents/pgvector-embeddings-migration.sql.template +91 -91
  94. package/framework/templates/code/typescript/contracts.ts +167 -167
  95. package/framework/templates/docs/clarifications.md +253 -253
  96. package/framework/templates/docs/schema-analysis.md +119 -119
  97. package/framework/templates/docs/ui-components.md +52 -52
  98. package/framework/templates/docs/ui-design-system.md +76 -76
  99. package/framework/templates/docs/ui-flows.md +167 -167
  100. package/framework/templates/docs/ui-mockups.md +98 -98
  101. package/framework/templates/feature/decisions.md +122 -122
  102. package/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +43 -43
  103. package/framework/templates/frontend/nextjs/client-component.tsx.hbs +26 -26
  104. package/framework/templates/frontend/nextjs/env.mjs.hbs +32 -32
  105. package/framework/templates/frontend/nextjs/feature-form.tsx.hbs +56 -56
  106. package/framework/templates/frontend/nextjs/page.tsx.hbs +22 -22
  107. package/framework/templates/frontend/nextjs/tsconfig.json.hbs +26 -26
  108. package/framework/templates/frontend/nextjs/use-feature.ts.hbs +54 -54
  109. package/framework/templates/infrastructure/docker/Dockerfile.template +58 -58
  110. package/framework/templates/infrastructure/docker/docker-compose.template.yml +50 -50
  111. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  112. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  113. package/framework/templates/infrastructure/github/README.md +56 -56
  114. package/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +45 -45
  115. package/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +27 -27
  116. package/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +59 -59
  117. package/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +39 -39
  118. package/framework/templates/integrations/asaas-client.cs +387 -387
  119. package/framework/templates/integrations/asaas-webhook.cs +351 -351
  120. package/framework/templates/meta-prompts/fusion/fusion-agent.md +76 -76
  121. package/framework/templates/meta-prompts/fusion/fusion-aggregator.md +100 -100
  122. package/framework/templates/meta-prompts/validators/pre-commit-validator.md +95 -95
  123. package/framework/templates/project/validate.js +120 -120
  124. package/framework/templates/state.template.json +17 -17
  125. package/framework/templates/ui/design-system.css +226 -226
  126. package/package.json +1 -1
  127. package/src/commands/dashboard/dashboard.js +53 -53
  128. package/src/commands/index.js +13 -13
  129. package/src/commands/mcp/mcp-setup.js +519 -519
  130. package/src/commands/project/checkpoint.js +209 -209
  131. package/src/commands/project/doctor.js +4 -2
  132. package/src/commands/project/init.js +46 -2
  133. package/src/commands/project/update.js +5 -3
  134. package/src/commands/project/worktree.js +1005 -46
  135. package/src/commands/state/advance.js +17 -2
  136. package/src/commands/state/approve.js +18 -1
  137. package/src/commands/state/create.js +158 -14
  138. package/src/commands/state/retype.js +126 -0
  139. package/src/commands/state/score.js +4 -0
  140. package/src/commands/tasks/dag.js +32 -0
  141. package/src/commands/validation/index.js +1 -0
  142. package/src/commands/validation/validate-feature.js +33 -5
  143. package/src/commands/validation/verify.js +190 -0
  144. package/src/core/state/phase-state-machine.js +197 -197
  145. package/src/core/state/state-manager.js +35 -10
  146. package/src/core/templates/template-renderer.js +477 -477
  147. package/src/core/work-types.js +79 -0
  148. package/src/dashboard/app/components/DetailPanel.jsx +11 -11
  149. package/src/dashboard/app/components/FlowGraph.jsx +17 -17
  150. package/src/dashboard/app/components/SearchFilter.jsx +22 -22
  151. package/src/dashboard/app/hooks/useDetailPanel.js +15 -15
  152. package/src/dashboard/app/main.jsx +13 -13
  153. package/src/dashboard/app/pages/AgentMap.jsx +370 -370
  154. package/src/dashboard/app/pages/HookInspector.jsx +418 -418
  155. package/src/dashboard/app/pages/LiveState.jsx +11 -1
  156. package/src/dashboard/app/pages/PhasePipeline.jsx +408 -408
  157. package/src/dashboard/app/pages/RulesMap.jsx +273 -273
  158. package/src/dashboard/app/pages/SkillsLibrary.jsx +366 -366
  159. package/src/dashboard/app/pages/Standards.jsx +332 -332
  160. package/src/dashboard/app/styles/index.css +47 -47
  161. package/src/dashboard/index.html +12 -12
  162. package/src/dashboard/package.json +24 -24
  163. package/src/dashboard/scanner/hooks-scanner.js +41 -41
  164. package/src/dashboard/scanner/phases-scanner.js +15 -15
  165. package/src/dashboard/scanner/rubrics-scanner.js +12 -12
  166. package/src/dashboard/scanner/rules-scanner.js +37 -37
  167. package/src/dashboard/scanner/skills-scanner.js +43 -43
  168. package/src/dashboard/scanner/squads-scanner.js +13 -13
  169. package/src/dashboard/scanner/standards-scanner.js +26 -26
  170. package/src/dashboard/scanner/state-scanner.js +42 -0
  171. package/src/dashboard/vite-plugin-morph-data.js +17 -17
  172. package/src/dashboard/vite.config.js +24 -24
  173. package/src/lib/agents/metrics-aggregator.js +56 -56
  174. package/src/lib/agents/metrics-calculator.js +125 -125
  175. package/src/lib/agents/output-collector.js +73 -73
  176. package/src/lib/detectors/claude-config-detector.js +152 -152
  177. package/src/lib/detectors/design-system-detector.js +231 -231
  178. package/src/lib/detectors/index.js +217 -217
  179. package/src/lib/generators/architecture-scanner.js +639 -639
  180. package/src/lib/generators/design-system-generator.js +508 -508
  181. package/src/lib/generators/index.js +13 -13
  182. package/src/lib/generators/settings-generator.js +209 -209
  183. package/src/lib/hooks/hook-executor.js +167 -167
  184. package/src/lib/installers/mcp-installer.js +719 -719
  185. package/src/lib/installers/memory-installer.js +1 -1
  186. package/src/lib/risk-detector.js +16 -0
  187. package/src/lib/tasks/dispatch-planner.js +122 -4
  188. package/src/lib/tasks/mermaid-renderer.js +132 -0
  189. package/src/lib/tasks/task-classifier.js +30 -30
  190. package/src/lib/tasks/task-parser.js +209 -209
  191. package/src/lib/tasks/test-runner.js +27 -6
  192. package/src/lib/validators/architecture/architecture-validator.js +259 -259
  193. package/src/lib/validators/checkpoint-persistence.js +39 -39
  194. package/src/lib/validators/contracts/contract-compliance-validator.js +274 -274
  195. package/src/lib/validators/css/css-validator.js +340 -340
  196. package/src/lib/validators/packages/package-validator.js +347 -347
  197. package/src/lib/validators/shared/emit-validator-dispatch.js +14 -14
  198. package/src/lib/validators/shared/issue-counter.js +14 -14
  199. package/src/lib/validators/validation-runner.js +349 -349
  200. package/src/lib/validators/verify-runner.js +322 -0
  201. package/src/lib/work-type-detector.js +143 -0
  202. package/src/scripts/setup-infra.js +32 -5
  203. package/src/utils/agent-id-mapper.js +11 -11
  204. package/src/utils/agents-installer.js +10 -6
  205. package/src/utils/claude-settings-manager.js +300 -300
  206. package/src/utils/file-copier.js +43 -0
  207. package/src/utils/hooks-installer.js +43 -34
  208. package/src/utils/skills-installer.js +174 -174
  209. package/framework/hooks/claude-code/core/subagent-report-guard.js +0 -95
  210. package/framework/templates/meta-prompts/parallel-workers/parallel-coordinator.md +0 -113
  211. package/framework/templates/meta-prompts/parallel-workers/parallel-worker.md +0 -80
  212. package/src/lib/tasks/wave-resolver.js +0 -353
@@ -1,273 +1,273 @@
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
- // ─── Node Components ──────────────────────────────────────────────────────────
10
-
11
- function RuleNode({ data }) {
12
- return (
13
- <div
14
- className="rounded-lg px-3 py-2 min-w-[150px] max-w-[180px] cursor-pointer select-none"
15
- style={{
16
- background: '#451a03',
17
- border: `1.5px solid ${data.dimmed ? '#78350f' : '#f59e0b'}`,
18
- boxShadow: data.dimmed ? 'none' : '0 0 8px #f59e0b33',
19
- opacity: data.dimmed ? 0.3 : 1,
20
- }}
21
- >
22
- <Handle type="source" position={Position.Right} style={{ background: '#f59e0b', width: 7, height: 7 }} />
23
- <div className="text-amber-100 text-xs font-semibold leading-tight truncate" title={data.label}>
24
- {data.label}
25
- </div>
26
- <div className="text-amber-400 text-[10px] mt-0.5">
27
- {data.pathCount} glob{data.pathCount !== 1 ? 's' : ''}
28
- {data.stacks?.length > 0 ? ` · ${data.stacks.join(', ')}` : ''}
29
- </div>
30
- </div>
31
- );
32
- }
33
-
34
- function StandardRefNode({ data }) {
35
- return (
36
- <div
37
- className="rounded-lg px-3 py-2 min-w-[140px] max-w-[170px] select-none cursor-default"
38
- style={{
39
- background: '#1e3a5f',
40
- border: `1.5px solid ${data.dimmed ? '#1e40af' : '#3b82f6'}`,
41
- boxShadow: data.dimmed ? 'none' : '0 0 8px #3b82f633',
42
- opacity: data.dimmed ? 0.3 : 1,
43
- }}
44
- >
45
- <Handle type="target" position={Position.Left} style={{ background: '#3b82f6', width: 7, height: 7 }} />
46
- <div className="text-blue-100 text-xs font-semibold leading-tight truncate" title={data.label}>
47
- {data.label}
48
- </div>
49
- <div className="text-blue-400 text-[10px] mt-0.5">standard ref</div>
50
- </div>
51
- );
52
- }
53
-
54
- const nodeTypes = { ruleNode: RuleNode, standardRefNode: StandardRefNode };
55
-
56
- // ─── Graph Builder ────────────────────────────────────────────────────────────
57
-
58
- function buildGraph(rules, search, stackFilter, dimmed) {
59
- const nodes = [];
60
- const edges = [];
61
-
62
- // Collect unique standard refs
63
- const allStdRefs = [...new Set(rules.flatMap((r) => r.standardRefs))];
64
-
65
- // Left column: rules at x=0
66
- const RULE_X = 0;
67
- const STD_X = 320;
68
- const ROW_H = 70;
69
-
70
- // Position rules
71
- const filteredRuleIds = new Set(
72
- rules
73
- .filter((r) => {
74
- const q = search.toLowerCase();
75
- const matchSearch = !q || r.name.toLowerCase().includes(q) || r.stacks.some((s) => s.toLowerCase().includes(q));
76
- const matchStack = !stackFilter || r.stacks.includes(stackFilter);
77
- return matchSearch && matchStack;
78
- })
79
- .map((r) => r.name)
80
- );
81
-
82
- const hasFilter = search || stackFilter;
83
-
84
- rules.forEach((rule, i) => {
85
- const isDimmed = hasFilter && !filteredRuleIds.has(rule.name);
86
- nodes.push({
87
- id: `rule-${rule.name}`,
88
- type: 'ruleNode',
89
- position: { x: RULE_X, y: i * ROW_H },
90
- data: {
91
- label: rule.name,
92
- pathCount: rule.paths.length,
93
- stacks: rule.stacks,
94
- ruleRef: rule,
95
- dimmed: isDimmed,
96
- },
97
- });
98
- });
99
-
100
- // Position standard refs in right column
101
- allStdRefs.forEach((ref, i) => {
102
- const label = ref.replace(/\.md$/, '').split('/').pop();
103
- nodes.push({
104
- id: `std-${ref}`,
105
- type: 'standardRefNode',
106
- position: { x: STD_X, y: i * ROW_H + (rules.length * ROW_H - allStdRefs.length * ROW_H) / 2 },
107
- data: { label, fullPath: ref, dimmed: false },
108
- });
109
- });
110
-
111
- // Edges: rule → its standard refs
112
- for (const rule of rules) {
113
- const isDimmed = hasFilter && !filteredRuleIds.has(rule.name);
114
- for (const ref of rule.standardRefs) {
115
- edges.push({
116
- id: `edge-${rule.name}-${ref}`,
117
- source: `rule-${rule.name}`,
118
- target: `std-${ref}`,
119
- type: 'smoothstep',
120
- style: {
121
- stroke: isDimmed ? '#374151' : '#f59e0b',
122
- strokeWidth: 1.2,
123
- opacity: isDimmed ? 0.2 : 0.6,
124
- },
125
- });
126
- }
127
- }
128
-
129
- return { nodes, edges };
130
- }
131
-
132
- // ─── Detail Content ───────────────────────────────────────────────────────────
133
-
134
- function RuleDetail({ rule }) {
135
- const [showContent, setShowContent] = useState(false);
136
- return (
137
- <div className="text-sm text-gray-200 space-y-4">
138
- <div>
139
- <p className="text-gray-400 text-xs">File: <span className="font-mono text-gray-300">{rule.filename}</span></p>
140
- </div>
141
-
142
- {rule.stacks?.length > 0 && (
143
- <div>
144
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Stacks</p>
145
- <div className="flex flex-wrap gap-1">
146
- {rule.stacks.map((s) => (
147
- <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>
148
- ))}
149
- </div>
150
- </div>
151
- )}
152
-
153
- {rule.paths?.length > 0 && (
154
- <div>
155
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Path Globs</p>
156
- <div className="space-y-1">
157
- {rule.paths.map((p) => (
158
- <code key={p} className="block px-2 py-1 bg-gray-950 border border-gray-800 rounded text-[10px] font-mono text-amber-300">{p}</code>
159
- ))}
160
- </div>
161
- </div>
162
- )}
163
-
164
- {rule.standardRefs?.length > 0 && (
165
- <div>
166
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Standard References</p>
167
- <ul className="space-y-1">
168
- {rule.standardRefs.map((ref) => (
169
- <li key={ref} className="flex items-center gap-2 text-xs">
170
- <span className="w-1.5 h-1.5 rounded-full bg-blue-400 flex-shrink-0" />
171
- <span className="font-mono text-blue-300">{ref}</span>
172
- </li>
173
- ))}
174
- </ul>
175
- </div>
176
- )}
177
-
178
- <div>
179
- <button
180
- onClick={() => setShowContent((v) => !v)}
181
- 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"
182
- >
183
- {showContent ? 'Hide Content' : 'Show Full Content'}
184
- </button>
185
- {showContent && (
186
- <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">
187
- {rule.content}
188
- </pre>
189
- )}
190
- </div>
191
- </div>
192
- );
193
- }
194
-
195
- // ─── Main Page ────────────────────────────────────────────────────────────────
196
-
197
- export default function RulesMap() {
198
- const { rules } = morphData;
199
- const [search, setSearch] = useState('');
200
- const [stackFilter, setStackFilter] = useState('');
201
- const { panel, openPanel, closePanel } = useDetailPanel();
202
-
203
- const allStacks = useMemo(
204
- () => [...new Set(rules.flatMap((r) => r.stacks))].sort(),
205
- [rules]
206
- );
207
-
208
- const { nodes, edges } = useMemo(
209
- () => buildGraph(rules, search, stackFilter),
210
- [rules, search, stackFilter]
211
- );
212
-
213
- const handleNodeClick = useCallback(
214
- (_event, node) => {
215
- if (node.type === 'ruleNode') {
216
- const rule = node.data.ruleRef;
217
- if (rule) openPanel(rule.name, <RuleDetail rule={rule} />);
218
- }
219
- },
220
- [openPanel]
221
- );
222
-
223
- const filterConfig = [
224
- { name: 'stack', label: 'Stack', options: allStacks, value: stackFilter },
225
- ];
226
-
227
- return (
228
- <div className="flex flex-col h-full">
229
- <SearchFilter
230
- placeholder="Search rules by name or stack..."
231
- filters={filterConfig}
232
- onSearchChange={setSearch}
233
- onFilterChange={(name, value) => {
234
- if (name === 'stack') setStackFilter(value);
235
- }}
236
- />
237
-
238
- <div className="flex-1 relative">
239
- <FlowGraph
240
- nodes={nodes}
241
- edges={edges}
242
- nodeTypes={nodeTypes}
243
- onNodeClick={handleNodeClick}
244
- fitView
245
- />
246
-
247
- <div className="absolute top-3 left-3 bg-gray-900/90 border border-gray-700 rounded-lg p-3 text-xs space-y-2 z-10">
248
- <p className="text-gray-400 font-semibold uppercase tracking-wide text-[10px] mb-2">Legend</p>
249
- <div className="flex items-center gap-2">
250
- <span className="inline-block w-4 h-4 rounded-sm" style={{ background: '#451a03', border: '1.5px solid #f59e0b' }} />
251
- <span className="text-gray-300">Rule file</span>
252
- </div>
253
- <div className="flex items-center gap-2">
254
- <span className="inline-block w-4 h-4 rounded-sm" style={{ background: '#1e3a5f', border: '1.5px solid #3b82f6' }} />
255
- <span className="text-gray-300">Standard reference</span>
256
- </div>
257
- <div className="flex items-center gap-2">
258
- <span className="inline-block w-6 border-t border-amber-400 opacity-60" />
259
- <span className="text-gray-400">references</span>
260
- </div>
261
- </div>
262
-
263
- <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">
264
- {rules.length} rules
265
- </div>
266
- </div>
267
-
268
- <DetailPanel open={panel.open} title={panel.title} onClose={closePanel}>
269
- {panel.content}
270
- </DetailPanel>
271
- </div>
272
- );
273
- }
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
+ // ─── Node Components ──────────────────────────────────────────────────────────
10
+
11
+ function RuleNode({ data }) {
12
+ return (
13
+ <div
14
+ className="rounded-lg px-3 py-2 min-w-[150px] max-w-[180px] cursor-pointer select-none"
15
+ style={{
16
+ background: '#451a03',
17
+ border: `1.5px solid ${data.dimmed ? '#78350f' : '#f59e0b'}`,
18
+ boxShadow: data.dimmed ? 'none' : '0 0 8px #f59e0b33',
19
+ opacity: data.dimmed ? 0.3 : 1,
20
+ }}
21
+ >
22
+ <Handle type="source" position={Position.Right} style={{ background: '#f59e0b', width: 7, height: 7 }} />
23
+ <div className="text-amber-100 text-xs font-semibold leading-tight truncate" title={data.label}>
24
+ {data.label}
25
+ </div>
26
+ <div className="text-amber-400 text-[10px] mt-0.5">
27
+ {data.pathCount} glob{data.pathCount !== 1 ? 's' : ''}
28
+ {data.stacks?.length > 0 ? ` · ${data.stacks.join(', ')}` : ''}
29
+ </div>
30
+ </div>
31
+ );
32
+ }
33
+
34
+ function StandardRefNode({ data }) {
35
+ return (
36
+ <div
37
+ className="rounded-lg px-3 py-2 min-w-[140px] max-w-[170px] select-none cursor-default"
38
+ style={{
39
+ background: '#1e3a5f',
40
+ border: `1.5px solid ${data.dimmed ? '#1e40af' : '#3b82f6'}`,
41
+ boxShadow: data.dimmed ? 'none' : '0 0 8px #3b82f633',
42
+ opacity: data.dimmed ? 0.3 : 1,
43
+ }}
44
+ >
45
+ <Handle type="target" position={Position.Left} style={{ background: '#3b82f6', width: 7, height: 7 }} />
46
+ <div className="text-blue-100 text-xs font-semibold leading-tight truncate" title={data.label}>
47
+ {data.label}
48
+ </div>
49
+ <div className="text-blue-400 text-[10px] mt-0.5">standard ref</div>
50
+ </div>
51
+ );
52
+ }
53
+
54
+ const nodeTypes = { ruleNode: RuleNode, standardRefNode: StandardRefNode };
55
+
56
+ // ─── Graph Builder ────────────────────────────────────────────────────────────
57
+
58
+ function buildGraph(rules, search, stackFilter, dimmed) {
59
+ const nodes = [];
60
+ const edges = [];
61
+
62
+ // Collect unique standard refs
63
+ const allStdRefs = [...new Set(rules.flatMap((r) => r.standardRefs))];
64
+
65
+ // Left column: rules at x=0
66
+ const RULE_X = 0;
67
+ const STD_X = 320;
68
+ const ROW_H = 70;
69
+
70
+ // Position rules
71
+ const filteredRuleIds = new Set(
72
+ rules
73
+ .filter((r) => {
74
+ const q = search.toLowerCase();
75
+ const matchSearch = !q || r.name.toLowerCase().includes(q) || r.stacks.some((s) => s.toLowerCase().includes(q));
76
+ const matchStack = !stackFilter || r.stacks.includes(stackFilter);
77
+ return matchSearch && matchStack;
78
+ })
79
+ .map((r) => r.name)
80
+ );
81
+
82
+ const hasFilter = search || stackFilter;
83
+
84
+ rules.forEach((rule, i) => {
85
+ const isDimmed = hasFilter && !filteredRuleIds.has(rule.name);
86
+ nodes.push({
87
+ id: `rule-${rule.name}`,
88
+ type: 'ruleNode',
89
+ position: { x: RULE_X, y: i * ROW_H },
90
+ data: {
91
+ label: rule.name,
92
+ pathCount: rule.paths.length,
93
+ stacks: rule.stacks,
94
+ ruleRef: rule,
95
+ dimmed: isDimmed,
96
+ },
97
+ });
98
+ });
99
+
100
+ // Position standard refs in right column
101
+ allStdRefs.forEach((ref, i) => {
102
+ const label = ref.replace(/\.md$/, '').split('/').pop();
103
+ nodes.push({
104
+ id: `std-${ref}`,
105
+ type: 'standardRefNode',
106
+ position: { x: STD_X, y: i * ROW_H + (rules.length * ROW_H - allStdRefs.length * ROW_H) / 2 },
107
+ data: { label, fullPath: ref, dimmed: false },
108
+ });
109
+ });
110
+
111
+ // Edges: rule → its standard refs
112
+ for (const rule of rules) {
113
+ const isDimmed = hasFilter && !filteredRuleIds.has(rule.name);
114
+ for (const ref of rule.standardRefs) {
115
+ edges.push({
116
+ id: `edge-${rule.name}-${ref}`,
117
+ source: `rule-${rule.name}`,
118
+ target: `std-${ref}`,
119
+ type: 'smoothstep',
120
+ style: {
121
+ stroke: isDimmed ? '#374151' : '#f59e0b',
122
+ strokeWidth: 1.2,
123
+ opacity: isDimmed ? 0.2 : 0.6,
124
+ },
125
+ });
126
+ }
127
+ }
128
+
129
+ return { nodes, edges };
130
+ }
131
+
132
+ // ─── Detail Content ───────────────────────────────────────────────────────────
133
+
134
+ function RuleDetail({ rule }) {
135
+ const [showContent, setShowContent] = useState(false);
136
+ return (
137
+ <div className="text-sm text-gray-200 space-y-4">
138
+ <div>
139
+ <p className="text-gray-400 text-xs">File: <span className="font-mono text-gray-300">{rule.filename}</span></p>
140
+ </div>
141
+
142
+ {rule.stacks?.length > 0 && (
143
+ <div>
144
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Stacks</p>
145
+ <div className="flex flex-wrap gap-1">
146
+ {rule.stacks.map((s) => (
147
+ <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>
148
+ ))}
149
+ </div>
150
+ </div>
151
+ )}
152
+
153
+ {rule.paths?.length > 0 && (
154
+ <div>
155
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Path Globs</p>
156
+ <div className="space-y-1">
157
+ {rule.paths.map((p) => (
158
+ <code key={p} className="block px-2 py-1 bg-gray-950 border border-gray-800 rounded text-[10px] font-mono text-amber-300">{p}</code>
159
+ ))}
160
+ </div>
161
+ </div>
162
+ )}
163
+
164
+ {rule.standardRefs?.length > 0 && (
165
+ <div>
166
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Standard References</p>
167
+ <ul className="space-y-1">
168
+ {rule.standardRefs.map((ref) => (
169
+ <li key={ref} className="flex items-center gap-2 text-xs">
170
+ <span className="w-1.5 h-1.5 rounded-full bg-blue-400 flex-shrink-0" />
171
+ <span className="font-mono text-blue-300">{ref}</span>
172
+ </li>
173
+ ))}
174
+ </ul>
175
+ </div>
176
+ )}
177
+
178
+ <div>
179
+ <button
180
+ onClick={() => setShowContent((v) => !v)}
181
+ 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"
182
+ >
183
+ {showContent ? 'Hide Content' : 'Show Full Content'}
184
+ </button>
185
+ {showContent && (
186
+ <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">
187
+ {rule.content}
188
+ </pre>
189
+ )}
190
+ </div>
191
+ </div>
192
+ );
193
+ }
194
+
195
+ // ─── Main Page ────────────────────────────────────────────────────────────────
196
+
197
+ export default function RulesMap() {
198
+ const { rules } = morphData;
199
+ const [search, setSearch] = useState('');
200
+ const [stackFilter, setStackFilter] = useState('');
201
+ const { panel, openPanel, closePanel } = useDetailPanel();
202
+
203
+ const allStacks = useMemo(
204
+ () => [...new Set(rules.flatMap((r) => r.stacks))].sort(),
205
+ [rules]
206
+ );
207
+
208
+ const { nodes, edges } = useMemo(
209
+ () => buildGraph(rules, search, stackFilter),
210
+ [rules, search, stackFilter]
211
+ );
212
+
213
+ const handleNodeClick = useCallback(
214
+ (_event, node) => {
215
+ if (node.type === 'ruleNode') {
216
+ const rule = node.data.ruleRef;
217
+ if (rule) openPanel(rule.name, <RuleDetail rule={rule} />);
218
+ }
219
+ },
220
+ [openPanel]
221
+ );
222
+
223
+ const filterConfig = [
224
+ { name: 'stack', label: 'Stack', options: allStacks, value: stackFilter },
225
+ ];
226
+
227
+ return (
228
+ <div className="flex flex-col h-full">
229
+ <SearchFilter
230
+ placeholder="Search rules by name or stack..."
231
+ filters={filterConfig}
232
+ onSearchChange={setSearch}
233
+ onFilterChange={(name, value) => {
234
+ if (name === 'stack') setStackFilter(value);
235
+ }}
236
+ />
237
+
238
+ <div className="flex-1 relative">
239
+ <FlowGraph
240
+ nodes={nodes}
241
+ edges={edges}
242
+ nodeTypes={nodeTypes}
243
+ onNodeClick={handleNodeClick}
244
+ fitView
245
+ />
246
+
247
+ <div className="absolute top-3 left-3 bg-gray-900/90 border border-gray-700 rounded-lg p-3 text-xs space-y-2 z-10">
248
+ <p className="text-gray-400 font-semibold uppercase tracking-wide text-[10px] mb-2">Legend</p>
249
+ <div className="flex items-center gap-2">
250
+ <span className="inline-block w-4 h-4 rounded-sm" style={{ background: '#451a03', border: '1.5px solid #f59e0b' }} />
251
+ <span className="text-gray-300">Rule file</span>
252
+ </div>
253
+ <div className="flex items-center gap-2">
254
+ <span className="inline-block w-4 h-4 rounded-sm" style={{ background: '#1e3a5f', border: '1.5px solid #3b82f6' }} />
255
+ <span className="text-gray-300">Standard reference</span>
256
+ </div>
257
+ <div className="flex items-center gap-2">
258
+ <span className="inline-block w-6 border-t border-amber-400 opacity-60" />
259
+ <span className="text-gray-400">references</span>
260
+ </div>
261
+ </div>
262
+
263
+ <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">
264
+ {rules.length} rules
265
+ </div>
266
+ </div>
267
+
268
+ <DetailPanel open={panel.open} title={panel.title} onClose={closePanel}>
269
+ {panel.content}
270
+ </DetailPanel>
271
+ </div>
272
+ );
273
+ }