@catalyst-cloud/schema 0.1.13 → 0.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catalyst-cloud/schema",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "type": "module",
   "description": "Typed Drizzle schema = single source of truth for the per-tenant Mirror DO SQLite store (CTC-13 / ADR-0002). Shared by the mirror Worker, the host-sync replica, and the browser OPFS replica.",
   "license": "MIT",

package/src/index.ts

@@ -19,6 +19,8 @@ import {
   projects,
   cycles,
   workflow_states,
+  // CTC-624: the tenant's per-team workflow DECISION, projected from the D1 registry (ADR-0033).
+  team_workflow_mapping,
   initiatives,
   project_initiatives,
   comments,
@@ -41,6 +43,7 @@ import {
   pr_commits,
   pr_events,
   pr_ancillary_backfill,
+  push_subscriptions,
 } from "./mirror.js";
 
 export * from "./mirror.js";
@@ -78,6 +81,8 @@ export const mirrorSchema = {
   projects,
   cycles,
   workflow_states,
+  // CTC-624: projected from the D1 registry, the one mirror table whose authority is not a provider.
+  team_workflow_mapping,
   initiatives,
   project_initiatives,
   comments,
@@ -112,6 +117,9 @@ export const mirrorSchema = {
   pr_commits,
   pr_events,
   pr_ancillary_backfill,
+  // CTC-619: a member's Web Push subscription. Rides the change feed like any other entity — a
+  // member-facing settings UI can reflect subscribe/unsubscribe reactively.
+  push_subscriptions,
 } as const;
 
 /**
@@ -139,6 +147,9 @@ export const mirrorEntityTables = {
   projects,
   cycles,
   workflow_states,
+  // CTC-624: the tenant's per-team workflow decision. On this plane deliberately — it is how
+  // anything reaches a host at all, and the browser board is a legitimate consumer (ADR-0033).
+  team_workflow_mapping,
   initiatives,
   project_initiatives,
   comments,
@@ -157,6 +168,8 @@ export const mirrorEntityTables = {
   pr_conversation_comments,
   pr_commits,
   pr_events,
+  // CTC-619: a member's Web Push subscription.
+  push_subscriptions,
 } as const;
 
 /** The wire `entity` name of a change-feed-carried table (keys of mirrorEntityTables). */

package/src/migrations.generated.ts

@@ -172,6 +172,20 @@ export const MIRROR_MIGRATIONS = {
         tag: "0022_chilly_gorgon",
         breakpoints: true,
       },
+      {
+        idx: 23,
+        version: "6",
+        when: 1786935258669,
+        tag: "0023_ambiguous_micromax",
+        breakpoints: true,
+      },
+      {
+        idx: 24,
+        version: "6",
+        when: 1786984427741,
+        tag: "0024_long_spencer_smythe",
+        breakpoints: true,
+      },
     ],
   },
   migrations: {
@@ -219,5 +233,9 @@ export const MIRROR_MIGRATIONS = {
       "CREATE TABLE `pr_ancillary_backfill` (\n\t`repo_id` text NOT NULL,\n\t`pr_number` integer NOT NULL,\n\t`backfilled_at` integer NOT NULL,\n\tPRIMARY KEY(`repo_id`, `pr_number`)\n);\n--> statement-breakpoint\nCREATE TABLE `pr_commits` (\n\t`repo_id` text NOT NULL,\n\t`pr_number` integer NOT NULL,\n\t`sha` text NOT NULL,\n\t`message` text,\n\t`author_login` text,\n\t`author_name` text,\n\t`author_email` text,\n\t`authored_at` integer,\n\t`committed_at` integer,\n\tPRIMARY KEY(`repo_id`, `pr_number`, `sha`)\n);\n--> statement-breakpoint\nCREATE TABLE `pr_conversation_comments` (\n\t`id` text PRIMARY KEY NOT NULL,\n\t`repo_id` text NOT NULL,\n\t`pr_number` integer NOT NULL,\n\t`author_id` text,\n\t`body` text,\n\t`created_at` integer,\n\t`updated_at` integer,\n\t`removed_at` integer\n);\n--> statement-breakpoint\nCREATE INDEX `idx_pr_conversation_comments_pr` ON `pr_conversation_comments` (`repo_id`,`pr_number`);--> statement-breakpoint\nCREATE TABLE `pr_events` (\n\t`id` text PRIMARY KEY NOT NULL,\n\t`repo_id` text NOT NULL,\n\t`pr_number` integer NOT NULL,\n\t`action` text,\n\t`actor_id` text,\n\t`created_at` integer,\n\t`updated_at` integer,\n\t`raw` text\n);\n--> statement-breakpoint\nCREATE INDEX `idx_pr_events_pr` ON `pr_events` (`repo_id`,`pr_number`,`created_at`);--> statement-breakpoint\nCREATE TABLE `pr_review_comments` (\n\t`id` text PRIMARY KEY NOT NULL,\n\t`repo_id` text NOT NULL,\n\t`pr_number` integer NOT NULL,\n\t`review_id` text,\n\t`commit_id` text,\n\t`path` text,\n\t`line` integer,\n\t`diff_hunk` text,\n\t`in_reply_to_id` text,\n\t`author_id` text,\n\t`body` text,\n\t`created_at` integer,\n\t`updated_at` integer,\n\t`removed_at` integer\n);\n--> statement-breakpoint\nCREATE INDEX `idx_pr_review_comments_pr` ON `pr_review_comments` (`repo_id`,`pr_number`);",
     "0022_chilly_gorgon":
       "CREATE TABLE `workflow_states` (\n\t`id` text PRIMARY KEY NOT NULL,\n\t`team_id` text,\n\t`name` text,\n\t`type` text,\n\t`position` real,\n\t`color` text,\n\t`archived_at` integer,\n\t`updated_at` integer\n);\n--> statement-breakpoint\nCREATE INDEX `idx_workflow_states_team` ON `workflow_states` (`team_id`);--> statement-breakpoint\nALTER TABLE `issues` ADD `state_type` text;--> statement-breakpoint\nALTER TABLE `issues` ADD `state_position` real;",
+    "0023_ambiguous_micromax":
+      "CREATE TABLE `push_subscriptions` (\n\t`endpoint` text PRIMARY KEY NOT NULL,\n\t`member_id` text NOT NULL,\n\t`p256dh` text NOT NULL,\n\t`auth` text NOT NULL,\n\t`created_at` integer,\n\t`last_used_at` integer\n);\n--> statement-breakpoint\nCREATE INDEX `idx_push_subscriptions_member` ON `push_subscriptions` (`member_id`);",
+    "0024_long_spencer_smythe":
+      "CREATE TABLE `team_workflow_mapping` (\n\t`team_id` text NOT NULL,\n\t`slot` text NOT NULL,\n\t`linear_state_id` text NOT NULL,\n\t`linear_state_name` text,\n\t`linear_state_type` text,\n\t`workflow_rev` integer,\n\t`updated_at` integer,\n\t`removed_at` integer,\n\tPRIMARY KEY(`team_id`, `slot`)\n);\n",
   },
 } as const;

