@taskforcehq/taskforce 0.3.170 → 0.3.301

package/dist/documentReviews/DocumentReviewCommentStore.js

@@ -0,0 +1,230 @@
+function normalizeId(value) {
+    return String(value || '').trim();
+}
+function normalizeWorkspaceId(value) {
+    return normalizeId(value) || 'default';
+}
+function normalizeNullable(value) {
+    const normalized = String(value || '').trim();
+    return normalized || null;
+}
+function normalizePositiveInteger(value) {
+    const numeric = Number(value);
+    if (!Number.isFinite(numeric))
+        return null;
+    const normalized = Math.floor(numeric);
+    return normalized >= 0 ? normalized : null;
+}
+function normalizeAnchor(raw) {
+    const record = raw && typeof raw === 'object' ? raw : null;
+    if (!record)
+        return null;
+    const kind = String(record.kind || '').trim().toLowerCase();
+    if (kind === 'document') {
+        return { kind: 'document' };
+    }
+    if (kind === 'quote') {
+        const quote = String(record.quote || '').trim();
+        if (!quote)
+            return null;
+        const prefix = normalizeNullable(record.prefix);
+        const suffix = normalizeNullable(record.suffix);
+        return { kind: 'quote', quote, prefix, suffix };
+    }
+    if (kind === 'line-range') {
+        const startLine = normalizePositiveInteger(record.startLine);
+        const endLine = normalizePositiveInteger(record.endLine);
+        if (startLine == null || endLine == null || startLine < 1 || endLine < 1)
+            return null;
+        return {
+            kind: 'line-range',
+            startLine,
+            endLine: Math.max(startLine, endLine),
+        };
+    }
+    return null;
+}
+function mapRow(row) {
+    const createdAt = normalizeId(row.created_at);
+    const updatedAt = normalizeId(row.updated_at) || createdAt;
+    return {
+        id: normalizeId(row.id),
+        tenantId: normalizeId(row.tenant_id) || 'default',
+        workspaceId: normalizeWorkspaceId(row.workspace_id),
+        sessionId: normalizeId(row.session_id),
+        order: normalizePositiveInteger(row.order_index) ?? 0,
+        body: normalizeId(row.body),
+        anchor: (() => {
+            const rawJson = typeof row.anchor_json === 'string' ? row.anchor_json : '';
+            if (!rawJson)
+                return null;
+            try {
+                return normalizeAnchor(JSON.parse(rawJson));
+            }
+            catch {
+                return null;
+            }
+        })(),
+        authorActorId: normalizeNullable(row.author_actor_id),
+        createdAt,
+        updatedAt,
+        deletedAt: normalizeNullable(row.deleted_at),
+    };
+}
+export class DocumentReviewCommentStore {
+    db;
+    tenantId;
+    constructor(db, tenantId) {
+        this.db = db;
+        this.tenantId = tenantId;
+    }
+    listForSession(sessionIdRaw, workspaceIdRaw, options) {
+        const sessionId = normalizeId(sessionIdRaw);
+        const workspaceId = normalizeWorkspaceId(workspaceIdRaw);
+        if (!sessionId)
+            return [];
+        const includeDeleted = options?.includeDeleted === true;
+        const rows = this.db.prepare(`
+            SELECT *
+            FROM document_review_comments
+            WHERE tenant_id = ?
+              AND workspace_id = ?
+              AND session_id = ?
+              ${includeDeleted ? '' : 'AND deleted_at IS NULL'}
+            ORDER BY order_index ASC, created_at ASC, id ASC
+        `).all(this.tenantId, workspaceId, sessionId);
+        return rows.map(mapRow);
+    }
+    listByWorkspace(workspaceIdRaw, options) {
+        const workspaceId = normalizeWorkspaceId(workspaceIdRaw);
+        const includeDeleted = options?.includeDeleted === true;
+        const rows = this.db.prepare(`
+            SELECT *
+            FROM document_review_comments
+            WHERE tenant_id = ?
+              AND workspace_id = ?
+              ${includeDeleted ? '' : 'AND deleted_at IS NULL'}
+            ORDER BY updated_at DESC, created_at DESC, id ASC
+        `).all(this.tenantId, workspaceId);
+        return rows.map(mapRow);
+    }
+    create(input) {
+        const id = normalizeId(input.id);
+        const sessionId = normalizeId(input.sessionId);
+        const workspaceId = normalizeWorkspaceId(input.workspaceId);
+        const createdAt = normalizeId(input.createdAt) || new Date().toISOString();
+        const updatedAt = normalizeId(input.updatedAt) || createdAt;
+        this.db.prepare(`
+            INSERT INTO document_review_comments (
+                id,
+                session_id,
+                tenant_id,
+                workspace_id,
+                body,
+                anchor_json,
+                author_actor_id,
+                order_index,
+                created_at,
+                updated_at,
+                deleted_at
+            ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        `).run(id, sessionId, this.tenantId, workspaceId, normalizeId(input.body), input.anchor ? JSON.stringify(input.anchor) : null, normalizeNullable(input.authorActorId), normalizePositiveInteger(input.order) ?? 0, createdAt, updatedAt, normalizeNullable(input.deletedAt));
+        return this.get(id, workspaceId, { includeDeleted: true });
+    }
+    get(commentIdRaw, workspaceIdRaw, options) {
+        const commentId = normalizeId(commentIdRaw);
+        const workspaceId = normalizeWorkspaceId(workspaceIdRaw);
+        if (!commentId)
+            return null;
+        const includeDeleted = options?.includeDeleted === true;
+        const row = this.db.prepare(`
+            SELECT *
+            FROM document_review_comments
+            WHERE tenant_id = ?
+              AND workspace_id = ?
+              AND id = ?
+              ${includeDeleted ? '' : 'AND deleted_at IS NULL'}
+            LIMIT 1
+        `).get(this.tenantId, workspaceId, commentId);
+        return row ? mapRow(row) : null;
+    }
+    update(input) {
+        const existing = this.get(input.id, input.workspaceId, { includeDeleted: true });
+        if (!existing)
+            return null;
+        this.db.prepare(`
+            UPDATE document_review_comments
+            SET body = ?,
+                anchor_json = ?,
+                order_index = ?,
+                author_actor_id = ?,
+                updated_at = ?,
+                deleted_at = ?
+            WHERE tenant_id = ?
+              AND workspace_id = ?
+              AND id = ?
+        `).run(input.body === undefined ? existing.body : normalizeId(input.body), input.anchor === undefined ? (existing.anchor ? JSON.stringify(existing.anchor) : null) : (input.anchor ? JSON.stringify(input.anchor) : null), input.order === undefined ? existing.order : (normalizePositiveInteger(input.order) ?? existing.order), input.authorActorId === undefined ? existing.authorActorId : normalizeNullable(input.authorActorId), normalizeId(input.updatedAt) || new Date().toISOString(), input.deletedAt === undefined ? existing.deletedAt : normalizeNullable(input.deletedAt), this.tenantId, normalizeWorkspaceId(input.workspaceId), normalizeId(input.id));
+        return this.get(input.id, input.workspaceId, { includeDeleted: true });
+    }
+    upsertForSync(input) {
+        const existing = this.get(input.id, input.workspaceId, { includeDeleted: true });
+        if (!existing) {
+            return this.create(input);
+        }
+        this.db.prepare(`
+            UPDATE document_review_comments
+            SET session_id = ?,
+                body = ?,
+                anchor_json = ?,
+                author_actor_id = ?,
+                order_index = ?,
+                created_at = ?,
+                updated_at = ?,
+                deleted_at = ?
+            WHERE tenant_id = ?
+              AND workspace_id = ?
+              AND id = ?
+        `).run(normalizeId(input.sessionId) || existing.sessionId, normalizeId(input.body), input.anchor ? JSON.stringify(input.anchor) : null, normalizeNullable(input.authorActorId), normalizePositiveInteger(input.order) ?? existing.order, normalizeId(input.createdAt) || existing.createdAt, normalizeId(input.updatedAt) || existing.updatedAt, normalizeNullable(input.deletedAt), this.tenantId, normalizeWorkspaceId(input.workspaceId), normalizeId(input.id));
+        return this.get(input.id, input.workspaceId, { includeDeleted: true });
+    }
+    softDelete(commentIdRaw, workspaceIdRaw, deletedAtRaw) {
+        const commentId = normalizeId(commentIdRaw);
+        const workspaceId = normalizeWorkspaceId(workspaceIdRaw);
+        if (!commentId)
+            return false;
+        const deletedAt = normalizeId(deletedAtRaw) || new Date().toISOString();
+        const result = this.db.prepare(`
+            UPDATE document_review_comments
+            SET deleted_at = ?, updated_at = ?
+            WHERE tenant_id = ?
+              AND workspace_id = ?
+              AND id = ?
+              AND deleted_at IS NULL
+        `).run(deletedAt, deletedAt, this.tenantId, workspaceId, commentId);
+        return Number(result?.changes || 0) > 0;
+    }
+    replaceForSession(input) {
+        const sessionId = normalizeId(input.sessionId);
+        const workspaceId = normalizeWorkspaceId(input.workspaceId);
+        this.db.prepare(`
+            DELETE FROM document_review_comments
+            WHERE tenant_id = ?
+              AND workspace_id = ?
+              AND session_id = ?
+        `).run(this.tenantId, workspaceId, sessionId);
+        for (const comment of input.comments) {
+            this.create({
+                id: comment.id,
+                sessionId,
+                workspaceId,
+                body: comment.body,
+                anchor: comment.anchor,
+                order: comment.order,
+                authorActorId: comment.authorActorId,
+                createdAt: comment.createdAt,
+                updatedAt: comment.updatedAt,
+                deletedAt: comment.deletedAt,
+            });
+        }
+    }
+}

