@cat-factory/worker 0.144.0 → 0.145.0

package/dist/infrastructure/repositories/D1TutorialProgressRepository.js

@@ -0,0 +1,66 @@
+/**
+ * Parse a stored JSON id array LENIENTLY: anything that is not an array of strings reads as
+ * empty.
+ *
+ * The row is composed by a browser, so a value that fails to parse means a client or a migration
+ * wrote something unexpected. Throwing here would take down the workspace snapshot this is read
+ * as part of, over a tutorial-progress list — the correct degradation is to forget the
+ * walkthroughs, which costs a re-offer, not the board.
+ */
+function parseIds(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) ? parsed.filter((id) => typeof id === 'string') : [];
+    }
+    catch {
+        // silent-catch-ok: a malformed list degrades to "no tours remembered"; the fallback IS the
+        // report, and there is nothing an operator would do about one row of client-authored JSON.
+        return [];
+    }
+}
+/**
+ * The stored decision, narrowed against the closed vocabulary. An unrecognised value reads as
+ * "never answered", so a retired member cannot be spliced into the SPA's state as a decision it
+ * has no branch for.
+ */
+function parseDecision(raw) {
+    return raw === 'accepted' || raw === 'declined' ? raw : null;
+}
+function rowToProgress(row) {
+    return {
+        decision: parseDecision(row.decision),
+        completedTourIds: parseIds(row.completed_tour_ids),
+        nudgedTourIds: parseIds(row.nudged_tour_ids),
+    };
+}
+/** D1-backed per-user tutorial progress (migration 0080). */
+export class D1TutorialProgressRepository {
+    db;
+    constructor({ db }) {
+        this.db = db;
+    }
+    async get(userId) {
+        const row = await this.db
+            .prepare('SELECT * FROM tutorial_progress WHERE user_id = ?')
+            .bind(userId)
+            .first();
+        return row ? rowToProgress(row) : null;
+    }
+    async upsert(userId, progress) {
+        await this.db
+            .prepare(`INSERT INTO tutorial_progress
+           (user_id, decision, completed_tour_ids, nudged_tour_ids, updated_at)
+         VALUES (?, ?, ?, ?, ?)
+         ON CONFLICT(user_id) DO UPDATE SET
+           decision = excluded.decision,
+           completed_tour_ids = excluded.completed_tour_ids,
+           nudged_tour_ids = excluded.nudged_tour_ids,
+           updated_at = excluded.updated_at`)
+            .bind(userId, progress.decision, JSON.stringify(progress.completedTourIds), JSON.stringify(progress.nudgedTourIds), Date.now())
+            .run();
+    }
+    async remove(userId) {
+        await this.db.prepare('DELETE FROM tutorial_progress WHERE user_id = ?').bind(userId).run();
+    }
+}
+//# sourceMappingURL=D1TutorialProgressRepository.js.map

package/dist/infrastructure/repositories/D1TutorialProgressRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"D1TutorialProgressRepository.js","sourceRoot":"","sources":["../../../src/infrastructure/repositories/D1TutorialProgressRepository.ts"],"names":[],"mappings":"AAYA;;;;;;;;GAQG;AACH,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACvC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACjG,CAAC;IAAC,MAAM,CAAC;QACP,2FAA2F;QAC3F,2FAA2F;QAC3F,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,GAAkB;IACvC,OAAO,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;AAC9D,CAAC;AAED,SAAS,aAAa,CAAC,GAAwB;IAC7C,OAAO;QACL,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC;QACrC,gBAAgB,EAAE,QAAQ,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAClD,aAAa,EAAE,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC;KAC7C,CAAA;AACH,CAAC;AAED,6DAA6D;AAC7D,MAAM,OAAO,4BAA4B;IACtB,EAAE,CAAY;IAE/B,YAAY,EAAE,EAAE,EAAsB;QACpC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAc;QACtB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,EAAE;aACtB,OAAO,CAAC,mDAAmD,CAAC;aAC5D,IAAI,CAAC,MAAM,CAAC;aACZ,KAAK,EAAuB,CAAA;QAC/B,OAAO,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACxC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,QAA0B;QACrD,MAAM,IAAI,CAAC,EAAE;aACV,OAAO,CACN;;;;;;;4CAOoC,CACrC;aACA,IAAI,CACH,MAAM,EACN,QAAQ,CAAC,QAAQ,EACjB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EACzC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,EACtC,IAAI,CAAC,GAAG,EAAE,CACX;aACA,GAAG,EAAE,CAAA;IACV,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc;QACzB,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,iDAAiD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAA;IAC7F,CAAC;CACF"}

package/migrations/0080_role_scoped_class_rules.sql

