sentinelayer-cli 0.1.2 → 0.3.0

package/src/commands/guide.js

@@ -1,174 +1,174 @@
-import fs from "node:fs";
-import fsp from "node:fs/promises";
-import path from "node:path";
-
-import pc from "picocolors";
-
-import {
-  defaultGuideExportFileName,
-  generateBuildGuide,
-  renderGuideExport,
-  SUPPORTED_GUIDE_EXPORT_FORMATS,
-} from "../guide/generator.js";
-import { renderTerminalMarkdown } from "../ui/markdown.js";
-
-function shouldEmitJson(options, command) {
-  const local = Boolean(options && options.json);
-  const globalFromCommand =
-    command && command.optsWithGlobals ? Boolean(command.optsWithGlobals().json) : false;
-  return local || globalFromCommand;
-}
-
-function resolveSpecPath(targetPath, explicitSpecFile) {
-  const explicit = String(explicitSpecFile || "").trim();
-  if (explicit) {
-    return path.resolve(targetPath, explicit);
-  }
-
-  const candidates = [path.join(targetPath, "SPEC.md"), path.join(targetPath, "docs", "spec.md")];
-  const found = candidates.find((candidate) => fs.existsSync(candidate));
-  if (!found) {
-    throw new Error("No spec file found. Provide --spec-file or generate SPEC.md first.");
-  }
-  return found;
-}
-
-function resolveExportFormat(rawFormat) {
-  const normalized = String(rawFormat || "").trim().toLowerCase();
-  if (!SUPPORTED_GUIDE_EXPORT_FORMATS.includes(normalized)) {
-    throw new Error(
-      `Unsupported export format '${rawFormat}'. Use one of: ${SUPPORTED_GUIDE_EXPORT_FORMATS.join(", ")}`
-    );
-  }
-  return normalized;
-}
-
-export function registerGuideCommand(program) {
-  const guide = program.command("guide").description("Generate and export phase-by-phase build guides");
-
-  guide
-    .command("generate")
-    .description("Generate BUILD_GUIDE.md from SPEC content")
-    .option("--path <path>", "Target workspace path", ".")
-    .option("--spec-file <path>", "Spec file path relative to --path")
-    .option("--output-file <path>", "Output guide path relative to --path", "BUILD_GUIDE.md")
-    .option("--json", "Emit machine-readable output")
-    .action(async (options, command) => {
-      const targetPath = path.resolve(process.cwd(), String(options.path || "."));
-      const outputPath = path.resolve(targetPath, String(options.outputFile || "BUILD_GUIDE.md").trim());
-      const specPath = resolveSpecPath(targetPath, options.specFile);
-      const specMarkdown = await fsp.readFile(specPath, "utf-8");
-
-      const guideDoc = generateBuildGuide({
-        specMarkdown,
-        projectPath: targetPath,
-        specPath,
-      });
-
-      await fsp.mkdir(path.dirname(outputPath), { recursive: true });
-      await fsp.writeFile(outputPath, `${guideDoc.markdown.trimEnd()}\n`, "utf-8");
-
-      const payload = {
-        command: "guide generate",
-        targetPath,
-        specPath,
-        outputPath,
-        phases: guideDoc.phases.map((phase) => ({
-          title: phase.title,
-          effort: phase.effort.label,
-          dependencies: phase.dependencies,
-        })),
-      };
-
-      if (shouldEmitJson(options, command)) {
-        console.log(JSON.stringify(payload, null, 2));
-        return;
-      }
-
-      console.log(pc.bold("Build guide generated"));
-      console.log(pc.gray(`Spec: ${specPath}`));
-      console.log(pc.gray(`Output: ${outputPath}`));
-      console.log(pc.gray(`Phases: ${guideDoc.phases.length}`));
-    });
-
-  guide
-    .command("export")
-    .description("Export build-guide phases into issue tracker-friendly format")
-    .requiredOption(
-      "--format <type>",
-      `Export format (${SUPPORTED_GUIDE_EXPORT_FORMATS.join("|")})`
-    )
-    .option("--path <path>", "Target workspace path", ".")
-    .option("--spec-file <path>", "Spec file path relative to --path")
-    .option("--output-file <path>", "Output export file path relative to --path")
-    .option("--json", "Emit machine-readable output")
-    .action(async (options, command) => {
-      const targetPath = path.resolve(process.cwd(), String(options.path || "."));
-      const format = resolveExportFormat(options.format);
-      const outputName =
-        String(options.outputFile || "").trim() || defaultGuideExportFileName(format);
-      const outputPath = path.resolve(targetPath, outputName);
-      const specPath = resolveSpecPath(targetPath, options.specFile);
-      const specMarkdown = await fsp.readFile(specPath, "utf-8");
-
-      const guideDoc = generateBuildGuide({
-        specMarkdown,
-        projectPath: targetPath,
-        specPath,
-      });
-      const exportBody = renderGuideExport({ format, guide: guideDoc });
-
-      await fsp.mkdir(path.dirname(outputPath), { recursive: true });
-      await fsp.writeFile(outputPath, `${exportBody.trimEnd()}\n`, "utf-8");
-
-      const payload = {
-        command: "guide export",
-        format,
-        targetPath,
-        specPath,
-        outputPath,
-        issueCount: guideDoc.tickets.length,
-      };
-
-      if (shouldEmitJson(options, command)) {
-        console.log(JSON.stringify(payload, null, 2));
-        return;
-      }
-
-      console.log(pc.bold("Build guide export generated"));
-      console.log(pc.gray(`Format: ${format}`));
-      console.log(pc.gray(`Output: ${outputPath}`));
-      console.log(pc.gray(`Issues: ${guideDoc.tickets.length}`));
-    });
-
-  guide
-    .command("show")
-    .description("Render an existing BUILD_GUIDE artifact in terminal markdown")
-    .option("--path <path>", "Target workspace path", ".")
-    .option("--file <path>", "Guide file path relative to --path", "BUILD_GUIDE.md")
-    .option("--plain", "Disable terminal markdown styling")
-    .option("--json", "Emit machine-readable output")
-    .action(async (options, command) => {
-      const targetPath = path.resolve(process.cwd(), String(options.path || "."));
-      const guidePath = path.resolve(targetPath, String(options.file || "BUILD_GUIDE.md").trim());
-      if (!fs.existsSync(guidePath)) {
-        throw new Error(`Guide artifact not found: ${guidePath}`);
-      }
-
-      const markdown = await fsp.readFile(guidePath, "utf-8");
-      const payload = {
-        command: "guide show",
-        guidePath,
-        lineCount: markdown.split(/\r?\n/).length,
-        preview: markdown,
-      };
-
-      if (shouldEmitJson(options, command)) {
-        console.log(JSON.stringify(payload, null, 2));
-        return;
-      }
-
-      console.log(renderTerminalMarkdown(markdown, { plain: Boolean(options.plain) }));
-    });
-}
-
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import path from "node:path";
+
+import pc from "picocolors";
+
+import {
+  defaultGuideExportFileName,
+  generateBuildGuide,
+  renderGuideExport,
+  SUPPORTED_GUIDE_EXPORT_FORMATS,
+} from "../guide/generator.js";
+import { renderTerminalMarkdown } from "../ui/markdown.js";
+
+function shouldEmitJson(options, command) {
+  const local = Boolean(options && options.json);
+  const globalFromCommand =
+    command && command.optsWithGlobals ? Boolean(command.optsWithGlobals().json) : false;
+  return local || globalFromCommand;
+}
+
+function resolveSpecPath(targetPath, explicitSpecFile) {
+  const explicit = String(explicitSpecFile || "").trim();
+  if (explicit) {
+    return path.resolve(targetPath, explicit);
+  }
+
+  const candidates = [path.join(targetPath, "SPEC.md"), path.join(targetPath, "docs", "spec.md")];
+  const found = candidates.find((candidate) => fs.existsSync(candidate));
+  if (!found) {
+    throw new Error("No spec file found. Provide --spec-file or generate SPEC.md first.");
+  }
+  return found;
+}
+
+function resolveExportFormat(rawFormat) {
+  const normalized = String(rawFormat || "").trim().toLowerCase();
+  if (!SUPPORTED_GUIDE_EXPORT_FORMATS.includes(normalized)) {
+    throw new Error(
+      `Unsupported export format '${rawFormat}'. Use one of: ${SUPPORTED_GUIDE_EXPORT_FORMATS.join(", ")}`
+    );
+  }
+  return normalized;
+}
+
+export function registerGuideCommand(program) {
+  const guide = program.command("guide").description("Generate and export phase-by-phase build guides");
+
+  guide
+    .command("generate")
+    .description("Generate BUILD_GUIDE.md from SPEC content")
+    .option("--path <path>", "Target workspace path", ".")
+    .option("--spec-file <path>", "Spec file path relative to --path")
+    .option("--output-file <path>", "Output guide path relative to --path", "BUILD_GUIDE.md")
+    .option("--json", "Emit machine-readable output")
+    .action(async (options, command) => {
+      const targetPath = path.resolve(process.cwd(), String(options.path || "."));
+      const outputPath = path.resolve(targetPath, String(options.outputFile || "BUILD_GUIDE.md").trim());
+      const specPath = resolveSpecPath(targetPath, options.specFile);
+      const specMarkdown = await fsp.readFile(specPath, "utf-8");
+
+      const guideDoc = generateBuildGuide({
+        specMarkdown,
+        projectPath: targetPath,
+        specPath,
+      });
+
+      await fsp.mkdir(path.dirname(outputPath), { recursive: true });
+      await fsp.writeFile(outputPath, `${guideDoc.markdown.trimEnd()}\n`, "utf-8");
+
+      const payload = {
+        command: "guide generate",
+        targetPath,
+        specPath,
+        outputPath,
+        phases: guideDoc.phases.map((phase) => ({
+          title: phase.title,
+          effort: phase.effort.label,
+          dependencies: phase.dependencies,
+        })),
+      };
+
+      if (shouldEmitJson(options, command)) {
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+      }
+
+      console.log(pc.bold("Build guide generated"));
+      console.log(pc.gray(`Spec: ${specPath}`));
+      console.log(pc.gray(`Output: ${outputPath}`));
+      console.log(pc.gray(`Phases: ${guideDoc.phases.length}`));
+    });
+
+  guide
+    .command("export")
+    .description("Export build-guide phases into issue tracker-friendly format")
+    .requiredOption(
+      "--format <type>",
+      `Export format (${SUPPORTED_GUIDE_EXPORT_FORMATS.join("|")})`
+    )
+    .option("--path <path>", "Target workspace path", ".")
+    .option("--spec-file <path>", "Spec file path relative to --path")
+    .option("--output-file <path>", "Output export file path relative to --path")
+    .option("--json", "Emit machine-readable output")
+    .action(async (options, command) => {
+      const targetPath = path.resolve(process.cwd(), String(options.path || "."));
+      const format = resolveExportFormat(options.format);
+      const outputName =
+        String(options.outputFile || "").trim() || defaultGuideExportFileName(format);
+      const outputPath = path.resolve(targetPath, outputName);
+      const specPath = resolveSpecPath(targetPath, options.specFile);
+      const specMarkdown = await fsp.readFile(specPath, "utf-8");
+
+      const guideDoc = generateBuildGuide({
+        specMarkdown,
+        projectPath: targetPath,
+        specPath,
+      });
+      const exportBody = renderGuideExport({ format, guide: guideDoc });
+
+      await fsp.mkdir(path.dirname(outputPath), { recursive: true });
+      await fsp.writeFile(outputPath, `${exportBody.trimEnd()}\n`, "utf-8");
+
+      const payload = {
+        command: "guide export",
+        format,
+        targetPath,
+        specPath,
+        outputPath,
+        issueCount: guideDoc.tickets.length,
+      };
+
+      if (shouldEmitJson(options, command)) {
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+      }
+
+      console.log(pc.bold("Build guide export generated"));
+      console.log(pc.gray(`Format: ${format}`));
+      console.log(pc.gray(`Output: ${outputPath}`));
+      console.log(pc.gray(`Issues: ${guideDoc.tickets.length}`));
+    });
+
+  guide
+    .command("show")
+    .description("Render an existing BUILD_GUIDE artifact in terminal markdown")
+    .option("--path <path>", "Target workspace path", ".")
+    .option("--file <path>", "Guide file path relative to --path", "BUILD_GUIDE.md")
+    .option("--plain", "Disable terminal markdown styling")
+    .option("--json", "Emit machine-readable output")
+    .action(async (options, command) => {
+      const targetPath = path.resolve(process.cwd(), String(options.path || "."));
+      const guidePath = path.resolve(targetPath, String(options.file || "BUILD_GUIDE.md").trim());
+      if (!fs.existsSync(guidePath)) {
+        throw new Error(`Guide artifact not found: ${guidePath}`);
+      }
+
+      const markdown = await fsp.readFile(guidePath, "utf-8");
+      const payload = {
+        command: "guide show",
+        guidePath,
+        lineCount: markdown.split(/\r?\n/).length,
+        preview: markdown,
+      };
+
+      if (shouldEmitJson(options, command)) {
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+      }
+
+      console.log(renderTerminalMarkdown(markdown, { plain: Boolean(options.plain) }));
+    });
+}
+

