@pcircle/memesh 2.6.6 → 2.7.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 (430) hide show
  1. package/README.md +116 -54
  2. package/README.zh-TW.md +198 -33
  3. package/dist/a2a/client/A2AClient.d.ts +7 -1
  4. package/dist/a2a/client/A2AClient.d.ts.map +1 -1
  5. package/dist/a2a/client/A2AClient.js +197 -61
  6. package/dist/a2a/client/A2AClient.js.map +1 -1
  7. package/dist/a2a/constants.d.ts +34 -0
  8. package/dist/a2a/constants.d.ts.map +1 -0
  9. package/dist/a2a/constants.js +34 -0
  10. package/dist/a2a/constants.js.map +1 -0
  11. package/dist/a2a/delegator/MCPTaskDelegator.d.ts +19 -0
  12. package/dist/a2a/delegator/MCPTaskDelegator.d.ts.map +1 -0
  13. package/dist/a2a/delegator/MCPTaskDelegator.js +184 -0
  14. package/dist/a2a/delegator/MCPTaskDelegator.js.map +1 -0
  15. package/dist/a2a/delegator/index.d.ts +3 -0
  16. package/dist/a2a/delegator/index.d.ts.map +1 -0
  17. package/dist/a2a/delegator/index.js +2 -0
  18. package/dist/a2a/delegator/index.js.map +1 -0
  19. package/dist/a2a/delegator/types.d.ts +9 -0
  20. package/dist/a2a/delegator/types.d.ts.map +1 -0
  21. package/dist/a2a/delegator/types.js +2 -0
  22. package/dist/a2a/delegator/types.js.map +1 -0
  23. package/dist/a2a/errors/ErrorCodes.d.ts +26 -0
  24. package/dist/a2a/errors/ErrorCodes.d.ts.map +1 -0
  25. package/dist/a2a/errors/ErrorCodes.js +25 -0
  26. package/dist/a2a/errors/ErrorCodes.js.map +1 -0
  27. package/dist/a2a/errors/ErrorMessages.d.ts +28 -0
  28. package/dist/a2a/errors/ErrorMessages.d.ts.map +1 -0
  29. package/dist/a2a/errors/ErrorMessages.js +51 -0
  30. package/dist/a2a/errors/ErrorMessages.js.map +1 -0
  31. package/dist/a2a/errors/index.d.ts +3 -0
  32. package/dist/a2a/errors/index.d.ts.map +1 -0
  33. package/dist/a2a/errors/index.js +3 -0
  34. package/dist/a2a/errors/index.js.map +1 -0
  35. package/dist/a2a/executor/TaskExecutor.d.ts +6 -4
  36. package/dist/a2a/executor/TaskExecutor.d.ts.map +1 -1
  37. package/dist/a2a/executor/TaskExecutor.js +8 -47
  38. package/dist/a2a/executor/TaskExecutor.js.map +1 -1
  39. package/dist/a2a/jobs/TimeoutChecker.d.ts +49 -0
  40. package/dist/a2a/jobs/TimeoutChecker.d.ts.map +1 -0
  41. package/dist/a2a/jobs/TimeoutChecker.js +176 -0
  42. package/dist/a2a/jobs/TimeoutChecker.js.map +1 -0
  43. package/dist/a2a/metrics/A2AMetrics.d.ts +38 -0
  44. package/dist/a2a/metrics/A2AMetrics.d.ts.map +1 -0
  45. package/dist/a2a/metrics/A2AMetrics.js +142 -0
  46. package/dist/a2a/metrics/A2AMetrics.js.map +1 -0
  47. package/dist/a2a/metrics/index.d.ts +3 -0
  48. package/dist/a2a/metrics/index.d.ts.map +1 -0
  49. package/dist/a2a/metrics/index.js +2 -0
  50. package/dist/a2a/metrics/index.js.map +1 -0
  51. package/dist/a2a/server/A2AServer.d.ts +2 -0
  52. package/dist/a2a/server/A2AServer.d.ts.map +1 -1
  53. package/dist/a2a/server/A2AServer.js +48 -8
  54. package/dist/a2a/server/A2AServer.js.map +1 -1
  55. package/dist/a2a/server/middleware/auth.d.ts +6 -0
  56. package/dist/a2a/server/middleware/auth.d.ts.map +1 -0
  57. package/dist/a2a/server/middleware/auth.js +64 -0
  58. package/dist/a2a/server/middleware/auth.js.map +1 -0
  59. package/dist/a2a/server/middleware/csrf.d.ts +7 -0
  60. package/dist/a2a/server/middleware/csrf.d.ts.map +1 -0
  61. package/dist/a2a/server/middleware/csrf.js +169 -0
  62. package/dist/a2a/server/middleware/csrf.js.map +1 -0
  63. package/dist/a2a/server/middleware/rateLimit.d.ts +9 -0
  64. package/dist/a2a/server/middleware/rateLimit.d.ts.map +1 -0
  65. package/dist/a2a/server/middleware/rateLimit.js +192 -0
  66. package/dist/a2a/server/middleware/rateLimit.js.map +1 -0
  67. package/dist/a2a/server/middleware/resourceProtection.d.ts +17 -0
  68. package/dist/a2a/server/middleware/resourceProtection.d.ts.map +1 -0
  69. package/dist/a2a/server/middleware/resourceProtection.js +258 -0
  70. package/dist/a2a/server/middleware/resourceProtection.js.map +1 -0
  71. package/dist/a2a/server/middleware/timeout.d.ts +4 -0
  72. package/dist/a2a/server/middleware/timeout.d.ts.map +1 -0
  73. package/dist/a2a/server/middleware/timeout.js +56 -0
  74. package/dist/a2a/server/middleware/timeout.js.map +1 -0
  75. package/dist/a2a/server/middleware.d.ts.map +1 -1
  76. package/dist/a2a/server/middleware.js +9 -6
  77. package/dist/a2a/server/middleware.js.map +1 -1
  78. package/dist/a2a/server/routes.d.ts +3 -0
  79. package/dist/a2a/server/routes.d.ts.map +1 -1
  80. package/dist/a2a/server/routes.js +24 -7
  81. package/dist/a2a/server/routes.js.map +1 -1
  82. package/dist/a2a/server/validation/index.d.ts +2 -0
  83. package/dist/a2a/server/validation/index.d.ts.map +1 -0
  84. package/dist/a2a/server/validation/index.js +2 -0
  85. package/dist/a2a/server/validation/index.js.map +1 -0
  86. package/dist/a2a/server/validation/sendMessageSchema.d.ts +112 -0
  87. package/dist/a2a/server/validation/sendMessageSchema.d.ts.map +1 -0
  88. package/dist/a2a/server/validation/sendMessageSchema.js +143 -0
  89. package/dist/a2a/server/validation/sendMessageSchema.js.map +1 -0
  90. package/dist/a2a/storage/AgentRegistry.d.ts +7 -0
  91. package/dist/a2a/storage/AgentRegistry.d.ts.map +1 -1
  92. package/dist/a2a/storage/AgentRegistry.js +95 -38
  93. package/dist/a2a/storage/AgentRegistry.js.map +1 -1
  94. package/dist/a2a/storage/TaskQueue.d.ts +3 -0
  95. package/dist/a2a/storage/TaskQueue.d.ts.map +1 -1
  96. package/dist/a2a/storage/TaskQueue.js +80 -18
  97. package/dist/a2a/storage/TaskQueue.js.map +1 -1
  98. package/dist/a2a/storage/inputValidation.d.ts +18 -0
  99. package/dist/a2a/storage/inputValidation.d.ts.map +1 -0
  100. package/dist/a2a/storage/inputValidation.js +101 -0
  101. package/dist/a2a/storage/inputValidation.js.map +1 -0
  102. package/dist/a2a/storage/schemas.sql +11 -1
  103. package/dist/a2a/types/index.d.ts +1 -0
  104. package/dist/a2a/types/index.d.ts.map +1 -1
  105. package/dist/a2a/types/rateLimit.d.ts +26 -0
  106. package/dist/a2a/types/rateLimit.d.ts.map +1 -0
  107. package/dist/a2a/types/rateLimit.js +2 -0
  108. package/dist/a2a/types/rateLimit.js.map +1 -0
  109. package/dist/a2a/types/task.d.ts +1 -1
  110. package/dist/a2a/types/task.d.ts.map +1 -1
  111. package/dist/agents/E2EHealingAgent.js +1 -1
  112. package/dist/agents/E2EHealingAgent.js.map +1 -1
  113. package/dist/agents/knowledge/storage/KnowledgeGraphStore.d.ts.map +1 -1
  114. package/dist/agents/knowledge/storage/KnowledgeGraphStore.js +5 -3
  115. package/dist/agents/knowledge/storage/KnowledgeGraphStore.js.map +1 -1
  116. package/dist/cli/config.d.ts +36 -0
  117. package/dist/cli/config.d.ts.map +1 -0
  118. package/dist/cli/config.js +398 -0
  119. package/dist/cli/config.js.map +1 -0
  120. package/dist/cli/daemon.d.ts +3 -0
  121. package/dist/cli/daemon.d.ts.map +1 -0
  122. package/dist/cli/daemon.js +413 -0
  123. package/dist/cli/daemon.js.map +1 -0
  124. package/dist/cli/dashboard.d.ts +2 -0
  125. package/dist/cli/dashboard.d.ts.map +1 -0
  126. package/dist/cli/dashboard.js +300 -0
  127. package/dist/cli/dashboard.js.map +1 -0
  128. package/dist/cli/index.d.ts +3 -0
  129. package/dist/cli/index.d.ts.map +1 -0
  130. package/dist/cli/index.js +182 -0
  131. package/dist/cli/index.js.map +1 -0
  132. package/dist/cli/setup-wizard.d.ts +18 -0
  133. package/dist/cli/setup-wizard.d.ts.map +1 -0
  134. package/dist/cli/setup-wizard.js +308 -0
  135. package/dist/cli/setup-wizard.js.map +1 -0
  136. package/dist/cli/stats.d.ts +34 -0
  137. package/dist/cli/stats.d.ts.map +1 -0
  138. package/dist/cli/stats.js +479 -0
  139. package/dist/cli/stats.js.map +1 -0
  140. package/dist/cli/tutorial.d.ts +27 -0
  141. package/dist/cli/tutorial.d.ts.map +1 -0
  142. package/dist/cli/tutorial.js +430 -0
  143. package/dist/cli/tutorial.js.map +1 -0
  144. package/dist/config/index.d.ts.map +1 -1
  145. package/dist/config/index.js +8 -7
  146. package/dist/config/index.js.map +1 -1
  147. package/dist/config/simple-config.js.map +1 -1
  148. package/dist/core/BackgroundExecutor.d.ts +6 -0
  149. package/dist/core/BackgroundExecutor.d.ts.map +1 -1
  150. package/dist/core/BackgroundExecutor.js +152 -44
  151. package/dist/core/BackgroundExecutor.js.map +1 -1
  152. package/dist/core/ClaudeMdRuleExtractor.d.ts.map +1 -1
  153. package/dist/core/ClaudeMdRuleExtractor.js +9 -14
  154. package/dist/core/ClaudeMdRuleExtractor.js.map +1 -1
  155. package/dist/core/MistakePatternManager.d.ts.map +1 -1
  156. package/dist/core/MistakePatternManager.js +29 -3
  157. package/dist/core/MistakePatternManager.js.map +1 -1
  158. package/dist/core/ResourceMonitor.d.ts.map +1 -1
  159. package/dist/core/ResourceMonitor.js +64 -2
  160. package/dist/core/ResourceMonitor.js.map +1 -1
  161. package/dist/core/ResultHandler.d.ts.map +1 -1
  162. package/dist/core/ResultHandler.js +12 -0
  163. package/dist/core/ResultHandler.js.map +1 -1
  164. package/dist/core/SessionContextMonitor.d.ts.map +1 -1
  165. package/dist/core/SessionContextMonitor.js +4 -1
  166. package/dist/core/SessionContextMonitor.js.map +1 -1
  167. package/dist/core/SessionTokenTracker.d.ts.map +1 -1
  168. package/dist/core/SessionTokenTracker.js +58 -2
  169. package/dist/core/SessionTokenTracker.js.map +1 -1
  170. package/dist/db/ConnectionPool.d.ts.map +1 -1
  171. package/dist/db/ConnectionPool.js +111 -37
  172. package/dist/db/ConnectionPool.js.map +1 -1
  173. package/dist/db/QueryCache.d.ts.map +1 -1
  174. package/dist/db/QueryCache.js +8 -5
  175. package/dist/db/QueryCache.js.map +1 -1
  176. package/dist/errors/ErrorClassifier.d.ts +60 -0
  177. package/dist/errors/ErrorClassifier.d.ts.map +1 -0
  178. package/dist/errors/ErrorClassifier.js +443 -0
  179. package/dist/errors/ErrorClassifier.js.map +1 -0
  180. package/dist/errors/index.d.ts +1 -0
  181. package/dist/errors/index.d.ts.map +1 -1
  182. package/dist/errors/index.js +3 -0
  183. package/dist/errors/index.js.map +1 -1
  184. package/dist/evolution/ABTestManager.d.ts.map +1 -1
  185. package/dist/evolution/ABTestManager.js +80 -1
  186. package/dist/evolution/ABTestManager.js.map +1 -1
  187. package/dist/evolution/EvolutionBootstrap.d.ts.map +1 -1
  188. package/dist/evolution/EvolutionBootstrap.js +4 -4
  189. package/dist/evolution/EvolutionBootstrap.js.map +1 -1
  190. package/dist/evolution/FeedbackCollector.d.ts.map +1 -1
  191. package/dist/evolution/FeedbackCollector.js +6 -0
  192. package/dist/evolution/FeedbackCollector.js.map +1 -1
  193. package/dist/evolution/LearningManager.d.ts.map +1 -1
  194. package/dist/evolution/LearningManager.js +16 -0
  195. package/dist/evolution/LearningManager.js.map +1 -1
  196. package/dist/evolution/MultiObjectiveOptimizer.d.ts.map +1 -1
  197. package/dist/evolution/MultiObjectiveOptimizer.js +18 -3
  198. package/dist/evolution/MultiObjectiveOptimizer.js.map +1 -1
  199. package/dist/evolution/PerformanceTracker.d.ts.map +1 -1
  200. package/dist/evolution/PerformanceTracker.js +83 -13
  201. package/dist/evolution/PerformanceTracker.js.map +1 -1
  202. package/dist/evolution/StatisticalAnalyzer.d.ts +1 -0
  203. package/dist/evolution/StatisticalAnalyzer.d.ts.map +1 -1
  204. package/dist/evolution/StatisticalAnalyzer.js +126 -9
  205. package/dist/evolution/StatisticalAnalyzer.js.map +1 -1
  206. package/dist/evolution/instrumentation/withEvolutionTracking.d.ts.map +1 -1
  207. package/dist/evolution/instrumentation/withEvolutionTracking.js +0 -2
  208. package/dist/evolution/instrumentation/withEvolutionTracking.js.map +1 -1
  209. package/dist/evolution/storage/SQLiteStore.d.ts +1 -0
  210. package/dist/evolution/storage/SQLiteStore.d.ts.map +1 -1
  211. package/dist/evolution/storage/SQLiteStore.js +59 -12
  212. package/dist/evolution/storage/SQLiteStore.js.map +1 -1
  213. package/dist/evolution/storage/validation.d.ts +2 -3
  214. package/dist/evolution/storage/validation.d.ts.map +1 -1
  215. package/dist/evolution/storage/validation.js +2 -6
  216. package/dist/evolution/storage/validation.js.map +1 -1
  217. package/dist/hooks/a2a-collaboration.d.ts +30 -0
  218. package/dist/hooks/a2a-collaboration.d.ts.map +1 -0
  219. package/dist/hooks/a2a-collaboration.js +400 -0
  220. package/dist/hooks/a2a-collaboration.js.map +1 -0
  221. package/dist/knowledge-graph/index.d.ts +7 -1
  222. package/dist/knowledge-graph/index.d.ts.map +1 -1
  223. package/dist/knowledge-graph/index.js +335 -52
  224. package/dist/knowledge-graph/index.js.map +1 -1
  225. package/dist/knowledge-graph/types.d.ts +1 -0
  226. package/dist/knowledge-graph/types.d.ts.map +1 -1
  227. package/dist/management/UninstallManager.d.ts.map +1 -1
  228. package/dist/management/UninstallManager.js.map +1 -1
  229. package/dist/mcp/BuddyCommands.d.ts +15 -2
  230. package/dist/mcp/BuddyCommands.d.ts.map +1 -1
  231. package/dist/mcp/BuddyCommands.js +635 -52
  232. package/dist/mcp/BuddyCommands.js.map +1 -1
  233. package/dist/mcp/ServerInitializer.d.ts +7 -1
  234. package/dist/mcp/ServerInitializer.d.ts.map +1 -1
  235. package/dist/mcp/ServerInitializer.js +121 -69
  236. package/dist/mcp/ServerInitializer.js.map +1 -1
  237. package/dist/mcp/ToolDefinitions.d.ts.map +1 -1
  238. package/dist/mcp/ToolDefinitions.js +109 -18
  239. package/dist/mcp/ToolDefinitions.js.map +1 -1
  240. package/dist/mcp/ToolRouter.d.ts +6 -0
  241. package/dist/mcp/ToolRouter.d.ts.map +1 -1
  242. package/dist/mcp/ToolRouter.js +90 -2
  243. package/dist/mcp/ToolRouter.js.map +1 -1
  244. package/dist/mcp/daemon/DaemonBootstrap.d.ts +33 -0
  245. package/dist/mcp/daemon/DaemonBootstrap.d.ts.map +1 -0
  246. package/dist/mcp/daemon/DaemonBootstrap.js +155 -0
  247. package/dist/mcp/daemon/DaemonBootstrap.js.map +1 -0
  248. package/dist/mcp/daemon/DaemonLockManager.d.ts +47 -0
  249. package/dist/mcp/daemon/DaemonLockManager.d.ts.map +1 -0
  250. package/dist/mcp/daemon/DaemonLockManager.js +417 -0
  251. package/dist/mcp/daemon/DaemonLockManager.js.map +1 -0
  252. package/dist/mcp/daemon/DaemonProtocol.d.ts +127 -0
  253. package/dist/mcp/daemon/DaemonProtocol.d.ts.map +1 -0
  254. package/dist/mcp/daemon/DaemonProtocol.js +452 -0
  255. package/dist/mcp/daemon/DaemonProtocol.js.map +1 -0
  256. package/dist/mcp/daemon/DaemonSocketServer.d.ts +71 -0
  257. package/dist/mcp/daemon/DaemonSocketServer.d.ts.map +1 -0
  258. package/dist/mcp/daemon/DaemonSocketServer.js +384 -0
  259. package/dist/mcp/daemon/DaemonSocketServer.js.map +1 -0
  260. package/dist/mcp/daemon/GracefulShutdownCoordinator.d.ts +67 -0
  261. package/dist/mcp/daemon/GracefulShutdownCoordinator.d.ts.map +1 -0
  262. package/dist/mcp/daemon/GracefulShutdownCoordinator.js +206 -0
  263. package/dist/mcp/daemon/GracefulShutdownCoordinator.js.map +1 -0
  264. package/dist/mcp/daemon/IpcTransport.d.ts +42 -0
  265. package/dist/mcp/daemon/IpcTransport.d.ts.map +1 -0
  266. package/dist/mcp/daemon/IpcTransport.js +231 -0
  267. package/dist/mcp/daemon/IpcTransport.js.map +1 -0
  268. package/dist/mcp/daemon/StdioProxyClient.d.ts +84 -0
  269. package/dist/mcp/daemon/StdioProxyClient.d.ts.map +1 -0
  270. package/dist/mcp/daemon/StdioProxyClient.js +560 -0
  271. package/dist/mcp/daemon/StdioProxyClient.js.map +1 -0
  272. package/dist/mcp/daemon/VersionManager.d.ts +35 -0
  273. package/dist/mcp/daemon/VersionManager.d.ts.map +1 -0
  274. package/dist/mcp/daemon/VersionManager.js +169 -0
  275. package/dist/mcp/daemon/VersionManager.js.map +1 -0
  276. package/dist/mcp/daemon/index.d.ts +9 -0
  277. package/dist/mcp/daemon/index.d.ts.map +1 -0
  278. package/dist/mcp/daemon/index.js +9 -0
  279. package/dist/mcp/daemon/index.js.map +1 -0
  280. package/dist/mcp/handlers/A2AToolHandlers.d.ts.map +1 -1
  281. package/dist/mcp/handlers/A2AToolHandlers.js +24 -4
  282. package/dist/mcp/handlers/A2AToolHandlers.js.map +1 -1
  283. package/dist/mcp/handlers/ToolHandlers.d.ts.map +1 -1
  284. package/dist/mcp/handlers/ToolHandlers.js.map +1 -1
  285. package/dist/mcp/resources/best-practices.md +1 -1
  286. package/dist/mcp/resources/buddy-do-skill.md +1 -1
  287. package/dist/mcp/resources/examples.md +1 -1
  288. package/dist/mcp/resources/quick-reference.md +1 -1
  289. package/dist/mcp/resources/usage-guide.md +2 -2
  290. package/dist/mcp/schemas/OutputSchemas.d.ts +16 -0
  291. package/dist/mcp/schemas/OutputSchemas.d.ts.map +1 -1
  292. package/dist/mcp/schemas/OutputSchemas.js +12 -0
  293. package/dist/mcp/schemas/OutputSchemas.js.map +1 -1
  294. package/dist/mcp/server-bootstrap.js +245 -29
  295. package/dist/mcp/server-bootstrap.js.map +1 -1
  296. package/dist/mcp/server.d.ts +11 -1
  297. package/dist/mcp/server.d.ts.map +1 -1
  298. package/dist/mcp/server.js +196 -9
  299. package/dist/mcp/server.js.map +1 -1
  300. package/dist/mcp/tools/a2a-list-tasks.d.ts +13 -0
  301. package/dist/mcp/tools/a2a-list-tasks.d.ts.map +1 -0
  302. package/dist/mcp/tools/a2a-list-tasks.js +24 -0
  303. package/dist/mcp/tools/a2a-list-tasks.js.map +1 -0
  304. package/dist/mcp/tools/a2a-report-result.d.ts +35 -0
  305. package/dist/mcp/tools/a2a-report-result.d.ts.map +1 -0
  306. package/dist/mcp/tools/a2a-report-result.js +73 -0
  307. package/dist/mcp/tools/a2a-report-result.js.map +1 -0
  308. package/dist/mcp/tools/buddy-do.d.ts.map +1 -1
  309. package/dist/mcp/tools/buddy-do.js +10 -2
  310. package/dist/mcp/tools/buddy-do.js.map +1 -1
  311. package/dist/mcp/tools/buddy-help.d.ts.map +1 -1
  312. package/dist/mcp/tools/buddy-help.js +6 -14
  313. package/dist/mcp/tools/buddy-help.js.map +1 -1
  314. package/dist/mcp/validation.d.ts +1 -1
  315. package/dist/memory/AutoMemoryRecorder.d.ts +35 -0
  316. package/dist/memory/AutoMemoryRecorder.d.ts.map +1 -0
  317. package/dist/memory/AutoMemoryRecorder.js +164 -0
  318. package/dist/memory/AutoMemoryRecorder.js.map +1 -0
  319. package/dist/memory/AutoTagger.d.ts +9 -0
  320. package/dist/memory/AutoTagger.d.ts.map +1 -0
  321. package/dist/memory/AutoTagger.js +149 -0
  322. package/dist/memory/AutoTagger.js.map +1 -0
  323. package/dist/memory/MistakePatternEngine.d.ts.map +1 -1
  324. package/dist/memory/MistakePatternEngine.js.map +1 -1
  325. package/dist/memory/ProjectMemoryCleanup.js +1 -1
  326. package/dist/memory/SecretManager.d.ts.map +1 -1
  327. package/dist/memory/SecretManager.js +48 -15
  328. package/dist/memory/SecretManager.js.map +1 -1
  329. package/dist/memory/SmartMemoryQuery.d.ts +9 -0
  330. package/dist/memory/SmartMemoryQuery.d.ts.map +1 -0
  331. package/dist/memory/SmartMemoryQuery.js +65 -0
  332. package/dist/memory/SmartMemoryQuery.js.map +1 -0
  333. package/dist/memory/UnifiedMemoryStore.d.ts +1 -0
  334. package/dist/memory/UnifiedMemoryStore.d.ts.map +1 -1
  335. package/dist/memory/UnifiedMemoryStore.js +211 -38
  336. package/dist/memory/UnifiedMemoryStore.js.map +1 -1
  337. package/dist/memory/UserPreferenceEngine.d.ts.map +1 -1
  338. package/dist/memory/UserPreferenceEngine.js +6 -5
  339. package/dist/memory/UserPreferenceEngine.js.map +1 -1
  340. package/dist/memory/types/unified-memory.d.ts +2 -0
  341. package/dist/memory/types/unified-memory.d.ts.map +1 -1
  342. package/dist/memory/types/unified-memory.js +2 -0
  343. package/dist/memory/types/unified-memory.js.map +1 -1
  344. package/dist/orchestrator/AgentRouter.d.ts.map +1 -1
  345. package/dist/orchestrator/AgentRouter.js +5 -4
  346. package/dist/orchestrator/AgentRouter.js.map +1 -1
  347. package/dist/orchestrator/CostTracker.d.ts.map +1 -1
  348. package/dist/orchestrator/CostTracker.js.map +1 -1
  349. package/dist/orchestrator/GlobalResourcePool.d.ts.map +1 -1
  350. package/dist/orchestrator/GlobalResourcePool.js +70 -3
  351. package/dist/orchestrator/GlobalResourcePool.js.map +1 -1
  352. package/dist/ui/AsciiProgressBar.d.ts.map +1 -1
  353. package/dist/ui/AsciiProgressBar.js +0 -1
  354. package/dist/ui/AsciiProgressBar.js.map +1 -1
  355. package/dist/ui/AttributionManager.js +2 -2
  356. package/dist/ui/AttributionManager.js.map +1 -1
  357. package/dist/ui/Dashboard.d.ts.map +1 -1
  358. package/dist/ui/Dashboard.js +2 -2
  359. package/dist/ui/Dashboard.js.map +1 -1
  360. package/dist/ui/MetricsStore.d.ts.map +1 -1
  361. package/dist/ui/MetricsStore.js +2 -2
  362. package/dist/ui/MetricsStore.js.map +1 -1
  363. package/dist/ui/ProgressIndicator.d.ts +35 -0
  364. package/dist/ui/ProgressIndicator.d.ts.map +1 -0
  365. package/dist/ui/ProgressIndicator.js +177 -0
  366. package/dist/ui/ProgressIndicator.js.map +1 -0
  367. package/dist/ui/ResponseFormatter.d.ts +8 -0
  368. package/dist/ui/ResponseFormatter.d.ts.map +1 -1
  369. package/dist/ui/ResponseFormatter.js +220 -35
  370. package/dist/ui/ResponseFormatter.js.map +1 -1
  371. package/dist/ui/design-tokens.d.ts +37 -0
  372. package/dist/ui/design-tokens.d.ts.map +1 -0
  373. package/dist/ui/design-tokens.js +105 -0
  374. package/dist/ui/design-tokens.js.map +1 -0
  375. package/dist/ui/theme.d.ts +14 -4
  376. package/dist/ui/theme.d.ts.map +1 -1
  377. package/dist/ui/theme.js +7 -2
  378. package/dist/ui/theme.js.map +1 -1
  379. package/dist/utils/PathResolver.d.ts.map +1 -1
  380. package/dist/utils/PathResolver.js +3 -2
  381. package/dist/utils/PathResolver.js.map +1 -1
  382. package/dist/utils/SystemResources.d.ts.map +1 -1
  383. package/dist/utils/SystemResources.js +9 -14
  384. package/dist/utils/SystemResources.js.map +1 -1
  385. package/dist/utils/errorHandler.d.ts +6 -0
  386. package/dist/utils/errorHandler.d.ts.map +1 -1
  387. package/dist/utils/errorHandler.js +50 -1
  388. package/dist/utils/errorHandler.js.map +1 -1
  389. package/dist/utils/index.d.ts +19 -0
  390. package/dist/utils/index.d.ts.map +1 -0
  391. package/dist/utils/index.js +17 -0
  392. package/dist/utils/index.js.map +1 -0
  393. package/dist/utils/json.d.ts.map +1 -1
  394. package/dist/utils/json.js +11 -1
  395. package/dist/utils/json.js.map +1 -1
  396. package/dist/utils/logger.d.ts.map +1 -1
  397. package/dist/utils/logger.js +65 -3
  398. package/dist/utils/logger.js.map +1 -1
  399. package/dist/utils/lru-cache.d.ts +7 -0
  400. package/dist/utils/lru-cache.d.ts.map +1 -1
  401. package/dist/utils/lru-cache.js +37 -7
  402. package/dist/utils/lru-cache.js.map +1 -1
  403. package/dist/utils/safeMath.d.ts +11 -0
  404. package/dist/utils/safeMath.d.ts.map +1 -0
  405. package/dist/utils/safeMath.js +92 -0
  406. package/dist/utils/safeMath.js.map +1 -0
  407. package/dist/utils/toonify-adapter.d.ts.map +1 -1
  408. package/dist/utils/toonify-adapter.js.map +1 -1
  409. package/dist/utils/tracing/TraceContext.d.ts +23 -0
  410. package/dist/utils/tracing/TraceContext.d.ts.map +1 -0
  411. package/dist/utils/tracing/TraceContext.js +127 -0
  412. package/dist/utils/tracing/TraceContext.js.map +1 -0
  413. package/dist/utils/tracing/index.d.ts +3 -0
  414. package/dist/utils/tracing/index.d.ts.map +1 -0
  415. package/dist/utils/tracing/index.js +3 -0
  416. package/dist/utils/tracing/index.js.map +1 -0
  417. package/dist/utils/tracing/middleware.d.ts +15 -0
  418. package/dist/utils/tracing/middleware.d.ts.map +1 -0
  419. package/dist/utils/tracing/middleware.js +49 -0
  420. package/dist/utils/tracing/middleware.js.map +1 -0
  421. package/dist/utils/validation.d.ts +12 -0
  422. package/dist/utils/validation.d.ts.map +1 -0
  423. package/dist/utils/validation.js +87 -0
  424. package/dist/utils/validation.js.map +1 -0
  425. package/mcp.json +10 -0
  426. package/package.json +10 -2
  427. package/plugin.json +2 -12
  428. package/scripts/postinstall.js +192 -21
  429. package/README.md.backup +0 -536
  430. package/README.zh-TW.md.backup +0 -446
