memkin 0.4.0

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

@@ -0,0 +1,120 @@
+import { FullCardBuilder } from "./full-builder.js";
+import { mergeUserNoteIntoCard } from "./render.js";
+import { writeCard } from "./store-writer.js";
+import { parseFeishuUrl } from "./url-parser.js";
+import { resolveWikiNode, WikiNodeNotFoundError } from "./wiki-resolver.js";
+// CALIBRATED 2026-06-14 against POST /open-apis/drive/v1/metas/batch_query with
+// body { request_docs: [{ doc_token, doc_type }] }. The response `url` comes back
+// as an EMPTY STRING "" (not undefined), so `??` would keep it — use `||` to fall
+// back. Unlike the drive/v1/files list API, the meta API DOES return the real last
+// editor via `latest_modify_user`.
+async function fetchDocMeta(client, docToken) {
+    const res = await client.request("POST", "/open-apis/drive/v1/metas/batch_query", {
+        body: { request_docs: [{ doc_token: docToken, doc_type: "docx" }] },
+    });
+    const m = res.data?.metas?.[0] ?? {};
+    return {
+        title: m.title || docToken,
+        url: m.url || `https://feishu.cn/docx/${docToken}`,
+        owner_id: m.owner_id ?? "",
+        last_editor_id: m.latest_modify_user || m.owner_id || "",
+        created: m.create_time || "0",
+        modified: m.latest_modify_time || "0",
+    };
+}
+export async function ingestFeishuDoc(deps, input) {
+    const parsed = parseFeishuUrl(input.url_or_token);
+    if (parsed.kind === "reject") {
+        if (parsed.code === "UNSUPPORTED_DOC_TYPE") {
+            return {
+                ok: false,
+                error: { code: "UNSUPPORTED_DOC_TYPE", type: "non_docx", message: parsed.message },
+            };
+        }
+        return { ok: false, error: { code: "INVALID_URL", message: parsed.message } };
+    }
+    let docToken;
+    try {
+        if (parsed.kind === "wiki_node") {
+            const resolved = await resolveWikiNode(deps.client, parsed.node_token);
+            if (resolved.obj_type !== "docx") {
+                return {
+                    ok: false,
+                    error: {
+                        code: "UNSUPPORTED_DOC_TYPE",
+                        type: resolved.obj_type,
+                        message: "Wiki node is not a docx",
+                    },
+                };
+            }
+            docToken = resolved.obj_token;
+        }
+        else {
+            docToken = parsed.token;
+        }
+    }
+    catch (err) {
+        if (err instanceof WikiNodeNotFoundError) {
+            return { ok: false, error: { code: "WIKI_NODE_NOT_FOUND", node_token: err.node_token } };
+        }
+        return {
+            ok: false,
+            error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : String(err) },
+        };
+    }
+    const now = deps.nowIso();
+    let meta;
+    try {
+        meta = await fetchDocMeta(deps.client, docToken);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : String(err) },
+        };
+    }
+    const existing = await deps.stores.pages.getPage(`feishu-docs/${docToken}`);
+    const candidate = {
+        doc_token: docToken,
+        doc_type: "docx",
+        title: meta.title,
+        url: meta.url,
+        owner_id: meta.owner_id,
+        last_editor_id: meta.last_editor_id,
+        created_at: meta.created === "0" ? now : new Date(Number.parseInt(meta.created, 10) * 1000).toISOString(),
+        modified_at: meta.modified === "0"
+            ? now
+            : new Date(Number.parseInt(meta.modified, 10) * 1000).toISOString(),
+        source: { kind: "mcp_ingest" },
+        parent_path: "MCP ingest/",
+    };
+    const builder = new FullCardBuilder(deps.client, deps.provider, deps.model, deps.nowIso);
+    const card = await builder.build(candidate, {
+        userNote: input.note,
+        tags: input.tags,
+        force: true,
+    });
+    if (card.extract_level === "pointer") {
+        // build degraded (empty blocks or LLM failure) — persist the pointer and report
+        await writeCard(deps.stores, card);
+        return {
+            ok: false,
+            error: {
+                code: "LLM_FAILED",
+                doc_token: docToken,
+                saved_as: "pointer",
+                original_error: card.extract_error ?? card.extract_skipped ?? "unknown",
+            },
+        };
+    }
+    const finalCard = input.note ? mergeUserNoteIntoCard(card, input.note) : card;
+    await writeCard(deps.stores, finalCard);
+    return {
+        ok: true,
+        doc_token: docToken,
+        extract_level: "full",
+        was_existing: existing !== null,
+        card: finalCard,
+    };
+}
+//# sourceMappingURL=ingest.js.map

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

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

