@google/jules-fleet 0.0.1-experimental.0

package/dist/init/handler.d.ts

@@ -0,0 +1,22 @@
+import type { Octokit } from 'octokit';
+import type { InitInput, InitResult, InitSpec } from './spec.js';
+import type { LabelConfigurator } from './types.js';
+import type { FleetEmitter } from '../shared/events.js';
+export interface InitHandlerDeps {
+    octokit: Octokit;
+    emit?: FleetEmitter;
+    labelConfigurator?: LabelConfigurator;
+}
+/**
+ * InitHandler scaffolds fleet workflow files by creating a PR via GitHub REST API.
+ * Never throws — all errors are Result values.
+ *
+ * Pipeline: createBranch → commitFiles → createInitPR → configureLabels
+ */
+export declare class InitHandler implements InitSpec {
+    private octokit;
+    private emit;
+    private labelConfigurator?;
+    constructor(deps: InitHandlerDeps);
+    execute(input: InitInput): Promise<InitResult>;
+}

package/dist/init/index.d.ts

@@ -0,0 +1,4 @@
+export type { InitInput, InitResult, InitSuccess, InitFailure, InitSpec, } from './spec.js';
+export { InitInputSchema, InitErrorCode } from './spec.js';
+export { InitHandler } from './handler.js';
+export type { LabelConfigurator } from './types.js';

package/dist/init/ops/commit-files.d.ts

@@ -0,0 +1,10 @@
+import type { InitResult } from '../spec.js';
+import type { InitContext } from '../types.js';
+import type { WorkflowTemplate } from '../templates/types.js';
+/**
+ * Commit workflow templates and an example goal to the init branch.
+ * Returns the list of files created, or a fail Result.
+ */
+export declare function commitFiles(ctx: InitContext, templates: readonly WorkflowTemplate[], exampleGoal: string): Promise<string[] | InitResult>;
+/** Type guard: returns true if the result is a fail Result */
+export declare function isCommitResult(result: string[] | InitResult): result is InitResult;

package/dist/init/ops/create-branch.d.ts

@@ -0,0 +1,16 @@
+import type { Octokit } from 'octokit';
+import type { InitResult } from '../spec.js';
+import type { FleetEmitter } from '../../shared/events.js';
+/**
+ * Create the fleet-init branch from the base branch SHA.
+ * Returns the branch name on success, or a fail Result.
+ */
+export declare function createBranch(octokit: Octokit, owner: string, repo: string, baseBranch: string, emit: FleetEmitter): Promise<{
+    branchName: string;
+    baseSha: string;
+} | InitResult>;
+/** Type guard: returns true if the result is a fail Result (not a branch info object) */
+export declare function isBranchResult(result: {
+    branchName: string;
+    baseSha: string;
+} | InitResult): result is InitResult;

package/dist/init/ops/create-pr.d.ts

@@ -0,0 +1,15 @@
+import type { InitResult } from '../spec.js';
+import type { InitContext } from '../types.js';
+/**
+ * Create the fleet initialization PR.
+ * Returns { prUrl, prNumber } on success, or a fail Result.
+ */
+export declare function createInitPR(ctx: InitContext, baseBranch: string, filesCreated: string[]): Promise<{
+    prUrl: string;
+    prNumber: number;
+} | InitResult>;
+/** Type guard: returns true if the result is a fail Result */
+export declare function isPRResult(result: {
+    prUrl: string;
+    prNumber: number;
+} | InitResult): result is InitResult;

package/dist/init/ops/pr-body.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Build the PR body for the fleet init PR.
+ * Isolated so copy edits don't conflict with handler logic.
+ */
+export declare function buildInitPRBody(filesCreated: string[]): string;

package/dist/init/ops/upload-secrets.d.ts

