edsger 0.76.0 → 0.78.0

package/dist/commands/build/index.js

@@ -1,544 +0,0 @@
-import { execFileSync, execSync, spawn } from 'child_process';
-import { existsSync, mkdirSync, readdirSync, rmSync, statSync, writeFileSync, } from 'fs';
-import { homedir } from 'os';
-import { join, relative } from 'path';
-import { getAppStoreConfigs, updateBuildConfig, } from '../../api/app-store.js';
-import { getGitHubConfigByProduct } from '../../api/github.js';
-import { getProduct } from '../../api/products.js';
-import { deregisterSession, registerSession, } from '../../system/session-manager.js';
-import { logInfo, logSuccess, logWarning } from '../../utils/logger.js';
-import { cloneIssueRepo, ensureWorkspaceDir, } from '../../workspace/workspace-manager.js';
-import { analyzeBuildPlan, } from './detect-project.js';
-/** Default (real) implementations of all dependencies. */
-export function createDefaultDeps() {
-    return {
-        fetchConfigs: getAppStoreConfigs,
-        fetchProduct: getProduct,
-        fetchGitHub: getGitHubConfigByProduct,
-        cloneRepo: (workspaceRoot, dirName, owner, repo, token) => cloneIssueRepo(workspaceRoot, dirName, owner, repo, token),
-        getWorkspaceRoot: ensureWorkspaceDir,
-        saveBuildConfig: updateBuildConfig,
-        checkoutDefaultBranch: checkoutDefaultBranchImpl,
-        analyzeBuildPlan: analyzeBuildPlan,
-        findProjects: findXcodeProjects,
-        findSchemes: discoverSchemes,
-        runCommand: spawnAsync,
-        isXcodeAvailable: isXcodebuildAvailable,
-    };
-}
-// ── Async spawn helper ─────────────────────────────────────────────
-/**
- * Active child process — killed on SIGTERM for graceful cancellation.
- * Only one build can run at a time; concurrent calls are rejected.
- */
-let activeChild = null;
-/**
- * Spawn a command asynchronously, stream output to stdout/stderr, and
- * return a promise that resolves on success or rejects on failure.
- * The spawned process is stored in `activeChild` so the desktop app's
- * "Stop Build" button (which sends SIGTERM to the CLI) cascades to it.
- * Rejects if another subprocess is already running (concurrency guard).
- */
-function spawnAsync(cmd, args, opts = {}) {
-    return new Promise((resolve, reject) => {
-        if (activeChild && activeChild.exitCode === null) {
-            reject(new Error('A build subprocess is already running'));
-            return;
-        }
-        const child = spawn(cmd, args, {
-            cwd: opts.cwd,
-            stdio: ['ignore', 'pipe', 'pipe'],
-            env: opts.env ?? process.env,
-        });
-        activeChild = child;
-        child.stdout?.on('data', (chunk) => process.stdout.write(chunk));
-        child.stderr?.on('data', (chunk) => process.stderr.write(chunk));
-        let timer;
-        if (opts.timeout) {
-            timer = setTimeout(() => {
-                child.kill('SIGTERM');
-                reject(new Error(`Command timed out after ${opts.timeout / 1000}s`));
-            }, opts.timeout);
-        }
-        child.on('close', (code) => {
-            if (timer)
-                clearTimeout(timer);
-            activeChild = null;
-            if (code === 0) {
-                resolve();
-            }
-            else {
-                reject(new Error(`${cmd} exited with code ${code}`));
-            }
-        });
-        child.on('error', (err) => {
-            if (timer)
-                clearTimeout(timer);
-            activeChild = null;
-            reject(err);
-        });
-    });
-}
-// ── Signal forwarding (scoped to runBuild) ─────────────────────────
-function forwardSignal(signal) {
-    if (activeChild && activeChild.exitCode === null) {
-        activeChild.kill(signal);
-    }
-}
-function installSignalHandlers() {
-    const onTerm = () => forwardSignal('SIGTERM');
-    const onInt = () => forwardSignal('SIGINT');
-    process.on('SIGTERM', onTerm);
-    process.on('SIGINT', onInt);
-    return () => {
-        process.removeListener('SIGTERM', onTerm);
-        process.removeListener('SIGINT', onInt);
-    };
-}
-// ── Pre-flight checks ──────────────────────────────────────────────
-function isXcodebuildAvailable() {
-    try {
-        execSync('xcodebuild -version', { stdio: 'pipe' });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-// ── Git helpers ────────────────────────────────────────────────────
-function checkoutDefaultBranchImpl(repoPath) {
-    try {
-        const defaultBranch = execFileSync('git', ['symbolic-ref', 'refs/remotes/origin/HEAD'], { cwd: repoPath, stdio: 'pipe' })
-            .toString()
-            .trim()
-            .replace('refs/remotes/origin/', '');
-        execFileSync('git', ['checkout', defaultBranch], {
-            cwd: repoPath,
-            stdio: 'pipe',
-        });
-        execFileSync('git', ['pull', 'origin', defaultBranch], {
-            cwd: repoPath,
-            stdio: 'pipe',
-        });
-        logInfo(`On branch: ${defaultBranch}`);
-    }
-    catch {
-        logWarning('Could not switch to default branch, using current state');
-    }
-}
-// ── Xcode project discovery ────────────────────────────────────────
-const EXCLUDED_DIRS = new Set([
-    'Pods',
-    '.build',
-    'node_modules',
-    'DerivedData',
-    'build',
-    '.git',
-    'Carthage',
-]);
-export function findXcodeProjects(rootDir) {
-    const results = [];
-    function walk(dir, depth) {
-        if (depth > 4)
-            return;
-        let entries;
-        try {
-            entries = readdirSync(dir);
-        }
-        catch {
-            return;
-        }
-        for (const entry of entries) {
-            if (EXCLUDED_DIRS.has(entry))
-                continue;
-            const fullPath = join(dir, entry);
-            if (entry.endsWith('.xcworkspace')) {
-                results.push({ path: relative(rootDir, fullPath), type: 'workspace' });
-            }
-            else if (entry.endsWith('.xcodeproj')) {
-                results.push({ path: relative(rootDir, fullPath), type: 'project' });
-            }
-            else {
-                try {
-                    if (statSync(fullPath).isDirectory()) {
-                        walk(fullPath, depth + 1);
-                    }
-                }
-                catch {
-                    // skip inaccessible
-                }
-            }
-        }
-    }
-    walk(rootDir, 0);
-    // Workspaces first, then by shallowest path
-    return results.sort((a, b) => {
-        if (a.type !== b.type)
-            return a.type === 'workspace' ? -1 : 1;
-        return a.path.length - b.path.length;
-    });
-}
-// ── Scheme discovery ───────────────────────────────────────────────
-export function discoverSchemes(repoPath, projectPath, projectType) {
-    const flag = projectType === 'workspace' ? '-workspace' : '-project';
-    const fullProjectPath = join(repoPath, projectPath);
-    try {
-        const output = execFileSync('xcodebuild', [flag, fullProjectPath, '-list'], { stdio: 'pipe', timeout: 30_000 }).toString();
-        const schemesMatch = output.match(/Schemes:\s*\n([\s\S]*?)(?:\n\n|$)/);
-        if (!schemesMatch)
-            return [];
-        return schemesMatch[1]
-            .split('\n')
-            .map((s) => s.trim())
-            .filter((s) => s.length > 0 &&
-            !s.endsWith('Tests') &&
-            !s.endsWith('UITests') &&
-            !s.includes('Test'));
-    }
-    catch {
-        return [];
-    }
-}
-// ── ExportOptions.plist generation ─────────────────────────────────
-/** Escape XML special characters to prevent injection in plist values. */
-function escapeXml(str) {
-    return str
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;')
-        .replace(/'/g, '&apos;');
-}
-export function generateExportOptionsPlist(teamId, exportMethod) {
-    const safeTeamId = escapeXml(teamId);
-    const safeMethod = escapeXml(exportMethod);
-    return `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>method</key>
-  <string>${safeMethod}</string>
-  <key>teamID</key>
-  <string>${safeTeamId}</string>
-  <key>uploadSymbols</key>
-  <true/>
-  <key>signingStyle</key>
-  <string>automatic</string>
-</dict>
-</plist>`;
-}
-// ── API Key file management ────────────────────────────────────────
-function getApiKeyDir() {
-    return join(homedir(), '.edsger', 'keys');
-}
-/** Validate keyId is alphanumeric to prevent path traversal. */
-function validateKeyId(keyId) {
-    if (!/^[A-Za-z0-9_-]+$/.test(keyId)) {
-        throw new Error(`Invalid API key ID: ${keyId}`);
-    }
-}
-export function writeApiKeyFile(keyId, privateKey) {
-    validateKeyId(keyId);
-    const keyDir = getApiKeyDir();
-    mkdirSync(keyDir, { recursive: true });
-    const keyPath = join(keyDir, `AuthKey_${keyId}.p8`);
-    writeFileSync(keyPath, privateKey, { mode: 0o600 });
-    return keyPath;
-}
-export function cleanupApiKeyFile(keyId) {
-    try {
-        validateKeyId(keyId);
-        rmSync(join(getApiKeyDir(), `AuthKey_${keyId}.p8`), { force: true });
-    }
-    catch {
-        // best effort
-    }
-}
-// ── Platform → destination mapping ─────────────────────────────────
-export function destinationForPlatform(platform) {
-    if (platform === 'macos') {
-        return 'generic/platform=macOS';
-    }
-    return 'generic/platform=iOS';
-}
-// ── Main build command ─────────────────────────────────────────────
-/**
- * Run the full build pipeline. Accepts an optional `deps` parameter
- * for dependency injection in tests; falls back to real implementations.
- */
-// eslint-disable-next-line complexity -- orchestration function, sequential steps are intentional
-export async function runBuild(options, deps = createDefaultDeps()) {
-    const { buildProductId: productId, verbose } = options;
-    // 1. Pre-flight
-    if (!deps.isXcodeAvailable()) {
-        throw new Error('xcodebuild is not available. Please install Xcode and Xcode Command Line Tools.\n\n' +
-            '  xcode-select --install\n');
-    }
-    // Register CLI session for log persistence
-    await registerSession({ command: 'build', productId });
-    // Install signal handlers for the duration of this build
-    const removeSignalHandlers = installSignalHandlers();
-    try {
-        logInfo(`Starting build for product: ${productId}`);
-        // 2. Fetch app store config
-        const configs = await deps.fetchConfigs(productId, verbose);
-        const appleConfig = configs.find((c) => c.store_type === 'apple_app_store');
-        if (!appleConfig) {
-            throw new Error('No Apple App Store configuration found. Add one in the App Store tab first.');
-        }
-        const buildConfig = appleConfig.build_config || {};
-        const shouldReselect = options.reselect || false;
-        // 3. Clone / update repo
-        const github = await deps.fetchGitHub(productId, verbose);
-        if (!github.configured || !github.token || !github.owner || !github.repo) {
-            throw new Error(`GitHub not configured: ${github.message || 'Connect a repository to this product.'}`);
-        }
-        const workspaceRoot = deps.getWorkspaceRoot();
-        const { repoPath } = deps.cloneRepo(workspaceRoot, `build-${productId}`, github.owner, github.repo, github.token);
-        deps.checkoutDefaultBranch(repoPath);
-        // 4. Resolve project path, scheme, and install dependencies.
-        //    If we already have a saved build_config (and not --reselect),
-        //    skip the AI and use the saved values directly.
-        //    Otherwise: AI analyzes → code executes install steps → discover project/scheme.
-        let projectPath = options.project || (shouldReselect ? undefined : buildConfig.project_path);
-        let projectType = 'workspace';
-        let scheme = options.scheme || (shouldReselect ? undefined : buildConfig.scheme);
-        const needsDiscovery = !projectPath || !scheme || shouldReselect;
-        if (needsDiscovery) {
-            // 4a. Ask AI to analyze the repo and produce a build plan
-            const product = await deps.fetchProduct(productId, verbose);
-            const plan = await deps.analyzeBuildPlan({
-                repoPath,
-                productName: product.name,
-                productDescription: product.description,
-            });
-            // 4b. Execute the plan's install steps (deterministic)
-            if (plan) {
-                for (const step of plan.installSteps) {
-                    const cwd = step.cwd ? join(repoPath, step.cwd) : repoPath;
-                    logInfo(`Running: ${step.cmd} ${step.args.join(' ')}${step.cwd ? ` (in ${step.cwd}/)` : ''}`);
-                    try {
-                        await deps.runCommand(step.cmd, step.args, {
-                            cwd,
-                            timeout: 300_000,
-                        });
-                        logSuccess(`${step.cmd} completed`);
-                    }
-                    catch {
-                        logWarning(`${step.cmd} ${step.args[0] || ''} failed — continuing`);
-                    }
-                }
-            }
-            // 4c. Resolve project path — prefer AI hint, fallback to scan
-            if (!projectPath) {
-                if (plan?.projectPath) {
-                    const fullPath = join(repoPath, plan.projectPath);
-                    if (existsSync(fullPath)) {
-                        projectPath = plan.projectPath;
-                        logInfo(`Using AI-suggested project: ${projectPath}`);
-                    }
-                    else {
-                        logWarning(`AI-suggested project not found: ${plan.projectPath}`);
-                    }
-                }
-                // Fallback: scan filesystem
-                if (!projectPath) {
-                    const projects = deps.findProjects(repoPath);
-                    if (projects.length === 0) {
-                        throw new Error(`No Xcode projects found in ${repoPath}.\n` +
-                            'Ensure the repository contains a .xcworkspace or .xcodeproj file.');
-                    }
-                    projectPath = projects[0].path;
-                    projectType = projects[0].type;
-                    logInfo(`Found project: ${projectPath}`);
-                }
-            }
-            projectType = projectPath.endsWith('.xcworkspace')
-                ? 'workspace'
-                : 'project';
-            // 4d. Resolve scheme — prefer CLI flag, then AI hint, then xcodebuild -list
-            if (!scheme) {
-                if (plan?.schemeHint) {
-                    scheme = plan.schemeHint;
-                    logInfo(`Using AI-suggested scheme: ${scheme}`);
-                }
-                else {
-                    const schemes = deps.findSchemes(repoPath, projectPath, projectType);
-                    if (schemes.length === 0) {
-                        throw new Error(`No schemes found in ${projectPath}. Specify one with --scheme.`);
-                    }
-                    scheme = schemes[0];
-                    logInfo(`Discovered scheme: ${scheme}`);
-                }
-            }
-        }
-        else {
-            projectType = projectPath.endsWith('.xcworkspace')
-                ? 'workspace'
-                : 'project';
-        }
-        // At this point projectPath and scheme must be resolved
-        if (!projectPath || !scheme) {
-            throw new Error('Could not determine Xcode project path and scheme.\n' +
-                'Specify them manually with --project and --scheme, or check the repository structure.');
-        }
-        // 5. Build settings
-        const configuration = options.configuration || buildConfig.configuration || 'Release';
-        const teamId = buildConfig.team_id;
-        const exportMethod = buildConfig.export_method || 'app-store';
-        const platform = options.platform || 'ios';
-        // 6. Persist discovered build config to DB
-        const newBuildConfig = {
-            project_path: projectPath,
-            scheme,
-            configuration,
-            team_id: teamId,
-            export_method: exportMethod,
-        };
-        if (newBuildConfig.project_path !== buildConfig.project_path ||
-            newBuildConfig.scheme !== buildConfig.scheme ||
-            newBuildConfig.configuration !== buildConfig.configuration) {
-            logInfo('Saving build configuration...');
-            await deps.saveBuildConfig(appleConfig.id, newBuildConfig, verbose);
-        }
-        if (!options.skipArchive && !options.ipa) {
-            // 7. Archive (async, cancellable)
-            const archivePath = join(repoPath, 'build', `${scheme}.xcarchive`);
-            const projectFlag = projectType === 'workspace' ? '-workspace' : '-project';
-            const fullProjectPath = join(repoPath, projectPath);
-            logInfo(`Archiving ${scheme} (${configuration}, ${platform})...`);
-            const archiveArgs = [
-                projectFlag,
-                fullProjectPath,
-                '-scheme',
-                scheme,
-                '-configuration',
-                configuration,
-                '-destination',
-                destinationForPlatform(platform),
-                '-archivePath',
-                archivePath,
-                'archive',
-                '-allowProvisioningUpdates',
-            ];
-            if (teamId) {
-                archiveArgs.push(`DEVELOPMENT_TEAM=${teamId}`);
-            }
-            await deps.runCommand('xcodebuild', archiveArgs, {
-                cwd: repoPath,
-                timeout: 1_200_000,
-            });
-            logSuccess('Archive created successfully');
-            // 8. Export IPA / .app
-            if (!teamId) {
-                logWarning('team_id not configured — skipping export. Set it in build settings.');
-                return;
-            }
-            const exportPath = join(repoPath, 'build', 'export');
-            mkdirSync(exportPath, { recursive: true });
-            const plistPath = join(repoPath, 'build', 'ExportOptions.plist');
-            writeFileSync(plistPath, generateExportOptionsPlist(teamId, exportMethod));
-            logInfo('Exporting archive...');
-            await deps.runCommand('xcodebuild', [
-                '-exportArchive',
-                '-archivePath',
-                archivePath,
-                '-exportOptionsPlist',
-                plistPath,
-                '-exportPath',
-                exportPath,
-                '-allowProvisioningUpdates',
-            ], { cwd: repoPath, timeout: 300_000 });
-            logSuccess('Export completed');
-            const ipaFiles = readdirSync(exportPath).filter((f) => f.endsWith('.ipa'));
-            if (ipaFiles.length === 0) {
-                throw new Error('No IPA file found after export');
-            }
-            const ipaPath = join(exportPath, ipaFiles[0]);
-            logSuccess(`IPA ready: ${ipaPath}`);
-            if (options.upload) {
-                await uploadIpa(ipaPath, appleConfig, platform, deps);
-            }
-            else {
-                logInfo('Build complete. Use --upload to also upload to App Store Connect.');
-            }
-        }
-        else if (options.ipa) {
-            if (!existsSync(options.ipa)) {
-                throw new Error(`IPA file not found: ${options.ipa}`);
-            }
-            await uploadIpa(options.ipa, appleConfig, platform, deps);
-        }
-    }
-    finally {
-        removeSignalHandlers();
-        await deregisterSession();
-    }
-}
-// ── Upload IPA to App Store Connect ────────────────────────────────
-//
-// Uses `xcrun notarytool submit` for macOS apps and
-// `xcrun altool --upload-app` for iOS (altool is deprecated but
-// notarytool does not support iOS App Store uploads).
-// When altool is removed in a future Xcode, migrate to the
-// App Store Connect API upload protocol (iTMSTransporter).
-async function uploadIpa(ipaPath, appleConfig, platform, deps) {
-    const credentials = appleConfig.credentials;
-    if (!credentials?.key_id ||
-        !credentials?.issuer_id ||
-        !credentials?.private_key) {
-        throw new Error('Apple App Store Connect API credentials not configured.\n' +
-            'Set key_id, issuer_id, and private_key in the App Store tab settings.');
-    }
-    logInfo('Uploading to App Store Connect...');
-    const keyId = credentials.key_id;
-    writeApiKeyFile(keyId, credentials.private_key);
-    const cleanup = () => cleanupApiKeyFile(keyId);
-    process.on('exit', cleanup);
-    try {
-        if (platform === 'macos') {
-            logInfo('Using xcrun notarytool for macOS submission...');
-            await deps.runCommand('xcrun', [
-                'notarytool',
-                'submit',
-                ipaPath,
-                '--key',
-                join(getApiKeyDir(), `AuthKey_${keyId}.p8`),
-                '--key-id',
-                keyId,
-                '--issuer',
-                credentials.issuer_id,
-                '--wait',
-            ], { timeout: 1_200_000 });
-        }
-        else {
-            // iOS: altool is the only CLI path for App Store uploads.
-            // Apple deprecated altool but has not yet provided a replacement
-            // CLI for iOS App Store uploads. When they do, switch here.
-            logInfo('Using xcrun altool for iOS upload (note: altool is deprecated by Apple)...');
-            await deps.runCommand('xcrun', [
-                'altool',
-                '--upload-app',
-                '-f',
-                ipaPath,
-                '-t',
-                'ios',
-                '--apiKey',
-                keyId,
-                '--apiIssuer',
-                credentials.issuer_id,
-            ], {
-                timeout: 1_200_000,
-                env: {
-                    ...process.env,
-                    API_PRIVATE_KEYS_DIR: getApiKeyDir(),
-                },
-            });
-        }
-        logSuccess('Upload to App Store Connect completed!');
-    }
-    finally {
-        cleanup();
-        process.removeListener('exit', cleanup);
-    }
-}

package/dist/commands/chat-serve/chat-server.d.ts

@@ -1,114 +0,0 @@
-/**
- * Chat Server — the engine behind the standalone `edsger chat-serve` daemon.
- *
- * A single long-lived process that answers human messages on **issue** and
- * **product group** chat channels (the chat surfaces in the issue- and
- * product-detail pages). It is deliberately independent of the autonomous
- * agent workflow: unlike the previous `chat-worker`, it is not forked by
- * `AgentWorkflowProcessor` and needs no IPC from it — so chat keeps working
- * whether or not the workflow is running.
- *
- * Two channel kinds are served here:
- *   - `issue`   — `channel_type='issue'`
- *   - `product` — `channel_type='product'` AND `chat_mode='group'`
- *
- * Session chats (`chat_mode='ai_assistant'`) are deliberately excluded — they
- * are owned by the per-session `edsger session-serve` daemon. Letting both
- * claim the same messages would produce duplicate replies.
- *
- * Message intake prefers Supabase Realtime (a `chat_messages` INSERT wakes the
- * claim+process path immediately); when no Supabase session is available it
- * falls back to MCP polling. Either way, messages are claimed atomically
- * (`claimPendingMessages`) so multiple workers never process the same message.
- *
- * Issue chats can give the AI read access to the issue's cloned repo. The repo
- * path is derived locally from the workspace root + issue id (the same pure
- * mapping the workflow uses), so no IPC hand-off is required; when the clone
- * isn't present the chat simply runs without code context.
- *
- * Side-effectful collaborators are injected via {@link ChatServerDeps} (with
- * real implementations as the default) so the routing/repo logic is unit
- * testable without a live Supabase or filesystem.
- */
-import { claimPendingMessages, listChannels } from '../../api/chat.js';
-import { processHumanMessages, processProductHumanMessages } from '../../phases/chat-processor/index.js';
-import { getSupabase, hasSupabaseSession } from '../../supabase/client.js';
-import type { ChatChannel, EdsgerConfig } from '../../types/index.js';
-/** Channel kinds this server is responsible for. */
-export type ServedChannelKind = 'issue' | 'product';
-/**
- * Classify a channel into the kind this server serves, or `null` to ignore it.
- * Pure — the single source of truth for "should chat-serve touch this channel",
- * shared by the initial refresh and the Realtime registration path.
- *
- * Note the precise product rule: only `chat_mode='group'` product channels are
- * served. `ai_assistant` (session) channels belong to `edsger session-serve`;
- * any other mode (e.g. `direct`) is not a product group chat and is ignored.
- */
-export declare function classifyChannel(channel: Pick<ChatChannel, 'channel_type' | 'chat_mode'>): ServedChannelKind | null;
-/** Side-effectful collaborators, injectable for testing. */
-export interface ChatServerDeps {
-    listChannels: typeof listChannels;
-    claimPendingMessages: typeof claimPendingMessages;
-    processHumanMessages: typeof processHumanMessages;
-    processProductHumanMessages: typeof processProductHumanMessages;
-    issueRepoExists: (workspaceRoot: string, issueId: string) => boolean;
-    getIssueRepoPath: (workspaceRoot: string, issueId: string) => string;
-    hasSupabaseSession: typeof hasSupabaseSession;
-    getSupabase: typeof getSupabase;
-}
-export interface ChatServerOptions {
-    config: EdsgerConfig;
-    /** Workspace root used to locate issue repo clones for code context. */
-    workspaceRoot: string;
-    verbose?: boolean;
-}
-export declare class ChatServer {
-    private readonly deps;
-    private readonly config;
-    private readonly workspaceRoot;
-    private readonly verbose;
-    /** Unique id for atomic message claiming across competing workers. */
-    private readonly workerId;
-    /** issueId -> channelId */
-    private readonly issueChannels;
-    /** productId -> channelId */
-    private readonly productChannels;
-    /** channelId -> { kind, refId } */
-    private readonly metaByChannel;
-    /** In-flight message processing, awaited on shutdown so we drain cleanly. */
-    private readonly inflight;
-    private realtimeChannel;
-    private pollTimer;
-    private refreshTimer;
-    private running;
-    constructor(options: ChatServerOptions, deps?: ChatServerDeps);
-    /** Bring the server up: seed channels, drain backlog, start intake. */
-    start(): Promise<void>;
-    /**
-     * Stop accepting new work, tear down timers/subscriptions, then wait for any
-     * in-flight message processing to finish (bounded by DRAIN_TIMEOUT_MS) so a
-     * mid-flight reply isn't abandoned. Idempotent.
-     */
-    stop(): Promise<void>;
-    private refreshChannels;
-    /**
-     * Register a channel into the routing maps. Returns true if it was newly
-     * added. Ignores channels this server doesn't serve (e.g. session chats).
-     */
-    private registerChannel;
-    /** Fire-and-forget a claim+process while tracking it for graceful drain. */
-    private dispatch;
-    /** Claim and process pending human messages on a single known channel. */
-    private claimAndProcess;
-    /**
-     * Locate the issue's cloned repo so the chat AI can read code. Derived from
-     * the workspace root with the same pure mapping the workflow uses; returns
-     * undefined when the clone isn't present (chat then runs without code).
-     */
-    private resolveRepoPath;
-    private startRealtime;
-    private stopRealtime;
-    private startPolling;
-    private pollOnce;
-}