ai-spector 0.1.1 → 0.1.2

package/README.md

@@ -1,6 +1,6 @@
-# Spec Writer
+# AI Spector
 
-Spec Writer is an npm-installable bootstrapper for incremental documentation workflows in Cursor.
+AI Spector is an npm-installable bootstrapper for incremental documentation workflows in Cursor.
 
 1. Analyze project sources with Graphify MCP.
 2. Generate SRS documents in dependency order.
@@ -116,7 +116,7 @@ From this package repo:
 ```bash
 npm login
 npm whoami
-chmod +x bin/spec-writer.js
+chmod +x bin/ai-spector.js
 npm pack --dry-run
 npm publish --access public
 ```
@@ -137,7 +137,7 @@ npm publish
     generate-srs.md
     generate-detail-design.md
   skills/
-    spec-writer/
+    ai-spector/
       SKILL.md
 
 docs/

package/assets/cursor/skills/{spec-writer → ai-spector}/SKILL.md

@@ -1,9 +1,9 @@
 ---
-name: spec-writer
+name: ai-spector
 description: "Incremental documentation workflow for analyze -> SRS -> detail design using Graphify MCP, dependency DAGs, and parallel subagents."
 ---
 
-# Spec Writer Skill
+# AI Spector Skill
 
 Use this skill when the user requests document generation from project data and templates.
 

package/bin/ai-spector.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+
+const { runInit } = require("../src/cli/init");
+
+function parseArgs(argv) {
+  const [command, ...rest] = argv;
+  const flags = {
+    yes: false,
+    force: false,
+    noGraphify: false,
+    skipIndex: false
+  };
+
+  for (const arg of rest) {
+    if (arg === "--yes" || arg === "-y") flags.yes = true;
+    if (arg === "--force" || arg === "-f") flags.force = true;
+    if (arg === "--no-graphify") flags.noGraphify = true;
+    if (arg === "--skip-index") flags.skipIndex = true;
+  }
+
+  return { command, flags };
+}
+
+function printHelp() {
+  console.log(`ai-spector
+
+Usage:
+  ai-spector init [--yes] [--force] [--no-graphify] [--skip-index]
+
+Commands:
+  init          Install Cursor commands, skill, templates, and workflow files.
+`);
+}
+
+async function main() {
+  const { command, flags } = parseArgs(process.argv.slice(2));
+
+  if (!command || command === "--help" || command === "-h") {
+    printHelp();
+    return;
+  }
+
+  if (command === "init") {
+    await runInit(process.cwd(), flags);
+    return;
+  }
+
+  console.error(`Unknown command: ${command}`);
+  printHelp();
+  process.exitCode = 1;
+}
+
+main().catch((error) => {
+  console.error(error.message);
+  process.exitCode = 1;
+});

package/bin/spec-writer.js

