comisai 1.0.44 → 1.0.46

package/node_modules/@comis/channels/dist/__tests__/fakes/irc-fake.js

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
  * FakeIrcAdapter — a deterministic, clock-free `ChannelPort` test double for the
- * IRC LinePerEvent renderer (§18.1 "fake adapter records every method call").
+ * IRC LinePerEvent renderer; it records every method call.
  *
  * Mirrors `createFakeSignalAdapter` (the non-EditPlace template) but for the
  * LinePerEvent shape:
@@ -9,7 +9,7 @@
  *     synthetic id `"sent"` for EVERY message (IRC has no standard message ids),
  *     which would collapse a multi-line call-log into indistinguishable rows. The
  *     fake mints per-call `irc-msg-0`, `irc-msg-1`, … instead so the byte-stable
- *     fixture reads unambiguously (Pitfall 2; clock-free, no wall-time call that
+ *     fixture reads unambiguously (clock-free, no wall-time call that
  *     would flap).
  *   - records NO `silent` flag on `send` (IRC has no rich effects — the
  *     LinePerEvent strategy posts one plain line per event), and

package/node_modules/@comis/channels/dist/__tests__/fakes/line-fake.js

@@ -1,12 +1,12 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
  * FakeLineAdapter — a deterministic, clock-free `ChannelPort` test double for the
- * LINE AppendOnly renderer (§18.1 "fake adapter records every method call").
+ * LINE AppendOnly renderer; it records every method call.
  *
  * Mirrors `createFakeSignalAdapter` (the non-EditPlace template) but for the
  * AppendOnly shape:
- *   - mints `line-msg-N` ids (LINE's determinism source for byte-stable fixtures
- *     — Pitfall 2; clock-free, no wall-time call that would flap),
+ *   - mints `line-msg-N` ids (LINE's determinism source for byte-stable fixtures;
+ *     clock-free, no wall-time call that would flap),
  *   - records NO `silent` flag on `send` (LINE does not send the silent effect —
  *     AppendOnly posts a single plain opening status), and
  *   - OMITS `editMessage` / `deleteMessage` entirely. LINE is send-only; the live

package/node_modules/@comis/channels/dist/__tests__/fakes/msteams-fake.d.ts

@@ -0,0 +1,43 @@
+import type { ChannelPort, RichButton } from "@comis/core";
+/**
+ * A Bot Framework Connector-shaped platform error (the structural fields the
+ * classifier reads). `status` is the HTTP status of the Connector response
+ * (`429`, `401`, `404`, …); `retryAfter` is the rate-limit backoff in SECONDS.
+ */
+export interface MSTeamsErrorShape {
+    status?: number;
+    retryAfter?: number;
+    message?: string;
+}
+/** One recorded adapter call — discriminated by `op`, deterministic ids, no timestamps. */
+export type FakeMSTeamsCall = {
+    op: "send";
+    id: string;
+    text: string;
+    buttons?: RichButton[][];
+} | {
+    op: "edit";
+    id: string;
+    text: string;
+} | {
+    op: "delete";
+    id: string;
+};
+/** What `createFakeMSTeamsAdapter()` returns: the port + a `recorded` accessor + a one-shot error seam. */
+export interface FakeMSTeamsAdapter extends ChannelPort {
+    /** Ordered call-log — the fixture artifact. Deterministic `ms-msg-N` ids, no timestamps. */
+    readonly recorded: {
+        calls: FakeMSTeamsCall[];
+    };
+    /**
+     * One-shot platform-error injection seam. When set, the NEXT recording call
+     * returns `err(nextError)` (the raw Connector-shaped object) and clears the
+     * seam. Drives `classifyMSTeamsError` off the structural numeric `e.status`.
+     */
+    nextError: MSTeamsErrorShape | Error | undefined;
+}
+/**
+ * Create a {@link FakeMSTeamsAdapter}. Mints `ms-msg-0`, `ms-msg-1`, … on each
+ * `sendMessage` and appends every method call to `recorded.calls` in order.
+ */
+export declare function createFakeMSTeamsAdapter(channelId?: string): FakeMSTeamsAdapter;

package/node_modules/@comis/channels/dist/__tests__/fakes/msteams-fake.js

@@ -0,0 +1,100 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * FakeMSTeamsAdapter — a deterministic, clock-free `ChannelPort` test double for
+ * the Microsoft Teams EditPlace renderer; it records every method call.
+ *
+ * Mirrors `createFakeSlackAdapter` (the sibling rich-channel fake) but:
+ *   - mints `ms-msg-N` ids (the determinism source for byte-stable fixtures),
+ *   - reports `connectionMode:"webhook"` — the Teams ingress is a public
+ *     endpoint, not a socket, and
+ *   - exposes a Connector-shaped (`{ status?, retryAfter? }`) `nextError`
+ *     injection seam: the STRUCTURAL numeric `status` `classifyMSTeamsError`
+ *     reads, distinct from Slack's `{ data: { error } }` string.
+ *
+ * The seam returns the raw Connector-shaped object through the `Result` err
+ * branch (one-shot, then clears) so the classifier is driven STRUCTURALLY off
+ * `e.status` — never by parsing a message string. All methods return `Result`;
+ * they NEVER throw across the port boundary (AGENTS.md §2.1). No `systemNowMs()`
+ * (would flap fixtures).
+ *
+ * The signed approval buttons ride on `send.buttons` — recorded ONLY when
+ * `options.buttons` is present so the button-less fixtures (the absent-signer
+ * approval frame and every non-approval frame) stay byte-stable.
+ */
+import { ok, err } from "@comis/shared";
+/**
+ * Create a {@link FakeMSTeamsAdapter}. Mints `ms-msg-0`, `ms-msg-1`, … on each
+ * `sendMessage` and appends every method call to `recorded.calls` in order.
+ */
+export function createFakeMSTeamsAdapter(channelId = "chat-1") {
+    const recorded = { calls: [] };
+    let messageCounter = 0;
+    const handlers = [];
+    // Consume the one-shot error seam, if armed. Returns the raw Connector-shaped
+    // object as an Error-typed err() (the port's Result<_, Error> is the contract;
+    // the classifier reads the structural numeric status off it).
+    function takeInjectedError(self) {
+        if (self.nextError === undefined || self.nextError === null)
+            return undefined;
+        const e = self.nextError;
+        self.nextError = undefined;
+        return e;
+    }
+    const adapter = {
+        channelId,
+        channelType: "msteams",
+        recorded,
+        nextError: undefined,
+        async start() {
+            return ok(undefined);
+        },
+        async stop() {
+            return ok(undefined);
+        },
+        async sendMessage(_channelId, text, options) {
+            const injected = takeInjectedError(adapter);
+            if (injected)
+                return err(injected);
+            const id = `ms-msg-${messageCounter++}`;
+            // The signed approval buttons ride on `buttons` — recorded ONLY when
+            // present so the button-less fixtures (absent-signer / non-approval
+            // frames) stay byte-stable.
+            recorded.calls.push({
+                op: "send",
+                id,
+                text,
+                ...(options?.buttons !== undefined ? { buttons: options.buttons } : {}),
+            });
+            return ok(id);
+        },
+        async editMessage(_channelId, messageId, text, _options) {
+            const injected = takeInjectedError(adapter);
+            if (injected)
+                return err(injected);
+            recorded.calls.push({ op: "edit", id: messageId, text });
+            return ok(undefined);
+        },
+        async deleteMessage(_channelId, messageId) {
+            const injected = takeInjectedError(adapter);
+            if (injected)
+                return err(injected);
+            recorded.calls.push({ op: "delete", id: messageId });
+            return ok(undefined);
+        },
+        async platformAction(action, params) {
+            return ok({ action, params, echoed: true });
+        },
+        onMessage(handler) {
+            handlers.push(handler);
+        },
+        getStatus() {
+            return {
+                connected: true,
+                channelId,
+                channelType: "msteams",
+                connectionMode: "webhook",
+            };
+        },
+    };
+    return adapter;
+}

package/node_modules/@comis/channels/dist/__tests__/fakes/signal-fake.js

@@ -1,13 +1,12 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
  * FakeSignalAdapter — a deterministic, clock-free `ChannelPort` test double for
- * the Signal DeleteAndRepost renderer (§18.1 "fake adapter
- * records every method call").
+ * the Signal DeleteAndRepost renderer; it records every method call.
  *
  * Mirrors `createFakeTelegramAdapter` (the canonical template) but for the
  * DeleteAndRepost shape:
  *   - mints `sig-msg-N` ids (Signal's determinism source for byte-stable
- *     fixtures — Pitfall 2; clock-free, no wall-time call that would flap),
+ *     fixtures; clock-free, no wall-time call that would flap),
  *   - records NO `silent` flag on `send` (Signal does not send the silent
  *     effect — the renderer posts a plain message per transition), and
  *   - OMITS `editMessage` entirely. Signal has no in-place edit; the live

package/node_modules/@comis/channels/dist/__tests__/fakes/slack-fake.js

@@ -1,12 +1,11 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
  * FakeSlackAdapter — a deterministic, clock-free `ChannelPort` test double for
- * the Slack EditPlace renderer (§18.1 "fake adapter records
- * every method call").
+ * the Slack EditPlace renderer; it records every method call.
  *
  * Mirrors `createFakeTelegramAdapter` (the canonical fake) but:
  *   - mints `sl-msg-N` ids (Slack's `ts` analogue; the determinism source for
- *     byte-stable fixtures — Pitfall 2), and
+ *     byte-stable fixtures), and
  *   - exposes a Slack-Bolt-shaped (`{ data: { error }, retryAfter? }`) `nextError`
  *     injection seam (distinct from grammy's `error_code` and discord's `.code`).
  *
@@ -25,7 +24,7 @@
  *
  * The Block Kit `actions` approval is a SHELL only: no interaction handler is
  * registered and no signed callback_data is produced — the
- * InteractiveCallbackRouter is handled separately (§17.3).
+ * InteractiveCallbackRouter is handled separately.
  */
 import { ok, err } from "@comis/shared";
 /**

package/node_modules/@comis/channels/dist/__tests__/fakes/telegram-fake.js

@@ -1,12 +1,11 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
  * FakeTelegramAdapter — a deterministic, clock-free `ChannelPort` test double
- * for the Telegram EditPlace renderer (§18.1 "fake adapter
- * records every method call").
+ * for the Telegram EditPlace renderer; it records every method call.
  *
- * Mirrors `createFakeEchoAdapter` (the Wave-1 template) but:
+ * Mirrors `createFakeEchoAdapter` (the reference template) but:
  *   - mints `tg-msg-N` ids (Telegram's determinism source for byte-stable
- *     fixtures — Pitfall 2), and
+ *     fixtures), and
  *   - records the `send` options so a fixture can pin the silent-notification
  *     flag (`{effects:["silent"]}` → `disable_notification:true`).
  *

package/node_modules/@comis/channels/dist/__tests__/fakes/whatsapp-fake.js

@@ -1,12 +1,11 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
  * FakeWhatsAppAdapter — a deterministic, clock-free `ChannelPort` test double for
- * the WhatsApp windowed EditPlace renderer (§18.1 "fake adapter
- * records every method call").
+ * the WhatsApp windowed EditPlace renderer; it records every method call.
  *
  * Mirrors `createFakeTelegramAdapter` (the canonical fake) but:
  *   - mints `wa-msg-N` ids (WhatsApp's determinism source for byte-stable
- *     fixtures — Pitfall 2), and
+ *     fixtures), and
  *   - exposes a baileys-shaped error-injection seam. baileys surfaces an
  *     operation failure as a thrown `Boom` carrying `.output.statusCode`
  *     (`@hapi/boom`; the live `whatsapp-adapter.ts` already reads

package/node_modules/@comis/channels/dist/__tests__/fixture-harness.js

@@ -2,7 +2,7 @@
 // @allow-throw: test fixture loader; the thrown "missing fixture" error is the
 // RED signal for an un-pinned scenario and is caught by Vitest at the call site.
 /**
- * Golden-fixture read helper (§18.1 read-from-disk + `toEqual`).
+ * Golden-fixture read helper (read-from-disk + `toEqual`).
  *
  * The single shared piece every channel renderer test reuses (rule-of-three):
  * `readFixture(channel, scenario)` reads
@@ -11,7 +11,7 @@
  *
  * `toEqual` against a read-from-disk object is the deliberate alternative to
  * `toMatchSnapshot` / `toMatchFileSnapshot`, which auto-write and self-heal a
- * wrong fixture (Pitfall 3). A missing fixture THROWS — that is the RED signal
+ * wrong fixture. A missing fixture THROWS — that is the RED signal
  * for a scenario the author has not yet pinned; the `check-fixture-diff.sh` CI
  * gate then guards undeclared fixture mutations.
  *

package/node_modules/@comis/channels/dist/discord/discord-activity.d.ts

@@ -29,9 +29,9 @@ export declare function makeDiscordRenderActions(adapter: ChannelPort, channelId
  *
  * `signCallbackData` is the secret-bound signer injected at the composition root:
  * the renderer CONSUMES it to build signed approval components and never
- * imports the orchestrator package (Pitfall 5). When omitted, an
- * approval frame degrades to a button-less text prompt (the signer is wired in a
- * later step; the rest of the renderer is unaffected).
+ * imports the orchestrator package. When omitted, an
+ * approval frame degrades to a button-less text prompt (no signer, no buttons;
+ * the rest of the renderer is unaffected).
  */
 export declare function createDiscordActivityRenderer(adapter: ChannelPort, channelId: string, deps: {
     timer: TimerPort;

package/node_modules/@comis/channels/dist/discord/discord-activity.js

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Discord EditPlace activity renderer (§7.2 / §18.2 row "EditPlace").
+ * Discord EditPlace activity renderer.
  *
  * Copies the canonical Telegram shape — only the error classifier and
  * the subagent thread-affordance differ. Three parts:
@@ -12,7 +12,7 @@
  *      sites). discord.js uses a numeric `.code` (10008 Unknown Message → drop
  *      edits; 50013 Missing Permissions → permission) and surfaces HTTP-429 via
  *      `RateLimitError.retryAfter` / `.status === 429`. It NEVER parses the
- *      generic "Failed to…" string. §19.3: the `.code` /
+ *      generic "Failed to…" string. The `.code` /
  *      `.message` is used ONLY to choose the closed `ActivityRenderError`
  *      variant — never rendered or logged as activity text.
  *
@@ -22,7 +22,7 @@
  *      the adapter creates a public thread (discord-adapter.ts:399-411). This is
  *      a DISPLAY affordance only — it registers NO interaction handler and signs
  *      no interaction payload; the signed-callback router lives in a separate
- *      component (§17.3). `edit`/`delete` GUARD the optional `ChannelPort`
+ *      component. `edit`/`delete` GUARD the optional `ChannelPort`
  *      methods (early `not_supported` — never a non-null `!` cluster, AGENTS.md
  *      §2.8) and map every `.error` through `classifyDiscordError`. All paths
  *      return `Result`; nothing throws across the boundary.
@@ -79,7 +79,7 @@ export function classifyDiscordError(e) {
 /** Latest-text retry cap — a 429 storm coalesces to the latest text; we never replay a backlog. */
 const MAX_RETRY_ATTEMPTS = 4;
 /**
- * The subagent-expand marker the renderer paints into the parent line (§18.2-S7).
+ * The subagent-expand marker the renderer paints into the parent line.
  * When a placeholder send carries it, the Discord adapter surfaces the thread
  * affordance SHELL (a public thread) — a DISPLAY affordance, never a resolution.
  */
@@ -184,9 +184,9 @@ export function makeDiscordRenderActions(adapter, channelId, deps = {}) {
  *
  * `signCallbackData` is the secret-bound signer injected at the composition root:
  * the renderer CONSUMES it to build signed approval components and never
- * imports the orchestrator package (Pitfall 5). When omitted, an
- * approval frame degrades to a button-less text prompt (the signer is wired in a
- * later step; the rest of the renderer is unaffected).
+ * imports the orchestrator package. When omitted, an
+ * approval frame degrades to a button-less text prompt (no signer, no buttons;
+ * the rest of the renderer is unaffected).
  */
 export function createDiscordActivityRenderer(adapter, channelId, deps) {
     const { signCallbackData } = deps;

package/node_modules/@comis/channels/dist/discord/discord-adapter.js

@@ -56,12 +56,13 @@ export function createDiscordAdapter(deps) {
         ...(deps.apiRoot ? { rest: { api: deps.apiRoot } } : {}),
     });
     const handlers = [];
-    // REACT-01: inbound reaction-add handlers (the binder logic is co-located in
+    // Inbound reaction-add handlers (the binder logic is co-located in
     // discord-reaction-binder.ts to hold the 800-line cap).
     const reactionHandlers = [];
     let _channelId = "discord-pending";
     // The bot's own user id, captured at start() from validateDiscordToken. Used
-    // by reconcileSend to match author=bot (Spoofing T-216-25); empty until start.
+    // by reconcileSend to match author=bot — a same-digest message from another
+    // author must never count as the bot's own send; empty until start.
     let _botUserId = "";
     let reconnectAttempt = 0;
     // Health tracking
@@ -137,7 +138,7 @@ export function createDiscordAdapter(deps) {
                     }
                 });
             });