@@ -0,0 +1,16 @@
+-- Role-scoped merge policy on the merge preset.
+--
+-- `class_rules_by_role` is a JSON partial map from workspace role (`admin` | `member` | `viewer`)
+-- to that role's own per-change-class rule map — the same shape as `class_rules`, one tier in.
+-- Composition is narrow-only in the domain (`narrowMergeClassRule`), so a role entry can only
+-- make a class stricter than the base rules; it can never widen one.
+--
+-- `dry_run_roles` is a JSON array of the roles whose runs are forced into dry-run mode: the
+-- pipeline runs in full and opens its pull request, but nothing merges.
+--
+-- Both are NOT NULL with empty defaults, so every existing row resolves to exactly its previous
+-- behaviour — no role narrows anything, nobody is sandboxed. Mirrored on Node by the
+-- `class_rules_by_role` / `dry_run_roles` text columns on the Drizzle `merge_threshold_presets`
+-- table.
+ALTER TABLE merge_threshold_presets ADD COLUMN class_rules_by_role TEXT NOT NULL DEFAULT '{}';
+ALTER TABLE merge_threshold_presets ADD COLUMN dry_run_roles TEXT NOT NULL DEFAULT '[]';

package/migrations/0080_tutorial_progress.sql

@@ -0,0 +1,18 @@
+-- Per-user in-app tutorial progress. PK is the user id, like `user_settings` (migration 0042).
+--
+-- Mirrors the SPA's browser-persisted store so a person's walkthrough history follows THEM rather
+-- than a browser profile: without it a second machine re-asks the launch question and re-makes
+-- every contextual offer. Absence of a row is the "never touched the tutorial" state, which is
+-- also what "Reset progress" restores (the row is deleted, never rewritten with defaults).
+--
+-- The two id lists are stored as JSON arrays rather than a join table on purpose: they are
+-- grow-only sets of at most a few dozen opaque tour ids, always read and written whole, and
+-- nothing joins or aggregates over them. `decision` is NULL when never answered, which is a real
+-- state distinct from 'declined'.
+CREATE TABLE tutorial_progress (
+  user_id            TEXT    NOT NULL PRIMARY KEY,
+  decision           TEXT,
+  completed_tour_ids TEXT    NOT NULL DEFAULT '[]',
+  nudged_tour_ids    TEXT    NOT NULL DEFAULT '[]',
+  updated_at         INTEGER NOT NULL
+);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/worker",
-  "version": "0.144.0",
+  "version": "0.145.0",
   "description": "Reusable Cloudflare Worker library (Hono + D1) exposing the Agent Architecture Board core: the `createApp()` Hono factory, the default fetch/scheduled/queue handler, and the Durable Object + Workflow classes. Deployments (see deploy/backend) supply the wrangler.toml + config and re-export these.",
   "repository": {
     "type": "git",
@@ -42,22 +42,22 @@
     "pino": "^10.3.1",
     "valibot": "^1.4.2",
     "workers-ai-provider": "^4.0.0",
-    "@cat-factory/agents": "0.107.0",
-    "@cat-factory/caching": "0.14.0",
-    "@cat-factory/consensus": "0.14.0",
-    "@cat-factory/contracts": "0.222.0",
-    "@cat-factory/eks": "0.1.210",
-    "@cat-factory/gates": "0.8.56",
-    "@cat-factory/integrations": "0.121.2",
-    "@cat-factory/kernel": "0.224.0",
-    "@cat-factory/observability-langfuse": "0.9.53",
-    "@cat-factory/observability-otel": "0.7.1",
-    "@cat-factory/orchestration": "0.193.0",
-    "@cat-factory/provider-cloudflare": "0.7.362",
-    "@cat-factory/prompt-fragments": "0.15.47",
-    "@cat-factory/gitlab": "0.15.15",
-    "@cat-factory/spend": "0.13.12",
-    "@cat-factory/server": "0.205.0"
+    "@cat-factory/caching": "0.14.2",
+    "@cat-factory/consensus": "0.14.2",
+    "@cat-factory/contracts": "0.224.0",
+    "@cat-factory/eks": "0.1.212",
+    "@cat-factory/gates": "0.8.58",
+    "@cat-factory/gitlab": "0.15.17",
+    "@cat-factory/integrations": "0.122.1",
+    "@cat-factory/observability-otel": "0.8.0",
+    "@cat-factory/kernel": "0.226.0",
+    "@cat-factory/orchestration": "0.195.0",
+    "@cat-factory/prompt-fragments": "0.15.49",
+    "@cat-factory/provider-cloudflare": "0.7.364",
+    "@cat-factory/server": "0.207.0",
+    "@cat-factory/spend": "0.14.0",
+    "@cat-factory/observability-langfuse": "0.9.55",
+    "@cat-factory/agents": "0.108.0"
   },
   "devDependencies": {
     "@cloudflare/vitest-pool-workers": "^0.20.1",
@@ -65,7 +65,7 @@
     "typescript": "7.0.2",
     "vitest": "^4.1.10",
     "wrangler": "^4.118.0",
-    "@cat-factory/conformance": "0.21.1"
+    "@cat-factory/conformance": "0.22.0"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",