specdrive-cli 0.1.1 → 0.1.3

package/README.md

@@ -21,6 +21,7 @@ It adds:
 - [Why SpecDrive](#why-specdrive)
 - [Prerequisites](#prerequisites)
 - [Installation](#installation)
+- [Where to Run Commands](#where-to-run-commands)
 - [Quickstart](#quickstart)
 - [Core Workflow](#core-workflow)
 - [Optional Commands](#optional-commands)
@@ -85,7 +86,16 @@ sdrive init
 This creates the `.sdrive/` folder and tool adapters.
 
 ---
+## Where to Run Commands
 
+| Command Type | Where to Run | Example |
+|--------------|--------------|---------|
+| Terminal command | In your terminal / shell | `sdrive init` |
+| Slash command | In your AI tool's chat | `/sdrive:propose "User login"` |
+
+**Rule:** If it starts with `sdrive`, run it in the terminal. If it starts with `/sdrive:`, run it in your AI chat.
+
+---
 ## Quickstart
 
 1. Initialize the project:
@@ -327,6 +337,10 @@ Audits and manages AI skills.
 | `sdrive status` | Show feature lifecycle state |
 | `sdrive approve <gate>` | Approve a workflow gate |
 | `sdrive create <feature>` | Create feature scaffold (internal) |
+| `sdrive team:add <username> <role>` | Add a new team member |
+| `sdrive team:remove <username>` | Remove a team member |
+| `sdrive team:list` | List all team members |
+| `sdrive team:update <username> <role>` | Update a member's role |
 
 ---
 
@@ -428,13 +442,29 @@ jobs:
 | Cursor | `.cursor/rules/sdrive.md` |
 | VS Code | `.vscode/sdrive-commands.json` |
 
-Run the generator:
+```
+
+---
+
+## Team Collaboration
+
+SpecDrive supports team roles.
+
+| Role | Can approve | Can implement |
+|------|-------------|---------------|
+| admin | ✅ | ✅ |
+| reviewer | ✅ | ❌ |
+| developer | ❌ | ✅ |
+
+Manage team:
 
 ```bash
-node .sdrive/scripts/generate-adapters.js
+sdrive team:add alice admin
+sdrive team:list
+sdrive team:update bob reviewer
+sdrive team:remove carol
 ```
 
----
 
 ## Contributing
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specdrive-cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "SpecDrive enterprise spec-driven development CLI",
   "bin": {
     "sdrive": "src/index.js"

package/src/index.js

@@ -20,7 +20,6 @@ program
     const projectRoot = process.cwd();
     const sdriveRoot = path.join(projectRoot, ".sdrive");
 
-    // Create .sdrive directory structure
     const dirs = [
       path.join(sdriveRoot, "agents"),
       path.join(sdriveRoot, "commands"),
@@ -44,21 +43,18 @@ program
       console.log(`  Created: ${path.relative(projectRoot, dir)}`);
     });
 
-    // Create workflow-state.json if missing
     const workflowStatePath = path.join(sdriveRoot, "workflow-state.json");
     if (!fs.existsSync(workflowStatePath)) {
       fs.writeFileSync(workflowStatePath, JSON.stringify({ features: [] }, null, 2));
       console.log("  Created: .sdrive/workflow-state.json");
     }
 
-    // Create constitution.md if missing
     const constitutionPath = path.join(sdriveRoot, "constitution.md");
     if (!fs.existsSync(constitutionPath)) {
       fs.writeFileSync(constitutionPath, "# SpecDrive Constitution\n\nInitialized by `sdrive init`.\n");
       console.log("  Created: .sdrive/constitution.md");
     }
 
-    // Generate tool adapters
     const generatorPath = path.join(sdriveRoot, "scripts", "generate-adapters.js");
     if (fs.existsSync(generatorPath)) {
       try {
@@ -232,4 +228,111 @@ program
     console.log(`✅ Gate "${gate}" approved for feature "${feature.name}".`);
   });
 
+// ---------- TEAM COMMANDS ----------
+
+program
+  .command("team:add <username> <role>")
+  .description("Add a new team member")
+  .action((username, role) => {
+    const teamPath = path.join(process.cwd(), ".sdrive", "team.json");
+
+    if (!fs.existsSync(teamPath)) {
+      console.error("❌ team.json not found. Run `sdrive init` first.");
+      process.exit(1);
+    }
+
+    const team = JSON.parse(fs.readFileSync(teamPath, "utf8"));
+
+    if (!team.members) {
+      team.members = [];
+    }
+
+    const existing = team.members.find((m) => m.username === username);
+    if (existing) {
+      console.error(`❌ User "${username}" already exists. Use team:update to change role.`);
+      process.exit(1);
+    }
+
+    team.members.push({ username, role });
+    fs.writeFileSync(teamPath, JSON.stringify(team, null, 2));
+
+    console.log(`✅ Added ${username} as ${role}.`);
+  });
+
+program
+  .command("team:remove <username>")
+  .description("Remove a team member")
+  .action((username) => {
+    const teamPath = path.join(process.cwd(), ".sdrive", "team.json");
+
+    if (!fs.existsSync(teamPath)) {
+      console.error("❌ team.json not found. Run `sdrive init` first.");
+      process.exit(1);
+    }
+
+    const team = JSON.parse(fs.readFileSync(teamPath, "utf8"));
+
+    const before = team.members?.length || 0;
+    team.members = (team.members || []).filter((m) => m.username !== username);
+    const after = team.members.length;
+
+    if (before === after) {
+      console.error(`❌ User "${username}" not found.`);
+      process.exit(1);
+    }
+
+    fs.writeFileSync(teamPath, JSON.stringify(team, null, 2));
+    console.log(`✅ Removed ${username}.`);
+  });
+
+program
+  .command("team:list")
+  .description("List all team members")
+  .action(() => {
+    const teamPath = path.join(process.cwd(), ".sdrive", "team.json");
+
+    if (!fs.existsSync(teamPath)) {
+      console.error("❌ team.json not found. Run `sdrive init` first.");
+      process.exit(1);
+    }
+
+    const team = JSON.parse(fs.readFileSync(teamPath, "utf8"));
+
+    if (!team.members || team.members.length === 0) {
+      console.log("No team members found.");
+      return;
+    }
+
+    console.log("\nSpecDrive Team Members\n");
+    team.members.forEach((m) => {
+      console.log(`👤 ${m.username} — ${m.role}`);
+    });
+  });
+
+program
+  .command("team:update <username> <role>")
+  .description("Update a team member's role")
+  .action((username, role) => {
+    const teamPath = path.join(process.cwd(), ".sdrive", "team.json");
+
+    if (!fs.existsSync(teamPath)) {
+      console.error("❌ team.json not found. Run `sdrive init` first.");
+      process.exit(1);
+    }
+
+    const team = JSON.parse(fs.readFileSync(teamPath, "utf8"));
+
+    const member = team.members?.find((m) => m.username === username);
+
+    if (!member) {
+      console.error(`❌ User "${username}" not found.`);
+      process.exit(1);
+    }
+
+    member.role = role;
+    fs.writeFileSync(teamPath, JSON.stringify(team, null, 2));
+
+    console.log(`✅ Updated ${username} to ${role}.`);
+  });
+
 program.parse(process.argv);