@gotcos/glasses-server 6.44.12 → 6.44.14

package/CHANGELOG.md

@@ -1,3 +1,67 @@
+## 6.44.14
+
+The Manage sheet's merge, with a preview, a worker and a receipt, plus a
+duplicates scan that proposes and never merges.
+
+- Miles 2026-09-08: "Build the Manage merge path with the preview", and
+  "address any of the obvious duplicates like the miels and queen example
+  from above without clobbering entities. You did good in deflecting miles
+  mallard vs the other miles profiles."
+- `POST /api/context/graph/merge/preview` `{ source, target }`: both entities
+  from this Mac's index, shared neighbors, the effect (relationships moved and
+  collapsed, texts re-embedded, about how long), a name signal, warnings
+  (types differ, larger into smaller, nothing links them, a large merge), and
+  `blocked` with its reason for a pair the graph knows to be different people
+  (Miles Ukaoma / Miles Mallard, Manoj Bisht / Manoj Kumar, the Kyles, the
+  Jacobuses, and any pair the user kept apart).
+- `POST /api/context/graph/merge` `{ source, target, confirm: true, rule? }`:
+  starts ONE detached worker on the ingestion owner and answers 202 with a
+  ticket and the receipt. The worker takes the exclusive ingest lock, copies
+  the GraphML aside, runs LightRAG's own entity merge (no deprecated strategy
+  argument), appends a curation ledger row, rebuilds the per-Mac index and
+  the Observatory export, and stamps its receipt at every step. Measured: the
+  hand merges of 2026-09-08 took about two minutes, so this is never a request.
+  Without `confirm` the answer is 400 `confirmation_required` with the preview;
+  409 `merge_blocked`, `merge_running`, `lock_held`, `not_owner`, or
+  `embedding_not_ready` (a merge re-embeds 1 + degree texts).
+- `GET /api/context/graph/merge`: the receipt with the worker's log tail. A
+  worker that died reads as failed with the snapshot intact, never as running.
+- `GET /api/context/graph/duplicates?limit=`: person entities whose names are
+  variants of one another (same first name with a surname within two letters,
+  whole names within two letters, one name spelling out the other, a bare
+  first name that matches exactly one full name), grouped under the full name
+  with the most connections, with shared-neighbor counts and a confidence.
+  Possessives ("Miles Ukaoma's Son") and ambiguous first names are left alone;
+  blocked pairs never share a group. Nothing here merges.
+- Four bridge commands: `graph-merge-preview`, `graph-merge`,
+  `graph-merge-status`, `graph-duplicates` (28 in the parity set).
+- Test: the 6.44.13 guardrails-run pin expected a zone-less `created_at` to
+  read as null; the normalizer has always passed a parseable timestamp through,
+  and the pin failed at HEAD. Corrected to the passed-through value.
+
+## 6.44.13
+
+Prune or accept a captured memory, and guardrails that prune nonsense for you.
+
+- Miles 2026-09-07, looking at a captured decision that read "AAAA...":
+  "we need the ability to either prune or accept the memory", and "an
+  automated review ... another person could set their own guardrails that
+  automatically just prune out stuff like this."
+- `POST /api/context/memory/:id/review` `{ decision: accept | prune, note? }`
+  stamps a captured memory as reviewed or deletes it; either way a review
+  ledger row (`accepted`, `pruned`) the learning timeline shows. Both are new
+  event types.
+- `GET` and `PUT /api/context/memory-guardrails`: the user's own rules
+  (minimum words, distinct characters, a repeat-ratio ceiling, banned
+  patterns, and an optional model pass: on or off, the tier, at most N per
+  run). The same rules refuse nonsense at capture time in the bridge's COS.
+- `POST /api/context/memory-guardrails/run` `{ days?, apply?, llm? }` scans
+  the captured memories, judges them (rules first; the model pass against
+  the COS philosophy principles only on what survives, only when enabled),
+  and returns every verdict with its reasons. Nothing is deleted without
+  `apply`; a record a person accepted is never flagged.
+- Includes 6.44.12, never published.
+
 ## 6.44.12
 
 The Knowledge down-select, and a fail-closed embedding gate.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gotcos/glasses-server",
