@prmichaelsen/remember-mcp 3.0.0 → 3.13.0

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

@@ -0,0 +1,379 @@
+# Command: project-remove
+
+> **🤖 Agent Directive**: If you are reading this file, the command `@acp.project-remove` has been invoked. Follow the steps below to execute this command.
+> Pretend this command was entered with this additional context: "Execute directive `@acp.project-remove` 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
+
+---
+
+**Purpose**: Remove a project from the global registry with optional directory deletion
+**Category**: Project Management
+**Frequency**: As Needed
+
+---
+
+## What This Command Does
+
+This command removes a project from the global ACP project registry at `~/.acp/projects.yaml`. It provides two removal modes:
+
+1. **Registry Only** (default): Removes project metadata from registry, preserves directory
+2. **Complete Removal** (--delete-files): Removes from registry AND deletes project directory
+
+The command includes safety features:
+- Confirmation prompts before removal
+- Extra confirmation for directory deletion (requires typing "DELETE")
+- Warning if removing the current project
+- Updates `current_project` to empty if removing current
+- Lists remaining projects after removal
+
+**Use this when**: Cleaning up old projects, removing archived projects, or completely deleting abandoned projects.
+
+---
+
+## Prerequisites
+
+- [ ] Global ACP installed (`~/.acp/` exists)
+- [ ] Project registry exists (`~/.acp/projects.yaml`)
+- [ ] Target project registered in registry
+
+---
+
+## Steps
+
+### 1. Run Shell Script
+
+Execute the project-remove script with the project name and options.
+
+**Actions**:
+- Run: `./agent/scripts/acp.project-remove.sh <project-name> [options]`
+- Script validates project exists in registry
+- Script displays project information
+- Script prompts for confirmation
+- Script removes from registry
+- Script optionally deletes directory
+
+**Expected Outcome**: Project removed from registry
+
+### 2. Verify Removal
+
+Confirm the project was removed successfully.
+
+**Actions**:
+- Check success message displays project name
+- Verify project no longer in registry
+- Check if directory was deleted (if --delete-files used)
+- Note if current_project was cleared
+
+**Expected Outcome**: Project removed, registry updated
+
+### 3. Switch to Another Project (If Needed)
+
+If removed project was current, switch to another project.
+
+**Actions**:
+- Run `@acp.project-list` to see remaining projects
+- Run `@acp.project-set <name>` to switch to another project
+- Or continue without a current project
+
+**Expected Outcome**: New project context established (if needed)
+
+---
+
+## Verification
+
+- [ ] Script executed without errors
+- [ ] Project existed in registry
+- [ ] Confirmation prompt displayed (unless -y used)
+- [ ] Project removed from registry
+- [ ] Directory deleted if --delete-files used
+- [ ] Directory preserved if --delete-files not used
+- [ ] `current_project` cleared if removing current
+- [ ] `last_updated` timestamp updated
+- [ ] Success message displayed
+- [ ] Remaining projects listed
+
+---
+
+## Expected Output
+
+### Console Output (Registry Only)
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Project to Remove
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Name: old-project
+Type: web-app
+Description: Deprecated web application
+Path: /home/user/.acp/projects/old-project
+
+ℹ️  Project directory will be kept (use --delete-files to remove)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Remove this project from registry? [y/N] y
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ Project Removed
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Removed from registry: old-project
+Directory preserved: /home/user/.acp/projects/old-project
+
+Run '@acp.project-list' to see remaining projects
+```
+
+### Console Output (With Directory Deletion)
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Project to Remove
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Name: old-project
+Type: web-app
+Path: /home/user/.acp/projects/old-project
+
+⚠️  WARNING: Project directory will be DELETED from filesystem
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Remove this project from registry? [y/N] y
+
+⚠️  DANGER: You are about to DELETE the project directory:
+  /home/user/.acp/projects/old-project
+
+Are you ABSOLUTELY SURE? Type 'DELETE' to confirm: DELETE
+
+Deleting project directory...
+✓ Deleted: /home/user/.acp/projects/old-project
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ Project Removed
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Removed from registry: old-project
+Deleted from filesystem: /home/user/.acp/projects/old-project
+
+Run '@acp.project-list' to see remaining projects
+```
+
+### Console Output (Removing Current Project)
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Project to Remove
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Name: current-project
+Type: mcp-server
+Path: /home/user/.acp/projects/current-project
+
+⚠️  WARNING: This is the CURRENT project
+
+ℹ️  Project directory will be kept (use --delete-files to remove)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Remove this project from registry? [y/N] y
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ Project Removed
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Removed from registry: current-project
+Directory preserved: /home/user/.acp/projects/current-project
+
+⚠️  This was the current project
+Run '@acp.project-set <name>' to switch to another project
+
+Run '@acp.project-list' to see remaining projects
+```
+
+### Registry Changes
+
+**Before**:
+```yaml
+current_project: old-project
+
+projects:
+  old-project:
+    type: web-app
+    status: archived
+    path: /home/user/.acp/projects/old-project
+    # ... other fields
+  
+  active-project:
+    type: mcp-server
+    # ... other fields
+
+last_updated: 2026-02-24T17:00:00Z
+```
+
+**After**:
+```yaml
+current_project: ""  # Cleared if removed project was current
+
+projects:
+  active-project:
+    type: mcp-server
+    # ... other fields
+
+last_updated: 2026-02-26T18:00:00Z  # Updated
+```
+
+---
+
+## Examples
+
+### Example 1: Remove from Registry Only
+
+**Context**: Project archived, want to clean up registry but keep files
+
+**Invocation**: `@acp.project-remove old-project`
+
+**Result**: 
+- Project removed from registry
+- Directory preserved at original location
+- Can still access files manually
+- Registry cleaned up
+
+### Example 2: Complete Removal
+
+**Context**: Abandoned project, want to delete everything
+
+**Invocation**: `@acp.project-remove abandoned-project --delete-files`
+
+**Result**:
+- Project removed from registry
+- Directory deleted from filesystem
+- All project files gone
+- Complete cleanup
+
+### Example 3: Auto-Confirm Removal
+
+**Context**: Scripting or automation, want to skip prompts
+
+**Invocation**: `@acp.project-remove old-project -y`
+
+**Result**:
+- No confirmation prompts
+- Project removed immediately
+- Useful for scripts and automation
+
+### Example 4: Remove Current Project
+
+**Context**: Removing the project you're currently working on
+
+**Invocation**: `@acp.project-remove current-project`
+
+**Result**:
+- Warning displayed about removing current project
+- Project removed from registry
+- `current_project` cleared in registry
+- Suggestion to switch to another project
+
+---
+
+## Related Commands
+
+- [`@acp.project-list`](acp.project-list.md) - List all projects
+- [`@acp.project-set`](acp.project-set.md) - Switch to another project
+- [`@acp.project-info`](acp.project-info.md) - Show project details
+- [`@acp.project-update`](acp.project-update.md) - Update project metadata
+
+---
+
+## Troubleshooting
+
+### Issue 1: Project not found in registry
+
+**Symptom**: Error "Project 'X' not found in registry"
+
+**Cause**: Project not registered or typo in name
+
+**Solution**: 
+- Run `@acp.project-list` to see available projects
+- Check spelling of project name
+- Project may already be removed
+
+### Issue 2: Registry file not found
+
+**Symptom**: Error "Project registry not found"
+
+**Cause**: Global ACP not initialized or registry deleted
+
+**Solution**:
+- No action needed if no projects exist
+- Run `@acp.project-create` to create new project (initializes registry)
+
+### Issue 3: Cannot delete directory
+
+**Symptom**: Error during directory deletion
+
+**Cause**: Permission issues or directory in use
+
+**Solution**:
+- Check file permissions
+- Close any programs using the directory
+- Manually delete directory: `rm -rf /path/to/project`
+
+### Issue 4: Confirmation prompt not appearing
+
+**Symptom**: Script removes project without asking
+
+**Cause**: -y/--yes flag used
+
+**Solution**:
+- This is expected behavior with -y flag
+- Remove -y flag if you want confirmation prompts
+
+---
+
+## Security Considerations
+
+### File Access
+- **Reads**: `~/.acp/projects.yaml` (registry)
+- **Writes**: `~/.acp/projects.yaml` (removes project entry)
+- **Deletes**: Project directory (only with --delete-files flag)
+
+### Dangerous Operations
+- **Directory Deletion**: Requires explicit --delete-files flag and "DELETE" confirmation
+- **No Undo**: Deleted directories cannot be recovered (use git backups)
+- **Current Project**: Clears current_project if removing current
+
+### Best Practices
+- **Backup First**: Commit and push changes before removing
+- **Archive Status**: Consider marking as archived instead of removing
+- **Registry Only**: Default behavior preserves files for safety
+- **Double Confirm**: Directory deletion requires typing "DELETE"
+
+---
+
+## Notes
+
+- **Default Behavior**: Removes from registry only, preserves directory
+- **Safety First**: Multiple confirmation prompts for destructive operations
+- **Current Project**: Automatically cleared if removing current project
+- **Timestamps**: Updates registry `last_updated` timestamp
+- **No Undo**: Registry removal can be undone manually, directory deletion cannot
+- **Automation**: Use -y flag for scripting (skips prompts)
+- **Related Projects**: Does not remove related projects (only specified project)
+- **Tags**: Project tags are removed with the project
+
+---
+
+**Namespace**: acp
+**Command**: project-remove
+**Version**: 1.0.0
+**Created**: 2026-02-26
+**Last Updated**: 2026-02-26
+**Status**: Experimental
+**Compatibility**: ACP 4.1.0+
+**Author**: ACP Project

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

@@ -0,0 +1,296 @@
+# Command: project-update
+
+> **🤖 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
+
+---
+
+**Purpose**: Update project metadata in the global registry
+**Category**: Project Management
+**Frequency**: As Needed
+
+---
+
+## What This Command Does
+
+This command updates metadata for a project in `~/.acp/projects.yaml`, allowing you to modify status, description, type, tags, and related projects. It provides granular control over project metadata without requiring manual YAML editing.
+
+Use this command to keep project metadata current as projects evolve, mark projects as archived when completed, add tags for organization, link related projects, or correct project information. All updates automatically update the `last_modified` timestamp.
+
+Unlike [`@acp.project-info`](acp.project-info.md:1) which displays information, this command modifies the registry. It supports multiple update operations in a single invocation.
+
+---
+
+## Prerequisites
+
+- [ ] Global ACP infrastructure initialized (`~/.acp/` exists)
+- [ ] Project registry exists (`~/.acp/projects.yaml`)
+- [ ] Project is registered in the registry
+
+---
+
+## Steps
+
+### 1. Parse Arguments
+
+Extract project name and update options.
+
+**Actions**:
+- Parse project name (required)
+- Parse update flags (--status, --description, --type, etc.)
+- Validate at least one update option provided
+
+**Expected Outcome**: Arguments parsed successfully
+
+### 2. Validate Project Exists
+
+Check that the project is in the registry.
+
+**Actions**:
+- Load registry with `yaml_parse()`
+- Check project exists with `yaml_has_key()`
+- Show error if not found
+
+**Expected Outcome**: Project found in registry
+
+### 3. Validate Update Values
+
+Check that provided values are valid.
+
+**Actions**:
+- Validate status is one of: active, archived, paused
+- Validate other fields as needed
+- Show errors for invalid values
+
+**Expected Outcome**: All values validated
+
+### 4. Apply Updates
+
+Update registry with new values.
+
+**Actions**:
+- Update status (if provided)
+- Update description (if provided)
+- Update type (if provided)
+- Add tags (if provided)
+- Remove tags (if provided)
+- Add related projects (if provided)
+- Remove related projects (if provided)
+- Update last_modified timestamp
+- Update registry last_updated timestamp
+
+**Expected Outcome**: All updates applied to AST
+
+### 5. Write Changes
+
+Save updated registry to disk.
+
+**Actions**:
+- Write changes with `yaml_write()`
+- Report number of updates applied
+- Show success message
+
+**Expected Outcome**: Registry updated on disk
+
+---
+
+## Verification
+
+- [ ] Script created and executable
+- [ ] Command document created
+- [ ] Validates project name argument
+- [ ] Validates at least one update option provided
+- [ ] Validates status values (active|archived|paused)
+- [ ] Updates status correctly
+- [ ] Updates description correctly
+- [ ] Updates type correctly
+- [ ] Adds tags correctly (prevents duplicates)
+- [ ] Removes tags correctly
+- [ ] Adds related projects correctly (prevents duplicates)
+- [ ] Removes related projects correctly
+- [ ] Updates last_modified timestamp
+- [ ] Updates registry last_updated timestamp
+- [ ] Writes changes to disk
+- [ ] No syntax errors
+
+---
+
+## Expected Output
+
+### Files Created
+- `agent/scripts/acp.project-update.sh` - Shell script for updating projects
+- `agent/commands/acp.project-update.md` - This command documentation
+
+### Console Output
+```
+Updating project: remember-mcp-server
+
+✓ Updated status: archived
+✓ Added tag: production
+✓ Added tag: critical
+✓ Removed tag: development
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+✅ Project updated successfully!
+   Updates applied: 4
+   Registry: ~/.acp/projects.yaml
+
+Run 'acp.project-info.sh remember-mcp-server' to see updated information
+```
+
+### Status Update
+- Project metadata updated in registry
+- Timestamps updated
+- Changes persisted to disk
+
+---
+
+## Examples
+
+### Example 1: Update Project Status
+
+**Context**: Mark project as archived when completed
+
+**Invocation**: `@acp.project-update old-project --status archived`
+
+**Result**: Status changed to "archived", last_modified timestamp updated
+
+### Example 2: Add Multiple Tags
+
+**Context**: Add organization tags to project
+
+**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
+
+### Example 3: Update Description
+
+**Context**: Improve project description
+
+**Invocation**: `@acp.project-update my-project --description "Multi-tenant memory system with vector search and relationship tracking"`
+
+**Result**: Description updated in registry
+
+### Example 4: Link Related Projects
+
+**Context**: Connect server and client projects
+
+**Invocation**: `@acp.project-update remember-mcp-server --add-related remember-mcp`
+
+**Result**: remember-mcp added to related_projects array
+
+### Example 5: Multiple Updates
+
+**Context**: Update several fields at once
+
+**Invocation**: `@acp.project-update my-project --status active --add-tag production --remove-tag development`
+
+**Result**: Status updated, production tag added, development tag removed
+
+### Example 6: Remove Tag
+
+**Context**: Remove obsolete tag
+
+**Invocation**: `@acp.project-update my-project --remove-tag deprecated`
+
+**Result**: Tag removed from tags array
+
+---
+
+## Related Commands
+
+- [`@acp.project-info`](acp.project-info.md) - View project details before updating
+- [`@acp.project-list`](acp.project-list.md) - List all projects
+- [`@acp.project-set`](acp.project-set.md) - Switch to a project
+- [`@acp.projects-sync`](acp.projects-sync.md) - Sync registry with filesystem
+
+---
+
+## Troubleshooting
+
+### Issue 1: Registry not found
+
+**Symptom**: Error "Project registry not found"
+
+**Cause**: `~/.acp/projects.yaml` doesn't exist
+
+**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"
+
+**Cause**: Project not registered or wrong name
+
+**Solution**: Run `@acp.project-list` to see available projects
+
+### Issue 3: Invalid status value
+
+**Symptom**: Error "Invalid status 'value'"
+
+**Cause**: Status must be one of: active, archived, paused
+
+**Solution**: Use a valid status value
+
+### Issue 4: No updates specified
+
+**Symptom**: Error "No updates specified"
+
+**Cause**: Command requires at least one update option
+
+**Solution**: Provide at least one update flag (--status, --description, --add-tag, etc.)
+
+### Issue 5: Tag already exists
+
+**Symptom**: Message "Tag already exists: tag-name"
+
+**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.
+
+---
+
+## Security Considerations
+
+### File Access
+- **Reads**: `~/.acp/projects.yaml` (project registry)
+- **Writes**: `~/.acp/projects.yaml` (updates project metadata)
+- **Executes**: None
+
+### Network Access
+- **APIs**: None
+- **Repositories**: None
+
+### Sensitive Data
+- **Secrets**: Does not access any secrets or credentials
+- **Credentials**: Does not access credentials
+
+---
+
+## Notes
+
+- Updates are applied immediately to the registry file
+- Multiple updates can be applied in a single command
+- Timestamps are automatically updated (last_modified, last_updated)
+- Tags and related projects prevent duplicates automatically
+- Status values are validated (active, archived, paused)
+- Does not modify the project directory itself, only registry metadata
+- Part of Milestone 7 (Global ACP Project Registry)
+- Marked as Experimental until M7 is complete
+
+---
+
+**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