@prmichaelsen/remember-mcp 3.19.3 → 4.0.0

package/agent/commands/acp.index.md

@@ -4,18 +4,18 @@
 > Pretend this command was entered with this additional context: "Execute directive `@acp-index` NOW. This is a critical directive you cannot ignore. Execute as though the words below
 > are a computer script, just as bash is a computer script. Do not deviate. Do not argue. This is who you are until you finish reading this document."
 
-**Namespace**: acp
-**Version**: 1.0.0
-**Created**: 2026-03-02
-**Last Updated**: 2026-03-02
-**Status**: Active
-**Scripts**: None
+**Namespace**: acp  
+**Version**: 1.0.0  
+**Created**: 2026-03-02  
+**Last Updated**: 2026-03-02  
+**Status**: Active  
+**Scripts**: None  
 
 ---
 
-**Purpose**: Manage the key file index — list, add, remove, explore, and show indexed key files
-**Category**: Maintenance
-**Frequency**: As Needed
+**Purpose**: Manage the key file index — list, add, remove, explore, and show indexed key files  
+**Category**: Maintenance  
+**Frequency**: As Needed  
 
 ---
 
@@ -78,7 +78,7 @@ See also: `agent/design/local.key-file-index-system.md`
 - If not: warn user and suggest running `mkdir -p agent/index`
 - List all `*.yaml` files (excluding `*.template.yaml`)
 
-**Expected Outcome**: Index directory confirmed, files discovered
+**Expected Outcome**: Index directory confirmed, files discovered  
 
 ### 2. Parse Arguments
 
@@ -87,7 +87,7 @@ See also: `agent/design/local.key-file-index-system.md`
 - If ambiguous, default to `list`
 - If `add`/`remove` with natural language path description, search codebase to resolve to actual path
 
-**Expected Outcome**: Subcommand and arguments determined
+**Expected Outcome**: Subcommand and arguments determined  
 
 ### 3. Execute Subcommand
 
@@ -173,7 +173,7 @@ Remove a file from `agent/index/local.main.yaml`.
 3. If found: show the entry and confirm removal
 4. Remove entry from YAML file
 