package/dist/documentReviews/DocumentReviewSessionStore.d.ts

@@ -0,0 +1,52 @@
+import type { DatabaseAdapter } from '../storage/databaseAdapter.js';
+import type { DocumentReviewSessionRecord, DocumentReviewSessionStatus } from './types.js';
+export declare class DocumentReviewSessionStore {
+    private readonly db;
+    private readonly tenantId;
+    constructor(db: DatabaseAdapter, tenantId: string);
+    listForAsset(assetIdRaw: string, workspaceIdRaw: string, options?: {
+        includeDeleted?: boolean;
+    }): DocumentReviewSessionRecord[];
+    listByWorkspace(workspaceIdRaw: string, options?: {
+        includeDeleted?: boolean;
+    }): DocumentReviewSessionRecord[];
+    get(sessionIdRaw: string, workspaceIdRaw: string, options?: {
+        includeDeleted?: boolean;
+    }): DocumentReviewSessionRecord | null;
+    create(input: {
+        id: string;
+        workspaceId: string;
+        assetId: string;
+        documentId?: string | null;
+        documentVersion?: number | null;
+        title?: string | null;
+        status?: DocumentReviewSessionStatus;
+        createdByActorId?: string | null;
+        updatedByActorId?: string | null;
+        createdAt?: string;
+        updatedAt?: string;
+    }): DocumentReviewSessionRecord;
+    upsertForSync(input: {
+        id: string;
+        workspaceId: string;
+        assetId: string;
+        documentId?: string | null;
+        documentVersion?: number | null;
+        title?: string | null;
+        status?: DocumentReviewSessionStatus;
+        createdByActorId?: string | null;
+        updatedByActorId?: string | null;
+        createdAt?: string;
+        updatedAt?: string;
+        deletedAt?: string | null;
+    }): DocumentReviewSessionRecord;
+    update(input: {
+        id: string;
+        workspaceId: string;
+        title?: string | null;
+        status?: DocumentReviewSessionStatus;
+        updatedByActorId?: string | null;
+        updatedAt?: string;
+    }): DocumentReviewSessionRecord | null;
+    softDelete(sessionIdRaw: string, workspaceIdRaw: string, deletedAtRaw?: string): boolean;
+}

