@tequila99/githuman 0.11.2 → 0.12.0

package/dist/server/repositories/artifact-search.repo.js

@@ -0,0 +1,192 @@
+import { MAX_SEARCH_WORD_CODEPOINTS } from "../../shared/artifacts/constants.js";
+import { searchCopy, searchTokens, searchGrams } from "../../shared/artifacts/search.js";
+import { ArtifactSearchUnavailableError } from "../errors/artifacts.js";
+export class ArtifactSearchRepository {
+    db;
+    statements = new Map();
+    storeId;
+    constructor(db, storeId) {
+        this.db = db;
+        this.storeId = storeId;
+    }
+    statement(sql) {
+        let prepared = this.statements.get(sql);
+        if (!prepared) {
+            prepared = this.db.prepare(sql);
+            this.statements.set(sql, prepared);
+        }
+        return prepared;
+    }
+    available() {
+        if (!this.statement("SELECT 1 FROM sqlite_master WHERE name='artifact_search_capabilities'").get()) {
+            return false;
+        }
+        return Boolean(this.statement('SELECT available FROM artifact_search_capabilities WHERE id=1').get()?.available);
+    }
+    assertAvailable() {
+        if (!this.available())
+            throw new ArtifactSearchUnavailableError();
+    }
+    epoch() {
+        return (this.statement('SELECT COALESCE(SUM(epoch),0) epoch FROM artifact_search_epochs').get()?.epoch ?? 0);
+    }
+    changed() {
+        this.statement('INSERT INTO artifact_search_epochs VALUES(?,1) ON CONFLICT(store_id) DO UPDATE SET epoch=epoch+1').run(this.storeId);
+    }
+    pending() {
+        return this.statement(`SELECT c.artifact_id FROM artifact_current c LEFT JOIN artifact_search_documents d ON d.store_id=c.store_id AND d.artifact_id=c.artifact_id LEFT JOIN artifact_search_suppressed s ON s.store_id=c.store_id AND s.artifact_id=c.artifact_id WHERE c.store_id=? AND s.artifact_id IS NULL AND (d.version IS NULL OR d.version<>c.version) ORDER BY c.artifact_id`).all(this.storeId).map(row => row.artifact_id);
+    }
+    document(id) {
+        return this.statement('SELECT rowid,version,sha256,title,body,title_offsets,body_offsets FROM artifact_search_documents WHERE store_id=? AND artifact_id=?').get(this.storeId, id);
+    }
+    index(artifact, body) {
+        if (!this.available())
+            return;
+        if (this.statement('SELECT 1 FROM artifact_search_suppressed WHERE store_id=? AND artifact_id=?').get(this.storeId, artifact.id)) {
+            return;
+        }
+        const old = this.document(artifact.id);
+        const title = searchCopy(artifact.title);
+        if (old &&
+            old.sha256 === artifact.sha256 &&
+            old.title === title.text &&
+            old.title_offsets === JSON.stringify(title.offsets)) {
+            this.statement('UPDATE artifact_search_documents SET version=? WHERE rowid=?').run(artifact.metadataVersion, old.rowid);
+            return;
+        }
+        const normalizedBody = old && old.sha256 === artifact.sha256
+            ? {
+                text: old.body,
+                offsets: JSON.parse(old.body_offsets)
+            }
+            : searchCopy(body());
+        this.removeDocument(artifact.id);
+        const inserted = this.statement('INSERT INTO artifact_search_documents(store_id,artifact_id,version,sha256,title,body,title_offsets,body_offsets) VALUES(?,?,?,?,?,?,?,?)').run(this.storeId, artifact.id, artifact.metadataVersion, artifact.sha256, title.text, normalizedBody.text, JSON.stringify(title.offsets), JSON.stringify(normalizedBody.offsets));
+        const rowid = Number(inserted.lastInsertRowid);
+        for (const table of ['artifact_search_fts', 'artifact_search_trigrams']) {
+            this.statement(`INSERT INTO ${table}(rowid,title,body) VALUES(?,?,?)`).run(rowid, title.text, normalizedBody.text);
+        }
+        for (const token of searchTokens(`${title.text}\n${normalizedBody.text}`)) {
+            const length = Array.from(token).length;
+            if (length > MAX_SEARCH_WORD_CODEPOINTS)
+                continue;
+            const frequency = this.statement('INSERT INTO artifact_search_words VALUES(?,?,?,1) ON CONFLICT(store_id,token) DO UPDATE SET frequency=frequency+1 RETURNING frequency').get(this.storeId, token, length);
+            const fresh = frequency?.frequency === 1;
+            this.statement('INSERT INTO artifact_search_document_words VALUES(?,?,?)').run(this.storeId, artifact.id, token);
+            if (fresh) {
+                for (const width of [1, 2]) {
+                    for (const gram of searchGrams(token, width)) {
+                        this.statement('INSERT INTO artifact_search_word_grams VALUES(?,?,?,?)').run(this.storeId, gram, width, token);
+                    }
+                }
+            }
+        }
+        this.changed();
+    }
+    removeDocument(id) {
+        const old = this.document(id);
+        if (!old)
+            return false;
+        for (const table of ['artifact_search_fts', 'artifact_search_trigrams']) {
+            this.statement(`DELETE FROM ${table} WHERE rowid=?`).run(old.rowid);
+        }
+        this.statement(`UPDATE artifact_search_words SET frequency=frequency-1 WHERE store_id=? AND token IN (SELECT token FROM artifact_search_document_words WHERE store_id=? AND artifact_id=?)`).run(this.storeId, this.storeId, id);
+        this.statement('DELETE FROM artifact_search_word_grams WHERE store_id=? AND token IN (SELECT token FROM artifact_search_words WHERE store_id=? AND frequency=0)').run(this.storeId, this.storeId);
+        this.statement('DELETE FROM artifact_search_words WHERE store_id=? AND frequency=0').run(this.storeId);
+        this.statement('DELETE FROM artifact_search_document_words WHERE store_id=? AND artifact_id=?').run(this.storeId, id);
+        this.statement('DELETE FROM artifact_search_documents WHERE rowid=?').run(old.rowid);
+        return true;
+    }
+    remove(id) {
+        if (this.removeDocument(id))
+            this.changed();
+    }
+    suppress(id, reason) {
+        this.removeDocument(id);
+        this.statement('INSERT INTO artifact_search_suppressed VALUES(?,?,?) ON CONFLICT(store_id,artifact_id) DO UPDATE SET reason=excluded.reason').run(this.storeId, id, reason);
+        this.changed();
+    }
+    reset() {
+        for (const row of this.statement('SELECT artifact_id FROM artifact_search_documents WHERE store_id=?').all(this.storeId)) {
+            this.removeDocument(row.artifact_id);
+        }
+        this.statement('DELETE FROM artifact_search_suppressed WHERE store_id=?').run(this.storeId);
+        this.changed();
+    }
+    candidates(token, edits, limit) {
+        const width = Array.from(token).length >= 8 ? 2 : 1;
+        return this.statement(`SELECT w.token,w.frequency,COUNT(*) overlap FROM artifact_search_word_grams g JOIN artifact_search_words w ON w.store_id=g.store_id AND w.token=g.token WHERE g.store_id=? AND g.width=? AND g.gram IN (SELECT value FROM json_each(?)) AND w.length BETWEEN ? AND ? GROUP BY w.token ORDER BY overlap DESC,w.frequency DESC,w.token LIMIT ?`).all(this.storeId, width, JSON.stringify(searchGrams(token, width)), Array.from(token).length - edits, Array.from(token).length + edits, limit);
+    }
+    select(input, normalized, exactExpression, fuzzyExpression, offset, limit) {
+        const params = [];
+        const hits = [];
+        if (normalized) {
+            if (Array.from(normalized).length >= 3) {
+                hits.push('SELECT rowid,bm25(artifact_search_trigrams,5,1) score,0 tier FROM artifact_search_trigrams WHERE artifact_search_trigrams MATCH ?');
+                params.push('"' + normalized.replaceAll('"', '""') + '"');
+            }
+            else {
+                hits.push("SELECT rowid,0 score,0 tier FROM artifact_search_documents WHERE store_id=? AND (title LIKE ? ESCAPE '\\' OR body LIKE ? ESCAPE '\\')");
+                const literal = '%' + normalized.replace(/[\\%_]/g, '\\$&') + '%';
+                params.push(this.storeId, literal, literal);
+            }
+            if (exactExpression) {
+                hits.push('SELECT rowid,bm25(artifact_search_fts,5,1) score,1 tier FROM artifact_search_fts WHERE artifact_search_fts MATCH ?');
+                params.push(exactExpression);
+            }
+            if (fuzzyExpression) {
+                hits.push('SELECT rowid,bm25(artifact_search_fts,5,1) score,2 tier FROM artifact_search_fts WHERE artifact_search_fts MATCH ?');
+                params.push(fuzzyExpression);
+            }
+        }
+        else {
+            hits.push('SELECT rowid,0 score,0 tier FROM artifact_search_documents');
+        }
+        const filters = input.filters ?? {};
+        const where = [
+            'd.store_id=?',
+            "json_extract(c.snapshot_json,'$.status') IN (SELECT value FROM json_each(?))"
+        ];
+        params.push(this.storeId, JSON.stringify(filters.statuses ?? ['accepted']));
+        if (filters.typeIds) {
+            where.push("json_extract(c.snapshot_json,'$.typeId') IN (SELECT value FROM json_each(?))");
+            params.push(JSON.stringify(filters.typeIds));
+        }
+        if (filters.taskIds) {
+            where.push("EXISTS(SELECT 1 FROM json_each(c.snapshot_json,'$.taskIds') WHERE value IN (SELECT value FROM json_each(?)))");
+            params.push(JSON.stringify(filters.taskIds));
+        }
+        if (filters.tags) {
+            where.push(filters.tagMode === 'any'
+                ? "EXISTS(SELECT 1 FROM json_each(c.snapshot_json,'$.tags') WHERE value IN (SELECT value FROM json_each(?)))"
+                : "NOT EXISTS(SELECT 1 FROM json_each(?) f WHERE f.value NOT IN (SELECT value FROM json_each(c.snapshot_json,'$.tags')))");
+            params.push(JSON.stringify(filters.tags));
+        }
+        // Stored timestamps are UTC ISO strings, so text comparison keeps time order.
+        if (filters.createdFrom) {
+            where.push("json_extract(c.snapshot_json,'$.createdAt') >= ?");
+            params.push(new Date(filters.createdFrom).toISOString());
+        }
+        if (filters.createdTo) {
+            where.push("json_extract(c.snapshot_json,'$.createdAt') <= ?");
+            params.push(new Date(filters.createdTo).toISOString());
+        }
+        const sort = input.sort === 'createdAt'
+            ? "json_extract(c.snapshot_json,'$.createdAt') DESC"
+            : input.sort === 'metadataUpdatedAt'
+                ? "json_extract(c.snapshot_json,'$.metadataUpdatedAt') DESC"
+                : 'h.tier,h.score';
+        params.push(limit, offset);
+        return this.statement(`WITH hits AS MATERIALIZED (${hits.join(' UNION ALL ')}), ranked AS (SELECT rowid,tier,score FROM (SELECT rowid,tier,score,ROW_NUMBER() OVER (PARTITION BY rowid ORDER BY tier,score) n FROM hits) WHERE n=1) SELECT d.artifact_id id,c.snapshot_json,h.tier,h.score FROM ranked h JOIN artifact_search_documents d ON d.rowid=h.rowid JOIN artifact_current c ON c.store_id=d.store_id AND c.artifact_id=d.artifact_id WHERE ${where.join(' AND ')} ORDER BY ${sort},d.artifact_id LIMIT ? OFFSET ?`).all(...params);
+    }
+    diagnostics() {
+        const available = this.available();
+        if (!available)
+            return { available, documents: 0, suppressed: [] };
+        return {
+            available,
+            documents: this.statement('SELECT COUNT(*) count FROM artifact_search_documents WHERE store_id=?').get(this.storeId).count,
+            suppressed: this.statement('SELECT artifact_id id,reason FROM artifact_search_suppressed WHERE store_id=? ORDER BY artifact_id').all(this.storeId)
+        };
+    }
+}

