@andre.li/memoark 0.3.1 → 0.3.2

package/dist/collectors/feishu/docs/types.d.ts

@@ -0,0 +1,109 @@
+export type DocSourceOrigin = {
+    kind: "my_space";
+    folder_token: string;
+} | {
+    kind: "wiki";
+    space_id: string;
+    space_name: string;
+    node_token: string;
+} | {
+    kind: "folder";
+    folder_token: string;
+    folder_name: string;
+} | {
+    kind: "mcp_ingest";
+};
+export interface DocCandidate {
+    doc_token: string;
+    doc_type: "docx";
+    title: string;
+    url: string;
+    owner_id: string;
+    last_editor_id: string;
+    created_at: string;
+    modified_at: string;
+    source: DocSourceOrigin;
+    parent_path: string;
+}
+export interface EntityMention {
+    name: string;
+    type_guess: "person" | "project" | "tool" | "concept" | "organization";
+}
+export interface TocItem {
+    level: 1 | 2 | 3;
+    title: string;
+}
+export interface DocDecision {
+    text: string;
+    made_by_raw?: string;
+}
+export interface ActionItem {
+    text: string;
+    owner_raw?: string;
+    owner_slug?: string;
+    due?: string;
+    status: "open" | "done";
+}
+export interface PointerCard extends DocCandidate {
+    extract_level: "pointer";
+    extracted_at: string;
+    extract_error?: string;
+    extract_skipped?: string;
+    user_note?: string;
+}
+export interface FullCard extends DocCandidate {
+    extract_level: "full";
+    purpose: string;
+    topics: string[];
+    entities: EntityMention[];
+    toc: TocItem[];
+    overview: string;
+    decisions: DocDecision[];
+    action_items: ActionItem[];
+    source_body_hash: string;
+    summary_generated_at: string;
+    summary_model: string;
+    extracted_at: string;
+    user_note?: string;
+    tags?: string[];
+}
+export type DocCard = PointerCard | FullCard;
+export interface DocBlock {
+    type: "heading1" | "heading2" | "heading3" | "text" | "other";
+    text: string;
+}
+export interface DocDecisionConfig {
+    self_edit: boolean;
+    recent_window_days: number | null;
+    important_folders: string[];
+    important_wiki_spaces: string[];
+}
+export type Decision = {
+    action: "skip_save";
+} | {
+    action: "save_pointer";
+    reason: string;
+} | {
+    action: "queue_for_upgrade";
+    trigger: string;
+} | {
+    action: "needs_body_check";
+};
+export type BodyCheckDecision = {
+    action: "metadata_refresh";
+} | {
+    action: "queue_for_upgrade";
+    trigger: "T5";
+};
+export type ParsedFeishuUrl = {
+    kind: "docx";
+    token: string;
+} | {
+    kind: "wiki_node";
+    node_token: string;
+} | {
+    kind: "reject";
+    code: "INVALID_URL" | "UNSUPPORTED_DOC_TYPE";
+    message: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/collectors/feishu/docs/types.d.ts.map

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

package/dist/collectors/feishu/docs/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/collectors/feishu/docs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/types.ts"],"names":[],"mappings":""}

package/dist/collectors/feishu/docs/upgrade-queue.d.ts

@@ -0,0 +1,19 @@
+export interface UpgradeQueueConfig {
+    batch_size: number;
+    bootstrap_batch_size: number;
+    bootstrap_runs: number;
+    max_pending: number;
+}
+export declare class UpgradeQueue {
+    private readonly maxPending;
+    private items;
+    private set;
+    constructor(initial: string[], maxPending: number);
+    /** Returns true if enqueued, false if duplicate or cap reached (dropped). */
+    enqueue(docToken: string): boolean;
+    shift(k: number): string[];
+    pending(): string[];
+    size(): number;
+}
+export declare function batchSizeForRun(runCount: number, cfg: UpgradeQueueConfig): number;
+//# sourceMappingURL=upgrade-queue.d.ts.map

package/dist/collectors/feishu/docs/upgrade-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-queue.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/upgrade-queue.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,GAAG,CAAc;gBAGvB,OAAO,EAAE,MAAM,EAAE,EACA,UAAU,EAAE,MAAM;IAMrC,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQlC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAM1B,OAAO,IAAI,MAAM,EAAE;IAInB,IAAI,IAAI,MAAM;CAGf;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAEjF"}

package/dist/collectors/feishu/docs/upgrade-queue.js

@@ -0,0 +1,36 @@
+export class UpgradeQueue {
+    maxPending;
+    items;
+    set;
+    constructor(initial, maxPending) {
+        this.maxPending = maxPending;
+        this.items = [...initial];
+        this.set = new Set(initial);
+    }
+    /** Returns true if enqueued, false if duplicate or cap reached (dropped). */
+    enqueue(docToken) {
+        if (this.set.has(docToken))
+            return false;
+        if (this.items.length >= this.maxPending)
+            return false;
+        this.items.push(docToken);
+        this.set.add(docToken);
+        return true;
+    }
+    shift(k) {
+        const batch = this.items.splice(0, k);
+        for (const t of batch)
+            this.set.delete(t);
+        return batch;
+    }
+    pending() {
+        return [...this.items];
+    }
+    size() {
+        return this.items.length;
+    }
+}
+export function batchSizeForRun(runCount, cfg) {
+    return runCount < cfg.bootstrap_runs ? cfg.bootstrap_batch_size : cfg.batch_size;
+}
+//# sourceMappingURL=upgrade-queue.js.map

package/dist/collectors/feishu/docs/upgrade-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-queue.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/upgrade-queue.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,YAAY;IAMJ;IALX,KAAK,CAAW;IAChB,GAAG,CAAc;IAEzB,YACE,OAAiB,EACA,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;QAEnC,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,6EAA6E;IAC7E,OAAO,CAAC,QAAgB;QACtB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QACvD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,CAAS;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,GAAuB;IACvE,OAAO,QAAQ,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;AACnF,CAAC"}

package/dist/collectors/feishu/docs/url-parser.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedFeishuUrl } from "./types.js";
+export declare function parseFeishuUrl(input: string): ParsedFeishuUrl;
+//# sourceMappingURL=url-parser.d.ts.map