package/dist/documentReviews/DocumentReviewSessionStore.js

@@ -0,0 +1,193 @@
+function normalizeId(value) {
+    return String(value || '').trim();
+}
+function normalizeWorkspaceId(value) {
+    return normalizeId(value) || 'default';
+}
+function normalizeNullable(value) {
+    const normalized = String(value || '').trim();
+    return normalized || null;
+}
+function normalizePositiveInteger(value) {
+    const numeric = Number(value);
+    if (!Number.isFinite(numeric))
+        return null;
+    const normalized = Math.floor(numeric);
+    return normalized > 0 ? normalized : null;
+}
+function normalizeStatus(value) {
+    return String(value || '').trim().toLowerCase() === 'resolved' ? 'resolved' : 'open';
+}
+function mapRow(row) {
+    return {
+        id: normalizeId(row.id),
+        tenantId: normalizeId(row.tenant_id) || 'default',
+        workspaceId: normalizeWorkspaceId(row.workspace_id),
+        assetId: normalizeId(row.asset_id),
+        documentId: normalizeNullable(row.document_id),
+        documentVersion: normalizePositiveInteger(row.document_version),
+        title: normalizeNullable(row.title),
+        status: normalizeStatus(row.status),
+        comments: [],
+        createdByActorId: normalizeNullable(row.created_by_actor_id),
+        updatedByActorId: normalizeNullable(row.updated_by_actor_id),
+        createdAt: normalizeId(row.created_at),
+        updatedAt: normalizeId(row.updated_at),
+        deletedAt: normalizeNullable(row.deleted_at),
+    };
+}
+export class DocumentReviewSessionStore {
+    db;
+    tenantId;
+    constructor(db, tenantId) {
+        this.db = db;
+        this.tenantId = tenantId;
+    }
+    listForAsset(assetIdRaw, workspaceIdRaw, options) {
+        const assetId = normalizeId(assetIdRaw);
+        const workspaceId = normalizeWorkspaceId(workspaceIdRaw);
+        if (!assetId)
+            return [];
+        const includeDeleted = options?.includeDeleted === true;
+        const rows = this.db.prepare(`
+            SELECT *
+            FROM document_review_sessions
+            WHERE tenant_id = ?
+              AND workspace_id = ?
+              AND asset_id = ?
+              ${includeDeleted ? '' : 'AND deleted_at IS NULL'}
+            ORDER BY updated_at DESC, created_at DESC, id ASC
+        `).all(this.tenantId, workspaceId, assetId);
+        return rows.map(mapRow);
+    }
+    listByWorkspace(workspaceIdRaw, options) {
+        const workspaceId = normalizeWorkspaceId(workspaceIdRaw);
+        const includeDeleted = options?.includeDeleted === true;
+        const rows = this.db.prepare(`
+            SELECT *
+            FROM document_review_sessions
+            WHERE tenant_id = ?
+              AND workspace_id = ?
+              ${includeDeleted ? '' : 'AND deleted_at IS NULL'}
+            ORDER BY updated_at DESC, created_at DESC, id ASC
+        `).all(this.tenantId, workspaceId);
+        return rows.map(mapRow);
+    }
+    get(sessionIdRaw, workspaceIdRaw, options) {
+        const sessionId = normalizeId(sessionIdRaw);
+        const workspaceId = normalizeWorkspaceId(workspaceIdRaw);
+        if (!sessionId)
+            return null;
+        const includeDeleted = options?.includeDeleted === true;
+        const row = this.db.prepare(`
+            SELECT *
+            FROM document_review_sessions
+            WHERE tenant_id = ?
+              AND workspace_id = ?
+              AND id = ?
+              ${includeDeleted ? '' : 'AND deleted_at IS NULL'}
+            LIMIT 1
+        `).get(this.tenantId, workspaceId, sessionId);
+        return row ? mapRow(row) : null;
+    }
+    create(input) {
+        const id = normalizeId(input.id);
+        const workspaceId = normalizeWorkspaceId(input.workspaceId);
+        const createdAt = normalizeId(input.createdAt) || new Date().toISOString();
+        const updatedAt = normalizeId(input.updatedAt) || createdAt;
+        this.db.prepare(`
+            INSERT INTO document_review_sessions (
+                id,
+                tenant_id,
+                workspace_id,
+                asset_id,
+                document_id,
+                document_version,
+                title,
+                status,
+                created_by_actor_id,
+                updated_by_actor_id,
+                created_at,
+                updated_at,
+                deleted_at
+            ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, NULL)
+        `).run(id, this.tenantId, workspaceId, normalizeId(input.assetId), normalizeNullable(input.documentId), normalizePositiveInteger(input.documentVersion), normalizeNullable(input.title), normalizeStatus(input.status), normalizeNullable(input.createdByActorId), normalizeNullable(input.updatedByActorId), createdAt, updatedAt);
+        return this.get(id, workspaceId, { includeDeleted: true });
+    }
+    upsertForSync(input) {
+        const id = normalizeId(input.id);
+        const workspaceId = normalizeWorkspaceId(input.workspaceId);
+        const existing = this.get(id, workspaceId, { includeDeleted: true });
+        if (!existing) {
+            this.db.prepare(`
+                INSERT INTO document_review_sessions (
+                    id,
+                    tenant_id,
+                    workspace_id,
+                    asset_id,
+                    document_id,
+                    document_version,
+                    title,
+                    status,
+                    created_by_actor_id,
+                    updated_by_actor_id,
+                    created_at,
+                    updated_at,
+                    deleted_at
+                ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+            `).run(id, this.tenantId, workspaceId, normalizeId(input.assetId), normalizeNullable(input.documentId), normalizePositiveInteger(input.documentVersion), normalizeNullable(input.title), normalizeStatus(input.status), normalizeNullable(input.createdByActorId), normalizeNullable(input.updatedByActorId), normalizeId(input.createdAt) || new Date().toISOString(), normalizeId(input.updatedAt) || normalizeId(input.createdAt) || new Date().toISOString(), normalizeNullable(input.deletedAt));
+            return this.get(id, workspaceId, { includeDeleted: true });
+        }
+        this.db.prepare(`
+            UPDATE document_review_sessions
+            SET asset_id = ?,
+                document_id = ?,
+                document_version = ?,
+                title = ?,
+                status = ?,
+                created_by_actor_id = ?,
+                updated_by_actor_id = ?,
+                created_at = ?,
+                updated_at = ?,
+                deleted_at = ?
+            WHERE tenant_id = ?
+              AND workspace_id = ?
+              AND id = ?
+        `).run(normalizeId(input.assetId) || existing.assetId, normalizeNullable(input.documentId), normalizePositiveInteger(input.documentVersion), normalizeNullable(input.title), normalizeStatus(input.status), normalizeNullable(input.createdByActorId), normalizeNullable(input.updatedByActorId), normalizeId(input.createdAt) || existing.createdAt, normalizeId(input.updatedAt) || existing.updatedAt, normalizeNullable(input.deletedAt), this.tenantId, workspaceId, id);
+        return this.get(id, workspaceId, { includeDeleted: true });
+    }
+    update(input) {
+        const existing = this.get(input.id, input.workspaceId);
+        if (!existing)
+            return null;
+        const updatedAt = normalizeId(input.updatedAt) || new Date().toISOString();
+        this.db.prepare(`
+            UPDATE document_review_sessions
+            SET title = ?,
+                status = ?,
+                updated_by_actor_id = ?,
+                updated_at = ?
+            WHERE tenant_id = ?
+              AND workspace_id = ?
+              AND id = ?
+              AND deleted_at IS NULL
+        `).run(input.title === undefined ? existing.title : normalizeNullable(input.title), input.status === undefined ? existing.status : normalizeStatus(input.status), input.updatedByActorId === undefined ? existing.updatedByActorId : normalizeNullable(input.updatedByActorId), updatedAt, this.tenantId, normalizeWorkspaceId(input.workspaceId), normalizeId(input.id));
+        return this.get(input.id, input.workspaceId);
+    }
+    softDelete(sessionIdRaw, workspaceIdRaw, deletedAtRaw) {
+        const sessionId = normalizeId(sessionIdRaw);
+        const workspaceId = normalizeWorkspaceId(workspaceIdRaw);
+        if (!sessionId)
+            return false;
+        const deletedAt = normalizeId(deletedAtRaw) || new Date().toISOString();
+        const result = this.db.prepare(`
+            UPDATE document_review_sessions
+            SET deleted_at = ?, updated_at = ?
+            WHERE tenant_id = ?
+              AND workspace_id = ?
+              AND id = ?
+              AND deleted_at IS NULL
+        `).run(deletedAt, deletedAt, this.tenantId, workspaceId, sessionId);
+        return Number(result?.changes || 0) > 0;
+    }
+}

