videobook-engine 5.3.3 → 5.4.0

package/dist/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../src/tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAGhB,oBAAoB,EAEpB,WAAW,EACX,wBAAwB,EACxB,MAAM,EACP,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAA0B,MAAM,cAAc,CAAC;AAMrE,OAAO,KAAK,EAEV,gBAAgB,EAChB,QAAQ,EACT,MAAM,iBAAiB,CAAC;AASzB,iDAAiD;AACjD,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAiCtC,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa;uBAQ7B,MAAM,KAAG,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC;4BAGlD,SAAS,MAAM,EAAE,KAC7B,MAAM,CAAC,gBAAgB,EAAE,EAAE,WAAW,CAAC;sBAG5B,MAAM,OACb,QAAQ,KACZ,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;0BAGnC,MAAM,QACZ,SAAS,QAAQ,EAAE,KACxB,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;yBAGnC,MAAM,OACb,gBAAgB,KACpB,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;0BAGnC,MAAM,OACb,gBAAgB,KACpB,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;;+BAIjC,MAAM,KACjB,MAAM,CAAC,oBAAoB,GAAG,SAAS,EAAE,WAAW,CAAC;yBAG/C,wBAAwB,KAC9B,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;;;;;;;;aAlB/C,CAAC;;;EAsBR"}

package/dist/tags.js

