specdrive-cli 0.1.10 → 0.1.12

package/scripts/diff-version.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+const projectRoot = process.cwd();
+const sdriveRoot = path.join(projectRoot, ".sdrive");
+
+const featureName = process.argv[2];
+const versionA = process.argv[3];
+const versionB = process.argv[4];
+
+if (!featureName || !versionA || !versionB) {
+  console.error("❌ Usage: node diff-version.js <feature> <v1> <v2>");
+  process.exit(1);
+}
+
+function findFile(baseDir, version, fileName) {
+  const candidate = path.join(baseDir, featureName, version, fileName);
+
+  if (fs.existsSync(candidate)) {
+    return candidate;
+  }
+
+  return null;
+}
+
+function readLines(filePath) {
+  return fs.readFileSync(filePath, "utf8").split("\n");
+}
+
+function simpleDiff(oldLines, newLines) {
+  const added = [];
+  const removed = [];
+  const unchanged = [];
+
+  const oldSet = new Set(oldLines);
+  const newSet = new Set(newLines);
+
+  newLines.forEach((line) => {
+    if (oldSet.has(line)) {
+      unchanged.push(line);
+    } else {
+      added.push(line);
+    }
+  });
+
+  oldLines.forEach((line) => {
+    if (!newSet.has(line)) {
+      removed.push(line);
+    }
+  });
+
+  return { added, removed, unchanged };
+}
+
+function diffFile(fileName, label) {
+  const specA = findFile(path.join(sdriveRoot, "specs", "ongoing"), versionA, fileName);
+  const specB = findFile(path.join(sdriveRoot, "specs", "ongoing"), versionB, fileName);
+
+  if (!specA || !specB) {
+    console.log(`\n⚠️  ${label}: not both versions have this file. Skipping.`);
+    return;
+  }
+
+  const oldLines = readLines(specA);
+  const newLines = readLines(specB);
+  const { added, removed } = simpleDiff(oldLines, newLines);
+
+  console.log(`\n📄 ${label} (${versionA} → ${versionB})`);
+
+  if (added.length === 0 && removed.length === 0) {
+    console.log("   ✅ No changes.");
+    return;
+  }
+
+  if (removed.length > 0) {
+    console.log("   ❌ Removed:");
+    removed.forEach((line) => console.log(`     - ${line}`));
+  }
+
+  if (added.length > 0) {
+    console.log("   ✅ Added:");
+    added.forEach((line) => console.log(`     + ${line}`));
+  }
+}
+
+function main() {
+  console.log(`\n🔍 Diff: ${featureName} (${versionA} → ${versionB})`);
+
+  diffFile("spec.md", "Specification");
+  diffFile("plan.md", "Plan");
+  diffFile("tasks.md", "Tasks");
+}
+
+main();

package/scripts/generate-adapters.js

