sqlew 3.7.3 → 3.8.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 (786) hide show
  1. package/CHANGELOG.md +427 -1
  2. package/README.md +71 -2
  3. package/assets/kanban-visualizer.png +0 -0
  4. package/assets/sample-agents/sqlew-scrum-master.md +4 -4
  5. package/dist/adapters/postgresql-adapter.d.ts +197 -5
  6. package/dist/adapters/postgresql-adapter.d.ts.map +1 -1
  7. package/dist/adapters/postgresql-adapter.js +300 -36
  8. package/dist/adapters/postgresql-adapter.js.map +1 -1
  9. package/dist/cli/db-export.d.ts +29 -0
  10. package/dist/cli/db-export.d.ts.map +1 -0
  11. package/dist/cli/db-export.js +251 -0
  12. package/dist/cli/db-export.js.map +1 -0
  13. package/dist/cli/db-import.d.ts +31 -0
  14. package/dist/cli/db-import.d.ts.map +1 -0
  15. package/dist/cli/db-import.js +258 -0
  16. package/dist/cli/db-import.js.map +1 -0
  17. package/dist/cli.d.ts +1 -1
  18. package/dist/cli.js +32 -73
  19. package/dist/cli.js.map +1 -1
  20. package/dist/config/knex/bootstrap/20251025021416_seed_master_data.d.ts.map +1 -1
  21. package/dist/config/knex/bootstrap/20251025021416_seed_master_data.js +158 -45
  22. package/dist/config/knex/bootstrap/20251025021416_seed_master_data.js.map +1 -1
  23. package/dist/config/knex/bootstrap/20251025070349_create_views.d.ts.map +1 -1
  24. package/dist/config/knex/bootstrap/20251025070349_create_views.js +60 -8
  25. package/dist/config/knex/bootstrap/20251025070349_create_views.js.map +1 -1
  26. package/dist/config/knex/enhancements/20251025100000_seed_help_metadata.js +1 -1
  27. package/dist/config/knex/enhancements/20251025100100_seed_remaining_use_cases.js +5 -5
  28. package/dist/config/knex/enhancements/20251028000000_simplify_agent_system.d.ts.map +1 -1
  29. package/dist/config/knex/enhancements/20251028000000_simplify_agent_system.js +9 -1
  30. package/dist/config/knex/enhancements/20251028000000_simplify_agent_system.js.map +1 -1
  31. package/dist/config/knex/enhancements/20251105000000_add_token_usage_table.d.ts.map +1 -1
  32. package/dist/config/knex/enhancements/20251105000000_add_token_usage_table.js +8 -1
  33. package/dist/config/knex/enhancements/20251105000000_add_token_usage_table.js.map +1 -1
  34. package/dist/config/knex/enhancements/20251108000000_add_planning_layers_v3_8_0.d.ts +21 -0
  35. package/dist/config/knex/enhancements/20251108000000_add_planning_layers_v3_8_0.d.ts.map +1 -0
  36. package/dist/config/knex/enhancements/20251108000000_add_planning_layers_v3_8_0.js +73 -0
  37. package/dist/config/knex/enhancements/20251108000000_add_planning_layers_v3_8_0.js.map +1 -0
  38. package/dist/config/knex/enhancements/20251109000000_fix_task_file_links_unique_constraint_v3_8_0.d.ts +19 -0
  39. package/dist/config/knex/enhancements/20251109000000_fix_task_file_links_unique_constraint_v3_8_0.d.ts.map +1 -0
  40. package/dist/config/knex/enhancements/20251109000000_fix_task_file_links_unique_constraint_v3_8_0.js +88 -0
  41. package/dist/config/knex/enhancements/20251109000000_fix_task_file_links_unique_constraint_v3_8_0.js.map +1 -0
  42. package/dist/config/knex/enhancements/20251109000003_token_usage_cross_db_compat_v3_7_5.d.ts +24 -0
  43. package/dist/config/knex/enhancements/20251109000003_token_usage_cross_db_compat_v3_7_5.d.ts.map +1 -0
  44. package/dist/config/knex/enhancements/20251109000003_token_usage_cross_db_compat_v3_7_5.js +79 -0
  45. package/dist/config/knex/enhancements/20251109000003_token_usage_cross_db_compat_v3_7_5.js.map +1 -0
  46. package/dist/config/knex/enhancements/20251109010000_tool_cleanup_v3_8_0.d.ts +27 -0
  47. package/dist/config/knex/enhancements/20251109010000_tool_cleanup_v3_8_0.d.ts.map +1 -0
  48. package/dist/config/knex/enhancements/20251109010000_tool_cleanup_v3_8_0.js +347 -0
  49. package/dist/config/knex/enhancements/20251109010000_tool_cleanup_v3_8_0.js.map +1 -0
  50. package/dist/config/knex/enhancements/20251109020000_fix_missing_help_actions_v3_8_0.d.ts +30 -0
  51. package/dist/config/knex/enhancements/20251109020000_fix_missing_help_actions_v3_8_0.d.ts.map +1 -0
  52. package/dist/config/knex/enhancements/20251109020000_fix_missing_help_actions_v3_8_0.js +232 -0
  53. package/dist/config/knex/enhancements/20251109020000_fix_missing_help_actions_v3_8_0.js.map +1 -0
  54. package/dist/config/knex/upgrades/20251104000000_add_multi_project_v3_7_0.d.ts.map +1 -1
  55. package/dist/config/knex/upgrades/20251104000000_add_multi_project_v3_7_0.js +9 -0
  56. package/dist/config/knex/upgrades/20251104000000_add_multi_project_v3_7_0.js.map +1 -1
  57. package/dist/config/knex/upgrades/20251108000000_hotfix_v_tagged_constraints_project_id.d.ts +14 -0
  58. package/dist/config/knex/upgrades/20251108000000_hotfix_v_tagged_constraints_project_id.d.ts.map +1 -0
  59. package/dist/config/knex/upgrades/20251108000000_hotfix_v_tagged_constraints_project_id.js +97 -0
  60. package/dist/config/knex/upgrades/20251108000000_hotfix_v_tagged_constraints_project_id.js.map +1 -0
  61. package/dist/config/knex/upgrades/20251109000002_multi_project_cross_db_compat_v3_7_5.d.ts +24 -0
  62. package/dist/config/knex/upgrades/20251109000002_multi_project_cross_db_compat_v3_7_5.d.ts.map +1 -0
  63. package/dist/config/knex/upgrades/20251109000002_multi_project_cross_db_compat_v3_7_5.js +303 -0
  64. package/dist/config/knex/upgrades/20251109000002_multi_project_cross_db_compat_v3_7_5.js.map +1 -0
  65. package/dist/constants.d.ts +14 -2
  66. package/dist/constants.d.ts.map +1 -1
  67. package/dist/constants.js +28 -1
  68. package/dist/constants.js.map +1 -1
  69. package/dist/database/config/adapter-factory.d.ts +13 -0
  70. package/dist/database/config/adapter-factory.d.ts.map +1 -0
  71. package/dist/database/config/adapter-factory.js +21 -0
  72. package/dist/database/config/adapter-factory.js.map +1 -0
  73. package/dist/database/config/config-ops.d.ts +34 -0
  74. package/dist/database/config/config-ops.d.ts.map +1 -0
  75. package/dist/database/config/config-ops.js +76 -0
  76. package/dist/database/config/config-ops.js.map +1 -0
  77. package/dist/database/index.d.ts +21 -0
  78. package/dist/database/index.d.ts.map +1 -0
  79. package/dist/database/index.js +31 -0
  80. package/dist/database/index.js.map +1 -0
  81. package/dist/database/initialization/cleanup.d.ts +8 -0
  82. package/dist/database/initialization/cleanup.d.ts.map +1 -0
  83. package/dist/database/initialization/cleanup.js +17 -0
  84. package/dist/database/initialization/cleanup.js.map +1 -0
  85. package/dist/database/initialization/init.d.ts +21 -0
  86. package/dist/database/initialization/init.d.ts.map +1 -0
  87. package/dist/database/initialization/init.js +83 -0
  88. package/dist/database/initialization/init.js.map +1 -0
  89. package/dist/database/operations/deletes.d.ts +10 -0
  90. package/dist/database/operations/deletes.d.ts.map +1 -0
  91. package/dist/database/operations/deletes.js +14 -0
  92. package/dist/database/operations/deletes.js.map +1 -0
  93. package/dist/database/operations/inserts.d.ts +40 -0
  94. package/dist/database/operations/inserts.d.ts.map +1 -0
  95. package/dist/database/operations/inserts.js +202 -0
  96. package/dist/database/operations/inserts.js.map +1 -0
  97. package/dist/database/operations/queries.d.ts +57 -0
  98. package/dist/database/operations/queries.d.ts.map +1 -0
  99. package/dist/database/operations/queries.js +77 -0
  100. package/dist/database/operations/queries.js.map +1 -0
  101. package/dist/database/operations/updates.d.ts +10 -0
  102. package/dist/database/operations/updates.d.ts.map +1 -0
  103. package/dist/database/operations/updates.js +14 -0
  104. package/dist/database/operations/updates.js.map +1 -0
  105. package/dist/database/types.d.ts +5 -0
  106. package/dist/database/types.d.ts.map +1 -0
  107. package/dist/database/types.js +5 -0
  108. package/dist/database/types.js.map +1 -0
  109. package/dist/database.d.ts +4 -144
  110. package/dist/database.d.ts.map +1 -1
  111. package/dist/database.js +5 -461
  112. package/dist/database.js.map +1 -1
  113. package/dist/index.js +29 -777
  114. package/dist/index.js.map +1 -1
  115. package/dist/server/arg-parser.d.ts +40 -0
  116. package/dist/server/arg-parser.d.ts.map +1 -0
  117. package/dist/server/arg-parser.js +137 -0
  118. package/dist/server/arg-parser.js.map +1 -0
  119. package/dist/server/setup.d.ts +31 -0
  120. package/dist/server/setup.d.ts.map +1 -0
  121. package/dist/server/setup.js +186 -0
  122. package/dist/server/setup.js.map +1 -0
  123. package/dist/server/shutdown.d.ts +15 -0
  124. package/dist/server/shutdown.d.ts.map +1 -0
  125. package/dist/server/shutdown.js +42 -0
  126. package/dist/server/shutdown.js.map +1 -0
  127. package/dist/server/tool-handlers.d.ts +10 -0
  128. package/dist/server/tool-handlers.d.ts.map +1 -0
  129. package/dist/server/tool-handlers.js +478 -0
  130. package/dist/server/tool-handlers.js.map +1 -0
  131. package/dist/server/tool-registry.d.ts +11 -0
  132. package/dist/server/tool-registry.d.ts.map +1 -0
  133. package/dist/server/tool-registry.js +225 -0
  134. package/dist/server/tool-registry.js.map +1 -0
  135. package/dist/tests/all-features.test.js +6 -38
  136. package/dist/tests/all-features.test.js.map +1 -1
  137. package/dist/tests/batch-validation-comprehensive.test.d.ts +12 -0
  138. package/dist/tests/batch-validation-comprehensive.test.d.ts.map +1 -0
  139. package/dist/tests/batch-validation-comprehensive.test.js +472 -0
  140. package/dist/tests/batch-validation-comprehensive.test.js.map +1 -0
  141. package/dist/tests/batch-validation-integration.test.d.ts +6 -0
  142. package/dist/tests/batch-validation-integration.test.d.ts.map +1 -0
  143. package/dist/tests/batch-validation-integration.test.js +193 -0
  144. package/dist/tests/batch-validation-integration.test.js.map +1 -0
  145. package/dist/tests/batch-validation.test.d.ts +6 -0
  146. package/dist/tests/batch-validation.test.d.ts.map +1 -0
  147. package/dist/tests/batch-validation.test.js +298 -0
  148. package/dist/tests/batch-validation.test.js.map +1 -0
  149. package/dist/tests/context-modular.test.d.ts +7 -0
  150. package/dist/tests/context-modular.test.d.ts.map +1 -0
  151. package/dist/tests/context-modular.test.js +271 -0
  152. package/dist/tests/context-modular.test.js.map +1 -0
  153. package/dist/tests/decision-batch-validation.test.d.ts +6 -0
  154. package/dist/tests/decision-batch-validation.test.d.ts.map +1 -0
  155. package/dist/tests/decision-batch-validation.test.js +253 -0
  156. package/dist/tests/decision-batch-validation.test.js.map +1 -0
  157. package/dist/tests/help-system.test.js +1 -1
  158. package/dist/tests/help-system.test.js.map +1 -1
  159. package/dist/tests/migrations/test-all-versions-real.js +3 -2
  160. package/dist/tests/migrations/test-all-versions-real.js.map +1 -1
  161. package/dist/tests/multi-project.test.js +2 -2
  162. package/dist/tests/multi-project.test.js.map +1 -1
  163. package/dist/tests/parameter-validation.test.js +2 -16
  164. package/dist/tests/parameter-validation.test.js.map +1 -1
  165. package/dist/tests/tasks.auto-pruning-decision-link.test.js +1 -1
  166. package/dist/tests/tasks.auto-pruning-decision-link.test.js.map +1 -1
  167. package/dist/tests/tasks.file-actions-integration.test.d.ts +10 -0
  168. package/dist/tests/tasks.file-actions-integration.test.d.ts.map +1 -0
  169. package/dist/tests/tasks.file-actions-integration.test.js +162 -0
  170. package/dist/tests/tasks.file-actions-integration.test.js.map +1 -0
  171. package/dist/tests/tasks.file-actions-validation.test.d.ts +6 -0
  172. package/dist/tests/tasks.file-actions-validation.test.d.ts.map +1 -0
  173. package/dist/tests/tasks.file-actions-validation.test.js +221 -0
  174. package/dist/tests/tasks.file-actions-validation.test.js.map +1 -0
  175. package/dist/tools/constraints/actions/add.d.ts +15 -0
  176. package/dist/tools/constraints/actions/add.d.ts.map +1 -0
  177. package/dist/tools/constraints/actions/add.js +101 -0
  178. package/dist/tools/constraints/actions/add.js.map +1 -0
  179. package/dist/tools/constraints/actions/deactivate.d.ts +16 -0
  180. package/dist/tools/constraints/actions/deactivate.d.ts.map +1 -0
  181. package/dist/tools/constraints/actions/deactivate.js +49 -0
  182. package/dist/tools/constraints/actions/deactivate.js.map +1 -0
  183. package/dist/tools/constraints/actions/get.d.ts +16 -0
  184. package/dist/tools/constraints/actions/get.d.ts.map +1 -0
  185. package/dist/tools/constraints/actions/get.js +76 -0
  186. package/dist/tools/constraints/actions/get.js.map +1 -0
  187. package/dist/tools/constraints/help/example.d.ts +9 -0
  188. package/dist/tools/constraints/help/example.d.ts.map +1 -0
  189. package/dist/tools/constraints/help/example.js +144 -0
  190. package/dist/tools/constraints/help/example.js.map +1 -0
  191. package/dist/tools/constraints/help/help.d.ts +9 -0
  192. package/dist/tools/constraints/help/help.d.ts.map +1 -0
  193. package/dist/tools/constraints/help/help.js +31 -0
  194. package/dist/tools/constraints/help/help.js.map +1 -0
  195. package/dist/tools/constraints/index.d.ts +12 -0
  196. package/dist/tools/constraints/index.d.ts.map +1 -0
  197. package/dist/tools/constraints/index.js +13 -0
  198. package/dist/tools/constraints/index.js.map +1 -0
  199. package/dist/tools/constraints/internal/validation.d.ts +11 -0
  200. package/dist/tools/constraints/internal/validation.d.ts.map +1 -0
  201. package/dist/tools/constraints/internal/validation.js +17 -0
  202. package/dist/tools/constraints/internal/validation.js.map +1 -0
  203. package/dist/tools/constraints/types.d.ts +6 -0
  204. package/dist/tools/constraints/types.d.ts.map +1 -0
  205. package/dist/tools/constraints/types.js +6 -0
  206. package/dist/tools/constraints/types.js.map +1 -0
  207. package/dist/tools/context/actions/add-context.d.ts +14 -0
  208. package/dist/tools/context/actions/add-context.d.ts.map +1 -0
  209. package/dist/tools/context/actions/add-context.js +62 -0
  210. package/dist/tools/context/actions/add-context.js.map +1 -0
  211. package/dist/tools/context/actions/batch-set.d.ts +16 -0
  212. package/dist/tools/context/actions/batch-set.d.ts.map +1 -0
  213. package/dist/tools/context/actions/batch-set.js +126 -0
  214. package/dist/tools/context/actions/batch-set.js.map +1 -0
  215. package/dist/tools/context/actions/create-template.d.ts +15 -0
  216. package/dist/tools/context/actions/create-template.d.ts.map +1 -0
  217. package/dist/tools/context/actions/create-template.js +68 -0
  218. package/dist/tools/context/actions/create-template.js.map +1 -0
  219. package/dist/tools/context/actions/get.d.ts +18 -0
  220. package/dist/tools/context/actions/get.d.ts.map +1 -0
  221. package/dist/tools/context/actions/get.js +80 -0
  222. package/dist/tools/context/actions/get.js.map +1 -0
  223. package/dist/tools/context/actions/hard-delete.d.ts +18 -0
  224. package/dist/tools/context/actions/hard-delete.d.ts.map +1 -0
  225. package/dist/tools/context/actions/hard-delete.js +85 -0
  226. package/dist/tools/context/actions/hard-delete.js.map +1 -0
  227. package/dist/tools/context/actions/has-updates.d.ts +16 -0
  228. package/dist/tools/context/actions/has-updates.d.ts.map +1 -0
  229. package/dist/tools/context/actions/has-updates.js +83 -0
  230. package/dist/tools/context/actions/has-updates.js.map +1 -0
  231. package/dist/tools/context/actions/list-contexts.d.ts +14 -0
  232. package/dist/tools/context/actions/list-contexts.d.ts.map +1 -0
  233. package/dist/tools/context/actions/list-contexts.js +43 -0
  234. package/dist/tools/context/actions/list-contexts.js.map +1 -0
  235. package/dist/tools/context/actions/list-templates.d.ts +15 -0
  236. package/dist/tools/context/actions/list-templates.d.ts.map +1 -0
  237. package/dist/tools/context/actions/list-templates.js +47 -0
  238. package/dist/tools/context/actions/list-templates.js.map +1 -0
  239. package/dist/tools/context/actions/list.d.ts +16 -0
  240. package/dist/tools/context/actions/list.d.ts.map +1 -0
  241. package/dist/tools/context/actions/list.js +100 -0
  242. package/dist/tools/context/actions/list.js.map +1 -0
  243. package/dist/tools/context/actions/quick-set.d.ts +21 -0
  244. package/dist/tools/context/actions/quick-set.d.ts.map +1 -0
  245. package/dist/tools/context/actions/quick-set.js +104 -0
  246. package/dist/tools/context/actions/quick-set.js.map +1 -0
  247. package/dist/tools/context/actions/search-advanced.d.ts +15 -0
  248. package/dist/tools/context/actions/search-advanced.d.ts.map +1 -0
  249. package/dist/tools/context/actions/search-advanced.js +140 -0
  250. package/dist/tools/context/actions/search-advanced.js.map +1 -0
  251. package/dist/tools/context/actions/search-layer.d.ts +15 -0
  252. package/dist/tools/context/actions/search-layer.d.ts.map +1 -0
  253. package/dist/tools/context/actions/search-layer.js +106 -0
  254. package/dist/tools/context/actions/search-layer.js.map +1 -0
  255. package/dist/tools/context/actions/search-tags.d.ts +15 -0
  256. package/dist/tools/context/actions/search-tags.d.ts.map +1 -0
  257. package/dist/tools/context/actions/search-tags.js +85 -0
  258. package/dist/tools/context/actions/search-tags.js.map +1 -0
  259. package/dist/tools/context/actions/set-from-template.d.ts +16 -0
  260. package/dist/tools/context/actions/set-from-template.d.ts.map +1 -0
  261. package/dist/tools/context/actions/set-from-template.js +83 -0
  262. package/dist/tools/context/actions/set-from-template.js.map +1 -0
  263. package/dist/tools/context/actions/set.d.ts +16 -0
  264. package/dist/tools/context/actions/set.d.ts.map +1 -0
  265. package/dist/tools/context/actions/set.js +56 -0
  266. package/dist/tools/context/actions/set.js.map +1 -0
  267. package/dist/tools/context/actions/versions.d.ts +15 -0
  268. package/dist/tools/context/actions/versions.d.ts.map +1 -0
  269. package/dist/tools/context/actions/versions.js +69 -0
  270. package/dist/tools/context/actions/versions.js.map +1 -0
  271. package/dist/tools/context/help/example.d.ts +5 -0
  272. package/dist/tools/context/help/example.d.ts.map +1 -0
  273. package/dist/tools/context/help/example.js +96 -0
  274. package/dist/tools/context/help/example.js.map +1 -0
  275. package/dist/tools/context/help/help.d.ts +5 -0
  276. package/dist/tools/context/help/help.d.ts.map +1 -0
  277. package/dist/tools/context/help/help.js +65 -0
  278. package/dist/tools/context/help/help.js.map +1 -0
  279. package/dist/tools/context/index.d.ts +25 -0
  280. package/dist/tools/context/index.d.ts.map +1 -0
  281. package/dist/tools/context/index.js +26 -0
  282. package/dist/tools/context/index.js.map +1 -0
  283. package/dist/tools/context/internal/queries.d.ts +18 -0
  284. package/dist/tools/context/internal/queries.d.ts.map +1 -0
  285. package/dist/tools/context/internal/queries.js +160 -0
  286. package/dist/tools/context/internal/queries.js.map +1 -0
  287. package/dist/tools/context/internal/validation.d.ts +39 -0
  288. package/dist/tools/context/internal/validation.d.ts.map +1 -0
  289. package/dist/tools/context/internal/validation.js +125 -0
  290. package/dist/tools/context/internal/validation.js.map +1 -0
  291. package/dist/tools/context/types.d.ts +6 -0
  292. package/dist/tools/context/types.d.ts.map +1 -0
  293. package/dist/tools/context/types.js +6 -0
  294. package/dist/tools/context/types.js.map +1 -0
  295. package/dist/tools/example/actions/get.d.ts +14 -0
  296. package/dist/tools/example/actions/get.d.ts.map +1 -0
  297. package/dist/tools/example/actions/get.js +40 -0
  298. package/dist/tools/example/actions/get.js.map +1 -0
  299. package/dist/tools/example/actions/list-all.d.ts +13 -0
  300. package/dist/tools/example/actions/list-all.d.ts.map +1 -0
  301. package/dist/tools/example/actions/list-all.js +39 -0
  302. package/dist/tools/example/actions/list-all.js.map +1 -0
  303. package/dist/tools/example/actions/search.d.ts +14 -0
  304. package/dist/tools/example/actions/search.d.ts.map +1 -0
  305. package/dist/tools/example/actions/search.js +52 -0
  306. package/dist/tools/example/actions/search.js.map +1 -0
  307. package/dist/tools/example/help/example.d.ts +6 -0
  308. package/dist/tools/example/help/example.d.ts.map +1 -0
  309. package/dist/tools/example/help/example.js +69 -0
  310. package/dist/tools/example/help/example.js.map +1 -0
  311. package/dist/tools/example/help/help.d.ts +6 -0
  312. package/dist/tools/example/help/help.d.ts.map +1 -0
  313. package/dist/tools/example/help/help.js +133 -0
  314. package/dist/tools/example/help/help.js.map +1 -0
  315. package/dist/tools/example/index.d.ts +11 -0
  316. package/dist/tools/example/index.d.ts.map +1 -0
  317. package/dist/tools/example/index.js +12 -0
  318. package/dist/tools/example/index.js.map +1 -0
  319. package/dist/tools/example/types.d.ts +59 -0
  320. package/dist/tools/example/types.d.ts.map +1 -0
  321. package/dist/tools/example/types.js +6 -0
  322. package/dist/tools/example/types.js.map +1 -0
  323. package/dist/tools/files/actions/check-lock.d.ts +16 -0
  324. package/dist/tools/files/actions/check-lock.d.ts.map +1 -0
  325. package/dist/tools/files/actions/check-lock.js +70 -0
  326. package/dist/tools/files/actions/check-lock.js.map +1 -0
  327. package/dist/tools/files/actions/get.d.ts +16 -0
  328. package/dist/tools/files/actions/get.d.ts.map +1 -0
  329. package/dist/tools/files/actions/get.js +113 -0
  330. package/dist/tools/files/actions/get.js.map +1 -0
  331. package/dist/tools/files/actions/record-batch.d.ts +18 -0
  332. package/dist/tools/files/actions/record-batch.d.ts.map +1 -0
  333. package/dist/tools/files/actions/record-batch.js +114 -0
  334. package/dist/tools/files/actions/record-batch.js.map +1 -0
  335. package/dist/tools/files/actions/record.d.ts +16 -0
  336. package/dist/tools/files/actions/record.d.ts.map +1 -0
  337. package/dist/tools/files/actions/record.js +37 -0
  338. package/dist/tools/files/actions/record.js.map +1 -0
  339. package/dist/tools/files/actions/sqlite-flush.d.ts +27 -0
  340. package/dist/tools/files/actions/sqlite-flush.d.ts.map +1 -0
  341. package/dist/tools/files/actions/sqlite-flush.js +66 -0
  342. package/dist/tools/files/actions/sqlite-flush.js.map +1 -0
  343. package/dist/tools/files/help/example.d.ts +5 -0
  344. package/dist/tools/files/help/example.d.ts.map +1 -0
  345. package/dist/tools/files/help/example.js +98 -0
  346. package/dist/tools/files/help/example.js.map +1 -0
  347. package/dist/tools/files/help/help.d.ts +5 -0
  348. package/dist/tools/files/help/help.d.ts.map +1 -0
  349. package/dist/tools/files/help/help.js +29 -0
  350. package/dist/tools/files/help/help.js.map +1 -0
  351. package/dist/tools/files/index.d.ts +14 -0
  352. package/dist/tools/files/index.d.ts.map +1 -0
  353. package/dist/tools/files/index.js +15 -0
  354. package/dist/tools/files/index.js.map +1 -0
  355. package/dist/tools/files/internal/queries.d.ts +18 -0
  356. package/dist/tools/files/internal/queries.d.ts.map +1 -0
  357. package/dist/tools/files/internal/queries.js +63 -0
  358. package/dist/tools/files/internal/queries.js.map +1 -0
  359. package/dist/tools/files/internal/validation.d.ts +18 -0
  360. package/dist/tools/files/internal/validation.d.ts.map +1 -0
  361. package/dist/tools/files/internal/validation.js +40 -0
  362. package/dist/tools/files/internal/validation.js.map +1 -0
  363. package/dist/tools/files/types.d.ts +6 -0
  364. package/dist/tools/files/types.d.ts.map +1 -0
  365. package/dist/tools/files/types.js +6 -0
  366. package/dist/tools/files/types.js.map +1 -0
  367. package/dist/tools/help/actions/batch-guide.d.ts +14 -0
  368. package/dist/tools/help/actions/batch-guide.d.ts.map +1 -0
  369. package/dist/tools/help/actions/batch-guide.js +59 -0
  370. package/dist/tools/help/actions/batch-guide.js.map +1 -0
  371. package/dist/tools/help/actions/error-recovery.d.ts +12 -0
  372. package/dist/tools/help/actions/error-recovery.d.ts.map +1 -0
  373. package/dist/tools/help/actions/error-recovery.js +107 -0
  374. package/dist/tools/help/actions/error-recovery.js.map +1 -0
  375. package/dist/tools/help/actions/query-action.d.ts +15 -0
  376. package/dist/tools/help/actions/query-action.d.ts.map +1 -0
  377. package/dist/tools/help/actions/query-action.js +15 -0
  378. package/dist/tools/help/actions/query-action.js.map +1 -0
  379. package/dist/tools/help/actions/query-params.d.ts +15 -0
  380. package/dist/tools/help/actions/query-params.d.ts.map +1 -0
  381. package/dist/tools/help/actions/query-params.js +15 -0
  382. package/dist/tools/help/actions/query-params.js.map +1 -0
  383. package/dist/tools/help/actions/query-tool.d.ts +15 -0
  384. package/dist/tools/help/actions/query-tool.d.ts.map +1 -0
  385. package/dist/tools/help/actions/query-tool.js +15 -0
  386. package/dist/tools/help/actions/query-tool.js.map +1 -0
  387. package/dist/tools/help/actions/workflow-hints.d.ts +14 -0
  388. package/dist/tools/help/actions/workflow-hints.d.ts.map +1 -0
  389. package/dist/tools/help/actions/workflow-hints.js +15 -0
  390. package/dist/tools/help/actions/workflow-hints.js.map +1 -0
  391. package/dist/tools/help/help/example.d.ts +6 -0
  392. package/dist/tools/help/help/example.d.ts.map +1 -0
  393. package/dist/tools/help/help/example.js +70 -0
  394. package/dist/tools/help/help/example.js.map +1 -0
  395. package/dist/tools/help/help/help.d.ts +6 -0
  396. package/dist/tools/help/help/help.d.ts.map +1 -0
  397. package/dist/tools/help/help/help.js +67 -0
  398. package/dist/tools/help/help/help.js.map +1 -0
  399. package/dist/tools/help/index.d.ts +14 -0
  400. package/dist/tools/help/index.d.ts.map +1 -0
  401. package/dist/tools/help/index.js +15 -0
  402. package/dist/tools/help/index.js.map +1 -0
  403. package/dist/tools/help/types.d.ts +92 -0
  404. package/dist/tools/help/types.d.ts.map +1 -0
  405. package/dist/tools/help/types.js +6 -0
  406. package/dist/tools/help/types.js.map +1 -0
  407. package/dist/tools/help-queries.d.ts.map +1 -1
  408. package/dist/tools/help-queries.js +1 -0
  409. package/dist/tools/help-queries.js.map +1 -1
  410. package/dist/tools/tasks/actions/add-dependency.d.ts +12 -0
  411. package/dist/tools/tasks/actions/add-dependency.d.ts.map +1 -0
  412. package/dist/tools/tasks/actions/add-dependency.js +124 -0
  413. package/dist/tools/tasks/actions/add-dependency.js.map +1 -0
  414. package/dist/tools/tasks/actions/archive.d.ts +11 -0
  415. package/dist/tools/tasks/actions/archive.d.ts.map +1 -0
  416. package/dist/tools/tasks/actions/archive.js +67 -0
  417. package/dist/tools/tasks/actions/archive.js.map +1 -0
  418. package/dist/tools/tasks/actions/create-batch.d.ts +19 -0
  419. package/dist/tools/tasks/actions/create-batch.d.ts.map +1 -0
  420. package/dist/tools/tasks/actions/create-batch.js +103 -0
  421. package/dist/tools/tasks/actions/create-batch.js.map +1 -0
  422. package/dist/tools/tasks/actions/create.d.ts +16 -0
  423. package/dist/tools/tasks/actions/create.d.ts.map +1 -0
  424. package/dist/tools/tasks/actions/create.js +180 -0
  425. package/dist/tools/tasks/actions/create.js.map +1 -0
  426. package/dist/tools/tasks/actions/get-dependencies.d.ts +12 -0
  427. package/dist/tools/tasks/actions/get-dependencies.d.ts.map +1 -0
  428. package/dist/tools/tasks/actions/get-dependencies.js +41 -0
  429. package/dist/tools/tasks/actions/get-dependencies.js.map +1 -0
  430. package/dist/tools/tasks/actions/get-pruned-files.d.ts +13 -0
  431. package/dist/tools/tasks/actions/get-pruned-files.d.ts.map +1 -0
  432. package/dist/tools/tasks/actions/get-pruned-files.js +45 -0
  433. package/dist/tools/tasks/actions/get-pruned-files.js.map +1 -0
  434. package/dist/tools/tasks/actions/get.d.ts +12 -0
  435. package/dist/tools/tasks/actions/get.d.ts.map +1 -0
  436. package/dist/tools/tasks/actions/get.js +88 -0
  437. package/dist/tools/tasks/actions/get.js.map +1 -0
  438. package/dist/tools/tasks/actions/link-pruned-file.d.ts +13 -0
  439. package/dist/tools/tasks/actions/link-pruned-file.d.ts.map +1 -0
  440. package/dist/tools/tasks/actions/link-pruned-file.js +63 -0
  441. package/dist/tools/tasks/actions/link-pruned-file.js.map +1 -0
  442. package/dist/tools/tasks/actions/link.d.ts +14 -0
  443. package/dist/tools/tasks/actions/link.d.ts.map +1 -0
  444. package/dist/tools/tasks/actions/link.js +118 -0
  445. package/dist/tools/tasks/actions/link.js.map +1 -0
  446. package/dist/tools/tasks/actions/list.d.ts +17 -0
  447. package/dist/tools/tasks/actions/list.d.ts.map +1 -0
  448. package/dist/tools/tasks/actions/list.js +98 -0
  449. package/dist/tools/tasks/actions/list.js.map +1 -0
  450. package/dist/tools/tasks/actions/move.d.ts +12 -0
  451. package/dist/tools/tasks/actions/move.d.ts.map +1 -0
  452. package/dist/tools/tasks/actions/move.js +91 -0
  453. package/dist/tools/tasks/actions/move.js.map +1 -0
  454. package/dist/tools/tasks/actions/remove-dependency.d.ts +12 -0
  455. package/dist/tools/tasks/actions/remove-dependency.d.ts.map +1 -0
  456. package/dist/tools/tasks/actions/remove-dependency.js +36 -0
  457. package/dist/tools/tasks/actions/remove-dependency.js.map +1 -0
  458. package/dist/tools/tasks/actions/update.d.ts +10 -0
  459. package/dist/tools/tasks/actions/update.d.ts.map +1 -0
  460. package/dist/tools/tasks/actions/update.js +186 -0
  461. package/dist/tools/tasks/actions/update.js.map +1 -0
  462. package/dist/tools/tasks/actions/watch-files.d.ts +14 -0
  463. package/dist/tools/tasks/actions/watch-files.d.ts.map +1 -0
  464. package/dist/tools/tasks/actions/watch-files.js +127 -0
  465. package/dist/tools/tasks/actions/watch-files.js.map +1 -0
  466. package/dist/tools/tasks/help/example.d.ts +8 -0
  467. package/dist/tools/tasks/help/example.d.ts.map +1 -0
  468. package/dist/tools/tasks/help/example.js +215 -0
  469. package/dist/tools/tasks/help/example.js.map +1 -0
  470. package/dist/tools/tasks/help/help.d.ts +8 -0
  471. package/dist/tools/tasks/help/help.d.ts.map +1 -0
  472. package/dist/tools/tasks/help/help.js +293 -0
  473. package/dist/tools/tasks/help/help.js.map +1 -0
  474. package/dist/tools/tasks/help/use-case.d.ts +11 -0
  475. package/dist/tools/tasks/help/use-case.d.ts.map +1 -0
  476. package/dist/tools/tasks/help/use-case.js +768 -0
  477. package/dist/tools/tasks/help/use-case.js.map +1 -0
  478. package/dist/tools/tasks/index.d.ts +28 -0
  479. package/dist/tools/tasks/index.d.ts.map +1 -0
  480. package/dist/tools/tasks/index.js +33 -0
  481. package/dist/tools/tasks/index.js.map +1 -0
  482. package/dist/tools/tasks/internal/state-machine.d.ts +16 -0
  483. package/dist/tools/tasks/internal/state-machine.d.ts.map +1 -0
  484. package/dist/tools/tasks/internal/state-machine.js +36 -0
  485. package/dist/tools/tasks/internal/state-machine.js.map +1 -0
  486. package/dist/tools/tasks/internal/task-queries.d.ts +12 -0
  487. package/dist/tools/tasks/internal/task-queries.d.ts.map +1 -0
  488. package/dist/tools/tasks/internal/task-queries.js +61 -0
  489. package/dist/tools/tasks/internal/task-queries.js.map +1 -0
  490. package/dist/tools/tasks/internal/validation.d.ts +47 -0
  491. package/dist/tools/tasks/internal/validation.d.ts.map +1 -0
  492. package/dist/tools/tasks/internal/validation.js +261 -0
  493. package/dist/tools/tasks/internal/validation.js.map +1 -0
  494. package/dist/tools/tasks/types.d.ts +68 -0
  495. package/dist/tools/tasks/types.d.ts.map +1 -0
  496. package/dist/tools/tasks/types.js +45 -0
  497. package/dist/tools/tasks/types.js.map +1 -0
  498. package/dist/tools/tasks/watcher/status.d.ts +9 -0
  499. package/dist/tools/tasks/watcher/status.d.ts.map +1 -0
  500. package/dist/tools/tasks/watcher/status.js +126 -0
  501. package/dist/tools/tasks/watcher/status.js.map +1 -0
  502. package/dist/tools/tasks.d.ts +12 -148
  503. package/dist/tools/tasks.d.ts.map +1 -1
  504. package/dist/tools/tasks.js +12 -2037
  505. package/dist/tools/tasks.js.map +1 -1
  506. package/dist/tools/use_case/actions/get.d.ts +14 -0
  507. package/dist/tools/use_case/actions/get.d.ts.map +1 -0
  508. package/dist/tools/use_case/actions/get.js +15 -0
  509. package/dist/tools/use_case/actions/get.js.map +1 -0
  510. package/dist/tools/use_case/actions/list-all.d.ts +15 -0
  511. package/dist/tools/use_case/actions/list-all.d.ts.map +1 -0
  512. package/dist/tools/use_case/actions/list-all.js +20 -0
  513. package/dist/tools/use_case/actions/list-all.js.map +1 -0
  514. package/dist/tools/use_case/actions/search.d.ts +14 -0
  515. package/dist/tools/use_case/actions/search.d.ts.map +1 -0
  516. package/dist/tools/use_case/actions/search.js +87 -0
  517. package/dist/tools/use_case/actions/search.js.map +1 -0
  518. package/dist/tools/use_case/help/example.d.ts +105 -0
  519. package/dist/tools/use_case/help/example.d.ts.map +1 -0
  520. package/dist/tools/use_case/help/example.js +138 -0
  521. package/dist/tools/use_case/help/example.js.map +1 -0
  522. package/dist/tools/use_case/help/help.d.ts +33 -0
  523. package/dist/tools/use_case/help/help.d.ts.map +1 -0
  524. package/dist/tools/use_case/help/help.js +109 -0
  525. package/dist/tools/use_case/help/help.js.map +1 -0
  526. package/dist/tools/use_case/index.d.ts +11 -0
  527. package/dist/tools/use_case/index.d.ts.map +1 -0
  528. package/dist/tools/use_case/index.js +12 -0
  529. package/dist/tools/use_case/index.js.map +1 -0
  530. package/dist/tools/use_case/types.d.ts +58 -0
  531. package/dist/tools/use_case/types.d.ts.map +1 -0
  532. package/dist/tools/use_case/types.js +6 -0
  533. package/dist/tools/use_case/types.js.map +1 -0
  534. package/dist/types/actions.d.ts +37 -0
  535. package/dist/types/actions.d.ts.map +1 -0
  536. package/dist/types/actions.js +6 -0
  537. package/dist/types/actions.js.map +1 -0
  538. package/dist/types/constraint/params.d.ts +2 -0
  539. package/dist/types/constraint/params.d.ts.map +1 -0
  540. package/dist/types/constraint/params.js +2 -0
  541. package/dist/types/constraint/params.js.map +1 -0
  542. package/dist/types/constraint/responses.d.ts +2 -0
  543. package/dist/types/constraint/responses.d.ts.map +1 -0
  544. package/dist/types/constraint/responses.js +2 -0
  545. package/dist/types/constraint/responses.js.map +1 -0
  546. package/dist/types/decision/batch.d.ts +24 -0
  547. package/dist/types/decision/batch.d.ts.map +1 -0
  548. package/dist/types/decision/batch.js +5 -0
  549. package/dist/types/decision/batch.js.map +1 -0
  550. package/dist/types/decision/params.d.ts +73 -0
  551. package/dist/types/decision/params.d.ts.map +1 -0
  552. package/dist/types/decision/params.js +5 -0
  553. package/dist/types/decision/params.js.map +1 -0
  554. package/dist/types/decision/responses.d.ts +79 -0
  555. package/dist/types/decision/responses.d.ts.map +1 -0
  556. package/dist/types/decision/responses.js +5 -0
  557. package/dist/types/decision/responses.js.map +1 -0
  558. package/dist/types/decision/templates.d.ts +74 -0
  559. package/dist/types/decision/templates.d.ts.map +1 -0
  560. package/dist/types/decision/templates.js +5 -0
  561. package/dist/types/decision/templates.js.map +1 -0
  562. package/dist/types/enums.d.ts +43 -0
  563. package/dist/types/enums.d.ts.map +1 -0
  564. package/dist/types/enums.js +47 -0
  565. package/dist/types/enums.js.map +1 -0
  566. package/dist/types/file/params.d.ts +40 -0
  567. package/dist/types/file/params.d.ts.map +1 -0
  568. package/dist/types/file/params.js +6 -0
  569. package/dist/types/file/params.js.map +1 -0
  570. package/dist/types/file/responses.d.ts +2 -0
  571. package/dist/types/file/responses.d.ts.map +1 -0
  572. package/dist/types/file/responses.js +2 -0
  573. package/dist/types/file/responses.js.map +1 -0
  574. package/dist/types/import-export.d.ts +126 -0
  575. package/dist/types/import-export.d.ts.map +1 -0
  576. package/dist/types/import-export.js +6 -0
  577. package/dist/types/import-export.js.map +1 -0
  578. package/dist/types/index.d.ts +25 -0
  579. package/dist/types/index.d.ts.map +1 -0
  580. package/dist/types/index.js +35 -0
  581. package/dist/types/index.js.map +1 -0
  582. package/dist/types/master-entities.d.ts +33 -0
  583. package/dist/types/master-entities.d.ts.map +1 -0
  584. package/dist/types/master-entities.js +6 -0
  585. package/dist/types/master-entities.js.map +1 -0
  586. package/dist/types/task/params.d.ts +172 -0
  587. package/dist/types/task/params.d.ts.map +1 -0
  588. package/dist/types/task/params.js +8 -0
  589. package/dist/types/task/params.js.map +1 -0
  590. package/dist/types/task/responses.d.ts +334 -0
  591. package/dist/types/task/responses.d.ts.map +1 -0
  592. package/dist/types/task/responses.js +8 -0
  593. package/dist/types/task/responses.js.map +1 -0
  594. package/dist/types/transaction-entities.d.ts +89 -0
  595. package/dist/types/transaction-entities.d.ts.map +1 -0
  596. package/dist/types/transaction-entities.js +5 -0
  597. package/dist/types/transaction-entities.js.map +1 -0
  598. package/dist/types/validation.d.ts +44 -0
  599. package/dist/types/validation.d.ts.map +1 -0
  600. package/dist/types/validation.js +6 -0
  601. package/dist/types/validation.js.map +1 -0
  602. package/dist/types/view-entities.d.ts +61 -0
  603. package/dist/types/view-entities.d.ts.map +1 -0
  604. package/dist/types/view-entities.js +5 -0
  605. package/dist/types/view-entities.js.map +1 -0
  606. package/dist/types.d.ts +133 -10
  607. package/dist/types.d.ts.map +1 -1
  608. package/dist/utils/action-specs/config-specs.d.ts +10 -0
  609. package/dist/utils/action-specs/config-specs.d.ts.map +1 -0
  610. package/dist/utils/action-specs/config-specs.js +12 -0
  611. package/dist/utils/action-specs/config-specs.js.map +1 -0
  612. package/dist/utils/action-specs/constraint-specs.d.ts +9 -0
  613. package/dist/utils/action-specs/constraint-specs.d.ts.map +1 -0
  614. package/dist/utils/action-specs/constraint-specs.js +42 -0
  615. package/dist/utils/action-specs/constraint-specs.js.map +1 -0
  616. package/dist/utils/action-specs/decision-specs.d.ts +9 -0
  617. package/dist/utils/action-specs/decision-specs.d.ts.map +1 -0
  618. package/dist/utils/action-specs/decision-specs.js +194 -0
  619. package/dist/utils/action-specs/decision-specs.js.map +1 -0
  620. package/dist/utils/action-specs/file-specs.d.ts +9 -0
  621. package/dist/utils/action-specs/file-specs.d.ts.map +1 -0
  622. package/dist/utils/action-specs/file-specs.js +56 -0
  623. package/dist/utils/action-specs/file-specs.js.map +1 -0
  624. package/dist/utils/action-specs/index.d.ts +38 -0
  625. package/dist/utils/action-specs/index.d.ts.map +1 -0
  626. package/dist/utils/action-specs/index.js +63 -0
  627. package/dist/utils/action-specs/index.js.map +1 -0
  628. package/dist/utils/action-specs/task-specs.d.ts +9 -0
  629. package/dist/utils/action-specs/task-specs.d.ts.map +1 -0
  630. package/dist/utils/action-specs/task-specs.js +143 -0
  631. package/dist/utils/action-specs/task-specs.js.map +1 -0
  632. package/dist/utils/action-specs/types.d.ts +14 -0
  633. package/dist/utils/action-specs/types.d.ts.map +1 -0
  634. package/dist/utils/action-specs/types.js +9 -0
  635. package/dist/utils/action-specs/types.js.map +1 -0
  636. package/dist/utils/batch-validation.d.ts +156 -0
  637. package/dist/utils/batch-validation.d.ts.map +1 -0
  638. package/dist/utils/batch-validation.example.d.ts +48 -0
  639. package/dist/utils/batch-validation.example.d.ts.map +1 -0
  640. package/dist/utils/batch-validation.example.js +180 -0
  641. package/dist/utils/batch-validation.example.js.map +1 -0
  642. package/dist/utils/batch-validation.js +345 -0
  643. package/dist/utils/batch-validation.js.map +1 -0
  644. package/dist/utils/exporter/export.d.ts +100 -0
  645. package/dist/utils/exporter/export.d.ts.map +1 -0
  646. package/dist/utils/exporter/export.js +363 -0
  647. package/dist/utils/exporter/export.js.map +1 -0
  648. package/dist/utils/importer/import.d.ts +29 -0
  649. package/dist/utils/importer/import.d.ts.map +1 -0
  650. package/dist/utils/importer/import.js +514 -0
  651. package/dist/utils/importer/import.js.map +1 -0
  652. package/dist/utils/importer/master-tables.d.ts +18 -0
  653. package/dist/utils/importer/master-tables.d.ts.map +1 -0
  654. package/dist/utils/importer/master-tables.js +255 -0
  655. package/dist/utils/importer/master-tables.js.map +1 -0
  656. package/dist/utils/importer/topological-sort.d.ts +61 -0
  657. package/dist/utils/importer/topological-sort.d.ts.map +1 -0
  658. package/dist/utils/importer/topological-sort.js +143 -0
  659. package/dist/utils/importer/topological-sort.js.map +1 -0
  660. package/dist/utils/levenshtein.d.ts +18 -0
  661. package/dist/utils/levenshtein.d.ts.map +1 -0
  662. package/dist/utils/levenshtein.js +46 -0
  663. package/dist/utils/levenshtein.js.map +1 -0
  664. package/dist/utils/parameter-validator.d.ts +3 -3
  665. package/dist/utils/parameter-validator.d.ts.map +1 -1
  666. package/dist/utils/parameter-validator.js +3 -39
  667. package/dist/utils/parameter-validator.js.map +1 -1
  668. package/dist/utils/sql-dump/core/dependency-sort.d.ts +16 -0
  669. package/dist/utils/sql-dump/core/dependency-sort.d.ts.map +1 -0
  670. package/dist/utils/sql-dump/core/dependency-sort.js +105 -0
  671. package/dist/utils/sql-dump/core/dependency-sort.js.map +1 -0
  672. package/dist/utils/sql-dump/core/generate-dump.d.ts +13 -0
  673. package/dist/utils/sql-dump/core/generate-dump.d.ts.map +1 -0
  674. package/dist/utils/sql-dump/core/generate-dump.js +181 -0
  675. package/dist/utils/sql-dump/core/generate-dump.js.map +1 -0
  676. package/dist/utils/sql-dump/core/index-export.d.ts +9 -0
  677. package/dist/utils/sql-dump/core/index-export.d.ts.map +1 -0
  678. package/dist/utils/sql-dump/core/index-export.js +173 -0
  679. package/dist/utils/sql-dump/core/index-export.js.map +1 -0
  680. package/dist/utils/sql-dump/core/sequence-reset.d.ts +6 -0
  681. package/dist/utils/sql-dump/core/sequence-reset.d.ts.map +1 -0
  682. package/dist/utils/sql-dump/core/sequence-reset.js +28 -0
  683. package/dist/utils/sql-dump/core/sequence-reset.js.map +1 -0
  684. package/dist/utils/sql-dump/core/table-export.d.ts +2 -0
  685. package/dist/utils/sql-dump/core/table-export.d.ts.map +1 -0
  686. package/dist/utils/sql-dump/core/table-export.js +4 -0
  687. package/dist/utils/sql-dump/core/table-export.js.map +1 -0
  688. package/dist/utils/sql-dump/core/view-export.d.ts +2 -0
  689. package/dist/utils/sql-dump/core/view-export.d.ts.map +1 -0
  690. package/dist/utils/sql-dump/core/view-export.js +4 -0
  691. package/dist/utils/sql-dump/core/view-export.js.map +1 -0
  692. package/dist/utils/sql-dump/formatters/bulk-insert.d.ts +14 -0
  693. package/dist/utils/sql-dump/formatters/bulk-insert.d.ts.map +1 -0
  694. package/dist/utils/sql-dump/formatters/bulk-insert.js +177 -0
  695. package/dist/utils/sql-dump/formatters/bulk-insert.js.map +1 -0
  696. package/dist/utils/sql-dump/formatters/identifiers.d.ts +6 -0
  697. package/dist/utils/sql-dump/formatters/identifiers.d.ts.map +1 -0
  698. package/dist/utils/sql-dump/formatters/identifiers.js +16 -0
  699. package/dist/utils/sql-dump/formatters/identifiers.js.map +1 -0
  700. package/dist/utils/sql-dump/formatters/value-formatter.d.ts +14 -0
  701. package/dist/utils/sql-dump/formatters/value-formatter.d.ts.map +1 -0
  702. package/dist/utils/sql-dump/formatters/value-formatter.js +281 -0
  703. package/dist/utils/sql-dump/formatters/value-formatter.js.map +1 -0
  704. package/dist/utils/sql-dump/generators/controls.d.ts +10 -0
  705. package/dist/utils/sql-dump/generators/controls.d.ts.map +1 -0
  706. package/dist/utils/sql-dump/generators/controls.js +36 -0
  707. package/dist/utils/sql-dump/generators/controls.js.map +1 -0
  708. package/dist/utils/sql-dump/generators/headers.d.ts +6 -0
  709. package/dist/utils/sql-dump/generators/headers.d.ts.map +1 -0
  710. package/dist/utils/sql-dump/generators/headers.js +19 -0
  711. package/dist/utils/sql-dump/generators/headers.js.map +1 -0
  712. package/dist/utils/sql-dump/index.d.ts +14 -0
  713. package/dist/utils/sql-dump/index.d.ts.map +1 -0
  714. package/dist/utils/sql-dump/index.js +16 -0
  715. package/dist/utils/sql-dump/index.js.map +1 -0
  716. package/dist/utils/sql-dump/schema/indexes.d.ts +6 -0
  717. package/dist/utils/sql-dump/schema/indexes.d.ts.map +1 -0
  718. package/dist/utils/sql-dump/schema/indexes.js +42 -0
  719. package/dist/utils/sql-dump/schema/indexes.js.map +1 -0
  720. package/dist/utils/sql-dump/schema/primary-keys.d.ts +6 -0
  721. package/dist/utils/sql-dump/schema/primary-keys.d.ts.map +1 -0
  722. package/dist/utils/sql-dump/schema/primary-keys.js +41 -0
  723. package/dist/utils/sql-dump/schema/primary-keys.js.map +1 -0
  724. package/dist/utils/sql-dump/schema/tables.d.ts +12 -0
  725. package/dist/utils/sql-dump/schema/tables.d.ts.map +1 -0
  726. package/dist/utils/sql-dump/schema/tables.js +370 -0
  727. package/dist/utils/sql-dump/schema/tables.js.map +1 -0
  728. package/dist/utils/sql-dump/schema/views.d.ts +11 -0
  729. package/dist/utils/sql-dump/schema/views.d.ts.map +1 -0
  730. package/dist/utils/sql-dump/schema/views.js +110 -0
  731. package/dist/utils/sql-dump/schema/views.js.map +1 -0
  732. package/dist/utils/sql-dump/types.d.ts +10 -0
  733. package/dist/utils/sql-dump/types.d.ts.map +1 -0
  734. package/dist/utils/sql-dump/types.js +3 -0
  735. package/dist/utils/sql-dump/types.js.map +1 -0
  736. package/docs/AI_AGENT_GUIDE.md +2 -2
  737. package/docs/AUTO_FILE_TRACKING.md +0 -1
  738. package/docs/BATCH_VALIDATION.md +617 -0
  739. package/docs/DATABASE_AUTH.md +1 -2
  740. package/docs/DECISION_TO_TASK_MIGRATION_GUIDE.md +2 -2
  741. package/docs/SHARED_CONCEPTS.md +2 -2
  742. package/docs/SPECIALIZED_AGENTS.md +1 -1
  743. package/docs/TASK_ACTIONS.md +7 -7
  744. package/docs/TASK_MIGRATION.md +5 -5
  745. package/docs/TASK_SYSTEM.md +5 -5
  746. package/docs/TOOL_REFERENCE.md +1 -3
  747. package/docs/WORKFLOWS.md +1 -1
  748. package/docs/{DATABASE_MIGRATION.md → cli/DATABASE_MIGRATION.md} +71 -32
  749. package/docs/cli/DATA_EXPORT_IMPORT.md +400 -0
  750. package/docs/cli/README.md +227 -0
  751. package/package.json +7 -4
  752. package/dist/tools/config.d.ts +0 -58
  753. package/dist/tools/config.d.ts.map +0 -1
  754. package/dist/tools/config.js +0 -281
  755. package/dist/tools/config.js.map +0 -1
  756. package/dist/tools/constraints.d.ts +0 -49
  757. package/dist/tools/constraints.d.ts.map +0 -1
  758. package/dist/tools/constraints.js +0 -378
  759. package/dist/tools/constraints.js.map +0 -1
  760. package/dist/tools/context.d.ts +0 -208
  761. package/dist/tools/context.d.ts.map +0 -1
  762. package/dist/tools/context.js +0 -1661
  763. package/dist/tools/context.js.map +0 -1
  764. package/dist/tools/files.d.ts +0 -54
  765. package/dist/tools/files.d.ts.map +0 -1
  766. package/dist/tools/files.js +0 -478
  767. package/dist/tools/files.js.map +0 -1
  768. package/dist/tools/messaging.d.ts +0 -71
  769. package/dist/tools/messaging.d.ts.map +0 -1
  770. package/dist/tools/messaging.js +0 -483
  771. package/dist/tools/messaging.js.map +0 -1
  772. package/dist/tools/utils.d.ts +0 -70
  773. package/dist/tools/utils.d.ts.map +0 -1
  774. package/dist/tools/utils.js +0 -483
  775. package/dist/tools/utils.js.map +0 -1
  776. package/dist/utils/action-specs.d.ts +0 -46
  777. package/dist/utils/action-specs.d.ts.map +0 -1
  778. package/dist/utils/action-specs.js +0 -527
  779. package/dist/utils/action-specs.js.map +0 -1
  780. package/docs/BASEADAPTER_IMPLEMENTATION.md +0 -399
  781. package/docs/HELP_PREVIEW_COMPARISON.md +0 -259
  782. package/docs/MIGRATION_CHAIN.md +0 -293
  783. package/docs/MIGRATION_v2.md +0 -538
  784. package/docs/MIGRATION_v3.3.md +0 -602
  785. package/docs/MIGRATION_v3.6.0.md +0 -170
  786. package/docs/MULTI_PROJECT_ARCHITECTURE.md +0 -497
