@citadel-labs/citadel 0.1.0

package/dist/core/pre-spawn-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-spawn-check.d.ts","sourceRoot":"","sources":["../../src/core/pre-spawn-check.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAExE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,oBAAoB,EAC7B,eAAe,EAAE,eAAe,EAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC,CAwCzB"}

package/dist/core/pre-spawn-check.js

@@ -0,0 +1,50 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { readBeads } from './append-bead.js';
+import { nudgeFirstOfficer } from './nudge.js';
+/**
+ * Pre-spawn check for an outpost:
+ * 1. Read unread TASK_ASSIGNMENT mail
+ * 2. If none, nudge NO_TASK_ASSIGNMENT
+ * 3. Check citizen ceiling
+ * 4. If at ceiling, nudge PARALLELISM_CEILING_HIT
+ */
+export async function preSpawnCheck(citadelRoot, outpost, processRegistry, maxCitizens) {
+    // 1. Read unread mail from outpost inbox
+    const mailDir = path.join(outpost.path, '.beads', 'mail');
+    const allMail = [];
+    try {
+        const files = await fs.readdir(mailDir);
+        for (const file of files) {
+            if (!file.endsWith('.jsonl'))
+                continue;
+            const beads = await readBeads(path.join(mailDir, file));
+            allMail.push(...beads);
+        }
+    }
+    catch {
+        // mail dir may not exist
+    }
+    // Find unread TASK_ASSIGNMENT
+    const taskMail = allMail.find(m => m.mail_type === 'TASK_ASSIGNMENT' && !m.read);
+    if (!taskMail) {
+        // Nudge NO_TASK_ASSIGNMENT
+        await nudgeFirstOfficer(citadelRoot, 'NO_TASK_ASSIGNMENT', {
+            outpost: outpost.slug,
+            triggering_mail_bead_id: '',
+        });
+        return { canSpawn: false, taskMail: null, reason: 'No unread TASK_ASSIGNMENT mail' };
+    }
+    // 2. Check ceiling
+    const activeCount = processRegistry.countActive(outpost.slug);
+    if (activeCount >= maxCitizens) {
+        await nudgeFirstOfficer(citadelRoot, 'PARALLELISM_CEILING_HIT', {
+            outpost: outpost.slug,
+            active_count: activeCount,
+            ceiling: maxCitizens,
+        });
+        return { canSpawn: false, taskMail, reason: `Ceiling reached: ${activeCount}/${maxCitizens}` };
+    }
+    return { canSpawn: true, taskMail };
+}
+//# sourceMappingURL=pre-spawn-check.js.map

package/dist/core/pre-spawn-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-spawn-check.js","sourceRoot":"","sources":["../../src/core/pre-spawn-check.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAU/C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB,EACnB,OAA6B,EAC7B,eAAgC,EAChC,WAAmB;IAEnB,yCAAyC;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAe,EAAE,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACvC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAW,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;YAClE,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yBAAyB;IAC3B,CAAC;IAED,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,iBAAiB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEjF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,2BAA2B;QAC3B,MAAM,iBAAiB,CAAC,WAAW,EAAE,oBAAoB,EAAE;YACzD,OAAO,EAAE,OAAO,CAAC,IAAI;YACrB,uBAAuB,EAAE,EAAE;SAC5B,CAAC,CAAC;QACH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,gCAAgC,EAAE,CAAC;IACvF,CAAC;IAED,mBAAmB;IACnB,MAAM,WAAW,GAAG,eAAe,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,WAAW,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,iBAAiB,CAAC,WAAW,EAAE,yBAAyB,EAAE;YAC9D,OAAO,EAAE,OAAO,CAAC,IAAI;YACrB,YAAY,EAAE,WAAW;YACzB,OAAO,EAAE,WAAW;SACrB,CAAC,CAAC;QACH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,oBAAoB,WAAW,IAAI,WAAW,EAAE,EAAE,CAAC;IACjG,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACtC,CAAC"}

package/dist/core/process-registry.d.ts

