@catalyst-cloud/sdk 0.16.2 → 0.16.4

package/dist/node.js

@@ -3435,6 +3435,18 @@ var durableEventTypes = {
     ingestVerb: "coordination.publish",
     wakes: false
   },
+  // ⭐ CTC-5517 — the three facts an agent working a branch waits on. All three are minted inside the
+  // tenant object (`apps/mirror/src/do/pr-branch-events.ts`) and refused on every publish route, so
+  // only the cloud can produce a type that may interrupt a running agent. Each costs four DO rows and
+  // three off-DO writes (`event-backbone.ts`), so each fires on a boundary, never on a level.
+  "branch.moved": {
+    rationale: "A pull request's head branch moved to a new commit, read from GitHub's own push delivery rather than from the pusher's report, so a lost robot receipt cannot lose it. One per push to an open pull request's branch; a push to a branch with no open pull request adds nothing beyond github.push.",
+    ingestVerb: "mirror.derived",
+    wakes: false,
+    entity: "pull_request",
+    publishers: ["cloud"],
+    urgency: "interrupt"
+  },
   "comms.message.posted": {
     rationale: "A real cross-agent/human communication fact \u2014 an actual message was posted, not sampled.",
     ingestVerb: "coordination.publish",
@@ -4872,6 +4884,26 @@ var durableEventTypes = {
   // replica reader could see it. The payload contract is `PromptRunFinishedPayload`
   // (packages/protocol/src/prompt-run.ts): identifiers, outcome, failure class and duration, never
   // the prompt text or the receipt summary.
+  // CTC-5517 — the conflicted boundary, never every mergeability state change: GitHub nulls
+  // `mergeable` on every open pull request at each base push and recomputes it, so a type fired on
+  // each change would fire once per open pull request per main merge (`remediate-trigger.ts`'s
+  // "TRANSITION, NEVER LEVEL").
+  "pr.conflict.detected": {
+    rationale: "An open pull request crossed into conflicting with its base, as GitHub decided it. Announced once when the conflict starts, not on each recompute, so the agent working the branch and the upkeep robot can act on it.",
+    ingestVerb: "mirror.derived",
+    wakes: false,
+    entity: "pull_request",
+    publishers: ["cloud"],
+    urgency: "interrupt"
+  },
+  "pr.mergeability.changed": {
+    rationale: "An open pull request crossed the conflicted boundary in either direction: into conflicting with its base, or out of it. A recompute through GitHub's unknown state that lands where it started is no change.",
+    ingestVerb: "mirror.derived",
+    wakes: false,
+    entity: "pull_request",
+    publishers: ["cloud"],
+    urgency: "next-turn"
+  },
   "prompt.run.finished": {
     rationale: "An operator prompt run left `running` for good: its lease was released with a receipt, released without one, refused after the claim, or recovered after an interrupted container. ADR-0039's own durable-fact example ('a runner reported an outcome'), for the third work-unit kind. It fires once per run, in the transaction that closes the run's row.",
     // ⚠️ Minted inside the mirror DO, like ask.replied: coordination.publish is the closest true verb.
@@ -5243,6 +5275,10 @@ var telemetryEventTypes = {
     reason: "CTC-289 \u2014 a verified, tenant-routable delivery whose repo/team is not a provisioned `projects` row. Carries the account, the scope key and the fence mode: the scope key is the entire diagnostic value (it answers 'why is repo Y in my mirror' and 'why is repo Y missing'), and the mode distinguishes an observed would-drop from an actual drop. Unsampled while the fence rolls out \u2014 the `observe` soak that gates enforcement reads exactly this signal, and a sampled soak cannot support a data-discarding flip. Revisit the class once enforce has been stable.",
     sampling: { kind: "always" }
   },
+  "mirror.webhook.ci-skipped": {
+    reason: "CTC-5300 \u2014 a verified, in-scope GitHub CI delivery the Worker edge withheld from the ingest queue (or, under `shadow`, would have): a non-final workflow_job, workflow_run or check_suite action nobody reads. Carries the account, the event type, the action and the filter mode; the mode distinguishes a would-skip from an actual skip. Unsampled for the same reason as mirror.webhook.out-of-scope: the `shadow` soak that gates a data-discarding flip reads exactly this signal, and a sampled soak cannot support it. Expected volume at enforce is about 31.6k/day fleet-wide. Revisit the class once enforce has been stable.",
+    sampling: { kind: "always" }
+  },
   "mirror.dispatch-queue.derive-refused": {
     reason: "CTC-1510 \u2014 one point per fail-closed `deriveDispatchQueue` refusal (an unresolved, missing or ambiguous team_workflow_mapping), carrying the team and WHICH resolution failed. Not durable: the refusal is a description of a configuration state, not a state transition, and it repeats every pass until the mapping is fixed \u2014 the durable fact is the mapping row itself. `always`-sampled: rare by design (a healthy tenant never emits it) and it is the ONLY machine-readable signal that a team's queue stopped advancing on purpose, which is exactly what a sampled-away point would hide. Repeats inside the DO's announce window are folded into `count`, never dropped.",
     sampling: { kind: "always" }
@@ -5406,6 +5442,14 @@ var ALL_CLASSIFIED_EVENT_TYPES = [
 var WAKE_ELIGIBLE_EVENT_TYPES = DURABLE_EVENT_TYPES.filter(
   (t) => durableEventTypes[t].wakes !== false
 );
+function hasExternalPublisher(t) {
+  if (!Object.prototype.hasOwnProperty.call(durableEventTypes, t)) return false;
+  const spec = durableEventTypes[t];
+  return spec.publishers === void 0 || spec.publishers.some((p) => p !== "cloud");
+}
+var CLOUD_ONLY_EVENT_TYPES = DURABLE_EVENT_TYPES.filter(
+  (t) => !hasExternalPublisher(t)
+);
 
 // node_modules/@catalyst-cloud/schema/src/events/retention.ts
 var EVENT_HOT_WINDOW_MS = 7 * 24 * 60 * 60 * 1e3;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catalyst-cloud/sdk",
-  "version": "0.16.2",
+  "version": "0.16.4",
   "description": "Read and update your Catalyst Cloud data, and receive live changes in your apps.",
   "license": "MIT",
   "author": "Coalesce Labs",
@@ -100,8 +100,8 @@
   ],
   "devDependencies": {
     "@catalyst-cloud/read-model": "^0.16.0",
-    "@catalyst-cloud/replicate": "0.16.1",
-    "@catalyst-cloud/schema": "0.16.1",
+    "@catalyst-cloud/replicate": "0.16.3",
+    "@catalyst-cloud/schema": "0.16.3",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/context-async-hooks": "^2.8.0",
     "@opentelemetry/resources": "^2.8.0",
@@ -119,8 +119,8 @@
     "@sqlite.org/sqlite-wasm": "*",
     "better-sqlite3": "*",
     "@catalyst-cloud/read-model": "^0.16.0",
-    "@catalyst-cloud/replicate": "0.16.1",
-    "@catalyst-cloud/schema": "0.16.1"
+    "@catalyst-cloud/replicate": "0.16.3",
+    "@catalyst-cloud/schema": "0.16.3"
   },
   "peerDependenciesMeta": {
     "@opentelemetry/api": {