@@ -0,0 +1,11 @@
+import type { Octokit } from 'octokit';
+import type { FleetEmitter } from '../../shared/events.js';
+/**
+ * Upload a secret to GitHub Actions using NaCl sealed-box encryption.
+ *
+ * Uses the repo public key endpoint + libsodium-wrappers.
+ */
+export declare function uploadSecret(octokit: Octokit, owner: string, repo: string, secretName: string, secretValue: string, emit: FleetEmitter): Promise<{
+    success: boolean;
+    error?: string;
+}>;

package/dist/init/spec.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+export declare const InitInputSchema: z.ZodObject<{
+    /** Repository in owner/repo format (auto-detected from git if omitted) */
+    repo: z.ZodOptional<z.ZodString>;
+    /** Repository owner (resolved from repo or git) */
+    owner: z.ZodString;
+    /** Repository name (resolved from repo or git) */
+    repoName: z.ZodString;
+    /** Base branch for the PR */
+    baseBranch: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    owner: string;
+    baseBranch: string;
+    repoName: string;
+    repo?: string | undefined;
+}, {
+    owner: string;
+    repoName: string;
+    repo?: string | undefined;
+    baseBranch?: string | undefined;
+}>;
+export type InitInput = z.infer<typeof InitInputSchema>;
+export declare const InitErrorCode: z.ZodEnum<["REPO_NOT_FOUND", "BRANCH_CREATE_FAILED", "FILE_COMMIT_FAILED", "PR_CREATE_FAILED", "LABEL_CREATE_FAILED", "GITHUB_API_ERROR", "UNKNOWN_ERROR"]>;
+export type InitErrorCode = z.infer<typeof InitErrorCode>;
+export interface InitSuccess {
+    success: true;
+    data: {
+        /** URL of the created PR */
+        prUrl: string;
+        /** PR number */
+        prNumber: number;
+        /** Files committed to the branch */
+        filesCreated: string[];
+        /** Labels created in the repo */
+        labelsCreated: string[];
+    };
+}
+export interface InitFailure {
+    success: false;
+    error: {
+        code: InitErrorCode;
+        message: string;
+        recoverable: boolean;
+        suggestion?: string;
+    };
+}
+export type InitResult = InitSuccess | InitFailure;
+export interface InitSpec {
+    execute(input: InitInput): Promise<InitResult>;
+}

package/dist/init/templates/analyze.d.ts

@@ -0,0 +1,2 @@
+import type { WorkflowTemplate } from './types.js';
+export declare const FLEET_ANALYZE_TEMPLATE: WorkflowTemplate;

package/dist/init/templates/dispatch.d.ts

@@ -0,0 +1,2 @@
+import type { WorkflowTemplate } from './types.js';
+export declare const FLEET_DISPATCH_TEMPLATE: WorkflowTemplate;

package/dist/init/templates/example-goal.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Example goal file content committed by `jules-fleet init`.
+ * Lives in its own file to keep handler.ts focused on orchestration.
+ */
+export declare const EXAMPLE_GOAL = "---\nmilestone: \"1\"\n---\n\n# Example Fleet Goal\n\nAnalyze the codebase for potential improvements and create\nissues for the engineering team.\n\n## Tools\n- Test Coverage: `npx vitest --coverage --json`\n\n## Assessment Hints\n- Focus on missing error handling in API routes\n- Look for hardcoded configuration values\n\n## Insight Hints\n- Report on overall test coverage metrics\n- Note any unusually complex functions (cyclomatic complexity)\n\n## Constraints\n- Do NOT propose changes already covered by open issues\n- Do NOT propose changes rejected in recently closed issues\n- Keep tasks small and isolated \u2014 one logical change per issue\n";

package/dist/init/templates/merge.d.ts

@@ -0,0 +1,2 @@
+import type { WorkflowTemplate } from './types.js';
+export declare const FLEET_MERGE_TEMPLATE: WorkflowTemplate;

package/dist/init/templates/types.d.ts