@@ -0,0 +1,17 @@
+import type { ProcessRegistryEntry } from '../types/registry.js';
+/**
+ * In-memory registry of active citizen processes, keyed by outpost slug then citizen_id.
+ */
+export declare class ProcessRegistry {
+    private registry;
+    set(outpost: string, citizenId: string, entry: ProcessRegistryEntry): void;
+    get(outpost: string, citizenId: string): ProcessRegistryEntry | undefined;
+    getAll(outpost: string): Map<string, ProcessRegistryEntry>;
+    delete(outpost: string, citizenId: string): boolean;
+    countActive(outpost: string): number;
+    /** Check if a process is still alive via process.kill(pid, 0). */
+    isAlive(outpost: string, citizenId: string): boolean;
+    /** Remove all dead processes across all outposts, return count removed. */
+    pruneDeadProcesses(): number;
+}
+//# sourceMappingURL=process-registry.d.ts.map

package/dist/core/process-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-registry.d.ts","sourceRoot":"","sources":["../../src/core/process-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAwD;IAExE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAS1E,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAIzE,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAI1D,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAUnD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIpC,kEAAkE;IAClE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAWpD,2EAA2E;IAC3E,kBAAkB,IAAI,MAAM;CAsB7B"}

package/dist/core/process-registry.js

