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,76 @@
1
+ const CONTEXT_WINDOWS = {
2
+ 'claude-opus-4-6': 1_000_000,
3
+ 'claude-sonnet-4-6': 200_000,
4
+ 'claude-haiku-4-5': 200_000,
5
+ 'gpt-4o': 128_000,
6
+ 'gpt-4o-mini': 128_000,
7
+ 'gemini-2.5-pro': 1_000_000,
8
+ 'gemini-2.5-flash': 1_000_000,
9
+ 'o3': 200_000,
10
+ 'default': 128_000,
11
+ };
12
+ function lookupContextWindow(model) {
13
+ if (!model)
14
+ return CONTEXT_WINDOWS['default'];
15
+ // Exact match first
16
+ if (model in CONTEXT_WINDOWS)
17
+ return CONTEXT_WINDOWS[model];
18
+ // Prefix / substring match
19
+ for (const [key, value] of Object.entries(CONTEXT_WINDOWS)) {
20
+ if (key === 'default')
21
+ continue;
22
+ if (model.startsWith(key) || key.startsWith(model))
23
+ return value;
24
+ }
25
+ return CONTEXT_WINDOWS['default'];
26
+ }
27
+ function getEnv(key) {
28
+ return process.env[key];
29
+ }
30
+ function hasEnvPrefix(prefix) {
31
+ return Object.keys(process.env).some((k) => k.startsWith(prefix));
32
+ }
33
+ export function detectTool() {
34
+ // ── Claude Code ──────────────────────────────────────
35
+ if (getEnv('CLAUDE_CODE') ||
36
+ getEnv('CLAUDE_CODE_VAULT_PATH') ||
37
+ getEnv('CLAUDE_CODE_WORKTREE') ||
38
+ // Claude Code sets ANTHROPIC_MODEL or CLAUDE_MODEL when the AI invokes tools
39
+ getEnv('CLAUDE_CODE_SESSION_ID') ||
40
+ // The AGENTS.md system-reminder tells us we're in Claude Code when this var is present
41
+ getEnv('CLAUDE_CODE_ENTRYPOINT')) {
42
+ const model = getEnv('CLAUDE_CODE_MODEL') ??
43
+ getEnv('ANTHROPIC_MODEL') ??
44
+ getEnv('CLAUDE_MODEL') ??
45
+ undefined;
46
+ return {
47
+ tool: 'claude-code',
48
+ model,
49
+ contextWindow: lookupContextWindow(model),
50
+ };
51
+ }
52
+ // ── OpenCode ─────────────────────────────────────────
53
+ if (hasEnvPrefix('OPENCODE_')) {
54
+ const model = getEnv('OPENCODE_MODEL') ?? undefined;
55
+ return { tool: 'opencode', model, contextWindow: lookupContextWindow(model) };
56
+ }
57
+ // ── Cursor ───────────────────────────────────────────
58
+ if (hasEnvPrefix('CURSOR_')) {
59
+ const model = getEnv('CURSOR_MODEL') ?? undefined;
60
+ return { tool: 'cursor', model, contextWindow: lookupContextWindow(model) };
61
+ }
62
+ // ── Codex ────────────────────────────────────────────
63
+ if (hasEnvPrefix('CODEX_')) {
64
+ const model = getEnv('CODEX_MODEL') ?? getEnv('OPENAI_MODEL') ?? undefined;
65
+ return { tool: 'codex', model, contextWindow: lookupContextWindow(model) };
66
+ }
67
+ // ── Gemini CLI ───────────────────────────────────────
68
+ if (hasEnvPrefix('GEMINI_')) {
69
+ const model = getEnv('GEMINI_MODEL') ?? undefined;
70
+ return { tool: 'gemini-cli', model, contextWindow: lookupContextWindow(model) };
71
+ }
72
+ // ── Unknown / fallback ───────────────────────────────
73
+ return { tool: 'unknown', contextWindow: CONTEXT_WINDOWS['default'] };
74
+ }
75
+ export { CONTEXT_WINDOWS };
76
+ //# sourceMappingURL=tool-detector.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-detector.js","sourceRoot":"","sources":["../../src/lib/tool-detector.ts"],"names":[],"mappings":"AAOA,MAAM,eAAe,GAA2B;IAC9C,iBAAiB,EAAE,SAAS;IAC5B,mBAAmB,EAAE,OAAO;IAC5B,kBAAkB,EAAE,OAAO;IAC3B,QAAQ,EAAE,OAAO;IACjB,aAAa,EAAE,OAAO;IACtB,gBAAgB,EAAE,SAAS;IAC3B,kBAAkB,EAAE,SAAS;IAC7B,IAAI,EAAE,OAAO;IACb,SAAS,EAAE,OAAO;CACnB,CAAC;AAEF,SAAS,mBAAmB,CAAC,KAAyB;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC;IAC9C,oBAAoB;IACpB,IAAI,KAAK,IAAI,eAAe;QAAE,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAC5D,2BAA2B;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAC3D,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;IACnE,CAAC;IACD,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,MAAM,CAAC,GAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,wDAAwD;IACxD,IACE,MAAM,CAAC,aAAa,CAAC;QACrB,MAAM,CAAC,wBAAwB,CAAC;QAChC,MAAM,CAAC,sBAAsB,CAAC;QAC9B,6EAA6E;QAC7E,MAAM,CAAC,wBAAwB,CAAC;QAChC,uFAAuF;QACvF,MAAM,CAAC,wBAAwB,CAAC,EAChC,CAAC;QACD,MAAM,KAAK,GACT,MAAM,CAAC,mBAAmB,CAAC;YAC3B,MAAM,CAAC,iBAAiB,CAAC;YACzB,MAAM,CAAC,cAAc,CAAC;YACtB,SAAS,CAAC;QACZ,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,KAAK;YACL,aAAa,EAAE,mBAAmB,CAAC,KAAK,CAAC;SAC1C,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,IAAI,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,gBAAgB,CAAC,IAAI,SAAS,CAAC;QACpD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;IAChF,CAAC;IAED,wDAAwD;IACxD,IAAI,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC;QAClD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;IAC9E,CAAC;IAED,wDAAwD;IACxD,IAAI,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC;QAC3E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7E,CAAC;IAED,wDAAwD;IACxD,IAAI,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC;QAClD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;IAClF,CAAC;IAED,wDAAwD;IACxD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,170 @@
1
+ import { describe, it, expect } from "vitest";
2
+ import { detectTool, CONTEXT_WINDOWS } from "./tool-detector.js";
3
+ // All environment keys that could trigger a specific tool detection.
4
+ // When testing one tool we need to clear all others (and vice versa).
5
+ const ALL_TOOL_KEYS = [
6
+ "CLAUDE_CODE",
7
+ "CLAUDE_CODE_VAULT_PATH",
8
+ "CLAUDE_CODE_WORKTREE",
9
+ "CLAUDE_CODE_SESSION_ID",
10
+ "CLAUDE_CODE_ENTRYPOINT",
11
+ "CLAUDE_CODE_MODEL",
12
+ "ANTHROPIC_MODEL",
13
+ "CLAUDE_MODEL",
14
+ ];
15
+ const ALL_TOOL_PREFIXES = ["OPENCODE_", "CURSOR_", "CODEX_", "GEMINI_"];
16
+ function clearAllToolEnv() {
17
+ const saved = {};
18
+ for (const key of Object.keys(process.env)) {
19
+ const isToolKey = ALL_TOOL_KEYS.includes(key) ||
20
+ ALL_TOOL_PREFIXES.some((p) => key.startsWith(p));
21
+ if (isToolKey) {
22
+ saved[key] = process.env[key];
23
+ delete process.env[key];
24
+ }
25
+ }
26
+ return saved;
27
+ }
28
+ function restoreToolEnv(saved) {
29
+ for (const [key, value] of Object.entries(saved)) {
30
+ if (value === undefined) {
31
+ delete process.env[key];
32
+ }
33
+ else {
34
+ process.env[key] = value;
35
+ }
36
+ }
37
+ }
38
+ function withEnv(overrides, fn) {
39
+ // First clear ALL tool env vars to prevent cross-contamination from the
40
+ // host environment (e.g. CLAUDE_CODE_VAULT_PATH set by Claude Code itself).
41
+ const savedAll = clearAllToolEnv();
42
+ // Then apply only the vars specified by this test.
43
+ const original = {};
44
+ for (const key of Object.keys(overrides)) {
45
+ original[key] = process.env[key];
46
+ if (overrides[key] === undefined) {
47
+ delete process.env[key];
48
+ }
49
+ else {
50
+ process.env[key] = overrides[key];
51
+ }
52
+ }
53
+ try {
54
+ fn();
55
+ }
56
+ finally {
57
+ for (const key of Object.keys(original)) {
58
+ if (original[key] === undefined) {
59
+ delete process.env[key];
60
+ }
61
+ else {
62
+ process.env[key] = original[key];
63
+ }
64
+ }
65
+ restoreToolEnv(savedAll);
66
+ }
67
+ }
68
+ describe("detectTool", () => {
69
+ describe("claude-code detection", () => {
70
+ it("detects CLAUDE_CODE env var", () => {
71
+ withEnv({ CLAUDE_CODE: "1" }, () => {
72
+ const result = detectTool();
73
+ expect(result.tool).toBe("claude-code");
74
+ });
75
+ });
76
+ it("detects CLAUDE_CODE_VAULT_PATH env var", () => {
77
+ withEnv({ CLAUDE_CODE_VAULT_PATH: "/some/path" }, () => {
78
+ const result = detectTool();
79
+ expect(result.tool).toBe("claude-code");
80
+ });
81
+ });
82
+ it("detects model from ANTHROPIC_MODEL", () => {
83
+ withEnv({ CLAUDE_CODE: "1", ANTHROPIC_MODEL: "claude-opus-4-6" }, () => {
84
+ const result = detectTool();
85
+ expect(result.tool).toBe("claude-code");
86
+ expect(result.model).toBe("claude-opus-4-6");
87
+ expect(result.contextWindow).toBe(1_000_000);
88
+ });
89
+ });
90
+ it("detects claude-sonnet-4-6 with 200k context", () => {
91
+ withEnv({ CLAUDE_CODE: "1", ANTHROPIC_MODEL: "claude-sonnet-4-6" }, () => {
92
+ const result = detectTool();
93
+ expect(result.contextWindow).toBe(200_000);
94
+ });
95
+ });
96
+ });
97
+ describe("opencode detection", () => {
98
+ it("detects OPENCODE_ prefix env var", () => {
99
+ withEnv({ OPENCODE_SESSION: "abc123" }, () => {
100
+ const result = detectTool();
101
+ expect(result.tool).toBe("opencode");
102
+ });
103
+ });
104
+ it("reads model from OPENCODE_MODEL", () => {
105
+ withEnv({ OPENCODE_MODEL: "gpt-4o" }, () => {
106
+ const result = detectTool();
107
+ expect(result.tool).toBe("opencode");
108
+ expect(result.model).toBe("gpt-4o");
109
+ expect(result.contextWindow).toBe(128_000);
110
+ });
111
+ });
112
+ });
113
+ describe("cursor detection", () => {
114
+ it("detects CURSOR_ prefix env var", () => {
115
+ withEnv({ CURSOR_EDITOR: "1" }, () => {
116
+ const result = detectTool();
117
+ expect(result.tool).toBe("cursor");
118
+ });
119
+ });
120
+ });
121
+ describe("codex detection", () => {
122
+ it("detects CODEX_ prefix env var", () => {
123
+ withEnv({ CODEX_SESSION: "xyz" }, () => {
124
+ const result = detectTool();
125
+ expect(result.tool).toBe("codex");
126
+ });
127
+ });
128
+ });
129
+ describe("gemini-cli detection", () => {
130
+ it("detects GEMINI_ prefix env var", () => {
131
+ withEnv({ GEMINI_API_KEY: "key123" }, () => {
132
+ const result = detectTool();
133
+ expect(result.tool).toBe("gemini-cli");
134
+ });
135
+ });
136
+ it("reads gemini model and returns 1M context", () => {
137
+ withEnv({ GEMINI_API_KEY: "key123", GEMINI_MODEL: "gemini-2.5-pro" }, () => {
138
+ const result = detectTool();
139
+ expect(result.contextWindow).toBe(1_000_000);
140
+ });
141
+ });
142
+ });
143
+ describe("unknown / fallback", () => {
144
+ it("returns unknown tool when no matching env vars", () => {
145
+ // withEnv with empty overrides clears all tool env vars
146
+ withEnv({}, () => {
147
+ const result = detectTool();
148
+ expect(result.tool).toBe("unknown");
149
+ expect(result.contextWindow).toBe(128_000);
150
+ });
151
+ });
152
+ it("uses 128000 as default context when model unknown", () => {
153
+ // Set CLAUDE_CODE but no model env vars
154
+ withEnv({ CLAUDE_CODE: "1" }, () => {
155
+ const result = detectTool();
156
+ // ANTHROPIC_MODEL / CLAUDE_MODEL are not set (cleared by withEnv)
157
+ expect(result.tool).toBe("claude-code");
158
+ expect(result.contextWindow).toBe(128_000);
159
+ });
160
+ });
161
+ });
162
+ describe("CONTEXT_WINDOWS mapping", () => {
163
+ it("exports the mapping", () => {
164
+ expect(CONTEXT_WINDOWS["claude-opus-4-6"]).toBe(1_000_000);
165
+ expect(CONTEXT_WINDOWS["gpt-4o"]).toBe(128_000);
166
+ expect(CONTEXT_WINDOWS["default"]).toBe(128_000);
167
+ });
168
+ });
169
+ });
170
+ //# sourceMappingURL=tool-detector.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-detector.test.js","sourceRoot":"","sources":["../../src/lib/tool-detector.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,39 @@
1
+ /**
2
+ * Safe filesystem operations on the vault.
3
+ * Every path is resolved against the vault root and validated.
4
+ */
5
+ export declare class VaultFS {
6
+ private readonly _root;
7
+ constructor(_root: string);
8
+ get root(): string;
9
+ /**
10
+ * Resolve a relative vault path to an absolute path.
11
+ * Rejects traversal attacks, absolute paths, and personal vault access.
12
+ */
13
+ private resolve;
14
+ read(relativePath: string): Promise<string>;
15
+ write(relativePath: string, content: string): Promise<{
16
+ path: string;
17
+ bytes: number;
18
+ }>;
19
+ append(relativePath: string, content: string): Promise<{
20
+ path: string;
21
+ bytes: number;
22
+ }>;
23
+ list(relativePath: string, depth?: number): Promise<string[]>;
24
+ private listRecursive;
25
+ delete(relativePath: string): Promise<void>;
26
+ move(relativePath: string, newRelativePath: string): Promise<{
27
+ from: string;
28
+ to: string;
29
+ }>;
30
+ exists(relativePath: string): Promise<boolean>;
31
+ /**
32
+ * Verify a path doesn't follow symlinks outside the vault.
33
+ */
34
+ verifyNoSymlinkEscape(relativePath: string): Promise<void>;
35
+ }
36
+ export declare class VaultError extends Error {
37
+ readonly code: string;
38
+ constructor(code: string, message: string);
39
+ }
@@ -0,0 +1,184 @@
1
+ // SPDX-License-Identifier: AGPL-3.0-or-later OR Commercial
2
+ import { readFile, writeFile, appendFile, mkdir, readdir, stat, realpath, unlink, rename } from "fs/promises";
3
+ import { join, resolve, relative, dirname } from "path";
4
+ /**
5
+ * Safe filesystem operations on the vault.
6
+ * Every path is resolved against the vault root and validated.
7
+ */
8
+ export class VaultFS {
9
+ _root;
10
+ constructor(_root) {
11
+ this._root = _root;
12
+ }
13
+ get root() {
14
+ return this._root;
15
+ }
16
+ /**
17
+ * Resolve a relative vault path to an absolute path.
18
+ * Rejects traversal attacks, absolute paths, and personal vault access.
19
+ */
20
+ resolve(relativePath) {
21
+ // Reject non-ASCII characters (prevents Unicode homoglyph attacks on APFS)
22
+ if (/[^\x20-\x7E]/.test(relativePath)) {
23
+ throw new VaultError("PERMISSION_DENIED", `Non-ASCII characters not allowed in paths: ${relativePath}`);
24
+ }
25
+ // Reject absolute paths
26
+ if (relativePath.startsWith("/") || relativePath.startsWith("~")) {
27
+ throw new VaultError("PERMISSION_DENIED", `Absolute paths not allowed: ${relativePath}`);
28
+ }
29
+ // Reject traversal
30
+ if (relativePath.includes("..")) {
31
+ throw new VaultError("PERMISSION_DENIED", `Path traversal not allowed: ${relativePath}`);
32
+ }
33
+ // Reject personal vault references (case-insensitive, segment-level match)
34
+ const segments = relativePath.toLowerCase().split("/");
35
+ if (segments.some((seg) => seg === "personal")) {
36
+ throw new VaultError("PERMISSION_DENIED", `Cannot access personal vault: ${relativePath}`);
37
+ }
38
+ const resolved = resolve(this._root, relativePath);
39
+ // Double-check the resolved path is within vault
40
+ const rel = relative(this._root, resolved);
41
+ if (rel.startsWith("..")) {
42
+ throw new VaultError("PERMISSION_DENIED", `Path escapes vault: ${relativePath}`);
43
+ }
44
+ return resolved;
45
+ }
46
+ async read(relativePath) {
47
+ const abs = this.resolve(relativePath);
48
+ await this.verifyNoSymlinkEscape(relativePath);
49
+ try {
50
+ return await readFile(abs, "utf-8");
51
+ }
52
+ catch (e) {
53
+ if (e.code === "ENOENT") {
54
+ throw new VaultError("FILE_NOT_FOUND", `Not found: ${relativePath}`);
55
+ }
56
+ throw e;
57
+ }
58
+ }
59
+ async write(relativePath, content) {
60
+ const abs = this.resolve(relativePath);
61
+ await this.verifyNoSymlinkEscape(relativePath);
62
+ await mkdir(dirname(abs), { recursive: true });
63
+ await writeFile(abs, content, "utf-8");
64
+ return { path: relativePath, bytes: Buffer.byteLength(content, "utf-8") };
65
+ }
66
+ async append(relativePath, content) {
67
+ const abs = this.resolve(relativePath);
68
+ await this.verifyNoSymlinkEscape(relativePath);
69
+ if (!(await this.exists(relativePath))) {
70
+ throw new VaultError("FILE_NOT_FOUND", `Cannot append to non-existent file: ${relativePath}`);
71
+ }
72
+ await appendFile(abs, content, "utf-8");
73
+ return { path: relativePath, bytes: Buffer.byteLength(content, "utf-8") };
74
+ }
75
+ async list(relativePath, depth = 1) {
76
+ const abs = this.resolve(relativePath);
77
+ await this.verifyNoSymlinkEscape(relativePath);
78
+ const results = [];
79
+ await this.listRecursive(abs, relativePath, depth, 0, results);
80
+ return results;
81
+ }
82
+ async listRecursive(absDir, relDir, maxDepth, currentDepth, results) {
83
+ if (currentDepth >= maxDepth)
84
+ return;
85
+ let entries;
86
+ try {
87
+ entries = await readdir(absDir, { withFileTypes: true });
88
+ }
89
+ catch (e) {
90
+ if (e.code === "ENOENT") {
91
+ throw new VaultError("FILE_NOT_FOUND", `Directory not found: ${relDir}`);
92
+ }
93
+ throw e;
94
+ }
95
+ for (const entry of entries) {
96
+ // Skip hidden files/dirs (.obsidian, .git, etc.)
97
+ if (entry.name.startsWith("."))
98
+ continue;
99
+ // Skip symlinks to prevent following links outside the vault
100
+ if (entry.isSymbolicLink())
101
+ continue;
102
+ const entryRel = relDir ? `${relDir}/${entry.name}` : entry.name;
103
+ if (entry.isDirectory()) {
104
+ results.push(`${entryRel}/`);
105
+ await this.listRecursive(join(absDir, entry.name), entryRel, maxDepth, currentDepth + 1, results);
106
+ }
107
+ else {
108
+ results.push(entryRel);
109
+ }
110
+ }
111
+ }
112
+ async delete(relativePath) {
113
+ const abs = this.resolve(relativePath);
114
+ await this.verifyNoSymlinkEscape(relativePath);
115
+ try {
116
+ await unlink(abs);
117
+ }
118
+ catch (e) {
119
+ if (e.code === "ENOENT") {
120
+ throw new VaultError("FILE_NOT_FOUND", `Not found: ${relativePath}`);
121
+ }
122
+ throw e;
123
+ }
124
+ }
125
+ async move(relativePath, newRelativePath) {
126
+ const absFrom = this.resolve(relativePath);
127
+ const absTo = this.resolve(newRelativePath);
128
+ await this.verifyNoSymlinkEscape(relativePath);
129
+ await this.verifyNoSymlinkEscape(newRelativePath);
130
+ await mkdir(dirname(absTo), { recursive: true });
131
+ try {
132
+ await rename(absFrom, absTo);
133
+ }
134
+ catch (e) {
135
+ if (e.code === "ENOENT") {
136
+ throw new VaultError("FILE_NOT_FOUND", `Not found: ${relativePath}`);
137
+ }
138
+ throw e;
139
+ }
140
+ return { from: relativePath, to: newRelativePath };
141
+ }
142
+ async exists(relativePath) {
143
+ try {
144
+ const abs = this.resolve(relativePath);
145
+ await stat(abs);
146
+ return true;
147
+ }
148
+ catch {
149
+ return false;
150
+ }
151
+ }
152
+ /**
153
+ * Verify a path doesn't follow symlinks outside the vault.
154
+ */
155
+ async verifyNoSymlinkEscape(relativePath) {
156
+ const abs = this.resolve(relativePath);
157
+ if (!(await this.exists(relativePath))) {
158
+ return;
159
+ }
160
+ try {
161
+ const [realAbs, realRoot] = await Promise.all([realpath(abs), realpath(this._root)]);
162
+ const rel = relative(realRoot, realAbs);
163
+ if (rel.startsWith("..")) {
164
+ throw new VaultError("PERMISSION_DENIED", `Symlink escapes vault: ${relativePath}`);
165
+ }
166
+ }
167
+ catch (e) {
168
+ if (e instanceof VaultError)
169
+ throw e;
170
+ if (e.code === "ENOENT")
171
+ return;
172
+ throw e;
173
+ }
174
+ }
175
+ }
176
+ export class VaultError extends Error {
177
+ code;
178
+ constructor(code, message) {
179
+ super(message);
180
+ this.code = code;
181
+ this.name = "VaultError";
182
+ }
183
+ }
184
+ //# sourceMappingURL=vault-fs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vault-fs.js","sourceRoot":"","sources":["../../src/lib/vault-fs.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};