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,361 +0,0 @@
|
|
|
1
|
-
# Test memory-journal-mcp — Schemas, Resources & GitHub
|
|
2
|
-
|
|
3
|
-
Exhaustively validate the memory-journal-mcp server's output schemas, resource handling, and GitHub integration.
|
|
4
|
-
|
|
5
|
-
**Scope:** Cross-cutting validation of all 61 tools (60 with outputSchema + Code Mode) and 28 resources — this file covers outputSchema verification, all resource validation (static + template), and GitHub tool happy paths + lifecycle + cleanup. Phases 0-2. Error handling, data integrity, boundary values, and implementation bug detection are covered in `test-tools3.md`.
|
|
6
|
-
|
|
7
|
-
**Prerequisites:**
|
|
8
|
-
|
|
9
|
-
- The core tests in `test-tools.md` must have completed successfully and any fixes applied before running this file.
|
|
10
|
-
- Confirm MCP server instructions were auto-received before starting.
|
|
11
|
-
- Use the MCP server directly for all tests — not the terminal or scripts.
|
|
12
|
-
- Use https://github.com/users/neverinfamous/projects/5 for project/Kanban testing.
|
|
13
|
-
|
|
14
|
-
**Workflow after testing:**
|
|
15
|
-
|
|
16
|
-
1. Create a plan to implement any fixes and/or improvement opportunities, including changes to `server-instructions.md`/`server-instructions.ts` or this file (`test-server/test-tools2.md`).
|
|
17
|
-
2. Use `code-map.md` as a source of truth and ensure fixes comply with `C:\Users\chris\Desktop\adamic\skills\mcp-builder`.
|
|
18
|
-
3. After implementation, update `UNRELEASED.md` and commit without pushing. Then, stop so the user can verify with `npm run lint && npm run typecheck`, `npm run test`, and `npm run test:e2e`.
|
|
19
|
-
4. After user completes verification, re-test fixes with direct MCP calls.
|
|
20
|
-
5. Provide a very brief final summary.
|
|
21
|
-
|
|
22
|
-
> [!IMPORTANT]
|
|
23
|
-
> **Test Session Prerequisites**
|
|
24
|
-
|
|
25
|
-
1. The server instructions are auto-injected by the MCP protocol. Confirm receipt (no need to read `memory://instructions` separately).
|
|
26
|
-
2. Read `memory://briefing` to confirm context loaded (the briefing table confirms receipt).
|
|
27
|
-
|
|
28
|
-
---
|
|
29
|
-
|
|
30
|
-
## Phase 0: outputSchema Validation
|
|
31
|
-
|
|
32
|
-
> [!NOTE]
|
|
33
|
-
> **60 tools** now return `structuredContent` validated against Zod output schemas (`mj_execute_code` intentionally excluded — its dynamic return type produces a bare `{}` JSON Schema that crashes clients processing `structuredContent`).
|
|
34
|
-
> Verify each response is structured JSON (not raw text).
|
|
35
|
-
|
|
36
|
-
### 0.1 Original 5 Tools
|
|
37
|
-
|
|
38
|
-
| Tool | Verification |
|
|
39
|
-
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
40
|
-
| `get_recent_entries` | Response has `entries` array with typed objects |
|
|
41
|
-
| `search_entries` | Response has `entries` array with `id`, `timestamp`, `content`, etc. |
|
|
42
|
-
| `search_by_date_range` | Response has `entries` array |
|
|
43
|
-
| `get_entry_by_id` | Response has `entry` object with `relationships` array |
|
|
44
|
-
| `get_statistics` | Response has `totalEntries`, `entriesByType`, `entriesByPeriod`, `decisionDensity`, `relationshipComplexity`, `activityTrend`, `causalMetrics` |
|
|
45
|
-
|
|
46
|
-
### 0.2 Core Read Tools
|
|
47
|
-
|
|
48
|
-
| Tool | Schema | Verification |
|
|
49
|
-
| ---------------------------- | ---------------------------------- | -------------------------------------------------------------- |
|
|
50
|
-
| `semantic_search` | `SemanticSearchOutputSchema` | `query`, `entries` (with `similarity`), `count` |
|
|
51
|
-
| `list_tags` | `TagsListOutputSchema` | `tags` array with `name`, `count` per tag |
|
|
52
|
-
| `get_vector_index_stats` | `VectorStatsOutputSchema` | `available`, `itemCount`, `modelName`, `dimensions`, `success` |
|
|
53
|
-
| `visualize_relationships` | `VisualizationOutputSchema` | `entry_count`, `relationship_count`, `mermaid`, `legend` |
|
|
54
|
-
| `get_cross_project_insights` | `CrossProjectInsightsOutputSchema` | `project_count`, `total_entries`, `projects` array |
|
|
55
|
-
|
|
56
|
-
### 0.3 Mutation Tools
|
|
57
|
-
|
|
58
|
-
| Tool | Schema | Verification |
|
|
59
|
-
| ---------------------- | ------------------------- | ----------------------------------------------------------------------- |
|
|
60
|
-
| `create_entry` | `CreateEntryOutputSchema` | `success: true`, `entry` object |
|
|
61
|
-
| `create_entry_minimal` | `CreateEntryOutputSchema` | `success: true`, `entry` object |
|
|
62
|
-
| `update_entry` | `UpdateEntryOutputSchema` | `success`, `entry` (or `error`) |
|
|
63
|
-
| `delete_entry` | `DeleteEntryOutputSchema` | `success`, `entryId`, `permanent` |
|
|
64
|
-
| `link_entries` | `LinkEntriesOutputSchema` | `success: true`, `relationship` object, optional `duplicate`, `message` |
|
|
65
|
-
| `merge_tags` | `MergeTagsOutputSchema` | `success`, `sourceTag`, `targetTag`, `entriesUpdated`, `message` |
|
|
66
|
-
|
|
67
|
-
### 0.4 GitHub Tools
|
|
68
|
-
|
|
69
|
-
| Tool | Schema | Verification |
|
|
70
|
-
| --------------------- | ------------------------------- | -------------------------------------------------------------- |
|
|
71
|
-
| `get_github_issues` | `GitHubIssuesListOutputSchema` | `owner`, `repo`, `issues` array, `count` |
|
|
72
|
-
| `get_github_issues` | (milestone field) | Issue objects include optional `milestone` with number & title |
|
|
73
|
-
| `get_github_prs` | `GitHubPRsListOutputSchema` | `owner`, `repo`, `pullRequests` array, `count` |
|
|
74
|
-
| `get_github_issue` | `GitHubIssueResultOutputSchema` | `issue` object with `body`, `labels`, `assignees` |
|
|
75
|
-
| `get_github_pr` | `GitHubPRResultOutputSchema` | `pullRequest` with `draft`, `headBranch`, `additions` |
|
|
76
|
-
| `get_github_context` | `GitHubContextOutputSchema` | `repoName`, `branch`, `issues`, `pullRequests` |
|
|
77
|
-
| `get_kanban_board` | `KanbanBoardOutputSchema` | `projectId`, `columns` array, `statusOptions` |
|
|
78
|
-
| `get_repo_insights` | `RepoInsightsOutputSchema` | `owner`, `repo`, requested `section` data |
|
|
79
|
-
| `get_copilot_reviews` | `CopilotReviewsOutputSchema` | `prNumber`, `state`, `commentCount`, `comments` array |
|
|
80
|
-
|
|
81
|
-
### 0.5 Backup Tools
|
|
82
|
-
|
|
83
|
-
| Tool | Schema | Verification |
|
|
84
|
-
| ----------------- | ---------------------------- | ---------------------------------------------------------------------------------------------- |
|
|
85
|
-
| `backup_journal` | `BackupResultOutputSchema` | `success`, `message`, `filename`, `path`, `sizeBytes` |
|
|
86
|
-
| `list_backups` | `BackupsListOutputSchema` | `backups` array, `total`, `backupsDirectory` |
|
|
87
|
-
| `cleanup_backups` | `CleanupBackupsOutputSchema` | `success`, `deleted` array, `deletedCount`, `keptCount` |
|
|
88
|
-
| `restore_backup` | `RestoreResultOutputSchema` | `success`, `message`, `restoredFrom`, `previousEntryCount`, `newEntryCount`, `revertedChanges` |
|
|
89
|
-
|
|
90
|
-
### 0.6 Remaining Tools
|
|
91
|
-
|
|
92
|
-
| Tool | Schema | Verification |
|
|
93
|
-
| -------------------------------- | ---------------------------------------- | ------------------------------------------------------------ |
|
|
94
|
-
| `test_simple` | `TestSimpleOutputSchema` | `message` string |
|
|
95
|
-
| `export_entries` | `ExportEntriesOutputSchema` | `format`, `entries` (JSON) or `content` (markdown) |
|
|
96
|
-
| `rebuild_vector_index` | `RebuildVectorIndexOutputSchema` | `success`, `entriesIndexed`, optional `failedEntries` |
|
|
97
|
-
| `add_to_vector_index` | `AddToVectorIndexOutputSchema` | `success`, `entryId` |
|
|
98
|
-
| `move_kanban_item` | `MoveKanbanItemOutputSchema` | `success`, `itemId`, `newStatus`, `projectNumber`, `message` |
|
|
99
|
-
| `create_github_issue_with_entry` | `CreateGitHubIssueWithEntryOutputSchema` | `success`, `issue`, `journalEntry`, optional `project` |
|
|
100
|
-
| `close_github_issue_with_entry` | `CloseGitHubIssueWithEntryOutputSchema` | `success`, `issue`, `journalEntry`, optional `kanban` |
|
|
101
|
-
|
|
102
|
-
### 0.7 Milestone Tools
|
|
103
|
-
|
|
104
|
-
| Tool | Schema | Verification |
|
|
105
|
-
| ------------------------- | ----------------------------------- | ---------------------------------------------------------------- |
|
|
106
|
-
| `get_github_milestones` | `GitHubMilestonesListOutputSchema` | `milestones` array with `completion_percentage`, `total` |
|
|
107
|
-
| `get_github_milestone` | `GitHubMilestoneResultOutputSchema` | `milestone` object with number, title, state, open/closed counts |
|
|
108
|
-
| `create_github_milestone` | `CreateMilestoneOutputSchema` | `success`, `milestone` (number, title, url), `message` |
|
|
109
|
-
| `update_github_milestone` | `UpdateMilestoneOutputSchema` | `success`, `milestone` (updated fields), `message` |
|
|
110
|
-
| `delete_github_milestone` | `DeleteMilestoneOutputSchema` | `success`, `message` |
|
|
111
|
-
|
|
112
|
-
### 0.8 Team Tools
|
|
113
|
-
|
|
114
|
-
| Tool | Schema | Verification |
|
|
115
|
-
| --------------------------------- | -------------------------------------- | -------------------------------------------------------------------------- |
|
|
116
|
-
| `team_create_entry` | `TeamCreateOutputSchema` | `success`, `entry` (with `author`), `author` field |
|
|
117
|
-
| `team_get_recent` | `TeamEntriesListOutputSchema` | `entries` array (each with `author`), `count` |
|
|
118
|
-
| `team_search` | `TeamEntriesListOutputSchema` | `entries` array (each with `author`), `count` |
|
|
119
|
-
| `team_get_entry_by_id` | `TeamEntryDetailOutputSchema` | `success`, `entry` (with `author`), optional `relationships`, `importance` |
|
|
120
|
-
| `team_list_tags` | `TeamTagsListOutputSchema` | `tags` array with `name`, `count` |
|
|
121
|
-
| `team_search_by_date_range` | `TeamEntriesListOutputSchema` | `entries` array (each with `author`), `count` |
|
|
122
|
-
| `team_update_entry` | `TeamUpdateOutputSchema` | `success`, `entry` (updated) |
|
|
123
|
-
| `team_delete_entry` | `TeamDeleteOutputSchema` | `success`, `message` |
|
|
124
|
-
| `team_merge_tags` | `TeamMergeTagsOutputSchema` | `success`, `message`, `entriesUpdated`, `sourceDeleted` |
|
|
125
|
-
| `team_get_statistics` | `TeamStatisticsOutputSchema` | `totalEntries`, `entryTypes`, `topTags`, `authors` |
|
|
126
|
-
| `team_link_entries` | `TeamLinkEntriesOutputSchema` | `success`, `relationship`, optional `alreadyExists` |
|
|
127
|
-
| `team_visualize_relationships` | `TeamVisualizeOutputSchema` | `mermaid`, `nodeCount`, `edgeCount` |
|
|
128
|
-
| `team_export_entries` | `TeamExportOutputSchema` | `format`, `data`, `count` |
|
|
129
|
-
| `team_backup` | `TeamBackupOutputSchema` | `success`, `filename`, `path`, `sizeBytes` |
|
|
130
|
-
| `team_list_backups` | `TeamBackupsListOutputSchema` | `backups` array, `total`, `backupsDirectory` |
|
|
131
|
-
| `team_semantic_search` | `TeamSemanticSearchOutputSchema` | `query`, `entries` (with `similarity`), `count` |
|
|
132
|
-
| `team_get_vector_index_stats` | `TeamVectorStatsOutputSchema` | `available`, `itemCount`, `modelName`, `dimensions`, `success` |
|
|
133
|
-
| `team_rebuild_vector_index` | `TeamRebuildVectorIndexOutputSchema` | `success`, `entriesIndexed`, optional `failedEntries` |
|
|
134
|
-
| `team_add_to_vector_index` | `TeamAddToVectorIndexOutputSchema` | `success`, `entryId` |
|
|
135
|
-
| `team_get_cross_project_insights` | `TeamCrossProjectInsightsOutputSchema` | `project_count`, `total_entries`, `projects` |
|
|
136
|
-
|
|
137
|
-
---
|
|
138
|
-
|
|
139
|
-
## Phase 1: All Resources
|
|
140
|
-
|
|
141
|
-
### 1.1 Static Resources
|
|
142
|
-
|
|
143
|
-
| Resource | URI | Test |
|
|
144
|
-
| ----------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
145
|
-
| Briefing | `memory://briefing` | Returns JSON with `userMessage`, `templateResources`, `journal`, `github`, optional `rulesFile`, `skillsDir`, `workflowSummary`, `copilotReviews` |
|
|
146
|
-
| Instructions | `memory://instructions` | Full server instructions — verify it references all 61 tools and key resources |
|
|
147
|
-
| Recent entries | `memory://recent` | Read, verify 10 entries with typed fields |
|
|
148
|
-
| Significant | `memory://significant` | Verify entries have `importance`, sorted by importance (primary), timestamp (secondary) |
|
|
149
|
-
| Significant order | `memory://significant` | Compare adjacent entries: `entries[0].importance >= entries[1].importance` etc. |
|
|
150
|
-
| Tags | `memory://tags` | Read, verify tag counts match `list_tags` output |
|
|
151
|
-
| Statistics | `memory://statistics` | Read, verify structured stats match `get_statistics` output |
|
|
152
|
-
| Health | `memory://health` | Shows DB stats, tool filter status, vector index health |
|
|
153
|
-
| GitHub status | `memory://github/status` | Compact JSON with repo, branch, CI, issues, PRs, Kanban summary (includes milestones) |
|
|
154
|
-
| Repo insights | `memory://github/insights` | Compact summary of stars, forks, and 14-day traffic |
|
|
155
|
-
| GitHub milestones | `memory://github/milestones` | Open milestones with completion percentages |
|
|
156
|
-
| Graph recent | `memory://graph/recent` | Mermaid diagram with harmonized arrows (`-->`, `==>`, `-.->`, `--x`, `<-->`) |
|
|
157
|
-
| Graph actions | `memory://graph/actions` | CI/CD narrative graph (verify graceful output when no workflow entries exist) |
|
|
158
|
-
| Actions recent | `memory://actions/recent` | Recent workflow runs (verify graceful output when no workflow entries exist) |
|
|
159
|
-
| Team recent | `memory://team/recent` | Author-enriched entries, `source: "team"`, `count` |
|
|
160
|
-
| Team statistics | `memory://team/statistics` | `configured: true`, `authors` array with `{ author, count }`, `source: "team"` |
|
|
161
|
-
| Help index | `memory://help` | Lists all tool groups with counts, descriptions, and `totalTools` |
|
|
162
|
-
| Help group detail | `memory://help/{group}` | Per-group tool listing with parameters, descriptions, and annotations (test with `memory://help/core`) |
|
|
163
|
-
| Help gotchas | `memory://help/gotchas` | Field notes and practical tips (moved from server instructions); verify non-empty content with actionable guidance |
|
|
164
|
-
| Rules | `memory://rules` | Rules file content (requires `RULES_FILE_PATH`); graceful empty if not set |
|
|
165
|
-
| Workflows | `memory://workflows` | Workflow summary (requires `MEMORY_JOURNAL_WORKFLOW_SUMMARY` or `--workflow-summary`); returns `{ configured: false }` when not set |
|
|
166
|
-
| Skills | `memory://skills` | Indexed skills listing (requires `SKILLS_DIR_PATH`); graceful empty if not set |
|
|
167
|
-
|
|
168
|
-
### 1.2 Template Resources — Happy Path
|
|
169
|
-
|
|
170
|
-
> [!CAUTION]
|
|
171
|
-
> Issue and PR template URIs require the `/entries` or `/timeline` suffix — they are **NOT** bare `memory://issues/{number}` or `memory://prs/{number}`. Using bare URIs will return "Resource not found". Always use the full paths shown in the table below (e.g. `memory://issues/55/entries`, `memory://prs/67/timeline`).
|
|
172
|
-
|
|
173
|
-
| Template | Test URI | Expected Result |
|
|
174
|
-
| ---------------- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
|
|
175
|
-
| Project timeline | `memory://projects/5/timeline` | Timeline data |
|
|
176
|
-
| Issue entries | `memory://issues/55/entries` | Entries linked to issue #55 |
|
|
177
|
-
| PR entries | `memory://prs/67/entries` | Entries linked to PR #67 (permanent test fixture) |
|
|
178
|
-
| PR timeline | `memory://prs/67/timeline` | PR lifecycle with `prMetadata` (live state) and `timelineNote` |
|
|
179
|
-
| Kanban JSON | `memory://kanban/5` | Board JSON |
|
|
180
|
-
| Kanban diagram | `memory://kanban/5/diagram` | Raw Mermaid text (`text/plain` MIME), not JSON-wrapped |
|
|
181
|
-
| Milestone detail | `memory://milestones/<N>` | Milestone with completion %, `openIssues` + `closedIssues` counts, and hint to use `get_github_issues` for individual issue details |
|
|
182
|
-
|
|
183
|
-
### 1.3 Template Resources — Error Paths
|
|
184
|
-
|
|
185
|
-
| Template | Test URI | Expected Result |
|
|
186
|
-
| -------------------------- | ---------------------------------- | --------------------------------------------------------------- |
|
|
187
|
-
| Nonexistent project | `memory://projects/99999/timeline` | Empty or graceful response (no entries for nonexistent project) |
|
|
188
|
-
| Nonexistent issue | `memory://issues/999999/entries` | Empty entries array (no crash) |
|
|
189
|
-
| Nonexistent PR | `memory://prs/999999/entries` | Empty entries array (no crash) |
|
|
190
|
-
| Nonexistent PR timeline | `memory://prs/999999/timeline` | Graceful response with empty/null `prMetadata` |
|
|
191
|
-
| Nonexistent Kanban | `memory://kanban/99999` | Error or empty board (no crash) |
|
|
192
|
-
| Nonexistent Kanban diagram | `memory://kanban/99999/diagram` | Error or empty diagram (no crash) |
|
|
193
|
-
| Nonexistent milestone | `memory://milestones/999999` | Error or empty milestone data (no crash) |
|
|
194
|
-
|
|
195
|
-
---
|
|
196
|
-
|
|
197
|
-
## Phase 2: GitHub Integration (16 tools)
|
|
198
|
-
|
|
199
|
-
### 2.1 Read-Only Tools
|
|
200
|
-
|
|
201
|
-
| Test | Command/Action | Expected Result |
|
|
202
|
-
| --------------------- | ---------------------------------------------- | -------------------------------------------------------- |
|
|
203
|
-
| Context | `get_github_context` | Returns repo, branch, issues, PRs |
|
|
204
|
-
| List issues | `get_github_issues(limit: 5)` | Returns open issues |
|
|
205
|
-
| Issue milestone data | Inspect issue objects | Issues include `milestone` field (if assigned) |
|
|
206
|
-
| Get issue | `get_github_issue(issue_number: <N>)` | Returns issue details |
|
|
207
|
-
| List PRs | `get_github_prs(limit: 5)` | Returns open PRs |
|
|
208
|
-
| List closed issues | `get_github_issues(state: "closed", limit: 3)` | Returns closed issues |
|
|
209
|
-
| List all issues | `get_github_issues(state: "all", limit: 3)` | Returns both open and closed issues |
|
|
210
|
-
| List closed PRs | `get_github_prs(state: "closed", limit: 3)` | Returns closed/merged PRs |
|
|
211
|
-
| List all PRs | `get_github_prs(state: "all", limit: 3)` | Returns both open and closed PRs |
|
|
212
|
-
| Get PR | `get_github_pr(pr_number: <N>)` | Returns PR details (use known closed PR) |
|
|
213
|
-
| Get nonexistent issue | `get_github_issue(issue_number: 999999)` | Structured error: `{ error: "Issue #999999 not found" }` |
|
|
214
|
-
| Get nonexistent PR | `get_github_pr(pr_number: 999999)` | Structured error: `{ error: "PR #999999 not found" }` |
|
|
215
|
-
|
|
216
|
-
### 2.2 Issue Lifecycle Tools
|
|
217
|
-
|
|
218
|
-
> [!CAUTION]
|
|
219
|
-
> These tools **create and close real GitHub issues**. Use with awareness.
|
|
220
|
-
|
|
221
|
-
| Test | Command/Action | Expected Result |
|
|
222
|
-
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
223
|
-
| Create issue + entry | `create_github_issue_with_entry(title: "Test: Unreleased Verification", project_number: 5)` | GitHub issue created + journal entry created + added to project |
|
|
224
|
-
| Create with milestone | `create_github_issue_with_entry(title: "Test: Milestone", milestone_number: <N>)` | Issue assigned to milestone, verify on GitHub |
|
|
225
|
-
| Close issue + entry | `close_github_issue_with_entry(issue_number: <new_issue>, resolution_notes: "Verified working")` | Issue closed + resolution entry created |
|
|
226
|
-
| Close with move_to_done | `close_github_issue_with_entry(issue_number: <new_issue>, move_to_done: true, project_number: 5)` | Issue closed + `kanban` block in response. `kanban.moved: true` expected — uses idempotent `addProjectItem` to resolve item ID directly (no board-scan race condition) |
|
|
227
|
-
| Create with full params | `create_github_issue_with_entry(title: "Test: Full", body: "Description", labels: ["test"], project_number: 5, initial_status: "In Progress", entry_content: "Custom journal text", tags: ["test"])` | Issue created with body/labels, project item in "In Progress", journal entry uses custom content |
|
|
228
|
-
| Close with comment | `close_github_issue_with_entry(issue_number: <new_issue>, resolution_notes: "Done", comment: "Closing comment", tags: ["resolved"])` | Issue closed with comment posted, entry tagged |
|
|
229
|
-
| Close already closed | `close_github_issue_with_entry(issue_number: <known_closed>)` | Structured error: `{ success: false, error: "Issue #X is already closed" }` |
|
|
230
|
-
| Close move_to_done no project | `close_github_issue_with_entry(issue_number: <open_issue>, move_to_done: true)` | When `DEFAULT_PROJECT_NUMBER` is configured: uses default project, issue closes (`success: true`), Kanban move attempted against default project. When NOT configured: `kanban: { moved: false, error: "project_number required when move_to_done is true" }` |
|
|
231
|
-
|
|
232
|
-
### 2.3 Kanban Tools
|
|
233
|
-
|
|
234
|
-
| Test | Command/Action | Expected Result |
|
|
235
|
-
| ------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
|
|
236
|
-
| Get board | `get_kanban_board(project_number: 5)` | Returns board structure with columns/items |
|
|
237
|
-
| Kanban resource | Read `memory://kanban/5` | JSON board data |
|
|
238
|
-
| Kanban diagram | Read `memory://kanban/5/diagram` | Raw Mermaid text (`text/plain` MIME), not JSON-wrapped |
|
|
239
|
-
| Move item | `move_kanban_item(project_number: 5, item_id: <id>, target_status: "In Progress")` | Item status updated |
|
|
240
|
-
| Move invalid status | `move_kanban_item(project_number: 5, item_id: <id>, target_status: "Nonexistent")` | Structured error with `availableStatuses` array listing valid options |
|
|
241
|
-
| Board nonexistent | `get_kanban_board(project_number: 99999)` | Structured error: `{ error: "Project #99999 not found..." }` |
|
|
242
|
-
|
|
243
|
-
### 2.4 Milestone Tools
|
|
244
|
-
|
|
245
|
-
> [!CAUTION]
|
|
246
|
-
> These tools **create, modify, and delete real GitHub milestones**. Clean up test milestones after testing.
|
|
247
|
-
|
|
248
|
-
| Test | Command/Action | Expected Result |
|
|
249
|
-
| -------------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
|
|
250
|
-
| List milestones | `get_github_milestones(state: "open")` | Returns milestones array with `completion_percentage`, `open_issues` |
|
|
251
|
-
| List all states | `get_github_milestones(state: "all")` | Returns both open and closed milestones |
|
|
252
|
-
| Get milestone detail | `get_github_milestone(milestone_number: <N>)` | Returns single milestone with full metadata |
|
|
253
|
-
| Create milestone | `create_github_milestone(title: "Test Milestone", description: "Testing", due_on: "YYYY-MM-DD")` | Returns `success: true`, created milestone with number and URL (⚠️ `due_on` must be `YYYY-MM-DD`, not ISO 8601) |
|
|
254
|
-
| Update milestone | `update_github_milestone(milestone_number: <new>, description: "Updated description")` | Returns `success: true`, updated milestone |
|
|
255
|
-
| Close milestone | `update_github_milestone(milestone_number: <new>, state: "closed")` | Milestone state changed to `closed` |
|
|
256
|
-
| Delete milestone | `delete_github_milestone(milestone_number: <new>, confirm: true)` | Returns `success: true`, milestone removed from GitHub |
|
|
257
|
-
| Get nonexistent | `get_github_milestone(milestone_number: 999999)` | Structured error: `{ error: "Milestone #999999 not found" }` |
|
|
258
|
-
| Milestone resource | Read `memory://github/milestones` | Static resource lists open milestones with completion % |
|
|
259
|
-
| Milestone detail | Read `memory://milestones/<N>` | Template resource shows milestone with completion %, openIssues + closedIssues counts, and hint for issue details |
|
|
260
|
-
|
|
261
|
-
### 2.5 Repository Insights Tool
|
|
262
|
-
|
|
263
|
-
| Test | Command/Action | Expected Result |
|
|
264
|
-
| ----------------- | ------------------------------------------ | -------------------------------------------------- |
|
|
265
|
-
| Default (stars) | `get_repo_insights` | Returns `stars`, `forks`, `watchers`, `openIssues` |
|
|
266
|
-
| Traffic section | `get_repo_insights(sections: "traffic")` | Returns 14-day `clones` and `views` aggregates |
|
|
267
|
-
| Referrers section | `get_repo_insights(sections: "referrers")` | Returns top 5 referral sources |
|
|
268
|
-
| Paths section | `get_repo_insights(sections: "paths")` | Returns top 5 popular content paths |
|
|
269
|
-
| All sections | `get_repo_insights(sections: "all")` | Returns full payload with all sections above |
|
|
270
|
-
|
|
271
|
-
### 2.6 Copilot Review Tool
|
|
272
|
-
|
|
273
|
-
| Test | Command/Action | Expected Result |
|
|
274
|
-
| --------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------- |
|
|
275
|
-
| Reviewed PR | `get_copilot_reviews(pr_number: <known_reviewed_pr>)` | Returns `state`, `commentCount`, `comments` array with `path`, `line`, `body` |
|
|
276
|
-
| Unreviewed PR | `get_copilot_reviews(pr_number: <unreviewed_pr>)` | Returns `state: "none"`, `commentCount: 0`, empty `comments` |
|
|
277
|
-
| Auto-detect repo | `get_copilot_reviews(pr_number: 1)` | Uses auto-detected owner/repo from git |
|
|
278
|
-
| No GitHub integration | (server without `GITHUB_TOKEN`) | Returns `{ success: false, error: "GitHub integration not available" }` |
|
|
279
|
-
|
|
280
|
-
### 2.7 GitHub Test Cleanup
|
|
281
|
-
|
|
282
|
-
> [!IMPORTANT]
|
|
283
|
-
> After GitHub testing, ensure all test artifacts are removed. Use the checklist below.
|
|
284
|
-
|
|
285
|
-
| Cleanup Step | Command/Action |
|
|
286
|
-
| ---------------------- | ----------------------------------------------------------------- |
|
|
287
|
-
| Close test issues | `close_github_issue_with_entry` for any unclosed test issues |
|
|
288
|
-
| Delete test milestones | `delete_github_milestone` for any test milestones still on GitHub |
|
|
289
|
-
| Verify project board | `get_kanban_board(project_number: 5)` — no orphaned test items |
|
|
290
|
-
|
|
291
|
-
---
|
|
292
|
-
|
|
293
|
-
## Test Execution Order
|
|
294
|
-
|
|
295
|
-
0. **Phase 0**: outputSchema Validation (verify structured responses across all 61 tools)
|
|
296
|
-
1. **Phase 1**: All Resources (static + template, happy path + error paths)
|
|
297
|
-
2. **Phase 2**: GitHub Integration (happy paths, lifecycle, milestones, insights, copilot, cleanup)
|
|
298
|
-
|
|
299
|
-
> [!NOTE]
|
|
300
|
-
> Continue with `test-tools3.md` for Phases 3-7 (prompts, error paths, data integrity, boundary values, bug detection).
|
|
301
|
-
|
|
302
|
-
---
|
|
303
|
-
|
|
304
|
-
## Success Criteria
|
|
305
|
-
|
|
306
|
-
### outputSchema Validation (Phase 0)
|
|
307
|
-
|
|
308
|
-
- [x] All 60 outputSchema tools return `structuredContent` (not raw text) — `mj_execute_code` excluded by design
|
|
309
|
-
|
|
310
|
-
### Resources (Phase 1)
|
|
311
|
-
|
|
312
|
-
- [x] All 20 static resources return valid data
|
|
313
|
-
- [x] All 8 template resources work with valid parameters
|
|
314
|
-
- [x] All 8 template resources handle invalid/nonexistent IDs gracefully (no crashes)
|
|
315
|
-
- [x] `memory://significant` includes `importance` field and is sorted by importance (primary) then timestamp (secondary)
|
|
316
|
-
- [x] `memory://tags` tag counts match `list_tags` output
|
|
317
|
-
- [x] `memory://statistics` structured stats match `get_statistics` output
|
|
318
|
-
- [x] `memory://github/insights` returns compact stats including traffic aggregates
|
|
319
|
-
- [x] `memory://graph/recent` uses harmonized arrows (`-->`, `==>`, `-.->`, `--x`, `<-->`)
|
|
320
|
-
- [x] `memory://instructions` references all 61 tools and key resources
|
|
321
|
-
|
|
322
|
-
### GitHub Integration (Phase 2)
|
|
323
|
-
|
|
324
|
-
- [x] GitHub issue lifecycle tools create/close issues correctly
|
|
325
|
-
- [x] `create_github_issue_with_entry` with `body`, `labels`, `initial_status`, `entry_content` works
|
|
326
|
-
- [x] `create_github_issue_with_entry` with `milestone_number` assigns issue to milestone
|
|
327
|
-
- [x] `close_github_issue_with_entry` returns structured error for already-closed issues
|
|
328
|
-
- [x] `close_github_issue_with_entry` with `move_to_done: true` behavior correct with/without `DEFAULT_PROJECT_NUMBER`
|
|
329
|
-
- [x] `get_github_issues` and `get_github_prs` with `state: "closed"` and `state: "all"` work
|
|
330
|
-
- [x] Milestone CRUD lifecycle works end-to-end (create → update → close → delete)
|
|
331
|
-
- [x] `memory://milestones/{number}` returns milestone with completion %, issue counts, and hint
|
|
332
|
-
- [x] `get_repo_insights` returns correct data based on `sections` parameter
|
|
333
|
-
- [x] `get_copilot_reviews` — referenced in test docs but not re-executed (verified in Phase 0.4 schema check only; see prior sessions)
|
|
334
|
-
- [x] All GitHub test artifacts cleaned up after testing (issues #290-293 closed, milestone #70 deleted)
|
|
335
|
-
|
|
336
|
-
---
|
|
337
|
-
|
|
338
|
-
## Findings
|
|
339
|
-
|
|
340
|
-
### Bugs / Schema Gaps
|
|
341
|
-
|
|
342
|
-
| ID | Severity | Tool | Issue | Status |
|
|
343
|
-
| ---------- | -------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ------ |
|
|
344
|
-
| **F-MK1** | Medium | `move_kanban_item` | Output schema missing `itemId`, `projectNumber`, `message` fields (only `success`, `newStatus`, `previousStatus` in structuredContent) | Open |
|
|
345
|
-
| **F-TVS1** | Low | `team_get_vector_index_stats` | Missing `success` field in output (personal version has it) | Open |
|
|
346
|
-
|
|
347
|
-
### Improvements / Observations
|
|
348
|
-
|
|
349
|
-
| ID | Priority | Area | Observation |
|
|
350
|
-
| --------- | -------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
351
|
-
| **F-KS1** | Low | `memory://github/status` | `kanbanSummary` keys are `"Todo"`, `"In Progress"`, `"Done"` but actual board column is `"In progress"` (lowercase 'p') — all counts show as 0 despite board having items |
|
|
352
|
-
| **F-HP1** | Low | `memory://help/{group}` | All tool parameter types show as `"unknown"` and all `required` flags are `true` — types are not extracted from Zod schemas |
|
|
353
|
-
|
|
354
|
-
### Already Fixed (in prior sessions)
|
|
355
|
-
|
|
356
|
-
| ID | Fix | Session |
|
|
357
|
-
| --- | ---------------------------------------------------------------------- | -------------- |
|
|
358
|
-
| F1 | Reverse relationships now allowed (not treated as duplicates) | Prior sessions |
|
|
359
|
-
| F2 | Team duplicate field correctly named `duplicate` (not `alreadyExists`) | Prior sessions |
|
|
360
|
-
| F3 | Team tools now return standardized error shapes | Prior sessions |
|
|
361
|
-
| F4 | FTS5 ghost entries cleaned up on server startup | Prior sessions |
|