specdrive-cli 0.1.2 → 0.1.8

package/README.md

@@ -1,3 +1,5 @@
+
+```markdown
 # SpecDrive
 
 **Enterprise Spec-Driven Development for AI Coding Tools**
@@ -21,6 +23,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)
@@ -30,6 +33,7 @@ It adds:
 - [Validation](#validation)
 - [CI/CD Integration](#cicd-integration)
 - [Tool Support](#tool-support)
+- [Team Collaboration](#team-collaboration)
 - [Contributing](#contributing)
 - [License](#license)
 
@@ -82,7 +86,20 @@ Inside your project root, run:
 sdrive init
 ```
 
-This creates the `.sdrive/` folder and tool adapters.
+SpecDrive will ask you to select which AI tools you use.
+
+It then creates the `.sdrive/` folder and tool adapters for the selected tools.
+
+---
+
+## 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.
 
 ---
 
@@ -424,6 +441,8 @@ jobs:
 
 ## Tool Support
 
+SpecDrive supports 15 AI tools.
+
 | Tool | Adapter |
 |------|---------|
 | GitHub Copilot | `.github/copilot-instructions.md` |
@@ -431,8 +450,20 @@ jobs:
 | Claude Code | `.claude/commands/sdrive.md` |
 | Cursor | `.cursor/rules/sdrive.md` |
 | VS Code | `.vscode/sdrive-commands.json` |
+| Amazon Q Developer | `.amazonq/rules/sdrive.md` |
+| Gemini CLI | `.gemini/commands/sdrive.md` |
+| Continue | `.continue/rules/sdrive.md` |
+| Codex | `.codex/rules/sdrive.md` |
+| Windsurf | `.windsurf/rules/sdrive.md` |
+| Kilo Code | `.kilocode/rules/sdrive.md` |
+| OpenCode | `.opencode/rules/sdrive.md` |
+| Qoder | `.qoder/rules/sdrive.md` |
+| Qwen Code | `.qwen/rules/sdrive.md` |
+| Rovo Dev CLI | `.rovo/rules/sdrive.md` |
 
-```
+Adapters are generated automatically when you run `sdrive init`.
+
+During initialization, you select which tools you use. Only selected tools get adapters.
 
 ---
 
@@ -455,6 +486,7 @@ sdrive team:update bob reviewer
 sdrive team:remove carol
 ```
 
+---
 
 ## Contributing
 
@@ -471,15 +503,4 @@ MIT
 
 ---
 
-This is now a complete, professional README with:
-
-- Table of contents
-- Installation steps
-- Core workflow in correct order
-- Detailed optional commands
-- Agent reference
-- Directory structure
-- Validation and CI/CD sections
-- Tool support
-
-You can now save it as `README.md`.
+This README is now clean and correct.

package/commands/gates.js

