opencode-extended-sidebar 0.2.90 → 0.2.91

package/src/pware.oc.opencode/resolver/pware.oc.opencode.resolver.file.ts

@@ -1,162 +1,150 @@
-/**
- * pware.oc.core.opencode.resolver.file
- *
- * File-touch parts → FileView (basename + optional +/- diff stats). Patch
- * parts and edit/write/read tool parts count; never bodies or paths in the
- * panel. Feeds the Current and Sessions tabs.
- */
-import { fileHitFromExtracted, filesFromPatchJson, type FileFilter, type FileView } from "../pware.oc.opencode.files.js"
-import { str } from "../../pware.oc.core/pware.oc.core.paths.js"
-import { toEpochMs } from "../../pware.oc.core/pware.oc.core.pulse.js"
-import { uniqueIds, type SqlDb } from "../../pware.oc.core/pware.oc.core.sqlite.js"
-import { PART_TYPE_PATCH } from "../../pware.oc.core/constants/pware.oc.core.constants.partType.js"
-
-const FILE_SCAN = 80
-
-type SessionFileRow = {
-  time_updated: number
-  time_created: number
-  kind: string | null
-  tool: string | null
-  filePath: string | null
-  filePath2: string | null
-  filePath3: string | null
-  addMeta: number | null
-  addMeta2: number | null
-  addTop: number | null
-  delMeta: number | null
-  delMeta2: number | null
-  delTop: number | null
-  files: string | null
-}
-
-/** Shared file-part column list — all columns from `part.data` via json_extract. */
-function fileColumns(): string {
-  return [
-    `time_created`,
-    `time_updated`,
-    `json_extract(data,'$.type') AS kind`,
-    `json_extract(data,'$.tool') AS tool`,
-    `json_extract(data,'$.state.input.filePath') AS filePath`,
-    `json_extract(data,'$.input.filePath') AS filePath2`,
-    `json_extract(data,'$.filePath') AS filePath3`,
-    `json_extract(data,'$.state.metadata.additions') AS addMeta`,
-    `json_extract(data,'$.metadata.additions') AS addMeta2`,
-    `json_extract(data,'$.additions') AS addTop`,
-    `json_extract(data,'$.state.metadata.deletions') AS delMeta`,
-    `json_extract(data,'$.metadata.deletions') AS delMeta2`,
-    `json_extract(data,'$.deletions') AS delTop`,
-    `json_extract(data,'$.files') AS files`,
-  ].join(",\n       ")
-}
-
-/** Patch parts + edit/write/read tool parts — what counts as a file touch. */
-function fileWhere(): string {
-  return `(
-    json_extract(data,'$.type') = 'patch'
-    OR (
-      json_extract(data,'$.type') = 'tool'
-       AND json_extract(data,'$.tool') IN ('edit','write','multiedit','read','delete','apply_edit','applyedit','remove','view','read_file','readfile')
-    )
-  )`
-}
-
-/** Patch `files[]` + edit metadata +/- , aggregated by path. No bodies. */
-function fileViewsFromRows(rows: readonly SessionFileRow[], filter?: FileFilter): FileView[] {
-  const byId = new Map<string, FileView>()
-  const add = (f: FileView) => {
-    const prev = byId.get(f.id)
-    byId.set(f.id, {
-      id: f.id,
-      name: f.name,
-      additions: (prev?.additions ?? 0) + f.additions,
-      deletions: (prev?.deletions ?? 0) + f.deletions,
-      at: Math.max(f.at, prev?.at ?? 0),
-      touch: prev?.touch === "write" || f.touch === "write" ? "write" : "read",
-      letter: f.letter ?? prev?.letter ?? null,
-    })
-  }
-  for (const row of rows) {
-    const at = toEpochMs(row.time_updated) ?? toEpochMs(row.time_created) ?? 0
-    if (str(row.kind) === PART_TYPE_PATCH) {
-      for (const f of filesFromPatchJson(row.files, at, filter)) add(f)
-      continue
-    }
-    const hit = fileHitFromExtracted({
-      tool: str(row.tool),
-      filePath: str(row.filePath) || str(row.filePath2) || str(row.filePath3),
-      additions: row.addMeta ?? row.addMeta2 ?? row.addTop,
-      deletions: row.delMeta ?? row.delMeta2 ?? row.delTop,
-      at,
-      filter,
-    })
-    if (hit) add(hit)
-  }
-  return [...byId.values()].sort((a, b) => b.at - a.at)
-}
-
-function listFileRows(db: SqlDb, where: string, params: string[]): SessionFileRow[] {
-  const candidateRows = db.all<{ id: string }>(
-    `SELECT id
-     FROM part
-     WHERE ${where}
-     ORDER BY time_updated DESC
-     LIMIT ${FILE_SCAN}`,
-    ...params,
-  )
-  const ids = candidateRows.map((r) => String(r.id))
-  if (ids.length === 0) return []
-  const saturated = ids.length === FILE_SCAN
-
-  const placeholders = ids.map(() => "?").join(",")
-  const rows = db.all<SessionFileRow>(
-    `SELECT ${fileColumns()}
-     FROM part
-     WHERE id IN (${placeholders})
-       AND ${fileWhere()}
-     ORDER BY time_updated DESC`,
-    ...ids,
-  )
-
-  if (saturated && rows.length < FILE_SCAN) {
-    return db.all<SessionFileRow>(
-      `SELECT ${fileColumns()}
-       FROM part
-       WHERE ${where}
-         AND ${fileWhere()}
-       ORDER BY time_updated DESC
-       LIMIT ${FILE_SCAN}`,
-      ...params,
-    )
-  }
-  return rows
-}
-
-/** Patch `files[]` + edit metadata +/- for one session. No bodies. */
-export function listSessionFiles(db: SqlDb, sessionId: string, filter?: FileFilter): FileView[] {
-  let rows: SessionFileRow[] = []
-  try {
-    rows = listFileRows(db, "session_id = ?", [sessionId])
-  } catch {
-    return []
-  }
-  return fileViewsFromRows(rows, filter)
-}
-
-/** Files touched by any of the given sessions, aggregated — the Sessions tab feed. */
-export function listRecentSessionFiles(
-  db: SqlDb,
-  sessionIds: string[],
-  filter?: FileFilter,
-): FileView[] {
-  const clean = uniqueIds(sessionIds)
-  if (clean.length === 0) return []
-  const placeholders = clean.map(() => "?").join(",")
-  let rows: SessionFileRow[] = []
-  try {
-    rows = listFileRows(db, `session_id IN (${placeholders})`, clean)
-  } catch {
-    return []
-  }
-  return fileViewsFromRows(rows, filter)
-}
+/**
+ * pware.oc.core.opencode.resolver.file
+ *
+ * File-touch parts → FileView (basename + optional +/- diff stats). Patch
+ * parts and edit/write/read tool parts count; never bodies or paths in the
+ * panel. Feeds the Current and Sessions tabs.
+ */
+import { fileHitFromExtracted, filesFromPatchJson, type FileFilter, type FileView } from "../pware.oc.opencode.files.js"
+import { str } from "../../pware.oc.core/pware.oc.core.paths.js"
+import { toEpochMs } from "../../pware.oc.core/pware.oc.core.pulse.js"
+import { uniqueIds, type SqlDb } from "../../pware.oc.core/pware.oc.core.sqlite.js"
+import { PART_TYPE_PATCH } from "../../pware.oc.core/constants/pware.oc.core.constants.partType.js"
+
+const FILE_SCAN = 80
+
+type SessionFileRow = {
+  time_updated: number
+  time_created: number
+  kind: string | null
+  tool: string | null
+  filePath: string | null
+  filePath2: string | null
+  filePath3: string | null
+  addMeta: number | null
+  addMeta2: number | null
+  addTop: number | null
+  delMeta: number | null
+  delMeta2: number | null
+  delTop: number | null
+  files: string | null
+}
+
+/** Shared file-part column list — all columns from `part.data` via json_extract. */
+function fileColumns(): string {
+  return [
+    `time_created`,
+    `time_updated`,
+    `json_extract(data,'$.type') AS kind`,
+    `json_extract(data,'$.tool') AS tool`,
+    `json_extract(data,'$.state.input.filePath') AS filePath`,
+    `json_extract(data,'$.input.filePath') AS filePath2`,
+    `json_extract(data,'$.filePath') AS filePath3`,
+    `json_extract(data,'$.state.metadata.additions') AS addMeta`,
+    `json_extract(data,'$.metadata.additions') AS addMeta2`,
+    `json_extract(data,'$.additions') AS addTop`,
+    `json_extract(data,'$.state.metadata.deletions') AS delMeta`,
+    `json_extract(data,'$.metadata.deletions') AS delMeta2`,
+    `json_extract(data,'$.deletions') AS delTop`,
+    `json_extract(data,'$.files') AS files`,
+  ].join(",\n       ")
+}
+
+/** Patch parts + edit/write/read tool parts — what counts as a file touch. */
+function fileWhere(): string {
+  return `(
+    json_extract(data,'$.type') = 'patch'
+    OR (
+      json_extract(data,'$.type') = 'tool'
+       AND json_extract(data,'$.tool') IN ('edit','write','multiedit','read','delete','apply_edit','applyedit','remove','view','read_file','readfile')
+    )
+  )`
+}
+
+/** Patch `files[]` + edit metadata +/- , aggregated by path. No bodies. */
+function fileViewsFromRows(rows: readonly SessionFileRow[], filter?: FileFilter): FileView[] {
+  const byId = new Map<string, FileView>()
+  const add = (f: FileView) => {
+    const prev = byId.get(f.id)
+    byId.set(f.id, {
+      id: f.id,
+      name: f.name,
+      additions: (prev?.additions ?? 0) + f.additions,
+      deletions: (prev?.deletions ?? 0) + f.deletions,
+      at: Math.max(f.at, prev?.at ?? 0),
+      touch: prev?.touch === "write" || f.touch === "write" ? "write" : "read",
+      letter: f.letter ?? prev?.letter ?? null,
+    })
+  }
+  for (const row of rows) {
+    const at = toEpochMs(row.time_updated) ?? toEpochMs(row.time_created) ?? 0
+    if (str(row.kind) === PART_TYPE_PATCH) {
+      for (const f of filesFromPatchJson(row.files, at, filter)) add(f)
+      continue
+    }
+    const hit = fileHitFromExtracted({
+      tool: str(row.tool),
+      filePath: str(row.filePath) || str(row.filePath2) || str(row.filePath3),
+      additions: row.addMeta ?? row.addMeta2 ?? row.addTop,
+      deletions: row.delMeta ?? row.delMeta2 ?? row.delTop,
+      at,
+      filter,
+    })
+    if (hit) add(hit)
+  }
+  return [...byId.values()].sort((a, b) => b.at - a.at)
+}
+
+function listFileRows(db: SqlDb, where: string, params: string[]): SessionFileRow[] {
+  const candidateRows = db.all<{ id: string }>(
+    `SELECT id
+     FROM part
+     WHERE ${where}
+     ORDER BY time_updated DESC
+     LIMIT ${FILE_SCAN}`,
+    ...params,
+  )
+  const ids = candidateRows.map((r) => String(r.id))
+  if (ids.length === 0) return []
+  const saturated = ids.length === FILE_SCAN
+
+  const placeholders = ids.map(() => "?").join(",")
+  const rows = db.all<SessionFileRow>(
+    `SELECT ${fileColumns()}
+     FROM part
+     WHERE id IN (${placeholders})
+       AND ${fileWhere()}
+     ORDER BY time_updated DESC`,
+    ...ids,
+  )
+
+  if (saturated && rows.length < FILE_SCAN) {
+    return db.all<SessionFileRow>(
+      `SELECT ${fileColumns()}
+       FROM part
+       WHERE ${where}
+         AND ${fileWhere()}
+       ORDER BY time_updated DESC
+       LIMIT ${FILE_SCAN}`,
+      ...params,
+    )
+  }
+  return rows
+}
+
+/** Patch `files[]` + edit metadata +/- for one session. No bodies. */
+export function listSessionFiles(db: SqlDb, sessionId: string, filter?: FileFilter): FileView[] {
+  return fileViewsFromRows(listFileRows(db, "session_id = ?", [sessionId]), filter)
+}
+
+/** Files touched by any of the given sessions, aggregated — the Sessions tab feed. */
+export function listRecentSessionFiles(
+  db: SqlDb,
+  sessionIds: string[],
+  filter?: FileFilter,
+): FileView[] {
+  const clean = uniqueIds(sessionIds)
+  if (clean.length === 0) return []
+  const placeholders = clean.map(() => "?").join(",")
+  return fileViewsFromRows(listFileRows(db, `session_id IN (${placeholders})`, clean), filter)
+}