package/src/mirror.ts

@@ -318,6 +318,51 @@ export const cycles = sqliteTable("cycles", {
 // (the prerequisite CTC-277's kanban board blocks on). Small, workspace-wide set — full sweep each
 // pass, same discipline as `labels`/`cycles`. No `removed_at`: Linear ARCHIVES a workflow state rather
 // than deleting it (`archived_at`), same convention `issues.archived_at` already uses.
+/**
+ * CTC-624 — the tenant's per-team workflow DECISION, replicated to hosts and the browser.
+ *
+ * ⭐ THIS IS THE ONE MIRROR TABLE WHOSE AUTHORITY IS NOT A PROVIDER. Every other table here is a
+ * projection of something Linear or GitHub owns; this is a projection of the **D1 registry**
+ * (`team_workflow_mapping`), which is where the tenant's choice actually lives. It rides this plane
+ * because the plane is how anything reaches a host at all, and ADR-0033 records why that does not
+ * re-open ADR-0028: the states themselves stay a mirrored Linear fact (`workflow_states`, below),
+ * while "which state means dispatchable" is a decision Linear has no field for.
+ *
+ * ⛔ `linear_state_name` / `linear_state_type` ARE DISPLAY SNAPSHOTS AND MUST NEVER BE JOINED ON.
+ * CTC-403: a Linear-to-Linear import preserved every human identifier and re-minted ~248 state UUIDs,
+ * so every cache still MATCHED by name while pointing at nothing. `linear_state_id` is the authority;
+ * a consumer resolving a slot joins THAT against `workflow_states` and finds the row absent when the
+ * workspace has been re-minted. That absence is the alarm, and it only works because the join key is
+ * the id.
+ *
+ * ⭐ `workflow_rev` RIDES EVERY ROW, and that is what makes the receipt possible. A host reads the max
+ * `workflow_rev` present in its own replica and echoes it on `/connect` (CTC-628) — read at RUNTIME
+ * FROM THE REPLICA, never from a config file, the same LOADED-not-LOCKED discipline
+ * `loadedSchemaIdentity` enforces for the migration bundle. Without the column on the row there is
+ * nothing for the host to read, and "we pushed it" would again be unfalsifiable.
+ *
+ * PK is `(team_id, slot)` — no `account_id`, because a Mirror DO **is** one account (same convention
+ * as every table here). Soft-deleted via `removed_at` so clearing a slot propagates as a change rather
+ * than as a row that silently stops being mentioned.
+ */
+export const team_workflow_mapping = sqliteTable(
+  "team_workflow_mapping",
+  {
+    team_id: text("team_id").notNull(),
+    /** One of the eleven Catalyst slots; the five load-bearing ones gate the fleet. */
+    slot: text("slot").notNull(),
+    /** THE AUTHORITY — joined against workflow_states.id by every consumer. */
+    linear_state_id: text("linear_state_id").notNull(),
+    linear_state_name: text("linear_state_name"),
+    linear_state_type: text("linear_state_type"),
+    /** The ACCOUNT-wide revision this row was written at. The scalar a host echoes back. */
+    workflow_rev: integer("workflow_rev"),
+    updated_at: integer("updated_at"),
+    removed_at: integer("removed_at"),
+  },
+  (t) => [primaryKey({ columns: [t.team_id, t.slot] })],
+);
+
 export const workflow_states = sqliteTable(
   "workflow_states",
   {
@@ -851,3 +896,25 @@ export const pr_ancillary_backfill = sqliteTable(
   },
   (t) => [primaryKey({ columns: [t.repo_id, t.pr_number] })],
 );
+
+// CTC-619 — a member's Web Push subscription (one browser/device). PK is the subscription `endpoint`
+// itself — a push endpoint URL is unique per browser install by construction, so keying on it is what
+// makes "a duplicate subscribe for the same endpoint does not create a second row" (the ticket's own
+// AC) a plain upsert, no synthetic id needed. `member_id` is the Linear user id (FK-shaped to
+// users.id, same as issues.assignee_id) — the ingest trigger's own correlation key. HARD delete on
+// unsubscribe (no removed_at): a stale/revoked push subscription has no historical value, matching
+// `users`' own "HARD-UPSERT, no soft delete" precedent for similarly overwrite-in-place data.
+export const push_subscriptions = sqliteTable(
+  "push_subscriptions",
+  {
+    endpoint: text("endpoint").primaryKey(),
+    member_id: text("member_id").notNull(),
+    p256dh: text("p256dh").notNull(),
+    auth: text("auth").notNull(),
+    created_at: integer("created_at"),
+    last_used_at: integer("last_used_at"),
+  },
+  // The ingest trigger's own read pattern: "every subscription for this member" (member_id, NOT the
+  // PK), keyed off issues.assignee_id — the same shape idx_workflow_states_team indexes on team_id.
+  (t) => [index("idx_push_subscriptions_member").on(t.member_id)],
+);