package/dist/documentReviews/DocumentReviewSessionStore.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/documentReviews/DocumentReviewSessionStore.test.js

@@ -0,0 +1,127 @@
+import { afterEach, describe, expect, it } from 'vitest';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { createDatabaseAdapter } from '../storage/createDatabaseAdapter.js';
+import { ensureDocumentReviewSessionsSchema, ensureTaskAssetsSchema, ensureWorkspaceAssetsSchema } from '../migrations/taskSchemaMigrations.js';
+import { DocumentReviewCommentStore } from './DocumentReviewCommentStore.js';
+import { DocumentReviewSessionStore } from './DocumentReviewSessionStore.js';
+function makeStore() {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), 'taskforce-document-reviews-'));
+    const dbPath = path.join(root, 'taskforce.db');
+    const db = createDatabaseAdapter({ sqliteDbPath: dbPath });
+    ensureTaskAssetsSchema(db);
+    ensureWorkspaceAssetsSchema(db);
+    ensureDocumentReviewSessionsSchema(db);
+    const store = new DocumentReviewSessionStore(db, 'default');
+    const commentStore = new DocumentReviewCommentStore(db, 'default');
+    return {
+        root,
+        db,
+        store,
+        commentStore,
+        cleanup() {
+            db.close();
+            fs.rmSync(root, { recursive: true, force: true });
+        }
+    };
+}
+describe('DocumentReviewSessionStore', () => {
+    const cleanups = [];
+    afterEach(() => {
+        while (cleanups.length > 0) {
+            cleanups.pop()?.();
+        }
+    });
+    it('creates and reads sessions without embedding comments', () => {
+        const ctx = makeStore();
+        cleanups.push(() => ctx.cleanup());
+        const created = ctx.store.create({
+            id: 'review-1',
+            workspaceId: 'workspace-1',
+            assetId: 'asset-doc-1',
+            documentId: 'doc-1',
+            documentVersion: 2,
+            title: 'Implementation review',
+        });
+        expect(created).toMatchObject({
+            id: 'review-1',
+            workspaceId: 'workspace-1',
+            assetId: 'asset-doc-1',
+            documentId: 'doc-1',
+            documentVersion: 2,
+            title: 'Implementation review',
+            status: 'open',
+        });
+        expect(created.comments).toEqual([]);
+    });
+    it('backfills embedded comment blobs into document_review_comments rows', () => {
+        const ctx = makeStore();
+        cleanups.push(() => ctx.cleanup());
+        ctx.db.prepare(`
+            INSERT INTO document_review_sessions (
+                id,
+                tenant_id,
+                workspace_id,
+                asset_id,
+                document_id,
+                document_version,
+                title,
+                status,
+                comments_json,
+                created_by_actor_id,
+                updated_by_actor_id,
+                created_at,
+                updated_at,
+                deleted_at
+            ) VALUES (?, 'default', 'workspace-1', 'asset-doc-1', 'doc-1', 2, 'Implementation review', 'open', ?, 'user-1', 'user-1', '2026-03-25T09:00:00.000Z', '2026-03-25T10:00:00.000Z', NULL)
+        `).run('review-legacy', JSON.stringify([
+            {
+                id: 'comment-1',
+                order: 1,
+                body: 'Needs a concrete rollout section.',
+                anchor: { kind: 'line-range', startLine: 12, endLine: 18 },
+                authorActorId: 'user-1',
+                createdAt: '2026-03-25T09:00:00.000Z',
+                updatedAt: '2026-03-25T09:00:00.000Z',
+                deletedAt: null,
+            },
+            {
+                id: 'comment-2',
+                order: 2,
+                body: 'Resolve the open question.',
+                anchor: { kind: 'quote', quote: 'Open Questions', prefix: '## ', suffix: '\\n' },
+                authorActorId: 'user-2',
+                createdAt: '2026-03-25T10:00:00.000Z',
+                updatedAt: '2026-03-25T10:00:00.000Z',
+                deletedAt: null,
+            },
+        ]));
+        ensureDocumentReviewSessionsSchema(ctx.db);
+        const comments = ctx.commentStore.listForSession('review-legacy', 'workspace-1');
+        expect(comments.map((comment) => comment.id)).toEqual(['comment-1', 'comment-2']);
+        expect(comments[0]).toMatchObject({
+            body: 'Needs a concrete rollout section.',
+            anchor: { kind: 'line-range', startLine: 12, endLine: 18 },
+        });
+    });
+    it('lists active sessions and keeps soft-deleted rows hidden by default', () => {
+        const ctx = makeStore();
+        cleanups.push(() => ctx.cleanup());
+        ctx.store.create({
+            id: 'review-a',
+            workspaceId: 'workspace-1',
+            assetId: 'asset-doc-1',
+        });
+        ctx.store.create({
+            id: 'review-b',
+            workspaceId: 'workspace-1',
+            assetId: 'asset-doc-1',
+        });
+        expect(ctx.store.softDelete('review-b', 'workspace-1')).toBe(true);
+        const active = ctx.store.listForAsset('asset-doc-1', 'workspace-1');
+        expect(active.map((session) => session.id)).toEqual(['review-a']);
+        const all = ctx.store.listForAsset('asset-doc-1', 'workspace-1', { includeDeleted: true });
+        expect(all.map((session) => session.id).sort()).toEqual(['review-a', 'review-b']);
+    });
+});

