@prmichaelsen/remember-mcp 3.19.3 → 4.0.0

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

@@ -2,17 +2,17 @@
 
 > **🤖 Agent Directive**: If you are reading this file, the command `@acp.project-update` has been invoked. Follow the steps below to execute this command.
 
-**Namespace**: acp
-**Version**: 1.0.0
-**Created**: 2026-02-25
-**Last Updated**: 2026-02-25
-**Status**: Experimental
+**Namespace**: acp  
+**Version**: 1.0.0  
+**Created**: 2026-02-25  
+**Last Updated**: 2026-02-25  
+**Status**: Experimental  
 
 ---
 
-**Purpose**: Update project metadata in the global registry
-**Category**: Project Management
-**Frequency**: As Needed
+**Purpose**: Update project metadata in the global registry  
+**Category**: Project Management  
+**Frequency**: As Needed  
 
 ---
 
@@ -45,7 +45,7 @@ Extract project name and update options.
 - Parse update flags (--status, --description, --type, --git-origin, --git-branch, etc.)
 - Validate at least one update option provided
 
-**Expected Outcome**: Arguments parsed successfully
+**Expected Outcome**: Arguments parsed successfully  
 
 ### 2. Validate Project Exists
 
@@ -56,7 +56,7 @@ Check that the project is in the registry.
 - Check project exists with `yaml_has_key()`
 - Show error if not found
 
-**Expected Outcome**: Project found in registry
+**Expected Outcome**: Project found in registry  
 
 ### 3. Validate Update Values
 
@@ -67,7 +67,7 @@ Check that provided values are valid.
 - Validate other fields as needed
 - Show errors for invalid values
 
-**Expected Outcome**: All values validated
+**Expected Outcome**: All values validated  
 
 ### 4. Apply Updates
 
@@ -86,7 +86,7 @@ Update registry with new values.
 - Update last_modified timestamp
 - Update registry last_updated timestamp
 
-**Expected Outcome**: All updates applied to AST
+**Expected Outcome**: All updates applied to AST  
 
 ### 5. Write Changes
 
@@ -97,7 +97,7 @@ Save updated registry to disk.
 - Report number of updates applied
 - Show success message
 
-**Expected Outcome**: Registry updated on disk
+**Expected Outcome**: Registry updated on disk  
 
 ---
 
@@ -157,59 +157,59 @@ Run 'acp.project-info.sh remember-mcp-server' to see updated information
 
 ### Example 1: Update Project Status
 
-**Context**: Mark project as archived when completed
+**Context**: Mark project as archived when completed  
 
-**Invocation**: `@acp.project-update old-project --status archived`
+**Invocation**: `@acp.project-update old-project --status archived`  
 
-**Result**: Status changed to "archived", last_modified timestamp updated
+**Result**: Status changed to "archived", last_modified timestamp updated  
 
 ### Example 2: Add Multiple Tags
 
-**Context**: Add organization tags to project
+**Context**: Add organization tags to project  
 
-**Invocation**: `@acp.project-update my-project --add-tag production --add-tag critical --add-tag backend`
+**Invocation**: `@acp.project-update my-project --add-tag production --add-tag critical --add-tag backend`  
 
-**Result**: Three tags added, duplicates prevented if tags already exist
+**Result**: Three tags added, duplicates prevented if tags already exist  
 
 ### Example 3: Update Description
 
-**Context**: Improve project description
+**Context**: Improve project description  
 
-**Invocation**: `@acp.project-update my-project --description "Multi-tenant memory system with vector search and relationship tracking"`
+**Invocation**: `@acp.project-update my-project --description "Multi-tenant memory system with vector search and relationship tracking"`  
 
-**Result**: Description updated in registry
+**Result**: Description updated in registry  
 
 ### Example 4: Link Related Projects
 
-**Context**: Connect server and client projects
+**Context**: Connect server and client projects  
 
-**Invocation**: `@acp.project-update remember-mcp-server --add-related remember-mcp`
+**Invocation**: `@acp.project-update remember-mcp-server --add-related remember-mcp`  
 
-**Result**: remember-mcp added to related_projects array
+**Result**: remember-mcp added to related_projects array  
 
 ### Example 5: Set Git Origin
 