@@ -7,7 +7,7 @@ function getWorkflowState() {
   const workflowStatePath = path.join(projectRoot, ".sdrive", "workflow-state.json");
 
   if (!fs.existsSync(workflowStatePath)) {
-    console.error("❌ workflow-state.json not found.");
+    console.error("❌ workflow-state.json not found. Run `sdrive init` first.");
     process.exit(1);
   }
 
@@ -19,14 +19,28 @@ function saveWorkflowState(state) {
   fs.writeFileSync(workflowStatePath, JSON.stringify(state, null, 2));
 }
 
-function approveGate(featureName, gate) {
+function getFeature(featureName) {
   const state = getWorkflowState();
+  return state.features?.find((f) => f.name === featureName);
+}
+
+function gateStatus(featureName, gate) {
+  const feature = getFeature(featureName);
 
-  const feature = state.features?.find((f) => f.name === featureName);
+  if (!feature) {
+    return "unknown";
+  }
+
+  return feature.gates?.[gate] || "pending";
+}
+
+function approveGate(featureName, gate) {
+  const state = getWorkflowState();
+  const feature = getFeature(featureName);
 
   if (!feature) {
     console.error(`❌ Feature "${featureName}" not found.`);
-    process.exit(1);
+    return false;
   }
 
   if (!feature.gates) {
@@ -43,22 +57,18 @@ function approveGate(featureName, gate) {
 
   saveWorkflowState(state);
   console.log(`✅ Gate "${gate}" approved for feature "${featureName}".`);
+  return true;
 }
 
-function gateStatus(featureName, gate) {
-  const state = getWorkflowState();
-  const feature = state.features?.find((f) => f.name === featureName);
-
-  if (!feature) {
-    return "unknown";
-  }
-
-  return feature.gates?.[gate] || "pending";
+function isGateApproved(featureName, gate) {
+  return gateStatus(featureName, gate) === "approved";
 }
 
 module.exports = {
-  approveGate,
-  gateStatus,
   getWorkflowState,
-  saveWorkflowState
+  saveWorkflowState,
+  getFeature,
+  gateStatus,
+  approveGate,
+  isGateApproved
 };

package/commands/router.js

@@ -3,7 +3,7 @@
 const fs = require("fs");
 const path = require("path");
 const { execSync } = require("child_process");
-const { getWorkflowState, saveWorkflowState } = require("./gates");
+const { getWorkflowState, saveWorkflowState, isGateApproved } = require("./gates");
 
 const projectRoot = process.cwd();
 
@@ -55,44 +55,6 @@ function runValidators(validators) {
   }
 }
 
-function checkGate(featureName, gate) {
-  const state = getWorkflowState();
-  const feature = state.features?.find((f) => f.name === featureName);
-
-  if (!feature) {
-    console.error(`❌ Feature "${featureName}" not found.`);
-    return false;
-  }
-
-  return feature.gates?.[gate] === "approved";
-}
-
-function approveGate(featureName, gate) {
-  const state = getWorkflowState();
-  const feature = state.features?.find((f) => f.name === featureName);
-
-  if (!feature) {
-    console.error(`❌ Feature "${featureName}" not found.`);
-    return false;
-  }
-
-  if (!feature.gates) {
-    feature.gates = {};
-  }
-
-  feature.gates[gate] = "approved";
-
-  feature.history = feature.history || [];
-  feature.history.push({
-    event: `${gate}_approved`,
-    timestamp: new Date().toISOString()
-  });
-
-  saveWorkflowState(state);
-  console.log(`✅ Gate "${gate}" approved for feature "${featureName}".`);
-  return true;
-}
-
 function toKebabCase(text) {
   return text
     .toLowerCase()
@@ -129,7 +91,6 @@ function main() {
   console.log(`📁 Agent File: ${command.agentFile}`);
   console.log(`📝 Description: ${command.description}`);
 
-  // Gate enforcement
   if (command.gates && command.gates.length > 0) {
     if (!featureName) {
       console.error(`❌ This command requires a feature name or description.`);
@@ -140,7 +101,7 @@ function main() {
     console.log(`\n🚧 Required Gates: ${command.gates.join(", ")}`);
 
     for (const gate of command.gates) {
-      if (!checkGate(featureName, gate)) {
+      if (!isGateApproved(featureName, gate)) {
         console.log(`\n⏸️  Gate "${gate}" is NOT approved for "${featureName}".`);
         console.log(`   Please approve this gate before running this command.`);
         console.log(`   Use: sdrive approve ${gate}\n`);

package/commands/tools.json

@@ -1,25 +1,20 @@
 {
   "version": "1.0.0",
   "tools": [
-    {
-      "name": "github-copilot",
-      "adapterPath": ".github/copilot-instructions.md"
-    },
-    {
-      "name": "cline",
-      "adapterPath": ".clinerules/sdrive.md"
-    },
-    {
-      "name": "claude-code",
-      "adapterPath": ".claude/commands/sdrive.md"
-    },
-    {
-      "name": "cursor",
-      "adapterPath": ".cursor/rules/sdrive.md"
-    },
-    {
-      "name": "vscode-native",
-      "adapterPath": ".vscode/sdrive-commands.json"
-    }
+    { "name": "github-copilot", "adapterPath": ".github/copilot-instructions.md" },
+    { "name": "cline", "adapterPath": ".clinerules/sdrive.md" },
+    { "name": "claude-code", "adapterPath": ".claude/commands/sdrive.md" },
+    { "name": "cursor", "adapterPath": ".cursor/rules/sdrive.md" },
+    { "name": "vscode-native", "adapterPath": ".vscode/sdrive-commands.json" },
+    { "name": "amazon-q", "adapterPath": ".amazonq/rules/sdrive.md" },
+    { "name": "gemini-cli", "adapterPath": ".gemini/commands/sdrive.md" },
+    { "name": "continue", "adapterPath": ".continue/rules/sdrive.md" },
+    { "name": "codex", "adapterPath": ".codex/rules/sdrive.md" },
+    { "name": "windsurf", "adapterPath": ".windsurf/rules/sdrive.md" },
+    { "name": "kilo-code", "adapterPath": ".kilocode/rules/sdrive.md" },
+    { "name": "opencode", "adapterPath": ".opencode/rules/sdrive.md" },
+    { "name": "qoder", "adapterPath": ".qoder/rules/sdrive.md" },
+    { "name": "qwen-code", "adapterPath": ".qwen/rules/sdrive.md" },
+    { "name": "rovo-dev", "adapterPath": ".rovo/rules/sdrive.md" }
   ]
 }

package/package.json

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

package/schemas/plan.schema.json

@@ -1,28 +1,47 @@
 {
-  "": "http://json-schema.org/draft-07/schema#",
+  "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Technical Plan",
   "type": "object",
   "properties": {
-    "feature": { "type": "string", "pattern": "^[a-z0-9-]+$" },
-    "version": { "type": "integer", "minimum": 1 },
+    "feature": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$"
+    },
+    "version": {
+      "type": "integer",
+      "minimum": 1
+    },
     "architecture": {
       "type": "object",
       "properties": {
-        "approach": { "type": "string" },
+        "approach": {
+          "type": "string",
+          "minLength": 10
+        },
         "components": {
           "type": "array",
           "items": {
             "type": "object",
             "properties": {
               "name": { "type": "string" },
-              "action": { "enum": ["create", "modify", "reuse", "delete"] },
+              "action": {
+                "enum": ["create", "modify", "reuse", "delete"]
+              },
               "description": { "type": "string" }
             },
             "required": ["name", "action"]
           }
+        },
+        "referencedRequirementIds": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^(FR|NFR)-[0-9]{3}$"
+          },
+          "uniqueItems": true
         }
       },
-      "required": ["approach", "components"]
+      "required": ["approach", "components", "referencedRequirementIds"]
     },
     "dataModel": {
       "type": "object",
@@ -33,7 +52,9 @@
             "type": "object",
             "properties": {
               "name": { "type": "string" },
-              "action": { "enum": ["create", "update", "no_change", "delete"] },
+              "action": {
+                "enum": ["create", "update", "no_change", "delete"]
+              },
               "fields": {
                 "type": "array",
                 "items": {
@@ -42,7 +63,9 @@
                     "name": { "type": "string" },
                     "type": { "type": "string" },
                     "nullable": { "type": "boolean" },
-                    "action": { "enum": ["add", "modify", "remove", "no_change"] }
+                    "action": {
+                      "enum": ["add", "modify", "remove", "no_change"]
+                    }
                   },
                   "required": ["name", "type", "action"]
                 }
@@ -51,7 +74,10 @@
             "required": ["name", "action", "fields"]
           }
         },
-        "flowDescription": { "type": "string" }
+        "flowDescription": {
+          "type": "string",
+          "minLength": 10
+        }
       },
       "required": ["entities", "flowDescription"]
     },
@@ -60,30 +86,82 @@
       "items": {
         "type": "object",
         "properties": {
-          "method": { "enum": ["GET", "POST", "PUT", "DELETE", "PATCH"] },
+          "method": {
+            "enum": ["GET", "POST", "PUT", "DELETE", "PATCH"]
+          },
           "path": { "type": "string" },
-          "action": { "enum": ["create", "modify", "reuse", "delete"] },
+          "action": {
+            "enum": ["create", "modify", "reuse", "delete"]
+          },
           "authenticationRequired": { "type": "boolean" },
           "linkedRequirements": {
             "type": "array",
-            "items": { "type": "string", "pattern": "^(FR|NFR)-[0-9]{3}$" }
+            "items": {
+              "type": "string",
+              "pattern": "^(FR|NFR)-[0-9]{3}$"
+            }
           }
         },
         "required": ["method", "path", "action", "linkedRequirements"]
       }
     },
+    "securityConsiderations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "requirementId": {
+            "type": "string",
+            "pattern": "^NFR-[0-9]{3}$"
+          },
+          "description": { "type": "string" }
+        },
+        "required": ["requirementId", "description"]
+      }
+    },
+    "performanceConsiderations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "requirementId": {
+            "type": "string",
+            "pattern": "^NFR-[0-9]{3}$"
+          },
+          "strategy": { "type": "string" }
+        },
+        "required": ["requirementId", "strategy"]
+      }
+    },
     "dependencies": {
       "type": "array",
       "items": {
         "type": "object",
         "properties": {
           "name": { "type": "string" },
-          "type": { "enum": ["library", "service", "internal", "external"] },
-          "action": { "enum": ["add", "update", "remove", "no_change"] }
+          "type": {
+            "enum": ["library", "service", "internal", "external"]
+          },
+          "action": {
+            "enum": ["add", "update", "remove", "no_change"]
+          },
+          "notes": { "type": "string" }
         },
         "required": ["name", "type", "action"]
       }
+    },
+    "risks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "description": { "type": "string" },
+          "mitigation": { "type": "string" }
+        },
+        "required": ["description", "mitigation"]
+      }
     }
   },
