@catalyst-cloud/schema 0.1.1 → 0.1.3

package/{dist/mirror.js → src/mirror.ts}

@@ -15,14 +15,22 @@
 //   • `relations` join on issues.identifier (issue_identifier), NOT issues.id.
 //   • `check_runs` join a PR by head_sha, NOT PR number.
 //   • PR mergeable / mergeable_state are nullable until a reconcile resolves them.
+
 import { sqliteTable, text, integer, real, primaryKey, index } from "drizzle-orm/sqlite-core";
+
 // ── Linear ───────────────────────────────────────────────────────────────────────────────────────
-export const issues = sqliteTable("issues", {
+
+export const issues = sqliteTable(
+  "issues",
+  {
     id: text("id").primaryKey(),
     identifier: text("identifier"),
     title: text("title"),
     description: text("description"),
     state: text("state"),
+    // CTC-148: the workflow state id behind the `state` NAME — lets a consumer key on state without
+    // string-matching the renameable name.
+    state_id: text("state_id"),
     assignee: text("assignee"),
     // CTC-USERS: the assignee's user id (FK → users.id), so the row JOINs to a name + avatar. The
     // legacy `assignee` name string is KEPT for back-compat (the SSE list row still carries it).
@@ -32,6 +40,10 @@ export const issues = sqliteTable("issues", {
     project_id: text("project_id"),
     cycle_id: text("cycle_id"),
     team_id: text("team_id"),
+    // CTC-148: denormalized team key + name (off the issue's `team` ref) so a row labels its team
+    // ("ENG / Engineering") without a teams lookup. team_id is KEPT.
+    team_key: text("team_key"),
+    team_name: text("team_name"),
     delegate_id: text("delegate_id"),
     delegate_name: text("delegate_name"),
     bot_actor_name: text("bot_actor_name"),
@@ -57,7 +69,8 @@ export const issues = sqliteTable("issues", {
     archived_at: integer("archived_at"),
     removed_at: integer("removed_at"),
     raw: text("raw"),
-}, (t) => [
+  },
+  (t) => [
     index("idx_issues_team").on(t.team_id),
     // CTC-59: the list query — `WHERE removed_at IS NULL ORDER BY updated_at DESC` (buildIssuesView).
     // The composite lets SQLite seek the live rows then walk updated_at in order (no temp b-tree).
@@ -68,14 +81,17 @@ export const issues = sqliteTable("issues", {
     // Drizzle SSOT ONLY (NOT schema.sql) — migrate.ts swallows a duplicate CREATE INDEX on replay
     // (CTC-59), so the generated `CREATE INDEX` is replay-safe; schema.sql would break the adoption test.
     index("idx_issues_sort_order").on(t.sort_order),
-]);
+  ],
+);
+
 export const labels = sqliteTable("labels", {
-    id: text("id").primaryKey(),
-    name: text("name"),
-    color: text("color"),
-    updated_at: integer("updated_at"),
-    removed_at: integer("removed_at"),
+  id: text("id").primaryKey(),
+  name: text("name"),
+  color: text("color"),
+  updated_at: integer("updated_at"),
+  removed_at: integer("removed_at"),
 });
+
 // Teammate identities (CTC-USERS): resolves issue assignees + delegate AGENTS (and comment/PR
 // authors/reviewers) to a name + avatar so the UI never renders a gray "Unknown" chip. AGENT
 // identities are first-class: `type` is human | agent | bot | app. Populated three ways — a ROSTER
@@ -86,27 +102,38 @@ export const labels = sqliteTable("labels", {
 // in place, never tombstoned (an avatar/name that goes missing just stops being referenced). `id` is
 // the source-native id: Linear's user node id, the bot actor id, or a `github:<login>` synthetic id.
 export const users = sqliteTable("users", {
-    id: text("id").primaryKey(),
-    name: text("name"),
-    display_name: text("display_name"),
-    avatar_url: text("avatar_url"),
-    type: text("type"), // human | agent | bot | app
-    source: text("source"), // linear | github
-    updated_at: integer("updated_at"),
+  id: text("id").primaryKey(),
+  name: text("name"),
+  display_name: text("display_name"),
+  avatar_url: text("avatar_url"),
+  type: text("type"), // human | agent | bot | app
+  source: text("source"), // linear | github
+  updated_at: integer("updated_at"),
 });
-export const issue_labels = sqliteTable("issue_labels", {
+
+export const issue_labels = sqliteTable(
+  "issue_labels",
+  {
     issue_id: text("issue_id").notNull(),
     label_id: text("label_id").notNull(),
-}, (t) => [primaryKey({ columns: [t.issue_id, t.label_id] })]);
+  },
+  (t) => [primaryKey({ columns: [t.issue_id, t.label_id] })],
+);
+
 // FULL-poll-and-diff every reconcile pass (Linear fires NO issueRelations webhooks). Delete-absent is
 // load-bearing — and there is intentionally NO removed_at: a stale edge is HARD-deleted, never soft.
-export const relations = sqliteTable("relations", {
+export const relations = sqliteTable(
+  "relations",
+  {
     id: text("id").primaryKey(),
     type: text("type"), // blocks | duplicate | related
     issue_identifier: text("issue_identifier"),
     related_identifier: text("related_identifier"),
     updated_at: integer("updated_at"),
-}, (t) => [index("idx_relations_issue").on(t.issue_identifier)]);
+  },
+  (t) => [index("idx_relations_issue").on(t.issue_identifier)],
+);
+
 // Linear IssueHistory events (CTC-14) — the per-issue change timeline. Captured INLINE on the issues
 // delta sweep (a nested history(last:100) connection), NOT a separate leg and NOT a webhook path. Each
 // node is IMMUTABLE with a stable `id`; HARD upsert keyed on `id` (NO removed_at — a history row never
@@ -115,7 +142,9 @@ export const relations = sqliteTable("relations", {
 // name — no states table). from_due_date/to_due_date are TimelessDate "YYYY-MM-DD" stored AS-IS as
 // TEXT (the trap), never a timestamp. added_label_ids/removed_label_ids are JSON array strings; the
 // boolean columns are the mirror's 0/1 ints. raw is the full node JSON (full fidelity / forward-compat).
-export const issue_history = sqliteTable("issue_history", {
+export const issue_history = sqliteTable(
+  "issue_history",
+  {
     id: text("id").primaryKey(),
     issue_id: text("issue_id").notNull(), // FK → issues.id
     actor_id: text("actor_id"), // FK → users.id; nullable (system events have no actor)
@@ -149,67 +178,79 @@ export const issue_history = sqliteTable("issue_history", {
     auto_closed: integer("auto_closed"), // 0/1
     trashed: integer("trashed"), // 0/1
     raw: text("raw"), // JSON.stringify(node) — full fidelity / forward-compat (like issues.raw)
-}, 
-// The timeline index lives in the Drizzle SSOT ONLY (NOT schema.sql) — migrate.ts makes the generated
-// CREATE INDEX replay-safe (same as the issues read-path indexes); putting it in schema.sql would
-// break the adoption test.
-(t) => [index("idx_issue_history_issue_created").on(t.issue_id, t.created_at)]);
+  },
+  // The timeline index lives in the Drizzle SSOT ONLY (NOT schema.sql) — migrate.ts makes the generated
+  // CREATE INDEX replay-safe (same as the issues read-path indexes); putting it in schema.sql would
+  // break the adoption test.
+  (t) => [index("idx_issue_history_issue_created").on(t.issue_id, t.created_at)],
+);
+
 // CTC-HIERARCHY enriches the project row with the lead (FK → users.id), description, lifecycle dates,
 // progress, health, and presentation (icon/color). `target_date` / `start_date` are Linear
 // TimelessDates ("YYYY-MM-DD") — stored AS-IS as TEXT, NEVER through isoToMs (the same trap as
 // issues.due_date). `progress` is a Float (0..1).
 export const projects = sqliteTable("projects", {
-    id: text("id").primaryKey(),
-    name: text("name"),
-    state: text("state"),
-    description: text("description"),
-    lead_id: text("lead_id"), // FK → users.id (CTC-HIERARCHY); upserted from the project lead.
-    target_date: text("target_date"), // TimelessDate "YYYY-MM-DD" — TEXT AS-IS (the trap), not a ts.
-    start_date: text("start_date"), // TimelessDate "YYYY-MM-DD" — TEXT AS-IS (the trap), not a ts.
-    progress: real("progress"),
-    health: text("health"), // onTrack | atRisk | offTrack (null until a project update reports it).
-    icon: text("icon"),
-    color: text("color"),
-    updated_at: integer("updated_at"),
-    removed_at: integer("removed_at"),
+  id: text("id").primaryKey(),
+  name: text("name"),
+  state: text("state"),
+  description: text("description"),
+  lead_id: text("lead_id"), // FK → users.id (CTC-HIERARCHY); upserted from the project lead.
+  target_date: text("target_date"), // TimelessDate "YYYY-MM-DD" — TEXT AS-IS (the trap), not a ts.
+  start_date: text("start_date"), // TimelessDate "YYYY-MM-DD" — TEXT AS-IS (the trap), not a ts.
+  progress: real("progress"),
+  health: text("health"), // onTrack | atRisk | offTrack (null until a project update reports it).
+  icon: text("icon"),
+  color: text("color"),
+  updated_at: integer("updated_at"),
+  removed_at: integer("removed_at"),
 });
+
 // CTC-HIERARCHY enriches the cycle row with its display name + progress + current scope/issue counts.
 // Linear exposes scope/issue counts only as weekly history arrays (completedScopeHistory etc.); we
 // store the CURRENT value (the last array element) as a scalar — not the whole history.
 export const cycles = sqliteTable("cycles", {
-    id: text("id").primaryKey(),
-    number: integer("number"),
-    name: text("name"),
-    progress: real("progress"),
-    completed_scope: real("completed_scope"), // last(completedScopeHistory) — current completed points.
-    scope: real("scope"), // last(scopeHistory) — current total scope points.
-    completed_issue_count: integer("completed_issue_count"), // last(completedIssueCountHistory).
-    issue_count: integer("issue_count"), // last(issueCountHistory).
-    starts_at: integer("starts_at"),
-    ends_at: integer("ends_at"),
-    updated_at: integer("updated_at"),
+  id: text("id").primaryKey(),
+  number: integer("number"),
+  name: text("name"),
+  progress: real("progress"),
+  completed_scope: real("completed_scope"), // last(completedScopeHistory) — current completed points.
+  scope: real("scope"), // last(scopeHistory) — current total scope points.
+  completed_issue_count: integer("completed_issue_count"), // last(completedIssueCountHistory).
+  issue_count: integer("issue_count"), // last(issueCountHistory).
+  starts_at: integer("starts_at"),
+  ends_at: integer("ends_at"),
+  updated_at: integer("updated_at"),
 });
+
 // Linear initiatives (CTC-HIERARCHY) — the top of the HIERARCHY (initiative → project → cycle →
 // issue). PK `id` (Linear node id). `status` is the InitiativeStatus enum string; `target_date` is a
 // TimelessDate ("YYYY-MM-DD") stored AS-IS as TEXT (the trap). `owner_id` is the FK → users.id.
 // HARD upsert — NO removed_at (a vanished initiative just stops being referenced by the join table).
 export const initiatives = sqliteTable("initiatives", {
-    id: text("id").primaryKey(),
-    name: text("name"),
-    description: text("description"),
-    status: text("status"),
-    target_date: text("target_date"), // TimelessDate "YYYY-MM-DD" — TEXT AS-IS (the trap), not a ts.
-    owner_id: text("owner_id"), // FK → users.id (CTC-HIERARCHY); upserted from the initiative owner.
-    updated_at: integer("updated_at"),
+  id: text("id").primaryKey(),
+  name: text("name"),
+  description: text("description"),
+  status: text("status"),
+  target_date: text("target_date"), // TimelessDate "YYYY-MM-DD" — TEXT AS-IS (the trap), not a ts.
+  owner_id: text("owner_id"), // FK → users.id (CTC-HIERARCHY); upserted from the initiative owner.
+  updated_at: integer("updated_at"),
 });
+
 // project↔initiative join (CTC-HIERARCHY) — Linear models this as many:many (a project belongs to
 // many initiatives), so it's an edge table modeled on issue_labels: composite PK, no updated_at, full
 // poll-and-diff per project leg in the reconcile (Linear fires no membership webhook for it).
-export const project_initiatives = sqliteTable("project_initiatives", {
+export const project_initiatives = sqliteTable(
+  "project_initiatives",
+  {
     project_id: text("project_id").notNull(),
     initiative_id: text("initiative_id").notNull(),
-}, (t) => [primaryKey({ columns: [t.project_id, t.initiative_id] })]);
-export const comments = sqliteTable("comments", {
+  },
+  (t) => [primaryKey({ columns: [t.project_id, t.initiative_id] })],
+);
+
+export const comments = sqliteTable(
+  "comments",
+  {
     id: text("id").primaryKey(),
     issue_id: text("issue_id"),
     body: text("body"),
@@ -222,12 +263,17 @@ export const comments = sqliteTable("comments", {
     created_at: integer("created_at"),
     updated_at: integer("updated_at"),
     removed_at: integer("removed_at"),
-}, 
-// CTC-59: the detail comments fetch — `WHERE issue_id = ? AND removed_at IS NULL ORDER BY updated_at`.
-// Composite covers the filter AND the sort, so SQLite seeks instead of building a temp b-tree.
-(t) => [index("idx_comments_issue").on(t.issue_id, t.removed_at, t.updated_at)]);
+  },
+  // CTC-59: the detail comments fetch — `WHERE issue_id = ? AND removed_at IS NULL ORDER BY updated_at`.
+  // Composite covers the filter AND the sort, so SQLite seeks instead of building a temp b-tree.
+  (t) => [index("idx_comments_issue").on(t.issue_id, t.removed_at, t.updated_at)],
+);
+
 // ── GitHub ───────────────────────────────────────────────────────────────────────────────────────
-export const pull_requests = sqliteTable("pull_requests", {
+
+export const pull_requests = sqliteTable(
+  "pull_requests",
+  {
     repo_id: text("repo_id").notNull(),
     number: integer("number").notNull(),
     node_id: text("node_id"),
@@ -254,12 +300,17 @@ export const pull_requests = sqliteTable("pull_requests", {
     milestone_title: text("milestone_title"),
     updated_at: integer("updated_at"),
     synced_at: integer("synced_at"),
-}, (t) => [
+  },
+  (t) => [
     primaryKey({ columns: [t.repo_id, t.number] }),
     // CTC-59: the pulls list — `ORDER BY updated_at DESC` (buildPullsView).
     index("idx_pulls_updated").on(t.updated_at),
-]);
-export const check_runs = sqliteTable("check_runs", {
+  ],
+);
+
+export const check_runs = sqliteTable(
+  "check_runs",
+  {
     repo_id: text("repo_id").notNull(),
     check_run_id: text("check_run_id").primaryKey(),
     head_sha: text("head_sha"),
@@ -268,41 +319,57 @@ export const check_runs = sqliteTable("check_runs", {
     conclusion: text("conclusion"),
     check_suite_id: text("check_suite_id"),
     updated_at: integer("updated_at"),
-}, (t) => [index("idx_check_runs_sha").on(t.head_sha)]);
-export const commit_statuses = sqliteTable("commit_statuses", {
+  },
+  (t) => [index("idx_check_runs_sha").on(t.head_sha)],
+);
+
+export const commit_statuses = sqliteTable(
+  "commit_statuses",
+  {
     repo_id: text("repo_id").notNull(),
     sha: text("sha").notNull(),
     context: text("context").notNull(),
     state: text("state"),
     target_url: text("target_url"),
     updated_at: integer("updated_at"),
-}, (t) => [primaryKey({ columns: [t.repo_id, t.sha, t.context] })]);
+  },
+  (t) => [primaryKey({ columns: [t.repo_id, t.sha, t.context] })],
+);
+
 export const reviews = sqliteTable("reviews", {
-    repo_id: text("repo_id").notNull(),
-    pr_number: integer("pr_number").notNull(),
-    review_id: text("review_id").primaryKey(),
-    user_id: text("user_id"),
-    state: text("state"),
-    submitted_at: integer("submitted_at"),
+  repo_id: text("repo_id").notNull(),
+  pr_number: integer("pr_number").notNull(),
+  review_id: text("review_id").primaryKey(),
+  user_id: text("user_id"),
+  state: text("state"),
+  submitted_at: integer("submitted_at"),
 });
+
 // ── Mirror infra (not domain entities — never ride the change-feed) ─────────────────────────────────
+
 export const processed_events = sqliteTable("processed_events", {
-    delivery_id: text("delivery_id").primaryKey(),
-    source: text("source"),
-    event_type: text("event_type"),
-    received_at: integer("received_at"),
+  delivery_id: text("delivery_id").primaryKey(),
+  source: text("source"),
+  event_type: text("event_type"),
+  received_at: integer("received_at"),
 });
+
 export const change_log = sqliteTable("change_log", {
-    seq: integer("seq").primaryKey({ autoIncrement: true }),
-    entity: text("entity"),
-    entity_id: text("entity_id"),
-    op: text("op"), // upsert | delete
-    payload: text("payload"),
-    ts: integer("ts"),
+  seq: integer("seq").primaryKey({ autoIncrement: true }),
+  entity: text("entity"),
+  entity_id: text("entity_id"),
+  op: text("op"), // upsert | delete
+  payload: text("payload"),
+  ts: integer("ts"),
 });
-export const sync_cursors = sqliteTable("sync_cursors", {
+
+export const sync_cursors = sqliteTable(
+  "sync_cursors",
+  {
     source: text("source").notNull(),
     entity: text("entity").notNull(),
     cursor: text("cursor"),
     last_run_at: integer("last_run_at"),
-}, (t) => [primaryKey({ columns: [t.source, t.entity] })]);
+  },
+  (t) => [primaryKey({ columns: [t.source, t.entity] })],
+);