@agile-vibe-coding/avc 0.1.1 → 0.2.3

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 (289) hide show
  1. package/cli/agent-loader.js +21 -0
  2. package/cli/agents/agent-selector.md +129 -0
  3. package/cli/agents/architecture-recommender.md +418 -0
  4. package/cli/agents/database-deep-dive.md +470 -0
  5. package/cli/agents/database-recommender.md +634 -0
  6. package/cli/agents/doc-distributor.md +176 -0
  7. package/cli/agents/documentation-updater.md +203 -0
  8. package/cli/agents/epic-story-decomposer.md +280 -0
  9. package/cli/agents/feature-context-generator.md +91 -0
  10. package/cli/agents/gap-checker-epic.md +52 -0
  11. package/cli/agents/impact-checker-story.md +51 -0
  12. package/cli/agents/migration-guide-generator.md +305 -0
  13. package/cli/agents/mission-scope-generator.md +79 -0
  14. package/cli/agents/mission-scope-validator.md +112 -0
  15. package/cli/agents/project-context-extractor.md +107 -0
  16. package/cli/agents/project-documentation-creator.json +226 -0
  17. package/cli/agents/project-documentation-creator.md +595 -0
  18. package/cli/agents/question-prefiller.md +269 -0
  19. package/cli/agents/refiner-epic.md +39 -0
  20. package/cli/agents/refiner-story.md +42 -0
  21. package/cli/agents/solver-epic-api.json +15 -0
  22. package/cli/agents/solver-epic-api.md +39 -0
  23. package/cli/agents/solver-epic-backend.json +15 -0
  24. package/cli/agents/solver-epic-backend.md +39 -0
  25. package/cli/agents/solver-epic-cloud.json +15 -0
  26. package/cli/agents/solver-epic-cloud.md +39 -0
  27. package/cli/agents/solver-epic-data.json +15 -0
  28. package/cli/agents/solver-epic-data.md +39 -0
  29. package/cli/agents/solver-epic-database.json +15 -0
  30. package/cli/agents/solver-epic-database.md +39 -0
  31. package/cli/agents/solver-epic-developer.json +15 -0
  32. package/cli/agents/solver-epic-developer.md +39 -0
  33. package/cli/agents/solver-epic-devops.json +15 -0
  34. package/cli/agents/solver-epic-devops.md +39 -0
  35. package/cli/agents/solver-epic-frontend.json +15 -0
  36. package/cli/agents/solver-epic-frontend.md +39 -0
  37. package/cli/agents/solver-epic-mobile.json +15 -0
  38. package/cli/agents/solver-epic-mobile.md +39 -0
  39. package/cli/agents/solver-epic-qa.json +15 -0
  40. package/cli/agents/solver-epic-qa.md +39 -0
  41. package/cli/agents/solver-epic-security.json +15 -0
  42. package/cli/agents/solver-epic-security.md +39 -0
  43. package/cli/agents/solver-epic-solution-architect.json +15 -0
  44. package/cli/agents/solver-epic-solution-architect.md +39 -0
  45. package/cli/agents/solver-epic-test-architect.json +15 -0
  46. package/cli/agents/solver-epic-test-architect.md +39 -0
  47. package/cli/agents/solver-epic-ui.json +15 -0
  48. package/cli/agents/solver-epic-ui.md +39 -0
  49. package/cli/agents/solver-epic-ux.json +15 -0
  50. package/cli/agents/solver-epic-ux.md +39 -0
  51. package/cli/agents/solver-story-api.json +15 -0
  52. package/cli/agents/solver-story-api.md +39 -0
  53. package/cli/agents/solver-story-backend.json +15 -0
  54. package/cli/agents/solver-story-backend.md +39 -0
  55. package/cli/agents/solver-story-cloud.json +15 -0
  56. package/cli/agents/solver-story-cloud.md +39 -0
  57. package/cli/agents/solver-story-data.json +15 -0
  58. package/cli/agents/solver-story-data.md +39 -0
  59. package/cli/agents/solver-story-database.json +15 -0
  60. package/cli/agents/solver-story-database.md +39 -0
  61. package/cli/agents/solver-story-developer.json +15 -0
  62. package/cli/agents/solver-story-developer.md +39 -0
  63. package/cli/agents/solver-story-devops.json +15 -0
  64. package/cli/agents/solver-story-devops.md +39 -0
  65. package/cli/agents/solver-story-frontend.json +15 -0
  66. package/cli/agents/solver-story-frontend.md +39 -0
  67. package/cli/agents/solver-story-mobile.json +15 -0
  68. package/cli/agents/solver-story-mobile.md +39 -0
  69. package/cli/agents/solver-story-qa.json +15 -0
  70. package/cli/agents/solver-story-qa.md +39 -0
  71. package/cli/agents/solver-story-security.json +15 -0
  72. package/cli/agents/solver-story-security.md +39 -0
  73. package/cli/agents/solver-story-solution-architect.json +15 -0
  74. package/cli/agents/solver-story-solution-architect.md +39 -0
  75. package/cli/agents/solver-story-test-architect.json +15 -0
  76. package/cli/agents/solver-story-test-architect.md +39 -0
  77. package/cli/agents/solver-story-ui.json +15 -0
  78. package/cli/agents/solver-story-ui.md +39 -0
  79. package/cli/agents/solver-story-ux.json +15 -0
  80. package/cli/agents/solver-story-ux.md +39 -0
  81. package/cli/agents/story-doc-enricher.md +133 -0
  82. package/cli/agents/suggestion-business-analyst.md +88 -0
  83. package/cli/agents/suggestion-deployment-architect.md +263 -0
  84. package/cli/agents/suggestion-product-manager.md +129 -0
  85. package/cli/agents/suggestion-security-specialist.md +156 -0
  86. package/cli/agents/suggestion-technical-architect.md +269 -0
  87. package/cli/agents/suggestion-ux-researcher.md +93 -0
  88. package/cli/agents/task-subtask-decomposer.md +188 -0
  89. package/cli/agents/validator-documentation.json +152 -0
  90. package/cli/agents/validator-documentation.md +453 -0
  91. package/cli/agents/validator-epic-api.json +93 -0
  92. package/cli/agents/validator-epic-api.md +137 -0
  93. package/cli/agents/validator-epic-backend.json +93 -0
  94. package/cli/agents/validator-epic-backend.md +130 -0
  95. package/cli/agents/validator-epic-cloud.json +93 -0
  96. package/cli/agents/validator-epic-cloud.md +137 -0
  97. package/cli/agents/validator-epic-data.json +93 -0
  98. package/cli/agents/validator-epic-data.md +130 -0
  99. package/cli/agents/validator-epic-database.json +93 -0
  100. package/cli/agents/validator-epic-database.md +137 -0
  101. package/cli/agents/validator-epic-developer.json +74 -0
  102. package/cli/agents/validator-epic-developer.md +153 -0
  103. package/cli/agents/validator-epic-devops.json +74 -0
  104. package/cli/agents/validator-epic-devops.md +153 -0
  105. package/cli/agents/validator-epic-frontend.json +74 -0
  106. package/cli/agents/validator-epic-frontend.md +153 -0
  107. package/cli/agents/validator-epic-mobile.json +93 -0
  108. package/cli/agents/validator-epic-mobile.md +130 -0
  109. package/cli/agents/validator-epic-qa.json +93 -0
  110. package/cli/agents/validator-epic-qa.md +130 -0
  111. package/cli/agents/validator-epic-security.json +74 -0
  112. package/cli/agents/validator-epic-security.md +154 -0
  113. package/cli/agents/validator-epic-solution-architect.json +74 -0
  114. package/cli/agents/validator-epic-solution-architect.md +156 -0
  115. package/cli/agents/validator-epic-test-architect.json +93 -0
  116. package/cli/agents/validator-epic-test-architect.md +130 -0
  117. package/cli/agents/validator-epic-ui.json +93 -0
  118. package/cli/agents/validator-epic-ui.md +130 -0
  119. package/cli/agents/validator-epic-ux.json +93 -0
  120. package/cli/agents/validator-epic-ux.md +130 -0
  121. package/cli/agents/validator-selector.md +211 -0
  122. package/cli/agents/validator-story-api.json +104 -0
  123. package/cli/agents/validator-story-api.md +152 -0
  124. package/cli/agents/validator-story-backend.json +104 -0
  125. package/cli/agents/validator-story-backend.md +152 -0
  126. package/cli/agents/validator-story-cloud.json +104 -0
  127. package/cli/agents/validator-story-cloud.md +152 -0
  128. package/cli/agents/validator-story-data.json +104 -0
  129. package/cli/agents/validator-story-data.md +152 -0
  130. package/cli/agents/validator-story-database.json +104 -0
  131. package/cli/agents/validator-story-database.md +152 -0
  132. package/cli/agents/validator-story-developer.json +104 -0
  133. package/cli/agents/validator-story-developer.md +152 -0
  134. package/cli/agents/validator-story-devops.json +104 -0
  135. package/cli/agents/validator-story-devops.md +152 -0
  136. package/cli/agents/validator-story-frontend.json +104 -0
  137. package/cli/agents/validator-story-frontend.md +152 -0
  138. package/cli/agents/validator-story-mobile.json +104 -0
  139. package/cli/agents/validator-story-mobile.md +152 -0
  140. package/cli/agents/validator-story-qa.json +104 -0
  141. package/cli/agents/validator-story-qa.md +152 -0
  142. package/cli/agents/validator-story-security.json +104 -0
  143. package/cli/agents/validator-story-security.md +152 -0
  144. package/cli/agents/validator-story-solution-architect.json +104 -0
  145. package/cli/agents/validator-story-solution-architect.md +152 -0
  146. package/cli/agents/validator-story-test-architect.json +104 -0
  147. package/cli/agents/validator-story-test-architect.md +152 -0
  148. package/cli/agents/validator-story-ui.json +104 -0
  149. package/cli/agents/validator-story-ui.md +152 -0
  150. package/cli/agents/validator-story-ux.json +104 -0
  151. package/cli/agents/validator-story-ux.md +152 -0
  152. package/cli/ansi-colors.js +21 -0
  153. package/cli/build-docs.js +29 -8
  154. package/cli/ceremony-history.js +369 -0
  155. package/cli/command-logger.js +49 -12
  156. package/cli/components/static-output.js +63 -0
  157. package/cli/console-output-manager.js +94 -0
  158. package/cli/docs-sync.js +306 -0
  159. package/cli/epic-story-validator.js +1174 -0
  160. package/cli/evaluation-prompts.js +1008 -0
  161. package/cli/execution-context.js +195 -0
  162. package/cli/generate-summary-table.js +340 -0
  163. package/cli/index.js +0 -0
  164. package/cli/init-model-config.js +697 -0
  165. package/cli/init.js +1311 -274
  166. package/cli/kanban-server-manager.js +228 -0
  167. package/cli/llm-claude.js +83 -1
  168. package/cli/llm-gemini.js +85 -0
  169. package/cli/llm-mock.js +233 -0
  170. package/cli/llm-openai.js +233 -0
  171. package/cli/llm-provider.js +240 -3
  172. package/cli/llm-token-limits.js +102 -0
  173. package/cli/llm-verifier.js +454 -0
  174. package/cli/message-constants.js +58 -0
  175. package/cli/message-manager.js +334 -0
  176. package/cli/message-types.js +96 -0
  177. package/cli/messaging-api.js +297 -0
  178. package/cli/model-pricing.js +169 -0
  179. package/cli/model-query-engine.js +468 -0
  180. package/cli/model-recommendation-analyzer.js +495 -0
  181. package/cli/model-selector.js +269 -0
  182. package/cli/output-buffer.js +107 -0
  183. package/cli/process-manager.js +73 -2
  184. package/cli/repl-ink.js +4988 -1217
  185. package/cli/repl-old.js +4 -4
  186. package/cli/seed-processor.js +792 -0
  187. package/cli/sprint-planning-processor.js +1813 -0
  188. package/cli/template-processor.js +2102 -105
  189. package/cli/templates/project.md +25 -8
  190. package/cli/templates/vitepress-config.mts.template +5 -4
  191. package/cli/token-tracker.js +520 -0
  192. package/cli/tools/generate-story-validators.js +317 -0
  193. package/cli/tools/generate-validators.js +669 -0
  194. package/cli/update-checker.js +19 -17
  195. package/cli/update-notifier.js +4 -4
  196. package/cli/validation-router.js +605 -0
  197. package/cli/verification-tracker.js +563 -0
  198. package/kanban/README.md +386 -0
  199. package/kanban/client/README.md +205 -0
  200. package/kanban/client/components.json +20 -0
  201. package/kanban/client/dist/assets/index-CiD8PS2e.js +306 -0
  202. package/kanban/client/dist/assets/index-nLh0m82Q.css +1 -0
  203. package/kanban/client/dist/index.html +16 -0
  204. package/kanban/client/dist/vite.svg +1 -0
  205. package/kanban/client/index.html +15 -0
  206. package/kanban/client/package-lock.json +9442 -0
  207. package/kanban/client/package.json +44 -0
  208. package/kanban/client/postcss.config.js +6 -0
  209. package/kanban/client/public/vite.svg +1 -0
  210. package/kanban/client/src/App.jsx +622 -0
  211. package/kanban/client/src/components/ProjectFileEditorPopup.jsx +117 -0
  212. package/kanban/client/src/components/ceremony/AskArchPopup.jsx +416 -0
  213. package/kanban/client/src/components/ceremony/AskModelPopup.jsx +616 -0
  214. package/kanban/client/src/components/ceremony/CeremonyWorkflowModal.jsx +946 -0
  215. package/kanban/client/src/components/ceremony/EpicStorySelectionModal.jsx +254 -0
  216. package/kanban/client/src/components/ceremony/SponsorCallModal.jsx +619 -0
  217. package/kanban/client/src/components/ceremony/SprintPlanningModal.jsx +704 -0
  218. package/kanban/client/src/components/ceremony/steps/ArchitectureStep.jsx +150 -0
  219. package/kanban/client/src/components/ceremony/steps/CompleteStep.jsx +154 -0
  220. package/kanban/client/src/components/ceremony/steps/DatabaseStep.jsx +202 -0
  221. package/kanban/client/src/components/ceremony/steps/DeploymentStep.jsx +123 -0
  222. package/kanban/client/src/components/ceremony/steps/MissionStep.jsx +106 -0
  223. package/kanban/client/src/components/ceremony/steps/ReviewAnswersStep.jsx +125 -0
  224. package/kanban/client/src/components/ceremony/steps/RunningStep.jsx +228 -0
  225. package/kanban/client/src/components/kanban/CardDetailModal.jsx +559 -0
  226. package/kanban/client/src/components/kanban/EpicSection.jsx +146 -0
  227. package/kanban/client/src/components/kanban/FilterToolbar.jsx +222 -0
  228. package/kanban/client/src/components/kanban/GroupingSelector.jsx +57 -0
  229. package/kanban/client/src/components/kanban/KanbanBoard.jsx +211 -0
  230. package/kanban/client/src/components/kanban/KanbanCard.jsx +138 -0
  231. package/kanban/client/src/components/kanban/KanbanColumn.jsx +90 -0
  232. package/kanban/client/src/components/kanban/RefineWorkItemPopup.jsx +789 -0
  233. package/kanban/client/src/components/layout/LoadingScreen.jsx +82 -0
  234. package/kanban/client/src/components/process/ProcessMonitorBar.jsx +80 -0
  235. package/kanban/client/src/components/settings/AgentEditorPopup.jsx +171 -0
  236. package/kanban/client/src/components/settings/AgentsTab.jsx +353 -0
  237. package/kanban/client/src/components/settings/ApiKeysTab.jsx +113 -0
  238. package/kanban/client/src/components/settings/CeremonyModelsTab.jsx +98 -0
  239. package/kanban/client/src/components/settings/CostThresholdsTab.jsx +94 -0
  240. package/kanban/client/src/components/settings/ModelPricingTab.jsx +204 -0
  241. package/kanban/client/src/components/settings/ServersTab.jsx +121 -0
  242. package/kanban/client/src/components/settings/SettingsModal.jsx +84 -0
  243. package/kanban/client/src/components/stats/CostModal.jsx +353 -0
  244. package/kanban/client/src/components/ui/badge.jsx +27 -0
  245. package/kanban/client/src/components/ui/dialog.jsx +121 -0
  246. package/kanban/client/src/components/ui/tabs.jsx +85 -0
  247. package/kanban/client/src/hooks/__tests__/useGrouping.test.js +232 -0
  248. package/kanban/client/src/hooks/useGrouping.js +118 -0
  249. package/kanban/client/src/hooks/useWebSocket.js +120 -0
  250. package/kanban/client/src/lib/__tests__/api.test.js +196 -0
  251. package/kanban/client/src/lib/__tests__/status-grouping.test.js +94 -0
  252. package/kanban/client/src/lib/api.js +401 -0
  253. package/kanban/client/src/lib/status-grouping.js +144 -0
  254. package/kanban/client/src/lib/utils.js +11 -0
  255. package/kanban/client/src/main.jsx +10 -0
  256. package/kanban/client/src/store/__tests__/kanbanStore.test.js +164 -0
  257. package/kanban/client/src/store/ceremonyStore.js +172 -0
  258. package/kanban/client/src/store/filterStore.js +201 -0
  259. package/kanban/client/src/store/kanbanStore.js +115 -0
  260. package/kanban/client/src/store/processStore.js +65 -0
  261. package/kanban/client/src/store/sprintPlanningStore.js +33 -0
  262. package/kanban/client/src/styles/globals.css +59 -0
  263. package/kanban/client/tailwind.config.js +77 -0
  264. package/kanban/client/vite.config.js +28 -0
  265. package/kanban/client/vitest.config.js +28 -0
  266. package/kanban/dev-start.sh +47 -0
  267. package/kanban/package.json +12 -0
  268. package/kanban/server/index.js +516 -0
  269. package/kanban/server/routes/ceremony.js +305 -0
  270. package/kanban/server/routes/costs.js +157 -0
  271. package/kanban/server/routes/processes.js +50 -0
  272. package/kanban/server/routes/settings.js +303 -0
  273. package/kanban/server/routes/websocket.js +276 -0
  274. package/kanban/server/routes/work-items.js +347 -0
  275. package/kanban/server/services/CeremonyService.js +1190 -0
  276. package/kanban/server/services/FileSystemScanner.js +95 -0
  277. package/kanban/server/services/FileWatcher.js +144 -0
  278. package/kanban/server/services/HierarchyBuilder.js +196 -0
  279. package/kanban/server/services/ProcessRegistry.js +122 -0
  280. package/kanban/server/services/WorkItemReader.js +123 -0
  281. package/kanban/server/services/WorkItemRefineService.js +510 -0
  282. package/kanban/server/start.js +49 -0
  283. package/kanban/server/utils/kanban-logger.js +132 -0
  284. package/kanban/server/utils/markdown.js +91 -0
  285. package/kanban/server/utils/status-grouping.js +107 -0
  286. package/kanban/server/workers/sponsor-call-worker.js +84 -0
  287. package/kanban/server/workers/sprint-planning-worker.js +130 -0
  288. package/package.json +18 -5
  289. package/cli/agents/documentation.md +0 -302