package/dist/server/repositories/artifact-transition.repo.js

@@ -0,0 +1,85 @@
+import { ArtifactNotFoundError } from "../errors/artifacts.js";
+export class ArtifactTransitionRepository {
+    db;
+    storeId;
+    constructor(db, storeId) {
+        this.db = db;
+        this.storeId = storeId;
+    }
+    operation(id) {
+        const row = this.db
+            .prepare('SELECT payload_json FROM artifact_transition_current WHERE store_id=? AND id=?')
+            .get(this.storeId, id);
+        if (!row) {
+            throw new ArtifactNotFoundError();
+        }
+        return JSON.parse(row.payload_json);
+    }
+    forArtifact(artifactId, limit = 10) {
+        const rows = this.db
+            .prepare('SELECT payload_json FROM artifact_transition_current WHERE store_id=? AND artifact_id=?')
+            .all(this.storeId, artifactId);
+        return rows
+            .map(row => JSON.parse(row.payload_json))
+            .sort((a, b) => b.createdAt - a.createdAt)
+            .slice(0, limit);
+    }
+    unfinished() {
+        const rows = this.db
+            .prepare(`SELECT payload_json FROM artifact_transition_current WHERE store_id=?
+         AND json_extract(payload_json,'$.stage') IN ('preparing','validating','applying')`)
+            .all(this.storeId);
+        return rows.map(row => JSON.parse(row.payload_json));
+    }
+    append(value) {
+        const payload = JSON.stringify(value);
+        this.db
+            .prepare('INSERT INTO artifact_transition_events(store_id,id,payload_json) VALUES(?,?,?)')
+            .run(this.storeId, value.id, payload);
+        this.db
+            .prepare(`INSERT INTO artifact_transition_current VALUES(?,?,?,?)
+         ON CONFLICT(store_id,id) DO UPDATE SET payload_json=excluded.payload_json`)
+            .run(this.storeId, value.id, value.artifactId, payload);
+    }
+    history(id) {
+        const rows = this.db
+            .prepare('SELECT payload_json FROM artifact_transition_events WHERE store_id=? AND id=? ORDER BY seq')
+            .all(this.storeId, id);
+        return rows.map(row => JSON.parse(row.payload_json));
+    }
+    rebuild() {
+        this.db
+            .prepare('DELETE FROM artifact_transition_current WHERE store_id=?')
+            .run(this.storeId);
+        this.db
+            .prepare(`INSERT INTO artifact_transition_current
+         SELECT store_id,id,json_extract(payload_json,'$.artifactId'),payload_json
+         FROM artifact_transition_events e WHERE store_id=? AND seq=(
+           SELECT MAX(seq) FROM artifact_transition_events n WHERE n.store_id=e.store_id AND n.id=e.id)`)
+            .run(this.storeId);
+    }
+    request(requestId) {
+        const row = this.db
+            .prepare('SELECT payload_hash,operation_id FROM artifact_transition_requests WHERE store_id=? AND request_id=?')
+            .get(this.storeId, requestId);
+        return row
+            ? { payloadHash: row.payload_hash, operationId: row.operation_id }
+            : undefined;
+    }
+    appendRequest(requestId, payloadHash, operationId) {
+        this.db
+            .prepare('INSERT INTO artifact_transition_requests(store_id,request_id,payload_hash,operation_id) VALUES(?,?,?,?)')
+            .run(this.storeId, requestId, payloadHash, operationId);
+    }
+    consent(operationId) {
+        const row = this.db
+            .prepare('SELECT payload_json FROM artifact_transition_consents WHERE store_id=? AND operation_id=?')
+            .get(this.storeId, operationId);
+        return row ? JSON.parse(row.payload_json) : undefined;
+    }
+    appendConsent(value) {
+        this.db
+            .prepare('INSERT INTO artifact_transition_consents(store_id,operation_id,payload_json) VALUES(?,?,?)')
+            .run(this.storeId, value.operationId, JSON.stringify(value));
+    }
+}

