videobook-engine 5.3.2 → 5.4.0

package/dist/tag-queries.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Tag queries: filtering, facet counts and autocomplete over effective
+ * tags.
+ *
+ * "Effective" means exactly what `engine.tags.read` reports: every manual
+ * assignment, plus automatic assignments that are neither dismissed nor
+ * stale. That rule lives once in SQL here and once in TypeScript in
+ * `src/tags.ts`; `tests/tag-queries.test.ts` asserts the two agree.
+ *
+ * Every query is one indexed statement against the catalog — never a
+ * per-artifact round trip and never a JSON scan — and every result set is
+ * bounded by a documented limit.
+ */
+import type { EngineError, Result, TagFacetCount, TagFilter, TagQueryOptions, TagQueryPage, TagSuggestQuery } from "./engine-types.js";
+import { EngineContext } from "./context.js";
+export declare const TAG_QUERY_LIMIT_DEFAULT = 50;
+export declare const TAG_QUERY_LIMIT_MAX = 500;
+export declare const TAG_FACET_LIMIT_DEFAULT = 50;
+export declare const TAG_FACET_LIMIT_MAX = 500;
+/** Candidate IDs a single call may hand to a composing search. */
+export declare const TAG_CANDIDATE_MAX = 5000;
+export declare function createTagQueriesApi(context: EngineContext): {
+    query: (filter?: TagFilter, options?: TagQueryOptions) => Result<TagQueryPage, EngineError>;
+    candidates: (filter?: TagFilter) => Result<string[], EngineError>;
+    facets: (filter?: TagFilter, options?: {
+        limit?: number;
+    }) => Result<TagFacetCount[], EngineError>;
+    suggest: (query?: TagSuggestQuery) => Result<TagFacetCount[], EngineError>;
+};
+//# sourceMappingURL=tag-queries.d.ts.map

package/dist/tag-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-queries.d.ts","sourceRoot":"","sources":["../src/tag-queries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAIV,WAAW,EACX,MAAM,EACN,aAAa,EACb,SAAS,EACT,eAAe,EACf,YAAY,EACZ,eAAe,EAEhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAgB,MAAM,cAAc,CAAC;AAS3D,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAkEtC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa;qBAG5C,SAAS,YACR,eAAe,KACvB,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC;0BAEf,SAAS,KAAQ,MAAM,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC;sBAGzD,SAAS,YACR;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAC1B,MAAM,CAAC,aAAa,EAAE,EAAE,WAAW,CAAC;sBAG9B,eAAe,KACrB,MAAM,CAAC,aAAa,EAAE,EAAE,WAAW,CAAC;EAG1C"}

package/dist/tag-queries.js

