@citadel-labs/citadel 0.1.0

package/dist/core/citizen-tribute.js

@@ -0,0 +1,55 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { appendBead, mintBeadId, readBeads } from './append-bead.js';
+import { SCHEMA_VERSION } from '../types/index.js';
+/**
+ * Write a Tribute bead from within a Citizen process.
+ * Reads env vars for context. Writes to <outpost_path>/.beads/tribute/<task_id>_tribute.jsonl
+ * Attempt number is determined from existing lines + 1.
+ */
+export async function writeTribute(opts) {
+    const beadsRoot = requireEnv('CITADEL_BEADS_ROOT');
+    const outpost = requireEnv('CITADEL_OUTPOST');
+    const citizenId = requireEnv('CITADEL_CITIZEN_ID');
+    const taskId = requireEnv('CITADEL_TASK_ID');
+    const worktree = requireEnv('CITADEL_WORKTREE');
+    const archetype = requireEnv('CITADEL_ARCHETYPE');
+    // Resolve outpost path from outposts.json
+    const outpostsPath = path.join(beadsRoot, '.citadel', 'outposts.json');
+    const raw = await fs.readFile(outpostsPath, 'utf-8');
+    const registry = JSON.parse(raw);
+    const outpostEntry = registry.outposts.find((o) => o.slug === outpost);
+    if (!outpostEntry)
+        throw new Error(`Outpost "${outpost}" not found in registry`);
+    const tributePath = path.join(outpostEntry.path, '.beads', 'tribute', `${taskId}_tribute.jsonl`);
+    // Determine attempt number
+    const existing = await readBeads(tributePath);
+    const attempt = existing.length + 1;
+    const bead = {
+        bead_id: mintBeadId('TRIBUTE'),
+        bead_type: 'TRIBUTE',
+        schema_version: SCHEMA_VERSION,
+        created_at: new Date().toISOString(),
+        citizen_id: citizenId,
+        task_id: taskId,
+        originating_mail_ref: opts.originatingMailRef,
+        archetype,
+        outpost,
+        worktree,
+        attempt,
+        status: opts.status,
+        summary: opts.summary,
+        artifacts: opts.artifacts,
+        acceptance_met: opts.acceptanceMet,
+        elapsed_seconds: opts.elapsedSeconds,
+        ...(opts.prUrl ? { pr_url: opts.prUrl } : {}),
+    };
+    return appendBead(tributePath, bead);
+}
+function requireEnv(name) {
+    const value = process.env[name];
+    if (!value)
+        throw new Error(`Missing required env var: ${name}`);
+    return value;
+}
+//# sourceMappingURL=citizen-tribute.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"citizen-tribute.js","sourceRoot":"","sources":["../../src/core/citizen-tribute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAanD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAyB;IAC1D,MAAM,SAAS,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAElD,0CAA0C;IAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IACzF,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,yBAAyB,CAAC,CAAC;IAEjF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,gBAAgB,CAAC,CAAC;IAEjG,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAc,WAAW,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAEpC,MAAM,IAAI,GAAgB;QACxB,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC;QAC9B,SAAS,EAAE,SAAS;QACpB,cAAc,EAAE,cAAc;QAC9B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,UAAU,EAAE,SAAS;QACrB,OAAO,EAAE,MAAM;QACf,oBAAoB,EAAE,IAAI,CAAC,kBAAkB;QAC7C,SAAS;QACT,OAAO;QACP,QAAQ;QACR,OAAO;QACP,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,cAAc,EAAE,IAAI,CAAC,aAAa;QAClC,eAAe,EAAE,IAAI,CAAC,cAAc;QACpC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,CAAC;IAEF,OAAO,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/command-bead.d.ts

@@ -0,0 +1,6 @@
+import type { CommandBead, CommandName, CommandArgs } from '../types/index.js';
+/**
+ * Write a Command Bead to .citadel/commands/<bead_id>.jsonl
+ */
+export declare function writeCommandBead(citadelRoot: string, command: CommandName, args: CommandArgs): Promise<CommandBead>;
+//# sourceMappingURL=command-bead.d.ts.map

package/dist/core/command-bead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-bead.d.ts","sourceRoot":"","sources":["../../src/core/command-bead.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE/E;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,WAAW,CAAC,CAgBtB"}

