archbyte 0.3.4 → 0.4.0

package/README.md

@@ -76,6 +76,48 @@ Run `/archbyte-help` in Claude Code to see all commands.
 
 ## CLI Commands
 
+### `archbyte login`
+
+Sign in or create a free account. Shows an interactive provider picker (GitHub, Google, Email & Password).
+
+```bash
+archbyte login              # interactive provider picker
+archbyte login --github     # sign in with GitHub
+archbyte login --google     # sign in with Google
+archbyte login --email      # sign in with email and password
+archbyte login --token JWT  # login with a pre-existing JWT token
+```
+
+Multiple accounts are supported. If already logged in, you'll be prompted to add a different account.
+
+### `archbyte logout`
+
+Sign out of ArchByte.
+
+```bash
+archbyte logout              # logout active account
+archbyte logout user@co.com  # logout specific account
+archbyte logout --all        # logout all accounts
+```
+
+### `archbyte accounts`
+
+List and manage logged-in accounts.
+
+```bash
+archbyte accounts                    # list all accounts
+archbyte accounts switch             # interactive account switcher
+archbyte accounts switch user@co.com # switch to specific account
+```
+
+### `archbyte status`
+
+Show account status, tier, and usage.
+
+```bash
+archbyte status
+```
+
 ### `archbyte init`
 
 Scaffold an `archbyte.yaml` config and `.archbyte/` directory.

package/bin/archbyte.js

@@ -18,7 +18,7 @@ import { handlePatrol } from '../dist/cli/patrol.js';
 import { handleWorkflow } from '../dist/cli/workflow.js';
 import { handleAnalyze } from '../dist/cli/analyze.js';
 import { handleConfig } from '../dist/cli/config.js';
-import { handleLogin, handleLoginWithToken, handleLogout, handleStatus } from '../dist/cli/auth.js';
+import { handleLogin, handleLoginWithToken, handleLogout, handleStatus, handleAccounts, handleAccountSwitch } from '../dist/cli/auth.js';
 import { handleRun } from '../dist/cli/run.js';
 import { handleSetup } from '../dist/cli/setup.js';
 import { handleVersion, handleUpdate } from '../dist/cli/version.js';
@@ -32,17 +32,15 @@ const program = new Command();
 
 program
   .name('archbyte')
-  .description('ArchByte - See what agents build. As they build it.')
-  .version(PKG_VERSION)
+  .description('ArchByte - AI architecture analysis with an interactive diagram UI')
+  .version(PKG_VERSION, '-v, --version', 'Show version number')
   .addHelpText('after', `
   Quick start:
-    1. Sign up at https://archbyte.heartbyte.io
-    2. $ archbyte login       Sign in from the CLI
-    3. $ archbyte init        Configure your model provider
-    4. $ archbyte run         Analyze → generate → serve
+    $ archbyte login          Sign in or create a free account
+    $ archbyte init           Configure your model provider
+    $ archbyte run            Analyze + open interactive diagram UI
 
   https://archbyte.heartbyte.io
-  Support: archbyte@heartbyte.io
 `);
 
 // — Getting started —
@@ -53,11 +51,13 @@ program
   .option('--token <jwt>', 'Login with a pre-existing JWT token')
   .option('--github', 'Sign in with GitHub')
   .option('--google', 'Sign in with Google')
+  .option('--email', 'Sign in with email and password')
   .action(async (options) => {
     if (options.token) {
       await handleLoginWithToken(options.token);
     } else {
-      const provider = options.google ? 'google' : 'github';
+      // Explicit provider flag, or null for interactive picker
+      const provider = options.github ? 'github' : options.google ? 'google' : options.email ? 'email' : undefined;
       await handleLogin(provider);
     }
   });
@@ -65,8 +65,10 @@ program
 program
   .command('logout')
   .description('Sign out of ArchByte')