-  "version": "6.44.12",
+  "version": "6.44.14",
   "description": "COS Glasses \u2014 self-hosted AI heads-up-display server for Even G2 smart glasses, powered by Claude Code, Codex, Cursor Agent CLI, or local Ollama",
   "type": "module",
   "bin": {

package/server/lib/cos-context-browser.ts

@@ -470,7 +470,8 @@ export function normalizeGraphBlock(value: unknown): GraphBlock | null {
 // ── Recent learning payloads (GET /context/learning, /context/learning/:id) ──
 
 export const LEARNING_EVENT_ID_PATTERN = /^evt_[a-f0-9]{16}$/
-export const LEARNING_EVENT_TYPES = new Set(['captured', 'proposed', 'promotable', 'saved', 'retrieved', 'used', 'checked', 'dismissed', 'reverted', 'reopened', 'consolidated', 'previewed'])
+export const LEARNING_EVENT_TYPES = new Set(['captured', 'proposed', 'promotable', 'saved', 'retrieved', 'used', 'checked', 'dismissed', 'reverted', 'reopened', 'consolidated', 'previewed', 'accepted', 'pruned'])
+export const REVIEW_DECISIONS = new Set(['dismissed', 'reopened', 'accepted', 'pruned'])
 const LEARNING_LIST_LIMIT = 50
 /** The strict To review set is small (121 today); one page shows it whole. */
 export const LEARNING_REVIEW_LIMIT = 200
@@ -783,7 +784,7 @@ export function normalizeReviewDecision(value: unknown): Record<string, unknown>
   if (!row) return null
   const decision = stringOrAbsent(row.decision, 16)
   const lessonId = stringOrAbsent(row.lesson_id, 200)
-  if (!lessonId || (decision !== 'dismissed' && decision !== 'reopened')) return null
+  if (!lessonId || !decision || !REVIEW_DECISIONS.has(decision)) return null
   return {
     lesson_id: lessonId,
     decision,
@@ -1018,6 +1019,47 @@ export function normalizeIngestProgress(value: unknown): Record<string, unknown>
   }
 }
 
+export const GUARDRAIL_LLM_TIERS = ['haiku', 'sonnet', 'opus'] as const
+
+/** The user's memory guardrails (6.44.13), every field bounded. */
+export function normalizeGuardrails(value: unknown): Record<string, unknown> | null {
+  const g = asRecord(value)
+  if (!g) return null
+  const llm = asRecord(g.llm_review) ?? {}
+  return {
+    min_words: integerOrAbsent(g.min_words) ?? 6,
+    min_distinct_chars: integerOrAbsent(g.min_distinct_chars) ?? 8,
+    max_repeat_ratio: typeof g.max_repeat_ratio === 'number' && Number.isFinite(g.max_repeat_ratio) ? g.max_repeat_ratio : 0.5,
+    banned_patterns: (Array.isArray(g.banned_patterns) ? g.banned_patterns : []).filter((p): p is string => typeof p === 'string').slice(0, 50).map(p => p.slice(0, 200)),
+    llm_review: {
+      enabled: llm.enabled === true,
+      model: (GUARDRAIL_LLM_TIERS as readonly string[]).includes(String(llm.model)) ? String(llm.model) : 'haiku',
+      max_per_run: integerOrAbsent(llm.max_per_run) ?? 20,
+    },
+    updated_at: isoOrAbsent(g.updated_at) ?? null,
+    by: stringOrAbsent(g.by, 32) ?? null,
+  }
+}
+
+/** One guardrails run: the receipt and the verdicts with their reasons. */
+export function normalizeGuardrailsRun(value: unknown): Record<string, unknown> {
+  const s = asRecord(value) ?? {}
+  const r = asRecord(s.run) ?? {}
+  const verdicts = (Array.isArray(s.verdicts) ? s.verdicts : []).flatMap((row) => {
+    const v = asRecord(row); const id = v ? stringOrAbsent(v.id, 200) : undefined
+    if (!id) return []
+    const verdict = v!.verdict === 'prune' || v!.verdict === 'keep' || v!.verdict === 'review' ? v!.verdict : 'review'
+    return [{ id, type: stringOrAbsent(v!.type, 32) ?? '', created_at: isoOrAbsent(v!.created_at) ?? null, excerpt: typeof v!.excerpt === 'string' ? v!.excerpt.slice(0, 200) : '', verdict,
+      reasons: (Array.isArray(v!.reasons) ? v!.reasons : []).filter((x): x is string => typeof x === 'string').slice(0, 8).map(x => x.slice(0, 300)), by: stringOrAbsent(v!.by, 16) ?? 'rules', applied: v!.applied === true }]
+  }).slice(0, 500)
+  return {
+    run: { id: stringOrAbsent(r.id, 64) ?? null, started_at: isoOrAbsent(r.started_at) ?? null, ended_at: isoOrAbsent(r.ended_at) ?? null, days: integerOrAbsent(r.days) ?? null,
+      scanned: integerOrAbsent(r.scanned) ?? 0, flagged: integerOrAbsent(r.flagged) ?? 0, review: integerOrAbsent(r.review) ?? 0, kept: integerOrAbsent(r.kept) ?? 0,
+      llm_reviewed: integerOrAbsent(r.llm_reviewed) ?? 0, llm_enabled: r.llm_enabled === true, applied: r.applied === true, pruned: integerOrAbsent(r.pruned) ?? 0 },
+    verdicts,
+  }
+}
+
 export function normalizeContextBrowserStatus(value: unknown): ContextBrowserStatus {
   const source = value && typeof value === 'object' && !Array.isArray(value)
     ? value as Record<string, unknown> : {}
@@ -1079,3 +1121,120 @@ export function normalizeContextBrowserStatus(value: unknown): ContextBrowserSta
     ...(graph ? { graph } : {}),
   }
 }