package/dist/core/command-bead.js

@@ -0,0 +1,20 @@
+import path from 'node:path';
+import { appendBead, mintBeadId } from './append-bead.js';
+import { SCHEMA_VERSION } from '../types/index.js';
+/**
+ * Write a Command Bead to .citadel/commands/<bead_id>.jsonl
+ */
+export async function writeCommandBead(citadelRoot, command, args) {
+    const beadId = mintBeadId('COMMAND');
+    const bead = {
+        bead_id: beadId,
+        bead_type: 'COMMAND',
+        schema_version: SCHEMA_VERSION,
+        created_at: new Date().toISOString(),
+        command,
+        args,
+        processed: false,
+    };
+    return appendBead(path.join(citadelRoot, '.citadel', 'commands', `${beadId}.jsonl`), bead);
+}
+//# sourceMappingURL=command-bead.js.map

package/dist/core/command-bead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-bead.js","sourceRoot":"","sources":["../../src/core/command-bead.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,OAAoB,EACpB,IAAiB;IAEjB,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,IAAI,GAAgB;QACxB,OAAO,EAAE,MAAM;QACf,SAAS,EAAE,SAAS;QACpB,cAAc,EAAE,cAAc;QAC9B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,OAAO;QACP,IAAI;QACJ,SAAS,EAAE,KAAK;KACjB,CAAC;IAEF,OAAO,UAAU,CACf,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,MAAM,QAAQ,CAAC,EACjE,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/core/courier.d.ts

@@ -0,0 +1,52 @@
+import type { CourierConfig } from '../types/index.js';
+import { EventEmitter } from 'node:events';
+export interface CourierOptions {
+    configPath?: string;
+    citadelRoot?: string;
+}
+export type CourierEvent = {
+    type: 'mail';
+    outpost: string;
+    filePath: string;
+} | {
+    type: 'tribute';
+    outpost: string;
+    filePath: string;
+} | {
+    type: 'command';
+    filePath: string;
+} | {
+    type: 'nudge';
+    filePath: string;
+};
+export interface CourierEventHandlers {
+    onMail: (outpost: string, filePath: string) => Promise<void>;
+    onTribute: (outpost: string, filePath: string) => Promise<void>;
+    onCommand: (filePath: string) => Promise<void>;
+    onNudge: (filePath: string) => Promise<void>;
+}
+export declare class Courier extends EventEmitter {
+    private options;
+    private config;
+    private watcher;
+    private citadelRoot;
+    constructor(options?: CourierOptions);
+    /** Resolve config: explicit path > courier.config.yaml > defaults */
+    resolveConfig(): Promise<CourierConfig>;
+    /** Load outpost registry and build watch paths */
+    private buildWatchPaths;
+    /** Classify a changed file path into a CourierEvent */
+    private classifyEvent;
+    /** Extract outpost slug from a bead file path by matching against known outpost paths */
+    private outpostPaths;
+    private extractOutpostSlug;
+    /** Start watching */
+    start(): Promise<void>;
+    /** Register handler callbacks for Courier events */
+    setEventHandlers(handlers: CourierEventHandlers): void;
+    private handleFileEvent;
+    /** Stop watching */
+    stop(): Promise<void>;
+    getConfig(): CourierConfig;
+}
+//# sourceMappingURL=courier.d.ts.map

package/dist/core/courier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"courier.d.ts","sourceRoot":"","sources":["../../src/core/courier.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED,qBAAa,OAAQ,SAAQ,YAAY;IAK3B,OAAO,CAAC,OAAO;IAJ3B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,WAAW,CAAS;gBAER,OAAO,GAAE,cAAmB;IAKhD,qEAAqE;IAC/D,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC;IA2B7C,kDAAkD;YACpC,eAAe;IAwB7B,uDAAuD;IACvD,OAAO,CAAC,aAAa;IA+BrB,yFAAyF;IACzF,OAAO,CAAC,YAAY,CAAkC;IAEtD,OAAO,CAAC,kBAAkB;IAO1B,qBAAqB;IACf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC5B,oDAAoD;IACpD,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAuBtD,OAAO,CAAC,eAAe;IAOvB,oBAAoB;IACd,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,SAAS,IAAI,aAAa;CAG3B"}

package/dist/core/courier.js

