squish-memory 1.0.2 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (704) hide show
  1. package/.env.example +146 -0
  2. package/CHANGELOG.md +202 -0
  3. package/README.md +192 -287
  4. package/{scripts → bin}/dependency-manager.mjs +217 -217
  5. package/{scripts → bin}/detect-clients.mjs +78 -78
  6. package/bin/install-interactive.mjs +321 -0
  7. package/bin/squish-mcp.mjs +46 -0
  8. package/bin/squish.mjs +33 -0
  9. package/config/mcp-migration-map.json +1 -6
  10. package/config/mcp-mode-semantics.json +10 -12
  11. package/config/mcp-remote-auth.json +3 -26
  12. package/config/mcp-universal.schema.json +5 -35
  13. package/config/settings.json +78 -22
  14. package/config.js +5 -0
  15. package/config.ts +218 -0
  16. package/core/adapters/config/claude-code.ts +133 -0
  17. package/core/adapters/config/cursor.ts +90 -0
  18. package/core/adapters/config/opencode.ts +89 -0
  19. package/core/adapters/config/windsurf.ts +90 -0
  20. package/core/adapters/index.ts +102 -0
  21. package/core/adapters/timeline.ts +116 -0
  22. package/core/adapters/types.ts +166 -0
  23. package/core/agent-preferences.ts +140 -0
  24. package/core/algorithms/analytics/token-estimator.ts +216 -0
  25. package/core/algorithms/detection/hash-filters.ts +260 -0
  26. package/core/algorithms/detection/semantic-ranker.ts +194 -0
  27. package/core/algorithms/detection/two-stage-detector.ts +421 -0
  28. package/core/algorithms/handlers/approve-merge.ts +215 -0
  29. package/core/algorithms/handlers/detect-duplicates.ts +192 -0
  30. package/core/algorithms/handlers/get-stats.ts +132 -0
  31. package/core/algorithms/handlers/list-proposals.ts +130 -0
  32. package/core/algorithms/handlers/preview-merge.ts +139 -0
  33. package/core/algorithms/handlers/reject-merge.ts +93 -0
  34. package/core/algorithms/handlers/reverse-merge.ts +155 -0
  35. package/core/algorithms/index.ts +39 -0
  36. package/core/algorithms/operations/cache-maintenance.ts +182 -0
  37. package/core/algorithms/safety/safety-checks.ts +256 -0
  38. package/core/algorithms/strategies/merge-strategies.ts +381 -0
  39. package/core/algorithms/types.ts +140 -0
  40. package/core/algorithms/utils/response-builder.ts +61 -0
  41. package/core/associations.ts +363 -0
  42. package/core/beliefs/decay.ts +289 -0
  43. package/core/beliefs/extractor.ts +131 -0
  44. package/core/beliefs/store.ts +557 -0
  45. package/core/beliefs/types.ts +38 -0
  46. package/core/commands/mcp-server.ts +5 -0
  47. package/core/compression.ts +177 -0
  48. package/core/config.js +2 -0
  49. package/core/consolidation.ts +330 -0
  50. package/core/context/agent-context.ts +388 -0
  51. package/core/context/context-paging.ts +449 -0
  52. package/core/context/context-window.ts +234 -0
  53. package/core/context/context.ts +35 -0
  54. package/core/embeddings/embeddings.ts +616 -0
  55. package/core/embeddings/google-multimodal.ts +200 -0
  56. package/core/embeddings/local-embeddings.ts +12 -0
  57. package/core/embeddings/qmd-client.ts +495 -0
  58. package/core/embeddings/transformers-local.ts +261 -0
  59. package/core/embeddings.js +4 -0
  60. package/core/error-handling.ts +206 -0
  61. package/core/external +219 -0
  62. package/core/graph/entity-deduplicator.ts +232 -0
  63. package/core/graph/graph-builder.ts +257 -0
  64. package/core/graph/graph-traversal.ts +490 -0
  65. package/core/graph/index.ts +24 -0
  66. package/core/graph/llm-entity-extractor.ts +402 -0
  67. package/core/graph/multi-hop-retrieval.ts +317 -0
  68. package/core/graph/relationship-extractor.ts +465 -0
  69. package/core/hooks/agent-hooks.ts +653 -0
  70. package/core/hooks/auto-tagger.ts +149 -0
  71. package/core/hooks/capture-filter.ts +169 -0
  72. package/core/hot-cache.ts +388 -0
  73. package/core/index.ts +10 -0
  74. package/core/ingestion/agent-memory.ts +167 -0
  75. package/core/ingestion/core-memory.ts +326 -0
  76. package/core/ingestion/learnings.ts +260 -0
  77. package/core/ingestion/signal-engine.ts +266 -0
  78. package/core/integrations/obsidian-vault.ts +197 -0
  79. package/core/layers/generator.ts +115 -0
  80. package/core/lib/db-client.ts +168 -0
  81. package/core/lib/parse-embedding.ts +59 -0
  82. package/core/lib/schemas.ts +102 -0
  83. package/core/lib/types.ts +49 -0
  84. package/core/lib/utils.ts +151 -0
  85. package/core/lib/validation.ts +180 -0
  86. package/core/lifecycle.ts +353 -0
  87. package/core/logger.ts +59 -0
  88. package/core/memory/bridge-discovery.ts +395 -0
  89. package/core/memory/categorizer.ts +390 -0
  90. package/core/memory/conflict-detector.ts +62 -0
  91. package/core/memory/consolidation.ts +372 -0
  92. package/core/memory/context-collector.ts +75 -0
  93. package/core/memory/contradiction-resolver.ts +494 -0
  94. package/core/memory/edit-workflow.ts +174 -0
  95. package/core/memory/entity-extractor.ts +426 -0
  96. package/core/memory/entity-resolver.ts +89 -0
  97. package/core/memory/explain.ts +112 -0
  98. package/core/memory/fact-deriver.ts +300 -0
  99. package/core/memory/fact-extractor.ts +120 -0
  100. package/core/memory/feedback-tracker.ts +200 -0
  101. package/core/memory/hooks.ts +230 -0
  102. package/core/memory/hybrid-retrieval.ts +65 -0
  103. package/core/memory/hybrid-scorer.ts +325 -0
  104. package/core/memory/hybrid-search.ts +748 -0
  105. package/core/memory/importance.ts +319 -0
  106. package/core/memory/index.ts +11 -0
  107. package/core/memory/loader.ts +178 -0
  108. package/core/memory/markdown/markdown-storage.ts +318 -0
  109. package/core/memory/memories.ts +565 -0
  110. package/core/memory/memory-lifecycle.ts +51 -0
  111. package/core/memory/memory-manager.ts +53 -0
  112. package/core/memory/migrate.ts +173 -0
  113. package/core/memory/normalization.ts +30 -0
  114. package/core/memory/path-strengthener.ts +211 -0
  115. package/core/memory/progressive-disclosure.ts +392 -0
  116. package/core/memory/query-processor.ts +130 -0
  117. package/core/memory/query-rewriter.ts +153 -0
  118. package/core/memory/response-analyzer.ts +81 -0
  119. package/core/memory/retrieval-feedback.ts +276 -0
  120. package/core/memory/serialization.ts +83 -0
  121. package/core/memory/stale-cleaner.ts +147 -0
  122. package/core/memory/stats.ts +181 -0
  123. package/core/memory/telemetry.ts +392 -0
  124. package/core/memory/temporal-facts.ts +356 -0
  125. package/core/memory/temporal-parser.ts +477 -0
  126. package/core/memory/trigger-detector.ts +104 -0
  127. package/core/memory/write-gate.ts +288 -0
  128. package/core/places/index.ts +14 -0
  129. package/core/places/memory-places.ts +339 -0
  130. package/core/places/places.ts +406 -0
  131. package/core/places/rules.ts +308 -0
  132. package/core/places/walking.ts +192 -0
  133. package/core/projects +89 -0
  134. package/core/projects.ts +131 -0
  135. package/core/redis.ts +82 -0
  136. package/core/responses.ts +187 -0
  137. package/core/runtime/trust-report.ts +195 -0
  138. package/core/runtime/trust-state.ts +360 -0
  139. package/core/scheduler/cron-scheduler.ts +581 -0
  140. package/core/scheduler/heartbeat.ts +91 -0
  141. package/core/scheduler/index.ts +8 -0
  142. package/core/scheduler/job-runner.ts +197 -0
  143. package/core/search/conversations.ts +166 -0
  144. package/core/search/entities.ts +46 -0
  145. package/core/search/folder-context.ts +154 -0
  146. package/core/search/graph-boost.ts +22 -0
  147. package/core/search/index.ts +4 -0
  148. package/core/search/qmd-wrapper.ts +84 -0
  149. package/core/security/encrypt.ts +51 -0
  150. package/core/security/governance.ts +102 -0
  151. package/core/security/privacy.ts +108 -0
  152. package/core/security/secret-detector.ts +122 -0
  153. package/core/session/auto-load.ts +160 -0
  154. package/core/session/entity-tracker.ts +363 -0
  155. package/core/session/index.ts +7 -0
  156. package/core/session/reference-resolver.ts +158 -0
  157. package/core/session/self-iteration-job.ts +478 -0
  158. package/core/session/session-hooks.ts +69 -0
  159. package/core/session/types.ts +36 -0
  160. package/core/session/working-set.ts +275 -0
  161. package/core/snapshots/cleanup.ts +13 -0
  162. package/core/snapshots/comparison.ts +59 -0
  163. package/core/snapshots/creation.ts +139 -0
  164. package/core/snapshots/retrieval.ts +44 -0
  165. package/core/snapshots/stats.ts +63 -0
  166. package/core/storage/cache.ts +241 -0
  167. package/core/storage/database.ts +23 -0
  168. package/core/summarization/cleanup.ts +13 -0
  169. package/core/summarization/queries.ts +32 -0
  170. package/core/summarization/stats.ts +64 -0
  171. package/core/summarization/strategies.ts +52 -0
  172. package/core/summarization.ts +248 -0
  173. package/core/temporal-facts.ts +244 -0
  174. package/core/tracing/collector.ts +470 -0
  175. package/core/tracing/visualizer.ts +195 -0
  176. package/core/utils/cleanup-operations.ts +50 -0
  177. package/core/utils/content-extraction.ts +95 -0
  178. package/core/utils/filter-builder.ts +56 -0
  179. package/core/utils/history-traversal.ts +63 -0
  180. package/core/utils/memory-operations.ts +56 -0
  181. package/core/utils/query-operations.ts +83 -0
  182. package/core/utils/summarization-helpers.ts +45 -0
  183. package/core/utils/temporal-queries.ts +39 -0
  184. package/core/utils/vector-operations.ts +135 -0
  185. package/core/utils/version-management.ts +74 -0
  186. package/core/worker.ts +324 -0
  187. package/db/adapter.ts +215 -0
  188. package/db/bootstrap.ts +1055 -0
  189. package/db/drizzle/migrations/0000_needy_cerebro.sql +402 -0
  190. package/db/drizzle/migrations/meta/0000_snapshot.json +3451 -0
  191. package/db/drizzle/migrations/meta/_journal.json +13 -0
  192. package/db/drizzle/schema-sqlite.ts +1032 -0
  193. package/db/drizzle/schema.ts +1128 -0
  194. package/db/drizzle.config.ts +12 -0
  195. package/db/index.ts +83 -0
  196. package/db/init.sql +5 -0
  197. package/db/migrations/associations.ts +35 -0
  198. package/db/migrations/beliefs.ts +89 -0
  199. package/db/migrations/core-memory.ts +35 -0
  200. package/db/migrations/fts.ts +59 -0
  201. package/db/migrations/index.ts +54 -0
  202. package/db/migrations/indexes.ts +36 -0
  203. package/db/migrations/learnings.ts +34 -0
  204. package/db/migrations/maintenance.ts +68 -0
  205. package/db/migrations/memories.ts +22 -0
  206. package/db/migrations/memory-places.ts +35 -0
  207. package/db/migrations/places.ts +49 -0
  208. package/db/migrations/projects.ts +21 -0
  209. package/db/migrations/tier-conversion.ts +24 -0
  210. package/db/neon.ts +22 -0
  211. package/db/schema/beliefs.ts +50 -0
  212. package/db/schema/generator.ts +159 -0
  213. package/db/schema/index.ts +58 -0
  214. package/db/schema/learnings.ts +32 -0
  215. package/db/schema/memories.ts +83 -0
  216. package/db/schema/projects.ts +33 -0
  217. package/db/schema.ts +13 -0
  218. package/db/supabase.ts +27 -0
  219. package/dist/config.d.ts +61 -14
  220. package/dist/config.js +159 -139
  221. package/dist/core/adapters/config/claude-code.d.ts +45 -0
  222. package/dist/core/adapters/config/claude-code.js +113 -0
  223. package/dist/core/adapters/config/cursor.d.ts +26 -0
  224. package/dist/core/adapters/config/cursor.js +74 -0
  225. package/dist/core/adapters/config/opencode.d.ts +23 -0
  226. package/dist/core/adapters/config/opencode.js +73 -0
  227. package/dist/core/adapters/config/windsurf.d.ts +26 -0
  228. package/dist/core/adapters/config/windsurf.js +74 -0
  229. package/dist/core/adapters/index.d.ts +45 -0
  230. package/dist/core/adapters/index.js +84 -0
  231. package/dist/core/adapters/scripts/install-adapter.d.ts +19 -0
  232. package/dist/core/adapters/scripts/install-adapter.js +149 -0
  233. package/dist/core/adapters/timeline.d.ts +23 -0
  234. package/dist/core/adapters/timeline.js +88 -0
  235. package/dist/core/adapters/types.d.ts +137 -0
  236. package/dist/core/adapters/types.js +50 -0
  237. package/dist/core/agent-preferences.d.ts +16 -0
  238. package/dist/core/agent-preferences.js +124 -0
  239. package/dist/{algorithms → core/algorithms}/analytics/token-estimator.d.ts +1 -1
  240. package/dist/{algorithms → core/algorithms}/analytics/token-estimator.js +3 -3
  241. package/dist/{algorithms → core/algorithms}/detection/semantic-ranker.d.ts +1 -1
  242. package/dist/{algorithms → core/algorithms}/detection/semantic-ranker.js +1 -1
  243. package/dist/{algorithms → core/algorithms}/detection/two-stage-detector.d.ts +1 -1
  244. package/dist/{algorithms → core/algorithms}/detection/two-stage-detector.js +7 -10
  245. package/dist/{algorithms → core/algorithms}/handlers/approve-merge.js +4 -4
  246. package/dist/{algorithms → core/algorithms}/handlers/detect-duplicates.js +3 -3
  247. package/dist/{algorithms → core/algorithms}/handlers/get-stats.js +3 -3
  248. package/dist/{algorithms → core/algorithms}/handlers/list-proposals.js +3 -3
  249. package/dist/{algorithms → core/algorithms}/handlers/preview-merge.js +3 -3
  250. package/dist/{algorithms → core/algorithms}/handlers/reject-merge.js +3 -3
  251. package/dist/{algorithms → core/algorithms}/handlers/reverse-merge.js +3 -3
  252. package/dist/core/algorithms/index.d.ts +21 -0
  253. package/dist/core/algorithms/index.js +26 -0
  254. package/dist/core/algorithms/operations/cache-maintenance.d.ts +12 -0
  255. package/dist/core/algorithms/operations/cache-maintenance.js +157 -0
  256. package/dist/{algorithms → core/algorithms}/safety/safety-checks.d.ts +2 -6
  257. package/dist/{algorithms → core/algorithms}/strategies/merge-strategies.d.ts +19 -1
  258. package/dist/{algorithms → core/algorithms}/strategies/merge-strategies.js +74 -123
  259. package/dist/core/algorithms/types.d.ts +125 -0
  260. package/dist/core/algorithms/types.js +5 -0
  261. package/dist/core/associations.d.ts +3 -2
  262. package/dist/core/associations.js +37 -2
  263. package/dist/core/autosave.d.ts +19 -0
  264. package/dist/core/autosave.js +16 -0
  265. package/dist/core/beliefs/decay.d.ts +27 -0
  266. package/dist/core/beliefs/decay.js +217 -0
  267. package/dist/core/beliefs/extractor.d.ts +9 -0
  268. package/dist/core/beliefs/extractor.js +113 -0
  269. package/dist/core/beliefs/store.d.ts +46 -0
  270. package/dist/core/beliefs/store.js +466 -0
  271. package/dist/core/beliefs/types.d.ts +28 -0
  272. package/dist/core/beliefs/types.js +2 -0
  273. package/dist/core/commands/mcp-server.d.ts +2 -0
  274. package/dist/core/commands/mcp-server.js +6 -0
  275. package/dist/core/commands/remember.d.ts +24 -0
  276. package/dist/core/commands/remember.js +144 -0
  277. package/dist/core/compression.d.ts +45 -0
  278. package/dist/core/compression.js +160 -0
  279. package/dist/core/context/agent-context.d.ts +106 -0
  280. package/dist/core/context/agent-context.js +274 -0
  281. package/dist/core/{context-paging.d.ts → context/context-paging.d.ts} +2 -12
  282. package/dist/core/{context-paging.js → context/context-paging.js} +19 -39
  283. package/dist/core/context/context-window.d.ts +40 -0
  284. package/dist/core/context/context-window.js +177 -0
  285. package/dist/core/context/context.js +22 -0
  286. package/dist/core/embeddings/embeddings.d.ts +29 -0
  287. package/dist/core/embeddings/embeddings.js +546 -0
  288. package/dist/core/embeddings/google-multimodal.js +6 -2
  289. package/dist/core/embeddings/local-embeddings.d.ts +11 -0
  290. package/dist/core/embeddings/local-embeddings.js +11 -0
  291. package/dist/core/embeddings/qmd-client.js +1 -1
  292. package/dist/core/embeddings/transformers-local.d.ts +64 -0
  293. package/dist/core/embeddings/transformers-local.js +213 -0
  294. package/dist/core/embeddings.d.ts +1 -28
  295. package/dist/core/embeddings.js +2 -401
  296. package/dist/core/error-handling.d.ts +63 -0
  297. package/dist/core/error-handling.js +173 -0
  298. package/dist/core/graph/entity-deduplicator.d.ts +24 -0
  299. package/dist/core/graph/entity-deduplicator.js +183 -0
  300. package/dist/core/graph/graph-builder.d.ts +46 -0
  301. package/dist/core/graph/graph-builder.js +174 -0
  302. package/dist/core/graph/graph-traversal.d.ts +80 -0
  303. package/dist/core/graph/graph-traversal.js +315 -0
  304. package/dist/core/graph/index.d.ts +19 -0
  305. package/dist/core/graph/index.js +13 -0
  306. package/dist/core/graph/llm-entity-extractor.d.ts +49 -0
  307. package/dist/core/graph/llm-entity-extractor.js +313 -0
  308. package/dist/core/graph/multi-hop-retrieval.d.ts +48 -0
  309. package/dist/core/graph/multi-hop-retrieval.js +215 -0
  310. package/dist/core/graph/relationship-extractor.d.ts +48 -0
  311. package/dist/core/graph/relationship-extractor.js +351 -0
  312. package/dist/core/hooks/agent-hooks.d.ts +83 -0
  313. package/dist/core/hooks/agent-hooks.js +521 -0
  314. package/dist/core/hooks/auto-tagger.d.ts +19 -0
  315. package/dist/core/hooks/auto-tagger.js +155 -0
  316. package/dist/core/hooks/capture-filter.d.ts +41 -0
  317. package/dist/core/hooks/capture-filter.js +128 -0
  318. package/dist/core/hot-cache.d.ts +86 -0
  319. package/dist/core/hot-cache.js +285 -0
  320. package/dist/core/index.d.ts +9 -9
  321. package/dist/core/index.js +9 -12
  322. package/dist/core/{agent-memory.js → ingestion/agent-memory.js} +5 -7
  323. package/dist/core/{core-memory.d.ts → ingestion/core-memory.d.ts} +2 -2
  324. package/dist/core/{core-memory.js → ingestion/core-memory.js} +7 -7
  325. package/dist/core/ingestion/learnings.d.ts +57 -0
  326. package/dist/core/ingestion/learnings.js +205 -0
  327. package/dist/core/ingestion/signal-engine.d.ts +41 -0
  328. package/dist/core/ingestion/signal-engine.js +201 -0
  329. package/dist/core/integrations/obsidian-vault.d.ts +31 -0
  330. package/dist/core/integrations/obsidian-vault.js +156 -0
  331. package/dist/core/lib/db-client.d.ts +114 -0
  332. package/dist/core/lib/db-client.js +130 -0
  333. package/dist/core/lib/parse-embedding.d.ts +9 -0
  334. package/dist/core/lib/parse-embedding.js +58 -0
  335. package/dist/core/lib/schemas.d.ts +132 -0
  336. package/dist/core/lib/schemas.js +87 -0
  337. package/dist/core/lib/types.d.ts +45 -0
  338. package/dist/core/lib/types.js +6 -0
  339. package/dist/core/{utils.d.ts → lib/utils.d.ts} +5 -0
  340. package/dist/core/lib/utils.js +145 -0
  341. package/dist/core/lib/validation.d.ts +38 -0
  342. package/dist/core/lib/validation.js +151 -0
  343. package/dist/core/lifecycle.d.ts +7 -1
  344. package/dist/core/lifecycle.js +152 -42
  345. package/dist/core/logger.d.ts +1 -0
  346. package/dist/core/logger.js +13 -1
  347. package/dist/core/mcp/tools.d.ts +0 -2
  348. package/dist/core/mcp/tools.js +35 -90
  349. package/dist/core/mcp/types.d.ts +25 -253
  350. package/dist/core/mcp/types.js +2 -2
  351. package/dist/core/memory/categorizer.js +2 -0
  352. package/dist/core/memory/conflict-detector.js +1 -1
  353. package/dist/core/memory/consolidation.d.ts +1 -10
  354. package/dist/core/memory/consolidation.js +4 -39
  355. package/dist/core/memory/context-collector.js +1 -1
  356. package/dist/core/memory/edit-workflow.js +1 -1
  357. package/dist/core/memory/entity-extractor.d.ts +4 -0
  358. package/dist/core/memory/entity-extractor.js +30 -16
  359. package/dist/core/memory/entity-resolver.js +7 -7
  360. package/dist/core/memory/explain.d.ts +18 -0
  361. package/dist/core/memory/explain.js +92 -0
  362. package/dist/core/memory/fact-deriver.d.ts +31 -0
  363. package/dist/core/memory/fact-deriver.js +236 -0
  364. package/dist/core/memory/fact-extractor.js +12 -12
  365. package/dist/core/memory/feedback-tracker.js +1 -1
  366. package/dist/core/memory/hooks.d.ts +88 -0
  367. package/dist/core/memory/hooks.js +174 -0
  368. package/dist/core/memory/hybrid-retrieval.d.ts +14 -16
  369. package/dist/core/memory/hybrid-retrieval.js +25 -127
  370. package/dist/core/memory/hybrid-scorer.js +6 -23
  371. package/dist/core/memory/hybrid-search.d.ts +9 -11
  372. package/dist/core/memory/hybrid-search.js +496 -273
  373. package/dist/core/memory/importance.d.ts +2 -24
  374. package/dist/core/memory/importance.js +7 -91
  375. package/dist/core/memory/index.d.ts +1 -0
  376. package/dist/core/memory/index.js +1 -0
  377. package/dist/core/memory/loader.d.ts +31 -0
  378. package/dist/core/memory/loader.js +141 -0
  379. package/dist/core/memory/markdown/markdown-storage.d.ts +72 -0
  380. package/dist/core/memory/markdown/markdown-storage.js +243 -0
  381. package/dist/core/memory/memories.d.ts +23 -19
  382. package/dist/core/memory/memories.js +243 -228
  383. package/dist/core/memory/memory-lifecycle.d.ts +8 -0
  384. package/dist/core/memory/memory-lifecycle.js +47 -0
  385. package/dist/core/memory/migrate.d.ts +21 -0
  386. package/dist/core/memory/migrate.js +134 -0
  387. package/dist/core/memory/normalization.d.ts +7 -0
  388. package/dist/core/memory/normalization.js +26 -0
  389. package/dist/core/memory/path-strengthener.d.ts +39 -0
  390. package/dist/core/memory/path-strengthener.js +150 -0
  391. package/dist/core/memory/progressive-disclosure.js +1 -1
  392. package/dist/core/memory/query-processor.js +37 -3
  393. package/dist/core/memory/query-rewriter.js +9 -9
  394. package/dist/core/memory/retrieval-feedback.d.ts +70 -0
  395. package/dist/core/memory/retrieval-feedback.js +213 -0
  396. package/dist/core/memory/serialization.d.ts +4 -0
  397. package/dist/core/memory/serialization.js +49 -0
  398. package/dist/core/memory/stale-cleaner.d.ts +26 -0
  399. package/dist/core/memory/stale-cleaner.js +97 -0
  400. package/dist/core/memory/stats.d.ts +15 -0
  401. package/dist/core/memory/stats.js +69 -13
  402. package/dist/core/memory/temporal-facts.js +21 -0
  403. package/dist/core/memory/trigger-detector.d.ts +8 -1
  404. package/dist/core/memory/trigger-detector.js +42 -5
  405. package/dist/core/memory/write-gate.js +1 -1
  406. package/dist/core/places/index.d.ts +14 -0
  407. package/dist/core/places/index.js +14 -0
  408. package/dist/core/places/memory-places.d.ts +68 -0
  409. package/dist/core/places/memory-places.js +261 -0
  410. package/dist/core/places/places.d.ts +88 -0
  411. package/dist/core/places/places.js +314 -0
  412. package/dist/core/places/rules.d.ts +74 -0
  413. package/dist/core/places/rules.js +240 -0
  414. package/dist/core/places/walking.d.ts +56 -0
  415. package/dist/core/places/walking.js +121 -0
  416. package/dist/core/projects.d.ts +5 -0
  417. package/dist/core/projects.js +47 -18
  418. package/dist/core/responses.d.ts +96 -0
  419. package/dist/core/responses.js +122 -0
  420. package/dist/core/runtime/trust-report.d.ts +102 -0
  421. package/dist/core/runtime/trust-report.js +107 -0
  422. package/dist/core/runtime/trust-state.d.ts +12 -0
  423. package/dist/core/runtime/trust-state.js +309 -0
  424. package/dist/core/scheduler/cron-scheduler.d.ts +1 -1
  425. package/dist/core/scheduler/cron-scheduler.js +193 -10
  426. package/dist/core/scheduler/index.d.ts +1 -1
  427. package/dist/core/scheduler/index.js +1 -1
  428. package/dist/core/scheduler/job-runner.js +2 -2
  429. package/dist/core/search/conversations.js +40 -42
  430. package/dist/core/search/entities.js +6 -9
  431. package/dist/core/search/graph-boost.d.ts +7 -0
  432. package/dist/core/search/graph-boost.js +23 -0
  433. package/dist/core/search/qmd-wrapper.d.ts +36 -0
  434. package/dist/core/search/qmd-wrapper.js +58 -0
  435. package/dist/core/security/encrypt.d.ts +6 -0
  436. package/dist/core/security/encrypt.js +47 -0
  437. package/dist/core/{governance.d.ts → security/governance.d.ts} +6 -1
  438. package/dist/core/security/governance.js +79 -0
  439. package/dist/core/session/auto-load.js +34 -9
  440. package/dist/core/session/entity-tracker.d.ts +62 -0
  441. package/dist/core/session/entity-tracker.js +287 -0
  442. package/dist/core/session/index.d.ts +1 -1
  443. package/dist/core/session/index.js +1 -1
  444. package/dist/core/session/reference-resolver.d.ts +26 -0
  445. package/dist/core/session/reference-resolver.js +121 -0
  446. package/dist/core/{session-hooks → session}/self-iteration-job.d.ts +15 -0
  447. package/dist/core/{session-hooks → session}/self-iteration-job.js +195 -90
  448. package/dist/core/session/working-set.d.ts +50 -0
  449. package/dist/core/session/working-set.js +212 -0
  450. package/dist/core/snapshots/creation.d.ts +2 -8
  451. package/dist/core/snapshots/creation.js +3 -12
  452. package/dist/core/{cache.js → storage/cache.js} +2 -2
  453. package/dist/core/utils/memory-operations.js +1 -1
  454. package/dist/core/utils/summarization-helpers.d.ts +0 -4
  455. package/dist/core/utils/summarization-helpers.js +1 -6
  456. package/dist/core/utils/vector-operations.d.ts +71 -0
  457. package/dist/core/utils/vector-operations.js +129 -0
  458. package/dist/db/adapter.d.ts +3 -3
  459. package/dist/db/adapter.js +99 -88
  460. package/dist/db/bootstrap.d.ts +2 -0
  461. package/dist/db/bootstrap.js +921 -674
  462. package/dist/{drizzle → db/drizzle}/schema-sqlite.d.ts +775 -25
  463. package/dist/{drizzle → db/drizzle}/schema-sqlite.js +170 -24
  464. package/dist/{drizzle → db/drizzle}/schema.d.ts +731 -32
  465. package/dist/{drizzle → db/drizzle}/schema.js +192 -32
  466. package/dist/db/drizzle.config.d.ts +3 -0
  467. package/dist/db/drizzle.config.js +12 -0
  468. package/dist/db/index.d.ts +1 -5
  469. package/dist/db/index.js +51 -8
  470. package/dist/db/migrations/associations.d.ts +6 -0
  471. package/dist/db/migrations/associations.js +29 -0
  472. package/dist/db/migrations/beliefs.d.ts +10 -0
  473. package/dist/db/migrations/beliefs.js +76 -0
  474. package/dist/db/migrations/core-memory.d.ts +6 -0
  475. package/dist/db/migrations/core-memory.js +29 -0
  476. package/dist/db/migrations/fts.d.ts +6 -0
  477. package/dist/db/migrations/fts.js +52 -0
  478. package/dist/db/migrations/index.d.ts +25 -0
  479. package/dist/db/migrations/index.js +51 -0
  480. package/dist/db/migrations/indexes.d.ts +6 -0
  481. package/dist/db/migrations/indexes.js +30 -0
  482. package/dist/db/migrations/learnings.d.ts +7 -0
  483. package/dist/db/migrations/learnings.js +26 -0
  484. package/dist/db/migrations/maintenance.d.ts +6 -0
  485. package/dist/db/migrations/maintenance.js +61 -0
  486. package/dist/db/migrations/memories.d.ts +7 -0
  487. package/dist/db/migrations/memories.js +16 -0
  488. package/dist/db/migrations/memory-places.d.ts +6 -0
  489. package/dist/db/migrations/memory-places.js +29 -0
  490. package/dist/db/migrations/places.d.ts +6 -0
  491. package/dist/db/migrations/places.js +43 -0
  492. package/dist/db/migrations/projects.d.ts +3 -0
  493. package/dist/db/migrations/projects.js +13 -0
  494. package/dist/db/migrations/tier-conversion.d.ts +7 -0
  495. package/dist/db/migrations/tier-conversion.js +20 -0
  496. package/dist/db/neon.d.ts +8 -0
  497. package/dist/db/neon.js +20 -0
  498. package/dist/db/schema/beliefs.d.ts +9 -0
  499. package/dist/db/schema/beliefs.js +46 -0
  500. package/dist/db/schema/generator.d.ts +38 -0
  501. package/dist/db/schema/generator.js +108 -0
  502. package/dist/db/schema/index.d.ts +39 -0
  503. package/dist/db/schema/index.js +51 -0
  504. package/dist/db/schema/learnings.d.ts +7 -0
  505. package/dist/db/schema/learnings.js +30 -0
  506. package/dist/db/schema/memories.d.ts +7 -0
  507. package/dist/db/schema/memories.js +81 -0
  508. package/dist/db/schema/projects.d.ts +4 -0
  509. package/dist/db/schema/projects.js +31 -0
  510. package/dist/db/schema/tables/context-sessions.d.ts +9 -0
  511. package/dist/db/schema/tables/context-sessions.js +37 -0
  512. package/dist/db/schema/tables/conversations.d.ts +9 -0
  513. package/dist/db/schema/tables/conversations.js +47 -0
  514. package/dist/db/schema/tables/core-memory.d.ts +9 -0
  515. package/dist/db/schema/tables/core-memory.js +41 -0
  516. package/dist/db/schema/tables/entities.d.ts +9 -0
  517. package/dist/db/schema/tables/entities.js +39 -0
  518. package/dist/db/schema/tables/entity-relations.d.ts +9 -0
  519. package/dist/db/schema/tables/entity-relations.js +31 -0
  520. package/dist/db/schema/tables/learnings.d.ts +9 -0
  521. package/dist/db/schema/tables/learnings.js +66 -0
  522. package/dist/db/schema/tables/memories.d.ts +9 -0
  523. package/dist/db/schema/tables/memories.js +161 -0
  524. package/dist/db/schema/tables/memory-associations.d.ts +9 -0
  525. package/dist/db/schema/tables/memory-associations.js +39 -0
  526. package/dist/db/schema/tables/memory-hash-cache.d.ts +9 -0
  527. package/dist/db/schema/tables/memory-hash-cache.js +29 -0
  528. package/dist/db/schema/tables/memory-merge-history.d.ts +9 -0
  529. package/dist/db/schema/tables/memory-merge-history.js +33 -0
  530. package/dist/db/schema/tables/memory-merge-proposals.d.ts +9 -0
  531. package/dist/db/schema/tables/memory-merge-proposals.js +39 -0
  532. package/dist/db/schema/tables/messages.d.ts +9 -0
  533. package/dist/db/schema/tables/messages.js +41 -0
  534. package/dist/db/schema/tables/namespaces.d.ts +9 -0
  535. package/dist/db/schema/tables/namespaces.js +37 -0
  536. package/dist/db/schema/tables/projects.d.ts +9 -0
  537. package/dist/db/schema/tables/projects.js +31 -0
  538. package/dist/db/schema/tables/users.d.ts +9 -0
  539. package/dist/db/schema/tables/users.js +27 -0
  540. package/dist/db/schema.d.ts +1 -1
  541. package/dist/db/schema.js +2 -2
  542. package/dist/db/supabase.d.ts +9 -0
  543. package/dist/db/supabase.js +24 -0
  544. package/dist/packages/mcp/src/index.d.ts +3 -0
  545. package/dist/packages/mcp/src/index.js +733 -0
  546. package/mcp.json.example +8 -0
  547. package/package.json +132 -173
  548. package/packages/cli/package.json +22 -0
  549. package/packages/cli/src/commands/clean.ts +68 -0
  550. package/packages/cli/src/commands/context.ts +79 -0
  551. package/packages/cli/src/commands/doctor.ts +357 -0
  552. package/packages/cli/src/commands/forget.ts +72 -0
  553. package/packages/cli/src/commands/health.ts +36 -0
  554. package/packages/cli/src/commands/inspect.ts +41 -0
  555. package/packages/cli/src/commands/link.ts +50 -0
  556. package/packages/cli/src/commands/migrate.ts +93 -0
  557. package/packages/cli/src/commands/recall.ts +99 -0
  558. package/packages/cli/src/commands/recent.ts +57 -0
  559. package/packages/cli/src/commands/remember.ts +139 -0
  560. package/packages/cli/src/commands/run.ts +58 -0
  561. package/packages/cli/src/commands/stale.ts +43 -0
  562. package/packages/cli/src/commands/stats.ts +42 -0
  563. package/packages/cli/src/index.ts +57 -0
  564. package/packages/cli/tsconfig.json +24 -0
  565. package/packages/mcp/package.json +26 -0
  566. package/packages/mcp/src/index.ts +877 -0
  567. package/packages/mcp/tsconfig.json +20 -0
  568. package/skills/squish-memory/SKILL.md +107 -114
  569. package/skills/squish-memory/install.sh +3 -3
  570. package/skills/squish-memory/{claude-desktop.json → references/claude-desktop.json} +12 -12
  571. package/skills/squish-memory/{openclaw.json → references/openclaw.json} +13 -13
  572. package/skills/squish-memory/{opencode.json → references/opencode.json} +14 -14
  573. package/.claude-plugin/marketplace.json +0 -20
  574. package/.claude-plugin/plugin.json +0 -32
  575. package/.env.mcp.example +0 -60
  576. package/.mcp.json +0 -11
  577. package/QUICK-START.md +0 -71
  578. package/bin/squish-add.mjs +0 -32
  579. package/bin/squish-rm.mjs +0 -21
  580. package/commands/context-paging.md +0 -51
  581. package/commands/context-status.md +0 -22
  582. package/commands/context.md +0 -5
  583. package/commands/core-memory.md +0 -56
  584. package/commands/health.md +0 -5
  585. package/commands/init.md +0 -39
  586. package/commands/merge.md +0 -113
  587. package/commands/observe.md +0 -5
  588. package/commands/recall.md +0 -5
  589. package/commands/remember.md +0 -11
  590. package/commands/search.md +0 -10
  591. package/config/mcp-cli-fallback-policy.json +0 -22
  592. package/config/mcp.json +0 -38
  593. package/config/plugin-manifest.json +0 -152
  594. package/config/plugin-manifest.schema.json +0 -244
  595. package/config/remote-memory-policy.json +0 -32
  596. package/dist/api/web/index.d.ts +0 -3
  597. package/dist/api/web/index.js +0 -4
  598. package/dist/api/web/web-server.d.ts +0 -3
  599. package/dist/api/web/web-server.js +0 -6
  600. package/dist/api/web/web.d.ts +0 -4
  601. package/dist/api/web/web.js +0 -639
  602. package/dist/commands/managed-sync.d.ts +0 -10
  603. package/dist/commands/managed-sync.js +0 -64
  604. package/dist/commands/mcp-server.d.ts +0 -3
  605. package/dist/commands/mcp-server.js +0 -393
  606. package/dist/core/context.js +0 -24
  607. package/dist/core/governance.js +0 -64
  608. package/dist/core/local-embeddings.d.ts +0 -6
  609. package/dist/core/local-embeddings.js +0 -20
  610. package/dist/core/namespaces/index.d.ts +0 -71
  611. package/dist/core/namespaces/index.js +0 -305
  612. package/dist/core/namespaces/uri-parser.d.ts +0 -31
  613. package/dist/core/namespaces/uri-parser.js +0 -74
  614. package/dist/core/observations.d.ts +0 -26
  615. package/dist/core/observations.js +0 -110
  616. package/dist/core/requirements.d.ts +0 -20
  617. package/dist/core/requirements.js +0 -35
  618. package/dist/core/search/qmd-search.d.ts +0 -61
  619. package/dist/core/search/qmd-search.js +0 -178
  620. package/dist/core/snapshots.d.ts +0 -29
  621. package/dist/core/snapshots.js +0 -220
  622. package/dist/core/sync/qmd-sync.d.ts +0 -106
  623. package/dist/core/sync/qmd-sync.js +0 -213
  624. package/dist/core/utils.js +0 -74
  625. package/dist/index.d.ts +0 -19
  626. package/dist/index.js +0 -997
  627. package/generated/mcp/manifest.json +0 -23
  628. package/generated/mcp/mcp-servers.json +0 -25
  629. package/generated/mcp/mcporter.json +0 -34
  630. package/generated/mcp/openclaw-memory-qmd.json +0 -17
  631. package/generated/mcp/runtime.json +0 -12
  632. package/hooks/hooks.json +0 -52
  633. package/hooks/post-tool-use.js +0 -26
  634. package/hooks/session-end.js +0 -28
  635. package/hooks/session-start.js +0 -33
  636. package/hooks/user-prompt-submit.js +0 -26
  637. package/hooks/utils.js +0 -153
  638. package/npx-installer.js +0 -208
  639. package/packages/plugin-claude-code/README.md +0 -73
  640. package/packages/plugin-claude-code/dist/plugin-wrapper.d.ts +0 -35
  641. package/packages/plugin-claude-code/dist/plugin-wrapper.js +0 -191
  642. package/packages/plugin-claude-code/package.json +0 -31
  643. package/packages/plugin-openclaw/README.md +0 -70
  644. package/packages/plugin-openclaw/dist/index.d.ts +0 -49
  645. package/packages/plugin-openclaw/dist/index.js +0 -262
  646. package/packages/plugin-openclaw/openclaw.plugin.json +0 -94
  647. package/packages/plugin-openclaw/package.json +0 -31
  648. package/packages/plugin-opencode/install.mjs +0 -217
  649. package/packages/plugin-opencode/package.json +0 -21
  650. package/plugin.json +0 -32
  651. package/scripts/build-release.sh +0 -36
  652. package/scripts/check-secrets.js +0 -132
  653. package/scripts/db/check-db.mjs +0 -88
  654. package/scripts/db/fix-all-columns.mjs +0 -52
  655. package/scripts/db/fix-schema-all.mjs +0 -55
  656. package/scripts/db/fix-schema-full.mjs +0 -46
  657. package/scripts/db/fix-schema.mjs +0 -38
  658. package/scripts/db/init-db.mjs +0 -13
  659. package/scripts/db/recreate-db.mjs +0 -14
  660. package/scripts/generate-mcp.mjs +0 -264
  661. package/scripts/github-release.sh +0 -77
  662. package/scripts/init-dirs.mjs +0 -13
  663. package/scripts/install-interactive.mjs +0 -677
  664. package/scripts/install-mcp.mjs +0 -116
  665. package/scripts/install-plugin.mjs +0 -415
  666. package/scripts/install-web.sh +0 -120
  667. package/scripts/install.mjs +0 -340
  668. package/scripts/openclaw-bootstrap.mjs +0 -127
  669. package/scripts/package-release.sh +0 -71
  670. package/scripts/remote-preflight.mjs +0 -62
  671. package/scripts/squish-fallback.mjs +0 -132
  672. package/scripts/test/test-all-systems.mjs +0 -139
  673. package/scripts/test/test-memory-system.mjs +0 -139
  674. package/scripts/test/test-v0.5.0.mjs +0 -210
  675. package/scripts/test-interactive.mjs +0 -131
  676. package/scripts/verify-mcp.mjs +0 -214
  677. package/skills/memory-guide/SKILL.md +0 -332
  678. package/skills/squish-cli/SKILL.md +0 -240
  679. package/skills/squish-mcp/SKILL.md +0 -355
  680. package/skills/squish-memory/install.mjs +0 -335
  681. package/skills/squish-memory/skill.json +0 -32
  682. /package/dist/{algorithms → core/algorithms}/detection/hash-filters.d.ts +0 -0
  683. /package/dist/{algorithms → core/algorithms}/detection/hash-filters.js +0 -0
  684. /package/dist/{algorithms → core/algorithms}/handlers/approve-merge.d.ts +0 -0
  685. /package/dist/{algorithms → core/algorithms}/handlers/detect-duplicates.d.ts +0 -0
  686. /package/dist/{algorithms → core/algorithms}/handlers/get-stats.d.ts +0 -0
  687. /package/dist/{algorithms → core/algorithms}/handlers/list-proposals.d.ts +0 -0
  688. /package/dist/{algorithms → core/algorithms}/handlers/preview-merge.d.ts +0 -0
  689. /package/dist/{algorithms → core/algorithms}/handlers/reject-merge.d.ts +0 -0
  690. /package/dist/{algorithms → core/algorithms}/handlers/reverse-merge.d.ts +0 -0
  691. /package/dist/{algorithms → core/algorithms}/safety/safety-checks.js +0 -0
  692. /package/dist/{algorithms → core/algorithms}/utils/response-builder.d.ts +0 -0
  693. /package/dist/{algorithms → core/algorithms}/utils/response-builder.js +0 -0
  694. /package/dist/core/{context.d.ts → context/context.d.ts} +0 -0
  695. /package/dist/core/{agent-memory.d.ts → ingestion/agent-memory.d.ts} +0 -0
  696. /package/dist/core/{privacy.d.ts → security/privacy.d.ts} +0 -0
  697. /package/dist/core/{privacy.js → security/privacy.js} +0 -0
  698. /package/dist/core/{secret-detector.d.ts → security/secret-detector.d.ts} +0 -0
  699. /package/dist/core/{secret-detector.js → security/secret-detector.js} +0 -0
  700. /package/dist/core/{session-hooks → session}/session-hooks.d.ts +0 -0
  701. /package/dist/core/{session-hooks → session}/session-hooks.js +0 -0
  702. /package/dist/core/{cache.d.ts → storage/cache.d.ts} +0 -0
  703. /package/dist/core/{database.d.ts → storage/database.d.ts} +0 -0
  704. /package/dist/core/{database.js → storage/database.js} +0 -0
