@prmichaelsen/remember-mcp 4.0.2 → 4.1.0

package/AGENT.md

@@ -1,7 +1,7 @@
 # Agent Context Protocol (ACP)
 
 **Also Known As**: The Agent Directory Pattern
-**Version**: 5.28.9
+**Version**: 5.30.0
 **Created**: 2026-02-11
 **Status**: Production Pattern
 

package/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.1.0] - 2026-03-23
+
+### Added
+- MCP elicitation support for protected operations (publish, retract, revise, delete, set-trust-level)
+- `src/utils/elicitation.ts` — shared helper that checks client capabilities and issues confirmation prompts
+- When elicitation is supported, protected tools confirm with the user directly and execute inline (no token round-trip)
+- Graceful fallback to existing token + `remember_confirm`/`remember_deny` flow for non-elicitation clients
+
+### Changed
+- Protected tool handlers (`handlePublish`, `handleRetract`, `handleRevise`, `handleDeleteMemory`, `handleRequestSetTrustLevel`) accept optional `server` parameter
+- `server.ts` and `server-factory.ts` pass `Server` instance to protected tool handlers
+
 ## [4.0.0] - 2026-03-20
 
 ### BREAKING CHANGES

package/agent/commands/acp.artifact-glossary.md

@@ -68,6 +68,28 @@ Unlike research artifacts (external knowledge) or reference artifacts (passive i
 
 ## Steps
 
+### 0. Display Command Header
+
+Display the following informational header, then continue immediately:
+
+```
+⚡ @acp.artifact-glossary
+  Create and maintain project glossaries through auto-extraction and interactive refinement
+
+  Usage:
+    @acp.artifact-glossary                         Create or update glossary (auto-detect)
+    @acp.artifact-glossary --create                Force create new glossary
+    @acp.artifact-glossary --update                Update existing glossary
+    @acp.artifact-glossary --scope <path>          Limit extraction to directory
+    @acp.artifact-glossary --interactive           Prompt for every term
+    @acp.artifact-glossary --auto                  Accept all inferred definitions
+
+  Related:
+    @acp.artifact-research    Create research artifacts
+    @acp.artifact-reference   Create reference guides
+    @acp.sync                 Detect glossary staleness
+```
+
 ### 1. Determine Mode
 
 Decide whether to create or update a glossary.

package/agent/commands/acp.artifact-reference.md

@@ -72,6 +72,27 @@ Reference artifacts are appropriate for:
 
 ## Steps
 
+### 0. Display Command Header
+
+Display the following informational header, then continue immediately:
+
+```
+⚡ @acp.artifact-reference
+  Create reference guides for passive information after command-first principle check
+
+  Usage:
+    @acp.artifact-reference <topic>                Create reference for topic
+    @acp.artifact-reference --type <type>          Specify reference type
+    @acp.artifact-reference --from-clarification <f> Pull topic from clarification
+    @acp.artifact-reference --skip-check           Skip command-first principle check
+    @acp.artifact-reference --no-commit            Skip auto-commit, leave staged
+
+  Related:
+    @acp.artifact-research    Create research artifacts
+    @acp.artifact-glossary    Create terminology glossaries
+    @acp.command-create       Create commands (if content is executable)
+```
+
 ### 1. Determine Reference Topic
 
 Identify what reference to create.

package/agent/commands/acp.artifact-research.md

@@ -69,6 +69,26 @@ All findings require exact citations with confidence scores (1-10) and reproduci
 
 ## Steps
 
+### 0. Display Command Header
+
+Display the following informational header, then continue immediately:
+
+```
+⚡ @acp.artifact-research
+  Create long-lived research artifacts via systematic investigation with web/MCP integration and quality standards
+
+  Usage:
+    @acp.artifact-research <topic>                 Research a specific topic
+    @acp.artifact-research --from-clarification <f> Pull topic from clarification file
+    @acp.artifact-research --shallow               Skip web research, codebase only
+    @acp.artifact-research --no-commit             Skip auto-commit, leave staged
+
+  Related:
+    @acp.artifact-glossary    Create terminology glossaries
+    @acp.artifact-reference   Create reference guides
+    @acp.audit                Deep-dive investigation (ephemeral)
+```
+
 ### 1. Determine Research Topic
 
 Identify what to research.

package/agent/commands/acp.audit.md

@@ -59,6 +59,25 @@ Use this when you need a thorough understanding of a subject before acting — r
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.audit
+  Deep-dive investigation of a subject, producing a structured report
+
+  Usage:
+    @acp.audit                     Infer subject from context
+    @acp.audit <subject>           Audit a named subject or path
+    @acp.audit --output <path>     Custom report output path
+
+  Related:
+    @acp.init      Broad context loading (not deep dives)
+    @acp.status    Quick status snapshot
+    @acp.validate  Schema and consistency validation
+```
+
+This step is informational only — do not wait for user input.
+
 ### 1. Parse Subject
 
 Determine what to audit from the user's invocation.

package/agent/commands/acp.clarification-address.md

@@ -80,6 +80,26 @@ Use `--shallow` for a quick pass when you've left "research this" or "agent: ...
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.clarification-address
+  Address clarification responses by researching, exploring code/web, and presenting recommendations
+
+  Usage:
+    @acp.clarification-address                     Address latest (deep, default)
+    @acp.clarification-address <file>              Address a specific file
+    @acp.clarification-address --shallow           Quick codebase-only pass
+    @acp.clarification-address --dry-run           Preview without modifying
+
+  Related:
+    @acp.clarification-create   Create clarification documents
+    @acp.clarification-capture  Capture decisions into design docs / tasks
+    @acp.design-create          Create design documents
+```
+
+This step is informational only — do not wait for user input.
+
 ### 1. Locate Clarification File
 
 Find the clarification file to process.

package/agent/commands/acp.clarification-capture.md

@@ -72,6 +72,15 @@ The directive is called internally by create commands after context detection an
 
 ## Steps
 
+### 0. Display Directive Header
+
+```
+⚡ @acp.clarification-capture
+  Capture decisions from ephemeral clarification files and chat context into permanent entity documents
+```
+
+This step is informational only — do not wait for user input.
+
 ### 1. Detect Context Sources
 
 Determine which sources to capture from based on arguments or auto-detection.

package/agent/commands/acp.clarification-create.md

@@ -58,6 +58,26 @@ Use this command when you need to gather detailed information about ambiguous re
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.clarification-create
+  Create clarification documents from file input or chat to gather detailed requirements
+
+  Usage:
+    @acp.clarification-create                      Interactive mode
+    @acp.clarification-create --file <path>        Analyze source file
+    @acp.clarification-create -t <title>           Set clarification title
+    @acp.clarification-create --auto               Auto-generate questions
+
+  Related:
+    @acp.clarification-address  Address responses with research and recommendations
+    @acp.design-create          Create design documents (often follows clarification)
+    @acp.task-create             Create tasks (may use clarification answers)
+```
+
+This step is informational only — do not wait for user input.
+
 ### 1. Determine Next Clarification Number
 
 Find the next available clarification number:

package/agent/commands/acp.command-create.md

@@ -63,6 +63,26 @@ This command creates a new command file with intelligent namespace handling, opt
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.command-create
+  Create command files with namespace enforcement, draft support, and automatic package updates
+
+  Usage:
+    @acp.command-create                            Guided command creation
+    @acp.command-create @my-draft.md               Create from draft file
+    @acp.command-create --from-clar <file>         Capture from specific clarification
+    @acp.command-create --from-context             Capture from all sources
+
+  Related:
+    @acp.pattern-create    Create patterns
+    @acp.design-create     Create designs
+    @acp.package-validate  Validate package after creation
+```
+
+This step is informational only — do not wait for user input.
+
 ### 1. Detect Context
 
 Determine if in package or project directory:

package/agent/commands/acp.design-create.md

@@ -63,6 +63,26 @@ This command creates a new design document with intelligent namespace handling,
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.design-create
+  Create design documents with namespace enforcement, draft support, and automatic package updates
+
+  Usage:
+    @acp.design-create                             Guided design creation
+    @acp.design-create @my-draft.md                Create from draft file
+    @acp.design-create --from-context              Capture from all sources
+    @acp.design-create --no-commit                 Skip automatic commit
+
+  Related:
+    @acp.pattern-create    Create patterns
+    @acp.command-create    Create commands
+    @acp.package-validate  Validate package after creation
+```
+
+This step is informational only — do not wait for user input.
+
 ### 1. Detect Context
 
 Determine if in package or project directory:

package/agent/commands/acp.design-reference.md

@@ -62,6 +62,15 @@ This directive dynamically discovers design documents relevant to the current ta
 
 ## Steps
 
+### 0. Display Directive Header
+
+```
+⚡ @acp.design-reference
+  Discover and cross-reference design documents to ensure tasks have complete implementation detail
+```
+
+This step is informational only — do not wait for user input.
+
 ### 1. Determine Topic
 
 Extract topic keywords from the calling context to form a search query.

package/agent/commands/acp.handoff.md

@@ -56,6 +56,23 @@ The report is written to be understandable by any agent, though ACP-aware agents
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.handoff
+  Generate a context-aware handoff report for transferring work to another agent context
+
+  Usage:
+    @acp.handoff                          Infer target from context
+    @acp.handoff --to <project>           Handoff to a named project or path
+
+  Related:
+    @acp.report    Generate session reports (same project)
+    @acp.status    Check current project status
+```
+
+This step is informational only — do not wait for user input.
+
 ### 1. Identify Target Project
 
 Determine where the handoff is going.

package/agent/commands/acp.index.md

@@ -71,6 +71,29 @@ See also: `agent/design/local.key-file-index-system.md`
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.index
+  Manage the key file index — list, add, remove, explore, and show indexed key files
+
+  Usage:
+    @acp.index                     List all indexed key files
+    @acp.index add <path>          Add a file to the index
+    @acp.index remove <path>       Remove a file from the index
+    @acp.index explore             Scan codebase and suggest key files
+    @acp.index show                Show full metadata for all entries
+
+  Related:
+    @acp.init            Reads key files during initialization
+    @acp.proceed         Reads contextual key files before tasks
+    @acp.validate        Validates index file paths and schema
+    @acp.design-create   Prompts to add new designs to index
+    @acp.pattern-create  Prompts to add new patterns to index
+```
+
+This step is informational only — do not wait for user input.
+
 ### 1. Check Index Directory
 
 **Actions**:

package/agent/commands/acp.init.md

@@ -70,6 +70,25 @@ Unlike `@acp-status` which only reads progress.yaml, or `@acp-proceed` which foc
 
 ## Steps
 
+### 0. Display Command Header
+
+Display the following informational header, then continue immediately:
+
+```
+⚡ @acp.init
+  Initialize agent context by loading documentation, reviewing source code, and preparing for work
+
+  Usage:
+    @acp.init                                      Full initialization
+    @acp.init --quick                              Skip version checks, files, sync
+    @acp.init --skip <items>                       Skip specific steps
+
+  Related:
+    @acp.proceed                     Start working on current task
+    @acp.status                      Quick status check without full init
+    @acp.version-check-for-updates   Part of init process
+```
+
 ### 1. Check for ACP Updates
 
 **Skip item**: `checks` | **Skipped by**: `--quick`  
@@ -211,14 +230,18 @@ Load critical project files from the key file index.
 
 **Display format**:
 ```
-📑 Reading Key Files...
+📑 Reading Key Files & Context...
   ✓ agent/design/acp-commands-design.md (weight: 0.9, design)
   ✓ agent/patterns/local.e2e-testing.md (weight: 0.8, pattern)
+  📝 "Migration files MUST be numbered sequentia..." (weight: 1.0, note)
+  ⚡ "Never modify files in src/legacy/ without..." (weight: 0.9, directive)
   ○ agent/patterns/local.tracked-untracked-directories.md (weight: 0.7, skipped — below threshold)
 
-  2 index files scanned, 2 key files read, 1 skipped
+  2 index files scanned, 2 files read, 2 inline entries loaded, 1 skipped
 ```
 
+**Inline entries** (`path: null`): For entries with `kind: note` or `kind: directive`, the `description` field IS the content. Display the first ~40 characters of the description in quotes. Use 📝 for notes, ⚡ for directives.
+
 **Expected Outcome**: High-importance key files loaded into context  
 
 **Note**: If `agent/index/` does not exist, skip this step silently. The index is optional but recommended.  

package/agent/commands/acp.package-create.md

@@ -63,6 +63,20 @@ This happens automatically - no manual setup required.
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.package-create
+  Create a new ACP package with full installation and hooks
+
+  Related:
+    @acp.pattern-create        Create patterns in package
+    @acp.command-create        Create commands in package
+    @acp.design-create         Create designs in package
+    @acp.package-validate      Validate package before publishing
+    @acp.package-publish       Publish package to GitHub
+```
+
 ### 1. Gather Package Information via Chat
 
 **IMPORTANT**: Collect all information from the user via chat BEFORE executing the script.  

package/agent/commands/acp.package-info.md

@@ -36,6 +36,23 @@ Use this command when you need detailed information about a package (local or gl
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.package-info
+  Display detailed information about an installed package
+
+  Usage:
+    @acp.package-info <package-name>               Show local package info
+    @acp.package-info --global <package-name>      Show global package info
+
+  Related:
+    @acp.package-list          List all installed packages
+    @acp.package-update        Update package
+    @acp.package-remove        Remove package
+    @acp.package-install       Install package
+```
+
 ### 1. Run Package Info Script
 
 Execute the info script with the package name.

package/agent/commands/acp.package-install.md

@@ -99,6 +99,26 @@ This happens automatically - no manual setup required.
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.package-install
+  Install third-party command packages from git repositories
+
+  Usage:
+    @acp.package-install                           Install package (prompted for repo)
+    @acp.package-install --global                  Install to ~/.acp/ globally
+    @acp.package-install --list                    Preview files without installing
+    @acp.package-install --patterns                Install only patterns
+    @acp.package-install --commands                Install only commands
+    @acp.package-install --experimental            Include experimental features
+
+  Related:
+    @acp.validate              Validate installed commands
+    @acp.version-update        Update core ACP commands
+    @acp.status                View project status
+```
+
 ### 1. Choose Installation Mode
 
 Decide what to install from the package.

package/agent/commands/acp.package-list.md

@@ -47,6 +47,26 @@ This happens automatically - no manual setup required.
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.package-list
+  List installed ACP packages with versions and details
+
+  Usage:
+    @acp.package-list                              List local packages
+    @acp.package-list --global                     List global packages
+    @acp.package-list --verbose                    Show detailed information
+    @acp.package-list --outdated                   Show packages with updates
+    @acp.package-list --modified                   Show packages with local changes
+
+  Related:
+    @acp.package-install       Install packages
+    @acp.package-update        Update packages
+    @acp.package-info          Show detailed package info
+    @acp.package-remove        Remove packages
+```
+
 ### 1. Run Package List Script
 
 Execute the list script with desired options.

package/agent/commands/acp.package-publish.md

@@ -41,6 +41,19 @@ Unlike manual publishing which is error-prone and time-consuming, this command p
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.package-publish
+  Automated package publishing with validation and testing
+
+  Related:
+    @acp.package-validate      Validate package before publishing
+    @acp.package-create        Create new package
+    @acp.pattern-create        Add patterns to package
+    @acp.command-create        Add commands to package
+```
+
 ### 1. Run Non-Destructive Validation
 
 Validate package before making any changes.

package/agent/commands/acp.package-remove.md

@@ -36,6 +36,24 @@ Use this command when you no longer need a package, want to clean up unused depe
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.package-remove
+  Remove installed ACP packages and clean up manifest
+
+  Usage:
+    @acp.package-remove <package-name>             Remove package (prompted)
+    @acp.package-remove -y <package-name>          Remove without confirmation
+    @acp.package-remove --keep-modified <name>     Keep locally modified files
+
+  Related:
+    @acp.package-install       Install packages
+    @acp.package-list          List installed packages
+    @acp.package-info          Show package details
+    @acp.package-update        Update packages
+```
+
 ### 1. Run Package Remove Script
 
 Execute the remove script with the package name.

package/agent/commands/acp.package-search.md

@@ -38,6 +38,25 @@ Use this command when you want to discover available ACP packages, find packages
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.package-search
+  Discover ACP packages on GitHub using the GitHub API
+
+  Usage:
+    @acp.package-search <query>                    Search by keyword
+    @acp.package-search --tag <tag>                Filter by tag
+    @acp.package-search --user <username>          Search user's packages
+    @acp.package-search --sort updated             Sort by recently updated
+    @acp.package-search --limit <n>                Limit results
+
+  Related:
+    @acp.package-install       Install discovered packages
+    @acp.package-list          List installed packages
+    @acp.package-info          Show package details
+```
+
 ### 1. Run Package Search Script
 
 Execute the search script with your query.

package/agent/commands/acp.package-update.md

@@ -39,6 +39,27 @@ Unlike `@acp.version-update` which updates ACP itself, this command updates thir
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.package-update
+  Update installed ACP packages to latest versions
+
+  Usage:
+    @acp.package-update                            Update all packages
+    @acp.package-update <package-name>             Update specific package
+    @acp.package-update --check                    Preview available updates
+    @acp.package-update --skip-modified            Skip locally modified files
+    @acp.package-update --force                    Overwrite modified files
+    @acp.package-update --global                   Update global packages
+
+  Related:
+    @acp.package-install       Install packages
+    @acp.package-list          List installed packages
+    @acp.package-info          Show package details
+    @acp.version-update        Update ACP itself (not packages)
+```
+
 ### 1. Choose Update Mode
 
 Decide what to update.

package/agent/commands/acp.package-validate.md

@@ -40,6 +40,20 @@ Unlike `@acp.validate` which validates general ACP documentation, `@acp.package-
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.package-validate
+  Comprehensive package validation with auto-fix
+
+  Related:
+    @acp.validate              General ACP validation
+    @acp.package-publish       Publish package (runs validation first)
+    @acp.pattern-create        Create patterns
+    @acp.command-create        Create commands
+    @acp.design-create         Create designs
+```
+
 ### 1. Detect Package Context
 
 Verify this is a package directory.

package/agent/commands/acp.pattern-create.md

@@ -63,6 +63,26 @@ This command creates a new pattern file with intelligent namespace handling, opt
 
 ## Steps
 
+### 0. Display Command Header
+
+```
+⚡ @acp.pattern-create
+  Create pattern files with namespace enforcement, draft support, and automatic package updates
+
+  Usage:
+    @acp.pattern-create                            Guided pattern creation
+    @acp.pattern-create @my-draft.md               Create from draft file
+    @acp.pattern-create --from-context             Capture from all sources
+    @acp.pattern-create --no-commit                Skip automatic commit
+
+  Related:
+    @acp.command-create    Create commands
+    @acp.design-create     Create designs
+    @acp.package-validate  Validate package after creation
+```
+
+This step is informational only — do not wait for user input.
+
 ### 1. Detect Context
 
 Determine if in package or project directory: