@bongos/core 1.19.1056 → 1.19.1058

package/modules/lifecycle/page-tweak-reads.js

@@ -0,0 +1,87 @@
+// modules/lifecycle/page-tweak-reads.js — the two ledger reads Tweak Mode's
+// status, changelog, drift and tally are derived from (task 1004316 / BV2.TW05,
+// ADR 0341 D7, D8, D10). Read-only; no state transition lives here.
+//
+// On the `lifecycle` port because tasks and claims are this module's tables and
+// copy-desk may only cross the wall through a port (ADR 0083, ADR 0093 §2). The
+// derivation itself is copy-desk's (modules/copy-desk/page-status.js); these
+// return the rows it reads, column for column, with no projection in between,
+// so a field added here reaches the derivation without a second mapper to
+// forget.
+
+'use strict';
+
+const api = require('../../src/module-api');
+
+// Every page-tweak task, oldest first, with what the round state (D7) and the
+// changelog (D8) need beside the task itself:
+//
+//   grade_passed      the task's grade (task_grades holds one row per task, the
+//                     latest). A completed round with a passed grade is waiting
+//                     for the artist; with a failed one it is still applying.
+//   holder_*          the ACTIVE claim, if any. holder_worktree is true for a CLI
+//                     claim (a worktree: the applier) and false for a web claim
+//                     (bind_session=false, no worktree: the artist writing).
+//   artist_*          the round's artist, the payee rule of D10: the builder of
+//                     the latest WEB claim on the task, which is the one the
+//                     submit released. Never a field in the description, which
+//                     the task's editors could change.
+//
+// THE QUERY PLAN, since this read backs all three page routes:
+//   * `t.source = 'page-tweak'` is served by idx_tasks_source_ref, which leads
+//     on (source) (migrations/core_240_artist_gate_indexes.sql), so the scan is
+//     bounded to the page-tweak rows, not the whole task table.
+//   * the active claim is a plain join: uniq_active_claim_per_task allows at
+//     most one row per task, and its partial index serves it.
+//   * the latest web claim is ONE pass over claims (the `web` CTE, DISTINCT ON
+//     per task), joined once, rather than a correlated subquery per task:
+//     claims has no full index on task_id, so a per-row LATERAL would scan it
+//     once per round.
+async function listPageTweakTasks() {
+  const { rows } = await api.pool.query(
+    `WITH pt AS (
+       SELECT t.id FROM tasks t WHERE t.source = 'page-tweak'
+     ), web AS (
+       SELECT DISTINCT ON (c.task_id) c.task_id, c.builder_id
+         FROM claims c JOIN pt ON pt.id = c.task_id
+        WHERE c.worktree_name IS NULL AND c.creator_session_id IS NULL
+        ORDER BY c.task_id, c.claimed_at DESC, c.id DESC
+     )
+     SELECT t.id, t.status, t.title, t.description, t.source_ref, t.touches,
+            t.shipped_at, t.created_at, t.updated_at,
+            g.passed AS grade_passed,
+            ac.builder_id AS holder_id, hb.github_login AS holder_login,
+            (ac.worktree_name IS NOT NULL) AS holder_worktree,
+            wc.builder_id AS artist_id, ab.github_login AS artist_login
+       FROM tasks t
+       LEFT JOIN task_grades g ON g.task_id = t.id
+       LEFT JOIN claims ac ON ac.task_id = t.id AND ac.released_at IS NULL
+       LEFT JOIN builders hb ON hb.id = ac.builder_id
+       LEFT JOIN web wc ON wc.task_id = t.id
+       LEFT JOIN builders ab ON ab.id = wc.builder_id
+      WHERE t.source = 'page-tweak'
+      ORDER BY t.id ASC`
+  );
+  return rows;
+}
+
+// The ships that changed a page since its last round (D8): shipped tasks after
+// `since` whose touches meet the page's files. The array-overlap operator is the
+// same one the parallel-safety check uses, served by idx_tasks_touches_gin.
+async function shippedTasksTouchingSince({ files, since, limit = 50 } = {}) {
+  const list = Array.isArray(files) ? files.map(String).filter(Boolean) : [];
+  if (!list.length || !since) return [];
+  const { rows } = await api.pool.query(
+    `SELECT t.id, t.title, t.shipped_at
+       FROM tasks t
+      WHERE t.status = 'shipped'
+        AND t.shipped_at > $2::timestamptz
+        AND t.touches && $1::text[]
+      ORDER BY t.shipped_at ASC, t.id ASC
+      LIMIT $3`,
+    [list, since, Math.max(1, Math.min(200, Number(limit) || 50))]
+  );
+  return rows;
+}
+
+module.exports = { listPageTweakTasks, shippedTasksTouchingSince };

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.1056",
+  "version": "1.19.1058",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.19.1056",
+      "version": "1.19.1058",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
         "express": "^4.21.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.1056",
+  "version": "1.19.1058",
   "description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
   "license": "AGPL-3.0-or-later",
   "main": "src/platform-server.js",

package/release-notes.json

@@ -7637,5 +7637,17 @@
       "id": "1004332",
       "text": "Tweak Mode now has one written plan that every later step builds on. It says how a page is taken, where the artist's words rest while they write, how a page shows as tweaked or changed since, how the Word download and upload w"
     }
+  ],
+  "1.19.1057": [
+    {
+      "id": "1004315",
+      "text": "Every page of the project now has a written reading: all the words it actually shows, in order, grouped under its headings. Each line says where the words live. Some come from a known place in the code, some are shared by ever"
+    }
+  ],
+  "1.19.1058": [
+    {
+      "id": "1004316",
+      "text": "Every page now has a status that is worked out from the project's own record, with nothing new to keep in sync. For each page you can see whether it is untweaked or text tweaked and how many times, a history of each round (who"
+    }
   ]
 }