opensquid 0.5.395

package/dist/channels/inbound_router.d.ts

@@ -0,0 +1,110 @@
+/**
+ * `InboundRouter` — AUTO.6 inbound-channel dispatcher.
+ *
+ * Authoritative source: `docs/tasks/automation.md` AUTO.6. Walks the user's
+ * `RoutingConfig.channelMapping`, finds the adapter for each concrete URI,
+ * and (when the adapter implements `subscribeInbound`) attaches a per-
+ * abstract-channel listener. Inbound messages flow:
+ *
+ *   adapter.subscribeInbound(handler)
+ *     → handler(event)
+ *       → CapabilityGate.check(pack, 'send_message', sender)   [optional]
+ *         → if allowed → dispatch(event)
+ *         → if denied  → audit + drop
+ *
+ * Sender allowlist is intentionally enforced via the existing AUTO.3
+ * capability gate (`send_message` capability with `channels:` allowlist
+ * — repurposed for inbound: a sender ID is the principal, mapped against
+ * the same pack-declared list). The router does NOT introduce a new gate
+ * surface; reuse keeps audit + override semantics identical.
+ *
+ * Engine-vocabulary: emits `InboundChannelEvent` only; never knows what
+ * downstream evaluator does with the event.
+ *
+ * Imports from: ../runtime/event.js, ../runtime/capability_gate.js,
+ * ./types.js. Imported by: src/runtime/daemon.ts (later) + tests.
+ */
+import type { InboundChannelEvent } from '../runtime/event.js';
+import type { CapabilityGate } from '../runtime/capability_gate.js';
+import type { ChannelAdapter, RoutingConfig } from './types.js';
+/**
+ * Per-abstract-channel inbound binding. Each binding maps one abstract
+ * channel name (e.g. `'alerts'`) to the pack that listens on it. Multiple
+ * packs can listen on the same abstract channel — declare one binding per
+ * (pack, channel) pair.
+ */
+export interface InboundBinding {
+    /** Pack id — passed to `CapabilityGate.check` as the principal. */
+    pack: string;
+    /** Abstract channel name — looked up in `routing.channelMapping`. */
+    channel: string;
+}
+export type InboundDispatcher = (event: InboundChannelEvent) => Promise<void>;
+interface AuditCommon {
+    pack: string;
+    channel: string;
+}
+export type InboundRouterAuditEntry = (AuditCommon & {
+    event: 'inbound_subscribed';
+    uri: string;
+    scheme: string;
+}) | (AuditCommon & {
+    event: 'inbound_unmapped';
+}) | (AuditCommon & {
+    event: 'inbound_no_adapter';
+    scheme: string;
+}) | (AuditCommon & {
+    event: 'inbound_adapter_not_inboundable';
+    uri: string;
+    scheme: string;
+}) | (AuditCommon & {
+    event: 'inbound_dispatched';
+    uri: string;
+    sender: string;
+}) | (AuditCommon & {
+    event: 'inbound_sender_denied';
+    sender: string;
+    reason: string;
+}) | (AuditCommon & {
+    event: 'inbound_dispatch_error';
+    sender: string;
+    reason: string;
+});
+export type InboundRouterAuditSink = (entry: InboundRouterAuditEntry) => void;
+export interface InboundRouterOpts {
+    /** Optional capability gate. When set, every inbound event runs through
+     *  `gate.check({pack, capability: 'send_message', target: sender})`
+     *  BEFORE dispatch. Denial drops the event + audits. Unset → no
+     *  sender filtering (dev/test default). */
+    capabilityGate?: CapabilityGate;
+    auditLog?: InboundRouterAuditSink;
+}
+export declare class InboundRouter {
+    private readonly subscriptions;
+    private readonly auditLog;
+    private readonly capabilityGate;
+    private state;
+    constructor(opts?: InboundRouterOpts);
+    /**
+     * Walk `bindings`, resolve each abstract channel → URI via
+     * `routing.channelMapping`, look up the adapter by URI scheme, and call
+     * its `subscribeInbound` to attach a sender-gated dispatcher. Skips +
+     * audits any binding whose channel is unmapped, whose adapter scheme
+     * isn't registered, or whose adapter doesn't implement `subscribeInbound`.
+     *
+     * Idempotent: a second `start()` while already running throws so the
+     * caller surfaces a lifecycle bug rather than double-subscribing.
+     */
+    start(bindings: readonly InboundBinding[], routing: RoutingConfig, adapters: Map<string, ChannelAdapter>, dispatch: InboundDispatcher): Promise<void>;
+    /**
+     * Unsubscribe every active binding in reverse order. Idempotent — a
+     * second stop() is a no-op. Each unsubscribe is best-effort; failures
+     * are swallowed so a single bad adapter doesn't strand the rest.
+     */
+    stop(): Promise<void>;
+    /** Test/inspection — number of active subscriptions. */
+    activeSubscriptionCount(): number;
+    private handleInbound;
+}
+export {};
+//# sourceMappingURL=inbound_router.d.ts.map

