@su-record/vibe 2.9.24 → 2.9.32

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 (530) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +109 -105
  3. package/LICENSE +21 -21
  4. package/README.en.md +220 -220
  5. package/README.md +171 -171
  6. package/agents/architect-low.md +41 -41
  7. package/agents/architect-medium.md +59 -59
  8. package/agents/architect.md +80 -80
  9. package/agents/build-error-resolver.md +115 -115
  10. package/agents/compounder.md +261 -261
  11. package/agents/diagrammer.md +178 -178
  12. package/agents/docs/api-documenter.md +99 -99
  13. package/agents/docs/changelog-writer.md +93 -93
  14. package/agents/e2e-tester.md +294 -294
  15. package/agents/event/event-comms.md +78 -78
  16. package/agents/event/event-content.md +68 -68
  17. package/agents/event/event-image.md +95 -95
  18. package/agents/event/event-ops.md +84 -84
  19. package/agents/event/event-scheduler.md +69 -69
  20. package/agents/event/event-speaker.md +86 -86
  21. package/agents/explorer-low.md +42 -42
  22. package/agents/explorer-medium.md +59 -59
  23. package/agents/explorer.md +48 -48
  24. package/agents/implementer-low.md +43 -43
  25. package/agents/implementer-medium.md +52 -52
  26. package/agents/implementer.md +54 -54
  27. package/agents/junior-mentor.md +141 -141
  28. package/agents/planning/requirements-analyst.md +84 -84
  29. package/agents/planning/ux-advisor.md +83 -83
  30. package/agents/qa/acceptance-tester.md +86 -86
  31. package/agents/qa/edge-case-finder.md +93 -93
  32. package/agents/qa/qa-coordinator.md +131 -131
  33. package/agents/refactor-cleaner.md +143 -143
  34. package/agents/research/best-practices-agent.md +199 -199
  35. package/agents/research/codebase-patterns-agent.md +157 -157
  36. package/agents/research/framework-docs-agent.md +188 -188
  37. package/agents/research/security-advisory-agent.md +213 -213
  38. package/agents/review/architecture-reviewer.md +107 -107
  39. package/agents/review/complexity-reviewer.md +116 -116
  40. package/agents/review/data-integrity-reviewer.md +88 -88
  41. package/agents/review/git-history-reviewer.md +103 -103
  42. package/agents/review/performance-reviewer.md +86 -86
  43. package/agents/review/python-reviewer.md +150 -150
  44. package/agents/review/rails-reviewer.md +139 -139
  45. package/agents/review/react-reviewer.md +144 -144
  46. package/agents/review/security-reviewer.md +80 -80
  47. package/agents/review/simplicity-reviewer.md +140 -140
  48. package/agents/review/test-coverage-reviewer.md +116 -116
  49. package/agents/review/typescript-reviewer.md +127 -127
  50. package/agents/searcher.md +54 -54
  51. package/agents/simplifier.md +120 -120
  52. package/agents/teams/debug-team.md +70 -70
  53. package/agents/teams/dev-team.md +88 -88
  54. package/agents/teams/docs-team.md +80 -80
  55. package/agents/teams/figma/figma-analyst.md +52 -52
  56. package/agents/teams/figma/figma-architect.md +112 -112
  57. package/agents/teams/figma/figma-auditor.md +82 -82
  58. package/agents/teams/figma/figma-builder.md +100 -100
  59. package/agents/teams/figma-team.md +85 -85
  60. package/agents/teams/fullstack-team.md +83 -83
  61. package/agents/teams/lite-team.md +69 -69
  62. package/agents/teams/migration-team.md +78 -78
  63. package/agents/teams/refactor-team.md +94 -94
  64. package/agents/teams/research-team.md +86 -86
  65. package/agents/teams/review-debate-team.md +125 -125
  66. package/agents/teams/security-team.md +81 -81
  67. package/agents/tester.md +49 -49
  68. package/agents/ui/ui-a11y-auditor.md +93 -93
  69. package/agents/ui/ui-antipattern-detector.md +102 -102
  70. package/agents/ui/ui-dataviz-advisor.md +69 -69
  71. package/agents/ui/ui-design-system-gen.md +57 -57
  72. package/agents/ui/ui-industry-analyzer.md +49 -49
  73. package/agents/ui/ui-layout-architect.md +65 -65
  74. package/agents/ui/ui-stack-implementer.md +68 -68
  75. package/agents/ui/ux-compliance-reviewer.md +81 -81
  76. package/agents/ui-previewer.md +258 -258
  77. package/commands/vibe.analyze.md +533 -533
  78. package/commands/vibe.contract.md +105 -105
  79. package/commands/vibe.docs.md +33 -33
  80. package/commands/vibe.event.md +163 -163
  81. package/commands/vibe.figma.md +600 -584
  82. package/commands/vibe.harness.md +177 -177
  83. package/commands/vibe.regress.md +73 -73
  84. package/commands/vibe.review.md +624 -624
  85. package/commands/vibe.run.md +1946 -1940
  86. package/commands/vibe.scaffold.md +195 -195
  87. package/commands/vibe.spec.md +577 -577
  88. package/commands/vibe.test.md +49 -96
  89. package/commands/vibe.trace.md +276 -276
  90. package/commands/vibe.utils.md +413 -413
  91. package/commands/vibe.verify.md +572 -550
  92. package/dist/cli/auth.d.ts +7 -1
  93. package/dist/cli/auth.d.ts.map +1 -1
  94. package/dist/cli/auth.js +51 -11
  95. package/dist/cli/auth.js.map +1 -1
  96. package/dist/cli/collaborator.d.ts +5 -1
  97. package/dist/cli/collaborator.d.ts.map +1 -1
  98. package/dist/cli/collaborator.js +60 -55
  99. package/dist/cli/collaborator.js.map +1 -1
  100. package/dist/cli/commands/codex-proxy.js +15 -15
  101. package/dist/cli/commands/config.js +9 -9
  102. package/dist/cli/commands/evolution.js +12 -12
  103. package/dist/cli/commands/figma.js +20 -20
  104. package/dist/cli/commands/info.d.ts.map +1 -1
  105. package/dist/cli/commands/info.js +47 -63
  106. package/dist/cli/commands/info.js.map +1 -1
  107. package/dist/cli/commands/init.d.ts +13 -5
  108. package/dist/cli/commands/init.d.ts.map +1 -1
  109. package/dist/cli/commands/init.js +71 -35
  110. package/dist/cli/commands/init.js.map +1 -1
  111. package/dist/cli/commands/remove.d.ts.map +1 -1
  112. package/dist/cli/commands/remove.js +35 -22
  113. package/dist/cli/commands/remove.js.map +1 -1
  114. package/dist/cli/commands/sentinel.js +27 -27
  115. package/dist/cli/commands/skills.js +5 -5
  116. package/dist/cli/commands/slack.js +10 -10
  117. package/dist/cli/commands/stats.js +6 -6
  118. package/dist/cli/commands/telegram.js +12 -12
  119. package/dist/cli/commands/update.d.ts.map +1 -1
  120. package/dist/cli/commands/update.js +10 -6
  121. package/dist/cli/commands/update.js.map +1 -1
  122. package/dist/cli/detect.js +32 -32
  123. package/dist/cli/index.js +37 -35
  124. package/dist/cli/index.js.map +1 -1
  125. package/dist/cli/llm/claude-commands.js +16 -16
  126. package/dist/cli/llm/config.js +18 -18
  127. package/dist/cli/llm/gemini-commands.js +16 -16
  128. package/dist/cli/llm/gpt-commands.js +19 -19
  129. package/dist/cli/llm/help.js +21 -21
  130. package/dist/cli/postinstall/constants.d.ts.map +1 -1
  131. package/dist/cli/postinstall/constants.js +1 -0
  132. package/dist/cli/postinstall/constants.js.map +1 -1
  133. package/dist/cli/postinstall/cursor-agents.js +32 -32
  134. package/dist/cli/postinstall/cursor-rules.js +83 -83
  135. package/dist/cli/postinstall/cursor-skills.js +743 -743
  136. package/dist/cli/postinstall/global-config.d.ts.map +1 -1
  137. package/dist/cli/postinstall/global-config.js +8 -4
  138. package/dist/cli/postinstall/global-config.js.map +1 -1
  139. package/dist/cli/setup/LegacyMigration.d.ts +14 -0
  140. package/dist/cli/setup/LegacyMigration.d.ts.map +1 -1
  141. package/dist/cli/setup/LegacyMigration.js +61 -0
  142. package/dist/cli/setup/LegacyMigration.js.map +1 -1
  143. package/dist/cli/setup/ProjectSetup.d.ts +9 -3
  144. package/dist/cli/setup/ProjectSetup.d.ts.map +1 -1
  145. package/dist/cli/setup/ProjectSetup.js +60 -36
  146. package/dist/cli/setup/ProjectSetup.js.map +1 -1
  147. package/dist/cli/setup/Provisioner.js +44 -44
  148. package/dist/cli/setup/Provisioner.js.map +1 -1
  149. package/dist/cli/setup.d.ts +1 -1
  150. package/dist/cli/setup.d.ts.map +1 -1
  151. package/dist/cli/setup.js +1 -1
  152. package/dist/cli/setup.js.map +1 -1
  153. package/dist/cli/utils/cli-detector.d.ts +9 -6
  154. package/dist/cli/utils/cli-detector.d.ts.map +1 -1
  155. package/dist/cli/utils/cli-detector.js +127 -8
  156. package/dist/cli/utils/cli-detector.js.map +1 -1
  157. package/dist/infra/lib/DeepInit.js +24 -24
  158. package/dist/infra/lib/IterationTracker.js +11 -11
  159. package/dist/infra/lib/PythonParser.js +108 -108
  160. package/dist/infra/lib/ReviewRace.js +96 -96
  161. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  162. package/dist/infra/lib/SkillQualityGate.js +9 -9
  163. package/dist/infra/lib/SkillRepository.js +159 -159
  164. package/dist/infra/lib/UltraQA.js +99 -99
  165. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  166. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  167. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  168. package/dist/infra/lib/autonomy/PolicyEngine.d.ts +3 -3
  169. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  170. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  171. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  172. package/dist/infra/lib/browser/compare.d.ts +27 -0
  173. package/dist/infra/lib/browser/compare.d.ts.map +1 -1
  174. package/dist/infra/lib/browser/compare.js +55 -0
  175. package/dist/infra/lib/browser/compare.js.map +1 -1
  176. package/dist/infra/lib/browser/index.d.ts +2 -1
  177. package/dist/infra/lib/browser/index.d.ts.map +1 -1
  178. package/dist/infra/lib/browser/index.js +1 -1
  179. package/dist/infra/lib/browser/index.js.map +1 -1
  180. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  181. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  182. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  183. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  184. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  185. package/dist/infra/lib/evolution/ParityTester.js +57 -57
  186. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  187. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  188. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  189. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  190. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  191. package/dist/infra/lib/figma/audit.d.ts +37 -0
  192. package/dist/infra/lib/figma/audit.d.ts.map +1 -0
  193. package/dist/infra/lib/figma/audit.js +130 -0
  194. package/dist/infra/lib/figma/audit.js.map +1 -0
  195. package/dist/infra/lib/figma/extract.d.ts +21 -1
  196. package/dist/infra/lib/figma/extract.d.ts.map +1 -1
  197. package/dist/infra/lib/figma/extract.js +84 -12
  198. package/dist/infra/lib/figma/extract.js.map +1 -1
  199. package/dist/infra/lib/figma/index.d.ts +4 -2
  200. package/dist/infra/lib/figma/index.d.ts.map +1 -1
  201. package/dist/infra/lib/figma/index.js +2 -1
  202. package/dist/infra/lib/figma/index.js.map +1 -1
  203. package/dist/infra/lib/figma/types.d.ts +31 -0
  204. package/dist/infra/lib/figma/types.d.ts.map +1 -1
  205. package/dist/infra/lib/gemini/orchestration.js +5 -5
  206. package/dist/infra/lib/gpt/orchestration.js +4 -4
  207. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  208. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  209. package/dist/infra/lib/memory/MemoryStorage.d.ts +5 -0
  210. package/dist/infra/lib/memory/MemoryStorage.d.ts.map +1 -1
  211. package/dist/infra/lib/memory/MemoryStorage.js +202 -183
  212. package/dist/infra/lib/memory/MemoryStorage.js.map +1 -1
  213. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  214. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  215. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  216. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  217. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  218. package/dist/infra/orchestrator/AgentManager.js +12 -12
  219. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  220. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  221. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  222. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  223. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  224. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  225. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  226. package/dist/tools/memory/getMemoryGraph.js +12 -12
  227. package/dist/tools/memory/getSessionContext.js +9 -9
  228. package/dist/tools/memory/linkMemories.js +14 -14
  229. package/dist/tools/memory/listMemories.js +4 -4
  230. package/dist/tools/memory/recallMemory.js +4 -4
  231. package/dist/tools/memory/saveMemory.js +4 -4
  232. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  233. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  234. package/dist/tools/semantic/astGrep.test.js +6 -6
  235. package/dist/tools/spec/prdParser.test.js +171 -171
  236. package/dist/tools/spec/specGenerator.js +169 -169
  237. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  238. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  239. package/hooks/gemini-hooks.json +73 -73
  240. package/hooks/hooks.json +134 -126
  241. package/hooks/scripts/__tests__/keyword-detector.test.js +199 -199
  242. package/hooks/scripts/__tests__/pre-tool-guard.test.js +409 -368
  243. package/hooks/scripts/__tests__/sentinel-guard.test.js +208 -208
  244. package/hooks/scripts/auto-commit.js +97 -97
  245. package/hooks/scripts/auto-format.js +64 -64
  246. package/hooks/scripts/auto-test.js +81 -81
  247. package/hooks/scripts/code-check.js +271 -271
  248. package/hooks/scripts/codex-detect.js +46 -46
  249. package/hooks/scripts/codex-review-gate.js +80 -80
  250. package/hooks/scripts/command-log.js +32 -32
  251. package/hooks/scripts/context-save.js +353 -353
  252. package/hooks/scripts/evolution-engine.js +91 -91
  253. package/hooks/scripts/figma-extract.js +768 -635
  254. package/hooks/scripts/figma-guard.js +219 -219
  255. package/hooks/scripts/figma-refine.js +315 -315
  256. package/hooks/scripts/figma-to-scss.js +394 -394
  257. package/hooks/scripts/figma-validate.js +353 -353
  258. package/hooks/scripts/hud-status.js +321 -321
  259. package/hooks/scripts/keyword-detector.js +214 -214
  260. package/hooks/scripts/lib/dispatcher.js +87 -83
  261. package/hooks/scripts/lib/scope-from-spec.js +276 -261
  262. package/hooks/scripts/llm-orchestrate.js +645 -645
  263. package/hooks/scripts/post-edit.js +35 -35
  264. package/hooks/scripts/pr-test-gate.js +52 -52
  265. package/hooks/scripts/pre-tool-guard.js +259 -254
  266. package/hooks/scripts/prompt-dispatcher.js +192 -190
  267. package/hooks/scripts/scope-guard.js +145 -145
  268. package/hooks/scripts/sentinel-guard.js +130 -130
  269. package/hooks/scripts/session-start.js +186 -186
  270. package/hooks/scripts/skill-injector.js +83 -83
  271. package/hooks/scripts/step-counter.js +45 -0
  272. package/hooks/scripts/stop-notify.js +209 -209
  273. package/hooks/scripts/utils.js +315 -257
  274. package/languages/csharp-unity.md +515 -515
  275. package/languages/gdscript-godot.md +470 -470
  276. package/languages/ruby-rails.md +489 -489
  277. package/languages/typescript-angular.md +433 -433
  278. package/languages/typescript-astro.md +416 -416
  279. package/languages/typescript-electron.md +406 -406
  280. package/languages/typescript-nestjs.md +524 -524
  281. package/languages/typescript-svelte.md +407 -407
  282. package/languages/typescript-tauri.md +365 -365
  283. package/package.json +106 -106
  284. package/skills/agents-md/SKILL.md +121 -121
  285. package/skills/agents-md/rubrics/what-to-keep.md +49 -49
  286. package/skills/agents-md/templates/agents-md.md +36 -36
  287. package/skills/arch-guard/SKILL.md +181 -181
  288. package/skills/arch-guard/agents/detector.md +48 -48
  289. package/skills/arch-guard/agents/reporter.md +48 -48
  290. package/skills/arch-guard/agents/rule-generator.md +49 -49
  291. package/skills/arch-guard/agents/violation-checker.md +51 -51
  292. package/skills/arch-guard/frameworks/clean-architecture.md +108 -108
  293. package/skills/arch-guard/frameworks/solid.md +102 -102
  294. package/skills/arch-guard/scripts/check-boundaries.js +90 -90
  295. package/skills/arch-guard/templates/arch-rules.json +47 -47
  296. package/skills/arch-guard/templates/violation-report.md +53 -53
  297. package/skills/brand-assets/SKILL.md +147 -147
  298. package/skills/brand-assets/rubrics/asset-checklist.md +98 -98
  299. package/skills/brand-assets/templates/brand-guide.md +161 -161
  300. package/skills/capability-loop/SKILL.md +272 -272
  301. package/skills/capability-loop/agents/capability-designer.md +61 -61
  302. package/skills/capability-loop/agents/failure-analyst.md +55 -55
  303. package/skills/capability-loop/agents/implementer.md +50 -50
  304. package/skills/capability-loop/agents/tester.md +53 -53
  305. package/skills/capability-loop/templates/capability-spec.md +118 -118
  306. package/skills/capability-loop/templates/failure-analysis.md +118 -118
  307. package/skills/characterization-test/SKILL.md +207 -207
  308. package/skills/characterization-test/agents/behavior-capturer.md +50 -50
  309. package/skills/characterization-test/agents/coverage-checker.md +54 -54
  310. package/skills/characterization-test/agents/reporter.md +50 -50
  311. package/skills/characterization-test/agents/test-writer.md +49 -49
  312. package/skills/characterization-test/rubrics/coverage-criteria.md +53 -53
  313. package/skills/characterization-test/templates/test-template.ts +101 -101
  314. package/skills/chub-usage/SKILL.md +139 -139
  315. package/skills/claude-md-guide/SKILL.md +351 -351
  316. package/skills/claude-md-guide/rubrics/anti-patterns.md +88 -88
  317. package/skills/claude-md-guide/templates/claude-md.md +54 -54
  318. package/skills/commerce-patterns/SKILL.md +64 -64
  319. package/skills/commerce-patterns/rubrics/checkout-flow.md +48 -48
  320. package/skills/commerce-patterns/templates/product-schema.md +85 -85
  321. package/skills/commit-push-pr/SKILL.md +77 -77
  322. package/skills/commit-push-pr/agents/change-analyzer.md +55 -55
  323. package/skills/commit-push-pr/agents/message-writer.md +50 -50
  324. package/skills/commit-push-pr/agents/pr-writer.md +58 -58
  325. package/skills/commit-push-pr/agents/reviewer.md +52 -52
  326. package/skills/commit-push-pr/rubrics/commit-message.md +73 -73
  327. package/skills/commit-push-pr/templates/pr-body.md +63 -63
  328. package/skills/context7-usage/SKILL.md +106 -106
  329. package/skills/context7-usage/rubrics/when-to-use.md +50 -50
  330. package/skills/create-prd/SKILL.md +90 -90
  331. package/skills/create-prd/agents/edge-case-finder.md +48 -48
  332. package/skills/create-prd/agents/prioritizer.md +60 -60
  333. package/skills/create-prd/agents/requirements-writer.md +48 -48
  334. package/skills/create-prd/agents/researcher.md +55 -55
  335. package/skills/create-prd/agents/reviewer.md +54 -54
  336. package/skills/create-prd/frameworks/jobs-to-be-done.md +96 -96
  337. package/skills/create-prd/frameworks/rice-scoring.md +97 -97
  338. package/skills/create-prd/orchestrator.md +70 -70
  339. package/skills/create-prd/rubrics/completeness.md +58 -58
  340. package/skills/create-prd/templates/prd.md +139 -139
  341. package/skills/design-audit/SKILL.md +152 -152
  342. package/skills/design-audit/agents/a11y-auditor.md +43 -43
  343. package/skills/design-audit/agents/performance-auditor.md +46 -46
  344. package/skills/design-audit/agents/responsive-auditor.md +46 -46
  345. package/skills/design-audit/agents/scorer.md +47 -47
  346. package/skills/design-audit/agents/slop-detector.md +47 -47
  347. package/skills/design-audit/frameworks/core-web-vitals.md +107 -107
  348. package/skills/design-audit/frameworks/wcag-checklist.md +64 -64
  349. package/skills/design-audit/orchestrator.md +64 -64
  350. package/skills/design-audit/rubrics/ai-slop-patterns.md +83 -83
  351. package/skills/design-audit/rubrics/scoring.md +63 -63
  352. package/skills/design-audit/templates/report.md +88 -88
  353. package/skills/design-critique/SKILL.md +139 -139
  354. package/skills/design-critique/rubrics/ux-heuristics.md +143 -143
  355. package/skills/design-critique/templates/critique-report.md +86 -86
  356. package/skills/design-distill/SKILL.md +130 -130
  357. package/skills/design-distill/templates/design-system.md +132 -132
  358. package/skills/design-normalize/SKILL.md +133 -133
  359. package/skills/design-normalize/rubrics/token-naming.md +117 -117
  360. package/skills/design-normalize/templates/token-audit.md +89 -89
  361. package/skills/design-polish/SKILL.md +131 -131
  362. package/skills/design-polish/rubrics/polish-checklist.md +68 -68
  363. package/skills/design-polish/templates/polish-report.md +64 -64
  364. package/skills/design-teach/SKILL.md +182 -182
  365. package/skills/design-teach/rubrics/brand-personality.md +73 -73
  366. package/skills/design-teach/templates/design-context.json +36 -36
  367. package/skills/devlog/SKILL.md +143 -143
  368. package/skills/e2e-commerce/SKILL.md +62 -62
  369. package/skills/e2e-commerce/templates/test-scenarios.md +170 -170
  370. package/skills/event-comms/SKILL.md +172 -172
  371. package/skills/event-comms/templates/email-invite.md +99 -99
  372. package/skills/event-comms/templates/sns-post.md +133 -133
  373. package/skills/event-ops/SKILL.md +207 -207
  374. package/skills/event-ops/rubrics/contingency.md +85 -85
  375. package/skills/event-ops/templates/d-day-checklist.md +65 -65
  376. package/skills/event-planning/SKILL.md +144 -144
  377. package/skills/event-planning/rubrics/timeline.md +70 -70
  378. package/skills/event-planning/templates/event-plan.md +91 -91
  379. package/skills/exec-plan/SKILL.md +149 -149
  380. package/skills/exec-plan/agents/decomposer.md +47 -47
  381. package/skills/exec-plan/agents/dependency-mapper.md +44 -44
  382. package/skills/exec-plan/agents/estimator.md +43 -43
  383. package/skills/exec-plan/agents/validator.md +55 -55
  384. package/skills/exec-plan/orchestrator.md +70 -70
  385. package/skills/exec-plan/rubrics/complexity-scoring.md +75 -75
  386. package/skills/exec-plan/templates/plan.md +147 -147
  387. package/skills/git-worktree/SKILL.md +73 -73
  388. package/skills/git-worktree/rubrics/when-to-use.md +55 -55
  389. package/skills/handoff/SKILL.md +110 -110
  390. package/skills/handoff/agents/context-summarizer.md +51 -51
  391. package/skills/handoff/agents/document-writer.md +63 -63
  392. package/skills/handoff/agents/state-collector.md +53 -53
  393. package/skills/handoff/agents/verifier.md +48 -48
  394. package/skills/handoff/rubrics/completeness.md +62 -62
  395. package/skills/handoff/templates/handoff.md +107 -107
  396. package/skills/parallel-research/SKILL.md +104 -104
  397. package/skills/parallel-research/agents/best-practices.md +43 -43
  398. package/skills/parallel-research/agents/codebase-patterns.md +46 -46
  399. package/skills/parallel-research/agents/framework-docs.md +45 -45
  400. package/skills/parallel-research/agents/security-advisory.md +46 -46
  401. package/skills/parallel-research/agents/synthesizer.md +57 -57
  402. package/skills/parallel-research/experts/best-practices.md +50 -50
  403. package/skills/parallel-research/experts/codebase-patterns.md +70 -70
  404. package/skills/parallel-research/experts/framework-docs.md +65 -65
  405. package/skills/parallel-research/experts/security-advisory.md +69 -69
  406. package/skills/parallel-research/orchestrator.md +79 -79
  407. package/skills/parallel-research/templates/awesome-list.md +32 -32
  408. package/skills/parallel-research/templates/paper.md +88 -88
  409. package/skills/parallel-research/templates/synthesis.md +101 -101
  410. package/skills/prioritization-frameworks/SKILL.md +87 -87
  411. package/skills/prioritization-frameworks/rubrics/frameworks.md +79 -79
  412. package/skills/prioritization-frameworks/templates/scoring-matrix.md +69 -69
  413. package/skills/priority-todos/SKILL.md +64 -64
  414. package/skills/priority-todos/rubrics/prioritization.md +70 -70
  415. package/skills/priority-todos/templates/todo-board.md +59 -59
  416. package/skills/seo-checklist/SKILL.md +58 -58
  417. package/skills/seo-checklist/frameworks/structured-data.md +153 -153
  418. package/skills/seo-checklist/rubrics/content-seo.md +42 -42
  419. package/skills/seo-checklist/rubrics/technical-seo.md +48 -48
  420. package/skills/techdebt/SKILL.md +124 -124
  421. package/skills/techdebt/agents/analyzer.md +50 -50
  422. package/skills/techdebt/agents/fixer.md +41 -41
  423. package/skills/techdebt/agents/reviewer.md +47 -47
  424. package/skills/techdebt/agents/scanner.md +44 -44
  425. package/skills/techdebt/orchestrator.md +70 -70
  426. package/skills/techdebt/rubrics/severity.md +51 -51
  427. package/skills/techdebt/scripts/scan.js +90 -90
  428. package/skills/techdebt/templates/report.md +86 -86
  429. package/skills/tool-fallback/SKILL.md +104 -104
  430. package/skills/tool-fallback/rubrics/fallback-chain.md +58 -58
  431. package/skills/typescript-advanced-types/SKILL.md +67 -67
  432. package/skills/typescript-advanced-types/rubrics/type-patterns.md +109 -109
  433. package/skills/ui-ux-pro-max/SKILL.md +236 -236
  434. package/skills/ui-ux-pro-max/reference/color-and-contrast.md +517 -517
  435. package/skills/ui-ux-pro-max/reference/interaction-design.md +544 -544
  436. package/skills/ui-ux-pro-max/reference/motion-design.md +591 -591
  437. package/skills/ui-ux-pro-max/reference/responsive-design.md +463 -463
  438. package/skills/ui-ux-pro-max/reference/spatial-design.md +390 -390
  439. package/skills/ui-ux-pro-max/reference/typography.md +455 -455
  440. package/skills/ui-ux-pro-max/reference/ux-writing.md +469 -469
  441. package/skills/ui-ux-pro-max/rubrics/interaction-states.md +83 -83
  442. package/skills/ui-ux-pro-max/rubrics/responsive-breakpoints.md +99 -99
  443. package/skills/user-personas/SKILL.md +75 -75
  444. package/skills/user-personas/rubrics/research-methods.md +56 -56
  445. package/skills/user-personas/templates/persona.md +89 -89
  446. package/skills/vercel-react-best-practices/SKILL.md +60 -60
  447. package/skills/vercel-react-best-practices/rubrics/performance.md +82 -82
  448. package/skills/vercel-react-best-practices/rubrics/server-components.md +86 -86
  449. package/skills/vibe-contract/SKILL.md +166 -166
  450. package/skills/vibe-docs/templates/architecture.md +80 -80
  451. package/skills/vibe-docs/templates/readme.md +84 -84
  452. package/skills/vibe-docs/templates/release-notes.md +74 -74
  453. package/skills/vibe-figma/SKILL.md +363 -363
  454. package/skills/vibe-figma/rubrics/extraction-checklist.md +51 -51
  455. package/skills/vibe-figma/templates/component-index.md +126 -126
  456. package/skills/vibe-figma/templates/component-spec.md +168 -168
  457. package/skills/vibe-figma/templates/figma-handoff.md +100 -100
  458. package/skills/vibe-figma/templates/remapped-tree.md +277 -277
  459. package/skills/vibe-figma-convert/SKILL.md +235 -235
  460. package/skills/vibe-figma-convert/rubrics/conversion-rules.md +141 -141
  461. package/skills/vibe-figma-convert/templates/component.md +140 -140
  462. package/skills/vibe-figma-extract/SKILL.md +241 -219
  463. package/skills/vibe-figma-extract/rubrics/image-rules.md +157 -157
  464. package/skills/vibe-interview/SKILL.md +358 -358
  465. package/skills/vibe-interview/checklists/api.md +101 -101
  466. package/skills/vibe-interview/checklists/feature.md +88 -88
  467. package/skills/vibe-interview/checklists/library.md +95 -95
  468. package/skills/vibe-interview/checklists/mobile.md +89 -89
  469. package/skills/vibe-interview/checklists/webapp.md +97 -97
  470. package/skills/vibe-interview/checklists/website.md +99 -99
  471. package/skills/vibe-plan/SKILL.md +254 -254
  472. package/skills/vibe-regress/SKILL.md +174 -174
  473. package/skills/vibe-regress/templates/bug.md +44 -44
  474. package/skills/vibe-regress/templates/test-jest.md +29 -29
  475. package/skills/vibe-regress/templates/test-vitest.md +30 -30
  476. package/skills/vibe-spec/SKILL.md +1195 -1195
  477. package/skills/vibe-spec-review/SKILL.md +726 -726
  478. package/skills/vibe-test/SKILL.md +140 -247
  479. package/skills/video-production/SKILL.md +52 -52
  480. package/skills/video-production/rubrics/quality-checklist.md +58 -58
  481. package/skills/video-production/templates/production-plan.md +104 -104
  482. package/vibe/config.json +29 -29
  483. package/vibe/constitution.md +227 -227
  484. package/vibe/rules/principles/communication-guide.md +98 -98
  485. package/vibe/rules/principles/development-philosophy.md +52 -52
  486. package/vibe/rules/principles/quick-start.md +102 -102
  487. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  488. package/vibe/rules/quality/checklist.md +276 -276
  489. package/vibe/rules/quality/performance.md +236 -236
  490. package/vibe/rules/quality/testing-strategy.md +440 -440
  491. package/vibe/rules/standards/anti-patterns.md +541 -541
  492. package/vibe/rules/standards/code-structure.md +291 -291
  493. package/vibe/rules/standards/complexity-metrics.md +313 -313
  494. package/vibe/rules/standards/git-workflow.md +237 -237
  495. package/vibe/rules/standards/naming-conventions.md +198 -198
  496. package/vibe/rules/standards/security.md +305 -305
  497. package/vibe/rules/writing/document-style.md +74 -74
  498. package/vibe/setup.sh +31 -31
  499. package/vibe/templates/claudemd-template.md +74 -74
  500. package/vibe/templates/constitution-template.md +267 -267
  501. package/vibe/templates/contract-backend-template.md +526 -526
  502. package/vibe/templates/contract-frontend-template.md +599 -599
  503. package/vibe/templates/feature-template.md +96 -96
  504. package/vibe/templates/plan-template.md +194 -194
  505. package/vibe/templates/spec-template.md +221 -221
  506. package/vibe/ui-ux-data/charts.csv +26 -26
  507. package/vibe/ui-ux-data/colors.csv +97 -97
  508. package/vibe/ui-ux-data/icons.csv +101 -101
  509. package/vibe/ui-ux-data/landing.csv +31 -31
  510. package/vibe/ui-ux-data/products.csv +96 -96
  511. package/vibe/ui-ux-data/react-performance.csv +45 -45
  512. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  513. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  514. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  515. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  516. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  517. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  518. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  519. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  520. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  521. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  522. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  523. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  524. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  525. package/vibe/ui-ux-data/styles.csv +68 -68
  526. package/vibe/ui-ux-data/typography.csv +57 -57
  527. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  528. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  529. package/vibe/ui-ux-data/version.json +31 -31
  530. package/vibe/ui-ux-data/web-interface.csv +31 -31
