specdrive-cli 0.1.10 → 0.1.12

package/dashboard/style.css

@@ -0,0 +1,157 @@
+* {
+  box-sizing: border-box;
+}
+
+body {
+  font-family: system-ui, sans-serif;
+  margin: 0;
+  padding: 0;
+  background: #f5f5f5;
+  color: #222;
+}
+
+header {
+  background: #111;
+  color: #fff;
+  padding: 20px;
+}
+
+header h1 {
+  margin: 0;
+  font-size: 20px;
+}
+
+main {
+  padding: 20px;
+  max-width: 900px;
+  margin: 0 auto;
+}
+
+section {
+  background: #fff;
+  padding: 20px;
+  margin-bottom: 20px;
+  border-radius: 8px;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.08);
+}
+
+h2 {
+  margin-top: 0;
+  font-size: 16px;
+  color: #333;
+}
+
+#feature-filters {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  align-items: center;
+}
+
+#feature-filters input[type="text"] {
+  flex: 1 1 200px;
+  min-width: 160px;
+}
+
+#feature-filters select {
+  flex: 0 0 auto;
+}
+
+#feature-filters label {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  color: #444;
+}
+
+.feature {
+  padding: 12px;
+  border-bottom: 1px solid #eee;
+}
+
+.feature:last-child {
+  border-bottom: none;
+}
+
+.feature-name {
+  font-weight: bold;
+}
+
+.feature-branch {
+  font-size: 12px;
+  color: #666;
+  margin: 4px 0 8px;
+}
+
+.gate {
+  display: inline-block;
+  margin-right: 8px;
+  font-size: 12px;
+  padding: 2px 6px;
+  border-radius: 4px;
+  background: #eee;
+}
+
+.gate.approved {
+  background: #c8f7c5;
+  color: #2b6b25;
+}
+
+.gate.pending {
+  background: #f9e0a0;
+  color: #7a5b1a;
+}
+
+.gate.in_progress {
+  background: #cce4ff;
+  color: #1f4d80;
+}
+
+.member {
+  padding: 6px 0;
+}
+
+.audit-event {
+  padding: 6px 0;
+  font-size: 13px;
+  color: #555;
+  border-bottom: 1px solid #eee;
+}
+
+.traceability {
+  margin-top: 8px;
+  font-size: 13px;
+  color: #444;
+}
+
+.feature-version {
+  margin-top: 16px;
+  padding-top: 12px;
+  border-top: 1px solid #eee;
+}
+
+.feature-version:first-of-type {
+  border-top: none;
+  padding-top: 0;
+}
+
+.onboarding {
+  background: #fff;
+  border-radius: 8px;
+}
+
+.onboarding h2 {
+  margin-top: 0;
+  font-size: 16px;
+}
+
+.onboarding ul {
+  margin: 4px 0 0 20px;
+  padding: 0;
+  font-size: 13px;
+  color: #444;
+}
+
+.onboarding li {
+  margin-bottom: 2px;
+}

package/mcp/mcp.json

@@ -0,0 +1,31 @@
+{
+  "name": "specdrive",
+  "version": "1.0.0",
+  "description": "SpecDrive MCP server",
+  "methods": [
+    {
+      "name": "specdrive.list_features",
+      "description": "List all SpecDrive features"
+    },
+    {
+      "name": "specdrive.get_feature",
+      "description": "Get details of a feature"
+    },
+    {
+      "name": "specdrive.get_spec",
+      "description": "Get the spec.json of a feature"
+    },
+    {
+      "name": "specdrive.get_traceability",
+      "description": "Get the traceability matrix of a feature"
+    },
+    {
+      "name": "specdrive.validate",
+      "description": "Run the governance validator"
+    },
+    {
+      "name": "specdrive.status",
+      "description": "Show SpecDrive status summary"
+    }
+  ]
+}