+
+// ── Curation (6.44.14): merge preview, the merge worker's receipt, duplicate proposals ──
+
+export const MERGE_NAME_LIMIT = 200
+export const DUPLICATES_LIMIT_MAX = 100
+export const MERGE_RECEIPT_STATES = ['running', 'merging', 'indexing', 'exporting', 'done', 'failed'] as const
+export type MergeReceiptState = typeof MERGE_RECEIPT_STATES[number]
+
+function entityCard(value: unknown, fallbackId: string): Record<string, unknown> {
+  const r = asRecord(value) ?? {}
+  return {
+    id: stringOrAbsent(r.id, MERGE_NAME_LIMIT) ?? fallbackId,
+    found: r.found === true,
+    type: stringOrAbsent(r.type, 40) ?? null,
+    degree: integerOrAbsent(r.degree) ?? 0,
+    descriptions: (Array.isArray(r.descriptions) ? r.descriptions : []).filter((d): d is string => typeof d === 'string').map(d => cleanContextText(d, 300)).filter(Boolean).slice(0, 3),
+    description_count: integerOrAbsent(r.description_count) ?? 0,
+    created_at: integerOrAbsent(r.created_at) ?? null,
+  }
+}
+
+/** `graph-merge-preview`: what a merge would do, read from the index. `blocked` wins over every warning. */
+export function normalizeMergePreview(value: unknown, source = '', target = ''): Record<string, unknown> {
+  const s = asRecord(value) ?? {}
+  const effect = asRecord(s.effect)
+  return {
+    available: s.available === true,
+    index_state: stringOrAbsent(s.index_state, 20) ?? 'missing',
+    index_built_at: isoOrAbsent(s.index_built_at) ?? null,
+    source: entityCard(s.source, source),
+    target: entityCard(s.target, target),
+    shared_neighbors: (Array.isArray(s.shared_neighbors) ? s.shared_neighbors : []).filter((n): n is string => typeof n === 'string').map(n => cleanContextText(n, MERGE_NAME_LIMIT)).filter(Boolean).slice(0, 10),
+    shared_count: integerOrAbsent(s.shared_count) ?? 0,
+    adjacent: s.adjacent === true,
+    effect: effect ? { moved: integerOrAbsent(effect.moved) ?? 0, collapsed: integerOrAbsent(effect.collapsed) ?? 0, embeddings: integerOrAbsent(effect.embeddings) ?? 0, estimated_seconds: integerOrAbsent(effect.estimated_seconds) ?? null } : null,
+    name_signal: stringOrAbsent(s.name_signal, 80) ?? null,
+    blocked: s.blocked === true,
+    block_reason: stringOrAbsent(s.block_reason, 300) ?? null,
+    warnings: (Array.isArray(s.warnings) ? s.warnings : []).flatMap((w) => {
+      const r = asRecord(w); const code = r ? stringOrAbsent(r.code, 40) : undefined; const text = r ? stringOrAbsent(r.text, 300) : undefined
+      return code && text ? [{ code, text }] : []
+    }).slice(0, 8),
+  }
+}
+
+/** The worker's receipt: one merge per Mac at a time, every step stamped. */
+export function normalizeMergeReceipt(value: unknown): Record<string, unknown> | null {
+  const r = asRecord(value)
+  if (!r) return null
+  const state = typeof r.state === 'string' && (MERGE_RECEIPT_STATES as readonly string[]).includes(r.state) ? r.state as MergeReceiptState : null
+  if (!state) return null
+  const before = asRecord(r.before); const after = asRecord(r.after)
+  return {
+    ticket: stringOrAbsent(r.ticket, 40) ?? null,
+    state,
+    step: stringOrAbsent(r.step, 20) ?? null,
+    source: stringOrAbsent(r.source, MERGE_NAME_LIMIT) ?? null,
+    target: stringOrAbsent(r.target, MERGE_NAME_LIMIT) ?? null,
+    by: stringOrAbsent(r.by, 40) ?? null,
+    pid: integerOrAbsent(r.pid) ?? null,
+    started_at: isoOrAbsent(r.started_at) ?? null,
+    finished_at: isoOrAbsent(r.finished_at) ?? null,
+    elapsed_s: typeof r.elapsed_s === 'number' && Number.isFinite(r.elapsed_s) ? r.elapsed_s : null,
+    before: before ? { source: integerOrAbsent(before.source) ?? null, target: integerOrAbsent(before.target) ?? null } : null,
+    after: after ? { target: integerOrAbsent(after.target) ?? null, source_present: after.source_present === true } : null,
+    embedded_texts: integerOrAbsent(r.embedded_texts) ?? null,
+    snapshot: stringOrAbsent(r.snapshot, 400) ?? null,
+    rule: asRecord(r.rule) ? { scope: stringOrAbsent((r.rule as Record<string, unknown>).scope, 40) ?? null, pattern: stringOrAbsent((r.rule as Record<string, unknown>).pattern, MERGE_NAME_LIMIT) ?? null, replacement: stringOrAbsent((r.rule as Record<string, unknown>).replacement, MERGE_NAME_LIMIT) ?? null } : null,
+    error: stringOrAbsent(r.error, 400) ?? null,
+    export_note: stringOrAbsent(r.export_note, 200) ?? null,
+  }
+}
+
+/** `graph-merge` (202) and `graph-merge-status`: the receipt plus the worker's log tail. */
+export function normalizeMergeStatus(value: unknown): Record<string, unknown> {
+  const s = asRecord(value) ?? {}
+  return {
+    running: s.running === true,
+    receipt: normalizeMergeReceipt(s.receipt),
+    log_tail: (Array.isArray(s.log_tail) ? s.log_tail : []).filter((l): l is string => typeof l === 'string').map(l => l.slice(0, 300)).slice(-24),
+  }
+}
+
+export function normalizeMergeKickoff(value: unknown): Record<string, unknown> {
+  const s = asRecord(value) ?? {}
+  return {
+    started: s.started === true,
+    ticket: stringOrAbsent(s.ticket, 40) ?? null,
+    pid: integerOrAbsent(s.pid) ?? null,
+    estimated_seconds: integerOrAbsent(s.estimated_seconds) ?? null,
+    receipt: normalizeMergeReceipt(s.receipt),
+  }
+}
+
+/** `graph-duplicates`: person entities whose names look like one person. Proposals, never merges. */
+export function normalizeDuplicates(value: unknown): Record<string, unknown> {
+  const s = asRecord(value) ?? {}
+  const groups = (Array.isArray(s.groups) ? s.groups : []).flatMap((g) => {
+    const r = asRecord(g); const target = r ? stringOrAbsent(r.target, MERGE_NAME_LIMIT) : undefined
+    if (!r || !target) return []
+    const members = (Array.isArray(r.members) ? r.members : []).flatMap((m) => {
+      const mr = asRecord(m); const id = mr ? stringOrAbsent(mr.id, MERGE_NAME_LIMIT) : undefined
+      if (!mr || !id) return []
+      return [{ id, degree: integerOrAbsent(mr.degree) ?? 0, shared_neighbors: integerOrAbsent(mr.shared_neighbors) ?? 0, description: stringOrAbsent(mr.description, 300) ?? '', why: stringOrAbsent(mr.why, 80) ?? null }]
+    }).slice(0, 6)
+    const confidence = r.confidence === 'high' || r.confidence === 'medium' || r.confidence === 'low' ? r.confidence : 'low'
+    return members.length >= 2 ? [{ target, members, confidence, reasons: (Array.isArray(r.reasons) ? r.reasons : []).filter((x): x is string => typeof x === 'string').map(x => cleanContextText(x, 80)).slice(0, 6), linked: r.linked === true }] : []
+  }).slice(0, DUPLICATES_LIMIT_MAX)
+  return {
+    available: s.available === true,
+    index_state: stringOrAbsent(s.index_state, 20) ?? 'missing',
+    index_built_at: isoOrAbsent(s.index_built_at) ?? null,
+    scanned: integerOrAbsent(s.scanned) ?? 0,
+    total_groups: integerOrAbsent(s.total_groups) ?? groups.length,
+    groups,
+  }
+}

