memory-journal-mcp 6.1.2 → 6.2.1

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 (372) hide show
  1. package/README.md +44 -28
  2. package/dist/{chunk-X4SWFATC.js → chunk-BI4ZNSKA.js} +38 -24
  3. package/dist/{chunk-HCEWINSB.js → chunk-N6EBIDN7.js} +99 -102
  4. package/dist/cli.js +2 -2
  5. package/dist/index.js +2 -2
  6. package/dist/tools-WPRY5MJ6.js +2 -0
  7. package/package.json +10 -1
  8. package/skills/github-commander/SKILL.md +151 -0
  9. package/skills/github-commander/config/project-config.example.md +125 -0
  10. package/skills/github-commander/workflows/code-quality-audit.md +80 -0
  11. package/skills/github-commander/workflows/full-audit.md +134 -0
  12. package/skills/github-commander/workflows/issue-triage.md +239 -0
  13. package/skills/github-commander/workflows/milestone-sprint.md +81 -0
  14. package/skills/github-commander/workflows/perf-audit.md +142 -0
  15. package/skills/github-commander/workflows/pr-review.md +123 -0
  16. package/skills/github-commander/workflows/security-audit.md +170 -0
  17. package/skills/github-commander/workflows/update-deps.md +109 -0
  18. package/.dockerignore +0 -139
  19. package/.gitattributes +0 -20
  20. package/.github/ISSUE_TEMPLATE/bug_report.md +0 -95
  21. package/.github/ISSUE_TEMPLATE/config.yml +0 -11
  22. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -110
  23. package/.github/ISSUE_TEMPLATE/question.md +0 -78
  24. package/.github/aw/actions-lock.json +0 -14
  25. package/.github/copilot-instructions.md +0 -122
  26. package/.github/dependabot.yml +0 -93
  27. package/.github/pull_request_template.md +0 -135
  28. package/.github/workflows/README.md +0 -133
  29. package/.github/workflows/agentics-maintenance.yml +0 -141
  30. package/.github/workflows/auto-release.yml +0 -68
  31. package/.github/workflows/ci-health-monitor.lock.yml +0 -1121
  32. package/.github/workflows/ci-health-monitor.md +0 -87
  33. package/.github/workflows/codeql.yml +0 -41
  34. package/.github/workflows/dependabot-auto-merge.yml +0 -42
  35. package/.github/workflows/dependency-maintenance.lock.yml +0 -1182
  36. package/.github/workflows/dependency-maintenance.md +0 -147
  37. package/.github/workflows/docker-publish.yml +0 -254
  38. package/.github/workflows/docs-drift-detector.lock.yml +0 -1142
  39. package/.github/workflows/docs-drift-detector.md +0 -115
  40. package/.github/workflows/lint-and-test.yml +0 -60
  41. package/.github/workflows/publish-npm.yml +0 -85
  42. package/.github/workflows/secrets-scanning.yml +0 -32
  43. package/.github/workflows/security-update.yml +0 -127
  44. package/.gitleaks.toml +0 -9
  45. package/.prettierignore +0 -21
  46. package/.prettierrc +0 -33
  47. package/.scout-ignore +0 -12
  48. package/.trivyignore +0 -21
  49. package/CHANGELOG.md +0 -1814
  50. package/CODE_OF_CONDUCT.md +0 -133
  51. package/CONTRIBUTING.md +0 -263
  52. package/DOCKER_README.md +0 -331
  53. package/Dockerfile +0 -128
  54. package/SECURITY.md +0 -227
  55. package/UNRELEASED.md +0 -1
  56. package/dist/tools-T4U5A3X4.js +0 -2
  57. package/docker-compose.yml +0 -71
  58. package/docs/README.md +0 -18
  59. package/docs/agentic-journal-synergy.md +0 -175
  60. package/docs/copilot-setup.md +0 -72
  61. package/eslint.config.js +0 -110
  62. package/mcp-config-example.json +0 -21
  63. package/playwright.config.ts +0 -35
  64. package/releases/v2.1.0.md +0 -220
  65. package/releases/v2.2.0.md +0 -168
  66. package/releases/v3.0.0.md +0 -237
  67. package/releases/v3.1.0.md +0 -104
  68. package/releases/v3.1.1.md +0 -42
  69. package/releases/v3.1.2.md +0 -40
  70. package/releases/v3.1.3.md +0 -64
  71. package/releases/v3.1.4.md +0 -32
  72. package/releases/v3.1.5.md +0 -44
  73. package/releases/v4.0.0.md +0 -71
  74. package/releases/v4.1.0.md +0 -88
  75. package/releases/v4.2.0.md +0 -90
  76. package/releases/v4.3.0.md +0 -92
  77. package/releases/v4.3.1.md +0 -69
  78. package/releases/v4.4.0.md +0 -120
  79. package/releases/v4.4.1.md +0 -33
  80. package/releases/v4.4.2.md +0 -31
  81. package/releases/v4.5.0.md +0 -116
  82. package/releases/v5.0.0.md +0 -105
  83. package/releases/v5.0.1.md +0 -25
  84. package/releases/v5.1.0.md +0 -83
  85. package/releases/v5.1.1.md +0 -10
  86. package/releases/v6.0.0.md +0 -48
  87. package/releases/v6.0.1.md +0 -36
  88. package/releases/v6.1.0.md +0 -68
  89. package/releases/v6.1.1.md +0 -30
  90. package/releases/v6.1.2.md +0 -23
  91. package/scripts/generate-server-instructions.ts +0 -306
  92. package/scripts/server-instructions-function-body.ts +0 -107
  93. package/scripts/server-instructions-gotchas.ts +0 -45
  94. package/server.json +0 -42
  95. package/social-preview.png +0 -0
  96. package/src/auth/auth-context.ts +0 -78
  97. package/src/auth/authorization-server-discovery.ts +0 -263
  98. package/src/auth/errors.ts +0 -215
  99. package/src/auth/index.ts +0 -58
  100. package/src/auth/middleware.ts +0 -392
  101. package/src/auth/oauth-resource-server.ts +0 -170
  102. package/src/auth/scope-map.ts +0 -46
  103. package/src/auth/scopes.ts +0 -256
  104. package/src/auth/token-validator.ts +0 -293
  105. package/src/auth/transport-agnostic.ts +0 -164
  106. package/src/auth/types.ts +0 -372
  107. package/src/cli.ts +0 -279
  108. package/src/codemode/api-constants.ts +0 -263
  109. package/src/codemode/api.ts +0 -302
  110. package/src/codemode/auto-return.ts +0 -65
  111. package/src/codemode/index.ts +0 -47
  112. package/src/codemode/sandbox-factory.ts +0 -144
  113. package/src/codemode/sandbox.ts +0 -220
  114. package/src/codemode/security.ts +0 -155
  115. package/src/codemode/types.ts +0 -228
  116. package/src/codemode/worker-sandbox.ts +0 -277
  117. package/src/codemode/worker-script.ts +0 -239
  118. package/src/constants/icons.ts +0 -183
  119. package/src/constants/server-instructions.md +0 -166
  120. package/src/constants/server-instructions.ts +0 -514
  121. package/src/database/adapter-factory.ts +0 -16
  122. package/src/database/core/entry-columns.ts +0 -10
  123. package/src/database/core/interfaces.ts +0 -188
  124. package/src/database/core/schema.ts +0 -152
  125. package/src/database/sqlite-adapter/backup.ts +0 -167
  126. package/src/database/sqlite-adapter/entries/crud.ts +0 -233
  127. package/src/database/sqlite-adapter/entries/importance.ts +0 -76
  128. package/src/database/sqlite-adapter/entries/index.ts +0 -142
  129. package/src/database/sqlite-adapter/entries/search.ts +0 -294
  130. package/src/database/sqlite-adapter/entries/shared.ts +0 -102
  131. package/src/database/sqlite-adapter/entries/statistics.ts +0 -162
  132. package/src/database/sqlite-adapter/index.ts +0 -265
  133. package/src/database/sqlite-adapter/native-connection.ts +0 -301
  134. package/src/database/sqlite-adapter/relationships.ts +0 -70
  135. package/src/database/sqlite-adapter/tags.ts +0 -182
  136. package/src/filtering/tool-filter.ts +0 -312
  137. package/src/github/github-integration/client.ts +0 -114
  138. package/src/github/github-integration/index.ts +0 -297
  139. package/src/github/github-integration/insights.ts +0 -155
  140. package/src/github/github-integration/issues.ts +0 -213
  141. package/src/github/github-integration/milestones.ts +0 -262
  142. package/src/github/github-integration/projects.ts +0 -414
  143. package/src/github/github-integration/pull-requests.ts +0 -235
  144. package/src/github/github-integration/repository.ts +0 -110
  145. package/src/github/github-integration/types.ts +0 -43
  146. package/src/handlers/prompts/github.ts +0 -210
  147. package/src/handlers/prompts/index.ts +0 -97
  148. package/src/handlers/prompts/workflow.ts +0 -361
  149. package/src/handlers/resources/core/briefing/context-section.ts +0 -182
  150. package/src/handlers/resources/core/briefing/github-section.ts +0 -354
  151. package/src/handlers/resources/core/briefing/index.ts +0 -106
  152. package/src/handlers/resources/core/briefing/user-message.ts +0 -114
  153. package/src/handlers/resources/core/health.ts +0 -75
  154. package/src/handlers/resources/core/index.ts +0 -31
  155. package/src/handlers/resources/core/instructions.ts +0 -45
  156. package/src/handlers/resources/core/utilities.ts +0 -310
  157. package/src/handlers/resources/github.ts +0 -340
  158. package/src/handlers/resources/graph.ts +0 -218
  159. package/src/handlers/resources/help.ts +0 -410
  160. package/src/handlers/resources/index.ts +0 -143
  161. package/src/handlers/resources/shared.ts +0 -219
  162. package/src/handlers/resources/team.ts +0 -134
  163. package/src/handlers/resources/templates.ts +0 -334
  164. package/src/handlers/tools/admin.ts +0 -351
  165. package/src/handlers/tools/analytics.ts +0 -346
  166. package/src/handlers/tools/backup.ts +0 -272
  167. package/src/handlers/tools/codemode.ts +0 -188
  168. package/src/handlers/tools/core.ts +0 -359
  169. package/src/handlers/tools/error-fields-mixin.ts +0 -10
  170. package/src/handlers/tools/export.ts +0 -150
  171. package/src/handlers/tools/github/copilot-tools.ts +0 -72
  172. package/src/handlers/tools/github/helpers.ts +0 -125
  173. package/src/handlers/tools/github/insights-tools.ts +0 -112
  174. package/src/handlers/tools/github/issue-tools.ts +0 -442
  175. package/src/handlers/tools/github/kanban-tools.ts +0 -153
  176. package/src/handlers/tools/github/milestone-tools.ts +0 -371
  177. package/src/handlers/tools/github/mutation-tools.ts +0 -17
  178. package/src/handlers/tools/github/read-tools.ts +0 -302
  179. package/src/handlers/tools/github/schemas.ts +0 -435
  180. package/src/handlers/tools/github.ts +0 -39
  181. package/src/handlers/tools/index.ts +0 -255
  182. package/src/handlers/tools/relationships.ts +0 -390
  183. package/src/handlers/tools/schemas.ts +0 -165
  184. package/src/handlers/tools/search.ts +0 -448
  185. package/src/handlers/tools/team/admin-tools.ts +0 -164
  186. package/src/handlers/tools/team/analytics-tools.ts +0 -233
  187. package/src/handlers/tools/team/backup-tools.ts +0 -83
  188. package/src/handlers/tools/team/core-tools.ts +0 -197
  189. package/src/handlers/tools/team/export-tools.ts +0 -130
  190. package/src/handlers/tools/team/helpers.ts +0 -66
  191. package/src/handlers/tools/team/index.ts +0 -45
  192. package/src/handlers/tools/team/relationship-tools.ts +0 -219
  193. package/src/handlers/tools/team/schemas.ts +0 -558
  194. package/src/handlers/tools/team/search-tools.ts +0 -145
  195. package/src/handlers/tools/team/vector-tools.ts +0 -261
  196. package/src/index.ts +0 -57
  197. package/src/server/mcp-server.ts +0 -446
  198. package/src/server/registration.ts +0 -141
  199. package/src/server/scheduler.ts +0 -283
  200. package/src/transports/http/handlers.ts +0 -78
  201. package/src/transports/http/index.ts +0 -8
  202. package/src/transports/http/security.ts +0 -147
  203. package/src/transports/http/server/index.ts +0 -397
  204. package/src/transports/http/server/legacy-sse.ts +0 -87
  205. package/src/transports/http/server/stateful.ts +0 -222
  206. package/src/transports/http/server/stateless.ts +0 -42
  207. package/src/transports/http/types.ts +0 -132
  208. package/src/types/entities.ts +0 -145
  209. package/src/types/error-types.ts +0 -92
  210. package/src/types/errors.ts +0 -200
  211. package/src/types/filtering.ts +0 -55
  212. package/src/types/github.ts +0 -216
  213. package/src/types/index.ts +0 -348
  214. package/src/utils/error-helpers.ts +0 -78
  215. package/src/utils/errors/error-response-fields.ts +0 -29
  216. package/src/utils/errors/suggestions.ts +0 -94
  217. package/src/utils/github-helpers.ts +0 -33
  218. package/src/utils/logger.ts +0 -107
  219. package/src/utils/mcp-logger.ts +0 -155
  220. package/src/utils/progress-utils.ts +0 -100
  221. package/src/utils/query-helpers.ts +0 -78
  222. package/src/utils/resource-annotations.ts +0 -75
  223. package/src/utils/security-utils.ts +0 -198
  224. package/src/utils/vector-index-helpers.ts +0 -24
  225. package/src/vector/vector-search-manager.ts +0 -409
  226. package/src/version.ts +0 -15
  227. package/test-server/README.md +0 -193
  228. package/test-server/code-map.md +0 -399
  229. package/test-server/test-agent-experience.md +0 -213
  230. package/test-server/test-filter-instructions.mjs +0 -295
  231. package/test-server/test-instruction-levels.mjs +0 -102
  232. package/test-server/test-preflight.md +0 -55
  233. package/test-server/test-prompts.mjs +0 -185
  234. package/test-server/test-scheduler.mjs +0 -174
  235. package/test-server/test-tool-annotations.mjs +0 -115
  236. package/test-server/test-tools-codemode.md +0 -632
  237. package/test-server/test-tools-codemode2.md +0 -1218
  238. package/test-server/test-tools-team.md +0 -215
  239. package/test-server/test-tools.md +0 -429
  240. package/test-server/test-tools2.md +0 -361
  241. package/test-server/test-tools3.md +0 -396
  242. package/test-server/tool-reference.md +0 -231
  243. package/tests/README.md +0 -54
  244. package/tests/auth/auth-context.test.ts +0 -162
  245. package/tests/auth/authorization-server-discovery.test.ts +0 -265
  246. package/tests/auth/errors.test.ts +0 -170
  247. package/tests/auth/middleware.test.ts +0 -585
  248. package/tests/auth/oauth-resource-server.test.ts +0 -173
  249. package/tests/auth/scope-map.test.ts +0 -66
  250. package/tests/auth/scopes.test.ts +0 -347
  251. package/tests/auth/token-validator.test.ts +0 -271
  252. package/tests/codemode/api.test.ts +0 -396
  253. package/tests/codemode/auto-return.test.ts +0 -167
  254. package/tests/codemode/codemode-tool-handlers.test.ts +0 -197
  255. package/tests/codemode/sandbox-factory.test.ts +0 -152
  256. package/tests/codemode/sandbox.test.ts +0 -190
  257. package/tests/codemode/security.test.ts +0 -242
  258. package/tests/codemode/worker-sandbox.test.ts +0 -106
  259. package/tests/constants/icons.test.ts +0 -101
  260. package/tests/constants/server-instructions.test.ts +0 -514
  261. package/tests/database/crud-workflow-branches.test.ts +0 -418
  262. package/tests/database/database-branches.test.ts +0 -132
  263. package/tests/database/entries-auth-branches.test.ts +0 -390
  264. package/tests/database/native-connection.test.ts +0 -249
  265. package/tests/database/shared-helpers.test.ts +0 -103
  266. package/tests/database/sqlite-adapter.bench.ts +0 -63
  267. package/tests/database/sqlite-adapter.test.ts +0 -690
  268. package/tests/database/tags.test.ts +0 -134
  269. package/tests/e2e/README.md +0 -39
  270. package/tests/e2e/auth.spec.ts +0 -106
  271. package/tests/e2e/codemode-abuse.spec.ts +0 -75
  272. package/tests/e2e/health.spec.ts +0 -63
  273. package/tests/e2e/helpers.ts +0 -139
  274. package/tests/e2e/oauth-discovery.spec.ts +0 -102
  275. package/tests/e2e/oauth-scopes.spec.ts +0 -222
  276. package/tests/e2e/payloads-admin.spec.ts +0 -76
  277. package/tests/e2e/payloads-analytics.spec.ts +0 -37
  278. package/tests/e2e/payloads-backup-restore.spec.ts +0 -102
  279. package/tests/e2e/payloads-backup.spec.ts +0 -44
  280. package/tests/e2e/payloads-codemode-api.spec.ts +0 -131
  281. package/tests/e2e/payloads-codemode-readonly.spec.ts +0 -116
  282. package/tests/e2e/payloads-codemode.spec.ts +0 -116
  283. package/tests/e2e/payloads-core.spec.ts +0 -82
  284. package/tests/e2e/payloads-error-contracts.spec.ts +0 -159
  285. package/tests/e2e/payloads-export.spec.ts +0 -46
  286. package/tests/e2e/payloads-github-degradation.spec.ts +0 -73
  287. package/tests/e2e/payloads-github.spec.ts +0 -176
  288. package/tests/e2e/payloads-relationships.spec.ts +0 -56
  289. package/tests/e2e/payloads-search.spec.ts +0 -64
  290. package/tests/e2e/payloads-team-happy.spec.ts +0 -231
  291. package/tests/e2e/payloads-team.spec.ts +0 -174
  292. package/tests/e2e/prompts-expanded.spec.ts +0 -137
  293. package/tests/e2e/prompts.spec.ts +0 -62
  294. package/tests/e2e/protocols.spec.ts +0 -134
  295. package/tests/e2e/rate-limiting.spec.ts +0 -291
  296. package/tests/e2e/resources-briefing-env.spec.ts +0 -106
  297. package/tests/e2e/resources-complete.spec.ts +0 -180
  298. package/tests/e2e/resources-expanded.spec.ts +0 -83
  299. package/tests/e2e/resources-instructions-levels.spec.ts +0 -145
  300. package/tests/e2e/resources-templates.spec.ts +0 -123
  301. package/tests/e2e/resources.spec.ts +0 -103
  302. package/tests/e2e/scheduler.spec.ts +0 -79
  303. package/tests/e2e/security.spec.ts +0 -112
  304. package/tests/e2e/session-advanced.spec.ts +0 -152
  305. package/tests/e2e/sessions.spec.ts +0 -95
  306. package/tests/e2e/stateless.spec.ts +0 -79
  307. package/tests/e2e/streaming.spec.ts +0 -176
  308. package/tests/e2e/tool-filtering-presets.spec.ts +0 -192
  309. package/tests/e2e/tool-filtering.spec.ts +0 -77
  310. package/tests/e2e/tools.spec.ts +0 -111
  311. package/tests/filtering/tool-filter.test.ts +0 -314
  312. package/tests/github/client-issues-errors.test.ts +0 -433
  313. package/tests/github/github-integration-branches.test.ts +0 -490
  314. package/tests/github/github-integration.test.ts +0 -1015
  315. package/tests/github/github-managers-branches.test.ts +0 -907
  316. package/tests/github/pull-requests.test.ts +0 -334
  317. package/tests/handlers/analytics-branches.test.ts +0 -222
  318. package/tests/handlers/backup-branches.test.ts +0 -270
  319. package/tests/handlers/briefing-context-section.test.ts +0 -388
  320. package/tests/handlers/briefing-github-section.test.ts +0 -392
  321. package/tests/handlers/briefing-user-message.test.ts +0 -405
  322. package/tests/handlers/codemode-tools.test.ts +0 -85
  323. package/tests/handlers/copilot-tools.test.ts +0 -126
  324. package/tests/handlers/error-path-coverage.test.ts +0 -324
  325. package/tests/handlers/export-tools.test.ts +0 -203
  326. package/tests/handlers/github-resource-handlers.test.ts +0 -929
  327. package/tests/handlers/github-tool-handlers.test.ts +0 -1452
  328. package/tests/handlers/handler-error-branches.test.ts +0 -346
  329. package/tests/handlers/help-resource.test.ts +0 -92
  330. package/tests/handlers/prompt-handler-coverage.test.ts +0 -108
  331. package/tests/handlers/prompt-handlers.test.ts +0 -131
  332. package/tests/handlers/resource-handler-coverage.test.ts +0 -281
  333. package/tests/handlers/resource-handlers.test.ts +0 -357
  334. package/tests/handlers/resource-prompt-branches.test.ts +0 -495
  335. package/tests/handlers/search-tool-handlers.test.ts +0 -379
  336. package/tests/handlers/targeted-gap-closure.test.ts +0 -387
  337. package/tests/handlers/team-admin.test.ts +0 -291
  338. package/tests/handlers/team-analytics.test.ts +0 -220
  339. package/tests/handlers/team-core.test.ts +0 -148
  340. package/tests/handlers/team-data.test.ts +0 -198
  341. package/tests/handlers/team-relationships.test.ts +0 -271
  342. package/tests/handlers/team-resource-handlers.test.ts +0 -161
  343. package/tests/handlers/team-search.test.ts +0 -134
  344. package/tests/handlers/team-tool-handlers.test.ts +0 -301
  345. package/tests/handlers/team-vector.test.ts +0 -213
  346. package/tests/handlers/template-github-branches.test.ts +0 -676
  347. package/tests/handlers/tool-annotations.test.ts +0 -90
  348. package/tests/handlers/tool-handler-coverage.test.ts +0 -514
  349. package/tests/handlers/tool-handlers.test.ts +0 -510
  350. package/tests/handlers/tool-output-schemas.test.ts +0 -116
  351. package/tests/handlers/vector-tool-handlers.test.ts +0 -238
  352. package/tests/security/sql-injection.test.ts +0 -284
  353. package/tests/server/mcp-server.bench.ts +0 -55
  354. package/tests/server/mcp-server.test.ts +0 -1326
  355. package/tests/server/scheduler.test.ts +0 -400
  356. package/tests/transports/http-legacy-sse.test.ts +0 -275
  357. package/tests/transports/http-security.test.ts +0 -322
  358. package/tests/transports/http-stateful.test.ts +0 -487
  359. package/tests/transports/http-transport-server.test.ts +0 -301
  360. package/tests/transports/http-transport.test.ts +0 -771
  361. package/tests/utils/github-helpers.test.ts +0 -58
  362. package/tests/utils/logger.test.ts +0 -180
  363. package/tests/utils/mcp-logger.test.ts +0 -211
  364. package/tests/utils/progress-utils.test.ts +0 -156
  365. package/tests/utils/query-helpers.test.ts +0 -80
  366. package/tests/utils/security-utils.test.ts +0 -82
  367. package/tests/vector/vector-search-branches.test.ts +0 -111
  368. package/tests/vector/vector-search-manager.test.ts +0 -375
  369. package/tests/vector/vector-search.bench.ts +0 -48
  370. package/tsconfig.json +0 -42
  371. package/tsup.config.ts +0 -19
  372. package/vitest.config.ts +0 -25