@@ -0,0 +1,167 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { parse as parseYaml } from 'yaml';
+import { watch as chokidarWatch } from 'chokidar';
+import { EventEmitter } from 'node:events';
+export class Courier extends EventEmitter {
+    options;
+    config;
+    watcher = null;
+    citadelRoot;
+    constructor(options = {}) {
+        super();
+        this.options = options;
+        this.citadelRoot = options.citadelRoot ?? process.cwd();
+    }
+    /** Resolve config: explicit path > courier.config.yaml > defaults */
+    async resolveConfig() {
+        if (this.options.configPath) {
+            const raw = await fs.readFile(this.options.configPath, 'utf-8');
+            this.config = parseYaml(raw);
+            return this.config;
+        }
+        const yamlPath = path.join(this.citadelRoot, 'courier.config.yaml');
+        try {
+            const raw = await fs.readFile(yamlPath, 'utf-8');
+            this.config = parseYaml(raw);
+            return this.config;
+        }
+        catch {
+            // Fall back to defaults
+            this.config = {
+                citadel_root: '.',
+                poll_interval_ms: 500,
+                debounce_ms: 200,
+                default_max_citizens: 3,
+                citizen_timeout_seconds: 1800,
+                log_level: 'INFO',
+                log_path: '.citadel/logs/courier.log',
+            };
+            return this.config;
+        }
+    }
+    /** Load outpost registry and build watch paths */
+    async buildWatchPaths() {
+        const paths = [];
+        const outpostsPath = path.join(this.citadelRoot, '.citadel', 'outposts.json');
+        try {
+            const raw = await fs.readFile(outpostsPath, 'utf-8');
+            const registry = JSON.parse(raw);
+            for (const outpost of registry.outposts) {
+                if (outpost.status !== 'ACTIVE')
+                    continue;
+                paths.push(path.join(outpost.path, '.beads', 'mail'));
+                paths.push(path.join(outpost.path, '.beads', 'tribute'));
+            }
+        }
+        catch {
+            // No outposts registered yet
+        }
+        // Also watch citadel-level directories
+        paths.push(path.join(this.citadelRoot, '.citadel', 'commands'));
+        paths.push(path.join(this.citadelRoot, '.citadel', 'nudges.jsonl'));
+        return paths;
+    }
+    /** Classify a changed file path into a CourierEvent */
+    classifyEvent(filePath) {
+        // Normalize paths for comparison
+        const norm = path.resolve(filePath);
+        // Check if it's a command file
+        const commandsDir = path.resolve(this.citadelRoot, '.citadel', 'commands');
+        if (norm.startsWith(commandsDir)) {
+            return { type: 'command', filePath: norm };
+        }
+        // Check if it's the nudges file
+        const nudgesPath = path.resolve(this.citadelRoot, '.citadel', 'nudges.jsonl');
+        if (norm === nudgesPath) {
+            return { type: 'nudge', filePath: norm };
+        }
+        // Check outpost paths (mail or tribute)
+        // We need to figure out which outpost this belongs to
+        if (norm.includes(path.sep + '.beads' + path.sep + 'mail' + path.sep)) {
+            const outpost = this.extractOutpostSlug(norm);
+            if (outpost)
+                return { type: 'mail', outpost, filePath: norm };
+        }
+        if (norm.includes(path.sep + '.beads' + path.sep + 'tribute' + path.sep)) {
+            const outpost = this.extractOutpostSlug(norm);
+            if (outpost)
+                return { type: 'tribute', outpost, filePath: norm };
+        }
+        return null;
+    }
+    /** Extract outpost slug from a bead file path by matching against known outpost paths */
+    outpostPaths = new Map(); // path -> slug
+    extractOutpostSlug(filePath) {
+        for (const [outpostPath, slug] of this.outpostPaths) {
+            if (filePath.startsWith(outpostPath))
+                return slug;
+        }
+        return null;
+    }
+    /** Start watching */
+    async start() {
+        await this.resolveConfig();
+        // Build outpost path -> slug mapping
+        const outpostsPath = path.join(this.citadelRoot, '.citadel', 'outposts.json');
+        try {
+            const raw = await fs.readFile(outpostsPath, 'utf-8');
+            const registry = JSON.parse(raw);
+            for (const outpost of registry.outposts) {
+                this.outpostPaths.set(path.resolve(outpost.path), outpost.slug);
+            }
+        }
+        catch {
+            // No outposts
+        }
+        const watchPaths = await this.buildWatchPaths();
+        this.watcher = chokidarWatch(watchPaths, {
+            ignoreInitial: true,
+            persistent: true,
+            awaitWriteFinish: {
+                stabilityThreshold: this.config.debounce_ms,
+                pollInterval: 50,
+            },
+        });
+        this.watcher.on('add', (fp) => this.handleFileEvent(fp));
+        this.watcher.on('change', (fp) => this.handleFileEvent(fp));
+        this.emit('started');
+    }
+    /** Register handler callbacks for Courier events */
+    setEventHandlers(handlers) {
+        this.on('event', (event) => {
+            switch (event.type) {
+                case 'mail':
+                    handlers.onMail(event.outpost, event.filePath).catch(err => console.error(`[Courier] mail handler error: ${err.message}`));
+                    break;
+                case 'tribute':
+                    handlers.onTribute(event.outpost, event.filePath).catch(err => console.error(`[Courier] tribute handler error: ${err.message}`));
+                    break;
+                case 'command':
+                    handlers.onCommand(event.filePath).catch(err => console.error(`[Courier] command handler error: ${err.message}`));
+                    break;
+                case 'nudge':
+                    handlers.onNudge(event.filePath).catch(err => console.error(`[Courier] nudge handler error: ${err.message}`));
+                    break;
+            }
+        });
+    }
+    handleFileEvent(filePath) {
+        const event = this.classifyEvent(filePath);
+        if (event) {
+            this.emit('event', event);
+        }
+    }
+    /** Stop watching */
+    async stop() {
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+        }
+        this.emit('stopped');
+    }
+    getConfig() {
+        return this.config;
+    }
+}
+//# sourceMappingURL=courier.js.map

