superskill 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (301) hide show
  1. package/CHANGELOG.md +42 -0
  2. package/LICENSE +21 -0
  3. package/README.md +235 -0
  4. package/dist/cli.d.ts +2 -0
  5. package/dist/cli.js +1158 -0
  6. package/dist/cli.js.map +1 -0
  7. package/dist/commands/brainstorm.d.ts +9 -0
  8. package/dist/commands/brainstorm.js +37 -0
  9. package/dist/commands/brainstorm.js.map +1 -0
  10. package/dist/commands/brainstorm.test.d.ts +1 -0
  11. package/dist/commands/brainstorm.test.js +110 -0
  12. package/dist/commands/brainstorm.test.js.map +1 -0
  13. package/dist/commands/context.d.ts +18 -0
  14. package/dist/commands/context.js +88 -0
  15. package/dist/commands/context.js.map +1 -0
  16. package/dist/commands/context.test.d.ts +1 -0
  17. package/dist/commands/context.test.js +230 -0
  18. package/dist/commands/context.test.js.map +1 -0
  19. package/dist/commands/decide.d.ts +12 -0
  20. package/dist/commands/decide.js +40 -0
  21. package/dist/commands/decide.js.map +1 -0
  22. package/dist/commands/decide.test.d.ts +1 -0
  23. package/dist/commands/decide.test.js +109 -0
  24. package/dist/commands/decide.test.js.map +1 -0
  25. package/dist/commands/graph.d.ts +15 -0
  26. package/dist/commands/graph.js +89 -0
  27. package/dist/commands/graph.js.map +1 -0
  28. package/dist/commands/graph.test.d.ts +1 -0
  29. package/dist/commands/graph.test.js +215 -0
  30. package/dist/commands/graph.test.js.map +1 -0
  31. package/dist/commands/init.d.ts +11 -0
  32. package/dist/commands/init.js +257 -0
  33. package/dist/commands/init.js.map +1 -0
  34. package/dist/commands/learn.d.ts +25 -0
  35. package/dist/commands/learn.js +92 -0
  36. package/dist/commands/learn.js.map +1 -0
  37. package/dist/commands/learn.test.d.ts +1 -0
  38. package/dist/commands/learn.test.js +241 -0
  39. package/dist/commands/learn.test.js.map +1 -0
  40. package/dist/commands/prune.d.ts +58 -0
  41. package/dist/commands/prune.js +246 -0
  42. package/dist/commands/prune.js.map +1 -0
  43. package/dist/commands/read.d.ts +8 -0
  44. package/dist/commands/read.js +7 -0
  45. package/dist/commands/read.js.map +1 -0
  46. package/dist/commands/read.test.d.ts +1 -0
  47. package/dist/commands/read.test.js +48 -0
  48. package/dist/commands/read.test.js.map +1 -0
  49. package/dist/commands/resume.d.ts +20 -0
  50. package/dist/commands/resume.js +141 -0
  51. package/dist/commands/resume.js.map +1 -0
  52. package/dist/commands/resume.test.d.ts +1 -0
  53. package/dist/commands/resume.test.js +243 -0
  54. package/dist/commands/resume.test.js.map +1 -0
  55. package/dist/commands/search.d.ts +8 -0
  56. package/dist/commands/search.js +25 -0
  57. package/dist/commands/search.js.map +1 -0
  58. package/dist/commands/search.test.d.ts +1 -0
  59. package/dist/commands/search.test.js +61 -0
  60. package/dist/commands/search.test.js.map +1 -0
  61. package/dist/commands/session.d.ts +22 -0
  62. package/dist/commands/session.js +79 -0
  63. package/dist/commands/session.js.map +1 -0
  64. package/dist/commands/session.test.d.ts +1 -0
  65. package/dist/commands/session.test.js +231 -0
  66. package/dist/commands/session.test.js.map +1 -0
  67. package/dist/commands/skill/catalog.d.ts +39 -0
  68. package/dist/commands/skill/catalog.js +260 -0
  69. package/dist/commands/skill/catalog.js.map +1 -0
  70. package/dist/commands/skill/index.d.ts +55 -0
  71. package/dist/commands/skill/index.js +82 -0
  72. package/dist/commands/skill/index.js.map +1 -0
  73. package/dist/commands/skill/index.test.d.ts +1 -0
  74. package/dist/commands/skill/index.test.js +137 -0
  75. package/dist/commands/skill/index.test.js.map +1 -0
  76. package/dist/commands/skill/install.d.ts +14 -0
  77. package/dist/commands/skill/install.js +108 -0
  78. package/dist/commands/skill/install.js.map +1 -0
  79. package/dist/commands/skill/install.test.d.ts +1 -0
  80. package/dist/commands/skill/install.test.js +225 -0
  81. package/dist/commands/skill/install.test.js.map +1 -0
  82. package/dist/commands/skill/list.d.ts +6 -0
  83. package/dist/commands/skill/list.js +5 -0
  84. package/dist/commands/skill/list.js.map +1 -0
  85. package/dist/commands/skill/list.test.d.ts +1 -0
  86. package/dist/commands/skill/list.test.js +101 -0
  87. package/dist/commands/skill/list.test.js.map +1 -0
  88. package/dist/commands/skill/marketplace.d.ts +121 -0
  89. package/dist/commands/skill/marketplace.js +548 -0
  90. package/dist/commands/skill/marketplace.js.map +1 -0
  91. package/dist/commands/skill/schema.d.ts +27 -0
  92. package/dist/commands/skill/schema.js +55 -0
  93. package/dist/commands/skill/schema.js.map +1 -0
  94. package/dist/commands/skill/schema.test.d.ts +1 -0
  95. package/dist/commands/skill/schema.test.js +142 -0
  96. package/dist/commands/skill/schema.test.js.map +1 -0
  97. package/dist/commands/skill/validate.d.ts +10 -0
  98. package/dist/commands/skill/validate.js +40 -0
  99. package/dist/commands/skill/validate.js.map +1 -0
  100. package/dist/commands/skill/validate.test.d.ts +1 -0
  101. package/dist/commands/skill/validate.test.js +171 -0
  102. package/dist/commands/skill/validate.test.js.map +1 -0
  103. package/dist/commands/task.d.ts +34 -0
  104. package/dist/commands/task.js +160 -0
  105. package/dist/commands/task.js.map +1 -0
  106. package/dist/commands/task.test.d.ts +1 -0
  107. package/dist/commands/task.test.js +395 -0
  108. package/dist/commands/task.test.js.map +1 -0
  109. package/dist/commands/todo.d.ts +15 -0
  110. package/dist/commands/todo.js +99 -0
  111. package/dist/commands/todo.js.map +1 -0
  112. package/dist/commands/todo.test.d.ts +1 -0
  113. package/dist/commands/todo.test.js +324 -0
  114. package/dist/commands/todo.test.js.map +1 -0
  115. package/dist/commands/write.d.ts +12 -0
  116. package/dist/commands/write.js +40 -0
  117. package/dist/commands/write.js.map +1 -0
  118. package/dist/commands/write.test.d.ts +1 -0
  119. package/dist/commands/write.test.js +79 -0
  120. package/dist/commands/write.test.js.map +1 -0
  121. package/dist/config.d.ts +15 -0
  122. package/dist/config.js +49 -0
  123. package/dist/config.js.map +1 -0
  124. package/dist/config.test.d.ts +1 -0
  125. package/dist/config.test.js +147 -0
  126. package/dist/config.test.js.map +1 -0
  127. package/dist/core/executor.d.ts +11 -0
  128. package/dist/core/executor.js +42 -0
  129. package/dist/core/executor.js.map +1 -0
  130. package/dist/core/executor.test.d.ts +1 -0
  131. package/dist/core/executor.test.js +206 -0
  132. package/dist/core/executor.test.js.map +1 -0
  133. package/dist/core/middleware/error-handler.d.ts +2 -0
  134. package/dist/core/middleware/error-handler.js +29 -0
  135. package/dist/core/middleware/error-handler.js.map +1 -0
  136. package/dist/core/middleware/index.d.ts +2 -0
  137. package/dist/core/middleware/index.js +3 -0
  138. package/dist/core/middleware/index.js.map +1 -0
  139. package/dist/core/middleware/logging.d.ts +2 -0
  140. package/dist/core/middleware/logging.js +18 -0
  141. package/dist/core/middleware/logging.js.map +1 -0
  142. package/dist/core/registry.d.ts +12 -0
  143. package/dist/core/registry.js +552 -0
  144. package/dist/core/registry.js.map +1 -0
  145. package/dist/core/registry.test.d.ts +1 -0
  146. package/dist/core/registry.test.js +213 -0
  147. package/dist/core/registry.test.js.map +1 -0
  148. package/dist/core/types.d.ts +38 -0
  149. package/dist/core/types.js +2 -0
  150. package/dist/core/types.js.map +1 -0
  151. package/dist/integration/coordination.test.d.ts +1 -0
  152. package/dist/integration/coordination.test.js +286 -0
  153. package/dist/integration/coordination.test.js.map +1 -0
  154. package/dist/integration/project-artifacts.test.d.ts +1 -0
  155. package/dist/integration/project-artifacts.test.js +275 -0
  156. package/dist/integration/project-artifacts.test.js.map +1 -0
  157. package/dist/integration/registry-graph.test.d.ts +1 -0
  158. package/dist/integration/registry-graph.test.js +157 -0
  159. package/dist/integration/registry-graph.test.js.map +1 -0
  160. package/dist/integration/vault-lifecycle.test.d.ts +1 -0
  161. package/dist/integration/vault-lifecycle.test.js +183 -0
  162. package/dist/integration/vault-lifecycle.test.js.map +1 -0
  163. package/dist/lib/auto-number.d.ts +10 -0
  164. package/dist/lib/auto-number.js +33 -0
  165. package/dist/lib/auto-number.js.map +1 -0
  166. package/dist/lib/auto-number.test.d.ts +1 -0
  167. package/dist/lib/auto-number.test.js +88 -0
  168. package/dist/lib/auto-number.test.js.map +1 -0
  169. package/dist/lib/auto-profile.d.ts +11 -0
  170. package/dist/lib/auto-profile.js +123 -0
  171. package/dist/lib/auto-profile.js.map +1 -0
  172. package/dist/lib/auto-profile.test.d.ts +1 -0
  173. package/dist/lib/auto-profile.test.js +227 -0
  174. package/dist/lib/auto-profile.test.js.map +1 -0
  175. package/dist/lib/escape-regex.d.ts +4 -0
  176. package/dist/lib/escape-regex.js +8 -0
  177. package/dist/lib/escape-regex.js.map +1 -0
  178. package/dist/lib/escape-regex.test.d.ts +1 -0
  179. package/dist/lib/escape-regex.test.js +27 -0
  180. package/dist/lib/escape-regex.test.js.map +1 -0
  181. package/dist/lib/frontmatter.d.ts +34 -0
  182. package/dist/lib/frontmatter.js +75 -0
  183. package/dist/lib/frontmatter.js.map +1 -0
  184. package/dist/lib/frontmatter.test.d.ts +1 -0
  185. package/dist/lib/frontmatter.test.js +192 -0
  186. package/dist/lib/frontmatter.test.js.map +1 -0
  187. package/dist/lib/project-detector.d.ts +12 -0
  188. package/dist/lib/project-detector.js +124 -0
  189. package/dist/lib/project-detector.js.map +1 -0
  190. package/dist/lib/project-detector.test.d.ts +1 -0
  191. package/dist/lib/project-detector.test.js +117 -0
  192. package/dist/lib/project-detector.test.js.map +1 -0
  193. package/dist/lib/safe-external-path.d.ts +10 -0
  194. package/dist/lib/safe-external-path.js +47 -0
  195. package/dist/lib/safe-external-path.js.map +1 -0
  196. package/dist/lib/safe-external-path.test.d.ts +1 -0
  197. package/dist/lib/safe-external-path.test.js +99 -0
  198. package/dist/lib/safe-external-path.test.js.map +1 -0
  199. package/dist/lib/search-engine.d.ts +19 -0
  200. package/dist/lib/search-engine.js +164 -0
  201. package/dist/lib/search-engine.js.map +1 -0
  202. package/dist/lib/search-engine.test.d.ts +1 -0
  203. package/dist/lib/search-engine.test.js +120 -0
  204. package/dist/lib/search-engine.test.js.map +1 -0
  205. package/dist/lib/session-registry.d.ts +59 -0
  206. package/dist/lib/session-registry.js +231 -0
  207. package/dist/lib/session-registry.js.map +1 -0
  208. package/dist/lib/session-registry.test.d.ts +1 -0
  209. package/dist/lib/session-registry.test.js +199 -0
  210. package/dist/lib/session-registry.test.js.map +1 -0
  211. package/dist/lib/skill-registry.d.ts +13 -0
  212. package/dist/lib/skill-registry.js +77 -0
  213. package/dist/lib/skill-registry.js.map +1 -0
  214. package/dist/lib/stack-detector.d.ts +7 -0
  215. package/dist/lib/stack-detector.js +184 -0
  216. package/dist/lib/stack-detector.js.map +1 -0
  217. package/dist/lib/stack-detector.test.d.ts +1 -0
  218. package/dist/lib/stack-detector.test.js +110 -0
  219. package/dist/lib/stack-detector.test.js.map +1 -0
  220. package/dist/lib/token-estimator.d.ts +19 -0
  221. package/dist/lib/token-estimator.js +59 -0
  222. package/dist/lib/token-estimator.js.map +1 -0
  223. package/dist/lib/token-estimator.test.d.ts +1 -0
  224. package/dist/lib/token-estimator.test.js +65 -0
  225. package/dist/lib/token-estimator.test.js.map +1 -0
  226. package/dist/lib/tool-detector.d.ts +8 -0
  227. package/dist/lib/tool-detector.js +76 -0
  228. package/dist/lib/tool-detector.js.map +1 -0
  229. package/dist/lib/tool-detector.test.d.ts +1 -0
  230. package/dist/lib/tool-detector.test.js +170 -0
  231. package/dist/lib/tool-detector.test.js.map +1 -0
  232. package/dist/lib/vault-fs.d.ts +39 -0
  233. package/dist/lib/vault-fs.js +184 -0
  234. package/dist/lib/vault-fs.js.map +1 -0
  235. package/dist/lib/vault-fs.test.d.ts +1 -0
  236. package/dist/lib/vault-fs.test.js +210 -0
  237. package/dist/lib/vault-fs.test.js.map +1 -0
  238. package/dist/mcp-server.d.ts +2 -0
  239. package/dist/mcp-server.js +387 -0
  240. package/dist/mcp-server.js.map +1 -0
  241. package/dist/setup/clients.d.ts +2 -0
  242. package/dist/setup/clients.js +109 -0
  243. package/dist/setup/clients.js.map +1 -0
  244. package/dist/setup/configure.d.ts +6 -0
  245. package/dist/setup/configure.js +126 -0
  246. package/dist/setup/configure.js.map +1 -0
  247. package/dist/setup/configure.test.d.ts +1 -0
  248. package/dist/setup/configure.test.js +112 -0
  249. package/dist/setup/configure.test.js.map +1 -0
  250. package/dist/setup/detect.d.ts +3 -0
  251. package/dist/setup/detect.js +24 -0
  252. package/dist/setup/detect.js.map +1 -0
  253. package/dist/setup/detect.test.d.ts +1 -0
  254. package/dist/setup/detect.test.js +44 -0
  255. package/dist/setup/detect.test.js.map +1 -0
  256. package/dist/setup/index.d.ts +2 -0
  257. package/dist/setup/index.js +147 -0
  258. package/dist/setup/index.js.map +1 -0
  259. package/dist/setup/instructions.d.ts +4 -0
  260. package/dist/setup/instructions.js +62 -0
  261. package/dist/setup/instructions.js.map +1 -0
  262. package/dist/setup/instructions.test.d.ts +1 -0
  263. package/dist/setup/instructions.test.js +84 -0
  264. package/dist/setup/instructions.test.js.map +1 -0
  265. package/dist/setup/json-config.d.ts +10 -0
  266. package/dist/setup/json-config.js +43 -0
  267. package/dist/setup/json-config.js.map +1 -0
  268. package/dist/setup/json-config.test.d.ts +1 -0
  269. package/dist/setup/json-config.test.js +92 -0
  270. package/dist/setup/json-config.test.js.map +1 -0
  271. package/dist/setup/postinstall.d.ts +2 -0
  272. package/dist/setup/postinstall.js +22 -0
  273. package/dist/setup/postinstall.js.map +1 -0
  274. package/dist/setup/preuninstall.d.ts +2 -0
  275. package/dist/setup/preuninstall.js +12 -0
  276. package/dist/setup/preuninstall.js.map +1 -0
  277. package/dist/setup/setup-integration.test.d.ts +1 -0
  278. package/dist/setup/setup-integration.test.js +72 -0
  279. package/dist/setup/setup-integration.test.js.map +1 -0
  280. package/dist/setup/teardown.d.ts +5 -0
  281. package/dist/setup/teardown.js +94 -0
  282. package/dist/setup/teardown.js.map +1 -0
  283. package/dist/setup/teardown.test.d.ts +1 -0
  284. package/dist/setup/teardown.test.js +105 -0
  285. package/dist/setup/teardown.test.js.map +1 -0
  286. package/dist/setup/toml-config.d.ts +5 -0
  287. package/dist/setup/toml-config.js +26 -0
  288. package/dist/setup/toml-config.js.map +1 -0
  289. package/dist/setup/toml-config.test.d.ts +1 -0
  290. package/dist/setup/toml-config.test.js +49 -0
  291. package/dist/setup/toml-config.test.js.map +1 -0
  292. package/dist/setup/types.d.ts +52 -0
  293. package/dist/setup/types.js +23 -0
  294. package/dist/setup/types.js.map +1 -0
  295. package/dist/test-helpers.d.ts +20 -0
  296. package/dist/test-helpers.js +47 -0
  297. package/dist/test-helpers.js.map +1 -0
  298. package/dist/test-helpers.test.d.ts +1 -0
  299. package/dist/test-helpers.test.js +90 -0
  300. package/dist/test-helpers.test.js.map +1 -0
  301. package/package.json +74 -0
