@andre.li/memoark 0.3.1 → 0.3.2

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

package/dist/collectors/feishu/docs/store-writer.js

@@ -0,0 +1,71 @@
+import { createHash } from "node:crypto";
+import { stringify as stringifyYaml } from "yaml";
+import { renderDocCardMarkdown } from "./render.js";
+export const docSlug = (docToken) => `feishu-docs/${docToken}`;
+/** First 8 hex chars of sha256(text) — stable per action-item text, not positional. */
+function actionItemHash(text) {
+    return createHash("sha256").update(text).digest("hex").slice(0, 8);
+}
+/** tasks/doc-<doc_token>-<hash8(text)> (Spec 9 §3.3). */
+export function actionItemTaskSlug(docToken, text) {
+    return `tasks/doc-${docToken}-${actionItemHash(text)}`;
+}
+function renderTaskMarkdown(docToken, item, ownerSlug) {
+    const fm = {
+        title: item.text,
+        type: "task",
+        status: item.status,
+        source: `doc:${docToken}`,
+    };
+    if (ownerSlug)
+        fm.owner_slug = ownerSlug;
+    if (item.due)
+        fm.due = item.due;
+    const yaml = stringifyYaml(fm).trimEnd();
+    return `---\n${yaml}\n---\n\n${item.text}\n`;
+}
+async function writeActionItems(stores, card, deps) {
+    if (card.extract_level !== "full")
+        return;
+    for (const item of card.action_items) {
+        const ownerSlug = item.owner_raw ? await deps.resolveOwner(item.owner_raw) : null;
+        const slug = actionItemTaskSlug(card.doc_token, item.text);
+        const content = renderTaskMarkdown(card.doc_token, item, ownerSlug);
+        const page = await stores.pages.putPage(slug, content, { halflife_days: null });
+        if (page.compiled_truth?.trim()) {
+            await stores.chunks.rechunk(page.id, page.compiled_truth);
+        }
+        if (ownerSlug) {
+            await deps.graph.addLink(slug, ownerSlug, "mentions");
+            if (ownerSlug !== "entities/me" && (await deps.isMe(ownerSlug))) {
+                await deps.graph.addLink(slug, "entities/me", "mentions");
+            }
+        }
+    }
+}
+export async function writeCard(stores, card, actionItemDeps) {
+    const content = renderDocCardMarkdown(card);
+    const page = await stores.pages.putPage(docSlug(card.doc_token), content, {
+        halflife_days: null,
+    });
+    await stores.chunks.rechunk(page.id, page.compiled_truth);
+    // Spec 9 §3.3: persist each action_item as a task signal anchored to its owner.
+    if (actionItemDeps && card.extract_level === "full" && card.action_items.length > 0) {
+        await writeActionItems(stores, card, actionItemDeps);
+    }
+}
+/**
+ * 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 async function loadExistingCard(stores, docToken) {
+    const page = await stores.pages.getPage(docSlug(docToken));
+    if (!page)
+        return null;
+    const fm = page.frontmatter;
+    if (fm.extract_level !== "full" && fm.extract_level !== "pointer")
+        return null;
+    return fm;
+}
+//# sourceMappingURL=store-writer.js.map

package/dist/collectors/feishu/docs/store-writer.js.map

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

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

@@ -0,0 +1,3 @@
+import type { DocBlock, TocItem } from "./types.js";
+export declare function extractTocFromBlocks(blocks: DocBlock[]): TocItem[];
+//# sourceMappingURL=toc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toc.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/toc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAQpD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,CAUlE"}

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

@@ -0,0 +1,19 @@
+const HEADING_LEVEL = {
+    heading1: 1,
+    heading2: 2,
+    heading3: 3,
+};
+export function extractTocFromBlocks(blocks) {
+    const toc = [];
+    for (const block of blocks) {
+        const level = HEADING_LEVEL[block.type];
+        if (!level)
+            continue;
+        const title = block.text.trim();
+        if (!title)
+            continue;
+        toc.push({ level, title });
+    }
+    return toc;
+}
+//# sourceMappingURL=toc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toc.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/toc.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAA8B;IAC/C,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;CACZ,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { DocCandidate, DocDecisionConfig } from "./types.js";
+/**
+ * Returns the id of the first trigger that fires (T1, T2, T4 order), or null.
+ * `nowMs` is injected so the function stays pure/testable.
+ */
+export declare function evaluateTriggers(candidate: DocCandidate, config: DocDecisionConfig, selfOpenId: string, nowMs: number): string | null;
+//# sourceMappingURL=triggers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/triggers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElE;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,iBAAiB,EACzB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CA4Bf"}

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

@@ -0,0 +1,31 @@
+/**
+ * Returns the id of the first trigger that fires (T1, T2, T4 order), or null.
+ * `nowMs` is injected so the function stays pure/testable.
+ */
+export function evaluateTriggers(candidate, config, selfOpenId, nowMs) {
+    // T1 — self edit
+    if (config.self_edit && selfOpenId && candidate.last_editor_id === selfOpenId) {
+        return "T1";
+    }
+    // T2 — recency (off when recent_window_days is null)
+    if (config.recent_window_days != null) {
+        const modifiedMs = Date.parse(candidate.modified_at);
+        const windowMs = config.recent_window_days * 86_400_000;
+        if (!Number.isNaN(modifiedMs) && nowMs - modifiedMs <= windowMs) {
+            return "T2";
+        }
+    }
+    // T4 — important folder / wiki space
+    const src = candidate.source;
+    if (src.kind === "folder" && config.important_folders.includes(src.folder_token)) {
+        return "T4";
+    }
+    if (src.kind === "my_space" && config.important_folders.includes(src.folder_token)) {
+        return "T4";
+    }
+    if (src.kind === "wiki" && config.important_wiki_spaces.includes(src.space_id)) {
+        return "T4";
+    }
+    return null;
+}
+//# sourceMappingURL=triggers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/triggers.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAuB,EACvB,MAAyB,EACzB,UAAkB,EAClB,KAAa;IAEb,iBAAiB;IACjB,IAAI,MAAM,CAAC,SAAS,IAAI,UAAU,IAAI,SAAS,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qDAAqD;IACrD,IAAI,MAAM,CAAC,kBAAkB,IAAI,IAAI,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,kBAAkB,GAAG,UAAU,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC;IAC7B,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QACjF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QACnF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,qBAAqB,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}