package/dist/core/courier.js.map

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

package/dist/core/fo-broadcast.d.ts

@@ -0,0 +1,15 @@
+import type { TributeBead } from '../types/index.js';
+export interface BroadcastResult {
+    sent: number;
+    recipients: Array<{
+        outpost: string;
+        taskId: string;
+        mailBeadId: string;
+    }>;
+}
+/**
+ * On SUCCESS tribute: find all tasks across outposts that depend on the
+ * resolved task_id and send each a DEPENDENCY_RESOLVED mail.
+ */
+export declare function broadcastDependencyResolved(citadelRoot: string, tribute: TributeBead): Promise<BroadcastResult>;
+//# sourceMappingURL=fo-broadcast.d.ts.map

package/dist/core/fo-broadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fo-broadcast.d.ts","sourceRoot":"","sources":["../../src/core/fo-broadcast.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAY,WAAW,EAA6B,MAAM,mBAAmB,CAAC;AAE1F,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC,CAqD1B"}

package/dist/core/fo-broadcast.js

@@ -0,0 +1,57 @@
+import path from 'node:path';
+import { appendBead, mintBeadId } from './append-bead.js';
+import { getBlockedOutposts } from './blocked-outposts.js';
+import { getActiveOutposts } from './outpost-registry.js';
+import { SCHEMA_VERSION } from '../types/index.js';
+/**
+ * On SUCCESS tribute: find all tasks across outposts that depend on the
+ * resolved task_id and send each a DEPENDENCY_RESOLVED mail.
+ */
+export async function broadcastDependencyResolved(citadelRoot, tribute) {
+    const blocked = await getBlockedOutposts(citadelRoot, tribute.task_id);
+    const result = { sent: 0, recipients: [] };
+    if (blocked.length === 0)
+        return result;
+    // Resolve outpost paths for writing mail
+    const activeOutposts = await getActiveOutposts(citadelRoot);
+    const outpostPathMap = new Map(activeOutposts.map(o => [o.slug, o.path]));
+    for (const task of blocked) {
+        const outpostPath = outpostPathMap.get(task.outpost);
+        if (!outpostPath)
+            continue;
+        const payload = {
+            resolved_task_id: tribute.task_id,
+            resolved_by_outpost: tribute.outpost,
+            tribute_ref: tribute.bead_id,
+            pr_url: tribute.pr_url,
+            summary: tribute.summary,
+        };
+        const mail = {
+            bead_id: mintBeadId('MAIL'),
+            bead_type: 'MAIL',
+            schema_version: SCHEMA_VERSION,
+            created_at: new Date().toISOString(),
+            task_id: task.taskId,
+            mail_type: 'DEPENDENCY_RESOLVED',
+            from: 'citadel',
+            to: task.outpost,
+            subject: `Dependency resolved: ${tribute.task_id}`,
+            read: false,
+            retry_of: null,
+            payload,
+        };
+        const mailPath = path.join(outpostPath, '.beads', 'mail', `depres-${mail.bead_id}.jsonl`);
+        await appendBead(mailPath, mail);
+        result.sent++;
+        result.recipients.push({
+            outpost: task.outpost,
+            taskId: task.taskId,
+            mailBeadId: mail.bead_id,
+        });
+    }
+    if (result.sent > 0) {
+        console.log(`[FO] DEPENDENCY_RESOLVED broadcast: ${result.sent} task(s) notified for resolved "${tribute.task_id}"`);
+    }
+    return result;
+}
+//# sourceMappingURL=fo-broadcast.js.map