package/dist/channels/inbound_router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound_router.d.ts","sourceRoot":"","sources":["../../src/channels/inbound_router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAuB,aAAa,EAAE,MAAM,YAAY,CAAC;AAErF;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9E,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,MAAM,uBAAuB,GAC/B,CAAC,WAAW,GAAG;IAAE,KAAK,EAAE,oBAAoB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5E,CAAC,WAAW,GAAG;IAAE,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC,GAC7C,CAAC,WAAW,GAAG;IAAE,KAAK,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/D,CAAC,WAAW,GAAG;IAAE,KAAK,EAAE,iCAAiC,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GACzF,CAAC,WAAW,GAAG;IAAE,KAAK,EAAE,oBAAoB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5E,CAAC,WAAW,GAAG;IAAE,KAAK,EAAE,uBAAuB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAClF,CAAC,WAAW,GAAG;IAAE,KAAK,EAAE,wBAAwB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAExF,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;AAE9E,MAAM,WAAW,iBAAiB;IAChC;;;+CAG2C;IAC3C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAiBD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4B;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,KAAK,CAA0C;gBAE3C,IAAI,GAAE,iBAAsB;IAKxC;;;;;;;;;OASG;IACG,KAAK,CACT,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACrC,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAiEhB;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B,wDAAwD;IACxD,uBAAuB,IAAI,MAAM;YAOnB,aAAa;CA6C5B"}

package/dist/channels/inbound_router.js

