@synergenius/flow-weaver 0.26.7 → 0.27.1

package/README.md

@@ -6,14 +6,61 @@
 [![Tests](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/moraispgsi/305430ef59a51d0a58eb61fefdfbe634/raw/flow-weaver-test-count.json&style=flat)](https://github.com/synergenius-fw/flow-weaver/actions/workflows/ci.yml)
 [![Coverage](https://img.shields.io/codecov/c/github/synergenius-fw/flow-weaver?style=flat)](https://codecov.io/gh/synergenius-fw/flow-weaver)
 [![License: Flow Weaver Library License](https://img.shields.io/badge/License-Flow%20Weaver%20Library-blue?style=flat)](./LICENSE)
-[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-green?style=flat)](https://nodejs.org)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D22-green?style=flat)](https://nodejs.org)
 
 **Design agent workflows in conversation. The compiled output is yours.**
 
-[**flowweaver.ai**](https://flowweaver.ai) · [**Studio**](https://flowweaver.ai/studio) · [**Docs**](https://flowweaver.ai/docs) · [**Discord**](https://discord.gg/6Byh3ur2bk) · [**npm**](https://www.npmjs.com/package/@synergenius/flow-weaver)
+[**flowweaver.ai**](https://flowweaver.ai) · [**Studio**](https://flowweaver.ai/studio) · [**Features**](https://flowweaver.ai/features) · [**Discord**](https://discord.gg/6Byh3ur2bk) · [**npm**](https://www.npmjs.com/package/@synergenius/flow-weaver)
 
 ---
 
+Flow Weaver is a TypeScript workflow compiler. Define workflows with JSDoc annotations in your existing codebase, compile to standalone TypeScript functions with zero runtime dependencies, and deploy to any serverless target. The compiled output has no dependency on Flow Weaver. You own it.
+
+Build AI agent workflows, data pipelines, or automation scripts through natural language using MCP tools in Claude Code, Cursor, Windsurf, VS Code, JetBrains, Codex, or any MCP-compatible editor. Or write them by hand with annotations the same way you write JSDoc today.
+
+## Project Status
+
+Flow Weaver is in **active alpha**. The compiler, validator, CLI, and MCP tools are stable and thoroughly tested. The test suite covers thousands of cases across parsing, compilation, validation, diffing, and deployment. CI runs on every commit.
+
+This started as a curiosity by [Ricardo Morais](https://linkedin.com/in/moraispgsi) into why visual programming never took off and whether code-first and visual editing could actually coexist. It has grown into something real. It is actively maintained, with releases shipping regularly. If you run into issues or have questions, the [Discord](https://discord.gg/6Byh3ur2bk) is the best place to reach out. Every issue and question gets a response, usually within a day.
+
+**Flow Weaver Studio**, the browser-based visual IDE, is the next major milestone and is being actively built. Core editing (canvas, terminal, diagnostics) is live today. The visual debugger, AI chat assistant, version history, and deployment dashboard are in progress. You can follow development on Discord or in the [GitHub releases](https://github.com/synergenius-fw/flow-weaver/releases).
+
+Breaking changes may occur between minor versions during alpha. Pin your version in `package.json` if stability matters for your project.
+
+## Capabilities
+
+**Annotation-driven workflows:** Define node graphs directly in TypeScript using JSDoc annotations. No YAML, no JSON configs, no separate workflow files. Your workflows live in `.ts` files, version-controlled alongside your code.
+
+**Zero-dependency compiled output:** The compiler generates a self-contained TypeScript function. No runtime to install in production, no SDK to import, no vendor lock-in. Delete the package after compiling and the output still runs.
+
+**AI-native editing:** MCP tools expose the full compiler, validator, debugger, and diagram surface to any MCP-compatible editor. Scaffold a project, add nodes, wire connections, validate, compile, run, and diff through conversation.
+
+**Structural validation:** Type checking across port connections, graph topology analysis, agent safety rules, and breaking change detection. Runs in CI, on every save, or on demand. Errors include source locations, fix suggestions, and documentation links.
+
+**Step-through debugging:** Set breakpoints on nodes, step through execution node by node, inspect variables mid-run, and resume from checkpoints. Variable injection available through MCP tools.
+
+**Semantic diffing:** Compare workflow versions at the graph level instead of text diffs. Impact analysis categorizes every change as critical, breaking, minor, or cosmetic. Know exactly what changed and whether it matters.
+
+**Deploy anywhere:** Export to Inngest, AWS Lambda, Vercel, Cloudflare Workers, GitHub Actions, or GitLab CI. Or serve workflows over HTTP with built-in framework adapters for Next.js, Express, Hono, Fastify, and Remix.
+
+**Extensible pack system:** Node types, deploy targets, CLI commands, and MCP tools are contributed by npm packages. Install community packs or build and publish your own.
+
+## Quick Start
+
+```bash
+npm install @synergenius/flow-weaver
+npx flow-weaver init my-agent
+npx flow-weaver compile my-agent.ts
+npx flow-weaver run my-agent.ts
+```
+
+The CLI scaffolds a project, compiles annotations into a runnable workflow, and executes it. Run `fw --help` for the full command reference. The example below shows a more complete workflow built through conversation.
+
+## See It in Action
+
+The conversation below shows [Weaver](https://github.com/synergenius-fw/flow-weaver-pack-weaver), an optional AI bot that drives Flow Weaver through natural language. It handles scaffolding, modification, validation, compilation, execution, and deployment. Install it with `fw market install @synergenius/flow-weaver-pack-weaver`, or use the MCP tools directly from your editor without Weaver.
+
 > **You:** Build a support agent that classifies messages and either auto-replies or escalates.
 
 > **Weaver:** Created `support-agent.ts`. Four nodes, one workflow.
@@ -101,19 +148,156 @@
 > fw export support-agent.ts --target inngest
 > ```
 
----
+## How Workflows Are Defined
+
+Workflows are TypeScript functions annotated with JSDoc. You write plain functions for each node, and the annotations describe how they connect.
+
+The function signature is the source of truth. Input parameters become input ports, return object fields become output ports. Every function has an `execute` boolean that controls whether it runs or passes through, and returns `onSuccess`/`onFailure` for branching. Expression nodes (marked with `@expression`) skip the execute/branching pattern and map return fields directly to outputs.
+
+The `@flowWeaver workflow` block wires node instances together. `@node` creates an instance of a node type, `@connect` wires ports between nodes, and `@path` is shorthand for a linear route. `Start` and `Exit` are virtual nodes representing the workflow's inputs and outputs.
 
-## Install
+The compiler reads these annotations, builds the execution graph, and generates the body in place between markers. Everything outside the markers stays untouched. Node type functions are never modified.
+
+```typescript
+/**
+ * @flowWeaver nodeType
+ * @expression
+ * @input message - The support message
+ * @output context - Classified context
+ */
+function classifyIntent(message: string): { context: SupportContext } {
+  const intent = /refund|cancel/i.test(message) ? 'billing' : 'general';
+  return { context: { message, intent, priority: 'normal' } };
+}
+
+// routeAction, llmReply, and escalate are defined the same way:
+// plain functions with @flowWeaver nodeType annotations.
+
+/**
+ * @flowWeaver workflow
+ * @node classify classifyIntent
+ * @node route routeAction
+ * @node reply llmReply
+ * @node esc escalate
+ * @path Start -> classify -> route -> reply -> Exit
+ * @path route:fail -> esc -> Exit
+ * @connect Start.message -> classify.message
+ * @connect classify.context -> route.context
+ * @param message - The support message
+ * @returns reply - Generated reply
+ * @returns ticket - Escalation ticket
+ */
+export async function supportAgent(
+  execute: boolean,
+  params: { message: string },
+): Promise<{
+  onSuccess: boolean;
+  onFailure: boolean;
+  reply: string | null;
+  ticket: string | null;
+}> {
+  // @flow-weaver-body-start
+  // Generated by the compiler. Do not edit.
+  // @flow-weaver-body-end
+}
+```
+
+## CLI Reference
+
+| Command | Description |
+|---------|-------------|
+| `fw init` | Scaffold a new project with presets and templates |
+| `fw compile` | Compile workflow files to standalone TypeScript |
+| `fw validate` | Validate workflows without compiling |
+| `fw run` | Execute a workflow with optional debug mode |
+| `fw watch` | Recompile on file changes |
+| `fw dev` | Watch + compile + run loop |
+| `fw describe` | Output workflow structure as JSON, text, Mermaid, ASCII, or paths |
+| `fw diagram` | Generate SVG, HTML, or ASCII diagrams |
+| `fw diff` | Semantic diff between two workflow versions |
+| `fw export` | Export to a deploy target (Inngest, Lambda, Vercel, Cloudflare, etc.) |
+| `fw serve` | Start an HTTP server exposing workflows as endpoints |
+| `fw modify` | Programmatic graph mutations (addNode, removeNode, connect, etc.) |
+| `fw mcp-server` | Start the MCP server for AI editor integration |
+| `fw mcp-setup` | Auto-configure MCP for Claude, Cursor, VS Code, Windsurf, or Codex |
+| `fw docs` | Browse bundled reference documentation |
+
+Run `fw --help` or `fw <command> --help` for full options.
+
+## Flow Weaver Studio (Early Beta)
+
+A browser-based visual IDE for building workflows. Canvas editor, integrated terminal, real-time diagnostics, and the full CLI available in the cloud.
+
+Studio is in early beta. Core editing is live. The visual debugger, AI chat assistant, version history, and deployment dashboard are being actively developed and will ship incrementally. The cloud platform is not yet production-ready, and paid plans are not available yet. Use it to explore and experiment, but expect rough edges.
+
+[Open Studio](https://flowweaver.ai/studio) · [Learn more](https://flowweaver.ai/features)
+
+## Weaver (Experimental)
+
+Weaver is an optional AI bot that automates the full workflow lifecycle. Give it a task in natural language and it plans, scaffolds, compiles, validates, and fixes issues in a loop until the workflow is correct. It connects to Anthropic, Claude CLI, or GitHub Copilot CLI.
+
+- `weaver bot "create a greeting workflow"` handles a task end-to-end with plan approval
+- `weaver run workflow.ts` executes a workflow with an AI agent channel attached
+- `weaver session` polls a task queue continuously for automated pipelines
+- `weaver swarm start` runs multiple bot instances in parallel, with an orchestrator dispatching tasks across them
+
+Weaver is itself built as a set of Flow Weaver workflows. Run `weaver eject` to get a local copy you can customize.
 
 ```bash
-npm install @synergenius/flow-weaver
-npx flow-weaver init
+fw market install @synergenius/flow-weaver-pack-weaver
 ```
 
-The CLI handles the rest.
+> **Weaver is experimental.** The bot, session, and swarm modes work and are being used internally, but the APIs and behavior may change between releases. Weaver is not required to use Flow Weaver. The compiler, CLI, and MCP tools are the stable foundation and work independently.
 
----
+## Documentation
+
+Reference documentation is bundled with the CLI. Run `fw docs` to browse topics, or `fw docs <topic>` to read a specific one:
+
+```bash
+fw docs list                    # List all topics
+fw docs tutorial                # Step-by-step first workflow guide
+fw docs concepts                # Core concepts
+fw docs jsdoc-grammar           # Annotation syntax reference
+fw docs cli-reference           # Full CLI command reference
+fw docs search <query>          # Search across all docs
+```
+
+**Online resources:**
+
+- [Features](https://flowweaver.ai/features)
+- [Compare with Alternatives](https://flowweaver.ai/compare)
+- [License](https://flowweaver.ai/license)
+
+## Community
+
+Flow Weaver is built and maintained by a solo developer. If you try it, find a bug, or just want to talk about workflows, the [Discord](https://discord.gg/6Byh3ur2bk) is open. Every message gets read and responded to, usually within a day.
+
+If something breaks, [open an issue](https://github.com/synergenius-fw/flow-weaver/issues). Bug reports with reproduction steps get prioritized. Feature requests are welcome too.
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
 
 ## License
 
-Licensed under the [Flow Weaver License](https://flowweaver.ai/license). See [LICENSE.md](./LICENSE.md).
+Licensed under the [Flow Weaver Library License](https://flowweaver.ai/license). See [LICENSE](./LICENSE).
+
+The license is designed to be generous for the vast majority of users while protecting the project's IP. Here is what it means in practice:
+
+**Use freely:**
+- Install, compile, validate, run, and deploy workflows in any project
+- All compiled output is fully yours with no restrictions or attribution required
+- Use in CI/CD pipelines and build systems
+- Host internally for organizations with 15 or fewer people
+- Include as a dependency in larger products where Flow Weaver is not the primary value
+
+**Requires a commercial license:**
+- Internal hosting for organizations with more than 15 people
+- Building a hosted or standalone workflow authoring product
+- Offering Flow Weaver capabilities as a managed service to third parties
+
+**Never permitted:**
+- Using source code, tests, documentation, or outputs as AI/ML training data to replicate the functionality
+- Extracting specifications to build competing software
+
+If you are unsure whether your use case needs a commercial license, reach out at support@synergenius.pt. The answer is probably "you're fine."

package/dist/cli/commands/account.d.ts

@@ -0,0 +1,4 @@
+export declare function formatLimit(used: number, limit: number): string;
+export declare function usageBar(used: number, limit: number, width?: number): string;
+export declare function accountCommand(): Promise<void>;
+//# sourceMappingURL=account.d.ts.map

package/dist/cli/commands/account.js

@@ -0,0 +1,50 @@
+import { requireLogin, fmt, exitWithError } from '../utils/cli-helpers.js';
+export function formatLimit(used, limit) {
+    if (limit === -1)
+        return `${used} (unlimited)`;
+    return `${used} / ${limit}`;
+}
+export function usageBar(used, limit, width = 20) {
+    if (limit === -1)
+        return '\x1b[36m∞\x1b[0m';
+    if (limit <= 0)
+        return '\x1b[2m-\x1b[0m';
+    const ratio = Math.min(used / limit, 1);
+    const filled = Math.round(ratio * width);
+    const empty = width - filled;
+    const color = ratio >= 0.9 ? '\x1b[31m' : ratio >= 0.7 ? '\x1b[33m' : '\x1b[32m';
+    return `${color}${'█'.repeat(filled)}\x1b[2m${'░'.repeat(empty)}\x1b[0m`;
+}
+export async function accountCommand() {
+    const { creds, client } = requireLogin();
+    try {
+        const [user, usage] = await Promise.all([
+            client.getUser(),
+            client.getDetailedUsage().catch(() => null),
+        ]);
+        console.log('');
+        console.log(`  ${fmt.bold(user.name)}`);
+        console.log(`  ${user.email}`);
+        console.log(`  Plan: ${user.plan}`);
+        console.log(`  Platform: ${fmt.dim(creds.platformUrl)}`);
+        if (usage) {
+            console.log('');
+            const rows = [
+                { label: 'Workflows', ...usage.usage.workflows },
+                { label: 'Deployments', ...usage.usage.deployments },
+                { label: 'Executions', ...usage.usage.executions },
+            ];
+            for (const row of rows) {
+                const bar = usageBar(row.used, row.limit);
+                const nums = formatLimit(row.used, row.limit);
+                console.log(`  ${row.label.padEnd(14)} ${bar}  ${nums}`);
+            }
+            console.log(`  ${'Timeout'.padEnd(14)} ${usage.limits.timeoutMs / 1000}s per run`);
+        }
+        console.log('');
+    }
+    catch (err) {
+        exitWithError(err, 'Failed to fetch account');
+    }
+}
+//# sourceMappingURL=account.js.map

package/dist/cli/commands/ai-credentials.d.ts

@@ -0,0 +1,12 @@
+export declare function aiAddCommand(provider: string, options: {
+    key?: string;
+    label?: string;
+    model?: string;
+    default?: boolean;
+}): Promise<void>;
+export declare function aiListCommand(): Promise<void>;
+export declare function aiRevokeCommand(id: string, options: {
+    force?: boolean;
+}): Promise<void>;
+export declare function aiTestCommand(id: string): Promise<void>;
+//# sourceMappingURL=ai-credentials.d.ts.map

package/dist/cli/commands/ai-credentials.js

@@ -0,0 +1,95 @@
+import { requireLogin, readLine, confirm, fmt, exitWithError } from '../utils/cli-helpers.js';
+const VALID_PROVIDERS = ['anthropic', 'openai'];
+export async function aiAddCommand(provider, options) {
+    const { client } = requireLogin();
+    try {
+        if (!VALID_PROVIDERS.includes(provider)) {
+            throw new Error(`Invalid provider "${provider}". Use: ${VALID_PROVIDERS.join(', ')}`);
+        }
+        // Read key from --key flag or prompt via stdin (non-TTY requires --key)
+        let apiKey = options.key;
+        if (!apiKey) {
+            apiKey = await readLine('  Enter API key: ') ?? undefined;
+            if (!apiKey) {
+                throw new Error('No API key provided. Use --key <key> or run in a terminal.');
+            }
+        }
+        const label = options.label ?? `${provider} key`;
+        const cred = await client.createAiCredential({
+            provider,
+            label,
+            apiKey,
+            defaultModel: options.model,
+            isDefault: options.default,
+        });
+        console.log('');
+        console.log(fmt.ok('Credential added'));
+        console.log('');
+        console.log(`  Provider: ${cred.provider}`);
+        console.log(`  Label:    ${cred.label}`);
+        console.log(`  ID:       ${fmt.dim(cred.id)}`);
+        console.log('');
+        console.log(`  Test it:  fw ai test ${cred.id}`);
+        console.log('');
+    }
+    catch (err) {
+        exitWithError(err, 'Failed to add credential');
+    }
+}
+export async function aiListCommand() {
+    const { client } = requireLogin();
+    try {
+        const creds = await client.listAiCredentials();
+        console.log('');
+        if (creds.length === 0) {
+            console.log('  No AI credentials. Add one with: fw ai add <provider>');
+        }
+        else {
+            console.log(`  ${creds.length} credential${creds.length === 1 ? '' : 's'}:`);
+            console.log('');
+            for (const c of creds) {
+                const def = c.isDefault ? ` ${fmt.yellow('★ default')}` : '';
+                const model = c.defaultModel ? ` ${fmt.dim(`(${c.defaultModel})`)}` : '';
+                console.log(`    ${fmt.cyan(c.provider.padEnd(10))} ${c.label}${model}${def}  ${fmt.dim(c.id)}`);
+            }
+        }
+        console.log('');
+    }
+    catch (err) {
+        exitWithError(err, 'Failed to list credentials');
+    }
+}
+export async function aiRevokeCommand(id, options) {
+    const { client } = requireLogin();
+    if (!options.force) {
+        const confirmed = await confirm('  Are you sure? This cannot be undone. [y/N] ');
+        if (!confirmed) {
+            console.log('  Cancelled.');
+            return;
+        }
+    }
+    try {
+        await client.revokeAiCredential(id);
+        console.log(fmt.ok('Credential revoked'));
+    }
+    catch (err) {
+        exitWithError(err, 'Failed to revoke credential');
+    }
+}
+export async function aiTestCommand(id) {
+    const { client } = requireLogin();
+    try {
+        console.log(`  ${fmt.dim('Testing credential...')}`);
+        const result = await client.testAiCredential(id);
+        if (result.success) {
+            console.log(fmt.ok('Credential is valid'));
+        }
+        else {
+            console.log(fmt.err(`Credential test failed${result.message ? `: ${result.message}` : ''}`));
+        }
+    }
+    catch (err) {
+        exitWithError(err, 'Test failed');
+    }
+}
+//# sourceMappingURL=ai-credentials.js.map

package/dist/cli/commands/apikey.d.ts

@@ -0,0 +1,4 @@
+export declare function apiKeyCreateCommand(name: string): Promise<void>;
+export declare function apiKeyListCommand(): Promise<void>;
+export declare function apiKeyRevokeCommand(idOrPrefix: string): Promise<void>;
+//# sourceMappingURL=apikey.d.ts.map

package/dist/cli/commands/apikey.js

@@ -0,0 +1,64 @@
+import { requireLogin, isUuid, fmt, exitWithError } from '../utils/cli-helpers.js';
+export async function apiKeyCreateCommand(name) {
+    const { client } = requireLogin();
+    try {
+        const apiKey = await client.createApiKey(name);
+        console.log('');
+        console.log(fmt.ok('API key created'));
+        console.log('');
+        console.log(`  Name:   ${apiKey.name}`);
+        console.log(`  Key:    ${fmt.bold(apiKey.key)}`);
+        console.log(`  Prefix: ${apiKey.keyPrefix}`);
+        console.log('');
+        console.log(`  ${fmt.yellow('⚠')} Copy this key now — it cannot be shown again.`);
+        console.log('');
+    }
+    catch (err) {
+        exitWithError(err, 'Failed to create API key');
+    }
+}
+export async function apiKeyListCommand() {
+    const { client } = requireLogin();
+    try {
+        const keys = await client.listApiKeys();
+        console.log('');
+        if (keys.length === 0) {
+            console.log('  No API keys. Create one with: fw apikey create <name>');
+        }
+        else {
+            console.log(`  ${keys.length} API key${keys.length === 1 ? '' : 's'}:`);
+            console.log('');
+            for (const key of keys) {
+                const date = new Date(key.createdAt).toLocaleDateString();
+                console.log(`    ${fmt.cyan(key.keyPrefix + '...')}  ${key.name.padEnd(20)}  ${date}  ${fmt.dim(key.id)}`);
+            }
+        }
+        console.log('');
+    }
+    catch (err) {
+        exitWithError(err, 'Failed to list API keys');
+    }
+}
+export async function apiKeyRevokeCommand(idOrPrefix) {
+    const { client } = requireLogin();
+    try {
+        let id = idOrPrefix;
+        if (!isUuid(idOrPrefix)) {
+            const keys = await client.listApiKeys();
+            const match = keys.filter((k) => k.keyPrefix.startsWith(idOrPrefix) || k.id.startsWith(idOrPrefix));
+            if (match.length === 0) {
+                throw new Error(`No API key matching "${idOrPrefix}"`);
+            }
+            if (match.length > 1) {
+                throw new Error(`Ambiguous: "${idOrPrefix}" matches ${match.length} keys. Use the full ID.`);
+            }
+            id = match[0].id;
+        }
+        await client.revokeApiKey(id);
+        console.log(fmt.ok('API key revoked'));
+    }
+    catch (err) {
+        exitWithError(err, 'Failed to revoke API key');
+    }
+}
+//# sourceMappingURL=apikey.js.map

package/dist/cli/commands/auth.d.ts

@@ -1,5 +1,6 @@
 export declare function loginCommand(options: {
     email?: string;
+    password?: string;
     apiKey?: string;
     platformUrl?: string;
 }): Promise<void>;

package/dist/cli/commands/auth.js

@@ -1,11 +1,12 @@
 import * as readline from 'node:readline';
 import { loadCredentials, saveCredentials, clearCredentials, getPlatformUrl } from '../config/credentials.js';
 import { PlatformClient } from '../config/platform-client.js';
+import { fmt } from '../utils/cli-helpers.js';
 export async function loginCommand(options) {
     const platformUrl = options.platformUrl ?? getPlatformUrl();
     const displayUrl = platformUrl.replace(/^https?:\/\//, '');
     console.log('');
-    console.log(`  \x1b[1mFlow Weaver\x1b[0m \x1b[2m(${displayUrl})\x1b[0m`);
+    console.log(`  ${fmt.bold('Flow Weaver')} ${fmt.dim(`(${displayUrl})`)}`);
     console.log('');
     // API key mode (for CI/headless)
     if (options.apiKey) {
@@ -14,7 +15,7 @@ export async function loginCommand(options) {
     }
     // Email mode (explicit --email flag)
     if (options.email) {
-        await loginWithEmail(options.email, platformUrl);
+        await loginWithEmail(options.email, platformUrl, options.password);
         return;
     }
     // Default: browser-first device auth
@@ -148,17 +149,17 @@ async function loginWithApiKey(apiKey, platformUrl) {
         userId = user.id;
     }
     catch {
-        console.error('  \x1b[31m✗\x1b[0m Invalid API key');
+        console.error(fmt.err('Invalid API key'));
         process.exit(1);
         return;
     }
     const expiresAt = Date.now() + 365 * 24 * 60 * 60 * 1000; // 1 year for API keys
     saveCredentials({ token: apiKey, email, plan: plan, platformUrl, expiresAt, userId });
-    console.log(`  \x1b[32m✓\x1b[0m Logged in as \x1b[1m${email}\x1b[0m (${plan} plan)`);
+    console.log(fmt.ok(`Logged in as ${fmt.bold(email)} (${plan} plan)`));
     console.log('');
 }
-async function loginWithEmail(email, platformUrl) {
-    const password = await prompt('  Password: ', true);
+async function loginWithEmail(email, platformUrl, passwordFlag) {
+    const password = passwordFlag ?? await prompt('  Password: ', true);
     try {
         const resp = await fetch(`${platformUrl}/auth/login`, {
             method: 'POST',
@@ -192,28 +193,27 @@ async function loginWithEmail(email, platformUrl) {
 }
 export async function logoutCommand() {
     clearCredentials();
-    console.log('  \x1b[32m✓\x1b[0m Logged out');
+    console.log(fmt.ok('Logged out'));
 }
 export async function authStatusCommand() {
     const creds = loadCredentials();
     if (!creds) {
         console.log('');
-        console.log('  Not logged in.');
-        console.log('  Run: \x1b[36mfw login\x1b[0m');
+        console.log(fmt.err(`Not logged in. Run: ${fmt.cyan('fw login')}`));
         console.log('');
-        return;
+        process.exit(1);
     }
     const expiresIn = Math.floor((creds.expiresAt - Date.now()) / 1000 / 60 / 60);
     console.log('');
-    console.log(`  \x1b[32m✓\x1b[0m Logged in as \x1b[1m${creds.email}\x1b[0m`);
+    console.log(fmt.ok(`Logged in as ${fmt.bold(creds.email)}`));
     console.log(`  Plan: ${creds.plan}`);
-    console.log(`  Platform: ${creds.platformUrl}`);
+    console.log(`  Platform: ${fmt.dim(creds.platformUrl)}`);
     console.log(`  Token expires in: ${expiresIn}h`);
     console.log('');
     console.log('  Commands unlocked:');
-    console.log('    \x1b[36mfw deploy <file>\x1b[0m         deploy to cloud');
-    console.log('    \x1b[36mfw cloud-status\x1b[0m          see deployments + usage');
-    console.log('    \x1b[36mweaver assistant\x1b[0m          AI with platform credits');
+    console.log(`    ${fmt.cyan('fw deploy <file>')}         deploy to cloud`);
+    console.log(`    ${fmt.cyan('fw cloud-status')}          see deployments + usage`);
+    console.log(`    ${fmt.cyan('weaver assistant')}          AI with platform credits`);
     console.log('');
 }
 function prompt(message, hidden = false) {

package/dist/cli/commands/deploy.js

@@ -1,31 +1,22 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { loadCredentials } from '../config/credentials.js';
-import { PlatformClient } from '../config/platform-client.js';
+import { requireLogin, fmt, exitWithError } from '../utils/cli-helpers.js';
 export async function deployCommand(filePath, options = {}) {
-    const creds = loadCredentials();
-    if (!creds) {
-        console.error('  \x1b[31m✗\x1b[0m Not logged in. Run: fw login');
-        process.exit(1);
-        return;
-    }
+    const { creds, client } = requireLogin();
     const absPath = path.resolve(filePath);
     if (!fs.existsSync(absPath)) {
-        console.error(`  \x1b[31m✗\x1b[0m File not found: ${filePath}`);
-        process.exit(1);
-        return;
+        exitWithError(new Error(`File not found: ${filePath}`), 'File not found');
     }
     const source = fs.readFileSync(absPath, 'utf-8');
     const name = options.name ?? path.basename(filePath, path.extname(filePath));
-    const client = new PlatformClient(creds);
     console.log('');
-    console.log(`  \x1b[2mPushing ${name}...\x1b[0m`);
+    console.log(`  ${fmt.dim(`Pushing ${name}...`)}`);
     try {
         const workflow = await client.pushWorkflow(name, source);
-        console.log(`  \x1b[32m✓\x1b[0m Pushed (v${workflow.version})`);
-        console.log(`  \x1b[2mDeploying...\x1b[0m`);
+        console.log(fmt.ok(`Pushed (v${workflow.version})`));
+        console.log(`  ${fmt.dim('Deploying...')}`);
         const deployment = await client.deploy(workflow.slug);
-        console.log(`  \x1b[32m✓\x1b[0m Deployed: ${deployment.slug}`);
+        console.log(fmt.ok(`Deployed: ${deployment.slug}`));
         console.log('');
         console.log(`  Endpoint: ${creds.platformUrl}/run/${deployment.slug}`);
         console.log('');
@@ -37,37 +28,23 @@ export async function deployCommand(filePath, options = {}) {
         console.log('');
     }
     catch (err) {
-        console.error(`  \x1b[31m✗\x1b[0m ${err instanceof Error ? err.message : 'Deploy failed'}`);
-        process.exit(1);
+        exitWithError(err, 'Deploy failed');
     }
 }
 export async function undeployCommand(slug) {
-    const creds = loadCredentials();
-    if (!creds) {
-        console.error('  \x1b[31m✗\x1b[0m Not logged in.');
-        process.exit(1);
-        return;
-    }
-    const client = new PlatformClient(creds);
+    const { client } = requireLogin();
     try {
         await client.undeploy(slug);
-        console.log(`  \x1b[32m✓\x1b[0m Undeployed: ${slug}`);
+        console.log(fmt.ok(`Undeployed: ${slug}`));
     }
     catch (err) {
-        console.error(`  \x1b[31m✗\x1b[0m ${err instanceof Error ? err.message : 'Undeploy failed'}`);
+        exitWithError(err, 'Undeploy failed');
     }
 }
 export async function cloudStatusCommand() {
-    const creds = loadCredentials();
-    if (!creds) {
-        console.log('');
-        console.log('  Not logged in. Run: \x1b[36mfw login\x1b[0m');
-        console.log('');
-        return;
-    }
-    const client = new PlatformClient(creds);
+    const { creds, client } = requireLogin();
     console.log('');
-    console.log(`  \x1b[1m${creds.email}\x1b[0m \x1b[2m(${creds.plan} plan)\x1b[0m`);
+    console.log(`  ${fmt.bold(creds.email)} ${fmt.dim(`(${creds.plan} plan)`)}`);
     console.log('');
     try {
         const deployments = await client.listDeployments();
@@ -83,7 +60,7 @@ export async function cloudStatusCommand() {
         }
     }
     catch {
-        console.log('  \x1b[33m⚠\x1b[0m Could not fetch deployments');
+        console.log(`  ${fmt.yellow('⚠')} Could not fetch deployments`);
     }
     try {
         const usage = await client.getUsage();

package/dist/cli/commands/org.d.ts

@@ -0,0 +1,8 @@
+export declare function orgListCommand(): Promise<void>;
+export declare function orgCreateCommand(name: string): Promise<void>;
+export declare function orgMembersCommand(identifier: string): Promise<void>;
+export declare function orgInviteCommand(identifier: string, email: string, options: {
+    role?: string;
+}): Promise<void>;
+export declare function orgRemoveCommand(identifier: string, userIdentifier: string): Promise<void>;
+//# sourceMappingURL=org.d.ts.map