@andre.li/memoark 0.3.1 → 0.3.2

package/dist/synth/intents/troubleshoot.js

@@ -0,0 +1,66 @@
+import { missingFieldRule } from "../gaps.js";
+/**
+ * Reorder `candidates` so that any slug present in `order` appears first, in the
+ * order given; candidates not in `order` keep their relative order and trail behind.
+ */
+function reorderBy(candidates, order) {
+    const rank = new Map();
+    order.forEach((slug, i) => {
+        rank.set(slug, i);
+    });
+    const ranked = [];
+    const rest = [];
+    for (const c of candidates) {
+        if (rank.has(c.slug))
+            ranked.push(c);
+        else
+            rest.push(c);
+    }
+    ranked.sort((a, b) => (rank.get(a.slug) ?? 0) - (rank.get(b.slug) ?? 0));
+    return [...ranked, ...rest];
+}
+/**
+ * Spec 11 §6: one-shot troubleshooting over playbook pages.
+ *
+ * Retrieval is scoped to `type=playbook`. Graph-edge ordering happens HERE (the
+ * LLM cannot see edges): the `sortCandidates` hook walks the `precedes` chain via
+ * `graph.getOrderedSequence` and pre-orders candidates before they are numbered.
+ * The systemPrompt only asks the model to follow the given numbering.
+ */
+export const troubleshootIntent = {
+    id: "troubleshoot",
+    format: "single",
+    staleDays: 0,
+    // types:["playbook"] is passed through by scope.ts to search.ts's `p.type = ANY($n)` filter.
+    buildScope: (args) => ({
+        query: args.query,
+        types: ["playbook"],
+        limit: 10,
+    }),
+    systemPrompt: "你是排查助手。下面是按排查顺序排好的 playbook 片段。" +
+        "请按片段给定的编号顺序组织排查步骤，并解释每步不同结果的含义。" +
+        "用 [n] 标注来源 playbook。信息不足时直说。",
+    expects: ["排查步骤"],
+    gapRules: [missingFieldRule],
+    // Graph-edge ordering at retrieval time; engine.ts calls this hook generically.
+    // Candidates arrive ranked by relevance, not by graph order. We walk the `precedes`
+    // chain from each candidate and adopt the longest chain that covers the most of them
+    // (so the chain head, wherever it sits in the relevance ranking, anchors the order).
+    async sortCandidates(candidates, stores) {
+        if (candidates.length <= 1)
+            return candidates;
+        const slugSet = new Set(candidates.map((c) => c.slug));
+        let best = [];
+        for (const c of candidates) {
+            const seq = (await stores.graph.getOrderedSequence(c.slug)).map((n) => n.slug);
+            const coverage = seq.filter((s) => slugSet.has(s)).length;
+            const bestCoverage = best.filter((s) => slugSet.has(s)).length;
+            if (coverage > bestCoverage)
+                best = seq;
+        }
+        if (best.length === 0)
+            return candidates;
+        return reorderBy(candidates, best);
+    },
+};
+//# sourceMappingURL=troubleshoot.js.map

package/dist/synth/intents/troubleshoot.js.map

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

package/dist/synth/scope.d.ts

@@ -0,0 +1,13 @@
+import type { StoreContext } from "../server/api.js";
+import type { AssembledCandidate, SynthScope } from "./types.js";
+/** A retrieved candidate before ref numbering (assigned in context.assemble). */
+export type RawCandidate = Omit<AssembledCandidate, "ref">;
+/**
+ * Retrieve candidates for a synth scope (Spec 7 §3.3 step 3).
+ * Three modes (entity / time / query); candidates are returned unnumbered —
+ * ref assignment happens in context.assemble.
+ */
+export declare function retrieve(scope: SynthScope, _opts: {
+    poolByPage?: boolean;
+}, stores: StoreContext): Promise<RawCandidate[]>;
+//# sourceMappingURL=scope.d.ts.map

package/dist/synth/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/synth/scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEjE,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;AAqB3D;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,EAC/B,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC,CAazB"}

package/dist/synth/scope.js

