archbyte 0.4.2 → 0.5.1

package/dist/cli/run.js

@@ -1,8 +1,124 @@
+import * as fs from "fs";
+import * as path from "path";
+import chalk from "chalk";
 import { handleAnalyze } from "./analyze.js";
 import { handleServe } from "./serve.js";
-import { DEFAULT_PORT } from "./constants.js";
+import { DEFAULT_PORT, CONFIG_PATH } from "./constants.js";
+import { loadCredentials } from "./auth.js";
+import { resolveConfig } from "./config.js";
+import { requireLicense } from "./license-gate.js";
+import { isTTY } from "./utils.js";
+/**
+ * Check if the user has explicitly configured a provider via `archbyte init`.
+ * This reads the raw config file — unlike resolveConfig() which auto-detects
+ * Claude Code on PATH, env vars, etc. We want to trigger setup only when
+ * the user hasn't gone through init yet.
+ */
+function hasExplicitConfig() {
+    try {
+        if (!fs.existsSync(CONFIG_PATH))
+            return false;
+        const config = JSON.parse(fs.readFileSync(CONFIG_PATH, "utf-8"));
+        return !!config.provider;
+    }
+    catch {
+        return false;
+    }
+}
 export async function handleRun(options) {
     const port = options.port || DEFAULT_PORT;
+    const isStaticOnly = options.static || options.skipLlm;
+    // ─── First-run onboarding: login + provider setup ───
+    const creds = loadCredentials();
+    const needsLogin = !creds;
+    const needsSetup = !hasExplicitConfig() && !isStaticOnly && !options.provider;
+    if (needsLogin || needsSetup) {
+        const dim = chalk.gray;
+        const sep = dim("  ───");
+        console.log();
+        console.log(chalk.bold.cyan("  Welcome to ArchByte"));
+        console.log(dim("  Visual observability for agentic development."));
+        console.log(dim("  Understand what your agents are building, in real time."));
+        console.log();
+        console.log(sep);
+        console.log();
+        console.log(dim("  Docs     ") + chalk.cyan("https://archbyte.heartbyte.io/setup"));
+        console.log(dim("  Website  ") + chalk.cyan("https://archbyte.heartbyte.io"));
+        console.log();
+        console.log(sep);
+        console.log();
+        console.log(dim("  Let's get you set up. This takes about 30 seconds."));
+        console.log();
+        // Step 1: Login
+        if (needsLogin) {
+            const { handleLogin } = await import("./auth.js");
+            await handleLogin();
+            if (!loadCredentials()) {
+                console.error(chalk.red("Login required. Run `archbyte login` to try again."));
+                process.exit(1);
+            }
+        }
+        // Step 2: Provider setup
+        if (needsSetup) {
+            const { handleSetup } = await import("./setup.js");
+            await handleSetup({ calledFromRun: true });
+        }
+        // Show config summary and pause before scanning
+        const resolvedConfig = resolveConfig();
+        const resolvedCreds = loadCredentials();
+        const rootDir = options.dir ? path.resolve(options.dir) : process.cwd();
+        console.log(sep);
+        console.log();
+        console.log("  " + chalk.bold("Ready to scan"));
+        console.log();
+        if (resolvedCreds) {
+            console.log(dim("  Account    ") + chalk.white(resolvedCreds.email));
+        }
+        if (resolvedConfig) {
+            const providerLabel = resolvedConfig.provider === "claude-sdk"
+                ? "Claude Code (SDK)"
+                : resolvedConfig.provider;
+            console.log(dim("  Provider   ") + chalk.white(providerLabel));
+            if (resolvedConfig.model) {
+                console.log(dim("  Model      ") + chalk.white(resolvedConfig.model));
+            }
+            if (resolvedConfig.provider !== "claude-sdk") {
+                console.log(dim("  API key    ") + (resolvedConfig.apiKey ? chalk.green("configured") : chalk.yellow("not set")));
+            }
+        }
+        console.log(dim("  Project    ") + chalk.white(path.basename(rootDir)));
+        console.log(dim("  Directory  ") + chalk.white(rootDir));
+        console.log();
+        // Pause — let the user absorb the config before scanning
+        if (isTTY()) {
+            await new Promise((resolve) => {
+                process.stdout.write(dim("  Press Enter to start analysis (q to quit)..."));
+                const stdin = process.stdin;
+                stdin.setRawMode(true);
+                stdin.resume();
+                stdin.setEncoding("utf8");
+                const onData = (data) => {
+                    if (data === "\r" || data === "\n" || data === " ") {
+                        stdin.setRawMode(false);
+                        stdin.pause();
+                        stdin.removeListener("data", onData);
+                        process.stdout.write("\n\n");
+                        resolve();
+                    }
+                    else if (data === "q" || data === "Q" || data === "\u0003" || data === "\u001b") {
+                        stdin.setRawMode(false);
+                        stdin.pause();
+                        stdin.removeListener("data", onData);
+                        process.stdout.write("\n");
+                        process.exit(0);
+                    }
+                };
+                stdin.on("data", onData);
+            });
+        }
+    }
+    // License/usage check (creds guaranteed to exist after onboarding)
+    await requireLicense("analyze");
     // 1. Analyze (includes auto-generate)
     await handleAnalyze({
         verbose: options.verbose,

package/dist/cli/setup.d.ts

@@ -1 +1,6 @@
-export declare function handleSetup(): Promise<void>;
+interface SetupOptions {
+    /** When true, skip "archbyte run" in next steps (called from `archbyte run`) */
+    calledFromRun?: boolean;
+}
+export declare function handleSetup(opts?: SetupOptions): Promise<void>;
+export {};

package/dist/cli/setup.js

@@ -207,7 +207,8 @@ async function validateProviderSilent(providerName, apiKey, model) {
 function getProfiles(config) {
     return config.profiles ?? {};
 }
-export async function handleSetup() {
+export async function handleSetup(opts) {
+    const calledFromRun = opts?.calledFromRun ?? false;
     console.log();
     console.log(chalk.bold.cyan("ArchByte Setup"));
     console.log(chalk.gray("Configure your model provider and API key.\n"));
@@ -300,12 +301,20 @@ export async function handleSetup() {
             console.log();
             console.log(sep);
             console.log();
-            console.log("  " + chalk.bold("Next steps"));
-            console.log();
-            console.log("  " + chalk.cyan("archbyte run") + "            Analyze your codebase");
-            console.log("  " + chalk.cyan("archbyte status") + "         Check account and usage");
-            console.log("  " + chalk.cyan("archbyte --help") + "         See all commands");
-            console.log();
+            if (calledFromRun) {
+                console.log(dim("  Continuing to scan your codebase..."));
+                console.log();
+            }
+            else {
+                console.log("  " + chalk.bold("Next steps"));
+                console.log();
+                console.log("  " + chalk.cyan("archbyte run") + "            Analyze your codebase");
+                console.log("  " + chalk.cyan("archbyte status") + "         Check account and usage");
+                console.log("  " + chalk.cyan("archbyte --help") + "         See all commands");
+                console.log();
+                console.log(dim("  Run from your project root, or use --dir <path> to specify the directory."));
+                console.log();
+            }
             return;
         }
         if (choice === "codex") {
@@ -588,18 +597,28 @@ export async function handleSetup() {
     console.log();
     console.log(sep);
     console.log();
-    console.log("  " + chalk.bold("Next steps"));
-    console.log();
-    console.log("  " + chalk.cyan("archbyte run") + "            Analyze your codebase");
-    if (hasClaude || hasCodex) {
+    if (calledFromRun) {
+        if (result === false) {
+            console.log(chalk.yellow("  Warning: credentials unverified. Saving anyway."));
+            console.log();
+        }
+        console.log(dim("  Continuing to scan your codebase..."));
+        console.log();
     }
-    console.log("  " + chalk.cyan("archbyte status") + "         Check account and usage");
-    console.log("  " + chalk.cyan("archbyte --help") + "         See all commands");
-    if (result === false) {
+    else {
+        console.log("  " + chalk.bold("Next steps"));
+        console.log();
+        console.log("  " + chalk.cyan("archbyte run") + "            Analyze your codebase");
+        console.log("  " + chalk.cyan("archbyte status") + "         Check account and usage");
+        console.log("  " + chalk.cyan("archbyte --help") + "         See all commands");
+        console.log();
+        console.log(dim("  Run from your project root, or use --dir <path> to specify the directory."));
+        if (result === false) {
+            console.log();
+            console.log(chalk.yellow("  Warning: credentials unverified. Saving anyway."));
+        }
         console.log();
-        console.log(chalk.yellow("  Warning: credentials unverified. Saving anyway."));
     }
-    console.log();
 }
 function writeArchbyteReadme(archbyteDir) {
     const readmePath = path.join(archbyteDir, "README.md");

package/dist/cli/shared.d.ts

@@ -64,16 +64,5 @@ export declare function parseRulesFromYaml(content: string): RuleConfig;
  *         level: error
  */
 export declare function parseCustomRulesFromYaml(content: string): CustomRule[];
-/**
- * Parse the patrol.ignore list from archbyte.yaml.
- * Returns user-defined glob patterns for watch mode to ignore.
- *
- *   patrol:
- *     ignore:
- *       - "docs/"
- *       - "*.md"
- *       - "build/"
- */
-export declare function loadPatrolIgnore(configPath?: string): string[];
 export declare function getRuleLevel(config: RuleConfig, rule: keyof RuleConfig, defaultLevel: RuleLevel): RuleLevel;
 export declare function getThreshold(config: RuleConfig, rule: "max-connections", defaultVal: number): number;

package/dist/cli/shared.js

@@ -259,67 +259,6 @@ export function parseCustomRulesFromYaml(content) {
         flushItem();
     return rules;
 }
-/**
- * Parse the patrol.ignore list from archbyte.yaml.
- * Returns user-defined glob patterns for watch mode to ignore.
- *
- *   patrol:
- *     ignore:
- *       - "docs/"
- *       - "*.md"
- *       - "build/"
- */
-export function loadPatrolIgnore(configPath) {
-    const rootDir = process.cwd();
-    const yamlPath = configPath
-        ? path.resolve(rootDir, configPath)
-        : path.join(rootDir, ".archbyte", "archbyte.yaml");
-    if (!fs.existsSync(yamlPath))
-        return [];
-    try {
-        const lines = fs.readFileSync(yamlPath, "utf-8").split("\n");
-        const patterns = [];
-        let inPatrol = false;
-        let inIgnore = false;
-        for (const line of lines) {
-            const trimmed = line.trimEnd();
-            if (/^patrol:\s*$/.test(trimmed)) {
-                inPatrol = true;
-                continue;
-            }
-            // Another top-level section ends patrol
-            if (inPatrol && /^\S/.test(trimmed) && !trimmed.startsWith("#")) {
-                inPatrol = false;
-                inIgnore = false;
-                continue;
-            }
-            if (!inPatrol)
-                continue;
-            if (trimmed === "" || trimmed.trim().startsWith("#"))
-                continue;
-            if (/^ {2}ignore:\s*$/.test(trimmed)) {
-                inIgnore = true;
-                continue;
-            }
-            // Another patrol sub-key ends ignore
-            if (inIgnore && /^ {2}\S/.test(trimmed) && !/^ {2}ignore:/.test(trimmed)) {
-                inIgnore = false;
-                continue;
-            }
-            if (!inIgnore)
-                continue;
-            // List item: "    - pattern"
-            const itemMatch = trimmed.match(/^ {4}-\s+"?([^"]+)"?\s*$/);
-            if (itemMatch) {
-                patterns.push(itemMatch[1].trim());
-            }
-        }
-        return patterns;
-    }
-    catch {
-        return [];
-    }
-}
 export function getRuleLevel(config, rule, defaultLevel) {
     const entry = config[rule];
     if (!entry)

package/dist/cli/workflow.js

@@ -8,7 +8,7 @@ const BUILTIN_WORKFLOWS = [
     {
         id: "full-analysis",
         name: "Full Analysis Pipeline",
-        description: "Complete architecture pipeline: analyze, generate, validate, and report",
+        description: "Complete architecture pipeline: analyze, generate, audit, and report",
         steps: [
             {
                 id: "generate",
@@ -17,13 +17,6 @@ const BUILTIN_WORKFLOWS = [
                 needs: [],
                 description: "Generate architecture diagram from analysis JSON",
             },
-            {
-                id: "validate",
-                name: "Validate Architecture",
-                command: "archbyte validate",
-                needs: ["generate"],
-                description: "Run fitness function rules against the architecture",
-            },
             {
                 id: "stats",
                 name: "Architecture Stats",
@@ -34,23 +27,23 @@ const BUILTIN_WORKFLOWS = [
             {
                 id: "export",
                 name: "Export Mermaid",
-                command: "archbyte export --format mermaid",
+                command: "archbyte export --format mermaid --output .archbyte/architecture.mmd",
                 needs: ["generate"],
-                description: "Export architecture as Mermaid diagram",
+                description: "Export architecture as Mermaid diagram to .archbyte/architecture.mmd",
             },
         ],
     },
     {
         id: "ci-check",
         name: "CI Architecture Check",
-        description: "Lightweight CI pipeline: validate and diff against baseline",
+        description: "Lightweight CI pipeline: audit architecture health",
         steps: [
             {
-                id: "validate",
-                name: "Validate",
-                command: "archbyte validate --ci",
+                id: "stats",
+                name: "Stats",
+                command: "archbyte stats --ci",
                 needs: [],
-                description: "Run validation in CI mode (JSON output, exit code on failure)",
+                description: "Run architecture stats in CI mode",
             },
         ],
     },