package/dist/core/fo-broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fo-broadcast.js","sourceRoot":"","sources":["../../src/core/fo-broadcast.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAQnD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,WAAmB,EACnB,OAAoB;IAEpB,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,MAAM,MAAM,GAAoB,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAE5D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAExC,yCAAyC;IACzC,MAAM,cAAc,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE1E,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrD,IAAI,CAAC,WAAW;YAAE,SAAS;QAE3B,MAAM,OAAO,GAA8B;YACzC,gBAAgB,EAAE,OAAO,CAAC,OAAO;YACjC,mBAAmB,EAAE,OAAO,CAAC,OAAO;YACpC,WAAW,EAAE,OAAO,CAAC,OAAO;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;QAEF,MAAM,IAAI,GAAa;YACrB,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC;YAC3B,SAAS,EAAE,MAAM;YACjB,cAAc,EAAE,cAAc;YAC9B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,OAAO,EAAE,IAAI,CAAC,MAAM;YACpB,SAAS,EAAE,qBAAqB;YAChC,IAAI,EAAE,SAAS;YACf,EAAE,EAAE,IAAI,CAAC,OAAO;YAChB,OAAO,EAAE,wBAAwB,OAAO,CAAC,OAAO,EAAE;YAClD,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,OAAO;SACR,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC;QAC1F,MAAM,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAEjC,MAAM,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,OAAO;SACzB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,uCAAuC,MAAM,CAAC,IAAI,mCAAmC,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC;IACvH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/fo-command-processor.d.ts

@@ -0,0 +1,7 @@
+import { ProcessRegistry } from './process-registry.js';
+import type { CommandBead } from '../types/index.js';
+/**
+ * Process a Command Bead — dispatch, note, retry, or resolve.
+ */
+export declare function processCommandBead(citadelRoot: string, bead: CommandBead, processRegistry: ProcessRegistry): Promise<void>;
+//# sourceMappingURL=fo-command-processor.d.ts.map

package/dist/core/fo-command-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fo-command-processor.d.ts","sourceRoot":"","sources":["../../src/core/fo-command-processor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,KAAK,EAAE,WAAW,EAA6E,MAAM,mBAAmB,CAAC;AAGhI;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,EACjB,eAAe,EAAE,eAAe,GAC/B,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/core/fo-command-processor.js

