@sarjallab09/figma-intelligence 1.1.0 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (297) hide show
  1. package/README.md +69 -36
  2. package/dist/bin/cli.js +2 -0
  3. package/dist/design-bridge/bridge.js +2 -0
  4. package/dist/figma-bridge-plugin/bridge-relay.js +2 -0
  5. package/dist/figma-bridge-plugin/code.js +1 -0
  6. package/{figma-bridge-plugin → dist/figma-bridge-plugin}/package-lock.json +0 -3
  7. package/dist/figma-bridge-plugin/ui.html +4970 -0
  8. package/dist/figma-intelligence-layer/dist/index.js +2 -0
  9. package/dist/scripts/clean-existing-chunks.js +2 -0
  10. package/dist/scripts/connect-ai-tool.js +2 -0
  11. package/dist/scripts/convert-hub-pdfs.js +2 -0
  12. package/dist/scripts/figma-mcp-status.js +2 -0
  13. package/dist/scripts/register-codex-mcp.js +2 -0
  14. package/dist/scripts/test-copilot-chat.js +2 -0
  15. package/package.json +11 -8
  16. package/bin/cli.js +0 -859
  17. package/design-bridge/bridge.js +0 -196
  18. package/design-bridge/lib/assets.js +0 -367
  19. package/design-bridge/lib/prompt.js +0 -85
  20. package/design-bridge/lib/server.js +0 -66
  21. package/design-bridge/lib/stitch.js +0 -37
  22. package/design-bridge/lib/tokens.js +0 -82
  23. package/design-bridge/package-lock.json +0 -579
  24. package/figma-bridge-plugin/README.md +0 -97
  25. package/figma-bridge-plugin/anthropic-chat-runner.js +0 -192
  26. package/figma-bridge-plugin/bridge-relay.js +0 -2505
  27. package/figma-bridge-plugin/chat-runner.js +0 -485
  28. package/figma-bridge-plugin/code.js +0 -1534
  29. package/figma-bridge-plugin/codex-runner.js +0 -505
  30. package/figma-bridge-plugin/component-schemas.js +0 -110
  31. package/figma-bridge-plugin/content-context.js +0 -869
  32. package/figma-bridge-plugin/create-button.js +0 -216
  33. package/figma-bridge-plugin/gemini-cli-runner.js +0 -291
  34. package/figma-bridge-plugin/gemini-runner.js +0 -187
  35. package/figma-bridge-plugin/html-to-figma.js +0 -927
  36. package/figma-bridge-plugin/knowledge-hub/.gitkeep +0 -0
  37. package/figma-bridge-plugin/knowledge-hub/uspec-references/anatomy-spec.md +0 -159
  38. package/figma-bridge-plugin/knowledge-hub/uspec-references/api-spec.md +0 -162
  39. package/figma-bridge-plugin/knowledge-hub/uspec-references/color-spec.md +0 -148
  40. package/figma-bridge-plugin/knowledge-hub/uspec-references/full-spec-template.md +0 -314
  41. package/figma-bridge-plugin/knowledge-hub/uspec-references/property-spec.md +0 -175
  42. package/figma-bridge-plugin/knowledge-hub/uspec-references/screen-reader-spec.md +0 -180
  43. package/figma-bridge-plugin/knowledge-hub/uspec-references/structure-spec.md +0 -165
  44. package/figma-bridge-plugin/perplexity-runner.js +0 -188
  45. package/figma-bridge-plugin/references/SKILL.md +0 -178
  46. package/figma-bridge-plugin/references/anatomy-spec.md +0 -159
  47. package/figma-bridge-plugin/references/api-spec.md +0 -162
  48. package/figma-bridge-plugin/references/color-spec.md +0 -148
  49. package/figma-bridge-plugin/references/full-spec-template.md +0 -314
  50. package/figma-bridge-plugin/references/property-spec.md +0 -175
  51. package/figma-bridge-plugin/references/screen-reader-spec.md +0 -180
  52. package/figma-bridge-plugin/references/structure-spec.md +0 -165
  53. package/figma-bridge-plugin/shared-prompt-config.js +0 -645
  54. package/figma-bridge-plugin/spec-helpers/build-table.js +0 -269
  55. package/figma-bridge-plugin/spec-helpers/classify-elements.js +0 -189
  56. package/figma-bridge-plugin/spec-helpers/index.js +0 -35
  57. package/figma-bridge-plugin/spec-helpers/parse-figma-link.js +0 -49
  58. package/figma-bridge-plugin/spec-helpers/position-markers.js +0 -158
  59. package/figma-bridge-plugin/stitch-auth.js +0 -322
  60. package/figma-bridge-plugin/stitch-runner.js +0 -1427
  61. package/figma-bridge-plugin/token-resolver.js +0 -107
  62. package/figma-bridge-plugin/ui.html +0 -4542
  63. package/figma-intelligence-layer/.env.example +0 -39
  64. package/figma-intelligence-layer/docs/local-image-generation.md +0 -60
  65. package/figma-intelligence-layer/examples/comfyui-workflow-template.example.json +0 -101
  66. package/figma-intelligence-layer/jest.config.js +0 -14
  67. package/figma-intelligence-layer/mcp-config.json +0 -19
  68. package/figma-intelligence-layer/package-lock.json +0 -5892
  69. package/figma-intelligence-layer/scripts/setup-comfyui-local.sh +0 -67
  70. package/figma-intelligence-layer/scripts/start-comfyui.sh +0 -33
  71. package/figma-intelligence-layer/src/index.ts +0 -2233
  72. package/figma-intelligence-layer/src/shared/auto-layout-validator.ts +0 -404
  73. package/figma-intelligence-layer/src/shared/cache.ts +0 -187
  74. package/figma-intelligence-layer/src/shared/color-operations.ts +0 -533
  75. package/figma-intelligence-layer/src/shared/color-utils.ts +0 -138
  76. package/figma-intelligence-layer/src/shared/component-script-builder.ts +0 -413
  77. package/figma-intelligence-layer/src/shared/component-templates.ts +0 -2767
  78. package/figma-intelligence-layer/src/shared/concept-taxonomy.ts +0 -694
  79. package/figma-intelligence-layer/src/shared/decision-log.ts +0 -128
  80. package/figma-intelligence-layer/src/shared/design-system-context.ts +0 -568
  81. package/figma-intelligence-layer/src/shared/design-system-intelligence.ts +0 -131
  82. package/figma-intelligence-layer/src/shared/design-system-matcher.ts +0 -184
  83. package/figma-intelligence-layer/src/shared/design-system-normalizers.ts +0 -196
  84. package/figma-intelligence-layer/src/shared/design-system-tokens.ts +0 -295
  85. package/figma-intelligence-layer/src/shared/dtcg-validator.ts +0 -530
  86. package/figma-intelligence-layer/src/shared/enrichment-pipeline.ts +0 -671
  87. package/figma-intelligence-layer/src/shared/figma-bridge.ts +0 -1418
  88. package/figma-intelligence-layer/src/shared/font-config.ts +0 -126
  89. package/figma-intelligence-layer/src/shared/icon-catalog.ts +0 -360
  90. package/figma-intelligence-layer/src/shared/icon-fetch.ts +0 -80
  91. package/figma-intelligence-layer/src/shared/prototype-script-builder.ts +0 -162
  92. package/figma-intelligence-layer/src/shared/response-compression.ts +0 -440
  93. package/figma-intelligence-layer/src/shared/semantic-token-catalog.ts +0 -324
  94. package/figma-intelligence-layer/src/shared/token-binder.ts +0 -505
  95. package/figma-intelligence-layer/src/shared/token-math.ts +0 -427
  96. package/figma-intelligence-layer/src/shared/token-naming.ts +0 -468
  97. package/figma-intelligence-layer/src/shared/token-utils.ts +0 -420
  98. package/figma-intelligence-layer/src/shared/types.ts +0 -346
  99. package/figma-intelligence-layer/src/shared/typography-presets.ts +0 -94
  100. package/figma-intelligence-layer/src/shared/unsplash.ts +0 -165
  101. package/figma-intelligence-layer/src/shared/vision-client.ts +0 -607
  102. package/figma-intelligence-layer/src/shared/vision-provider-anthropic.ts +0 -334
  103. package/figma-intelligence-layer/src/shared/vision-provider-openai.ts +0 -446
  104. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/a11y-annotate-handler.ts +0 -782
  105. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/a11y-annotate-renderer.ts +0 -496
  106. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/a11y-annotation-kit.ts +0 -230
  107. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/colorblind-sim.ts +0 -66
  108. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/index.ts +0 -810
  109. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/keyboard-sr-order-analyzer.ts +0 -1191
  110. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/keyboard-sr-order-figma-page.ts +0 -1346
  111. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/keyboard-sr-order-handler.ts +0 -148
  112. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/vpat-figma-page.ts +0 -499
  113. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/vpat-report.ts +0 -910
  114. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/wcag-checker.ts +0 -989
  115. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/wcag-criteria.ts +0 -1160
  116. package/figma-intelligence-layer/src/tools/phase1-vision/design-from-ref/index.ts +0 -424
  117. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/component-recognizer.ts +0 -38
  118. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/ds-matcher.ts +0 -111
  119. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/font-matcher.ts +0 -114
  120. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/icon-resolver.ts +0 -103
  121. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/index.ts +0 -1060
  122. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/layout-segmenter.ts +0 -18
  123. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/token-inferencer.ts +0 -39
  124. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/vision-pipeline.ts +0 -58
  125. package/figma-intelligence-layer/src/tools/phase1-vision/sketch-to-design/index.ts +0 -298
  126. package/figma-intelligence-layer/src/tools/phase1-vision/visual-audit/index.ts +0 -197
  127. package/figma-intelligence-layer/src/tools/phase2-accuracy/component-audit/index.ts +0 -494
  128. package/figma-intelligence-layer/src/tools/phase2-accuracy/intent-translator/index.ts +0 -356
  129. package/figma-intelligence-layer/src/tools/phase2-accuracy/layout-intelligence/container-patterns.ts +0 -123
  130. package/figma-intelligence-layer/src/tools/phase2-accuracy/layout-intelligence/index.ts +0 -663
  131. package/figma-intelligence-layer/src/tools/phase2-accuracy/lint-rules/built-in-rules.yaml +0 -56
  132. package/figma-intelligence-layer/src/tools/phase2-accuracy/lint-rules/index.ts +0 -614
  133. package/figma-intelligence-layer/src/tools/phase2-accuracy/lint-rules/rule-engine.ts +0 -113
  134. package/figma-intelligence-layer/src/tools/phase2-accuracy/theme-generator/color-theory.ts +0 -178
  135. package/figma-intelligence-layer/src/tools/phase2-accuracy/theme-generator/index.ts +0 -470
  136. package/figma-intelligence-layer/src/tools/phase2-accuracy/variant-expander/index.ts +0 -429
  137. package/figma-intelligence-layer/src/tools/phase2-accuracy/variant-expander/token-override-maps.ts +0 -226
  138. package/figma-intelligence-layer/src/tools/phase3-generation/ai-image-insert/index.ts +0 -535
  139. package/figma-intelligence-layer/src/tools/phase3-generation/component-archaeologist/index.ts +0 -660
  140. package/figma-intelligence-layer/src/tools/phase3-generation/component-archaeologist/pattern-fingerprints.ts +0 -209
  141. package/figma-intelligence-layer/src/tools/phase3-generation/composition-builder/index.ts +0 -540
  142. package/figma-intelligence-layer/src/tools/phase3-generation/figma-animated-build.ts +0 -391
  143. package/figma-intelligence-layer/src/tools/phase3-generation/page-architect/index.ts +0 -2019
  144. package/figma-intelligence-layer/src/tools/phase3-generation/page-architect/screen-templates.ts +0 -131
  145. package/figma-intelligence-layer/src/tools/phase3-generation/prototype-map/index.ts +0 -381
  146. package/figma-intelligence-layer/src/tools/phase3-generation/prototype-wire/index.ts +0 -565
  147. package/figma-intelligence-layer/src/tools/phase3-generation/swarm-build/index.ts +0 -764
  148. package/figma-intelligence-layer/src/tools/phase3-generation/system-drift/index.ts +0 -535
  149. package/figma-intelligence-layer/src/tools/phase3-generation/unsplash-search/index.ts +0 -84
  150. package/figma-intelligence-layer/src/tools/phase3-generation/url-to-frame/index.ts +0 -401
  151. package/figma-intelligence-layer/src/tools/phase4-sync/animation-specifier/code-generators/css-animations.ts +0 -68
  152. package/figma-intelligence-layer/src/tools/phase4-sync/animation-specifier/code-generators/framer-motion.ts +0 -78
  153. package/figma-intelligence-layer/src/tools/phase4-sync/animation-specifier/code-generators/swift-animations.ts +0 -93
  154. package/figma-intelligence-layer/src/tools/phase4-sync/animation-specifier/index.ts +0 -596
  155. package/figma-intelligence-layer/src/tools/phase4-sync/ci-check/index.ts +0 -462
  156. package/figma-intelligence-layer/src/tools/phase4-sync/export-tokens/index.ts +0 -1470
  157. package/figma-intelligence-layer/src/tools/phase4-sync/generate-component-code/index.ts +0 -829
  158. package/figma-intelligence-layer/src/tools/phase4-sync/handoff-spec/index.ts +0 -702
  159. package/figma-intelligence-layer/src/tools/phase4-sync/icon-library-sync/index.ts +0 -483
  160. package/figma-intelligence-layer/src/tools/phase4-sync/sync-from-code/index.ts +0 -501
  161. package/figma-intelligence-layer/src/tools/phase4-sync/sync-from-code/storybook-parser.ts +0 -106
  162. package/figma-intelligence-layer/src/tools/phase4-sync/watch-docs/index.ts +0 -676
  163. package/figma-intelligence-layer/src/tools/phase4-sync/webhook-listener/index.ts +0 -560
  164. package/figma-intelligence-layer/src/tools/phase5-governance/apg-doc/index.ts +0 -1043
  165. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/component-detection.ts +0 -620
  166. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/anatomy.ts +0 -331
  167. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/color-tokens.ts +0 -77
  168. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/properties.ts +0 -54
  169. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/snapshot.ts +0 -287
  170. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/spacing.ts +0 -71
  171. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/states.ts +0 -43
  172. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/typography.ts +0 -71
  173. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/index.ts +0 -221
  174. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/_default.ts +0 -166
  175. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/accordion.ts +0 -232
  176. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/alert.ts +0 -234
  177. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/avatar-group.ts +0 -270
  178. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/avatar.ts +0 -249
  179. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/badge.ts +0 -231
  180. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/banner.ts +0 -293
  181. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/breadcrumb.ts +0 -240
  182. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/button.ts +0 -243
  183. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/calendar.ts +0 -307
  184. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/card.ts +0 -143
  185. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/checkbox.ts +0 -227
  186. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/chip.ts +0 -233
  187. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/combobox.ts +0 -282
  188. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/datepicker.ts +0 -276
  189. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/divider.ts +0 -223
  190. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/drawer.ts +0 -255
  191. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/dropdown-menu.ts +0 -289
  192. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/empty-state.ts +0 -261
  193. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/file-uploader.ts +0 -290
  194. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/form.ts +0 -265
  195. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/grid.ts +0 -238
  196. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/icon.ts +0 -255
  197. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/index.ts +0 -128
  198. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/inline-edit.ts +0 -286
  199. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/inline-message.ts +0 -255
  200. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/input.ts +0 -330
  201. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/link.ts +0 -247
  202. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/list.ts +0 -250
  203. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/menu.ts +0 -247
  204. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/modal.ts +0 -144
  205. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/navbar.ts +0 -264
  206. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/navigation.ts +0 -251
  207. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/number-input.ts +0 -261
  208. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/pagination.ts +0 -248
  209. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/popover.ts +0 -270
  210. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/progress.ts +0 -251
  211. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/radio.ts +0 -142
  212. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/range-slider.ts +0 -282
  213. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/rating.ts +0 -250
  214. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/search.ts +0 -258
  215. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/segmented-control.ts +0 -265
  216. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/select.ts +0 -319
  217. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/skeleton.ts +0 -256
  218. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/slider.ts +0 -232
  219. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/spinner.ts +0 -239
  220. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/status-dot.ts +0 -252
  221. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/stepper.ts +0 -270
  222. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/table.ts +0 -244
  223. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/tabs.ts +0 -143
  224. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/tag.ts +0 -243
  225. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/textarea.ts +0 -259
  226. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/time-picker.ts +0 -293
  227. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/toast.ts +0 -144
  228. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/toggle.ts +0 -289
  229. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/toolbar.ts +0 -267
  230. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/tooltip.ts +0 -232
  231. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/treeview.ts +0 -257
  232. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/typography.ts +0 -319
  233. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/legacy-compat.ts +0 -121
  234. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/anatomy-diagram.ts +0 -430
  235. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/figma-page.ts +0 -312
  236. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/json.ts +0 -129
  237. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/markdown.ts +0 -78
  238. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/visual-doc.ts +0 -2333
  239. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/accessibility.ts +0 -100
  240. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/anatomy.ts +0 -32
  241. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/color-tokens.ts +0 -59
  242. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/content-guidance.ts +0 -18
  243. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/design-tokens.ts +0 -53
  244. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/interaction-rules.ts +0 -19
  245. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/overview.ts +0 -91
  246. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/properties-api.ts +0 -71
  247. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/qa-criteria.ts +0 -19
  248. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/related-components.ts +0 -110
  249. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/responsive.ts +0 -19
  250. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/size-specs.ts +0 -67
  251. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/spacing-structure.ts +0 -58
  252. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/state-specs.ts +0 -79
  253. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/states.ts +0 -50
  254. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/type-hierarchy.ts +0 -33
  255. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/typography.ts +0 -55
  256. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/usage-guidelines.ts +0 -73
  257. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/variants.ts +0 -81
  258. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/types.ts +0 -409
  259. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec-sheet/index.ts +0 -198
  260. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec-sheet/renderer.ts +0 -701
  261. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec-sheet/types.ts +0 -88
  262. package/figma-intelligence-layer/src/tools/phase5-governance/decision-log/index.ts +0 -135
  263. package/figma-intelligence-layer/src/tools/phase5-governance/design-decision-log/index.ts +0 -491
  264. package/figma-intelligence-layer/src/tools/phase5-governance/ds-primitives/index.ts +0 -416
  265. package/figma-intelligence-layer/src/tools/phase5-governance/ds-scaffolder/index.ts +0 -722
  266. package/figma-intelligence-layer/src/tools/phase5-governance/ds-variables/index.ts +0 -449
  267. package/figma-intelligence-layer/src/tools/phase5-governance/health-report/index.ts +0 -393
  268. package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/index.ts +0 -406
  269. package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/renderers/figma-page.ts +0 -292
  270. package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/renderers/json.ts +0 -24
  271. package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/renderers/markdown.ts +0 -172
  272. package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/renderers/naming-guide.ts +0 -409
  273. package/figma-intelligence-layer/src/tools/phase5-governance/token-analytics/index.ts +0 -594
  274. package/figma-intelligence-layer/src/tools/phase5-governance/token-docs/index.ts +0 -710
  275. package/figma-intelligence-layer/src/tools/phase5-governance/token-migrate/index.ts +0 -458
  276. package/figma-intelligence-layer/src/tools/phase5-governance/token-naming/index.ts +0 -134
  277. package/figma-intelligence-layer/tests/apg-doc.test.ts +0 -101
  278. package/figma-intelligence-layer/tests/design-system-context.test.ts +0 -152
  279. package/figma-intelligence-layer/tests/design-system-matcher.test.ts +0 -144
  280. package/figma-intelligence-layer/tests/figma-bridge.test.ts +0 -83
  281. package/figma-intelligence-layer/tests/generate-image-and-insert.test.ts +0 -56
  282. package/figma-intelligence-layer/tests/screen-cloner-regression.test.ts +0 -69
  283. package/figma-intelligence-layer/tests/smoke.test.ts +0 -174
  284. package/figma-intelligence-layer/tests/spec-generator.test.ts +0 -127
  285. package/figma-intelligence-layer/tests/token-migrate.test.ts +0 -21
  286. package/figma-intelligence-layer/tests/token-naming.test.ts +0 -30
  287. package/figma-intelligence-layer/tsconfig.json +0 -19
  288. package/scripts/clean-existing-chunks.js +0 -179
  289. package/scripts/connect-ai-tool.js +0 -490
  290. package/scripts/convert-hub-pdfs.js +0 -425
  291. package/scripts/figma-mcp-status.js +0 -349
  292. package/scripts/register-codex-mcp.js +0 -96
  293. /package/{design-bridge → dist/design-bridge}/.env.example +0 -0
  294. /package/{design-bridge → dist/design-bridge}/package.json +0 -0
  295. /package/{figma-bridge-plugin → dist/figma-bridge-plugin}/manifest.json +0 -0
  296. /package/{figma-bridge-plugin → dist/figma-bridge-plugin}/package.json +0 -0
  297. /package/{figma-intelligence-layer → dist/figma-intelligence-layer}/package.json +0 -0
