@prmichaelsen/reddit-mcp 0.1.0

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

@@ -0,0 +1,312 @@
+# Command: project-info
+
+> **🤖 Agent Directive**: If you are reading this file, the command `@acp.project-info` 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**: Display detailed information about a specific project from the global registry
+**Category**: Project Management
+**Frequency**: As Needed
+
+---
+
+## What This Command Does
+
+This command displays comprehensive information about a project registered in `~/.acp/projects.yaml`, including metadata, timestamps, tags, related projects, dependencies, and directory status. It provides a complete view of a project's configuration and current state.
+
+Use this command to understand project details, check project status, view relationships with other projects, and verify project directory existence. It's particularly useful when working with multiple projects in the global workspace to quickly understand project context.
+
+Unlike [`@acp.project-list`](acp.project-list.md:1) which shows all projects in a summary view, `@acp.project-info` focuses on a single project and displays all available metadata in detail.
+
+---
+
+## Prerequisites
+
+- [ ] Global ACP infrastructure initialized (`~/.acp/` exists)
+- [ ] Project registry exists (`~/.acp/projects.yaml`)
+- [ ] Project is registered in the registry
+
+---
+
+## Steps
+
+### 1. Validate Arguments
+
+Check that project name is provided.
+
+**Actions**:
+- Verify project name argument is present
+- Show usage if missing
+
+**Expected Outcome**: Project name identified
+
+### 2. Load Registry
+
+Read the project registry file.
+
+**Actions**:
+- Get registry path via `get_projects_registry_path()`
+- Check if registry file exists
+- Parse registry with `yaml_parse()`
+
+**Expected Outcome**: Registry loaded successfully
+
+### 3. Validate Project Exists
+
+Check that the project is in the registry.
+
+**Actions**:
+- Use `yaml_has_key()` to check for project
+- If not found, list available projects
+- Show helpful error message
+
+**Expected Outcome**: Project found in registry
+
+### 4. Extract Project Metadata
+
+Read all project fields from registry.
+
+**Actions**:
+- Extract required fields: path, type, description, status, timestamps
+- Extract git fields: git_origin, git_branch
+- Extract optional fields: tags, related_projects, dependencies
+- Check if project is current project (marked with ⭐)
+
+**Expected Outcome**: All metadata extracted
+
+### 5. Display Project Information
+
+Format and display comprehensive project details.
+
+**Actions**:
+- Display project name with current indicator
+- Show type, status, path, description
+- Display timestamps (created, modified, accessed)
+- Display git info (origin, branch) if available
+- Show tags (if present)
+- Show related projects (if present)
+- Show dependencies by package manager (npm, pip, cargo, go)
+
+**Expected Outcome**: Complete project information displayed
+
+### 6. Check Directory Status
+
+Verify project directory exists and check ACP status.
+
+**Actions**:
+- Expand tilde in path
+- Check if directory exists
+- Check if AGENT.md exists (ACP project indicator)
+- Try to read project version from progress.yaml
+- Display status with appropriate indicators (✅/❌/⚠️)
+
+**Expected Outcome**: Directory status reported
+
+---
+
+## Verification
+
+- [ ] Script created and executable
+- [ ] Command document created
+- [ ] Validates project name argument
+- [ ] Loads registry successfully
+- [ ] Checks project exists in registry
+- [ ] Displays all metadata fields
+- [ ] Shows tags, related projects, dependencies (if present)
+- [ ] Checks directory existence
+- [ ] Detects ACP projects
+- [ ] Handles missing projects gracefully
+- [ ] Clear formatting with separators
+- [ ] No syntax errors
+
+---
+
+## Expected Output
+
+### Files Created
+- `agent/scripts/acp.project-info.sh` - Shell script for displaying project info
+- `agent/commands/acp.project-info.md` - This command documentation
+
+### Console Output
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📦 remember-mcp-server ⭐ Current
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Type: mcp-server
+Status: active
+Path: ~/.acp/projects/remember-mcp-server
+
+Description:
+  Multi-tenant memory system with vector search
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Timestamps:
+  Created: 2026-02-20T10:00:00Z
+  Last Modified: 2026-02-23T07:00:00Z
+  Last Accessed: 2026-02-25T17:00:00Z
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Tags:
+  - mcp
+  - memory
+  - vector-search
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Related Projects:
+  - remember-mcp
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Dependencies:
+  npm:
+    - weaviate-client
+    - firebase-admin
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+✅ Project directory exists
+✅ ACP project (AGENT.md found)
+   Version: 1.0.0
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Status Update
+- Project information displayed
+- Directory status verified
+
+---
+
+## Examples
+
+### Example 1: Show Current Project Info
+
+**Context**: Want to see details about the current project
+
+**Invocation**: `@acp.project-info remember-mcp-server`
+
+**Result**: Displays complete project metadata including type, status, path, description, timestamps, tags, related projects, dependencies, and directory status
+
+### Example 2: Check Project Before Switching
+
+**Context**: Want to verify project exists before switching to it
+
+**Invocation**: `@acp.project-info agentbase-mcp-server`
+
+**Result**: Shows project details, confirms directory exists, shows it's an ACP project with version
+
+### Example 3: Project Not Found
+
+**Context**: Trying to view info for non-existent project
+
+**Invocation**: `@acp.project-info nonexistent-project`
+
+**Result**: Error message with list of available projects
+
+### Example 4: Project Directory Missing
+
+**Context**: Project in registry but directory deleted
+
+**Invocation**: `@acp.project-info old-project`
+
+**Result**: Shows metadata but warns that directory doesn't exist
+
+---
+
+## Related Commands
+
+- [`@acp.project-list`](acp.project-list.md) - List all projects in registry
+- [`@acp.project-set`](acp.project-set.md) - Switch to a project
+- [`@acp.project-update`](acp.project-update.md) - Update project metadata
+- [`@acp.projects-sync`](acp.projects-sync.md) - Sync registry with filesystem
+- [`@acp.projects-restore`](acp.projects-restore.md) - Restore projects from git origins
+
+---
+
+## 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, or use `@acp.projects-sync` to discover unregistered projects
+
+### Issue 3: Directory not found
+
+**Symptom**: Warning "Project directory not found"
+
+**Cause**: Project directory was moved or deleted
+
+**Solution**: Either restore the directory, update the path with `@acp.project-update`, or remove the project with `@acp.project-remove`
+
+### Issue 4: No metadata displayed
+
+**Symptom**: Some fields show as empty or "null"
+
+**Cause**: Optional fields not set in registry
+
+**Solution**: This is normal for optional fields (tags, related_projects, dependencies). Use `@acp.project-update` to add metadata.
+
+---
+
+## Security Considerations
+
+### File Access
+- **Reads**: `~/.acp/projects.yaml` (project registry), project directory for AGENT.md and progress.yaml
+- **Writes**: None (read-only command)
+- **Executes**: None
+
+### Network Access
+- **APIs**: None
+- **Repositories**: None
+
+### Sensitive Data
+- **Secrets**: Does not access any secrets or credentials
+- **Credentials**: Does not access credentials
+
+---
+
+## Notes
+
+- This is a read-only command - it doesn't modify the registry
+- Expands tilde (~) in project paths automatically
+- Checks if project directory exists on filesystem
+- Detects ACP projects by presence of AGENT.md
+- Tries to read project version from progress.yaml
+- Shows current project indicator (⭐) if applicable
+- Handles missing optional fields gracefully
+- Part of Milestone 7 (Global ACP Project Registry)
+- Marked as Experimental until M7 is complete
+
+---
+
+**Namespace**: acp
+**Command**: project-info
+**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.project-list.md