package/mcp/server.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+const projectRoot = process.cwd();
+
+function loadWorkflowState() {
+  const statePath = path.join(projectRoot, ".sdrive", "workflow-state.json");
+
+  if (!fs.existsSync(statePath)) {
+    return { features: [] };
+  }
+
+  return JSON.parse(fs.readFileSync(statePath, "utf8"));
+}
+
+function listFeatures() {
+  const state = loadWorkflowState();
+  return state.features || [];
+}
+
+function getFeature(name) {
+  const features = listFeatures();
+  return features.find((f) => f.name === name);
+}
+
+function getSpec(name) {
+  const specPath = path.join(projectRoot, ".sdrive", "governance", name, "spec.json");
+
+  if (!fs.existsSync(specPath)) {
+    return null;
+  }
+
+  return JSON.parse(fs.readFileSync(specPath, "utf8"));
+}
+
+function getTraceability(name) {
+  const tracePath = path.join(projectRoot, ".sdrive", "governance", name, "traceability.json");
+
+  if (!fs.existsSync(tracePath)) {
+    return null;
+  }
+
+  return JSON.parse(fs.readFileSync(tracePath, "utf8"));
+}
+
+function runValidator() {
+  const { execSync } = require("child_process");
+  const validatorPath = path.join(projectRoot, ".sdrive", "scripts", "validate-governance.js");
+
+  try {
+    execSync(`node "${validatorPath}"`, { stdio: "pipe" });
+    return { success: true };
+  } catch (error) {
+    return { success: false, message: error.message };
+  }
+}
+
+// ---------- MCP handlers ----------
+
+const handlers = {
+  "specdrive.list_features": () => {
+    return { features: listFeatures() };
+  },
+  "specdrive.get_feature": ({ name }) => {
+    return { feature: getFeature(name) };
+  },
+  "specdrive.get_spec": ({ name }) => {
+    return { spec: getSpec(name) };
+  },
+  "specdrive.get_traceability": ({ name }) => {
+    return { traceability: getTraceability(name) };
+  },
+  "specdrive.validate": () => {
+    return runValidator();
+  },
+  "specdrive.status": () => {
+    const features = listFeatures();
+    return {
+      count: features.length,
+      features: features.map((f) => ({
+        name: f.name,
+        phase: f.phase,
+        currentStep: f.currentStep
+      }))
+    };
+  }
+};
+
+// ---------- CLI entry point ----------
+
+const input = process.argv[2] ? JSON.parse(process.argv[2]) : null;
+
+if (!input) {
+  console.error("❌ Usage: node server.js '{\"method\": \"specdrive.list_features\"}'");
+  process.exit(1);
+}
+
+const handler = handlers[input.method];
+
+if (!handler) {
+  console.error(`❌ Unknown MCP method: ${input.method}`);
+  process.exit(1);
+}
+
+const result = handler(input.params || {});
+console.log(JSON.stringify(result, null, 2));

package/package.json

@@ -1,32 +1,35 @@
-{
-  "name": "specdrive-cli",
-  "version": "0.1.10",
-  "description": "SpecDrive enterprise spec-driven development CLI",
-  "bin": {
-    "sdrive": "src/index.js"
-  },
-  "main": "src/index.js",
-  "files": [
-    "src/",
-    "scripts/",
-    "commands/",
-    "schemas/",
-    "agents/",
-    "README.md"
-  ],
-  "dependencies": {
-    "commander": "^12.0.0",
-    "ajv": "^8.12.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "keywords": [
-    "spec-driven",
-    "ai",
-    "governance",
-    "cli",
-    "specflow"
-  ],
-  "license": "MIT"
-}
+{
+  "name": "specdrive-cli",
+  "version": "0.1.12",
+  "description": "SpecDrive enterprise spec-driven development CLI",
+  "bin": {
+    "sdrive": "src/index.js"
+  },
+  "main": "src/index.js",
+  "files": [
+    "src/",
+    "scripts/",
+    "commands/",
+    "schemas/",
+    "agents/",
+    "dashboard/",
+    "mcp/",
+    "templates/",
+    "README.md"
+  ],
+  "dependencies": {
+    "commander": "^12.0.0",
+    "ajv": "^8.12.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "spec-driven",
+    "ai",
+    "governance",
+    "cli",
+    "specflow"
+  ],
+  "license": "MIT"
+}

package/schemas/config.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "SpecDrive Config",
+  "type": "object",
+  "properties": {
+    "defaultTemplate": {
+      "type": "string",
+      "enum": [
+        "generic",
+        "react-node",
+        "nextjs",
+        "expo",
+        "fastapi",
+        "turborepo"
+      ]
+    }
+  },
+  "required": ["defaultTemplate"],
+  "additionalProperties": false
+}

package/schemas/workflow-state.schema.json

@@ -12,61 +12,172 @@
             "type": "string",
             "pattern": "^[a-z0-9-]+$"
           },