@@ -0,0 +1,488 @@
+/**
+ * Asset tags: durable automatic and user-managed tagging.
+ *
+ * The engine owns state, normalization, transactions and provenance; the
+ * consumer owns inference, scheduling and vocabulary. Three rules shape
+ * everything here:
+ *
+ * 1. Semantic identity is (facet, canonical key). Two facets carrying the
+ *    same word stay distinct assignments.
+ * 2. Manual intent outranks analysis. An automatic snapshot replaces only
+ *    the automatic rows; it can never add, drop or relabel a manual row,
+ *    and it can never clear a dismissal.
+ * 3. Automatic output is fenced to the content it described. A snapshot
+ *    records the analyzed source hash and a per-artifact generation, so a
+ *    late result cannot overwrite a newer one and tags for replaced
+ *    content drop out of the effective set instead of lying.
+ */
+import { ok } from "./engine-types.js";
+import { resultOf, syncResultOf } from "./context.js";
+import { EngineFault } from "./store.js";
+import { createTagQueriesApi } from "./tag-queries.js";
+import { automaticTagsMatch, compareTags, snapshotMatches } from "./tag-rows.js";
+import { createTagTransferApi } from "./tag-transfer.js";
+import { normalizeAutomaticTags } from "./tag-validation.js";
+import { MANUAL_TAGS_PER_ARTIFACT_MAX, TAG_DISMISSALS_PER_ARTIFACT_MAX, normalizeTagIdentity, normalizeTagList, tagIdentity, } from "./tag-values.js";
+/** Artifacts a single batched read may cover. */
+export const TAG_READ_BATCH_MAX = 500;
+const READ_CHUNK = 200;
+export function createTagsApi(context) {
+    const queries = createTagQueriesApi(context);
+    const transfer = createTagTransferApi(context, (artifactId) => tagState(context, artifactId));
+    return {
+        ...queries,
+        ...transfer,
+        read: (artifactId) => syncResultOf(() => readTagState(context, artifactId)),
+        readMany: (artifactIds) => syncResultOf(() => readTagStates(context, artifactIds)),
+        add: (artifactId, tag) => addManualTags(context, artifactId, [tag]),
+        addMany: (artifactId, tags) => addManualTags(context, artifactId, tags),
+        remove: (artifactId, tag) => removeTag(context, artifactId, tag),
+        restore: (artifactId, tag) => restoreTag(context, artifactId, tag),
+        automatic: {
+            snapshot: (artifactId) => syncResultOf(() => readSnapshot(context, artifactId)),
+            replace: (input) => replaceAutomaticTags(context, input),
+        },
+    };
+}
+// ---------------------------------------------------------------- reads
+function readTagState(context, artifactReference) {
+    const artifact = context.artifactRow(artifactReference);
+    return tagState(context, artifact.artifact_id);
+}
+function readTagStates(context, artifactReferences) {
+    if (artifactReferences.length > TAG_READ_BATCH_MAX) {
+        throw new Error(`Tag reads must cover at most ${TAG_READ_BATCH_MAX} artifacts; received ${artifactReferences.length}`);
+    }
+    const artifactIds = artifactReferences.map((reference) => context.artifactRow(reference).artifact_id);
+    const tags = chunkedRows(context, artifactIds, (placeholders) => `SELECT artifact_id, origin, facet, tag_key, label, entity_id, created_at
+       FROM artifact_tags
+       WHERE artifact_id IN (${placeholders})
+       ORDER BY artifact_id, facet, tag_key`);
+    const dismissals = chunkedRows(context, artifactIds, (placeholders) => `SELECT artifact_id, facet, tag_key, label, dismissed_at
+       FROM artifact_tag_dismissals
+       WHERE artifact_id IN (${placeholders})
+       ORDER BY artifact_id, facet, tag_key`);
+    const snapshots = chunkedRows(context, artifactIds, (placeholders) => `SELECT artifact_id, source_hash, generator, model, extractor_version,
+              tag_count, generation, analyzed_at
+       FROM artifact_tag_snapshots
+       WHERE artifact_id IN (${placeholders})`);
+    const snapshotByArtifact = new Map(snapshots.map((row) => [row.artifact_id, row]));
+    const liveHashes = artifactFileHashes(context, artifactIds);
+    return artifactIds.map((artifactId) => assembleState(artifactId, tags.filter((row) => row.artifact_id === artifactId), dismissals.filter((row) => row.artifact_id === artifactId), snapshotByArtifact.get(artifactId), liveHashes.get(artifactId) ?? new Set()));
+}
+function tagState(context, artifactId) {
+    const tags = context.store.db
+        .prepare(`SELECT artifact_id, origin, facet, tag_key, label, entity_id, created_at
+       FROM artifact_tags
+       WHERE artifact_id=?
+       ORDER BY facet, tag_key`)
+        .all(artifactId);
+    const dismissals = context.store.db
+        .prepare(`SELECT artifact_id, facet, tag_key, label, dismissed_at
+       FROM artifact_tag_dismissals
+       WHERE artifact_id=?
+       ORDER BY facet, tag_key`)
+        .all(artifactId);
+    const snapshot = snapshotRow(context, artifactId);
+    return assembleState(artifactId, tags, dismissals, snapshot, artifactFileHashes(context, [artifactId]).get(artifactId) ??
+        new Set());
+}
+/**
+ * Effective tags: every manual assignment, plus automatic assignments that
+ * are neither dismissed nor stale, deduplicated on identity with the
+ * manual display label and ownership preferred.
+ */
+function assembleState(artifactId, tagRows, dismissalRows, snapshotRow, liveHashes) {
+    const dismissed = new Set(dismissalRows.map((row) => tagIdentity(row.facet, row.tag_key)));
+    const stale = snapshotRow !== undefined && !liveHashes.has(snapshotRow.source_hash);
+    const manual = tagRows
+        .filter((row) => row.origin === "manual")
+        .map((row) => assetTag(row));
+    const automatic = tagRows
+        .filter((row) => row.origin === "automatic")
+        .map((row) => ({
+        ...assetTag(row),
+        dismissed: dismissed.has(tagIdentity(row.facet, row.tag_key)),
+        stale,
+    }));
+    const effective = [...manual];
+    const claimed = new Set(manual.map((tag) => tagIdentity(tag.facet, tag.key)));
+    for (const tag of automatic) {
+        if (tag.dismissed || tag.stale)
+            continue;
+        const identity = tagIdentity(tag.facet, tag.key);
+        if (claimed.has(identity))
+            continue;
+        claimed.add(identity);
+        effective.push({
+            facet: tag.facet,
+            key: tag.key,
+            label: tag.label,
+            origin: tag.origin,
+            ...(tag.entityId ? { entityId: tag.entityId } : {}),
+            createdAt: tag.createdAt,
+        });
+    }
+    effective.sort(compareTags);
+    return {
+        artifactId,
+        effective,
+        manual,
+        automatic,
+        dismissed: dismissalRows.map((row) => ({
+            facet: row.facet,
+            key: row.tag_key,
+            label: row.label,
+            dismissedAt: row.dismissed_at,
+        })),
+        ...(snapshotRow
+            ? { snapshot: snapshotFromRow(snapshotRow, stale) }
+            : {}),
+    };
+}
+function assetTag(row) {
+    return {
+        facet: row.facet,
+        key: row.tag_key,
+        label: row.label,
+        origin: row.origin,
+        ...(row.entity_id ? { entityId: row.entity_id } : {}),
+        createdAt: row.created_at,
+    };
+}
+function readSnapshot(context, artifactReference) {
+    const artifact = context.artifactRow(artifactReference);
+    const row = snapshotRow(context, artifact.artifact_id);
+    if (!row)
+        return undefined;
+    const hashes = artifactFileHashes(context, [artifact.artifact_id]);
+    const live = hashes.get(artifact.artifact_id) ?? new Set();
+    return snapshotFromRow(row, !live.has(row.source_hash));
+}
+function snapshotRow(context, artifactId) {
+    return context.store.db
+        .prepare(`SELECT artifact_id, source_hash, generator, model, extractor_version,
+              tag_count, generation, analyzed_at
+       FROM artifact_tag_snapshots
+       WHERE artifact_id=?`)
+        .get(artifactId);
+}
+function snapshotFromRow(row, stale) {
+    return {
+        artifactId: row.artifact_id,
+        sourceHash: row.source_hash,
+        generator: row.generator,
+        ...(row.model === null ? {} : { model: row.model }),
+        extractorVersion: row.extractor_version,
+        tagCount: row.tag_count,
+        generation: row.generation,
+        analyzedAt: row.analyzed_at,
+        stale,
+    };
+}
+/**
+ * Current content hashes per artifact. An automatic snapshot is stale once
+ * the hash it analyzed is no longer one of the artifact's files, which is
+ * how replaced originals drop their automatic tags without deleting the
+ * provenance that explains them.
+ */
+function artifactFileHashes(context, artifactIds) {
+    const rows = chunkedRows(context, artifactIds, (placeholders) => `SELECT artifact_id, object_hash FROM artifact_files
+       WHERE artifact_id IN (${placeholders})`);
+    const hashes = new Map();
+    for (const row of rows) {
+        const existing = hashes.get(row.artifact_id);
+        if (existing)
+            existing.add(row.object_hash);
+        else
+            hashes.set(row.artifact_id, new Set([row.object_hash]));
+    }
+    return hashes;
+}
+function chunkedRows(context, artifactIds, sql) {
+    const rows = [];
+    const uniqueIds = [...new Set(artifactIds)];
+    for (let index = 0; index < uniqueIds.length; index += READ_CHUNK) {
+        const chunk = uniqueIds.slice(index, index + READ_CHUNK);
+        if (chunk.length === 0)
+            continue;
+        const placeholders = chunk.map(() => "?").join(", ");
+        rows.push(...context.store.db
+            .prepare(sql(placeholders))
+            .all(...chunk));
+    }
+    return rows;
+}
+// --------------------------------------------------------------- writes
+async function addManualTags(context, artifactReference, inputs) {
+    return resultOf(() => context.store.semanticOperation((commit) => {
+        const artifact = context.artifactRow(artifactReference);
+        const artifactId = artifact.artifact_id;
+        const tags = normalizeTagList(inputs);
+        if (tags.length === 0) {
+            throw new Error("At least one tag is required");
+        }
+        for (const tag of tags)
+            requireEntity(context, tag);
+        const existing = manualRowsByIdentity(context, artifactId);
+        const added = tags.filter((tag) => !existing.has(tagIdentity(tag.facet, tag.key)));
+        const total = existing.size + added.length;
+        if (total > MANUAL_TAGS_PER_ARTIFACT_MAX) {
+            throw new EngineFault({
+                code: "RESOURCE_EXHAUSTED",
+                message: `Artifact ${artifactId} would carry ${total} manual tags; the limit is ` +
+                    `${MANUAL_TAGS_PER_ARTIFACT_MAX}`,
+                details: { artifactId, requested: total, limit: MANUAL_TAGS_PER_ARTIFACT_MAX },
+            });
+        }
+        const dismissed = dismissedIdentities(context, artifactId);
+        const changed = tags.filter((tag) => {
+            const identity = tagIdentity(tag.facet, tag.key);
+            if (dismissed.has(identity))
+                return true;
+            const row = existing.get(identity);
+            if (!row)
+                return true;
+            return row.label !== tag.label || (row.entity_id ?? undefined) !== tag.entityId;
+        });
+        if (changed.length === 0)
+            return ok(tagState(context, artifactId));
+        const mutation = commit({
+            operation: "add_artifact_tags",
+            tables: ["artifact_tags", "artifact_tag_dismissals"],
+            artifactId,
+            details: { artifactId, tags: changed.map(identityDetail) },
+            writeSet: changed.map((tag) => writeSetKey(artifactId, tag)),
+        }, (_operationId, now) => {
+            const insert = context.store.db.prepare(`INSERT INTO artifact_tags(
+             artifact_id, origin, facet, tag_key, label, entity_id, created_at
+           ) VALUES (?, 'manual', ?, ?, ?, ?, ?)
+           ON CONFLICT(artifact_id, origin, facet, tag_key) DO UPDATE SET
+             label=excluded.label,
+             entity_id=excluded.entity_id`);
+            const clearDismissal = context.store.db.prepare(`DELETE FROM artifact_tag_dismissals
+           WHERE artifact_id=? AND facet=? AND tag_key=?`);
+            for (const tag of changed) {
+                insert.run(artifactId, tag.facet, tag.key, tag.label, tag.entityId ?? null, now);
+                // An explicit add is explicit consent: it clears the durable
+                // suppression that a previous removal recorded.
+                clearDismissal.run(artifactId, tag.facet, tag.key);
+            }
+        });
+        return ok(tagState(context, artifactId), mutation.revision);
+    }));
+}
+async function removeTag(context, artifactReference, input) {
+    return resultOf(() => context.store.semanticOperation((commit) => {
+        const artifact = context.artifactRow(artifactReference);
+        const artifactId = artifact.artifact_id;
+        const identity = normalizeTagIdentity(input);
+        const manual = manualRowsByIdentity(context, artifactId).get(tagIdentity(identity.facet, identity.key));
+        const dismissal = context.store.db
+            .prepare(`SELECT artifact_id, facet, tag_key, label, dismissed_at
+         FROM artifact_tag_dismissals
+         WHERE artifact_id=? AND facet=? AND tag_key=?`)
+            .get(artifactId, identity.facet, identity.key);
+        if (!manual && dismissal)
+            return ok(tagState(context, artifactId));
+        if (!dismissal)
+            assertDismissalCapacity(context, artifactId);
+        // The dismissal keeps the label the user actually saw, so a restored
+        // suppression reads the same way it did when it was removed.
+        const label = manual?.label ?? automaticLabel(context, artifactId, identity) ??
+            identity.label;
+        const mutation = commit({
+            operation: "remove_artifact_tag",
+            tables: ["artifact_tags", "artifact_tag_dismissals"],
+            artifactId,
+            details: {
+                artifactId,
+                facet: identity.facet,
+                key: identity.key,
+            },
+            writeSet: [writeSetKey(artifactId, identity)],
+        }, (_operationId, now) => {
+            context.store.db
+                .prepare(`DELETE FROM artifact_tags
+             WHERE artifact_id=? AND origin='manual' AND facet=? AND tag_key=?`)
+                .run(artifactId, identity.facet, identity.key);
+            context.store.db
+                .prepare(`INSERT INTO artifact_tag_dismissals(
+               artifact_id, facet, tag_key, label, dismissed_at
+             ) VALUES (?, ?, ?, ?, ?)
+             ON CONFLICT(artifact_id, facet, tag_key) DO UPDATE SET
+               label=excluded.label`)
+                .run(artifactId, identity.facet, identity.key, label, now);
+        });
+        return ok(tagState(context, artifactId), mutation.revision);
+    }));
+}
+async function restoreTag(context, artifactReference, input) {
+    return resultOf(() => context.store.semanticOperation((commit) => {
+        const artifact = context.artifactRow(artifactReference);
+        const artifactId = artifact.artifact_id;
+        const identity = normalizeTagIdentity(input);
+        const present = context.store.db
+            .prepare(`SELECT 1 AS present FROM artifact_tag_dismissals
+         WHERE artifact_id=? AND facet=? AND tag_key=?`)
+            .get(artifactId, identity.facet, identity.key);
+        if (!present)
+            return ok(tagState(context, artifactId));
+        const mutation = commit({
+            operation: "restore_artifact_tag",
+            tables: ["artifact_tag_dismissals"],
+            artifactId,
+            details: { artifactId, facet: identity.facet, key: identity.key },
+            writeSet: [writeSetKey(artifactId, identity)],
+        }, () => {
+            context.store.db
+                .prepare(`DELETE FROM artifact_tag_dismissals
+             WHERE artifact_id=? AND facet=? AND tag_key=?`)
+                .run(artifactId, identity.facet, identity.key);
+        });
+        return ok(tagState(context, artifactId), mutation.revision);
+    }));
+}
+async function replaceAutomaticTags(context, input) {
+    return resultOf(() => context.store.semanticOperation((commit) => {
+        const artifact = context.artifactRow(input.artifactId);
+        const artifactId = artifact.artifact_id;
+        const { sourceHash, generator, extractorVersion, model, tags } = normalizeAutomaticTags(input);
+        if (input.expectedGeneration !== undefined &&
+            (!Number.isSafeInteger(input.expectedGeneration) || input.expectedGeneration < 0)) {
+            throw new Error("Automatic tag expectedGeneration must be a nonnegative integer");
+        }
+        for (const tag of tags)
+            requireEntity(context, tag);
+        const current = snapshotRow(context, artifactId);
+        const generation = current?.generation ?? 0;
+        if (input.expectedGeneration !== undefined &&
+            input.expectedGeneration !== generation) {
+            throw new EngineFault({
+                code: "STALE_REVISION",
+                message: `Automatic tags for ${artifactId} expected generation ` +
+                    `${input.expectedGeneration} but the catalog is at ${generation}`,
+                details: {
+                    artifactId,
+                    expectedGeneration: input.expectedGeneration,
+                    generation,
+                },
+            });
+        }
+        if (snapshotMatches(current, {
+            sourceHash,
+            generator,
+            ...(model ? { model } : {}),
+            extractorVersion,
+        }) &&
+            automaticTagsMatch(context.store.db, artifactId, tags)) {
+            // Re-running the same analyzer over the same bytes with the same
+            // answer is not history; it mints no commit and does not advance
+            // the fence.
+            return ok(tagState(context, artifactId));
+        }
+        const mutation = commit({
+            operation: "replace_automatic_artifact_tags",
+            tables: ["artifact_tags", "artifact_tag_snapshots"],
+            artifactId,
+            details: {
+                artifactId,
+                sourceHash,
+                generator,
+                extractorVersion,
+                generation: generation + 1,
+                tags: tags.map(identityDetail),
+            },
+            writeSet: [`artifact-tags-automatic:${artifactId}`],
+        }, (_operationId, now) => {
+            context.store.db
+                .prepare("DELETE FROM artifact_tags WHERE artifact_id=? AND origin='automatic'")
+                .run(artifactId);
+            const insert = context.store.db.prepare(`INSERT INTO artifact_tags(
+             artifact_id, origin, facet, tag_key, label, entity_id, created_at
+           ) VALUES (?, 'automatic', ?, ?, ?, ?, ?)`);
+            for (const tag of tags) {
+                insert.run(artifactId, tag.facet, tag.key, tag.label, tag.entityId ?? null, now);
+            }
+            context.store.db
+                .prepare(`INSERT INTO artifact_tag_snapshots(
+               artifact_id, source_hash, generator, model, extractor_version,
+               tag_count, generation, analyzed_at
+             ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+             ON CONFLICT(artifact_id) DO UPDATE SET
+               source_hash=excluded.source_hash,
+               generator=excluded.generator,
+               model=excluded.model,
+               extractor_version=excluded.extractor_version,
+               tag_count=excluded.tag_count,
+               generation=excluded.generation,
+               analyzed_at=excluded.analyzed_at`)
+                .run(artifactId, sourceHash, generator, model || null, extractorVersion, tags.length, generation + 1, now);
+        });
+        return ok(tagState(context, artifactId), mutation.revision);
+    }));
+}
+// --------------------------------------------------------------- helpers
+function manualRowsByIdentity(context, artifactId) {
+    const rows = context.store.db
+        .prepare(`SELECT artifact_id, origin, facet, tag_key, label, entity_id, created_at
+       FROM artifact_tags
+       WHERE artifact_id=? AND origin='manual'`)
+        .all(artifactId);
+    return new Map(rows.map((row) => [tagIdentity(row.facet, row.tag_key), row]));
+}
+function dismissedIdentities(context, artifactId) {
+    const rows = context.store.db
+        .prepare("SELECT facet, tag_key FROM artifact_tag_dismissals WHERE artifact_id=?")
+        .all(artifactId);
+    return new Set(rows.map((row) => tagIdentity(row.facet, row.tag_key)));
+}
+function assertDismissalCapacity(context, artifactId) {
+    const row = context.store.db
+        .prepare("SELECT COUNT(*) AS total FROM artifact_tag_dismissals WHERE artifact_id=?")
+        .get(artifactId);
+    if (row.total >= TAG_DISMISSALS_PER_ARTIFACT_MAX) {
+        throw new EngineFault({
+            code: "RESOURCE_EXHAUSTED",
+            message: `Artifact ${artifactId} already carries ${row.total} dismissals; the limit is ` +
+                `${TAG_DISMISSALS_PER_ARTIFACT_MAX}`,
+            details: {
+                artifactId,
+                total: row.total,
+                limit: TAG_DISMISSALS_PER_ARTIFACT_MAX,
+            },
+        });
+    }
+}
+function automaticLabel(context, artifactId, identity) {
+    const row = context.store.db
+        .prepare(`SELECT label FROM artifact_tags
+       WHERE artifact_id=? AND origin='automatic' AND facet=? AND tag_key=?`)
+        .get(artifactId, identity.facet, identity.key);
+    return row?.label;
+}
+/**
+ * Entity references are carried, never invented: a tag may point at an
+ * entity the caller has already confirmed, and the reference must resolve.
+ */
+function requireEntity(context, tag) {
+    if (!tag.entityId)
+        return;
+    const row = context.store.db
+        .prepare("SELECT 1 AS present FROM entities WHERE entity_id=?")
+        .get(tag.entityId);
+    if (!row) {
+        throw new EngineFault({
+            code: "NOT_FOUND",
+            message: `Tag entity does not exist: ${tag.entityId}`,
+            details: { entityId: tag.entityId },
+        });
+    }
+}
+function identityDetail(tag) {
+    return tagIdentity(tag.facet, tag.key);
+}
+function writeSetKey(artifactId, tag) {
+    return `artifact-tag:${artifactId}:${tagIdentity(tag.facet, tag.key)}`;
+}
+//# sourceMappingURL=tags.js.map