@@ -0,0 +1,6 @@
+export interface WorkflowTemplate {
+    /** Path in the target repo (relative) */
+    repoPath: string;
+    /** File content */
+    content: string;
+}

package/dist/init/templates.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Barrel re-export for workflow templates.
+ * Each template lives in its own file to prevent merge conflicts.
+ */
+export type { WorkflowTemplate } from './templates/types.js';
+export { FLEET_ANALYZE_TEMPLATE } from './templates/analyze.js';
+export { FLEET_DISPATCH_TEMPLATE } from './templates/dispatch.js';
+export { FLEET_MERGE_TEMPLATE } from './templates/merge.js';
+import type { WorkflowTemplate } from './templates/types.js';
+export declare const WORKFLOW_TEMPLATES: readonly WorkflowTemplate[];

package/dist/init/types.d.ts

@@ -0,0 +1,19 @@
+import type { ConfigureResult } from '../configure/spec.js';
+import type { FleetEmitter } from '../shared/events.js';
+/** Interface for label configuration — decouples init from configure slice */
+export interface LabelConfigurator {
+    execute(input: {
+        resource: 'labels';
+        action: 'create';
+        owner: string;
+        repo: string;
+    }): Promise<ConfigureResult>;
+}
+/** Shared context threaded through init operations */
+export interface InitContext {
+    octokit: import('octokit').Octokit;
+    owner: string;
+    repo: string;
+    branchName: string;
+    emit: FleetEmitter;
+}

package/dist/init/wizard/headless.d.ts

@@ -0,0 +1,8 @@
+import { fail } from '../../shared/result/index.js';
+import type { FleetEmitter } from '../../shared/events.js';
+import type { InitArgs, InitWizardResult } from './types.js';
+/**
+ * Validate all required inputs from flags + env vars in non-interactive mode.
+ * Fails with actionable errors when required values are missing.
+ */
+export declare function validateHeadlessInputs(args: InitArgs, emit: FleetEmitter): Promise<InitWizardResult | ReturnType<typeof fail>>;

package/dist/init/wizard/index.d.ts

@@ -0,0 +1,3 @@
+export type { InitWizardResult, InitArgs } from './types.js';
+export { runInitWizard } from './interactive.js';
+export { validateHeadlessInputs } from './headless.js';

package/dist/init/wizard/interactive.d.ts

@@ -0,0 +1,9 @@
+import { fail } from '../../shared/result/index.js';
+import type { FleetEmitter } from '../../shared/events.js';
+import type { InitArgs, InitWizardResult } from './types.js';
+/**
+ * Collect all init inputs via interactive wizard prompts.
+ * Each step checks if the value is already available from flags/env
+ * and skips the prompt if so.
+ */
+export declare function runInitWizard(args: InitArgs, emit: FleetEmitter): Promise<InitWizardResult | ReturnType<typeof fail>>;

package/dist/init/wizard/types.d.ts

@@ -0,0 +1,22 @@
+/** Resolved inputs from the wizard or flags+env validation */
+export interface InitWizardResult {
+    owner: string;
+    repo: string;
+    baseBranch: string;
+    authMethod: 'token' | 'app';
+    /** Secrets to upload (name → value). Empty if user declines or non-interactive. */
+    secretsToUpload: Record<string, string>;
+    /** Whether to perform a dry run (list files but don't create PR) */
+    dryRun: boolean;
+}
+/** Parsed args from citty */
+export interface InitArgs {
+    repo?: string;
+    base?: string;
+    'non-interactive'?: boolean;
+    'dry-run'?: boolean;
+    auth?: string;
+    'app-id'?: string;
+    'installation-id'?: string;
+    'upload-secrets'?: boolean;
+}

package/dist/merge/handler.d.ts