-  "required": ["feature", "version", "architecture", "dataModel"]
-}
+  "required": ["feature", "version", "architecture", "dataModel"],
+  "additionalProperties": false
+}

package/schemas/spec.schema.json

@@ -1,16 +1,45 @@
 {
-  "": "http://json-schema.org/draft-07/schema#",
+  "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Feature Specification",
   "type": "object",
   "properties": {
-    "feature": { "type": "string", "pattern": "^[a-z0-9-]+$" },
-    "version": { "type": "integer", "minimum": 1 },
+    "feature": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$",
+      "description": "Machine-friendly feature name (kebab-case)"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 3,
+      "description": "Human-readable feature title"
+    },
+    "version": {
+      "type": "integer",
+      "minimum": 1
+    },
     "overview": {
       "type": "object",
       "properties": {
-        "problemStatement": { "type": "string" },
-        "proposedSolution": { "type": "string" },
-        "targetAudience": { "type": "string" }
+        "problemStatement": {
+          "type": "string",
+          "minLength": 10
+        },
+        "proposedSolution": {
+          "type": "string",
+          "minLength": 10
+        },
+        "targetAudience": {
+          "type": "string",
+          "minLength": 3
+        },
+        "assumptions": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "outOfScope": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
       },
       "required": ["problemStatement", "proposedSolution", "targetAudience"]
     },
@@ -20,31 +49,60 @@
       "items": {
         "type": "object",
         "properties": {
-          "id": { "type": "string", "pattern": "^US-[0-9]{3}$" },
-          "title": { "type": "string" },
+          "id": {
+            "type": "string",
+            "pattern": "^US-[0-9]{3}$"
+          },
+          "title": {
+            "type": "string",
+            "minLength": 5
+          },
+          "role": { "type": "string" },
+          "want": { "type": "string" },
+          "benefit": { "type": "string" },
           "acceptanceCriteria": {
             "type": "array",
             "minItems": 1,
             "items": {
               "type": "object",
               "properties": {
-                "id": { "type": "string", "pattern": "^AC-[0-9]{3}$" },
-                "text": { "type": "string" }
+                "id": {
+                  "type": "string",
+                  "pattern": "^AC-[0-9]{3}$"
+                },
+                "text": {
+                  "type": "string",
+                  "minLength": 10
+                }
               },
               "required": ["id", "text"]
             }
           }
         },
-        "required": ["id", "title", "acceptanceCriteria"]
+        "required": ["id", "title", "role", "want", "benefit", "acceptanceCriteria"]
       }
     },
     "functionalRequirements": {
       "type": "array",
+      "minItems": 1,
       "items": {
         "type": "object",
         "properties": {
-          "id": { "type": "string", "pattern": "^FR-[0-9]{3}$" },
-          "text": { "type": "string" }
+          "id": {
+            "type": "string",
+            "pattern": "^FR-[0-9]{3}$"
+          },
+          "text": {
+            "type": "string",
+            "minLength": 10
+          },
+          "linkedAcceptanceCriteria": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^AC-[0-9]{3}$"
+            }
+          }
         },
         "required": ["id", "text"]
       }
