specdrive-cli 0.1.9 → 0.1.12

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,71 +1,98 @@
-const fs = require("fs");
-const path = require("path");
-
-const projectRoot = process.cwd();
-
-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.`);
-    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]");
-  process.exit(1);
-}
-
-generate(templateName, 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

@@ -0,0 +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);
+}
+
+generateOpenAPI(featureName);

package/scripts/github-team-sync.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+
+const { execSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+
+const projectRoot = process.cwd();
+
+function getRepoInfo() {
+  try {
+    const remote = execSync("git config --get remote.origin.url", {
+      stdio: "pipe",
+      encoding: "utf8"
+    }).trim();
+
+    const match = remote.match(/github\.com[:/](.+?)\/(.+?)(\.git)?$/);
+
+    if (!match) {
+      console.error("❌ Could not detect GitHub repository.");
+      return null;
+    }
+
+    return { owner: match[1], repo: match[2] };
+  } catch (error) {
+    console.error("❌ Git not initialized or remote missing.");
+    return null;
+  }
+}
+
+function fetchCollaborators(owner, repo) {
+  try {
+    const result = execSync(`gh api repos/${owner}/${repo}/collaborators`, {
+      stdio: "pipe",
+      encoding: "utf8"
+    });
+
+    return JSON.parse(result);
+  } catch (error) {
+    console.error("❌ Could not fetch collaborators. Is gh CLI installed and authenticated?");
+    return null;
+  }
+}
+
+function syncTeam() {
+  const repoInfo = getRepoInfo();
+
+  if (!repoInfo) {
+    process.exit(1);
+  }
+
+  const collaborators = fetchCollaborators(repoInfo.owner, repoInfo.repo);
+
+  if (!collaborators) {
+    process.exit(1);
+  }
+
+  const teamPath = path.join(projectRoot, ".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"));
+
+  collaborators.forEach((user) => {
+    const existing = team.members.find((m) => m.username === user.login);
+
+    if (!existing) {
+      team.members.push({
+        username: user.login,
+        role: user.permissions?.admin ? "admin" : "developer"
+      });
+    }
+  });
+
+  fs.writeFileSync(teamPath, JSON.stringify(team, null, 2));
+  console.log(`✅ Synced ${collaborators.length} collaborators from GitHub.`);
+}
+
+syncTeam();

package/scripts/install-hooks.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+const projectRoot = process.cwd();
+const hooksDir = path.join(projectRoot, ".git", "hooks");
+const preCommitPath = path.join(hooksDir, "pre-commit");
+
+const hookContent = `#!/bin/sh
+node .sdrive/scripts/pre-commit.js
+`;
+
+if (!fs.existsSync(hooksDir)) {
+  console.error("❌ .git/hooks not found. Are you in a Git repository?");
+  process.exit(1);
+}
+
+fs.writeFileSync(preCommitPath, hookContent, { mode: 0o755 });
+console.log("✅ Installed SpecDrive pre-commit hook.");
+console.log("   Governance validation will now run before every commit.");

package/scripts/load-plugins.js

@@ -1,66 +1,66 @@
-const fs = require("fs");
-const path = require("path");
-
-const projectRoot = process.cwd();
-const pluginsDir = path.join(projectRoot, ".sdrive", "plugins");
-
-function loadPlugins() {
-  if (!fs.existsSync(pluginsDir)) {
-    return [];
-  }
-
-  const pluginFolders = fs.readdirSync(pluginsDir, { withFileTypes: true })
-    .filter((d) => d.isDirectory())
-    .map((d) => d.name);
-
-  const plugins = [];
-
-  pluginFolders.forEach((folder) => {
-    const pluginJsonPath = path.join(pluginsDir, folder, "plugin.json");
-
-    if (!fs.existsSync(pluginJsonPath)) {
-      return;
-    }
-
-    try {
-      const pluginDef = JSON.parse(fs.readFileSync(pluginJsonPath, "utf8"));
-      plugins.push({
-        ...pluginDef,
-        path: path.join(pluginsDir, folder)
-      });
-    } catch (error) {
-      console.warn(`⚠️  Skipping invalid plugin: ${folder}`);
-    }
-  });
-
-  return plugins;
-}
-
-function runPlugin(pluginName) {
-  const plugins = loadPlugins();
-  const plugin = plugins.find((p) => p.name === pluginName);
-
-  if (!plugin) {
-    console.error(`❌ Plugin "${pluginName}" not found.`);
-    process.exit(1);
-  }
-
-  const entryPath = path.join(plugin.path, plugin.entry);
-
-  if (!fs.existsSync(entryPath)) {
-    console.error(`❌ Plugin entry not found: ${plugin.entry}`);
-    process.exit(1);
-  }
-
-  require(entryPath);
-}
-
-function listPlugins() {
-  return loadPlugins();
-}
-
-module.exports = {
-  loadPlugins,
-  runPlugin,
-  listPlugins
+const fs = require("fs");
+const path = require("path");
+
+const projectRoot = process.cwd();
+const pluginsDir = path.join(projectRoot, ".sdrive", "plugins");
+
+function loadPlugins() {
+  if (!fs.existsSync(pluginsDir)) {
+    return [];
+  }
+
+  const pluginFolders = fs.readdirSync(pluginsDir, { withFileTypes: true })
+    .filter((d) => d.isDirectory())
+    .map((d) => d.name);
+
+  const plugins = [];
+
+  pluginFolders.forEach((folder) => {
+    const pluginJsonPath = path.join(pluginsDir, folder, "plugin.json");
+
+    if (!fs.existsSync(pluginJsonPath)) {
+      return;
+    }
+
+    try {
+      const pluginDef = JSON.parse(fs.readFileSync(pluginJsonPath, "utf8"));
+      plugins.push({
+        ...pluginDef,
+        path: path.join(pluginsDir, folder)
+      });
+    } catch (error) {
+      console.warn(`⚠️  Skipping invalid plugin: ${folder}`);
+    }
+  });
+
+  return plugins;
+}
+
+function runPlugin(pluginName) {
+  const plugins = loadPlugins();
+  const plugin = plugins.find((p) => p.name === pluginName);
+
+  if (!plugin) {
+    console.error(`❌ Plugin "${pluginName}" not found.`);
+    process.exit(1);
+  }
+
+  const entryPath = path.join(plugin.path, plugin.entry);
+
+  if (!fs.existsSync(entryPath)) {
+    console.error(`❌ Plugin entry not found: ${plugin.entry}`);
+    process.exit(1);
+  }
+
+  require(entryPath);
+}
+
+function listPlugins() {
+  return loadPlugins();
+}
+
+module.exports = {
+  loadPlugins,
+  runPlugin,
+  listPlugins
 };