@andre.li/memoark 0.3.1 → 0.3.2

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

@@ -0,0 +1,30 @@
+export function normalizeDocsConfig(raw) {
+    return {
+        my_space: { enabled: raw.my_space?.enabled ?? true, max_depth: raw.my_space?.max_depth ?? 10 },
+        wiki: {
+            enabled: raw.wiki?.enabled ?? true,
+            exclude_space_ids: raw.wiki?.exclude_space_ids ?? [],
+        },
+        folders: raw.folders ?? [],
+        gate: { min_content_chars: raw.gate?.min_content_chars ?? 200 },
+        triggers: {
+            self_edit: raw.triggers?.self_edit ?? true,
+            recent_window_days: raw.triggers?.recent_window_days ?? null,
+            important_folders: raw.triggers?.important_folders ?? [],
+            important_wiki_spaces: raw.triggers?.important_wiki_spaces ?? [],
+        },
+        refresh: {
+            on_hash_change: raw.refresh?.on_hash_change ?? true,
+            cold_refresh_days: raw.refresh?.cold_refresh_days ?? null,
+        },
+        upgrade_queue: {
+            batch_size: raw.upgrade_queue?.batch_size ?? 20,
+            bootstrap_batch_size: raw.upgrade_queue?.bootstrap_batch_size ?? 50,
+            bootstrap_runs: raw.upgrade_queue?.bootstrap_runs ?? 5,
+            max_pending: raw.upgrade_queue?.max_pending ?? 5000,
+        },
+        llm: { model: raw.llm?.model ?? null, qps: raw.llm?.qps ?? 2 },
+        self_open_id: raw.self_open_id ?? null,
+    };
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/config.ts"],"names":[],"mappings":"AAwBA,MAAM,UAAU,mBAAmB,CAAC,GAA0B;IAC5D,OAAO;QACL,QAAQ,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,IAAI,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,SAAS,IAAI,EAAE,EAAE;QAC9F,IAAI,EAAE;YACJ,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI;YAClC,iBAAiB,EAAE,GAAG,CAAC,IAAI,EAAE,iBAAiB,IAAI,EAAE;SACrD;QACD,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;QAC1B,IAAI,EAAE,EAAE,iBAAiB,EAAE,GAAG,CAAC,IAAI,EAAE,iBAAiB,IAAI,GAAG,EAAE;QAC/D,QAAQ,EAAE;YACR,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,SAAS,IAAI,IAAI;YAC1C,kBAAkB,EAAE,GAAG,CAAC,QAAQ,EAAE,kBAAkB,IAAI,IAAI;YAC5D,iBAAiB,EAAE,GAAG,CAAC,QAAQ,EAAE,iBAAiB,IAAI,EAAE;YACxD,qBAAqB,EAAE,GAAG,CAAC,QAAQ,EAAE,qBAAqB,IAAI,EAAE;SACjE;QACD,OAAO,EAAE;YACP,cAAc,EAAE,GAAG,CAAC,OAAO,EAAE,cAAc,IAAI,IAAI;YACnD,iBAAiB,EAAE,GAAG,CAAC,OAAO,EAAE,iBAAiB,IAAI,IAAI;SAC1D;QACD,aAAa,EAAE;YACb,UAAU,EAAE,GAAG,CAAC,aAAa,EAAE,UAAU,IAAI,EAAE;YAC/C,oBAAoB,EAAE,GAAG,CAAC,aAAa,EAAE,oBAAoB,IAAI,EAAE;YACnE,cAAc,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,IAAI,CAAC;YACtD,WAAW,EAAE,GAAG,CAAC,aAAa,EAAE,WAAW,IAAI,IAAI;SACpD;QACD,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,IAAI,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE;QAC9D,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;KACvC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { BodyCheckDecision, Decision, DocCandidate, DocCard, DocDecisionConfig } from "./types.js";
+/**
+ * Pure decision for a candidate given the existing card (if any).
+ * Mirrors the spec's "Full decision flow". The one IO-dependent branch
+ * (existing FullCard whose body may have changed) returns `needs_body_check`;
+ * Plan 2 fetches raw_content, hashes it, and calls `decideAfterBodyCheck`.
+ */
+export declare function decide(candidate: DocCandidate, existing: DocCard | null, config: DocDecisionConfig, selfOpenId: string, nowMs: number): Decision;
+/**
+ * Second-phase decision once raw_content has been fetched and hashed.
+ * T5: re-summarize only when the body text actually changed.
+ */
+export declare function decideAfterBodyCheck(newBodyHash: string, existingBodyHash: string): BodyCheckDecision;
+//# sourceMappingURL=decision.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/decision.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,OAAO,GAAG,IAAI,EACxB,MAAM,EAAE,iBAAiB,EACzB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,QAAQ,CA8BV;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,GACvB,iBAAiB,CAInB"}

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

@@ -0,0 +1,43 @@
+import { evaluateTriggers } from "./triggers.js";
+/**
+ * Pure decision for a candidate given the existing card (if any).
+ * Mirrors the spec's "Full decision flow". The one IO-dependent branch
+ * (existing FullCard whose body may have changed) returns `needs_body_check`;
+ * Plan 2 fetches raw_content, hashes it, and calls `decideAfterBodyCheck`.
+ */
+export function decide(candidate, existing, config, selfOpenId, nowMs) {
+    // Gate phase 1
+    if (candidate.doc_type !== "docx") {
+        return { action: "save_pointer", reason: "non_docx" };
+    }
+    const trigger = evaluateTriggers(candidate, config, selfOpenId, nowMs);
+    if (existing === null) {
+        return trigger
+            ? { action: "queue_for_upgrade", trigger }
+            : { action: "save_pointer", reason: "no_trigger" };
+    }
+    const modifiedChanged = candidate.modified_at !== existing.modified_at;
+    if (existing.extract_level === "pointer") {
+        if (!modifiedChanged) {
+            return trigger ? { action: "queue_for_upgrade", trigger } : { action: "skip_save" };
+        }
+        return trigger
+            ? { action: "queue_for_upgrade", trigger }
+            : { action: "save_pointer", reason: "metadata_refresh" };
+    }
+    // existing FullCard
+    if (!modifiedChanged) {
+        return { action: "skip_save" };
+    }
+    return { action: "needs_body_check" };
+}
+/**
+ * Second-phase decision once raw_content has been fetched and hashed.
+ * T5: re-summarize only when the body text actually changed.
+ */
+export function decideAfterBodyCheck(newBodyHash, existingBodyHash) {
+    return newBodyHash === existingBodyHash
+        ? { action: "metadata_refresh" }
+        : { action: "queue_for_upgrade", trigger: "T5" };
+}
+//# sourceMappingURL=decision.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/decision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AASjD;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CACpB,SAAuB,EACvB,QAAwB,EACxB,MAAyB,EACzB,UAAkB,EAClB,KAAa;IAEb,eAAe;IACf,IAAI,SAAS,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAClC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAEvE,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,OAAO;YACZ,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE;YAC1C,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,eAAe,GAAG,SAAS,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW,CAAC;IAEvE,IAAI,QAAQ,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACzC,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QACtF,CAAC;QACD,OAAO,OAAO;YACZ,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE;YAC1C,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7D,CAAC;IAED,oBAAoB;IACpB,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAmB,EACnB,gBAAwB;IAExB,OAAO,WAAW,KAAK,gBAAgB;QACrC,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE;QAChC,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACrD,CAAC"}

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

@@ -0,0 +1,17 @@
+import type { LLMProvider } from "../../../extractors/providers/types.js";
+import type { IFeishuHttpClient } from "../http-client.js";
+import type { DocCandidate, DocCard } from "./types.js";
+export declare class FullCardBuilder {
+    private readonly client;
+    private readonly provider;
+    private readonly model;
+    private readonly nowIso;
+    constructor(client: IFeishuHttpClient, provider: LLMProvider, model: string, nowIso: () => string);
+    private fetchBlocks;
+    build(candidate: DocCandidate, opts?: {
+        userNote?: string;
+        tags?: string[];
+        force?: boolean;
+    }): Promise<DocCard>;
+}
+//# sourceMappingURL=full-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"full-builder.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/full-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAM3D,OAAO,KAAK,EAEV,YAAY,EACZ,OAAO,EAIR,MAAM,YAAY,CAAC;AAiEpB,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHN,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,MAAM;YAGzB,WAAW;IAcnB,KAAK,CACT,SAAS,EAAE,YAAY,EACvB,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7D,OAAO,CAAC,OAAO,CAAC;CA2DpB"}

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

@@ -0,0 +1,136 @@
+import { feishuBlocksToDocBlocks, feishuBlocksToRawText } from "./blocks.js";
+import { computeSourceBodyHash } from "./hash.js";
+import { LlmJsonParseError, parseLlmJson } from "./llm-json.js";
+import { buildPointerCard } from "./pointer-builder.js";
+import { extractTocFromBlocks } from "./toc.js";
+const MIN_CONTENT_CHARS = 200;
+function buildPrompt(rawText, userNote) {
+    const noteLine = userNote
+        ? `\nThe user says this document's purpose is: "${userNote}". Use it.`
+        : "";
+    return [
+        "Summarize the following document into JSON with keys:",
+        '{ "purpose": string (<=50 chars), "topics": string[] (3-7), "entities": {name, type_guess}[], "overview": string (200-400 chars), "decisions": {text, made_by}[], "action_items": {text, owner, due}[] }.',
+        "type_guess ∈ person|project|tool|concept|organization.",
+        "decisions: concrete choices the document records (each with who made it, or null).",
+        'action_items: concrete to-dos, each with its owner (name/@mention, or null) and due date (ISO8601 "YYYY-MM-DD", or null). For meeting-minutes docs, extract every action item and its owner.',
+        "Reply with JSON only, no markdown.",
+        noteLine,
+        "\n---\n",
+        rawText.slice(0, 12000),
+    ].join("\n");
+}
+function parseDecisions(value) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    for (const raw of value) {
+        const text = typeof raw?.text === "string" ? raw.text.trim() : "";
+        if (!text)
+            continue;
+        const decision = { text };
+        if (typeof raw.made_by === "string" && raw.made_by.trim()) {
+            decision.made_by_raw = raw.made_by.trim();
+        }
+        out.push(decision);
+    }
+    return out;
+}
+function parseActionItems(value) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    for (const raw of value) {
+        const text = typeof raw?.text === "string" ? raw.text.trim() : "";
+        if (!text)
+            continue;
+        const item = {
+            text,
+            status: raw.status === "done" ? "done" : "open",
+        };
+        if (typeof raw.owner === "string" && raw.owner.trim())
+            item.owner_raw = raw.owner.trim();
+        if (typeof raw.due === "string" && raw.due.trim())
+            item.due = raw.due.trim();
+        out.push(item);
+    }
+    return out;
+}
+export class FullCardBuilder {
+    client;
+    provider;
+    model;
+    nowIso;
+    constructor(client, provider, model, nowIso) {
+        this.client = client;
+        this.provider = provider;
+        this.model = model;
+        this.nowIso = nowIso;
+    }
+    async fetchBlocks(docToken) {
+        const blocks = [];
+        // CALIBRATED 2026-06-14: the GET /open-apis/docx/v1/documents/<id>/blocks
+        // endpoint and ndjson row shape are confirmed live — each row carries an
+        // integer `block_type` plus a per-type holder with elements[].text_run.content
+        // (see blocks.ts#BLOCK_MAP and probe-fixtures.md docx_block fixture).
+        for await (const page of this.client.paginate(`/open-apis/docx/v1/documents/${docToken}/blocks`)) {
+            blocks.push(...page.items);
+        }
+        return blocks;
+    }
+    async build(candidate, opts) {
+        const now = this.nowIso();
+        let blocks;
+        try {
+            blocks = await this.fetchBlocks(candidate.doc_token);
+        }
+        catch {
+            return buildPointerCard(candidate, now, {
+                extract_error: "blocks_fetch_failed",
+                user_note: opts?.userNote,
+            });
+        }
+        if (blocks.length === 0) {
+            return buildPointerCard(candidate, now, {
+                extract_skipped: "empty_blocks",
+                user_note: opts?.userNote,
+            });
+        }
+        const rawText = feishuBlocksToRawText(blocks);
+        if (!opts?.force && rawText.length < MIN_CONTENT_CHARS) {
+            return buildPointerCard(candidate, now, {
+                extract_skipped: "below_min_chars",
+                user_note: opts?.userNote,
+            });
+        }
+        let parsed;
+        try {
+            const out = await this.provider.chat([{ role: "user", content: buildPrompt(rawText, opts?.userNote) }], { responseFormat: "json" });
+            parsed = parseLlmJson(out);
+        }
+        catch (err) {
+            const code = err instanceof LlmJsonParseError ? "llm_invalid_json" : "llm_failed";
+            return buildPointerCard(candidate, now, { extract_error: code, user_note: opts?.userNote });
+        }
+        const entities = Array.isArray(parsed.entities) ? parsed.entities : [];
+        const card = {
+            ...candidate,
+            extract_level: "full",
+            purpose: String(parsed.purpose ?? "").slice(0, 50),
+            topics: Array.isArray(parsed.topics) ? parsed.topics : [],
+            entities,
+            toc: extractTocFromBlocks(feishuBlocksToDocBlocks(blocks)),
+            overview: String(parsed.overview ?? ""),
+            decisions: parseDecisions(parsed.decisions),
+            action_items: parseActionItems(parsed.action_items),
+            source_body_hash: computeSourceBodyHash(rawText),
+            summary_generated_at: now,
+            summary_model: this.model,
+            extracted_at: now,
+            ...(opts?.userNote ? { user_note: opts.userNote } : {}),
+            ...(opts?.tags ? { tags: opts.tags } : {}),
+        };
+        return card;
+    }
+}
+//# sourceMappingURL=full-builder.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * sha256 of raw_content, whitespace-normalized so that cosmetic edits
+ * (trailing spaces, CRLF vs LF) do not flip the hash and trigger a needless
+ * LLM refresh. This is FullCard.source_body_hash — distinct from the store's
+ * pages.content_hash column (which hashes the whole rendered page).
+ */
+export declare function computeSourceBodyHash(rawContent: string): string;
+//# sourceMappingURL=hash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/hash.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAMhE"}

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