package/dist/server/repositories/artifact-validation.repo.js

@@ -0,0 +1,146 @@
+import { artifactLeaseBusyError, ArtifactNotFoundError } from "../errors/artifacts.js";
+export class ArtifactValidationRepository {
+    db;
+    storeId;
+    constructor(db, storeId) {
+        this.db = db;
+        this.storeId = storeId;
+    }
+    proposal(id) {
+        const row = this.db
+            .prepare('SELECT payload_json FROM artifact_change_set_events WHERE store_id=? AND id=? ORDER BY version DESC LIMIT 1')
+            .get(this.storeId, id);
+        if (!row)
+            throw new ArtifactNotFoundError();
+        return JSON.parse(row.payload_json);
+    }
+    proposalVersion(id, version) {
+        const row = this.db
+            .prepare('SELECT payload_json FROM artifact_change_set_events WHERE store_id=? AND id=? AND version=?')
+            .get(this.storeId, id, version);
+        if (!row)
+            throw new ArtifactNotFoundError();
+        return JSON.parse(row.payload_json);
+    }
+    proposalRequest(requestId) {
+        const row = this.db
+            .prepare('SELECT payload_json FROM artifact_change_set_events WHERE store_id=? AND request_id=?')
+            .get(this.storeId, requestId);
+        return row ? JSON.parse(row.payload_json) : undefined;
+    }
+    appendProposal(value) {
+        this.db
+            .prepare('INSERT INTO artifact_change_set_events(store_id,id,version,request_id,payload_json) VALUES(?,?,?,?,?)')
+            .run(this.storeId, value.id, value.version, value.requestId, JSON.stringify(value));
+    }
+    validation(id) {
+        const row = this.db
+            .prepare('SELECT payload_json FROM artifact_validation_current WHERE store_id=? AND id=?')
+            .get(this.storeId, id);
+        if (!row)
+            throw new ArtifactNotFoundError();
+        return JSON.parse(row.payload_json);
+    }
+    appendValidation(value, eventKind = ['pass', 'conflict'].includes(value.state)
+        ? 'completed'
+        : value.state) {
+        const payload = JSON.stringify({ ...value, eventKind });
+        this.db
+            .prepare('INSERT INTO artifact_validation_events(store_id,id,payload_json) VALUES(?,?,?)')
+            .run(this.storeId, value.id, payload);
+        this.db
+            .prepare('INSERT INTO artifact_validation_current VALUES(?,?,?) ON CONFLICT(store_id,id) DO UPDATE SET payload_json=excluded.payload_json')
+            .run(this.storeId, value.id, payload);
+    }
+    history(id, afterSeq = 0, limit = 50) {
+        return this.db
+            .prepare('SELECT seq,payload_json FROM artifact_validation_events WHERE store_id=? AND id=? AND seq>? ORDER BY seq LIMIT ?')
+            .all(this.storeId, id, afterSeq, limit).map(row => ({
+            seq: row.seq,
+            validation: JSON.parse(row.payload_json)
+        }));
+    }
+    rebuild() {
+        this.db
+            .prepare('DELETE FROM artifact_validation_current WHERE store_id=?')
+            .run(this.storeId);
+        this.db
+            .prepare(`INSERT INTO artifact_validation_current SELECT store_id,id,payload_json FROM artifact_validation_events e WHERE store_id=? AND seq=(SELECT MAX(seq) FROM artifact_validation_events n WHERE n.store_id=e.store_id AND n.id=e.id)`)
+            .run(this.storeId);
+    }
+    lease() {
+        return this.db
+            .prepare('SELECT validation_id,owner,owner_pid,expires_at FROM artifact_validation_leases WHERE store_id=?')
+            .get(this.storeId);
+    }
+    claim(id, owner, now, ttl) {
+        if (this.lease()) {
+            throw artifactLeaseBusyError('Another validation job is active.');
+        }
+        this.db
+            .prepare('INSERT INTO artifact_validation_leases VALUES(?,?,?,?,?)')
+            .run(this.storeId, id, owner, process.pid, now + ttl);
+    }
+    release(id, owner) {
+        this.db
+            .prepare('DELETE FROM artifact_validation_leases WHERE store_id=? AND validation_id=? AND owner=?')
+            .run(this.storeId, id, owner);
+    }
+    /** Records that `owner` is alive; old rows of dead owners are dropped. */
+    beat(owner, now, keepMs) {
+        this.db
+            .prepare(`INSERT INTO artifact_owner_heartbeats VALUES(?,?,?)
+         ON CONFLICT(store_id,owner) DO UPDATE SET beat_at=excluded.beat_at`)
+            .run(this.storeId, owner, now);
+        this.db
+            .prepare('DELETE FROM artifact_owner_heartbeats WHERE store_id=? AND beat_at<?')
+            .run(this.storeId, now - keepMs);
+    }
+    forget(owner) {
+        this.db
+            .prepare('DELETE FROM artifact_owner_heartbeats WHERE store_id=? AND owner=?')
+            .run(this.storeId, owner);
+    }
+    /** Time of the last heartbeat, or undefined when the owner never wrote one. */
+    heartbeat(owner) {
+        const row = this.db
+            .prepare('SELECT beat_at FROM artifact_owner_heartbeats WHERE store_id=? AND owner=?')
+            .get(this.storeId, owner);
+        return row?.beat_at;
+    }
+    appendAuthorization(id, data) {
+        this.db
+            .prepare('INSERT INTO artifact_user_authorizations(store_id,id,payload_json) VALUES(?,?,?)')
+            .run(this.storeId, id, JSON.stringify(data));
+    }
+    authorizationEvent(id, kind, data) {
+        this.db
+            .prepare('INSERT INTO artifact_authorization_events(store_id,id,kind,payload_json) VALUES(?,?,?,?)')
+            .run(this.storeId, id, kind, JSON.stringify(data));
+    }
+    consumed(id) {
+        return Boolean(this.db
+            .prepare("SELECT 1 FROM artifact_authorization_events WHERE store_id=? AND id=? AND kind='consumed'")
+            .get(this.storeId, id));
+    }
+    commitRequest(requestId) {
+        const row = this.db
+            .prepare('SELECT seq,payload_hash,result_json FROM artifact_lifecycle_commits WHERE store_id=? AND request_id=?')
+            .get(this.storeId, requestId);
+        return row
+            ? {
+                payloadHash: row.payload_hash,
+                result: {
+                    ...JSON.parse(row.result_json),
+                    eventSeq: row.seq
+                }
+            }
+            : undefined;
+    }
+    appendCommit(requestId, payloadHash, result) {
+        const inserted = this.db
+            .prepare('INSERT INTO artifact_lifecycle_commits(store_id,request_id,payload_hash,result_json) VALUES(?,?,?,?)')
+            .run(this.storeId, requestId, payloadHash, JSON.stringify(result));
+        return Number(inserted.lastInsertRowid);
+    }
+}