@@ -0,0 +1,109 @@
1
+ function home(sub) {
2
+ return { darwin: `~/${sub}`, linux: `~/${sub}`, win32: `~/${sub}` };
3
+ }
4
+ export const CLIENT_REGISTRY = [
5
+ {
6
+ name: "Claude Code",
7
+ slug: "claude-code",
8
+ mcpConfigPaths: home(".claude.json"),
9
+ configFormat: "json",
10
+ rootKey: "mcpServers",
11
+ commandType: "string",
12
+ envKey: "env",
13
+ instructionStrategy: "markdown-file",
14
+ instructionPaths: home(".claude/CLAUDE.md"),
15
+ verified: true,
16
+ },
17
+ {
18
+ name: "Claude Desktop",
19
+ slug: "claude-desktop",
20
+ mcpConfigPaths: {
21
+ darwin: "~/Library/Application Support/Claude/claude_desktop_config.json",
22
+ linux: "~/.config/Claude/claude_desktop_config.json",
23
+ win32: "~/AppData/Roaming/Claude/claude_desktop_config.json",
24
+ },
25
+ configFormat: "json",
26
+ rootKey: "mcpServers",
27
+ commandType: "string",
28
+ envKey: "env",
29
+ instructionStrategy: "none",
30
+ verified: true,
31
+ },
32
+ {
33
+ name: "Cursor",
34
+ slug: "cursor",
35
+ mcpConfigPaths: home(".cursor/mcp.json"),
36
+ configFormat: "json",
37
+ rootKey: "mcpServers",
38
+ commandType: "string",
39
+ envKey: "env",
40
+ instructionStrategy: "mdc-file",
41
+ instructionPaths: home(".cursor/rules/superskill.mdc"),
42
+ verified: true,
43
+ },
44
+ {
45
+ name: "OpenCode",
46
+ slug: "opencode",
47
+ mcpConfigPaths: home(".config/opencode/opencode.json"),
48
+ configFormat: "json",
49
+ rootKey: "mcp",
50
+ commandType: "array",
51
+ envKey: "environment",
52
+ extraFields: { type: "local" },
53
+ instructionStrategy: "config-array",
54
+ instructionPaths: home(".config/opencode/superskill-instructions.md"),
55
+ verified: false,
56
+ },
57
+ {
58
+ name: "Crush CLI",
59
+ slug: "crush",
60
+ mcpConfigPaths: {
61
+ darwin: "~/.config/crush/crush.json",
62
+ linux: "~/.config/crush/crush.json",
63
+ win32: "~/AppData/Local/crush/crush.json",
64
+ },
65
+ configFormat: "json",
66
+ rootKey: "mcp",
67
+ commandType: "string",
68
+ envKey: "env",
69
+ instructionStrategy: "none",
70
+ verified: false,
71
+ },
72
+ {
73
+ name: "Codex CLI",
74
+ slug: "codex",
75
+ mcpConfigPaths: home(".codex/config.toml"),
76
+ configFormat: "toml",
77
+ rootKey: "mcp_servers",
78
+ commandType: "string",
79
+ envKey: "env",
80
+ instructionStrategy: "markdown-file",
81
+ instructionPaths: home(".codex/AGENTS.md"),
82
+ verified: true,
83
+ },
84
+ {
85
+ name: "Gemini CLI",
86
+ slug: "gemini",
87
+ mcpConfigPaths: home(".gemini/settings.json"),
88
+ configFormat: "json",
89
+ rootKey: "mcpServers",
90
+ commandType: "string",
91
+ envKey: "env",
92
+ instructionStrategy: "markdown-file",
93
+ instructionPaths: home(".gemini/GEMINI.md"),
94
+ verified: true,
95
+ },
96
+ {
97
+ name: "Droid",
98
+ slug: "droid",
99
+ mcpConfigPaths: home(".factory/mcp.json"),
100
+ configFormat: "json",
101
+ rootKey: "mcpServers",
102
+ commandType: "string",
103
+ envKey: "env",
104
+ instructionStrategy: "markdown-file",
105
+ instructionPaths: home(".factory/CLAUDE.md"),
106
+ verified: false,
107
+ },
108
+ ];
109
+ //# sourceMappingURL=clients.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"clients.js","sourceRoot":"","sources":["../../src/setup/clients.ts"],"names":[],"mappings":"AAGA,SAAS,IAAI,CAAC,GAAW;IACvB,OAAO,EAAE,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,aAAa;QACnB,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC;QACpC,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,YAAY;QACrB,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,KAAK;QACb,mBAAmB,EAAE,eAAe;QACpC,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAAC;QAC3C,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,gBAAgB;QACtB,cAAc,EAAE;YACd,MAAM,EAAE,iEAAiE;YACzE,KAAK,EAAE,6CAA6C;YACpD,KAAK,EAAE,qDAAqD;SAC7D;QACD,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,YAAY;QACrB,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,KAAK;QACb,mBAAmB,EAAE,MAAM;QAC3B,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,cAAc,EAAE,IAAI,CAAC,kBAAkB,CAAC;QACxC,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,YAAY;QACrB,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,KAAK;QACb,mBAAmB,EAAE,UAAU;QAC/B,gBAAgB,EAAE,IAAI,CAAC,8BAA8B,CAAC;QACtD,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,cAAc,EAAE,IAAI,CAAC,gCAAgC,CAAC;QACtD,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,OAAO;QACpB,MAAM,EAAE,aAAa;QACrB,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;QAC9B,mBAAmB,EAAE,cAAc;QACnC,gBAAgB,EAAE,IAAI,CAAC,6CAA6C,CAAC;QACrE,QAAQ,EAAE,KAAK;KAChB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,OAAO;QACb,cAAc,EAAE;YACd,MAAM,EAAE,4BAA4B;YACpC,KAAK,EAAE,4BAA4B;YACnC,KAAK,EAAE,kCAAkC;SAC1C;QACD,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,KAAK;QACb,mBAAmB,EAAE,MAAM;QAC3B,QAAQ,EAAE,KAAK;KAChB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,OAAO;QACb,cAAc,EAAE,IAAI,CAAC,oBAAoB,CAAC;QAC1C,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,aAAa;QACtB,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,KAAK;QACb,mBAAmB,EAAE,eAAe;QACpC,gBAAgB,EAAE,IAAI,CAAC,kBAAkB,CAAC;QAC1C,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,QAAQ;QACd,cAAc,EAAE,IAAI,CAAC,uBAAuB,CAAC;QAC7C,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,YAAY;QACrB,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,KAAK;QACb,mBAAmB,EAAE,eAAe;QACpC,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAAC;QAC3C,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,OAAO;QACb,cAAc,EAAE,IAAI,CAAC,mBAAmB,CAAC;QACzC,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,YAAY;QACrB,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,KAAK;QACb,mBAAmB,EAAE,eAAe;QACpC,gBAAgB,EAAE,IAAI,CAAC,oBAAoB,CAAC;QAC5C,QAAQ,EAAE,KAAK;KAChB;CACF,CAAC"}
@@ -0,0 +1,6 @@
1
+ import type { DetectedClient, SetupResult } from "./types.js";
2
+ export declare function buildMcpEntry(commandType: "string" | "array", envKey: string, vaultPath: string, extraFields?: Record<string, unknown>): Record<string, unknown>;
3
+ export declare function configureClient(detected: DetectedClient, vaultPath: string, options?: {
4
+ dryRun?: boolean;
5
+ force?: boolean;
6
+ }): SetupResult;
@@ -0,0 +1,126 @@
1
+ // SPDX-License-Identifier: AGPL-3.0-or-later OR Commercial
2
+ import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
3
+ import { dirname } from "path";
4
+ import { INSTRUCTION_TEXT } from "./types.js";
5
+ import { readJsonConfig, writeJsonConfig, addMcpEntry } from "./json-config.js";
6
+ import { insertTomlBlock } from "./toml-config.js";
7
+ import { writeMarkdownInstruction, writeMdcInstruction, } from "./instructions.js";
8
+ export function buildMcpEntry(commandType, envKey, vaultPath, extraFields) {
9
+ const base = { ...extraFields };
10
+ if (commandType === "array") {
11
+ base.command = ["npx", "-y", "superskill"];
12
+ }
13
+ else {
14
+ base.command = "npx";
15
+ base.args = ["-y", "superskill"];
16
+ }
17
+ base[envKey] = { VAULT_PATH: vaultPath };
18
+ return base;
19
+ }
20
+ function buildTomlBlock(vaultPath) {
21
+ return `[mcp_servers.superskill]
22
+ command = "npx"
23
+ args = ["-y", "superskill"]
24
+
25
+ [mcp_servers.superskill.env]
26
+ VAULT_PATH = "${vaultPath}"`;
27
+ }
28
+ export function configureClient(detected, vaultPath, options = {}) {
29
+ const { config, mcpConfigPath, instructionPath } = detected;
30
+ const result = {
31
+ client: config.name,
32
+ mcpConfigured: false,
33
+ instructionConfigured: false,
34
+ };
35
+ try {
36
+ // 1. Configure MCP entry
37
+ if (config.configFormat === "json") {
38
+ if (options.dryRun) {
39
+ result.mcpConfigured = true;
40
+ }
41
+ else {
42
+ const existing = readJsonConfig(mcpConfigPath);
43
+ if (existing === null) {
44
+ result.error = `Invalid JSON in ${mcpConfigPath} — skipped`;
45
+ return result;
46
+ }
47
+ const entry = buildMcpEntry(config.commandType, config.envKey, vaultPath, config.extraFields);
48
+ const merged = addMcpEntry(existing, config.rootKey, "superskill", entry, options.force);
49
+ if (merged.alreadyExists) {
50
+ result.skipped = "MCP entry already exists";
51
+ }
52
+ else {
53
+ writeJsonConfig(mcpConfigPath, merged.config);
54
+ result.mcpConfigured = true;
55
+ }
56
+ }
57
+ }
58
+ else {
59
+ // TOML (Codex)
60
+ if (options.dryRun) {
61
+ result.mcpConfigured = true;
62
+ }
63
+ else {
64
+ const content = existsSync(mcpConfigPath)
65
+ ? readFileSync(mcpConfigPath, "utf-8")
66
+ : "";
67
+ const block = buildTomlBlock(vaultPath);
68
+ const updated = insertTomlBlock(content, block, options.force);
69
+ if (updated === null) {
70
+ result.skipped = "MCP entry already exists";
71
+ }
72
+ else {
73
+ const dir = dirname(mcpConfigPath);
74
+ if (!existsSync(dir))
75
+ mkdirSync(dir, { recursive: true });
76
+ writeFileSync(mcpConfigPath, updated, "utf-8");
77
+ result.mcpConfigured = true;
78
+ }
79
+ }
80
+ }
81
+ // 2. Configure instruction
82
+ if (config.instructionStrategy === "none") {
83
+ // nothing to do
84
+ }
85
+ else if (options.dryRun) {
86
+ result.instructionConfigured = true;
87
+ }
88
+ else if (config.instructionStrategy === "markdown-file" && instructionPath) {
89
+ const status = writeMarkdownInstruction(instructionPath, options.force);
90
+ result.instructionConfigured = status !== "exists";
91
+ if (status === "exists") {
92
+ result.skipped = (result.skipped ? result.skipped + "; " : "") + "Instruction already exists";
93
+ }
94
+ }
95
+ else if (config.instructionStrategy === "mdc-file" && instructionPath) {
96
+ writeMdcInstruction(instructionPath);
97
+ result.instructionConfigured = true;
98
+ }
99
+ else if (config.instructionStrategy === "config-array" && instructionPath) {
100
+ // OpenCode: add instruction file path to config + write instruction file
101
+ const configPath = detected.mcpConfigPath;
102
+ const existing = readJsonConfig(configPath);
103
+ if (existing === null) {
104
+ result.error = (result.error ? result.error + "; " : "") +
105
+ `Invalid JSON in ${configPath} — skipped instruction config`;
106
+ return result;
107
+ }
108
+ const instructions = existing.instructions ?? [];
109
+ if (!instructions.includes(instructionPath)) {
110
+ existing.instructions = [...instructions, instructionPath];
111
+ writeJsonConfig(configPath, existing);
112
+ }
113
+ // Write the instruction file itself
114
+ const dir = dirname(instructionPath);
115
+ if (!existsSync(dir))
116
+ mkdirSync(dir, { recursive: true });
117
+ writeFileSync(instructionPath, INSTRUCTION_TEXT + "\n", "utf-8");
118
+ result.instructionConfigured = true;
119
+ }
120
+ }
121
+ catch (e) {
122
+ result.error = e.message;
123
+ }
124
+ return result;
125
+ }
126
+ //# sourceMappingURL=configure.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"configure.js","sourceRoot":"","sources":["../../src/setup/configure.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,112 @@
1
+ import { describe, it, expect, vi, beforeEach } from "vitest";
2
+ import { existsSync, readFileSync, writeFileSync } from "fs";
3
+ import { buildMcpEntry, configureClient } from "./configure.js";
4
+ import { readJsonConfig, writeJsonConfig, addMcpEntry } from "./json-config.js";
5
+ import { insertTomlBlock } from "./toml-config.js";
6
+ import { writeMarkdownInstruction, writeMdcInstruction } from "./instructions.js";
7
+ import { CLIENT_REGISTRY } from "./clients.js";
8
+ vi.mock("./json-config.js");
9
+ vi.mock("./toml-config.js");
10
+ vi.mock("./instructions.js");
11
+ vi.mock("fs", () => ({
12
+ existsSync: vi.fn(),
13
+ readFileSync: vi.fn(),
14
+ writeFileSync: vi.fn(),
15
+ mkdirSync: vi.fn(),
16
+ }));
17
+ const mockExists = vi.mocked(existsSync);
18
+ beforeEach(() => vi.resetAllMocks());
19
+ function makeDetected(slug) {
20
+ const config = CLIENT_REGISTRY.find((c) => c.slug === slug);
21
+ return {
22
+ config,
23
+ mcpConfigPath: `/home/${slug}/config`,
24
+ instructionPath: `/home/${slug}/instruction`,
25
+ };
26
+ }
27
+ describe("buildMcpEntry", () => {
28
+ it("builds string command entry for standard clients", () => {
29
+ const entry = buildMcpEntry("string", "env", "~/Vaults/ai");
30
+ expect(entry).toEqual({
31
+ command: "npx",
32
+ args: ["-y", "superskill"],
33
+ env: { VAULT_PATH: "~/Vaults/ai" },
34
+ });
35
+ });
36
+ it("builds array command entry for OpenCode", () => {
37
+ const entry = buildMcpEntry("array", "environment", "~/Vaults/ai", { type: "local" });
38
+ expect(entry).toEqual({
39
+ type: "local",
40
+ command: ["npx", "-y", "superskill"],
41
+ environment: { VAULT_PATH: "~/Vaults/ai" },
42
+ });
43
+ });
44
+ });
45
+ describe("configureClient", () => {
46
+ it("configures JSON client with MCP entry and markdown instruction", () => {
47
+ vi.mocked(readJsonConfig).mockReturnValue({ mcpServers: {} });
48
+ vi.mocked(addMcpEntry).mockReturnValue({ config: { mcpServers: { "superskill": {} } }, alreadyExists: false });
49
+ vi.mocked(writeMarkdownInstruction).mockReturnValue("created");
50
+ const result = configureClient(makeDetected("claude-code"), "~/Vaults/ai");
51
+ expect(result.mcpConfigured).toBe(true);
52
+ expect(result.instructionConfigured).toBe(true);
53
+ });
54
+ it("skips when MCP entry already exists", () => {
55
+ vi.mocked(readJsonConfig).mockReturnValue({ mcpServers: { "superskill": {} } });
56
+ vi.mocked(addMcpEntry).mockReturnValue({ config: {}, alreadyExists: true });
57
+ vi.mocked(writeMarkdownInstruction).mockReturnValue("exists");
58
+ const result = configureClient(makeDetected("claude-code"), "~/Vaults/ai");
59
+ expect(result.mcpConfigured).toBe(false);
60
+ expect(result.skipped).toContain("already exists");
61
+ });
62
+ it("returns error for invalid JSON", () => {
63
+ vi.mocked(readJsonConfig).mockReturnValue(null);
64
+ const result = configureClient(makeDetected("claude-code"), "~/Vaults/ai");
65
+ expect(result.error).toContain("Invalid JSON");
66
+ });
67
+ it("handles dry run", () => {
68
+ const result = configureClient(makeDetected("claude-code"), "~/Vaults/ai", { dryRun: true });
69
+ expect(result.mcpConfigured).toBe(true);
70
+ expect(result.instructionConfigured).toBe(true);
71
+ expect(writeJsonConfig).not.toHaveBeenCalled();
72
+ });
73
+ it("configures TOML client (Codex)", () => {
74
+ mockExists.mockReturnValue(false);
75
+ vi.mocked(insertTomlBlock).mockReturnValue("toml content");
76
+ vi.mocked(writeMarkdownInstruction).mockReturnValue("created");
77
+ const result = configureClient(makeDetected("codex"), "~/Vaults/ai");
78
+ expect(result.mcpConfigured).toBe(true);
79
+ expect(writeFileSync).toHaveBeenCalled();
80
+ });
81
+ it("skips TOML when block already exists", () => {
82
+ mockExists.mockReturnValue(true);
83
+ vi.mocked(readFileSync).mockReturnValue("existing toml");
84
+ vi.mocked(insertTomlBlock).mockReturnValue(null);
85
+ vi.mocked(writeMarkdownInstruction).mockReturnValue("created");
86
+ const result = configureClient(makeDetected("codex"), "~/Vaults/ai");
87
+ expect(result.skipped).toContain("already exists");
88
+ });
89
+ it("configures mdc-file strategy (Cursor)", () => {
90
+ vi.mocked(readJsonConfig).mockReturnValue({});
91
+ vi.mocked(addMcpEntry).mockReturnValue({ config: {}, alreadyExists: false });
92
+ const result = configureClient(makeDetected("cursor"), "~/Vaults/ai");
93
+ expect(result.instructionConfigured).toBe(true);
94
+ expect(writeMdcInstruction).toHaveBeenCalled();
95
+ });
96
+ it("handles none instruction strategy", () => {
97
+ vi.mocked(readJsonConfig).mockReturnValue({});
98
+ vi.mocked(addMcpEntry).mockReturnValue({ config: {}, alreadyExists: false });
99
+ const result = configureClient(makeDetected("claude-desktop"), "~/Vaults/ai");
100
+ expect(result.mcpConfigured).toBe(true);
101
+ expect(result.instructionConfigured).toBe(false);
102
+ });
103
+ it("configures config-array strategy (OpenCode)", () => {
104
+ vi.mocked(readJsonConfig).mockReturnValue({});
105
+ vi.mocked(addMcpEntry).mockReturnValue({ config: {}, alreadyExists: false });
106
+ mockExists.mockReturnValue(true);
107
+ const result = configureClient(makeDetected("opencode"), "~/Vaults/ai");
108
+ expect(result.instructionConfigured).toBe(true);
109
+ expect(writeFileSync).toHaveBeenCalled();
110
+ });
111
+ });
112
+ //# sourceMappingURL=configure.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"configure.test.js","sourceRoot":"","sources":["../../src/setup/configure.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { ClientConfig, DetectedClient } from "./types.js";
2
+ export declare function detectClient(client: ClientConfig): DetectedClient | null;
3
+ export declare function detectClients(): DetectedClient[];
@@ -0,0 +1,24 @@
1
+ // SPDX-License-Identifier: AGPL-3.0-or-later OR Commercial
2
+ import { existsSync } from "fs";
3
+ import { dirname } from "path";
4
+ import { homedir } from "os";
5
+ import { CLIENT_REGISTRY } from "./clients.js";
6
+ import { resolveHome, currentPlatform } from "./types.js";
7
+ export function detectClient(client) {
8
+ const plat = currentPlatform();
9
+ const mcpPath = resolveHome(client.mcpConfigPaths[plat]);
10
+ const parentDir = dirname(mcpPath);
11
+ const home = homedir();
12
+ const parentIsHome = parentDir === home || parentDir === home + "/";
13
+ if (!existsSync(mcpPath) && (parentIsHome || !existsSync(parentDir))) {
14
+ return null;
15
+ }
16
+ const instructionPath = client.instructionPaths
17
+ ? resolveHome(client.instructionPaths[plat])
18
+ : undefined;
19
+ return { config: client, mcpConfigPath: mcpPath, instructionPath };
20
+ }
21
+ export function detectClients() {
22
+ return CLIENT_REGISTRY.map(detectClient).filter((d) => d !== null);
23
+ }
24
+ //# sourceMappingURL=detect.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/setup/detect.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IAEzD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,MAAM,YAAY,GAAG,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,GAAG,GAAG,CAAC;IAEpE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,CAAC,gBAAgB;QAC7C,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,CAC7C,CAAC,CAAC,EAAuB,EAAE,CAAC,CAAC,KAAK,IAAI,CACvC,CAAC;AACJ,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,44 @@
1
+ import { describe, it, expect, vi, beforeEach } from "vitest";
2
+ import { existsSync } from "fs";
3
+ import { detectClient, detectClients } from "./detect.js";
4
+ import { CLIENT_REGISTRY } from "./clients.js";
5
+ vi.mock("fs", () => ({
6
+ existsSync: vi.fn(),
7
+ }));
8
+ const mockExists = vi.mocked(existsSync);
9
+ beforeEach(() => {
10
+ mockExists.mockReset();
11
+ });
12
+ describe("detectClient", () => {
13
+ it("returns DetectedClient when config path exists", () => {
14
+ mockExists.mockReturnValue(true);
15
+ const claude = CLIENT_REGISTRY.find((c) => c.slug === "claude-code");
16
+ const result = detectClient(claude);
17
+ expect(result).not.toBeNull();
18
+ expect(result.config.slug).toBe("claude-code");
19
+ expect(result.mcpConfigPath).toContain(".claude.json");
20
+ });
21
+ it("returns null when config path does not exist", () => {
22
+ mockExists.mockReturnValue(false);
23
+ const claude = CLIENT_REGISTRY.find((c) => c.slug === "claude-code");
24
+ expect(detectClient(claude)).toBeNull();
25
+ });
26
+ });
27
+ describe("detectClients", () => {
28
+ it("returns only clients whose config exists", () => {
29
+ mockExists.mockImplementation((p) => String(p).includes(".claude.json"));
30
+ const detected = detectClients();
31
+ expect(detected.length).toBe(1);
32
+ expect(detected[0].config.slug).toBe("claude-code");
33
+ });
34
+ it("returns empty array when no clients detected", () => {
35
+ mockExists.mockReturnValue(false);
36
+ expect(detectClients()).toEqual([]);
37
+ });
38
+ it("returns all clients when all config paths exist", () => {
39
+ mockExists.mockReturnValue(true);
40
+ const detected = detectClients();
41
+ expect(detected.length).toBe(CLIENT_REGISTRY.length);
42
+ });
43
+ });
44
+ //# sourceMappingURL=detect.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"detect.test.js","sourceRoot":"","sources":["../../src/setup/detect.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ import type { Command } from "commander";
2
+ export declare function registerSetupCommands(program: Command): void;
@@ -0,0 +1,147 @@
1
+ import { CLIENT_REGISTRY } from "./clients.js";
2
+ import { detectClients } from "./detect.js";
3
+ import { configureClient } from "./configure.js";
4
+ import { teardownAll } from "./teardown.js";
5
+ import { resolveHome, currentPlatform } from "./types.js";
6
+ export function registerSetupCommands(program) {
7
+ program
8
+ .command("setup")
9
+ .description("Auto-configure AI clients to use superskill as knowledge base")
10
+ .option("--all", "Configure all supported clients (even undetected)")
11
+ .option("--clients <list>", "Comma-separated client slugs")
12
+ .option("--dry-run", "Show what would change without writing")
13
+ .option("--force", "Overwrite existing superskill entries")
14
+ .option("--vault-path <path>", "Override vault path")
15
+ .action(async (opts) => {
16
+ const vaultPath = opts.vaultPath ?? process.env.VAULT_PATH ?? "~/Vaults/ai";
17
+ const clientSlugs = opts.clients?.split(",").map((s) => s.trim());
18
+ console.log("\nScanning for AI clients...\n");
19
+ const detected = detectClients();
20
+ const detectedSlugs = new Set(detected.map((d) => d.config.slug));
21
+ for (const client of CLIENT_REGISTRY) {
22
+ const found = detectedSlugs.has(client.slug);
23
+ const mark = found ? "+" : "-";
24
+ const suffix = found ? "" : " (not found)";
25
+ console.log(` ${mark} ${client.name.padEnd(18)}${suffix}`);
26
+ }
27
+ // Determine targets
28
+ let targets;
29
+ if (clientSlugs) {
30
+ targets = [];
31
+ for (const slug of clientSlugs) {
32
+ const existing = detected.find((d) => d.config.slug === slug);
33
+ if (existing) {
34
+ targets.push(existing);
35
+ }
36
+ else {
37
+ const cfg = CLIENT_REGISTRY.find((c) => c.slug === slug);
38
+ if (cfg) {
39
+ const plat = currentPlatform();
40
+ targets.push({
41
+ config: cfg,
42
+ mcpConfigPath: resolveHome(cfg.mcpConfigPaths[plat]),
43
+ instructionPath: cfg.instructionPaths
44
+ ? resolveHome(cfg.instructionPaths[plat])
45
+ : undefined,
46
+ });
47
+ }
48
+ }
49
+ }
50
+ }
51
+ else if (opts.all) {
52
+ const plat = currentPlatform();
53
+ targets = CLIENT_REGISTRY.map((cfg) => ({
54
+ config: cfg,
55
+ mcpConfigPath: resolveHome(cfg.mcpConfigPaths[plat]),
56
+ instructionPath: cfg.instructionPaths
57
+ ? resolveHome(cfg.instructionPaths[plat])
58
+ : undefined,
59
+ }));
60
+ }
61
+ else {
62
+ targets = detected;
63
+ }
64
+ if (targets.length === 0) {
65
+ console.log("\nNo clients to configure.");
66
+ console.log('Run "superskill-cli setup --all" to configure all supported clients.\n');
67
+ return;
68
+ }
69
+ console.log(`\n${opts.dryRun ? "Would configure" : "Configuring"}...\n`);
70
+ let configured = 0;
71
+ for (const target of targets) {
72
+ const result = configureClient(target, vaultPath, {
73
+ dryRun: opts.dryRun,
74
+ force: opts.force,
75
+ });
76
+ console.log(` ${result.client}`);
77
+ if (result.error) {
78
+ console.log(` ! Error: ${result.error}`);
79
+ }
80
+ else {
81
+ if (result.mcpConfigured) {
82
+ console.log(` + MCP server ${opts.dryRun ? "would be added to" : "added to"} ${target.mcpConfigPath}`);
83
+ }
84
+ if (result.skipped) {
85
+ console.log(` ~ ${result.skipped}`);
86
+ }
87
+ if (result.instructionConfigured) {
88
+ const instrLabel = target.config.instructionStrategy === "mdc-file"
89
+ ? "Rule written to"
90
+ : "Instruction added to";
91
+ console.log(` + ${instrLabel} ${target.instructionPath ?? "config"}`);
92
+ }
93
+ if (target.config.instructionStrategy === "none") {
94
+ console.log(" i No instruction mechanism — AI will discover tools automatically");
95
+ }
96
+ if (!target.config.verified) {
97
+ console.log(" i Config format unverified — please check manually");
98
+ }
99
+ configured++;
100
+ }
101
+ }
102
+ console.log(`\nDone! ${configured} client(s) configured.\n`);
103
+ const targetSlugs = new Set(targets.map((t) => t.config.slug));
104
+ const unconfigured = CLIENT_REGISTRY.filter((c) => !targetSlugs.has(c.slug));
105
+ if (unconfigured.length > 0 && !opts.all) {
106
+ console.log(`Not configured: ${unconfigured.map((c) => c.name).join(", ")}`);
107
+ console.log('Run "superskill-cli setup --all" to configure them.\n');
108
+ }
109
+ });
110
+ program
111
+ .command("teardown")
112
+ .description("Remove superskill configuration from AI clients")
113
+ .option("--clients <list>", "Comma-separated client slugs")
114
+ .option("--dry-run", "Show what would be removed")
115
+ .option("--silent", "Suppress output")
116
+ .action(async (opts) => {
117
+ const clientSlugs = opts.clients?.split(",").map((s) => s.trim());
118
+ const results = await teardownAll({
119
+ clients: clientSlugs,
120
+ dryRun: opts.dryRun,
121
+ silent: opts.silent,
122
+ });
123
+ if (opts.silent)
124
+ return;
125
+ if (results.length === 0) {
126
+ console.log("\nNothing to clean up.\n");
127
+ return;
128
+ }
129
+ console.log("\nRemoving superskill configuration...\n");
130
+ for (const r of results) {
131
+ console.log(` ${r.client}`);
132
+ if (r.error) {
133
+ console.log(` ! Error: ${r.error}`);
134
+ }
135
+ else {
136
+ if (r.mcpRemoved)
137
+ console.log(" - MCP entry removed");
138
+ if (r.instructionRemoved)
139
+ console.log(" - Instruction removed");
140
+ if (!r.mcpRemoved && !r.instructionRemoved)
141
+ console.log(" ~ Nothing found");
142
+ }
143
+ }
144
+ console.log("\nDone!\n");
145
+ });
146
+ }
147
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export declare function writeMarkdownInstruction(filePath: string, force?: boolean): "created" | "appended" | "exists";
2
+ export declare function removeMarkdownInstruction(filePath: string): boolean;
3
+ export declare function writeMdcInstruction(filePath: string): void;
4
+ export declare function removeMdcInstruction(filePath: string): boolean;