@@ -0,0 +1,226 @@
+# Command: project-list
+
+> **🤖 Agent Directive**: If you are reading this file, the command `@acp.project-list` has been invoked. Follow the steps below to execute this command.
+> Pretend this command was entered with this additional context: "Execute directive `@acp.project-list` 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-23
+**Last Updated**: 2026-02-23
+**Status**: Experimental
+**Scripts**: acp.project-list.sh, acp.common.sh, acp.yaml-parser.sh
+
+---
+
+**Purpose**: List all projects registered in global workspace
+**Category**: Utility
+**Frequency**: As Needed
+
+---
+
+## What This Command Does
+
+Lists all projects registered in `~/.acp/projects.yaml` with their metadata. Shows project type, status, description, git origin (when available), and last accessed time. Highlights the current active project with a ⭐ marker.
+
+**Key Distinction**: This command lists projects IN the registry. Use `@acp.projects-sync` to discover projects NOT YET registered.
+
+---
+
+## Prerequisites
+
+- [ ] Global ACP initialized (`~/.acp/` exists)
+- [ ] Projects registry exists (`~/.acp/projects.yaml`)
+- [ ] At least one project registered
+
+---
+
+## Steps
+
+### 1. Run Shell Script
+
+Execute the project list script with optional filters.
+
+**Actions**:
+- Run `./agent/scripts/acp.project-list.sh`
+- Pass filter arguments if needed
+- Script reads `~/.acp/projects.yaml`
+- Displays formatted project list
+
+**Expected Outcome**: Project list displayed
+
+### 2. Review Output
+
+Examine the project list and identify projects of interest.
+
+**Actions**:
+- Note current project (marked with ⭐)
+- Review project types and statuses
+- Check last accessed timestamps
+- Identify projects to switch to or investigate
+
+**Expected Outcome**: Projects understood
+
+---
+
+## Verification
+
+- [ ] Script executed successfully
+- [ ] Projects displayed with correct formatting
+- [ ] Current project marked with ⭐
+- [ ] Filtering works correctly (if used)
+- [ ] No errors encountered
+
+---
+
+## Arguments
+
+### Optional Filters
+
+- `--type <type>` - Filter by project type (e.g., `mcp-server`, `web-app`, `cli-tool`)
+- `--status <status>` - Filter by status (`active`, `archived`, `paused`)
+- `--tags <tag1,tag2>` - Filter by tags (comma-separated) [Not yet implemented]
+
+---
+
+## Expected Output
+
+### Console Output (No Projects)
+```
+📁 Projects in ~/.acp/projects/
+
+No projects registered yet
+
+Create projects with: @acp.project-create
+```
+
+### Console Output (With Projects)
+```
+📁 Projects in ~/.acp/projects/
+
+remember-mcp-server (mcp-server) - active ⭐ Current
+  Multi-tenant memory system with vector search
+  Last accessed: 2026-02-23T07:45:00Z
+
+agentbase-mcp-server (mcp-server) - active
+  Agent base server implementation
+  Last accessed: 2026-02-22T16:00:00Z
+
+my-web-app (web-app) - paused
+  Personal portfolio website
+  Last accessed: 2026-02-20T14:30:00Z
+
+Showing 3 of 3 projects
+```
+
+### Console Output (With Filters)
+```bash
+# Filter by type
+./agent/scripts/acp.project-list.sh --type mcp-server
+
+📁 Projects in ~/.acp/projects/
+
+remember-mcp-server (mcp-server) - active ⭐ Current
+  Multi-tenant memory system with vector search
+  Last accessed: 2026-02-23T07:45:00Z
+
+agentbase-mcp-server (mcp-server) - active
+  Agent base server implementation
+  Last accessed: 2026-02-22T16:00:00Z
+
+Showing 2 of 3 projects
+```
+
+---
+
+## Examples
+
+### Example 1: List All Projects
+
+**Context**: Want to see all registered projects
+
+**Invocation**: `@acp.project-list`
+
+**Result**: Displays all projects with metadata, current project marked
+
+### Example 2: Filter by Type
+
+**Context**: Only want to see MCP server projects
+
+**Invocation**: `@acp.project-list --type mcp-server`
+
+**Result**: Displays only MCP server projects
+
+### Example 3: Filter by Status
+
+**Context**: Only want to see active projects
+
+**Invocation**: `@acp.project-list --status active`
+
+**Result**: Displays only active projects (excludes archived/paused)
+
+### Example 4: Empty Registry
+
+**Context**: No projects registered yet
+
+**Invocation**: `@acp.project-list`
+
+**Result**: Helpful message suggesting to create projects
+
+---
+
+## Related Commands
+
+- [`@acp.project-create`](acp.project-create.md) - Create new project
+- [`@acp.project-set`](acp.project-set.md) - Switch to project
+- [`@acp.projects-sync`](acp.projects-sync.md) - Discover unregistered projects
+- [`@acp.project-info`](acp.project-info.md) - Show project details
+- [`@acp.projects-restore`](acp.projects-restore.md) - Restore projects from git origins
+
+---
+
+## Troubleshooting
+
+### Issue 1: No registry found
+
+**Symptom**: "No projects registry found"
+
+**Cause**: Global ACP not initialized or registry not created
+
+**Solution**: Run `@acp.project-create` to create first project (auto-initializes registry)
+
+### Issue 2: No projects shown
+
+**Symptom**: "No projects registered yet"
+
+**Cause**: Registry exists but is empty
+
+**Solution**: Create projects with `@acp.project-create` or discover existing projects with `@acp.projects-sync`
+
+### Issue 3: Filters return no results
+
+**Symptom**: "No projects match filters"
+
+**Cause**: No projects match the specified filter criteria
+
+**Solution**: Remove filters or adjust filter values to match existing projects
+
+---
+
+## Notes
+
+- This command reads from the registry, not the filesystem
+- Current project is determined from `current_project` field in registry
+- Projects are displayed in the order they appear in the YAML file
+- Tag filtering is planned but not yet implemented
+- Empty registry is handled gracefully with helpful message
+
+---
+
+**Namespace**: acp
+**Command**: project-list
+**Version**: 1.0.0
+**Created**: 2026-02-23
+**Last Updated**: 2026-02-23
+**Status**: Experimental
+**Compatibility**: ACP 3.12.0+
+**Author**: ACP Project