package/dist/collectors/feishu/docs/llm-json.d.ts

@@ -0,0 +1,13 @@
+export declare class LlmJsonParseError extends Error {
+    constructor(message: string);
+}
+/**
+ * Robust parse of an LLM JSON response (spec §"LLM JSON robustness", steps 1-2):
+ *  1. Try JSON.parse as-is.
+ *  2. Strip markdown code fences, then extract the substring between the first
+ *     `{` and last `}` and parse that.
+ * Throws LlmJsonParseError if both fail. The caller (FullCardBuilder, Plan 2)
+ * handles step 3 (retry LLM) and step 4 (degrade to pointer).
+ */
+export declare function parseLlmJson(output: string): Record<string, unknown>;
+//# sourceMappingURL=llm-json.d.ts.map

package/dist/collectors/feishu/docs/llm-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-json.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/llm-json.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBpE"}

package/dist/collectors/feishu/docs/llm-json.js

@@ -0,0 +1,40 @@
+export class LlmJsonParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "LlmJsonParseError";
+    }
+}
+/**
+ * Robust parse of an LLM JSON response (spec §"LLM JSON robustness", steps 1-2):
+ *  1. Try JSON.parse as-is.
+ *  2. Strip markdown code fences, then extract the substring between the first
+ *     `{` and last `}` and parse that.
+ * Throws LlmJsonParseError if both fail. The caller (FullCardBuilder, Plan 2)
+ * handles step 3 (retry LLM) and step 4 (degrade to pointer).
+ */
+export function parseLlmJson(output) {
+    try {
+        return JSON.parse(output);
+    }
+    catch {
+        // fall through
+    }
+    const stripped = output.replace(/```[a-zA-Z]*\n?/g, "").replace(/```/g, "");
+    // Known limitation: this naively takes the first `{` to the last `}`. Trailing
+    // prose containing a stray `}` can over-extend the slice past the real JSON,
+    // yielding an unparseable candidate that falls through to the throw below.
+    // This is acceptable — the caller handles retry/degrade on LlmJsonParseError.
+    const first = stripped.indexOf("{");
+    const last = stripped.lastIndexOf("}");
+    if (first !== -1 && last !== -1 && last > first) {
+        const candidate = stripped.slice(first, last + 1);
+        try {
+            return JSON.parse(candidate);
+        }
+        catch {
+            // fall through
+        }
+    }
+    throw new LlmJsonParseError(`Could not parse LLM JSON from output: ${output.slice(0, 120)}`);
+}
+//# sourceMappingURL=llm-json.js.map

package/dist/collectors/feishu/docs/llm-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-json.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/llm-json.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAA4B,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5E,+EAA+E;IAC/E,6EAA6E;IAC7E,2EAA2E;IAC3E,8EAA8E;IAC9E,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAA4B,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,iBAAiB,CAAC,yCAAyC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAC/F,CAAC"}

package/dist/collectors/feishu/docs/pointer-builder.d.ts

@@ -0,0 +1,7 @@
+import type { DocCandidate, PointerCard } from "./types.js";
+export declare function buildPointerCard(candidate: DocCandidate, nowIso: string, extra?: {
+    extract_error?: string;
+    extract_skipped?: string;
+    user_note?: string;
+}): PointerCard;
+//# sourceMappingURL=pointer-builder.d.ts.map

package/dist/collectors/feishu/docs/pointer-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer-builder.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/pointer-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5D,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/E,WAAW,CASb"}

package/dist/collectors/feishu/docs/pointer-builder.js

@@ -0,0 +1,11 @@
+export function buildPointerCard(candidate, nowIso, extra) {
+    return {
+        ...candidate,
+        extract_level: "pointer",
+        extracted_at: nowIso,
+        ...(extra?.extract_error ? { extract_error: extra.extract_error } : {}),
+        ...(extra?.extract_skipped ? { extract_skipped: extra.extract_skipped } : {}),
+        ...(extra?.user_note ? { user_note: extra.user_note } : {}),
+    };
+}
+//# sourceMappingURL=pointer-builder.js.map

