rootandClaude Opus 5.5
a24bda952b
- Sites / accounts / feeds: registry view (/site-definitions), site CRUD with
enable/disable (history stays queryable, marked site_disabled), accounts and
feed URLs stored as secrets (only secret_ref / redacted urlDisplay exposed),
feed enable/disable/reset/fetch; one shared rate limiter + adapter per site.
- Tasks: ingestFeed (FeedFetchState/FeedCursor on feed_source, observation
feed+guid upsert with digest-change updates, source_release site+id
aggregation across feeds, auth failure -> account invalid + decision, no
retry, gap -> feed.gap_suspected -> budgeted backfill snapshot),
resolveObservation (parseRelease -> local recall via title_alias pg_trgm +
accepted identities -> TMDB -> resolveIdentity; auto binds entity /
provisional units / identities / aliases, otherwise identity_candidate pool
with evidence version and bounded review backoff; manual lock respected),
refreshMetadata (metadata_field + field_override, user locks win, paths
untouched), snapshotSite (site_snapshot coverage records).
- Events: feed.due, feed.gap_suspected, release.observed (self-consumed),
release.resolved, decision.created/updated; scheduler in worker start().
- Identity API: entity detail with redirects, manual mapping correction with
identity_revision, merge with identity_redirect, pool list/assign/dismiss/
retry, content unit numbering lock, aliases, external identities.
- Decisions: list/summary (by entity and kind)/detail/resolve; identity
options executed directly.
- Workbench: /sites/{id}/releases (snapshot first, coalesced live search with
backoff, origin + freshness) and /sites/{id}/releases/{rid} (volatile field
recheck times, refresh keeps data on failure).
- Capabilities: catalog.lookup, release.search, release.inspect,
identity.resolve.
- Migrations 0018-0020: site.adapter api, source_release.resolution_locked,
site_snapshot, identity_candidate, resolution_attempt, identity_redirect,
metadata_field, field_override.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
75 lines
3.3 KiB
TypeScript
75 lines
3.3 KiB
TypeScript
import type { Kysely } from "kysely";
|
|
import { dropTables, entityTable, execDdl, oneOf } from "../src/migration-helpers.ts";
|
|
|
|
// W2-B 待识别池与身份治理(REQ §7.2、§7.5):
|
|
// - identity_candidate:每条 source_release 至多一条待识别记录,候选只存 JSON,不逐个建为正式作品;
|
|
// 失败保存原因、证据版本与下一次复查时间(有界退避),新证据到来时重试;
|
|
// - resolution_attempt:每次识别尝试的结果与证据版本(只追加);
|
|
// - identity_redirect:作品合并后的旧 ID 跳转历史(与 media_entity.merged_into_id 一致,可修订)。
|
|
|
|
const ACTOR = ["user", "agent", "system", "api_key"] as const;
|
|
|
|
// biome-ignore lint/suspicious/noExplicitAny: 迁移不依赖应用表类型
|
|
export async function up(db: Kysely<any>): Promise<void> {
|
|
await execDdl(
|
|
db,
|
|
`
|
|
${entityTable(
|
|
"identity_candidate",
|
|
`
|
|
source_release_id uuid not null references source_release (id) on delete cascade,
|
|
status text not null default 'pending' ${oneOf("status", ["pending", "resolved", "dismissed", "archived"])},
|
|
reason text not null ${oneOf("reason", ["ambiguous", "no_match", "proposed", "lookup_failed"])},
|
|
query jsonb not null default '{}'::jsonb,
|
|
candidates jsonb not null default '[]'::jsonb,
|
|
evidence_version text not null,
|
|
attempts integer not null default 0,
|
|
last_attempt_at timestamptz,
|
|
next_review_at timestamptz,
|
|
decision_id uuid references decision (id) on delete set null,
|
|
resolved_media_entity_id uuid references media_entity (id) on delete set null,
|
|
resolved_by text,
|
|
resolved_at timestamptz,
|
|
constraint identity_candidate_release_key unique (source_release_id)`,
|
|
)}
|
|
create index identity_candidate_review_idx on identity_candidate (next_review_at) where status = 'pending';
|
|
create index identity_candidate_status_idx on identity_candidate (status, updated_at desc);
|
|
|
|
${entityTable(
|
|
"resolution_attempt",
|
|
`
|
|
source_release_id uuid not null references source_release (id) on delete cascade,
|
|
observation_id uuid references observation (id) on delete set null,
|
|
outcome text not null ${oneOf("outcome", ["auto", "proposed", "ambiguous", "no_match", "lookup_failed", "manual", "skipped_locked"])},
|
|
reason text,
|
|
evidence_version text not null,
|
|
candidate_count integer not null default 0,
|
|
media_entity_id uuid references media_entity (id) on delete set null,
|
|
best jsonb,
|
|
error jsonb,
|
|
actor_type text not null default 'system' ${oneOf("actor_type", ACTOR)},
|
|
actor_id text`,
|
|
)}
|
|
create index resolution_attempt_release_idx on resolution_attempt (source_release_id, created_at desc);
|
|
|
|
${entityTable(
|
|
"identity_redirect",
|
|
`
|
|
from_entity_id uuid not null references media_entity (id) on delete cascade,
|
|
to_entity_id uuid not null references media_entity (id) on delete cascade,
|
|
reason text,
|
|
actor_type text not null ${oneOf("actor_type", ACTOR)},
|
|
actor_id text,
|
|
constraint identity_redirect_from_key unique (from_entity_id),
|
|
constraint identity_redirect_not_self check (from_entity_id <> to_entity_id)`,
|
|
)}
|
|
create index identity_redirect_to_idx on identity_redirect (to_entity_id);
|
|
`,
|
|
);
|
|
}
|
|
|
|
// biome-ignore lint/suspicious/noExplicitAny: 同上
|
|
export async function down(db: Kysely<any>): Promise<void> {
|
|
await execDdl(db, dropTables(["identity_redirect", "resolution_attempt", "identity_candidate"]));
|
|
}
|