@@ -0,0 +1,559 @@
1
+ import { useState, useEffect } from 'react';
2
+ import {
3
+ Dialog,
4
+ DialogContent,
5
+ DialogHeader,
6
+ DialogTitle,
7
+ DialogDescription,
8
+ } from '../ui/dialog';
9
+ import { Tabs, TabsList, TabsTrigger, TabsContent } from '../ui/tabs';
10
+ import { Badge } from '../ui/badge';
11
+ import {
12
+ FileText,
13
+ BookOpen,
14
+ Users,
15
+ Link2,
16
+ Calendar,
17
+ Package,
18
+ ChevronLeft,
19
+ ChevronRight,
20
+ Pencil,
21
+ X,
22
+ Save,
23
+ ChevronUp,
24
+ Wand2,
25
+ } from 'lucide-react';
26
+ import {
27
+ getWorkItem,
28
+ getWorkItemDoc,
29
+ getWorkItemDocRaw,
30
+ updateWorkItemDoc,
31
+ getProjectDoc,
32
+ } from '../../lib/api';
33
+ import { getStatusMetadata } from '../../lib/status-grouping';
34
+ import { cn } from '../../lib/utils';
35
+ import { RefineWorkItemPopup } from './RefineWorkItemPopup';
36
+
37
+ /**
38
+ * Clickable item box — same visual style as the children list.
39
+ */
40
+ function ItemBox({ item, fallbackName, fallbackId, onItemClick }) {
41
+ const typeMeta = item ? TYPE_METADATA[item.type] : null;
42
+ const statusMeta = item ? getStatusMetadata(item.status) : null;
43
+
44
+ return (
45
+ <button
46
+ onClick={() => item && onItemClick?.(item)}
47
+ disabled={!item}
48
+ className="w-full text-left p-4 border border-slate-200 rounded-lg hover:border-blue-300 hover:bg-blue-50 transition-colors disabled:opacity-50 disabled:cursor-default"
49
+ >
50
+ <div className="flex items-start justify-between">
51
+ <div className="flex-1 min-w-0">
52
+ <p className="font-medium text-slate-900 mb-1 truncate">{item?.name ?? fallbackName}</p>
53
+ {item?.description && (
54
+ <p className="text-xs text-slate-500 mb-1 line-clamp-2">{item.description}</p>
55
+ )}
56
+ {(statusMeta || typeMeta) && (
57
+ <div className="flex items-center gap-2 mt-1">
58
+ {statusMeta && (
59
+ <Badge variant="secondary" className={cn(
60
+ 'text-xs',
61
+ statusMeta.color === 'green' && 'bg-green-100 text-green-700',
62
+ statusMeta.color === 'blue' && 'bg-blue-100 text-blue-700',
63
+ statusMeta.color === 'yellow' && 'bg-yellow-100 text-yellow-700',
64
+ statusMeta.color === 'purple' && 'bg-purple-100 text-purple-700',
65
+ statusMeta.color === 'red' && 'bg-red-100 text-red-700',
66
+ )}>
67
+ {statusMeta.icon} {statusMeta.label}
68
+ </Badge>
69
+ )}
70
+ {typeMeta && (
71
+ <Badge variant="outline" className="text-xs">
72
+ {typeMeta.icon} {typeMeta.label}
73
+ </Badge>
74
+ )}
75
+ </div>
76
+ )}
77
+ </div>
78
+ {item && <ChevronRight className="w-4 h-4 text-slate-400 mt-1 flex-shrink-0 ml-2" />}
79
+ </div>
80
+ </button>
81
+ );
82
+ }
83
+
84
+ /**
85
+ * Inline viewer for a parent's (or project root's) doc or context file.
86
+ * item = { id, name } for work items, or { id: 'project', name: 'Project' } for root.
87
+ */
88
+ function ParentFileLink({ item }) {
89
+ const [expanded, setExpanded] = useState(false);
90
+ const [html, setHtml] = useState(null);
91
+
92
+ const load = async () => {
93
+ if (html !== null) { setExpanded(!expanded); return; }
94
+ const content = item.id === 'project'
95
+ ? await getProjectDoc()
96
+ : await getWorkItemDoc(item.id).catch(() => '');
97
+ setHtml(content || '<p class="text-slate-400 italic">No content</p>');
98
+ setExpanded(true);
99
+ };
100
+
101
+ const isProject = item.id === 'project';
102
+
103
+ return (
104
+ <div className="w-full">
105
+ <button
106
+ onClick={load}
107
+ className={`inline-flex items-center gap-1 px-2 py-0.5 rounded font-medium ${
108
+ isProject
109
+ ? 'bg-indigo-50 hover:bg-indigo-100 text-indigo-700'
110
+ : 'bg-slate-100 hover:bg-slate-200 text-slate-600'
111
+ }`}
112
+ >
113
+ {expanded ? <ChevronUp className="w-3 h-3" /> : <ChevronRight className="w-3 h-3" />}
114
+ {item.name} — doc.md
115
+ </button>
116
+ {expanded && html && (
117
+ <div className="mt-2 ml-4 p-3 border-l-2 border-slate-200 prose prose-sm prose-slate max-w-none">
118
+ <div dangerouslySetInnerHTML={{ __html: html }} />
119
+ </div>
120
+ )}
121
+ </div>
122
+ );
123
+ }
124
+
125
+ /**
126
+ * Work item type metadata
127
+ */
128
+ const TYPE_METADATA = {
129
+ epic: { color: 'indigo', icon: '🏛️', label: 'Epic' },
130
+ story: { color: 'blue', icon: '📖', label: 'Story' },
131
+ task: { color: 'emerald', icon: '⚙️', label: 'Task' },
132
+ subtask: { color: 'gray', icon: '📝', label: 'Subtask' },
133
+ };
134
+
135
+ /**
136
+ * Card Detail Modal Component
137
+ * Displays full work item details with tabbed sections
138
+ */
139
+ export function CardDetailModal({ workItem, open, onOpenChange, onNavigate, onItemClick, allItems, refineProgress, refineResult, refineError, onClearRefine }) {
140
+ const [activeTab, setActiveTab] = useState('documentation');
141
+ const [fullDetails, setFullDetails] = useState(null);
142
+ const [documentation, setDocumentation] = useState(null);
143
+ const [loading, setLoading] = useState(false);
144
+ const [error, setError] = useState(null);
145
+
146
+ // Edit mode state
147
+ const [editingDoc, setEditingDoc] = useState(false);
148
+ const [docDraft, setDocDraft] = useState('');
149
+ const [saving, setSaving] = useState(false);
150
+
151
+ // Parent chain for navigation
152
+ const [parentChain, setParentChain] = useState([]);
153
+
154
+ // Refine popup state
155
+ const [refineOpen, setRefineOpen] = useState(false);
156
+
157
+ // Reload full details after a successful refine apply
158
+ const handleRefineAccepted = () => {
159
+ setRefineOpen(false);
160
+ onClearRefine?.();
161
+ loadFullDetails();
162
+ };
163
+
164
+ // Load full details when modal opens
165
+ useEffect(() => {
166
+ if (open && workItem) {
167
+ loadFullDetails();
168
+ }
169
+ }, [open, workItem?.id]);
170
+
171
+ // Fall back to 'details' tab if no doc.md available
172
+ useEffect(() => {
173
+ if (!loading && documentation === null) setActiveTab('details');
174
+ }, [loading, documentation]);
175
+
176
+ // Keyboard navigation
177
+ useEffect(() => {
178
+ if (!open) return;
179
+
180
+ const handleKeyPress = (e) => {
181
+ if (e.key === 'ArrowLeft') {
182
+ onNavigate?.('prev');
183
+ } else if (e.key === 'ArrowRight') {
184
+ onNavigate?.('next');
185
+ }
186
+ };
187
+
188
+ document.addEventListener('keydown', handleKeyPress);
189
+ return () => document.removeEventListener('keydown', handleKeyPress);
190
+ }, [open, onNavigate]);
191
+
192
+ const loadFullDetails = async () => {
193
+ if (!workItem) return;
194
+
195
+ setLoading(true);
196
+ setError(null);
197
+ setEditingDoc(false);
198
+
199
+ try {
200
+ const details = await getWorkItem(workItem.id);
201
+ setFullDetails(details);
202
+
203
+ // Build parent chain: project root → … → grandparent → parent
204
+ const chain = [{ id: 'project', name: 'Project' }];
205
+ if (allItems) {
206
+ const ancestors = [];
207
+ let parentId = details.parentId;
208
+ while (parentId) {
209
+ const parent = allItems.find((i) => i.id === parentId);
210
+ if (!parent) break;
211
+ ancestors.unshift(parent);
212
+ parentId = parent.parentId;
213
+ }
214
+ chain.push(...ancestors);
215
+ }
216
+ setParentChain(chain);
217
+
218
+ const doc = await getWorkItemDoc(workItem.id).catch(() => null);
219
+ setDocumentation(doc || null);
220
+ } catch (err) {
221
+ setError(err.message);
222
+ console.error('Failed to load work item details:', err);
223
+ } finally {
224
+ setLoading(false);
225
+ }
226
+ };
227
+
228
+ const startEditDoc = async () => {
229
+ const raw = await getWorkItemDocRaw(workItem.id);
230
+ setDocDraft(raw);
231
+ setEditingDoc(true);
232
+ };
233
+
234
+ const saveDoc = async () => {
235
+ setSaving(true);
236
+ try {
237
+ await updateWorkItemDoc(workItem.id, docDraft);
238
+ const html = await getWorkItemDoc(workItem.id);
239
+ setDocumentation(html);
240
+ setEditingDoc(false);
241
+ } finally {
242
+ setSaving(false);
243
+ }
244
+ };
245
+
246
+ if (!workItem) return null;
247
+
248
+ const statusMeta = getStatusMetadata(workItem.status);
249
+ const typeMeta = TYPE_METADATA[workItem.type] || TYPE_METADATA.task;
250
+
251
+ return (
252
+ <Dialog open={open} onOpenChange={onOpenChange}>
253
+ <DialogContent onClose={() => onOpenChange(false)}>
254
+ {/* Header */}
255
+ <DialogHeader>
256
+ <div className="flex items-start justify-between pr-8">
257
+ <div className="flex-1">
258
+ <DialogTitle className="mb-2">{workItem.name}</DialogTitle>
259
+ <DialogDescription className="flex items-center gap-2 flex-wrap">
260
+ {/* Status Badge */}
261
+ <Badge
262
+ variant="secondary"
263
+ className={cn(
264
+ statusMeta?.color === 'blue' && 'bg-blue-100 text-blue-700',
265
+ statusMeta?.color === 'yellow' && 'bg-yellow-100 text-yellow-700',
266
+ statusMeta?.color === 'green' && 'bg-green-100 text-green-700',
267
+ statusMeta?.color === 'purple' && 'bg-purple-100 text-purple-700',
268
+ statusMeta?.color === 'red' && 'bg-red-100 text-red-700'
269
+ )}
270
+ >
271
+ {statusMeta?.icon} {statusMeta?.label}
272
+ </Badge>
273
+
274
+ {/* Type Badge */}
275
+ <Badge variant="outline">{typeMeta.icon} {typeMeta.label}</Badge>
276
+
277
+ {/* ID */}
278
+ <span className="text-slate-400 text-xs">{workItem.id}</span>
279
+ </DialogDescription>
280
+ </div>
281
+ </div>
282
+ </DialogHeader>
283
+
284
+ {/* Tabs */}
285
+ <div className="flex-1 overflow-hidden flex flex-col">
286
+ <div className="px-6 pb-2 border-b border-slate-100 flex items-center justify-between gap-4">
287
+ <Tabs value={activeTab} onValueChange={setActiveTab}>
288
+ <TabsList>
289
+ {documentation && (
290
+ <TabsTrigger value="documentation">
291
+ <BookOpen className="w-4 h-4 mr-2" />
292
+ Documentation
293
+ </TabsTrigger>
294
+ )}
295
+ <TabsTrigger value="details">
296
+ <FileText className="w-4 h-4 mr-2" />
297
+ Details
298
+ </TabsTrigger>
299
+ {fullDetails?.children && fullDetails.children.length > 0 && (
300
+ <TabsTrigger value="children">
301
+ <Users className="w-4 h-4 mr-2" />
302
+ Children ({fullDetails.children.length})
303
+ </TabsTrigger>
304
+ )}
305
+ </TabsList>
306
+ </Tabs>
307
+
308
+ {/* Validation score + Refine button — right side, same row as tabs */}
309
+ <div className="flex items-center gap-2 flex-shrink-0">
310
+ {(() => {
311
+ const vr = fullDetails?.metadata?.validationResult;
312
+ if (!vr) return null;
313
+ const score = vr.averageScore ?? null;
314
+ const critCount = (vr.criticalIssues || []).length;
315
+ const majCount = (vr.majorIssues || []).length;
316
+ const minCount = (vr.minorIssues || []).length;
317
+ const totalIssues = critCount + majCount + minCount;
318
+ return (
319
+ <div className="flex items-center gap-1.5 text-xs text-slate-500">
320
+ <span className={`font-bold px-2 py-0.5 rounded-full ${
321
+ score >= 95 ? 'bg-green-100 text-green-700'
322
+ : score >= 80 ? 'bg-amber-100 text-amber-700'
323
+ : 'bg-red-100 text-red-700'
324
+ }`}>{score}/100</span>
325
+ {totalIssues > 0 && (
326
+ <span>
327
+ {critCount > 0 && <span className="text-red-600 font-medium">{critCount} critical</span>}
328
+ {critCount > 0 && majCount > 0 && <span className="mx-0.5">·</span>}
329
+ {majCount > 0 && <span className="text-orange-600 font-medium">{majCount} major</span>}
330
+ {(critCount > 0 || majCount > 0) && minCount > 0 && <span className="mx-0.5">·</span>}
331
+ {minCount > 0 && <span className="text-amber-600">{minCount} minor</span>}
332
+ </span>
333
+ )}
334
+ </div>
335
+ );
336
+ })()}
337
+ {fullDetails && (
338
+ <button
339
+ onClick={() => setRefineOpen(true)}
340
+ className="flex items-center gap-1.5 px-3 py-1.5 text-xs font-medium text-violet-700 bg-violet-50 border border-violet-200 rounded-lg hover:bg-violet-100 transition-colors"
341
+ >
342
+ <Wand2 className="w-3.5 h-3.5" />
343
+ Refine with AI
344
+ </button>
345
+ )}
346
+ </div>
347
+ </div>
348
+
349
+ {/* Tab Content */}
350
+ <div className="flex-1 overflow-y-auto px-6 py-4">
351
+ {loading ? (
352
+ <div className="flex items-center justify-center py-12">
353
+ <div className="animate-spin rounded-full h-8 w-8 border-b-2 border-blue-600"></div>
354
+ </div>
355
+ ) : error ? (
356
+ <div className="text-center py-12">
357
+ <p className="text-red-600">Failed to load details: {error}</p>
358
+ </div>
359
+ ) : (
360
+ <Tabs value={activeTab}>
361
+ {/* Documentation Tab */}
362
+ {documentation && (
363
+ <TabsContent value="documentation">
364
+ {/* Parent chain links */}
365
+ {parentChain.length > 0 && (
366
+ <div className="mb-4 flex flex-wrap items-center gap-2 text-xs text-slate-500">
367
+ {parentChain.map((ancestor) => (
368
+ <ParentFileLink key={ancestor.id} item={ancestor} fileType="doc" />
369
+ ))}
370
+ </div>
371
+ )}
372
+ {/* Edit toolbar */}
373
+ <div className="flex justify-end mb-2">
374
+ {editingDoc ? (
375
+ <div className="flex gap-2">
376
+ <button
377
+ onClick={() => setEditingDoc(false)}
378
+ className="flex items-center gap-1 px-2 py-1 text-xs text-slate-600 hover:text-slate-900 border border-slate-200 rounded"
379
+ >
380
+ <X className="w-3 h-3" /> Cancel
381
+ </button>
382
+ <button
383
+ onClick={saveDoc}
384
+ disabled={saving}
385
+ className="flex items-center gap-1 px-2 py-1 text-xs text-white bg-indigo-600 hover:bg-indigo-700 rounded disabled:opacity-50"
386
+ >
387
+ <Save className="w-3 h-3" /> {saving ? 'Saving…' : 'Save'}
388
+ </button>
389
+ </div>
390
+ ) : (
391
+ <button
392
+ onClick={startEditDoc}
393
+ className="flex items-center gap-1 px-2 py-1 text-xs text-slate-600 hover:text-slate-900 border border-slate-200 rounded"
394
+ >
395
+ <Pencil className="w-3 h-3" /> Edit
396
+ </button>
397
+ )}
398
+ </div>
399
+ {editingDoc ? (
400
+ <textarea
401
+ className="w-full h-96 p-3 text-sm font-mono border border-slate-300 rounded focus:outline-none focus:ring-2 focus:ring-indigo-400 resize-y"
402
+ value={docDraft}
403
+ onChange={(e) => setDocDraft(e.target.value)}
404
+ />
405
+ ) : (
406
+ <div className="prose prose-slate max-w-none">
407
+ <div dangerouslySetInnerHTML={{ __html: documentation }} />
408
+ </div>
409
+ )}
410
+ </TabsContent>
411
+ )}
412
+
413
+ {/* Details Tab */}
414
+ <TabsContent value="details">
415
+ <div className="space-y-6">
416
+ {/* Created */}
417
+ {fullDetails?.created && (
418
+ <div className="flex items-center gap-2 text-sm text-slate-500">
419
+ <Calendar className="w-4 h-4" />
420
+ <span>Created {new Date(fullDetails.created).toLocaleDateString()}</span>
421
+ </div>
422
+ )}
423
+
424
+ {/* Parent */}
425
+ {fullDetails?.parentName && (() => {
426
+ const parent = allItems?.find((i) => i.id === fullDetails.parentId);
427
+ return (
428
+ <div>
429
+ <div className="flex items-center gap-2 text-sm font-semibold text-slate-700 mb-2">
430
+ <Package className="w-4 h-4" />
431
+ <span>Parent</span>
432
+ </div>
433
+ <ItemBox item={parent} fallbackName={fullDetails.parentName} fallbackId={fullDetails.parentId} onItemClick={onItemClick} />
434
+ </div>
435
+ );
436
+ })()}
437
+
438
+ {/* Epic */}
439
+ {fullDetails?.epicName && workItem.type !== 'epic' && (() => {
440
+ const epic = allItems?.find((i) => i.id === fullDetails.epicId);
441
+ return (
442
+ <div>
443
+ <div className="flex items-center gap-2 text-sm font-semibold text-slate-700 mb-2">
444
+ <Package className="w-4 h-4" />
445
+ <span>Epic</span>
446
+ </div>
447
+ <ItemBox item={epic} fallbackName={fullDetails.epicName} fallbackId={fullDetails.epicId} onItemClick={onItemClick} />
448
+ </div>
449
+ );
450
+ })()}
451
+
452
+ {/* Dependencies */}
453
+ {fullDetails?.dependencies && fullDetails.dependencies.length > 0 && (
454
+ <div>
455
+ <div className="flex items-center gap-2 text-sm font-semibold text-slate-700 mb-2">
456
+ <Link2 className="w-4 h-4" />
457
+ <span>Dependencies ({fullDetails.dependencies.length})</span>
458
+ </div>
459
+ <div className="space-y-2">
460
+ {fullDetails.dependencies.map((depId) => {
461
+ const depItem = allItems?.find((i) => i.id === depId);
462
+ return <ItemBox key={depId} item={depItem} fallbackName={depId} fallbackId={depId} onItemClick={onItemClick} />;
463
+ })}
464
+ </div>
465
+ </div>
466
+ )}
467
+ </div>
468
+ </TabsContent>
469
+
470
+ {/* Children Tab */}
471
+ {fullDetails?.children && fullDetails.children.length > 0 && (
472
+ <TabsContent value="children">
473
+ <div className="space-y-2">
474
+ {fullDetails.children.map((child) => {
475
+ const childStatusMeta = getStatusMetadata(child.status);
476
+ const childTypeMeta = TYPE_METADATA[child.type];
477
+
478
+ const fullChild = allItems?.find((i) => i.id === child.id);
479
+
480
+ return (
481
+ <button
482
+ key={child.id}
483
+ onClick={() => fullChild && onItemClick?.(fullChild)}
484
+ className="w-full text-left p-4 border border-slate-200 rounded-lg hover:border-blue-300 hover:bg-blue-50 transition-colors cursor-pointer"
485
+ >
486
+ <div className="flex items-start justify-between">
487
+ <div>
488
+ <h4 className="font-medium text-slate-900 mb-1">
489
+ {child.name}
490
+ </h4>
491
+ <div className="flex items-center gap-2">
492
+ <Badge
493
+ variant="secondary"
494
+ className={cn(
495
+ 'text-xs',
496
+ childStatusMeta?.color === 'green' &&
497
+ 'bg-green-100 text-green-700',
498
+ childStatusMeta?.color === 'blue' &&
499
+ 'bg-blue-100 text-blue-700',
500
+ childStatusMeta?.color === 'yellow' &&
501
+ 'bg-yellow-100 text-yellow-700'
502
+ )}
503
+ >
504
+ {childStatusMeta?.icon} {childStatusMeta?.label}
505
+ </Badge>
506
+ <Badge variant="outline" className="text-xs">
507
+ {childTypeMeta?.icon} {childTypeMeta?.label}
508
+ </Badge>
509
+ </div>
510
+ </div>
511
+ <ChevronRight className="w-4 h-4 text-slate-400 mt-1 flex-shrink-0" />
512
+ </div>
513
+ </button>
514
+ );
515
+ })}
516
+ </div>
517
+ </TabsContent>
518
+ )}
519
+ </Tabs>
520
+ )}
521
+ </div>
522
+ </div>
523
+
524
+ {/* Footer with Navigation */}
525
+ {onNavigate && (
526
+ <div className="px-6 py-4 border-t border-slate-100 flex items-center justify-between">
527
+ <button
528
+ onClick={() => onNavigate('prev')}
529
+ className="flex items-center gap-2 text-sm text-slate-600 hover:text-slate-900 transition-colors"
530
+ >
531
+ <ChevronLeft className="w-4 h-4" />
532
+ Previous
533
+ </button>
534
+ <span className="text-xs text-slate-400">Use ← → to navigate</span>
535
+ <button
536
+ onClick={() => onNavigate('next')}
537
+ className="flex items-center gap-2 text-sm text-slate-600 hover:text-slate-900 transition-colors"
538
+ >
539
+ Next
540
+ <ChevronRight className="w-4 h-4" />
541
+ </button>
542
+ </div>
543
+ )}
544
+ </DialogContent>
545
+
546
+ {/* Refine popup — rendered outside DialogContent so it stacks above the modal */}
547
+ {refineOpen && fullDetails && (
548
+ <RefineWorkItemPopup
549
+ item={fullDetails}
550
+ refineProgress={refineProgress?.itemId === fullDetails.id ? refineProgress : null}
551
+ refineResult={refineResult?.itemId === fullDetails.id ? refineResult : null}
552
+ refineError={refineError?.itemId === fullDetails.id ? refineError : null}
553
+ onClose={() => { setRefineOpen(false); onClearRefine?.(); }}
554
+ onAccepted={handleRefineAccepted}
555
+ />
556
+ )}
557
+ </Dialog>
558
+ );
559
+ }