specdrive-cli 0.1.9 → 0.1.12

package/scripts/onboard.js

@@ -0,0 +1,312 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+const projectRoot = process.cwd();
+const sdriveRoot = path.join(projectRoot, ".sdrive");
+const onboardingDir = path.join(sdriveRoot, "onboarding");
+
+const inventoryPath = path.join(onboardingDir, "inventory.json");
+const reportPath = path.join(onboardingDir, "report.md");
+
+const DETECT_FILES = {
+  manifests: [
+    "package.json",
+    "requirements.txt",
+    "pyproject.toml",
+    "go.mod",
+    "pubspec.yaml",
+    "Cargo.toml",
+    "pom.xml",
+    "build.gradle"
+  ],
+  docs: [
+    "README.md",
+    "CONTRIBUTING.md"
+  ],
+  codeRoots: [
+    "src",
+    "app",
+    "lib",
+    "pages",
+    "server",
+    "internal",
+    "cmd",
+    "pkg",
+    "api",
+    "apps",
+    "packages"
+  ],
+  ci: [
+    ".github/workflows",
+    ".gitlab-ci.yml"
+  ],
+  tests: [
+    "tests",
+    "__tests__",
+    "spec",
+    "test"
+  ],
+  configs: [
+    "tsconfig.json",
+    "jsconfig.json",
+    ".eslintrc",
+    ".eslintrc.js",
+    ".eslintrc.json",
+    ".prettierrc",
+    ".prettierrc.js",
+    ".prettierrc.json"
+  ],
+  specdrive: [
+    ".sdrive/constitution.md",
+    ".sdrive/skills",
+    ".sdrive/specs",
+    ".sdrive/governance",
+    ".sdrive/workflow-state.json",
+    ".sdrive/schemas",
+    ".sdrive/scripts",
+    ".sdrive/commands",
+    ".sdrive/agents",
+    ".sdrive/dashboard",
+    ".sdrive/mcp"
+  ],
+  externalSpecSystems: [
+    "openspec",
+    "openspec/specs",
+    "openspec/changes",
+    "openspec/archive",
+    ".specify",
+    ".specify/specs",
+    ".specify/memory"
+  ]
+};
+
+function exists(relativePath) {
+  return fs.existsSync(path.join(projectRoot, relativePath));
+}
+
+function countFiles(relativePath) {
+  const full = path.join(projectRoot, relativePath);
+
+  if (!fs.existsSync(full)) return 0;
+
+  const stat = fs.statSync(full);
+  if (!stat.isDirectory()) return 1;
+
+  let count = 0;
+  const walk = (dir) => {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      if (entry.name === "node_modules" || entry.name === ".git") continue;
+      const fullEntry = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(fullEntry);
+      } else {
+        count++;
+      }
+    }
+  };
+  walk(full);
+  return count;
+}
+
+function scanSection(list) {
+  const result = [];
+  for (const relativePath of list) {
+    const present = exists(relativePath);
+    result.push({
+      path: relativePath,
+      present,
+      fileCount: present ? countFiles(relativePath) : 0
+    });
+  }
+  return result;
+}
+
+function detectExternalSpecSystems() {
+  const detection = {
+    openspec: {
+      detected: false,
+      specs: 0,
+      changes: 0,
+      archived: 0
+    },
+    speckit: {
+      detected: false,
+      specs: 0,
+      hasConstitution: false
+    }
+  };
+
+  // OpenSpec detection
+  const openspecDir = path.join(projectRoot, "openspec");
+  if (fs.existsSync(openspecDir)) {
+    detection.openspec.detected = true;
+
+    const specsDir = path.join(openspecDir, "specs");
+    const changesDir = path.join(openspecDir, "changes");
+    const archiveDir = path.join(openspecDir, "archive");
+
+    if (fs.existsSync(specsDir)) {
+      detection.openspec.specs = fs
+        .readdirSync(specsDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory()).length;
+    }
+
+    if (fs.existsSync(changesDir)) {
+      detection.openspec.changes = fs
+        .readdirSync(changesDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory()).length;
+    }
+
+    if (fs.existsSync(archiveDir)) {
+      detection.openspec.archived = fs
+        .readdirSync(archiveDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory()).length;
+    }
+  }
+
+  // Spec-Kit detection
+  const speckitDir = path.join(projectRoot, ".specify");
+  if (fs.existsSync(speckitDir)) {
+    detection.speckit.detected = true;
+
+    const specsDir = path.join(speckitDir, "specs");
+    const constitutionPath = path.join(speckitDir, "memory", "constitution.md");
+
+    if (fs.existsSync(specsDir)) {
+      detection.speckit.specs = fs
+        .readdirSync(specsDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory()).length;
+    }
+
+    if (fs.existsSync(constitutionPath)) {
+      detection.speckit.hasConstitution = true;
+    }
+  }
+
+  return detection;
+}
+
+function buildInventory() {
+  const inventory = {
+    projectRoot,
+    scannedAt: new Date().toISOString(),
+    mode: "brownfield",
+    sections: {
+      manifests: scanSection(DETECT_FILES.manifests),
+      docs: scanSection(DETECT_FILES.docs),
+      codeRoots: scanSection(DETECT_FILES.codeRoots),
+      ci: scanSection(DETECT_FILES.ci),
+      tests: scanSection(DETECT_FILES.tests),
+      configs: scanSection(DETECT_FILES.configs),
+      specdrive: scanSection(DETECT_FILES.specdrive),
+      externalSpecSystems: scanSection(DETECT_FILES.externalSpecSystems)
+    },
+    detectedSystems: detectExternalSpecSystems(),
+    missing: [],
+    present: [],
+    deferred: []
+  };
+
+  const flatten = (section) => section.map((item) => item);
+
+  const all = [
+    ...flatten(inventory.sections.manifests),
+    ...flatten(inventory.sections.docs),
+    ...flatten(inventory.sections.codeRoots),
+    ...flatten(inventory.sections.ci),
+    ...flatten(inventory.sections.tests),
+    ...flatten(inventory.sections.configs),
+    ...flatten(inventory.sections.specdrive)
+  ];
+
+  for (const item of all) {
+    if (item.present) {
+      inventory.present.push(item.path);
+    } else {
+      inventory.missing.push(item.path);
+    }
+  }
+
+  return inventory;
+}
+
+function buildReport(inventory) {
+  const lines = [];
+
+  lines.push("# Onboarding Report");
+  lines.push("");
+  lines.push(`Scanned at: ${inventory.scannedAt}`);
+  lines.push(`Project root: ${inventory.projectRoot}`);
+  lines.push("");
+
+  // External Spec Systems
+  const ext = inventory.detectedSystems || {};
+  if (ext.openspec?.detected || ext.speckit?.detected) {
+    lines.push("## Detected External Spec Systems");
+    if (ext.openspec?.detected) {
+      lines.push(`- ✅ OpenSpec`);
+      lines.push(`  - Specs: ${ext.openspec.specs}`);
+      lines.push(`  - Active changes: ${ext.openspec.changes}`);
+      lines.push(`  - Archived: ${ext.openspec.archived}`);
+    }
+    if (ext.speckit?.detected) {
+      lines.push(`- ✅ Spec-Kit`);
+      lines.push(`  - Specs: ${ext.speckit.specs}`);
+      lines.push(`  - Constitution: ${ext.speckit.hasConstitution ? "found" : "missing"}`);
+    }
+    lines.push("");
+    lines.push("> These can be migrated into SpecDrive during onboarding via the Onboarding Agent.");
+    lines.push("");
+  }
+
+  lines.push("## Present");
+  inventory.present.forEach((p) => lines.push(`- ✅ ${p}`));
+  lines.push("");
+  lines.push("## Missing");
+  inventory.missing.forEach((p) => lines.push(`- ❌ ${p}`));
+  lines.push("");
+  lines.push("## Deferred");
+  if (inventory.deferred.length === 0) {
+    lines.push("(none yet)");
+  } else {
+    inventory.deferred.forEach((p) => lines.push(`- ⚠️  ${p}`));
+  }
+  lines.push("");
+
+  return lines.join("\n");
+}
+
+function main() {
+  fs.mkdirSync(onboardingDir, { recursive: true });
+
+  const inventory = buildInventory();
+  fs.writeFileSync(inventoryPath, JSON.stringify(inventory, null, 2));
+
+  const report = buildReport(inventory);
+  fs.writeFileSync(reportPath, report);
+
+  console.log(`✅ Inventory written: ${path.relative(projectRoot, inventoryPath)}`);
+  console.log(`✅ Report written:    ${path.relative(projectRoot, reportPath)}`);
+  console.log("");
+  console.log(`Present:  ${inventory.present.length}`);
+  console.log(`Missing:  ${inventory.missing.length}`);
+  console.log(`Deferred: ${inventory.deferred.length}`);
+
+  const ext = inventory.detectedSystems || {};
+  if (ext.openspec?.detected || ext.speckit?.detected) {
+    console.log("");
+    console.log("🔍 External Spec Systems Detected:");
+    if (ext.openspec?.detected) {
+      console.log(`   - OpenSpec (${ext.openspec.specs} specs, ${ext.openspec.changes} changes)`);
+    }
+    if (ext.speckit?.detected) {
+      console.log(`   - Spec-Kit (${ext.speckit.specs} specs)`);
+    }
+    console.log("");
+    console.log("   Run /sdrive:onboard to migrate them.");
+  }
+}
+
+main();