@@ -54,12 +112,77 @@
       "items": {
         "type": "object",
         "properties": {
-          "id": { "type": "string", "pattern": "^NFR-[0-9]{3}$" },
-          "text": { "type": "string" }
+          "id": {
+            "type": "string",
+            "pattern": "^NFR-[0-9]{3}$"
+          },
+          "text": {
+            "type": "string",
+            "minLength": 10
+          },
+          "linkedAcceptanceCriteria": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^AC-[0-9]{3}$"
+            }
+          }
         },
         "required": ["id", "text"]
       }
+    },
+    "edgeCases": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^EC-[0-9]{3}$"
+          },
+          "description": { "type": "string" },
+          "expectedBehavior": { "type": "string" }
+        },
+        "required": ["id", "description", "expectedBehavior"]
+      }
+    },
+    "dependencies": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string" },
+          "type": {
+            "enum": ["library", "service", "internal", "external"]
+          },
+          "notes": { "type": "string" }
+        },
+        "required": ["name", "type"]
+      }
+    },
+    "risks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^RISK-[0-9]{3}$"
+          },
+          "description": { "type": "string" },
+          "mitigation": { "type": "string" }
+        },
+        "required": ["id", "description", "mitigation"]
+      }
     }
   },
-  "required": ["feature", "version", "overview", "userStories"]
-}
+  "required": [
+    "feature",
+    "title",
+    "version",
+    "overview",
+    "userStories",
+    "functionalRequirements"
+  ],
+  "additionalProperties": false
+}