@@ -0,0 +1,182 @@
+/**
+ * `InboundRouter` — AUTO.6 inbound-channel dispatcher.
+ *
+ * Authoritative source: `docs/tasks/automation.md` AUTO.6. Walks the user's
+ * `RoutingConfig.channelMapping`, finds the adapter for each concrete URI,
+ * and (when the adapter implements `subscribeInbound`) attaches a per-
+ * abstract-channel listener. Inbound messages flow:
+ *
+ *   adapter.subscribeInbound(handler)
+ *     → handler(event)
+ *       → CapabilityGate.check(pack, 'send_message', sender)   [optional]
+ *         → if allowed → dispatch(event)
+ *         → if denied  → audit + drop
+ *
+ * Sender allowlist is intentionally enforced via the existing AUTO.3
+ * capability gate (`send_message` capability with `channels:` allowlist
+ * — repurposed for inbound: a sender ID is the principal, mapped against
+ * the same pack-declared list). The router does NOT introduce a new gate
+ * surface; reuse keeps audit + override semantics identical.
+ *
+ * Engine-vocabulary: emits `InboundChannelEvent` only; never knows what
+ * downstream evaluator does with the event.
+ *
+ * Imports from: ../runtime/event.js, ../runtime/capability_gate.js,
+ * ./types.js. Imported by: src/runtime/daemon.ts (later) + tests.
+ */
+const noopAudit = () => {
+    /* default audit sink */
+};
+export class InboundRouter {
+    subscriptions = [];
+    auditLog;
+    capabilityGate;
+    state = 'idle';
+    constructor(opts = {}) {
+        this.auditLog = opts.auditLog ?? noopAudit;
+        this.capabilityGate = opts.capabilityGate;
+    }
+    /**
+     * Walk `bindings`, resolve each abstract channel → URI via
+     * `routing.channelMapping`, look up the adapter by URI scheme, and call
+     * its `subscribeInbound` to attach a sender-gated dispatcher. Skips +
+     * audits any binding whose channel is unmapped, whose adapter scheme
+     * isn't registered, or whose adapter doesn't implement `subscribeInbound`.
+     *
+     * Idempotent: a second `start()` while already running throws so the
+     * caller surfaces a lifecycle bug rather than double-subscribing.
+     */
+    async start(bindings, routing, adapters, dispatch) {
+        if (this.state !== 'idle') {
+            throw new Error(`InboundRouter.start: invalid state "${this.state}"`);
+        }
+        this.state = 'running';
+        for (const binding of bindings) {
+            const uri = routing.channelMapping[binding.channel];
+            if (uri === undefined || uri === '') {
+                this.auditLog({
+                    event: 'inbound_unmapped',
+                    pack: binding.pack,
+                    channel: binding.channel,
+                });
+                continue;
+            }
+            const schemePart = uri.split('://')[0];
+            if (schemePart === undefined || schemePart === '') {
+                this.auditLog({
+                    event: 'inbound_unmapped',
+                    pack: binding.pack,
+                    channel: binding.channel,
+                });
+                continue;
+            }
+            const adapter = adapters.get(schemePart);
+            if (adapter === undefined) {
+                this.auditLog({
+                    event: 'inbound_no_adapter',
+                    pack: binding.pack,
+                    channel: binding.channel,
+                    scheme: schemePart,
+                });
+                continue;
+            }
+            if (adapter.subscribeInbound === undefined) {
+                this.auditLog({
+                    event: 'inbound_adapter_not_inboundable',
+                    pack: binding.pack,
+                    channel: binding.channel,
+                    uri,
+                    scheme: schemePart,
+                });
+                continue;
+            }
+            // Closure captures `binding` so the gate + audit + dispatch path
+            // can reference the right pack/channel without threading them
+            // through `subscribeInbound`'s handler signature.
+            const handler = async (event) => {
+                await this.handleInbound(binding, event, dispatch);
+            };
+            const sub = await adapter.subscribeInbound(handler);
+            this.subscriptions.push({ pack: binding.pack, channel: binding.channel, sub });
+            this.auditLog({
+                event: 'inbound_subscribed',
+                pack: binding.pack,
+                channel: binding.channel,
+                uri,
+                scheme: schemePart,
+            });
+        }
+    }
+    /**
+     * Unsubscribe every active binding in reverse order. Idempotent — a
+     * second stop() is a no-op. Each unsubscribe is best-effort; failures
+     * are swallowed so a single bad adapter doesn't strand the rest.
+     */
+    async stop() {
+        if (this.state !== 'running') {
+            this.state = 'stopped';
+            return;
+        }
+        this.state = 'stopped';
+        while (this.subscriptions.length > 0) {
+            const entry = this.subscriptions.pop();
+            if (entry === undefined)
+                break;
+            try {
+                await entry.sub.unsubscribe();
+            }
+            catch {
+                // best-effort — audit-and-continue, never throw out of stop().
+            }
+        }
+    }
+    /** Test/inspection — number of active subscriptions. */
+    activeSubscriptionCount() {
+        return this.subscriptions.length;
+    }
+    // -------------------------------------------------------------------------
+    // Internals.
+    async handleInbound(binding, event, dispatch) {
+        // Sender allowlist via capability gate. Repurposes `send_message`'s
+        // `channels:` allowlist as the sender principal set — the gate's
+        // glob-list matcher handles user-id allowlists cleanly.
+        if (this.capabilityGate !== undefined) {
+            const verdict = await this.capabilityGate.check({
+                pack: binding.pack,
+                capability: 'send_message',
+                target: event.sender,
+                context: { inbound: true, channelUri: event.channelUri },
+            });
+            if (!verdict.allowed) {
+                this.auditLog({
+                    event: 'inbound_sender_denied',
+                    pack: binding.pack,
+                    channel: binding.channel,
+                    sender: event.sender,
+                    reason: verdict.message ?? verdict.source,
+                });
+                return;
+            }
+        }
+        try {
+            await dispatch(event);
+            this.auditLog({
+                event: 'inbound_dispatched',
+                pack: binding.pack,
+                channel: binding.channel,
+                uri: event.channelUri,
+                sender: event.sender,
+            });
+        }
+        catch (err) {
+            this.auditLog({
+                event: 'inbound_dispatch_error',
+                pack: binding.pack,
+                channel: binding.channel,
+                sender: event.sender,
+                reason: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+}
+//# sourceMappingURL=inbound_router.js.map

package/dist/channels/inbound_router.js.map

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

package/dist/channels/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Channels: pluggable channel adapters for notification routing (chat,
+ * Telegram, Discord, Slack, generic webhook) keyed by URI scheme.
+ *
+ * Public surface: the abstract types every adapter implements, plus
+ * the built-in chat:// adapter. Other adapters (telegram/discord/slack)
+ * land in later tasks; the router (Task 1.14) wires them via a registry.
+ *
+ * Imports from: secrets/ (resolved at call site by runtime).
+ * Imported by: runtime/, setup/, mcp/.
+ */
+export type { ChannelAdapter, ChannelMessage, InboundSubscription, RoutingConfig, SendResult, Severity, } from './types.js';
+export { InboundRouter, type InboundBinding, type InboundDispatcher, type InboundRouterAuditEntry, type InboundRouterAuditSink, type InboundRouterOpts, } from './inbound_router.js';
+export { chatAdapter } from './chat.js';
+export { telegramAdapter, type TelegramAdapter, type TelegramAdapterOpts, } from './adapters/telegram.js';
+export { discordAdapter, type DiscordAdapter, type DiscordAdapterOpts, } from './adapters/discord.js';
+export { slackAdapter, type SlackAdapter, type SlackAdapterOpts, type SlackInboundEvent, type SlackInboundEnvelope, } from './adapters/slack.js';
+export { webhookAdapter, type WebhookAdapterOpts } from './adapters/webhook.js';
+export { NotificationRouter, type MulticastResult } from './router.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EACV,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/channels/index.js

@@ -0,0 +1,19 @@
+/**
+ * Channels: pluggable channel adapters for notification routing (chat,
+ * Telegram, Discord, Slack, generic webhook) keyed by URI scheme.
+ *
+ * Public surface: the abstract types every adapter implements, plus
+ * the built-in chat:// adapter. Other adapters (telegram/discord/slack)
+ * land in later tasks; the router (Task 1.14) wires them via a registry.
+ *
+ * Imports from: secrets/ (resolved at call site by runtime).
+ * Imported by: runtime/, setup/, mcp/.
+ */
+export { InboundRouter, } from './inbound_router.js';
+export { chatAdapter } from './chat.js';
+export { telegramAdapter, } from './adapters/telegram.js';
+export { discordAdapter, } from './adapters/discord.js';
+export { slackAdapter, } from './adapters/slack.js';
+export { webhookAdapter } from './adapters/webhook.js';
+export { NotificationRouter } from './router.js';
+//# sourceMappingURL=index.js.map

package/dist/channels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,OAAO,EACL,aAAa,GAMd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,eAAe,GAGhB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,cAAc,GAGf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,YAAY,GAKb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAA2B,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAwB,MAAM,aAAa,CAAC"}

package/dist/channels/migrate.d.ts

@@ -0,0 +1,133 @@
+/**
+ * One-shot legacy→umbrella migration (T-CHAT-AS-TERMINAL CAT.1d).
+ *
+ * The legacy chat stack keyed routing + inbox by per-cwd `project_uuid`:
+ *   - `~/.opensquid/projects/<uuid>/chat-routing.json` (one per project_uuid)
+ *   - `~/.opensquid/projects.json` registry (`{ projects: { <uuid>: { id,
+ *     last_seen_path, ... } } }`)
+ *   - `~/.opensquid/projects/<uuid>/inbox/<platform>.jsonl` (per-uuid inbox)
+ *
+ * The new stack keys EVERYTHING by UMBRELLA (`src/channels/routing.ts`):
+ *   - one authoritative `~/.opensquid/channels.json`
+ *   - `~/.opensquid/umbrellas/<id>/inbox/<platform>.jsonl`
+ *
+ * This module synthesizes the umbrella config FROM the legacy per-project
+ * files and copies the inbox rows into the umbrella keyspace, NON-DESTRUCTIVELY
+ * (the legacy files are left intact; src.legacy deletion is CAT.8).
+ *
+ * Grouping algorithm (the da96≡0742 mirror collapse):
+ *   Every uuid is grouped by its telegram destination `(report_channel,
+ *   report_topic_id)`. Two mirror uuids that report to the SAME (channel,
+ *   topic) — the da96≡0742 hack — fall into ONE group, hence ONE umbrella, and
+ *   their `last_seen_path`s become that umbrella's `members`. The umbrella id
+ *   is a slug of the shared project `id` (from the registry).
+ *
+ * DM rule (locked, invariant #5): ANY `inbound_dm_user_ids` found on ANY
+ * project go to the TOP-LEVEL `general.telegram.dm_user_ids` — never onto a
+ * project umbrella. DMs route to general, deliberately, even though raumpilates
+ * carries the DM allowlist today.
+ *
+ * Everything pure where possible; fs only at the edges (`synthChannelsConfig`
+ * reads, `writeChannelsConfig` + `migrateInboxData` write).
+ *
+ * Imports from: node:fs/promises, node:path, ../runtime/paths, ./routing.
+ * Imported by: CAT.1d CLI (`opensquid chat migrate`) + tests.
+ */
+import { type ChannelsConfig } from './routing.js';
+/** A single project's telegram routing block (`chat-routing.json`). */
+interface LegacyTelegramRouting {
+    report_channel?: string;
+    report_topic_id?: number;
+    inbound_dm_user_ids?: string[];
+}
+interface LegacyChatRouting {
+    telegram?: LegacyTelegramRouting;
+}
+/**
+ * Slugify a project `id` into a stable umbrella id: lowercase, every run of
+ * non-`[a-z0-9]` collapses to a single `-`, leading/trailing `-` trimmed.
+ * `RaumPilates-FE` → `raumpilates-fe`, `loop` → `loop`. Never returns the
+ * reserved `general` (the caller substitutes a fallback for empties).
+ */
+export declare function slugifyUmbrellaId(id: string): string;
+/** Parse `report_channel` ("telegram:<chat_id>") → the bare chat_id, or null. */
+export declare function chatIdFromReportChannel(reportChannel: string | undefined): string | null;
+interface LegacyProject {
+    uuid: string;
+    id: string;
+    lastSeenPath: string;
+    routing: LegacyChatRouting;
+}
+/**
+ * Pure core of `synthChannelsConfig`: given the loaded legacy projects, group
+ * them into umbrellas + the general row. Exposed for testing without fs.
+ *
+ * Returns both the `ChannelsConfig` AND the umbrella-id → legacy-uuids map so
+ * `migrateInboxData` can copy each umbrella's rows from its member uuids.
+ */
+export declare function synthFromLegacy(projects: LegacyProject[]): {
+    config: ChannelsConfig;
+    uuidsByUmbrella: Record<string, string[]>;
+};
+/**
+ * Load every legacy project from disk: the registry (`projects.json`) is the
+ * authority for `id` + `last_seen_path`; each uuid's `chat-routing.json`
+ * supplies the telegram destination. A uuid present in the registry but with
+ * no routing file is loaded with an empty routing (it forms no umbrella but is
+ * still visible to the caller).
+ */
+export declare function loadLegacyProjects(): Promise<LegacyProject[]>;
+/**
+ * Read the legacy per-project routing + registry and synthesize the umbrella
+ * `ChannelsConfig`. The mirror-collapse + DM→general rules are in
+ * `synthFromLegacy`; this is the fs wrapper.
+ */
+export declare function synthChannelsConfig(): Promise<ChannelsConfig>;
+/**
+ * Resolve an umbrella id → its legacy uuids (the inverse of the synth
+ * grouping). Re-derives from disk so callers don't have to thread the synth
+ * result. Returns [] for an unknown umbrella id.
+ */
+export declare function legacyUuidsForUmbrella(umbrellaId: string): Promise<string[]>;
+/**
+ * Write the synthesized `channels.json` to `channelsConfigPath()` atomically
+ * (tmp + rename). By default refuses to overwrite an existing file (idempotent
+ * — a second migrate run is a no-op); pass `{ force: true }` to overwrite.
+ * Returns whether the file was actually written + the path.
+ */
+export declare function writeChannelsConfig(cfg: ChannelsConfig, opts?: {
+    force?: boolean;
+}): Promise<{
+    written: boolean;
+    path: string;
+}>;
+/**
+ * Copy every umbrella's inbox rows from its member uuids' legacy per-project
+ * inbox into the umbrella keyspace. NON-DESTRUCTIVE (the source files are never
+ * touched) + idempotent (re-running adds no duplicate rows — dedup is seeded
+ * from the destination). Dedup keys: inbox rows by `(platform, id)`, ack rows
+ * by `message_id`. Returns the per-umbrella count of NEWLY-copied inbox rows.
+ */
+export declare function migrateInboxData(cfg: ChannelsConfig): Promise<{
+    copied: Record<string, number>;
+}>;
+export interface MigrateResult {
+    config: ChannelsConfig;
+    /** Whether channels.json was written (false = already present, no --force). */
+    configWritten: boolean;
+    configPath: string;
+    /** Per-umbrella count of newly-copied inbox rows. */
+    copied: Record<string, number>;
+}
+/**
+ * Run the full migration: synthesize the umbrella config, write it (honoring
+ * `force`), then copy the inbox data. READ-ONLY w.r.t. the legacy keyspace.
+ */
+export declare function runMigration(opts?: {
+    force?: boolean;
+}): Promise<MigrateResult>;
+/** Discover every uuid directory under `projects/` (diagnostic helper; the
+ *  registry is the authority but this surfaces orphan dirs to the operator). */
+export declare function listProjectUuids(): Promise<string[]>;
+export {};
+//# sourceMappingURL=migrate.d.ts.map

package/dist/channels/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/channels/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,OAAO,EAAsB,KAAK,cAAc,EAAoB,MAAM,cAAc,CAAC;AAOzF,uEAAuE;AACvE,UAAU,qBAAqB;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AACD,UAAU,iBAAiB;IACzB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AA6BD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAMxF;AAOD,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAQD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG;IAC1D,MAAM,EAAE,cAAc,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC3C,CA6EA;AAqBD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAcnE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,cAAc,CAAC,CAGnE;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGlF;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,cAAc,EACnB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB7C;AA8FD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAe7C;AAMD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,+EAA+E;IAC/E,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAOzF;AAED;gFACgF;AAChF,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAM1D"}

package/dist/channels/migrate.js.map

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

package/dist/channels/router.d.ts

@@ -0,0 +1,54 @@
+/**
+ * NotificationRouter — resolves (severity, project) → concrete channel
+ * targets, then multicasts in parallel with partial-success accounting.
+ *
+ * Resolution algorithm (per docs/opensquid-real-design.md §"Resolution
+ * algorithm"):
+ *   1. If `project` is set AND `perProjectOverride[project][severity]`
+ *      exists → use that list of abstract channel names.
+ *   2. Else use `severityTiers[severity]` (or fall back to `['chat']`
+ *      if absent).
+ *   3. For each abstract name: resolve to a URI via `channelMapping`
+ *      (the literal name `'chat'` is special-cased to `chat://`).
+ *   4. For each URI: extract scheme, look up registered adapter; skip
+ *      silently if no adapter handles that scheme (misconfigured
+ *      mapping is a warning, not a crash — see §"Fallback chain").
+ *   5. If zero targets resolved → fall back to the chat adapter (if
+ *      registered). This is the last-resort path that guarantees the
+ *      user sees the message in-session even when their channel config
+ *      is broken.
+ *
+ * Multicast policy: parallel `Promise.all` with per-task `.catch` →
+ * partial-success. No silent drops: every failure is counted and
+ * surfaced in the result's `errors` array. Even if every target fails
+ * (including the chat fallback), we return `{ sent: 0, failed: N }`
+ * rather than throwing — the runtime must stay alive.
+ */
+import type { ChannelAdapter, ChannelMessage, RoutingConfig, Severity } from './types.js';
+export interface MulticastResult {
+    sent: number;
+    failed: number;
+    errors: string[];
+}
+export declare class NotificationRouter {
+    private readonly adapters;
+    /** Register an adapter keyed by its URI scheme (e.g. 'chat', 'telegram'). */
+    registerAdapter(adapter: ChannelAdapter): void;
+    /**
+     * Resolve (severity, project, config) → ordered list of concrete
+     * targets. Returns an empty array only if no adapters are registered
+     * at all (including no chat fallback).
+     */
+    resolve(severity: Severity, project: string | null, config: RoutingConfig): {
+        uri: string;
+        adapter: ChannelAdapter;
+    }[];
+    /**
+     * Multicast `message` to every channel resolved for (severity,
+     * project). Sends are issued in parallel; each rejection is caught
+     * and translated to a `SendResult` with `ok: false` so partial
+     * success is preserved.
+     */
+    multicast(severity: Severity, project: string | null, message: ChannelMessage, config: RoutingConfig): Promise<MulticastResult>;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/channels/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/channels/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,aAAa,EAEb,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAE9D,6EAA6E;IAC7E,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAI9C;;;;OAIG;IACH,OAAO,CACL,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,MAAM,EAAE,aAAa,GACpB;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE,EAAE;IA2B7C;;;;;OAKG;IACG,SAAS,CACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,eAAe,CAAC;CAiB5B"}