Initial commit

commands/project-maps-list.md

@@ -0,0 +1,120 @@
+# Project Maps List Command
+
+List all projects with generated context maps.
+
+## Usage
+
+```
+/project-maps-list
+```
+
+## Implementation
+
+### Step 1: Scan Maps Directory
+
+List all subdirectories in the maps storage:
+
+```bash
+ls -d ~/.claude/project-maps/*/ 2>/dev/null
+```
+
+Each subdirectory represents a project hash.
+
+### Step 2: Load Summary for Each Project
+
+For each project hash, load the summary.json to get project details:
+
+```javascript
+const fs = require('fs').promises;
+const path = require('path');
+const MapLoader = require('./map-loader');
+
+const mapsBaseDir = path.join(process.env.HOME, '.claude/project-maps');
+const projectDirs = await fs.readdir(mapsBaseDir);
+
+for (const hash of projectDirs) {
+  if (hash === 'maps' || hash === 'schemas' || hash === 'temp') continue;
+
+  try {
+    const summaryPath = path.join(mapsBaseDir, hash, 'summary.json');
+    const summary = await loadSummary(summaryPath);
+    // Display project info
+  } catch (error) {
+    // Skip invalid projects
+  }
+}
+```
+
+### Step 3: Display Projects List
+
+Show all projects with their metadata:
+
+```
+Project Maps
+
+Found {count} projects with generated maps:
+
+1. {project_name}
+   Path: {project_path}
+   Hash: {project_hash}
+   Files: {file_count}
+   Generated: {timestamp}
+   Staleness: {score}/100 ({level})
+   Size: {total_size}
+
+2. {project_name}
+   Path: {project_path}
+   Hash: {project_hash}
+   Files: {file_count}
+   Generated: {timestamp}
+   Staleness: {score}/100 ({level})
+   Size: {total_size}
+
+Total storage: {total_storage_size}
+
+Commands:
+  • Load project: /project-maps-load
+  • Refresh: /project-maps-refresh
+  • Generate new: /project-maps-generate
+```
+
+### Step 4: Highlight Stale Projects
+
+Mark projects that need refresh:
+
+```
+⚠️  The following projects may need refresh:
+  • {project_name} - Staleness: {score}/100
+  • {project_name} - Staleness: {score}/100
+
+Run: /project-maps-refresh to update
+```
+
+## Error Handling
+
+**No maps found:**
+```
+No project maps found
+
+Storage location: ~/.claude/project-maps/
+
+Generate maps for current project:
+  /project-maps-generate
+```
+
+**Corrupt project data:**
+```
+⚠️  Found {count} projects, but {error_count} have corrupt data:
+  • {hash} - Cannot read summary
+  • {hash} - Missing metadata
+
+Consider removing corrupt entries:
+  rm -rf ~/.claude/project-maps/{hash}
+```
+
+## Examples
+
+```bash
+# List all projects with maps
+/project-maps-list
+```