@@ -0,0 +1,71 @@
+/**
+ * In-memory registry of active citizen processes, keyed by outpost slug then citizen_id.
+ */
+export class ProcessRegistry {
+    registry = new Map();
+    set(outpost, citizenId, entry) {
+        let citizens = this.registry.get(outpost);
+        if (!citizens) {
+            citizens = new Map();
+            this.registry.set(outpost, citizens);
+        }
+        citizens.set(citizenId, entry);
+    }
+    get(outpost, citizenId) {
+        return this.registry.get(outpost)?.get(citizenId);
+    }
+    getAll(outpost) {
+        return this.registry.get(outpost) ?? new Map();
+    }
+    delete(outpost, citizenId) {
+        const citizens = this.registry.get(outpost);
+        if (!citizens)
+            return false;
+        const deleted = citizens.delete(citizenId);
+        if (citizens.size === 0) {
+            this.registry.delete(outpost);
+        }
+        return deleted;
+    }
+    countActive(outpost) {
+        return this.registry.get(outpost)?.size ?? 0;
+    }
+    /** Check if a process is still alive via process.kill(pid, 0). */
+    isAlive(outpost, citizenId) {
+        const entry = this.get(outpost, citizenId);
+        if (!entry)
+            return false;
+        try {
+            process.kill(entry.pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Remove all dead processes across all outposts, return count removed. */
+    pruneDeadProcesses() {
+        let removed = 0;
+        for (const [outpost, citizens] of this.registry) {
+            for (const [citizenId, entry] of citizens) {
+                let alive;
+                try {
+                    process.kill(entry.pid, 0);
+                    alive = true;
+                }
+                catch {
+                    alive = false;
+                }
+                if (!alive) {
+                    citizens.delete(citizenId);
+                    removed++;
+                }
+            }
+            if (citizens.size === 0) {
+                this.registry.delete(outpost);
+            }
+        }
+        return removed;
+    }
+}
+//# sourceMappingURL=process-registry.js.map

package/dist/core/process-registry.js.map

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

package/dist/core/spawn-citizen.d.ts

@@ -0,0 +1,23 @@
+import { WorktreeManager } from './worktree-manager.js';
+import { GrandArchives } from './grand-archives.js';
+import { ProcessRegistry } from './process-registry.js';
+import type { MailBead } from '../types/index.js';
+export interface SpawnCitizenOptions {
+    citadelRoot: string;
+    outpostSlug: string;
+    taskMail: MailBead;
+    worktreeManager: WorktreeManager;
+    grandArchives: GrandArchives;
+    processRegistry: ProcessRegistry;
+    agentBinaryOverride?: string;
+}
+/**
+ * Spawn a citizen agent process:
+ * 1. Create worktree if not exists (preserved on retry)
+ * 2. Resolve archetype from GrandArchives
+ * 3. Spawn agent process with env vars
+ * 4. Register in ProcessRegistry
+ * 5. On exit(0): remove worktree. On error: preserve, nudge CITIZEN_EXIT_ERROR
+ */
+export declare function spawnCitizen(opts: SpawnCitizenOptions): Promise<void>;
+//# sourceMappingURL=spawn-citizen.d.ts.map

package/dist/core/spawn-citizen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-citizen.d.ts","sourceRoot":"","sources":["../../src/core/spawn-citizen.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe,EAAE,eAAe,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2F3E"}

package/dist/core/spawn-citizen.js

@@ -0,0 +1,99 @@
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { nudgeFirstOfficer } from './nudge.js';
+/**
+ * Spawn a citizen agent process:
+ * 1. Create worktree if not exists (preserved on retry)
+ * 2. Resolve archetype from GrandArchives
+ * 3. Spawn agent process with env vars
+ * 4. Register in ProcessRegistry
+ * 5. On exit(0): remove worktree. On error: preserve, nudge CITIZEN_EXIT_ERROR
+ */
+export async function spawnCitizen(opts) {
+    const { citadelRoot, outpostSlug, taskMail, worktreeManager, grandArchives, processRegistry } = opts;
+    const spawnHint = taskMail.spawn_hint;
+    if (!spawnHint) {
+        throw new Error(`TASK_ASSIGNMENT mail ${taskMail.bead_id} missing spawn_hint`);
+    }
+    const { archetype, citizen_id: citizenId } = spawnHint;
+    const taskId = taskMail.task_id ?? taskMail.bead_id;
+    // 1. Create worktree (reuse existing on retry)
+    let worktreePath;
+    const exists = await worktreeManager.exists(outpostSlug, taskId);
+    if (exists) {
+        worktreePath = await worktreeManager.create(outpostSlug, citizenId, taskId)
+            .catch(() => {
+            // Already exists — reconstruct the path the same way WorktreeManager does
+            // This is a fallback; the worktree is already on disk.
+            return '';
+        });
+        if (!worktreePath) {
+            // Derive path from the worktreeManager.create convention:
+            // repoRoot/worktrees/citizen/<taskId> — but we don't have repoRoot here.
+            // Instead, rely on the fact that exists() confirmed the worktree is there,
+            // so we can safely re-derive it. WorktreeManager keeps the same layout.
+            // We call list() and match by taskId.
+            const entries = await worktreeManager.list(outpostSlug);
+            const match = entries.find(e => path.basename(e.path) === taskId);
+            if (!match)
+                throw new Error(`Worktree exists but could not resolve path for task ${taskId}`);
+            worktreePath = match.path;
+        }
+    }
+    else {
+        worktreePath = await worktreeManager.create(outpostSlug, citizenId, taskId);
+    }
+    // 2. Resolve archetype
+    const resolved = await grandArchives.resolve(archetype);
+    // 3. Set up env
+    const env = {
+        ...process.env,
+        CITADEL_OUTPOST: outpostSlug,
+        CITADEL_ARCHETYPE: archetype,
+        CITADEL_CITIZEN_ID: citizenId,
+        CITADEL_TASK_ID: taskId,
+        CITADEL_WORKTREE: worktreePath,
+        CITADEL_BEADS_ROOT: citadelRoot,
+    };
+    // 4. Spawn agent process (configurable binary: override > archetype > default)
+    const agentBin = opts.agentBinaryOverride ?? resolved.agent_binary;
+    const child = spawn(agentBin, [
+        '--system-prompt', resolved.system_prompt_path,
+        '--tools', resolved.toolset_manifest_path,
+        '--dir', worktreePath,
+    ], {
+        cwd: worktreePath,
+        env,
+        stdio: 'pipe',
+        detached: false,
+    });
+    // 5. Register in ProcessRegistry
+    processRegistry.set(outpostSlug, citizenId, {
+        pid: child.pid,
+        spawned_at: new Date().toISOString(),
+        worktree_path: worktreePath,
+        task_id: taskId,
+    });
+    // 6. Handle exit
+    child.on('close', async (code, _signal) => {
+        processRegistry.delete(outpostSlug, citizenId);
+        if (code === 0) {
+            try {
+                await worktreeManager.remove(outpostSlug, taskId);
+            }
+            catch {
+                // best effort
+            }
+        }
+        else {
+            await nudgeFirstOfficer(citadelRoot, 'CITIZEN_EXIT_ERROR', {
+                outpost: outpostSlug,
+                citizen_id: citizenId,
+                task_id: taskId,
+                exit_code: code,
+                worktree: worktreePath,
+            });
+        }
+    });
+}
+//# sourceMappingURL=spawn-citizen.js.map

package/dist/core/spawn-citizen.js.map

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

package/dist/core/timeout-watchdog.d.ts

@@ -0,0 +1,14 @@
+import { ProcessRegistry } from './process-registry.js';
+export declare class TimeoutWatchdog {
+    private citadelRoot;
+    private processRegistry;
+    private timeoutSeconds;
+    private pollIntervalMs;
+    private intervalHandle;
+    constructor(citadelRoot: string, processRegistry: ProcessRegistry, timeoutSeconds: number, pollIntervalMs?: number);
+    start(): void;
+    stop(): void;
+    /** Check all active citizens for timeout */
+    check(): Promise<void>;
+}
+//# sourceMappingURL=timeout-watchdog.d.ts.map

package/dist/core/timeout-watchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-watchdog.d.ts","sourceRoot":"","sources":["../../src/core/timeout-watchdog.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIxD,qBAAa,eAAe;IAIxB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,cAAc;IANxB,OAAO,CAAC,cAAc,CAA+C;gBAG3D,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,eAAe,EAChC,cAAc,EAAE,MAAM,EACtB,cAAc,GAAE,MAAc;IAGxC,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;IAOZ,4CAA4C;IACtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAuC7B"}

package/dist/core/timeout-watchdog.js

@@ -0,0 +1,68 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { nudgeFirstOfficer } from './nudge.js';
+export class TimeoutWatchdog {
+    citadelRoot;
+    processRegistry;
+    timeoutSeconds;
+    pollIntervalMs;
+    intervalHandle = null;
+    constructor(citadelRoot, processRegistry, timeoutSeconds, pollIntervalMs = 10000) {
+        this.citadelRoot = citadelRoot;
+        this.processRegistry = processRegistry;
+        this.timeoutSeconds = timeoutSeconds;
+        this.pollIntervalMs = pollIntervalMs;
+    }
+    start() {
+        this.intervalHandle = setInterval(() => {
+            this.check().catch(err => {
+                console.warn(`[TimeoutWatchdog] check error: ${err.message}`);
+            });
+        }, this.pollIntervalMs);
+    }
+    stop() {
+        if (this.intervalHandle) {
+            clearInterval(this.intervalHandle);
+            this.intervalHandle = null;
+        }
+    }
+    /** Check all active citizens for timeout */
+    async check() {
+        const outpostsPath = path.join(this.citadelRoot, '.citadel', 'outposts.json');
+        let registry;
+        try {
+            const raw = await fs.readFile(outpostsPath, 'utf-8');
+            registry = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        const now = Date.now();
+        for (const outpost of registry.outposts) {
+            const citizens = this.processRegistry.getAll(outpost.slug);
+            for (const [citizenId, entry] of citizens) {
+                const elapsed = (now - new Date(entry.spawned_at).getTime()) / 1000;
+                if (elapsed >= this.timeoutSeconds) {
+                    // Kill the process
+                    try {
+                        process.kill(entry.pid, 'SIGTERM');
+                    }
+                    catch {
+                        // already dead
+                    }
+                    // Remove from registry
+                    this.processRegistry.delete(outpost.slug, citizenId);
+                    // Nudge CITIZEN_TIMEOUT (preserve worktree)
+                    await nudgeFirstOfficer(this.citadelRoot, 'CITIZEN_TIMEOUT', {
+                        outpost: outpost.slug,
+                        citizen_id: citizenId,
+                        task_id: entry.task_id,
+                        spawned_at: entry.spawned_at,
+                        worktree: entry.worktree_path,
+                    });
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=timeout-watchdog.js.map

package/dist/core/timeout-watchdog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-watchdog.js","sourceRoot":"","sources":["../../src/core/timeout-watchdog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,MAAM,OAAO,eAAe;IAIhB;IACA;IACA;IACA;IANF,cAAc,GAA0C,IAAI,CAAC;IAErE,YACU,WAAmB,EACnB,eAAgC,EAChC,cAAsB,EACtB,iBAAyB,KAAK;QAH9B,gBAAW,GAAX,WAAW,CAAQ;QACnB,oBAAe,GAAf,eAAe,CAAiB;QAChC,mBAAc,GAAd,cAAc,CAAQ;QACtB,mBAAc,GAAd,cAAc,CAAgB;IACrC,CAAC;IAEJ,KAAK;QACH,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;YACrC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;gBACvB,OAAO,CAAC,IAAI,CAAC,kCAAmC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3E,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,KAAK;QACT,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;QAC9E,IAAI,QAAyB,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACrD,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC3D,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;gBAC1C,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;gBACpE,IAAI,OAAO,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;oBACnC,mBAAmB;oBACnB,IAAI,CAAC;wBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;oBACrC,CAAC;oBAAC,MAAM,CAAC;wBACP,eAAe;oBACjB,CAAC;oBAED,uBAAuB;oBACvB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;oBAErD,4CAA4C;oBAC5C,MAAM,iBAAiB,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,EAAE;wBAC3D,OAAO,EAAE,OAAO,CAAC,IAAI;wBACrB,UAAU,EAAE,SAAS;wBACrB,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;wBAC5B,QAAQ,EAAE,KAAK,CAAC,aAAa;qBAC9B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/core/validate-tribute.d.ts

@@ -0,0 +1,11 @@
+import type { TributeBead, MailBead } from '../types/index.js';
+export interface TributeValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validate a TributeBead against its originating TASK_ASSIGNMENT mail.
+ * Schema + acceptance criteria validation only — no ceiling checks.
+ */
+export declare function validateTribute(tribute: TributeBead, taskMail: MailBead): TributeValidationResult;
+//# sourceMappingURL=validate-tribute.d.ts.map

package/dist/core/validate-tribute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-tribute.d.ts","sourceRoot":"","sources":["../../src/core/validate-tribute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAyB,MAAM,mBAAmB,CAAC;AAEtF,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,QAAQ,GACjB,uBAAuB,CA8CzB"}

package/dist/core/validate-tribute.js

@@ -0,0 +1,44 @@
+/**
+ * Validate a TributeBead against its originating TASK_ASSIGNMENT mail.
+ * Schema + acceptance criteria validation only — no ceiling checks.
+ */
+export function validateTribute(tribute, taskMail) {
+    const errors = [];
+    const payload = taskMail.payload;
+    // task_id must match
+    if (tribute.task_id !== (taskMail.task_id ?? taskMail.bead_id)) {
+        errors.push(`task_id mismatch: tribute="${tribute.task_id}" mail="${taskMail.task_id ?? taskMail.bead_id}"`);
+    }
+    // originating_mail_ref must match
+    if (tribute.originating_mail_ref !== taskMail.bead_id) {
+        errors.push(`originating_mail_ref mismatch: expected="${taskMail.bead_id}" got="${tribute.originating_mail_ref}"`);
+    }
+    // citizen_id must match spawn_hint
+    if (taskMail.spawn_hint && tribute.citizen_id !== taskMail.spawn_hint.citizen_id) {
+        errors.push(`citizen_id mismatch: expected="${taskMail.spawn_hint.citizen_id}" got="${tribute.citizen_id}"`);
+    }
+    // summary required
+    if (!tribute.summary || tribute.summary.trim() === '') {
+        errors.push('summary is required');
+    }
+    // acceptance_met count must match acceptance_criteria count
+    const criteriaCount = payload.acceptance_criteria?.length ?? 0;
+    const metCount = tribute.acceptance_met?.length ?? 0;
+    if (metCount !== criteriaCount) {
+        errors.push(`acceptance_met count (${metCount}) does not match acceptance_criteria count (${criteriaCount})`);
+    }
+    // SUCCESS requires all criteria met
+    if (tribute.status === 'SUCCESS') {
+        if (tribute.acceptance_met && !tribute.acceptance_met.every(Boolean)) {
+            errors.push('SUCCESS status requires all acceptance criteria to be met');
+        }
+    }
+    // PARTIAL requires not all met
+    if (tribute.status === 'PARTIAL') {
+        if (tribute.acceptance_met && tribute.acceptance_met.every(Boolean)) {
+            errors.push('PARTIAL status should not have all acceptance criteria met (use SUCCESS instead)');
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=validate-tribute.js.map

package/dist/core/validate-tribute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-tribute.js","sourceRoot":"","sources":["../../src/core/validate-tribute.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAoB,EACpB,QAAkB;IAElB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAgC,CAAC;IAE1D,qBAAqB;IACrB,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC,8BAA8B,OAAO,CAAC,OAAO,WAAW,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC;IAC/G,CAAC;IAED,kCAAkC;IAClC,IAAI,OAAO,CAAC,oBAAoB,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC,4CAA4C,QAAQ,CAAC,OAAO,UAAU,OAAO,CAAC,oBAAoB,GAAG,CAAC,CAAC;IACrH,CAAC;IAED,mCAAmC;IACnC,IAAI,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QACjF,MAAM,CAAC,IAAI,CAAC,kCAAkC,QAAQ,CAAC,UAAU,CAAC,UAAU,UAAU,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC;IAC/G,CAAC;IAED,mBAAmB;IACnB,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACrC,CAAC;IAED,4DAA4D;IAC5D,MAAM,aAAa,GAAG,OAAO,CAAC,mBAAmB,EAAE,MAAM,IAAI,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC,CAAC;IACrD,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,yBAAyB,QAAQ,+CAA+C,aAAa,GAAG,CAAC,CAAC;IAChH,CAAC;IAED,oCAAoC;IACpC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,OAAO,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACpE,MAAM,CAAC,IAAI,CAAC,kFAAkF,CAAC,CAAC;QAClG,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC"}

package/dist/core/worktree-manager.d.ts

@@ -0,0 +1,20 @@
+import type { WorktreeEntry } from '../types/index.js';
+export declare class WorktreeManager {
+    private citadelRoot;
+    constructor(citadelRoot: string);
+    /** Resolve outpost repo path from slug via outposts.json */
+    private resolveOutpostPath;
+    /** Create a worktree for a citizen task */
+    create(slug: string, _citizenId: string, taskId: string): Promise<string>;
+    /** Remove a worktree by task ID */
+    remove(slug: string, taskId: string): Promise<void>;
+    /** Check if a worktree exists for a task */
+    exists(slug: string, taskId: string): Promise<boolean>;
+    /** List all worktrees for an outpost (parse git worktree list --porcelain) */
+    list(slug: string): Promise<WorktreeEntry[]>;
+    /** Find orphaned worktrees (exist on disk but not in a provided set of active task IDs) */
+    listOrphaned(slug: string, activeTaskIds: Set<string>): Promise<WorktreeEntry[]>;
+    /** Prune all orphaned worktrees */
+    pruneOrphaned(slug: string, activeTaskIds: Set<string>): Promise<number>;
+}
+//# sourceMappingURL=worktree-manager.d.ts.map

package/dist/core/worktree-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-manager.d.ts","sourceRoot":"","sources":["../../src/core/worktree-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIxE,qBAAa,eAAe;IACd,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,MAAM;IAEvC,4DAA4D;YAC9C,kBAAkB;IAUhC,2CAA2C;IACrC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ/E,mCAAmC;IAC7B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzD,4CAA4C;IACtC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW5D,8EAA8E;IACxE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAMlD,2FAA2F;IACrF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAatF,mCAAmC;IAC7B,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAc/E"}

package/dist/core/worktree-manager.js

@@ -0,0 +1,123 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { execFile as execFileCb } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFile = promisify(execFileCb);
+export class WorktreeManager {
+    citadelRoot;
+    constructor(citadelRoot) {
+        this.citadelRoot = citadelRoot;
+    }
+    /** Resolve outpost repo path from slug via outposts.json */
+    async resolveOutpostPath(slug) {
+        const raw = await fs.readFile(path.join(this.citadelRoot, '.citadel', 'outposts.json'), 'utf-8');
+        const registry = JSON.parse(raw);
+        const entry = registry.outposts.find(o => o.slug === slug);
+        if (!entry)
+            throw new Error(`Outpost "${slug}" not found in registry`);
+        return entry.path;
+    }
+    /** Create a worktree for a citizen task */
+    async create(slug, _citizenId, taskId) {
+        const repoRoot = await this.resolveOutpostPath(slug);
+        const worktreePath = path.join(repoRoot, 'worktrees', 'citizen', taskId);
+        const branch = `citizen/${taskId}`;
+        await execFile('git', ['worktree', 'add', '-b', branch, worktreePath], { cwd: repoRoot });
+        return worktreePath;
+    }
+    /** Remove a worktree by task ID */
+    async remove(slug, taskId) {
+        const repoRoot = await this.resolveOutpostPath(slug);
+        const worktreePath = path.join(repoRoot, 'worktrees', 'citizen', taskId);
+        await execFile('git', ['worktree', 'remove', '--force', worktreePath], { cwd: repoRoot });
+        // Prune stale worktree metadata
+        await execFile('git', ['worktree', 'prune'], { cwd: repoRoot });
+    }
+    /** Check if a worktree exists for a task */
+    async exists(slug, taskId) {
+        const repoRoot = await this.resolveOutpostPath(slug);
+        const worktreePath = path.join(repoRoot, 'worktrees', 'citizen', taskId);
+        try {
+            await fs.access(worktreePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** List all worktrees for an outpost (parse git worktree list --porcelain) */
+    async list(slug) {
+        const repoRoot = await this.resolveOutpostPath(slug);
+        const { stdout } = await execFile('git', ['worktree', 'list', '--porcelain'], { cwd: repoRoot });
+        return parseWorktreeList(stdout);
+    }
+    /** Find orphaned worktrees (exist on disk but not in a provided set of active task IDs) */
+    async listOrphaned(slug, activeTaskIds) {
+        const entries = await this.list(slug);
+        const repoRoot = await this.resolveOutpostPath(slug);
+        const citizenDir = path.resolve(repoRoot, 'worktrees', 'citizen');
+        // Only consider worktrees under worktrees/citizen/
+        return entries.filter(e => {
+            const resolved = path.resolve(e.path);
+            if (!resolved.startsWith(citizenDir))
+                return false;
+            const taskId = path.basename(resolved);
+            return !activeTaskIds.has(taskId);
+        });
+    }
+    /** Prune all orphaned worktrees */
+    async pruneOrphaned(slug, activeTaskIds) {
+        const orphaned = await this.listOrphaned(slug, activeTaskIds);
+        for (const entry of orphaned) {
+            const repoRoot = await this.resolveOutpostPath(slug);
+            try {
+                await execFile('git', ['worktree', 'remove', '--force', entry.path], { cwd: repoRoot });
+            }
+            catch {
+                // best effort
+            }
+        }
+        const repoRoot = await this.resolveOutpostPath(slug);
+        await execFile('git', ['worktree', 'prune'], { cwd: repoRoot });
+        return orphaned.length;
+    }
+}
+/** Parse `git worktree list --porcelain` output */
+function parseWorktreeList(output) {
+    const entries = [];
+    let current = {};
+    for (const line of output.split('\n')) {
+        if (line.startsWith('worktree ')) {
+            current.path = line.slice('worktree '.length);
+        }
+        else if (line.startsWith('HEAD ')) {
+            current.head = line.slice('HEAD '.length);
+        }
+        else if (line.startsWith('branch ')) {
+            current.branch = line.slice('branch '.length);
+        }
+        else if (line === 'prunable') {
+            current.prunable = true;
+        }
+        else if (line.trim() === '' && current.path) {
+            entries.push({
+                path: current.path,
+                branch: current.branch ?? '',
+                head: current.head ?? '',
+                prunable: current.prunable ?? false,
+            });
+            current = {};
+        }
+    }
+    // Handle last entry if no trailing newline
+    if (current.path) {
+        entries.push({
+            path: current.path,
+            branch: current.branch ?? '',
+            head: current.head ?? '',
+            prunable: current.prunable ?? false,
+        });
+    }
+    return entries;
+}
+//# sourceMappingURL=worktree-manager.js.map

package/dist/core/worktree-manager.js.map

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