package/dist/collectors/feishu/docs/url-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-parser.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/url-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQlD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAsC7D"}

package/dist/collectors/feishu/docs/url-parser.js

@@ -0,0 +1,39 @@
+const RAW_TOKEN = /^[A-Za-z0-9]{20,}$/;
+const DOCX_URL = /feishu\.[a-z]+\/docx\/([^/?#]+)/;
+const WIKI_URL = /feishu\.[a-z]+\/wiki\/([^/?#]+)/;
+const OLD_DOC_URL = /feishu\.[a-z]+\/docs\//;
+const UNSUPPORTED_URL = /feishu\.[a-z]+\/(sheets|base|mindnotes|file|slides)\//;
+export function parseFeishuUrl(input) {
+    const value = input.trim();
+    if (RAW_TOKEN.test(value)) {
+        return { kind: "docx", token: value };
+    }
+    const docx = value.match(DOCX_URL);
+    if (docx) {
+        return { kind: "docx", token: docx[1] };
+    }
+    const wiki = value.match(WIKI_URL);
+    if (wiki) {
+        return { kind: "wiki_node", node_token: wiki[1] };
+    }
+    if (OLD_DOC_URL.test(value)) {
+        return {
+            kind: "reject",
+            code: "UNSUPPORTED_DOC_TYPE",
+            message: "Old /docs/ documents are not supported in v1 (docx only)",
+        };
+    }
+    if (UNSUPPORTED_URL.test(value)) {
+        return {
+            kind: "reject",
+            code: "UNSUPPORTED_DOC_TYPE",
+            message: "Only docx is supported in v1",
+        };
+    }
+    return {
+        kind: "reject",
+        code: "INVALID_URL",
+        message: `Unrecognized Feishu URL or token: ${input}`,
+    };
+}
+//# sourceMappingURL=url-parser.js.map

package/dist/collectors/feishu/docs/url-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-parser.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/url-parser.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAG,oBAAoB,CAAC;AACvC,MAAM,QAAQ,GAAG,iCAAiC,CAAC;AACnD,MAAM,QAAQ,GAAG,iCAAiC,CAAC;AACnD,MAAM,WAAW,GAAG,wBAAwB,CAAC;AAC7C,MAAM,eAAe,GAAG,uDAAuD,CAAC;AAEhF,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE3B,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,CAAC;IAED,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,0DAA0D;SACpE,CAAC;IACJ,CAAC;IAED,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,8BAA8B;SACxC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,qCAAqC,KAAK,EAAE;KACtD,CAAC;AACJ,CAAC"}

package/dist/collectors/feishu/docs/walkers.d.ts

@@ -0,0 +1,24 @@
+import type { IFeishuHttpClient } from "../http-client.js";
+import type { ResolvedDocsConfig } from "./config.js";
+import type { DocCandidate, DocSourceOrigin } from "./types.js";
+/**
+ * Recursively walk a drive folder. docx files → candidates; folders → recurse
+ * while depth budget remains. `source` describes the origin for emitted
+ * candidates; `parentPath` is the human-readable breadcrumb.
+ * CALIBRATED 2026-06-14: drive/v1/files rows carry `type` with live values
+ * folder/docx/bitable/file, so `file.type === "folder"` / `"docx"` are correct.
+ */
+export declare function walkDriveFolder(client: IFeishuHttpClient, folderToken: string, source: DocSourceOrigin, parentPath: string, maxDepth: number): AsyncGenerator<DocCandidate>;
+/**
+ * Walk every wiki space (minus excluded ids) and emit docx nodes.
+ * CALIBRATED 2026-06-14: wiki/v2/spaces rows expose `space_id`/`name`, and
+ * wiki/v2/spaces/<id>/nodes rows expose `node_token`/`obj_token`/`obj_type`/
+ * `title` plus `owner` (the last-editor field, NOT `owner_id`) and a real `url`.
+ */
+export declare function walkWiki(client: IFeishuHttpClient, excludeSpaceIds: string[]): AsyncGenerator<DocCandidate>;
+/**
+ * Union of all configured walkers, deduped by doc_token. My Space first, then
+ * whitelist folders, then Wiki — first occurrence wins.
+ */
+export declare function iterateCandidates(client: IFeishuHttpClient, config: ResolvedDocsConfig): AsyncGenerator<DocCandidate>;
+//# sourceMappingURL=walkers.d.ts.map

package/dist/collectors/feishu/docs/walkers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walkers.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/walkers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;GAMG;AACH,wBAAuB,eAAe,CACpC,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,cAAc,CAAC,YAAY,CAAC,CAsB9B;AAOD;;;;;GAKG;AACH,wBAAuB,QAAQ,CAC7B,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,MAAM,EAAE,GACxB,cAAc,CAAC,YAAY,CAAC,CAwB9B;AAeD;;;GAGG;AACH,wBAAuB,iBAAiB,CACtC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,kBAAkB,GACzB,cAAc,CAAC,YAAY,CAAC,CAyC9B"}

package/dist/collectors/feishu/docs/walkers.js

@@ -0,0 +1,90 @@
+import { driveFileToCandidate, wikiNodeToCandidate } from "./candidate.js";
+/**
+ * Recursively walk a drive folder. docx files → candidates; folders → recurse
+ * while depth budget remains. `source` describes the origin for emitted
+ * candidates; `parentPath` is the human-readable breadcrumb.
+ * CALIBRATED 2026-06-14: drive/v1/files rows carry `type` with live values
+ * folder/docx/bitable/file, so `file.type === "folder"` / `"docx"` are correct.
+ */
+export async function* walkDriveFolder(client, folderToken, source, parentPath, maxDepth) {
+    for await (const page of client.paginate("/open-apis/drive/v1/files", {
+        folder_token: folderToken,
+        page_size: "50",
+    })) {
+        for (const file of page.items) {
+            if (file.type === "folder") {
+                if (maxDepth > 0) {
+                    yield* walkDriveFolder(client, file.token, source, `${parentPath}${file.name}/`, maxDepth - 1);
+                }
+                continue;
+            }
+            if (file.type !== "docx")
+                continue;
+            yield driveFileToCandidate(file, source, parentPath);
+        }
+    }
+}
+/**
+ * Walk every wiki space (minus excluded ids) and emit docx nodes.
+ * CALIBRATED 2026-06-14: wiki/v2/spaces rows expose `space_id`/`name`, and
+ * wiki/v2/spaces/<id>/nodes rows expose `node_token`/`obj_token`/`obj_type`/
+ * `title` plus `owner` (the last-editor field, NOT `owner_id`) and a real `url`.
+ */
+export async function* walkWiki(client, excludeSpaceIds) {
+    const excluded = new Set(excludeSpaceIds);
+    for await (const spacePage of client.paginate("/open-apis/wiki/v2/spaces")) {
+        for (const space of spacePage.items) {
+            if (excluded.has(space.space_id))
+                continue;
+            for await (const nodePage of client.paginate(`/open-apis/wiki/v2/spaces/${space.space_id}/nodes`)) {
+                for (const node of nodePage.items) {
+                    if (node.obj_type !== "docx")
+                        continue;
+                    yield wikiNodeToCandidate(node, {
+                        kind: "wiki",
+                        space_id: space.space_id,
+                        space_name: space.name,
+                        node_token: node.node_token,
+                    }, `Wiki/${space.name}/`);
+                }
+            }
+        }
+    }
+}
+/**
+ * CALIBRATED 2026-06-14 against real lark-cli: the endpoint is the explorer v2
+ * API (the drive/v1 path returns HTTP 404), and the root token is at data.token.
+ * Real response: { code: 0, data: { id, token, user_id }, msg: "success" }.
+ */
+async function getMySpaceRoot(client) {
+    const res = await client.request("GET", "/open-apis/drive/explorer/v2/root_folder/meta");
+    return res.data?.token ?? null;
+}
+/**
+ * Union of all configured walkers, deduped by doc_token. My Space first, then
+ * whitelist folders, then Wiki — first occurrence wins.
+ */
+export async function* iterateCandidates(client, config) {
+    const seen = new Set();
+    const emit = async function* (gen) {
+        for await (const c of gen) {
+            if (seen.has(c.doc_token))
+                continue;
+            seen.add(c.doc_token);
+            yield c;
+        }
+    };
+    if (config.my_space.enabled) {
+        const root = await getMySpaceRoot(client);
+        if (root) {
+            yield* emit(walkDriveFolder(client, root, { kind: "my_space", folder_token: root }, "My Space/", config.my_space.max_depth));
+        }
+    }
+    for (const folder of config.folders) {
+        yield* emit(walkDriveFolder(client, folder.token, { kind: "folder", folder_token: folder.token, folder_name: folder.name }, `${folder.name}/`, config.my_space.max_depth));
+    }
+    if (config.wiki.enabled) {
+        yield* emit(walkWiki(client, config.wiki.exclude_space_ids));
+    }
+}
+//# sourceMappingURL=walkers.js.map

package/dist/collectors/feishu/docs/walkers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walkers.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/walkers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAuB,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIhG;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,eAAe,CACpC,MAAyB,EACzB,WAAmB,EACnB,MAAuB,EACvB,UAAkB,EAClB,QAAgB;IAEhB,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAkB,2BAA2B,EAAE;QACrF,YAAY,EAAE,WAAW;QACzB,SAAS,EAAE,IAAI;KAChB,CAAC,EAAE,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC3B,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;oBACjB,KAAK,CAAC,CAAC,eAAe,CACpB,MAAM,EACN,IAAI,CAAC,KAAK,EACV,MAAM,EACN,GAAG,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,EAC5B,QAAQ,GAAG,CAAC,CACb,CAAC;gBACJ,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAS;YACnC,MAAM,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;AACH,CAAC;AAOD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,QAAQ,CAC7B,MAAyB,EACzB,eAAyB;IAEzB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;IAC1C,IAAI,KAAK,EAAE,MAAM,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAkB,2BAA2B,CAAC,EAAE,CAAC;QAC5F,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACpC,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAC3C,IAAI,KAAK,EAAE,MAAM,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAC1C,6BAA6B,KAAK,CAAC,QAAQ,QAAQ,CACpD,EAAE,CAAC;gBACF,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;oBAClC,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM;wBAAE,SAAS;oBACvC,MAAM,mBAAmB,CACvB,IAAI,EACJ;wBACE,IAAI,EAAE,MAAM;wBACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,UAAU,EAAE,KAAK,CAAC,IAAI;wBACtB,UAAU,EAAE,IAAI,CAAC,UAAU;qBAC5B,EACD,QAAQ,KAAK,CAAC,IAAI,GAAG,CACtB,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,cAAc,CAAC,MAAyB;IACrD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAC9B,KAAK,EACL,+CAA+C,CAChD,CAAC;IACF,OAAO,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,iBAAiB,CACtC,MAAyB,EACzB,MAA0B;IAE1B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,IAAI,GAAG,KAAK,SAAS,CAAC,EAAE,GAAiC;QAC7D,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;gBAAE,SAAS;YACpC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACtB,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,CAAC,CAAC,IAAI,CACT,eAAe,CACb,MAAM,EACN,IAAI,EACJ,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,EACxC,WAAW,EACX,MAAM,CAAC,QAAQ,CAAC,SAAS,CAC1B,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,KAAK,CAAC,CAAC,IAAI,CACT,eAAe,CACb,MAAM,EACN,MAAM,CAAC,KAAK,EACZ,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,EACxE,GAAG,MAAM,CAAC,IAAI,GAAG,EACjB,MAAM,CAAC,QAAQ,CAAC,SAAS,CAC1B,CACF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/collectors/feishu/docs/wiki-resolver.d.ts

@@ -0,0 +1,15 @@
+import type { IFeishuHttpClient } from "../http-client.js";
+export declare class WikiNodeNotFoundError extends Error {
+    node_token: string;
+    constructor(node_token: string);
+}
+/**
+ * CALIBRATED 2026-06-14: GET /open-apis/wiki/v2/spaces/get_node returns the node
+ * under data.node, carrying obj_token/obj_type (same fields seen live on the
+ * wiki/v2/spaces/<id>/nodes rows — see probe-fixtures.md wiki_node_row).
+ */
+export declare function resolveWikiNode(client: IFeishuHttpClient, nodeToken: string): Promise<{
+    obj_token: string;
+    obj_type: string;
+}>;
+//# sourceMappingURL=wiki-resolver.d.ts.map

package/dist/collectors/feishu/docs/wiki-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-resolver.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/wiki-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,qBAAa,qBAAsB,SAAQ,KAAK;IAC3B,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAItC;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAYlD"}

package/dist/collectors/feishu/docs/wiki-resolver.js

@@ -0,0 +1,24 @@
+export class WikiNodeNotFoundError extends Error {
+    node_token;
+    constructor(node_token) {
+        super(`Wiki node not found: ${node_token}`);
+        this.node_token = node_token;
+        this.name = "WikiNodeNotFoundError";
+    }
+}
+/**
+ * CALIBRATED 2026-06-14: GET /open-apis/wiki/v2/spaces/get_node returns the node
+ * under data.node, carrying obj_token/obj_type (same fields seen live on the
+ * wiki/v2/spaces/<id>/nodes rows — see probe-fixtures.md wiki_node_row).
+ */
+export async function resolveWikiNode(client, nodeToken) {
+    const res = await client.request("GET", "/open-apis/wiki/v2/spaces/get_node", {
+        params: { token: nodeToken, obj_type: "wiki" },
+    });
+    const node = res.data?.node;
+    if (!node?.obj_token || !node.obj_type) {
+        throw new WikiNodeNotFoundError(nodeToken);
+    }
+    return { obj_token: node.obj_token, obj_type: node.obj_type };
+}
+//# sourceMappingURL=wiki-resolver.js.map

package/dist/collectors/feishu/docs/wiki-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-resolver.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/wiki-resolver.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC3B;IAAnB,YAAmB,UAAkB;QACnC,KAAK,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;QAD3B,eAAU,GAAV,UAAU,CAAQ;QAEnC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAyB,EACzB,SAAiB;IAEjB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAG7B,KAAK,EAAE,oCAAoC,EAAE;QAC9C,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE;KAC/C,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;AAChE,CAAC"}

package/dist/collectors/feishu/lark-cli-client.d.ts

@@ -8,6 +8,18 @@ export declare class LarkCliHttpClient implements IFeishuHttpClient {
     }): Promise<T>;
     paginate<T = Record<string, unknown>>(path: string, params?: Record<string, string>): AsyncGenerator<PagedResult<T>>;
     execShortcut(domain: string, shortcut: string, flags?: string[]): Promise<string>;
+    /**
+     * Fetch the lark-cli auth state. Returns parsed JSON output from
+     * `lark auth status --verify --format json`. Throws if the subprocess
+     * fails or output is unparseable.
+     *
+     * Used by chat-name resolution to discover the current user's open_id
+     * (needed for distinguishing self from counterparty in p2p chats).
+     *
+     * Returned shape (subset of fields):
+     *   { userOpenId: string, tokenStatus: "valid" | ..., scope: string, userName: string, ... }
+     */
+    getAuthStatus<T = unknown>(): Promise<T>;
     healthCheck(): Promise<{
         ok: boolean;
         message: string;

package/dist/collectors/feishu/lark-cli-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lark-cli-client.d.ts","sourceRoot":"","sources":["../../../src/collectors/feishu/lark-cli-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAmBvE,qBAAa,iBAAkB,YAAW,iBAAiB;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,OAAO,CAAC,EAAE,MAAM;IAItB,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5D,OAAO,CAAC,CAAC,CAAC;IAeN,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAoB3B,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAMjF,WAAW,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAW/D"}
+{"version":3,"file":"lark-cli-client.d.ts","sourceRoot":"","sources":["../../../src/collectors/feishu/lark-cli-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAoCvE,qBAAa,iBAAkB,YAAW,iBAAiB;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,OAAO,CAAC,EAAE,MAAM;IAItB,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5D,OAAO,CAAC,CAAC,CAAC;IAeN,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAoB3B,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAMvF;;;;;;;;;;OAUG;IACG,aAAa,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC;IAKxC,WAAW,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAW/D"}

package/dist/collectors/feishu/lark-cli-client.js

@@ -1,8 +1,28 @@
 import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
 import { FeishuApiError } from "./types.js";
-const DEFAULT_LARK_BIN = `${process.env.HOME}/.local/bin/lark`;
 const EXEC_TIMEOUT = 120_000;
 const MAX_BUFFER = 256 * 1024 * 1024;
+// Locate the lark-cli executable: PATH first, then ~/.local/bin (a common
+// install location that isn't always on PATH for non-interactive shells).
+// Returns undefined when nothing is found; callers fall through to "lark"
+// so the eventual ENOENT carries the bare binary name.
+function findLarkBin() {
+    const candidates = ["lark", "lark-cli"];
+    const dirs = (process.env.PATH ?? "").split(":").filter(Boolean);
+    const home = process.env.HOME;
+    if (home)
+        dirs.push(join(home, ".local", "bin"));
+    for (const dir of dirs) {
+        for (const name of candidates) {
+            const p = join(dir, name);
+            if (existsSync(p))
+                return p;
+        }
+    }
+    return undefined;
+}
 function execLark(bin, args) {
     return new Promise((resolve, reject) => {
         execFile(bin, args, { timeout: EXEC_TIMEOUT, maxBuffer: MAX_BUFFER }, (err, stdout) => {
@@ -17,7 +37,7 @@ function execLark(bin, args) {
 export class LarkCliHttpClient {
     bin;
     constructor(larkBin) {
-        this.bin = larkBin ?? DEFAULT_LARK_BIN;
+        this.bin = larkBin ?? findLarkBin() ?? "lark";
     }
     async request(method, path, options) {
         const args = ["--as", "user", "api", method.toUpperCase(), path, "--format", "json"];
@@ -53,6 +73,21 @@ export class LarkCliHttpClient {
             args.push(...flags);
         return execLark(this.bin, args);
     }
+    /**
+     * Fetch the lark-cli auth state. Returns parsed JSON output from
+     * `lark auth status --verify --format json`. Throws if the subprocess
+     * fails or output is unparseable.
+     *
+     * Used by chat-name resolution to discover the current user's open_id
+     * (needed for distinguishing self from counterparty in p2p chats).
+     *
+     * Returned shape (subset of fields):
+     *   { userOpenId: string, tokenStatus: "valid" | ..., scope: string, userName: string, ... }
+     */
+    async getAuthStatus() {
+        const stdout = await execLark(this.bin, ["auth", "status", "--verify", "--format", "json"]);
+        return JSON.parse(stdout);
+    }
     async healthCheck() {
         try {
             await execLark(this.bin, ["auth", "status"]);

package/dist/collectors/feishu/lark-cli-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"lark-cli-client.js","sourceRoot":"","sources":["../../../src/collectors/feishu/lark-cli-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lark-cli-client.js","sourceRoot":"","sources":["../../../src/collectors/feishu/lark-cli-client.ts"],"names":[],"mappings":"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"}

package/dist/collectors/feishu/lark-cli-identity-backend.d.ts

@@ -0,0 +1,28 @@
+import type { IdentityBackend } from "../../core/identity-resolver.js";
+import type { LarkCliHttpClient } from "./lark-cli-client.js";
+export declare class LarkCliIdentityBackend implements IdentityBackend {
+    private readonly client;
+    private readonly selfOpenId?;
+    constructor(client: LarkCliHttpClient, selfOpenId?: string | undefined);
+    /**
+     * Person open_id → name. Task 3 leaves this as a stub returning null;
+     * the live person-resolution path stays on the existing IdentityResolver
+     * cache flow until a future task explicitly wires it through here.
+     */
+    resolveFeishuOpenId(_openId: string): Promise<null>;
+    /**
+     * Channel string → display name.
+     * - mail channels: short-circuit to null without any lark-cli call.
+     * - group: GET /open-apis/im/v1/chats/{chat_id}, return data.name.
+     * - p2p: Task 4 will land the algorithm; returns null for now.
+     * Any non-zero response code, missing field, or thrown error returns null.
+     */
+    resolveFeishuChatId(channel: string): Promise<{
+        name: string;
+    } | null>;
+    private resolveP2P;
+    private findCounterpartyFromMembers;
+    private findCounterpartyFromMessages;
+    private getChatInfo;
+}
+//# sourceMappingURL=lark-cli-identity-backend.d.ts.map

package/dist/collectors/feishu/lark-cli-identity-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lark-cli-identity-backend.d.ts","sourceRoot":"","sources":["../../../src/collectors/feishu/lark-cli-identity-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA8C9D,qBAAa,sBAAuB,YAAW,eAAe;IAE1D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBADX,MAAM,EAAE,iBAAiB,EACzB,UAAU,CAAC,EAAE,MAAM,YAAA;IAGtC;;;;OAIG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM;IAIzC;;;;;;OAMG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;YAmB9D,UAAU;YAYV,2BAA2B;YAiB3B,4BAA4B;YAqB5B,WAAW;CAY1B"}