@@ -1,115 +0,0 @@
1
- ---
2
- description: 'Audit README and DOCKER_README for consistency and accuracy on every code PR'
3
- private: true
4
- labels: [documentation, automation]
5
-
6
- on:
7
- pull_request:
8
- types: [opened, ready_for_review]
9
- paths: ['src/**', 'package.json', 'Dockerfile', 'tsconfig*.json', 'scripts/**']
10
-
11
- engine:
12
- id: copilot
13
- model: claude-opus-4-20250514
14
-
15
- network:
16
- allowed:
17
- - defaults
18
-
19
- permissions: read-all
20
-
21
- safe-outputs:
22
- add-comment:
23
- max: 3
24
- discussions: false
25
- noop:
26
- max: 1
27
-
28
- timeout-minutes: 15
29
- concurrency: docs-drift-detector
30
- ---
31
-
32
- # Documentation Drift Detector
33
-
34
- You are auditing documentation for the **memory-journal-mcp** project — a TypeScript MCP server for project context management. Your job is to check if documentation is accurate and consistent with each other and with recent changes.
35
-
36
- ## Important Rules
37
-
38
- - **You are read-only.** Never modify files. Only post comments.
39
- - **Be specific.** Quote the exact section and line that needs updating.
40
- - **Don't nitpick.** Focus on factual accuracy and consistency, not style or wording preferences.
41
- - **If everything looks good, say so.** Post a short ✅ confirmation via noop, don't create noise.
42
-
43
- ## Step 1: Understand Recent Changes
44
-
45
- 1. Read the PR diff to understand what code changed.
46
- 2. Read the `UNRELEASED.md` file. **Never read the full `CHANGELOG.md`** — it is very long and only the unreleased section is relevant.
47
- 3. Read the latest release notes file from `releases/` (the one with the highest version number).
48
-
49
- ## Step 2: Audit README.md
50
-
51
- Check the following against the PR diff and unreleased changes:
52
-
53
- - **Feature list and tool counts** — are all features described still accurate? Were tools added or removed? Does the tool count match?
54
- - **Version references** — version badges. Are they stale?
55
- - **Environment variables** — are all documented env vars still used in the code? Any new ones missing from docs?
56
- - **Install/usage instructions** — do Docker commands, CLI args, and config examples match the current codebase?
57
- - **Architecture/stack** — does the described tech stack match `package.json` dependencies?
58
- - **Error handling** — does the described error handling pattern (ErrorResponse with category, suggestion, recoverable) match the actual implementation?
59
-
60
- ## Step 3: Audit DOCKER_README.md
61
-
62
- Same checks as Step 2, plus:
63
-
64
- - **Available Tags table** — does it list the correct latest version?
65
- - **Docker Compose examples** — are port mappings, volume mounts, and env vars current?
66
- - **Security notes** — do they match the Dockerfile's actual patches and security measures?
67
- - **Multi-arch support** — is the platform support list accurate?
68
-
69
- ## Step 4: Audit CONTRIBUTING.md
70
-
71
- - **Directory tree** — does it match the actual `src/` directory structure?
72
- - **Error handling patterns** — do code examples match the current error hierarchy?
73
- - **Test instructions** — are test commands and patterns current?
74
- - **Module organization** — does it accurately describe the barrel export pattern?
75
-
76
- ## Step 5: Cross-Document Consistency
77
-
78
- Compare all documentation files for sections that should match:
79
-
80
- - Feature descriptions and tool counts across README.md, DOCKER_README.md
81
- - Error handling descriptions
82
- - Environment variable documentation
83
- - Version numbers
84
- - Server instructions preamble vs actual `server-instructions.ts`
85
-
86
- ## Step 6: Report Findings
87
-
88
- ### If drift is found:
89
-
90
- Use the `add-comment` tool to post a PR conversation comment with your findings organized as:
91
-
92
- ```
93
- ## 📋 Documentation Drift Report
94
-
95
- ### ⚠️ Drift Detected
96
-
97
- **README.md**
98
- - Line X: [description of issue and suggested fix]
99
-
100
- **DOCKER_README.md**
101
- - Line Y: [description of issue and suggested fix]
102
-
103
- **CONTRIBUTING.md**
104
- - Line Z: [description of issue and suggested fix]
105
-
106
- ### 🔄 Cross-Document Inconsistencies
107
- - [description of what doesn't match between docs]
108
-
109
- ### ✅ Verified Sections
110
- - [list of sections that are accurate]
111
- ```
112
-
113
- ### If no drift is found:
114
-
115
- Use the noop tool with: "✅ Documentation audit complete — all docs are consistent and accurate with current codebase."
@@ -1,60 +0,0 @@
1
- name: Lint and Test
2
-
3
- on:
4
- push:
5
- branches: [main]
6
- pull_request:
7
- branches: [main]
8
-
9
- permissions:
10
- contents: read
11
-
12
- jobs:
13
- lint:
14
- runs-on: ubuntu-latest
15
- strategy:
16
- matrix:
17
- node-version: [24.x, 25.x]
18
-
19
- steps:
20
- - name: Checkout code
21
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
22
-
23
- - name: Setup Node.js ${{ matrix.node-version }}
24
- uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6
25
- with:
26
- node-version: ${{ matrix.node-version }}
27
- cache: 'npm'
28
-
29
- - name: Install dependencies
30
- run: npm ci
31
-
32
- - name: Run ESLint
33
- run: npm run lint
34
-
35
- - name: Run TypeScript check
36
- run: npm run typecheck
37
-
38
- - name: Build
39
- run: npm run build
40
-
41
- - name: Run unit tests
42
- run: npm run test
43
-
44
- security-scan:
45
- runs-on: ubuntu-latest
46
- steps:
47
- - name: Checkout code
48
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
49
-
50
- - name: Setup Node.js
51
- uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6
52
- with:
53
- node-version: '24.x'
54
- cache: 'npm'
55
-
56
- - name: Install dependencies
57
- run: npm ci
58
-
59
- - name: Run npm audit
60
- run: npm audit --audit-level=moderate
@@ -1,85 +0,0 @@
1
- name: Publish to NPM
2
-
3
- # npm publish is gated behind Docker security checks:
4
- # - Triggered by docker-publish.yml after Docker Scout + image push succeeds
5
- # - Manual dispatch available as fallback
6
- on:
7
- workflow_call:
8
- secrets:
9
- NPM_TOKEN:
10
- required: true
11
- workflow_dispatch:
12
- inputs:
13
- version:
14
- description: 'Version to publish (must match package.json)'
15
- required: false
16
- default: ''
17
-
18
- permissions:
19
- contents: read
20
- id-token: write
21
-
22
- jobs:
23
- publish:
24
- runs-on: ubuntu-latest
25
- environment:
26
- name: npm
27
- url: https://www.npmjs.com/package/memory-journal-mcp
28
-
29
- steps:
30
- - name: Checkout code
31
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
32
- with:
33
- ref: ${{ github.event.workflow_run.head_sha || github.ref }}
34
-
35
- - name: Setup Node.js
36
- uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6
37
- with:
38
- node-version: '24.x'
39
- registry-url: 'https://registry.npmjs.org'
40
- cache: 'npm'
41
-
42
- - name: Install dependencies
43
- run: npm ci
44
-
45
- - name: Read version
46
- id: version
47
- run: |
48
- VERSION=$(node -p "require('./package.json').version")
49
- echo "version=$VERSION" >> $GITHUB_OUTPUT
50
- echo "Detected version: $VERSION"
51
-
52
- - name: Check if version already published
53
- id: check
54
- run: |
55
- PKG_VERSION="${{ steps.version.outputs.version }}"
56
- PUBLISHED=$(npm view memory-journal-mcp version 2>/dev/null || echo "none")
57
- echo "published=$PUBLISHED" >> $GITHUB_OUTPUT
58
- if [ "$PUBLISHED" = "$PKG_VERSION" ]; then
59
- echo "Version $PKG_VERSION already published, skipping"
60
- echo "skip=true" >> $GITHUB_OUTPUT
61
- else
62
- echo "Publishing version $PKG_VERSION (current published: $PUBLISHED)"
63
- echo "skip=false" >> $GITHUB_OUTPUT
64
- fi
65
-
66
- - name: Build package
67
- if: steps.check.outputs.skip != 'true'
68
- run: npm run build
69
-
70
- - name: Publish to NPM
71
- if: steps.check.outputs.skip != 'true'
72
- run: npm publish --access public --provenance
73
- env:
74
- NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
75
-
76
- - name: Verify publication
77
- if: steps.check.outputs.skip != 'true'
78
- run: |
79
- sleep 10
80
- PUBLISHED=$(npm view memory-journal-mcp version)
81
- EXPECTED="${{ steps.version.outputs.version }}"
82
- echo "Published: $PUBLISHED | Expected: $EXPECTED"
83
- if [ "$PUBLISHED" != "$EXPECTED" ]; then
84
- echo "::warning::Version mismatch after publish"
85
- fi
@@ -1,32 +0,0 @@
1
- name: Secret Scanning
2
-
3
- on:
4
- push:
5
- branches: [main]
6
- pull_request:
7
- branches: [main]
8
-
9
- permissions:
10
- contents: read
11
-
12
- jobs:
13
- secrets:
14
- runs-on: ubuntu-latest
15
- steps:
16
- - name: Checkout code
17
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
18
- with:
19
- fetch-depth: 0
20
-
21
- - name: TruffleHog Secret Scanning
22
- uses: trufflesecurity/trufflehog@6c05c4a00b91aa542267d8e32a8254774799d68d # v3.93.8
23
- with:
24
- path: ./
25
- base: ${{ github.event.before || 'HEAD~1' }}
26
- head: HEAD
27
- extra_args: --only-verified
28
-
29
- - name: GITLEAKS Secret Scanning
30
- uses: gitleaks/gitleaks-action@ff98106e4c7b2bc287b24eaf42907196329070c7 # v2.3.9
31
- env:
32
- GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -1,127 +0,0 @@
1
- name: Security Update Check
2
-
3
- on:
4
- schedule:
5
- # Run weekly on Sundays at 2 AM UTC
6
- - cron: '0 2 * * 0'
7
- push:
8
- branches: [main]
9
- paths:
10
- - 'Dockerfile'
11
- - 'package.json'
12
- - 'package-lock.json'
13
- - '.trivyignore'
14
- pull_request:
15
- branches: [main]
16
- paths:
17
- - 'Dockerfile'
18
- - 'package.json'
19
- - 'package-lock.json'
20
- workflow_dispatch:
21
-
22
- permissions:
23
- contents: write
24
- pull-requests: write
25
- security-events: write
26
- issues: write
27
-
28
- jobs:
29
- security-scan:
30
- runs-on: ubuntu-latest
31
-
32
- steps:
33
- - name: Checkout repository
34
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
35
-
36
- - name: Set up Docker Buildx
37
- uses: docker/setup-buildx-action@4d04d5d9486b7bd6fa91e7baf45bbb4f8b9deedd # v4
38
-
39
- - name: Build image for scanning
40
- uses: docker/build-push-action@d08e5c354a6adb9ed34480a06d141179aa583294 # v7
41
- with:
42
- context: .
43
- file: Dockerfile
44
- tags: security-test:latest
45
- load: true
46
- cache-from: type=gha
47
- cache-to: type=gha,mode=max
48
-
49
- # Run SARIF scan first (non-blocking) to always generate the file
50
- - name: Run Trivy scanner for SARIF output
51
- uses: aquasecurity/trivy-action@57a97c7e7821a5776cebc9bb87c984fa69cba8f1 # 0.35.0
52
- with:
53
- image-ref: security-test:latest
54
- format: 'sarif'
55
- output: 'trivy-results.sarif'
56
- exit-code: '0'
57
- ignore-unfixed: true
58
- severity: 'CRITICAL,HIGH,MEDIUM'
59
- trivyignores: '.trivyignore'
60
- skip-dirs: '/usr/local/lib/node_modules/npm'
61
-
62
- - name: Upload Trivy scan results
63
- uses: github/codeql-action/upload-sarif@f0213c31c702f929cf06ddb900ac315d246a8997 # v4.33.0
64
- if: always() && hashFiles('trivy-results.sarif') != ''
65
- with:
66
- sarif_file: 'trivy-results.sarif'
67
-
68
- # Run table scan (blocking) after SARIF is uploaded
69
- - name: Run Trivy vulnerability scanner
70
- uses: aquasecurity/trivy-action@57a97c7e7821a5776cebc9bb87c984fa69cba8f1 # 0.35.0
71
- with:
72
- image-ref: security-test:latest
73
- format: 'table'
74
- exit-code: '1'
75
- ignore-unfixed: true
76
- severity: 'CRITICAL,HIGH,MEDIUM'
77
- trivyignores: '.trivyignore'
78
- skip-dirs: '/usr/local/lib/node_modules/npm'
79
-
80
- - name: Create security issue if vulnerabilities found
81
- if: failure()
82
- uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8
83
- with:
84
- script: |
85
- const title = '🚨 Security vulnerabilities detected in Docker images'
86
-
87
- // Check for existing open issue with same title to avoid duplicates
88
- const { data: existing } = await github.rest.issues.listForRepo({
89
- owner: context.repo.owner,
90
- repo: context.repo.repo,
91
- state: 'open',
92
- labels: 'security,vulnerability,docker',
93
- per_page: 10,
94
- })
95
- if (existing.some(issue => issue.title === title)) {
96
- console.log('Open security issue already exists — skipping creation')
97
- return
98
- }
99
-
100
- github.rest.issues.create({
101
- owner: context.repo.owner,
102
- repo: context.repo.repo,
103
- title,
104
- body: `
105
- ## Security Alert
106
-
107
- Trivy has detected security vulnerabilities in our Docker images.
108
-
109
- **Action Required:**
110
- 1. Review the security scan results in the Actions tab
111
- 2. Update base images and dependencies
112
- 3. Test the fixes
113
- 4. Deploy updated images
114
-
115
- **Scan Details:**
116
- - Workflow run: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
117
- - Triggered by: Weekly security scan
118
- - Scan Date: ${{ github.event.schedule || 'Manual trigger' }}
119
-
120
- **Next Steps:**
121
- - [ ] Review vulnerability details
122
- - [ ] Update Dockerfiles
123
- - [ ] Test changes
124
- - [ ] Deploy fixes
125
- `,
126
- labels: ['security', 'vulnerability', 'docker']
127
- })
package/.gitleaks.toml DELETED
@@ -1,9 +0,0 @@
1
- # Gitleaks Configuration
2
- # https://github.com/gitleaks/gitleaks#configuration
3
-
4
- title = "memory-journal-mcp gitleaks config"
5
-
6
- # Allowlist for known false positives in test fixtures
7
- [allowlist]
8
- description = "Test fixtures containing intentionally fake secrets"
9
- paths = []
package/.prettierignore DELETED
@@ -1,21 +0,0 @@
1
- # Build output
2
- dist/
3
- build/
4
-
5
- # Dependencies
6
- node_modules/
7
-
8
- # Package manager files
9
- package-lock.json
10
- pnpm-lock.yaml
11
-
12
- # Logs
13
- *.log
14
-
15
- # Generated
16
- *.min.js
17
- *.min.css
18
-
19
- # Database files
20
- *.db
21
- *.sqlite
package/.prettierrc DELETED
@@ -1,33 +0,0 @@
1
- {
2
- "semi": false,
3
- "singleQuote": true,
4
- "tabWidth": 4,
5
- "useTabs": false,
6
- "trailingComma": "es5",
7
- "printWidth": 100,
8
- "bracketSpacing": true,
9
- "arrowParens": "always",
10
- "endOfLine": "auto",
11
- "proseWrap": "preserve",
12
- "overrides": [
13
- {
14
- "files": ["*.json", "*.jsonc"],
15
- "options": {
16
- "tabWidth": 4
17
- }
18
- },
19
- {
20
- "files": ["*.yaml", "*.yml"],
21
- "options": {
22
- "tabWidth": 2
23
- }
24
- },
25
- {
26
- "files": ["*.md"],
27
- "options": {
28
- "tabWidth": 2,
29
- "proseWrap": "preserve"
30
- }
31
- }
32
- ]
33
- }
package/.scout-ignore DELETED
@@ -1,12 +0,0 @@
1
- # Docker Scout CVE Ignore File
2
- # See: https://docs.docker.com/scout/explore/cve-ignorelist/
3
- #
4
- # Only include CVEs with NO upstream fix available
5
-
6
- # Alpine zlib - Critical severity, but NO FIX VERSION RELEASED by Alpine yet
7
- # zlib 1.3.1.3 contains the fix but Alpine hasn't packaged it
8
- CVE-2026-22184
9
-
10
- # Alpine busybox - wget CRLF injection (MEDIUM)
11
- # Patch submitted to busybox upstream but not in a release yet
12
- CVE-2025-60876
package/.trivyignore DELETED
@@ -1,21 +0,0 @@
1
- # Trivy CVE Ignore List for memory-journal-mcp
2
- # Add CVEs here that are:
3
- # 1. False positives
4
- # 2. Upstream issues with no fix available
5
- # 3. Not applicable to our use case
6
-
7
- # Format: CVE-YYYY-NNNNN
8
-
9
- # libexpat — No attack surface. This project is TypeScript/Node.js and does not
10
- # parse untrusted XML/DTD content. libexpat is a transitive Alpine system dependency.
11
-
12
- # CRITICAL — Mislabeled/poisoned CVE (supply chain data corruption in advisory feed).
13
- # Description is a SiYuan Note application-level authorization bypass (Go web app)
14
- # that was incorrectly attributed to the libexpat package. Not a real libexpat vuln.
15
- CVE-2026-32767
16
-
17
- # MEDIUM — DoS via infinite loop in DTD content parsing. No XML attack surface.
18
- CVE-2026-32777
19
-
20
- # MEDIUM — DoS via NULL pointer dereference after OOM. No XML attack surface.
21
- CVE-2026-32778