@@ -1,81 +1,81 @@
-const fs = require("fs");
-const path = require("path");
-
-const projectRoot = process.cwd();
-
-function loadTools() {
-  const toolsPath = path.join(projectRoot, ".sdrive", "commands", "tools.json");
-
-  if (!fs.existsSync(toolsPath)) {
-    console.error("❌ tools.json not found.");
-    process.exit(1);
-  }
-
-  return JSON.parse(fs.readFileSync(toolsPath, "utf8")).tools;
-}
-
-function adapterContent(toolName) {
-  return `# SpecDrive Commands
-
-This project uses SpecDrive for spec-driven development.
-
-## How to use
-
-When the user types a /sdrive:* command, follow these steps:
-
-1. Read .sdrive/commands/manifest.json
-2. Find the matching command
-3. Read the agent file listed in agentFile
-4. Follow that agent's instructions exactly
-5. Run validators after writing files
-6. Stop at human approval gates
-
-Always read the manifest first. Never hardcode the command list.
-`;
-}
-
-function generateForTools(tools) {
-  tools.forEach((tool) => {
-    const adapterFullPath = path.join(projectRoot, tool.adapterPath);
-    const adapterDir = path.dirname(adapterFullPath);
-
-    if (!fs.existsSync(adapterDir)) {
-      fs.mkdirSync(adapterDir, { recursive: true });
-    }
-
-    if (fs.existsSync(adapterFullPath)) {
-      console.log(`⚠️  Skipped existing: ${tool.adapterPath}`);
-      return;
-    }
-
-    fs.writeFileSync(adapterFullPath, adapterContent(tool.name));
-    console.log(`✅ Generated: ${tool.adapterPath}`);
-  });
-}
-
-function generateAll() {
-  const tools = loadTools();
-  generateForTools(tools);
-  console.log("\n🎉 All adapters generated successfully.");
-}
-
-function generateSelected(indexes) {
-  const tools = loadTools();
-  const selectedTools = indexes
-    .map((i) => tools[i])
-    .filter((tool) => tool);
-
-  if (selectedTools.length === 0) {
-    console.error("❌ No valid tools selected.");
-    process.exit(1);
-  }
-
-  generateForTools(selectedTools);
-  console.log("\n🎉 Selected adapters generated successfully.");
-}
-
-module.exports = {
-  generateAll,
-  generateSelected,
-  loadTools
+const fs = require("fs");
+const path = require("path");
+
+const projectRoot = process.cwd();
+
+function loadTools() {
+  const toolsPath = path.join(projectRoot, ".sdrive", "commands", "tools.json");
+
+  if (!fs.existsSync(toolsPath)) {
+    console.error("❌ tools.json not found.");
+    process.exit(1);
+  }
+
+  return JSON.parse(fs.readFileSync(toolsPath, "utf8")).tools;
+}
+
+function adapterContent(toolName) {
+  return `# SpecDrive Commands
+
+This project uses SpecDrive for spec-driven development.
+
+## How to use
+
+When the user types a /sdrive:* command, follow these steps:
+
+1. Read .sdrive/commands/manifest.json
+2. Find the matching command
+3. Read the agent file listed in agentFile
+4. Follow that agent's instructions exactly
+5. Run validators after writing files
+6. Stop at human approval gates
+
+Always read the manifest first. Never hardcode the command list.
+`;
+}
+
+function generateForTools(tools) {
+  tools.forEach((tool) => {
+    const adapterFullPath = path.join(projectRoot, tool.adapterPath);
+    const adapterDir = path.dirname(adapterFullPath);
+
+    if (!fs.existsSync(adapterDir)) {
+      fs.mkdirSync(adapterDir, { recursive: true });
+    }
+
+    if (fs.existsSync(adapterFullPath)) {
+      console.log(`⚠️  Skipped existing: ${tool.adapterPath}`);
+      return;
+    }
+
+    fs.writeFileSync(adapterFullPath, adapterContent(tool.name));
+    console.log(`✅ Generated: ${tool.adapterPath}`);
+  });
+}
+
+function generateAll() {
+  const tools = loadTools();
+  generateForTools(tools);
+  console.log("\n🎉 All adapters generated successfully.");
+}
+
+function generateSelected(indexes) {
+  const tools = loadTools();
+  const selectedTools = indexes
+    .map((i) => tools[i])
+    .filter((tool) => tool);
+
+  if (selectedTools.length === 0) {
+    console.error("❌ No valid tools selected.");
+    process.exit(1);
+  }
+
+  generateForTools(selectedTools);
+  console.log("\n🎉 Selected adapters generated successfully.");
+}
+
+module.exports = {
+  generateAll,
+  generateSelected,
+  loadTools
 };

package/scripts/generate-from-template.js

@@ -1,98 +1,98 @@
-const fs = require("fs");
-const path = require("path");
-
-const projectRoot = process.cwd();
-
-function loadRegistry() {
-  const registryPath = path.join(projectRoot, ".sdrive", "templates", "registry.json");
-
-  if (!fs.existsSync(registryPath)) {
-    console.error("❌ registry.json not found.");
-    process.exit(1);
-  }
-
-  return JSON.parse(fs.readFileSync(registryPath, "utf8")).templates;
-}
-
-function templateExists(templateName) {
-  const registry = loadRegistry();
-  return registry.some((t) => t.name === templateName || t.path === templateName);
-}
-
-function listTemplates() {
-  const registry = loadRegistry();
-  console.log("\nAvailable SpecDrive Templates\n");
-  registry.forEach((t) => {
-    console.log(`  ${t.name} — ${t.description}`);
-  });
-}
-
-function loadTemplate(templateName, fileName) {
-  const templatePath = path.join(projectRoot, ".sdrive", "templates", templateName, fileName);
-  return fs.readFileSync(templatePath, "utf8");
-}
-
-function applyVariables(content, variables) {
-  let result = content;
-  Object.keys(variables).forEach((key) => {
-    result = result.replaceAll(`{{${key}}}`, variables[key]);
-  });
-  return result;
-}
-
-function generate(templateName, featureName, variables) {
-  const templateDir = path.join(projectRoot, ".sdrive", "templates", templateName);
-  const govDir = path.join(projectRoot, ".sdrive", "governance", featureName);
-
-  if (!fs.existsSync(templateDir)) {
-    console.error(`❌ Template "${templateName}" not found.`);
-    listTemplates();
-    process.exit(1);
-  }
-
-  fs.mkdirSync(govDir, { recursive: true });
-
-  const files = ["spec.json", "plan.json", "tasks.json"];
-
-  files.forEach((file) => {
-    const templateFile = path.join(templateDir, file);
-
-    if (!fs.existsSync(templateFile)) {
-      return;
-    }
-
-    let content = loadTemplate(templateName, file);
-    content = applyVariables(content, {
-      featureName,
-      ...variables
-    });
-
-    fs.writeFileSync(path.join(govDir, file), content);
-    console.log(`✅ Generated: ${featureName}/${file}`);
-  });
-
-  console.log(`\n🎉 Feature "${featureName}" generated from "${templateName}" template.`);
-}
-
-const templateName = process.argv[2];
-const featureName = process.argv[3];
-const problemStatement = process.argv[4] || "";
-const proposedSolution = process.argv[5] || "";
-const targetAudience = process.argv[6] || "";
-const approach = process.argv[7] || "";
-const flowDescription = process.argv[8] || "";
-
-if (!templateName || !featureName) {
-  console.error("❌ Usage: node generate-from-template.js <template> <feature> [problem] [solution] [audience] [approach] [flow]");
-  listTemplates();
-  process.exit(1);
-}
-
-generate(templateName, featureName, {
-  title: featureName,
-  problemStatement,
-  proposedSolution,
-  targetAudience,
-  approach,
-  flowDescription
+const fs = require("fs");
+const path = require("path");
+
+const projectRoot = process.cwd();
+
+function loadRegistry() {
+  const registryPath = path.join(projectRoot, ".sdrive", "templates", "registry.json");
+
+  if (!fs.existsSync(registryPath)) {
+    console.error("❌ registry.json not found.");
+    process.exit(1);
+  }
+
+  return JSON.parse(fs.readFileSync(registryPath, "utf8")).templates;
+}
+
+function templateExists(templateName) {
+  const registry = loadRegistry();
+  return registry.some((t) => t.name === templateName || t.path === templateName);
+}
+
+function listTemplates() {
+  const registry = loadRegistry();
+  console.log("\nAvailable SpecDrive Templates\n");
+  registry.forEach((t) => {
+    console.log(`  ${t.name} — ${t.description}`);
+  });
+}
+
+function loadTemplate(templateName, fileName) {
+  const templatePath = path.join(projectRoot, ".sdrive", "templates", templateName, fileName);
+  return fs.readFileSync(templatePath, "utf8");
+}
+
+function applyVariables(content, variables) {
+  let result = content;
+  Object.keys(variables).forEach((key) => {
+    result = result.replaceAll(`{{${key}}}`, variables[key]);
+  });
+  return result;
+}
+
+function generate(templateName, featureName, variables) {
+  const templateDir = path.join(projectRoot, ".sdrive", "templates", templateName);
+  const govDir = path.join(projectRoot, ".sdrive", "governance", featureName);
+
+  if (!fs.existsSync(templateDir)) {
+    console.error(`❌ Template "${templateName}" not found.`);
+    listTemplates();
+    process.exit(1);
+  }
+
+  fs.mkdirSync(govDir, { recursive: true });
+
+  const files = ["spec.json", "plan.json", "tasks.json"];
+
+  files.forEach((file) => {
+    const templateFile = path.join(templateDir, file);
+
+    if (!fs.existsSync(templateFile)) {
+      return;
+    }
+
+    let content = loadTemplate(templateName, file);
+    content = applyVariables(content, {
+      featureName,
+      ...variables
+    });
+
+    fs.writeFileSync(path.join(govDir, file), content);
+    console.log(`✅ Generated: ${featureName}/${file}`);
+  });
+
+  console.log(`\n🎉 Feature "${featureName}" generated from "${templateName}" template.`);
+}
+
+const templateName = process.argv[2];
+const featureName = process.argv[3];
+const problemStatement = process.argv[4] || "";
+const proposedSolution = process.argv[5] || "";
+const targetAudience = process.argv[6] || "";
+const approach = process.argv[7] || "";
+const flowDescription = process.argv[8] || "";
+
+if (!templateName || !featureName) {
+  console.error("❌ Usage: node generate-from-template.js <template> <feature> [problem] [solution] [audience] [approach] [flow]");
+  listTemplates();
+  process.exit(1);
+}
+
+generate(templateName, featureName, {
+  title: featureName,
+  problemStatement,
+  proposedSolution,
+  targetAudience,
+  approach,
+  flowDescription
 });

package/scripts/generate-openapi.js

@@ -1,76 +1,76 @@
-#!/usr/bin/env node
-
-const fs = require("fs");
-const path = require("path");
-
-const projectRoot = process.cwd();
-
-function loadPlan(featureName) {
-  const planPath = path.join(projectRoot, ".sdrive", "governance", featureName, "plan.json");
-
-  if (!fs.existsSync(planPath)) {
-    console.error(`❌ plan.json not found for feature "${featureName}".`);
-    process.exit(1);
-  }
-
-  return JSON.parse(fs.readFileSync(planPath, "utf8"));
-}
-
-function generateOpenAPI(featureName) {
-  const plan = loadPlan(featureName);
-
-  const openapi = {
-    openapi: "3.0.0",
-    info: {
-      title: `${featureName} API`,
-      version: "1.0.0",
-      description: `API specification for ${featureName}`
-    },
-    paths: {}
-  };
-
-  const contracts = plan.apiContracts || [];
-
-  contracts.forEach((contract) => {
-    const method = contract.method.toLowerCase();
-    const apiPath = contract.path;
-
-    if (!openapi.paths[apiPath]) {
-      openapi.paths[apiPath] = {};
-    }
-
-    openapi.paths[apiPath][method] = {
-      summary: `${contract.method} ${apiPath}`,
-      security: contract.authenticationRequired ? [{ bearerAuth: [] }] : [],
-      responses: {
-        200: {
-          description: "Successful response"
-        }
-      }
-    };
-  });
-
-  openapi.components = {
-    securitySchemes: {
-      bearerAuth: {
-        type: "http",
-        scheme: "bearer"
-      }
-    }
-  };
-
-  const outputPath = path.join(projectRoot, ".sdrive", "governance", featureName, "openapi.json");
-  fs.writeFileSync(outputPath, JSON.stringify(openapi, null, 2));
-
-  console.log(`✅ Generated OpenAPI spec.`);
-  console.log(`   File: ${outputPath}`);
-}
-
-const featureName = process.argv[2];
-
-if (!featureName) {
-  console.error("❌ Usage: node generate-openapi.js <feature-name>");
-  process.exit(1);
-}
-
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+const projectRoot = process.cwd();
+
+function loadPlan(featureName) {
+  const planPath = path.join(projectRoot, ".sdrive", "governance", featureName, "plan.json");
+
+  if (!fs.existsSync(planPath)) {
+    console.error(`❌ plan.json not found for feature "${featureName}".`);
+    process.exit(1);
+  }
+
+  return JSON.parse(fs.readFileSync(planPath, "utf8"));
+}
+
+function generateOpenAPI(featureName) {
+  const plan = loadPlan(featureName);
+
+  const openapi = {
+    openapi: "3.0.0",
+    info: {
+      title: `${featureName} API`,
+      version: "1.0.0",
+      description: `API specification for ${featureName}`
+    },
+    paths: {}
+  };
+
+  const contracts = plan.apiContracts || [];
+
+  contracts.forEach((contract) => {
+    const method = contract.method.toLowerCase();
+    const apiPath = contract.path;
+
+    if (!openapi.paths[apiPath]) {
+      openapi.paths[apiPath] = {};
+    }
+
+    openapi.paths[apiPath][method] = {
+      summary: `${contract.method} ${apiPath}`,
+      security: contract.authenticationRequired ? [{ bearerAuth: [] }] : [],
+      responses: {
+        200: {
+          description: "Successful response"
+        }
+      }
+    };
+  });
+
+  openapi.components = {
+    securitySchemes: {
+      bearerAuth: {
+        type: "http",
+        scheme: "bearer"
+      }
+    }
+  };
+
+  const outputPath = path.join(projectRoot, ".sdrive", "governance", featureName, "openapi.json");
+  fs.writeFileSync(outputPath, JSON.stringify(openapi, null, 2));
+
+  console.log(`✅ Generated OpenAPI spec.`);
+  console.log(`   File: ${outputPath}`);
+}
+
+const featureName = process.argv[2];
+
+if (!featureName) {
+  console.error("❌ Usage: node generate-openapi.js <feature-name>");
+  process.exit(1);
+}
+
 generateOpenAPI(featureName);