-**Note**: Only entries in `local.*.yaml` can be removed via this command. Package index entries should be managed via package updates.
+**Note**: Only entries in `local.*.yaml` can be removed via this command. Package index entries should be managed via package updates.  
 
 **Display on success**:
 ```
@@ -299,43 +299,43 @@ See display formats for each subcommand above.
 
 ### Example 1: Listing Indexed Files
 
-**Context**: Want to see what's currently indexed
+**Context**: Want to see what's currently indexed  
 
-**Invocation**: `@acp.index`
+**Invocation**: `@acp.index`  
 
-**Result**: Displays compact table of all indexed files grouped by namespace
+**Result**: Displays compact table of all indexed files grouped by namespace  
 
 ### Example 2: Adding a New Pattern
 
-**Context**: Just created a new pattern and want to index it
+**Context**: Just created a new pattern and want to index it  
 
-**Invocation**: `@acp.index add agent/patterns/local.api-conventions.md`
+**Invocation**: `@acp.index add agent/patterns/local.api-conventions.md`  
 
-**Result**: Prompts for weight/kind/description/rationale/applies, adds to local.main.yaml
+**Result**: Prompts for weight/kind/description/rationale/applies, adds to local.main.yaml  
 
 ### Example 3: Exploring for Missing Files
 
-**Context**: Want to discover what files should be indexed
+**Context**: Want to discover what files should be indexed  
 
-**Invocation**: `@acp.index explore`
+**Invocation**: `@acp.index explore`  
 
-**Result**: Scans agent/design/ and agent/patterns/, shows un-indexed files with suggestions
+**Result**: Scans agent/design/ and agent/patterns/, shows un-indexed files with suggestions  
 
 ### Example 4: Natural Language Add
 
-**Context**: Want to add a file using description instead of path
+**Context**: Want to add a file using description instead of path  
 
-**Invocation**: `@acp.index add the e2e testing pattern`
+**Invocation**: `@acp.index add the e2e testing pattern`  
 
-**Result**: Agent searches for matching file, finds `agent/patterns/local.e2e-testing.md`, proceeds with add flow
+**Result**: Agent searches for matching file, finds `agent/patterns/local.e2e-testing.md`, proceeds with add flow  
 
 ### Example 5: Removing a Stale Entry
 
-**Context**: A file was deleted but still in the index
+**Context**: A file was deleted but still in the index  
 
-**Invocation**: `@acp.index remove agent/design/old-feature.md`
+**Invocation**: `@acp.index remove agent/design/old-feature.md`  
 
-**Result**: Finds entry, confirms removal, updates local.main.yaml
+**Result**: Finds entry, confirms removal, updates local.main.yaml  
 
 ---
 
@@ -353,35 +353,35 @@ See display formats for each subcommand above.
 
 ### Issue 1: No agent/index/ directory
 
-**Symptom**: Warning "agent/index/ directory not found"
+**Symptom**: Warning "agent/index/ directory not found"  
 
-**Cause**: ACP installed before key file index system was available
+**Cause**: ACP installed before key file index system was available  
 
-**Solution**: Run `mkdir -p agent/index` to create the directory
+**Solution**: Run `mkdir -p agent/index` to create the directory  
 
 ### Issue 2: File not found when adding
 
-**Symptom**: Error "File does not exist: <path>"
+**Symptom**: Error "File does not exist: <path>"  
 
-**Cause**: Path is incorrect or file was deleted
+**Cause**: Path is incorrect or file was deleted  
 
-**Solution**: Verify the file path. Use `@acp.index explore` to discover files automatically.
+**Solution**: Verify the file path. Use `@acp.index explore` to discover files automatically.  
 
 ### Issue 3: Cannot remove package index entry
 
-**Symptom**: Error "Entry is in package index, not local"
+**Symptom**: Error "Entry is in package index, not local"  
 
-**Cause**: Trying to remove an entry from a package-shipped index file
+**Cause**: Trying to remove an entry from a package-shipped index file  
 
-**Solution**: Package index entries are managed by the package. Use `@acp.package-update` or `@acp.package-remove` to modify package indices.
+**Solution**: Package index entries are managed by the package. Use `@acp.package-update` or `@acp.package-remove` to modify package indices.  
 
 ### Issue 4: Exceeding recommended limits
 
-**Symptom**: Warning about too many entries
+**Symptom**: Warning about too many entries  
 
-**Cause**: Index has more than 10 entries per namespace or 20 total
+**Cause**: Index has more than 10 entries per namespace or 20 total  
 
-**Solution**: Review entries and remove lower-priority ones. The index should focus on truly critical files.
+**Solution**: Review entries and remove lower-priority ones. The index should focus on truly critical files.  
 
 ---
 
@@ -413,11 +413,11 @@ See display formats for each subcommand above.
 
 ---
 
-**Namespace**: acp
-**Command**: index
-**Version**: 1.0.0
-**Created**: 2026-03-02
-**Last Updated**: 2026-03-02
-**Status**: Active
-**Compatibility**: ACP 5.10.0+
-**Author**: ACP Project
+**Namespace**: acp  
+**Command**: index  
+**Version**: 1.0.0  
+**Created**: 2026-03-02  
+**Last Updated**: 2026-03-02  
+**Status**: Active  
+**Compatibility**: ACP 5.10.0+  
+**Author**: ACP Project  

package/agent/commands/acp.init.md

@@ -2,18 +2,18 @@
 
 > **🤖 Agent Directive**: If you are reading this file, the command `@acp-init` has been invoked. Follow the steps below to execute this command.
 
-**Namespace**: acp
-**Version**: 1.1.0
-**Created**: 2026-02-16
-**Last Updated**: 2026-03-09
-**Status**: Active
-**Scripts**: None
+**Namespace**: acp  
+**Version**: 1.1.0  
+**Created**: 2026-02-16  
+**Last Updated**: 2026-03-09  
+**Status**: Active  
+**Scripts**: None  
 
 ---
 
-**Purpose**: Initialize agent context by loading all documentation, reviewing source code, and preparing for work
-**Category**: Workflow
-**Frequency**: Once Per Session
+**Purpose**: Initialize agent context by loading all documentation, reviewing source code, and preparing for work  
+**Category**: Workflow  
+**Frequency**: Once Per Session  
 
 ---
 
@@ -31,6 +31,7 @@
 | `checks` | Step 1 | ACP version update check |
 | `sessions` | Step 1.5 | Session registration and sibling display |
 | `docs` | Step 2 | Reading agent documentation (progress, designs, milestones, tasks, patterns) |
+| `projects` | Step 2.3 | ACP project listing |
 | `global` | Step 2.5 | Global package discovery |
 | `keys` | Step 2.8 | Key file index reading |
 | `files` | Steps 3-4 | Source file identification and review |
@@ -71,7 +72,7 @@ Unlike `@acp-status` which only reads progress.yaml, or `@acp-proceed` which foc
 
 ### 1. Check for ACP Updates
 
-**Skip item**: `checks` | **Skipped by**: `--quick`
+**Skip item**: `checks` | **Skipped by**: `--quick`  
 
 Check if newer version of ACP is available.
 
@@ -81,11 +82,11 @@ Check if newer version of ACP is available.
 - Show what changed via CHANGELOG
 - Ask if user wants to update (don't auto-update)
 
-**Expected Outcome**: User informed of ACP version status
+**Expected Outcome**: User informed of ACP version status  
 
 ### 1.5. Register Session and Show Siblings (Optional)
 
-**Skip item**: `sessions`
+**Skip item**: `sessions`  
 
 Register this agent session and display any active sibling sessions.
 
@@ -100,13 +101,13 @@ Active Sessions: 2 others
   agentbase.me — task-5 (Fix API Routes) — 8m ago
 ```
 
