@catalyst-cloud/schema 0.1.14 → 0.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catalyst-cloud/schema",
-  "version": "0.1.14",
+  "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,
@@ -79,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,
@@ -143,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,

package/src/migrations.generated.ts

@@ -179,6 +179,13 @@ export const MIRROR_MIGRATIONS = {
         tag: "0023_ambiguous_micromax",
         breakpoints: true,
       },
+      {
+        idx: 24,
+        version: "6",
+        when: 1786984427741,
+        tag: "0024_long_spencer_smythe",
+        breakpoints: true,
+      },
     ],
   },
   migrations: {
@@ -228,5 +235,7 @@ export const MIRROR_MIGRATIONS = {
       "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",
   {