-**Context**: Manually set git remote URL for a project
+**Context**: Manually set git remote URL for a project  
 
-**Invocation**: `@acp.project-update my-project --git-origin git@github.com:user/my-project.git --git-branch main`
+**Invocation**: `@acp.project-update my-project --git-origin git@github.com:user/my-project.git --git-branch main`  
 
-**Result**: git_origin and git_branch set in registry, enabling `@acp.projects-restore`
+**Result**: git_origin and git_branch set in registry, enabling `@acp.projects-restore`  
 
 ### Example 6: Multiple Updates
 
-**Context**: Update several fields at once
+**Context**: Update several fields at once  
 
-**Invocation**: `@acp.project-update my-project --status active --add-tag production --remove-tag development`
+**Invocation**: `@acp.project-update my-project --status active --add-tag production --remove-tag development`  
 
-**Result**: Status updated, production tag added, development tag removed
+**Result**: Status updated, production tag added, development tag removed  
 
 ### Example 7: Remove Tag
 
-**Context**: Remove obsolete tag
+**Context**: Remove obsolete tag  
 
-**Invocation**: `@acp.project-update my-project --remove-tag deprecated`
+**Invocation**: `@acp.project-update my-project --remove-tag deprecated`  
 
-**Result**: Tag removed from tags array
+**Result**: Tag removed from tags array  
 
 ---
 
@@ -227,43 +227,43 @@ Run 'acp.project-info.sh remember-mcp-server' to see updated information
 
 ### Issue 1: Registry not found
 
-**Symptom**: Error "Project registry not found"
+**Symptom**: Error "Project registry not found"  
 
-**Cause**: `~/.acp/projects.yaml` doesn't exist
+**Cause**: `~/.acp/projects.yaml` doesn't exist  
 
-**Solution**: Create a project with `@acp.project-create` to initialize the registry
+**Solution**: Create a project with `@acp.project-create` to initialize the registry  
 
 ### Issue 2: Project not found
 
-**Symptom**: Error "Project 'name' not found in registry"
+**Symptom**: Error "Project 'name' not found in registry"  
 
-**Cause**: Project not registered or wrong name
+**Cause**: Project not registered or wrong name  
 
-**Solution**: Run `@acp.project-list` to see available projects
+**Solution**: Run `@acp.project-list` to see available projects  
 
 ### Issue 3: Invalid status value
 
-**Symptom**: Error "Invalid status 'value'"
+**Symptom**: Error "Invalid status 'value'"  
 
-**Cause**: Status must be one of: active, archived, paused
+**Cause**: Status must be one of: active, archived, paused  
 
-**Solution**: Use a valid status value
+**Solution**: Use a valid status value  
 
 ### Issue 4: No updates specified
 
-**Symptom**: Error "No updates specified"
+**Symptom**: Error "No updates specified"  
 
-**Cause**: Command requires at least one update option
+**Cause**: Command requires at least one update option  
 
-**Solution**: Provide at least one update flag (--status, --description, --add-tag, etc.)
+**Solution**: Provide at least one update flag (--status, --description, --add-tag, etc.)  
 
 ### Issue 5: Tag already exists
 
-**Symptom**: Message "Tag already exists: tag-name"
+**Symptom**: Message "Tag already exists: tag-name"  
 
-**Cause**: Trying to add a tag that's already in the tags array
+**Cause**: Trying to add a tag that's already in the tags array  
 
-**Solution**: This is informational, not an error. The tag won't be duplicated.
+**Solution**: This is informational, not an error. The tag won't be duplicated.  
 
 ---
 
@@ -297,11 +297,11 @@ Run 'acp.project-info.sh remember-mcp-server' to see updated information
 
 ---
 
-**Namespace**: acp
-**Command**: project-update
-**Version**: 1.0.0
-**Created**: 2026-02-25
-**Last Updated**: 2026-02-25
-**Status**: Experimental
-**Compatibility**: ACP 4.1.1+
-**Author**: ACP Project
+**Namespace**: acp  
+**Command**: project-update  
+**Version**: 1.0.0  
+**Created**: 2026-02-25  
+**Last Updated**: 2026-02-25  
+**Status**: Experimental  
+**Compatibility**: ACP 4.1.1+  
+**Author**: ACP Project  

