crewly 1.0.7 → 1.0.8

package/dist/cli/backend/src/utils/file-io.utils.js

@@ -0,0 +1,214 @@
+/**
+ * Centralized Atomic File I/O Utilities
+ *
+ * Provides safe, atomic file operations for all JSON persistence in Crewly.
+ * Uses temp-file + fsync + rename to prevent corruption on crash,
+ * and in-process locks to serialize concurrent writes to the same file.
+ *
+ * @module utils/file-io.utils
+ */
+import * as fs from 'fs/promises';
+// ──────────────────────────────────────────────────────────────────────
+//  Module-level lock maps (singleton per process — no class needed)
+// ──────────────────────────────────────────────────────────────────────
+const fileLocks = new Map();
+const operationLocks = new Map();
+// ──────────────────────────────────────────────────────────────────────
+//  Directory helpers
+// ──────────────────────────────────────────────────────────────────────
+/**
+ * Ensures a directory exists, creating it recursively if necessary.
+ *
+ * @param dirPath - Absolute path to the directory
+ */
+export async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+// ──────────────────────────────────────────────────────────────────────
+//  Locking
+// ──────────────────────────────────────────────────────────────────────
+/**
+ * Acquire and hold a lock from the given map for the duration of the operation.
+ *
+ * Uses promise-chaining so each caller queues behind the previous one.
+ * This avoids the race condition where multiple awaiters of the same
+ * promise all wake up and proceed past a `while` check simultaneously.
+ */
+async function withLock(lockMap, lockKey, operation) {
+    // Chain behind whatever is currently queued (or resolve immediately)
+    const prevLock = lockMap.get(lockKey) ?? Promise.resolve();
+    let releaseLock;
+    const myLock = new Promise((resolve) => { releaseLock = resolve; });
+    lockMap.set(lockKey, myLock);
+    // Wait for the previous holder to finish
+    await prevLock;
+    try {
+        return await operation();
+    }
+    finally {
+        releaseLock();
+        // Only clean up if we're still the tail of the chain
+        if (lockMap.get(lockKey) === myLock) {
+            lockMap.delete(lockKey);
+        }
+    }
+}
+/**
+ * Serialize concurrent writes to the same file.
+ *
+ * @param lockKey - Unique key for the lock (typically the file path)
+ * @param operation - Async operation to run while holding the lock
+ * @returns The result of the operation
+ */
+export async function withFileLock(lockKey, operation) {
+    return withLock(fileLocks, lockKey, operation);
+}
+/**
+ * Serialize read-modify-write cycles on a logical resource.
+ *
+ * Uses a separate lock map from {@link withFileLock} so that callers
+ * can hold an operation lock across a read + write without deadlocking
+ * on the inner file lock.
+ *
+ * @param lockKey - Unique key for the lock
+ * @param operation - Async operation to run while holding the lock
+ * @returns The result of the operation
+ */
+export async function withOperationLock(lockKey, operation) {
+    return withLock(operationLocks, lockKey, operation);
+}
+// ──────────────────────────────────────────────────────────────────────
+//  Atomic write
+// ──────────────────────────────────────────────────────────────────────
+/**
+ * Write a string to a file atomically (temp file → fsync → rename).
+ *
+ * Acquires a per-path file lock so concurrent callers targeting the
+ * same path are serialized.
+ *
+ * **Precondition:** The parent directory must already exist. This function
+ * does not create intermediate directories — use {@link ensureDir} first
+ * if the directory may not exist.
+ *
+ * @param filePath - Destination file path
+ * @param content - String content to write
+ */
+export async function atomicWriteFile(filePath, content) {
+    await withFileLock(filePath, async () => {
+        const tempPath = `${filePath}.tmp.${Date.now()}.${Math.random().toString(36).substring(2)}`;
+        try {
+            await fs.writeFile(tempPath, content, 'utf8');
+            // Ensure data hits the disk before the atomic rename
+            const handle = await fs.open(tempPath, 'r+');
+            await handle.sync();
+            await handle.close();
+            await fs.rename(tempPath, filePath);
+        }
+        catch (error) {
+            // Clean up temp file on failure
+            try {
+                await fs.unlink(tempPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw error;
+        }
+    });
+}
+/**
+ * Serialize a JavaScript value to JSON and write it atomically.
+ *
+ * @param filePath - Destination file path
+ * @param data - Value to serialize (via `JSON.stringify`)
+ */
+export async function atomicWriteJson(filePath, data) {
+    await atomicWriteFile(filePath, JSON.stringify(data, null, 2));
+}
+// ──────────────────────────────────────────────────────────────────────
+//  Safe read
+// ──────────────────────────────────────────────────────────────────────
+/**
+ * Read and parse a JSON file safely.
+ *
+ * - On `ENOENT` → returns `defaultValue` silently.
+ * - On parse error → backs up the corrupt file as `<path>.corrupt.<ts>`
+ *   and returns `defaultValue`.
+ *
+ * @param filePath - Path to the JSON file
+ * @param defaultValue - Value to return when the file is missing or corrupt
+ * @param logger - Optional logger for warnings on corruption
+ * @returns Parsed value or `defaultValue`
+ */
+export async function safeReadJson(filePath, defaultValue, logger) {
+    let raw;
+    try {
+        raw = await fs.readFile(filePath, 'utf-8');
+    }
+    catch (error) {
+        // File does not exist — totally normal, return default
+        if (error.code === 'ENOENT') {
+            return defaultValue;
+        }
+        throw error; // Permission errors etc. should bubble
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        // Corrupt JSON — back up the file so we can debug later
+        const backupPath = `${filePath}.corrupt.${Date.now()}`;
+        try {
+            await fs.copyFile(filePath, backupPath);
+            logger?.warn('Backed up corrupt JSON file', { filePath, backupPath });
+        }
+        catch {
+            logger?.warn('Failed to back up corrupt JSON file', { filePath });
+        }
+        return defaultValue;
+    }
+}
+// ──────────────────────────────────────────────────────────────────────
+//  Read-modify-write helper
+// ──────────────────────────────────────────────────────────────────────
+/**
+ * Locked read → mutate → atomic write cycle.
+ *
+ * This is the most common persistence pattern: load a JSON file,
+ * apply a mutation, and write it back atomically — all while holding
+ * an operation lock to prevent concurrent read-modify-write races.
+ *
+ * **Important:** If the mutator returns `undefined` (void), the mutated
+ * `data` object is written back. If it returns any other value — including
+ * falsy values like `null`, `0`, or `false` — that value is written instead.
+ * Beware of methods like `Array.push()` which return a number: an accidental
+ * `return records.push(item)` will write the array length to the file.
+ *
+ * @param filePath - Path to the JSON file
+ * @param defaultValue - Value to use if the file is missing or corrupt
+ * @param mutator - Function that receives the current data and mutates it in place (or returns new data)
+ * @param logger - Optional logger
+ * @returns The value returned by `mutator` (or void)
+ */
+export async function modifyJsonFile(filePath, defaultValue, mutator, logger) {
+    return withOperationLock(filePath, async () => {
+        const data = await safeReadJson(filePath, defaultValue, logger);
+        const result = await mutator(data);
+        // If mutator returns undefined (void), write the mutated data in place;
+        // otherwise write the returned value (including null, 0, false, etc.)
+        const toWrite = result === undefined ? data : result;
+        await atomicWriteJson(filePath, toWrite);
+        return result;
+    });
+}
+// ──────────────────────────────────────────────────────────────────────
+//  Test helper
+// ──────────────────────────────────────────────────────────────────────
+/**
+ * Reset all lock maps. **Test-only** — never call in production.
+ */
+export function _clearAllLocks() {
+    fileLocks.clear();
+    operationLocks.clear();
+}
+//# sourceMappingURL=file-io.utils.js.map

package/dist/cli/backend/src/utils/file-io.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-io.utils.js","sourceRoot":"","sources":["../../../../../backend/src/utils/file-io.utils.ts"],"names":[],"mappings":"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"}

package/dist/cli/backend/src/utils/terminal-output.utils.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Terminal output utilities for processing PTY output.
+ *
+ * Provides functions for stripping ANSI escape codes and deduplicating
+ * chat responses from orchestrator terminal output.
+ *
+ * @module terminal-output-utils
+ */
+/**
+ * Strip ANSI escape codes from PTY output for reliable pattern matching.
+ *
+ * Handles color codes, cursor movements, OSC sequences, and other control
+ * characters. Cursor forward movements are replaced with spaces to preserve
+ * word boundaries in rendered output.
+ *
+ * @param content - Raw PTY output containing ANSI codes
+ * @returns Clean text with ANSI codes removed
+ */
+export declare function stripAnsiCodes(content: string): string;
+/**
+ * Generate a hash key for a chat response to detect duplicates.
+ *
+ * Normalizes whitespace and truncates to create a consistent key
+ * for the same logical response content.
+ *
+ * @param conversationId - The conversation this response belongs to
+ * @param content - The response content to hash
+ * @returns A string key for deduplication
+ */
+export declare function generateResponseHash(conversationId: string, content: string): string;
+/**
+ * Manages a set of recent response hashes for deduplication.
+ * Uses a circular eviction strategy to bound memory usage.
+ */
+export declare class ResponseDeduplicator {
+    private recentHashes;
+    private readonly maxSize;
+    /**
+     * @param maxSize - Maximum number of hashes to track before evicting oldest
+     */
+    constructor(maxSize?: number);
+    /**
+     * Check if a response is a duplicate and track it if not.
+     *
+     * @param hash - The response hash to check
+     * @returns true if the response is a duplicate, false if it's new
+     */
+    isDuplicate(hash: string): boolean;
+    /** Clear all tracked hashes */
+    clear(): void;
+    /** Current number of tracked hashes */
+    get size(): number;
+}
+//# sourceMappingURL=terminal-output.utils.d.ts.map

package/dist/cli/backend/src/utils/terminal-output.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-output.utils.d.ts","sourceRoot":"","sources":["../../../../../backend/src/utils/terminal-output.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsBtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpF;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC;;OAEG;gBACS,OAAO,GAAE,MAAW;IAIhC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAclC,+BAA+B;IAC/B,KAAK,IAAI,IAAI;IAIb,uCAAuC;IACvC,IAAI,IAAI,IAAI,MAAM,CAEjB;CACD"}

package/dist/cli/backend/src/utils/terminal-output.utils.js

@@ -0,0 +1,97 @@
+/**
+ * Terminal output utilities for processing PTY output.
+ *
+ * Provides functions for stripping ANSI escape codes and deduplicating
+ * chat responses from orchestrator terminal output.
+ *
+ * @module terminal-output-utils
+ */
+/**
+ * Strip ANSI escape codes from PTY output for reliable pattern matching.
+ *
+ * Handles color codes, cursor movements, OSC sequences, and other control
+ * characters. Cursor forward movements are replaced with spaces to preserve
+ * word boundaries in rendered output.
+ *
+ * @param content - Raw PTY output containing ANSI codes
+ * @returns Clean text with ANSI codes removed
+ */
+export function stripAnsiCodes(content) {
+    return content
+        // Replace cursor forward movements with a space (\d* is safe here because \x1b prefix
+        // prevents false matches with text like [CHAT_RESPONSE]; orphaned CSI below uses \d+)
+        .replace(/\x1b\[\d*C/g, ' ')
+        // Remove other CSI sequences (colors, cursor positioning, etc.)
+        .replace(/\x1b\[[0-9;]*[A-Za-zH]/g, '')
+        // Remove OSC sequences (title changes, hyperlinks, etc.)
+        .replace(/\x1b\][^\x07]*\x07/g, '')
+        // Remove other escape sequences
+        .replace(/\x1b[^[\]].?/g, '')
+        // Clean orphaned CSI fragments from PTY buffer boundary splits.
+        // When ESC char lands in one chunk and the CSI params in the next,
+        // artifacts like "[1C", "[22m", or "[38;2;249;226;175m" appear mid-word.
+        // Note: \d+ (one or more digits) required to avoid matching [C in [CHAT_RESPONSE]
+        .replace(/\[\d+C/g, ' ')
+        .replace(/\[\d+(?:;\d+)*[A-BJKHfm]/g, '')
+        // Replace carriage returns with newline (CR/LF normalization)
+        .replace(/\r\n/g, '\n')
+        .replace(/\r/g, '\n')
+        // Remove remaining control characters but keep tabs and newlines
+        .replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '');
+}
+/**
+ * Generate a hash key for a chat response to detect duplicates.
+ *
+ * Normalizes whitespace and truncates to create a consistent key
+ * for the same logical response content.
+ *
+ * @param conversationId - The conversation this response belongs to
+ * @param content - The response content to hash
+ * @returns A string key for deduplication
+ */
+export function generateResponseHash(conversationId, content) {
+    const normalized = content.replace(/\s+/g, ' ').trim();
+    return `${conversationId}:${normalized.substring(0, 200)}`;
+}
+/**
+ * Manages a set of recent response hashes for deduplication.
+ * Uses a circular eviction strategy to bound memory usage.
+ */
+export class ResponseDeduplicator {
+    recentHashes = new Set();
+    maxSize;
+    /**
+     * @param maxSize - Maximum number of hashes to track before evicting oldest
+     */
+    constructor(maxSize = 20) {
+        this.maxSize = maxSize;
+    }
+    /**
+     * Check if a response is a duplicate and track it if not.
+     *
+     * @param hash - The response hash to check
+     * @returns true if the response is a duplicate, false if it's new
+     */
+    isDuplicate(hash) {
+        if (this.recentHashes.has(hash)) {
+            return true;
+        }
+        this.recentHashes.add(hash);
+        if (this.recentHashes.size > this.maxSize) {
+            const first = this.recentHashes.values().next().value;
+            if (first !== undefined) {
+                this.recentHashes.delete(first);
+            }
+        }
+        return false;
+    }
+    /** Clear all tracked hashes */
+    clear() {
+        this.recentHashes.clear();
+    }
+    /** Current number of tracked hashes */
+    get size() {
+        return this.recentHashes.size;
+    }
+}
+//# sourceMappingURL=terminal-output.utils.js.map

package/dist/cli/backend/src/utils/terminal-output.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-output.utils.js","sourceRoot":"","sources":["../../../../../backend/src/utils/terminal-output.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC7C,OAAO,OAAO;QACb,sFAAsF;QACtF,sFAAsF;SACrF,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;QAC5B,gEAAgE;SAC/D,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC;QACvC,yDAAyD;SACxD,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC;QACnC,gCAAgC;SAC/B,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;QAC7B,gEAAgE;QAChE,mEAAmE;QACnE,yEAAyE;QACzE,kFAAkF;SACjF,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC;QACzC,8DAA8D;SAC7D,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;QACrB,iEAAiE;SAChE,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,cAAsB,EAAE,OAAe;IAC3E,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,OAAO,GAAG,cAAc,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACxB,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACxB,OAAO,CAAS;IAEjC;;OAEG;IACH,YAAY,UAAkB,EAAE;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,IAAY;QACvB,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACb,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACtD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;QACF,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,+BAA+B;IAC/B,KAAK;QACJ,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,uCAAuC;IACvC,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;IAC/B,CAAC;CACD"}

package/dist/cli/cli/src/commands/mcp-server.d.ts

@@ -0,0 +1,38 @@
+/**
+ * CLI command: crewly mcp-server
+ *
+ * Starts the Crewly MCP Server on stdio transport so that external AI tools
+ * (Claude Code, Cursor, Windsurf, etc.) can manage Crewly teams via MCP.
+ *
+ * Usage:
+ *   crewly mcp-server
+ *
+ * Claude Code configuration example:
+ *   Add to ~/.claude.json or project .mcp.json:
+ *   {
+ *     "mcpServers": {
+ *       "crewly": {
+ *         "command": "npx",
+ *         "args": ["crewly", "mcp-server"]
+ *       }
+ *     }
+ *   }
+ *
+ * @module commands/mcp-server
+ */
+/**
+ * Start the Crewly MCP Server on stdio transport.
+ *
+ * The server exposes Crewly capabilities as MCP tools:
+ * - crewly_get_teams: List all teams
+ * - crewly_create_team: Create a new team
+ * - crewly_assign_task: Assign task to an agent
+ * - crewly_get_status: Get team/agent status
+ * - crewly_recall_memory: Search team memory
+ * - crewly_send_message: Send message to orchestrator
+ *
+ * Runs on stdio (stdin/stdout) for MCP protocol communication.
+ * The process stays alive until the client disconnects.
+ */
+export declare function mcpServerCommand(): Promise<void>;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/cli/cli/src/commands/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../../../cli/src/commands/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAatD"}

package/dist/cli/cli/src/commands/mcp-server.js

@@ -0,0 +1,49 @@
+/**
+ * CLI command: crewly mcp-server
+ *
+ * Starts the Crewly MCP Server on stdio transport so that external AI tools
+ * (Claude Code, Cursor, Windsurf, etc.) can manage Crewly teams via MCP.
+ *
+ * Usage:
+ *   crewly mcp-server
+ *
+ * Claude Code configuration example:
+ *   Add to ~/.claude.json or project .mcp.json:
+ *   {
+ *     "mcpServers": {
+ *       "crewly": {
+ *         "command": "npx",
+ *         "args": ["crewly", "mcp-server"]
+ *       }
+ *     }
+ *   }
+ *
+ * @module commands/mcp-server
+ */
+import { CrewlyMcpServer } from '../../../backend/src/services/mcp-server.js';
+/**
+ * Start the Crewly MCP Server on stdio transport.
+ *
+ * The server exposes Crewly capabilities as MCP tools:
+ * - crewly_get_teams: List all teams
+ * - crewly_create_team: Create a new team
+ * - crewly_assign_task: Assign task to an agent
+ * - crewly_get_status: Get team/agent status
+ * - crewly_recall_memory: Search team memory
+ * - crewly_send_message: Send message to orchestrator
+ *
+ * Runs on stdio (stdin/stdout) for MCP protocol communication.
+ * The process stays alive until the client disconnects.
+ */
+export async function mcpServerCommand() {
+    const server = new CrewlyMcpServer();
+    // Handle graceful shutdown
+    const shutdown = async () => {
+        await server.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    await server.start();
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/cli/cli/src/commands/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../../../../../cli/src/commands/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IAErC,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC"}

package/dist/cli/cli/src/commands/onboard.d.ts

@@ -8,11 +8,22 @@
  * Used directly via `crewly onboard`, by the curl install script, and
  * by the Electron desktop app.
  *
+ * Supports non-interactive mode via `--yes` flag and direct template
+ * selection via `--template <id>`.
+ *
  * @module cli/commands/onboard
  */
 import { type Interface as ReadlineInterface } from 'readline';
+import { type TeamTemplate } from '../utils/templates.js';
 /** Provider choice returned by the selection step */
 export type ProviderChoice = 'claude' | 'gemini' | 'both' | 'skip';
+/** Options passed from Commander.js for the onboard command */
+export interface OnboardOptions {
+    /** Skip all interactive prompts and use defaults */
+    yes?: boolean;
+    /** Select a team template by ID (e.g. "web-dev-team") */
+    template?: string;
+}
 /**
  * Prints the Crewly ASCII art banner to stdout.
  */
@@ -59,12 +70,14 @@ export declare function installTool(displayName: string, npmPackage: string): bo
  * Checks for and optionally installs the tools needed for the selected provider.
  *
  * For each required tool, checks if it's on the PATH. If missing, asks the user
- * whether to install it via npm.
+ * whether to install it via npm. In non-interactive (--yes) mode, automatically
+ * installs missing tools.
  *
  * @param rl - Readline interface
  * @param provider - The chosen provider
+ * @param autoYes - When true, skip prompts and install missing tools automatically
  */
-export declare function ensureTools(rl: ReadlineInterface, provider: ProviderChoice): Promise<void>;
+export declare function ensureTools(rl: ReadlineInterface, provider: ProviderChoice, autoYes?: boolean): Promise<void>;
 /**
  * Checks for and installs agent skills from the marketplace.
  *
@@ -72,18 +85,59 @@ export declare function ensureTools(rl: ReadlineInterface, provider: ProviderCho
  * and installs all skills with progress feedback.
  */
 export declare function ensureSkills(): Promise<void>;
+/**
+ * Asks the user to pick a pre-built team template.
+ *
+ * Displays available templates with descriptions. The user can pick one
+ * or skip to configure their team later through the dashboard.
+ *
+ * @param rl - Readline interface
+ * @returns The selected template, or null if skipped
+ */
+export declare function selectTemplate(rl: ReadlineInterface): Promise<TeamTemplate | null>;
+/**
+ * Scaffolds the .crewly/ directory in the current working directory.
+ *
+ * Creates the minimum directory structure needed for `crewly start` to work:
+ * - .crewly/
+ * - .crewly/docs/
+ * - .crewly/memory/
+ * - .crewly/tasks/
+ * - .crewly/teams/
+ *
+ * If the directory already exists, reports it and moves on.
+ *
+ * @param projectDir - The project root directory (defaults to process.cwd())
+ * @returns True if the directory was created or already existed
+ */
+export declare function scaffoldCrewlyDirectory(projectDir?: string): boolean;
 /**
  * Prints the setup-complete summary with next-step instructions.
+ *
+ * If a team template was selected, includes instructions on how to
+ * create the team from the dashboard.
+ *
+ * @param selectedTemplate - The template chosen during onboarding, or null
+ * @param projectDir - The project directory path for next-steps output
  */
-export declare function printSummary(): void;
+export declare function printSummary(selectedTemplate?: TeamTemplate | null, projectDir?: string): void;
 /**
- * Runs the interactive onboarding wizard.
+ * Runs the onboarding wizard.
  *
- * Walks the user through 4 steps:
+ * In interactive mode (default), walks the user through 5 steps:
  * 1. Choose an AI provider (Claude Code, Gemini CLI, both, or skip)
  * 2. Detect / install the chosen tool(s)
  * 3. Install agent skills from the marketplace
- * 4. Print a success summary
+ * 4. Pick a team template (or skip)
+ * 5. Print a success summary
+ *
+ * In non-interactive mode (--yes), uses defaults:
+ * - Provider: claude
+ * - Auto-install missing tools
+ * - First available template (or --template flag)
+ * - Scaffold .crewly/ directory
+ *
+ * @param options - Command options from Commander.js
  */
-export declare function onboardCommand(): Promise<void>;
+export declare function onboardCommand(options?: OnboardOptions): Promise<void>;
 //# sourceMappingURL=onboard.d.ts.map

package/dist/cli/cli/src/commands/onboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../../../../cli/src/commands/onboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAmB,KAAK,SAAS,IAAI,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAQhF,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAInE;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC;AAID;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAK3D;AAmBD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwBnF;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAO3D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,SAAc,GAAG,MAAM,GAAG,IAAI,CAYxF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAc5E;AAwBD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,iBAAiB,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhG;AAID;;;;;GAKG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA4BlD;AAID;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAMnC;AAID;;;;;;;;GAQG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAoBpD"}
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../../../../cli/src/commands/onboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAmB,KAAK,SAAS,IAAI,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAShF,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAE/B,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnE,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC;AAID;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAK3D;AAmBD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwBnF;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAO3D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,SAAc,GAAG,MAAM,GAAG,IAAI,CAYxF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAc5E;AAwBD;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,iBAAiB,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BjH;AAID;;;;;GAKG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA4BlD;AAID;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAoCxF;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,GAAE,MAAsB,GAAG,OAAO,CA2BnF;AAID;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,gBAAgB,GAAE,YAAY,GAAG,IAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAoBpG;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmFhF"}