@@ -0,0 +1,21 @@
+import type { Octokit } from 'octokit';
+import type { MergeInput, MergeResult, MergeSpec } from './spec.js';
+import type { FleetEmitter } from '../shared/events.js';
+export interface MergeHandlerDeps {
+    octokit: Octokit;
+    emit?: FleetEmitter;
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * MergeHandler implements the sequential merge loop.
+ * All GitHub interactions go through Octokit REST API.
+ * Never throws — all errors returned as Result.
+ */
+export declare class MergeHandler implements MergeSpec {
+    private octokit;
+    private emit;
+    private sleep;
+    constructor(deps: MergeHandlerDeps);
+    execute(input: MergeInput): Promise<MergeResult>;
+    private selectPRs;
+}

package/dist/merge/index.d.ts

@@ -0,0 +1,5 @@
+export type { MergeInput, MergeResult, MergeSuccess, MergeFailure, MergeSpec, } from './spec.js';
+export { MergeInputSchema, MergeMode, MergeErrorCode } from './spec.js';
+export { MergeHandler } from './handler.js';
+export { selectByLabel } from './select/by-label.js';
+export { selectByFleetRun } from './select/by-fleet-run.js';

package/dist/merge/ops/index.d.ts

@@ -0,0 +1,4 @@
+export { updateBranch } from './update-branch.js';
+export { waitForCI } from './wait-for-ci.js';
+export { squashMerge } from './squash-merge.js';
+export { redispatch } from './redispatch.js';

package/dist/merge/ops/redispatch.d.ts

@@ -0,0 +1,8 @@
+import type { Octokit } from 'octokit';
+import type { PR } from '../../shared/schemas/pr.js';
+import type { FleetEmitter } from '../../shared/events.js';
+/**
+ * Closes a conflicting PR and re-dispatches via Jules SDK.
+ * Polls for the new PR and returns it, or null on timeout.
+ */
+export declare function redispatch(octokit: Octokit, owner: string, repo: string, oldPr: PR, baseBranch: string, pollTimeoutSeconds: number, emit: FleetEmitter, sleep: (ms: number) => Promise<void>): Promise<PR | null>;

package/dist/merge/ops/squash-merge.d.ts

@@ -0,0 +1,8 @@
+import type { Octokit } from 'octokit';
+/**
+ * Squash-merges a PR via the GitHub REST API.
+ */
+export declare function squashMerge(octokit: Octokit, owner: string, repo: string, prNumber: number): Promise<{
+    ok: boolean;
+    error?: string;
+}>;

package/dist/merge/ops/update-branch.d.ts

@@ -0,0 +1,11 @@
+import type { Octokit } from 'octokit';
+import type { FleetEmitter } from '../../shared/events.js';
+/**
+ * Updates a PR branch from its base branch.
+ * Returns conflict status so the caller can decide to re-dispatch.
+ */
+export declare function updateBranch(octokit: Octokit, owner: string, repo: string, prNumber: number, emit: FleetEmitter): Promise<{
+    ok: boolean;
+    conflict: boolean;
+    error?: string;
+}>;

package/dist/merge/ops/wait-for-ci.d.ts

@@ -0,0 +1,7 @@
+import type { Octokit } from 'octokit';
+import type { FleetEmitter } from '../../shared/events.js';
+/**
+ * Polls GitHub Checks API until all checks complete or timeout.
+ * Returns 'pass', 'fail', 'none' (no checks configured), or 'timeout'.
+ */
+export declare function waitForCI(octokit: Octokit, owner: string, repo: string, prNumber: number, maxWaitMs: number, emit: FleetEmitter, sleep: (ms: number) => Promise<void>): Promise<'pass' | 'fail' | 'none' | 'timeout'>;

package/dist/merge/select/by-fleet-run.d.ts

@@ -0,0 +1,8 @@
+import type { Octokit } from 'octokit';
+import type { PR } from '../../shared/schemas/pr.js';
+/**
+ * Select PRs by fleet-run ID embedded in PR body.
+ * Matches `<!-- fleet-run: <ID> -->` marker.
+ * Returns PRs sorted by number (oldest first).
+ */
+export declare function selectByFleetRun(octokit: Octokit, owner: string, repo: string, baseBranch: string, runId: string): Promise<PR[]>;

package/dist/merge/select/by-label.d.ts

@@ -0,0 +1,7 @@
+import type { Octokit } from 'octokit';
+import type { PR } from '../../shared/schemas/pr.js';
+/**
+ * Select PRs using the `fleet-merge-ready` label.
+ * Returns PRs sorted by number (oldest first) for deterministic ordering.
+ */
+export declare function selectByLabel(octokit: Octokit, owner: string, repo: string, baseBranch: string): Promise<PR[]>;

package/dist/merge/select/index.d.ts

@@ -0,0 +1,2 @@
+export { selectByLabel } from './by-label.js';
+export { selectByFleetRun } from './by-fleet-run.js';

package/dist/merge/spec.d.ts

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+export declare const MergeMode: z.ZodEnum<["label", "fleet-run"]>;
+export type MergeMode = z.infer<typeof MergeMode>;
+export declare const MergeInputSchema: z.ZodEffects<z.ZodObject<{
+    /** PR selection mode */
+    mode: z.ZodDefault<z.ZodEnum<["label", "fleet-run"]>>;
+    /** Fleet run ID — required when mode is 'fleet-run' */
+    runId: z.ZodOptional<z.ZodString>;
+    /** Base branch to merge into */
+    baseBranch: z.ZodDefault<z.ZodString>;
+    /** Use admin privileges to bypass branch protection */
+    admin: z.ZodDefault<z.ZodBoolean>;
+    /** Max seconds to wait for CI per PR */
+    maxCIWaitSeconds: z.ZodDefault<z.ZodNumber>;
+    /** Max re-dispatch attempts per PR on conflict */
+    maxRetries: z.ZodDefault<z.ZodNumber>;
+    /** Enable automatic re-dispatch on merge conflict (requires JULES_API_KEY) */
+    reDispatch: z.ZodDefault<z.ZodBoolean>;
+    /** Max seconds to wait for re-dispatched PR to appear */
+    pollTimeoutSeconds: z.ZodDefault<z.ZodNumber>;
+    /** Repository owner */
+    owner: z.ZodString;
+    /** Repository name */
+    repo: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    owner: string;
+    repo: string;
+    mode: "label" | "fleet-run";
+    baseBranch: string;
+    admin: boolean;
+    maxCIWaitSeconds: number;
+    maxRetries: number;
+    reDispatch: boolean;
+    pollTimeoutSeconds: number;
+    runId?: string | undefined;
+}, {
+    owner: string;
+    repo: string;
+    mode?: "label" | "fleet-run" | undefined;
+    runId?: string | undefined;
+    baseBranch?: string | undefined;
+    admin?: boolean | undefined;
+    maxCIWaitSeconds?: number | undefined;
+    maxRetries?: number | undefined;
+    reDispatch?: boolean | undefined;
+    pollTimeoutSeconds?: number | undefined;
+}>, {
+    owner: string;
+    repo: string;
+    mode: "label" | "fleet-run";
+    baseBranch: string;
+    admin: boolean;
+    maxCIWaitSeconds: number;
+    maxRetries: number;
+    reDispatch: boolean;
+    pollTimeoutSeconds: number;
+    runId?: string | undefined;
+}, {
+    owner: string;
+    repo: string;
+    mode?: "label" | "fleet-run" | undefined;
+    runId?: string | undefined;
+    baseBranch?: string | undefined;
+    admin?: boolean | undefined;
+    maxCIWaitSeconds?: number | undefined;
+    maxRetries?: number | undefined;
+    reDispatch?: boolean | undefined;
+    pollTimeoutSeconds?: number | undefined;
+}>;
+export type MergeInput = z.infer<typeof MergeInputSchema>;
+export declare const MergeErrorCode: z.ZodEnum<["NO_PRS_FOUND", "CI_FAILED", "CI_TIMEOUT", "MERGE_FAILED", "CONFLICT_RETRIES_EXHAUSTED", "REDISPATCH_TIMEOUT", "GITHUB_API_ERROR", "UNKNOWN_ERROR"]>;
+export type MergeErrorCode = z.infer<typeof MergeErrorCode>;
+export interface MergeSuccess {
+    success: true;
+    data: {
+        /** PRs that were successfully merged */
+        merged: number[];
+        /** PRs skipped (CI failure, etc.) */
+        skipped: number[];
+        /** PRs that were re-dispatched due to conflicts */
+        redispatched: Array<{
+            oldPr: number;
+            newPr: number;
+        }>;
+    };
+}
+export interface MergeFailure {
+    success: false;
+    error: {
+        code: MergeErrorCode;
+        message: string;
+        recoverable: boolean;
+        suggestion?: string;
+    };
+}
+export type MergeResult = MergeSuccess | MergeFailure;
+export interface MergeSpec {
+    execute(input: MergeInput): Promise<MergeResult>;
+}

package/dist/shared/auth/cache-plugin.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Octokit plugin that caches responses using GitHub's ETag mechanism.
+ * 304 Not Modified responses don't count against your rate limit.
+ *
+ * Uses `any` for the octokit param because Octokit.plugin() expects
+ * the @octokit/core Octokit type, which is a transitive dep we don't
+ * want to declare directly.
+ */
+export declare function cachePlugin(octokit: any): void;

package/dist/shared/auth/git.d.ts

@@ -0,0 +1,22 @@
+/** Parsed git remote info */
+export interface GitRepoInfo {
+    owner: string;
+    repo: string;
+    fullName: string;
+}
+/**
+ * Detect repository owner and name.
+ *
+ * Priority:
+ * 1. `GITHUB_REPOSITORY` env var (always set in GitHub Actions: "owner/repo")
+ * 2. git remote URL parsing (HTTPS or SSH)
+ */
+export declare function getGitRepoInfo(remoteName?: string): Promise<GitRepoInfo>;
+/**
+ * Parses a git remote URL to extract owner and repo.
+ * - https://github.com/owner/repo.git
+ * - git@github.com:owner/repo.git
+ */
+export declare function parseGitRemoteUrl(remoteUrl: string): GitRepoInfo;
+/** Gets the current git branch name. */
+export declare function getCurrentBranch(): Promise<string>;

package/dist/shared/auth/index.d.ts

@@ -0,0 +1,4 @@
+export { createFleetOctokit, getAuthOptions } from './octokit.js';
+export { getGitRepoInfo, getCurrentBranch, parseGitRemoteUrl, type GitRepoInfo, } from './git.js';
+export { resolvePrivateKey } from './resolve-key.js';
+export { cachePlugin } from './cache-plugin.js';

package/dist/shared/auth/octokit.d.ts

@@ -0,0 +1,11 @@
+import { Octokit } from 'octokit';
+/**
+ * Detect auth mode from environment variables and return Octokit options.
+ *
+ * Priority:
+ * 1. GitHub App (GITHUB_APP_ID + GITHUB_APP_PRIVATE_KEY[_BASE64] + GITHUB_APP_INSTALLATION_ID)
+ * 2. PAT fallback (GITHUB_TOKEN)
+ */
+export declare function getAuthOptions(): ConstructorParameters<typeof Octokit>[0];
+/** Create a new authenticated Octokit instance with caching. */
+export declare function createFleetOctokit(): InstanceType<typeof Octokit>;

package/dist/shared/auth/resolve-key.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Resolve a private key from environment variable input.
+ *
+ * Accepts two formats:
+ *   1. Raw PEM (with real newlines or literal \n strings)
+ *   2. Base64-encoded PEM (`base64 < key.pem | tr -d '\n'`)
+ *
+ * @param base64Value - GITHUB_APP_PRIVATE_KEY_BASE64
+ * @param rawValue    - GITHUB_APP_PRIVATE_KEY
+ */
+export declare function resolvePrivateKey(base64Value: string | undefined, rawValue: string | undefined): string;

package/dist/shared/events/analyze.d.ts

@@ -0,0 +1,37 @@
+/** Analyze domain events */
+export type AnalyzeEvent = {
+    type: 'analyze:start';
+    owner: string;
+    repo: string;
+    goalCount: number;
+} | {
+    type: 'analyze:goal:start';
+    file: string;
+    index: number;
+    total: number;
+    milestone?: string;
+} | {
+    type: 'analyze:milestone:resolved';
+    title: string;
+    id: string;
+} | {
+    type: 'analyze:context:fetched';
+    openIssues: number;
+    closedIssues: number;
+    prs: number;
+} | {
+    type: 'analyze:session:dispatching';
+    goal: string;
+} | {
+    type: 'analyze:session:started';
+    id: string;
+    goal: string;
+} | {
+    type: 'analyze:session:failed';
+    goal: string;
+    error: string;
+} | {
+    type: 'analyze:done';
+    sessionsStarted: number;
+    goalsProcessed: number;
+};

package/dist/shared/events/configure.d.ts

@@ -0,0 +1,21 @@
+/** Configure domain events */
+export type ConfigureEvent = {
+    type: 'configure:start';
+    resource: string;
+    owner: string;
+    repo: string;
+} | {
+    type: 'configure:label:created';
+    name: string;
+} | {
+    type: 'configure:label:exists';
+    name: string;
+} | {
+    type: 'configure:secret:uploading';
+    name: string;
+} | {
+    type: 'configure:secret:uploaded';
+    name: string;
+} | {
+    type: 'configure:done';
+};

package/dist/shared/events/dispatch.d.ts

@@ -0,0 +1,26 @@
+/** Dispatch domain events */
+export type DispatchEvent = {
+    type: 'dispatch:start';
+    milestone: string;
+} | {
+    type: 'dispatch:scanning';
+} | {
+    type: 'dispatch:found';
+    count: number;
+} | {
+    type: 'dispatch:issue:dispatching';
+    number: number;
+    title: string;
+} | {
+    type: 'dispatch:issue:dispatched';
+    number: number;
+    sessionId: string;
+} | {
+    type: 'dispatch:issue:skipped';
+    number: number;
+    reason: string;
+} | {
+    type: 'dispatch:done';
+    dispatched: number;
+    skipped: number;
+};

package/dist/shared/events/error.d.ts

@@ -0,0 +1,7 @@
+/** Shared error event — not domain-specific */
+export type ErrorEvent = {
+    type: 'error';
+    code: string;
+    message: string;
+    suggestion?: string;
+};

package/dist/shared/events/index.d.ts

@@ -0,0 +1,16 @@
+export type { InitEvent } from './init.js';
+export type { AnalyzeEvent } from './analyze.js';
+export type { MergeEvent } from './merge.js';
+export type { DispatchEvent } from './dispatch.js';
+export type { ConfigureEvent } from './configure.js';
+export type { ErrorEvent } from './error.js';
+import type { InitEvent } from './init.js';
+import type { AnalyzeEvent } from './analyze.js';
+import type { MergeEvent } from './merge.js';
+import type { DispatchEvent } from './dispatch.js';
+import type { ConfigureEvent } from './configure.js';
+import type { ErrorEvent } from './error.js';
+/** All possible fleet events */
+export type FleetEvent = InitEvent | AnalyzeEvent | MergeEvent | DispatchEvent | ConfigureEvent | ErrorEvent;
+/** Emitter function signature — handlers call this to emit events */
+export type FleetEmitter = (event: FleetEvent) => void;