package/agent/commands/acp.projects-restore.md

@@ -2,18 +2,18 @@
 
 > **🤖 Agent Directive**: If you are reading this file, the command `@acp.projects-restore` has been invoked. Follow the steps below to execute this command.
 
-**Namespace**: acp
-**Version**: 1.0.0
-**Created**: 2026-03-01
-**Last Updated**: 2026-03-01
-**Status**: Experimental
+**Namespace**: acp  
+**Version**: 1.0.0  
+**Created**: 2026-03-01  
+**Last Updated**: 2026-03-01  
+**Status**: Experimental  
 
 ---
 
-**Purpose**: Restore/clone missing projects from their registered git origins
-**Category**: Project Management
-**Frequency**: As Needed
-**Script**: [`agent/scripts/acp.projects-restore.sh`](../scripts/acp.projects-restore.sh)
+**Purpose**: Restore/clone missing projects from their registered git origins  
+**Category**: Project Management  
+**Frequency**: As Needed  
+**Script**: [`agent/scripts/acp.projects-restore.sh`](../scripts/acp.projects-restore.sh)  
 
 ---
 
@@ -52,7 +52,7 @@ Run the shell script to restore missing projects.
 - Checks each project's directory existence
 - Clones missing projects from `git_origin`
 
-**Expected Outcome**: Missing projects cloned to their registered paths
+**Expected Outcome**: Missing projects cloned to their registered paths  
 
 ### 2. Review Results
 
@@ -63,7 +63,7 @@ Check the restore summary.
 - Review skip count (already exist, archived, no origin)
 - Review errors (failed clones)
 
-**Expected Outcome**: All restorable projects cloned successfully
+**Expected Outcome**: All restorable projects cloned successfully  
 
 ---
 
@@ -129,27 +129,27 @@ Restore Complete
 
 ### Example 1: Preview Restore
 
-**Context**: Check what would be restored on a new machine
+**Context**: Check what would be restored on a new machine  
 
-**Invocation**: `@acp.projects-restore --dry-run`
+**Invocation**: `@acp.projects-restore --dry-run`  
 
-**Result**: Lists projects that would be cloned, skipped projects, and reasons
+**Result**: Lists projects that would be cloned, skipped projects, and reasons  
 
 ### Example 2: Full Restore
 
-**Context**: Restore all projects on a new machine
+**Context**: Restore all projects on a new machine  
 
-**Invocation**: `@acp.projects-restore`
+**Invocation**: `@acp.projects-restore`  
 
-**Result**: Clones all missing projects from their git origins
+**Result**: Clones all missing projects from their git origins  
 
 ### Example 3: Restore with ACP Install
 
-**Context**: Restore and set up ACP in each project
+**Context**: Restore and set up ACP in each project  
 
-**Invocation**: `@acp.projects-restore --install-acp`
+**Invocation**: `@acp.projects-restore --install-acp`  
 
-**Result**: Clones missing projects and installs ACP in each one
+**Result**: Clones missing projects and installs ACP in each one  
 
 ---
 
@@ -166,27 +166,27 @@ Restore Complete
 
 ### Issue 1: No projects to restore
 
-**Symptom**: All projects show "already exists" or "no git_origin"
+**Symptom**: All projects show "already exists" or "no git_origin"  
 
-**Cause**: Either all projects exist on disk, or git origins haven't been recorded
+**Cause**: Either all projects exist on disk, or git origins haven't been recorded  
 
-**Solution**: Run `@acp.projects-sync` first to backfill git_origin for existing projects
+**Solution**: Run `@acp.projects-sync` first to backfill git_origin for existing projects  
 
 ### Issue 2: Clone failed
 
-**Symptom**: "Clone failed" for a project
+**Symptom**: "Clone failed" for a project  
 
-**Cause**: Network error, authentication required, or repository no longer exists
+**Cause**: Network error, authentication required, or repository no longer exists  
 
