memkin 0.4.0

package/dist/core/person-identity.js

@@ -0,0 +1,428 @@
+/**
+ * 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 { stringify as stringifyYaml } from "yaml";
+/** Default strength for a handle kind. Nicknames are weak; everything else strong. */
+export function defaultStrength(kind) {
+    return kind === "nickname" ? "weak" : "strong";
+}
+/**
+ * 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 function canonicalizeHandleValue(kind, value) {
+    const trimmed = value.trim();
+    switch (kind) {
+        case "email":
+        case "feishu_open_id":
+            return trimmed.toLowerCase();
+        case "name":
+        case "nickname":
+            return trimmed.replace(/\s+/g, " ");
+        case "slug":
+            return trimmed;
+    }
+}
+const OPEN_ID_RE = /\bou_[a-zA-Z0-9]+\b/;
+const EMAIL_RE = /[^\s@]+@[^\s@]+\.[^\s@]+/;
+/** Canonical slug of the special "me" identity page (Spec 9 §4.1). */
+export const ME_SLUG = "entities/me";
+export class PersonIdentityStore {
+    db;
+    stores;
+    extra;
+    constructor(db, stores, extra) {
+        this.db = db;
+        this.stores = stores;
+        this.extra = extra;
+    }
+    /** Resolve a single handle to its canonical person slug, or null. */
+    async resolveHandle(kind, value) {
+        const v = canonicalizeHandleValue(kind, value);
+        const r = await this.db.query("SELECT canonical_slug FROM person_handles WHERE kind = $1 AND value = $2", [kind, v]);
+        return r.rows[0]?.canonical_slug ?? 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.
+     */
+    async resolveForExtraction(name, modelSlug) {
+        const bySlug = await this.resolveHandle("slug", modelSlug);
+        if (bySlug)
+            return bySlug;
+        const openId = name.match(OPEN_ID_RE)?.[0];
+        if (openId) {
+            const hit = await this.resolveHandle("feishu_open_id", openId);
+            if (hit)
+                return hit;
+        }
+        const email = name.match(EMAIL_RE)?.[0];
+        if (email) {
+            const hit = await this.resolveHandle("email", email);
+            if (hit)
+                return hit;
+        }
+        const byName = await this.resolveHandle("name", name);
+        if (byName)
+            return byName;
+        // Weak handles resolve too, but only because they were explicitly linked.
+        return this.resolveHandle("nickname", name);
+    }
+    /**
+     * 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.
+     */
+    async recordCanonical(name, canonicalSlug) {
+        await this.insertHandle("name", name, canonicalSlug, "strong", true);
+        await this.insertHandle("slug", canonicalSlug, canonicalSlug, "strong", true);
+        const openId = name.match(OPEN_ID_RE)?.[0];
+        if (openId) {
+            await this.insertHandle("feishu_open_id", openId, canonicalSlug, "strong", true);
+        }
+    }
+    /**
+     * 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.
+     */
+    async ensureEntitiesMe() {
+        const pages = this.requirePages();
+        const existing = await pages.getPage(ME_SLUG);
+        if (!existing) {
+            const content = `---\ntitle: Me\ntype: person\nis_me: true\n---\n# Me\n\n（自我身份页：可手编你的角色 / 公司 / 团队 / 项目 / 沟通偏好 / 各平台 handle。）\n`;
+            await pages.putPage(ME_SLUG, content);
+        }
+        await this.insertHandle("slug", ME_SLUG, ME_SLUG, "strong", true);
+        return ME_SLUG;
+    }
+    /**
+     * 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.
+     */
+    async registerSelfHandle(kind, value) {
+        await this.ensureEntitiesMe();
+        await this.insertHandle(kind, value, ME_SLUG, "strong", false);
+    }
+    /**
+     * 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`.
+     */
+    async isMe(slugOrHandle) {
+        if (slugOrHandle === ME_SLUG)
+            return true;
+        // direct slug handle
+        if ((await this.resolveHandle("slug", slugOrHandle)) === ME_SLUG)
+            return true;
+        // try the strong handle kinds it could be
+        for (const kind of ["feishu_open_id", "email", "name", "nickname"]) {
+            if ((await this.resolveHandle(kind, slugOrHandle)) === ME_SLUG)
+                return true;
+        }
+        return false;
+    }
+    /**
+     * 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).
+     */
+    async addAlias(canonicalSlug, kind, value, strength) {
+        const v = canonicalizeHandleValue(kind, value);
+        const existing = await this.resolveHandle(kind, v);
+        if (existing && existing !== canonicalSlug) {
+            throw new Error(`handle ${kind}:${v} already maps to '${existing}'; remove it or merge '${existing}' into '${canonicalSlug}' first`);
+        }
+        await this.insertHandle(kind, v, canonicalSlug, strength ?? defaultStrength(kind), false);
+        // Reflect the alias into the page frontmatter so it's visible + searchable.
+        if (this.stores?.pages) {
+            await this.appendAliasesToPage(canonicalSlug, [v]);
+        }
+    }
+    /** List all handles attached to a canonical person. */
+    async listHandles(canonicalSlug) {
+        const r = await this.db.query("SELECT kind, value, canonical_slug, strength FROM person_handles WHERE canonical_slug = $1 ORDER BY kind, value", [canonicalSlug]);
+        return r.rows;
+    }
+    /** Remove a handle by (kind, value). */
+    async removeHandle(kind, value) {
+        const v = canonicalizeHandleValue(kind, value);
+        await this.db.query("DELETE FROM person_handles WHERE kind = $1 AND value = $2", [kind, v]);
+    }
+    /**
+     * 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.
+     */
+    async recanonicalize(oldSlug, newSlug) {
+        if (oldSlug === newSlug)
+            return;
+        const pages = this.requirePages();
+        const page = await pages.getPage(oldSlug);
+        if (!page)
+            throw new Error(`person page '${oldSlug}' not found`);
+        if (await pages.getPage(newSlug)) {
+            throw new Error(`'${newSlug}' already exists; use merge('${oldSlug}', '${newSlug}') instead`);
+        }
+        await this.db.query("UPDATE pages SET slug = $1, updated_at = NOW() WHERE slug = $2", [
+            newSlug,
+            oldSlug,
+        ]);
+        await this.db.query("UPDATE person_handles SET canonical_slug = $1 WHERE canonical_slug = $2", [
+            newSlug,
+            oldSlug,
+        ]);
+        await this.insertHandle("slug", oldSlug, newSlug, "strong", false);
+        await this.repointIdentityCache(oldSlug, newSlug);
+        const renamed = await pages.getPage(newSlug);
+        if (renamed)
+            await this.appendAliasesToPage(newSlug, [oldSlug]);
+    }
+    /**
+     * 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.
+     */
+    async merge(fromSlug, intoSlug) {
+        if (fromSlug === intoSlug)
+            throw new Error("cannot merge a person into itself");
+        // Validate existence BEFORE the transaction (nicer error messages).
+        const pages = this.requirePages();
+        const fromPre = await pages.getPage(fromSlug);
+        const intoPre = await pages.getPage(intoSlug);
+        if (!fromPre)
+            throw new Error(`person page '${fromSlug}' not found`);
+        if (!intoPre)
+            throw new Error(`person page '${intoSlug}' not found`);
+        // Spec 8: behavior counters are additive; use their own atomic transaction.
+        // This runs outside the identity tx intentionally — behavior is eventually
+        // consistent and additive.
+        // NOTE: behavior.merge() runs BEFORE the identity tx (it has its own atomic tx).
+        // Known relaxation: if the identity tx below rolls back AFTER this succeeds,
+        // behavior counters are misattributed to the target while the identity merge is
+        // reverted (source page persists with no behavior row, counters double-counted
+        // under target). Acceptable for rare explicit merges; for strict consistency,
+        // move behavior merge into the identity tx via a tx-scoped variant.
+        // Identity-table integrity itself is unaffected.
+        if (this.extra?.behavior) {
+            await this.extra.behavior.merge(fromSlug, intoSlug);
+        }
+        // Compute merged content before entering the tx (reads only, no side effects).
+        const aliasValues = new Set([
+            ...this.frontmatterAliases(intoPre),
+            ...this.frontmatterAliases(fromPre),
+            fromSlug,
+        ]);
+        const foldedBody = fromPre.compiled_truth.trim().length > 0
+            ? `${intoPre.compiled_truth.trimEnd()}\n\n## Merged from ${fromSlug}\n\n${fromPre.compiled_truth.trim()}`
+            : intoPre.compiled_truth;
+        // Spec 8: drop stale cached communication profile so next synthesis recomputes.
+        const { profile: _staleProfile, ...intoFm } = intoPre.frontmatter;
+        const mergedPage = { ...intoPre, frontmatter: intoFm };
+        await this.db.transaction(async (tx) => {
+            // Lock page rows in FIXED sorted slug order to prevent deadlock between
+            // concurrent A→B and B→A merges.
+            const [firstSlug, secondSlug] = [fromSlug, intoSlug].sort();
+            await tx.query("SELECT id FROM pages WHERE slug = $1 FOR UPDATE", [firstSlug]);
+            await tx.query("SELECT id FROM pages WHERE slug = $1 FOR UPDATE", [secondSlug]);
+            // Idempotency: if the source page was already merged, return as no-op.
+            const fromCheck = await tx.query("SELECT id FROM pages WHERE slug = $1", [
+                fromSlug,
+            ]);
+            if (fromCheck.rows.length === 0)
+                return;
+            const fromId = fromCheck.rows[0].id;
+            const intoCheck = await tx.query("SELECT id FROM pages WHERE slug = $1", [
+                intoSlug,
+            ]);
+            if (intoCheck.rows.length === 0)
+                return;
+            const intoId = intoCheck.rows[0].id;
+            // Re-point outgoing links, skipping rows that would violate the
+            // UNIQUE(from_page_id, to_page_id, link_type) constraint, then drop dups.
+            await tx.query(`UPDATE links SET from_page_id = $1
+         WHERE from_page_id = $2
+           AND NOT EXISTS (
+             SELECT 1 FROM links l2
+             WHERE l2.from_page_id = $1 AND l2.to_page_id = links.to_page_id
+               AND l2.link_type = links.link_type
+           )`, [intoId, fromId]);
+            await tx.query("DELETE FROM links WHERE from_page_id = $1", [fromId]);
+            // Re-point incoming links.
+            await tx.query(`UPDATE links SET to_page_id = $1
+         WHERE to_page_id = $2
+           AND NOT EXISTS (
+             SELECT 1 FROM links l2
+             WHERE l2.to_page_id = $1 AND l2.from_page_id = links.from_page_id
+               AND l2.link_type = links.link_type
+           )`, [intoId, fromId]);
+            await tx.query("DELETE FROM links WHERE to_page_id = $1", [fromId]);
+            // Drop any self-link created by the merge.
+            await tx.query("DELETE FROM links WHERE from_page_id = $1 AND to_page_id = $1", [intoId]);
+            // Re-point timeline entries (UNIQUE(page_id, date, summary)).
+            await tx.query(`UPDATE timeline_entries SET page_id = $1
+         WHERE page_id = $2
+           AND NOT EXISTS (
+             SELECT 1 FROM timeline_entries t2
+             WHERE t2.page_id = $1 AND t2.date = timeline_entries.date
+               AND t2.summary = timeline_entries.summary
+           )`, [intoId, fromId]);
+            await tx.query("DELETE FROM timeline_entries WHERE page_id = $1", [fromId]);
+            // Re-point tags (UNIQUE(page_id, tag)).
+            await tx.query(`UPDATE tags SET page_id = $1
+         WHERE page_id = $2
+           AND NOT EXISTS (SELECT 1 FROM tags t2 WHERE t2.page_id = $1 AND t2.tag = tags.tag)`, [intoId, fromId]);
+            await tx.query("DELETE FROM tags WHERE page_id = $1", [fromId]);
+            // Fold body + aliases into the target page.
+            await this.writePageTx(tx, mergedPage, foldedBody, [...aliasValues]);
+            // Re-point handle + identity-cache mappings.
+            await tx.query("UPDATE person_handles SET canonical_slug = $1 WHERE canonical_slug = $2", [
+                intoSlug,
+                fromSlug,
+            ]);
+            await this.insertHandleTx(tx, "slug", fromSlug, intoSlug, "strong", false);
+            await this.repointIdentityCacheTx(tx, fromSlug, intoSlug);
+            // Delete the source page (chunks cascade via FK ON DELETE CASCADE).
+            await tx.query("DELETE FROM pages WHERE slug = $1", [fromSlug]);
+        });
+    }
+    // ── internals ──────────────────────────────────────────────────────────
+    requirePages() {
+        if (!this.stores?.pages) {
+            throw new Error("PersonIdentityStore: page operations require a PageStore");
+        }
+        return this.stores.pages;
+    }
+    async insertHandle(kind, value, canonicalSlug, strength, ignoreConflict) {
+        const v = canonicalizeHandleValue(kind, value);
+        if (ignoreConflict) {
+            await this.db.query(`INSERT INTO person_handles (kind, value, canonical_slug, strength)
+         VALUES ($1, $2, $3, $4)
+         ON CONFLICT (kind, value) DO NOTHING`, [kind, v, canonicalSlug, strength]);
+        }
+        else {
+            await this.db.query(`INSERT INTO person_handles (kind, value, canonical_slug, strength)
+         VALUES ($1, $2, $3, $4)
+         ON CONFLICT (kind, value) DO UPDATE SET
+           canonical_slug = EXCLUDED.canonical_slug,
+           strength = EXCLUDED.strength`, [kind, v, canonicalSlug, strength]);
+        }
+    }
+    async repointIdentityCache(oldSlug, newSlug) {
+        await this.db.query("UPDATE identity_cache SET display_name = $1 WHERE platform = 'canonical' AND display_name = $2", [newSlug, oldSlug]);
+        await this.db.query(`INSERT INTO identity_cache (platform, external_id, display_name, slug_hint)
+       VALUES ('canonical', $1, $2, $1)
+       ON CONFLICT (platform, external_id) DO UPDATE SET display_name = EXCLUDED.display_name`, [oldSlug, newSlug]);
+    }
+    /** tx-scoped variant of repointIdentityCache for use inside merge transaction. */
+    async repointIdentityCacheTx(tx, oldSlug, newSlug) {
+        await tx.query("UPDATE identity_cache SET display_name = $1 WHERE platform = 'canonical' AND display_name = $2", [newSlug, oldSlug]);
+        await tx.query(`INSERT INTO identity_cache (platform, external_id, display_name, slug_hint)
+       VALUES ('canonical', $1, $2, $1)
+       ON CONFLICT (platform, external_id) DO UPDATE SET display_name = EXCLUDED.display_name`, [oldSlug, newSlug]);
+    }
+    /** tx-scoped variant of insertHandle for use inside merge transaction. */
+    async insertHandleTx(tx, kind, value, canonicalSlug, strength, ignoreConflict) {
+        const v = canonicalizeHandleValue(kind, value);
+        if (ignoreConflict) {
+            await tx.query(`INSERT INTO person_handles (kind, value, canonical_slug, strength)
+         VALUES ($1, $2, $3, $4)
+         ON CONFLICT (kind, value) DO NOTHING`, [kind, v, canonicalSlug, strength]);
+        }
+        else {
+            await tx.query(`INSERT INTO person_handles (kind, value, canonical_slug, strength)
+         VALUES ($1, $2, $3, $4)
+         ON CONFLICT (kind, value) DO UPDATE SET
+           canonical_slug = EXCLUDED.canonical_slug,
+           strength = EXCLUDED.strength`, [kind, v, canonicalSlug, strength]);
+        }
+    }
+    frontmatterAliases(page) {
+        const a = page.frontmatter.aliases;
+        return Array.isArray(a) ? a.map(String) : [];
+    }
+    async appendAliasesToPage(slug, newAliases) {
+        const pages = this.requirePages();
+        const page = await pages.getPage(slug);
+        if (!page)
+            return;
+        const merged = new Set([...this.frontmatterAliases(page), ...newAliases]);
+        await this.writePage(page, page.compiled_truth, [...merged]);
+    }
+    async writePage(page, body, aliases) {
+        const pages = this.requirePages();
+        const { aliases: _drop, ...rest } = page.frontmatter;
+        const fm = {
+            title: page.title,
+            type: page.type,
+            ...rest,
+        };
+        if (aliases.length > 0)
+            fm.aliases = aliases;
+        const content = `---\n${stringifyYaml(fm)}---\n${body}`;
+        await pages.putPage(page.slug, content);
+    }
+    /**
+     * 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).
+     */
+    async writePageTx(tx, page, body, aliases) {
+        const { createHash } = await import("node:crypto");
+        const { stringify: stringifyYamlFn } = await import("yaml");
+        const { aliases: _drop, ...rest } = page.frontmatter;
+        const fm = {
+            title: page.title,
+            type: page.type,
+            ...rest,
+        };
+        if (aliases.length > 0)
+            fm.aliases = aliases;
+        const content = `---\n${stringifyYamlFn(fm)}---\n${body}`;
+        const contentHash = createHash("sha256").update(content).digest("hex");
+        await tx.query(`INSERT INTO pages (slug, type, title, compiled_truth, frontmatter, content_hash)
+       VALUES ($1, $2, $3, $4, $5::jsonb, $6)
+       ON CONFLICT (slug) DO UPDATE SET
+         type = EXCLUDED.type,
+         title = EXCLUDED.title,
+         compiled_truth = EXCLUDED.compiled_truth,
+         frontmatter = EXCLUDED.frontmatter,
+         content_hash = EXCLUDED.content_hash,
+         updated_at = NOW()`, [page.slug, page.type, page.title, body, JSON.stringify(fm), contentHash]);
+    }
+}
+//# sourceMappingURL=person-identity.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * Convert a person's name to a canonical slug.
+ *
+ * Chinese names: person/{family}-{given} (pinyin, lowercase)
+ * Latin names: person/{kebab-case}
+ * Feishu open IDs: person/{ou_<id>} (preserve underscore)
+ *
+ * Returns null if:
+ * - Input is empty or whitespace only
+ * - Name contains non-CJK, non-Latin scripts (e.g. Arabic, Cyrillic)
+ *
+ * @example
+ * toPersonCanonicalSlug("王建都") // "person/wang-jiandu"
+ * toPersonCanonicalSlug("李明") // "person/li-ming"
+ * toPersonCanonicalSlug("Alice Smith") // "person/alice-smith"
+ * toPersonCanonicalSlug("Sylar") // "person/sylar"
+ * toPersonCanonicalSlug("ou_10d417bea2263b13b0112f8067334323") // "person/ou_10d417..."
+ * toPersonCanonicalSlug("أحمد") // null
+ */
+export declare function toPersonCanonicalSlug(name: string): string | null;
+//# sourceMappingURL=person-slug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"person-slug.d.ts","sourceRoot":"","sources":["../../src/core/person-slug.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkDjE"}

package/dist/core/person-slug.js

@@ -0,0 +1,93 @@
+import { pinyin } from "pinyin-pro";
+/**
+ * Convert a person's name to a canonical slug.
+ *
+ * Chinese names: person/{family}-{given} (pinyin, lowercase)
+ * Latin names: person/{kebab-case}
+ * Feishu open IDs: person/{ou_<id>} (preserve underscore)
+ *
+ * Returns null if:
+ * - Input is empty or whitespace only
+ * - Name contains non-CJK, non-Latin scripts (e.g. Arabic, Cyrillic)
+ *
+ * @example
+ * toPersonCanonicalSlug("王建都") // "person/wang-jiandu"
+ * toPersonCanonicalSlug("李明") // "person/li-ming"
+ * toPersonCanonicalSlug("Alice Smith") // "person/alice-smith"
+ * toPersonCanonicalSlug("Sylar") // "person/sylar"
+ * toPersonCanonicalSlug("ou_10d417bea2263b13b0112f8067334323") // "person/ou_10d417..."
+ * toPersonCanonicalSlug("أحمد") // null
+ */
+export function toPersonCanonicalSlug(name) {
+    // 1. Trim whitespace
+    let cleaned = name.trim();
+    if (cleaned === "")
+        return null;
+    // 2. Generic Feishu user labels often include the only stable identity as an open ID.
+    const openIdMatch = cleaned.match(/\bou_[a-zA-Z0-9]+\b/);
+    if (openIdMatch) {
+        const labelWithoutOpenId = cleaned
+            .replace(/[（(][^）)]*ou_[a-zA-Z0-9]+[^）)]*[）)]/gi, "")
+            .replace(/\bou_[a-zA-Z0-9]+\b/gi, "")
+            .trim();
+        const genericLabel = labelWithoutOpenId
+            .toLowerCase()
+            .replace(/[^a-z]+/g, " ")
+            .trim();
+        const hasNamedCjkLabel = /[一-鿿]/.test(labelWithoutOpenId);
+        if (!hasNamedCjkLabel &&
+            (genericLabel === "" || genericLabel === "user" || genericLabel === "feishu user")) {
+            return `person/${openIdMatch[0].toLowerCase()}`;
+        }
+    }
+    // 3. Remove parenthetical hints: strip (...)
+    cleaned = cleaned.replace(/[（(][^）)]*[）)]/g, "").trim();
+    if (cleaned === "")
+        return null;
+    // 4. Preserve bare Feishu open IDs as stable opaque identifiers.
+    if (/^ou_[a-zA-Z0-9]+$/.test(cleaned)) {
+        return `person/${cleaned.toLowerCase()}`;
+    }
+    // 5. Detect script
+    const hasCJK = /[一-鿿]/.test(cleaned);
+    const isLatinOnly = /^[a-zA-Z\s\-']+$/.test(cleaned);
+    if (hasCJK) {
+        // Chinese path
+        return chinesePath(cleaned);
+    }
+    if (isLatinOnly) {
+        // Latin path
+        return latinPath(cleaned);
+    }
+    // Otherwise: ambiguous or unsupported script
+    return null;
+}
+function chinesePath(name) {
+    // Convert to pinyin array (without tones)
+    const syllables = pinyin(name, { toneType: "none", type: "array" });
+    if (syllables.length === 0)
+        return "person/unknown";
+    if (syllables.length === 1) {
+        // Single character name
+        return `person/${syllables[0].toLowerCase()}`;
+    }
+    // First syllable = family name
+    const family = syllables[0].toLowerCase();
+    // Remaining syllables = join together (no separator) = given name
+    const given = syllables
+        .slice(1)
+        .map((s) => s.toLowerCase())
+        .join("");
+    return `person/${family}-${given}`;
+}
+function latinPath(name) {
+    // Lowercase, replace apostrophes with hyphen, split on whitespace/hyphen, join with hyphen
+    const kebab = name
+        .toLowerCase()
+        .replace(/'/g, "-") // Replace apostrophes with hyphens
+        .split(/\s+/)
+        .filter((part) => part.length > 0)
+        .join("-");
+    return `person/${kebab}`;
+}
+//# sourceMappingURL=person-slug.js.map

package/dist/core/person-slug.js.map

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

package/dist/core/pipeline-factory.d.ts

@@ -0,0 +1,13 @@
+import type { LLMProvider } from "../extractors/providers/types.js";
+import type { SqlExecutor } from "../store/sql-executor.js";
+import type { Config } from "./config.js";
+import { IdentityResolver } from "./identity-resolver.js";
+import type { PipelineConfig } from "./pipeline.js";
+export interface PipelineRuntime {
+    config: PipelineConfig;
+    provider: LLMProvider;
+    identity_resolver?: IdentityResolver;
+}
+export declare function buildPipelineConfig(config: Config, output_dir: string, projectRoot?: string): PipelineConfig;
+export declare function createPipelineRuntime(config: Config, pg: SqlExecutor, output_dir: string): Promise<PipelineRuntime>;
+//# sourceMappingURL=pipeline-factory.d.ts.map

package/dist/core/pipeline-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-factory.d.ts","sourceRoot":"","sources":["../../src/core/pipeline-factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,WAAW,CAAC;IACtB,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CACtC;AAMD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,cAAc,CAahB;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,WAAW,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAiB1B"}

package/dist/core/pipeline-factory.js

@@ -0,0 +1,37 @@
+import { createLLMProvider } from "../extractors/providers/index.js";
+import { IdentityResolver } from "./identity-resolver.js";
+import { statePath } from "./state.js";
+function projectRootOf(config, projectRoot) {
+    return projectRoot ?? config.__context?.projectRoot;
+}
+export function buildPipelineConfig(config, output_dir, projectRoot) {
+    const stateBase = projectRootOf(config, projectRoot);
+    return {
+        dedup_checkpoint: statePath("dedup.jsonl", stateBase),
+        cursor_checkpoint: statePath("cursors.yaml", stateBase),
+        block_gap_minutes: config.block_builder.block_gap_minutes,
+        max_block_tokens: config.block_builder.max_block_tokens,
+        max_block_messages: config.block_builder.max_block_messages,
+        privacy: config.privacy,
+        output_dir,
+        block_concurrency: config.pipeline?.block_concurrency,
+        state_base: stateBase,
+    };
+}
+export async function createPipelineRuntime(config, pg, output_dir) {
+    const llmConfig = { ...config.llm };
+    if (!llmConfig.api_key && !process.env.OPENAI_API_KEY) {
+        throw new Error("No API key configured. Set api_key in memkin.yaml or OPENAI_API_KEY env var.");
+    }
+    if (!llmConfig.api_key) {
+        llmConfig.api_key = process.env.OPENAI_API_KEY;
+    }
+    const provider = createLLMProvider(llmConfig);
+    const identity_resolver = new IdentityResolver(pg);
+    return {
+        config: buildPipelineConfig(config, output_dir),
+        provider,
+        identity_resolver,
+    };
+}
+//# sourceMappingURL=pipeline-factory.js.map

package/dist/core/pipeline-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-factory.js","sourceRoot":"","sources":["../../src/core/pipeline-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAIrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAQvC,SAAS,aAAa,CAAC,MAAc,EAAE,WAAoB;IACzD,OAAO,WAAW,IAAK,MAAgC,CAAC,SAAS,EAAE,WAAW,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,UAAkB,EAClB,WAAoB;IAEpB,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrD,OAAO;QACL,gBAAgB,EAAE,SAAS,CAAC,aAAa,EAAE,SAAS,CAAC;QACrD,iBAAiB,EAAE,SAAS,CAAC,cAAc,EAAE,SAAS,CAAC;QACvD,iBAAiB,EAAE,MAAM,CAAC,aAAa,CAAC,iBAAiB;QACzD,gBAAgB,EAAE,MAAM,CAAC,aAAa,CAAC,gBAAgB;QACvD,kBAAkB,EAAE,MAAM,CAAC,aAAa,CAAC,kBAAkB;QAC3D,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU;QACV,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,iBAAiB;QACrD,UAAU,EAAE,SAAS;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAc,EACd,EAAe,EACf,UAAkB;IAElB,MAAM,SAAS,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACvB,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACjD,CAAC;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAE9C,MAAM,iBAAiB,GAAG,IAAI,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAEnD,OAAO;QACL,MAAM,EAAE,mBAAmB,CAAC,MAAM,EAAE,UAAU,CAAC;QAC/C,QAAQ;QACR,iBAAiB;KAClB,CAAC;AACJ,CAAC"}