@andre.li/memoark 0.3.1 → 0.3.2

package/dist/core/person-identity.js

@@ -0,0 +1,342 @@
+/**
+ * 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.
+     *
+     * Note: the old page's embeddings (chunks) are dropped with it — run
+     * `memoark embed` afterwards to re-embed the folded content.
+     */
+    async merge(fromSlug, intoSlug) {
+        if (fromSlug === intoSlug)
+            throw new Error("cannot merge a person into itself");
+        const pages = this.requirePages();
+        const from = await pages.getPage(fromSlug);
+        const into = await pages.getPage(intoSlug);
+        if (!from)
+            throw new Error(`person page '${fromSlug}' not found`);
+        if (!into)
+            throw new Error(`person page '${intoSlug}' not found`);
+        const fromId = from.id;
+        const intoId = into.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 this.db.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 this.db.query("DELETE FROM links WHERE from_page_id = $1", [fromId]);
+        // Re-point incoming links.
+        await this.db.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 this.db.query("DELETE FROM links WHERE to_page_id = $1", [fromId]);
+        // Drop any self-link created by the merge.
+        await this.db.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 this.db.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 this.db.query("DELETE FROM timeline_entries WHERE page_id = $1", [fromId]);
+        // Re-point tags (UNIQUE(page_id, tag)).
+        await this.db.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 this.db.query("DELETE FROM tags WHERE page_id = $1", [fromId]);
+        // Fold body + aliases into the target.
+        const aliasValues = new Set([
+            ...this.frontmatterAliases(into),
+            ...this.frontmatterAliases(from),
+            fromSlug,
+        ]);
+        const foldedBody = from.compiled_truth.trim().length > 0
+            ? `${into.compiled_truth.trimEnd()}\n\n## Merged from ${fromSlug}\n\n${from.compiled_truth.trim()}`
+            : into.compiled_truth;
+        // Spec 8: the merged-into person's cached communication profile is now stale
+        // (it was computed before the behavior counters were folded in) — drop it so
+        // the next nightly synthesis recomputes from the combined evidence.
+        const { profile: _staleProfile, ...intoFm } = into.frontmatter;
+        await this.writePage({ ...into, frontmatter: intoFm }, foldedBody, [...aliasValues]);
+        // Spec 8: fold the behavior-layer counters (additive) into the target.
+        if (this.extra?.behavior) {
+            await this.extra.behavior.merge(fromSlug, intoSlug);
+        }
+        // Re-point handle + identity-cache mappings, then drop the old page.
+        await this.db.query("UPDATE person_handles SET canonical_slug = $1 WHERE canonical_slug = $2", [
+            intoSlug,
+            fromSlug,
+        ]);
+        await this.insertHandle("slug", fromSlug, intoSlug, "strong", false);
+        await this.repointIdentityCache(fromSlug, intoSlug);
+        await pages.deletePage(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]);
+    }
+    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);
+    }
+}
+//# 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

@@ -8,6 +8,6 @@ export interface PipelineRuntime {
     provider: LLMProvider;
     identity_resolver?: IdentityResolver;
 }
-export declare function buildPipelineConfig(config: Config, output_dir: string): PipelineConfig;
+export declare function buildPipelineConfig(config: Config, output_dir: string, projectRoot?: string): PipelineConfig;
 export declare function createPipelineRuntime(config: Config, pg: PGlite, output_dir: string): Promise<PipelineRuntime>;
 //# sourceMappingURL=pipeline-factory.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pipeline-factory.d.ts","sourceRoot":"","sources":["../../src/core/pipeline-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,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;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAWtF;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAmB1B"}
+{"version":3,"file":"pipeline-factory.d.ts","sourceRoot":"","sources":["../../src/core/pipeline-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,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,MAAM,EACV,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAmB1B"}

package/dist/core/pipeline-factory.js

@@ -1,16 +1,21 @@
 import { createLLMProvider } from "../extractors/providers/index.js";
 import { IdentityResolver } from "./identity-resolver.js";
 import { statePath } from "./state.js";
-export function buildPipelineConfig(config, output_dir) {
+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"),
-        cursor_checkpoint: statePath("cursors.yaml"),
+        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) {

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

@@ -1 +1 @@
-{"version":3,"file":"pipeline-factory.js","sourceRoot":"","sources":["../../src/core/pipeline-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAGrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAQvC,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,UAAkB;IACpE,OAAO;QACL,gBAAgB,EAAE,SAAS,CAAC,aAAa,CAAC;QAC1C,iBAAiB,EAAE,SAAS,CAAC,cAAc,CAAC;QAC5C,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;KACtD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAc,EACd,EAAU,EACV,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,CACb,+EAA+E,CAChF,CAAC;IACJ,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"}
+{"version":3,"file":"pipeline-factory.js","sourceRoot":"","sources":["../../src/core/pipeline-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAGrE,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,EAAU,EACV,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,CACb,+EAA+E,CAChF,CAAC;IACJ,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"}

package/dist/core/pipeline.d.ts

@@ -5,7 +5,9 @@
  */
 import { type StoreAdapterContext } from "../adapters/store.js";
 import type { LLMProvider } from "../extractors/providers/types.js";
+import { type AccumulateDeps } from "../profile/accumulate.js";
 import type { PrivacyConfig } from "./config.js";
+import type { IdentityResolver } from "./identity-resolver.js";
 import type { Collector, RawMessage } from "./types.js";
 /**
  * Pipeline configuration
@@ -19,6 +21,7 @@ export interface PipelineConfig {
     privacy: PrivacyConfig;
     output_dir: string;
     block_concurrency?: number;
+    state_base?: string;
 }
 /**
  * Pipeline execution options
@@ -32,6 +35,19 @@ export interface PipelineOpts {
     dryRun?: boolean;
     since?: string;
     limit?: number;
+    /**
+     * Optional identity resolver. When provided, person slugs are canonicalized
+     * (Stage 2.5) before results are pushed to the adapter, preventing duplicate
+     * person pages from LLM-produced slug variants.
+     */
+    identityResolver?: IdentityResolver;
+    /**
+     * Optional person-communication-profile behavior accumulation (Spec 8 §4.1).
+     * When provided AND config.profile.enabled, DM/group blocks contribute to the
+     * person_behavior table while raw messages are still in memory. No-op when the
+     * config is disabled, so callers can wire it unconditionally.
+     */
+    behavior?: AccumulateDeps;
 }
 /**
  * Pipeline execution result

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

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAM9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAKpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,OAAO,KAAK,EAGV,SAAS,EAGT,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5B,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAChD,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,cAAc,EAAE,UAAU,EAAE,CAAC;IAC7B,kBAAkB,CAAC,EAAE,UAAU,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,cAAc,CAAC,CA0QzB"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAO9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAGpE,OAAO,EAAE,KAAK,cAAc,EAAsB,MAAM,0BAA0B,CAAC;AAGnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,KAAK,EAGV,SAAS,EAGT,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5B,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAChD,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,cAAc,EAAE,UAAU,EAAE,CAAC;IAC7B,kBAAkB,CAAC,EAAE,UAAU,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,cAAc,CAAC,CA+TzB"}