-**Solution**: Check the git_origin URL, verify network access, and ensure you have repository permissions
+**Solution**: Check the git_origin URL, verify network access, and ensure you have repository permissions  
 
 ### Issue 3: Branch not found
 
-**Symptom**: "Branch 'xyz' not found on remote, using default"
+**Symptom**: "Branch 'xyz' not found on remote, using default"  
 
-**Cause**: The stored branch no longer exists on the remote
+**Cause**: The stored branch no longer exists on the remote  
 
-**Solution**: This is handled automatically by falling back to the default branch. Update with `@acp.project-update <name> --git-branch <new-branch>`
+**Solution**: This is handled automatically by falling back to the default branch. Update with `@acp.project-update <name> --git-branch <new-branch>`  
 
 ---
 
@@ -218,11 +218,11 @@ Restore Complete
 
 ---
 
-**Namespace**: acp
-**Command**: projects-restore
-**Version**: 1.0.0
-**Created**: 2026-03-01
-**Last Updated**: 2026-03-01
-**Status**: Experimental
-**Compatibility**: ACP 5.7.3+
-**Author**: ACP Project
+**Namespace**: acp  
+**Command**: projects-restore  
+**Version**: 1.0.0  
+**Created**: 2026-03-01  
+**Last Updated**: 2026-03-01  
+**Status**: Experimental  
+**Compatibility**: ACP 5.7.3+  
+**Author**: ACP Project  

package/agent/commands/acp.projects-sync.md

@@ -3,18 +3,18 @@
 > **🤖 Agent Directive**: If you are reading this file, the command `@acp.projects-sync` has been invoked. Follow the steps below to execute this command.
 > Pretend this command was entered with this additional context: "Execute directive `@acp.projects-sync` 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-02-26
-**Last Updated**: 2026-02-26
-**Status**: Experimental
+**Namespace**: acp  
+**Version**: 1.0.0  
+**Created**: 2026-02-26  
+**Last Updated**: 2026-02-26  
+**Status**: Experimental  
 
 ---
 
-**Purpose**: Discover unregistered ACP projects in `~/.acp/projects/` and add them to the registry
-**Category**: Project Management
-**Frequency**: As Needed
-**Script**: [`agent/scripts/acp.projects-sync.sh`](../scripts/acp.projects-sync.sh)
+**Purpose**: Discover unregistered ACP projects in `~/.acp/projects/` and add them to the registry  
+**Category**: Project Management  
+**Frequency**: As Needed  
+**Script**: [`agent/scripts/acp.projects-sync.sh`](../scripts/acp.projects-sync.sh)  
 
 ---
 
@@ -54,7 +54,7 @@ Run the shell script to scan for unregistered projects.
 - Checks registry for each project
 - Prompts for unregistered projects
 
-**Expected Outcome**: Interactive prompts for each unregistered project
+**Expected Outcome**: Interactive prompts for each unregistered project  
 
 ### 2. Review Each Unregistered Project
 
@@ -66,7 +66,7 @@ For each unregistered project found, review the metadata.
 - Display metadata to user
 - Prompt: "Register this project? (Y/n)"
 
-**Expected Outcome**: User decides whether to register each project
+**Expected Outcome**: User decides whether to register each project  
 
 ### 3. Register Selected Projects
 
@@ -78,7 +78,7 @@ Register projects that user confirms.
 - Set timestamps (created, modified, accessed)
 - Display success message
 
-**Expected Outcome**: Selected projects added to registry
+**Expected Outcome**: Selected projects added to registry  
 
 ### 4. Backfill Git Info
 
