@prmichaelsen/acp-visualizer 0.1.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-set.md

@@ -0,0 +1,227 @@
+# Command: project-set
+
+> **🤖 Agent Directive**: If you are reading this file, the command `@acp.project-set` has been invoked. Follow the steps below to execute this command.
+> Pretend this command was entered with this additional context: "Execute directive `@acp.project-set` 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-24
+**Last Updated**: 2026-02-24
+**Status**: Experimental
+**Scripts**: acp.project-set.sh, acp.common.sh, acp.yaml-parser.sh
+
+---
+
+**Purpose**: Switch to a different project in the global registry
+**Category**: Workflow
+**Frequency**: As Needed
+
+---
+
+## What This Command Does
+
+This command enables seamless context switching between projects in the global ACP workspace. It:
+
+1. Sets the specified project as the current project in `~/.acp/projects.yaml`
+2. Updates the project's `last_accessed` timestamp
+3. Changes the working directory to the project path
+4. Reports the new context to the user
+
+After running this command, all subsequent file operations will be relative to the new project directory. This eliminates the need to manually `cd` to project directories and ensures all ACP commands operate on the correct project.
+
+**Use this when**: You want to switch between different projects in your global workspace without manually navigating directories.
+
+---
+
+## Prerequisites
+
+- [ ] Global ACP installed (`~/.acp/` exists)
+- [ ] Project registry exists (`~/.acp/projects.yaml`)
+- [ ] Target project registered in registry
+- [ ] Project directory exists on filesystem
+
+---
+
+## Steps
+
+### 1. Run Shell Script
+
+Execute the project-set script with the project name.
+
+**Actions**:
+- Run: `./agent/scripts/acp.project-set.sh <project-name>`
+- Script validates project exists in registry
+- Script validates project directory exists
+- Script updates registry metadata
+- Script changes to project directory
+
+**Expected Outcome**: Working directory changed to project path
+
+### 2. Verify Context Switch
+
+Confirm the context switch was successful.
+
+**Actions**:
+- Check success message displays project name and path
+- Verify working directory changed
+- Note project type and description
+
+**Expected Outcome**: Clear confirmation of new project context
+
+### 3. Load Project Context (Optional)
+
+Suggest running `@acp.init` to load full project context.
+
+**Actions**:
+- Inform user they can run `@acp.init`
+- This will load project documentation and status
+- All ACP commands now operate on this project
+
+**Expected Outcome**: User knows how to proceed
+
+---
+
+## Verification
+
+- [ ] Script executed without errors
+- [ ] Project exists in registry
+- [ ] Project directory exists
+- [ ] `current_project` updated in registry
+- [ ] `last_accessed` timestamp updated
+- [ ] Working directory changed to project path
+- [ ] Success message displayed
+- [ ] User informed about next steps
+
+---
+
+## Expected Output
+
+### Console Output
+```
+✓ Switched to project: remember-mcp-server
+  Path: /home/user/.acp/projects/remember-mcp-server
+  Type: mcp-server
+  Description: Multi-tenant memory system with vector search
+
+You are now in the project directory. All file operations will be relative to:
+  /home/user/.acp/projects/remember-mcp-server
+
+Run '@acp.init' to load project context
+```
+
+### Registry Changes
+```yaml
+# ~/.acp/projects.yaml
+current_project: remember-mcp-server  # Updated
+
+projects:
+  remember-mcp-server:
+    last_accessed: 2026-02-24T17:00:00Z  # Updated
+    # ... other fields unchanged
+
+last_updated: 2026-02-24T17:00:00Z  # Updated
+```
+
+---
+
+## Examples
+
+### Example 1: Switch to MCP Server Project
+
+**Context**: Working on multiple MCP servers, need to switch between them
+
+**Invocation**: `@acp.project-set remember-mcp-server`
+
+**Result**: 
+- Context switched to remember-mcp-server
+- Working directory: `~/.acp/projects/remember-mcp-server`
+- All commands now operate on this project
+
+### Example 2: Switch to Client Project
+
+**Context**: Need to work on client library after working on server
+
+**Invocation**: `@acp.project-set remember-mcp`
+
+**Result**:
+- Context switched to remember-mcp (client)
+- Working directory: `~/.acp/projects/remember-mcp`
+- Can now work on client code
+
+### Example 3: Project Not Found
+
+**Context**: Trying to switch to non-existent project
+
+**Invocation**: `@acp.project-set nonexistent-project`
+
+**Result**:
+- Error message displayed
+- List of available projects shown
+- Suggestion to run `@acp.project-list`
+- Working directory unchanged
+
+---
+
+## Related Commands
+
+- [`@acp.project-list`](acp.project-list.md) - List all projects
+- [`@acp.project-info`](acp.project-info.md) - Show project details
+- [`@acp.project-create`](acp.project-create.md) - Create new project
+- [`@acp.init`](acp.init.md) - Load project context
+
+---
+
+## 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
+- Register project with `@acp.project-create` if needed
+
+### Issue 2: Project directory not found
+
+**Symptom**: Error "Project directory not found: /path/to/project"
+
+**Cause**: Project moved or deleted from filesystem
+
+**Solution**:
+- Update project path: `@acp.project-update <name> --path <new-path>`
+- Or remove from registry: `@acp.project-remove <name>`
+
+### Issue 3: Registry file not found
+
+**Symptom**: Error "Project registry not found"
+
+**Cause**: Global ACP not initialized or registry deleted
+
+**Solution**:
+- Run `@acp.project-create` to create first project (initializes registry)
+- Or manually create `~/.acp/projects.yaml` from template
+
+---
+
+## Notes
+
+- **Context Switching**: This command changes your shell's working directory
+- **Relative Paths**: All file operations after this command are relative to the new project
+- **Current Project**: Only one project can be current at a time
+- **Timestamps**: `last_accessed` is updated every time you switch to a project
+- **No Side Effects**: Switching projects doesn't modify project files
+- **Shell Session**: Context switch persists for current shell session only
+
+---
+
+**Namespace**: acp
+**Command**: project-set
+**Version**: 1.0.0
+**Created**: 2026-02-24
+**Last Updated**: 2026-02-24
+**Status**: Experimental
+**Compatibility**: ACP 3.12.0+
+**Author**: ACP Project