-          "phase": {
-            "enum": ["backlog", "ongoing", "completed", "blocked"]
-          },
-          "currentStep": {
-            "enum": ["specification", "planning", "implementation", "review"]
-          },
           "branch": {
             "type": "string"
           },
-          "gates": {
-            "type": "object",
-            "properties": {
-              "specification": {
-                "enum": ["pending", "approved", "rejected"]
-              },
-              "planning": {
-                "enum": ["pending", "approved", "rejected"]
-              },
-              "implementation": {
-                "enum": ["pending", "in_progress", "approved", "rejected"]
-              },
-              "review": {
-                "enum": ["pending", "approved", "rejected"]
-              }
-            },
-            "required": [
-              "specification",
-              "planning",
-              "implementation",
-              "review"
-            ]
+          "currentVersion": {
+            "type": "string",
+            "pattern": "^v[0-9]+$"
           },
-          "history": {
+          "versions": {
             "type": "array",
+            "minItems": 1,
             "items": {
               "type": "object",
               "properties": {
-                "event": {
+                "id": {
                   "type": "string",
-                  "minLength": 3
+                  "pattern": "^v[0-9]+$"
                 },
-                "by": {
-                  "type": "string"
+                "phase": {
+                  "enum": ["backlog", "ongoing", "completed", "blocked"]
                 },
-                "timestamp": {
-                  "type": "string",
-                  "format": "date-time"
+                "currentStep": {
+                  "enum": ["specification", "planning", "implementation", "review"]
+                },
+                "gates": {
+                  "type": "object",
+                  "properties": {
+                    "specification": {
+                      "enum": ["pending", "approved", "rejected"]
+                    },
+                    "planning": {
+                      "enum": ["pending", "approved", "rejected"]
+                    },
+                    "implementation": {
+                      "enum": ["pending", "in_progress", "approved", "rejected"]
+                    },
+                    "review": {
+                      "enum": ["pending", "approved", "rejected"]
+                    }
+                  },
+                  "required": [
+                    "specification",
+                    "planning",
+                    "implementation",
+                    "review"
+                  ]
+                },
+                "history": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "event": {
+                        "type": "string",
+                        "minLength": 3
+                      },
+                      "by": {
+                        "type": "string"
+                      },
+                      "timestamp": {
+                        "type": "string",
+                        "format": "date-time"
+                      }
+                    },
+                    "required": ["event", "timestamp"]
+                  }
                 }
               },
-              "required": ["event", "timestamp"]
+              "required": ["id", "phase", "currentStep", "gates"]
             }
           }
         },
-        "required": ["name", "phase", "currentStep", "gates"]
+        "required": ["name", "currentVersion", "versions"]
       }
+    },
+    "onboarding": {
+      "type": "object",
+      "properties": {
+        "mode": {
+          "enum": ["greenfield", "brownfield"]
+        },
+        "date": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "detectedSystems": {
+          "type": "object",
+          "properties": {
+            "openspec": {
+              "type": "object",
+              "properties": {
+                "detected": { "type": "boolean" },
+                "specs": { "type": "integer" },
+                "changes": { "type": "integer" },
+                "archived": { "type": "integer" }
+              },
+              "required": ["detected"],
+              "additionalProperties": false
+            },
+            "speckit": {
+              "type": "object",
+              "properties": {
+                "detected": { "type": "boolean" },
+                "specs": { "type": "integer" },
+                "hasConstitution": { "type": "boolean" }
+              },
+              "required": ["detected"],
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        },
+        "missing": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "deferred": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "retroactiveFeatures": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "verifiedFeatures": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "migrated": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "feature": { "type": "string" },
+              "from": {
+                "enum": ["openspec", "speckit", "other"]
+              },
+              "date": {
+                "type": "string",
+                "format": "date-time"
+              },
+              "source": { "type": "string" }
+            },
+            "required": ["feature", "from", "date"],
+            "additionalProperties": false
+          }
+        },
+        "skipped": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "system": {
+                "enum": ["openspec", "speckit", "other"]
+              },
+              "reason": { "type": "string" }
+            },
+            "required": ["system"],
+            "additionalProperties": false
+          }
+        },
+        "notes": {
+          "type": "string"
+        }
+      },
+      "required": ["mode", "date"],
+      "additionalProperties": false
     }
   },
   "required": ["features"],