@@ -90,7 +90,7 @@ For already-registered projects, detect and backfill missing `git_origin` and `g
 - Auto-detect branch from `git branch --show-current`
 - Write backfilled data to registry
 
-**Expected Outcome**: Existing projects gain git_origin/git_branch fields
+**Expected Outcome**: Existing projects gain git_origin/git_branch fields  
 
 ### 5. Display Summary
 
@@ -103,7 +103,7 @@ Show sync results.
 - Display summary statistics
 - Suggest running `@acp.project-list`
 
-**Expected Outcome**: User knows what was registered and backfilled
+**Expected Outcome**: User knows what was registered and backfilled  
 
 ---
 
@@ -155,9 +155,9 @@ Run @acp.project-list to see all registered projects
 
 ### Example 1: First Time Sync
 
-**Context**: User has 3 projects in `~/.acp/projects/`, none registered
+**Context**: User has 3 projects in `~/.acp/projects/`, none registered  
 
-**Invocation**: `@acp.projects-sync`
+**Invocation**: `@acp.projects-sync`  
 
 **Result**:
 - Finds 3 projects
@@ -167,9 +167,9 @@ Run @acp.project-list to see all registered projects
 
 ### Example 2: Partial Sync
 
-**Context**: User has 5 projects, 2 already registered
+**Context**: User has 5 projects, 2 already registered  
 
-**Invocation**: `@acp.projects-sync`
+**Invocation**: `@acp.projects-sync`  
 
 **Result**:
 - Finds 5 projects total
@@ -180,9 +180,9 @@ Run @acp.project-list to see all registered projects
 
 ### Example 3: No New Projects
 
-**Context**: All projects already registered
+**Context**: All projects already registered  
 
-**Invocation**: `@acp.projects-sync`
+**Invocation**: `@acp.projects-sync`  
 
 **Result**:
 - Finds all projects
@@ -192,9 +192,9 @@ Run @acp.project-list to see all registered projects
 
 ### Example 4: Empty Directory
 
-**Context**: `~/.acp/projects/` is empty
+**Context**: `~/.acp/projects/` is empty  
 
-**Invocation**: `@acp.projects-sync`
+**Invocation**: `@acp.projects-sync`  
 
 **Result**:
 - No projects found
@@ -216,9 +216,9 @@ Run @acp.project-list to see all registered projects
 
 ### Issue 1: No projects found
 
-**Symptom**: "Found: 0 projects"
+**Symptom**: "Found: 0 projects"  
 
-**Cause**: No directories in `~/.acp/projects/` with `agent/progress.yaml`
+**Cause**: No directories in `~/.acp/projects/` with `agent/progress.yaml`  
 
 **Solution**: 
 - Check if projects exist in `~/.acp/projects/`
@@ -227,11 +227,11 @@ Run @acp.project-list to see all registered projects
 
 ### Issue 2: Registry not found
 
-**Symptom**: Error about missing registry
+**Symptom**: Error about missing registry  
 
-**Cause**: `~/.acp/projects.yaml` doesn't exist
+**Cause**: `~/.acp/projects.yaml` doesn't exist  
 
-**Solution**: Script auto-initializes registry, but if error persists:
+**Solution**: Script auto-initializes registry, but if error persists:  
 ```bash
 # Initialize global ACP
 ~/.acp/agent/scripts/acp.common.sh
@@ -240,9 +240,9 @@ init_projects_registry
 
 ### Issue 3: Cannot read progress.yaml
 
-**Symptom**: "Type: unknown, Description: No description"
+**Symptom**: "Type: unknown, Description: No description"  
 
-**Cause**: `progress.yaml` is malformed or missing fields
+**Cause**: `progress.yaml` is malformed or missing fields  
 
 **Solution**: 
 - Check `progress.yaml` syntax
@@ -251,9 +251,9 @@ init_projects_registry
 
 ### Issue 4: Permission denied
 
-**Symptom**: Cannot write to registry
+**Symptom**: Cannot write to registry  
 
-**Cause**: No write permission for `~/.acp/projects.yaml`
+**Cause**: No write permission for `~/.acp/projects.yaml`  
 
 **Solution**:
 ```bash
@@ -337,11 +337,11 @@ Uses existing infrastructure:
 
 ---
 
-**Namespace**: acp
-**Command**: projects-sync
-**Version**: 1.0.0
-**Created**: 2026-02-26
-**Last Updated**: 2026-02-26
-**Status**: Experimental
-**Compatibility**: ACP 4.1.0+
-**Author**: ACP Project
+**Namespace**: acp  
+**Command**: projects-sync  
+**Version**: 1.0.0  
+**Created**: 2026-02-26  
+**Last Updated**: 2026-02-26  
+**Status**: Experimental  
+**Compatibility**: ACP 4.1.0+  
+**Author**: ACP Project