@@ -0,0 +1,123 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { appendBead, mintBeadId } from './append-bead.js';
+import { dispatch } from './fo-dispatch.js';
+import { GrandArchives } from './grand-archives.js';
+import { reconstructState } from './fo-state.js';
+import { SCHEMA_VERSION } from '../types/index.js';
+import { nanoid } from 'nanoid';
+/**
+ * Process a Command Bead — dispatch, note, retry, or resolve.
+ */
+export async function processCommandBead(citadelRoot, bead, processRegistry) {
+    switch (bead.command) {
+        case 'dispatch':
+            await handleDispatch(citadelRoot, bead.args, processRegistry);
+            break;
+        case 'note':
+            await handleNote(citadelRoot, bead.args);
+            break;
+        case 'retry':
+            await handleRetry(citadelRoot, bead.args, processRegistry);
+            break;
+        case 'resolve':
+            await handleResolve(citadelRoot, bead.args, processRegistry);
+            break;
+    }
+}
+async function handleDispatch(citadelRoot, args, processRegistry) {
+    await dispatch({
+        citadelRoot,
+        outpostSlug: args.outpost,
+        task: {
+            title: args.task,
+            description: args.task,
+            acceptanceCriteria: [],
+        },
+        archetype: args.archetype,
+        processRegistry,
+    });
+}
+async function handleNote(citadelRoot, args) {
+    // Resolve outpost path
+    const outpostsPath = path.join(citadelRoot, '.citadel', 'outposts.json');
+    const raw = await fs.readFile(outpostsPath, 'utf-8');
+    const registry = JSON.parse(raw);
+    const outpost = registry.outposts.find(o => o.slug === args.outpost);
+    if (!outpost)
+        throw new Error(`Outpost "${args.outpost}" not found`);
+    // Resolve archetype for spawn_hint (PRD §3.1.1: all downward mail carries spawn_hint)
+    let archetypeKey = outpost.default_archetype;
+    if (!archetypeKey) {
+        const archives = new GrandArchives(citadelRoot);
+        const archetypeRegistry = await archives.listArchetypes();
+        const active = archetypeRegistry.archetypes.find(a => a.status === 'active');
+        if (active)
+            archetypeKey = active.key;
+    }
+    const citizenId = `citizen-${nanoid()}`;
+    const mail = {
+        bead_id: mintBeadId('MAIL'),
+        bead_type: 'MAIL',
+        schema_version: SCHEMA_VERSION,
+        created_at: new Date().toISOString(),
+        task_id: args.task_id,
+        mail_type: 'OPERATOR_NOTE',
+        from: 'citadel',
+        to: args.outpost,
+        subject: 'Operator note',
+        read: false,
+        retry_of: null,
+        spawn_hint: {
+            archetype: archetypeKey ?? 'software-engineer',
+            citizen_id: citizenId,
+        },
+        payload: {
+            body: args.body,
+            task_id: args.task_id,
+        },
+    };
+    const mailPath = path.join(outpost.path, '.beads', 'mail', `note-${mail.bead_id}.jsonl`);
+    await appendBead(mailPath, mail);
+    console.log(`[FO] Note sent to outpost "${args.outpost}"`);
+}
+async function handleRetry(citadelRoot, args, _processRegistry) {
+    // Find the original TASK_ASSIGNMENT for this task
+    const state = await reconstructState(citadelRoot);
+    const task = state.tasks.find(t => t.taskId === args.task_id);
+    if (!task)
+        throw new Error(`Task "${args.task_id}" not found in state`);
+    const origMail = task.assignmentMail;
+    // Re-dispatch with retry_of
+    const outpostsPath = path.join(citadelRoot, '.citadel', 'outposts.json');
+    const raw = await fs.readFile(outpostsPath, 'utf-8');
+    const registry = JSON.parse(raw);
+    const outpost = registry.outposts.find(o => o.slug === task.outpost);
+    if (!outpost)
+        throw new Error(`Outpost "${task.outpost}" not found`);
+    const retryMail = {
+        ...origMail,
+        bead_id: mintBeadId('MAIL'),
+        created_at: new Date().toISOString(),
+        read: false,
+        retry_of: origMail.bead_id,
+    };
+    const mailPath = path.join(outpost.path, '.beads', 'mail', `retry-${retryMail.bead_id}.jsonl`);
+    await appendBead(mailPath, retryMail);
+    console.log(`[FO] Retry issued for task "${args.task_id}"`);
+}
+async function handleResolve(citadelRoot, args, _processRegistry) {
+    const { task_id, action, note } = args;
+    switch (action) {
+        case 'retry':
+            await handleRetry(citadelRoot, { task_id }, _processRegistry);
+            break;
+        case 'abandon':
+            console.log(`[FO] Task "${task_id}" abandoned${note ? `: ${note}` : ''}`);
+            break;
+        case 'rewrite':
+            console.log(`[FO] Task "${task_id}" marked for rewrite${note ? `: ${note}` : ''}`);
+            break;
+    }
+}
+//# sourceMappingURL=fo-command-processor.js.map

