toolroll 0.9.41 → 0.9.43

package/dist/store.js

@@ -1,4 +1,5 @@
 import { chatSchema, chatTables } from "./contracts/chat-tables.js";
+import { parseStoreColumn, readStoreColumn, readStoreStringifiedList, readStoreTextList } from "./contracts/store-json.js";
 import { assessmentFromSavedEvidence, verificationEvidence } from "./verification-evidence.js";
 import { LEARNING_SCHEMA, queueLearning } from "./project-learning.js";
 import { SKILLS_SCHEMA } from "./project-skills.js";
@@ -353,6 +354,40 @@ CREATE TABLE IF NOT EXISTS telegram_flow_choice (
 );
 CREATE INDEX IF NOT EXISTS telegram_flow_choice_visit ON telegram_flow_choice (card, entry);
 `;
+/** An owner's lasting choice to approve plans and merges from their paired chat (chat-approval.ts), for all their
+ * projects (scope '*') or one (its path), with the limits they agreed to. Off unless a row says on; a project's own row
+ * outranks the all-projects one. `generation` is the account's at the change: a reset password ends it. */
+export const CHAT_APPROVAL_SCHEMA = `
+CREATE TABLE IF NOT EXISTS chat_approval_setting (
+  approver             TEXT NOT NULL,
+  scope                TEXT NOT NULL,
+  enabled              INTEGER NOT NULL CHECK (enabled IN (0,1)),
+  full_access          INTEGER NOT NULL DEFAULT 0 CHECK (full_access IN (0,1)),
+  attempt_cap_microusd INTEGER CHECK (attempt_cap_microusd IS NULL OR attempt_cap_microusd >= 0),
+  generation           INTEGER NOT NULL,
+  digest               TEXT NOT NULL,
+  updated_by           TEXT NOT NULL,
+  updated_at           TEXT NOT NULL,
+  PRIMARY KEY (approver, scope)
+);
+`;
+/** The second tap on a flow decision in Telegram (telegram-flow.ts): Approve arms Yes and Cancel, bound to the binding,
+ * chat, message and exact visit of the card; Yes decides it once. */
+export const TELEGRAM_FLOW_CONFIRM_SCHEMA = `
+CREATE TABLE IF NOT EXISTS telegram_flow_confirm (
+  token       TEXT PRIMARY KEY,
+  binding     INTEGER NOT NULL,
+  chat_id     TEXT NOT NULL,
+  message_id  TEXT NOT NULL,
+  card        INTEGER NOT NULL,
+  entry       INTEGER NOT NULL,
+  phase       TEXT NOT NULL CHECK (phase IN ('yes','cancel')),
+  created_at  TEXT NOT NULL,
+  expires_at  TEXT NOT NULL,
+  consumed_at TEXT
+);
+CREATE INDEX IF NOT EXISTS telegram_flow_confirm_visit ON telegram_flow_confirm (card, entry);
+`;
 export const CHAT_DECIDE_SCHEMA = `
 CREATE TABLE IF NOT EXISTS chat_decide_action (
   token       TEXT PRIMARY KEY,
@@ -504,10 +539,10 @@ const isCheckExitCode = (value) => value === null || (Number.isSafeInteger(value
 /** Read a stored suite list; a malformed optional summary reads as no suite detail. */
 export function checkSuitesOf(value) {
     try {
-        const parsed = JSON.parse(String(value ?? "[]"));
-        if (!Array.isArray(parsed))
+        const read = readStoreColumn("run_check.suites_json", value ?? "[]");
+        if (!read.ok)
             return [];
-        return parsed.filter((one) => {
+        return read.value.filter((one) => {
             if (one === null || typeof one !== "object")
                 return false;
             const row = one;
@@ -620,37 +655,22 @@ function readTeammateMemory(row) {
         createdBy: String(row["created_by"]), createdAt: String(row["created_at"]), updatedBy: String(row["updated_by"]), updatedAt: String(row["updated_at"]), usedAt: row["used_at"] === null ? null : String(row["used_at"]) };
 }
 function readTeammateSuggestion(row) {
-    const parsed = (key, fallback) => { try {
-        return JSON.parse(String(row[key]));
-    }
-    catch {
-        return fallback;
-    } };
-    return { id: Number(row["id"]), teammate: Number(row["teammate"]), tool: String(row["tool"]), action: String(row["action"]), rule: parsed("rule_json", { use: "ask" }), was: parsed("was_json", { use: "ask" }),
-        evidence: parsed("evidence_json", []), said: String(row["said"]), state: String(row["state"]),
+    const parsed = (column, key, fallback) => { const read = readStoreColumn(column, row[key]); return read.ok ? read.value : fallback; };
+    return { id: Number(row["id"]), teammate: Number(row["teammate"]), tool: String(row["tool"]), action: String(row["action"]), rule: parsed("teammate_suggestion.rule_json", "rule_json", { use: "ask" }), was: parsed("teammate_suggestion.was_json", "was_json", { use: "ask" }),
+        evidence: parsed("teammate_suggestion.evidence_json", "evidence_json", []), said: String(row["said"]), state: String(row["state"]),
         decidedBy: row["decided_by"] === null ? null : String(row["decided_by"]), decidedAt: row["decided_at"] === null ? null : String(row["decided_at"]), createdAt: String(row["created_at"]) };
 }
 function readTeammateCall(row) {
     const text = (key) => row[key] === null || row[key] === undefined ? null : String(row[key]);
-    let input = {};
-    try {
-        input = JSON.parse(String(row["input_json"]));
-    }
-    catch {
-        input = {};
-    }
+    const read = readStoreColumn("teammate_call.input_json", row["input_json"]);
+    const input = read.ok ? read.value : {};
     return { id: Number(row["id"]), teammate: Number(row["teammate"]), card: Number(row["card"]), entry: Number(row["entry"]), tool: String(row["tool"]), action: String(row["action"]), input,
         rule: String(row["rule"]), why: String(row["why"]), state: String(row["state"]), result: text("result"), decidedBy: text("decided_by"), decidedAt: text("decided_at"),
         createdAt: String(row["created_at"]), doneAt: text("done_at"), undoOf: row["undo_of"] === null || row["undo_of"] === undefined ? null : Number(row["undo_of"]), undoneBy: text("undone_by"), undoneAt: text("undone_at") };
 }
 function readTeammateGrant(row) {
-    const parsed = (key, fallback) => { try {
-        return JSON.parse(String(row[key]));
-    }
-    catch {
-        return fallback;
-    } };
-    return { teammate: Number(row["teammate"]), tool: String(row["tool"]), actions: parsed("actions_json", []), rules: parsed("rules_json", {}),
+    const parsed = (column, key, fallback) => { const read = readStoreColumn(column, row[key]); return read.ok ? read.value : fallback; };
+    return { teammate: Number(row["teammate"]), tool: String(row["tool"]), actions: parsed("teammate_tool.actions_json", "actions_json", []), rules: parsed("teammate_tool.rules_json", "rules_json", {}),
         listedAt: row["listed_at"] === null ? null : String(row["listed_at"]), updatedBy: String(row["updated_by"]), updatedAt: String(row["updated_at"]) };
 }
 function readTeammateRow(row) {
@@ -663,7 +683,7 @@ function readTeammateRow(row) {
 function readTeammateQuestion(row) {
     const text = (key) => row[key] === null || row[key] === undefined ? null : String(row[key]);
     return { id: Number(row["id"]), teammate: Number(row["teammate"]), card: Number(row["card"]), entry: Number(row["entry"]), question: String(row["question"]),
-        options: JSON.parse(String(row["options_json"])), askedOf: String(row["asked_of"]), state: String(row["state"]),
+        options: parseStoreColumn("teammate_question.options_json", row["options_json"]), askedOf: String(row["asked_of"]), state: String(row["state"]),
         choice: text("choice"), answer: text("answer"), answeredBy: text("answered_by"), answeredVia: text("answered_via"), answeredAt: text("answered_at"), createdAt: String(row["created_at"]),
         toolCall: row["tool_call"] === null || row["tool_call"] === undefined ? null : Number(row["tool_call"]),
         suggestion: row["suggestion"] === null || row["suggestion"] === undefined ? null : Number(row["suggestion"]) };
@@ -697,10 +717,11 @@ function readFlowCardRow(row) {
 function readFlowCardSource(value) {
     if (typeof value !== "string")
         return null;
+    const read = readStoreColumn("flow_card.source_json", value);
+    if (!read.ok)
+        return null;
     try {
-        const parsed = JSON.parse(value);
-        if (typeof parsed["label"] !== "string")
-            return null;
+        const parsed = read.value;
         const mail = parsed["mail"] !== null && typeof parsed["mail"] === "object" ? parsed["mail"] : null;
         const chat = parsed["chat"] !== null && typeof parsed["chat"] === "object" ? parsed["chat"] : null;
         return { kind: String(parsed["kind"] ?? ""), label: parsed["label"], url: typeof parsed["url"] === "string" ? parsed["url"] : null,
@@ -3977,6 +3998,9 @@ function initializeStore(db, file) {
     db.exec(MATE_ASK_SCHEMA);
     // Decisions in the chat app (no version bump: additive only): result, plan and merge buttons, and Request changes.
     db.exec(CHAT_DECIDE_SCHEMA);
+    // An owner's lasting chat-approval setting (no version bump: additive only; absent means off).
+    db.exec(CHAT_APPROVAL_SCHEMA);
+    db.exec(TELEGRAM_FLOW_CONFIRM_SCHEMA);
     // A flow's "Send to me" and "Person chooses" zones (no version bump: additive only).
     db.exec(FLOW_SEND_SCHEMA);
     db.exec(SPEND_SCHEMA);
@@ -6684,12 +6708,10 @@ function migrateToV24(db) {
         }
         else {
             let touches = [];
-            try {
-                touches = JSON.parse(row.touches);
-            }
-            catch {
-                touches = [];
-            }
+            const read = readStoreColumn("task_scope.touches", row.touches);
+            // Unlike the display reader, v24 passed every valid JSON value to digestOf, including non-arrays.
+            if (read.ok)
+                touches = read.value;
             const recomputed = digestOf({ goal: row.goal, outOfScope: row.outOfScope, touches, budgetMicrousd: row.budget }, resolved.profile);
             stampUnapproved.run(snapshot, recomputed, provenance, row.taskId);
         }
@@ -8812,7 +8834,7 @@ export class Store {
                 // (setup review): the approval is what was stale, and it is new.
                 const ref = this.db.prepare("SELECT id FROM task_ref WHERE backend = ? AND external_id = ?").get(BUILT_IN, taskId);
                 if (ref !== undefined) {
-                    if (basis === undefined)
+                    if (basis === undefined || basis.kind === "chat")
                         this.noteTaskAct(Number(ref["id"]), "approved", now);
                     this.db.prepare("DELETE FROM hold WHERE owner_kind = 'backoff' AND owner_id = ?").run(`stale:${Number(ref["id"])}`);
                     this.db
@@ -8828,7 +8850,9 @@ export class Store {
                             subject: "Scope approved",
                             body: basis === undefined
                                 ? `Approved by ${currentActor()?.lead === true ? "the lead" : lifecycleWords(by, 40)}. A connected worker can take it next.`
-                                : "Approved automatically under the operating mode. A connected worker can take it next.",
+                                : basis.kind === "chat"
+                                    ? `Approved by ${lifecycleWords(by, 40)} in chat. A connected worker can take it next.`
+                                    : "Approved automatically under the operating mode. A connected worker can take it next.",
                             link: chatControlHref("task", taskId),
                         }, now);
                     }
@@ -9086,7 +9110,7 @@ export class Store {
                 return { ok: true };
             let terms;
             try {
-                terms = JSON.parse(mode.termsJson);
+                terms = parseStoreColumn("operating_mode.terms_json", mode.termsJson);
             }
             catch {
                 return { ok: true };
@@ -9243,15 +9267,7 @@ export class Store {
         const row = this.db.prepare("SELECT * FROM approval_policy WHERE repo = ?").get(repo);
         if (row === undefined)
             return { ...NO_RULES, updatedBy: null, updatedAt: null };
-        let paths = [];
-        try {
-            const parsed = JSON.parse(String(row["protected_paths"]));
-            if (Array.isArray(parsed))
-                paths = parsed.filter((one) => typeof one === "string");
-        }
-        catch {
-            paths = [];
-        }
+        const paths = readStoreTextList("approval_policy.protected_paths", row["protected_paths"]);
         return { notRequester: Number(row["not_requester"]) === 1, protectProject: Number(row["protect_project"]) === 1, protectedPaths: paths, updatedBy: String(row["updated_by"]), updatedAt: String(row["updated_at"]) };
     }
     /** Change a project's rules; the ledger keeps before → after. */
@@ -9302,15 +9318,7 @@ export class Store {
             return { verdict: "seal", protectedWork: false };
         const repo = String(ref["repo"]);
         const rules = this.approvalRules(repo);
-        let touches = [];
-        try {
-            const parsed = JSON.parse(String(scope?.["touches"] ?? "[]"));
-            if (Array.isArray(parsed))
-                touches = parsed.map(String);
-        }
-        catch {
-            touches = [];
-        }
+        const touches = readStoreStringifiedList("task_scope.touches", scope?.["touches"] ?? "[]");
         const protectedWork = isProtectedWork(rules, touches);
         if (!rules.notRequester && !protectedWork)
             return { verdict: "seal", protectedWork: false };
@@ -12048,7 +12056,7 @@ export class Store {
                 let reviewAuto = false;
                 if (mode !== null && mode.digest === String(row["mode_digest"] ?? "")) {
                     try {
-                        reviewAuto = JSON.parse(mode.termsJson).reviewAuto === true;
+                        reviewAuto = parseStoreColumn("operating_mode.terms_json", mode.termsJson).reviewAuto === true;
                     }
                     catch {
                         reviewAuto = false;
@@ -13458,13 +13466,10 @@ export class Store {
         const row = this.db.prepare("SELECT entries_json FROM fallback_config WHERE scope = ? AND phase = 'build'").get(scope);
         if (row === undefined)
             return { ok: true, entries: [] };
-        let parsed;
-        try {
-            parsed = JSON.parse(String(row["entries_json"]));
-        }
-        catch {
+        const read = readStoreColumn("fallback_config.entries_json", row["entries_json"]);
+        if (!read.ok && read.malformed)
             return { ok: false, problem: `the fallback configuration for ${scope} is not valid JSON — set it again with \`config set fallback\`, or clear it` };
-        }
+        const parsed = read.ok ? read.value : null;
         if (!Array.isArray(parsed))
             return { ok: false, problem: `the fallback configuration for ${scope} is not a list of entries — set it again with \`config set fallback\`, or clear it` };
         // A PRESENT row carries one to three entries (atomic authority
@@ -13834,7 +13839,7 @@ export class Store {
             .filter(row => {
             if (assignedRunner !== null)
                 return String(row["runner"]) === assignedRunner;
-            const repos = readJsonArray(row["repos"]);
+            const repos = readStoreTextList("runner.repos", row["repos"]);
             return repo === null || repos.includes(repo);
         })
             .sort((a, b) => Number(alive(b)) - Number(alive(a)));
@@ -14004,7 +14009,7 @@ export class Store {
         if (open !== null) {
             let pinned = null;
             try {
-                const terms = JSON.parse(open.termsJson);
+                const terms = parseStoreColumn("attended_authorization.terms_json", open.termsJson);
                 pinned = profileFromJson(typeof terms.profileJson === "string" ? terms.profileJson : null);
             }
             catch {
@@ -14695,7 +14700,10 @@ export class Store {
                 .all(...admittedRepos);
             const optionsOf = (raw) => {
                 try {
-                    const parsed = JSON.parse(String(raw));
+                    const read = readStoreColumn("decision.options", raw);
+                    if (!read.ok)
+                        return [];
+                    const parsed = read.value;
                     return Array.isArray(parsed)
                         ? parsed.slice(0, 6).map(one => ({ id: String(one?.id ?? ""), label: String(one?.label ?? ""), reversible: one?.reversible === true }))
                         : [];
@@ -15856,7 +15864,7 @@ export class Store {
                 refuse(`the attended authorization ${live.id} was minted for ${live.runner} at generation ${live.runnerGeneration}, not ${named.generation}`);
             let pinned = null;
             try {
-                const terms = JSON.parse(live.termsJson);
+                const terms = parseStoreColumn("attended_authorization.terms_json", live.termsJson);
                 pinned = profileFromJson(typeof terms.profileJson === "string" ? terms.profileJson : null);
             }
             catch {
@@ -17421,7 +17429,7 @@ export class Store {
                 let quickMint = false;
                 if (mode !== null && mode.digest === input.basis.digest && mode.signedBy === input.approver) {
                     try {
-                        quickMint = JSON.parse(mode.termsJson).quickMint === true;
+                        quickMint = parseStoreColumn("operating_mode.terms_json", mode.termsJson).quickMint === true;
                     }
                     catch {
                         quickMint = false;
@@ -18544,6 +18552,7 @@ export class Store {
         const stamp = now.toISOString();
         this.db.prepare("UPDATE telegram_flow_action SET consumed_at = ? WHERE card = ? AND entry = ? AND consumed_at IS NULL").run(stamp, card, entry);
         this.db.prepare("UPDATE telegram_flow_prompt SET consumed_at = ? WHERE card = ? AND entry = ? AND consumed_at IS NULL").run(stamp, card, entry);
+        this.db.prepare("UPDATE telegram_flow_confirm SET consumed_at = ? WHERE card = ? AND entry = ? AND consumed_at IS NULL").run(stamp, card, entry);
     }
     recordTelegramFlowPrompt(prompt, now, hours = 24) {
         this.db.prepare("INSERT OR REPLACE INTO telegram_flow_prompt (chat_id, message_id, binding, card, entry, mode, created_at, expires_at, consumed_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, NULL)")
@@ -18808,7 +18817,7 @@ export class Store {
             if (mode !== null) {
                 let publication;
                 try {
-                    publication = JSON.parse(mode.termsJson).publication;
+                    publication = parseStoreColumn("operating_mode.terms_json", mode.termsJson).publication;
                 }
                 catch {
                     publication = undefined;
@@ -18938,7 +18947,7 @@ export class Store {
             if (basis === "mode") {
                 let publication;
                 try {
-                    publication = mode === null ? undefined : JSON.parse(mode.termsJson).publication;
+                    publication = mode === null ? undefined : parseStoreColumn("operating_mode.terms_json", mode.termsJson).publication;
                 }
                 catch {
                     publication = undefined;
@@ -18950,7 +18959,7 @@ export class Store {
             else if (basis === "grant" && mode !== null) {
                 let publication;
                 try {
-                    publication = JSON.parse(mode.termsJson).publication;
+                    publication = parseStoreColumn("operating_mode.terms_json", mode.termsJson).publication;
                 }
                 catch {
                     publication = undefined;
@@ -19486,7 +19495,7 @@ export class Store {
     teammateEvents(teammate, limit, since = null) {
         return this.db.prepare(`SELECT * FROM teammate_event WHERE teammate = ? ${since === null ? "" : "AND at >= ?"} ORDER BY id DESC LIMIT ?`).all(...(since === null ? [teammate, limit] : [teammate, since, limit])).map(row => ({
             id: Number(row["id"]), teammate: Number(row["teammate"]), card: row["card"] === null ? null : Number(row["card"]), entry: row["entry"] === null ? null : Number(row["entry"]),
-            kind: String(row["kind"]), said: String(row["said"]), detail: row["detail_json"] === null ? null : JSON.parse(String(row["detail_json"])),
+            kind: String(row["kind"]), said: String(row["said"]), detail: row["detail_json"] === null ? null : parseStoreColumn("teammate_event.detail_json", row["detail_json"]),
             by: row["by"] === null ? null : String(row["by"]), at: String(row["at"])
         }));
     }
@@ -19837,15 +19846,7 @@ export class Store {
     /** A card's discussion, oldest first. */
     flowComments(card) {
         return this.db.prepare("SELECT * FROM flow_comment WHERE card = ? ORDER BY id").all(card).map(row => {
-            let mentions = [];
-            try {
-                const parsed = JSON.parse(String(row["mentions_json"]));
-                if (Array.isArray(parsed))
-                    mentions = parsed.filter((one) => typeof one === "string");
-            }
-            catch {
-                mentions = [];
-            }
+            const mentions = readStoreTextList("flow_comment.mentions_json", row["mentions_json"]);
             return { id: Number(row["id"]), card: Number(row["card"]), kind: String(row["kind"]), author: String(row["author"]), body: String(row["body"]), mentions, at: String(row["at"]) };
         });
     }
@@ -19947,13 +19948,8 @@ export class Store {
         const row = this.db.prepare("SELECT tools_json FROM tool_seal WHERE task = ? AND approved_digest = ?").get(taskId, approvedDigest);
         if (row === undefined)
             return null;
-        try {
-            const parsed = JSON.parse(String(row["tools_json"]));
-            return Array.isArray(parsed) ? parsed.filter((one) => typeof one?.name === "string" && typeof one?.digest === "string") : [];
-        }
-        catch {
-            return [];
-        }
+        const read = readStoreColumn("tool_seal.tools_json", row["tools_json"]);
+        return read.ok ? read.value.filter((one) => typeof one?.name === "string" && typeof one?.digest === "string") : [];
     }
     /** What one attempt launched with (first launch of the run wins its record; a resumed turn updates it). */
     recordRunTools(run, toolsJson, now) {
@@ -19969,19 +19965,15 @@ export class Store {
         const row = this.db.prepare("SELECT json_extract(tools_json, '$.fence') AS fence FROM run_tool WHERE run = ?").get(run);
         if (row === undefined || row["fence"] === null)
             return null;
-        try {
-            return JSON.parse(String(row["fence"]));
-        }
-        catch {
-            return null;
-        }
+        const read = readStoreColumn("run_tool.tools_json.fence", row["fence"]);
+        return read.ok ? read.value : null;
     }
     runTools(run) {
         const row = this.db.prepare("SELECT tools_json FROM run_tool WHERE run = ?").get(run);
         if (row === undefined)
             return null;
         try {
-            const parsed = JSON.parse(String(row["tools_json"]));
+            const parsed = parseStoreColumn("run_tool.tools_json", row["tools_json"]);
             return { tools: Array.isArray(parsed.tools) ? parsed.tools : [], skipped: Array.isArray(parsed.skipped) ? parsed.skipped : [] };
         }
         catch {
@@ -20075,7 +20067,7 @@ export class Store {
         const row = this.db.prepare("SELECT a.* FROM mate_ask a JOIN mate_turn t ON t.id = a.turn WHERE a.turn = ? AND t.state = 'answered'").get(turn);
         if (row === undefined)
             return null;
-        const options = JSON.parse(String(row["options_json"]));
+        const options = parseStoreColumn("mate_ask.options_json", row["options_json"]);
         return { turn: Number(row["turn"]), thread: Number(row["thread"]), question: String(row["question"]), options: Array.isArray(options) ? options.map(String) : [], createdAt: String(row["created_at"]) };
     }
     /** What a tap on the question finds: open; answered (its owner has written in its thread since the reply that asked
@@ -22721,13 +22713,7 @@ export class Store {
         const row = this.db.prepare("SELECT about_json FROM lead_config WHERE account = ?").get(account);
         if (row === undefined)
             return [];
-        try {
-            const lines = JSON.parse(String(row["about_json"]));
-            return Array.isArray(lines) ? lines.filter((one) => typeof one === "string") : [];
-        }
-        catch {
-            return [];
-        }
+        return readStoreTextList("lead_config.about_json", row["about_json"]);
     }
     /** Save what this person's lead knows about them (checked by the caller: lead-about.ts). A person who never named
      * their lead gets an empty name and persona, so they keep following the defaults. */
@@ -23284,7 +23270,7 @@ export class Store {
     mateRequestReceipt(session, request) {
         const row = this.db.prepare("SELECT result FROM mutation WHERE idempotency_key = ? AND operation = 'mate-send'")
             .get(`mate-send:${session}:${request}`);
-        return row === undefined ? null : JSON.parse(String(row["result"]));
+        return row === undefined ? null : parseStoreColumn("mutation.result", row["result"]);
     }
     /**
      * Run `body` once per key, ever.
@@ -23315,7 +23301,7 @@ export class Store {
             .prepare("SELECT result FROM mutation WHERE idempotency_key = ?")
             .get(idempotencyKey);
         if (seen !== undefined)
-            return JSON.parse(String(seen["result"]));
+            return parseStoreColumn("mutation.result", seen["result"]);
         const result = body();
         if (!worthRecording(result))
             return result;
@@ -23596,7 +23582,7 @@ function readDecision(row) {
         state: String(row["state"]),
         recap: String(row["recap"]),
         question: String(row["question"]),
-        options: JSON.parse(String(row["options"])),
+        options: parseStoreColumn("decision.options", row["options"]),
         recommendation: String(row["recommendation"]),
         assignee: row["assignee"] === null ? null : String(row["assignee"]),
         deadline: row["deadline"] === null ? null : String(row["deadline"]),
@@ -23638,7 +23624,7 @@ function readPlanRevision(row) {
         kind: String(row["kind"]),
         authorityKind: String(row["authority_kind"]),
         authorityDigest: String(row["authority_digest"]),
-        changedFields: row["changed_fields"] === null || row["changed_fields"] === undefined ? [] : JSON.parse(String(row["changed_fields"])),
+        changedFields: row["changed_fields"] === null || row["changed_fields"] === undefined ? [] : parseStoreColumn("plan_revision.changed_fields", row["changed_fields"]),
         status: String(row["status"]),
         createdAt: String(row["created_at"]),
         resolvedAt: row["resolved_at"] === null || row["resolved_at"] === undefined ? null : String(row["resolved_at"]),
@@ -23665,7 +23651,7 @@ function readRunCheckpoint(row) {
         run: Number(row["run"]),
         taskRef: Number(row["task_ref"]),
         planRevision: Number(row["plan_revision"]),
-        snapshot: JSON.parse(String(row["snapshot_json"])),
+        snapshot: parseStoreColumn("run_checkpoint.snapshot_json", row["snapshot_json"]),
         createdAt: String(row["created_at"]),
     };
 }
@@ -23738,7 +23724,7 @@ function readTelegramConversationPart(row) {
         text: String(row["text"]),
         replyTo: text("reply_to"),
         proposal: row["proposal"] === null || row["proposal"] === undefined ? null : Number(row["proposal"]),
-        keyboard: row["keyboard_json"] === null || row["keyboard_json"] === undefined ? null : JSON.parse(String(row["keyboard_json"])),
+        keyboard: row["keyboard_json"] === null || row["keyboard_json"] === undefined ? null : parseStoreColumn("telegram_conversation_part.keyboard_json", row["keyboard_json"]),
         state: String(row["state"]),
         messageId: text("message_id"),
         taskId: text("task_id"),
@@ -23804,7 +23790,7 @@ function readPublicationGrant(row) {
         remote: String(row["remote"]),
         headPrefix: String(row["head_prefix"]),
         base: String(row["base"]),
-        capabilities: JSON.parse(String(row["capabilities"])),
+        capabilities: parseStoreColumn("publication_grant.capabilities", row["capabilities"]),
         selector: String(row["selector"]),
         draft: Number(row["draft"]) === 1,
         grantedBy: String(row["granted_by"]),
@@ -23879,8 +23865,8 @@ function readTaskRef(row) {
             ? null
             : String(row["coordinator_cid"]),
         assignedRunner: row["assigned_runner"] === null || row["assigned_runner"] === undefined ? null : String(row["assigned_runner"]),
-        zones: readJsonArray(row["zones"]),
-        capabilityRequirements: readJsonArray(row["capability_requirements"]),
+        zones: readStoreTextList("task_ref.zones", row["zones"]),
+        capabilityRequirements: readStoreTextList("task_ref.capability_requirements", row["capability_requirements"]),
         parkRate: Number(row["park_rate"]),
         plan: row["plan"] === null || row["plan"] === undefined
             ? null
@@ -23968,9 +23954,9 @@ function readRoutine(row) {
         repo: String(row["repo"]),
         goal: String(row["goal"]),
         outOfScope: row["out_of_scope"] === null ? null : String(row["out_of_scope"]),
-        touches: readJsonArray(row["touches"]),
-        acceptance: readAcceptance(row["acceptance_json"]),
-        requirements: readJsonArray(row["requirements"]),
+        touches: readStoreTextList("routine.touches", row["touches"]),
+        acceptance: readAcceptance("routine.acceptance_json", row["acceptance_json"]),
+        requirements: readStoreTextList("routine.requirements", row["requirements"]),
         schedule: String(row["schedule"]),
         singleFlight: Number(row["single_flight"]) === 1,
         costCeilingUsd: row["cost_ceiling_usd"] === null ? null : Number(row["cost_ceiling_usd"]),
@@ -24004,7 +23990,7 @@ function readTournamentTerms(row) {
         active: Number(row["active"]) === 1,
         kind: String(row["kind"] ?? "race") === "comparison" ? "comparison" : "race",
         raceDigest: String(row["race_digest"]),
-        agents: JSON.parse(String(row["agents"])),
+        agents: parseStoreColumn("tournament_terms.agents", row["agents"]),
         n: Number(row["n"]),
         perAgentBudgetMicrousd: Number(row["per_agent_budget_microusd"]),
         overrunReserveMicrousd: Number(row["overrun_reserve_microusd"]),
@@ -24169,12 +24155,12 @@ function readCoordinatorProposal(row) {
         name: String(row["name"]),
         repo: String(row["repo"]),
         kind: String(row["kind"]),
-        payload: JSON.parse(String(row["payload_json"])),
+        payload: parseStoreColumn("coordinator_proposal.payload_json", row["payload_json"]),
         state: String(row["state"]),
         createdAt: String(row["created_at"]),
         resolvedAt: row["resolved_at"] === null ? null : String(row["resolved_at"]),
         resolvedBy: row["resolved_by"] === null ? null : String(row["resolved_by"]),
-        outcome: row["outcome_json"] === null ? null : JSON.parse(String(row["outcome_json"])),
+        outcome: row["outcome_json"] === null ? null : parseStoreColumn("coordinator_proposal.outcome_json", row["outcome_json"]),
     };
 }
 function readMateProposal(row) {
@@ -24185,13 +24171,13 @@ function readMateProposal(row) {
         thread: Number(row["thread"]),
         turn: Number(row["turn"]),
         kind: String(row["kind"]),
-        payload: JSON.parse(String(row["payload_json"])),
+        payload: parseStoreColumn("mate_proposal.payload_json", row["payload_json"]),
         ceilingDigest: String(row["ceiling_digest"]),
         state: String(row["state"]),
         createdAt: String(row["created_at"]),
         resolvedAt: maybe("resolved_at"),
         resolvedBy: maybe("resolved_by"),
-        outcome: outcome === null ? null : JSON.parse(outcome),
+        outcome: outcome === null ? null : parseStoreColumn("mate_proposal.outcome_json", outcome),
     };
 }
 function readMateTurn(row) {
@@ -24261,9 +24247,10 @@ function readMatrixJson(raw) {
     if (raw === null || raw === undefined)
         return [];
     try {
-        const parsed = JSON.parse(String(raw));
-        if (!Array.isArray(parsed))
+        const read = readStoreColumn("proof_verdict.matrix_json", raw);
+        if (!read.ok)
             return [];
+        const parsed = read.value;
         // `answered` and `review` are additive (post-v39/v40 review findings):
         // a row stored before either fix simply has none, never a throw at
         // render.
@@ -24274,15 +24261,7 @@ function readMatrixJson(raw) {
     }
 }
 function readProofVerdict(row) {
-    let reasons = [];
-    try {
-        const parsed = JSON.parse(String(row["reasons_json"]));
-        if (Array.isArray(parsed))
-            reasons = parsed.map(one => String(one));
-    }
-    catch {
-        reasons = [];
-    }
+    const reasons = readStoreStringifiedList("proof_verdict.reasons_json", row["reasons_json"]);
     return {
         run: Number(row["run"]),
         verdict: String(row["verdict"]),
@@ -24296,10 +24275,10 @@ function readReviewBindingList(raw) {
     if (typeof raw !== "string")
         return [];
     try {
-        const parsed = JSON.parse(raw);
-        if (!Array.isArray(parsed))
+        const read = readStoreColumn("criterion_review.screenshots_json", raw);
+        if (!read.ok)
             return [];
-        return parsed
+        return read.value
             .filter((one) => typeof one === "object" && one !== null)
             .map(one => ({
             artifact: Number(one["artifact"]),
@@ -24388,15 +24367,7 @@ export function revisionTermsOf(sourceRef, sourceScope, coverage, permissionDefa
     };
 }
 function readRepairChain(row) {
-    let unresolved = [];
-    try {
-        const parsed = JSON.parse(String(row["unresolved_json"]));
-        if (Array.isArray(parsed))
-            unresolved = parsed.map(one => String(one));
-    }
-    catch {
-        unresolved = [];
-    }
+    const unresolved = readStoreStringifiedList("repair_chain.unresolved_json", row["unresolved_json"]);
     return {
         id: Number(row["id"]),
         rootTask: String(row["root_task"]),
@@ -24457,11 +24428,11 @@ export function contestantProfileOf(provider, model, repairModel, permissionMode
 /** The stored rubric, re-proved through the same strict parser that admits
  * one on the way in — never trusted bytes back out. Malformed or absent
  * reads back as `[]`, matching every rubric-less scope. */
-function readAcceptance(value) {
+function readAcceptance(column, value) {
     if (value === null || value === undefined)
         return [];
     try {
-        return parseAcceptanceCriteria(JSON.parse(String(value))).criteria;
+        return parseAcceptanceCriteria(parseStoreColumn(column, value)).criteria;
     }
     catch {
         return [];
@@ -24522,7 +24493,7 @@ function readScope(row) {
         taskId: String(row["task_id"]),
         goal: String(row["goal"]),
         outOfScope: row["out_of_scope"] === null ? null : String(row["out_of_scope"]),
-        touches: readJsonArray(row["touches"]),
+        touches: readStoreTextList("task_scope.touches", row["touches"]),
         proposedAt: String(row["proposed_at"]),
         digest: String(row["digest"]),
         budgetMicrousd: row["budget_microusd"] === null || row["budget_microusd"] === undefined ? null : Number(row["budget_microusd"]),
@@ -24546,7 +24517,7 @@ function readScope(row) {
         proposedChainJson: row["proposed_chain_json"] === null || row["proposed_chain_json"] === undefined ? null : String(row["proposed_chain_json"]),
         approvedChainJson: row["approved_chain_json"] === null || row["approved_chain_json"] === undefined ? null : String(row["approved_chain_json"]),
         approvalKind: String(row["approval_kind"] ?? "profile") === "chain" ? "chain" : "profile",
-        acceptance: readAcceptance(row["acceptance_json"]),
+        acceptance: readAcceptance("task_scope.acceptance_json", row["acceptance_json"]),
         qualityMode: row["quality_mode"] === "strict" ? "strict" : "default",
         riskLevel: isRiskLevel(row["risk_level"]) ? row["risk_level"] : "routine",
         proposedRouteJson: row["proposed_route_json"] === null || row["proposed_route_json"] === undefined ? null : String(row["proposed_route_json"]),
@@ -24561,8 +24532,8 @@ function readRunner(row) {
         name: String(row["name"]),
         host: String(row["host"]),
         capacity: Number(row["capacity"]),
-        repos: readJsonArray(row["repos"]),
-        agents: readJsonArray(row["agents"]),
+        repos: readStoreTextList("runner.repos", row["repos"]),
+        agents: readStoreTextList("runner.agents", row["agents"]),
         registeredAt: String(row["registered_at"]),
         heartbeatAt: String(row["heartbeat_at"]),
         retiredAt: row["retired_at"] === null ? null : String(row["retired_at"]),
@@ -24655,8 +24626,8 @@ function readGrant(row) {
     return {
         repo: String(row["repo"]),
         backend: String(row["backend"]),
-        paths: readJsonArray(row["paths"]),
-        mutations: readJsonArray(row["mutations"]),
+        paths: readStoreTextList("backend_grant.paths", row["paths"]),
+        mutations: readStoreTextList("backend_grant.mutations", row["mutations"]),
         selector: String(row["selector"]) === "all" ? "all" : "ours",
         credentialScope: row["credential_scope"] === null ? null : String(row["credential_scope"]),
         observedByGit: Number(row["observed_by_git"]) === 1,
@@ -24672,15 +24643,6 @@ function readGrant(row) {
         dispatchBlockedDetail: row["dispatch_blocked_detail"] === null || row["dispatch_blocked_detail"] === undefined ? null : String(row["dispatch_blocked_detail"]),
     };
 }
-function readJsonArray(value) {
-    try {
-        const parsed = JSON.parse(String(value));
-        return Array.isArray(parsed) ? parsed.filter((one) => typeof one === "string") : [];
-    }
-    catch {
-        return [];
-    }
-}
 export function verifiedAuthor(name) {
     return name;
 }