@andre.li/memoark 0.3.1 → 0.3.2

package/dist/synth/context.js

@@ -0,0 +1,67 @@
+/**
+ * Token budget for assembled candidates (Spec 9 §6). `limit` only caps how many
+ * candidates are retrieved; here we truncate the retrieved set to a total token
+ * budget so a busy day never dumps hundreds of signals into the LLM. We use a
+ * cheap chars≈tokens heuristic (CJK-heavy text → ~1 token/char is a safe upper
+ * bound) and accumulate in order, stopping once the budget is exceeded.
+ */
+const TOKEN_BUDGET = 12_000;
+const CHARS_PER_TOKEN = 1;
+function estimateTokens(c) {
+    return Math.ceil((c.title.length + c.text.length) / CHARS_PER_TOKEN);
+}
+/**
+ * Drop exact-duplicate candidates, keeping the first occurrence (Spec 9 §6
+ * primary-key dedupe). Keyed on `slug::text` (not slug alone) so that
+ * entity-scope retrieval, which emits every timeline entry under the same
+ * `slug = scope.entity`, is not collapsed to a single entry. Matches the
+ * composite key used by scope.ts's own dedupe.
+ */
+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;
+}
+/** Accumulate candidates in order until the token budget is reached. Always keeps ≥1. */
+function truncateToBudget(candidates) {
+    const out = [];
+    let used = 0;
+    for (const c of candidates) {
+        const cost = estimateTokens(c);
+        if (out.length > 0 && used + cost > TOKEN_BUDGET)
+            break;
+        out.push(c);
+        used += cost;
+    }
+    return out;
+}
+/**
+ * Assemble retrieved candidates into a numbered AssembledContext (Spec 7 §3.3 step 5).
+ * Dedupes by slug, truncates to a token budget (Spec 9 §6), assigns ref=1..N (in
+ * order), and derives latestDate=max(date). pinnedContext is left undefined;
+ * intents may set it via the buildPinnedContext hook.
+ */
+export function assemble(scope, candidates) {
+    const deduped = dedupeBySlug(candidates);
+    const budgeted = truncateToBudget(deduped);
+    const numbered = budgeted.map((c, i) => ({ ...c, ref: i + 1 }));
+    let latestDate;
+    for (const c of numbered) {
+        if (c.date && (!latestDate || c.date > latestDate)) {
+            latestDate = c.date;
+        }
+    }
+    return {
+        scope,
+        candidates: numbered,
+        latestDate,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/synth/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/synth/context.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,YAAY,GAAG,MAAM,CAAC;AAC5B,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,SAAS,cAAc,CAAC,CAAe;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,UAA0B;IAC9C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,yFAAyF;AACzF,SAAS,gBAAgB,CAAC,UAA0B;IAClD,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,GAAG,IAAI,GAAG,YAAY;YAAE,MAAM;QACxD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,IAAI,IAAI,IAAI,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAiB,EAAE,UAA0B;IACpE,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAEhE,IAAI,UAA8B,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC;YACnD,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK;QACL,UAAU,EAAE,QAAQ;QACpB,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/synth/engine.d.ts

@@ -0,0 +1,16 @@
+import type { LLMProvider } from "../extractors/providers/types.js";
+import type { StoreContext } from "../server/api.js";
+import "./intents/index.js";
+import type { SynthesisResult, SynthOpts, SynthScope } from "./types.js";
+export interface SynthDeps {
+    stores: StoreContext;
+    provider: LLMProvider;
+    /** Model id to record in meta (the provider itself is already configured). */
+    model?: string;
+}
+/**
+ * Synthesis engine entry point (Spec 7 §3.3 eight-step flow).
+ * The engine calls optional intent hooks generically; it never imports a concrete intent.
+ */
+export declare function synthesize(intentId: string, scope: SynthScope, deps: SynthDeps, opts?: SynthOpts): Promise<SynthesisResult>;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/synth/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAOrD,OAAO,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAKV,eAAe,EACf,SAAS,EACT,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,WAAW,CAAC;IACtB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA2CD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,EACf,IAAI,CAAC,EAAE,SAAS,GACf,OAAO,CAAC,eAAe,CAAC,CAiF1B"}

package/dist/synth/engine.js

@@ -0,0 +1,111 @@
+import * as cache from "./cache.js";
+import { finalize } from "./citations.js";
+import { assemble } from "./context.js";
+import { getIntent } from "./intent.js";
+import { retrieve } from "./scope.js";
+// Trigger explicit intent registration before any synthesize() call.
+import "./intents/index.js";
+function renderCandidates(ctx) {
+    return ctx.candidates
+        .map((c) => `[${c.ref}] ${c.title}${c.date ? ` (${c.date})` : ""}\n${c.text}`)
+        .join("\n\n");
+}
+function buildMessages(intent, ctx, extra) {
+    const parts = [];
+    if (ctx.pinnedContext)
+        parts.push(ctx.pinnedContext);
+    parts.push(renderCandidates(ctx));
+    if (extra && Object.keys(extra).length > 0) {
+        parts.push(`补充参数：${JSON.stringify(extra)}`);
+    }
+    return [
+        { role: "system", content: intent.systemPrompt },
+        { role: "user", content: parts.join("\n\n") },
+    ];
+}
+async function compose(intent, ctx, provider, extra) {
+    const answer = await provider.chat(buildMessages(intent, ctx, extra));
+    return { answer };
+}
+function runGaps(intent, ctx, raw) {
+    const gaps = [];
+    for (const rule of intent.gapRules) {
+        gaps.push(...rule.evaluate(ctx, raw, intent));
+    }
+    return gaps;
+}
+/**
+ * Synthesis engine entry point (Spec 7 §3.3 eight-step flow).
+ * The engine calls optional intent hooks generically; it never imports a concrete intent.
+ */
+export async function synthesize(intentId, scope, deps, opts) {
+    // 1. resolve intent
+    const intent = getIntent(intentId);
+    const { stores, provider } = deps;
+    // 3. retrieve candidates (best-chunk pooling enabled inside scope retrieval)
+    const rawCandidates = await retrieve(scope, { poolByPage: true }, stores);
+    // Short-circuit: no candidates → never call the LLM (avoid hallucination + cost).
+    if (rawCandidates.length === 0) {
+        return {
+            intent: intentId,
+            answer: "(未找到相关记忆)",
+            sections: undefined,
+            citations: [],
+            gaps: [],
+            meta: {
+                model: deps.model ?? "unknown",
+                generated_at: new Date().toISOString(),
+                scope,
+                cached: false,
+            },
+        };
+    }
+    // 4. optional hook: re-rank candidates
+    let raw = rawCandidates;
+    if (intent.sortCandidates) {
+        const numbered = raw.map((c, i) => ({ ...c, ref: i + 1 }));
+        const sorted = await intent.sortCandidates(numbered, stores);
+        raw = sorted.map(({ ref: _ref, ...rest }) => rest);
+    }
+    // 5. assemble numbered context
+    const ctx = assemble(scope, raw);
+    // compute freshness hash now that candidates are known
+    const inputHash = cache.computeInputHash(ctx.candidates);
+    // 2. cache read (after retrieval so input_hash freshness can be validated)
+    if (!opts?.noCache) {
+        const hit = await cache.read(intentId, scope, inputHash, stores);
+        if (hit)
+            return hit;
+    }
+    // 6. optional hook: build non-citable pinned context
+    if (intent.buildPinnedContext) {
+        ctx.pinnedContext = await intent.buildPinnedContext(scope, stores);
+    }
+    // 7. compose via LLM
+    const composed = await compose(intent, ctx, provider, opts?.extra);
+    // 8. finalize citations + gaps + cache write
+    const { answer, citations } = finalize(composed.answer, ctx.candidates);
+    const gaps = runGaps(intent, ctx, composed);
+    let sections;
+    if (intent.format === "sections" && intent.parseSections) {
+        sections = intent.parseSections(answer);
+    }
+    const result = {
+        intent: intentId,
+        answer,
+        sections,
+        citations,
+        gaps,
+        meta: {
+            model: deps.model ?? "unknown",
+            generated_at: new Date().toISOString(),
+            scope,
+            cached: false,
+        },
+    };
+    if (!opts?.noCache) {
+        await cache.write(intentId, scope, result, inputHash, stores);
+    }
+    return result;
+}
+//# sourceMappingURL=engine.js.map

package/dist/synth/engine.js.map

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

package/dist/synth/gaps.d.ts

@@ -0,0 +1,17 @@
+import type { GapRule } from "./types.js";
+/**
+ * stale gap (Spec 7 §六): the freshest candidate is older than the intent's staleDays threshold.
+ * Deterministic; no LLM.
+ */
+export declare const staleRule: GapRule;
+/**
+ * missing_field gap (Spec 7 §六): an expected point (intent.expects) is not covered by the answer.
+ * Deterministic keyword/heuristic match.
+ */
+export declare const missingFieldRule: GapRule;
+/**
+ * contradiction gap (Spec 7 §六): placeholder. Default off — runs as an independent optional
+ * pass (not mixed into compose). Implemented in a later spec / consolidator follow-up.
+ */
+export declare const contradictionRule: GapRule;
+//# sourceMappingURL=gaps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gaps.d.ts","sourceRoot":"","sources":["../../src/synth/gaps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwC,OAAO,EAAkB,MAAM,YAAY,CAAC;AAIhG;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,OAevB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAgB9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAK/B,CAAC"}

package/dist/synth/gaps.js

@@ -0,0 +1,57 @@
+const DEFAULT_STALE_DAYS = 14;
+/**
+ * stale gap (Spec 7 §六): the freshest candidate is older than the intent's staleDays threshold.
+ * Deterministic; no LLM.
+ */
+export const staleRule = {
+    id: "stale",
+    evaluate(ctx, _raw, intent) {
+        if (!ctx.latestDate)
+            return [];
+        const staleDays = intent.staleDays ?? DEFAULT_STALE_DAYS;
+        const ageDays = (Date.now() - new Date(ctx.latestDate).getTime()) / 86_400_000;
+        if (ageDays <= staleDays)
+            return [];
+        return [
+            {
+                type: "stale",
+                message: `最新信息距今约 ${Math.floor(ageDays)} 天（超过 ${staleDays} 天阈值），可能已过期。`,
+                meta: { latestDate: ctx.latestDate, staleDays, ageDays: Math.floor(ageDays) },
+            },
+        ];
+    },
+};
+/**
+ * missing_field gap (Spec 7 §六): an expected point (intent.expects) is not covered by the answer.
+ * Deterministic keyword/heuristic match.
+ */
+export const missingFieldRule = {
+    id: "missing_field",
+    evaluate(_ctx, raw, intent) {
+        const expects = intent.expects ?? [];
+        if (expects.length === 0)
+            return [];
+        const haystack = raw.answer.toLowerCase();
+        const missing = expects.filter((field) => !haystack.includes(field.toLowerCase()));
+        if (missing.length === 0)
+            return [];
+        return [
+            {
+                type: "missing_field",
+                message: `回答未覆盖以下要点：${missing.join("、")}。`,
+                meta: { missing },
+            },
+        ];
+    },
+};
+/**
+ * contradiction gap (Spec 7 §六): placeholder. Default off — runs as an independent optional
+ * pass (not mixed into compose). Implemented in a later spec / consolidator follow-up.
+ */
+export const contradictionRule = {
+    id: "contradiction",
+    evaluate() {
+        return [];
+    },
+};
+//# sourceMappingURL=gaps.js.map

package/dist/synth/gaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gaps.js","sourceRoot":"","sources":["../../src/synth/gaps.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAY;IAChC,EAAE,EAAE,OAAO;IACX,QAAQ,CAAC,GAAqB,EAAE,IAAmB,EAAE,MAAsB;QACzE,IAAI,CAAC,GAAG,CAAC,UAAU;YAAE,OAAO,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,kBAAkB,CAAC;QACzD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC;QAC/E,IAAI,OAAO,IAAI,SAAS;YAAE,OAAO,EAAE,CAAC;QACpC,OAAO;YACL;gBACE,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,SAAS,cAAc;gBACvE,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE;aAC9E;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAY;IACvC,EAAE,EAAE,eAAe;IACnB,QAAQ,CAAC,IAAsB,EAAE,GAAkB,EAAE,MAAsB;QACzE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACnF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACpC,OAAO;YACL;gBACE,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,aAAa,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;gBAC1C,IAAI,EAAE,EAAE,OAAO,EAAE;aAClB;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAY;IACxC,EAAE,EAAE,eAAe;IACnB,QAAQ;QACN,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC"}

package/dist/synth/index.d.ts

@@ -0,0 +1,6 @@
+import "./intents/index.js";
+export type { SynthDeps } from "./engine.js";
+export { synthesize } from "./engine.js";
+export { getIntent, registerIntent } from "./intent.js";
+export type { AssembledCandidate, AssembledContext, Citation, ComposeOutput, Gap, GapRule, IntentTemplate, SynthesisResult, SynthOpts, SynthScope, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/synth/index.ts"],"names":[],"mappings":"AAEA,OAAO,oBAAoB,CAAC;AAE5B,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,GAAG,EACH,OAAO,EACP,cAAc,EACd,eAAe,EACf,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/synth/index.js

@@ -0,0 +1,6 @@
+// Public entry point for the synthesis engine.
+// Importing this module registers built-in intents (via engine.ts → intents/index.ts).
+import "./intents/index.js";
+export { synthesize } from "./engine.js";
+export { getIntent, registerIntent } from "./intent.js";
+//# sourceMappingURL=index.js.map

package/dist/synth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/synth/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,uFAAuF;AACvF,OAAO,oBAAoB,CAAC;AAG5B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/synth/intent.d.ts

@@ -0,0 +1,6 @@
+import type { IntentTemplate } from "./types.js";
+/** Register an intent template. Called explicitly from intents/index.ts (no import side-effect magic). */
+export declare function registerIntent(t: IntentTemplate): void;
+/** Resolve a registered intent by id; throws if unknown. */
+export declare function getIntent(id: string): IntentTemplate;
+//# sourceMappingURL=intent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/synth/intent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,0GAA0G;AAC1G,wBAAgB,cAAc,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI,CAEtD;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAIpD"}

package/dist/synth/intent.js

@@ -0,0 +1,13 @@
+const intentRegistry = new Map();
+/** Register an intent template. Called explicitly from intents/index.ts (no import side-effect magic). */
+export function registerIntent(t) {
+    intentRegistry.set(t.id, t);
+}
+/** Resolve a registered intent by id; throws if unknown. */
+export function getIntent(id) {
+    const t = intentRegistry.get(id);
+    if (!t)
+        throw new Error(`unknown synth intent: ${id}`);
+    return t;
+}
+//# sourceMappingURL=intent.js.map

package/dist/synth/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../src/synth/intent.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEzD,0GAA0G;AAC1G,MAAM,UAAU,cAAc,CAAC,CAAiB;IAC9C,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/synth/intents/daily-report.d.ts

@@ -0,0 +1,7 @@
+import type { IntentTemplate } from "../types.js";
+export declare function parseSections(answer: string): {
+    title: string;
+    body: string;
+}[];
+export declare const dailyReportIntent: IntentTemplate;
+//# sourceMappingURL=daily-report.d.ts.map

package/dist/synth/intents/daily-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daily-report.d.ts","sourceRoot":"","sources":["../../../src/synth/intents/daily-report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,aAAa,CAAC;AAU9D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAQ/E;AAED,eAAO,MAAM,iBAAiB,EAAE,cAmB/B,CAAC"}

package/dist/synth/intents/daily-report.js

@@ -0,0 +1,37 @@
+import { missingFieldRule } from "../gaps.js";
+// Spec 9 §5.1 (responds to S9-P1-2): local-timezone YYYY-MM-DD.
+function today() {
+    const d = new Date();
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+// Spec 9 §5.1 (responds to S9-P0-1): the LLM emits "## <section title>\n<body>";
+// split on H2 headers.
+export function parseSections(answer) {
+    const parts = answer.split(/^##\s+/m).filter((s) => s.trim());
+    return parts.map((p) => {
+        const nl = p.indexOf("\n");
+        return nl === -1
+            ? { title: p.trim(), body: "" }
+            : { title: p.slice(0, nl).trim(), body: p.slice(nl + 1).trim() };
+    });
+}
+export const dailyReportIntent = {
+    id: "daily_report",
+    format: "sections", // Spec 7 §3.4
+    staleDays: 0, // a daily report is never "stale"
+    buildScope: (args) => {
+        const day = args.date ?? today();
+        // limit:200 is only a retrieval cap; context.ts truncates to a token budget (§6).
+        return { time: { from: `${day}T00:00:00`, to: `${day}T23:59:59` }, limit: 200 };
+    },
+    // Spec 9 §5.1 (responds to R2-S9-P1-1): must be a real string. The 7 H2 titles
+    // are fixed and in fixed order; parseSections depends on them.
+    systemPrompt: "你是用户的工作日报助手。基于下列带编号的今日记忆片段，用中文生成日报。\n" +
+        "严格用 7 个二级标题分段，标题文字必须与下列完全一致、顺序不变：\n" +
+        "## 今日概览\n## 今日完成\n## 推进中\n## 我的待办\n## 待回复与被@\n## 人脉动态\n## 明日提醒\n" +
+        "每段下写要点；事实性条目后用 [n] 标注来源编号；无内容的段写「无」。不要编造未提供的信息。",
+    expects: ["今日完成", "我的待办", "明日提醒"], // substrings of the fixed titles above
+    gapRules: [missingFieldRule],
+    parseSections,
+};
+//# sourceMappingURL=daily-report.js.map

package/dist/synth/intents/daily-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daily-report.js","sourceRoot":"","sources":["../../../src/synth/intents/daily-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,gEAAgE;AAChE,SAAS,KAAK;IACZ,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACnH,CAAC;AAED,iFAAiF;AACjF,uBAAuB;AACvB,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACrB,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,EAAE,KAAK,CAAC,CAAC;YACd,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;YAC/B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,EAAE,EAAE,cAAc;IAClB,MAAM,EAAE,UAAU,EAAE,cAAc;IAClC,SAAS,EAAE,CAAC,EAAE,kCAAkC;IAChD,UAAU,EAAE,CAAC,IAAI,EAAc,EAAE;QAC/B,MAAM,GAAG,GAAI,IAAI,CAAC,IAAe,IAAI,KAAK,EAAE,CAAC;QAC7C,kFAAkF;QAClF,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,GAAG,WAAW,EAAE,EAAE,EAAE,GAAG,GAAG,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAClF,CAAC;IACD,+EAA+E;IAC/E,+DAA+D;IAC/D,YAAY,EACV,uCAAuC;QACvC,qCAAqC;QACrC,kEAAkE;QAClE,iDAAiD;IACnD,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,uCAAuC;IAC1E,QAAQ,EAAE,CAAC,gBAAgB,CAAC;IAC5B,aAAa;CACd,CAAC"}

package/dist/synth/intents/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/synth/intents/index.d.ts.map

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

package/dist/synth/intents/index.js

@@ -0,0 +1,12 @@
+import { registerIntent } from "../intent.js";
+import { dailyReportIntent } from "./daily-report.js";
+import { personStrategyIntent } from "./person-strategy.js";
+import { recallIntent } from "./recall.js";
+import { troubleshootIntent } from "./troubleshoot.js";
+// Explicit registration (no implicit import-order side effects).
+// Spec 8/9/11 append their own registerIntent(...) lines here.
+registerIntent(recallIntent);
+registerIntent(personStrategyIntent);
+registerIntent(dailyReportIntent);
+registerIntent(troubleshootIntent);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/synth/intents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,iEAAiE;AACjE,+DAA+D;AAC/D,cAAc,CAAC,YAAY,CAAC,CAAC;AAC7B,cAAc,CAAC,oBAAoB,CAAC,CAAC;AACrC,cAAc,CAAC,iBAAiB,CAAC,CAAC;AAClC,cAAc,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/synth/intents/person-strategy.d.ts

@@ -0,0 +1,40 @@
+/**
+ * person_strategy intent (Spec 8 §6) — the Hero feature's strategy synthesis.
+ *
+ * Produces practical, evidence-cited communication advice for a person, optionally
+ * conditioned on a goal (passed via SynthOpts.extra.goal, threaded by the engine).
+ *
+ * The structured person profile (frontmatter.profile) is injected as non-citable
+ * pinnedContext via the buildPinnedContext hook; the [n] citations still point at
+ * candidate signals (the profile's evidence_refs surface there as candidates).
+ *
+ * Ethics guardrail (§6.3) is the literal systemPrompt: suggestions for better
+ * communication/collaboration only — never manipulation, PUA, or pressure tactics.
+ */
+import type { IntentTemplate } from "../types.js";
+interface ProfileLike {
+    trait?: {
+        insufficient?: boolean;
+        dimensions?: Array<{
+            axis?: string;
+            level?: string;
+            confidence?: string;
+            note?: string;
+        }>;
+    };
+    four_color?: {
+        colors?: string[];
+        descriptions?: string[];
+        disclaimer?: string;
+    };
+    relation?: {
+        tone?: string;
+        concerns?: string[];
+        landmines?: string[];
+    };
+}
+/** Render a person's structured profile into a compact, non-citable framework block. */
+export declare function renderProfileBlock(profile: ProfileLike): string;
+export declare const personStrategyIntent: IntentTemplate;
+export {};
+//# sourceMappingURL=person-strategy.d.ts.map

package/dist/synth/intents/person-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"person-strategy.d.ts","sourceRoot":"","sources":["../../../src/synth/intents/person-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,aAAa,CAAC;AAE9D,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,UAAU,CAAC,EAAE,KAAK,CAAC;YACjB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC,CAAC;KACJ,CAAC;IACF,UAAU,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjF,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACzE;AAED,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CA6B/D;AAED,eAAO,MAAM,oBAAoB,EAAE,cAiBlC,CAAC"}

package/dist/synth/intents/person-strategy.js

@@ -0,0 +1,66 @@
+/**
+ * person_strategy intent (Spec 8 §6) — the Hero feature's strategy synthesis.
+ *
+ * Produces practical, evidence-cited communication advice for a person, optionally
+ * conditioned on a goal (passed via SynthOpts.extra.goal, threaded by the engine).
+ *
+ * The structured person profile (frontmatter.profile) is injected as non-citable
+ * pinnedContext via the buildPinnedContext hook; the [n] citations still point at
+ * candidate signals (the profile's evidence_refs surface there as candidates).
+ *
+ * Ethics guardrail (§6.3) is the literal systemPrompt: suggestions for better
+ * communication/collaboration only — never manipulation, PUA, or pressure tactics.
+ */
+import { staleRule } from "../gaps.js";
+/** Render a person's structured profile into a compact, non-citable framework block. */
+export function renderProfileBlock(profile) {
+    const lines = ["【沟通画像（前置参考，非引用来源）】"];
+    const trait = profile.trait;
+    if (trait?.insufficient) {
+        lines.push("特质层：证据不足，暂不画像。");
+    }
+    else if (trait?.dimensions && trait.dimensions.length > 0) {
+        lines.push("行为四象限：");
+        for (const d of trait.dimensions) {
+            const parts = [`${d.axis ?? "?"} ${d.level ?? ""}`.trim()];
+            if (d.confidence)
+                parts.push(`置信度:${d.confidence}`);
+            if (d.note)
+                parts.push(d.note);
+            lines.push(`- ${parts.join("，")}`);
+        }
+    }
+    const fc = profile.four_color;
+    if (fc?.colors && fc.colors.length > 0) {
+        lines.push(`四色：${fc.colors.join(" / ")}（${fc.disclaimer ?? "通俗映射，非临床诊断"}）`);
+    }
+    const rel = profile.relation;
+    if (rel) {
+        if (rel.tone)
+            lines.push(`关系基调：${rel.tone}`);
+        if (rel.concerns && rel.concerns.length > 0)
+            lines.push(`对方在意：${rel.concerns.join("、")}`);
+        if (rel.landmines && rel.landmines.length > 0)
+            lines.push(`雷区：${rel.landmines.join("、")}`);
+    }
+    return lines.join("\n");
+}
+export const personStrategyIntent = {
+    id: "person_strategy",
+    format: "single",
+    staleDays: 21,
+    buildScope: (args) => ({ entity: args.person, limit: 40 }),
+    systemPrompt: "你基于用户与某人的真实互动画像（前置 pinnedContext）和下列带编号的信号，给出实用的沟通建议。\n" +
+        "要求：① 只给「如何更好沟通/协作」的建议，不得给操纵、PUA、施压话术；② 尊重对方、假设善意；\n" +
+        "③ 每条建议后用 [n] 标注证据；④ 若提供了「本次沟通目标」，针对该目标给策略；⑤ 证据不足直说，不编造性格判断。",
+    expects: ["沟通建议"],
+    gapRules: [staleRule],
+    buildPinnedContext: async (scope, stores) => {
+        if (!scope.entity)
+            return undefined;
+        const page = await stores.pages.getPage(scope.entity);
+        const profile = page?.frontmatter?.profile;
+        return profile ? renderProfileBlock(profile) : undefined;
+    },
+};
+//# sourceMappingURL=person-strategy.js.map

package/dist/synth/intents/person-strategy.js.map

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

package/dist/synth/intents/recall.d.ts

@@ -0,0 +1,8 @@
+import type { IntentTemplate } from "../types.js";
+/**
+ * Reference intent shipped by Spec 7 (appendix A).
+ * A general "recall" over an entity / free query / time window, producing a single
+ * concise synthesized answer with inline [n] citations and a stale gap check.
+ */
+export declare const recallIntent: IntentTemplate;
+//# sourceMappingURL=recall.d.ts.map

package/dist/synth/intents/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../../src/synth/intents/recall.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,cAkB1B,CAAC"}

package/dist/synth/intents/recall.js

@@ -0,0 +1,26 @@
+import { staleRule } from "../gaps.js";
+/**
+ * Reference intent shipped by Spec 7 (appendix A).
+ * A general "recall" over an entity / free query / time window, producing a single
+ * concise synthesized answer with inline [n] citations and a stale gap check.
+ */
+export const recallIntent = {
+    id: "recall",
+    format: "single",
+    staleDays: 14,
+    buildScope: (args) => ({
+        entity: args.entity,
+        query: args.query,
+        time: args.time,
+        limit: 30,
+    }),
+    systemPrompt: [
+        "你是用户的工作记忆助手。下面是带编号的记忆片段。",
+        "请用中文写一段简洁、客观的综合回答，概括用户所问范围的情况。",
+        "每个事实性断言后用 [n] 标注来源编号（n 对应片段编号）。",
+        "只使用提供的片段，不要编造未提供的信息；信息不足时直说。",
+    ].join("\n"),
+    expects: [],
+    gapRules: [staleRule],
+};
+//# sourceMappingURL=recall.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recall.js","sourceRoot":"","sources":["../../../src/synth/intents/recall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,EAAE,EAAE,QAAQ;IACZ,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACrB,MAAM,EAAE,IAAI,CAAC,MAA4B;QACzC,KAAK,EAAE,IAAI,CAAC,KAA2B;QACvC,IAAI,EAAE,IAAI,CAAC,IAAgD;QAC3D,KAAK,EAAE,EAAE;KACV,CAAC;IACF,YAAY,EAAE;QACZ,0BAA0B;QAC1B,gCAAgC;QAChC,iCAAiC;QACjC,8BAA8B;KAC/B,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,CAAC,SAAS,CAAC;CACtB,CAAC"}

package/dist/synth/intents/troubleshoot.d.ts

@@ -0,0 +1,11 @@
+import type { IntentTemplate } from "../types.js";
+/**
+ * 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 declare const troubleshootIntent: IntentTemplate;
+//# sourceMappingURL=troubleshoot.d.ts.map

package/dist/synth/intents/troubleshoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshoot.d.ts","sourceRoot":"","sources":["../../../src/synth/intents/troubleshoot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsB,cAAc,EAAE,MAAM,aAAa,CAAC;AAqBtE;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAiChC,CAAC"}