package/server/lib/python-bridge.ts

@@ -67,6 +67,13 @@ export const LEARNING_COMMANDS = [
   'graph-ingest-progress',
   'graph-setup-embedding',
   'graph-setup-extraction',
+  'memory-review',
+  'memory-guardrails',
+  'memory-guardrails-run',
+  'graph-merge-preview',
+  'graph-merge',
+  'graph-merge-status',
+  'graph-duplicates',
 ] as const
 
 // The optional Python bridge is available only when the user points us at a real
@@ -250,6 +257,13 @@ function standaloneNoop(args: string[]): unknown {
     case 'graph-ingest-progress':
     case 'graph-setup-embedding':
     case 'graph-setup-extraction':
+    case 'memory-review':
+    case 'memory-guardrails':
+    case 'memory-guardrails-run':
+    case 'graph-merge-preview':
+    case 'graph-merge':
+    case 'graph-merge-status':
+    case 'graph-duplicates':
       return { error: 'cos_pipeline_not_configured' }
     case 'task-rows':
     case 'task-capture':

package/server/routes/memory.ts

@@ -32,6 +32,14 @@ import { normalizeReviewDecision, LEARNING_REVIEW_LIMIT,
   normalizeIngestProgress,
   normalizeEmbeddingBlock,
   normalizeExtractionBlock,
+  normalizeGuardrails,
+  normalizeGuardrailsRun,
+  normalizeMergePreview,
+  normalizeMergeStatus,
+  normalizeMergeKickoff,
+  normalizeDuplicates,
+  MERGE_NAME_LIMIT,
+  DUPLICATES_LIMIT_MAX,
   EMBEDDING_PROVIDERS,
   EXTRACTION_TIERS,
   KNOWLEDGE_SETUP_SAMPLE_MAX,
@@ -201,6 +209,192 @@ memoryRouter.post('/context/learning/:id/review', async (req, res) => {
   }
 })
 
+// ── Memory review and guardrails (6.44.13) ──────────────────────────
+//
+// Accept stamps a captured memory as reviewed; prune deletes it. Both are
+// review-ledger rows the timeline shows. The guardrails are the user's own
+// rules; a run scans, judges (rules, then an optional bounded model pass),
+// and prunes only with apply.
+
+memoryRouter.post('/context/memory/:id/review', async (req, res) => {
+  noStore(res)
+  const memoryId = String(req.params.id)
+  const decision = typeof req.body?.decision === 'string' ? req.body.decision : ''
+  if (!memoryId || memoryId.length > 200 || CONTROL_CHARACTER.test(memoryId)) { res.status(400).json({ error: 'invalid_memory_id' }); return }
+  if (decision !== 'accept' && decision !== 'prune') { res.status(400).json({ error: 'invalid_decision', message: 'decision must be accept or prune' }); return }
+  if (!contextConfigured()) { res.status(503).json({ error: pythonBridgeState() }); return }
+  try {
+    const note = typeof req.body?.note === 'string' ? req.body.note.slice(0, 400) : ''
+    const answer = await callPython(['memory-review', `--id=${memoryId}`, `--decision=${decision}`, ...(note ? [`--note=${note}`] : [])], 20_000)
+    const code = bridgeErrorCode(answer)
+    if (code) { sendSetupError(res, code, answer); return }
+    const a = answer as { decision?: unknown; deleted?: unknown }
+    const row = normalizeReviewDecision({ decision: a.decision })
+    if (!row) { res.status(503).json({ error: 'memory_review_unavailable' }); return }
+    res.json({ decision: row, deleted: a.deleted === true })
+  } catch (error) {
+    console.warn('[context] memory review bridge failure:', (error as Error).message)
+    res.status(503).json({ error: 'memory_unavailable' })
+  }
+})
+
+memoryRouter.get('/context/memory-guardrails', async (_req, res) => {
+  noStore(res)
+  if (!contextConfigured()) { res.status(503).json({ error: pythonBridgeState() }); return }
+  try {
+    const answer = await callPython(['memory-guardrails'], 15_000)
+    const code = bridgeErrorCode(answer)
+    if (code) { sendSetupError(res, code, answer); return }
+    const a = answer as { guardrails?: unknown; philosophy_rubric_lines?: unknown }
+    res.json({ guardrails: normalizeGuardrails(a.guardrails), philosophy_rubric_lines: Number.isInteger(a.philosophy_rubric_lines) ? a.philosophy_rubric_lines : 0 })
+  } catch (error) {
+    console.warn('[context] guardrails bridge failure:', (error as Error).message)
+    res.status(503).json({ error: 'memory_unavailable' })
+  }
+})
+
+memoryRouter.put('/context/memory-guardrails', async (req, res) => {
+  noStore(res)
+  if (!contextConfigured()) { res.status(503).json({ error: pythonBridgeState() }); return }
+  const body = req.body
+  if (!body || typeof body !== 'object' || Array.isArray(body)) { res.status(400).json({ error: 'invalid_guardrails', message: 'the body must be a JSON object' }); return }
+  const text = JSON.stringify(body)
+  if (text.length > 16_000) { res.status(400).json({ error: 'invalid_guardrails', message: 'the guardrails patch is too large' }); return }
+  try {
+    const answer = await callPython(['memory-guardrails', '--stdin'], 15_000, text)
+    const code = bridgeErrorCode(answer)
+    if (code) { sendSetupError(res, code, answer); return }
+    const a = answer as { guardrails?: unknown; philosophy_rubric_lines?: unknown }
+    res.json({ guardrails: normalizeGuardrails(a.guardrails), philosophy_rubric_lines: Number.isInteger(a.philosophy_rubric_lines) ? a.philosophy_rubric_lines : 0 })
+  } catch (error) {
+    console.warn('[context] guardrails bridge failure:', (error as Error).message)
+    res.status(503).json({ error: 'memory_unavailable' })
+  }
+})
+
+/** `{ days?, apply?, llm? }` → scan the captured memories; prune the flagged ones only with apply. Bounded: 30 days, one model pass of max_per_run. */
+memoryRouter.post('/context/memory-guardrails/run', async (req, res) => {
+  noStore(res)
+  if (!contextConfigured()) { res.status(503).json({ error: pythonBridgeState() }); return }
+  const body = (req.body ?? {}) as { days?: unknown; apply?: unknown; llm?: unknown }
+  const days = body.days === undefined || body.days === null ? 30 : Number(body.days)
+  if (!Number.isInteger(days) || days < 1 || days > 3650) { res.status(400).json({ error: 'invalid_days', message: 'days must be an integer from 1 to 3650' }); return }
+  if (body.apply !== undefined && typeof body.apply !== 'boolean') { res.status(400).json({ error: 'invalid_apply', message: 'apply must be true or false' }); return }
+  if (body.llm !== undefined && body.llm !== null && typeof body.llm !== 'boolean') { res.status(400).json({ error: 'invalid_llm', message: 'llm must be true or false' }); return }
+  const argv = ['memory-guardrails-run', `--days=${days}`]
+  if (body.apply === true) argv.push('--apply')
+  if (typeof body.llm === 'boolean') argv.push(`--llm=${body.llm}`)
+  try {
+    const answer = await callPython(argv, body.llm === false ? 60_000 : 400_000)
+    const code = bridgeErrorCode(answer)
+    if (code) { sendSetupError(res, code, answer); return }
+    res.json(normalizeGuardrailsRun(answer))
+  } catch (error) {
+    console.warn('[context] guardrails run bridge failure:', (error as Error).message)
+    res.status(503).json({ error: 'memory_unavailable' })
+  }
+})
+
+// ── Curation (6.44.14): the Manage sheet's merge, with a preview, a worker and a receipt ──
+//
+// Miles 2026-09-08: "Build the Manage merge path with the preview" and "address any of
+// the obvious duplicates like the miels and queen example without clobbering entities."
+// The merge is a DETACHED worker: the two hand merges of 2026-09-08 took ~2 minutes of
+// vector-store rewriting, far past any request budget. The kickoff answers 202 with a
+// ticket; GET /context/graph/merge is the receipt to poll. Two people the graph knows
+// to be different (Miles Ukaoma / Miles Mallard) come back 409 merge_blocked.
+
+function mergeNames(body: unknown): { source: string; target: string } | null {
+  const b = (body ?? {}) as { source?: unknown; target?: unknown }
+  const source = typeof b.source === 'string' ? b.source.trim() : ''
+  const target = typeof b.target === 'string' ? b.target.trim() : ''
+  if (source.length < 1 || source.length > MERGE_NAME_LIMIT || target.length < 1 || target.length > MERGE_NAME_LIMIT) return null
+  return { source, target }
+}
+
+/** `{ source, target }` → what the merge would do. Read-only; a blocked pair answers 200 with `blocked: true`. */
+memoryRouter.post('/context/graph/merge/preview', async (req, res) => {
+  noStore(res)
+  if (!contextConfigured()) { res.status(503).json({ error: pythonBridgeState() }); return }
+  const names = mergeNames(req.body)
+  if (!names) { res.status(400).json({ error: 'invalid_entity', message: `source and target must be 1 to ${MERGE_NAME_LIMIT} characters` }); return }
+  try {
+    const data = await callPython(['graph-merge-preview', `--source=${names.source}`, `--target=${names.target}`], 20_000)
+    const code = bridgeErrorCode(data)
+    if (code) { sendSetupError(res, code, data); return }
+    res.json(normalizeMergePreview(data, names.source, names.target))
+  } catch (error) {
+    console.warn('[context] merge preview bridge failure:', (error as Error).message)
+    res.status(503).json({ error: 'graph_unavailable' })
+  }
+})
+
+/**
+ * `{ source, target, confirm: true, rule? }` → start the merge worker on the owner Mac; 202 with the ticket and receipt.
+ * Without `confirm: true` the answer is 400 confirmation_required with the preview. 409 when the pair is blocked, a merge
+ * is already running, the ingest lock is held, this is a replica, or the chosen embedding cannot embed right now.
+ */
+memoryRouter.post('/context/graph/merge', async (req, res) => {
+  noStore(res)
+  if (!contextConfigured()) { res.status(503).json({ error: pythonBridgeState() }); return }
+  const names = mergeNames(req.body)
+  if (!names) { res.status(400).json({ error: 'invalid_entity', message: `source and target must be 1 to ${MERGE_NAME_LIMIT} characters` }); return }
+  const body = (req.body ?? {}) as { confirm?: unknown; rule?: unknown }
+  if (body.confirm !== undefined && typeof body.confirm !== 'boolean') { res.status(400).json({ error: 'invalid_confirm', message: 'confirm must be true or false' }); return }
+  if (body.rule !== undefined && body.rule !== null && (typeof body.rule !== 'object' || Array.isArray(body.rule))) { res.status(400).json({ error: 'invalid_rule', message: 'rule must be an object' }); return }
+  const argv = ['graph-merge', `--source=${names.source}`, `--target=${names.target}`, '--by=control']
+  if (body.confirm === true) argv.push('--confirm')
+  if (body.rule && typeof body.rule === 'object') {
+    const r = body.rule as Record<string, unknown>
+    const rule: Record<string, string> = {}
+    for (const key of ['scope', 'pattern', 'replacement']) if (typeof r[key] === 'string') rule[key] = (r[key] as string).slice(0, MERGE_NAME_LIMIT)
+    argv.push(`--rule=${JSON.stringify(rule)}`)
+  }
+  try {
+    // 20 s: the kickoff reads the index and probes the embedding, then spawns and answers.
+    const data = await callPython(argv, 20_000)
+    const code = bridgeErrorCode(data)
+    if (code) { sendSetupError(res, code, data); return }
+    res.status(202).json(normalizeMergeKickoff(data))
+  } catch (error) {
+    console.warn('[context] merge bridge failure:', (error as Error).message)
+    res.status(503).json({ error: 'graph_unavailable' })
+  }
+})
+
+/** The current or last merge's receipt with the worker's log tail. A dead worker reads as failed, never as running. */
+memoryRouter.get('/context/graph/merge', async (_req, res) => {
+  noStore(res)
+  if (!contextConfigured()) { res.status(503).json({ error: pythonBridgeState() }); return }
+  try {
+    const data = await callPython(['graph-merge-status'], 10_000)
+    const code = bridgeErrorCode(data)
+    if (code) { res.status(503).json({ error: code }); return }
+    res.json(normalizeMergeStatus(data))
+  } catch (error) {
+    console.warn('[context] merge status bridge failure:', (error as Error).message)
+    res.status(503).json({ error: 'graph_unavailable' })
+  }
+})
+
+/** `?limit=` → person entities whose names look like one person, grouped with a confidence. Proposals only. */
+memoryRouter.get('/context/graph/duplicates', async (req, res) => {
+  noStore(res)
+  if (!contextConfigured()) { res.status(503).json({ error: pythonBridgeState() }); return }
+  const raw = req.query.limit
+  const limit = raw === undefined ? 25 : Number(raw)
+  if (!Number.isInteger(limit) || limit < 1 || limit > DUPLICATES_LIMIT_MAX) { res.status(400).json({ error: 'invalid_limit', message: `limit must be an integer from 1 to ${DUPLICATES_LIMIT_MAX}` }); return }
+  try {
+    const data = await callPython(['graph-duplicates', `--limit=${limit}`], 30_000)
+    const code = bridgeErrorCode(data)
+    if (code) { sendSetupError(res, code, data); return }
+    res.json(normalizeDuplicates(data))
+  } catch (error) {
+    console.warn('[context] duplicates bridge failure:', (error as Error).message)
+    res.status(503).json({ error: 'graph_unavailable' })
+  }
+})
+
 memoryRouter.get('/context/learning/:id', async (req, res) => {
   noStore(res)
   if (!LEARNING_EVENT_ID_PATTERN.test(req.params.id)) { res.status(400).json({ error: 'invalid_event_id' }); return }
@@ -379,6 +573,19 @@ function sendSetupError(res: import('express').Response, code: string, data: unk
   const detail = asDetail(data)
   if (code === 'not_owner') { res.status(409).json({ error: code, message: detail.message, owner_host: detail.owner_host ?? null }); return }
   if (code === 'embedding_locked' || code === 'embedding_mismatch') { res.status(409).json({ error: code, message: detail.message }); return }
+  if (code === 'merge_blocked') {
+    // 6.44.14: two entities the graph knows to be different people. The preview rides along so the page can say why.
+    const d = (typeof data === 'object' && data !== null ? data : {}) as { preview?: unknown }
+    res.status(409).json({ error: code, message: detail.message, preview: d.preview ? normalizeMergePreview(d.preview) : null }); return
+  }
+  if (code === 'merge_running' || code === 'lock_held') {
+    const d = (typeof data === 'object' && data !== null ? data : {}) as { receipt?: unknown; lock?: unknown }
+    res.status(409).json({ error: code, message: detail.message, receipt: d.receipt ? normalizeMergeStatus({ receipt: d.receipt }).receipt : null, lock: normalizeIngestKickoff({ lock: d.lock }).lock }); return
+  }
+  if (code === 'confirmation_required') {
+    const d = (typeof data === 'object' && data !== null ? data : {}) as { preview?: unknown }
+    res.status(400).json({ error: code, message: detail.message, preview: d.preview ? normalizeMergePreview(d.preview) : null }); return
+  }
   if (code === 'embedding_not_ready') {
     // 6.44.12: the chosen embedding cannot embed on this Mac right now. The
     // bridge refused before spawning; pass its fix through so the page can show it.