@@ -0,0 +1,313 @@
+/**
+ * Tag queries: filtering, facet counts and autocomplete over effective
+ * tags.
+ *
+ * "Effective" means exactly what `engine.tags.read` reports: every manual
+ * assignment, plus automatic assignments that are neither dismissed nor
+ * stale. That rule lives once in SQL here and once in TypeScript in
+ * `src/tags.ts`; `tests/tag-queries.test.ts` asserts the two agree.
+ *
+ * Every query is one indexed statement against the catalog — never a
+ * per-artifact round trip and never a JSON scan — and every result set is
+ * bounded by a documented limit.
+ */
+import { syncResultOf } from "./context.js";
+import { assertTagFacet, normalizeTagIdentity, normalizeTagPrefix, tagIdentity, } from "./tag-values.js";
+export const TAG_QUERY_LIMIT_DEFAULT = 50;
+export const TAG_QUERY_LIMIT_MAX = 500;
+export const TAG_FACET_LIMIT_DEFAULT = 50;
+export const TAG_FACET_LIMIT_MAX = 500;
+/** Candidate IDs a single call may hand to a composing search. */
+export const TAG_CANDIDATE_MAX = 5000;
+/**
+ * The effective-tag projection. Manual rows always count; automatic rows
+ * count only while no dismissal suppresses their identity and the
+ * snapshot's analyzed hash is still one of the artifact's files.
+ */
+const EFFECTIVE_TAGS_SQL = `
+  SELECT t.artifact_id, t.facet, t.tag_key, t.label, t.origin
+  FROM artifact_tags t
+  WHERE t.origin='manual'
+  UNION ALL
+  SELECT t.artifact_id, t.facet, t.tag_key, t.label, t.origin
+  FROM artifact_tags t
+  JOIN artifact_tag_snapshots s ON s.artifact_id = t.artifact_id
+  WHERE t.origin='automatic'
+    AND NOT EXISTS (
+      SELECT 1 FROM artifact_tag_dismissals d
+      WHERE d.artifact_id = t.artifact_id
+        AND d.facet = t.facet
+        AND d.tag_key = t.tag_key
+    )
+    AND EXISTS (
+      SELECT 1 FROM artifact_files f
+      WHERE f.artifact_id = s.artifact_id
+        AND f.object_hash = s.source_hash
+    )
+`;
+export function createTagQueriesApi(context) {
+    return {
+        query: (filter = {}, options = {}) => syncResultOf(() => queryTags(context, filter, options)),
+        candidates: (filter = {}) => syncResultOf(() => candidateIds(context, filter)),
+        facets: (filter = {}, options = {}) => syncResultOf(() => facetCounts(context, filter, options.limit)),
+        suggest: (query = {}) => syncResultOf(() => suggestTags(context, query)),
+    };
+}
+// --------------------------------------------------------------- filter
+/**
+ * Turns a filter into the artifact-selection clause. `all` and `any` each
+ * become one grouped lookup through the tag identity index, so a filter
+ * costs one statement regardless of how many artifacts it spans.
+ */
+function filterClause(filter) {
+    const parts = [];
+    const params = [];
+    const kinds = filter.kinds ?? [];
+    if (kinds.length > 0) {
+        parts.push(`a.kind IN (${kinds.map(() => "?").join(", ")})`);
+        params.push(...kinds);
+    }
+    const all = normalizeIdentities(filter.all);
+    if (all.length > 0) {
+        const pairs = identityPredicate(all);
+        parts.push(`a.artifact_id IN (
+         SELECT e.artifact_id FROM effective e
+         WHERE ${pairs.sql}
+         GROUP BY e.artifact_id
+         HAVING COUNT(DISTINCT e.facet || ':' || e.tag_key) = ?
+       )`);
+        params.push(...pairs.params, all.length);
+    }
+    const any = normalizeIdentities(filter.any);
+    if (any.length > 0) {
+        const pairs = identityPredicate(any);
+        parts.push(`a.artifact_id IN (
+         SELECT e.artifact_id FROM effective e WHERE ${pairs.sql}
+       )`);
+        params.push(...pairs.params);
+    }
+    return {
+        sql: parts.length > 0 ? parts.join("\n    AND ") : "1=1",
+        params,
+    };
+}
+function normalizeIdentities(inputs) {
+    if (!inputs || inputs.length === 0)
+        return [];
+    const seen = new Set();
+    const identities = [];
+    for (const input of inputs) {
+        const { facet, key } = normalizeTagIdentity(input);
+        const identity = tagIdentity(facet, key);
+        if (seen.has(identity))
+            continue;
+        seen.add(identity);
+        identities.push({ facet, key });
+    }
+    return identities;
+}
+function identityPredicate(identities) {
+    return {
+        sql: identities.map(() => "(e.facet = ? AND e.tag_key = ?)").join(" OR "),
+        params: identities.flatMap((identity) => [identity.facet, identity.key]),
+    };
+}
+// ---------------------------------------------------------------- pages
+function queryTags(context, filter, options) {
+    const limit = boundedLimit(options.limit, TAG_QUERY_LIMIT_DEFAULT, TAG_QUERY_LIMIT_MAX, "Tag query limit");
+    const where = filterClause(filter);
+    const cursor = decodeCursor(options.cursor);
+    const cursorClause = cursor
+        ? " AND (a.created_at > ? OR (a.created_at = ? AND a.artifact_id > ?))"
+        : "";
+    const cursorParams = cursor
+        ? [cursor.createdAt, cursor.createdAt, cursor.artifactId]
+        : [];
+    const rows = context.store.db
+        .prepare(`WITH effective AS (${EFFECTIVE_TAGS_SQL})
+       SELECT a.artifact_id, a.label, a.kind, a.created_at
+       FROM artifacts a
+       WHERE ${where.sql}${cursorClause}
+       ORDER BY a.created_at, a.artifact_id
+       LIMIT ?`)
+        .all(...where.params, ...cursorParams, limit + 1);
+    const page = rows.slice(0, limit);
+    const total = countMatches(context, where);
+    const last = page.at(-1);
+    const tags = effectiveTagsFor(context, page.map((row) => row.artifact_id));
+    return {
+        artifacts: page.map((row) => ({
+            artifact: artifactOf(context, row),
+            tags: tags.get(row.artifact_id) ?? [],
+        })),
+        total,
+        ...(rows.length > limit && last
+            ? { nextCursor: encodeCursor(last.created_at, last.artifact_id) }
+            : {}),
+    };
+}
+function candidateIds(context, filter) {
+    const where = filterClause(filter);
+    const rows = context.store.db
+        .prepare(`WITH effective AS (${EFFECTIVE_TAGS_SQL})
+       SELECT a.artifact_id
+       FROM artifacts a
+       WHERE ${where.sql}
+       ORDER BY a.created_at, a.artifact_id
+       LIMIT ?`)
+        .all(...where.params, TAG_CANDIDATE_MAX);
+    return rows.map((row) => row.artifact_id);
+}
+function countMatches(context, where) {
+    const row = context.store.db
+        .prepare(`WITH effective AS (${EFFECTIVE_TAGS_SQL})
+       SELECT COUNT(*) AS total FROM artifacts a WHERE ${where.sql}`)
+        .get(...where.params);
+    return row.total;
+}
+function artifactOf(context, row) {
+    return context.artifact({
+        artifact_id: row.artifact_id,
+        label: row.label,
+        kind: row.kind,
+        created_at: row.created_at,
+    });
+}
+/** Effective tags for one page of artifacts, in one statement. */
+function effectiveTagsFor(context, artifactIds) {
+    const tags = new Map();
+    if (artifactIds.length === 0)
+        return tags;
+    const placeholders = artifactIds.map(() => "?").join(", ");
+    const rows = context.store.db
+        .prepare(`WITH effective AS (${EFFECTIVE_TAGS_SQL})
+       SELECT e.artifact_id, e.facet, e.tag_key, e.label, e.origin,
+              t.created_at, t.entity_id
+       FROM effective e
+       JOIN artifact_tags t
+         ON t.artifact_id = e.artifact_id
+        AND t.origin = e.origin
+        AND t.facet = e.facet
+        AND t.tag_key = e.tag_key
+       WHERE e.artifact_id IN (${placeholders})
+       ORDER BY e.artifact_id, e.facet, e.tag_key, e.origin DESC`)
+        .all(...artifactIds);
+    for (const row of rows) {
+        const existing = tags.get(row.artifact_id) ?? [];
+        // origin DESC puts 'manual' first, so a manual assignment claims the
+        // identity and the automatic duplicate is dropped, exactly as
+        // engine.tags.read reports it.
+        if (existing.some((tag) => tag.facet === row.facet && tag.key === row.tag_key)) {
+            continue;
+        }
+        existing.push({
+            facet: row.facet,
+            key: row.tag_key,
+            label: row.label,
+            origin: row.origin,
+            ...(row.entity_id ? { entityId: row.entity_id } : {}),
+            createdAt: row.created_at,
+        });
+        tags.set(row.artifact_id, existing);
+    }
+    return tags;
+}
+// --------------------------------------------------------------- facets
+function facetCounts(context, filter, requestedLimit) {
+    const limit = boundedLimit(requestedLimit, TAG_FACET_LIMIT_DEFAULT, TAG_FACET_LIMIT_MAX, "Tag facet limit");
+    const where = filterClause(filter);
+    return countedFacets(context, where, limit, undefined);
+}
+function suggestTags(context, query) {
+    const limit = boundedLimit(query.limit, TAG_FACET_LIMIT_DEFAULT, TAG_FACET_LIMIT_MAX, "Tag suggestion limit");
+    const prefix = normalizeTagPrefix(query.prefix ?? "");
+    const parts = [];
+    const params = [];
+    if (query.facet) {
+        parts.push("e.facet = ?");
+        params.push(assertTagFacet(query.facet));
+    }
+    if (prefix) {
+        parts.push("e.tag_key LIKE ? ESCAPE '\\'");
+        params.push(`${escapeLike(prefix)}%`);
+    }
+    const where = filterClause({
+        ...(query.kinds ? { kinds: query.kinds } : {}),
+    });
+    return countedFacets(context, where, limit, {
+        sql: parts.length > 0 ? parts.join(" AND ") : "1=1",
+        params,
+    });
+}
+/**
+ * Distinct matching artifacts per identity — never assignment rows and
+ * never only the current page — with the manual display label preferred.
+ */
+function countedFacets(context, where, limit, identityFilter) {
+    const extra = identityFilter ? ` AND (${identityFilter.sql})` : "";
+    const rows = context.store.db
+        .prepare(`WITH effective AS (${EFFECTIVE_TAGS_SQL})
+       SELECT e.facet, e.tag_key, COUNT(DISTINCT e.artifact_id) AS artifacts
+       FROM effective e
+       JOIN artifacts a ON a.artifact_id = e.artifact_id
+       WHERE ${where.sql}${extra}
+       GROUP BY e.facet, e.tag_key
+       ORDER BY artifacts DESC, e.facet, e.tag_key
+       LIMIT ?`)
+        .all(...where.params, ...(identityFilter?.params ?? []), limit);
+    if (rows.length === 0)
+        return [];
+    const labels = preferredLabels(context, rows);
+    return rows.map((row) => ({
+        facet: row.facet,
+        key: row.tag_key,
+        label: labels.get(tagIdentity(row.facet, row.tag_key)) ?? row.tag_key,
+        artifacts: row.artifacts,
+    }));
+}
+function preferredLabels(context, rows) {
+    const predicate = rows.map(() => "(facet = ? AND tag_key = ?)").join(" OR ");
+    const params = rows.flatMap((row) => [row.facet, row.tag_key]);
+    const labelRows = context.store.db
+        .prepare(`WITH effective AS (${EFFECTIVE_TAGS_SQL})
+       SELECT facet, tag_key, origin, label FROM effective
+       WHERE ${predicate}
+       ORDER BY facet, tag_key, origin DESC, label`)
+        .all(...params);
+    const labels = new Map();
+    for (const row of labelRows) {
+        // origin DESC lists 'manual' first, so the user's spelling wins.
+        const identity = tagIdentity(row.facet, row.tag_key);
+        if (!labels.has(identity))
+            labels.set(identity, row.label);
+    }
+    return labels;
+}
+// -------------------------------------------------------------- helpers
+function boundedLimit(requested, fallback, max, label) {
+    if (requested === undefined)
+        return fallback;
+    if (!Number.isInteger(requested) || requested < 1 || requested > max) {
+        throw new Error(`${label} must be an integer between 1 and ${max}`);
+    }
+    return requested;
+}
+function escapeLike(value) {
+    return value.replace(/[\\%_]/gu, (character) => `\\${character}`);
+}
+function encodeCursor(createdAt, artifactId) {
+    return Buffer.from(`${createdAt}:${artifactId}`, "utf8").toString("base64url");
+}
+function decodeCursor(cursor) {
+    if (cursor === undefined)
+        return undefined;
+    const decoded = Buffer.from(cursor, "base64url").toString("utf8");
+    const separator = decoded.indexOf(":");
+    const createdAt = Number(decoded.slice(0, separator));
+    const artifactId = decoded.slice(separator + 1);
+    if (separator < 0 || !Number.isInteger(createdAt) || !artifactId) {
+        throw new Error("Tag query cursor is invalid");
+    }
+    return { createdAt, artifactId };
+}
+//# sourceMappingURL=tag-queries.js.map