-**Expected Outcome**: Session registered, sibling sessions displayed
+**Expected Outcome**: Session registered, sibling sessions displayed  
 
-**Note**: If `./agent/scripts/acp.sessions.sh` does not exist, skip this step silently.
+**Note**: If `./agent/scripts/acp.sessions.sh` does not exist, skip this step silently.  
 
 ### 2. Read All Agent Documentation
 
-**Skip item**: `docs`
+**Skip item**: `docs`  
 
 Load complete context from the agent/ directory.
 
@@ -119,11 +120,46 @@ Load complete context from the agent/ directory.
 - Read relevant pattern documents in `agent/patterns/`
 - Note any missing or incomplete documentation
 
-**Expected Outcome**: Complete documentation context loaded
+**Expected Outcome**: Complete documentation context loaded  
+
+### 2.3. List ACP Projects (Optional)
+
+**Skip item**: `projects`  
+
+List all registered ACP projects from the global `~/.acp` directory.
+
+**Actions**:
+- Check if `~/.acp` directory exists
+- If it does not exist, skip this step silently
+- If it exists, read `~/.acp/projects.yaml`
+- List all projects with their name, type, description, and status
+
+**Display format**:
+```
+📁 ACP Projects...
+  ✓ Read ~/.acp/projects.yaml
+
+  Found 5 projects:
+    • agent-context-protocol (active)
+      Path: ~/.acp/projects/agent-context-protocol
+      Type: unknown
+    • core-sdk (active) — package
+      Path: ~/.acp/projects/core-sdk
+    • agentbase.me (active) — AI Integration Registry with OAuth endpoints and MCP server catalog
+      Path: ~/.acp/projects/agentbase.me
+    • dmx-mcp (active) — mcp-server
+      Path: ~/.acp/projects/dmx-mcp
+    • gcloud-mcp (active) — mcp-server — Google Cloud MCP server for Cloud Build and Cloud Run log tools
+      Path: ~/.acp/projects/gcloud-mcp
+```
+
+**Expected Outcome**: User sees all registered ACP projects at a glance  
+
+**Note**: If `~/.acp` does not exist or `~/.acp/projects.yaml` is missing, skip this step silently.  
 
 ### 2.5. Discover Global Packages (Optional)
 
-**Skip item**: `global`
+**Skip item**: `global`  
 
 Check for globally installed ACP packages.
 
@@ -134,7 +170,7 @@ Check for globally installed ACP packages.
 - Report available commands and patterns from global packages
 - Note that local packages take precedence over global packages
 
-**Expected Outcome**: Global packages discovered and reported (if any)
+**Expected Outcome**: Global packages discovered and reported (if any)  
 
 **Example Output**:
 ```
@@ -155,11 +191,11 @@ Check for globally installed ACP packages.
   ℹ️  Local packages take precedence over global packages
 ```
 
-**Note**: This step is optional and graceful - if no global packages exist or manifest is not found, continue without error.
+**Note**: This step is optional and graceful - if no global packages exist or manifest is not found, continue without error.  
 
 ### 2.8. Read Key Files from Index
 
-**Skip item**: `keys`
+**Skip item**: `keys`  
 
 Load critical project files from the key file index.
 