package/dist/documentReviews/service.d.ts

@@ -0,0 +1,68 @@
+import type { TaskActor } from '../core/Taskforce.js';
+import type { WorkspaceAssetStore } from '../storage/workspaceAssetStore.js';
+import { DocumentReviewCommentStore } from './DocumentReviewCommentStore.js';
+import { DocumentReviewSessionStore } from './DocumentReviewSessionStore.js';
+import type { DocumentReviewAnchor, DocumentReviewSession, DocumentReviewSessionRecord, DocumentReviewSessionStatus } from './types.js';
+export interface DocumentReviewServiceDeps {
+    tenantId: string;
+    workspaceAssetStore: WorkspaceAssetStore | null;
+    sessionStore: DocumentReviewSessionStore;
+    commentStore: DocumentReviewCommentStore;
+    normalizeWorkspaceId: (workspaceId?: string | null) => string;
+    resolveWorkspaceActor: (workspaceId: string, actorRef: unknown) => TaskActor | null;
+    generateEntityId: (prefix: string) => string;
+    createRuleError: (message: string, statusCode?: number, code?: string) => Error;
+}
+export declare function listDocumentReviewSessionsService(deps: DocumentReviewServiceDeps, input: {
+    workspaceId?: string | null;
+    assetId: string;
+    includeDeleted?: boolean;
+}): DocumentReviewSession[];
+export declare function getDocumentReviewSessionService(deps: DocumentReviewServiceDeps, input: {
+    workspaceId?: string | null;
+    sessionId: string;
+    includeDeleted?: boolean;
+}): DocumentReviewSession | null;
+export declare function listDocumentReviewSessionsForSyncService(deps: DocumentReviewServiceDeps, input: {
+    workspaceId?: string | null;
+    includeDeleted?: boolean;
+}): DocumentReviewSessionRecord[];
+export declare function createDocumentReviewSessionService(deps: DocumentReviewServiceDeps, input: {
+    workspaceId?: string | null;
+    assetId: string;
+    title?: string | null;
+    status?: DocumentReviewSessionStatus;
+    actorId?: string | null;
+}): DocumentReviewSession;
+export declare function updateDocumentReviewSessionService(deps: DocumentReviewServiceDeps, input: {
+    workspaceId?: string | null;
+    sessionId: string;
+    title?: string | null;
+    status?: DocumentReviewSessionStatus;
+    actorId?: string | null;
+}): DocumentReviewSession;
+export declare function addDocumentReviewCommentService(deps: DocumentReviewServiceDeps, input: {
+    workspaceId?: string | null;
+    sessionId: string;
+    body: string;
+    anchor?: DocumentReviewAnchor | null;
+    actorId?: string | null;
+}): DocumentReviewSession;
+export declare function updateDocumentReviewCommentService(deps: DocumentReviewServiceDeps, input: {
+    workspaceId?: string | null;
+    sessionId: string;
+    commentId: string;
+    body?: string;
+    anchor?: DocumentReviewAnchor | null;
+    actorId?: string | null;
+}): DocumentReviewSession;
+export declare function deleteDocumentReviewCommentService(deps: DocumentReviewServiceDeps, input: {
+    workspaceId?: string | null;
+    sessionId: string;
+    commentId: string;
+    actorId?: string | null;
+}): DocumentReviewSession;
+export declare function deleteDocumentReviewSessionService(deps: DocumentReviewServiceDeps, input: {
+    workspaceId?: string | null;
+    sessionId: string;
+}): boolean;