package main import ( "context" "fmt" "log" "time" "knowledge-governance/internal/governance" "knowledge-governance/internal/jobs" ) // libraryResumeStore 是"启动接管"用到的存储动作。 // // 为什么抽成接口:日志必须证明"这个作业真的被本 worker 认领了",而不是 // "扫描循环数了一下"。只有单测能控制 claim/attach 的返回时,才验证得了 // "认领失败时一行都不许写"(2026-10-29 的演练现场就是只有汇总行 // `library job takeover sweep: 1 resumed`,外部无法判断认领的是哪个作业)。 type libraryResumeStore interface { InterruptedLibraryJobs(ctx context.Context) ([]governance.LibraryJob, error) AdvanceLibraryJob(ctx context.Context, jobID string, state governance.LibraryJobState, stage, message, recovery, snapshotID, targetSnapshotID string, now time.Time) error ClaimLibraryJobForResume(ctx context.Context, jobID string, now time.Time) (bool, error) Enqueue(ctx context.Context, request jobs.EnqueueRequest, now time.Time) (*jobs.Job, error) ResetQueueJobForResume(ctx context.Context, queueJobID string, now time.Time) error AttachLibraryQueueJob(ctx context.Context, jobID, queueJobID string, now time.Time) error } // 认领路径:两条都是"真认领",差别只在队列行是新建的、还是上一次崩溃前就存在的。 // 必须写进日志:上一轮只有新建那一支打日志,"队列行已存在"那一支只把计数加一, // 于是外部只看到汇总,无法证明是哪个作业、也无从证明它被认领过。 const ( takeoverPathEnqueue = "enqueue" takeoverPathExistingQueue = "existing-queue" ) // takeoverClaimLine 是"作业被本 worker 认领"的唯一证据行(一行、字段全 key=value)。 // 判据脚本按字段名取值,不按位置猜;改字段名会让演练直接红,而不是静默放过。 func takeoverClaimLine(job governance.LibraryJob, queueJobID, path string, at time.Time) string { return fmt.Sprintf( "library job %s takeover claimed at=%s kind=%s scope=%s target=%s backup=%s queue=%s path=%s", job.ID, at.UTC().Format(time.RFC3339Nano), job.Kind, job.Scope, job.TargetSnapshotID, job.SnapshotID, queueJobID, path) } // takeoverDecisionLine 说明"接管时判定要怎么做":fresh=整条写入链路重跑; // pending_final=只复核与收尾;superseded / foreign_effective / unknown=拒绝接管。 // 没有这一行,事后只能从阶段表倒推决策 —— 而阶段表正是同快照收尾能伪造的地方。 func takeoverDecisionLine(jobID string, decision takeoverKind, kind governance.LibraryJobKind, scope, target, backup string, finalizeOnly bool, at time.Time) string { return fmt.Sprintf( "library job %s takeover decision=%s at=%s kind=%s scope=%s target=%s backup=%s finalize_only=%t", jobID, decision, at.UTC().Format(time.RFC3339Nano), kind, scope, target, backup, finalizeOnly) } func logTakeoverClaim(job governance.LibraryJob, queueJobID, path string, at time.Time) { log.Print(takeoverClaimLine(job, queueJobID, path, at)) } func logTakeoverDecision(jobID string, decision takeoverKind, kind governance.LibraryJobKind, scope, target, backup string, finalizeOnly bool, at time.Time) { log.Print(takeoverDecisionLine(jobID, decision, kind, scope, target, backup, finalizeOnly, at)) }