memkin 0.4.0

package/dist/core/env-validation.js

@@ -0,0 +1,94 @@
+const ENV_REF_PATTERN = /\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g;
+function placeholdersIn(value) {
+    const result = new Set();
+    function walk(item) {
+        if (typeof item === "string") {
+            for (const match of item.matchAll(ENV_REF_PATTERN)) {
+                result.add(match[1]);
+            }
+            return;
+        }
+        if (Array.isArray(item)) {
+            for (const child of item)
+                walk(child);
+            return;
+        }
+        if (item !== null && typeof item === "object") {
+            for (const child of Object.values(item))
+                walk(child);
+        }
+    }
+    walk(value);
+    return Array.from(result).sort();
+}
+function hasUsableSecret(value) {
+    return Boolean(value && !value.match(ENV_REF_PATTERN));
+}
+function llmEnvVar(provider) {
+    return provider === "anthropic" ? "ANTHROPIC_API_KEY" : "OPENAI_API_KEY";
+}
+function missingLlmVars(config) {
+    const missing = new Set();
+    const providerEnv = llmEnvVar(config.llm.provider);
+    for (const name of placeholdersIn(config.llm)) {
+        if (config.__context.missingEnvVars.includes(name))
+            missing.add(name);
+    }
+    if (!hasUsableSecret(config.llm.api_key) && !process.env[providerEnv]) {
+        missing.add(providerEnv);
+    }
+    return Array.from(missing).sort();
+}
+function missingEmbeddingVars(config) {
+    if (config.embedding.provider !== "openai")
+        return [];
+    const missing = new Set();
+    for (const name of placeholdersIn(config.embedding)) {
+        if (config.__context.missingEnvVars.includes(name))
+            missing.add(name);
+    }
+    if (!hasUsableSecret(config.embedding.api_key) && !process.env.OPENAI_API_KEY) {
+        missing.add("OPENAI_API_KEY");
+    }
+    return Array.from(missing).sort();
+}
+export function getMissingEnvVarsForCommand(config, command, opts = {}) {
+    const missing = new Set();
+    if (command === "extract") {
+        for (const name of missingLlmVars(config))
+            missing.add(name);
+    }
+    else if (command === "embed") {
+        for (const name of missingEmbeddingVars(config))
+            missing.add(name);
+    }
+    else if (command === "search") {
+        if (opts.searchMode !== "fts") {
+            for (const name of missingEmbeddingVars(config))
+                missing.add(name);
+        }
+    }
+    else if (command === "doctor") {
+        for (const name of config.__context.missingEnvVars)
+            missing.add(name);
+        for (const name of missingLlmVars(config))
+            missing.add(name);
+        for (const name of missingEmbeddingVars(config))
+            missing.add(name);
+    }
+    else if (command === "serve") {
+        for (const name of config.__context.missingEnvVars)
+            missing.add(name);
+    }
+    return Array.from(missing).sort();
+}
+export function validateEnvForCommand(config, command, opts = {}) {
+    const missing = getMissingEnvVarsForCommand(config, command, opts);
+    if (missing.length === 0)
+        return;
+    throw new Error(`Missing required environment variables: ${missing.join(", ")}\n` +
+        `Referenced by: ${config.__context.configPath}\n` +
+        "Set them in your shell or replace the $" +
+        "{VAR} placeholders in memkin.yaml.");
+}
+//# sourceMappingURL=env-validation.js.map

package/dist/core/env-validation.js.map

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

package/dist/core/helpers.d.ts

@@ -0,0 +1,3 @@
+import type { ExtractionResult } from "./types.js";
+export declare function isEmptyExtraction(result: ExtractionResult): boolean;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/core/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/core/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAUnE"}

package/dist/core/helpers.js