package/src/commands/ingest.js

@@ -1,58 +1,58 @@
-import path from "node:path";
-
-import pc from "picocolors";
-
-import { formatIngestSummary, generateCodebaseIngest } from "../ingest/engine.js";
-
-function shouldEmitJson(options, command) {
-  const local = Boolean(options && options.json);
-  const globalFromCommand =
-    command && command.optsWithGlobals ? Boolean(command.optsWithGlobals().json) : false;
-  return local || globalFromCommand;
-}
-
-export function registerIngestCommand(program) {
-  const ingest = program
-    .command("ingest")
-    .description("Run deterministic codebase ingest and mapping");
-
-  ingest
-    .command("map")
-    .description("Generate CODEBASE_INGEST.json with stack/risk hints")
-    .option("--path <path>", "Target repository path", ".")
-    .option("--output-file <path>", "Explicit output file path relative to --path")
-    .option("--output-dir <path>", "Artifact root used when output file is not provided")
-    .option("--json", "Emit machine-readable output")
-    .action(async (options, command) => {
-      const targetPath = path.resolve(process.cwd(), String(options.path || "."));
-      const result = await generateCodebaseIngest({
-        rootPath: targetPath,
-        outputFile: options.outputFile,
-        outputDir: options.outputDir,
-      });
-
-      const emitJson = shouldEmitJson(options, command);
-      if (emitJson) {
-        console.log(
-          JSON.stringify(
-            {
-              command: "ingest map",
-              targetPath,
-              outputPath: result.outputPath,
-              summary: result.ingest.summary,
-              frameworks: result.ingest.frameworks,
-              entryPoints: result.ingest.entryPoints,
-              riskSurfaces: result.ingest.riskSurfaces,
-            },
-            null,
-            2
-          )
-        );
-        return;
-      }
-
-      console.log(pc.bold("Codebase ingest completed"));
-      console.log(pc.gray(`Output: ${result.outputPath}`));
-      console.log(formatIngestSummary(result.ingest));
-    });
-}
+import path from "node:path";
+
+import pc from "picocolors";
+
+import { formatIngestSummary, generateCodebaseIngest } from "../ingest/engine.js";
+
+function shouldEmitJson(options, command) {
+  const local = Boolean(options && options.json);
+  const globalFromCommand =
+    command && command.optsWithGlobals ? Boolean(command.optsWithGlobals().json) : false;
+  return local || globalFromCommand;
+}
+
+export function registerIngestCommand(program) {
+  const ingest = program
+    .command("ingest")
+    .description("Run deterministic codebase ingest and mapping");
+
+  ingest
+    .command("map")
+    .description("Generate CODEBASE_INGEST.json with stack/risk hints")
+    .option("--path <path>", "Target repository path", ".")
+    .option("--output-file <path>", "Explicit output file path relative to --path")
+    .option("--output-dir <path>", "Artifact root used when output file is not provided")
+    .option("--json", "Emit machine-readable output")
+    .action(async (options, command) => {
+      const targetPath = path.resolve(process.cwd(), String(options.path || "."));
+      const result = await generateCodebaseIngest({
+        rootPath: targetPath,
+        outputFile: options.outputFile,
+        outputDir: options.outputDir,
+      });
+
+      const emitJson = shouldEmitJson(options, command);
+      if (emitJson) {
+        console.log(
+          JSON.stringify(
+            {
+              command: "ingest map",
+              targetPath,
+              outputPath: result.outputPath,
+              summary: result.ingest.summary,
+              frameworks: result.ingest.frameworks,
+              entryPoints: result.ingest.entryPoints,
+              riskSurfaces: result.ingest.riskSurfaces,
+            },
+            null,
+            2
+          )
+        );
+        return;
+      }
+
+      console.log(pc.bold("Codebase ingest completed"));
+      console.log(pc.gray(`Output: ${result.outputPath}`));
+      console.log(formatIngestSummary(result.ingest));
+    });
+}