package/README.md CHANGED
@@ -10,10 +10,12 @@
10
10
 
11
11
  [![GitHub Stars](https://img.shields.io/github/stars/PCIRCLE-AI/claude-code-buddy?style=social)](https://github.com/PCIRCLE-AI/claude-code-buddy)
12
12
  [![npm version](https://img.shields.io/npm/v/@pcircle/memesh)](https://www.npmjs.com/package/@pcircle/memesh)
13
+ [![npm publish](https://github.com/PCIRCLE-AI/claude-code-buddy/actions/workflows/publish-npm.yml/badge.svg)](https://github.com/PCIRCLE-AI/claude-code-buddy/actions/workflows/publish-npm.yml)
14
+ [![Installation Tests](https://github.com/PCIRCLE-AI/claude-code-buddy/actions/workflows/installation-test.yml/badge.svg)](https://github.com/PCIRCLE-AI/claude-code-buddy/actions/workflows/installation-test.yml)
13
15
  [![License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
14
16
  [![MCP](https://img.shields.io/badge/MCP-1.25.3-purple.svg)](https://modelcontextprotocol.io)
15
17
 
16
- [🚀 Quick Start](#-2-minute-quick-start) • [📖 Docs](docs/) • [🌐 Website](https://memesh.pcircle.ai) • [💬 Discussions](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
18
+ [🚀 Quick Start](#-2-minute-quick-start) • [📖 Docs](docs/) • [🌐 GitHub](https://github.com/PCIRCLE-AI/claude-code-buddy) • [💬 Discussions](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
17
19
 
18
20
  ---
19
21
 
@@ -68,15 +70,25 @@ MeMesh: 🧠 "I see you have JWT. Let's
68
70
  </tr>
69
71
  </table>
70
72
 
73
+ ---
74
+
75
+ <div align="center">
76
+
77
+ https://github.com/user-attachments/assets/a389bcd2-1563-4d91-b363-44cdba5f4e44
78
+
79
+ </div>
80
+
81
+ ---
82
+
71
83
  <div align="center">
72
84
 
73
85
  **💡 Try it yourself:**
74
86
 
75
87
  ```bash
76
- # In Claude Code/Cursor
77
- buddy-help # See all commands
78
- buddy-do "explain how MeMesh works" # Watch it intelligently respond
79
- buddy-remember "project decisions" # Query your project memory
88
+ # In Claude Code
89
+ buddy-help # See all commands
90
+ buddy-do "explain how MeMesh works" # Watch it intelligently respond
91
+ buddy-remember "project decisions" # Query your project memory
80
92
  ```
81
93
 
82
94
  **📖 [Read User Guide](docs/USER_GUIDE.md)** • **🔧 [API Reference](docs/api/API_REFERENCE.md)**
@@ -171,38 +183,39 @@ buddy-help # When stuck
171
183
 
172
184
  **Three commands. Infinite possibilities.**
173
185
 
186
+ ### 4. 🔐 **Secure Credential Storage**
187
+
188
+ ```bash
189
+ buddy-secret-store "openai_key" "sk-..." api_key # Store encrypted
190
+ buddy-secret-get "openai_key" # Retrieve for API calls
191
+ buddy-secret-list # See what's stored
192
+ buddy-secret-delete "old_key" # Cleanup
193
+ ```
194
+
195
+ **AES-256-GCM encryption. Local only. Never transmitted.**
196
+
174
197
  ---
175
198
 
176
199
  ## 🚀 Installation Options
177
200
 
178
201
  Choose your preferred installation method:
179
202
 
180
- ### 🏆 Official Marketplace (Coming Soon)
181
- Once approved by Anthropic, install with one command:
182
- ```bash
183
- /plugin install memesh@claude-plugins-official
184
- ```
185
-
186
- ### ⚡ GitHub Marketplace (Available Now)
203
+ ### npm Global Install (Easiest) ⭐ RECOMMENDED
187
204
  ```bash
188
- # Add marketplace
189
- /plugin marketplace add PCIRCLE-AI/claude-code-buddy
190
-
191
- # Install plugin
192
- /plugin install memesh@pcircle-ai
205
+ npm install -g @pcircle/memesh
206
+ # Auto-configures everything! Just restart Claude Code.
193
207
  ```
194
208
 
195
- ### 📦 Quick Install Script (Recommended for Local Dev)
209
+ ### 📦 Quick Install Script (For Local Dev)
196
210
  ```bash
197
211
  git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
198
212
  cd claude-code-buddy
199
213
  ./scripts/quick-install.sh
200
- claude --plugin-dir /path/to/claude-code-buddy
201
214
  ```
202
215
 
203
- ### 🎯 For Cursor Users
204
- ```
205
- cursor://anysphere.cursor-deeplink/mcp/install?name=@pcircle/memesh&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwY2lyY2xlL21lbWVzaCJdfQ==
216
+ ### 🏆 Claude Code Marketplace (Coming Soon)
217
+ ```bash
218
+ /plugin install memesh@claude-plugins-official
206
219
  ```
207
220
 
208
221
  ---
@@ -226,15 +239,13 @@ The script will:
226
239
  - ✅ Check prerequisites (Node.js 20+)
227
240
  - ✅ Install dependencies
228
241
  - ✅ Build MeMesh
229
- - ✅ Show you how to activate the plugin
242
+ - ✅ **Auto-configure** `~/.claude/mcp_settings.json`
230
243
 
231
- **Then start Claude Code with:**
244
+ **Then restart Claude Code completely (quit and reopen).**
232
245
 
233
- ```bash
234
- claude --plugin-dir /path/to/claude-code-buddy
235
- ```
246
+ **Done!** MeMesh is now available and ready to use.
236
247
 
237
- **Done!** MeMesh is now available as a plugin.
248
+ > **Note**: The installer automatically configures your MCP settings. No manual configuration needed!
238
249
 
239
250
  <Note>
240
251
  The `--plugin-dir` flag loads your local plugin. For team distribution, see [Plugin Marketplaces](https://code.claude.com/docs/en/plugin-marketplaces) to create a shared marketplace.
@@ -242,22 +253,10 @@ claude --plugin-dir /path/to/claude-code-buddy
242
253
 
243
254
  </details>
244
255
 
245
- <details>
246
- <summary><strong>🎯 Cursor Users</strong> (Click to expand)</summary>
247
-
248
- Cursor uses the same MCP protocol. You can use the quick install link:
249
- ```
250
- cursor://anysphere.cursor-deeplink/mcp/install?name=@pcircle/memesh&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwY2lyY2xlL21lbWVzaCJdfQ==
251
- ```
252
-
253
- **Restart Cursor** and you're set.
254
-
255
- </details>
256
-
257
256
  ### Step 2: Test It
258
257
 
259
258
  ```bash
260
- # In Claude Code/Cursor, type:
259
+ # In Claude Code, type:
261
260
  buddy-help
262
261
 
263
262
  # You should see MeMesh's command list
@@ -352,15 +351,48 @@ Week 8│ You: "Why did we choose JWT again?"
352
351
  ## 🛠️ Advanced Features
353
352
 
354
353
  <details>
355
- <summary><strong>Auto-Memory System</strong></summary>
354
+ <summary><strong>Auto-Memory Hooks</strong></summary>
355
+
356
+ **What is it?** MeMesh remembers what you did in your last coding session and shows you a summary when you start a new one.
357
+
358
+ ### How It Works (Simple Version)
359
+
360
+ 1. **When you open Claude Code** → MeMesh shows what you did last time
361
+ 2. **While you work** → MeMesh quietly tracks your progress
362
+ 3. **When you close Claude Code** → MeMesh saves a summary for next time
363
+
364
+ ### What You'll See
365
+
366
+ When you start a new session, you'll see something like:
367
+
368
+ ```
369
+ 🧠 MeMesh Memory Recall
370
+
371
+ 🕐 Last session: 2 hours ago (45 minutes)
372
+
373
+ 📋 What you did:
374
+ 📁 Changed 5 files in src/auth/
375
+ ✅ Made 3 git commits
376
+ 💡 Implemented JWT refresh tokens
377
+ ```
378
+
379
+ **That's it!** No setup needed. MeMesh handles everything automatically.
380
+
381
+ ### What Gets Saved
382
+
383
+ | Icon | What | Example |
384
+ |------|------|---------|
385
+ | 📁 | Files you changed | `src/auth/login.ts` |
386
+ | ✅ | Commits you made | `feat: add login` |
387
+ | 💡 | Things you learned | `Use async/await here` |
388
+ | ⚠️ | Problems you hit | `API timeout issue` |
356
389
 
357
- When you use `buddy-do`, MeMesh automatically records:
358
- - ✅ Task goals and outcomes
359
- - ✅ Technical decisions and reasoning
360
- - ✅ Errors encountered and solutions
361
- - ✅ Development milestones
390
+ ### Good to Know
362
391
 
363
- **You don't think about memory. MeMesh does.**
392
+ - Saves automatically every 250K tokens (about 1-2 hours of work)
393
+ - Session memories kept for **30 days**, then auto-cleaned
394
+ - Project memories (code changes, test results) kept for **90 days**
395
+ - Currently available in Claude Code only
364
396
 
365
397
  </details>
366
398
 
@@ -382,11 +414,41 @@ buddy-remember "auth" # Returns project-B's auth decisions
382
414
  </details>
383
415
 
384
416
  <details>
385
- <summary><strong>17 MCP Standard Tools</strong></summary>
417
+ <summary><strong>Smart Memory Query</strong></summary>
418
+
419
+ Context-aware memory retrieval with intelligent ranking:
420
+ - 🎯 Semantic search across your knowledge base
421
+ - 🏷️ Auto-tagging for better organization
422
+ - 📊 Relevance scoring based on context
423
+
424
+ </details>
425
+
426
+ <details>
427
+ <summary><strong>Multi-Session Support (Daemon Mode)</strong></summary>
428
+
429
+ Run multiple Claude Code sessions sharing the same memory:
430
+ - 🔄 First instance becomes the daemon
431
+ - 🔗 Subsequent instances connect as proxies
432
+ - 📡 Shared knowledge graph across all sessions
433
+
434
+ </details>
435
+
436
+ <details>
437
+ <summary><strong>SecretManager</strong></summary>
438
+
439
+ Securely store API keys and credentials:
440
+ - 🔐 AES-256-GCM encryption
441
+ - 💾 Local SQLite storage (never transmitted)
442
+ - 🔑 Use `buddy-secret-store` and `buddy-secret-get`
443
+
444
+ </details>
445
+
446
+ <details>
447
+ <summary><strong>18+ MCP Standard Tools</strong></summary>
386
448
 
387
- Full integration with Model Context Protocol.
449
+ Full integration with Model Context Protocol for seamless Claude Code experience.
388
450
 
389
- See complete list: [ToolDefinitions.ts](src/mcp/ToolDefinitions.ts)
451
+ Use `buddy-help` to see all available commands.
390
452
 
391
453
  </details>
392
454
 
@@ -400,7 +462,7 @@ See complete list: [ToolDefinitions.ts](src/mcp/ToolDefinitions.ts)
400
462
 
401
463
  ### Requirements
402
464
  - Node.js 20+
403
- - Claude Code or Cursor IDE
465
+ - Claude Code
404
466
  - 5 minutes of your time
405
467
 
406
468
  </td>
@@ -476,9 +538,9 @@ Think of it as Claude Code + a really good memory + autopilot mode.
476
538
  <details>
477
539
  <summary><strong>Q: Can I customize it?</strong></summary>
478
540
 
479
- **A:** Absolutely. Prompt templates in `src/core/PromptEnhancer.ts`.
541
+ **A:** Absolutely! MeMesh plugin is fully open source.
480
542
 
481
- Want deeper customization? Fork it, hack it, make it yours. That's the open source way.
543
+ Want deeper customization? Check our [Contributing Guide](docs/CONTRIBUTING.md) or fork the repo and make it yours.
482
544
 
483
545
  </details>
484
546
 
package/README.zh-TW.md CHANGED
@@ -13,10 +13,86 @@
13
13
  [![License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
14
14
  [![MCP](https://img.shields.io/badge/MCP-1.25.3-purple.svg)](https://modelcontextprotocol.io)
15
15
 
16
- [🚀 快速開始](#-2-分鐘快速開始) • [📖 文檔](docs/) • [🌐 官網](https://memesh.pcircle.ai) • [💬 討論區](https://github.com/PCIRCLE-AI/memesh/discussions)
16
+ [🚀 快速開始](#-2-分鐘快速開始) • [📖 文檔](docs/) • [🌐 GitHub](https://github.com/PCIRCLE-AI/claude-code-buddy) • [💬 討論區](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
17
17
 
18
18
  ---
19
19
 
20
+ ### 🎥 **實際效果展示**(互動示範)
21
+
22
+ <table>
23
+ <tr>
24
+ <td width="50%" valign="top">
25
+
26
+ #### 🔴 **沒有 MeMesh**
27
+
28
+ ```bash
29
+ # Session 1(週一)
30
+ 你: "我們用 JWT 做身份驗證,因為..."
31
+ Claude: "了解!✅"
32
+
33
+ # Session 2(週二)
34
+ 你: "還記得我們的身份驗證方式嗎?"
35
+ Claude: "抱歉,我沒有這個 context..."
36
+ 你: *再解釋一次所有東西* 😤
37
+
38
+ # Session 3(週三)
39
+ 你: "我們的 JWT 實作..."
40
+ Claude: "什麼 JWT 實作?"
41
+ 你: *暴怒離開* 💢
42
+ ```
43
+
44
+ </td>
45
+ <td width="50%" valign="top">
46
+
47
+ #### ✅ **有 MeMesh**
48
+
49
+ ```bash
50
+ # Session 1(週一)
51
+ 你: buddy-do "設定 JWT 身份驗證"
52
+ MeMesh: ✅ 已實作 + 儲存到記憶
53
+
54
+ # Session 2(週二)
55
+ 你: buddy-remember "auth"
56
+ MeMesh: 📚 "JWT 身份驗證實作於 2024-01-15
57
+ ↳ Access tokens: 15 分鐘
58
+ ↳ Refresh tokens: 7 天
59
+ ↳ 金鑰輪替: 每月"
60
+
61
+ # Session 3(任何時候,永遠)
62
+ 你: buddy-do "新增 OAuth"
63
+ MeMesh: 🧠 "我看到你有 JWT。讓我們
64
+ 把 OAuth 整合進去..."
65
+ ```
66
+
67
+ </td>
68
+ </tr>
69
+ </table>
70
+
71
+ ---
72
+
73
+ <div align="center">
74
+
75
+ https://github.com/user-attachments/assets/a389bcd2-1563-4d91-b363-44cdba5f4e44
76
+
77
+ </div>
78
+
79
+ ---
80
+
81
+ <div align="center">
82
+
83
+ **💡 自己試試看:**
84
+
85
+ ```bash
86
+ # 在 Claude Code 中
87
+ buddy-help # 查看所有指令
88
+ buddy-do "解釋 MeMesh 如何運作" # 看它智能回應
89
+ buddy-remember "專案決策" # 查詢專案記憶
90
+ ```
91
+
92
+ **📖 [閱讀使用指南](docs/USER_GUIDE.md)** • **🔧 [API 參考](docs/api/API_REFERENCE.md)**
93
+
94
+ </div>
95
+
20
96
  </div>
21
97
 
22
98
  ---
@@ -105,40 +181,50 @@ buddy-help # 需要幫助時
105
181
 
106
182
  **三個命令。無限可能。**
107
183
 
184
+ ### 4. 🔐 **安全憑證儲存**
185
+
186
+ ```bash
187
+ buddy-secret-store "openai_key" "sk-..." api_key # 加密儲存
188
+ buddy-secret-get "openai_key" # 取得憑證
189
+ buddy-secret-list # 查看已儲存
190
+ buddy-secret-delete "old_key" # 清理舊金鑰
191
+ ```
192
+
193
+ **AES-256-GCM 加密。僅存本地。永不傳輸。**
194
+
108
195
  ---
109
196
 
110
197
  ## 🚀 安裝選項
111
198
 
112
199
  選擇你偏好的安裝方式:
113
200
 
114
- ### 🏆 官方 Marketplace(即將推出)
115
- 一旦獲得 Anthropic 批准,一行命令即可安裝:
201
+ ### npm 全域安裝(最簡單)⭐ 推薦
116
202
  ```bash
117
- /plugin install memesh@claude-plugins-official
203
+ npm install -g @pcircle/memesh
204
+ # 自動設定完成!只需重啟 Claude Code。
118
205
  ```
119
206
 
120
- ### GitHub Marketplace(現已可用)
121
- ```bash
122
- # 添加 marketplace
123
- /plugin marketplace add PCIRCLE-AI/claude-code-buddy
124
-
125
- # 安裝 plugin
126
- /plugin install memesh@pcircle-ai
127
- ```
128
-
129
- ### 📦 快速安裝腳本(本地開發推薦)
207
+ ### 📦 快速安裝腳本(本地開發用)
130
208
  ```bash
131
209
  git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
132
210
  cd claude-code-buddy
133
211
  ./scripts/quick-install.sh
134
- claude --plugin-dir /path/to/claude-code-buddy
135
212
  ```
136
213
 
137
214
  ### 🎯 Cursor 使用者
215
+
216
+ **快速安裝**(基本功能):
138
217
  ```
139
218
  cursor://anysphere.cursor-deeplink/mcp/install?name=@pcircle/memesh&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwY2lyY2xlL21lbWVzaCJdfQ==
140
219
  ```
141
220
 
221
+ **完整設定**(支援 A2A):請參閱下方 [Cursor 完整設定](#cursor-完整設定)。
222
+
223
+ ### 🏆 Claude Code Marketplace(即將推出)
224
+ ```bash
225
+ /plugin install memesh@claude-plugins-official
226
+ ```
227
+
142
228
  ---
143
229
 
144
230
  ## 🚀 2 分鐘快速開始
@@ -168,7 +254,7 @@ cd claude-code-buddy
168
254
  claude --plugin-dir /path/to/claude-code-buddy
169
255
  ```
170
256
 
171
- **完成!**CCB 現在可以作為 plugin 使用了。
257
+ **完成!**MeMesh 現在可以作為 plugin 使用了。
172
258
 
173
259
  <Note>
174
260
  `--plugin-dir` 標記用於載入本地 plugin。如需團隊分發,請參閱 [Plugin Marketplaces](https://code.claude.com/docs/en/plugin-marketplaces) 建立共享的 marketplace。
@@ -179,12 +265,33 @@ claude --plugin-dir /path/to/claude-code-buddy
179
265
  <details>
180
266
  <summary><strong>🎯 Cursor 使用者</strong>(點擊展開)</summary>
181
267
 
182
- Cursor 使用相同的 MCP 協議。你可以使用快速安裝連結:
183
- ```
184
- cursor://anysphere.cursor-deeplink/mcp/install?name=@pcircle/memesh&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwY2lyY2xlL21lbWVzaCJdfQ==
185
- ```
268
+ <h4 id="cursor-完整設定">Cursor 完整設定(支援 A2A)</h4>
269
+
270
+ Deep link 提供基本功能。如需**完整 A2A(Agent-to-Agent)支援**,請手動設定:
271
+
272
+ 1. **生成 token**:
273
+ ```bash
274
+ openssl rand -hex 32
275
+ ```
276
+
277
+ 2. **編輯 Cursor MCP 設定**(`~/.cursor/mcp.json` 或透過 Cursor 設定):
278
+ ```json
279
+ {
280
+ "mcpServers": {
281
+ "memesh": {
282
+ "command": "npx",
283
+ "args": ["-y", "@pcircle/memesh"],
284
+ "env": {
285
+ "MEMESH_A2A_TOKEN": "<你的-64-字元-hex-token>"
286
+ }
287
+ }
288
+ }
289
+ }
290
+ ```
186
291
 
187
- **重啟 Cursor** 就完成了。
292
+ 3. **重啟 Cursor** 就完成了。
293
+
294
+ > **注意**:所有 session 需使用相同的 token 才能讓 A2A 正常運作。
188
295
 
189
296
  </details>
190
297
 
@@ -264,13 +371,13 @@ MeMesh 立即回想:
264
371
  <details>
265
372
  <summary><strong>自動記憶系統</strong></summary>
266
373
 
267
- 當你使用 `buddy-do` 時,CCB 會自動記錄:
374
+ 當你使用 `buddy-do` 時,MeMesh 會自動記錄:
268
375
  - ✅ 任務目標和結果
269
376
  - ✅ 技術決策和理由
270
377
  - ✅ 遇到的錯誤和解決方案
271
378
  - ✅ 開發里程碑
272
379
 
273
- **你不用想記憶的事。CCB 會處理。**
380
+ **你不用想記憶的事。MeMesh 會處理。**
274
381
 
275
382
  </details>
276
383
 
@@ -292,11 +399,41 @@ buddy-remember "auth" # 回傳 project-B 的 auth 決策
292
399
  </details>
293
400
 
294
401
  <details>
295
- <summary><strong>17 個 MCP 標準工具</strong></summary>
402
+ <summary><strong>智能記憶查詢</strong></summary>
403
+
404
+ 具備上下文感知的智能記憶檢索:
405
+ - 🎯 知識庫語意搜尋
406
+ - 🏷️ 自動標籤分類
407
+ - 📊 基於上下文的相關性排序
296
408
 
297
- 完整整合 Model Context Protocol。
409
+ </details>
410
+
411
+ <details>
412
+ <summary><strong>多 Session 支援(Daemon 模式)</strong></summary>
298
413
 
299
- 查看完整列表:[ToolDefinitions.ts](src/mcp/ToolDefinitions.ts)
414
+ 多個 Claude Code session 共享同一記憶:
415
+ - 🔄 第一個實例成為 daemon
416
+ - 🔗 後續實例作為 proxy 連接
417
+ - 📡 所有 session 共享知識圖譜
418
+
419
+ </details>
420
+
421
+ <details>
422
+ <summary><strong>SecretManager 密鑰管理</strong></summary>
423
+
424
+ 安全存儲 API 金鑰和憑證:
425
+ - 🔐 AES-256-GCM 加密
426
+ - 💾 本地 SQLite 存儲(永不傳輸)
427
+ - 🔑 使用 `buddy-secret-store` 和 `buddy-secret-get`
428
+
429
+ </details>
430
+
431
+ <details>
432
+ <summary><strong>18+ 個 MCP 標準工具</strong></summary>
433
+
434
+ 完整整合 Model Context Protocol,提供無縫的 Claude Code 體驗。
435
+
436
+ 使用 `buddy-help` 查看所有可用指令。
300
437
 
301
438
  </details>
302
439
 
@@ -334,13 +471,41 @@ buddy-remember "auth" # 回傳 project-B 的 auth 決策
334
471
 
335
472
  ---
336
473
 
474
+ ## 🐛 回報問題 & 獲取協助
475
+
476
+ 遇到問題了嗎?我們來幫忙!
477
+
478
+ ### 📝 如何回報 Bug
479
+
480
+ 1. **檢查現有 Issues**:先看看是否有人已經回報
481
+ - [搜尋現有 Issues](https://github.com/PCIRCLE-AI/claude-code-buddy/issues)
482
+
483
+ 2. **建立新 Issue**:
484
+ - [開啟新 Issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
485
+ - 請包含:
486
+ - ✅ MeMesh 版本(執行 `npm list @pcircle/memesh` 查看)
487
+ - ✅ Node.js 版本(執行 `node --version`)
488
+ - ✅ 作業系統(Windows/macOS/Linux)
489
+ - ✅ 錯誤訊息(完整的錯誤 log)
490
+ - ✅ 重現步驟
491
+
492
+ 3. **緊急問題**:如果是安全相關問題,請私下回報至:security@pcircle.ai
493
+
494
+ ### 💬 社群支援
495
+
496
+ - **一般問題**:[GitHub Discussions](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
497
+ - **功能建議**:[Feature Requests](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions/categories/ideas)
498
+ - **疑難排解**:[閱讀疑難排解指南](docs/TROUBLESHOOTING.md)
499
+
500
+ ---
501
+
337
502
  ## 🤝 貢獻
338
503
 
339
504
  我們很樂意你的幫助讓 MeMesh 變得更好!
340
505
 
341
- - 🐛 **發現 bug?**[開啟 issue](https://github.com/PCIRCLE-AI/memesh/issues/new)
342
- - 💡 **有想法?**[開始討論](https://github.com/PCIRCLE-AI/memesh/discussions)
343
- - 🛠️ **想寫程式?**查看 [Good First Issues](https://github.com/PCIRCLE-AI/memesh/labels/good%20first%20issue)
506
+ - 🐛 **發現 bug?**[開啟 issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
507
+ - 💡 **有想法?**[開始討論](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
508
+ - 🛠️ **想寫程式?**查看 [Good First Issues](https://github.com/PCIRCLE-AI/claude-code-buddy/labels/good%20first%20issue)
344
509
 
345
510
  **貢獻指南**:[CONTRIBUTING.md](docs/CONTRIBUTING.md)
346
511
 
@@ -386,9 +551,9 @@ buddy-remember "auth" # 回傳 project-B 的 auth 決策
386
551
  <details>
387
552
  <summary><strong>Q:可以客製化嗎?</strong></summary>
388
553
 
389
- **A:** 當然。提示詞模板在 `src/core/PromptEnhancer.ts`。
554
+ **A:** 當然!MeMesh 外掛程式完全開源。
390
555
 
391
- 想更深度客製化?Fork 它、改它、變成你的。這就是開源精神。
556
+ 想更深度客製化?查看我們的[貢獻指南](docs/CONTRIBUTING.md)或 fork 此專案。
392
557
 
393
558
  </details>
394
559
 
@@ -407,7 +572,7 @@ buddy-remember "auth" # 回傳 project-B 的 auth 決策
407
572
 
408
573
  - [Model Context Protocol (MCP)](https://github.com/anthropics/mcp) - 基礎
409
574
  - [Claude Code](https://claude.com/claude-code) - 平台
410
- - 所有我們出色的[貢獻者](https://github.com/PCIRCLE-AI/memesh/graphs/contributors)和早期測試者
575
+ - 所有我們出色的[貢獻者](https://github.com/PCIRCLE-AI/claude-code-buddy/graphs/contributors)和早期測試者
411
576
 
412
577
  ---
413
578
 
@@ -431,7 +596,7 @@ buddy-remember "auth" # 回傳 project-B 的 auth 決策
431
596
 
432
597
  **別再重複自己。開始 vibe 吧。**
433
598
 
434
- [🚀 開始使用](#-2-分鐘快速開始) • [📖 閱讀文檔](docs/) • [💬 加入討論](https://github.com/PCIRCLE-AI/memesh/discussions)
599
+ [🚀 開始使用](#-2-分鐘快速開始) • [📖 閱讀文檔](docs/) • [💬 加入討論](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
435
600
 
436
601
  ---
437
602
 
@@ -1,7 +1,12 @@
1
1
  import type { SendMessageRequest, SendMessageResponse, Task, TaskStatus, AgentCard } from '../types/index.js';
2
+ import { type RetryOptions } from '../../utils/retry.js';
2
3
  export declare class A2AClient {
3
4
  private registry;
4
- constructor();
5
+ private retryConfig;
6
+ constructor(retryConfig?: Partial<RetryOptions>);
7
+ private getAuthHeaders;
8
+ private fetchWithTimeout;
9
+ private isRetryableHttpError;
5
10
  sendMessage(targetAgentId: string, request: SendMessageRequest): Promise<SendMessageResponse>;
6
11
  getTask(targetAgentId: string, taskId: string): Promise<Task>;
7
12
  listTasks(targetAgentId: string, params?: {
@@ -11,6 +16,7 @@ export declare class A2AClient {
11
16
  }): Promise<TaskStatus[]>;
12
17
  getAgentCard(targetAgentId: string): Promise<AgentCard>;
13
18
  cancelTask(targetAgentId: string, taskId: string): Promise<void>;
19
+ private validateContentType;
14
20
  private handleResponse;
15
21
  listAvailableAgents(): string[];
16
22
  }
@@ -1 +1 @@
1
- {"version":3,"file":"A2AClient.d.ts","sourceRoot":"","sources":["../../../src/a2a/client/A2AClient.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EAEnB,IAAI,EACJ,UAAU,EACV,SAAS,EACV,MAAM,mBAAmB,CAAC;AAG3B,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAgB;;IAM1B,WAAW,CACf,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC;IAuBzB,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB7D,SAAS,CACb,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5D,OAAO,CAAC,UAAU,EAAE,CAAC;IA2BlB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAsBvD,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAsBxD,cAAc;IAwB5B,mBAAmB,IAAI,MAAM,EAAE;CAGhC"}
1
+ {"version":3,"file":"A2AClient.d.ts","sourceRoot":"","sources":["../../../src/a2a/client/A2AClient.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EAEnB,IAAI,EACJ,UAAU,EACV,SAAS,EACV,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAmF3E,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,WAAW,CAAe;gBAStB,WAAW,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAqC/C,OAAO,CAAC,cAAc;YAgCR,gBAAgB;IAmD9B,OAAO,CAAC,oBAAoB;IA6BtB,WAAW,CACf,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC;IA8BzB,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC7D,SAAS,CACb,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5D,OAAO,CAAC,UAAU,EAAE,CAAC;IAmClB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA6BvD,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CtE,OAAO,CAAC,mBAAmB;YAgBb,cAAc;IAgC5B,mBAAmB,IAAI,MAAM,EAAE;CAGhC"}