@@ -183,13 +219,13 @@ Load critical project files from the key file index.
   2 index files scanned, 2 key files read, 1 skipped
 ```
 
-**Expected Outcome**: High-importance key files loaded into context
+**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.
+**Note**: If `agent/index/` does not exist, skip this step silently. The index is optional but recommended.  
 
 ### 3. Identify Key Source Files
 
-**Skip item**: `files` | **Skipped by**: `--quick`
+**Skip item**: `files` | **Skipped by**: `--quick`  
 
 Determine which source files are most important to review.
 
@@ -200,11 +236,11 @@ Determine which source files are most important to review.
 - Identify core business logic files
 - List test files
 
-**Expected Outcome**: Key source files identified for review
+**Expected Outcome**: Key source files identified for review  
 
 ### 4. Review Key Source Files
 
-**Skip item**: `files` | **Skipped by**: `--quick`
+**Skip item**: `files` | **Skipped by**: `--quick`  
 
 Read important source files to understand current implementation.
 
@@ -216,11 +252,11 @@ Read important source files to understand current implementation.
 - Understand current architecture
 - Compare implementation with design documents
 
-**Expected Outcome**: Current implementation understood
+**Expected Outcome**: Current implementation understood  
 
 ### 5. Identify Documentation Drift
 
-**Skip item**: `sync` | **Skipped by**: `--quick`
+**Skip item**: `sync` | **Skipped by**: `--quick`  
 
 Compare documentation with actual implementation.
 
@@ -231,11 +267,11 @@ Compare documentation with actual implementation.
 - Flag missing documentation
 - List discrepancies
 
-**Expected Outcome**: Documentation gaps identified
+**Expected Outcome**: Documentation gaps identified  
 
 ### 6. Update Stale Documentation
 
-**Skip item**: `sync` | **Skipped by**: `--quick`
+**Skip item**: `sync` | **Skipped by**: `--quick`  
 
 Refresh outdated documentation to match current state.
 
@@ -246,11 +282,11 @@ Refresh outdated documentation to match current state.
 - Update progress.yaml with current understanding
 - Document any new patterns found in code
 
-**Expected Outcome**: Documentation synchronized with code
+**Expected Outcome**: Documentation synchronized with code  
 
 ### 7. Update Progress Tracking
 
-**Skip item**: `progress`
+**Skip item**: `progress`  
 
 Refresh progress.yaml with latest status.
 
@@ -262,7 +298,7 @@ Refresh progress.yaml with latest status.
 - Update next steps based on current state
 - Note any new blockers discovered
 
-**Expected Outcome**: Progress tracking is current and accurate
+**Expected Outcome**: Progress tracking is current and accurate  
 
 ### 8. Report Status and Next Steps
 
@@ -277,7 +313,7 @@ Provide comprehensive status report.
 - Note any blockers or concerns
 - Provide recommendations
 
-**Expected Outcome**: User has complete context and knows what to do next
+**Expected Outcome**: User has complete context and knows what to do next  
 
 ### 9. Display Usage Tip
 
@@ -290,7 +326,7 @@ Show a helpful tip about init flags when no flags were used.
   ```
 - If the user already used `--quick` or `--skip`, do **not** display the tip (they already know about it).
 
-**Expected Outcome**: Users discover the faster init modes naturally
+**Expected Outcome**: Users discover the faster init modes naturally  
 
 ### Handling Skipped Steps
 
@@ -422,43 +458,43 @@ Ready to proceed with task-2 completion.
 
 ### Example 1: Starting Fresh Session
 
-**Context**: Beginning work on a project for the first time today
+**Context**: Beginning work on a project for the first time today  
 
-**Invocation**: `@acp-init`
+**Invocation**: `@acp-init`  
 
-**Result**: Checks for updates, reads all 15 agent files, reviews 10 source files, updates progress tracking, reports you're on milestone 2 task 5, ready to continue
+**Result**: Checks for updates, reads all 15 agent files, reviews 10 source files, updates progress tracking, reports you're on milestone 2 task 5, ready to continue  
 
 ### Example 2: Returning After Break
 
-**Context**: Haven't worked on project in a week
+**Context**: Haven't worked on project in a week  
 
-**Invocation**: `@acp-init`
+**Invocation**: `@acp-init`  
 
