feat(ingest): POST /triplets/ingest 寫入端 + deprecate-then-append (T3.2-3.5)

對應 issue #1 T3 B 段。

- templates: TRIPLET_SLOTS 加 status/superseded_by/source_uri/content_hash;
  ENTITY_SLOTS 加 gloss;recordToTriplet 映射新欄位(缺省 status=active 相容舊資料)
- kbdb-client: ensureTemplate 改 slot-diff 補丁(既有 template 走 PATCH /templates/:id
  補缺 slot,取代 early-return → 免遷移腳本);新增 updateRecord(PATCH /records/:id)
- triplet-ingest action(88 行純函式):Zod strict 鏡射 ingest-candidate 契約 →
  idempotency(uri+hash 同→no-op)→ 先 append 後 deprecate(無「全無 active」空窗)
- POST /triplets/ingest route:strict 驗證失敗 → 422(禁送 graph 領域欄位)
- queryTriplets 預設 active-only(traverse/search/neighbors 皆經此),
  includeDeprecated opt-out 供 rollback/考古
- 6 測試案全綠(vitest 16 passed);mock-client 同步 slot-diff + updateRecord

gates: zero SQL / zero migration / 無 D1·Vectorize·AI 綁定 / dry-run bundle 乾淨

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-26 18:13:49 +08:00
parent 98b221b435
commit 27f7448914
9 changed files with 279 additions and 13 deletions
+14 -2
View File
@@ -50,12 +50,19 @@ export class MockKbdbClient {
}
async ensureTemplate(name: string, slots: string[]): Promise<void> {
if (!this.templates.has(name)) this.templates.set(name, slots);
// 對齊真 client 的 slot-diff 行為:既有 template 補缺 slot(不 early-return)。
const have = this.templates.get(name);
if (!have) {
this.templates.set(name, [...slots]);
return;
}
const set = new Set(have);
for (const s of slots) if (!set.has(s)) have.push(s);
}
async createRecord(template: string, values: Record<string, string>, owner_id?: string): Promise<string> {
const id = this.id('rec');
this.records.set(id, { template, values, owner_id });
this.records.set(id, { template, values: { ...values }, owner_id });
return id;
}
@@ -65,6 +72,11 @@ export class MockKbdbClient {
return { record_id: recordId, template: r.template, values: r.values };
}
async updateRecord(recordId: string, values: Record<string, string>): Promise<void> {
const r = this.records.get(recordId);
if (r) Object.assign(r.values, values);
}
async listRecordsByTemplate(template: string, owner_id?: string): Promise<BaseRecord[]> {
return [...this.records.entries()]
.filter(([, r]) => r.template === template && (!owner_id || r.owner_id === owner_id))