package/dist/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../src/tags.ts"],"names":[],"mappings":"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"}

package/docs/engine-layout.md

@@ -105,7 +105,7 @@ Notation used below:
 - `→` names the referenced column.
 - Defaults and checks are shown inline.
 
-There are 34 allowlisted semantic tables.
+There are 36 allowlisted semantic tables.
 
 ### Catalog, artifacts, and content
 
@@ -136,6 +136,89 @@ There are 34 allowlisted semantic tables.
 | `runs` | `run_id TEXT`<br>`notebook_id TEXT`<br>`status TEXT`<br>`started_at INTEGER`<br>`completed_at INTEGER`<br>`cell_order_json TEXT`<br>`outputs_json TEXT`<br>`error TEXT?` | `run_id PK`; notebook `FK → notebooks ON DELETE CASCADE`; `status CHECK IN (completed, failed, aborted)`. Terminal, versioned notebook execution records. |
 | `generations` | `generation_id TEXT`<br>`notebook_id TEXT`<br>`cell_id TEXT`<br>`output_cell_id TEXT?`<br>`run_id TEXT?`<br>`status TEXT`<br>`tool TEXT`<br>`provider TEXT?`<br>`model TEXT?`<br>`prompt TEXT?`<br>`resolved_prompt TEXT?`<br>`provider_artifact_id TEXT?`<br>`output_artifact_id TEXT?`<br>`error TEXT?`<br>`created_at INTEGER`<br>`updated_at INTEGER` | `generation_id PK`; composite cell FK with cascade; `status CHECK IN (dispatched, awaiting_provider, completed, failed)`. One row per generation attempt; every transition is its own attributed semantic commit, so `dolt_history_generations` is the per-attempt timeline. |
 
