@shinobiapps/shinobi 0.1.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 (378) hide show
  1. package/CHANGELOG.md +70 -0
  2. package/CODE_OF_CONDUCT.md +70 -0
  3. package/LICENSE +21 -0
  4. package/README.md +269 -0
  5. package/SECURITY.md +75 -0
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +200 -0
  9. package/dist/cli.js.map +1 -0
  10. package/dist/commands/cost.d.ts +9 -0
  11. package/dist/commands/cost.d.ts.map +1 -0
  12. package/dist/commands/cost.js +49 -0
  13. package/dist/commands/cost.js.map +1 -0
  14. package/dist/commands/digest.d.ts +29 -0
  15. package/dist/commands/digest.d.ts.map +1 -0
  16. package/dist/commands/digest.js +63 -0
  17. package/dist/commands/digest.js.map +1 -0
  18. package/dist/commands/init.d.ts +15 -0
  19. package/dist/commands/init.d.ts.map +1 -0
  20. package/dist/commands/init.js +81 -0
  21. package/dist/commands/init.js.map +1 -0
  22. package/dist/commands/sync.d.ts +5 -0
  23. package/dist/commands/sync.d.ts.map +1 -0
  24. package/dist/commands/sync.js +160 -0
  25. package/dist/commands/sync.js.map +1 -0
  26. package/dist/dashboard/auth.d.ts +17 -0
  27. package/dist/dashboard/auth.d.ts.map +1 -0
  28. package/dist/dashboard/auth.js +108 -0
  29. package/dist/dashboard/auth.js.map +1 -0
  30. package/dist/dashboard/server.d.ts +16 -0
  31. package/dist/dashboard/server.d.ts.map +1 -0
  32. package/dist/dashboard/server.js +1020 -0
  33. package/dist/dashboard/server.js.map +1 -0
  34. package/dist/dashboard/settings-store.d.ts +46 -0
  35. package/dist/dashboard/settings-store.d.ts.map +1 -0
  36. package/dist/dashboard/settings-store.js +183 -0
  37. package/dist/dashboard/settings-store.js.map +1 -0
  38. package/dist/dashboard-spa/apple-touch-icon.png +0 -0
  39. package/dist/dashboard-spa/assets/index-0vWLEg34.css +1 -0
  40. package/dist/dashboard-spa/assets/index-Rnhs9802.js +263 -0
  41. package/dist/dashboard-spa/assets/index-Rnhs9802.js.map +1 -0
  42. package/dist/dashboard-spa/icon-192.png +0 -0
  43. package/dist/dashboard-spa/icon-192.svg +4 -0
  44. package/dist/dashboard-spa/icon-512.png +0 -0
  45. package/dist/dashboard-spa/index.html +29 -0
  46. package/dist/dashboard-spa/manifest.webmanifest +37 -0
  47. package/dist/dashboard-spa/sw.js +111 -0
  48. package/dist/lib/config.d.ts +14 -0
  49. package/dist/lib/config.d.ts.map +1 -0
  50. package/dist/lib/config.js +36 -0
  51. package/dist/lib/config.js.map +1 -0
  52. package/dist/lib/db.d.ts +5 -0
  53. package/dist/lib/db.d.ts.map +1 -0
  54. package/dist/lib/db.js +33 -0
  55. package/dist/lib/db.js.map +1 -0
  56. package/dist/lib/fts.d.ts +2 -0
  57. package/dist/lib/fts.d.ts.map +1 -0
  58. package/dist/lib/fts.js +14 -0
  59. package/dist/lib/fts.js.map +1 -0
  60. package/dist/lib/json.d.ts +3 -0
  61. package/dist/lib/json.d.ts.map +1 -0
  62. package/dist/lib/json.js +16 -0
  63. package/dist/lib/json.js.map +1 -0
  64. package/dist/lib/migrations.d.ts +9 -0
  65. package/dist/lib/migrations.d.ts.map +1 -0
  66. package/dist/lib/migrations.js +94 -0
  67. package/dist/lib/migrations.js.map +1 -0
  68. package/dist/lib/priority.d.ts +2 -0
  69. package/dist/lib/priority.d.ts.map +1 -0
  70. package/dist/lib/priority.js +8 -0
  71. package/dist/lib/priority.js.map +1 -0
  72. package/dist/models/activity.d.ts +41 -0
  73. package/dist/models/activity.d.ts.map +1 -0
  74. package/dist/models/activity.js +55 -0
  75. package/dist/models/activity.js.map +1 -0
  76. package/dist/models/approvals.d.ts +43 -0
  77. package/dist/models/approvals.d.ts.map +1 -0
  78. package/dist/models/approvals.js +102 -0
  79. package/dist/models/approvals.js.map +1 -0
  80. package/dist/models/context.d.ts +25 -0
  81. package/dist/models/context.d.ts.map +1 -0
  82. package/dist/models/context.js +63 -0
  83. package/dist/models/context.js.map +1 -0
  84. package/dist/models/dead_ends-helpers.d.ts +3 -0
  85. package/dist/models/dead_ends-helpers.d.ts.map +1 -0
  86. package/dist/models/dead_ends-helpers.js +9 -0
  87. package/dist/models/dead_ends-helpers.js.map +1 -0
  88. package/dist/models/dead_ends.d.ts +41 -0
  89. package/dist/models/dead_ends.d.ts.map +1 -0
  90. package/dist/models/dead_ends.js +96 -0
  91. package/dist/models/dead_ends.js.map +1 -0
  92. package/dist/models/decision_drafts.d.ts +59 -0
  93. package/dist/models/decision_drafts.d.ts.map +1 -0
  94. package/dist/models/decision_drafts.js +105 -0
  95. package/dist/models/decision_drafts.js.map +1 -0
  96. package/dist/models/decisions-helpers.d.ts +3 -0
  97. package/dist/models/decisions-helpers.d.ts.map +1 -0
  98. package/dist/models/decisions-helpers.js +9 -0
  99. package/dist/models/decisions-helpers.js.map +1 -0
  100. package/dist/models/decisions.d.ts +51 -0
  101. package/dist/models/decisions.d.ts.map +1 -0
  102. package/dist/models/decisions.js +97 -0
  103. package/dist/models/decisions.js.map +1 -0
  104. package/dist/models/notes-helpers.d.ts +3 -0
  105. package/dist/models/notes-helpers.d.ts.map +1 -0
  106. package/dist/models/notes-helpers.js +9 -0
  107. package/dist/models/notes-helpers.js.map +1 -0
  108. package/dist/models/notes.d.ts +35 -0
  109. package/dist/models/notes.d.ts.map +1 -0
  110. package/dist/models/notes.js +66 -0
  111. package/dist/models/notes.js.map +1 -0
  112. package/dist/models/plans.d.ts +25 -0
  113. package/dist/models/plans.d.ts.map +1 -0
  114. package/dist/models/plans.js +39 -0
  115. package/dist/models/plans.js.map +1 -0
  116. package/dist/models/pr_links.d.ts +36 -0
  117. package/dist/models/pr_links.d.ts.map +1 -0
  118. package/dist/models/pr_links.js +45 -0
  119. package/dist/models/pr_links.js.map +1 -0
  120. package/dist/models/project_members.d.ts +22 -0
  121. package/dist/models/project_members.d.ts.map +1 -0
  122. package/dist/models/project_members.js +33 -0
  123. package/dist/models/project_members.js.map +1 -0
  124. package/dist/models/projects.d.ts +55 -0
  125. package/dist/models/projects.d.ts.map +1 -0
  126. package/dist/models/projects.js +126 -0
  127. package/dist/models/projects.js.map +1 -0
  128. package/dist/models/push_subscriptions.d.ts +24 -0
  129. package/dist/models/push_subscriptions.d.ts.map +1 -0
  130. package/dist/models/push_subscriptions.js +39 -0
  131. package/dist/models/push_subscriptions.js.map +1 -0
  132. package/dist/models/session_costs.d.ts +48 -0
  133. package/dist/models/session_costs.d.ts.map +1 -0
  134. package/dist/models/session_costs.js +77 -0
  135. package/dist/models/session_costs.js.map +1 -0
  136. package/dist/models/sessions.d.ts +41 -0
  137. package/dist/models/sessions.d.ts.map +1 -0
  138. package/dist/models/sessions.js +96 -0
  139. package/dist/models/sessions.js.map +1 -0
  140. package/dist/models/subtasks-helpers.d.ts +3 -0
  141. package/dist/models/subtasks-helpers.d.ts.map +1 -0
  142. package/dist/models/subtasks-helpers.js +9 -0
  143. package/dist/models/subtasks-helpers.js.map +1 -0
  144. package/dist/models/subtasks.d.ts +69 -0
  145. package/dist/models/subtasks.d.ts.map +1 -0
  146. package/dist/models/subtasks.js +215 -0
  147. package/dist/models/subtasks.js.map +1 -0
  148. package/dist/models/users.d.ts +25 -0
  149. package/dist/models/users.d.ts.map +1 -0
  150. package/dist/models/users.js +44 -0
  151. package/dist/models/users.js.map +1 -0
  152. package/dist/server/mcp.d.ts +6 -0
  153. package/dist/server/mcp.d.ts.map +1 -0
  154. package/dist/server/mcp.js +72 -0
  155. package/dist/server/mcp.js.map +1 -0
  156. package/dist/server/tools/approval.d.ts +3 -0
  157. package/dist/server/tools/approval.d.ts.map +1 -0
  158. package/dist/server/tools/approval.js +98 -0
  159. package/dist/server/tools/approval.js.map +1 -0
  160. package/dist/server/tools/args.d.ts +11 -0
  161. package/dist/server/tools/args.d.ts.map +1 -0
  162. package/dist/server/tools/args.js +79 -0
  163. package/dist/server/tools/args.js.map +1 -0
  164. package/dist/server/tools/context.d.ts +3 -0
  165. package/dist/server/tools/context.d.ts.map +1 -0
  166. package/dist/server/tools/context.js +72 -0
  167. package/dist/server/tools/context.js.map +1 -0
  168. package/dist/server/tools/dead_ends.d.ts +3 -0
  169. package/dist/server/tools/dead_ends.d.ts.map +1 -0
  170. package/dist/server/tools/dead_ends.js +111 -0
  171. package/dist/server/tools/dead_ends.js.map +1 -0
  172. package/dist/server/tools/decisions.d.ts +3 -0
  173. package/dist/server/tools/decisions.d.ts.map +1 -0
  174. package/dist/server/tools/decisions.js +101 -0
  175. package/dist/server/tools/decisions.js.map +1 -0
  176. package/dist/server/tools/extraction.d.ts +3 -0
  177. package/dist/server/tools/extraction.d.ts.map +1 -0
  178. package/dist/server/tools/extraction.js +145 -0
  179. package/dist/server/tools/extraction.js.map +1 -0
  180. package/dist/server/tools/git.d.ts +3 -0
  181. package/dist/server/tools/git.d.ts.map +1 -0
  182. package/dist/server/tools/git.js +86 -0
  183. package/dist/server/tools/git.js.map +1 -0
  184. package/dist/server/tools/history.d.ts +3 -0
  185. package/dist/server/tools/history.d.ts.map +1 -0
  186. package/dist/server/tools/history.js +51 -0
  187. package/dist/server/tools/history.js.map +1 -0
  188. package/dist/server/tools/index.d.ts +6 -0
  189. package/dist/server/tools/index.d.ts.map +1 -0
  190. package/dist/server/tools/index.js +41 -0
  191. package/dist/server/tools/index.js.map +1 -0
  192. package/dist/server/tools/notes.d.ts +3 -0
  193. package/dist/server/tools/notes.d.ts.map +1 -0
  194. package/dist/server/tools/notes.js +60 -0
  195. package/dist/server/tools/notes.js.map +1 -0
  196. package/dist/server/tools/plans.d.ts +3 -0
  197. package/dist/server/tools/plans.d.ts.map +1 -0
  198. package/dist/server/tools/plans.js +65 -0
  199. package/dist/server/tools/plans.js.map +1 -0
  200. package/dist/server/tools/plugin.d.ts +3 -0
  201. package/dist/server/tools/plugin.d.ts.map +1 -0
  202. package/dist/server/tools/plugin.js +26 -0
  203. package/dist/server/tools/plugin.js.map +1 -0
  204. package/dist/server/tools/projects.d.ts +3 -0
  205. package/dist/server/tools/projects.d.ts.map +1 -0
  206. package/dist/server/tools/projects.js +197 -0
  207. package/dist/server/tools/projects.js.map +1 -0
  208. package/dist/server/tools/recall.d.ts +3 -0
  209. package/dist/server/tools/recall.d.ts.map +1 -0
  210. package/dist/server/tools/recall.js +74 -0
  211. package/dist/server/tools/recall.js.map +1 -0
  212. package/dist/server/tools/registry.d.ts +8 -0
  213. package/dist/server/tools/registry.d.ts.map +1 -0
  214. package/dist/server/tools/registry.js +23 -0
  215. package/dist/server/tools/registry.js.map +1 -0
  216. package/dist/server/tools/subtasks.d.ts +3 -0
  217. package/dist/server/tools/subtasks.d.ts.map +1 -0
  218. package/dist/server/tools/subtasks.js +306 -0
  219. package/dist/server/tools/subtasks.js.map +1 -0
  220. package/dist/server/tools/types.d.ts +7 -0
  221. package/dist/server/tools/types.d.ts.map +1 -0
  222. package/dist/server/tools/types.js +2 -0
  223. package/dist/server/tools/types.js.map +1 -0
  224. package/dist/server/tools/workflow.d.ts +3 -0
  225. package/dist/server/tools/workflow.d.ts.map +1 -0
  226. package/dist/server/tools/workflow.js +434 -0
  227. package/dist/server/tools/workflow.js.map +1 -0
  228. package/dist/services/auth/magic-link.d.ts +27 -0
  229. package/dist/services/auth/magic-link.d.ts.map +1 -0
  230. package/dist/services/auth/magic-link.js +48 -0
  231. package/dist/services/auth/magic-link.js.map +1 -0
  232. package/dist/services/auth/session.d.ts +15 -0
  233. package/dist/services/auth/session.d.ts.map +1 -0
  234. package/dist/services/auth/session.js +65 -0
  235. package/dist/services/auth/session.js.map +1 -0
  236. package/dist/services/cost/claude-code-parser.d.ts +30 -0
  237. package/dist/services/cost/claude-code-parser.d.ts.map +1 -0
  238. package/dist/services/cost/claude-code-parser.js +110 -0
  239. package/dist/services/cost/claude-code-parser.js.map +1 -0
  240. package/dist/services/cost/pricing.d.ts +15 -0
  241. package/dist/services/cost/pricing.d.ts.map +1 -0
  242. package/dist/services/cost/pricing.js +33 -0
  243. package/dist/services/cost/pricing.js.map +1 -0
  244. package/dist/services/digest/generator.d.ts +51 -0
  245. package/dist/services/digest/generator.d.ts.map +1 -0
  246. package/dist/services/digest/generator.js +136 -0
  247. package/dist/services/digest/generator.js.map +1 -0
  248. package/dist/services/digest/scheduler.d.ts +3 -0
  249. package/dist/services/digest/scheduler.d.ts.map +1 -0
  250. package/dist/services/digest/scheduler.js +61 -0
  251. package/dist/services/digest/scheduler.js.map +1 -0
  252. package/dist/services/digest/telegram.d.ts +13 -0
  253. package/dist/services/digest/telegram.d.ts.map +1 -0
  254. package/dist/services/digest/telegram.js +68 -0
  255. package/dist/services/digest/telegram.js.map +1 -0
  256. package/dist/services/embedding/detect.d.ts +19 -0
  257. package/dist/services/embedding/detect.d.ts.map +1 -0
  258. package/dist/services/embedding/detect.js +64 -0
  259. package/dist/services/embedding/detect.js.map +1 -0
  260. package/dist/services/embedding/factory.d.ts +10 -0
  261. package/dist/services/embedding/factory.d.ts.map +1 -0
  262. package/dist/services/embedding/factory.js +79 -0
  263. package/dist/services/embedding/factory.js.map +1 -0
  264. package/dist/services/embedding/ollama.d.ts +14 -0
  265. package/dist/services/embedding/ollama.d.ts.map +1 -0
  266. package/dist/services/embedding/ollama.js +28 -0
  267. package/dist/services/embedding/ollama.js.map +1 -0
  268. package/dist/services/embedding/openai.d.ts +16 -0
  269. package/dist/services/embedding/openai.d.ts.map +1 -0
  270. package/dist/services/embedding/openai.js +33 -0
  271. package/dist/services/embedding/openai.js.map +1 -0
  272. package/dist/services/embedding/store.d.ts +25 -0
  273. package/dist/services/embedding/store.d.ts.map +1 -0
  274. package/dist/services/embedding/store.js +79 -0
  275. package/dist/services/embedding/store.js.map +1 -0
  276. package/dist/services/embedding/types.d.ts +9 -0
  277. package/dist/services/embedding/types.d.ts.map +1 -0
  278. package/dist/services/embedding/types.js +2 -0
  279. package/dist/services/embedding/types.js.map +1 -0
  280. package/dist/services/embedding/vector-math.d.ts +4 -0
  281. package/dist/services/embedding/vector-math.d.ts.map +1 -0
  282. package/dist/services/embedding/vector-math.js +27 -0
  283. package/dist/services/embedding/vector-math.js.map +1 -0
  284. package/dist/services/embedding/voyage.d.ts +16 -0
  285. package/dist/services/embedding/voyage.d.ts.map +1 -0
  286. package/dist/services/embedding/voyage.js +33 -0
  287. package/dist/services/embedding/voyage.js.map +1 -0
  288. package/dist/services/extraction/decision-extractor.d.ts +16 -0
  289. package/dist/services/extraction/decision-extractor.d.ts.map +1 -0
  290. package/dist/services/extraction/decision-extractor.js +111 -0
  291. package/dist/services/extraction/decision-extractor.js.map +1 -0
  292. package/dist/services/extraction/session-summarizer.d.ts +17 -0
  293. package/dist/services/extraction/session-summarizer.d.ts.map +1 -0
  294. package/dist/services/extraction/session-summarizer.js +112 -0
  295. package/dist/services/extraction/session-summarizer.js.map +1 -0
  296. package/dist/services/github/webhook.d.ts +17 -0
  297. package/dist/services/github/webhook.d.ts.map +1 -0
  298. package/dist/services/github/webhook.js +159 -0
  299. package/dist/services/github/webhook.js.map +1 -0
  300. package/dist/services/llm/factory.d.ts +3 -0
  301. package/dist/services/llm/factory.d.ts.map +1 -0
  302. package/dist/services/llm/factory.js +53 -0
  303. package/dist/services/llm/factory.js.map +1 -0
  304. package/dist/services/llm/openai-compat.d.ts +20 -0
  305. package/dist/services/llm/openai-compat.d.ts.map +1 -0
  306. package/dist/services/llm/openai-compat.js +53 -0
  307. package/dist/services/llm/openai-compat.js.map +1 -0
  308. package/dist/services/llm/types.d.ts +23 -0
  309. package/dist/services/llm/types.d.ts.map +1 -0
  310. package/dist/services/llm/types.js +2 -0
  311. package/dist/services/llm/types.js.map +1 -0
  312. package/dist/services/mentions/resolver.d.ts +36 -0
  313. package/dist/services/mentions/resolver.d.ts.map +1 -0
  314. package/dist/services/mentions/resolver.js +97 -0
  315. package/dist/services/mentions/resolver.js.map +1 -0
  316. package/dist/services/plugins/api.d.ts +55 -0
  317. package/dist/services/plugins/api.d.ts.map +1 -0
  318. package/dist/services/plugins/api.js +35 -0
  319. package/dist/services/plugins/api.js.map +1 -0
  320. package/dist/services/plugins/discovery.d.ts +7 -0
  321. package/dist/services/plugins/discovery.d.ts.map +1 -0
  322. package/dist/services/plugins/discovery.js +104 -0
  323. package/dist/services/plugins/discovery.js.map +1 -0
  324. package/dist/services/plugins/marketplace.d.ts +42 -0
  325. package/dist/services/plugins/marketplace.d.ts.map +1 -0
  326. package/dist/services/plugins/marketplace.js +186 -0
  327. package/dist/services/plugins/marketplace.js.map +1 -0
  328. package/dist/services/plugins/registry.d.ts +12 -0
  329. package/dist/services/plugins/registry.d.ts.map +1 -0
  330. package/dist/services/plugins/registry.js +66 -0
  331. package/dist/services/plugins/registry.js.map +1 -0
  332. package/dist/services/plugins/state.d.ts +12 -0
  333. package/dist/services/plugins/state.d.ts.map +1 -0
  334. package/dist/services/plugins/state.js +14 -0
  335. package/dist/services/plugins/state.js.map +1 -0
  336. package/dist/services/push/web-push.d.ts +26 -0
  337. package/dist/services/push/web-push.d.ts.map +1 -0
  338. package/dist/services/push/web-push.js +84 -0
  339. package/dist/services/push/web-push.js.map +1 -0
  340. package/dist/services/relay/client.d.ts +27 -0
  341. package/dist/services/relay/client.d.ts.map +1 -0
  342. package/dist/services/relay/client.js +219 -0
  343. package/dist/services/relay/client.js.map +1 -0
  344. package/dist/services/relay/types.d.ts +19 -0
  345. package/dist/services/relay/types.d.ts.map +1 -0
  346. package/dist/services/relay/types.js +2 -0
  347. package/dist/services/relay/types.js.map +1 -0
  348. package/dist/services/telemetry/client.d.ts +35 -0
  349. package/dist/services/telemetry/client.d.ts.map +1 -0
  350. package/dist/services/telemetry/client.js +125 -0
  351. package/dist/services/telemetry/client.js.map +1 -0
  352. package/dist/services/transcription/whisper.d.ts +16 -0
  353. package/dist/services/transcription/whisper.d.ts.map +1 -0
  354. package/dist/services/transcription/whisper.js +72 -0
  355. package/dist/services/transcription/whisper.js.map +1 -0
  356. package/docs/architecture.md +108 -0
  357. package/docs/configuration.md +73 -0
  358. package/docs/cursor-quirks.md +42 -0
  359. package/docs/embedding-providers.md +110 -0
  360. package/docs/github-integration.md +109 -0
  361. package/docs/plugin-development.md +104 -0
  362. package/docs/plugins.md +104 -0
  363. package/docs/relay.md +108 -0
  364. package/docs/remote-access.md +218 -0
  365. package/docs/sponsorship.md +54 -0
  366. package/migrations/.gitkeep +0 -0
  367. package/migrations/0001_initial_schema.sql +284 -0
  368. package/migrations/0002_activity_and_links.sql +26 -0
  369. package/migrations/0003_workspace.sql +7 -0
  370. package/migrations/0004_decision_drafts.sql +28 -0
  371. package/migrations/0005_project_summaries.sql +10 -0
  372. package/migrations/0006_push_and_approvals.sql +37 -0
  373. package/migrations/0007_session_costs.sql +17 -0
  374. package/migrations/0008_pr_links.sql +22 -0
  375. package/migrations/0009_telemetry.sql +17 -0
  376. package/migrations/0010_users_and_members.sql +40 -0
  377. package/migrations/0011_assignments_mentions.sql +20 -0
  378. package/package.json +95 -0