package/scripts/pre-commit.js

@@ -1,20 +1,56 @@
-const { execSync } = require("child_process");
-const path = require("path");
-const fs = require("fs");
-
-const projectRoot = process.cwd();
-const validatorPath = path.join(projectRoot, ".sdrive", "scripts", "validate-governance.js");
-
-if (!fs.existsSync(validatorPath)) {
-  console.log("⚠️  Validator not found. Skipping pre-commit validation.");
-  process.exit(0);
-}
-
-try {
-  execSync(`node "${validatorPath}"`, { stdio: "inherit" });
-  console.log("✅ Pre-commit validation passed.");
-  process.exit(0);
-} catch (error) {
-  console.error("❌ Pre-commit validation failed. Fix errors before committing.");
-  process.exit(1);
-}
+const { execSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+const projectRoot = process.cwd();
+
+const validatorPath = path.join(projectRoot, ".sdrive", "scripts", "validate-governance.js");
+const verifyPath = path.join(projectRoot, ".sdrive", "scripts", "verify.js");
+
+function getFeatureNames() {
+  const workflowStatePath = path.join(projectRoot, ".sdrive", "workflow-state.json");
+
+  if (!fs.existsSync(workflowStatePath)) return [];
+
+  try {
+    const state = JSON.parse(fs.readFileSync(workflowStatePath, "utf8"));
+    return (state.features || []).map((f) => f.name);
+  } catch (error) {
+    return [];
+  }
+}
+
+// 1. Run governance validator
+if (fs.existsSync(validatorPath)) {
+  try {
+    execSync(`node "${validatorPath}"`, { stdio: "inherit" });
+    console.log("✅ Governance validation passed.");
+  } catch (error) {
+    console.error("❌ Governance validation failed. Fix errors before committing.");
+    process.exit(1);
+  }
+} else {
+  console.log("⚠️  Validator not found. Skipping governance validation.");
+}
+
+// 2. Run spec-to-code verification for every active feature
+const features = getFeatureNames();
+
+if (features.length === 0) {
+  console.log("⚠️  No features found. Skipping spec-to-code verification.");
+  process.exit(0);
+}
+
+for (const feature of features) {
+  try {
+    execSync(`node "${verifyPath}" "${feature}"`, { stdio: "pipe" });
+    console.log(`✅ Spec-to-code verification passed for ${feature}.`);
+  } catch (error) {
+    console.error(`❌ Verification failed for ${feature}.`);
+    console.error(error.stdout ? error.stdout.toString() : "");
+    process.exit(1);
+  }
+}
+
+console.log("✅ Pre-commit checks passed.");
+process.exit(0);

package/scripts/team.js

@@ -1,114 +1,114 @@
-const fs = require("fs");
-const path = require("path");
-
-const projectRoot = process.cwd();
-const teamPath = path.join(projectRoot, ".sdrive", "team.json");
-
-function loadTeam() {
-  if (!fs.existsSync(teamPath)) {
-    console.error("❌ team.json not found. Run `sdrive init` first.");
-    process.exit(1);
-  }
-
-  try {
-    return JSON.parse(fs.readFileSync(teamPath, "utf8"));
-  } catch (error) {
-    console.error(`❌ Invalid team.json: ${error.message}`);
-    process.exit(1);
-  }
-}
-
-function saveTeam(team) {
-  fs.writeFileSync(teamPath, JSON.stringify(team, null, 2));
-}
-
-function getUserRole(username) {
-  const team = loadTeam();
-  const member = team.members?.find((m) => m.username === username);
-  return member ? member.role : null;
-}
-
-function canApprove(username) {
-  const role = getUserRole(username);
-  if (!role) return false;
-
-  const team = loadTeam();
-  return team.rules?.approval_required?.includes(role) || false;
-}
-
-function canImplement(username) {
-  const role = getUserRole(username);
-  if (!role) return false;
-
-  const team = loadTeam();
-  return team.rules?.implementation_allowed?.includes(role) || false;
-}
-
-function listMembers() {
-  const team = loadTeam();
-  return team.members || [];
-}
-
-function addMember(username, role) {
-  const team = loadTeam();
-
-  if (!team.members) {
-    team.members = [];
-  }
-
-  const existing = team.members.find((m) => m.username === username);
-  if (existing) {
-    console.error(`❌ User "${username}" already exists.`);
-    return false;
-  }
-
-  team.members.push({ username, role });
-  saveTeam(team);
-  console.log(`✅ Added ${username} as ${role}.`);
-  return true;
-}
-
-function removeMember(username) {
-  const team = loadTeam();
-
-  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.`);
-    return false;
-  }
-
-  saveTeam(team);
-  console.log(`✅ Removed ${username}.`);
-  return true;
-}
-
-function updateMember(username, role) {
-  const team = loadTeam();
-
-  const member = team.members?.find((m) => m.username === username);
-
-  if (!member) {
-    console.error(`❌ User "${username}" not found.`);
-    return false;
-  }
-
-  member.role = role;
-  saveTeam(team);
-  console.log(`✅ Updated ${username} to ${role}.`);
-  return true;
-}
-
-module.exports = {
-  loadTeam,
-  saveTeam,
-  getUserRole,
-  canApprove,
-  canImplement,
-  listMembers,
-  addMember,
-  removeMember,
-  updateMember
+const fs = require("fs");
+const path = require("path");
+
+const projectRoot = process.cwd();
+const teamPath = path.join(projectRoot, ".sdrive", "team.json");
+
+function loadTeam() {
+  if (!fs.existsSync(teamPath)) {
+    console.error("❌ team.json not found. Run `sdrive init` first.");
+    process.exit(1);
+  }
+
+  try {
+    return JSON.parse(fs.readFileSync(teamPath, "utf8"));
+  } catch (error) {
+    console.error(`❌ Invalid team.json: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+function saveTeam(team) {
+  fs.writeFileSync(teamPath, JSON.stringify(team, null, 2));
+}
+
+function getUserRole(username) {
+  const team = loadTeam();
+  const member = team.members?.find((m) => m.username === username);
+  return member ? member.role : null;
+}
+
+function canApprove(username) {
+  const role = getUserRole(username);
+  if (!role) return false;
+
+  const team = loadTeam();
+  return team.rules?.approval_required?.includes(role) || false;
+}
+
+function canImplement(username) {
+  const role = getUserRole(username);
+  if (!role) return false;
+
+  const team = loadTeam();
+  return team.rules?.implementation_allowed?.includes(role) || false;
+}
+
+function listMembers() {
+  const team = loadTeam();
+  return team.members || [];
+}
+
+function addMember(username, role) {
+  const team = loadTeam();
+
+  if (!team.members) {
+    team.members = [];
+  }
+
+  const existing = team.members.find((m) => m.username === username);
+  if (existing) {
+    console.error(`❌ User "${username}" already exists.`);
+    return false;
+  }
+
+  team.members.push({ username, role });
+  saveTeam(team);
+  console.log(`✅ Added ${username} as ${role}.`);
+  return true;
+}
+
+function removeMember(username) {
+  const team = loadTeam();
+
+  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.`);
+    return false;
+  }
+
+  saveTeam(team);
+  console.log(`✅ Removed ${username}.`);
+  return true;
+}
+
+function updateMember(username, role) {
+  const team = loadTeam();
+
+  const member = team.members?.find((m) => m.username === username);
+
+  if (!member) {
+    console.error(`❌ User "${username}" not found.`);
+    return false;
+  }
+
+  member.role = role;
+  saveTeam(team);
+  console.log(`✅ Updated ${username} to ${role}.`);
+  return true;
+}
+
+module.exports = {
+  loadTeam,
+  saveTeam,
+  getUserRole,
+  canApprove,
+  canImplement,
+  listMembers,
+  addMember,
+  removeMember,
+  updateMember
 };