package/dist/core/fo-command-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fo-command-processor.js","sourceRoot":"","sources":["../../src/core/fo-command-processor.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,IAAiB,EACjB,eAAgC;IAEhC,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,UAAU;YACb,MAAM,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,IAAoB,EAAE,eAAe,CAAC,CAAC;YAC9E,MAAM;QACR,KAAK,MAAM;YACT,MAAM,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,IAAgB,CAAC,CAAC;YACrD,MAAM;QACR,KAAK,OAAO;YACV,MAAM,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,IAAiB,EAAE,eAAe,CAAC,CAAC;YACxE,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,IAAmB,EAAE,eAAe,CAAC,CAAC;YAC5E,MAAM;IACV,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,WAAmB,EACnB,IAAkB,EAClB,eAAgC;IAEhC,MAAM,QAAQ,CAAC;QACb,WAAW;QACX,WAAW,EAAE,IAAI,CAAC,OAAO;QACzB,IAAI,EAAE;YACJ,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,WAAW,EAAE,IAAI,CAAC,IAAI;YACtB,kBAAkB,EAAE,EAAE;SACvB;QACD,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,eAAe;KAChB,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,WAAmB,EAAE,IAAc;IAC3D,uBAAuB;IACvB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;IACzE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAoB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC;IACrE,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,OAAO,aAAa,CAAC,CAAC;IAErE,sFAAsF;IACtF,IAAI,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAC7C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,iBAAiB,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;QAC7E,IAAI,MAAM;YAAE,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC;IACxC,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,MAAM,EAAE,EAAE,CAAC;IAExC,MAAM,IAAI,GAAa;QACrB,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC;QAC3B,SAAS,EAAE,MAAM;QACjB,cAAc,EAAE,cAAc;QAC9B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,eAAe;QAC1B,IAAI,EAAE,SAAS;QACf,EAAE,EAAE,IAAI,CAAC,OAAO;QAChB,OAAO,EAAE,eAAe;QACxB,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE;YACV,SAAS,EAAE,YAAY,IAAI,mBAAmB;YAC9C,UAAU,EAAE,SAAS;SACtB;QACD,OAAO,EAAE;YACP,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB;KACF,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC;IACzF,MAAM,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,WAAmB,EACnB,IAAe,EACf,gBAAkC;IAElC,kDAAkD;IAClD,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,OAAO,sBAAsB,CAAC,CAAC;IAExE,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC;IACrC,4BAA4B;IAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;IACzE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAoB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC;IACrE,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,OAAO,aAAa,CAAC,CAAC;IAErE,MAAM,SAAS,GAAa;QAC1B,GAAG,QAAQ;QACX,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC;QAC3B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,QAAQ,CAAC,OAAO;KAC3B,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAS,CAAC,OAAO,QAAQ,CAAC,CAAC;IAC/F,MAAM,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,WAAmB,EACnB,IAAiB,EACjB,gBAAiC;IAEjC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAEvC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,MAAM,WAAW,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;YAC9D,MAAM;QACR,KAAK,SAAS;YACZ,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,cAAc,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1E,MAAM;QACR,KAAK,SAAS;YACZ,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,uBAAuB,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnF,MAAM;IACV,CAAC;AACH,CAAC"}

package/dist/core/fo-dispatch.d.ts

@@ -0,0 +1,24 @@
+import type { MailBead } from '../types/index.js';
+import { ProcessRegistry } from './process-registry.js';
+export interface DispatchOptions {
+    citadelRoot: string;
+    outpostSlug: string;
+    task: TaskDescription;
+    archetype?: string;
+    processRegistry: ProcessRegistry;
+}
+export interface TaskDescription {
+    title: string;
+    description: string;
+    acceptanceCriteria: string[];
+    priority?: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
+    contextRefs?: string[];
+    dependencies?: string[];
+    timeoutSeconds?: number;
+}
+/**
+ * First Officer dispatch: select archetype, mint citizen_id, compose TASK_ASSIGNMENT mail,
+ * write to outpost inbox. Respects max_citizens ceiling.
+ */
+export declare function dispatch(opts: DispatchOptions): Promise<MailBead>;
+//# sourceMappingURL=fo-dispatch.d.ts.map

package/dist/core/fo-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fo-dispatch.d.ts","sourceRoot":"","sources":["../../src/core/fo-dispatch.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAgE,MAAM,mBAAmB,CAAC;AAChH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuEvE"}