fleet-commander-ai 0.0.1

package/dist/server/services/team-manager.d.ts

@@ -0,0 +1,188 @@
+import type { Writable } from 'stream';
+import type { StreamEvent } from './sse-broker.js';
+import type { Team } from '../../shared/types.js';
+export declare class TeamManager {
+    private outputBuffers;
+    private childProcesses;
+    private stdinPipes;
+    private parsedEvents;
+    private tokenCounters;
+    private _processingQueue;
+    private shutdownTimers;
+    /**
+     * Per-team map of tool_use_id -> agent name.
+     * When the TL spawns a subagent via the "Agent" or "Task" tool, the tool_use
+     * content block's `id` becomes the `parent_tool_use_id` on subsequent
+     * assistant events from that subagent. We extract the agent name from the
+     * tool input (e.g. `input.name` = "dev") and store it here so every stream
+     * event can be tagged with the originating agent name.
+     */
+    private agentMaps;
+    /** Teams currently in extended thinking — tracked in-memory only */
+    readonly thinkingTeams: Set<number>;
+    /** Timestamp when thinking started for each team (for duration tracking) */
+    private thinkingStartTimes;
+    /** Content block index of the active thinking block per team */
+    private thinkingBlockIndex;
+    /**
+     * Sync local repo with origin before creating a worktree.
+     * Returns the number of commits the local default branch was behind origin.
+     */
+    private syncWithOrigin;
+    launch(projectId: number, issueNumber: number, issueTitle?: string, prompt?: string, headless?: boolean, force?: boolean): Promise<Team>;
+    stop(teamId: number): Promise<Team>;
+    resume(teamId: number): Promise<Team>;
+    restart(teamId: number, prompt?: string): Promise<Team>;
+    stopAll(): Promise<Team[]>;
+    private queueTeam;
+    forceLaunch(teamId: number): Promise<Team>;
+    processQueue(projectId: number): Promise<void>;
+    /**
+     * Filter queued teams to only include those with no open dependencies.
+     * Teams with open dependencies are logged and tracked in the GitHubPoller
+     * for auto-launch when dependencies resolve.
+     *
+     * If a circular dependency is detected, the team is treated as unblocked
+     * to avoid deadlocking the queue.
+     *
+     * Uses the IssueFetcher's cached data when available, falling back to
+     * fresh API calls. If the dependency check fails entirely, the team is
+     * treated as unblocked (permissive fallback).
+     */
+    private filterUnblockedTeams;
+    private launchQueued;
+    getOutput(teamId: number, lines?: number): string[];
+    getParsedEvents(teamId: number): StreamEvent[];
+    /**
+     * Persist the in-memory parsed events for a team to the database.
+     * Called before clearing the in-memory buffer on process exit/stop.
+     */
+    private persistParsedEvents;
+    sendMessage(teamId: number, message: string, source?: 'user' | 'fc', subtype?: string): boolean;
+    getStdinPipe(teamId: number): Writable | undefined;
+    /**
+     * Gracefully shut down a team after its PR is merged.
+     * 1. Send pr_merged_shutdown message to TL via stdin
+     * 2. Wait graceMs for the process to exit on its own
+     * 3. If still alive: close stdin, wait 10s, then force kill
+     *
+     * Race-condition safe: the process exit handler already does cleanup,
+     * so all timer callbacks re-check childProcesses.has() before acting.
+     */
+    gracefulShutdown(teamId: number, prNumber: number, graceMs: number): void;
+    /**
+     * Clear all active shutdown timers. Called during server shutdown
+     * to prevent dangling timers.
+     */
+    clearShutdownTimers(): void;
+    private writeStdinMessage;
+    /**
+     * Read the project's prompt file and replace {{ISSUE_NUMBER}} placeholder.
+     * Fallback chain: project prompt file > prompts/default-prompt.md > hardcoded default.
+     */
+    private resolvePromptFromFile;
+    launchBatch(projectId: number, issues: Array<{
+        number: number;
+        title?: string;
+    }>, prompt?: string, delayMs?: number, headless?: boolean): Promise<Team[]>;
+    /**
+     * Build the spawn environment for a Claude Code process.
+     * Inherits the server's env and adds fleet/git-bash vars.
+     * This is the SINGLE source of CC env vars for BOTH headless and interactive modes.
+     */
+    private buildSpawnEnv;
+    /**
+     * Build the base Claude CLI args shared by BOTH headless and interactive modes.
+     * @param worktreeName — worktree name for --worktree flag
+     * @param options.resume — add --resume flag (for resume flow)
+     * @param options.model — optional model override from project
+     * @param options.prompt — positional prompt arg (interactive mode only)
+     */
+    private buildBaseClaudeArgs;
+    /**
+     * Build Claude CLI args for headless (stream-json) mode.
+     * Calls buildBaseClaudeArgs() and appends stream-json + verbose flags.
+     */
+    private buildHeadlessClaudeArgs;
+    /**
+     * Build the `set VAR=value` portion of the innerCommand for interactive
+     * mode on Windows. Iterates over buildSpawnEnv() output to generate
+     * set commands dynamically, ensuring all env vars are passed.
+     *
+     * Only includes fleet/CC-specific vars (prefixed FLEET_, CLAUDE_CODE_)
+     * to keep the command string manageable and avoid leaking unrelated env.
+     */
+    private buildInteractiveEnvSetCommands;
+    /**
+     * Launch a Claude Code process in interactive mode (Windows terminal).
+     * Extracted from the duplicated logic in launch() and launchQueued().
+     *
+     * Opens a new terminal window (wt.exe or cmd.exe) with the Claude Code
+     * CLI and all required env vars from buildSpawnEnv().
+     */
+    private launchInteractive;
+    /**
+     * Spawn a Claude Code process and validate it got a PID.
+     * On failure, transitions team to 'failed' and broadcasts snapshot.
+     * Returns the child process, or null if spawn failed.
+     */
+    private spawnAndValidate;
+    /**
+     * Attach exit and error handlers to a child process.
+     * These handlers clean up maps, transition the team to done/failed,
+     * broadcast SSE events, and trigger queue processing.
+     */
+    private attachProcessHandlers;
+    /**
+     * Store the stdin pipe, send the initial prompt (if provided), set up
+     * output capture, and broadcast the initial FC event in the session log.
+     */
+    private setupStdinAndOutput;
+    /**
+     * Create a git worktree with -b fallback. On failure, transitions team
+     * to 'failed' and broadcasts snapshot.
+     * Returns true on success, false on failure.
+     */
+    private createWorktree;
+    /**
+     * Copy hook scripts and generate settings.json into a worktree directory.
+     */
+    private copyHooksAndSettings;
+    /**
+     * Derive worktree naming from a project and issue number.
+     */
+    private deriveWorktreeNames;
+    /**
+     * Broadcast a full team dashboard snapshot to all SSE clients.
+     * Called after any team state change so the Fleet Grid refreshes.
+     */
+    private broadcastSnapshot;
+    private initOutputBuffer;
+    private captureOutput;
+    /**
+     * Extract and accumulate token counts from stream events.
+     * - `assistant` events: increment token counters from usage.input_tokens, etc.
+     * - `result` events: replace totalCostUsd (it's cumulative) and flush to DB.
+     */
+    private accumulateTokens;
+    /**
+     * Persist in-memory token counters to the database and broadcast SSE update.
+     */
+    private flushTokenCounters;
+    /**
+     * Detect thinking start/stop from Claude Code stream-json events.
+     *
+     * content_block_start with content_block.type === "thinking" signals the
+     * start of an extended thinking block. content_block_stop (matched by
+     * index) signals the end.
+     */
+    private detectThinking;
+    /**
+     * Clear thinking state for a team (e.g. on stop/cleanup).
+     */
+    clearThinking(teamId: number): void;
+    private killProcess;
+}
+export declare function getTeamManager(): TeamManager;
+export default TeamManager;
+//# sourceMappingURL=team-manager.d.ts.map

package/dist/server/services/team-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-manager.d.ts","sourceRoot":"","sources":["../../../src/server/services/team-manager.ts"],"names":[],"mappings":"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"}