package/dist/tag-queries.js.map

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

package/dist/tag-rows.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Row-level tag comparisons shared by the write and transfer paths, so
+ * "this write would change nothing" means the same thing in both.
+ */
+import type { DatabaseSync } from "@dolthub/doltlite";
+import { type NormalizedTag, type TagFacet } from "./tag-values.js";
+/** Match SQLite's BINARY ordering, including astral Unicode code points. */
+export declare function compareTags(left: {
+    facet: TagFacet;
+    key: string;
+}, right: {
+    facet: TagFacet;
+    key: string;
+}): number;
+interface StoredSnapshotRow {
+    artifact_id: string;
+    source_hash: string;
+    generator: string;
+    model: string | null;
+    extractor_version: string;
+    tag_count: number;
+    generation: number;
+    analyzed_at: number;
+}
+export declare function storedSnapshot(db: DatabaseSync, artifactId: string): StoredSnapshotRow | undefined;
+/** Whether the stored automatic set is exactly `tags`, labels included. */
+export declare function automaticTagsMatch(db: DatabaseSync, artifactId: string, tags: readonly NormalizedTag[]): boolean;
+/** Whether a stored snapshot already records exactly this analysis run. */
+export declare function snapshotMatches(current: StoredSnapshotRow | undefined, analysis: {
+    sourceHash: string;
+    generator: string;
+    model?: string;
+    extractorVersion: string;
+}): boolean;
+export {};
+//# sourceMappingURL=tag-rows.d.ts.map