package/src/commands/init.js

@@ -1,55 +1,55 @@
-import process from "node:process";
-
-import { loadConfig } from "../config/service.js";
-
-function applyConfigEnvDefaults(resolvedConfig) {
-  if (!process.env.SENTINELAYER_API_URL && resolvedConfig.apiUrl) {
-    process.env.SENTINELAYER_API_URL = resolvedConfig.apiUrl;
-  }
-  if (!process.env.SENTINELAYER_WEB_URL && resolvedConfig.webUrl) {
-    process.env.SENTINELAYER_WEB_URL = resolvedConfig.webUrl;
-  }
-  if (!process.env.SENTINELAYER_TOKEN && resolvedConfig.sentinelayerToken) {
-    process.env.SENTINELAYER_TOKEN = resolvedConfig.sentinelayerToken;
-  }
-  if (!process.env.OPENAI_API_KEY && resolvedConfig.openaiApiKey) {
-    process.env.OPENAI_API_KEY = resolvedConfig.openaiApiKey;
-  }
-  if (!process.env.ANTHROPIC_API_KEY && resolvedConfig.anthropicApiKey) {
-    process.env.ANTHROPIC_API_KEY = resolvedConfig.anthropicApiKey;
-  }
-  if (!process.env.GOOGLE_API_KEY && resolvedConfig.googleApiKey) {
-    process.env.GOOGLE_API_KEY = resolvedConfig.googleApiKey;
-  }
-}
-
-export function registerInitCommand(program, invokeLegacy) {
-  program
-    .command("init [projectName]")
-    .description("Run scaffold/auth generation flow")
-    .option("--non-interactive", "Disable prompts and require interview payload")
-    .option("--interview-file <path>", "Load interview JSON from file")
-    .option("--skip-browser-open", "Do not auto-open browser during auth")
-    .action(async (projectName, options) => {
-      const config = await loadConfig();
-      applyConfigEnvDefaults(config.resolved);
-
-      const legacyArgs = [];
-      const normalizedProjectName = String(projectName || "").trim();
-      if (normalizedProjectName) {
-        legacyArgs.push(normalizedProjectName);
-      }
-      if (options.nonInteractive) {
-        legacyArgs.push("--non-interactive");
-      }
-      const interviewFile = String(options.interviewFile || "").trim();
-      if (interviewFile) {
-        legacyArgs.push("--interview-file", interviewFile);
-      }
-      if (options.skipBrowserOpen) {
-        legacyArgs.push("--skip-browser-open");
-      }
-
-      await invokeLegacy(legacyArgs);
-    });
-}
+import process from "node:process";
+
+import { loadConfig } from "../config/service.js";
+
+function applyConfigEnvDefaults(resolvedConfig) {
+  if (!process.env.SENTINELAYER_API_URL && resolvedConfig.apiUrl) {
+    process.env.SENTINELAYER_API_URL = resolvedConfig.apiUrl;
+  }
+  if (!process.env.SENTINELAYER_WEB_URL && resolvedConfig.webUrl) {
+    process.env.SENTINELAYER_WEB_URL = resolvedConfig.webUrl;
+  }
+  if (!process.env.SENTINELAYER_TOKEN && resolvedConfig.sentinelayerToken) {
+    process.env.SENTINELAYER_TOKEN = resolvedConfig.sentinelayerToken;
+  }
+  if (!process.env.OPENAI_API_KEY && resolvedConfig.openaiApiKey) {
+    process.env.OPENAI_API_KEY = resolvedConfig.openaiApiKey;
+  }
+  if (!process.env.ANTHROPIC_API_KEY && resolvedConfig.anthropicApiKey) {
+    process.env.ANTHROPIC_API_KEY = resolvedConfig.anthropicApiKey;
+  }
+  if (!process.env.GOOGLE_API_KEY && resolvedConfig.googleApiKey) {
+    process.env.GOOGLE_API_KEY = resolvedConfig.googleApiKey;
+  }
+}
+
+export function registerInitCommand(program, invokeLegacy) {
+  program
+    .command("init [projectName]")
+    .description("Run scaffold/auth generation flow")
+    .option("--non-interactive", "Disable prompts and require interview payload")
+    .option("--interview-file <path>", "Load interview JSON from file")
+    .option("--skip-browser-open", "Do not auto-open browser during auth")
+    .action(async (projectName, options) => {
+      const config = await loadConfig();
+      applyConfigEnvDefaults(config.resolved);
+
+      const legacyArgs = [];
+      const normalizedProjectName = String(projectName || "").trim();
+      if (normalizedProjectName) {
+        legacyArgs.push(normalizedProjectName);
+      }
+      if (options.nonInteractive) {
+        legacyArgs.push("--non-interactive");
+      }
+      const interviewFile = String(options.interviewFile || "").trim();
+      if (interviewFile) {
+        legacyArgs.push("--interview-file", interviewFile);
+      }
+      if (options.skipBrowserOpen) {
+        legacyArgs.push("--skip-browser-open");
+      }
+
+      await invokeLegacy(legacyArgs);
+    });
+}