@@ -0,0 +1,10 @@
+export function isEmptyExtraction(result) {
+    return (result.entities.length === 0 &&
+        result.timeline.length === 0 &&
+        result.links.length === 0 &&
+        result.decisions.length === 0 &&
+        result.tasks.length === 0 &&
+        result.discoveries.length === 0 &&
+        result.knowledge.length === 0);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/core/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/core/helpers.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,MAAwB;IACxD,OAAO,CACL,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC5B,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QACzB,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QACzB,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QAC/B,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAC9B,CAAC;AACJ,CAAC"}

package/dist/core/identity-resolver.d.ts

@@ -0,0 +1,42 @@
+import type { SqlExecutor } from "../store/sql-executor.js";
+import type { ExtractionResult, RawMessage } from "./types.js";
+export interface IdentityBackend {
+    resolveFeishuOpenId(openId: string): Promise<{
+        name: string;
+        slugHint?: string;
+    } | null>;
+    resolveFeishuChatId(channel: string): Promise<{
+        name: string;
+    } | null>;
+}
+export declare class IdentityResolver {
+    private db;
+    private backend?;
+    private readonly identity;
+    constructor(db: SqlExecutor, backend?: IdentityBackend | undefined);
+    enrichBatch(messages: RawMessage[]): Promise<RawMessage[]>;
+    private resolve;
+    private isUnresolvedId;
+    /**
+     * Canonicalize a person slug using pinyin rules and cache the result.
+     *
+     * @param name - The person's display name (e.g., "王建都")
+     * @param modelSlug - The model-produced slug (e.g., "person/wang-jian-du")
+     * @returns Canonical slug and whether the input was an alias
+     */
+    canonicalizePersonSlug(name: string, modelSlug: string): Promise<{
+        slug: string;
+        isAlias: boolean;
+    }>;
+    /**
+     * Canonicalize all person slugs in an ExtractionResult and rewrite references.
+     *
+     * @param result - The extraction result to canonicalize
+     * @returns Canonicalized result and alias map (canonical -> list of old slugs)
+     */
+    canonicalizeExtractionResult(result: ExtractionResult): Promise<{
+        result: ExtractionResult;
+        aliases: Map<string, string[]>;
+    }>;
+}
+//# sourceMappingURL=identity-resolver.d.ts.map

package/dist/core/identity-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-resolver.d.ts","sourceRoot":"","sources":["../../src/core/identity-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAKzF,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CACxE;AAOD,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,OAAO,CAAC;IAJlB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;gBAGrC,EAAE,EAAE,WAAW,EACf,OAAO,CAAC,EAAE,eAAe,YAAA;IAK7B,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YAwBlD,OAAO;IAqCrB,OAAO,CAAC,cAAc;IAItB;;;;;;OAMG;IACG,sBAAsB,CAC1B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAyF9C;;;;;OAKG;IACG,4BAA4B,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC;QACpE,MAAM,EAAE,gBAAgB,CAAC;QACzB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;KAChC,CAAC;CAmFH"}

package/dist/core/identity-resolver.js

@@ -0,0 +1,207 @@
+import { PersonIdentityStore } from "./person-identity.js";
+import { toPersonCanonicalSlug } from "./person-slug.js";
+export class IdentityResolver {
+    db;
+    backend;
+    identity;
+    constructor(db, backend) {
+        this.db = db;
+        this.backend = backend;
+        this.identity = new PersonIdentityStore(db);
+    }
+    async enrichBatch(messages) {
+        const unresolvedIds = new Set();
+        for (const msg of messages) {
+            if (this.isUnresolvedId(msg.contact)) {
+                unresolvedIds.add(msg.contact);
+            }
+        }
+        if (unresolvedIds.size === 0)
+            return messages;
+        const resolved = new Map();
+        for (const id of unresolvedIds) {
+            const name = await this.resolve("feishu", id);
+            if (name)
+                resolved.set(id, name);
+        }
+        return messages.map((msg) => {
+            const name = resolved.get(msg.contact);
+            if (!name)
+                return msg;
+            return { ...msg, contact: name };
+        });
+    }
+    async resolve(platform, externalId) {
+        const cached = await this.db.query("SELECT display_name, slug_hint FROM identity_cache WHERE platform = $1 AND external_id = $2", [platform, externalId]);
+        if (cached.rows.length > 0) {
+            const row = cached.rows[0];
+            if (row.display_name) {
+                return row.slug_hint ? `${row.display_name} (${row.slug_hint})` : row.display_name;
+            }
+            // display_name is NULL — cache row exists but is incomplete; fall through to backend
+        }
+        if (!this.backend)
+            return null;
+        try {
+            const result = await this.backend.resolveFeishuOpenId(externalId);
+            if (!result)
+                return null;
+            await this.db.query(`INSERT INTO identity_cache (platform, external_id, display_name, slug_hint)
+         VALUES ($1, $2, $3, $4)
+         ON CONFLICT (platform, external_id) DO UPDATE SET
+           display_name = EXCLUDED.display_name,
+           slug_hint = EXCLUDED.slug_hint,
+           resolved_at = NOW()`, [platform, externalId, result.name, result.slugHint ?? null]);
+            return result.slugHint ? `${result.name} (${result.slugHint})` : result.name;
+        }
+        catch (error) {
+            console.warn(`[IdentityResolver] Failed to resolve ${externalId}:`, error);
+            return null;
+        }
+    }
+    isUnresolvedId(contact) {
+        return contact.startsWith("ou_");
+    }
+    /**
+     * Canonicalize a person slug using pinyin rules and cache the result.
+     *
+     * @param name - The person's display name (e.g., "王建都")
+     * @param modelSlug - The model-produced slug (e.g., "person/wang-jian-du")
+     * @returns Canonical slug and whether the input was an alias
+     */
+    async canonicalizePersonSlug(name, modelSlug) {
+        // 0. Explicit handle table wins (Layer 1): a previously-linked alias —
+        //    open id / email / exact name / nickname — pins the canonical slug.
+        const byHandle = await this.identity.resolveForExtraction(name, modelSlug);
+        if (byHandle) {
+            return { slug: byHandle, isAlias: modelSlug !== byHandle };
+        }
+        // 1. Check cache by modelSlug
+        const cacheBySlug = await this.db.query("SELECT display_name FROM identity_cache WHERE platform = $1 AND external_id = $2", ["canonical", modelSlug]);
+        if (cacheBySlug.rows.length > 0) {
+            const canonicalSlug = cacheBySlug.rows[0].display_name;
+            if (canonicalSlug)
+                return { slug: canonicalSlug, isAlias: modelSlug !== canonicalSlug };
+            // display_name is NULL: deliberate fallthrough — cacheByName (Step 2) may still have a valid canonical
+        }
+        // 2. Check cache by name
+        const cacheByName = await this.db.query("SELECT display_name FROM identity_cache WHERE platform = $1 AND external_id = $2", ["canonical", name]);
+        if (cacheByName.rows.length > 0) {
+            const canonicalSlug = cacheByName.rows[0].display_name;
+            if (canonicalSlug) {
+                // Insert modelSlug -> canonical mapping (if not already there)
+                await this.db.query(`INSERT INTO identity_cache (platform, external_id, display_name, slug_hint)
+           VALUES ($1, $2, $3, $4)
+           ON CONFLICT (platform, external_id) DO NOTHING`, ["canonical", modelSlug, canonicalSlug, name]);
+                return { slug: canonicalSlug, isAlias: modelSlug !== canonicalSlug };
+            }
+            // display_name is NULL: treat as cache miss, fall through to pinyin step
+        }
+        // 3. Generate canonical slug
+        const canonicalSlug = toPersonCanonicalSlug(name);
+        // 4. If null (unsupported script), return original
+        if (canonicalSlug === null) {
+            return { slug: modelSlug, isAlias: false };
+        }
+        // 5. Collision guard: check if canonical slug already exists with different name
+        const collision = await this.db.query("SELECT slug_hint FROM identity_cache WHERE platform = $1 AND display_name = $2 AND slug_hint != $3", ["canonical", canonicalSlug, name]);
+        if (collision.rows.length > 0) {
+            const canonicalOpenId = canonicalSlug.match(/^person\/(ou_[a-z0-9]+)$/)?.[1];
+            const nameOpenId = name.match(/\bou_[a-zA-Z0-9]+\b/)?.[0].toLowerCase();
+            if (!canonicalOpenId || canonicalOpenId !== nameOpenId) {
+                console.warn(`[IdentityResolver] Slug collision detected: canonical slug '${canonicalSlug}' already exists for '${collision.rows[0].slug_hint}', keeping original slug '${modelSlug}' for '${name}'`);
+                return { slug: modelSlug, isAlias: false };
+            }
+        }
+        // 6. Insert both mappings: modelSlug -> canonical and name -> canonical
+        await this.db.query(`INSERT INTO identity_cache (platform, external_id, display_name, slug_hint)
+       VALUES ($1, $2, $3, $4)
+       ON CONFLICT (platform, external_id) DO NOTHING`, ["canonical", modelSlug, canonicalSlug, name]);
+        await this.db.query(`INSERT INTO identity_cache (platform, external_id, display_name, slug_hint)
+       VALUES ($1, $2, $3, $4)
+       ON CONFLICT (platform, external_id) DO NOTHING`, ["canonical", name, canonicalSlug, name]);
+        // Record the strong handles (name/slug/open id) so future explicit aliases
+        // and merges can build on a populated handle table.
+        await this.identity.recordCanonical(name, canonicalSlug);
+        return { slug: canonicalSlug, isAlias: modelSlug !== canonicalSlug };
+    }
+    /**
+     * Canonicalize all person slugs in an ExtractionResult and rewrite references.
+     *
+     * @param result - The extraction result to canonicalize
+     * @returns Canonicalized result and alias map (canonical -> list of old slugs)
+     */
+    async canonicalizeExtractionResult(result) {
+        // 1. Build rewrite map for person entities
+        const rewriteMap = new Map();
+        const aliasesMap = new Map();
+        for (const entity of result.entities) {
+            if (entity.type !== "person")
+                continue;
+            const { slug: canonicalSlug, isAlias } = await this.canonicalizePersonSlug(entity.name, entity.slug);
+            rewriteMap.set(entity.slug, canonicalSlug);
+            if (isAlias && entity.slug !== canonicalSlug) {
+                if (!aliasesMap.has(canonicalSlug)) {
+                    aliasesMap.set(canonicalSlug, []);
+                }
+                const aliases = aliasesMap.get(canonicalSlug);
+                if (aliases) {
+                    aliases.push(entity.slug);
+                }
+            }
+        }
+        // 2. Helper to rewrite a slug if it's in the map
+        const rewriteSlug = (slug) => {
+            return rewriteMap.get(slug) ?? slug;
+        };
+        // 3. Rewrite entities and deduplicate
+        const entityMap = new Map();
+        for (const entity of result.entities) {
+            const slug = entity.type === "person" ? rewriteSlug(entity.slug) : entity.slug;
+            // Keep first entity for each canonical slug
+            if (!entityMap.has(slug)) {
+                entityMap.set(slug, { ...entity, slug });
+            }
+        }
+        // 4. Rewrite all slug references
+        const canonicalized = {
+            source: result.source,
+            entities: Array.from(entityMap.values()),
+            timeline: result.timeline.map((t) => ({
+                ...t,
+                entities: t.entities.map(rewriteSlug),
+            })),
+            links: result.links.map((link) => ({
+                ...link,
+                from: rewriteSlug(link.from),
+                to: rewriteSlug(link.to),
+            })),
+            decisions: result.decisions.map((d) => ({
+                ...d,
+                entities: d.entities.map(rewriteSlug),
+            })),
+            tasks: result.tasks.map((task) => ({
+                ...task,
+                owner: task.owner?.startsWith("person/") ? rewriteSlug(task.owner) : task.owner,
+            })),
+            discoveries: result.discoveries.map((d) => ({
+                ...d,
+                entities: d.entities.map(rewriteSlug),
+            })),
+            knowledge: result.knowledge.map((k) => ({
+                ...k,
+                related_entities: k.related_entities.map(rewriteSlug),
+            })),
+            preferences: (result.preferences ?? []).map((p) => ({
+                ...p,
+                entities: p.entities.map(rewriteSlug),
+            })),
+            references: (result.references ?? []).map((r) => ({
+                ...r,
+                entities: r.entities.map(rewriteSlug),
+            })),
+        };
+        return { result: canonicalized, aliases: aliasesMap };
+    }
+}
+//# sourceMappingURL=identity-resolver.js.map

package/dist/core/identity-resolver.js.map

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

package/dist/core/person-identity.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Person identity — Layer 1: typed handle/alias resolution.
+ *
+ * A person is anchored by a human-readable canonical page slug (e.g.
+ * `person/li-yinglong`). Every other way the person is referred to — a Feishu
+ * open id, an email, an exact display name, a nickname / 花名 — is a *handle*
+ * stored in `person_handles` and pointing at that canonical slug.
+ *
+ * Resolution rules (mirrors openhuman's `people` resolver contract):
+ *   - Strong handles (feishu_open_id / email / name / slug) auto-resolve and
+ *     are recorded automatically during canonicalization.
+ *   - Weak handles (nickname / 花名) are NEVER created automatically — they
+ *     only enter the table via an explicit `addAlias` / `link`, so an
+ *     ambiguous nickname like "龙哥" can never silently merge two people.
+ *   - Merging two existing person pages is always an explicit operation.
+ */
+import type { PageStore } from "../store/pages.js";
+import type { PersonBehaviorStore } from "../store/person-behavior.js";
+import type { SqlExecutor } from "../store/sql-executor.js";
+export type HandleKind = "feishu_open_id" | "email" | "name" | "nickname" | "slug";
+export type HandleStrength = "strong" | "weak";
+export interface PersonHandle {
+    kind: HandleKind;
+    value: string;
+    canonical_slug: string;
+    strength: HandleStrength;
+}
+/** Default strength for a handle kind. Nicknames are weak; everything else strong. */
+export declare function defaultStrength(kind: HandleKind): HandleStrength;
+/**
+ * Canonicalize a handle value for storage and lookup. Emails and open ids are
+ * lowercased; names and nicknames are whitespace-collapsed; slugs are passed
+ * through (already normalized lowercase).
+ */
+export declare function canonicalizeHandleValue(kind: HandleKind, value: string): string;
+/** Canonical slug of the special "me" identity page (Spec 9 §4.1). */
+export declare const ME_SLUG = "entities/me";
+export interface PersonIdentityStores {
+    pages: PageStore;
+}
+/** Optional extra stores kept consistent across identity operations (Spec 8). */
+export interface PersonIdentityExtraStores {
+    /** Spec 8 behavior layer — counters are merged when two persons merge. */
+    behavior?: PersonBehaviorStore;
+}
+export declare class PersonIdentityStore {
+    private db;
+    private stores?;
+    private extra?;
+    constructor(db: SqlExecutor, stores?: PersonIdentityStores | undefined, extra?: PersonIdentityExtraStores | undefined);
+    /** Resolve a single handle to its canonical person slug, or null. */
+    resolveHandle(kind: HandleKind, value: string): Promise<string | null>;
+    /**
+     * Resolve an extraction's (name, modelSlug) to a canonical slug via known
+     * handles. Tries strong handles first (slug, embedded open id / email, exact
+     * name), then any explicitly-linked nickname. Returns null if nothing known.
+     */
+    resolveForExtraction(name: string, modelSlug: string): Promise<string | null>;
+    /**
+     * Record the strong handles implied by a freshly-canonicalized person
+     * (name → slug, slug → slug, and any embedded open id). Idempotent and
+     * non-destructive: existing rows are left untouched.
+     */
+    recordCanonical(name: string, canonicalSlug: string): Promise<void>;
+    /**
+     * Ensure the special `entities/me` self-identity page exists (Spec 9 §4.1).
+     * Idempotent — returns the canonical slug; creates a minimal person page the
+     * user can hand-edit (role / company / team / handles) when absent.
+     */
+    ensureEntitiesMe(): Promise<string>;
+    /**
+     * Register one of the current user's own handles (open_id / email / name),
+     * pointing it at `entities/me` as a strong handle (Spec 9 §4.2 manual path).
+     * Ensures the me page exists first.
+     *
+     * Spike (Spec 9 §4.2): auto-resolving the self open_id via
+     * `resolveSelfOpenId()` (src/collectors/feishu/self-open-id.ts) is wired as a
+     * best-effort enhancement only — it depends on a live lark-cli user-level
+     * OAuth session (user_access_token, separate from the bot token). That session
+     * is not available in CI/test, so only this manual path is exercised by tests
+     * and is the reliable default. Callers may best-effort call resolveSelfOpenId
+     * and feed the result here when a real session exists.
+     */
+    registerSelfHandle(kind: HandleKind, value: string): Promise<void>;
+    /**
+     * Whether `slugOrHandle` is the current user (Spec 9 §4.3). Accepts either a
+     * canonical slug (e.g. `entities/me`, `people/alice`) or a raw handle value
+     * (open_id / email / name / nickname); resolves to a canonical slug and
+     * compares against `entities/me`.
+     */
+    isMe(slugOrHandle: string): Promise<boolean>;
+    /**
+     * Explicitly attach a handle (alias) to a canonical person. Defaults to the
+     * kind's natural strength. Throws if the handle already points at a
+     * different person (use `merge` / `removeHandle` to reassign).
+     */
+    addAlias(canonicalSlug: string, kind: HandleKind, value: string, strength?: HandleStrength): Promise<void>;
+    /** List all handles attached to a canonical person. */
+    listHandles(canonicalSlug: string): Promise<PersonHandle[]>;
+    /** Remove a handle by (kind, value). */
+    removeHandle(kind: HandleKind, value: string): Promise<void>;
+    /**
+     * Rename a person's canonical slug (correct a wrong canonicalization).
+     * Renames the page, re-points handles + identity_cache, leaves the old slug
+     * behind as a resolvable alias.
+     */
+    recanonicalize(oldSlug: string, newSlug: string): Promise<void>;
+    /**
+     * Merge person page `fromSlug` into `intoSlug`. Re-points links, timeline
+     * entries, and tags; folds the body and aliases into the target; records the
+     * old slug + handles as aliases of the target; deletes the old page.
+     *
+     * All direct SQL is executed inside a single transaction. Page rows are
+     * locked in sorted slug order to prevent deadlocks between concurrent
+     * reverse merges. If the source page no longer exists inside the transaction
+     * (already merged by a concurrent caller), the method returns as a no-op.
+     *
+     * Note: the old page's embeddings (chunks) are dropped with it — run
+     * `memkin embed` afterwards to re-embed the folded content.
+     */
+    merge(fromSlug: string, intoSlug: string): Promise<void>;
+    private requirePages;
+    private insertHandle;
+    private repointIdentityCache;
+    /** tx-scoped variant of repointIdentityCache for use inside merge transaction. */
+    private repointIdentityCacheTx;
+    /** tx-scoped variant of insertHandle for use inside merge transaction. */
+    private insertHandleTx;
+    private frontmatterAliases;
+    private appendAliasesToPage;
+    private writePage;
+    /**
+     * tx-scoped page write for use inside the merge transaction.
+     * Executes the putPage SQL directly against the tx connection so the update
+     * participates in the outer transaction (avoids using a pool connection from
+     * PageStore which would be outside the tx boundary).
+     */
+    private writePageTx;
+}
+//# sourceMappingURL=person-identity.d.ts.map

package/dist/core/person-identity.d.ts.map

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