package/dist/server/repositories/notes-catalog.repo.js

@@ -1,3 +1,4 @@
+import { withSavepoint } from "../db/transaction.js";
 import { randomUUID } from 'node:crypto';
 function toNote(row) {
     return {
@@ -25,16 +26,7 @@ export class NotesCatalogRepository {
         }
     }
     transaction(run) {
-        this.db.exec('SAVEPOINT notes_catalog');
-        try {
-            const value = run();
-            this.db.exec('RELEASE notes_catalog');
-            return value;
-        }
-        catch (error) {
-            this.db.exec('ROLLBACK TO notes_catalog; RELEASE notes_catalog');
-            throw error;
-        }
+        return withSavepoint(this.db, run);
     }
     all() {
         return this.db

package/dist/server/repositories/task.repo.js

@@ -0,0 +1,114 @@
+import { ArtifactConflictError } from "../errors/artifacts.js";
+export class TaskRepository {
+    db;
+    storeId;
+    constructor(db, storeId) {
+        this.db = db;
+        this.storeId = storeId;
+    }
+    // oxlint-disable-next-line typescript/no-unnecessary-type-parameters -- The caller supplies the domain type for stored JSON.
+    get(kind, id) {
+        const row = this.db
+            .prepare(`SELECT snapshot_json FROM ${kind}_current WHERE store_id=? AND id=?`)
+            .get(this.storeId, id);
+        return row ? JSON.parse(row.snapshot_json) : undefined;
+    }
+    all(kind) {
+        return this.db
+            .prepare(`SELECT snapshot_json FROM ${kind}_current WHERE store_id=? ORDER BY id`)
+            .all(this.storeId).map(row => JSON.parse(row.snapshot_json));
+    }
+    history(kind, id) {
+        return this.db
+            .prepare(`SELECT * FROM ${kind}_versions WHERE store_id=? AND id=? ORDER BY version`)
+            .all(this.storeId, id).map(row => ({
+            snapshot: JSON.parse(row.snapshot_json),
+            requestId: row.request_id,
+            actor: JSON.parse(row.actor_json),
+            createdAt: row.created_at
+        }));
+    }
+    append(kind, snapshot, requestId, actor, now) {
+        this.db
+            .prepare(`INSERT INTO ${kind}_versions VALUES(?,?,?,?,?,?,?)`)
+            .run(this.storeId, snapshot.id, snapshot.version, requestId, JSON.stringify(snapshot), JSON.stringify(actor), now);
+        this.db
+            .prepare(`INSERT INTO ${kind}_current VALUES(?,?,?) ON CONFLICT(store_id,id) DO UPDATE SET snapshot_json=excluded.snapshot_json`)
+            .run(this.storeId, snapshot.id, JSON.stringify(snapshot));
+    }
+    // oxlint-disable-next-line typescript/no-unnecessary-type-parameters -- The command owner knows the stored result type.
+    replay(requestId, hash) {
+        if (this.db
+            .prepare('SELECT 1 FROM artifact_operations WHERE store_id=? AND request_id=?')
+            .get(this.storeId, requestId)) {
+            throw new ArtifactConflictError('Request identifier already used for an artifact operation.');
+        }
+        const row = this.db
+            .prepare('SELECT payload_hash,result_json FROM artifact_definition_operations WHERE store_id=? AND request_id=?')
+            .get(this.storeId, requestId);
+        if (!row) {
+            const reserved = this.db
+                .prepare('SELECT 1 FROM artifact_type_versions WHERE store_id=? AND request_id=?')
+                .get(this.storeId, requestId);
+            if (reserved) {
+                throw new ArtifactConflictError('Request identifier belongs to type initialization.');
+            }
+            return undefined;
+        }
+        if (row.payload_hash !== hash) {
+            throw new ArtifactConflictError('Request identifier already used for a different operation.');
+        }
+        return { result: JSON.parse(row.result_json) };
+    }
+    record(requestId, hash, result) {
+        this.db
+            .prepare('INSERT INTO artifact_definition_operations VALUES(?,?,?,?)')
+            .run(this.storeId, requestId, hash, JSON.stringify(result));
+    }
+    assertArtifactRequest(requestId) {
+        if (this.db
+            .prepare('SELECT 1 FROM artifact_definition_operations WHERE store_id=? AND request_id=?')
+            .get(this.storeId, requestId)) {
+            throw new ArtifactConflictError('Request identifier already used for a definition operation.');
+        }
+    }
+    assignment(sessionId) {
+        const row = this.db
+            .prepare('SELECT version,task_ids_json FROM task_chat_link_events WHERE store_id=? AND session_id=? ORDER BY version DESC LIMIT 1')
+            .get(this.storeId, sessionId);
+        return {
+            sessionId,
+            version: row?.version ?? 0,
+            taskIds: row ? JSON.parse(row.task_ids_json) : []
+        };
+    }
+    appendAssignment(sessionId, version, taskIds, title, requestId, actor, now) {
+        this.db
+            .prepare('INSERT INTO task_chat_link_events(store_id,session_id,version,request_id,task_ids_json,chat_title_snapshot,actor_json,created_at) VALUES(?,?,?,?,?,?,?,?)')
+            .run(this.storeId, sessionId, version, requestId, JSON.stringify(taskIds), title, JSON.stringify(actor), now);
+    }
+    chatHistory() {
+        return this.db
+            .prepare('SELECT * FROM task_chat_link_events WHERE store_id=? ORDER BY seq')
+            .all(this.storeId).map(row => ({
+            seq: row.seq,
+            sessionId: row.session_id,
+            version: row.version,
+            taskIds: JSON.parse(row.task_ids_json),
+            title: row.chat_title_snapshot,
+            actor: JSON.parse(row.actor_json),
+            createdAt: row.created_at,
+            requestId: row.request_id
+        }));
+    }
+    rebuild() {
+        for (const kind of ['task', 'artifact_type']) {
+            this.db
+                .prepare(`DELETE FROM ${kind}_current WHERE store_id=?`)
+                .run(this.storeId);
+            this.db
+                .prepare(`INSERT INTO ${kind}_current SELECT v.store_id,v.id,v.snapshot_json FROM ${kind}_versions v WHERE v.store_id=? AND v.version=(SELECT MAX(n.version) FROM ${kind}_versions n WHERE n.store_id=v.store_id AND n.id=v.id)`)
+                .run(this.storeId);
+        }
+    }
+}

package/dist/server/routes/agent.js

@@ -72,7 +72,10 @@ export async function agentRoutes(app, opts) {
             throw new NotFoundError(`Review ${reviewId} not found`);
         }
         // The agent starts in the background; failure shows up as a closed session.
-        const session = registry.create(presetId, reviewId ?? null, name);
+        const deviceId = request.access?.device.status === 'device'
+            ? request.access.device.device.id
+            : undefined;
+        const session = registry.create(presetId, reviewId ?? null, name, deviceId);
         reply.code(201);
         return session.info();
     });
@@ -125,6 +128,7 @@ export async function agentRoutes(app, opts) {
         session.assertCanPrompt();
         const blocks = await buildPromptBlocks(request.body, {
             notes: opts.notes,
+            artifacts: opts.artifacts,
             db,
             repositoryPath,
             embeddedContext: session.supportsEmbeddedContext,
@@ -250,6 +254,9 @@ export async function agentRoutes(app, opts) {
                     data: message.envelope
                 });
             }
+            else if (message.type === 'artifact-actions') {
+                safeSend(reply.sse, { event: 'artifact-actions', data: {} });
+            }
             else if (message.type === 'gap') {
                 safeSend(reply.sse, {
                     event: 'gap',