@@ -22,10 +22,10 @@ function parseArgs(argv) {
 }
 
 function printHelp() {
-  console.log(`spec-writer
+  console.log(`ai-spector
 
 Usage:
-  spec-writer init [--yes] [--force] [--no-graphify] [--skip-index]
+  ai-spector init [--yes] [--force] [--no-graphify] [--skip-index]
 
 Commands:
   init          Install Cursor commands, skill, templates, and workflow files.

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "ai-spector",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Cursor skill and workflow bootstrapper for incremental SRS/detail design generation.",
   "type": "commonjs",
   "bin": {
-    "ai-spector": "bin/spec-writer.js"
+    "ai-spector": "bin/ai-spector.js"
   },
   "keywords": [
     "cursor",
@@ -18,8 +18,8 @@
   },
   "license": "MIT",
   "scripts": {
-    "start": "node bin/spec-writer.js",
-    "init:local": "node bin/spec-writer.js init",
+    "start": "node bin/ai-spector.js",
+    "init:local": "node bin/ai-spector.js init",
     "lint": "node -e \"console.log('No linter configured yet')\""
   }
 }

package/src/cli/init.js

@@ -1,4 +1,3 @@
-const fs = require("fs");
 const path = require("path");
 const { spawnSync } = require("child_process");
 const { ensureDir, copyRecursive, writeJson, readJson } = require("./helpers/fs");
@@ -10,7 +9,7 @@ function getPackageRoot() {
 function targetPaths(cwd) {
   return {
     cursorCommands: path.join(cwd, ".cursor/commands"),
-    cursorSkill: path.join(cwd, ".cursor/skills/spec-writer"),
+    cursorSkill: path.join(cwd, ".cursor/skills/ai-spector"),
     docsRoot: path.join(cwd, "docs"),
     templates: path.join(cwd, "docs/_templates"),
     docflowRoot: path.join(cwd, "docs/.docflow"),
@@ -25,20 +24,26 @@ function targetPaths(cwd) {
   };
 }
 
-function installGraphify(cwd) {
+function canRunGraphifyCli(cwd) {
   const detect = spawnSync("npx", ["--yes", "graphify", "--help"], {
     cwd,
     stdio: "ignore"
   });
-  if (detect.status === 0) return { installed: false, available: true };
+  return detect.status === 0;
+}
 
+function installGraphify(cwd) {
+  if (canRunGraphifyCli(cwd)) {
+    return { installed: false, available: true };
+  }
   const install = spawnSync("npm", ["install", "--save-dev", "graphify"], {
     cwd,
     stdio: "inherit"
   });
+  const available = install.status === 0 && canRunGraphifyCli(cwd);
   return {
     installed: install.status === 0,
-    available: install.status === 0
+    available
   };
 }
 
@@ -50,8 +55,12 @@ function runInitialGraphifyIndex(cwd, graphConfigPath) {
     "--config",
     graphConfigPath
   ];
-  const result = spawnSync("npx", args, { cwd, stdio: "inherit" });
-  return result.status === 0;
+  const result = spawnSync("npx", args, { cwd, stdio: "pipe", encoding: "utf8" });
+  return {
+    ok: result.status === 0,
+    stderr: result.stderr || "",
+    stdout: result.stdout || ""
+  };
 }
 
 function installAssets(cwd, options) {
@@ -79,7 +88,7 @@ function installAssets(cwd, options) {
     copyOptions
   );
   copyRecursive(
-    path.join(pkgRoot, "assets/cursor/skills/spec-writer"),
+    path.join(pkgRoot, "assets/cursor/skills/ai-spector"),
     t.cursorSkill,
     copyOptions
   );
@@ -148,14 +157,20 @@ async function runInit(cwd, options) {
     graphifyInstalled = result.installed;
     if (!graphifyReady) {
       console.warn(
-        "Graphify installation failed. Continue with manual setup later."
+        "Graphify CLI was not detected. Continue with manual setup or rerun with --no-graphify."
       );
     }
   }
 
   if (graphifyReady && !options.skipIndex) {
     const graphConfigPath = path.join(t.config, "analyze.graphify.json");
-    runInitialGraphifyIndex(cwd, graphConfigPath);
+    const indexResult = runInitialGraphifyIndex(cwd, graphConfigPath);
+    if (!indexResult.ok) {
+      console.warn("Graphify index step failed; initialization will continue.");
+      if (indexResult.stderr) {
+        console.warn(indexResult.stderr.trim());
+      }
+    }
   }
 
   const statePath = path.join(t.docflowRoot, "state.json");
@@ -167,7 +182,7 @@ async function runInit(cwd, options) {
   };
   writeJson(statePath, state, { overwrite: true });
 
-  console.log("Spec Writer initialization complete.");
+  console.log("AI Spector initialization complete.");
   console.log("Next steps:");
   console.log("- Run `/analyze [paths...]` in Cursor.");
   console.log("- Run `/generate-srs` and `/generate-detail-design` incrementally.");