@@ -1,353 +1,353 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * figma-validate.js — SCSS vs sections.json 대조 검증
5
- *
6
- * Usage:
7
- * node figma-validate.js <scss-dir> <sections.json> [--section=<name>]
8
- *
9
- * 검증 항목:
10
- * 1. SCSS의 모든 CSS 속성이 sections.json에 근거하는가
11
- * 2. sections.json의 CSS 속성이 SCSS에 누락되지 않았는가
12
- * 3. 금지 패턴 감지 (커스텀 함수, aspect-ratio 등)
13
- * 4. 이미지 파일명 kebab-case 확인
14
- *
15
- * 출력: JSON { status, errors[], summary }
16
- */
17
-
18
- import fs from 'fs';
19
- import path from 'path';
20
-
21
- // ─── Helpers ────────────────────────────────────────────────────────
22
-
23
- function camelToKebab(str) {
24
- return str.replace(/([A-Z])/g, '-$1').toLowerCase();
25
- }
26
-
27
- function parseSCSS(scssContent) {
28
- // 간이 SCSS 파서: 셀렉터 → CSS 속성 맵 추출
29
- const blocks = {};
30
- let currentSelector = null;
31
- const lines = scssContent.split('\n');
32
-
33
- for (const line of lines) {
34
- const trimmed = line.trim();
35
-
36
- // 빈 줄, 코멘트 스킵
37
- if (!trimmed || trimmed.startsWith('//') || trimmed.startsWith('/*')) continue;
38
-
39
- // 셀렉터 열기
40
- const selectorMatch = trimmed.match(/^([.&][a-zA-Z0-9_-][a-zA-Z0-9_-]*(?:__[a-zA-Z0-9_-]+(?:-[a-zA-Z0-9_-]+)*)?)\s*\{/);
41
- if (selectorMatch) {
42
- currentSelector = selectorMatch[1];
43
- if (!blocks[currentSelector]) blocks[currentSelector] = {};
44
- continue;
45
- }
46
-
47
- // 블록 닫기
48
- if (trimmed === '}') {
49
- currentSelector = null;
50
- continue;
51
- }
52
-
53
- // CSS 속성
54
- if (currentSelector && trimmed.includes(':') && trimmed.endsWith(';')) {
55
- const colonIdx = trimmed.indexOf(':');
56
- const prop = trimmed.slice(0, colonIdx).trim();
57
- const value = trimmed.slice(colonIdx + 1).replace(/;$/, '').trim();
58
- blocks[currentSelector][prop] = value;
59
- }
60
- }
61
-
62
- return blocks;
63
- }
64
-
65
- // ─── Forbidden Pattern Detection ────────────────────────────────────
66
-
67
- const FORBIDDEN_PATTERNS = [
68
- { pattern: /@function\s/, id: 'custom-function', msg: '@function 자체 정의 금지' },
69
- { pattern: /@mixin\s/, id: 'custom-mixin', msg: '@mixin 자체 정의 금지 (기존 @use만 허용)' },
70
- { pattern: /aspect-ratio\s*:/, id: 'aspect-ratio', msg: 'aspect-ratio는 tree.json에 없는 속성' },
71
- { pattern: /clamp\s*\(/, id: 'clamp', msg: 'clamp()는 font-size 외 사용 금지' },
72
- { pattern: /\d+vw/, id: 'vw-unit', msg: 'vw 단위 사용 금지 (스태틱 구현)' },
73
- { pattern: /@media\s/, id: 'media-query', msg: '@media 금지 (스태틱 구현)' },
74
- { pattern: /@include\s/, id: 'include', msg: '@include 사용 시 기존 프로젝트 믹스인만 허용' },
75
- ];
76
-
77
- function detectForbidden(scssContent, filePath) {
78
- const errors = [];
79
- const lines = scssContent.split('\n');
80
-
81
- for (let i = 0; i < lines.length; i++) {
82
- const line = lines[i];
83
- for (const { pattern, id, msg } of FORBIDDEN_PATTERNS) {
84
- if (pattern.test(line)) {
85
- // clamp in font-size is allowed
86
- if (id === 'clamp' && line.includes('font-size')) continue;
87
- errors.push({
88
- priority: 'P1',
89
- file: filePath,
90
- line: i + 1,
91
- type: `forbidden-${id}`,
92
- actual: line.trim(),
93
- message: msg
94
- });
95
- }
96
- }
97
- }
98
-
99
- return errors;
100
- }
101
-
102
- // ─── CSS Value Comparison ───────────────────────────────────────────
103
-
104
- function collectCSSFromTree(node, sectionClass, parentPath, result) {
105
- const css = node.css || {};
106
- const children = node.children || [];
107
- const name = node.name || '';
108
- const type = node.type || '';
109
-
110
- // BG 프레임 스킵
111
- const nameLower = name.toLowerCase();
112
- if (nameLower === 'bg' || nameLower.endsWith('-bg') || nameLower.startsWith('bg-')) return;
113
-
114
- // 클래스명 재현 (figma-to-scss.js와 동일 로직)
115
- let cls = name
116
- .replace(/[^a-zA-Z0-9\s_-]/g, '')
117
- .replace(/[\s_]+/g, '-')
118
- .replace(/([a-z])([A-Z])/g, '$1-$2')
119
- .toLowerCase()
120
- .replace(/-+/g, '-')
121
- .replace(/^-|-$/g, '') || null;
122
-
123
- if (!cls) {
124
- const idx = parentPath ? parentPath.split('-').length : 0;
125
- if (type === 'TEXT') cls = `text-${idx}`;
126
- else if (type === 'VECTOR') cls = `vector-${idx}`;
127
- else if (type === 'RECTANGLE') cls = `rect-${idx}`;
128
- else cls = `el-${idx}`;
129
- }
130
-
131
- const currentPath = parentPath ? `${parentPath}-${cls}` : cls;
132
- const selector = `.${sectionClass}__${currentPath}`;
133
-
134
- // CSS 속성 저장 (kebab 변환)
135
- if (Object.keys(css).length > 0) {
136
- const kebabCSS = {};
137
- for (const [prop, value] of Object.entries(css)) {
138
- if (prop.startsWith('_')) continue;
139
- kebabCSS[camelToKebab(prop)] = String(value);
140
- }
141
- result[selector] = kebabCSS;
142
- }
143
-
144
- // 자식 재귀
145
- const seenClasses = new Set();
146
- for (const child of children) {
147
- const childName = child.name || '';
148
- const childLower = childName.toLowerCase();
149
- if (childLower === 'bg' || childLower.endsWith('-bg') || childLower.startsWith('bg-')) continue;
150
-
151
- let childCls = childName
152
- .replace(/[^a-zA-Z0-9\s_-]/g, '')
153
- .replace(/[\s_]+/g, '-')
154
- .replace(/([a-z])([A-Z])/g, '$1-$2')
155
- .toLowerCase()
156
- .replace(/-+/g, '-')
157
- .replace(/^-|-$/g, '') || null;
158
- if (!childCls) childCls = `${child.type?.toLowerCase() || 'el'}-0`;
159
-
160
- if (seenClasses.has(childCls)) continue;
161
- seenClasses.add(childCls);
162
- collectCSSFromTree(child, sectionClass, currentPath, result);
163
- }
164
- }
165
-
166
- function compareCSSValues(scssBlocks, treeCSS, filePath) {
167
- const errors = [];
168
-
169
- // SCSS에 있지만 tree에 없는 속성 (임의 추가)
170
- for (const [selector, props] of Object.entries(scssBlocks)) {
171
- if (!selector.startsWith('.')) continue;
172
- const treeProps = treeCSS[selector];
173
-
174
- for (const [prop, value] of Object.entries(props)) {
175
- // background-image url, background-size 등은 이미지 처리에서 추가됨
176
- if (prop === 'background-image' || prop === 'background-size' ||
177
- prop === 'background-position' || prop === 'background-repeat') continue;
178
- // imageRef 주석 스킵
179
- if (prop.startsWith('//')) continue;
180
-
181
- if (!treeProps || !(prop in treeProps)) {
182
- errors.push({
183
- priority: 'P2',
184
- file: filePath,
185
- type: 'extra-property',
186
- selector,
187
- property: prop,
188
- actual: value,
189
- message: `SCSS에 있지만 sections.json에 없는 속성: ${prop}: ${value}`
190
- });
191
- } else if (treeProps[prop] !== value) {
192
- errors.push({
193
- priority: 'P1',
194
- file: filePath,
195
- type: 'value-mismatch',
196
- selector,
197
- property: prop,
198
- expected: treeProps[prop],
199
- actual: value,
200
- message: `값 불일치: ${prop} expected="${treeProps[prop]}" actual="${value}"`
201
- });
202
- }
203
- }
204
- }
205
-
206
- // tree에 있지만 SCSS에 없는 속성 (누락)
207
- for (const [selector, props] of Object.entries(treeCSS)) {
208
- const scssProps = scssBlocks[selector];
209
- if (!scssProps) {
210
- errors.push({
211
- priority: 'P1',
212
- file: filePath,
213
- type: 'missing-selector',
214
- selector,
215
- message: `sections.json에 있지만 SCSS에 없는 셀렉터: ${selector}`
216
- });
217
- continue;
218
- }
219
- for (const [prop] of Object.entries(props)) {
220
- if (!(prop in scssProps)) {
221
- errors.push({
222
- priority: 'P1',
223
- file: filePath,
224
- type: 'missing-property',
225
- selector,
226
- property: prop,
227
- expected: props[prop],
228
- message: `SCSS에 누락된 속성: ${selector} { ${prop}: ${props[prop]} }`
229
- });
230
- }
231
- }
232
- }
233
-
234
- return errors;
235
- }
236
-
237
- // ─── Image Filename Check ───────────────────────────────────────────
238
-
239
- function checkImageFilenames(scssContent, filePath) {
240
- const errors = [];
241
- const urlRegex = /url\(['"]?([^'")\s]+)['"]?\)/g;
242
- let match;
243
-
244
- while ((match = urlRegex.exec(scssContent)) !== null) {
245
- const imgPath = match[1];
246
- const filename = path.basename(imgPath, path.extname(imgPath));
247
-
248
- // 해시 파일명 감지 (16자 이상 hex)
249
- if (/^[0-9a-f]{16,}$/.test(filename)) {
250
- errors.push({
251
- priority: 'P1',
252
- file: filePath,
253
- type: 'hash-filename',
254
- actual: imgPath,
255
- message: `해시 파일명 금지: ${imgPath} → kebab-case로 변경 필요`
256
- });
257
- }
258
- }
259
-
260
- return errors;
261
- }
262
-
263
- // ─── Main ───────────────────────────────────────────────────────────
264
-
265
- function main() {
266
- const args = process.argv.slice(2);
267
- if (args.length < 2) {
268
- console.error('Usage: node figma-validate.js <scss-dir> <sections.json> [--section=<name>]');
269
- process.exit(1);
270
- }
271
-
272
- const scssDir = args[0];
273
- const sectionsFile = args[1];
274
- let sectionFilter = '';
275
-
276
- for (const arg of args.slice(2)) {
277
- if (arg.startsWith('--section=')) sectionFilter = arg.slice(10);
278
- }
279
-
280
- // 입력 읽기
281
- const data = JSON.parse(fs.readFileSync(sectionsFile, 'utf-8'));
282
- let sections = data.sections || [];
283
-
284
- if (sectionFilter) {
285
- sections = sections.filter(s => s.name === sectionFilter);
286
- }
287
-
288
- const allErrors = [];
289
-
290
- for (const section of sections) {
291
- const sectionClass = section.name
292
- .replace(/[^a-zA-Z0-9\s_-]/g, '')
293
- .replace(/[\s_]+/g, '-')
294
- .replace(/([a-z])([A-Z])/g, '$1-$2')
295
- .toLowerCase()
296
- .replace(/-+/g, '-')
297
- .replace(/^-|-$/g, '');
298
-
299
- const scssFile = path.join(scssDir, `_${sectionClass}.scss`);
300
- if (!fs.existsSync(scssFile)) {
301
- allErrors.push({
302
- priority: 'P1',
303
- type: 'missing-file',
304
- expected: scssFile,
305
- message: `SCSS 파일 없음: ${scssFile}`
306
- });
307
- continue;
308
- }
309
-
310
- const scssContent = fs.readFileSync(scssFile, 'utf-8');
311
-
312
- // 1. 금지 패턴 검사
313
- allErrors.push(...detectForbidden(scssContent, scssFile));
314
-
315
- // 2. 이미지 파일명 검사
316
- allErrors.push(...checkImageFilenames(scssContent, scssFile));
317
-
318
- // 3. CSS 값 대조
319
- const scssBlocks = parseSCSS(scssContent);
320
- const treeCSS = {};
321
-
322
- // 루트 섹션 CSS
323
- const rootSelector = `.${sectionClass}`;
324
- if (section.css && Object.keys(section.css).length > 0) {
325
- treeCSS[rootSelector] = {};
326
- for (const [prop, value] of Object.entries(section.css)) {
327
- if (!prop.startsWith('_')) treeCSS[rootSelector][camelToKebab(prop)] = String(value);
328
- }
329
- }
330
-
331
- // 자식 CSS 재귀 수집
332
- for (const child of (section.children || [])) {
333
- collectCSSFromTree(child, sectionClass, '', treeCSS);
334
- }
335
-
336
- allErrors.push(...compareCSSValues(scssBlocks, treeCSS, scssFile));
337
- }
338
-
339
- // 결과 출력
340
- const p1 = allErrors.filter(e => e.priority === 'P1').length;
341
- const p2 = allErrors.filter(e => e.priority === 'P2').length;
342
-
343
- const result = {
344
- status: p1 === 0 ? 'PASS' : 'FAIL',
345
- errors: allErrors,
346
- summary: { p1, p2, total: allErrors.length }
347
- };
348
-
349
- console.log(JSON.stringify(result, null, 2));
350
- process.exit(p1 > 0 ? 1 : 0);
351
- }
352
-
353
- main();
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * figma-validate.js — SCSS vs sections.json 대조 검증
5
+ *
6
+ * Usage:
7
+ * node figma-validate.js <scss-dir> <sections.json> [--section=<name>]
8
+ *
9
+ * 검증 항목:
10
+ * 1. SCSS의 모든 CSS 속성이 sections.json에 근거하는가
11
+ * 2. sections.json의 CSS 속성이 SCSS에 누락되지 않았는가
12
+ * 3. 금지 패턴 감지 (커스텀 함수, aspect-ratio 등)
13
+ * 4. 이미지 파일명 kebab-case 확인
14
+ *
15
+ * 출력: JSON { status, errors[], summary }
16
+ */
17
+
18
+ import fs from 'fs';
19
+ import path from 'path';
20
+
21
+ // ─── Helpers ────────────────────────────────────────────────────────
22
+
23
+ function camelToKebab(str) {
24
+ return str.replace(/([A-Z])/g, '-$1').toLowerCase();
25
+ }
26
+
27
+ function parseSCSS(scssContent) {
28
+ // 간이 SCSS 파서: 셀렉터 → CSS 속성 맵 추출
29
+ const blocks = {};
30
+ let currentSelector = null;
31
+ const lines = scssContent.split('\n');
32
+
33
+ for (const line of lines) {
34
+ const trimmed = line.trim();
35
+
36
+ // 빈 줄, 코멘트 스킵
37
+ if (!trimmed || trimmed.startsWith('//') || trimmed.startsWith('/*')) continue;
38
+
39
+ // 셀렉터 열기
40
+ const selectorMatch = trimmed.match(/^([.&][a-zA-Z0-9_-][a-zA-Z0-9_-]*(?:__[a-zA-Z0-9_-]+(?:-[a-zA-Z0-9_-]+)*)?)\s*\{/);
41
+ if (selectorMatch) {
42
+ currentSelector = selectorMatch[1];
43
+ if (!blocks[currentSelector]) blocks[currentSelector] = {};
44
+ continue;
45
+ }
46
+
47
+ // 블록 닫기
48
+ if (trimmed === '}') {
49
+ currentSelector = null;
50
+ continue;
51
+ }
52
+
53
+ // CSS 속성
54
+ if (currentSelector && trimmed.includes(':') && trimmed.endsWith(';')) {
55
+ const colonIdx = trimmed.indexOf(':');
56
+ const prop = trimmed.slice(0, colonIdx).trim();
57
+ const value = trimmed.slice(colonIdx + 1).replace(/;$/, '').trim();
58
+ blocks[currentSelector][prop] = value;
59
+ }
60
+ }
61
+
62
+ return blocks;
63
+ }
64
+
65
+ // ─── Forbidden Pattern Detection ────────────────────────────────────
66
+
67
+ const FORBIDDEN_PATTERNS = [
68
+ { pattern: /@function\s/, id: 'custom-function', msg: '@function 자체 정의 금지' },
69
+ { pattern: /@mixin\s/, id: 'custom-mixin', msg: '@mixin 자체 정의 금지 (기존 @use만 허용)' },
70
+ { pattern: /aspect-ratio\s*:/, id: 'aspect-ratio', msg: 'aspect-ratio는 tree.json에 없는 속성' },
71
+ { pattern: /clamp\s*\(/, id: 'clamp', msg: 'clamp()는 font-size 외 사용 금지' },
72
+ { pattern: /\d+vw/, id: 'vw-unit', msg: 'vw 단위 사용 금지 (스태틱 구현)' },
73
+ { pattern: /@media\s/, id: 'media-query', msg: '@media 금지 (스태틱 구현)' },
74
+ { pattern: /@include\s/, id: 'include', msg: '@include 사용 시 기존 프로젝트 믹스인만 허용' },
75
+ ];
76
+
77
+ function detectForbidden(scssContent, filePath) {
78
+ const errors = [];
79
+ const lines = scssContent.split('\n');
80
+
81
+ for (let i = 0; i < lines.length; i++) {
82
+ const line = lines[i];
83
+ for (const { pattern, id, msg } of FORBIDDEN_PATTERNS) {
84
+ if (pattern.test(line)) {
85
+ // clamp in font-size is allowed
86
+ if (id === 'clamp' && line.includes('font-size')) continue;
87
+ errors.push({
88
+ priority: 'P1',
89
+ file: filePath,
90
+ line: i + 1,
91
+ type: `forbidden-${id}`,
92
+ actual: line.trim(),
93
+ message: msg
94
+ });
95
+ }
96
+ }
97
+ }
98
+
99
+ return errors;
100
+ }
101
+
102
+ // ─── CSS Value Comparison ───────────────────────────────────────────
103
+
104
+ function collectCSSFromTree(node, sectionClass, parentPath, result) {
105
+ const css = node.css || {};
106
+ const children = node.children || [];
107
+ const name = node.name || '';
108
+ const type = node.type || '';
109
+
110
+ // BG 프레임 스킵
111
+ const nameLower = name.toLowerCase();
112
+ if (nameLower === 'bg' || nameLower.endsWith('-bg') || nameLower.startsWith('bg-')) return;
113
+
114
+ // 클래스명 재현 (figma-to-scss.js와 동일 로직)
115
+ let cls = name
116
+ .replace(/[^a-zA-Z0-9\s_-]/g, '')
117
+ .replace(/[\s_]+/g, '-')
118
+ .replace(/([a-z])([A-Z])/g, '$1-$2')
119
+ .toLowerCase()
120
+ .replace(/-+/g, '-')
121
+ .replace(/^-|-$/g, '') || null;
122
+
123
+ if (!cls) {
124
+ const idx = parentPath ? parentPath.split('-').length : 0;
125
+ if (type === 'TEXT') cls = `text-${idx}`;
126
+ else if (type === 'VECTOR') cls = `vector-${idx}`;
127
+ else if (type === 'RECTANGLE') cls = `rect-${idx}`;
128
+ else cls = `el-${idx}`;
129
+ }
130
+
131
+ const currentPath = parentPath ? `${parentPath}-${cls}` : cls;
132
+ const selector = `.${sectionClass}__${currentPath}`;
133
+
134
+ // CSS 속성 저장 (kebab 변환)
135
+ if (Object.keys(css).length > 0) {
136
+ const kebabCSS = {};
137
+ for (const [prop, value] of Object.entries(css)) {
138
+ if (prop.startsWith('_')) continue;
139
+ kebabCSS[camelToKebab(prop)] = String(value);
140
+ }
141
+ result[selector] = kebabCSS;
142
+ }
143
+
144
+ // 자식 재귀
145
+ const seenClasses = new Set();
146
+ for (const child of children) {
147
+ const childName = child.name || '';
148
+ const childLower = childName.toLowerCase();
149
+ if (childLower === 'bg' || childLower.endsWith('-bg') || childLower.startsWith('bg-')) continue;
150
+
151
+ let childCls = childName
152
+ .replace(/[^a-zA-Z0-9\s_-]/g, '')
153
+ .replace(/[\s_]+/g, '-')
154
+ .replace(/([a-z])([A-Z])/g, '$1-$2')
155
+ .toLowerCase()
156
+ .replace(/-+/g, '-')
157
+ .replace(/^-|-$/g, '') || null;
158
+ if (!childCls) childCls = `${child.type?.toLowerCase() || 'el'}-0`;
159
+
160
+ if (seenClasses.has(childCls)) continue;
161
+ seenClasses.add(childCls);
162
+ collectCSSFromTree(child, sectionClass, currentPath, result);
163
+ }
164
+ }
165
+
166
+ function compareCSSValues(scssBlocks, treeCSS, filePath) {
167
+ const errors = [];
168
+
169
+ // SCSS에 있지만 tree에 없는 속성 (임의 추가)
170
+ for (const [selector, props] of Object.entries(scssBlocks)) {
171
+ if (!selector.startsWith('.')) continue;
172
+ const treeProps = treeCSS[selector];
173
+
174
+ for (const [prop, value] of Object.entries(props)) {
175
+ // background-image url, background-size 등은 이미지 처리에서 추가됨
176
+ if (prop === 'background-image' || prop === 'background-size' ||
177
+ prop === 'background-position' || prop === 'background-repeat') continue;
178
+ // imageRef 주석 스킵
179
+ if (prop.startsWith('//')) continue;
180
+
181
+ if (!treeProps || !(prop in treeProps)) {
182
+ errors.push({
183
+ priority: 'P2',
184
+ file: filePath,
185
+ type: 'extra-property',
186
+ selector,
187
+ property: prop,
188
+ actual: value,
189
+ message: `SCSS에 있지만 sections.json에 없는 속성: ${prop}: ${value}`
190
+ });
191
+ } else if (treeProps[prop] !== value) {
192
+ errors.push({
193
+ priority: 'P1',
194
+ file: filePath,
195
+ type: 'value-mismatch',
196
+ selector,
197
+ property: prop,
198
+ expected: treeProps[prop],
199
+ actual: value,
200
+ message: `값 불일치: ${prop} expected="${treeProps[prop]}" actual="${value}"`
201
+ });
202
+ }
203
+ }
204
+ }
205
+
206
+ // tree에 있지만 SCSS에 없는 속성 (누락)
207
+ for (const [selector, props] of Object.entries(treeCSS)) {
208
+ const scssProps = scssBlocks[selector];
209
+ if (!scssProps) {
210
+ errors.push({
211
+ priority: 'P1',
212
+ file: filePath,
213
+ type: 'missing-selector',
214
+ selector,
215
+ message: `sections.json에 있지만 SCSS에 없는 셀렉터: ${selector}`
216
+ });
217
+ continue;
218
+ }
219
+ for (const [prop] of Object.entries(props)) {
220
+ if (!(prop in scssProps)) {
221
+ errors.push({
222
+ priority: 'P1',
223
+ file: filePath,
224
+ type: 'missing-property',
225
+ selector,
226
+ property: prop,
227
+ expected: props[prop],
228
+ message: `SCSS에 누락된 속성: ${selector} { ${prop}: ${props[prop]} }`
229
+ });
230
+ }
231
+ }
232
+ }
233
+
234
+ return errors;
235
+ }
236
+
237
+ // ─── Image Filename Check ───────────────────────────────────────────
238
+
239
+ function checkImageFilenames(scssContent, filePath) {
240
+ const errors = [];
241
+ const urlRegex = /url\(['"]?([^'")\s]+)['"]?\)/g;
242
+ let match;
243
+
244
+ while ((match = urlRegex.exec(scssContent)) !== null) {
245
+ const imgPath = match[1];
246
+ const filename = path.basename(imgPath, path.extname(imgPath));
247
+
248
+ // 해시 파일명 감지 (16자 이상 hex)
249
+ if (/^[0-9a-f]{16,}$/.test(filename)) {
250
+ errors.push({
251
+ priority: 'P1',
252
+ file: filePath,
253
+ type: 'hash-filename',
254
+ actual: imgPath,
255
+ message: `해시 파일명 금지: ${imgPath} → kebab-case로 변경 필요`
256
+ });
257
+ }
258
+ }
259
+
260
+ return errors;
261
+ }
262
+
263
+ // ─── Main ───────────────────────────────────────────────────────────
264
+
265
+ function main() {
266
+ const args = process.argv.slice(2);
267
+ if (args.length < 2) {
268
+ console.error('Usage: node figma-validate.js <scss-dir> <sections.json> [--section=<name>]');
269
+ process.exit(1);
270
+ }
271
+
272
+ const scssDir = args[0];
273
+ const sectionsFile = args[1];
274
+ let sectionFilter = '';
275
+
276
+ for (const arg of args.slice(2)) {
277
+ if (arg.startsWith('--section=')) sectionFilter = arg.slice(10);
278
+ }
279
+
280
+ // 입력 읽기
281
+ const data = JSON.parse(fs.readFileSync(sectionsFile, 'utf-8'));
282
+ let sections = data.sections || [];
283
+
284
+ if (sectionFilter) {
285
+ sections = sections.filter(s => s.name === sectionFilter);
286
+ }
287
+
288
+ const allErrors = [];
289
+
290
+ for (const section of sections) {
291
+ const sectionClass = section.name
292
+ .replace(/[^a-zA-Z0-9\s_-]/g, '')
293
+ .replace(/[\s_]+/g, '-')
294
+ .replace(/([a-z])([A-Z])/g, '$1-$2')
295
+ .toLowerCase()
296
+ .replace(/-+/g, '-')
297
+ .replace(/^-|-$/g, '');
298
+
299
+ const scssFile = path.join(scssDir, `_${sectionClass}.scss`);
300
+ if (!fs.existsSync(scssFile)) {
301
+ allErrors.push({
302
+ priority: 'P1',
303
+ type: 'missing-file',
304
+ expected: scssFile,
305
+ message: `SCSS 파일 없음: ${scssFile}`
306
+ });
307
+ continue;
308
+ }
309
+
310
+ const scssContent = fs.readFileSync(scssFile, 'utf-8');
311
+
312
+ // 1. 금지 패턴 검사
313
+ allErrors.push(...detectForbidden(scssContent, scssFile));
314
+
315
+ // 2. 이미지 파일명 검사
316
+ allErrors.push(...checkImageFilenames(scssContent, scssFile));
317
+
318
+ // 3. CSS 값 대조
319
+ const scssBlocks = parseSCSS(scssContent);
320
+ const treeCSS = {};
321
+
322
+ // 루트 섹션 CSS
323
+ const rootSelector = `.${sectionClass}`;
324
+ if (section.css && Object.keys(section.css).length > 0) {
325
+ treeCSS[rootSelector] = {};
326
+ for (const [prop, value] of Object.entries(section.css)) {
327
+ if (!prop.startsWith('_')) treeCSS[rootSelector][camelToKebab(prop)] = String(value);
328
+ }
329
+ }
330
+
331
+ // 자식 CSS 재귀 수집
332
+ for (const child of (section.children || [])) {
333
+ collectCSSFromTree(child, sectionClass, '', treeCSS);
334
+ }
335
+
336
+ allErrors.push(...compareCSSValues(scssBlocks, treeCSS, scssFile));
337
+ }
338
+
339
+ // 결과 출력
340
+ const p1 = allErrors.filter(e => e.priority === 'P1').length;
341
+ const p2 = allErrors.filter(e => e.priority === 'P2').length;
342
+
343
+ const result = {
344
+ status: p1 === 0 ? 'PASS' : 'FAIL',
345
+ errors: allErrors,
346
+ summary: { p1, p2, total: allErrors.length }
347
+ };
348
+
349
+ console.log(JSON.stringify(result, null, 2));
350
+ process.exit(p1 > 0 ? 1 : 0);
351
+ }
352
+
353
+ main();