@@ -0,0 +1,139 @@
+const DEFAULT_LIMIT = 30;
+function sourceToString(source) {
+    if (!source)
+        return undefined;
+    return source.channel_name ?? source.channel ?? source.platform ?? undefined;
+}
+function dedupeBySlug(candidates) {
+    const seen = new Set();
+    const out = [];
+    for (const c of candidates) {
+        const key = `${c.slug}::${c.text}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(c);
+    }
+    return out;
+}
+/**
+ * Retrieve candidates for a synth scope (Spec 7 §3.3 step 3).
+ * Three modes (entity / time / query); candidates are returned unnumbered —
+ * ref assignment happens in context.assemble.
+ */
+export async function retrieve(scope, _opts, stores) {
+    const limit = scope.limit ?? DEFAULT_LIMIT;
+    if (scope.query) {
+        return retrieveByQuery(scope, limit, stores);
+    }
+    if (scope.entity) {
+        return retrieveByEntity(scope, limit, stores);
+    }
+    if (scope.time) {
+        return retrieveByTime(scope, limit, stores);
+    }
+    return [];
+}
+async function retrieveByQuery(scope, limit, stores) {
+    const results = await stores.search.query(scope.query, {
+        poolByPage: true,
+        type: scope.types,
+        from: scope.time?.from,
+        to: scope.time?.to,
+        limit,
+    });
+    return results.map((r) => ({
+        slug: r.slug,
+        title: r.title,
+        type: r.type,
+        text: r.snippet || r.title,
+        source: sourceToString(r.provenance),
+    }));
+}
+async function retrieveByEntity(scope, limit, stores) {
+    const candidates = [];
+    const typeSet = scope.types && scope.types.length > 0 ? new Set(scope.types) : undefined;
+    const backlinks = await stores.graph.getBacklinksEnriched(scope.entity);
+    for (const bl of backlinks) {
+        if (typeSet && !typeSet.has(bl.page.type))
+            continue;
+        const page = await stores.pages.getPage(bl.from_slug);
+        if (!page)
+            continue;
+        const source = (page.frontmatter.source ?? page.frontmatter.first_seen);
+        candidates.push({
+            slug: page.slug,
+            title: page.title,
+            type: page.type,
+            text: page.compiled_truth || page.title,
+            date: source?.timestamp ?? page.created_at,
+            source: sourceToString(source),
+        });
+    }
+    const timeline = await stores.timeline.getTimeline(scope.entity);
+    for (const entry of timeline) {
+        candidates.push({
+            slug: scope.entity,
+            title: entry.summary,
+            type: "timeline",
+            text: entry.detail ? `${entry.summary} — ${entry.detail}` : entry.summary,
+            date: entry.date,
+            source: sourceToString(entry.provenance),
+        });
+    }
+    return dedupeBySlug(candidates).slice(0, limit);
+}
+/**
+ * Cross-channel dedupe (Spec 9 §6): drop rows whose `frontmatter.source_hash`
+ * was already seen — the same source block surfaced under two slugs (e.g. a mail
+ * forwarded into a group). Rows without a source_hash are always kept. The first
+ * occurrence (DESC by signal_time) wins.
+ */
+function dedupeBySourceHash(rows) {
+    const seenHash = new Set();
+    const out = [];
+    for (const row of rows) {
+        if (row.source_hash) {
+            if (seenHash.has(row.source_hash))
+                continue;
+            seenHash.add(row.source_hash);
+        }
+        out.push(row);
+    }
+    return out;
+}
+async function retrieveByTime(scope, limit, stores) {
+    const time = scope.time;
+    const params = [time.from, time.to];
+    const conditions = [
+        `COALESCE(frontmatter->'source'->>'timestamp', frontmatter->'first_seen'->>'timestamp', created_at::text)::timestamptz >= $1::timestamptz`,
+        `COALESCE(frontmatter->'source'->>'timestamp', frontmatter->'first_seen'->>'timestamp', created_at::text)::timestamptz < ($2::date + interval '1 day')`,
+    ];
+    if (scope.types && scope.types.length > 0) {
+        params.push(scope.types);
+        conditions.push(`type = ANY($${params.length}::text[])`);
+    }
+    params.push(limit);
+    const result = await stores.db.pg.query(`SELECT slug, title, type, compiled_truth,
+       COALESCE(frontmatter->'source'->>'timestamp', frontmatter->'first_seen'->>'timestamp', created_at::text) AS signal_time,
+       COALESCE(frontmatter->'source', frontmatter->'first_seen') AS source,
+       frontmatter->>'source_hash' AS source_hash
+     FROM pages
+     WHERE ${conditions.join(" AND ")}
+     ORDER BY signal_time DESC
+     LIMIT $${params.length}`, params);
+    return dedupeBySourceHash(result.rows).map((row) => {
+        const source = typeof row.source === "string"
+            ? JSON.parse(row.source)
+            : (row.source ?? undefined);
+        return {
+            slug: row.slug,
+            title: row.title,
+            type: row.type,
+            text: row.compiled_truth || row.title,
+            date: row.signal_time ?? undefined,
+            source: sourceToString(source ?? undefined),
+        };
+    });
+}
+//# sourceMappingURL=scope.js.map

package/dist/synth/scope.js.map

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

package/dist/synth/types.d.ts

@@ -0,0 +1,117 @@
+import type { StoreContext } from "../server/api.js";
+export interface SynthScope {
+    /** 围绕某实体（如 person/zhang-san）→ backlinks + timeline */
+    entity?: string;
+    /** 时间窗 → 跨渠道按 date 过滤 */
+    time?: {
+        from: string;
+        to: string;
+    };
+    /** 自由语义检索 → hybrid search */
+    query?: string;
+    /** 限定信号类型（透传到 search 的 `p.type = ANY(...)` 过滤） */
+    types?: string[];
+    /** 限定来源渠道，合法值与 timeline_entries.source 对齐 */
+    channels?: string[];
+    /** 候选上限（默认 30） */
+    limit?: number;
+}
+/**
+ * 合成调用选项：意图专属参数（如 daily_report 的 date、person_strategy 的 goal）经 extra 透传到 compose。
+ */
+export interface SynthOpts {
+    /** 透传给意图的 systemPrompt 拼装 */
+    extra?: Record<string, unknown>;
+    noCache?: boolean;
+}
+export interface AssembledCandidate {
+    /** 引用编号，从 1 起，对应 answer 里的 [n] */
+    ref: number;
+    slug: string;
+    title: string;
+    type: string;
+    /** 喂给 LLM 的正文片段 */
+    text: string;
+    /** 信号日期（gap 计算用） */
+    date?: string;
+    /** provenance（frontmatter.source / links.provenance / timeline.provenance） */
+    source?: string;
+}
+export interface AssembledContext {
+    scope: SynthScope;
+    candidates: AssembledCandidate[];
+    /** candidates 中 max(date)，供 stale gap 用 */
+    latestDate?: string;
+    /**
+     * 非可引用的前置框架文本（如人物画像摘要）；由意图的 buildPinnedContext 钩子产出，
+     * 置于候选之前喂 LLM。不分配 ref，引用仍指向 candidates。
+     */
+    pinnedContext?: string;
+}
+export interface ComposeOutput {
+    /** 含 inline [n] 标记的 markdown */
+    answer: string;
+}
+export interface Citation {
+    /** 与 answer 里的 [n] 一一对应 */
+    ref: number;
+    slug: string;
+    title: string;
+    source?: string;
+    date?: string;
+}
+export interface Gap {
+    type: "stale" | "missing_field" | "contradiction";
+    message: string;
+    meta?: Record<string, unknown>;
+}
+export interface GapRule {
+    id: Gap["type"];
+    evaluate(ctx: AssembledContext, raw: ComposeOutput, intent: IntentTemplate): Gap[];
+}
+export interface SynthesisResult {
+    intent: string;
+    /** 始终非空 */
+    answer: string;
+    /** 仅 format="sections" 的意图产出 */
+    sections?: {
+        title: string;
+        body: string;
+    }[];
+    /** 仅保留被 answer 引用过的候选 */
+    citations: Citation[];
+    gaps: Gap[];
+    meta: {
+        model: string;
+        generated_at: string;
+        scope: SynthScope;
+        cached: boolean;
+    };
+}
+export interface IntentTemplate {
+    id: string;
+    format: "single" | "sections";
+    buildScope(args: Record<string, unknown>): SynthScope;
+    systemPrompt: string;
+    /** missing_field gap：期望 answer 覆盖的要点 */
+    expects?: string[];
+    /** stale gap 阈值（缺省 14） */
+    staleDays?: number;
+    gapRules: GapRule[];
+    /** format="sections" 必填 */
+    parseSections?(answer: string): {
+        title: string;
+        body: string;
+    }[];
+    /**
+     * 可选钩子：产出 AssembledContext.pinnedContext（如 Spec 8 读 frontmatter.profile）。
+     * 通用层只调用、不感知具体意图。
+     */
+    buildPinnedContext?(scope: SynthScope, stores: StoreContext): Promise<string | undefined>;
+    /**
+     * 可选钩子：重排候选（如 Spec 11 沿 precedes 链）。
+     * 通用层只调用、不感知具体意图。
+     */
+    sortCandidates?(candidates: AssembledCandidate[], stores: StoreContext): Promise<AssembledCandidate[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/synth/types.d.ts.map

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

package/dist/synth/types.js

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

package/dist/synth/types.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@andre.li/memoark",
-  "version": "0.3.1",
-  "description": "Local-first personal memory extraction and storage",
+  "version": "0.3.2",
+  "description": "Local-first personal memory system — extracts signals from Feishu/Lark chats and AI-agent sessions into a private knowledge graph, served to any agent via MCP",
   "type": "module",
   "bin": {
     "memoark": "./bin/memoark.mjs"
@@ -25,6 +25,7 @@
     "access": "public"
   },
   "scripts": {
+    "setup": "bun install && cd web && bun install",
     "dev": "bun src/cli.ts",
     "test": "vitest run",
     "test:watch": "vitest --watch",
@@ -32,6 +33,8 @@
     "build": "node scripts/gen-embedded-assets.mjs && tsc && node scripts/post-build.mjs",
     "compile": "node scripts/gen-embedded-assets.mjs && bun build --compile src/cli.ts --outfile dist-bin/memoark",
     "typecheck": "tsc --noEmit",
+    "prepack": "mv README.md README.zh-CN.md && cp README.en.md README.md",
+    "postpack": "mv README.zh-CN.md README.md",
     "prepublishOnly": "npm run build",
     "lint": "biome check src/ tests/",
     "lint:fix": "biome check --fix src/ tests/",
@@ -43,11 +46,13 @@
   },
   "dependencies": {
     "@electric-sql/pglite": "^0.4.6",
+    "@hono/node-server": "^1.19.14",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "commander": "^11.1.0",
     "hono": "^4.12.23",
     "ink": "^7.0.5",
     "openai": "^6.39.0",
+    "pinyin-pro": "^3.28.1",
     "react": "^19.2.7",
     "react-devtools-core": "^6.1.5",
     "yaml": "^2.3.4",
@@ -63,22 +68,29 @@
     "vitest": "^1.0.4"
   },
   "keywords": [
+    "mcp",
+    "agent-memory",
+    "local-first",
     "knowledge-graph",
-    "signal-extraction",
+    "feishu",
+    "lark",
     "claude-code",
     "codex",
     "ai-agent",
+    "self-hosted",
+    "personal-knowledge-management",
+    "signal-extraction",
     "conversation-mining",
+    "pglite",
     "cli"
   ],
-  "author": "AndreLYL",
+  "author": "AndreLYL (https://github.com/AndreLYL)",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/AndreLYL/memoark.git"
   },
   "engines": {
-    "node": ">=18.0.0",
-    "bun": ">=1.0.0"
+    "node": ">=18.0.0"
   }
 }