GitHub Copilot forgets everything between chats. GHCP-MEM gives it a local, auditable memory — seeded from your git history in 30 seconds — so every chat starts where the last one ended. No cloud backend, secrets redacted, every claim cited.
GHCP-MEM defines 16 tools with consistent naming (verb_noun pattern: ghcpMem_search, ghcpMem_get, etc.) and reasonable descriptions (avg ~80 chars). All tools have input schemas with typed parameters and descriptions. However, output schemas are not documented, LLMs cannot predict return structure. Error handling is absent; no guidance on retryability, user-fixable vs fatal errors, or recovery paths. Parameter descriptions lack constraints (e.g., 'limit' has no min/max stated in schema). No tool annotations (readOnlyHint, destructiveHint) despite clear risk levels (READ_ONLY, WRITE, DESTRUCTIVE). Composition is sound, each tool has one responsibility, but chaining IDs are not guaranteed in responses.
Detect conflicting decisions or contradictions in session memory
Correct/update a session's metadata (summary, decisions, problems, etc.)
Delete a session from memory (retract it from search results)
Look up decisions and context about a specific file or entity
Explain why a session was ranked high for a query
Get full detail of a session by ID prefix
Export session relationships as a Mermaid graph
No output schemas documented. LLMs cannot predict return structure, forcing them to guess field names and types for downstream tool chaining. This violates pattern:tool and pattern:response-shaper.
No error handling guidance. Tools do not indicate which errors are retryable, user-fixable, or fatal. No recovery suggestions (e.g., 'Session not found. Try ghcpMem_search() first.'). Violates pattern:recovery-guide and pattern:error-classification.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2026-07-28+ | v2 |
Show causal lineage of a session (what led to it, what it led to)
Show the most recent sessions
Retract a session (mark it as superseded or incorrect without deleting)
Get a recommendation for the cheapest, highest-fidelity way to satisfy a query (MCP tools vs file attach)
Search past sessions for a keyword/query
Extract decision/problem snippets from sessions matching a query
Store a one-shot note into memory without waiting for compression
Mark one session as superseded by another
Show chronological sessions around a date/query
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels declared (READ_ONLY, WRITE, DESTRUCTIVE, REVERSIBLE). LLMs cannot infer safety properties without explicit annotations. Violates current MCP spec (2026-07-28) tool annotation requirement.
Parameter constraints not enforced in schema. 'limit' parameters lack min/max bounds (e.g., ghcpMem_search allows 'max 25' in description but no JSON Schema maxItems/maximum). 'sinceDays' and 'days' have no range validation. Violates pattern:constrained-input.
No confirmation/dry-run pattern for destructive operations (ghcpMem_delete, ghcpMem_retract). Agents can irreversibly delete sessions without a safety gate. Violates pattern:confirmation-request.