package/dist/collectors/feishu/docs/pointer-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer-builder.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/pointer-builder.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAC9B,SAAuB,EACvB,MAAc,EACd,KAAgF;IAEhF,OAAO;QACL,GAAG,SAAS;QACZ,aAAa,EAAE,SAAS;QACxB,YAAY,EAAE,MAAM;QACpB,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { DocCard, FullCard } from "./types.js";
+export declare function renderDocCardMarkdown(card: DocCard): string;
+/**
+ * MCP ingest: the user note is the authoritative purpose. Forced post-LLM
+ * because the model cannot be trusted to obey the instruction reliably.
+ */
+export declare function mergeUserNoteIntoCard(card: FullCard, userNote: string): FullCard;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/render.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA8FpD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAI3D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAEhF"}

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

@@ -0,0 +1,105 @@
+import { stringify as stringifyYaml } from "yaml";
+const PAGE_TYPE = "feishu_doc_card";
+/**
+ * Build the frontmatter object. `title` and `type` are top-level so
+ * PageStore.parseMarkdownWithFrontmatter lifts them; everything else is
+ * preserved as nested frontmatter for programmatic query.
+ */
+function frontmatter(card) {
+    const fm = {
+        title: card.title,
+        type: PAGE_TYPE,
+        extract_level: card.extract_level,
+        doc_token: card.doc_token,
+        doc_type: card.doc_type,
+        url: card.url,
+        owner_id: card.owner_id,
+        last_editor_id: card.last_editor_id,
+        created_at: card.created_at,
+        modified_at: card.modified_at,
+        extracted_at: card.extracted_at,
+        parent_path: card.parent_path,
+        source: card.source,
+    };
+    if (card.extract_level === "full") {
+        fm.purpose = card.purpose;
+        fm.topics = card.topics;
+        fm.entities = card.entities;
+        fm.toc = card.toc;
+        fm.overview = card.overview;
+        fm.decisions = card.decisions;
+        fm.action_items = card.action_items;
+        fm.source_body_hash = card.source_body_hash;
+        fm.summary_generated_at = card.summary_generated_at;
+        fm.summary_model = card.summary_model;
+        if (card.user_note !== undefined)
+            fm.user_note = card.user_note;
+        if (card.tags !== undefined)
+            fm.tags = card.tags;
+    }
+    else {
+        if (card.extract_error !== undefined)
+            fm.extract_error = card.extract_error;
+        if (card.extract_skipped !== undefined)
+            fm.extract_skipped = card.extract_skipped;
+        if (card.user_note !== undefined)
+            fm.user_note = card.user_note;
+    }
+    return fm;
+}
+function fullBody(card) {
+    const topics = card.topics.map((t) => `- ${t}`).join("\n");
+    const entities = card.entities.map((e) => `- ${e.name} (${e.type_guess})`).join("\n");
+    const toc = card.toc.map((i) => `- ${i.title}`).join("\n");
+    return [
+        `# ${card.title}`,
+        "",
+        `**Purpose**: ${card.purpose}`,
+        `**URL**: ${card.url}`,
+        `**Last modified**: ${card.modified_at} by ${card.last_editor_id}`,
+        "",
+        "## Overview",
+        card.overview,
+        "",
+        "## Topics",
+        topics,
+        "",
+        "## Mentioned entities",
+        entities,
+        "",
+        "## Table of contents",
+        toc,
+        "",
+        "---",
+        `*Source: Feishu ${card.source.kind} / ${card.parent_path}*`,
+        "",
+    ].join("\n");
+}
+function pointerBody(card) {
+    const errorSuffix = card.extract_level === "pointer" && card.extract_error
+        ? ` Last error: ${card.extract_error}`
+        : "";
+    return [
+        `# ${card.title}`,
+        "",
+        `**URL**: ${card.url}`,
+        `**Last modified**: ${card.modified_at}`,
+        `**Source**: Feishu ${card.source.kind} / ${card.parent_path}`,
+        "",
+        `*(Pointer card — full summary not yet generated.${errorSuffix})*`,
+        "",
+    ].join("\n");
+}
+export function renderDocCardMarkdown(card) {
+    const yaml = stringifyYaml(frontmatter(card)).trimEnd();
+    const body = card.extract_level === "full" ? fullBody(card) : pointerBody(card);
+    return `---\n${yaml}\n---\n\n${body}`;
+}
+/**
+ * MCP ingest: the user note is the authoritative purpose. Forced post-LLM
+ * because the model cannot be trusted to obey the instruction reliably.
+ */
+export function mergeUserNoteIntoCard(card, userNote) {
+    return { ...card, purpose: userNote, user_note: userNote };
+}
+//# sourceMappingURL=render.js.map

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

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

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