+### Asset tags
+
+Flat, book-local tags on artifacts. Semantic identity is the pair
+(`facet`, `tag_key`) — never the display label alone — so the same word in
+two facets stays two assignments. Manual and automatic assignments share
+one table keyed by `origin`: replacing an automatic snapshot deletes and
+reinserts only the `automatic` rows, so it can never add, drop or relabel
+a manual row. Dismissals are a separate durable record of user intent that
+outlives any snapshot, which is what stops re-analysis from resurrecting a
+tag the user removed.
+
+| Table | Columns | Keys, constraints, and purpose |
+| --- | --- | --- |
+| `artifact_tags` | `artifact_id TEXT`<br>`origin TEXT`<br>`facet TEXT`<br>`tag_key TEXT`<br>`label TEXT`<br>`entity_id TEXT?`<br>`created_at INTEGER` | `(artifact_id, origin, facet, tag_key) PK`; `artifact_id FK → artifacts.artifact_id ON DELETE CASCADE`; `entity_id FK → entities.entity_id ON DELETE RESTRICT`; `origin CHECK IN (manual, automatic)`; `facet CHECK IN (people, places, editing, custom)`. `tag_key` is the NFKC-normalized, whitespace-collapsed, lowercased key; `label` is the display form. A tag may carry an already-confirmed entity reference, and holding one keeps that entity alive (`engine.entities.delete` returns `IN_USE`). |
+| `artifact_tag_dismissals` | `artifact_id TEXT`<br>`facet TEXT`<br>`tag_key TEXT`<br>`label TEXT`<br>`dismissed_at INTEGER` | `(artifact_id, facet, tag_key) PK`; `artifact_id FK → artifacts.artifact_id ON DELETE CASCADE`. One row per suppressed identity. Suppression is applied when tags are read, so the automatic row keeps the provenance that explains it while staying invisible. Adding the identity manually deletes the row; `engine.tags.restore` deletes it without claiming ownership. |
+| `artifact_tag_snapshots` | `artifact_id TEXT`<br>`source_hash TEXT`<br>`generator TEXT`<br>`model TEXT?`<br>`extractor_version TEXT`<br>`tag_count INTEGER`<br>`generation INTEGER`<br>`analyzed_at INTEGER` | `artifact_id PK`; `artifact_id FK → artifacts.artifact_id ON DELETE CASCADE`; `tag_count CHECK >= 0`; `generation CHECK > 0`. The last successful automatic analysis. A row with `tag_count` 0 is a successful empty result; no row at all means no successful analysis. `extractor_version` includes the editorial tag-policy version so a policy change can drive selective refresh. `generation` is the per-artifact fence: a caller may pass `expectedGeneration` and a mismatch is refused with `STALE_REVISION`. |
+
+`source_hash` is a content fingerprint, deliberately **not** an `objects`
+foreign key and not a first-class `object_hash` column: tags neither pin
+bytes against GC nor block forgetting. An automatic snapshot is stale once
+that hash is no longer one of the artifact's `artifact_files` rows, and
+stale automatic tags drop out of the effective set instead of describing
+content that is gone.
+
+Effective tags are every manual assignment plus every automatic assignment
+that is neither dismissed nor stale, deduplicated on identity with the
+manual label and ownership preferred. Documented limits: 64 Unicode code
+points per label, 100 manual tags per artifact, 12 automatic tags per
+snapshot, 500 dismissals per artifact. Exceeding one is refused with
+`RESOURCE_EXHAUSTED` rather than silently dropping user intent.
+
+Automatic analysis uses the `people`, `places`, and `editing` facets;
+`custom` is reserved for manual tags. Writes check generation fences,
+capacity, and no-op decisions inside the same serialized SQL transaction
+as their mutation. Imports apply the same automatic metadata and size
+validation, and count duplicate dismissals only once. The browser-safe
+`videobook-engine/tag-values` subpath exposes normalization and limits.
+
+`engine.tags.query` filters artifacts on that same effective set: `all`
+(every identity), `any` (at least one), and `kinds`, with keyset paging and
+a total that counts every match rather than the current page.
+`engine.tags.candidates` returns the unpaged matching IDs so the
+application can compose a tag filter with temporal or semantic search
+before either applies a limit. `engine.tags.facets` counts distinct
+matching artifacts per identity, and `engine.tags.suggest` completes known
+keys by prefix and facet; both prefer the manual display label. The
+effective-tag rule is written once as SQL in `src/tag-queries.ts` and once
+in TypeScript in `src/tags.ts`, and `tests/tag-queries.test.ts` asserts the
+two agree.
+
+Tag rows are ordinary semantic rows, so history needs no special case:
+`history.restore` reloads them from their `dolt_at_*` projections like
+every other table, and an explicit restore may therefore rewind manual
+edits that routine re-analysis never can. Restoring a revision recorded
+under an older schema stays refused by the existing version guard.
+`engine.tags.readAtRevision` reports the state a revision recorded; a
+revision written before schema 25 has no tag state at all and yields an
+empty snapshot rather than an error.
+
+`engine.tags.export` produces a portable snapshot — manual tags,
+dismissals, and automatic evidence only while it is still valid — and
+`engine.tags.import` applies one to another artifact, in the same catalog
+or a different engine. Import never trusts the source: labels are
+re-normalized into destination-local identities, an entity reference
+survives only when that entity exists in the destination, and automatic
+evidence transfers only when the destination artifact carries the exact
+analyzed hash. A hash-identical duplicate therefore inherits automatic
+tags; a modified or generated derivative inherits only manual intent, with
+`skippedAutomatic` saying so.
+Re-importing unchanged, valid evidence is a no-op and leaves
+`skippedAutomatic` false.
+
+Merges treat an automatic snapshot and its tag rows as one unit. Competing
+answers for the same artifact conflict even when their metadata agrees;
+the engine never combines two automatic sets into an invented analysis.
+Merges also reject combined manual or dismissal sets that exceed the
+per-artifact limits, before changing the accepted catalog.
+
+Query cost is fixed, not proportional to catalog size: `query` is three
+statements (page, total, page tags), `candidates` one, and `facets` two
+(counts, then preferred labels). `tests/tag-queries.test.ts` measures those
+counts against a catalog ten times larger and asserts they do not move.
+
 ### Sequence timeline and media editing state
 
 Sequences are the single timeline model. `sequences`, `sequence_tracks`,
