baxian 0.0.1 → 0.2.0

package/dist/index.js

@@ -0,0 +1,310 @@
+import { resolve, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { rename, stat } from 'node:fs/promises';
+import { readFileSync, existsSync } from 'node:fs';
+import { loadConfig, resolveConfigPath, resolveStateDir, userConfigPath, createDefaultConfig, } from './config/loader.js';
+import { initStateDir } from './state/init.js';
+import { AgentStore } from './state/agent-store.js';
+import { TaskStore } from './state/task-store.js';
+import { ErrorRecordStore } from './state/error-record-store.js';
+import { PostApproveStore } from './state/post-approve-store.js';
+import { LockManager } from './state/lock.js';
+import { ProcessLock, ProcessLockError } from './state/process-lock.js';
+import { EventBus } from './event/bus.js';
+import { EventLog } from './event/log.js';
+import { SkillRegistry } from './skill/registry.js';
+import { AgentManager } from './agent/manager.js';
+import { PaneStreamerManager } from './agent/pane-streamer-manager.js';
+import { EventBroker } from './event/broker.js';
+import { EventPublisher } from './event/publish.js';
+import { autoBootstrapAgentIds, bootstrapAutoRepos } from './agent/bootstrap.js';
+import { registerEventHandlers } from './event/handlers.js';
+import { GitHubPoller } from './github/poller.js';
+import { resolveEventRouting } from './github/resolver.js';
+import { createRunner } from './agent/runner.js';
+import { TmuxProbePoller, TmuxSessionStatusStore } from './agent/tmux-probe-poller.js';
+import { BootstrapPoller } from './agent/bootstrap-poller.js';
+import { buildApp } from './app.js';
+import { RestartCoordinator } from './lifecycle/restart.js';
+import { consumeRestartSentinel } from './lifecycle/restart-sentinel.js';
+// All-miss returns first candidate so caller surfaces ENOENT instead of silently using wrong path.
+export function pickExistingPath(base, candidates) {
+    for (const rel of candidates) {
+        const p = resolve(base, rel);
+        if (existsSync(p))
+            return p;
+    }
+    return resolve(base, candidates[0]);
+}
+export async function migrateLegacyPollerStateFile(stateDir, legacyProjectIds, newStatePath) {
+    try {
+        await stat(newStatePath);
+        return;
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT') {
+            console.warn(`[startup] poller cursor migration: stat(${newStatePath}) failed:`, err);
+            return;
+        }
+    }
+    for (const legacyId of legacyProjectIds) {
+        const legacyPath = join(stateDir, 'state', `poller-${legacyId}.json`);
+        try {
+            await rename(legacyPath, newStatePath);
+            console.log(`[startup] migrated poller cursor ${legacyPath} → ${newStatePath}`);
+            return;
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === 'ENOENT')
+                continue;
+            console.warn(`[startup] poller cursor migration ${legacyPath} → ${newStatePath} failed:`, err);
+            return;
+        }
+    }
+}
+export async function scanLegacyPending(taskStore) {
+    const legacyPending = (await taskStore.list({ status: 'pending' }))
+        .filter(t => !t.preferredAgentId);
+    if (legacyPending.length > 0) {
+        console.warn(`[startup] ${legacyPending.length} legacy pending task(s) without preferredAgentId; ` +
+            `they will be skipped by drainQueue until you assign a dev. ` +
+            `Fix via: PATCH /api/tasks/<id> { preferredAgentId: 'dev-...' } or cancel them. ` +
+            `Task IDs: ${legacyPending.map(t => t.id).join(', ')}`);
+    }
+}
+export function scheduleBackgroundDrain(agentManager, projects) {
+    return (async () => {
+        for (const project of projects) {
+            try {
+                await agentManager.drainQueue(project.id);
+            }
+            catch (err) {
+                console.error(`[startup] drainQueue failed for project ${project.id}:`, err);
+            }
+        }
+    })();
+}
+export async function startServer(configPath) {
+    // Zero-config first run: auto-create a minimal user-level config at ~/.baxian/config.json
+    // so `baxian` works straight after `npm install -g baxian`. UI then populates project/agent
+    // via saveConfig writebacks. Explicit -c <path> doesn't auto-create — surface ENOENT instead.
+    let cfgPath = await resolveConfigPath(configPath);
+    if (!cfgPath) {
+        cfgPath = userConfigPath();
+        await createDefaultConfig(cfgPath);
+        console.log(`Initialized config at ${cfgPath} (no baxian.json found in cwd, no ~/.baxian/config.json yet)`);
+    }
+    const config = await loadConfig(cfgPath);
+    const cfgDir = dirname(cfgPath);
+    const stateDir = resolveStateDir(cfgPath);
+    await initStateDir(stateDir);
+    const processLock = new ProcessLock(stateDir);
+    try {
+        await processLock.acquire();
+    }
+    catch (err) {
+        if (err instanceof ProcessLockError) {
+            console.error('[startup] process lock acquisition failed', err);
+        }
+        throw err;
+    }
+    const releaseLockStrict = () => processLock.release();
+    const releaseLockBestEffort = async () => {
+        try {
+            await releaseLockStrict();
+        }
+        catch (e) {
+            console.warn('[shutdown] processLock.release failed', e);
+        }
+    };
+    process.once('exit', () => { processLock.releaseSync(); });
+    process.once('SIGINT', () => { void (async () => { await releaseLockBestEffort(); process.exit(130); })(); });
+    process.once('SIGTERM', () => { void (async () => { await releaseLockBestEffort(); process.exit(143); })(); });
+    try {
+        const sentinel = await consumeRestartSentinel(stateDir);
+        if (sentinel) {
+            console.log(`[startup] restart confirmed (parentPid=${sentinel.parentPid}, ` +
+                `actor=${sentinel.actor}, age=${Date.now() - sentinel.createdAt}ms)`);
+        }
+        const skillSource = resolve(cfgDir, 'skills');
+        const serverDistDir = dirname(fileURLToPath(import.meta.url));
+        const builtinSkills = pickExistingPath(serverDistDir, ['./skills', '../../../skills']);
+        const agentStore = new AgentStore(`${stateDir}/state/agents`);
+        const taskStore = new TaskStore(`${stateDir}/state/tasks`);
+        const errorRecordStore = new ErrorRecordStore(`${stateDir}/state/errors`);
+        const postApproveStore = new PostApproveStore(`${stateDir}/state/post-approve`);
+        const lockManager = new LockManager(`${stateDir}/locks`);
+        const eventLog = new EventLog(`${stateDir}/events`);
+        const eventBus = new EventBus(eventLog);
+        const eventBroker = new EventBroker();
+        const tmuxSessionStatusStore = new TmuxSessionStatusStore();
+        const registry = new SkillRegistry(skillSource, builtinSkills);
+        await registry.scan();
+        const paneStreamerManager = new PaneStreamerManager({
+            runnerFactory: (agent) => createRunner(agent.mode, agent.host),
+        });
+        const agentManager = new AgentManager({
+            config,
+            agentStore,
+            taskStore,
+            lockManager,
+            eventBus,
+            skillRegistry: registry,
+            paneStreamerManager,
+            postApproveStore,
+            errorRecordStore,
+        });
+        const tmuxProbePoller = new TmuxProbePoller({
+            config,
+            store: tmuxSessionStatusStore,
+            agentManager,
+            agentStore,
+            errorRecordStore,
+        });
+        await agentManager.recover();
+        registerEventHandlers(eventBus, agentManager, config);
+        // Arm marker watchers AFTER handlers register so emits land on live listeners.
+        await agentManager.armRecoveredPostApproveMarkers();
+        await agentManager.armRecoveredSpecMarkers();
+        const snapshotCtx = { agentManager, agentStore, taskStore, tmuxSessionStatusStore, errorRecordStore };
+        const eventPublisher = new EventPublisher(eventBroker, snapshotCtx, taskStore);
+        agentStore.onChange((kind, id) => eventPublisher.publishAgentChange(kind, id));
+        tmuxSessionStatusStore.onChange((kind, id) => eventPublisher.publishAgentChange(kind, id));
+        taskStore.onChange((kind, id) => eventPublisher.publishTaskChange(kind, id));
+        // Notify subscribers when bootstrap touches an agent's error state; agentStore alone misses
+        // failure paths since those don't mutate any binding. Must be wired AFTER publisher exists.
+        const onBootstrapAgentAffected = (ids) => {
+            for (const id of ids)
+                eventPublisher.publishAgentChange('set', id);
+        };
+        const bootstrapPoller = new BootstrapPoller({
+            config,
+            agentStore,
+            eventBus,
+            repoCache: agentManager.getRepoCache(),
+            errorRecordStore,
+            onAgentAffected: onBootstrapAgentAffected,
+        });
+        const migrationResult = await taskStore.migrateLegacyFiles();
+        if (migrationResult.migrated > 0 || migrationResult.failed > 0) {
+            console.log(`[startup] task-store migration: ${migrationResult.migrated} migrated, ${migrationResult.failed} failed`);
+        }
+        await scanLegacyPending(taskStore);
+        // Sweep stale bootstrap errors for agents no longer in the auto-bootstrap set. Covers:
+        // (a) agent deleted while server was down; (b) agent transitioned to explicit workdir
+        // mode (id stays, leaves bootstrap); (c) PATCH /config restartRequired window where the
+        // old poller appended a fresh stale record before the operator restarted.
+        try {
+            const result = await errorRecordStore.sweepStaleBootstrapErrors(autoBootstrapAgentIds(config));
+            if (result.removed > 0) {
+                console.log(`[startup] swept ${result.removed} stale bootstrap error records for agents no longer in auto-bootstrap`);
+            }
+        }
+        catch (err) {
+            console.warn('[startup] sweepStaleBootstrapErrors failed:', err);
+        }
+        void bootstrapAutoRepos({
+            config,
+            agentStore,
+            eventBus,
+            repoCache: agentManager.getRepoCache(),
+            errorRecordStore,
+            onAgentAffected: onBootstrapAgentAffected,
+        }).catch(err => console.error('[baxian] bootstrap failed:', err));
+        const poller = new GitHubPoller({
+            runner: createRunner('local'),
+            onEvent: async (projectId, mapped) => {
+                const routing = await resolveEventRouting(agentManager, mapped);
+                await eventBus.emit({
+                    id: '',
+                    type: mapped.type,
+                    timestamp: new Date().toISOString(),
+                    projectId,
+                    ...(routing.taskId ? { taskId: routing.taskId } : {}),
+                    ...(routing.agentId ? { agentId: routing.agentId } : {}),
+                    data: mapped.data,
+                });
+            },
+        });
+        const seenRepos = new Set();
+        for (const project of config.project) {
+            const repoKey = project.repo.toLowerCase();
+            if (seenRepos.has(repoKey))
+                continue;
+            seenRepos.add(repoKey);
+            const repoFileKey = encodeURIComponent(repoKey);
+            const newStatePath = join(stateDir, 'state', `poller-${repoFileKey}.json`);
+            const legacyIds = config.project
+                .filter(p => p.repo.toLowerCase() === repoKey)
+                .map(p => p.id);
+            await migrateLegacyPollerStateFile(stateDir, legacyIds, newStatePath);
+            poller.add({ projectId: project.id, repo: project.repo, statePath: newStatePath });
+        }
+        poller.setLifecycleHook(() => {
+            eventPublisher.publishPollersChange(() => poller.snapshots());
+        });
+        poller.start(config.server.githubPollIntervalMs ?? 30_000);
+        const httpsOpts = config.server.https
+            ? {
+                key: readFileSync(config.server.https.keyFile),
+                cert: readFileSync(config.server.https.certFile),
+            }
+            : undefined;
+        const webRoot = pickExistingPath(serverDistDir, ['./web', '../../web/dist']);
+        const app = await buildApp({
+            config,
+            agentManager,
+            agentStore,
+            taskStore,
+            lockManager,
+            eventBus,
+            eventLog,
+            tmuxSessionStatusStore,
+            tmuxProbePoller,
+            bootstrapPoller,
+            configPath: cfgPath,
+            poller,
+            paneStreamerManager,
+            eventBroker,
+            errorRecordStore,
+        }, {
+            ...(httpsOpts ? { https: httpsOpts } : {}),
+            webRoot,
+            ...(config.server.allowedHosts ? { allowedHosts: config.server.allowedHosts } : {}),
+        });
+        app.addHook('onClose', releaseLockStrict);
+        const restartCoordinator = new RestartCoordinator({
+            app,
+            configPath: cfgPath,
+            stateDir,
+            beforeExit: releaseLockStrict,
+        });
+        app.ctx.restartCoordinator = restartCoordinator;
+        const host = config.server.host ?? '127.0.0.1';
+        if (host !== '127.0.0.1' && !config.server.token) {
+            console.warn(`[baxian] server.host=${host} but no server.token configured — API is unauthenticated. Set a token before exposing the server.`);
+        }
+        await app.listen({ port: config.server.port, host });
+        tmuxProbePoller.start();
+        bootstrapPoller.start();
+        void scheduleBackgroundDrain(agentManager, config.project);
+        // Print user-clickable URL. 0.0.0.0/:: bind addresses aren't connectable in browsers,
+        // so swap to 127.0.0.1 for the printed link; the underlying listen address is unchanged.
+        const browsable = host === '0.0.0.0' || host === '::' ? '127.0.0.1' : host;
+        const scheme = config.server.https ? 'https' : 'http';
+        console.log(`baxian server running on ${host}:${config.server.port}`);
+        console.log(`Open ${scheme}://${browsable}:${config.server.port} in your browser to manage projects.`);
+    }
+    catch (err) {
+        await releaseLockBestEffort();
+        throw err;
+    }
+}
+if (process.argv[1]?.endsWith('index.js')) {
+    startServer().catch(err => {
+        console.error(err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lifecycle/restart-sentinel.d.ts

@@ -0,0 +1,18 @@
+export interface RestartSentinel {
+    kind: 'restart';
+    restartId: string;
+    parentPid: number;
+    createdAt: number;
+    ttlMs: number;
+    actor: string;
+}
+export declare function writeRestartSentinelSync(opts: {
+    stateDir: string;
+    restartId: string;
+    parentPid: number;
+    actor: string;
+    ttlMs?: number;
+}): void;
+export declare function clearRestartSentinelSync(stateDir: string): void;
+export declare function consumeRestartSentinel(stateDir: string): Promise<RestartSentinel | null>;
+//# sourceMappingURL=restart-sentinel.d.ts.map

package/dist/lifecycle/restart-sentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-sentinel.d.ts","sourceRoot":"","sources":["../../src/lifecycle/restart-sentinel.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAQD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,IAAI,CAYP;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAM/D;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA2BjC"}

package/dist/lifecycle/restart-sentinel.js

@@ -0,0 +1,61 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const SENTINEL_FILENAME = 'restart-intent.json';
+function sentinelPath(stateDir) {
+    return path.join(stateDir, 'state', SENTINEL_FILENAME);
+}
+export function writeRestartSentinelSync(opts) {
+    const payload = {
+        kind: 'restart',
+        restartId: opts.restartId,
+        parentPid: opts.parentPid,
+        createdAt: Date.now(),
+        ttlMs: opts.ttlMs ?? 60_000,
+        actor: opts.actor,
+    };
+    const target = sentinelPath(opts.stateDir);
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.writeFileSync(target, JSON.stringify(payload) + '\n');
+}
+export function clearRestartSentinelSync(stateDir) {
+    try {
+        fs.unlinkSync(sentinelPath(stateDir));
+    }
+    catch {
+        /* best-effort */
+    }
+}
+export async function consumeRestartSentinel(stateDir) {
+    const target = sentinelPath(stateDir);
+    let raw;
+    try {
+        raw = await fs.promises.readFile(target, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    await fs.promises.unlink(target).catch(() => { });
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (parsed.kind !== 'restart')
+        return null;
+    if (typeof parsed.restartId !== 'string')
+        return null;
+    if (typeof parsed.parentPid !== 'number')
+        return null;
+    if (typeof parsed.createdAt !== 'number')
+        return null;
+    if (typeof parsed.ttlMs !== 'number')
+        return null;
+    if (typeof parsed.actor !== 'string')
+        return null;
+    if (Date.now() - parsed.createdAt > parsed.ttlMs)
+        return null;
+    return parsed;
+}
+//# sourceMappingURL=restart-sentinel.js.map

package/dist/lifecycle/restart-sentinel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-sentinel.js","sourceRoot":"","sources":["../../src/lifecycle/restart-sentinel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAW7B,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAEhD,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAMxC;IACC,MAAM,OAAO,GAAoB;QAC/B,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;IACF,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAgB;IAEhB,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAEjD,IAAI,MAAgC,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAElD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAE9D,OAAO,MAAyB,CAAC;AACnC,CAAC"}

package/dist/lifecycle/restart.d.ts

@@ -0,0 +1,21 @@
+import type { FastifyInstance } from 'fastify';
+export interface RestartCoordinatorOptions {
+    app: Pick<FastifyInstance, 'close'>;
+    configPath: string;
+    stateDir: string;
+    /** Runs between app.close() and process.exit(); throws here abort restart. */
+    beforeExit?: () => Promise<void>;
+}
+export declare class RestartCoordinator {
+    private opts;
+    private restarting;
+    private actor;
+    private restartId;
+    constructor(opts: RestartCoordinatorOptions);
+    isRestarting(): boolean;
+    beginRestart(audit: {
+        actor: string;
+    }): void;
+    execute(): Promise<void>;
+}
+//# sourceMappingURL=restart.d.ts.map

package/dist/lifecycle/restart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.d.ts","sourceRoot":"","sources":["../../src/lifecycle/restart.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAQ/C,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,qBAAa,kBAAkB;IAKjB,OAAO,CAAC,IAAI;IAJxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAAM;gBAEH,IAAI,EAAE,yBAAyB;IAEnD,YAAY,IAAI,OAAO;IAIvB,YAAY,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAStC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAsC/B"}

package/dist/lifecycle/restart.js

@@ -0,0 +1,57 @@
+import { randomUUID } from 'node:crypto';
+import { clearRestartSentinelSync, writeRestartSentinelSync, } from './restart-sentinel.js';
+const APP_CLOSE_GRACE_MS = 5000;
+export class RestartCoordinator {
+    opts;
+    restarting = false;
+    actor = 'unknown';
+    restartId = '';
+    constructor(opts) {
+        this.opts = opts;
+    }
+    isRestarting() {
+        return this.restarting;
+    }
+    beginRestart(audit) {
+        if (this.restarting) {
+            throw new Error('restart already in progress');
+        }
+        this.restarting = true;
+        this.actor = audit.actor;
+        this.restartId = randomUUID();
+    }
+    async execute() {
+        try {
+            writeRestartSentinelSync({
+                stateDir: this.opts.stateDir,
+                restartId: this.restartId,
+                parentPid: process.pid,
+                actor: this.actor,
+            });
+        }
+        catch (err) {
+            console.error(`[restart] sentinel write failed (restartId=${this.restartId}, actor=${this.actor}):`, err);
+            this.restarting = false;
+            return;
+        }
+        try {
+            await Promise.race([
+                this.opts.app.close(),
+                new Promise(r => setTimeout(r, APP_CLOSE_GRACE_MS)),
+            ]);
+            if (this.opts.beforeExit) {
+                await this.opts.beforeExit();
+            }
+            // Exit only; an external supervisor (systemd Restart=always in prod, or whoever ran
+            // `baxian start` in dev) is responsible for relaunching. Self-spawn would race with
+            // systemd and leave a stale detached process holding the lock.
+            process.exit(0);
+        }
+        catch (err) {
+            console.error(`[restart] failed before exit (restartId=${this.restartId}, actor=${this.actor}):`, err);
+            clearRestartSentinelSync(this.opts.stateDir);
+            process.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=restart.js.map

package/dist/lifecycle/restart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.js","sourceRoot":"","sources":["../../src/lifecycle/restart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAUhC,MAAM,OAAO,kBAAkB;IAKT;IAJZ,UAAU,GAAG,KAAK,CAAC;IACnB,KAAK,GAAG,SAAS,CAAC;IAClB,SAAS,GAAG,EAAE,CAAC;IAEvB,YAAoB,IAA+B;QAA/B,SAAI,GAAJ,IAAI,CAA2B;IAAG,CAAC;IAEvD,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,YAAY,CAAC,KAAwB;QACnC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,UAAU,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,wBAAwB,CAAC;gBACvB,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAC5B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,SAAS,EAAE,OAAO,CAAC,GAAG;gBACtB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CACX,8CAA8C,IAAI,CAAC,SAAS,WAAW,IAAI,CAAC,KAAK,IAAI,EACrF,GAAG,CACJ,CAAC;YACF,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;YACxB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC;gBACjB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE;gBACrB,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;aAC1D,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACzB,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAC/B,CAAC;YACD,oFAAoF;YACpF,oFAAoF;YACpF,+DAA+D;YAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CACX,2CAA2C,IAAI,CAAC,SAAS,WAAW,IAAI,CAAC,KAAK,IAAI,EAClF,GAAG,CACJ,CAAC;YACF,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF"}

package/dist/shared/constants.d.ts

@@ -0,0 +1,18 @@
+import type { AgentRole, TaskStatus } from './types.js';
+export declare const DEFAULT_REVIEW_ROUNDS = 10;
+export declare const DEFAULT_SERVER_PORT = 3000;
+export declare const BRANCH_PREFIX = "bx/";
+export declare const WORKTREE_DIR = ".baxian-worktrees";
+export declare const STATE_DIR = ".baxian";
+export declare const CONFIG_FILE = "baxian.json";
+export declare const MAX_CONFIG_BACKUPS = 7;
+export declare const USER_CONFIG_REL = ".baxian/config.json";
+export declare const USER_STATE_REL = ".baxian";
+export declare const AGENT_PHASES: Record<AgentRole, Record<string, {
+    skills: string[];
+}>>;
+export declare const PHASE_EXPECTED_STATUS: Record<string, TaskStatus[]>;
+export declare const PHASE_REQUIRES_AGENT_BOUND_TO_TASK: Record<string, boolean>;
+export declare const TASK_TERMINAL_STATUSES: readonly TaskStatus[];
+export declare const TASK_TERMINAL_STATUS_SET: ReadonlySet<TaskStatus>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/shared/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,eAAO,MAAM,aAAa,QAAQ,CAAC;AACnC,eAAO,MAAM,YAAY,sBAAsB,CAAC;AAChD,eAAO,MAAM,SAAS,YAAY,CAAC;AACnC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAMpC,eAAO,MAAM,eAAe,wBAAwB,CAAC;AACrD,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAehF,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAU9D,CAAC;AAEF,eAAO,MAAM,kCAAkC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAUtE,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,SAAS,UAAU,EAKvD,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,UAAU,CAAmC,CAAC"}

package/dist/shared/constants.js

@@ -0,0 +1,60 @@
+export const DEFAULT_REVIEW_ROUNDS = 10;
+export const DEFAULT_SERVER_PORT = 3000;
+export const BRANCH_PREFIX = 'bx/';
+export const WORKTREE_DIR = '.baxian-worktrees';
+export const STATE_DIR = '.baxian';
+export const CONFIG_FILE = 'baxian.json';
+export const MAX_CONFIG_BACKUPS = 7;
+// User-level fallback under $HOME, used when cwd has no baxian.json.
+// Mirrors the cwd-mode layout: `~/.baxian/config.json` is the config, `~/.baxian/`
+// itself is the state dir (state/, locks/, events/ live directly under it).
+// Same naming as the cwd-mode `./.baxian/` so users see one consistent label.
+export const USER_CONFIG_REL = '.baxian/config.json';
+export const USER_STATE_REL = '.baxian';
+export const AGENT_PHASES = {
+    dev: {
+        develop: { skills: ['baxian-rules', 'task-check', 'spells'] },
+        fix: { skills: ['baxian-rules', 'pr-feedback', 'spells'] },
+        post_approve: { skills: ['baxian-rules', 'pr-feedback', 'spells'] },
+        merge: { skills: ['baxian-rules', 'merge-sync', 'spells'] },
+        'spec-fix': { skills: ['baxian-rules', 'spells'] },
+        code: { skills: ['baxian-rules', 'task-check', 'spells'] },
+    },
+    qa: {
+        review: { skills: ['baxian-rules', 'pr-review', 'spells'] },
+        recheck: { skills: ['baxian-rules', 'pr-recheck', 'spells'] },
+        merge: { skills: ['baxian-rules', 'merge-sync', 'spells'] },
+        'spec-review': { skills: ['baxian-rules', 'spells'] },
+    },
+};
+export const PHASE_EXPECTED_STATUS = {
+    develop: ['in_progress'],
+    review: ['review'],
+    recheck: ['review'],
+    fix: ['fixing'],
+    post_approve: ['approved'],
+    merge: ['approved', 'review'],
+    'spec-review': ['review'],
+    'spec-fix': ['fixing'],
+    code: ['in_progress'],
+};
+export const PHASE_REQUIRES_AGENT_BOUND_TO_TASK = {
+    develop: true,
+    fix: true,
+    post_approve: true,
+    review: false,
+    recheck: false,
+    merge: false,
+    'spec-review': false,
+    'spec-fix': true,
+    code: true,
+};
+// Terminal statuses — no auto transitions fire from these.
+export const TASK_TERMINAL_STATUSES = [
+    'merged',
+    'failed',
+    'max_rounds',
+    'cancelled',
+];
+export const TASK_TERMINAL_STATUS_SET = new Set(TASK_TERMINAL_STATUSES);
+//# sourceMappingURL=constants.js.map

package/dist/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AACnC,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAChD,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC;AACnC,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC,qEAAqE;AACrE,mFAAmF;AACnF,4EAA4E;AAC5E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,qBAAqB,CAAC;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AAExC,MAAM,CAAC,MAAM,YAAY,GAA4D;IACnF,GAAG,EAAE;QACH,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE;QAC7D,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,cAAc,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE;QAC1D,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,cAAc,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE;QACnE,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE;QAC3D,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC,EAAE;QAClD,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE;KAC3D;IACD,EAAE,EAAE;QACF,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,cAAc,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE;QAC3D,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE;QAC7D,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE;QAC3D,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC,EAAE;KACtD;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAiC;IACjE,OAAO,EAAE,CAAC,aAAa,CAAC;IACxB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,OAAO,EAAE,CAAC,QAAQ,CAAC;IACnB,GAAG,EAAE,CAAC,QAAQ,CAAC;IACf,YAAY,EAAE,CAAC,UAAU,CAAC;IAC1B,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC7B,aAAa,EAAE,CAAC,QAAQ,CAAC;IACzB,UAAU,EAAE,CAAC,QAAQ,CAAC;IACtB,IAAI,EAAE,CAAC,aAAa,CAAC;CACtB,CAAC;AAEF,MAAM,CAAC,MAAM,kCAAkC,GAA4B;IACzE,OAAO,EAAE,IAAI;IACb,GAAG,EAAE,IAAI;IACT,YAAY,EAAE,IAAI;IAClB,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,KAAK;IACZ,aAAa,EAAE,KAAK;IACpB,UAAU,EAAE,IAAI;IAChB,IAAI,EAAE,IAAI;CACX,CAAC;AAEF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAA0B;IAC3D,QAAQ;IACR,QAAQ;IACR,YAAY;IACZ,WAAW;CACZ,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAA4B,IAAI,GAAG,CAAC,sBAAsB,CAAC,CAAC"}

package/dist/shared/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './constants.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/shared/index.js

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}