@@ -0,0 +1,72 @@
1
+ import { recordActivity } from '../../models/activity.js';
2
+ import { getContext, upsertContext } from '../../models/context.js';
3
+ import { getObject, getString, getStringArray, requireNumber } from './args.js';
4
+ export const contextTools = [
5
+ {
6
+ name: 'get_context',
7
+ description: 'Get a project living context: conventions, dont_touch, test_patterns, deploy_notes, file_annotations. Returns null when no context row exists yet.',
8
+ inputSchema: {
9
+ type: 'object',
10
+ properties: { project_id: { type: 'integer' } },
11
+ required: ['project_id'],
12
+ additionalProperties: false,
13
+ },
14
+ handler: (args) => getContext(requireNumber(args, 'project_id')),
15
+ },
16
+ {
17
+ name: 'update_context',
18
+ description: "Patch a project's context. Only fields present in the patch are modified — others preserve their prior value.",
19
+ inputSchema: {
20
+ type: 'object',
21
+ properties: {
22
+ project_id: { type: 'integer' },
23
+ conventions: { type: 'string' },
24
+ dont_touch: { type: 'array', items: { type: 'string' } },
25
+ test_patterns: { type: 'string' },
26
+ deploy_notes: { type: 'string' },
27
+ file_annotations: { type: 'object', additionalProperties: { type: 'string' } },
28
+ last_validated_commit: { type: 'string' },
29
+ session_id: { type: 'string' },
30
+ },
31
+ required: ['project_id'],
32
+ additionalProperties: false,
33
+ },
34
+ handler: (args) => {
35
+ const id = requireNumber(args, 'project_id');
36
+ const patch = {};
37
+ if ('conventions' in args)
38
+ patch['conventions'] = getString(args, 'conventions') ?? null;
39
+ if ('dont_touch' in args)
40
+ patch['dont_touch'] = getStringArray(args, 'dont_touch') ?? null;
41
+ if ('test_patterns' in args)
42
+ patch['test_patterns'] = getString(args, 'test_patterns') ?? null;
43
+ if ('deploy_notes' in args)
44
+ patch['deploy_notes'] = getString(args, 'deploy_notes') ?? null;
45
+ if ('file_annotations' in args) {
46
+ const annotations = getObject(args, 'file_annotations');
47
+ const coerced = annotations
48
+ ? Object.fromEntries(Object.entries(annotations).map(([k, v]) => {
49
+ if (typeof v !== 'string') {
50
+ throw new Error('file_annotations values must be strings');
51
+ }
52
+ return [k, v];
53
+ }))
54
+ : null;
55
+ patch['file_annotations'] = coerced;
56
+ }
57
+ if ('last_validated_commit' in args)
58
+ patch['last_validated_commit'] = getString(args, 'last_validated_commit') ?? null;
59
+ const updated = upsertContext(id, patch);
60
+ recordActivity({
61
+ project_id: id,
62
+ session_id: getString(args, 'session_id'),
63
+ action_type: 'update_context',
64
+ action_details: Object.keys(patch).join(','),
65
+ entity_type: 'context',
66
+ entity_id: id,
67
+ });
68
+ return updated;
69
+ },
70
+ },
71
+ ];
72
+ //# sourceMappingURL=context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/server/tools/context.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { ShinobiTool } from './types.js';
2
+ export declare const deadEndTools: ShinobiTool[];
3
+ //# sourceMappingURL=dead_ends.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dead_ends.d.ts","sourceRoot":"","sources":["../../../src/server/tools/dead_ends.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAU9C,eAAO,MAAM,YAAY,EAAE,WAAW,EA+FrC,CAAC"}
@@ -0,0 +1,111 @@
1
+ import { recordActivity } from '../../models/activity.js';
2
+ import { checkDeadEnds, logDeadEnd, } from '../../models/dead_ends.js';
3
+ import { resolveEmbeddingProvider } from '../../services/embedding/factory.js';
4
+ import { semanticSearch, updateRowEmbedding } from '../../services/embedding/store.js';
5
+ import { parseJsonOrNull } from '../../lib/json.js';
6
+ import { getBoolean, getNumber, getString, getStringArray, requireNumber, requireString, } from './args.js';
7
+ function hydrate(row) {
8
+ return {
9
+ ...row,
10
+ files_involved: parseJsonOrNull(row.files_involved),
11
+ never_retry: row.never_retry === 1,
12
+ };
13
+ }
14
+ export const deadEndTools = [
15
+ {
16
+ name: 'log_dead_end',
17
+ description: 'Log an approach that demonstrably failed so future sessions do not re-try. Embeds approach+failure_reason for semantic match when SHINOBI_EMBED_PROVIDER is configured.',
18
+ inputSchema: {
19
+ type: 'object',
20
+ properties: {
21
+ project_id: { type: 'integer' },
22
+ attempted_approach: { type: 'string' },
23
+ failure_reason: { type: 'string' },
24
+ files_involved: { type: 'array', items: { type: 'string' } },
25
+ never_retry: { type: 'boolean', default: false },
26
+ session_id: { type: 'string' },
27
+ },
28
+ required: ['project_id', 'attempted_approach', 'failure_reason'],
29
+ additionalProperties: false,
30
+ },
31
+ handler: async (args) => {
32
+ const dead = logDeadEnd({
33
+ project_id: requireNumber(args, 'project_id'),
34
+ attempted_approach: requireString(args, 'attempted_approach'),
35
+ failure_reason: requireString(args, 'failure_reason'),
36
+ files_involved: getStringArray(args, 'files_involved'),
37
+ never_retry: getBoolean(args, 'never_retry') ?? false,
38
+ claude_session_id: getString(args, 'session_id'),
39
+ });
40
+ const embedText = `${dead.attempted_approach}\n${dead.failure_reason}`;
41
+ const embedded = await updateRowEmbedding('dead_ends', dead.id, embedText);
42
+ recordActivity({
43
+ project_id: dead.project_id,
44
+ session_id: dead.claude_session_id,
45
+ action_type: 'log_dead_end',
46
+ action_details: dead.attempted_approach.slice(0, 200),
47
+ entity_type: 'dead_end',
48
+ entity_id: dead.id,
49
+ });
50
+ return { ...dead, embedded: embedded !== null, embedding_provider: embedded?.provider ?? null };
51
+ },
52
+ },
53
+ {
54
+ name: 'check_dead_ends',
55
+ description: 'Preventive search BEFORE implementing an approach. Pass a description and optional file paths. Uses semantic similarity when SHINOBI_EMBED_PROVIDER is configured; otherwise FTS5 + filename overlap. Returns matching past failures.',
56
+ inputSchema: {
57
+ type: 'object',
58
+ properties: {
59
+ approach: { type: 'string', description: 'Plain English description of the planned approach' },
60
+ files: { type: 'array', items: { type: 'string' } },
61
+ project_id: { type: 'integer' },
62
+ limit: { type: 'integer', default: 10 },
63
+ score_threshold: { type: 'number', description: 'Semantic mode only: minimum cosine score (default 0.55)' },
64
+ },
65
+ required: ['approach'],
66
+ additionalProperties: false,
67
+ },
68
+ handler: async (args) => {
69
+ const approach = requireString(args, 'approach');
70
+ const files = getStringArray(args, 'files');
71
+ const projectId = getNumber(args, 'project_id');
72
+ const limit = getNumber(args, 'limit') ?? 10;
73
+ const threshold = getNumber(args, 'score_threshold') ?? 0.55;
74
+ const provider = await resolveEmbeddingProvider();
75
+ if (provider) {
76
+ const semanticOpts = { limit };
77
+ if (projectId !== undefined)
78
+ semanticOpts.projectId = projectId;
79
+ const semantic = await semanticSearch('dead_ends', approach, semanticOpts);
80
+ const matches = semantic
81
+ .filter((hit) => hit.score >= threshold)
82
+ .map((hit) => ({ ...hydrate(hit.row), score: Number(hit.score.toFixed(4)) }));
83
+ if (matches.length > 0) {
84
+ return {
85
+ matches,
86
+ count: matches.length,
87
+ mode: 'semantic',
88
+ provider: provider.name,
89
+ verdict: 'matches_found',
90
+ };
91
+ }
92
+ }
93
+ const fallbackOpts = {
94
+ approach,
95
+ limit,
96
+ };
97
+ if (files)
98
+ fallbackOpts.files = files;
99
+ if (projectId !== undefined)
100
+ fallbackOpts.projectId = projectId;
101
+ const matches = checkDeadEnds(fallbackOpts);
102
+ return {
103
+ matches,
104
+ count: matches.length,
105
+ mode: provider ? 'semantic_fallback_fulltext' : 'fulltext',
106
+ verdict: matches.length === 0 ? 'no_known_dead_ends' : 'matches_found',
107
+ };
108
+ },
109
+ },
110
+ ];
111
+ //# sourceMappingURL=dead_ends.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dead_ends.js","sourceRoot":"","sources":["../../../src/server/tools/dead_ends.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { ShinobiTool } from './types.js';
2
+ export declare const decisionTools: ShinobiTool[];
3
+ //# sourceMappingURL=decisions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../../src/server/tools/decisions.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,eAAO,MAAM,aAAa,EAAE,WAAW,EA4FtC,CAAC"}
@@ -0,0 +1,101 @@
1
+ import { recordActivity } from '../../models/activity.js';
2
+ import { decisionsForFile, listDecisions, logDecision, updateDecisionStatus, } from '../../models/decisions.js';
3
+ import { updateRowEmbedding } from '../../services/embedding/store.js';
4
+ import { getNumber, getString, getStringArray, requireNumber, requireString, } from './args.js';
5
+ const KIND_ENUM = ['architecture', 'library', 'pattern', 'tradeoff', 'workaround', 'other'];
6
+ const STATUS_ENUM = ['open', 'fix_now', 'fix_later', 'wontfix', 'fixed', 'false_positive'];
7
+ export const decisionTools = [
8
+ {
9
+ name: 'log_decision',
10
+ description: 'Record a decision in the durable decision log. Architectural choices, library picks, tradeoffs, workarounds. Embeds summary+rationale for semantic recall when SHINOBI_EMBED_PROVIDER is configured.',
11
+ inputSchema: {
12
+ type: 'object',
13
+ properties: {
14
+ project_id: { type: 'integer' },
15
+ subtask_id: { type: 'integer' },
16
+ summary: { type: 'string', description: 'Short one-liner' },
17
+ rationale: { type: 'string', description: 'Full reasoning' },
18
+ alternatives_considered: { type: 'string' },
19
+ files_touched: { type: 'array', items: { type: 'string' } },
20
+ tags: { type: 'array', items: { type: 'string' } },
21
+ kind: { type: 'string', enum: [...KIND_ENUM], default: 'other' },
22
+ session_id: { type: 'string' },
23
+ },
24
+ required: ['project_id', 'summary', 'rationale'],
25
+ additionalProperties: false,
26
+ },
27
+ handler: async (args) => {
28
+ const decision = logDecision({
29
+ project_id: requireNumber(args, 'project_id'),
30
+ subtask_id: getNumber(args, 'subtask_id') ?? null,
31
+ summary: requireString(args, 'summary'),
32
+ rationale: requireString(args, 'rationale'),
33
+ alternatives_considered: getString(args, 'alternatives_considered'),
34
+ files_touched: getStringArray(args, 'files_touched'),
35
+ tags: getStringArray(args, 'tags'),
36
+ kind: getString(args, 'kind'),
37
+ claude_session_id: getString(args, 'session_id'),
38
+ });
39
+ const embedText = [decision.summary, decision.rationale, decision.alternatives_considered]
40
+ .filter((v) => typeof v === 'string' && v.length > 0)
41
+ .join('\n');
42
+ const embedded = await updateRowEmbedding('decisions', decision.id, embedText);
43
+ recordActivity({
44
+ project_id: decision.project_id,
45
+ session_id: decision.claude_session_id,
46
+ action_type: 'log_decision',
47
+ action_details: decision.summary,
48
+ entity_type: 'decision',
49
+ entity_id: decision.id,
50
+ });
51
+ return { ...decision, embedded: embedded !== null, embedding_provider: embedded?.provider ?? null };
52
+ },
53
+ },
54
+ {
55
+ name: 'decisions_for_file',
56
+ description: 'Return every decision whose files_touched contains the given path. Useful when opening a file you have not touched in months.',
57
+ inputSchema: {
58
+ type: 'object',
59
+ properties: {
60
+ file_path: { type: 'string' },
61
+ limit: { type: 'integer', default: 50 },
62
+ },
63
+ required: ['file_path'],
64
+ additionalProperties: false,
65
+ },
66
+ handler: (args) => decisionsForFile(requireString(args, 'file_path'), getNumber(args, 'limit') ?? 50),
67
+ },
68
+ {
69
+ name: 'update_decision_status',
70
+ description: 'Move a decision through its lifecycle (open / fix_now / fix_later / wontfix / fixed / false_positive). Stamps decided_at automatically on closing states.',
71
+ inputSchema: {
72
+ type: 'object',
73
+ properties: {
74
+ decision_id: { type: 'integer' },
75
+ status: { type: 'string', enum: [...STATUS_ENUM] },
76
+ fixed_in_commit_sha: { type: 'string' },
77
+ session_id: { type: 'string' },
78
+ },
79
+ required: ['decision_id', 'status'],
80
+ additionalProperties: false,
81
+ },
82
+ handler: (args) => {
83
+ const decisionId = requireNumber(args, 'decision_id');
84
+ const status = requireString(args, 'status');
85
+ const updated = updateDecisionStatus(decisionId, status, getString(args, 'fixed_in_commit_sha'));
86
+ if (updated) {
87
+ recordActivity({
88
+ project_id: updated.project_id,
89
+ session_id: getString(args, 'session_id'),
90
+ action_type: 'decision_status_changed',
91
+ action_details: `${status}`,
92
+ entity_type: 'decision',
93
+ entity_id: updated.id,
94
+ });
95
+ }
96
+ return updated;
97
+ },
98
+ },
99
+ ];
100
+ void listDecisions;
101
+ //# sourceMappingURL=decisions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decisions.js","sourceRoot":"","sources":["../../../src/server/tools/decisions.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { ShinobiTool } from './types.js';
2
+ export declare const extractionTools: ShinobiTool[];
3
+ //# sourceMappingURL=extraction.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extraction.d.ts","sourceRoot":"","sources":["../../../src/server/tools/extraction.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,eAAe,EAAE,WAAW,EAgJxC,CAAC"}
@@ -0,0 +1,145 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { recordActivity } from '../../models/activity.js';
3
+ import { createDraft } from '../../models/decision_drafts.js';
4
+ import { getProject } from '../../models/projects.js';
5
+ import { extractDecisions } from '../../services/extraction/decision-extractor.js';
6
+ import { persistSummary, summarizeProject } from '../../services/extraction/session-summarizer.js';
7
+ import { getBoolean, getNumber, getString, requireNumber, requireString } from './args.js';
8
+ export const extractionTools = [
9
+ {
10
+ name: 'extract_decisions',
11
+ description: 'Extract decision drafts from a conversation transcript via LLM (Groq Llama 3.3 by default, free tier). Drafts land in the decision_drafts table with status=pending — the user reviews them in the dashboard and approves to create real decisions via log_decision. Use at session boundaries when you want auto-capture of decisions you may have forgotten to log explicitly. Requires SHINOBI_LLM_PROVIDER + GROQ_API_KEY (or OPENAI_API_KEY).',
12
+ inputSchema: {
13
+ type: 'object',
14
+ properties: {
15
+ project_id: { type: 'integer' },
16
+ text: {
17
+ type: 'string',
18
+ description: 'Conversation transcript or session log. Truncated to last ~24k chars if larger. Include enough context that decisions are identifiable.',
19
+ },
20
+ session_id: { type: 'string' },
21
+ auto_persist: {
22
+ type: 'boolean',
23
+ default: true,
24
+ description: 'When true (default), drafts persist to decision_drafts table for human review. When false, drafts are returned to the caller but NOT persisted — useful when the caller wants to inspect before storing.',
25
+ },
26
+ max_drafts: {
27
+ type: 'integer',
28
+ default: 50,
29
+ description: 'Cap on number of drafts persisted (safety net against extractor over-generation).',
30
+ },
31
+ },
32
+ required: ['project_id', 'text'],
33
+ additionalProperties: false,
34
+ },
35
+ handler: async (args) => {
36
+ const projectId = requireNumber(args, 'project_id');
37
+ const text = requireString(args, 'text');
38
+ const sessionId = getString(args, 'session_id') ?? null;
39
+ const autoPersist = args['auto_persist'] !== false;
40
+ const maxDrafts = getNumber(args, 'max_drafts') ?? 50;
41
+ const result = await extractDecisions(text);
42
+ const drafts = result.decisions.slice(0, maxDrafts);
43
+ const sourceHash = createHash('sha256').update(text).digest('hex').slice(0, 32);
44
+ let persisted = [];
45
+ if (autoPersist && drafts.length > 0) {
46
+ persisted = drafts.map((d) => createDraft({
47
+ project_id: projectId,
48
+ session_id: sessionId,
49
+ kind: d.kind,
50
+ summary: d.summary,
51
+ rationale: d.rationale,
52
+ alternatives_considered: d.alternatives_considered,
53
+ files_touched: d.files_touched,
54
+ source: 'extraction',
55
+ extractor_model: `${result.provider}:${result.model}`,
56
+ source_text_hash: sourceHash,
57
+ }).id);
58
+ recordActivity({
59
+ project_id: projectId,
60
+ session_id: sessionId,
61
+ action_type: 'extract_decisions',
62
+ action_details: `${drafts.length} draft(s) persisted via ${result.provider}:${result.model}`,
63
+ entity_type: 'project',
64
+ entity_id: projectId,
65
+ });
66
+ }
67
+ return {
68
+ provider: result.provider,
69
+ model: result.model,
70
+ truncated: result.truncated,
71
+ raw_length: result.raw_length,
72
+ drafts_extracted: result.decisions.length,
73
+ drafts_persisted: persisted.length,
74
+ persisted_draft_ids: persisted,
75
+ drafts,
76
+ };
77
+ },
78
+ },
79
+ {
80
+ name: 'compress_session_summary',
81
+ description: "Compress a project's recent activity + decisions + dead ends into a terse 3-paragraph markdown summary via LLM (Groq Llama 3.3 by default, free tier). When persist=true (default), stores on projects.recent_summary_md so next agent_bootstrap surfaces it as signal instead of raw 270-row noise. Requires SHINOBI_LLM_PROVIDER + GROQ_API_KEY (or OPENAI_API_KEY).",
82
+ inputSchema: {
83
+ type: 'object',
84
+ properties: {
85
+ project_id: { type: 'integer' },
86
+ activity_limit: { type: 'integer', default: 50 },
87
+ decisions_limit: { type: 'integer', default: 12 },
88
+ dead_ends_limit: { type: 'integer', default: 8 },
89
+ open_subtasks_limit: { type: 'integer', default: 8 },
90
+ persist: {
91
+ type: 'boolean',
92
+ default: true,
93
+ description: 'Persist to projects.recent_summary_md. Set false to inspect output without saving.',
94
+ },
95
+ session_id: { type: 'string' },
96
+ },
97
+ required: ['project_id'],
98
+ additionalProperties: false,
99
+ },
100
+ handler: async (args) => {
101
+ const projectId = requireNumber(args, 'project_id');
102
+ const project = getProject(projectId);
103
+ if (!project)
104
+ throw new Error(`project not found: ${projectId}`);
105
+ const input = { projectId };
106
+ const a = getNumber(args, 'activity_limit');
107
+ if (a !== undefined)
108
+ input.activityLimit = a;
109
+ const d = getNumber(args, 'decisions_limit');
110
+ if (d !== undefined)
111
+ input.decisionsLimit = d;
112
+ const de = getNumber(args, 'dead_ends_limit');
113
+ if (de !== undefined)
114
+ input.deadEndsLimit = de;
115
+ const os = getNumber(args, 'open_subtasks_limit');
116
+ if (os !== undefined)
117
+ input.openSubtasksLimit = os;
118
+ const result = await summarizeProject(input);
119
+ const persist = getBoolean(args, 'persist') !== false;
120
+ const providerLabel = `${result.provider}:${result.model}`;
121
+ if (persist) {
122
+ persistSummary(projectId, result.summary, providerLabel);
123
+ recordActivity({
124
+ project_id: projectId,
125
+ session_id: getString(args, 'session_id') ?? null,
126
+ action_type: 'compress_session_summary',
127
+ action_details: `${result.summary.length} chars, ${providerLabel}`,
128
+ entity_type: 'project',
129
+ entity_id: projectId,
130
+ });
131
+ }
132
+ return {
133
+ project_id: projectId,
134
+ provider: result.provider,
135
+ model: result.model,
136
+ input_chars: result.input_chars,
137
+ truncated: result.truncated,
138
+ summary_chars: result.summary.length,
139
+ summary: result.summary,
140
+ persisted: persist,
141
+ };
142
+ },
143
+ },
144
+ ];
145
+ //# sourceMappingURL=extraction.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extraction.js","sourceRoot":"","sources":["../../../src/server/tools/extraction.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { ShinobiTool } from './types.js';
2
+ export declare const gitTools: ShinobiTool[];
3
+ //# sourceMappingURL=git.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/server/tools/git.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,WAAW,EA0FjC,CAAC"}
@@ -0,0 +1,86 @@
1
+ import { linkCommit, recordActivity } from '../../models/activity.js';
2
+ import { projectsMatchingTargetPath } from '../../models/projects.js';
3
+ import { getNumber, getString, getStringArray, requireString, } from './args.js';
4
+ export const gitTools = [
5
+ {
6
+ name: 'link_commit',
7
+ description: "Link a git commit to a subtask (when commit message contains [KLA-N] or [SHI-N] tags) or attribute to projects via target_path match. Records to the activity timeline so 'history' shows commits next to claims/completions.",
8
+ inputSchema: {
9
+ type: 'object',
10
+ properties: {
11
+ commit_sha: { type: 'string', description: 'Full or short SHA' },
12
+ message: { type: 'string' },
13
+ files: { type: 'array', items: { type: 'string' }, description: 'Paths touched by the commit; used for target_path attribution when no [N] tag matches' },
14
+ subtask_id: { type: 'integer', description: 'Explicit subtask binding (use this when you already know the [N])' },
15
+ project_id: { type: 'integer', description: 'Explicit project binding (overrides path-based attribution)' },
16
+ ref_url: { type: 'string', description: 'Optional permalink to the commit (e.g. GitHub URL)' },
17
+ session_id: { type: 'string' },
18
+ },
19
+ required: ['commit_sha'],
20
+ additionalProperties: false,
21
+ },
22
+ handler: (args) => {
23
+ const commitSha = requireString(args, 'commit_sha');
24
+ const message = getString(args, 'message');
25
+ const files = getStringArray(args, 'files') ?? [];
26
+ const explicitSubtask = getNumber(args, 'subtask_id');
27
+ const explicitProject = getNumber(args, 'project_id');
28
+ const refUrl = getString(args, 'ref_url') ?? commitSha;
29
+ const sessionId = getString(args, 'session_id');
30
+ if (explicitSubtask !== undefined) {
31
+ const linked = linkCommit({
32
+ project_id: explicitProject ?? null,
33
+ subtask_id: explicitSubtask,
34
+ commit_sha: commitSha,
35
+ ref_url: refUrl,
36
+ message: message ?? commitSha,
37
+ session_id: sessionId,
38
+ });
39
+ return { mode: 'explicit_subtask', linked: [linked] };
40
+ }
41
+ const tagMatch = message ? /\[(?:KLA|SHI)-(\d+)\]/i.exec(message) : null;
42
+ if (tagMatch) {
43
+ const subtaskId = Number(tagMatch[1]);
44
+ const linked = linkCommit({
45
+ project_id: explicitProject ?? null,
46
+ subtask_id: subtaskId,
47
+ commit_sha: commitSha,
48
+ ref_url: refUrl,
49
+ message: message ?? commitSha,
50
+ session_id: sessionId,
51
+ });
52
+ return { mode: 'tag_matched', tag: tagMatch[0], linked: [linked] };
53
+ }
54
+ if (explicitProject !== undefined) {
55
+ const activity = recordActivity({
56
+ project_id: explicitProject,
57
+ session_id: sessionId,
58
+ action_type: 'commit_path_matched',
59
+ action_details: message ?? commitSha,
60
+ entity_type: 'commit',
61
+ ref_url: refUrl,
62
+ });
63
+ return { mode: 'explicit_project', linked: [activity] };
64
+ }
65
+ const matchedProjects = new Set();
66
+ for (const path of files) {
67
+ for (const project of projectsMatchingTargetPath(path)) {
68
+ matchedProjects.add(project.id);
69
+ }
70
+ }
71
+ if (matchedProjects.size === 0) {
72
+ return { mode: 'unattributed', linked: [] };
73
+ }
74
+ const linked = [...matchedProjects].map((projectId) => recordActivity({
75
+ project_id: projectId,
76
+ session_id: sessionId,
77
+ action_type: 'commit_path_matched',
78
+ action_details: message ?? commitSha,
79
+ entity_type: 'commit',
80
+ ref_url: refUrl,
81
+ }));
82
+ return { mode: 'path_attributed', projects: [...matchedProjects], linked };
83
+ },
84
+ },
85
+ ];
86
+ //# sourceMappingURL=git.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"git.js","sourceRoot":"","sources":["../../../src/server/tools/git.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { ShinobiTool } from './types.js';
2
+ export declare const historyTools: ShinobiTool[];
3
+ //# sourceMappingURL=history.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../src/server/tools/history.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,YAAY,EAAE,WAAW,EAyCrC,CAAC"}