package/dist/tag-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-rows.d.ts","sourceRoot":"","sources":["../src/tag-rows.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAe,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEjF,4EAA4E;AAC5E,wBAAgB,WAAW,CACzB,IAAI,EAAE;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACtC,KAAK,EAAE;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACtC,MAAM,CAGR;AASD,UAAU,iBAAiB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,cAAc,CAC5B,EAAE,EAAE,YAAY,EAChB,UAAU,EAAE,MAAM,GACjB,iBAAiB,GAAG,SAAS,CAS/B;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,YAAY,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,SAAS,aAAa,EAAE,GAC7B,OAAO,CAqBT;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAC7B,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,QAAQ,EAAE;IACR,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GACA,OAAO,CAQT"}

package/dist/tag-rows.js

@@ -0,0 +1,48 @@
+/**
+ * Row-level tag comparisons shared by the write and transfer paths, so
+ * "this write would change nothing" means the same thing in both.
+ */
+import { tagIdentity } from "./tag-values.js";
+/** Match SQLite's BINARY ordering, including astral Unicode code points. */
+export function compareTags(left, right) {
+    if (left.facet !== right.facet)
+        return left.facet < right.facet ? -1 : 1;
+    return Buffer.compare(Buffer.from(left.key), Buffer.from(right.key));
+}
+export function storedSnapshot(db, artifactId) {
+    return 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);
+}
+/** Whether the stored automatic set is exactly `tags`, labels included. */
+export function automaticTagsMatch(db, artifactId, tags) {
+    const rows = db
+        .prepare(`SELECT facet, tag_key, label, entity_id
+       FROM artifact_tags
+       WHERE artifact_id=? AND origin='automatic'
+       ORDER BY facet, tag_key`)
+        .all(artifactId);
+    if (rows.length !== tags.length)
+        return false;
+    const byIdentity = new Map(rows.map((row) => [tagIdentity(row.facet, row.tag_key), row]));
+    return tags.every((tag) => {
+        const row = byIdentity.get(tagIdentity(tag.facet, tag.key));
+        return (row !== undefined &&
+            row.facet === tag.facet &&
+            row.tag_key === tag.key &&
+            row.label === tag.label &&
+            (row.entity_id ?? undefined) === tag.entityId);
+    });
+}
+/** Whether a stored snapshot already records exactly this analysis run. */
+export function snapshotMatches(current, analysis) {
+    return (current !== undefined &&
+        current.source_hash === analysis.sourceHash &&
+        current.generator === analysis.generator &&
+        (current.model ?? undefined) === (analysis.model || undefined) &&
+        current.extractor_version === analysis.extractorVersion);
+}
+//# sourceMappingURL=tag-rows.js.map