@@ -0,0 +1,37 @@
+import type { CursorStore } from "../../../core/cursors.js";
+import type { LLMProvider } from "../../../extractors/providers/types.js";
+import type { ChunkStore } from "../../../store/chunks.js";
+import type { PageStore } from "../../../store/pages.js";
+import type { IFeishuHttpClient } from "../http-client.js";
+import type { ResolvedDocsConfig } from "./config.js";
+import { type ActionItemDeps } from "./store-writer.js";
+export interface DocSourceStats {
+    candidates_scanned: number;
+    pointer_saved: number;
+    full_card_generated: number;
+    full_card_refreshed: number;
+    skipped: number;
+    upgrade_queue_size: number;
+    llm_failed: number;
+}
+export interface RunDocSourceDeps {
+    client: IFeishuHttpClient;
+    stores: {
+        pages: PageStore;
+        chunks: ChunkStore;
+    };
+    provider: LLMProvider;
+    config: ResolvedDocsConfig;
+    cursor: Pick<CursorStore, "getJSON" | "setJSON" | "commit">;
+    selfOpenId: string;
+    nowMs: number;
+    nowIso: () => string;
+    /**
+     * Identity/graph deps for persisting action_items as task signals. When
+     * provided, FULL cards built this run also write their action_items as
+     * `tasks/doc-*` pages (Spec 9 §3.3). Omitted for runs that only need cards.
+     */
+    actionItemDeps?: ActionItemDeps;
+}
+export declare function runDocSource(deps: RunDocSourceDeps): Promise<DocSourceStats>;
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAKtD,OAAO,EAAE,KAAK,cAAc,EAA+B,MAAM,mBAAmB,CAAC;AAOrF,MAAM,WAAW,cAAc;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAOD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC;IACjD,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA+HlF"}

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