package/src/commands/legacy-args.js

@@ -1,10 +1,10 @@
-function wantsJsonOutput(commandOptions, command) {
-  const local = Boolean(commandOptions && commandOptions.json);
-  const globalFromCommand =
-    command && command.optsWithGlobals ? Boolean(command.optsWithGlobals().json) : false;
-  return local || globalFromCommand;
-}
-
+function wantsJsonOutput(commandOptions, command) {
+  const local = Boolean(commandOptions && commandOptions.json);
+  const globalFromCommand =
+    command && command.optsWithGlobals ? Boolean(command.optsWithGlobals().json) : false;
+  return local || globalFromCommand;
+}
+
 function appendPathFlag(args, maybePath) {
   const value = String(maybePath || "").trim();
   if (value) {
@@ -18,7 +18,7 @@ function appendOutputDirFlag(args, maybeOutputDir) {
     args.push("--output-dir", value);
   }
 }
-
+
 export function buildLegacyArgs(baseArgs, { commandOptions = {}, command } = {}) {
   const args = [...baseArgs];
   appendPathFlag(args, commandOptions.path);
@@ -26,5 +26,5 @@ export function buildLegacyArgs(baseArgs, { commandOptions = {}, command } = {})
   if (wantsJsonOutput(commandOptions, command)) {
     args.push("--json");
   }
-  return args;
-}
+  return args;
+}