@@ -1,70 +0,0 @@
1
- /**
2
- * Utility tools for MCP Shared Context Server
3
- * Database statistics, layer summaries, and manual cleanup
4
- *
5
- * CONVERTED: Using Knex.js with DatabaseAdapter (async/await)
6
- * MULTI-PROJECT: All queries scoped by project_id (Constraint #38)
7
- */
8
- import { DatabaseAdapter } from '../adapters/index.js';
9
- import type { GetLayerSummaryResponse, ClearOldDataParams, ClearOldDataResponse, GetStatsResponse, GetActivityLogParams, GetActivityLogResponse, FlushWALResponse } from '../types.js';
10
- /**
11
- * Get summary statistics for all architecture layers
12
- * Uses the v_layer_summary view for token efficiency
13
- * PROJECT-SCOPED: Only returns data for current project (Constraint #38)
14
- *
15
- * @param adapter - Optional database adapter (for testing)
16
- * @returns Layer summaries for all 5 standard layers
17
- */
18
- export declare function getLayerSummary(adapter?: DatabaseAdapter): Promise<GetLayerSummaryResponse>;
19
- /**
20
- * Clear old data from the database
21
- * Deletes messages and file changes older than specified thresholds
22
- * Preserves decision_history, constraints, and core decisions
23
- * PROJECT-SCOPED: Only deletes data from current project (Constraint #40)
24
- *
25
- * If parameters are not provided, uses config-based weekend-aware retention.
26
- * If parameters are provided, they override m_config settings (no weekend-awareness).
27
- *
28
- * @param params - Optional parameters for cleanup thresholds (overrides config)
29
- * @param adapter - Optional database adapter (for testing)
30
- * @returns Counts of deleted records
31
- */
32
- export declare function clearOldData(params?: ClearOldDataParams, adapter?: DatabaseAdapter): Promise<ClearOldDataResponse>;
33
- /**
34
- * Get comprehensive database statistics
35
- * Returns counts for all major tables and database health metrics
36
- * PROJECT-SCOPED: Only returns counts for current project (Constraint #38)
37
- *
38
- * @param adapter - Optional database adapter (for testing)
39
- * @returns Complete database statistics
40
- */
41
- export declare function getStats(adapter?: DatabaseAdapter): Promise<GetStatsResponse>;
42
- /**
43
- * Get activity log entries with filtering
44
- * Supports time-based filtering (relative or absolute) and agent/action filtering
45
- * PROJECT-SCOPED: Only returns activity for current project (Constraint #38)
46
- *
47
- * @param params - Filter parameters (since, agent_names, actions, limit)
48
- * @param adapter - Optional database adapter (for testing)
49
- * @returns Activity log entries with parsed details
50
- */
51
- export declare function getActivityLog(params?: GetActivityLogParams, adapter?: DatabaseAdapter): Promise<GetActivityLogResponse>;
52
- /**
53
- * Force WAL checkpoint to flush pending transactions to main database file
54
- * Uses TRUNCATE mode for complete flush - useful before git commits
55
- *
56
- * @param adapter - Optional database adapter (for testing)
57
- * @returns Checkpoint result with pages flushed
58
- */
59
- export declare function flushWAL(adapter?: DatabaseAdapter): Promise<FlushWALResponse>;
60
- /**
61
- * Get help documentation for stats tool
62
- * @returns Help documentation object
63
- */
64
- export declare function statsHelp(): any;
65
- /**
66
- * Get comprehensive examples for stats tool
67
- * @returns Examples documentation object
68
- */
69
- export declare function statsExample(): any;
70
- //# sourceMappingURL=utils.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EAGtB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAOrB;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,uBAAuB,CAAC,CAyBlC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,MAAM,CAAC,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAkE/B;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,gBAAgB,CAAC,CA0H3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,MAAM,CAAC,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAiGjC;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,gBAAgB,CAAC,CA+B3B;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,GAAG,CA0B/B;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,GAAG,CAmGlC"}
@@ -1,483 +0,0 @@
1
- /**
2
- * Utility tools for MCP Shared Context Server
3
- * Database statistics, layer summaries, and manual cleanup
4
- *
5
- * CONVERTED: Using Knex.js with DatabaseAdapter (async/await)
6
- * MULTI-PROJECT: All queries scoped by project_id (Constraint #38)
7
- */
8
- import { getAdapter } from '../database.js';
9
- import { calculateFileChangeCutoff, releaseInactiveAgents } from '../utils/retention.js';
10
- import { cleanupWithCustomRetention } from '../utils/cleanup.js';
11
- import { validateActionParams } from '../utils/parameter-validator.js';
12
- import { getProjectContext } from '../utils/project-context.js';
13
- import connectionManager from '../utils/connection-manager.js';
14
- /**
15
- * Get summary statistics for all architecture layers
16
- * Uses the v_layer_summary view for token efficiency
17
- * PROJECT-SCOPED: Only returns data for current project (Constraint #38)
18
- *
19
- * @param adapter - Optional database adapter (for testing)
20
- * @returns Layer summaries for all 5 standard layers
21
- */
22
- export async function getLayerSummary(adapter) {
23
- const actualAdapter = adapter ?? getAdapter();
24
- const knex = actualAdapter.getKnex();
25
- try {
26
- // Validate parameters
27
- validateActionParams('stats', 'layer_summary', {});
28
- return await connectionManager.executeWithRetry(async () => {
29
- // Get current project ID (Constraint #38 - project-scoped by default)
30
- const projectId = getProjectContext().getProjectId();
31
- const summary = await knex('v_layer_summary')
32
- .select('layer', 'decisions_count', 'file_changes_count', 'constraints_count')
33
- .where('project_id', projectId)
34
- .orderBy('layer');
35
- return {
36
- summary,
37
- };
38
- });
39
- }
40
- catch (error) {
41
- const message = error instanceof Error ? error.message : String(error);
42
- throw new Error(`Failed to get layer summary: ${message}`);
43
- }
44
- }
45
- /**
46
- * Clear old data from the database
47
- * Deletes messages and file changes older than specified thresholds
48
- * Preserves decision_history, constraints, and core decisions
49
- * PROJECT-SCOPED: Only deletes data from current project (Constraint #40)
50
- *
51
- * If parameters are not provided, uses config-based weekend-aware retention.
52
- * If parameters are provided, they override m_config settings (no weekend-awareness).
53
- *
54
- * @param params - Optional parameters for cleanup thresholds (overrides config)
55
- * @param adapter - Optional database adapter (for testing)
56
- * @returns Counts of deleted records
57
- */
58
- export async function clearOldData(params, adapter) {
59
- const actualAdapter = adapter ?? getAdapter();
60
- try {
61
- // Validate parameters
62
- validateActionParams('stats', 'clear', params || {});
63
- return await connectionManager.executeWithRetry(async () => {
64
- // Get current project ID (Constraint #40 - respect project boundaries)
65
- const projectId = getProjectContext().getProjectId();
66
- // Calculate cutoff threshold BEFORE starting transaction to avoid connection pool deadlock
67
- // (calculateFileChangeCutoff queries m_config table, which would try to acquire a second connection)
68
- const fileChangesThreshold = params?.file_changes_older_than_days === undefined
69
- ? await calculateFileChangeCutoff(actualAdapter)
70
- : null;
71
- return await actualAdapter.transaction(async (trx) => {
72
- let messagesDeleted = 0;
73
- let fileChangesDeleted = 0;
74
- let activityLogsDeleted = 0;
75
- if (params?.messages_older_than_hours !== undefined || params?.file_changes_older_than_days !== undefined) {
76
- // Parameters provided: use custom retention (no weekend-awareness)
77
- const result = await cleanupWithCustomRetention(actualAdapter, params.messages_older_than_hours, params.file_changes_older_than_days, trx);
78
- messagesDeleted = result.messagesDeleted;
79
- fileChangesDeleted = result.fileChangesDeleted;
80
- activityLogsDeleted = result.activityLogsDeleted;
81
- }
82
- else {
83
- // No parameters: use config-based weekend-aware retention
84
- // (threshold already calculated above, before transaction started)
85
- // Delete file changes (project-scoped)
86
- fileChangesDeleted = await trx('t_file_changes')
87
- .where('project_id', projectId)
88
- .where('ts', '<', fileChangesThreshold)
89
- .delete();
90
- // Delete activity logs (uses same threshold as file changes, project-scoped)
91
- activityLogsDeleted = await trx('t_activity_log')
92
- .where('project_id', projectId)
93
- .where('ts', '<', fileChangesThreshold)
94
- .delete();
95
- }
96
- // Release inactive generic agent slots (24 hours of inactivity)
97
- const agentsReleased = await releaseInactiveAgents(actualAdapter, 24, trx);
98
- return {
99
- success: true,
100
- messages_deleted: messagesDeleted,
101
- file_changes_deleted: fileChangesDeleted,
102
- activity_logs_deleted: activityLogsDeleted,
103
- agents_released: agentsReleased,
104
- };
105
- });
106
- });
107
- }
108
- catch (error) {
109
- const message = error instanceof Error ? error.message : String(error);
110
- throw new Error(`Failed to clear old data: ${message}`);
111
- }
112
- }
113
- /**
114
- * Get comprehensive database statistics
115
- * Returns counts for all major tables and database health metrics
116
- * PROJECT-SCOPED: Only returns counts for current project (Constraint #38)
117
- *
118
- * @param adapter - Optional database adapter (for testing)
119
- * @returns Complete database statistics
120
- */
121
- export async function getStats(adapter) {
122
- const actualAdapter = adapter ?? getAdapter();
123
- const knex = actualAdapter.getKnex();
124
- try {
125
- // Validate parameters
126
- validateActionParams('stats', 'db_stats', {});
127
- return await connectionManager.executeWithRetry(async () => {
128
- // Get current project ID (Constraint #38 - project-scoped by default)
129
- const projectId = getProjectContext().getProjectId();
130
- // Helper to get count from a table with project_id filtering
131
- const getCount = async (table, additionalWhere) => {
132
- let query = knex(table)
133
- .count('* as count')
134
- .where('project_id', projectId);
135
- if (additionalWhere) {
136
- query = query.where(additionalWhere);
137
- }
138
- const result = await query.first();
139
- return result.count;
140
- };
141
- // Helper to get count from master tables (no project_id)
142
- const getMasterCount = async (table) => {
143
- const result = await knex(table)
144
- .count('* as count')
145
- .first();
146
- return result.count;
147
- };
148
- // Get all statistics (note: all await calls!)
149
- // Master tables - no project_id filtering
150
- const agents = await getMasterCount('m_agents');
151
- const files = await getMasterCount('m_files');
152
- const context_keys = await getMasterCount('m_context_keys');
153
- const tags = await getMasterCount('m_tags');
154
- const scopes = await getMasterCount('m_scopes');
155
- const layers = await getMasterCount('m_layers');
156
- // Decisions (active vs total) - project-scoped
157
- const active_decisions = await getCount('t_decisions', { status: 1 });
158
- const total_decisions = await getCount('t_decisions');
159
- // File changes - project-scoped
160
- const file_changes = await getCount('t_file_changes');
161
- // Constraints (active vs total) - project-scoped
162
- const active_constraints = await getCount('t_constraints', { active: 1 });
163
- const total_constraints = await getCount('t_constraints');
164
- // Task statistics (v3.x) - project-scoped
165
- const total_tasks = await getCount('t_tasks');
166
- // Active tasks (exclude done and archived)
167
- const active_tasks = await knex('t_tasks')
168
- .count('* as count')
169
- .where('project_id', projectId)
170
- .whereNotIn('status_id', [5, 6])
171
- .first();
172
- // Tasks by status (1=todo, 2=in_progress, 3=waiting_review, 4=blocked, 5=done, 6=archived)
173
- const tasks_by_status = {
174
- todo: await getCount('t_tasks', { status_id: 1 }),
175
- in_progress: await getCount('t_tasks', { status_id: 2 }),
176
- waiting_review: await getCount('t_tasks', { status_id: 3 }),
177
- blocked: await getCount('t_tasks', { status_id: 4 }),
178
- done: await getCount('t_tasks', { status_id: 5 }),
179
- archived: await getCount('t_tasks', { status_id: 6 }),
180
- };
181
- // Tasks by priority (1=low, 2=medium, 3=high, 4=critical)
182
- const tasks_by_priority = {
183
- low: await getCount('t_tasks', { priority: 1 }),
184
- medium: await getCount('t_tasks', { priority: 2 }),
185
- high: await getCount('t_tasks', { priority: 3 }),
186
- critical: await getCount('t_tasks', { priority: 4 }),
187
- };
188
- // Review status (v3.4.0) - tasks in waiting_review awaiting git commits
189
- // Overdue review: tasks in waiting_review for >24h (may need attention)
190
- const now = Math.floor(Date.now() / 1000);
191
- const overdueThreshold = now - 86400; // 24 hours ago
192
- const overdue_review_result = await knex('t_tasks')
193
- .count('* as count')
194
- .where('project_id', projectId)
195
- .where('status_id', 3)
196
- .where('updated_ts', '<', overdueThreshold)
197
- .first();
198
- const review_status = {
199
- awaiting_commit: tasks_by_status.waiting_review,
200
- overdue_review: overdue_review_result.count,
201
- };
202
- return {
203
- agents,
204
- files,
205
- context_keys,
206
- active_decisions,
207
- total_decisions,
208
- file_changes,
209
- active_constraints,
210
- total_constraints,
211
- tags,
212
- scopes,
213
- layers,
214
- total_tasks,
215
- active_tasks: active_tasks.count,
216
- tasks_by_status,
217
- tasks_by_priority,
218
- review_status, // v3.4.0: Enhanced review visibility
219
- };
220
- });
221
- }
222
- catch (error) {
223
- const message = error instanceof Error ? error.message : String(error);
224
- throw new Error(`Failed to get database statistics: ${message}`);
225
- }
226
- }
227
- /**
228
- * Get activity log entries with filtering
229
- * Supports time-based filtering (relative or absolute) and agent/action filtering
230
- * PROJECT-SCOPED: Only returns activity for current project (Constraint #38)
231
- *
232
- * @param params - Filter parameters (since, agent_names, actions, limit)
233
- * @param adapter - Optional database adapter (for testing)
234
- * @returns Activity log entries with parsed details
235
- */
236
- export async function getActivityLog(params, adapter) {
237
- const actualAdapter = adapter ?? getAdapter();
238
- const knex = actualAdapter.getKnex();
239
- try {
240
- // Validate parameters
241
- validateActionParams('stats', 'activity_log', params || {});
242
- // Get current project ID (Constraint #38 - project-scoped by default)
243
- const projectId = getProjectContext().getProjectId();
244
- let sinceTimestamp = null;
245
- if (params?.since) {
246
- const since = params.since;
247
- const now = Math.floor(Date.now() / 1000);
248
- const relativeMatch = since.match(/^(\d+)([mhd])$/);
249
- if (relativeMatch) {
250
- const value = parseInt(relativeMatch[1], 10);
251
- const unit = relativeMatch[2];
252
- let seconds = 0;
253
- switch (unit) {
254
- case 'm':
255
- seconds = value * 60;
256
- break;
257
- case 'h':
258
- seconds = value * 3600;
259
- break;
260
- case 'd':
261
- seconds = value * 86400;
262
- break;
263
- }
264
- sinceTimestamp = now - seconds;
265
- }
266
- else {
267
- try {
268
- const date = new Date(since);
269
- sinceTimestamp = Math.floor(date.getTime() / 1000);
270
- }
271
- catch {
272
- throw new Error(`Invalid 'since' parameter: ${since}. Use relative format (5m, 1h, 2d) or ISO 8601 timestamp`);
273
- }
274
- }
275
- }
276
- let query = knex('t_activity_log as al')
277
- .join('m_agents as a', 'al.agent_id', 'a.id')
278
- .leftJoin('m_layers as l', 'al.layer_id', 'l.id')
279
- .select('al.id', 'al.ts', 'a.name as agent', 'al.action_type', 'al.target', 'l.name as layer', 'al.details')
280
- .where('al.project_id', projectId);
281
- if (sinceTimestamp !== null) {
282
- query = query.where('al.ts', '>=', sinceTimestamp);
283
- }
284
- if (params?.agent_names && params.agent_names.length > 0 && !params.agent_names.includes('*')) {
285
- query = query.whereIn('a.name', params.agent_names);
286
- }
287
- if (params?.actions && params.actions.length > 0) {
288
- query = query.whereIn('al.action_type', params.actions);
289
- }
290
- const limit = params?.limit ?? 100;
291
- query = query.orderBy('al.ts', 'desc').limit(limit);
292
- const rows = await query;
293
- const activities = rows.map(row => ({
294
- id: row.id,
295
- timestamp: new Date(row.ts * 1000).toISOString(),
296
- agent: row.agent,
297
- action: row.action_type,
298
- target: row.target,
299
- layer: row.layer,
300
- details: row.details ? JSON.parse(row.details) : null,
301
- }));
302
- return {
303
- activities,
304
- count: activities.length,
305
- };
306
- }
307
- catch (error) {
308
- const message = error instanceof Error ? error.message : String(error);
309
- throw new Error(`Failed to get activity log: ${message}`);
310
- }
311
- }
312
- /**
313
- * Force WAL checkpoint to flush pending transactions to main database file
314
- * Uses TRUNCATE mode for complete flush - useful before git commits
315
- *
316
- * @param adapter - Optional database adapter (for testing)
317
- * @returns Checkpoint result with pages flushed
318
- */
319
- export async function flushWAL(adapter) {
320
- const actualAdapter = adapter ?? getAdapter();
321
- const knex = actualAdapter.getKnex();
322
- try {
323
- // Validate parameters
324
- validateActionParams('stats', 'flush', {});
325
- return await connectionManager.executeWithRetry(async () => {
326
- // Execute TRUNCATE checkpoint - most aggressive mode
327
- // Blocks until complete, ensures all WAL data written to main DB file
328
- // Returns array: [[busy, log, checkpointed]]
329
- // - busy: number of frames not checkpointed due to locks
330
- // - log: total number of frames in WAL file
331
- // - checkpointed: number of frames checkpointed
332
- const result = await knex.raw('PRAGMA wal_checkpoint(TRUNCATE)');
333
- // Parse result array format from Knex
334
- const pagesFlushed = result?.[0]?.[0]?.[2] || 0;
335
- return {
336
- success: true,
337
- mode: 'TRUNCATE',
338
- pages_flushed: pagesFlushed,
339
- message: `WAL checkpoint completed successfully. ${pagesFlushed} pages flushed to main database file.`
340
- };
341
- });
342
- }
343
- catch (error) {
344
- const message = error instanceof Error ? error.message : String(error);
345
- throw new Error(`Failed to flush WAL: ${message}`);
346
- }
347
- }
348
- /**
349
- * Get help documentation for stats tool
350
- * @returns Help documentation object
351
- */
352
- export function statsHelp() {
353
- return {
354
- tool: 'stats',
355
- description: 'View database statistics, activity logs, manage data cleanup, and WAL checkpoints',
356
- note: '💡 TIP: Use action: "example" to see comprehensive usage scenarios and real-world examples for all stats actions.',
357
- actions: {
358
- layer_summary: 'Get summary by layer. No params required',
359
- db_stats: 'Get database statistics. No params required',
360
- clear: 'Clear old data. Params: messages_older_than_hours, file_changes_older_than_days',
361
- activity_log: 'Get activity log (v3.0.0). Params: since (e.g., "5m", "1h", "2d"), agent_names (array or ["*"]), actions (filter by action types), limit (default: 100)',
362
- flush: 'Force WAL checkpoint to flush pending transactions to main database file. No params required. Uses TRUNCATE mode for complete flush. Useful before git commits to ensure database file is up-to-date.'
363
- },
364
- examples: {
365
- layer_summary: '{ action: "layer_summary" }',
366
- db_stats: '{ action: "db_stats" }',
367
- clear: '{ action: "clear", messages_older_than_hours: 48, file_changes_older_than_days: 14 }',
368
- activity_log: '{ action: "activity_log", since: "1h", agent_names: ["bot1", "bot2"], limit: 50 }',
369
- flush: '{ action: "flush" }'
370
- },
371
- documentation: {
372
- workflows: 'docs/WORKFLOWS.md - Activity monitoring, automatic cleanup workflows (602 lines, ~30k tokens)',
373
- best_practices: 'docs/BEST_PRACTICES.md - Database health, cleanup strategies (345 lines, ~17k tokens)',
374
- shared_concepts: 'docs/SHARED_CONCEPTS.md - Layer definitions for layer_summary (339 lines, ~17k tokens)',
375
- architecture: 'docs/ARCHITECTURE.md - Database schema, views, statistics tables'
376
- }
377
- };
378
- }
379
- /**
380
- * Get comprehensive examples for stats tool
381
- * @returns Examples documentation object
382
- */
383
- export function statsExample() {
384
- return {
385
- tool: 'stats',
386
- description: 'Database statistics and maintenance examples',
387
- scenarios: {
388
- layer_analysis: {
389
- title: 'Architecture Layer Summary',
390
- example: {
391
- request: '{ action: "layer_summary" }',
392
- response_structure: '{ layer: string, decision_count: number, file_changes: number, active_constraints: number }[]',
393
- use_case: 'Understand which layers have most activity and decisions'
394
- }
395
- },
396
- database_health: {
397
- title: 'Database Statistics',
398
- example: {
399
- request: '{ action: "db_stats" }',
400
- response_structure: '{ decisions: N, file_changes: N, constraints: N, tasks: N, db_size_mb: N }',
401
- use_case: 'Monitor database growth and table sizes'
402
- }
403
- },
404
- activity_monitoring: {
405
- title: 'Activity Log Queries',
406
- examples: [
407
- {
408
- scenario: 'Recent activity (last hour)',
409
- request: '{ action: "activity_log", since: "1h", limit: 50 }',
410
- explanation: 'View all agent activity in the past hour'
411
- },
412
- {
413
- scenario: 'Specific agent activity',
414
- request: '{ action: "activity_log", since: "24h", agent_names: ["backend-agent", "frontend-agent"] }',
415
- explanation: 'Track what specific agents have been doing'
416
- },
417
- {
418
- scenario: 'Filter by action type',
419
- request: '{ action: "activity_log", since: "2d", actions: ["set_decision", "create_task"] }',
420
- explanation: 'See only specific types of actions'
421
- }
422
- ]
423
- },
424
- data_cleanup: {
425
- title: 'Maintenance and Cleanup',
426
- examples: [
427
- {
428
- scenario: 'Manual cleanup with specific retention',
429
- request: '{ action: "clear", messages_older_than_hours: 48, file_changes_older_than_days: 14 }',
430
- explanation: 'Override config and delete old data'
431
- },
432
- {
433
- scenario: 'Config-based automatic cleanup',
434
- request: '{ action: "clear" }',
435
- explanation: 'Use configured retention settings (respects weekend-aware mode)'
436
- }
437
- ]
438
- },
439
- wal_management: {
440
- title: 'WAL Checkpoint (Git Workflow)',
441
- workflow: [
442
- {
443
- step: 1,
444
- action: 'Make changes to context (decisions, tasks, etc.)',
445
- explanation: 'SQLite WAL mode keeps changes in separate file'
446
- },
447
- {
448
- step: 2,
449
- action: 'Before git commit, flush WAL',
450
- request: '{ action: "flush" }',
451
- explanation: 'Merges WAL changes into main .db file'
452
- },
453
- {
454
- step: 3,
455
- action: 'Commit database file',
456
- explanation: 'Database file now contains all changes for version control'
457
- }
458
- ]
459
- }
460
- },
461
- best_practices: {
462
- monitoring: [
463
- 'Check layer_summary regularly to identify hotspots',
464
- 'Monitor db_stats to prevent database bloat',
465
- 'Use activity_log for debugging multi-agent issues',
466
- 'Set appropriate retention periods based on project needs'
467
- ],
468
- cleanup: [
469
- 'Run periodic cleanup to manage database size',
470
- 'Use weekend-aware mode for business hour retention',
471
- 'Consider longer retention for important decisions',
472
- 'Test cleanup with manual parameters before automating'
473
- ],
474
- wal_checkpoints: [
475
- 'Always flush before git commits for clean diffs',
476
- 'WAL mode improves concurrent access performance',
477
- 'Checkpoint automatically happens on shutdown',
478
- 'Manual flush ensures immediate persistence'
479
- ]
480
- }
481
- };
482
- }
483
- //# sourceMappingURL=utils.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"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"}
@@ -1,46 +0,0 @@
1
- /**
2
- * Action Specification Registry for MCP Tool Parameter Validation
3
- *
4
- * Centralized registry of all action-specific parameter requirements across
5
- * sqlew MCP tools. Used by parameter-validator.ts to generate structured
6
- * error messages with examples and typo suggestions.
7
- *
8
- * Each action spec includes:
9
- * - required: Array of required parameter names
10
- * - optional: Array of optional parameter names
11
- * - example: Valid example object demonstrating correct usage
12
- * - hint: Optional helpful tip for using the action
13
- */
14
- export interface ActionSpec {
15
- required: string[];
16
- optional: string[];
17
- example: any;
18
- hint?: string;
19
- }
20
- export declare const DECISION_ACTION_SPECS: Record<string, ActionSpec>;
21
- export declare const TASK_ACTION_SPECS: Record<string, ActionSpec>;
22
- export declare const FILE_ACTION_SPECS: Record<string, ActionSpec>;
23
- export declare const CONSTRAINT_ACTION_SPECS: Record<string, ActionSpec>;
24
- export declare const STATS_ACTION_SPECS: Record<string, ActionSpec>;
25
- export declare const ACTION_SPECS_BY_TOOL: Record<string, Record<string, ActionSpec>>;
26
- /**
27
- * Get action specification for a tool/action combination
28
- * @param tool Tool name (e.g., 'decision', 'task')
29
- * @param action Action name (e.g., 'set', 'create')
30
- * @returns Action specification or null if not found
31
- */
32
- export declare function getActionSpec(tool: string, action: string): ActionSpec | null;
33
- /**
34
- * Check if an action exists for a tool
35
- * @param tool Tool name
36
- * @param action Action name
37
- * @returns True if action exists
38
- */
39
- export declare function hasAction(tool: string, action: string): boolean;
40
- /**
41
- * Get all action names for a tool
42
- * @param tool Tool name
43
- * @returns Array of action names or empty array if tool not found
44
- */
45
- export declare function getToolActions(tool: string): string[];
46
- //# sourceMappingURL=action-specs.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"action-specs.d.ts","sourceRoot":"","sources":["../../src/utils/action-specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,GAAG,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAyM5D,CAAC;AAMF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAkJxD,CAAC;AAMF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAmDxD,CAAC;AAMF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAoC9D,CAAC;AAMF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAkDzD,CAAC;AAMF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAM3E,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAM7E;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMrD"}