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.
- package/README.md +44 -28
- package/dist/{chunk-X4SWFATC.js → chunk-BI4ZNSKA.js} +38 -24
- package/dist/{chunk-HCEWINSB.js → chunk-N6EBIDN7.js} +99 -102
- package/dist/cli.js +2 -2
- package/dist/index.js +2 -2
- package/dist/tools-WPRY5MJ6.js +2 -0
- package/package.json +10 -1
- package/skills/github-commander/SKILL.md +151 -0
- package/skills/github-commander/config/project-config.example.md +125 -0
- package/skills/github-commander/workflows/code-quality-audit.md +80 -0
- package/skills/github-commander/workflows/full-audit.md +134 -0
- package/skills/github-commander/workflows/issue-triage.md +239 -0
- package/skills/github-commander/workflows/milestone-sprint.md +81 -0
- package/skills/github-commander/workflows/perf-audit.md +142 -0
- package/skills/github-commander/workflows/pr-review.md +123 -0
- package/skills/github-commander/workflows/security-audit.md +170 -0
- package/skills/github-commander/workflows/update-deps.md +109 -0
- package/.dockerignore +0 -139
- package/.gitattributes +0 -20
- package/.github/ISSUE_TEMPLATE/bug_report.md +0 -95
- package/.github/ISSUE_TEMPLATE/config.yml +0 -11
- package/.github/ISSUE_TEMPLATE/feature_request.md +0 -110
- package/.github/ISSUE_TEMPLATE/question.md +0 -78
- package/.github/aw/actions-lock.json +0 -14
- package/.github/copilot-instructions.md +0 -122
- package/.github/dependabot.yml +0 -93
- package/.github/pull_request_template.md +0 -135
- package/.github/workflows/README.md +0 -133
- package/.github/workflows/agentics-maintenance.yml +0 -141
- package/.github/workflows/auto-release.yml +0 -68
- package/.github/workflows/ci-health-monitor.lock.yml +0 -1121
- package/.github/workflows/ci-health-monitor.md +0 -87
- package/.github/workflows/codeql.yml +0 -41
- package/.github/workflows/dependabot-auto-merge.yml +0 -42
- package/.github/workflows/dependency-maintenance.lock.yml +0 -1182
- package/.github/workflows/dependency-maintenance.md +0 -147
- package/.github/workflows/docker-publish.yml +0 -254
- package/.github/workflows/docs-drift-detector.lock.yml +0 -1142
- package/.github/workflows/docs-drift-detector.md +0 -115
- package/.github/workflows/lint-and-test.yml +0 -60
- package/.github/workflows/publish-npm.yml +0 -85
- package/.github/workflows/secrets-scanning.yml +0 -32
- package/.github/workflows/security-update.yml +0 -127
- package/.gitleaks.toml +0 -9
- package/.prettierignore +0 -21
- package/.prettierrc +0 -33
- package/.scout-ignore +0 -12
- package/.trivyignore +0 -21
- package/CHANGELOG.md +0 -1814
- package/CODE_OF_CONDUCT.md +0 -133
- package/CONTRIBUTING.md +0 -263
- package/DOCKER_README.md +0 -331
- package/Dockerfile +0 -128
- package/SECURITY.md +0 -227
- package/UNRELEASED.md +0 -1
- package/dist/tools-T4U5A3X4.js +0 -2
- package/docker-compose.yml +0 -71
- package/docs/README.md +0 -18
- package/docs/agentic-journal-synergy.md +0 -175
- package/docs/copilot-setup.md +0 -72
- package/eslint.config.js +0 -110
- package/mcp-config-example.json +0 -21
- package/playwright.config.ts +0 -35
- package/releases/v2.1.0.md +0 -220
- package/releases/v2.2.0.md +0 -168
- package/releases/v3.0.0.md +0 -237
- package/releases/v3.1.0.md +0 -104
- package/releases/v3.1.1.md +0 -42
- package/releases/v3.1.2.md +0 -40
- package/releases/v3.1.3.md +0 -64
- package/releases/v3.1.4.md +0 -32
- package/releases/v3.1.5.md +0 -44
- package/releases/v4.0.0.md +0 -71
- package/releases/v4.1.0.md +0 -88
- package/releases/v4.2.0.md +0 -90
- package/releases/v4.3.0.md +0 -92
- package/releases/v4.3.1.md +0 -69
- package/releases/v4.4.0.md +0 -120
- package/releases/v4.4.1.md +0 -33
- package/releases/v4.4.2.md +0 -31
- package/releases/v4.5.0.md +0 -116
- package/releases/v5.0.0.md +0 -105
- package/releases/v5.0.1.md +0 -25
- package/releases/v5.1.0.md +0 -83
- package/releases/v5.1.1.md +0 -10
- package/releases/v6.0.0.md +0 -48
- package/releases/v6.0.1.md +0 -36
- package/releases/v6.1.0.md +0 -68
- package/releases/v6.1.1.md +0 -30
- package/releases/v6.1.2.md +0 -23
- package/scripts/generate-server-instructions.ts +0 -306
- package/scripts/server-instructions-function-body.ts +0 -107
- package/scripts/server-instructions-gotchas.ts +0 -45
- package/server.json +0 -42
- package/social-preview.png +0 -0
- package/src/auth/auth-context.ts +0 -78
- package/src/auth/authorization-server-discovery.ts +0 -263
- package/src/auth/errors.ts +0 -215
- package/src/auth/index.ts +0 -58
- package/src/auth/middleware.ts +0 -392
- package/src/auth/oauth-resource-server.ts +0 -170
- package/src/auth/scope-map.ts +0 -46
- package/src/auth/scopes.ts +0 -256
- package/src/auth/token-validator.ts +0 -293
- package/src/auth/transport-agnostic.ts +0 -164
- package/src/auth/types.ts +0 -372
- package/src/cli.ts +0 -279
- package/src/codemode/api-constants.ts +0 -263
- package/src/codemode/api.ts +0 -302
- package/src/codemode/auto-return.ts +0 -65
- package/src/codemode/index.ts +0 -47
- package/src/codemode/sandbox-factory.ts +0 -144
- package/src/codemode/sandbox.ts +0 -220
- package/src/codemode/security.ts +0 -155
- package/src/codemode/types.ts +0 -228
- package/src/codemode/worker-sandbox.ts +0 -277
- package/src/codemode/worker-script.ts +0 -239
- package/src/constants/icons.ts +0 -183
- package/src/constants/server-instructions.md +0 -166
- package/src/constants/server-instructions.ts +0 -514
- package/src/database/adapter-factory.ts +0 -16
- package/src/database/core/entry-columns.ts +0 -10
- package/src/database/core/interfaces.ts +0 -188
- package/src/database/core/schema.ts +0 -152
- package/src/database/sqlite-adapter/backup.ts +0 -167
- package/src/database/sqlite-adapter/entries/crud.ts +0 -233
- package/src/database/sqlite-adapter/entries/importance.ts +0 -76
- package/src/database/sqlite-adapter/entries/index.ts +0 -142
- package/src/database/sqlite-adapter/entries/search.ts +0 -294
- package/src/database/sqlite-adapter/entries/shared.ts +0 -102
- package/src/database/sqlite-adapter/entries/statistics.ts +0 -162
- package/src/database/sqlite-adapter/index.ts +0 -265
- package/src/database/sqlite-adapter/native-connection.ts +0 -301
- package/src/database/sqlite-adapter/relationships.ts +0 -70
- package/src/database/sqlite-adapter/tags.ts +0 -182
- package/src/filtering/tool-filter.ts +0 -312
- package/src/github/github-integration/client.ts +0 -114
- package/src/github/github-integration/index.ts +0 -297
- package/src/github/github-integration/insights.ts +0 -155
- package/src/github/github-integration/issues.ts +0 -213
- package/src/github/github-integration/milestones.ts +0 -262
- package/src/github/github-integration/projects.ts +0 -414
- package/src/github/github-integration/pull-requests.ts +0 -235
- package/src/github/github-integration/repository.ts +0 -110
- package/src/github/github-integration/types.ts +0 -43
- package/src/handlers/prompts/github.ts +0 -210
- package/src/handlers/prompts/index.ts +0 -97
- package/src/handlers/prompts/workflow.ts +0 -361
- package/src/handlers/resources/core/briefing/context-section.ts +0 -182
- package/src/handlers/resources/core/briefing/github-section.ts +0 -354
- package/src/handlers/resources/core/briefing/index.ts +0 -106
- package/src/handlers/resources/core/briefing/user-message.ts +0 -114
- package/src/handlers/resources/core/health.ts +0 -75
- package/src/handlers/resources/core/index.ts +0 -31
- package/src/handlers/resources/core/instructions.ts +0 -45
- package/src/handlers/resources/core/utilities.ts +0 -310
- package/src/handlers/resources/github.ts +0 -340
- package/src/handlers/resources/graph.ts +0 -218
- package/src/handlers/resources/help.ts +0 -410
- package/src/handlers/resources/index.ts +0 -143
- package/src/handlers/resources/shared.ts +0 -219
- package/src/handlers/resources/team.ts +0 -134
- package/src/handlers/resources/templates.ts +0 -334
- package/src/handlers/tools/admin.ts +0 -351
- package/src/handlers/tools/analytics.ts +0 -346
- package/src/handlers/tools/backup.ts +0 -272
- package/src/handlers/tools/codemode.ts +0 -188
- package/src/handlers/tools/core.ts +0 -359
- package/src/handlers/tools/error-fields-mixin.ts +0 -10
- package/src/handlers/tools/export.ts +0 -150
- package/src/handlers/tools/github/copilot-tools.ts +0 -72
- package/src/handlers/tools/github/helpers.ts +0 -125
- package/src/handlers/tools/github/insights-tools.ts +0 -112
- package/src/handlers/tools/github/issue-tools.ts +0 -442
- package/src/handlers/tools/github/kanban-tools.ts +0 -153
- package/src/handlers/tools/github/milestone-tools.ts +0 -371
- package/src/handlers/tools/github/mutation-tools.ts +0 -17
- package/src/handlers/tools/github/read-tools.ts +0 -302
- package/src/handlers/tools/github/schemas.ts +0 -435
- package/src/handlers/tools/github.ts +0 -39
- package/src/handlers/tools/index.ts +0 -255
- package/src/handlers/tools/relationships.ts +0 -390
- package/src/handlers/tools/schemas.ts +0 -165
- package/src/handlers/tools/search.ts +0 -448
- package/src/handlers/tools/team/admin-tools.ts +0 -164
- package/src/handlers/tools/team/analytics-tools.ts +0 -233
- package/src/handlers/tools/team/backup-tools.ts +0 -83
- package/src/handlers/tools/team/core-tools.ts +0 -197
- package/src/handlers/tools/team/export-tools.ts +0 -130
- package/src/handlers/tools/team/helpers.ts +0 -66
- package/src/handlers/tools/team/index.ts +0 -45
- package/src/handlers/tools/team/relationship-tools.ts +0 -219
- package/src/handlers/tools/team/schemas.ts +0 -558
- package/src/handlers/tools/team/search-tools.ts +0 -145
- package/src/handlers/tools/team/vector-tools.ts +0 -261
- package/src/index.ts +0 -57
- package/src/server/mcp-server.ts +0 -446
- package/src/server/registration.ts +0 -141
- package/src/server/scheduler.ts +0 -283
- package/src/transports/http/handlers.ts +0 -78
- package/src/transports/http/index.ts +0 -8
- package/src/transports/http/security.ts +0 -147
- package/src/transports/http/server/index.ts +0 -397
- package/src/transports/http/server/legacy-sse.ts +0 -87
- package/src/transports/http/server/stateful.ts +0 -222
- package/src/transports/http/server/stateless.ts +0 -42
- package/src/transports/http/types.ts +0 -132
- package/src/types/entities.ts +0 -145
- package/src/types/error-types.ts +0 -92
- package/src/types/errors.ts +0 -200
- package/src/types/filtering.ts +0 -55
- package/src/types/github.ts +0 -216
- package/src/types/index.ts +0 -348
- package/src/utils/error-helpers.ts +0 -78
- package/src/utils/errors/error-response-fields.ts +0 -29
- package/src/utils/errors/suggestions.ts +0 -94
- package/src/utils/github-helpers.ts +0 -33
- package/src/utils/logger.ts +0 -107
- package/src/utils/mcp-logger.ts +0 -155
- package/src/utils/progress-utils.ts +0 -100
- package/src/utils/query-helpers.ts +0 -78
- package/src/utils/resource-annotations.ts +0 -75
- package/src/utils/security-utils.ts +0 -198
- package/src/utils/vector-index-helpers.ts +0 -24
- package/src/vector/vector-search-manager.ts +0 -409
- package/src/version.ts +0 -15
- package/test-server/README.md +0 -193
- package/test-server/code-map.md +0 -399
- package/test-server/test-agent-experience.md +0 -213
- package/test-server/test-filter-instructions.mjs +0 -295
- package/test-server/test-instruction-levels.mjs +0 -102
- package/test-server/test-preflight.md +0 -55
- package/test-server/test-prompts.mjs +0 -185
- package/test-server/test-scheduler.mjs +0 -174
- package/test-server/test-tool-annotations.mjs +0 -115
- package/test-server/test-tools-codemode.md +0 -632
- package/test-server/test-tools-codemode2.md +0 -1218
- package/test-server/test-tools-team.md +0 -215
- package/test-server/test-tools.md +0 -429
- package/test-server/test-tools2.md +0 -361
- package/test-server/test-tools3.md +0 -396
- package/test-server/tool-reference.md +0 -231
- package/tests/README.md +0 -54
- package/tests/auth/auth-context.test.ts +0 -162
- package/tests/auth/authorization-server-discovery.test.ts +0 -265
- package/tests/auth/errors.test.ts +0 -170
- package/tests/auth/middleware.test.ts +0 -585
- package/tests/auth/oauth-resource-server.test.ts +0 -173
- package/tests/auth/scope-map.test.ts +0 -66
- package/tests/auth/scopes.test.ts +0 -347
- package/tests/auth/token-validator.test.ts +0 -271
- package/tests/codemode/api.test.ts +0 -396
- package/tests/codemode/auto-return.test.ts +0 -167
- package/tests/codemode/codemode-tool-handlers.test.ts +0 -197
- package/tests/codemode/sandbox-factory.test.ts +0 -152
- package/tests/codemode/sandbox.test.ts +0 -190
- package/tests/codemode/security.test.ts +0 -242
- package/tests/codemode/worker-sandbox.test.ts +0 -106
- package/tests/constants/icons.test.ts +0 -101
- package/tests/constants/server-instructions.test.ts +0 -514
- package/tests/database/crud-workflow-branches.test.ts +0 -418
- package/tests/database/database-branches.test.ts +0 -132
- package/tests/database/entries-auth-branches.test.ts +0 -390
- package/tests/database/native-connection.test.ts +0 -249
- package/tests/database/shared-helpers.test.ts +0 -103
- package/tests/database/sqlite-adapter.bench.ts +0 -63
- package/tests/database/sqlite-adapter.test.ts +0 -690
- package/tests/database/tags.test.ts +0 -134
- package/tests/e2e/README.md +0 -39
- package/tests/e2e/auth.spec.ts +0 -106
- package/tests/e2e/codemode-abuse.spec.ts +0 -75
- package/tests/e2e/health.spec.ts +0 -63
- package/tests/e2e/helpers.ts +0 -139
- package/tests/e2e/oauth-discovery.spec.ts +0 -102
- package/tests/e2e/oauth-scopes.spec.ts +0 -222
- package/tests/e2e/payloads-admin.spec.ts +0 -76
- package/tests/e2e/payloads-analytics.spec.ts +0 -37
- package/tests/e2e/payloads-backup-restore.spec.ts +0 -102
- package/tests/e2e/payloads-backup.spec.ts +0 -44
- package/tests/e2e/payloads-codemode-api.spec.ts +0 -131
- package/tests/e2e/payloads-codemode-readonly.spec.ts +0 -116
- package/tests/e2e/payloads-codemode.spec.ts +0 -116
- package/tests/e2e/payloads-core.spec.ts +0 -82
- package/tests/e2e/payloads-error-contracts.spec.ts +0 -159
- package/tests/e2e/payloads-export.spec.ts +0 -46
- package/tests/e2e/payloads-github-degradation.spec.ts +0 -73
- package/tests/e2e/payloads-github.spec.ts +0 -176
- package/tests/e2e/payloads-relationships.spec.ts +0 -56
- package/tests/e2e/payloads-search.spec.ts +0 -64
- package/tests/e2e/payloads-team-happy.spec.ts +0 -231
- package/tests/e2e/payloads-team.spec.ts +0 -174
- package/tests/e2e/prompts-expanded.spec.ts +0 -137
- package/tests/e2e/prompts.spec.ts +0 -62
- package/tests/e2e/protocols.spec.ts +0 -134
- package/tests/e2e/rate-limiting.spec.ts +0 -291
- package/tests/e2e/resources-briefing-env.spec.ts +0 -106
- package/tests/e2e/resources-complete.spec.ts +0 -180
- package/tests/e2e/resources-expanded.spec.ts +0 -83
- package/tests/e2e/resources-instructions-levels.spec.ts +0 -145
- package/tests/e2e/resources-templates.spec.ts +0 -123
- package/tests/e2e/resources.spec.ts +0 -103
- package/tests/e2e/scheduler.spec.ts +0 -79
- package/tests/e2e/security.spec.ts +0 -112
- package/tests/e2e/session-advanced.spec.ts +0 -152
- package/tests/e2e/sessions.spec.ts +0 -95
- package/tests/e2e/stateless.spec.ts +0 -79
- package/tests/e2e/streaming.spec.ts +0 -176
- package/tests/e2e/tool-filtering-presets.spec.ts +0 -192
- package/tests/e2e/tool-filtering.spec.ts +0 -77
- package/tests/e2e/tools.spec.ts +0 -111
- package/tests/filtering/tool-filter.test.ts +0 -314
- package/tests/github/client-issues-errors.test.ts +0 -433
- package/tests/github/github-integration-branches.test.ts +0 -490
- package/tests/github/github-integration.test.ts +0 -1015
- package/tests/github/github-managers-branches.test.ts +0 -907
- package/tests/github/pull-requests.test.ts +0 -334
- package/tests/handlers/analytics-branches.test.ts +0 -222
- package/tests/handlers/backup-branches.test.ts +0 -270
- package/tests/handlers/briefing-context-section.test.ts +0 -388
- package/tests/handlers/briefing-github-section.test.ts +0 -392
- package/tests/handlers/briefing-user-message.test.ts +0 -405
- package/tests/handlers/codemode-tools.test.ts +0 -85
- package/tests/handlers/copilot-tools.test.ts +0 -126
- package/tests/handlers/error-path-coverage.test.ts +0 -324
- package/tests/handlers/export-tools.test.ts +0 -203
- package/tests/handlers/github-resource-handlers.test.ts +0 -929
- package/tests/handlers/github-tool-handlers.test.ts +0 -1452
- package/tests/handlers/handler-error-branches.test.ts +0 -346
- package/tests/handlers/help-resource.test.ts +0 -92
- package/tests/handlers/prompt-handler-coverage.test.ts +0 -108
- package/tests/handlers/prompt-handlers.test.ts +0 -131
- package/tests/handlers/resource-handler-coverage.test.ts +0 -281
- package/tests/handlers/resource-handlers.test.ts +0 -357
- package/tests/handlers/resource-prompt-branches.test.ts +0 -495
- package/tests/handlers/search-tool-handlers.test.ts +0 -379
- package/tests/handlers/targeted-gap-closure.test.ts +0 -387
- package/tests/handlers/team-admin.test.ts +0 -291
- package/tests/handlers/team-analytics.test.ts +0 -220
- package/tests/handlers/team-core.test.ts +0 -148
- package/tests/handlers/team-data.test.ts +0 -198
- package/tests/handlers/team-relationships.test.ts +0 -271
- package/tests/handlers/team-resource-handlers.test.ts +0 -161
- package/tests/handlers/team-search.test.ts +0 -134
- package/tests/handlers/team-tool-handlers.test.ts +0 -301
- package/tests/handlers/team-vector.test.ts +0 -213
- package/tests/handlers/template-github-branches.test.ts +0 -676
- package/tests/handlers/tool-annotations.test.ts +0 -90
- package/tests/handlers/tool-handler-coverage.test.ts +0 -514
- package/tests/handlers/tool-handlers.test.ts +0 -510
- package/tests/handlers/tool-output-schemas.test.ts +0 -116
- package/tests/handlers/vector-tool-handlers.test.ts +0 -238
- package/tests/security/sql-injection.test.ts +0 -284
- package/tests/server/mcp-server.bench.ts +0 -55
- package/tests/server/mcp-server.test.ts +0 -1326
- package/tests/server/scheduler.test.ts +0 -400
- package/tests/transports/http-legacy-sse.test.ts +0 -275
- package/tests/transports/http-security.test.ts +0 -322
- package/tests/transports/http-stateful.test.ts +0 -487
- package/tests/transports/http-transport-server.test.ts +0 -301
- package/tests/transports/http-transport.test.ts +0 -771
- package/tests/utils/github-helpers.test.ts +0 -58
- package/tests/utils/logger.test.ts +0 -180
- package/tests/utils/mcp-logger.test.ts +0 -211
- package/tests/utils/progress-utils.test.ts +0 -156
- package/tests/utils/query-helpers.test.ts +0 -80
- package/tests/utils/security-utils.test.ts +0 -82
- package/tests/vector/vector-search-branches.test.ts +0 -111
- package/tests/vector/vector-search-manager.test.ts +0 -375
- package/tests/vector/vector-search.bench.ts +0 -48
- package/tsconfig.json +0 -42
- package/tsup.config.ts +0 -19
- 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
|