comisai 1.0.45 → 1.0.46

package/node_modules/@comis/core/dist/event-bus/events-learning.d.ts

@@ -1,11 +1,11 @@
 /**
- * LearningEvents: verified-learning (v2.26) write-back + telemetry events.
+ * LearningEvents: verified-learning write-back + telemetry events.
  *
  * Composed into `EventMap` (events.ts) as a sibling of `AgentEvents` — the
- * dedicated file keeps `events-agent.ts` under its 799-line cap (Plan 07 adds
- * its `learning:skill_*` telemetry keys to THIS same interface, not events-agent).
+ * dedicated file keeps `events-agent.ts` under its 799-line cap (the
+ * `learning:skill_*` telemetry keys live on THIS same interface, not events-agent).
  *
- * Closed-graph discipline (the agent↛memory cut, SEC-01): the AGENT emits these
+ * Closed-graph discipline (the agent↛memory cut): the AGENT emits these
  * events; the DAEMON write-back subscriber does the memory store write. Mirrors
  * the `memory:recall_used → setup-memory-usefulness-wiring.ts → recordUsage`
  * precedent — the agent never imports `@comis/memory`.
@@ -19,14 +19,14 @@
  */
 /**
  * The CLOSED set of acute reasons a reflection run admitted nothing (or did) —
- * the content-free verdict carried on `reflect:funnel.admissionOutcome` (INV-6).
+ * the content-free verdict carried on `reflect:funnel.admissionOutcome`.
  *
- * Canonical HERE in `@comis/core` (IN-02): the event payload that uses it lives in
+ * Canonical HERE in `@comis/core`: the event payload that uses it lives in
  * this file, and `@comis/agent` cannot be imported by core (the agent→core direction
  * only). `@comis/agent`'s reflection-job re-exports THIS type and its
  * `classifyReflectOutcome` returns it, so the daemon emit (which assigns the value)
  * and this event contract share one closed union — a free-form string assigned into
- * the funnel field is a compile error, not a silent INV-6 drift.
+ * the funnel field is a compile error, not a silent contract drift.
  *
  * Precedence/meaning is documented at the reflection classifier
  * (`@comis/agent` reflection-job.ts `classifyReflectOutcome`):
@@ -36,17 +36,17 @@
 export type ReflectAdmissionOutcome = "admitted" | "uncorroborated" | "rejected_validation" | "rejected_name_length" | "untrusted_origin" | "empty_reflection" | "no_successes";
 export interface LearningEvents {
     /**
-     * ATTR-02: skill-use attribution complete for one turn. MINIMAL payload —
+     * Skill-use attribution complete for one turn. MINIMAL payload —
      * the per-turn used-skill ids + count ONLY, NEVER procedure bodies, the agent
      * response, or the read path. The bridge attributes a `read` whose path
-     * matches a frozen learned-skill `<location>` to a skill (ATTR-01) and
+     * matches a frozen learned-skill `<location>` to a skill and
      * accumulates the ids in a per-turn carrier; `postExecution` emits this event
      * with those ids. Emit site: `postExecution` (executor-post-execution.ts),
-     * gated on a non-empty `usedSkillIds` (absent/empty ⇒ no emit, byte-identical
-     * to pre-patch). The daemon subscriber (setup-learning.ts, Plan 07) threads
+     * gated on a non-empty `usedSkillIds` (absent/empty ⇒ no emit).
+     * The daemon subscriber (setup-learning.ts) threads
      * `usedSkillIds` into `observe()` → the `used_skill_ids` column. Mirrors the
-     * counts/ids-only `memory:recall_used`. Trajectory-bridged → `memory.skill_used`
-     * since IMP-3/PD-OBS-1 (package-delivery-20260628), so `explain.learning.skillsUsed`
+     * counts/ids-only `memory:recall_used`. Trajectory-bridged → `memory.skill_used`,
+     * so `explain.learning.skillsUsed`
      * surfaces the inline-credited ids without a DB hand-join.
      */
     "memory:skill_used": {
@@ -61,10 +61,10 @@ export interface LearningEvents {
         timestamp: number;
     };
     /**
-     * The full per-turn topic-match reuse-attribution CENSUS (finding A, obs-sweep
-     * package-delivery-20260628). `memory:skill_used` fires only when ≥1 skill is CREDITED, so a
+     * The full per-turn topic-match reuse-attribution CENSUS.
+     * `memory:skill_used` fires only when ≥1 skill is CREDITED, so a
      * surfaced skill that JUST missed the bar (coverage under threshold, or below the absolute
-     * floor) or a legacy doc with no topicTokens left NO signal — "why wasn't my skill reused?"
+     * floor) or a doc with no topicTokens left NO signal — "why wasn't my skill reused?"
      * needed a debugger. Emitted per turn when ≥1 learned skill is surfaced for topic-match, with a
      * content-free score per surfaced skill (the NAME is an opaque id; the rest are numbers — never
      * a procedure body). Bridged to the `memory.skill_surfaced` trajectory record; folded into
@@ -89,15 +89,15 @@ export interface LearningEvents {
         timestamp: number;
     };
     /**
-     * REFLECT (v2.31, Phase 226 SIMPLIFY-04): a reflection run admitted N candidate
+     * A reflection run admitted N candidate
      * docs. Emitted DAEMON-SIDE (plain `eventBus.emit`, never `?.`) by the reflection
      * cron handler (setup-channels-memory-crons-wire.ts) AFTER `runReflection` returns
      * — the daemon emit (not the agent job) keeps the trajectory-bridge entry landing
-     * with the emit (no agent-side gate trip). RENAMED from `learning:skill_synthesized`
-     * to `reflect:admitted` (the reflection funnel rename — the forget/outcome events
-     * KEEP their `learning:*` names, Pitfall 6). COUNT ONLY — the reflected doc body is
-     * a compile error here (the §2.7 / SEC-01 firewall). Bridged
-     * (TRAJECTORY_BRIDGE_MAPPING) for `comis explain` / OBS-02.
+     * with the emit (no agent-side gate trip). The `reflect:*` prefix covers the
+     * reflection funnel only — the forget/outcome events carry `learning:*` names.
+     * COUNT ONLY — the reflected doc body is
+     * a compile error here (the §2.7 counts-only firewall). Bridged
+     * (TRAJECTORY_BRIDGE_MAPPING) for `comis explain`.
      */
     "reflect:admitted": {
         agentId: string;
@@ -106,16 +106,16 @@ export interface LearningEvents {
         timestamp: number;
     };
     /**
-     * REFLECT (v2.31, Phase 226 SIMPLIFY-04): the reflection-run FUNNEL — counts ONLY,
+     * The reflection-run FUNNEL — counts ONLY,
      * emitted DAEMON-SIDE alongside `reflect:admitted` after `runReflection` returns (the
      * reflection cron wire maps the reflect result onto these fields). Where
      * `reflect:admitted.count` is only the ADMITTED tail, this carries the whole funnel so
      * `comis explain` answers "why didn't a doc get learned" WITHOUT a DEBUG-log grep — the
      * load-bearing field is `maxClusterCardinality` (the distinct (session,sender)
      * corroboration size; a value of 1 = a single uncorroborated instance, so admission
-     * CORRECTLY refused; the same conservatism that defeats poisoning). RENAMED from the
-     * old synthesis-funnel event to `reflect:funnel`. COUNT ONLY — a reflected doc
-     * body is a compile error here (the §2.7 / SEC-01 firewall). Bridged
+     * CORRECTLY refused; the same conservatism that defeats poisoning).
+     * COUNT ONLY — a reflected doc
+     * body is a compile error here (the §2.7 counts-only firewall). Bridged
      * (TRAJECTORY_BRIDGE_MAPPING) for `comis explain`.
      */
     "reflect:funnel": {
@@ -161,7 +161,7 @@ export interface LearningEvents {
          */
         totalSourceChars: number;
         /**
-         * RC-4: the acute reason this run admitted nothing (or `admitted`) — a content-free
+         * The acute reason this run admitted nothing (or `admitted`) — a content-free
          * closed enum so `comis explain` answers "why was 0 admitted" from ONE field. The
          * reflect verdict (classifyReflectOutcome): `no_successes` (no trusted-origin success
          * cleared SELECT) / `untrusted_origin` (all successes dropped at SELECT for an
@@ -169,18 +169,18 @@ export interface LearningEvents {
          * `empty_reflection` / `rejected_name_length` (doc name over MAX_DOC_NAME_LENGTH) /
          * `rejected_validation` / `admitted`.
          *
-         * IN-02: typed to the CLOSED {@link ReflectAdmissionOutcome} union (was `string`) so
+         * Typed to the CLOSED {@link ReflectAdmissionOutcome} union so
          * the closed-enum contract is type-enforced — a free-form string into the funnel field
-         * is a compile error, not a silent INV-6 drift.
+         * is a compile error, not a silent contract drift.
          */
         admissionOutcome: ReflectAdmissionOutcome;
         timestamp: number;
     };
     /**
-     * SURFACE-06: an attributed successful reuse promoted N candidate skills this
+     * An attributed successful reuse promoted N candidate skills this
      * resolve (candidate→active past promoteAtProofCount). Emitted DAEMON-SIDE
-     * (setup-learning.ts, Plan 05) — counts ONLY, never a procedure body/script/id-list.
-     * Bridged for comis explain / OBS-02.
+     * (setup-learning.ts) — counts ONLY, never a procedure body/script/id-list.
+     * Bridged for comis explain.
      */
     "learning:skill_promoted": {
         agentId: string;
@@ -189,22 +189,23 @@ export interface LearningEvents {
         timestamp: number;
     };
     /**
-     * SURFACE-06: a corroboration-gated decay-aware-trend WEAKENING demoted N skills
+     * A corroboration-gated decay-aware-trend WEAKENING demoted N skills
      * this resolve (active→stale→archived). Emitted DAEMON-SIDE.
      *
-     * Finding C (obs-sweep package-delivery-20260628): carries the demoted skill NAMES + the
+     * Carries the demoted skill NAMES + the
      * trigger trajectory id alongside the count, so `explain` answers "WHICH skill demoted and WHY"
-     * in one call (it was count-only → "2 demoted" with no name, forcing a daemon.log + mental_models
-     * hand-join). Content-free: skill NAMES are the same opaque id-class as `skill.prompt_invoked.skillName`
-     * + a trajectory id — never a procedure body/script (SEC-01).
+     * in one call (a count-only payload — "2 demoted" with no name — would force a daemon.log +
+     * mental_models hand-join). Content-free: skill NAMES are the same opaque id-class as
+     * `skill.prompt_invoked.skillName`
+     * + a trajectory id — never a procedure body/script.
      */
     "learning:skill_demoted": {
         agentId: string;
         /** How many skills were demoted (active→stale→archived) this resolve (count only). */
         count: number;
-        /** The demoted skill NAMES (id-class; == count entries). Finding C. */
+        /** The demoted skill NAMES (id-class; == count entries). */
         demotedSkillNames?: string[];
-        /** The trajectory whose failure/correction outcome drove this demote (the WHY). Finding C. */
+        /** The trajectory whose failure/correction outcome drove this demote (the WHY). */
         triggerTrajectoryId?: string;
         timestamp: number;
     };
@@ -215,7 +216,7 @@ export interface LearningEvents {
      * `learning:skill_demoted`) so `wireLearningOutcome` (which owns the gated skill-transition + its
      * corroboration/trend state) can RE-RUN the skill transition for that trajectory's credited skills
      * with a `corrected` verdict → a corroborated correction flips the wrong skill active/candidate→stale
-     * (kept, not deleted). Content-free: ids + a confidence scalar ONLY, never a body (INV-6).
+     * (kept, not deleted). Content-free: ids + a confidence scalar ONLY, never a body.
      */
     "learning:correction_observed": {
         agentId: string;

package/node_modules/@comis/core/dist/event-bus/events-learning.js

@@ -1,12 +1,12 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * LearningEvents: verified-learning (v2.26) write-back + telemetry events.
+ * LearningEvents: verified-learning write-back + telemetry events.
  *
  * Composed into `EventMap` (events.ts) as a sibling of `AgentEvents` — the
- * dedicated file keeps `events-agent.ts` under its 799-line cap (Plan 07 adds
- * its `learning:skill_*` telemetry keys to THIS same interface, not events-agent).
+ * dedicated file keeps `events-agent.ts` under its 799-line cap (the
+ * `learning:skill_*` telemetry keys live on THIS same interface, not events-agent).
  *
- * Closed-graph discipline (the agent↛memory cut, SEC-01): the AGENT emits these
+ * Closed-graph discipline (the agent↛memory cut): the AGENT emits these
  * events; the DAEMON write-back subscriber does the memory store write. Mirrors
  * the `memory:recall_used → setup-memory-usefulness-wiring.ts → recordUsage`
  * precedent — the agent never imports `@comis/memory`.

package/node_modules/@comis/core/dist/event-bus/events-media.d.ts

@@ -1,7 +1,7 @@
 /**
  * MediaGenerationEvents: image-generation lifecycle events (image:*).
  *
- * OBS-04 (Phase 186, v2.23): the daemon image RPC handler records an image
+ * The daemon image RPC handler records an image
  * turn's lifecycle onto the per-session trajectory so `comis explain
  * <sessionKey>` can reconstruct it (provider / model / costUsd / outcome).
  *
@@ -14,11 +14,11 @@
  * nonetheless, for trajectory-type ARCH CLOSURE (the arch test enumerates the
  * mapping) and so a future bus emitter is already wired.
  *
- * CONTENT-FREE (T-186-08): every payload carries ids / labels / counts /
+ * CONTENT-FREE: every payload carries ids / labels / counts /
  * `costUsd` / booleans ONLY — NEVER the prompt text, the generated image bytes,
  * a credential, or a raw provider error message. `costUsd` rides
  * `image:generated` so the trajectory reconstruction surfaces the image turn's
- * cost (OBS-03 Route a — the binding bar). The redaction-safe detail (if any)
+ * cost. The redaction-safe detail (if any)
  * rides the structured Pino LOG, never the bus/trajectory.
  */
 export interface MediaGenerationEvents {
@@ -30,7 +30,7 @@ export interface MediaGenerationEvents {
     "image:requested": {
         /** The executing image provider id (the boot-selected port — `deps.provider.id`). */
         provider: string;
-        /** The caller agent's resolved main provider id (RES-01 lockstep label). */
+        /** The caller agent's resolved main provider id (lockstep label). */
         mainProvider: string;
         /** Multi-tenant agent identifier (envelope correlation — stripped from trajectory data). */
         agentId?: string;
@@ -40,7 +40,7 @@ export interface MediaGenerationEvents {
     };
     /**
      * An image was generated successfully. Carries the cost + provider + model +
-     * size + outcome — the OBS-03 cost-carry record (`costUsd`) so `comis
+     * size + outcome — the cost-carry record (`costUsd`) so `comis
      * explain` reconstructs the turn's cost from the trajectory. NO image bytes.
      */
     "image:generated": {
@@ -48,7 +48,7 @@ export interface MediaGenerationEvents {
         provider: string;
         /** The image model the provider used (e.g. "gpt-image-1"). Optional — some adapters omit it. */
         model?: string;
-        /** The image generation cost in USD (from the widened ImageGenOutput — OBS-03). Optional. */
+        /** The image generation cost in USD (from ImageGenOutput). Optional. */
         costUsd?: number;
         /** The persisted/encoded image size in bytes (a size signal, not the content). Optional. */
         sizeBytes?: number;
@@ -93,21 +93,21 @@ export interface MediaGenerationEvents {
     };
 }
 /**
- * The `path` a vision turn took — VIS-03's "which path" signal (the locked
+ * The `path` a vision turn took — the "which path" signal (the locked
  * ladder order). `unavailable` is failure-only (no tier served).
  */
 export type VisionPath = "main-vision" | "registry" | "gemini-video" | "unavailable";
 /**
  * MediaVisionEvents: vision-analysis lifecycle events (media.vision:*).
  *
- * VIS-04 (Phase 187, v2.23): the daemon vision RPC handler
+ * The daemon vision RPC handler
  * (`image.analyze` / `media.describe_video`) records a vision turn's lifecycle
  * onto the per-session trajectory so `comis explain <sessionKey>` can
  * reconstruct it (provider / mainProvider / model / path / costUsd / outcome) —
- * the SAME observability image generation got in Phase 186 (the `image.*`
+ * the SAME observability image generation gets (the `image.*`
  * machinery is the template).
  *
- * APPEND-ONLY (Pitfall 5): this is a NEW event set ALONGSIDE the SemVer-frozen
+ * APPEND-ONLY: this is a NEW event set ALONGSIDE the SemVer-frozen
  * `MediaGenerationEvents` `image:*` shape — never a rename of an `image.*`
  * literal (a rename trips the bridge-entry-count guard + the
  * `IncidentReport.image` reconstruction + the web codegen cascade).
@@ -119,12 +119,12 @@ export type VisionPath = "main-vision" | "registry" | "gemini-video" | "unavaila
  * trajectory registries + a translator) for trajectory-type ARCH CLOSURE and so
  * a future bus emitter is already wired.
  *
- * CONTENT-FREE (T-187-12): every payload carries ids / labels / the `path` /
+ * CONTENT-FREE: every payload carries ids / labels / the `path` /
  * `costUsd` / `outcome` / `errorKind` ONLY — NEVER the image bytes, the analysis
  * prompt, the model's answer, or a credential. `costUsd` rides
  * `media.vision:completed` (= `AssistantMessage.usage.cost.total`, optional —
- * absent on the registry/gemini-video tiers which return no cost; Pitfall 4) so
- * the trajectory reconstruction surfaces the vision turn's cost (Route a).
+ * absent on the registry/gemini-video tiers which return no cost) so
+ * the trajectory reconstruction surfaces the vision turn's cost.
  */
 export interface MediaVisionEvents {
     /**
@@ -146,10 +146,10 @@ export interface MediaVisionEvents {
     /**
      * A vision analysis completed successfully on some tier. Carries the
      * executing provider + the resolved main provider + model + the `path` label +
-     * an OPTIONAL `costUsd` — the VIS-04 cost-carry record (Route a) so `comis
+     * an OPTIONAL `costUsd` — the cost-carry record so `comis
      * explain` reconstructs the turn's cost. `costUsd` is present only on the
      * main-vision tier (the bridge returns it); the registry/gemini-video tiers
-     * return no cost (Pitfall 4). NO model answer text.
+     * return no cost. NO model answer text.
      */
     "media.vision:completed": {
         /** The executing vision provider id (e.g. "anthropic" on main-vision, "gemini" on the registry tier). */
@@ -158,9 +158,9 @@ export interface MediaVisionEvents {
         mainProvider: string;
         /** The vision model used (e.g. "claude-sonnet-4-5"). Optional — some adapters omit it. */
         model?: string;
-        /** The analysis cost in USD (from AssistantMessage.usage.cost.total — VIS-04). Optional (absent on registry/gemini-video). */
+        /** The analysis cost in USD (from AssistantMessage.usage.cost.total). Optional (absent on registry/gemini-video). */
         costUsd?: number;
-        /** Which ladder tier served the turn (VIS-03's "which path" signal). */
+        /** Which ladder tier served the turn (the "which path" signal). */
         path: VisionPath;
         /** Closed outcome label (always "ok" on this event — failures emit media.vision:failed). */
         outcome: "ok";
@@ -195,7 +195,7 @@ export interface MediaVisionEvents {
 /**
  * MediaVideoGenerationEvents: video-generation lifecycle events (video:*).
  *
- * OBS-04 (Phase 192, v2.24): the daemon video RPC handler (`video.generate`,
+ * The daemon video RPC handler (`video.generate`,
  * in-turn) AND the off-turn background poller (`setup-video-poller.ts`) record a
  * video turn's lifecycle onto the per-session trajectory so `comis explain
  * <sessionKey>` can reconstruct it — INCLUDING a job that completes in the
@@ -203,7 +203,7 @@ export interface MediaVisionEvents {
  * completion via `traceId`/`jobId`; the persisted `session_key` job-row column is
  * how the off-turn poller resolves the recorder.
  *
- * APPEND-ONLY (Pitfall 8): a NEW event set ALONGSIDE the SemVer-frozen
+ * APPEND-ONLY: a NEW event set ALONGSIDE the SemVer-frozen
  * `MediaGenerationEvents` `image:*` shape + `MediaVisionEvents` `media.vision:*`
  * shape — never a rename of an `image.*`/`media.vision.*` literal (a rename trips
  * the bridge-entry-count guard + the `IncidentReport` reconstruction + the web
@@ -216,10 +216,10 @@ export interface MediaVisionEvents {
  * trajectory registries + a translator) for trajectory-type ARCH CLOSURE and so
  * a future bus emitter is already wired.
  *
- * CONTENT-FREE (T-192-01): every payload carries ids / labels / counts /
+ * CONTENT-FREE: every payload carries ids / labels / counts /
  * `costUsd` / `outcome` / `errorKind` / booleans ONLY — NEVER the prompt, the
  * video bytes, a credential, the Veo keyed-download-URL, or a raw provider
- * message. `costUsd` rides `video:generated` (OBS-03 Route a — FAL/Veo estimate,
+ * message. `costUsd` rides `video:generated` (FAL/Veo estimate,
  * Grok actual; optional so an absent value never appears) so the trajectory
  * reconstruction surfaces the video turn's cost. The redaction-safe detail rides
  * the structured Pino LOG, never the bus/trajectory.
@@ -233,7 +233,7 @@ export interface MediaVideoGenerationEvents {
     "video:requested": {
         /** The executing video provider id (the boot-selected port — `deps.provider.id`). */
         provider: string;
-        /** The caller agent's resolved main provider id (RES-01 lockstep label). */
+        /** The caller agent's resolved main provider id (lockstep label). */
         mainProvider: string;
         /** Multi-tenant agent identifier (envelope correlation — stripped from trajectory data). */
         agentId?: string;
@@ -259,7 +259,7 @@ export interface MediaVideoGenerationEvents {
     };
     /**
      * A video was generated successfully (the off-turn poller's done branch).
-     * Carries the cost + provider + model + size + duration + outcome — the OBS-03
+     * Carries the cost + provider + model + size + duration + outcome — the
      * cost-carry record (`costUsd`) so `comis explain` reconstructs the turn's cost
      * from the trajectory. NO video bytes, NO keyed-download-URL.
      */
@@ -268,7 +268,7 @@ export interface MediaVideoGenerationEvents {
         provider: string;
         /** The video model the provider used (e.g. "veo-3.1"). Optional. */
         model?: string;
-        /** The reconciled generation cost in USD (OBS-03; FAL/Veo estimate, Grok actual). Optional. */
+        /** The reconciled generation cost in USD (FAL/Veo estimate, Grok actual). Optional. */
         costUsd?: number;
         /** The persisted video size in bytes (a size signal, not the content). Optional. */
         sizeBytes?: number;
@@ -318,7 +318,7 @@ export interface MediaVideoGenerationEvents {
 }
 /**
  * The resolved STT/TTS selection rung — the provenance `source` of the chosen
- * provider (design §17 / OBS-03). Matches `SttSelection.source` in
+ * provider. Matches `SttSelection.source` in
  * `resolve-transcription-provider.ts` / `resolve-tts-provider.ts`; kept local to
  * the EventMap so a consumer can type-narrow the rung without the resolver
  * barrel. `keyless-local` is the default; `follow-main-key` reuses the main
@@ -330,15 +330,15 @@ export type VoiceSelectionSource = "explicit" | "keyless-local" | "follow-main-k
  * MediaSttEvents + MediaTtsEvents: voice (speech-to-text / text-to-speech)
  * lifecycle events (`media.stt:*` / `media.tts:*`).
  *
- * OBS-02/03 (Phase 196, v2.25): the daemon voice RPC handler (`media.transcribe`
+ * The daemon voice RPC handler (`media.transcribe`
  * / `tts.synthesize`) records a voice turn's lifecycle onto the per-session
  * trajectory so `comis explain <sessionKey>` reconstructs it (provider /
  * keyless? / model / durationMs / costUsd / the resolved `source` rung + the
- * `onSkip` reasons / outcome) — the SAME observability image/vision/video got in
- * Phases 186/187/192 (the `video:*` machinery is the cleanest twin: record-only,
+ * `onSkip` reasons / outcome) — the SAME observability the image/vision/video
+ * events provide (the `video:*` machinery is the cleanest twin: record-only,
  * because the voice handlers/pipeline already carry §2.7 logging).
  *
- * APPEND-ONLY (Pitfall 8): a NEW event set ALONGSIDE the SemVer-frozen
+ * APPEND-ONLY: a NEW event set ALONGSIDE the SemVer-frozen
  * `MediaGenerationEvents` `image:*` / `MediaVisionEvents` `media.vision:*` /
  * `MediaVideoGenerationEvents` `video:*` shapes — never a rename of a frozen
  * literal (a rename trips the bridge-entry-count guard + the `IncidentReport`
@@ -351,13 +351,13 @@ export type VoiceSelectionSource = "explicit" | "keyless-local" | "follow-main-k
  * registries + a translator) for trajectory-type ARCH CLOSURE and so a future
  * bus emitter is already wired.
  *
- * CONTENT-FREE (T-196-04): every payload carries ids / labels / numbers /
+ * CONTENT-FREE: every payload carries ids / labels / numbers /
  * booleans / closed-enum reasons ONLY — NEVER the audio bytes, the transcript
  * text, the synthesized audio, or a credential. `costUsd` rides `*:completed`
- * (OBS-05 Route a; keyless = `0` EXPLICIT so "free" is visible — never absent;
- * keyed omits it where the provider returns no per-call cost — Pitfall 4) so the
+ * (keyless = `0` EXPLICIT so "free" is visible — never absent;
+ * keyed omits it where the provider returns no per-call cost) so the
  * trajectory reconstruction surfaces the voice turn's cost. The `onSkip` reasons
- * (a closed rung-list, no free text) ride `*:requested` (OBS-03 — WHY `auto`
+ * (a closed rung-list, no free text) ride `*:requested` (WHY `auto`
  * picked the rung, beyond the chosen `source`). The domain `SttErrorKind` rides
  * `*:failed.errorKind` verbatim (the redaction-safe detail + the closed log union
  * via `STT_ERR_TO_LOG` ride the structured Pino LOG, never the trajectory).
@@ -368,16 +368,16 @@ export interface MediaSttEvents {
     /**
      * A transcription was requested (entry, after the keyless-first resolve).
      * Carries the resolved provider + keyless flag + the selection `source` rung +
-     * the `onSkip` reasons (the rungs `auto` skipped + why — OBS-03). NO audio.
+     * the `onSkip` reasons (the rungs `auto` skipped + why). NO audio.
      */
     "media.stt:requested": {
         /** The resolved/executing STT provider id (e.g. "local", "openai"). */
         provider: string;
         /** Whether the resolved provider is keyless (no audio key needed). */
         keyless: boolean;
-        /** The resolved selection rung (OBS-03 — which rung `auto` chose). */
+        /** The resolved selection rung (which rung `auto` chose). */
         source: VoiceSelectionSource;
-        /** The resolver's onSkip reasons (the rungs auto SKIPPED + why — OBS-03; a
+        /** The resolver's onSkip reasons (the rungs auto SKIPPED + why; a
          *  closed rung-list, NOT a credential). Optional — absent on an explicit pin. */
         onSkip?: string[];
         /** Multi-tenant agent identifier (envelope correlation — stripped from trajectory data). */
@@ -390,7 +390,7 @@ export interface MediaSttEvents {
     };
     /**
      * A transcription completed successfully. Carries provider + keyless + model +
-     * durationMs + audioBytes + an OPTIONAL `costUsd` (OBS-05 Route a — keyless = 0
+     * durationMs + audioBytes + an OPTIONAL `costUsd` (keyless = 0
      * EXPLICIT, keyed omits where no per-call cost) + the selection `source`. NO
      * transcript text.
      */
@@ -405,7 +405,7 @@ export interface MediaSttEvents {
         durationMs?: number;
         /** The inbound audio size in bytes (a size signal, not the content). Optional. */
         audioBytes?: number;
-        /** The transcription cost in USD (OBS-05; keyless = 0 explicit, keyed omitted). Optional. */
+        /** The transcription cost in USD (keyless = 0 explicit, keyed omitted). Optional. */
         costUsd?: number;
         /** The resolved selection rung. */
         source: VoiceSelectionSource;
@@ -446,22 +446,22 @@ export interface MediaSttEvents {
 }
 /**
  * MediaTtsEvents: text-to-speech lifecycle events (`media.tts:*`). The TTS twin
- * of {@link MediaSttEvents} — the same content-free shape, the same OBS-02/03/05
- * obligations (see the `MediaSttEvents` header). APPEND-ONLY alongside the frozen
+ * of {@link MediaSttEvents} — the same content-free shape, the same cost-carry
+ * and selection-provenance obligations (see the `MediaSttEvents` header). APPEND-ONLY alongside the frozen
  * media.stt:* / video:* shapes — never a rename.
  */
 export interface MediaTtsEvents {
     /** A synthesis was requested (entry, after the keyless-first resolve). Carries
      *  the resolved provider + keyless flag + the selection `source` rung + the
-     *  `onSkip` reasons (OBS-03). NO text. */
+     *  `onSkip` reasons. NO text. */
     "media.tts:requested": {
         /** The resolved/executing TTS provider id (e.g. "edge", "elevenlabs"). */
         provider: string;
         /** Whether the resolved provider is keyless. */
         keyless: boolean;
-        /** The resolved selection rung (OBS-03). */
+        /** The resolved selection rung. */
         source: VoiceSelectionSource;
-        /** The resolver's onSkip reasons (the rungs auto SKIPPED + why — OBS-03). Optional. */
+        /** The resolver's onSkip reasons (the rungs auto SKIPPED + why). Optional. */
         onSkip?: string[];
         /** Multi-tenant agent identifier (envelope correlation — stripped from trajectory data). */
         agentId?: string;
@@ -485,7 +485,7 @@ export interface MediaTtsEvents {
         durationMs?: number;
         /** The produced audio size in bytes (a size signal, not the content). Optional. */
         audioBytes?: number;
-        /** The synthesis cost in USD (OBS-05; keyless = 0 explicit, keyed omitted). Optional. */
+        /** The synthesis cost in USD (keyless = 0 explicit, keyed omitted). Optional. */
         costUsd?: number;
         /** The resolved selection rung. */
         source: VoiceSelectionSource;