-  .action(async () => {
-    await handleLogout();
+  .argument('[email]', 'Logout a specific account by email')
+  .option('--all', 'Logout all accounts')
+  .action(async (email, options) => {
+    await handleLogout({ email, all: options.all });
   });
 
 program
@@ -169,7 +171,7 @@ program
   .command('export')
   .description('Export architecture to various formats')
   .option('-d, --diagram <path>', 'Path to architecture JSON (default: .archbyte/architecture.json)')
-  .option('-f, --format <format>', 'Output format: mermaid, markdown, json, plantuml, dot (default: mermaid)')
+  .option('-f, --format <format>', 'Output format: mermaid, markdown, json, plantuml, dot, html [Pro] (default: mermaid)')
   .option('-o, --output <path>', 'Write to file instead of stdout')
   .action(async (options) => {
     await handleExport(options);
@@ -214,14 +216,30 @@ program
     await handleStatus();
   });
 
+const accountsCmd = program
+  .command('accounts')
+  .description('List and manage logged-in accounts')
+  .action(async () => {
+    await handleAccounts();
+  });
+
+accountsCmd
+  .command('switch')
+  .description('Switch the active account')
+  .argument('[email]', 'Switch to a specific account by email')
+  .action(async (email) => {
+    await handleAccountSwitch(email);
+  });
+
 program
   .command('config')
   .description('Manage ArchByte configuration (provider, API key)')
   .argument('[action]', 'show, set, get, or path')
   .argument('[key]', 'config key (provider, api-key, model)')
   .argument('[value]', 'config value')
-  .action(async (action, key, value) => {
-    await handleConfig({ args: [action, key, value].filter(Boolean) });
+  .option('--raw', 'Show unmasked values (for scripting)')
+  .action(async (action, key, value, options) => {
+    await handleConfig({ args: [action, key, value].filter(Boolean), raw: options.raw });
   });
 
 program

package/dist/agents/pipeline/merger.js

@@ -1,5 +1,10 @@
 // Pipeline — Merger
 // Assembles all agent outputs into a StaticAnalysisResult
+function sanitize(s) {
+    if (!s)
+        return s;
+    return s.replace(/\u2014/g, "-").replace(/\u2013/g, "-").replace(/\u2018|\u2019/g, "'").replace(/\u201C|\u201D/g, '"');
+}
 /**
  * Merge all pipeline agent outputs into a StaticAnalysisResult
  * compatible with the existing buildAnalysisFromStatic() in cli/analyze.ts.
@@ -11,11 +16,11 @@ export function mergeAgentOutputs(ctx, componentId, serviceDesc, flowDet, connMa
         for (const c of componentId.components) {
             components.push({
                 id: c.id,
-                name: c.name,
+                name: sanitize(c.name) ?? c.name,
                 type: c.type,
                 layer: c.layer,
                 path: c.path,
-                description: c.description,
+                description: sanitize(c.description),
                 technologies: c.technologies,
             });
         }
@@ -46,7 +51,7 @@ export function mergeAgentOutputs(ctx, componentId, serviceDesc, flowDet, connMa
                     type: "database",
                     layer: "data",
                     path: "",
-                    description: db.description,
+                    description: sanitize(db.description),
                     technologies: [db.type],
                 });
                 componentIds.add(db.id);
@@ -59,11 +64,11 @@ export function mergeAgentOutputs(ctx, componentId, serviceDesc, flowDet, connMa
             if (!componentIds.has(svc.id)) {
                 components.push({
                     id: svc.id,
-                    name: svc.name,
+                    name: sanitize(svc.name) ?? svc.name,
                     type: "service",
                     layer: "external",
                     path: "",
-                    description: svc.description,
+                    description: sanitize(svc.description),
                     technologies: [svc.type],
                 });
                 componentIds.add(svc.id);
@@ -96,7 +101,7 @@ export function mergeAgentOutputs(ctx, componentId, serviceDesc, flowDet, connMa
     // Apply validator description improvements
     if (validatorOut?.componentDescriptions) {
         for (const comp of components) {
-            const better = validatorOut.componentDescriptions[comp.id];
+            const better = sanitize(validatorOut.componentDescriptions[comp.id]);
             if (better && better.length > (comp.description?.length ?? 0)) {
                 comp.description = better;
             }
@@ -118,7 +123,7 @@ export function mergeAgentOutputs(ctx, componentId, serviceDesc, flowDet, connMa
                 from: c.from,
                 to: c.to,
                 type: c.type,
-                description: c.description,
+                description: sanitize(c.description),
                 confidence: 80,
                 async: c.async,
             });
@@ -198,7 +203,7 @@ export function mergeAgentOutputs(ctx, componentId, serviceDesc, flowDet, connMa
                 from: c.from,
                 to: c.to,
                 type: c.type,
-                description: c.description,
+                description: sanitize(c.description),
                 confidence: 65,
                 async: c.async,
             });
@@ -247,7 +252,7 @@ export function mergeAgentOutputs(ctx, componentId, serviceDesc, flowDet, connMa
     // Override docs from service-describer
     const docs = { ...ctx.docs };
     if (serviceDesc?.projectDescription && serviceDesc.projectDescription.length > (docs.projectDescription?.length ?? 0)) {
-        docs.projectDescription = serviceDesc.projectDescription;
+        docs.projectDescription = sanitize(serviceDesc.projectDescription);
     }
     return {
         structure,
@@ -259,8 +264,8 @@ export function mergeAgentOutputs(ctx, componentId, serviceDesc, flowDet, connMa
         connections: {
             connections: filteredConnections,
             flows: flows.map((f) => ({
-                name: f.name,
-                description: f.description,
+                name: sanitize(f.name) ?? f.name,
+                description: sanitize(f.description),
                 category: f.category,
                 steps: f.steps,
             })),

package/dist/agents/providers/claude-sdk.d.ts

@@ -0,0 +1,7 @@
+import type { LLMProvider, ChatParams, LLMResponse, LLMChunk } from "../runtime/types.js";
+export declare class ClaudeSdkProvider implements LLMProvider {
+    name: "claude-sdk";
+    chat(params: ChatParams): Promise<LLMResponse>;
+    stream(params: ChatParams): AsyncIterable<LLMChunk>;
+    private extractPrompt;
+}

package/dist/agents/providers/claude-sdk.js

@@ -0,0 +1,59 @@
+export class ClaudeSdkProvider {
+    name = "claude-sdk";
+    async chat(params) {
+        const { query } = await import("@anthropic-ai/claude-agent-sdk");
+        const prompt = this.extractPrompt(params.messages);
+        const result = query({
+            prompt,
+            options: {
+                systemPrompt: params.system,
+                allowedTools: [],
+                maxTurns: 1,
+                ...(params.model ? { model: params.model } : {}),
+                permissionMode: "bypassPermissions",
+                allowDangerouslySkipPermissions: true,
+            },
+        });
+        let resultText = "";
+        let usage = { inputTokens: 0, outputTokens: 0 };
+        for await (const message of result) {
+            if (message.type === "result") {
+                if (message.subtype === "success") {
+                    resultText = message.result;
+                }
+                usage = {
+                    inputTokens: message.usage.input_tokens ?? 0,
+                    outputTokens: message.usage.output_tokens ?? 0,
+                };
+            }
+        }
+        return {
+            content: [{ type: "text", text: resultText }],
+            stopReason: "end_turn",
+            usage,
+        };
+    }
+    async *stream(params) {
+        // Pipeline agents don't use streaming — delegate to chat()
+        const response = await this.chat(params);
+        const text = response.content.find((b) => b.type === "text")?.text ?? "";
+        if (text) {
+            yield { type: "text", text };
+        }
+        yield { type: "done" };
+    }
+    extractPrompt(messages) {
+        for (let i = messages.length - 1; i >= 0; i--) {
+            if (messages[i].role === "user") {
+                const content = messages[i].content;
+                if (typeof content === "string")
+                    return content;
+                return content
+                    .filter((b) => b.type === "text")
+                    .map((b) => b.text ?? "")
+                    .join("\n");
+            }
+        }
+        return "";
+    }
+}

package/dist/agents/providers/router.d.ts

@@ -1,7 +1,12 @@
 import type { LLMProvider, ArchByteConfig } from "../runtime/types.js";
 export declare function createProvider(config: ArchByteConfig): LLMProvider;
+/**
+ * Check if Claude Code CLI is available on PATH.
+ */
+export declare function isClaudeCodeAvailable(): boolean;
 /**
  * Auto-detect provider from environment variables.
  * Checks in order: ARCHBYTE_PROVIDER, then falls back to whichever API key is set.
+ * Last resort: Claude Code on PATH → claude-sdk (zero config).
  */
 export declare function detectConfig(): ArchByteConfig | null;

package/dist/agents/providers/router.js

@@ -1,6 +1,8 @@
+import { execSync } from "child_process";
 import { AnthropicProvider } from "./anthropic.js";
 import { OpenAIProvider } from "./openai.js";
 import { GoogleProvider } from "./google.js";
+import { ClaudeSdkProvider } from "./claude-sdk.js";
 export function createProvider(config) {
     switch (config.provider) {
         case "anthropic":
@@ -9,13 +11,29 @@ export function createProvider(config) {
             return new OpenAIProvider(config.apiKey);
         case "google":
             return new GoogleProvider(config.apiKey);
+        case "claude-sdk":
+            return new ClaudeSdkProvider();
         default:
             throw new Error(`Unknown provider: ${config.provider}`);
     }
 }
+/**
+ * Check if Claude Code CLI is available on PATH.
+ */
+export function isClaudeCodeAvailable() {
+    try {
+        const cmd = process.platform === "win32" ? "where claude" : "which claude";
+        execSync(cmd, { stdio: "pipe" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Auto-detect provider from environment variables.
  * Checks in order: ARCHBYTE_PROVIDER, then falls back to whichever API key is set.
+ * Last resort: Claude Code on PATH → claude-sdk (zero config).
  */
 export function detectConfig() {
     const explicit = process.env.ARCHBYTE_PROVIDER;
@@ -23,7 +41,11 @@ export function detectConfig() {
     if (explicit && apiKey) {
         return { provider: explicit, apiKey };
     }
-    // Auto-detect from known env vars
+    // Claude Code on PATH → zero-config, preferred
+    if (isClaudeCodeAvailable()) {
+        return { provider: "claude-sdk" };
+    }
+    // Fall back to API key env vars
     if (process.env.ANTHROPIC_API_KEY) {
         return { provider: "anthropic", apiKey: process.env.ANTHROPIC_API_KEY };
     }

package/dist/agents/runtime/types.d.ts

@@ -97,14 +97,14 @@ export interface License {
     expiresAt: string;
     isValid: boolean;
 }
-export type ProviderName = "anthropic" | "openai" | "google";
+export type ProviderName = "anthropic" | "openai" | "google" | "claude-sdk";
 export interface ProviderProfile {
     apiKey?: string;
     model?: string;
 }
 export interface ArchByteConfig {
     provider: ProviderName;
-    apiKey: string;
+    apiKey?: string;
     model?: string;
     modelOverrides?: Partial<Record<ModelTier, string>>;
     profiles?: Record<string, ProviderProfile>;

package/dist/agents/runtime/types.js

@@ -6,6 +6,11 @@ export const MODEL_MAP = {
         standard: "claude-sonnet-4-5-20250929",
         advanced: "claude-opus-4-6",
     },
+    "claude-sdk": {
+        fast: "haiku",
+        standard: "sonnet",
+        advanced: "opus",
+    },
     openai: {
         fast: "gpt-5.2",
         standard: "gpt-5.2",

package/dist/cli/analyze.js

@@ -72,7 +72,7 @@ export async function handleAnalyze(options) {
     if (options.provider) {
         config = {
             provider: options.provider,
-            apiKey: options.apiKey ?? config?.apiKey ?? "",
+            ...(options.provider !== "claude-sdk" ? { apiKey: options.apiKey ?? config?.apiKey ?? "" } : {}),
         };
     }
     if (options.apiKey && config) {
@@ -81,7 +81,10 @@ export async function handleAnalyze(options) {
     if (!config) {
         console.error(chalk.red("No model provider configured."));
         console.error();
-        console.error(chalk.bold("Set up with:"));
+        console.error(chalk.bold("Zero-config (Claude Code users):"));
+        console.error(chalk.gray("  Install Claude Code → archbyte analyze just works"));
+        console.error();
+        console.error(chalk.bold("Or set up with:"));
         console.error(chalk.gray("  archbyte config set provider anthropic"));
         console.error(chalk.gray("  archbyte config set api-key sk-ant-..."));
         console.error();
@@ -93,10 +96,11 @@ export async function handleAnalyze(options) {
         console.error(chalk.gray("  archbyte analyze --static"));
         console.error();
         console.error(chalk.bold("Supported providers:"));
-        console.error(chalk.gray("  anthropic, openai, google"));
+        console.error(chalk.gray("  anthropic, openai, google, claude-sdk"));
         process.exit(1);
     }
-    console.log(chalk.gray(`Provider: ${chalk.white(config.provider)}`));
+    const providerLabel = config.provider === "claude-sdk" ? "Claude Code (SDK)" : config.provider;
+    console.log(chalk.gray(`Provider: ${chalk.white(providerLabel)}`));
     console.log(chalk.gray(`Project:  ${chalk.white(path.basename(rootDir))}`));
     console.log();
     // 2. Create provider

package/dist/cli/auth.d.ts

@@ -5,10 +5,16 @@ interface Credentials {
     expiresAt: string;
 }
 export type OAuthProvider = "github" | "google";
-export declare function handleLogin(provider?: OAuthProvider): Promise<void>;
+export type LoginProvider = OAuthProvider | "email";
+export declare function handleLogin(provider?: LoginProvider): Promise<void>;
 export declare function handleLoginWithToken(token: string): Promise<void>;
-export declare function handleLogout(): Promise<void>;
+export declare function handleLogout(options?: {
+    all?: boolean;
+    email?: string;
+}): Promise<void>;
 export declare function handleStatus(): Promise<void>;
+export declare function handleAccounts(): Promise<void>;
+export declare function handleAccountSwitch(email?: string): Promise<void>;
 export declare function loadCredentials(): Credentials | null;
 /**
  * Get the tier from the JWT token payload. NEVER falls back to the
@@ -34,6 +40,9 @@ export declare function getVerifiedTier(): "free" | "premium";
 /**
  * Check if an offline action is allowed. Returns true if within limits.
  * Increments the counter when allowed.
+ *
+ * Uses atomic write-to-temp-then-rename to prevent race conditions
+ * between concurrent CLI invocations.
  */
 export declare function checkOfflineAction(): {
     allowed: boolean;