package/src/pware.oc.opencode/resolver/pware.oc.opencode.resolver.question.ts

@@ -1,185 +1,149 @@
-/**
- * pware.oc.core.opencode.resolver.question
- *
- * Open `question` tool parts across a project — the "waiting on my answer"
- * queue. A question is open while its state has no end time and its status is
- * running or pending, or while it is a still-unanswered error/interrupted
- * part. Scanned **project-wide** (every non-archived session of the project),
- * not just the current+recent window, so an open question keeps showing after
- * a restart or a session switch. Lazy read, gated on the My work tab;
- * soft-fails to [] on a missing/locked DB. The question text and options stay
- * in the `part.data` blob — never read, never shown.
- */
-import fs from "node:fs"
-import { str } from "../../pware.oc.core/pware.oc.core.paths.js"
-import { toEpochMs } from "../../pware.oc.core/pware.oc.core.pulse.js"
-import { openReadonlyDb, withDbRead } from "../../pware.oc.core/pware.oc.core.sqlite.js"
-import { toToolStatus } from "../../pware.oc.core/pware.oc.core.status.js"
-import { PART_TYPE_TOOL } from "../../pware.oc.core/constants/pware.oc.core.constants.partType.js"
-import {
-  TOOL_STATUS_COMPLETED,
-  TOOL_STATUS_ERROR,
-  TOOL_STATUS_PENDING,
-  TOOL_STATUS_RUNNING,
-} from "../../pware.oc.core/constants/pware.oc.core.constants.status.js"
-import { TOOL_QUESTION } from "../../pware.oc.core/constants/pware.oc.core.constants.toolName.js"
-import {
-  QUESTION_KIND_ERROR,
-  QUESTION_KIND_INTERRUPTED,
-  QUESTION_KIND_QUESTION,
-  type OpenQuestionKind,
-} from "../constants/pware.oc.opencode.constants.questionKind.js"
-
-export type { OpenQuestionKind }
-
-export type OpenQuestion = {
-  partId: string
-  sessionId: string
-  /** The session's own title — the question's session may sit outside the recent window. */
-  title: string
-  startedAt: number | null
-  kind: OpenQuestionKind
-  /** `state.error` text for interrupted/error parts; null for an open question. */
-  reason: string | null
-  /**
-   * True when the part has a terminal end time. An ended plain error is kept in
-   * the queue for the Errors group, but it is no longer "live" — the tab light
-   * must not treat it as something happening right now. Absent = still live.
-   */
-  ended?: boolean
-}
-
-/** Raw SELECT row for an open-question scan. Metadata only — never part.data text. */
-export type OpenQuestionRow = {
-  id: string
-  session_id: string
-  title: string | null
-  time_created: number
-  status: string | null
-  tstart: number | null
-  tend: number | null
-  error: string | null
-  interrupted: number | null
-}
-
-/**
- * Classify one SELECT row into an open question, or null when the part is not
- * part of the queue (resolved / completed / a still-terminated interrupt).
- * Pure — the same row always maps to the same answer.
- */
-export function classifyQuestionRow(row: OpenQuestionRow): OpenQuestion | null {
-  const start = toEpochMs(row.tstart)
-  const end = toEpochMs(row.tend)
-  const status = toToolStatus(
-    str(row.status) || (end != null ? TOOL_STATUS_COMPLETED : start != null ? TOOL_STATUS_RUNNING : null),
-  )
-  if (status !== TOOL_STATUS_RUNNING && status !== TOOL_STATUS_PENDING && status !== TOOL_STATUS_ERROR) return null
-  const interrupted = row.interrupted === 1
-  // An interrupted question that terminated (has an end time) is resolved:
-  // the abort closed the tool and no answer is pending. Only a still-open
-  // interrupted part (no end time) stays "your call".
-  if (interrupted && end != null) return null
-  const reason = str(row.error) || null
-  const kind: OpenQuestionKind =
-    status === TOOL_STATUS_ERROR
-      ? interrupted
-        ? QUESTION_KIND_INTERRUPTED
-        : QUESTION_KIND_ERROR
-      : QUESTION_KIND_QUESTION
-  return {
-    partId: row.id,
-    sessionId: row.session_id,
-    title: str(row.title) || "untitled",
-    startedAt: start ?? toEpochMs(row.time_created),
-    kind,
-    reason: kind === QUESTION_KIND_QUESTION ? null : reason,
-    ended: end != null,
-  }
-}
-
-export function listOpenQuestions(opts: {
-  dbPath: string
-  projectId: string | null
-}): OpenQuestion[] {
-  if (!opts.dbPath || !opts.projectId || !fs.existsSync(opts.dbPath)) return []
-  return withDbRead(() => {
-    const db = openReadonlyDb(opts.dbPath)
-    if (!db) return []
-    let rows: OpenQuestionRow[] = []
-    try {
-      rows = db.all<OpenQuestionRow>(
-        `SELECT p.id AS id,
-                p.session_id,
-                s.title AS title,
-                p.time_created,
-                json_extract(p.data,'$.state.status') AS status,
-                json_extract(p.data,'$.state.time.start') AS tstart,
-                json_extract(p.data,'$.state.time.end') AS tend,
-                json_extract(p.data,'$.state.error') AS error,
-                json_extract(p.data,'$.state.metadata.interrupted') AS interrupted
-         FROM part p
-         JOIN session s ON s.id = p.session_id
-         WHERE json_extract(p.data,'$.type') = '${PART_TYPE_TOOL}'
-           AND json_extract(p.data,'$.tool') = '${TOOL_QUESTION}'
-           AND (s.time_archived IS NULL OR s.time_archived = 0)
-           AND s.project_id = ?
-         ORDER BY p.time_created DESC
-         LIMIT 80`,
-        opts.projectId,
-      )
-    } catch {
-      return []
-    }
-    return rows
-      .map(classifyQuestionRow)
-      .filter((q): q is OpenQuestion => q != null)
-  }, () => [])
-}
-
-/**
- * Session-scoped open questions. Same SELECT columns and filters as
- * `listOpenQuestions`, but `WHERE p.session_id = ?` rides `part_session_idx`
- * for a cheap targeted re-read. Foundation for later event-driven invalidation
- * of the "My work" queue.
- */
-export function listSessionQuestions(opts: {
-  dbPath: string
-  sessionId: string
-  projectId: string | null
-}): OpenQuestion[] {
-  if (!opts.dbPath || !opts.sessionId || !opts.projectId || !fs.existsSync(opts.dbPath)) return []
-  return withDbRead(() => {
-    const db = openReadonlyDb(opts.dbPath)
-    if (!db) return []
-    let rows: OpenQuestionRow[] = []
-    try {
-      rows = db.all<OpenQuestionRow>(
-        `SELECT p.id AS id,
-                p.session_id,
-                s.title AS title,
-                p.time_created,
-                json_extract(p.data,'$.state.status') AS status,
-                json_extract(p.data,'$.state.time.start') AS tstart,
-                json_extract(p.data,'$.state.time.end') AS tend,
-                json_extract(p.data,'$.state.error') AS error,
-                json_extract(p.data,'$.state.metadata.interrupted') AS interrupted
-         FROM part p
-         JOIN session s ON s.id = p.session_id
-         WHERE p.session_id = ?
-           AND json_extract(p.data,'$.type') = '${PART_TYPE_TOOL}'
-           AND json_extract(p.data,'$.tool') = '${TOOL_QUESTION}'
-           AND (s.time_archived IS NULL OR s.time_archived = 0)
-           AND s.project_id = ?
-         ORDER BY p.time_created DESC
-         LIMIT 20`,
-        opts.sessionId,
-        opts.projectId,
-      )
-    } catch {
-      return []
-    }
-    return rows
-      .map(classifyQuestionRow)
-      .filter((q): q is OpenQuestion => q != null)
-  }, () => [])
-}
+/**
+ * pware.oc.core.opencode.resolver.question
+ *
+ * Open `question` tool parts across a project — the "waiting on my answer"
+ * queue. A question is open while its state has no end time and its status is
+ * running or pending, or while it is a still-unanswered error/interrupted
+ * part. Scanned **project-wide** (every non-archived session of the project),
+ * not just the current+recent window, so an open question keeps showing after
+ * a restart or a session switch. Lazy read, gated on the My work tab;
+ * soft-fails to [] on a missing/locked DB. The question text and options stay
+ * in the `part.data` blob — never read, never shown.
+ */
+import { str } from "../../pware.oc.core/pware.oc.core.paths.js"
+import { toEpochMs } from "../../pware.oc.core/pware.oc.core.pulse.js"
+import type { SqlDb } from "../../pware.oc.core/pware.oc.core.sqlite.js"
+import { toToolStatus } from "../../pware.oc.core/pware.oc.core.status.js"
+import { PART_TYPE_TOOL } from "../../pware.oc.core/constants/pware.oc.core.constants.partType.js"
+import {
+  TOOL_STATUS_COMPLETED,
+  TOOL_STATUS_ERROR,
+  TOOL_STATUS_PENDING,
+  TOOL_STATUS_RUNNING,
+} from "../../pware.oc.core/constants/pware.oc.core.constants.status.js"
+import { TOOL_QUESTION } from "../../pware.oc.core/constants/pware.oc.core.constants.toolName.js"
+import {
+  QUESTION_KIND_ERROR,
+  QUESTION_KIND_INTERRUPTED,
+  QUESTION_KIND_QUESTION,
+  type OpenQuestionKind,
+} from "../constants/pware.oc.opencode.constants.questionKind.js"
+
+export type { OpenQuestionKind }
+
+export type OpenQuestion = {
+  partId: string
+  sessionId: string
+  /** The session's own title — the question's session may sit outside the recent window. */
+  title: string
+  startedAt: number | null
+  kind: OpenQuestionKind
+  /** `state.error` text for interrupted/error parts; null for an open question. */
+  reason: string | null
+  /**
+   * True when the part has a terminal end time. An ended plain error is kept in
+   * the queue for the Errors group, but it is no longer "live" — the tab light
+   * must not treat it as something happening right now. Absent = still live.
+   */
+  ended?: boolean
+}
+
+/** Raw SELECT row for an open-question scan. Metadata only — never part.data text. */
+export type OpenQuestionRow = {
+  id: string
+  session_id: string
+  title: string | null
+  time_created: number
+  status: string | null
+  tstart: number | null
+  tend: number | null
+  error: string | null
+  interrupted: number | null
+}
+
+/**
+ * Classify one SELECT row into an open question, or null when the part is not
+ * part of the queue (resolved / completed / a still-terminated interrupt).
+ * Pure — the same row always maps to the same answer.
+ */
+export function classifyQuestionRow(row: OpenQuestionRow): OpenQuestion | null {
+  const start = toEpochMs(row.tstart)
+  const end = toEpochMs(row.tend)
+  const status = toToolStatus(
+    str(row.status) || (end != null ? TOOL_STATUS_COMPLETED : start != null ? TOOL_STATUS_RUNNING : null),
+  )
+  if (status !== TOOL_STATUS_RUNNING && status !== TOOL_STATUS_PENDING && status !== TOOL_STATUS_ERROR) return null
+  const interrupted = row.interrupted === 1
+  // An interrupted question that terminated (has an end time) is resolved:
+  // the abort closed the tool and no answer is pending. Only a still-open
+  // interrupted part (no end time) stays "your call".
+  if (interrupted && end != null) return null
+  const reason = str(row.error) || null
+  const kind: OpenQuestionKind =
+    status === TOOL_STATUS_ERROR
+      ? interrupted
+        ? QUESTION_KIND_INTERRUPTED
+        : QUESTION_KIND_ERROR
+      : QUESTION_KIND_QUESTION
+  return {
+    partId: row.id,
+    sessionId: row.session_id,
+    title: str(row.title) || "untitled",
+    startedAt: start ?? toEpochMs(row.time_created),
+    kind,
+    reason: kind === QUESTION_KIND_QUESTION ? null : reason,
+    ended: end != null,
+  }
+}
+
+function queryQuestions(
+  db: SqlDb,
+  scope: "project" | "session",
+  projectId: string,
+  sessionId?: string,
+): OpenQuestion[] {
+  const sessionFilter = scope === "session" ? "p.session_id = ? AND" : ""
+  const params = scope === "session" && sessionId ? [sessionId, projectId] : [projectId]
+  const limit = scope === "session" ? 20 : 80
+  return db.all<OpenQuestionRow>(
+    `SELECT p.id AS id,
+            p.session_id,
+            s.title AS title,
+            p.time_created,
+            json_extract(p.data,'$.state.status') AS status,
+            json_extract(p.data,'$.state.time.start') AS tstart,
+            json_extract(p.data,'$.state.time.end') AS tend,
+            json_extract(p.data,'$.state.error') AS error,
+            json_extract(p.data,'$.state.metadata.interrupted') AS interrupted
+     FROM part p
+     JOIN session s ON s.id = p.session_id
+     WHERE ${sessionFilter}
+       json_extract(p.data,'$.type') = '${PART_TYPE_TOOL}'
+       AND json_extract(p.data,'$.tool') = '${TOOL_QUESTION}'
+       AND (s.time_archived IS NULL OR s.time_archived = 0)
+       AND s.project_id = ?
+     ORDER BY p.time_created DESC
+     LIMIT ${limit}`,
+    ...params,
+  )
+    .map(classifyQuestionRow)
+    .filter((question): question is OpenQuestion => question != null)
+}
+
+export function listOpenQuestions(db: SqlDb, projectId: string | null): OpenQuestion[] {
+  return projectId ? queryQuestions(db, "project", projectId) : []
+}
+
+/**
+ * Session-scoped open questions. Same SELECT columns and filters as
+ * `listOpenQuestions`, but `WHERE p.session_id = ?` rides `part_session_idx`
+ * for a cheap targeted re-read. Foundation for later event-driven invalidation
+ * of the "My work" queue.
+ */
+export function listSessionQuestions(
+  db: SqlDb,
+  sessionId: string,
+  projectId: string | null,
+): OpenQuestion[] {
+  return sessionId && projectId ? queryQuestions(db, "session", projectId, sessionId) : []
+}