package/dist/tag-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-rows.js","sourceRoot":"","sources":["../src/tag-rows.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,WAAW,EAAqC,MAAM,iBAAiB,CAAC;AAEjF,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CACzB,IAAsC,EACtC,KAAuC;IAEvC,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACvE,CAAC;AAoBD,MAAM,UAAU,cAAc,CAC5B,EAAgB,EAChB,UAAkB;IAElB,OAAO,EAAE;SACN,OAAO,CACN;;;2BAGqB,CACtB;SACA,GAAG,CAAC,UAAU,CAA6C,CAAC;AACjE,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAChC,EAAgB,EAChB,UAAkB,EAClB,IAA8B;IAE9B,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;;;+BAGyB,CAC1B;SACA,GAAG,CAAC,UAAU,CAA8B,CAAC;IAChD,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1F,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,OAAO,CACL,GAAG,KAAK,SAAS;YACjB,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK;YACvB,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,GAAG;YACvB,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK;YACvB,CAAC,GAAG,CAAC,SAAS,IAAI,SAAS,CAAC,KAAK,GAAG,CAAC,QAAQ,CAC9C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAC7B,OAAsC,EACtC,QAKC;IAED,OAAO,CACL,OAAO,KAAK,SAAS;QACrB,OAAO,CAAC,WAAW,KAAK,QAAQ,CAAC,UAAU;QAC3C,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS;QACxC,CAAC,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,SAAS,CAAC;QAC9D,OAAO,CAAC,iBAAiB,KAAK,QAAQ,CAAC,gBAAgB,CACxD,CAAC;AACJ,CAAC"}