package/bin/cli.js DELETED
@@ -1,859 +0,0 @@
1
- #!/usr/bin/env node
2
- "use strict";
3
-
4
- /**
5
- * figma-intelligence CLI
6
- *
7
- * Usage:
8
- * npx figma-intelligence start # Start the bridge relay server
9
- * npx figma-intelligence stop # Stop the relay server
10
- * npx figma-intelligence status # Show relay + CLI auth status
11
- * npx figma-intelligence doctor # Diagnose common issues
12
- * npx figma-intelligence setup # Full interactive setup (install deps, register MCP, start relay)
13
- */
14
-
15
- const { spawn, spawnSync, execSync } = require("child_process");
16
- const fs = require("fs");
17
- const path = require("path");
18
- const os = require("os");
19
- const readline = require("readline");
20
-
21
- // ── Paths ───────────────────────────────────────────────────────────────────
22
- const ROOT_DIR = path.resolve(__dirname, "..");
23
- const RELAY_SCRIPT = path.join(ROOT_DIR, "figma-bridge-plugin", "bridge-relay.js");
24
- const MCP_BUILD = path.join(ROOT_DIR, "figma-intelligence-layer", "dist", "index.js");
25
- const MCP_SRC = path.join(ROOT_DIR, "figma-intelligence-layer");
26
- const BRIDGE_DIR = path.join(ROOT_DIR, "figma-bridge-plugin");
27
- const DESIGN_BRIDGE_DIR = path.join(ROOT_DIR, "design-bridge");
28
- const DATA_DIR = path.join(os.homedir(), ".figma-intelligence");
29
- const PID_FILE = path.join(DATA_DIR, "relay.pid");
30
- const LOG_FILE = path.join(DATA_DIR, "relay.log");
31
- const PORT = parseInt(process.env.BRIDGE_PORT || "9001", 10);
32
-
33
- const PLIST_LABEL = "com.figma-intelligence.bridge-relay";
34
- const PLIST_DIR = path.join(os.homedir(), "Library", "LaunchAgents");
35
- const PLIST_PATH = path.join(PLIST_DIR, `${PLIST_LABEL}.plist`);
36
-
37
- // ── Helpers ─────────────────────────────────────────────────────────────────
38
- function log(msg) { console.log(msg); }
39
- function success(msg) { console.log(` \u2714 ${msg}`); }
40
- function warn(msg) { console.log(` \u26A0 ${msg}`); }
41
- function fail(msg) { console.log(` \u274C ${msg}`); }
42
- function info(msg) { console.log(` \u2139 ${msg}`); }
43
-
44
- function run(cmd, args, opts = {}) {
45
- const r = spawnSync(cmd, args, { encoding: "utf8", shell: true, ...opts });
46
- return { ok: r.status === 0, stdout: (r.stdout || "").trim(), stderr: (r.stderr || "").trim() };
47
- }
48
-
49
- function which(cmd) {
50
- const r = run("which", [cmd]);
51
- return r.ok ? r.stdout : null;
52
- }
53
-
54
- function extractEmail(text) {
55
- const m = text.match(/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/);
56
- return m ? m[0] : "";
57
- }
58
-
59
- function maskToken(t) {
60
- if (!t || t.length < 8) return "(not set)";
61
- return `${t.slice(0, 4)}....${t.slice(-4)}`;
62
- }
63
-
64
- function ensureDataDir() {
65
- fs.mkdirSync(DATA_DIR, { recursive: true });
66
- }
67
-
68
- function isPortInUse(port) {
69
- const r = run("lsof", ["-n", "-P", `-iTCP:${port}`, "-sTCP:LISTEN"]);
70
- return r.ok && r.stdout.length > 0;
71
- }
72
-
73
- function getRelayPid() {
74
- if (!fs.existsSync(PID_FILE)) return null;
75
- const pid = parseInt(fs.readFileSync(PID_FILE, "utf8").trim(), 10);
76
- if (isNaN(pid)) return null;
77
- try { process.kill(pid, 0); return pid; } catch { return null; }
78
- }
79
-
80
- function prompt(question) {
81
- return new Promise((resolve) => {
82
- const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
83
- rl.question(question, (answer) => { rl.close(); resolve(answer.trim()); });
84
- });
85
- }
86
-
87
- // ── CLI Detection ───────────────────────────────────────────────────────────
88
-
89
- function detectCLIs() {
90
- const clis = {};
91
-
92
- // Claude
93
- const claudeBin = which("claude");
94
- if (claudeBin) {
95
- const authResult = run(claudeBin, ["auth", "status"]);
96
- const output = authResult.stdout + " " + authResult.stderr;
97
- clis.claude = {
98
- bin: claudeBin,
99
- loggedIn: authResult.ok,
100
- email: extractEmail(output),
101
- };
102
- }
103
-
104
- // Codex
105
- let codexBin = which("codex");
106
- if (!codexBin && fs.existsSync("/Applications/Codex.app/Contents/Resources/codex")) {
107
- codexBin = "/Applications/Codex.app/Contents/Resources/codex";
108
- }
109
- if (codexBin) {
110
- const authResult = run(codexBin, ["login", "status"]);
111
- const output = authResult.stdout + " " + authResult.stderr;
112
- clis.codex = {
113
- bin: codexBin,
114
- loggedIn: authResult.ok,
115
- email: extractEmail(output),
116
- };
117
- }
118
-
119
- // Gemini
120
- const geminiBin = which("gemini");
121
- if (geminiBin) {
122
- let loggedIn = false;
123
- let email = "";
124
-
125
- // Check macOS Keychain first
126
- if (process.platform === "darwin") {
127
- const kcResult = run("security", ["find-generic-password", "-s", "gemini-cli-oauth", "-a", "main-account"]);
128
- if (kcResult.ok) {
129
- loggedIn = true;
130
- try {
131
- const pwResult = run("security", ["find-generic-password", "-s", "gemini-cli-oauth", "-a", "main-account", "-w"]);
132
- if (pwResult.ok && pwResult.stdout) {
133
- try {
134
- const parsed = JSON.parse(Buffer.from(pwResult.stdout, "base64").toString("utf8"));
135
- email = parsed.email || parsed.client_email || "";
136
- } catch {
137
- try { const p = JSON.parse(pwResult.stdout); email = p.email || p.client_email || ""; } catch {}
138
- }
139
- }
140
- } catch {}
141
- }
142
- }
143
-
144
- // Fallback: check credential files
145
- if (!loggedIn) {
146
- const credPaths = [
147
- path.join(os.homedir(), ".gemini", "oauth_creds.json"),
148
- path.join(os.homedir(), ".gemini", "credentials.json"),
149
- path.join(os.homedir(), ".gemini", "auth.json"),
150
- ];
151
- for (const cp of credPaths) {
152
- if (fs.existsSync(cp)) {
153
- loggedIn = true;
154
- try {
155
- const d = JSON.parse(fs.readFileSync(cp, "utf8"));
156
- email = d.email || d.client_email || (d.user && d.user.email) || "";
157
- } catch {}
158
- break;
159
- }
160
- }
161
- }
162
-
163
- clis.gemini = { bin: geminiBin, loggedIn, email };
164
- }
165
-
166
- return clis;
167
- }
168
-
169
- // ── MCP Registration ────────────────────────────────────────────────────────
170
-
171
- function registerMcpWithClaude(claudeBin, figmaToken, envExtras = {}) {
172
- // Remove stale first
173
- run(claudeBin, ["mcp", "remove", "figma-intelligence-layer"]);
174
- run(claudeBin, ["mcp", "remove", "design-bridge"]);
175
-
176
- const envArgs = [
177
- "-e", `FIGMA_ACCESS_TOKEN=${figmaToken}`,
178
- "-e", "FIGMA_BRIDGE_PORT=9001",
179
- "-e", "ENABLE_DECISION_LOG=true",
180
- ];
181
- if (envExtras.UNSPLASH_ACCESS_KEY) envArgs.push("-e", `UNSPLASH_ACCESS_KEY=${envExtras.UNSPLASH_ACCESS_KEY}`);
182
- if (envExtras.PEXELS_API_KEY) envArgs.push("-e", `PEXELS_API_KEY=${envExtras.PEXELS_API_KEY}`);
183
-
184
- const r = run(claudeBin, ["mcp", "add", "-s", "user", ...envArgs, "figma-intelligence-layer", "--", "node", MCP_BUILD]);
185
- return r.ok;
186
- }
187
-
188
- function registerMcpWithCodex(codexBin, figmaToken) {
189
- run(codexBin, ["mcp", "remove", "figma-intelligence-layer"]);
190
- const r = run(codexBin, [
191
- "mcp", "add", "figma-intelligence-layer",
192
- "--env", `FIGMA_ACCESS_TOKEN=${figmaToken}`,
193
- "--env", "FIGMA_BRIDGE_PORT=9001",
194
- "--env", "ENABLE_DECISION_LOG=true",
195
- "--", "node", MCP_BUILD,
196
- ]);
197
- return r.ok;
198
- }
199
-
200
- function registerMcpWithGemini(figmaToken) {
201
- const settingsDir = path.join(os.homedir(), ".gemini");
202
- const settingsPath = path.join(settingsDir, "settings.json");
203
- fs.mkdirSync(settingsDir, { recursive: true });
204
-
205
- let settings = {};
206
- if (fs.existsSync(settingsPath)) {
207
- try { settings = JSON.parse(fs.readFileSync(settingsPath, "utf8")); } catch {}
208
- }
209
- if (!settings.mcpServers) settings.mcpServers = {};
210
-
211
- settings.mcpServers["figma-intelligence-layer"] = {
212
- command: "node",
213
- args: [MCP_BUILD],
214
- env: {
215
- FIGMA_ACCESS_TOKEN: figmaToken,
216
- FIGMA_BRIDGE_PORT: "9001",
217
- ENABLE_DECISION_LOG: "true",
218
- },
219
- };
220
-
221
- fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
222
- return true;
223
- }
224
-
225
- function writeClaudePermissions() {
226
- const settingsPath = path.join(os.homedir(), ".claude", "settings.json");
227
- let settings = {};
228
- if (fs.existsSync(settingsPath)) {
229
- try { settings = JSON.parse(fs.readFileSync(settingsPath, "utf8")); } catch {}
230
- }
231
- if (!settings.permissions) settings.permissions = {};
232
- if (!Array.isArray(settings.permissions.allow)) settings.permissions.allow = [];
233
- const perms = ["mcp__figma-intelligence-layer__*", "mcp__design-bridge__*"];
234
- for (const p of perms) {
235
- if (!settings.permissions.allow.includes(p)) settings.permissions.allow.push(p);
236
- }
237
- fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
238
- fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
239
- }
240
-
241
- // ── Commands ────────────────────────────────────────────────────────────────
242
-
243
- async function cmdStart() {
244
- ensureDataDir();
245
-
246
- // Check if already running
247
- const existingPid = getRelayPid();
248
- if (existingPid) {
249
- success(`Relay already running (PID: ${existingPid})`);
250
- log(` WebSocket: ws://localhost:${PORT}`);
251
- log(` Logs: ${LOG_FILE}`);
252
- return;
253
- }
254
-
255
- if (isPortInUse(PORT)) {
256
- warn(`Port ${PORT} is already in use by another process.`);
257
- info(`Run 'npx figma-intelligence stop' first or use BRIDGE_PORT=9002 npx figma-intelligence start`);
258
- return;
259
- }
260
-
261
- // Check prerequisites
262
- if (!fs.existsSync(RELAY_SCRIPT)) {
263
- fail("Bridge relay not found. Run 'npx figma-intelligence setup' first.");
264
- return;
265
- }
266
-
267
- // Detect CLIs for PATH
268
- const clis = detectCLIs();
269
- const pathDirs = new Set(["/usr/local/bin", "/usr/bin", "/bin", "/usr/sbin", "/sbin"]);
270
- if (clis.claude) pathDirs.add(path.dirname(clis.claude.bin));
271
- if (clis.codex) pathDirs.add(path.dirname(clis.codex.bin));
272
- if (clis.gemini) pathDirs.add(path.dirname(clis.gemini.bin));
273
-
274
- const env = {
275
- ...process.env,
276
- HOME: os.homedir(),
277
- PATH: [...pathDirs].join(":") + ":" + (process.env.PATH || ""),
278
- };
279
- if (clis.claude) env.CLAUDE_BIN_PATH = clis.claude.bin;
280
- if (clis.codex) env.CODEX_BIN_PATH = clis.codex.bin;
281
- if (clis.gemini) env.GEMINI_BIN_PATH = clis.gemini.bin;
282
-
283
- log("");
284
- log("Starting Figma Intelligence relay server...");
285
-
286
- // Start relay as detached background process
287
- const logStream = fs.openSync(LOG_FILE, "a");
288
- const child = spawn("node", [RELAY_SCRIPT], {
289
- cwd: BRIDGE_DIR,
290
- env,
291
- detached: true,
292
- stdio: ["ignore", logStream, logStream],
293
- });
294
-
295
- child.unref();
296
- fs.writeFileSync(PID_FILE, String(child.pid));
297
-
298
- // Wait briefly and verify
299
- await new Promise((r) => setTimeout(r, 2000));
300
-
301
- if (getRelayPid()) {
302
- success(`Relay started (PID: ${child.pid})`);
303
- log(` WebSocket: ws://localhost:${PORT}`);
304
- log(` Logs: ${LOG_FILE}`);
305
- log("");
306
-
307
- // Show CLI status
308
- const anyLoggedIn = Object.values(clis).some((c) => c.loggedIn);
309
- if (anyLoggedIn) {
310
- log(" Available providers:");
311
- if (clis.claude?.loggedIn) success(`Claude${clis.claude.email ? ` (${clis.claude.email})` : ""}`);
312
- if (clis.codex?.loggedIn) success(`OpenAI Codex${clis.codex.email ? ` (${clis.codex.email})` : ""}`);
313
- if (clis.gemini?.loggedIn) success(`Gemini${clis.gemini.email ? ` (${clis.gemini.email})` : ""}`);
314
- } else {
315
- warn("No AI providers are logged in. Run one of:");
316
- info(" claude login");
317
- info(" codex login");
318
- info(" gemini");
319
- }
320
-
321
- log("");
322
- log(" Now open your Figma plugin - it will auto-connect.");
323
- } else {
324
- fail("Relay failed to start. Check logs:");
325
- log(` ${LOG_FILE}`);
326
- }
327
- }
328
-
329
- function cmdStop() {
330
- let stopped = false;
331
-
332
- // Stop via PID file
333
- const pid = getRelayPid();
334
- if (pid) {
335
- try {
336
- process.kill(pid, "SIGTERM");
337
- stopped = true;
338
- success(`Stopped relay (PID: ${pid})`);
339
- } catch (e) {
340
- warn(`Could not stop PID ${pid}: ${e.message}`);
341
- }
342
- try { fs.unlinkSync(PID_FILE); } catch {}
343
- }
344
-
345
- // Also try launchctl on macOS
346
- if (process.platform === "darwin" && fs.existsSync(PLIST_PATH)) {
347
- run("launchctl", ["unload", PLIST_PATH]);
348
- info("Unloaded launchd service");
349
- stopped = true;
350
- }
351
-
352
- // Kill any remaining relay processes
353
- const r = run("pkill", ["-f", "bridge-relay.js"]);
354
- if (r.ok) stopped = true;
355
-
356
- if (stopped) {
357
- success("Relay stopped");
358
- } else {
359
- info("No relay process found");
360
- }
361
- }
362
-
363
- function cmdStatus() {
364
- log("");
365
- log("Figma Intelligence Status");
366
- log("=".repeat(50));
367
- log("");
368
-
369
- // Relay status
370
- const pid = getRelayPid();
371
- const portActive = isPortInUse(PORT);
372
-
373
- if (pid) {
374
- success(`Relay: RUNNING (PID: ${pid}, port ${PORT})`);
375
- } else if (portActive) {
376
- warn(`Relay: Port ${PORT} in use (unknown process)`);
377
- } else {
378
- fail(`Relay: NOT RUNNING`);
379
- }
380
-
381
- // MCP build
382
- if (fs.existsSync(MCP_BUILD)) {
383
- success("MCP server: BUILT");
384
- } else {
385
- fail("MCP server: NOT BUILT (run 'npx figma-intelligence setup')");
386
- }
387
-
388
- log("");
389
-
390
- // CLI status
391
- const clis = detectCLIs();
392
- log("AI Providers:");
393
-
394
- if (clis.claude) {
395
- if (clis.claude.loggedIn) {
396
- success(`Claude: logged in${clis.claude.email ? ` as ${clis.claude.email}` : ""}`);
397
- } else {
398
- warn("Claude: installed but not logged in (run 'claude login')");
399
- }
400
- } else {
401
- info("Claude: not installed (https://claude.ai/download)");
402
- }
403
-
404
- if (clis.codex) {
405
- if (clis.codex.loggedIn) {
406
- success(`OpenAI Codex: logged in${clis.codex.email ? ` as ${clis.codex.email}` : ""}`);
407
- } else {
408
- warn("OpenAI Codex: installed but not logged in (run 'codex login')");
409
- }
410
- } else {
411
- info("OpenAI Codex: not installed (npm i -g @openai/codex)");
412
- }
413
-
414
- if (clis.gemini) {
415
- if (clis.gemini.loggedIn) {
416
- success(`Gemini: logged in${clis.gemini.email ? ` as ${clis.gemini.email}` : ""}`);
417
- } else {
418
- warn("Gemini: installed but not logged in (run 'gemini')");
419
- }
420
- } else {
421
- info("Gemini: not installed (npm i -g @google/gemini-cli)");
422
- }
423
-
424
- // Figma token
425
- log("");
426
- const claudeSettings = path.join(os.homedir(), ".claude", "settings.json");
427
- if (fs.existsSync(claudeSettings)) {
428
- try {
429
- const s = JSON.parse(fs.readFileSync(claudeSettings, "utf8"));
430
- const token = s?.mcpServers?.["figma-intelligence-layer"]?.env?.FIGMA_ACCESS_TOKEN || "";
431
- if (token && token !== "YOUR_FIGMA_TOKEN_HERE") {
432
- success(`Figma token: ${maskToken(token)}`);
433
- } else {
434
- warn("Figma token: not set");
435
- }
436
- } catch {
437
- warn("Could not read Claude settings");
438
- }
439
- }
440
-
441
- log("");
442
- }
443
-
444
- function cmdDoctor() {
445
- log("");
446
- log("Figma Intelligence Doctor");
447
- log("=".repeat(50));
448
- log("");
449
-
450
- let issues = 0;
451
-
452
- // 1. Node.js version
453
- const nodeVer = process.version;
454
- const major = parseInt(nodeVer.slice(1), 10);
455
- if (major >= 18) {
456
- success(`Node.js ${nodeVer}`);
457
- } else {
458
- fail(`Node.js ${nodeVer} - requires >= 18`);
459
- issues++;
460
- }
461
-
462
- // 2. Dependencies installed
463
- const bridgeDeps = path.join(BRIDGE_DIR, "node_modules");
464
- const mcpDeps = path.join(MCP_SRC, "node_modules");
465
- if (fs.existsSync(bridgeDeps)) {
466
- success("Bridge relay dependencies installed");
467
- } else {
468
- fail("Bridge relay dependencies missing (run 'npx figma-intelligence setup')");
469
- issues++;
470
- }
471
- if (fs.existsSync(mcpDeps)) {
472
- success("MCP server dependencies installed");
473
- } else {
474
- fail("MCP server dependencies missing (run 'npx figma-intelligence setup')");
475
- issues++;
476
- }
477
-
478
- // 3. MCP build
479
- if (fs.existsSync(MCP_BUILD)) {
480
- success("MCP server built");
481
- } else {
482
- fail("MCP server not built");
483
- issues++;
484
- }
485
-
486
- // 4. Relay running
487
- const pid = getRelayPid();
488
- if (pid) {
489
- success(`Relay running (PID: ${pid})`);
490
- } else if (isPortInUse(PORT)) {
491
- warn(`Port ${PORT} in use but not by our relay`);
492
- issues++;
493
- } else {
494
- fail("Relay not running (run 'npx figma-intelligence start')");
495
- issues++;
496
- }
497
-
498
- // 5. CLIs
499
- const clis = detectCLIs();
500
- const anyInstalled = Object.keys(clis).length > 0;
501
- const anyLoggedIn = Object.values(clis).some((c) => c.loggedIn);
502
- if (!anyInstalled) {
503
- fail("No AI CLI installed. Install at least one: claude, codex, or gemini");
504
- issues++;
505
- } else if (!anyLoggedIn) {
506
- fail("No AI CLI is logged in. Log in to at least one provider");
507
- issues++;
508
- } else {
509
- success("AI provider(s) authenticated");
510
- }
511
-
512
- // 6. Sharp module
513
- try {
514
- require(path.join(MCP_SRC, "node_modules", "sharp"));
515
- success("Sharp image module OK");
516
- } catch {
517
- warn("Sharp module not loadable (some vision tools may not work)");
518
- }
519
-
520
- // 7. MCP server handshake test
521
- if (fs.existsSync(MCP_BUILD)) {
522
- log("\n Testing MCP server handshake...");
523
- const testResult = run("node", ["-e", `
524
- const { spawn } = require('child_process');
525
- const p = spawn('node', ['${MCP_BUILD}'], {
526
- env: { ...process.env, FIGMA_ACCESS_TOKEN: 'test', FIGMA_BRIDGE_PORT: '0' },
527
- stdio: ['pipe', 'pipe', 'pipe']
528
- });
529
- const msg = JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'initialize', params: { protocolVersion: '2024-11-05', capabilities: {}, clientInfo: { name: 'doctor', version: '1.0.0' } } });
530
- let responded = false;
531
- p.stdout.on('data', () => { if (!responded) { responded = true; console.log('ok'); p.kill(); } });
532
- p.stdin.write(msg + '\\n');
533
- setTimeout(() => { if (!responded) console.log('timeout'); p.kill(); process.exit(0); }, 5000);
534
- `], { timeout: 8000 });
535
-
536
- if (testResult.stdout.includes("ok")) {
537
- success("MCP server responds to handshake");
538
- } else {
539
- fail("MCP server did not respond");
540
- issues++;
541
- }
542
- }
543
-
544
- log("");
545
- if (issues === 0) {
546
- log(" All checks passed! Your setup is healthy.");
547
- } else {
548
- log(` ${issues} issue(s) found. Fix them and run doctor again.`);
549
- }
550
- log("");
551
- }
552
-
553
- async function cmdSetup() {
554
- log("");
555
- log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
556
- log("\u2502 Figma Intelligence \u2014 Setup \u2502");
557
- log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
558
- log("");
559
-
560
- ensureDataDir();
561
-
562
- // Step 1: Check Node.js
563
- const major = parseInt(process.version.slice(1), 10);
564
- if (major < 18) {
565
- fail(`Node.js ${process.version} is too old. Install Node.js 18+ from https://nodejs.org`);
566
- process.exit(1);
567
- }
568
- success(`Node.js ${process.version}`);
569
-
570
- // Step 2: Detect and check CLIs
571
- log("");
572
- log("Checking AI provider authentication...");
573
- const clis = detectCLIs();
574
-
575
- if (clis.claude) {
576
- if (clis.claude.loggedIn) {
577
- success(`Claude logged in${clis.claude.email ? ` as ${clis.claude.email}` : ""}`);
578
- } else {
579
- warn("Claude CLI installed but not logged in.");
580
- info("Run 'claude login' to authenticate");
581
- }
582
- } else {
583
- info("Claude CLI not found. Install from: https://claude.ai/download");
584
- }
585
-
586
- if (clis.codex) {
587
- if (clis.codex.loggedIn) {
588
- success(`Codex logged in${clis.codex.email ? ` as ${clis.codex.email}` : ""}`);
589
- } else {
590
- warn("Codex CLI installed but not logged in.");
591
- info("Run 'codex login' to authenticate");
592
- }
593
- } else {
594
- info("OpenAI Codex not found. Install with: npm i -g @openai/codex");
595
- }
596
-
597
- if (clis.gemini) {
598
- if (clis.gemini.loggedIn) {
599
- success(`Gemini logged in${clis.gemini.email ? ` as ${clis.gemini.email}` : ""}`);
600
- } else {
601
- warn("Gemini CLI installed but not logged in.");
602
- info("Run 'gemini' to authenticate via Google");
603
- }
604
- } else {
605
- info("Gemini CLI not found. Install with: npm i -g @google/gemini-cli");
606
- }
607
-
608
- const anyLoggedIn = Object.values(clis).some((c) => c.loggedIn);
609
- if (!Object.keys(clis).length) {
610
- log("");
611
- fail("No supported AI CLI found. Install at least one:");
612
- info(" Claude: https://claude.ai/download");
613
- info(" OpenAI Codex: npm i -g @openai/codex");
614
- info(" Gemini CLI: npm i -g @google/gemini-cli");
615
- process.exit(1);
616
- }
617
-
618
- if (!anyLoggedIn) {
619
- log("");
620
- fail("No AI provider is logged in. Log in to at least one:");
621
- if (clis.claude) info(" claude login");
622
- if (clis.codex) info(" codex login");
623
- if (clis.gemini) info(" gemini");
624
- process.exit(1);
625
- }
626
-
627
- // Step 3: Install dependencies
628
- log("");
629
- log("Installing dependencies...");
630
-
631
- const packages = [
632
- { name: "Bridge relay", dir: BRIDGE_DIR },
633
- { name: "MCP server", dir: MCP_SRC },
634
- ];
635
- if (fs.existsSync(DESIGN_BRIDGE_DIR)) {
636
- packages.push({ name: "Design bridge", dir: DESIGN_BRIDGE_DIR });
637
- }
638
-
639
- for (const pkg of packages) {
640
- log(` Installing ${pkg.name}...`);
641
- const r = run("npm", ["install"], { cwd: pkg.dir });
642
- if (r.ok) {
643
- success(`${pkg.name} dependencies installed`);
644
- } else {
645
- fail(`${pkg.name} install failed: ${r.stderr}`);
646
- process.exit(1);
647
- }
648
- }
649
-
650
- // Step 4: Build MCP server
651
- log("");
652
- log("Building MCP server...");
653
- const buildResult = run("npm", ["run", "build"], { cwd: MCP_SRC });
654
- if (buildResult.ok) {
655
- success("MCP server built");
656
- } else {
657
- fail(`Build failed: ${buildResult.stderr}`);
658
- process.exit(1);
659
- }
660
-
661
- // Step 5: Figma Access Token
662
- log("");
663
- log("Figma Personal Access Token");
664
- info("Required to read your Figma files.");
665
- info("Get one: Figma Desktop > Account Settings > Security > Personal access tokens");
666
- log("");
667
-
668
- let existingToken = "";
669
- const claudeSettingsPath = path.join(os.homedir(), ".claude", "settings.json");
670
- if (fs.existsSync(claudeSettingsPath)) {
671
- try {
672
- const s = JSON.parse(fs.readFileSync(claudeSettingsPath, "utf8"));
673
- const t = s?.mcpServers?.["figma-intelligence-layer"]?.env?.FIGMA_ACCESS_TOKEN || "";
674
- if (t && t !== "YOUR_FIGMA_TOKEN_HERE") existingToken = t;
675
- } catch {}
676
- }
677
-
678
- let figmaToken;
679
- if (existingToken) {
680
- log(` Found existing token: ${maskToken(existingToken)}`);
681
- const input = await prompt(" Press Enter to keep, or paste a new token: ");
682
- figmaToken = input || existingToken;
683
- } else {
684
- figmaToken = await prompt(" Paste your token: ");
685
- if (!figmaToken) {
686
- figmaToken = "YOUR_FIGMA_TOKEN_HERE";
687
- warn("No token provided. Set it later in ~/.claude/settings.json");
688
- }
689
- }
690
-
691
- // Step 6: Register MCP servers
692
- log("");
693
- log("Registering MCP servers...");
694
-
695
- if (clis.claude) {
696
- if (registerMcpWithClaude(clis.claude.bin, figmaToken)) {
697
- success("Registered with Claude Code");
698
- } else {
699
- warn("Could not register with Claude Code");
700
- }
701
- }
702
-
703
- if (clis.codex) {
704
- if (registerMcpWithCodex(clis.codex.bin, figmaToken)) {
705
- success("Registered with Codex");
706
- } else {
707
- warn("Could not register with Codex");
708
- }
709
- }
710
-
711
- if (clis.gemini) {
712
- if (registerMcpWithGemini(figmaToken)) {
713
- success("Registered with Gemini CLI");
714
- } else {
715
- warn("Could not register with Gemini");
716
- }
717
- }
718
-
719
- // Write permissions
720
- writeClaudePermissions();
721
- success("MCP tool permissions auto-enabled");
722
-
723
- // Step 7: Start relay
724
- log("");
725
- log("Starting relay server...");
726
- await cmdStart();
727
-
728
- // Step 8: Install as background service on macOS
729
- if (process.platform === "darwin") {
730
- log("");
731
- const installService = await prompt(" Install as login service (auto-starts on reboot)? [Y/n]: ");
732
- if (!installService || installService.toLowerCase() !== "n") {
733
- installLaunchdService(clis);
734
- }
735
- }
736
-
737
- // Done
738
- log("");
739
- log("=".repeat(53));
740
- log(" Setup complete!");
741
- log("");
742
- log(" If you installed the plugin from Figma Community:");
743
- log(" Just open it - it will auto-connect.");
744
- log("");
745
- log(" If loading from development:");
746
- log(" 1. Figma Desktop > Plugins > Development > Import plugin from manifest");
747
- log(` 2. Select: ${path.join(BRIDGE_DIR, "manifest.json")}`);
748
- log(" 3. Run the plugin - you should see 'Connected'");
749
- log("");
750
- log(" Restart these apps to pick up MCP changes:");
751
- info(" Claude Code: exit terminal and run 'claude' again");
752
- info(" VS Code: Cmd+Shift+P > 'Reload Window'");
753
- log("=".repeat(53));
754
- log("");
755
- }
756
-
757
- function installLaunchdService(clis) {
758
- // Build PATH
759
- const pathDirs = ["/usr/local/bin", "/usr/bin", "/bin", "/usr/sbin", "/sbin"];
760
- if (clis.claude) pathDirs.unshift(path.dirname(clis.claude.bin));
761
- if (clis.codex) pathDirs.unshift(path.dirname(clis.codex.bin));
762
- if (clis.gemini) pathDirs.unshift(path.dirname(clis.gemini.bin));
763
- const launchdPath = [...new Set(pathDirs)].join(":");
764
- const nodePath = process.execPath;
765
-
766
- // Stop existing
767
- run("launchctl", ["unload", PLIST_PATH]);
768
-
769
- fs.mkdirSync(PLIST_DIR, { recursive: true });
770
-
771
- const plist = `<?xml version="1.0" encoding="UTF-8"?>
772
- <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
773
- <plist version="1.0">
774
- <dict>
775
- <key>Label</key>
776
- <string>${PLIST_LABEL}</string>
777
- <key>ProgramArguments</key>
778
- <array>
779
- <string>${nodePath}</string>
780
- <string>${RELAY_SCRIPT}</string>
781
- </array>
782
- <key>WorkingDirectory</key>
783
- <string>${BRIDGE_DIR}</string>
784
- <key>EnvironmentVariables</key>
785
- <dict>
786
- <key>HOME</key>
787
- <string>${os.homedir()}</string>
788
- <key>PATH</key>
789
- <string>${launchdPath}</string>${clis.claude ? `
790
- <key>CLAUDE_BIN_PATH</key>
791
- <string>${clis.claude.bin}</string>` : ""}${clis.codex ? `
792
- <key>CODEX_BIN_PATH</key>
793
- <string>${clis.codex.bin}</string>` : ""}${clis.gemini ? `
794
- <key>GEMINI_BIN_PATH</key>
795
- <string>${clis.gemini.bin}</string>` : ""}
796
- </dict>
797
- <key>RunAtLoad</key>
798
- <true/>
799
- <key>KeepAlive</key>
800
- <true/>
801
- <key>StandardOutPath</key>
802
- <string>${LOG_FILE}</string>
803
- <key>StandardErrorPath</key>
804
- <string>${LOG_FILE}</string>
805
- </dict>
806
- </plist>`;
807
-
808
- fs.writeFileSync(PLIST_PATH, plist);
809
- const r = run("launchctl", ["load", PLIST_PATH]);
810
- if (r.ok) {
811
- success("Installed as login service (auto-starts on reboot)");
812
- info(`To stop: launchctl unload ${PLIST_PATH}`);
813
- } else {
814
- warn("Could not install launchd service. The relay was started manually instead.");
815
- }
816
- }
817
-
818
- // ── Main ────────────────────────────────────────────────────────────────────
819
-
820
- const command = process.argv[2] || "start";
821
-
822
- switch (command) {
823
- case "start":
824
- cmdStart();
825
- break;
826
- case "stop":
827
- cmdStop();
828
- break;
829
- case "status":
830
- cmdStatus();
831
- break;
832
- case "doctor":
833
- cmdDoctor();
834
- break;
835
- case "setup":
836
- cmdSetup();
837
- break;
838
- case "help":
839
- case "--help":
840
- case "-h":
841
- log("");
842
- log("Figma Intelligence CLI");
843
- log("");
844
- log("Usage: npx figma-intelligence <command>");
845
- log("");
846
- log("Commands:");
847
- log(" start Start the bridge relay server (default)");
848
- log(" stop Stop the relay server");
849
- log(" status Show relay + CLI auth status");
850
- log(" doctor Diagnose common issues");
851
- log(" setup Full interactive setup (install deps, register MCP, start relay)");
852
- log(" help Show this help message");
853
- log("");
854
- break;
855
- default:
856
- fail(`Unknown command: ${command}`);
857
- log("Run 'npx figma-intelligence help' for usage.");
858
- process.exit(1);
859
- }