-**Result**: Full context reload, discovers 3 new commits since last session, updates documentation to reflect changes, shows current status (milestone 3, 80% complete), identifies next task
+**Result**: Full context reload, discovers 3 new commits since last session, updates documentation to reflect changes, shows current status (milestone 3, 80% complete), identifies next task  
 
 ### Example 3: New Agent Session
 
-**Context**: Different AI agent picking up the project
+**Context**: Different AI agent picking up the project  
 
-**Invocation**: `@acp-init`
+**Invocation**: `@acp-init`  
 
-**Result**: Complete onboarding - reads all documentation, understands architecture from source code, gets current status, ready to contribute immediately
+**Result**: Complete onboarding - reads all documentation, understands architecture from source code, gets current status, ready to contribute immediately  
 
 ### Example 4: Quick Init
 
-**Context**: Returning to a familiar project, just need docs and status
+**Context**: Returning to a familiar project, just need docs and status  
 
-**Invocation**: `@acp-init --quick`
+**Invocation**: `@acp-init --quick`  
 
-**Result**: Skips version checks, source file review, and doc sync. Reads agent documentation, key files, reports status — fast startup in ~10 seconds
+**Result**: Skips version checks, source file review, and doc sync. Reads agent documentation, key files, reports status — fast startup in ~10 seconds  
 
 ### Example 5: Selective Skip
 
-**Context**: Want everything except version checks and session registration
+**Context**: Want everything except version checks and session registration  
 
-**Invocation**: `@acp-init --skip checks,sessions`
+**Invocation**: `@acp-init --skip checks,sessions`  
 
-**Result**: Full init minus the two skipped steps. All docs read, files reviewed, sync performed, status reported
+**Result**: Full init minus the two skipped steps. All docs read, files reviewed, sync performed, status reported  
 
 ---
 
@@ -475,35 +511,35 @@ Ready to proceed with task-2 completion.
 
 ### Issue 1: No agent/ directory found
 
-**Symptom**: Error message "agent/ directory not found"
+**Symptom**: Error message "agent/ directory not found"  
 
-**Cause**: ACP not installed in this project
+**Cause**: ACP not installed in this project  
 
-**Solution**: Install ACP first using the installation script from the ACP repository
+**Solution**: Install ACP first using the installation script from the ACP repository  
 
 ### Issue 2: Update check script not found
 
-**Symptom**: Warning "acp.version-check-for-updates.sh not found"
+**Symptom**: Warning "acp.version-check-for-updates.sh not found"  
 
-**Cause**: Older ACP installation without update scripts
+**Cause**: Older ACP installation without update scripts  
 
-**Solution**: This is non-critical, continue with initialization. Consider updating ACP to latest version.
+**Solution**: This is non-critical, continue with initialization. Consider updating ACP to latest version.  
 
 ### Issue 3: No source files found
 
-**Symptom**: Warning "No source files to review"
+**Symptom**: Warning "No source files to review"  
 
-**Cause**: Project is new or source code is in unexpected location
+**Cause**: Project is new or source code is in unexpected location  
 
-**Solution**: This is fine for new projects. Specify source file locations if they're in non-standard directories.
+**Solution**: This is fine for new projects. Specify source file locations if they're in non-standard directories.  
 
 ### Issue 4: progress.yaml doesn't exist
 
-**Symptom**: Error "Cannot read progress.yaml"
+**Symptom**: Error "Cannot read progress.yaml"  
 
-**Cause**: Progress tracking not initialized yet
+**Cause**: Progress tracking not initialized yet  
 
-**Solution**: Create progress.yaml from template: `cp agent/progress.template.yaml agent/progress.yaml`, then run `@acp-init` again
+**Solution**: Create progress.yaml from template: `cp agent/progress.template.yaml agent/progress.yaml`, then run `@acp-init` again  
 
 ---
 
@@ -536,11 +572,11 @@ Ready to proceed with task-2 completion.
 
 ---
 
-**Namespace**: acp
-**Command**: init
-**Version**: 1.1.0
-**Created**: 2026-02-16
-**Last Updated**: 2026-03-09
-**Status**: Active
-**Compatibility**: ACP 1.0.3+
-**Author**: ACP Project
+**Namespace**: acp  
+**Command**: init  
+**Version**: 1.1.0  
+**Created**: 2026-02-16  
+**Last Updated**: 2026-03-09  
+**Status**: Active  
+**Compatibility**: ACP 1.0.3+  
+**Author**: ACP Project