@@ -0,0 +1,143 @@
+import { feishuBlocksToRawText } from "./blocks.js";
+import { decide, decideAfterBodyCheck } from "./decision.js";
+import { FullCardBuilder } from "./full-builder.js";
+import { computeSourceBodyHash } from "./hash.js";
+import { buildPointerCard } from "./pointer-builder.js";
+import { loadExistingCard, writeCard } from "./store-writer.js";
+import { batchSizeForRun, UpgradeQueue } from "./upgrade-queue.js";
+import { iterateCandidates } from "./walkers.js";
+const CURSOR_KEY = "feishu.docs";
+export async function runDocSource(deps) {
+    const { client, stores, provider, config, cursor, selfOpenId, nowMs, nowIso, actionItemDeps } = deps;
+    const stats = {
+        candidates_scanned: 0,
+        pointer_saved: 0,
+        full_card_generated: 0,
+        full_card_refreshed: 0,
+        skipped: 0,
+        upgrade_queue_size: 0,
+        llm_failed: 0,
+    };
+    const checkpoint = cursor.getJSON(CURSOR_KEY) ?? {};
+    const queue = new UpgradeQueue(checkpoint.upgrade_queue?.pending ?? [], config.upgrade_queue.max_pending);
+    const runCount = checkpoint.run_count ?? 0;
+    const decisionConfig = {
+        self_edit: config.triggers.self_edit,
+        recent_window_days: config.triggers.recent_window_days,
+        important_folders: config.triggers.important_folders,
+        important_wiki_spaces: config.triggers.important_wiki_spaces,
+    };
+    // Candidates enqueued this run, kept in memory so phase 2 can upgrade them
+    // directly without round-tripping through the store.
+    const enqueuedCandidates = new Map();
+    try {
+        // Phase 1: scan + decide
+        for await (const candidate of iterateCandidates(client, config)) {
+            stats.candidates_scanned++;
+            try {
+                const existing = await loadExistingCard(stores, candidate.doc_token);
+                const decision = decide(candidate, existing, decisionConfig, selfOpenId, nowMs);
+                // Resolve the effective terminal action. `needs_body_check` fetches the
+                // body and folds into either `metadata_refresh` (refresh the existing
+                // full card's metadata) or `queue_for_upgrade` (T5 re-summarize).
+                let action;
+                if (decision.action === "needs_body_check") {
+                    const rawText = await fetchRawText(client, candidate.doc_token);
+                    const newHash = computeSourceBodyHash(rawText);
+                    const existingHash = existing?.extract_level === "full" ? existing.source_body_hash : "";
+                    action = decideAfterBodyCheck(newHash, existingHash).action;
+                }
+                else {
+                    action = decision.action;
+                }
+                if (action === "skip_save") {
+                    stats.skipped++;
+                }
+                else if (action === "metadata_refresh") {
+                    // existing is a FullCard here (only needs_body_check reaches this); refresh
+                    // the cheap metadata, KEEP the LLM summary, do NOT call the LLM.
+                    await writeCard(stores, {
+                        ...existing,
+                        title: candidate.title,
+                        url: candidate.url,
+                        modified_at: candidate.modified_at,
+                        last_editor_id: candidate.last_editor_id,
+                        parent_path: candidate.parent_path,
+                        source: candidate.source,
+                        extracted_at: nowIso(),
+                    }, actionItemDeps);
+                    stats.full_card_refreshed++;
+                }
+                else if (action === "save_pointer") {
+                    await writeCard(stores, buildPointerCard(candidate, nowIso()));
+                    stats.pointer_saved++;
+                }
+                else if (action === "queue_for_upgrade") {
+                    // Pointer placeholder lands immediately; the full card overwrites it in
+                    // phase 2, so the placeholder is not counted as a saved pointer.
+                    if (!existing) {
+                        await writeCard(stores, buildPointerCard(candidate, nowIso()));
+                    }
+                    if (queue.enqueue(candidate.doc_token)) {
+                        enqueuedCandidates.set(candidate.doc_token, candidate);
+                    }
+                }
+            }
+            catch (err) {
+                // One bad doc (paginate failure, fetchRawText timeout, write error) must
+                // not abort the whole run and lose checkpoint progress. Skip and continue.
+                console.error(`feishu.docs: failed to process candidate ${candidate.doc_token}:`, err);
+                stats.skipped++;
+            }
+        }
+        // Phase 2: drain the queue
+        const k = batchSizeForRun(runCount, config.upgrade_queue);
+        const builder = new FullCardBuilder(client, provider, config.llm.model ?? "unknown", nowIso);
+        const batch = queue.shift(k);
+        for (const docToken of batch) {
+            try {
+                // Prefer the in-memory candidate from this run; fall back to the stored
+                // pointer card for tokens carried over from a previous run's checkpoint.
+                const candidate = enqueuedCandidates.get(docToken) ?? (await rebuildCandidate(stores, docToken));
+                if (!candidate)
+                    continue;
+                const card = await builder.build(candidate);
+                await writeCard(stores, card, actionItemDeps);
+                if (card.extract_level === "full")
+                    stats.full_card_generated++;
+                else
+                    stats.llm_failed++;
+            }
+            catch (err) {
+                // The builder degrades internally, but fetchRawText/writeCard can still
+                // throw. Skip this token and keep draining the rest of the batch.
+                console.error(`feishu.docs: failed to upgrade ${docToken}:`, err);
+                stats.skipped++;
+            }
+        }
+    }
+    finally {
+        // Always persist the checkpoint so a mid-run throw does not lose the
+        // upgrade-queue pending list or run_count progress.
+        stats.upgrade_queue_size = queue.size();
+        cursor.setJSON(CURSOR_KEY, {
+            upgrade_queue: { pending: queue.pending(), last_upgrade_at: nowMs },
+            run_count: runCount + 1,
+        });
+        cursor.commit();
+    }
+    return stats;
+}
+async function fetchRawText(client, docToken) {
+    const blocks = [];
+    for await (const page of client.paginate(`/open-apis/docx/v1/documents/${docToken}/blocks`)) {
+        blocks.push(...page.items);
+    }
+    return feishuBlocksToRawText(blocks);
+}
+/** Reconstruct a candidate from the stored pointer card so phase 2 can upgrade it. */
+async function rebuildCandidate(stores, docToken) {
+    // The builder only reads DocCandidate fields, so either card kind works here.
+    return loadExistingCard(stores, docToken);
+}
+//# sourceMappingURL=run.js.map

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

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

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