package/dist/tag-transfer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Tag history reads and snapshot transfer.
+ *
+ * Two jobs the consumer cannot do for itself without touching catalogs
+ * directly: reading an artifact's tag state as some revision recorded it,
+ * and moving tag state between artifacts — including between separate
+ * engines — as validated data rather than raw rows.
+ *
+ * Transfer never trusts the source's keys or references. Labels are
+ * re-normalized into destination-local identities, an entity reference
+ * survives only if that entity exists in the destination, and automatic
+ * evidence crosses only when the destination artifact actually carries the
+ * bytes that were analyzed. A modified or generated derivative therefore
+ * cannot inherit automatic tags describing content it does not have.
+ */
+import type { ArtifactTagState, AssetTagSnapshotExport, EngineError, Result, TagImportResult } from "./engine-types.js";
+import { EngineContext } from "./context.js";
+export declare const TAG_SNAPSHOT_VERSION = 1;
+type ReadTagState = (artifactId: string) => ArtifactTagState;
+export declare function createTagTransferApi(context: EngineContext, tagState: ReadTagState): {
+    readAtRevision: (artifactId: string, revision: string) => Result<ArtifactTagState, EngineError>;
+    export: (artifactId: string) => Result<AssetTagSnapshotExport, EngineError>;
+    import: (artifactId: string, snapshot: AssetTagSnapshotExport) => Promise<Result<TagImportResult, EngineError>>;
+};
+export {};
+//# sourceMappingURL=tag-transfer.d.ts.map

package/dist/tag-transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-transfer.d.ts","sourceRoot":"","sources":["../src/tag-transfer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAEhB,sBAAsB,EAGtB,WAAW,EACX,MAAM,EACN,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAA0B,MAAM,cAAc,CAAC;AAoBrE,eAAO,MAAM,oBAAoB,IAAI,CAAC;AA6BtC,KAAK,YAAY,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,gBAAgB,CAAC;AAE7D,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,YAAY;iCAIN,MAAM,YACR,MAAM,KACf,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC;yBAEnB,MAAM,KAAG,MAAM,CAAC,sBAAsB,EAAE,WAAW,CAAC;yBAG3D,MAAM,YACR,sBAAsB,KAC/B,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;EAGnD"}