@@ -361,6 +444,9 @@ schema additionally defines every index below.
 | `prompt_entries_lookup` | `prompt_entries(surface, created_at, prompt_id)` |
 | `messages_created` | `messages(created_at, message_id)` |
 | `generations_cell` | `generations(notebook_id, cell_id, created_at)` |
+| `artifact_tags_identity` | `artifact_tags(facet, tag_key, artifact_id)` |
+| `artifact_tags_entity` | `artifact_tags(entity_id)` |
+| `artifact_tag_dismissals_identity` | `artifact_tag_dismissals(facet, tag_key, artifact_id)` |
 
 ## Local-only runtime schema
 
@@ -728,6 +814,8 @@ must reproduce a render.
 | Content-addressed object layout, remote keys, deletion | [`src/cas.ts`](../src/cas.ts) |
 | Object publication, deletion, GC, and catalog backup | [`src/storage.ts`](../src/storage.ts) |
 | Artifact mappings and workspace materialization | [`src/files.ts`](../src/files.ts) |
+| Asset tag state, precedence, and snapshots | [`src/tags.ts`](../src/tags.ts), [`src/tag-values.ts`](../src/tag-values.ts) |
+| Asset tag schema upgrade (24 to 25) | [`src/migrate-tags-v24.ts`](../src/migrate-tags-v24.ts) |
 | Sequence reads/structure and transactional edits | [`src/sequences.ts`](../src/sequences.ts), [`src/edits.ts`](../src/edits.ts) |
 | Public manifest, job, status, and similarity types | [`src/engine-types.ts`](../src/engine-types.ts) |
 | Entity/notebook graph types | [`src/notebook/types.ts`](../src/notebook/types.ts) |