@@ -0,0 +1,16 @@
+interface CardPage {
+    frontmatter: Record<string, unknown>;
+}
+export interface CardSummary {
+    total: number;
+    full: number;
+    pointer: number;
+    failed: number;
+}
+export declare function summarizeCards(pages: CardPage[]): CardSummary;
+export declare function failedCards(pages: CardPage[]): Array<{
+    doc_token: string;
+    error: string;
+}>;
+export {};
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/status.ts"],"names":[],"mappings":"AAAA,UAAU,QAAQ;IAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,WAAW,CAW7D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAO1F"}

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

@@ -0,0 +1,24 @@
+export function summarizeCards(pages) {
+    let full = 0;
+    let pointer = 0;
+    let failed = 0;
+    for (const p of pages) {
+        const fm = p.frontmatter;
+        if (fm.extract_level === "full")
+            full++;
+        else
+            pointer++;
+        if (fm.extract_error)
+            failed++;
+    }
+    return { total: pages.length, full, pointer, failed };
+}
+export function failedCards(pages) {
+    return pages
+        .filter((p) => p.frontmatter.extract_error)
+        .map((p) => ({
+        doc_token: String(p.frontmatter.doc_token ?? "?"),
+        error: String(p.frontmatter.extract_error),
+    }));
+}
+//# sourceMappingURL=status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/status.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC9C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,CAAC;QACzB,IAAI,EAAE,CAAC,aAAa,KAAK,MAAM;YAAE,IAAI,EAAE,CAAC;;YACnC,OAAO,EAAE,CAAC;QACf,IAAI,EAAE,CAAC,aAAa;YAAE,MAAM,EAAE,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC;SAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,IAAI,GAAG,CAAC;QACjD,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC;KAC3C,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/collectors/feishu/docs/store-writer.d.ts

@@ -0,0 +1,32 @@
+import type { ChunkStore } from "../../../store/chunks.js";
+import type { GraphStore } from "../../../store/graph.js";
+import type { PageStore } from "../../../store/pages.js";
+import type { DocCard } from "./types.js";
+export declare const docSlug: (docToken: string) => string;
+/** tasks/doc-<doc_token>-<hash8(text)> (Spec 9 §3.3). */
+export declare function actionItemTaskSlug(docToken: string, text: string): string;
+/**
+ * Identity/graph dependencies for persisting action_items as task signals.
+ * Injected so store-writer stays free of a hard dependency on the identity layer
+ * (Spec 9 §3.3 / §4 — owner canonicalization + isMe).
+ */
+export interface ActionItemDeps {
+    graph: GraphStore;
+    /** Resolve an owner_raw (name/@mention) to a canonical person slug, or null. */
+    resolveOwner: (ownerRaw: string | undefined) => Promise<string | null>;
+    /** Whether a canonical slug resolves to `entities/me`. */
+    isMe: (slug: string) => Promise<boolean>;
+}
+export declare function writeCard(stores: {
+    pages: PageStore;
+    chunks: ChunkStore;
+}, card: DocCard, actionItemDeps?: ActionItemDeps): Promise<void>;
+/**
+ * Reconstruct a stored card from its page frontmatter. The decision engine only
+ * needs extract_level, modified_at, and (for full cards) source_body_hash, but
+ * we cast the whole frontmatter — it was serialized from a DocCard by writeCard.
+ */
+export declare function loadExistingCard(stores: {
+    pages: PageStore;
+}, docToken: string): Promise<DocCard | null>;
+//# sourceMappingURL=store-writer.d.ts.map

package/dist/collectors/feishu/docs/store-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-writer.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/store-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAc,OAAO,EAAE,MAAM,YAAY,CAAC;AAEtD,eAAO,MAAM,OAAO,GAAI,UAAU,MAAM,KAAG,MAAmC,CAAC;AAO/E,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,gFAAgF;IAChF,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvE,0DAA0D;IAC1D,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAsCD,wBAAsB,SAAS,CAC7B,MAAM,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,EAChD,IAAI,EAAE,OAAO,EACb,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAMzB"}