@@ -1,677 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * Squish Interactive Plugin Installer
5
- * Multi-step wizard with clack
6
- */
7
-
8
- import { intro, outro, confirm, multiselect, select, isCancel, cancel, spinner, note } from '@clack/prompts';
9
- import picocolors from 'picocolors';
10
- import fs from "node:fs";
11
- import os from "node:os";
12
- import path from "node:path";
13
- import { spawnSync } from "node:child_process";
14
-
15
- const root = process.cwd();
16
- const manifestPath = path.join(root, "config", "plugin-manifest.json");
17
-
18
- const c = picocolors;
19
-
20
- const icons = {
21
- squish: "🐙",
22
- check: "✓",
23
- cross: "✗",
24
- package: "📦",
25
- arrow: "→",
26
- dot: "●",
27
- circle: "○",
28
- diamond: "◆",
29
- pointer: "❯",
30
- line: "│",
31
- corner: "└",
32
- section: "─",
33
- cli: "⌨️",
34
- mcp: "🔌",
35
- plugin: "🔧",
36
- settings: "⚙️",
37
- local: "🏠",
38
- remote: "☁️",
39
- brain: "🧠",
40
- cloud: "☁️"
41
- };
42
-
43
- const CLIENT_DIRS = {
44
- "claude-code": path.join(os.homedir(), ".claude"),
45
- opencode: path.join(os.homedir(), ".config", "opencode"),
46
- codex: path.join(os.homedir(), ".codex"),
47
- cursor: path.join(os.homedir(), ".cursor"),
48
- vscode: path.join(os.homedir(), ".vscode", "mcp"),
49
- windsurf: path.join(os.homedir(), ".windsurf"),
50
- openclaw: path.join(os.homedir(), ".openclaw")
51
- };
52
-
53
- const PLUGINS_DIR = path.join(root, "packages");
54
-
55
- function printLogo() {
56
- console.log(c.cyan(`
57
- ███████╗ ██████╗ ██╗ ██╗██╗███████╗██╗ ██╗
58
- ██╔════╝██╔═══██╗██║ ██║██║██╔════╝██║ ██║
59
- ███████╗██║ ██║██║ ██║██║███████╗███████║
60
- ╚════██║██║ ██║██║ ██║██║╚════██║██╔══██║
61
- ███████║╚██████╔╝╚██████╔╝██║███████║██║ ██║
62
- ╚══════╝ ╚═════╝ ╚═════╝ ╚═╝╚══════╝╚═╝ ╚═╝
63
- `));
64
- console.log(c.gray(" Universal Memory System for AI Agents\n"));
65
- }
66
-
67
- function loadManifest() {
68
- if (!fs.existsSync(manifestPath)) {
69
- return null;
70
- }
71
- try {
72
- return JSON.parse(fs.readFileSync(manifestPath, "utf8"));
73
- } catch {
74
- return null;
75
- }
76
- }
77
-
78
- function detectInstalledClients() {
79
- const installed = {};
80
- for (const [client, dir] of Object.entries(CLIENT_DIRS)) {
81
- try {
82
- installed[client] = fs.existsSync(dir);
83
- } catch {
84
- installed[client] = false;
85
- }
86
- }
87
- return installed;
88
- }
89
-
90
- function checkPluginSource(pluginId) {
91
- const pluginDirs = {
92
- "claude-code": path.join(PLUGINS_DIR, "plugin-claude-code"),
93
- "openclaw": path.join(PLUGINS_DIR, "plugin-openclaw"),
94
- "opencode": path.join(PLUGINS_DIR, "plugin-opencode")
95
- };
96
-
97
- const pluginDir = pluginDirs[pluginId];
98
- if (!pluginDir) return false;
99
-
100
- return fs.existsSync(pluginDir) && fs.existsSync(path.join(pluginDir, "package.json"));
101
- }
102
-
103
- function shouldUseNonInteractive() {
104
- return process.env.CI === 'true' ||
105
- process.env.NON_INTERACTIVE === '1' ||
106
- process.env.AUTOMATION === 'true' ||
107
- !process.stdin.isTTY;
108
- }
109
-
110
- function parseArgs(argv) {
111
- const flags = {
112
- auto: false,
113
- select: [],
114
- all: false,
115
- list: false,
116
- dryRun: false,
117
- help: false,
118
- verbose: false,
119
- quick: false,
120
- interactive: false
121
- };
122
-
123
- for (let i = 2; i < argv.length; i++) {
124
- const token = argv[i];
125
-
126
- if (token === "--auto" || token === "-a") {
127
- flags.auto = true;
128
- } else if (token === "--all") {
129
- flags.all = true;
130
- } else if (token === "--list" || token === "-l") {
131
- flags.list = true;
132
- } else if (token === "--dry-run" || token === "-n") {
133
- flags.dryRun = true;
134
- } else if (token === "--verbose" || token === "-v") {
135
- flags.verbose = true;
136
- } else if (token === "--help" || token === "-h") {
137
- flags.help = true;
138
- } else if (token === "--quick" || token === "-q") {
139
- flags.quick = true;
140
- } else if (token === "--interactive" || token === "-i") {
141
- flags.interactive = true;
142
- } else if (token.startsWith("--select=")) {
143
- flags.select = token.slice(9).split(",").map(s => s.trim());
144
- } else if (token === "--select") {
145
- flags.select = [argv[i + 1]];
146
- i++;
147
- } else {
148
- console.log(c.red(`Unknown flag: ${token}`));
149
- console.log(`Run ${c.cyan("--help")} for usage information`);
150
- process.exit(1);
151
- }
152
- }
153
-
154
- return flags;
155
- }
156
-
157
- function printHelp() {
158
- printLogo();
159
- console.log(c.white("USAGE:"));
160
- console.log(` ${c.cyan("bun run install:interactive")} [OPTIONS]\n`);
161
-
162
- console.log(c.white("OPTIONS:"));
163
- console.log(` ${c.cyan("--auto")}, ${c.cyan("-a")} Skip menu, install all available plugins`);
164
- console.log(` ${c.cyan("--quick")}, ${c.cyan("-q")} Quick install (CLI + all plugins)`);
165
- console.log(` ${c.cyan("--select")}=<list> Pre-select plugins (comma-separated)`);
166
- console.log(` ${c.cyan("--all")} Install all available plugins`);
167
- console.log(` ${c.cyan("--list")}, ${c.cyan("-l")} List available plugins and exit`);
168
- console.log(` ${c.cyan("--dry-run")}, ${c.cyan("-n")} Preview changes without installing`);
169
- console.log(` ${c.cyan("--verbose")}, ${c.cyan("-v")} Show detailed output`);
170
- console.log(` ${c.cyan("--help")}, ${c.cyan("-h")} Show this help message\n`);
171
-
172
- console.log(c.white("ENVIRONMENT VARIABLES:"));
173
- console.log(` ${c.cyan("CI=true")} Force non-interactive mode`);
174
- console.log(` ${c.cyan("NON_INTERACTIVE=1")} Force non-interactive mode`);
175
- console.log(` ${c.cyan("AUTOMATION=true")} Force non-interactive mode\n`);
176
-
177
- console.log(c.white("INTERACTIVE WIZARD:"));
178
- console.log(` ${c.gray("1.")} Select components: CLI, MCP Server, Plugins`);
179
- console.log(` ${c.gray("2.")} Choose plugins (if selected)`);
180
- console.log(` ${c.gray("3.")} Configure mode (local/remote)`);
181
- console.log(` ${c.gray("4.")} Review and install\n`);
182
-
183
- console.log(c.white("EXAMPLES:"));
184
- console.log(` ${c.gray("# Interactive wizard (default)")}`);
185
- console.log(` ${c.gray("$")} bun run install:interactive\n`);
186
- console.log(` ${c.gray("# Quick install (CLI + all plugins)")}`);
187
- console.log(` ${c.gray("$")} bun run install:interactive --quick\n`);
188
- console.log(` ${c.gray("# Non-interactive: install all")}`);
189
- console.log(` ${c.gray("$")} bun run install:interactive --auto\n`);
190
-
191
- console.log(c.gray("────────────────────────────────────────────────────"));
192
- console.log(c.gray("Documentation: https://github.com/michielhdoteth/squish"));
193
- }
194
-
195
- function listPlugins() {
196
- const manifest = loadManifest();
197
- if (!manifest || !manifest.targets) {
198
- console.log(c.red("Error: Plugin manifest not found"));
199
- process.exit(1);
200
- }
201
-
202
- const installed = detectInstalledClients();
203
- const clientNames = {
204
- "claude-code": "Claude Code",
205
- "openclaw": "OpenClaw",
206
- "opencode": "OpenCode",
207
- "codex": "Codex",
208
- "cursor": "Cursor",
209
- "vscode": "VS Code",
210
- "windsurf": "Windsurf"
211
- };
212
-
213
- printLogo();
214
- console.log(c.white("Available Plugins:"));
215
- console.log(c.gray("────────────────────────────────────────────────────"));
216
- console.log();
217
-
218
- let i = 1;
219
- for (const [client, config] of Object.entries(manifest.targets)) {
220
- const isInstalled = installed[client];
221
- const hasSource = checkPluginSource(client);
222
-
223
- const status = isInstalled
224
- ? `${c.green(icons.check)} installed`
225
- : `${c.yellow(icons.dot)} not installed`;
226
-
227
- const source = hasSource
228
- ? `${c.cyan(icons.package)} source`
229
- : `${c.red(icons.cross)} no source`;
230
-
231
- console.log(` ${i}. ${c.white(clientNames[client] || client)}`);
232
- console.log(` ${c.gray("Type:")} ${config.type || 'unknown'}`);
233
- console.log(` ${status} ${source}`);
234
- console.log();
235
- i++;
236
- }
237
-
238
- console.log(c.gray("────────────────────────────────────────────────────"));
239
- console.log(c.gray(`Total: ${i - 1} plugins available`));
240
- }
241
-
242
- function getPluginChoices() {
243
- const manifest = loadManifest();
244
- if (!manifest || !manifest.targets) {
245
- return [];
246
- }
247
-
248
- const installed = detectInstalledClients();
249
- const clientNames = {
250
- "claude-code": "Claude Code",
251
- "openclaw": "OpenClaw",
252
- "opencode": "OpenCode",
253
- "codex": "Codex",
254
- "cursor": "Cursor",
255
- "vscode": "VS Code",
256
- "windsurf": "Windsurf"
257
- };
258
-
259
- const typeDescriptions = {
260
- "hooks": "Session hooks for auto-memory",
261
- "plugin-slot": "Memory slot via MCP bridge",
262
- "mcp": "MCP server configuration"
263
- };
264
-
265
- return Object.entries(manifest.targets).map(([client, config]) => {
266
- const isInstalled = installed[client];
267
- const hasSource = checkPluginSource(client);
268
-
269
- const name = clientNames[client] || client;
270
- const type = typeDescriptions[config.type] || config.type || 'Plugin';
271
-
272
- let label = name;
273
- if (isInstalled) label += ` ${c.green(icons.check)}`;
274
- if (hasSource) label += ` ${c.cyan(icons.package)}`;
275
-
276
- return {
277
- value: client,
278
- label: label,
279
- hint: type
280
- };
281
- });
282
- }
283
-
284
- async function wizardComponentSelection() {
285
- const components = await multiselect({
286
- message: 'What would you like to install?',
287
- options: [
288
- {
289
- value: 'cli',
290
- label: `${icons.cli} CLI - Command line interface`,
291
- hint: 'squish command for terminal use'
292
- },
293
- {
294
- value: 'plugins',
295
- label: `${icons.plugin} AI Agent Plugins`,
296
- hint: 'Claude Code, OpenClaw, OpenCode, etc.'
297
- }
298
- ],
299
- required: false
300
- });
301
-
302
- if (isCancel(components)) {
303
- cancel('Installation cancelled');
304
- process.exit(0);
305
- }
306
-
307
- return components;
308
- }
309
-
310
- async function wizardPluginSelection() {
311
- const choices = getPluginChoices();
312
-
313
- if (choices.length === 0) {
314
- console.log(c.yellow("No plugins available"));
315
- return [];
316
- }
317
-
318
- const plugins = await multiselect({
319
- message: 'Which AI agents do you want to integrate with?',
320
- options: choices,
321
- required: false
322
- });
323
-
324
- if (isCancel(plugins)) {
325
- cancel('Installation cancelled');
326
- process.exit(0);
327
- }
328
-
329
- return plugins;
330
- }
331
-
332
- async function wizardConfiguration() {
333
- const mode = await select({
334
- message: 'Select operation mode:',
335
- options: [
336
- {
337
- value: 'local',
338
- label: `${icons.local} Local Mode`,
339
- hint: 'Everything runs locally (default, recommended)'
340
- },
341
- {
342
- value: 'remote',
343
- label: `${icons.remote} Remote Mode`,
344
- hint: 'Connect to remote Squish server'
345
- }
346
- ]
347
- });
348
-
349
- if (isCancel(mode)) {
350
- cancel('Installation cancelled');
351
- process.exit(0);
352
- }
353
-
354
- const embeddings = await select({
355
- message: 'Select embeddings provider:',
356
- options: [
357
- {
358
- value: 'local',
359
- label: `${icons.brain} Local Embeddings`,
360
- hint: 'Uses local CPU (default, free, private)'
361
- },
362
- {
363
- value: 'openai',
364
- label: `${icons.cloud} OpenAI Embeddings`,
365
- hint: 'Requires OPENAI_API_KEY (better quality)'
366
- },
367
- {
368
- value: 'cohere',
369
- label: `${icons.cloud} Cohere Embeddings`,
370
- hint: 'Requires COHERE_API_KEY'
371
- }
372
- ]
373
- });
374
-
375
- if (isCancel(embeddings)) {
376
- cancel('Installation cancelled');
377
- process.exit(0);
378
- }
379
-
380
- return { mode, embeddings };
381
- }
382
-
383
- async function wizardReview(installConfig) {
384
- const { components, plugins, config } = installConfig;
385
-
386
- let summary = `${c.white("Installation Summary:")}\n\n`;
387
-
388
- summary += `${c.cyan("Components:")}\n`;
389
- if (components.includes('cli')) summary += ` ${icons.check} CLI\n`;
390
- if (components.includes('mcp')) summary += ` ${icons.check} MCP Server\n`;
391
- if (components.includes('plugins')) summary += ` ${icons.check} AI Agent Plugins\n`;
392
-
393
- if (components.includes('plugins') && plugins.length > 0) {
394
- summary += `\n${c.cyan("Plugins:")}\n`;
395
- plugins.forEach(p => {
396
- summary += ` ${icons.check} ${p}\n`;
397
- });
398
- }
399
-
400
- summary += `\n${c.cyan("Configuration:")}\n`;
401
- summary += ` ${icons.settings} Mode: ${config.mode}\n`;
402
- summary += ` ${icons.brain} Embeddings: ${config.embeddings}\n`;
403
-
404
- note(summary, 'Review');
405
-
406
- const shouldInstall = await confirm({
407
- message: 'Proceed with installation?',
408
- initialValue: true
409
- });
410
-
411
- if (isCancel(shouldInstall) || !shouldInstall) {
412
- cancel('Installation cancelled');
413
- process.exit(0);
414
- }
415
-
416
- return shouldInstall;
417
- }
418
-
419
- async function performInstallation(installConfig, options = {}) {
420
- const { components, plugins, config } = installConfig;
421
- const s = spinner();
422
-
423
- if (options.dryRun) {
424
- console.log();
425
- note(`${c.yellow("Dry-run mode - no changes made")}\n\nRemove --dry-run flag to perform actual installation.`, 'Preview');
426
- return;
427
- }
428
-
429
- // Install dependencies
430
- if (components.length > 0 || plugins.length > 0) {
431
- s.start('Installing dependencies...');
432
-
433
- const depResult = spawnSync(
434
- process.execPath,
435
- [path.join(root, "scripts", "dependency-manager.mjs")],
436
- { encoding: "utf8", stdio: "pipe", timeout: 120000 }
437
- );
438
-
439
- if (depResult.status !== 0) {
440
- s.stop(c.red(`${icons.cross} Dependency installation failed`));
441
- if (options.verbose && depResult.stderr) {
442
- console.log(c.gray(`Error: ${depResult.stderr}`));
443
- }
444
- process.exit(1);
445
- }
446
-
447
- s.stop(c.green(`${icons.check} Dependencies installed`));
448
- }
449
-
450
- // Install CLI
451
- if (components.includes('cli')) {
452
- s.start('Setting up CLI...');
453
- // CLI is already available via npm install, but we could add global link
454
- s.stop(c.green(`${icons.check} CLI ready`));
455
- }
456
-
457
- // Install plugins
458
- if (components.includes('plugins') && plugins.length > 0) {
459
- // Handle OpenCode specially - use its own installer
460
- const opencodeIndex = plugins.indexOf('opencode');
461
- if (opencodeIndex > -1) {
462
- plugins.splice(opencodeIndex, 1);
463
-
464
- s.start('Installing OpenCode plugin...');
465
- const opencodeResult = spawnSync(
466
- process.execPath,
467
- [path.join(root, "packages", "plugin-opencode", "install.mjs")],
468
- { encoding: "utf8", stdio: "pipe", timeout: 60000 }
469
- );
470
-
471
- if (opencodeResult.status !== 0) {
472
- s.stop(c.red(`${icons.cross} OpenCode plugin installation failed`));
473
- if (options.verbose && opencodeResult.stderr) {
474
- console.log(c.gray(`Error: ${opencodeResult.stderr}`));
475
- }
476
- } else {
477
- s.stop(c.green(`${icons.check} OpenCode plugin installed`));
478
- }
479
- }
480
-
481
- // Install remaining plugins using general installer
482
- if (plugins.length > 0) {
483
- s.start(`Installing ${plugins.length} plugin(s)...`);
484
-
485
- const installResult = spawnSync(
486
- process.execPath,
487
- [path.join(root, "scripts", "install-plugin.mjs"), "--client=" + plugins.join(",")],
488
- { encoding: "utf8", stdio: "pipe", timeout: 300000 }
489
- );
490
-
491
- if (installResult.status !== 0) {
492
- s.stop(c.red(`${icons.cross} Plugin installation failed`));
493
- if (options.verbose && installResult.stderr) {
494
- console.log(c.gray(`Error: ${installResult.stderr}`));
495
- }
496
- process.exit(1);
497
- }
498
-
499
- s.stop(c.green(`${icons.check} Plugins installed`));
500
- }
501
- }
502
-
503
- // Save configuration
504
- if (config) {
505
- s.start('Saving configuration...');
506
- // Save config to ~/.squish/config.json
507
- const configPath = path.join(os.homedir(), '.squish', 'config.json');
508
- const configDir = path.dirname(configPath);
509
-
510
- if (!fs.existsSync(configDir)) {
511
- fs.mkdirSync(configDir, { recursive: true });
512
- }
513
-
514
- fs.writeFileSync(configPath, JSON.stringify({
515
- mode: config.mode,
516
- embeddingsProvider: config.embeddings,
517
- installedAt: new Date().toISOString(),
518
- version: '1.0.0'
519
- }, null, 2));
520
-
521
- s.stop(c.green(`${icons.check} Configuration saved`));
522
- }
523
- }
524
-
525
- async function runWizard(options = {}) {
526
- printLogo();
527
-
528
- intro(c.cyan(`${icons.squish} Squish Memory Installer`));
529
-
530
- // Step 1: Component selection
531
- const components = await wizardComponentSelection();
532
-
533
- if (components.length === 0) {
534
- cancel('No components selected. Exiting.');
535
- process.exit(0);
536
- }
537
-
538
- // Step 2: Plugin selection (if chosen)
539
- let plugins = [];
540
- if (components.includes('plugins')) {
541
- plugins = await wizardPluginSelection();
542
- }
543
-
544
- // Step 3: Configuration
545
- const config = await wizardConfiguration();
546
-
547
- // Step 4: Review
548
- const installConfig = { components, plugins, config };
549
- await wizardReview(installConfig);
550
-
551
- // Step 5: Install
552
- console.log();
553
- await performInstallation(installConfig, options);
554
-
555
- // Success
556
- console.log();
557
- outro(c.green(`${icons.check} Installation Complete!`));
558
-
559
- // Next steps
560
- console.log();
561
- console.log(c.white("What's next?"));
562
- console.log(` ${c.cyan(icons.arrow)} Restart your AI assistant(s)`);
563
- console.log(` ${c.cyan(icons.arrow)} Try: ${c.gray("squish health")}`);
564
- console.log(` ${c.cyan(icons.arrow)} Try: ${c.cyan("squish remember \"Your first memory\"")}`);
565
- console.log();
566
- console.log(c.gray("Documentation: https://github.com/michielhdoteth/squish"));
567
- }
568
-
569
- async function handleNonInteractive(flags, options) {
570
- const choices = getPluginChoices();
571
-
572
- if (choices.length === 0) {
573
- console.log(c.red("No plugins available"));
574
- process.exit(1);
575
- }
576
-
577
- let pluginIds = [];
578
- let components = ['cli'];
579
-
580
- if (flags.quick) {
581
- // Quick install: CLI + all plugins
582
- pluginIds = choices.map(c => c.value);
583
- components = ['cli', 'plugins'];
584
- if (options.verbose) {
585
- printLogo();
586
- console.log(`${c.cyan("[QUICK MODE]")} Installing CLI + all plugins...\n`);
587
- }
588
- } else if (flags.all) {
589
- pluginIds = choices.map(c => c.value);
590
- components = ['cli', 'mcp', 'plugins'];
591
- if (options.verbose) {
592
- printLogo();
593
- console.log(`${c.cyan("[AUTO MODE]")} Installing all components...\n`);
594
- }
595
- } else if (flags.select.length > 0) {
596
- const validIds = choices.map(c => c.value);
597
- const invalid = flags.select.filter(s => !validIds.includes(s));
598
-
599
- if (invalid.length > 0) {
600
- console.log(c.red(`Invalid plugins: ${invalid.join(", ")}`));
601
- console.log(c.gray(`Available: ${validIds.join(", ")}`));
602
- process.exit(1);
603
- }
604
-
605
- pluginIds = flags.select;
606
- components = ['cli', 'plugins'];
607
- if (options.verbose) {
608
- printLogo();
609
- console.log(`${c.cyan("[AUTO MODE]")} Installing: ${pluginIds.join(", ")}...\n`);
610
- }
611
- } else {
612
- console.log(c.yellow("Auto mode requires --all, --quick, or --select flag"));
613
- const validIds = choices.map(c => c.value);
614
- console.log(c.gray(`Available: ${validIds.join(", ")}`));
615
- console.log(`Use ${c.cyan("--list")} to see all options`);
616
- process.exit(1);
617
- }
618
-
619
- const installConfig = {
620
- components,
621
- plugins: pluginIds,
622
- config: { mode: 'local', embeddings: 'local' }
623
- };
624
-
625
- await performInstallation(installConfig, options);
626
- }
627
-
628
- async function main() {
629
- const flags = parseArgs(process.argv);
630
-
631
- if (flags.help) {
632
- printHelp();
633
- process.exit(0);
634
- }
635
-
636
- if (flags.list) {
637
- listPlugins();
638
- process.exit(0);
639
- }
640
-
641
- const manifest = loadManifest();
642
- if (!manifest) {
643
- console.log(c.red("Error: Plugin manifest not found"));
644
- console.log(c.gray(`Expected: ${manifestPath}`));
645
- process.exit(1);
646
- }
647
-
648
- const options = {
649
- dryRun: flags.dryRun,
650
- verbose: flags.verbose
651
- };
652
-
653
- // Non-interactive mode (only if explicitly requested and not in interactive mode)
654
- if (!flags.interactive && (flags.auto || flags.quick || flags.select.length > 0 || shouldUseNonInteractive())) {
655
- await handleNonInteractive(flags, options);
656
- return;
657
- }
658
-
659
- // Interactive wizard mode (default when no flags, or when --interactive is passed)
660
- await runWizard(options);
661
- }
662
-
663
- process.on("SIGINT", () => {
664
- console.log(`\n${c.yellow("Installation cancelled.")}`);
665
- process.exit(0);
666
- });
667
-
668
- process.on("SIGTERM", () => {
669
- console.log(`\n${c.yellow("Installation cancelled.")}`);
670
- process.exit(0);
671
- });
672
-
673
- main().catch((err) => {
674
- console.log(c.red(`Fatal error: ${err.message}`));
675
- console.error(err);
676
- process.exit(1);
677
- });