@@ -0,0 +1,15 @@
+import { createHash } from "node:crypto";
+/**
+ * sha256 of raw_content, whitespace-normalized so that cosmetic edits
+ * (trailing spaces, CRLF vs LF) do not flip the hash and trigger a needless
+ * LLM refresh. This is FullCard.source_body_hash — distinct from the store's
+ * pages.content_hash column (which hashes the whole rendered page).
+ */
+export function computeSourceBodyHash(rawContent) {
+    const normalized = rawContent
+        .replace(/\r\n/g, "\n")
+        .replace(/[ \t]+$/gm, "")
+        .trim();
+    return createHash("sha256").update(normalized, "utf8").digest("hex");
+}
+//# sourceMappingURL=hash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACtD,MAAM,UAAU,GAAG,UAAU;SAC1B,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,IAAI,EAAE,CAAC;IACV,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC"}

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

@@ -0,0 +1,54 @@
+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 { FullCard } from "./types.js";
+export interface IngestDeps {
+    client: IFeishuHttpClient;
+    stores: {
+        pages: PageStore;
+        chunks: ChunkStore;
+    };
+    provider: LLMProvider;
+    model: string;
+    nowIso: () => string;
+}
+export interface IngestInput {
+    url_or_token: string;
+    note?: string;
+    tags?: string[];
+    force_refresh?: boolean;
+}
+export type IngestOutput = {
+    ok: true;
+    doc_token: string;
+    extract_level: "full";
+    was_existing: boolean;
+    card: FullCard;
+} | {
+    ok: false;
+    error: {
+        code: "INVALID_URL";
+        message: string;
+    } | {
+        code: "UNSUPPORTED_DOC_TYPE";
+        type: string;
+        message: string;
+    } | {
+        code: "PERMISSION_DENIED";
+        doc_token: string;
+    } | {
+        code: "WIKI_NODE_NOT_FOUND";
+        node_token: string;
+    } | {
+        code: "LLM_FAILED";
+        doc_token: string;
+        saved_as: "pointer";
+        original_error: string;
+    } | {
+        code: "NETWORK_ERROR";
+        message: string;
+    };
+};
+export declare function ingestFeishuDoc(deps: IngestDeps, input: IngestInput): Promise<IngestOutput>;
+//# sourceMappingURL=ingest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/ingest.ts"],"names":[],"mappings":"AAAA,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;AAI3D,OAAO,KAAK,EAAgB,QAAQ,EAAE,MAAM,YAAY,CAAC;AAIzD,MAAM,WAAW,UAAU;IACzB,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,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC7F;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EACD;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GACxC;QAAE,IAAI,EAAE,sBAAsB,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAM/D;QAAE,IAAI,EAAE,mBAAmB,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAChD;QAAE,IAAI,EAAE,qBAAqB,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GACnD;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,SAAS,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,GACtF;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD,CAAC;AA4CN,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAmGjG"}

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"}