-            // REACT-01: bind the inbound reaction-add listener (intents already held
+            // Bind the inbound reaction-add listener (intents already held
             // at :92-93). Co-located in discord-reaction-binder.ts (800-line cap).
             bindDiscordReactions(client, reactionHandlers, deps.logger);
             // Shard lifecycle event handlers for reconnection visibility
@@ -488,7 +489,7 @@ export function createDiscordAdapter(deps) {
         async reconcileSend(query) {
             // We can only prove a bot send if we know who the bot is. If start() has
             // not captured the bot user id, we cannot tell -> unresolved (never a
-            // guess, ONCE-03).
+            // guess).
             if (!_botUserId) {
                 deps.logger.debug({ channelType: "discord", hint: "reconcileSend called before start(): bot id unknown" }, "reconcileSend unresolved");
                 return ok({ kind: "unresolved" });
@@ -507,8 +508,8 @@ export function createDiscordAdapter(deps) {
                 return ok({ kind: "unresolved" });
             }
             // discord.js throws on fetch failure / rate-limit. A failed or partial
-            // fetch can NEVER prove the message is absent (Pitfall 2 / T-216-22) —
-            // any throw is `unresolved`, never `not_sent`.
+            // fetch can NEVER prove the message is absent — any throw is
+            // `unresolved`, never `not_sent`.
             let fetched;
             try {
                 fetched = await tc.messages.fetch({ limit: 50 });
@@ -526,7 +527,7 @@ export function createDiscordAdapter(deps) {
             // fetch({limit}) returns a Collection<Snowflake, Message> (Map-iterable).
             for (const [, m] of fetched) {
                 if (m.author?.id !== _botUserId)
-                    continue; // author=bot required (T-216-25)
+                    continue; // author=bot required — other authors never count
                 if (m.createdTimestamp < query.sentAfterMs || m.createdTimestamp > query.sentBeforeMs) {
                     continue;
                 }

package/node_modules/@comis/channels/dist/discord/discord-plugin.js

@@ -17,7 +17,7 @@ const CAPABILITIES = {
         deleteMessages: true,
         fetchHistory: true,
         attachments: true,
-        // §17.2: Discord EditPlace + Components — typing, threads, component buttons.
+        // Discord EditPlace + Components — typing, threads, component buttons.
         typing: true,
         threads: true,
         buttons: "components",

package/node_modules/@comis/channels/dist/discord/discord-reaction-binder.d.ts

@@ -1,11 +1,11 @@
 /**
- * Discord reaction-add binder (REACT-01, Verified Learning WS1).
+ * Discord reaction-add binder.
  *
  * Co-located out of discord-adapter.ts to hold the 800-line file-size cap
  * (the adapter only keeps the `reactionHandlers` array + the bind call + the
  * `onReaction` registration). This module owns the single
- * `Events.MessageReactionAdd` listener that Comis never bound before — the net-
- * new inbound-reaction capture. The Discord client ALREADY holds the
+ * `Events.MessageReactionAdd` listener — Comis's inbound-reaction capture
+ * point. The Discord client ALREADY holds the
  * `GuildMessageReactions`/`DirectMessageReactions` intents (discord-adapter.ts:92-93).
  *
  * Posture (mirrors the MessageCreate binder at discord-adapter.ts:142):
@@ -13,13 +13,13 @@
  *   analogue of `msg.author.bot`).
  * - PARTIAL guard: discord.js v14 delivers a PARTIAL reaction for an uncached
  *   message; `reaction.fetch()` must resolve it before `messageId`/`emoji` can
- *   be read. A failed fetch is a NON-FATAL skip (RESEARCH Pitfall 3).
+ *   be read. A failed fetch is a NON-FATAL skip.
  * - fire-and-forget fanout: every handler is `void Promise.resolve(...).catch()`ed
  *   so one throwing handler never crashes the gateway event loop.
  *
  * The reactorId is UNTRUSTED inbound (an arbitrary chat sender); no trust is
  * assigned here — the binder only normalizes to {@link NormalizedReaction} and
- * fans out. Trust + the messageId→trajectory resolve happen daemon-side (Plan 04).
+ * fans out. Trust + the messageId→trajectory resolve happen daemon-side.
  *
  * @module
  */

package/node_modules/@comis/channels/dist/discord/discord-reaction-binder.js

@@ -1,12 +1,12 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Discord reaction-add binder (REACT-01, Verified Learning WS1).
+ * Discord reaction-add binder.
  *
  * Co-located out of discord-adapter.ts to hold the 800-line file-size cap
  * (the adapter only keeps the `reactionHandlers` array + the bind call + the
  * `onReaction` registration). This module owns the single
- * `Events.MessageReactionAdd` listener that Comis never bound before — the net-
- * new inbound-reaction capture. The Discord client ALREADY holds the
+ * `Events.MessageReactionAdd` listener — Comis's inbound-reaction capture
+ * point. The Discord client ALREADY holds the
  * `GuildMessageReactions`/`DirectMessageReactions` intents (discord-adapter.ts:92-93).
  *
  * Posture (mirrors the MessageCreate binder at discord-adapter.ts:142):
@@ -14,13 +14,13 @@
  *   analogue of `msg.author.bot`).
  * - PARTIAL guard: discord.js v14 delivers a PARTIAL reaction for an uncached
  *   message; `reaction.fetch()` must resolve it before `messageId`/`emoji` can
- *   be read. A failed fetch is a NON-FATAL skip (RESEARCH Pitfall 3).
+ *   be read. A failed fetch is a NON-FATAL skip.
  * - fire-and-forget fanout: every handler is `void Promise.resolve(...).catch()`ed
  *   so one throwing handler never crashes the gateway event loop.
  *
  * The reactorId is UNTRUSTED inbound (an arbitrary chat sender); no trust is
  * assigned here — the binder only normalizes to {@link NormalizedReaction} and
- * fans out. Trust + the messageId→trajectory resolve happen daemon-side (Plan 04).
+ * fans out. Trust + the messageId→trajectory resolve happen daemon-side.
  *
  * @module
  */
@@ -63,7 +63,7 @@ export function bindDiscordReactions(client, reactionHandlers, logger) {
         const normalized = {
             messageId: resolved.message.id,
             // SAME identity space as senderId (author.id) — what the trust resolver
-            // + rate limiter key on downstream (Plan 04).
+            // + rate limiter key on downstream.
             reactorId: user.id,
             emoji: resolved.emoji.name ?? resolved.emoji.toString(),
             channelType: "discord",

package/node_modules/@comis/channels/dist/discord/format-discord.d.ts

@@ -1,9 +1,8 @@
 /**
  * Discord text chunking with code-fence awareness.
  *
- * Ported from legacy `src/discord/chunk.ts`. Splits outbound Discord text
- * by both character count and (soft) line count, while keeping fenced code
- * blocks balanced across chunks.
+ * Splits outbound Discord text by both character count and (soft) line
+ * count, while keeping fenced code blocks balanced across chunks.
  *
  * Self-contained: no external dependencies beyond Node.js built-ins.
  *

package/node_modules/@comis/channels/dist/discord/format-discord.js

@@ -2,9 +2,8 @@
 /**
  * Discord text chunking with code-fence awareness.
  *
- * Ported from legacy `src/discord/chunk.ts`. Splits outbound Discord text
- * by both character count and (soft) line count, while keeping fenced code
- * blocks balanced across chunks.
+ * Splits outbound Discord text by both character count and (soft) line
+ * count, while keeping fenced code blocks balanced across chunks.
  *
  * Self-contained: no external dependencies beyond Node.js built-ins.
  *

package/node_modules/@comis/channels/dist/echo/echo-activity.d.ts

@@ -1,5 +1,5 @@
 /**
- * Echo activity renderer (§7.2 row "TestSink").
+ * Echo activity renderer (the "TestSink" strategy).
  *
  * Echo is the thinnest channel: its renderer is the canonical-stream recorder.
  * It wraps `createTestSink()` verbatim — every `apply(frame)` is captured with
@@ -7,7 +7,7 @@
  * adapter and zero platform I/O (`canEdit:false`, `canDelete:false`), so Echo
  * needs no `ChannelPort` and no `TimerPort`/`ClockPort`.
  *
- * This is the reference shape the 4 EditPlace channels (Wave 2) build against:
+ * This is the reference shape the 4 EditPlace channels build against:
  * a `create<Ch>ActivityRenderer()` factory that returns a `ChannelActivityRenderer`.
  */
 import { type TestSinkRecorder } from "../shared/strategies/test-sink.js";

package/node_modules/@comis/channels/dist/echo/echo-activity.js

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Echo activity renderer (§7.2 row "TestSink").
+ * Echo activity renderer (the "TestSink" strategy).
  *
  * Echo is the thinnest channel: its renderer is the canonical-stream recorder.
  * It wraps `createTestSink()` verbatim — every `apply(frame)` is captured with
@@ -8,7 +8,7 @@
  * adapter and zero platform I/O (`canEdit:false`, `canDelete:false`), so Echo
  * needs no `ChannelPort` and no `TimerPort`/`ClockPort`.
  *
- * This is the reference shape the 4 EditPlace channels (Wave 2) build against:
+ * This is the reference shape the 4 EditPlace channels build against:
  * a `create<Ch>ActivityRenderer()` factory that returns a `ChannelActivityRenderer`.
  */
 import { createTestSink } from "../shared/strategies/test-sink.js";

package/node_modules/@comis/channels/dist/echo/echo-adapter.d.ts

@@ -41,12 +41,12 @@ export declare class EchoChannelAdapter implements ChannelPort {
     sendAttachment(channelId: string, attachment: AttachmentPayload, options?: SendMessageOptions): Promise<Result<string, Error>>;
     platformAction(action: string, params: Record<string, unknown>): Promise<Result<unknown, Error>>;
     /**
-     * Reconcile a crash-interrupted outward send (Phase 216, ONCE-03).
+     * Reconcile a crash-interrupted outward send.
      *
      * Echo is the deterministic test channel — it has perfect, in-memory
      * visibility of every send, so a confirmed absence IS `not_sent` (it can
-     * never return `unresolved`). This is the channel the Plan 08 chaos test
-     * drives: a controllable reconcile oracle.
+     * never return `unresolved`). This is the channel the chaos tests drive:
+     * a controllable reconcile oracle.
      *
      * Matches by channelId + send-window + recomputed content digest
      * (sha256(text).slice(0,16)) — the same content_digest the send-wrap stored.

package/node_modules/@comis/channels/dist/echo/echo-adapter.js

@@ -95,12 +95,12 @@ export class EchoChannelAdapter {
         return ok({ action, params, echoed: true });
     }
     /**
-     * Reconcile a crash-interrupted outward send (Phase 216, ONCE-03).
+     * Reconcile a crash-interrupted outward send.
      *
      * Echo is the deterministic test channel — it has perfect, in-memory
      * visibility of every send, so a confirmed absence IS `not_sent` (it can
-     * never return `unresolved`). This is the channel the Plan 08 chaos test
-     * drives: a controllable reconcile oracle.
+     * never return `unresolved`). This is the channel the chaos tests drive:
+     * a controllable reconcile oracle.
      *
      * Matches by channelId + send-window + recomputed content digest
      * (sha256(text).slice(0,16)) — the same content_digest the send-wrap stored.

package/node_modules/@comis/channels/dist/echo/echo-plugin.js

@@ -18,7 +18,7 @@ const CAPABILITIES = {
         deleteMessages: false,
         fetchHistory: false,
         attachments: false,
-        // §17.2: Echo is the TestSink — no typing, no threads, no buttons.
+        // Echo is the TestSink — no typing, no threads, no buttons.
         typing: false,
         threads: false,
         buttons: "none",
@@ -26,10 +26,9 @@ const CAPABILITIES = {
     limits: {
         maxMessageChars: 10000,
     },
-    // Defensive declaration so the lifecycle reactor + replyToMetaKey
-    // single-source path (post-REPLY_TO_META_KEY Record deletion) does
-    // not silently disable echo replies in integration tests. Echo's
-    // adapter stores message IDs under this key.
+    // Defensive declaration so the lifecycle reactor's replyToMetaKey
+    // single-source path does not silently disable echo replies in
+    // integration tests. Echo's adapter stores message IDs under this key.
     replyToMetaKey: "echoMessageId",
 };
 /**

package/node_modules/@comis/channels/dist/email/email-activity.d.ts

@@ -25,7 +25,7 @@ export interface EmailActivityRendererDeps {
  * failure with no structured numeric code on the returned value, so this DEFAULTS
  * to `internal` carrying the cause. The error is consulted for NOTHING that
  * reaches the user — it selects the variant only and is never rendered or logged
- * as activity text (§19.3).
+ * as activity text.
  */
 export declare function classifyEmailError(e: unknown): ActivityRenderError;
 /**
@@ -38,8 +38,8 @@ export declare function makeEmailRenderActions(adapter: ChannelPort, channelId:
 /**
  * Create the Email DigestOnly activity renderer — wires the
  * {@link createDigestOnlyRenderer} with the per-channel render-actions adapter.
- * DigestOnly is purely end-of-turn, so it takes NO TimerPort / ClockPort (Pitfall
- * 5). The daemon composition root constructs this with the recipient id
+ * DigestOnly is purely end-of-turn, so it takes NO TimerPort / ClockPort.
+ * The daemon composition root constructs this with the recipient id
  * and the optional `mintApprovalLink` accessor: when present, a `[FAILED]`
  * digest whose trail carries a `kind:"approval"` event appends the minted
  * single-use link. When absent, the digest is the byte-stable failure body.