@vortex-os/memory-extended 0.5.1

package/dist/consolidate/query.js

@@ -0,0 +1,40 @@
+/**
+ * Pull the recently-ingested sessions together with their event bodies.
+ * Sessions with zero text events are dropped — they cannot drive a memory
+ * proposal, and feeding them to the LLM only wastes tokens.
+ */
+export function collectRecentSessions(store, options) {
+    const metas = store.listSessions({
+        ...(options?.sinceMs !== undefined ? { sinceMs: options.sinceMs } : {}),
+        ...(options?.limit !== undefined ? { limit: options.limit } : {}),
+    });
+    const out = [];
+    for (const m of metas) {
+        const events = store.readSessionEvents(m.host, m.sessionId);
+        if (events.some((e) => (e.text ?? "").trim().length > 0)) {
+            out.push({ metadata: m, events });
+        }
+    }
+    return out;
+}
+/**
+ * Render an archived session as a compact transcript for an LLM prompt.
+ * Empty / tool-call-only events are dropped (they rarely carry the kind
+ * of insight worth promoting to memory); the remaining events are joined
+ * with `[<role>]` prefixes for the LLM to follow turn boundaries.
+ */
+export function renderSessionForPrompt(session) {
+    const lines = [];
+    const header = session.metadata.startedAt
+        ? `Session ${session.metadata.host}/${session.metadata.sessionId} (started ${session.metadata.startedAt})`
+        : `Session ${session.metadata.host}/${session.metadata.sessionId}`;
+    lines.push(`# ${header}`);
+    for (const ev of session.events) {
+        const text = (ev.text ?? "").trim();
+        if (!text)
+            continue;
+        lines.push(`[${ev.kind}#${ev.idx}] ${text}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=query.js.map

package/dist/consolidate/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/consolidate/query.ts"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAA0B,EAC1B,OAAgC;IAEhC,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC;QAC/B,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC,CAAC;IACH,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAwB;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS;QACvC,CAAC,CAAC,WAAW,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,aAAa,OAAO,CAAC,QAAQ,CAAC,SAAS,GAAG;QAC1G,CAAC,CAAC,WAAW,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;IAC1B,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/consolidate/store.d.ts

@@ -0,0 +1,21 @@
+export interface RejectedEntry {
+    readonly rejectedAt: string;
+    /** Memory candidate name at the time of rejection — for audit display only. */
+    readonly candidateName: string;
+    readonly expiresAt: string;
+}
+export declare function loadRejectedFingerprints(cwd: string, now: Date): Promise<ReadonlySet<string>>;
+export declare function recordRejection(cwd: string, args: {
+    readonly fingerprint: string;
+    readonly candidateName: string;
+    readonly now: Date;
+    readonly expiryDays?: number;
+}): Promise<void>;
+export declare function recordAcceptance(cwd: string, args: {
+    readonly fingerprint: string;
+    readonly candidateName: string;
+    readonly writtenPath: string;
+    readonly now: Date;
+}): Promise<void>;
+export declare function resetRejected(cwd: string): Promise<void>;
+//# sourceMappingURL=store.d.ts.map

package/dist/consolidate/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/consolidate/store.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAMD,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAU9B;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IACJ,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,GACA,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IACJ,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;CACpB,GACA,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9D"}

package/dist/consolidate/store.js

@@ -0,0 +1,91 @@
+import { existsSync } from "node:fs";
+import { appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * Persistence for the consolidate namespace — mirrors the
+ * proactive-curator decline store but lives under its own directory so
+ * the two surfaces never collide on a fingerprint.
+ *
+ * Layout under `<cwd>/data/_session-archive/consolidate/`:
+ *   rejected.json   — keyed by candidate fingerprint; expires after N days
+ *   accepted.log    — JSONL audit trail of accepted candidates
+ */
+const STORE_DIR = "data/_session-archive/consolidate";
+const REJECTED_FILE = "rejected.json";
+const ACCEPTED_LOG = "accepted.log";
+const DEFAULT_EXPIRY_DAYS = 30;
+export async function loadRejectedFingerprints(cwd, now) {
+    const parsed = await readRejectedFile(cwd);
+    if (!parsed)
+        return new Set();
+    const active = new Set();
+    const nowMs = now.getTime();
+    for (const [fp, entry] of Object.entries(parsed)) {
+        const expiresMs = new Date(entry.expiresAt).getTime();
+        if (Number.isFinite(expiresMs) && expiresMs > nowMs)
+            active.add(fp);
+    }
+    return active;
+}
+export async function recordRejection(cwd, args) {
+    await ensureStoreDir(cwd);
+    const existing = (await readRejectedFile(cwd)) ?? {};
+    const expiryDays = args.expiryDays ?? DEFAULT_EXPIRY_DAYS;
+    const expiresAt = new Date(args.now.getTime() + expiryDays * 24 * 60 * 60 * 1000).toISOString();
+    const updated = purgeExpired(existing, args.now);
+    updated[args.fingerprint] = {
+        rejectedAt: args.now.toISOString(),
+        candidateName: args.candidateName,
+        expiresAt,
+    };
+    await writeFile(join(cwd, STORE_DIR, REJECTED_FILE), JSON.stringify(updated, null, 2) + "\n", "utf8");
+}
+export async function recordAcceptance(cwd, args) {
+    await ensureStoreDir(cwd);
+    const line = JSON.stringify({
+        acceptedAt: args.now.toISOString(),
+        fingerprint: args.fingerprint,
+        candidateName: args.candidateName,
+        writtenPath: args.writtenPath,
+    });
+    await appendFile(join(cwd, STORE_DIR, ACCEPTED_LOG), line + "\n", "utf8");
+}
+export async function resetRejected(cwd) {
+    const file = join(cwd, STORE_DIR, REJECTED_FILE);
+    if (!existsSync(file))
+        return;
+    await writeFile(file, JSON.stringify({}, null, 2) + "\n", "utf8");
+}
+// Fingerprints are file-derived keys parsed from JSON on disk; a crafted file
+// could carry `__proto__`/`constructor`/`prototype` keys. Build the accumulator
+// with a null prototype and skip those keys — belt-and-suspenders against
+// prototype pollution when rebuilding the store.
+const DANGEROUS_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+function purgeExpired(entries, now) {
+    const out = Object.create(null);
+    const nowMs = now.getTime();
+    for (const [fp, entry] of Object.entries(entries)) {
+        if (DANGEROUS_KEYS.has(fp))
+            continue;
+        const expiresMs = new Date(entry.expiresAt).getTime();
+        if (Number.isFinite(expiresMs) && expiresMs > nowMs)
+            out[fp] = entry;
+    }
+    return out;
+}
+async function readRejectedFile(cwd) {
+    const file = join(cwd, STORE_DIR, REJECTED_FILE);
+    if (!existsSync(file))
+        return null;
+    try {
+        const raw = await readFile(file, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function ensureStoreDir(cwd) {
+    await mkdir(join(cwd, STORE_DIR), { recursive: true });
+}
+//# sourceMappingURL=store.js.map

package/dist/consolidate/store.js.map

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

package/dist/consolidate/types.d.ts

@@ -0,0 +1,68 @@
+import type { AcceptResult, Proposal, ProposalAction } from "../internal/proactive-curator-helpers.js";
+/**
+ * Memory candidate extracted from past sessions. Mirrors the `_memory/*.md`
+ * frontmatter shape so the accepted candidate can be written through the
+ * base `memorySystem` API without further transformation.
+ *
+ * `sourceExcerptIds` carries the (host, sessionId, eventIdx) triples that
+ * justified the proposal. The host displays these so the operator can
+ * verify the source before accepting.
+ */
+export interface MemoryCandidate {
+    /** Slug-safe name — becomes `_memory/<name>.md`. */
+    readonly name: string;
+    /** One-line description for the memory's frontmatter `description` field. */
+    readonly description: string;
+    /** Memory type: "user" | "feedback" | "project" | "reference". */
+    readonly type: string;
+    /** Body content (markdown, no frontmatter — the writer adds the header). */
+    readonly body: string;
+    /** Source events that justified this candidate (audit trail). */
+    readonly sourceExcerptIds: readonly SourceExcerptId[];
+}
+/**
+ * Identifier of a single event inside a session — the smallest addressable
+ * unit a consolidate proposal can cite. Sticking to (host, sessionId,
+ * eventIdx) keeps the citation stable across re-ingest as long as the
+ * source files have not been deleted from `_session-archive/normalized/`.
+ */
+export interface SourceExcerptId {
+    readonly host: string;
+    readonly sessionId: string;
+    readonly eventIdx: number;
+}
+/**
+ * Consolidate proposal — the proactive-curator `Proposal` shape specialized
+ * for the consolidate kind. `action` is always `create-file` with
+ * `folderPath: "_memory"` and `filename: "<candidate.name>.md"`; this lets
+ * the same `/curate`-style host UX render the proposal without a separate
+ * code path.
+ */
+export interface ConsolidateProposal extends Proposal {
+    readonly kind: "consolidate-memory";
+    readonly action: Extract<ProposalAction, {
+        kind: "create-file";
+    }>;
+    /** Full candidate — kept on the proposal so hosts can show structured info beyond `preview`. */
+    readonly candidate: MemoryCandidate;
+}
+/**
+ * Result returned by a consolidate proposal's `onAccept`.
+ */
+export interface ConsolidateAcceptResult extends AcceptResult {
+    readonly actionApplied: "create-file";
+}
+/**
+ * Options accepted by {@link Consolidator}. All fields are optional.
+ */
+export interface ConsolidatorOptions {
+    /** Look back this many days when no explicit `sinceMs` is provided. Default 7. */
+    readonly defaultLookbackDays?: number;
+    /** Cap the number of sessions fed into one LLM call. Default 20. */
+    readonly maxSessionsPerRun?: number;
+    /** Cap the number of candidates the LLM may propose per run. Default 5. */
+    readonly maxCandidatesPerRun?: number;
+    /** Days after which a rejected candidate becomes eligible to re-surface. Default 30. */
+    readonly rejectionExpiryDays?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/consolidate/types.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EACR,cAAc,EACf,MAAM,0CAA0C,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,gBAAgB,EAAE,SAAS,eAAe,EAAE,CAAC;CACvD;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,QAAQ;IACnD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE;QAAE,IAAI,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IAClE,gGAAgG;IAChG,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kFAAkF;IAClF,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,oEAAoE;IACpE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,2EAA2E;IAC3E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,wFAAwF;IACxF,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC"}

package/dist/consolidate/types.js

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

package/dist/consolidate/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * as sessionArchive from "./sessionArchive/index.js";
+export * as consolidate from "./consolidate/index.js";
+export * as sqlite from "./sqlite/index.js";
+export * as vector from "./vector/index.js";
+export * as recall from "./recall/index.js";
+export * as mcp from "./mcp/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,WAAW,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * as sessionArchive from "./sessionArchive/index.js";
+export * as consolidate from "./consolidate/index.js";
+export * as sqlite from "./sqlite/index.js";
+export * as vector from "./vector/index.js";
+export * as recall from "./recall/index.js";
+export * as mcp from "./mcp/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,WAAW,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}

package/dist/internal/frontmatter.d.ts

@@ -0,0 +1,6 @@
+export interface FrontmatterDoc<T> {
+    readonly frontmatter: T;
+    readonly body: string;
+}
+export declare function parseFrontmatter<T = Record<string, unknown>>(source: string): FrontmatterDoc<T>;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/internal/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/internal/frontmatter.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,MAAM,EAAE,MAAM,GACb,cAAc,CAAC,CAAC,CAAC,CAkBnB"}

package/dist/internal/frontmatter.js

@@ -0,0 +1,38 @@
+import { parse as parseYaml } from "yaml";
+/**
+ * Inlined YAML-frontmatter parser (Phase 11c follow-up, 2026-05-29).
+ *
+ * memory-extended ships as a public add-on (`base` + add-ons is the intended
+ * public surface). It previously imported `parseFrontmatter` from the
+ * internal `@vortex-os/core` package, which forced `core` onto the public
+ * registry just to satisfy the import. To keep `core` private, the single
+ * helper memory-extended needs is inlined here — the add-on is now
+ * self-contained (only `yaml` is an external dependency).
+ *
+ * Behavior mirrors `@vortex-os/core`'s `parseFrontmatter`: BOM-safe, returns
+ * empty frontmatter + the source unchanged when no fence is present, and
+ * tolerates a malformed fence by treating it as no frontmatter.
+ */
+const FENCE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+const BOM = "";
+export function parseFrontmatter(source) {
+    const cleaned = source.startsWith(BOM) ? source.slice(1) : source;
+    const match = cleaned.match(FENCE);
+    if (!match) {
+        return { frontmatter: {}, body: cleaned };
+    }
+    const yaml = match[1] ?? "";
+    const body = cleaned.slice(match[0].length);
+    let parsed;
+    try {
+        parsed = (parseYaml(yaml) ?? {});
+    }
+    catch {
+        // Fence present but its YAML body did not parse (copy/paste artifacts,
+        // a stray mid-document `---`, etc.). Treat as no frontmatter so callers
+        // can still read the body; the fence content is discarded.
+        parsed = {};
+    }
+    return { frontmatter: parsed, body };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/internal/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/internal/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,KAAK,GAAG,mCAAmC,CAAC;AAClD,MAAM,GAAG,GAAG,GAAG,CAAC;AAOhB,MAAM,UAAU,gBAAgB,CAC9B,MAAc;IAEd,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAClE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,WAAW,EAAE,EAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACjD,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAS,CAAC;IACd,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAM,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,wEAAwE;QACxE,2DAA2D;QAC3D,MAAM,GAAG,EAAO,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC"}

package/dist/internal/proactive-curator-helpers.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Inlined proactive-curator helpers (self-contained add-on, 2026-05-31).
+ *
+ * memory-extended ships as a public add-on (`base` + add-ons is the intended
+ * public surface). The `consolidate` namespace and the `mcp` document tools
+ * previously reached into the private `@vortex-os/proactive-curator` package
+ * — `consolidate` for its proposal/judge TYPES, the document tools for its
+ * stateless decline-store FUNCTIONS — which forced `proactive-curator` onto
+ * the public registry just to satisfy those imports. To keep that package
+ * private, the small surface memory-extended actually uses is inlined here.
+ * The add-on stays standalone-capable: nothing here depends on a separately
+ * published `@vortex-os/proactive-curator`, and the only runtime imports are
+ * Node builtins (`node:fs`, `node:path`).
+ *
+ * Mirrors the precedent in `internal/frontmatter.ts`, which inlined the one
+ * `@vortex-os/core` helper this package needed for the same reason.
+ *
+ * Two parts:
+ *   (1) Type/interface definitions — structurally identical to the curator's
+ *       (`Proposal`, `ProposalAction`, `AcceptResult`, `LLMJudge`,
+ *       `ExpectedShape`). TypeScript is structural, so a host that holds the
+ *       real curator objects stays assignable to these copies and vice-versa.
+ *   (2) The decline store — `loadDeclinedFingerprints` / `recordDecline` /
+ *       `recordAcceptance`. These are stateless and idempotent (no in-memory
+ *       state; each call reads/writes `data/_proactive-curator/` afresh), so a
+ *       one-shot MCP tool can call them directly. Behavior is copied verbatim
+ *       from the curator, including the prototype-pollution guard and the
+ *       expire-on-read / purge-on-write semantics. Only the three functions
+ *       memory-extended uses are inlined; the curator's `resetDeclined` and
+ *       its insight/hub proposers are deliberately NOT brought along.
+ */
+/**
+ * Host-supplied LLM adapter. Single-shot: a prompt plus a JSON-shaped
+ * expected answer in, a structured (runtime-validated) answer out. Structural
+ * copy of the curator's `LLMJudge` so a host's real judge stays compatible.
+ */
+export interface LLMJudge {
+    readonly host: string;
+    ask(prompt: string, expected: ExpectedShape): Promise<unknown>;
+}
+/**
+ * Shape descriptor for the expected LLM response. `"string"` for a free-form
+ * answer; `"json"` for a JSON value matching a best-effort `schema` descriptor
+ * (the caller still runtime-validates). Structural copy of the curator type.
+ */
+export type ExpectedShape = {
+    readonly shape: "string";
+} | {
+    readonly shape: "json";
+    readonly schema: unknown;
+};
+/**
+ * Placement action chosen by a proposer. Four kinds cover the capture
+ * lifecycle. All paths are `data/`-relative so proposals never embed absolute
+ * paths. Structural copy of the curator's `ProposalAction` union.
+ */
+export type ProposalAction = {
+    readonly kind: "create-folder";
+    readonly folderPath: string;
+    readonly filename: string;
+    readonly body: string;
+} | {
+    readonly kind: "create-file";
+    readonly folderPath: string;
+    readonly filename: string;
+    readonly body: string;
+} | {
+    readonly kind: "append-section";
+    readonly filePath: string;
+    readonly sectionHeader: string;
+    readonly body: string;
+} | {
+    readonly kind: "update-file";
+    readonly filePath: string;
+    readonly body: string;
+    readonly reason: string;
+};
+/**
+ * A single proposal handed to the host for the user to accept or decline.
+ * `onAccept` / `onDecline` are thunks captured at evaluation time. Structural
+ * copy of the curator's `Proposal`; the consolidate namespace specializes it.
+ */
+export interface Proposal {
+    readonly kind: string;
+    readonly fingerprint: string;
+    readonly action: ProposalAction;
+    readonly preview: string;
+    readonly rationale: string;
+    readonly sourceRefs: readonly string[];
+    readonly onAccept: () => Promise<AcceptResult>;
+    readonly onDecline: () => Promise<void>;
+}
+/**
+ * Result returned by {@link Proposal.onAccept}. Structural copy of the
+ * curator's `AcceptResult`.
+ */
+export interface AcceptResult {
+    readonly writtenPath: string;
+    readonly actionApplied: ProposalAction["kind"];
+    readonly nextActionHint?: string;
+}
+/**
+ * Proposal kinds tracked in the declined-file structure. `capture-insight` and
+ * `create-hub` are the curator's own kinds; `mcp-document` is the document
+ * tools' kind. All three are persisted AND read back by
+ * {@link loadDeclinedFingerprints} so a recorded decline actually suppresses a
+ * later matching suggestion for the expiry window.
+ *
+ * (Historically `mcp-document` was written but never read back — see FIX M3 —
+ * which silently broke the document-tool 30-day suppression. It is now a
+ * first-class tracked kind.)
+ */
+export type ProposalKind = "capture-insight" | "create-hub" | "mcp-document";
+export interface DeclinedEntry {
+    /** ISO-8601 timestamp of when the user declined. */
+    readonly declinedAt: string;
+    /** Topic slug at decline time (audit trail; not part of the fingerprint). */
+    readonly topic: string;
+    /** ISO-8601 timestamp after which this entry is eligible for re-evaluation. */
+    readonly expiresAt: string;
+    /** The action the user declined — `create-file`, `append-section`, etc. */
+    readonly actionKind: ProposalAction["kind"];
+    /** Target path the declined action would have written/touched (data-relative). */
+    readonly targetPath: string;
+    /** Hub proposals only — the source-doc cluster that triggered this proposal. */
+    readonly sourceDocs?: readonly string[];
+}
+/**
+ * Load the active (un-expired) declined fingerprints. Missing or corrupt store
+ * files return an empty set rather than throwing.
+ */
+export declare function loadDeclinedFingerprints(cwd: string, now: Date): Promise<ReadonlySet<string>>;
+/**
+ * Persist a decline. Purges expired entries from disk in the same write so the
+ * store does not grow unbounded.
+ */
+export declare function recordDecline(cwd: string, args: {
+    readonly kind: ProposalKind;
+    readonly fingerprint: string;
+    readonly topic: string;
+    readonly actionKind: ProposalAction["kind"];
+    readonly targetPath: string;
+    readonly sourceDocs?: readonly string[];
+    readonly now: Date;
+    readonly expiryDays?: number;
+}): Promise<void>;
+/**
+ * Append an acceptance record to the audit trail. Newline-delimited JSON so
+ * the file is grep-/tail-friendly without a parser.
+ */
+export declare function recordAcceptance(cwd: string, args: {
+    readonly kind: ProposalKind;
+    readonly fingerprint: string;
+    readonly topic: string;
+    readonly actionKind: ProposalAction["kind"];
+    readonly writtenPath: string;
+    readonly now: Date;
+}): Promise<void>;
+/**
+ * Assert that `name` is a safe plain basename: non-empty, not "." or "..", and
+ * free of path separators, control characters, and Windows-reserved characters.
+ *
+ * Used at write boundaries where the destination FOLDER is a trusted constant
+ * (e.g. consolidate's fixed `_memory/` dir, which the canonical path gate
+ * rejects as a system dir, so containment relies on the basename instead). A
+ * denylist, not an ASCII allowlist, so non-Latin names (e.g. Korean) still
+ * pass. Throws a clear Error. Inlined here to keep the add-on standalone — see
+ * the file header.
+ */
+export declare function assertSafeBasename(name: string): void;
+//# sourceMappingURL=proactive-curator-helpers.d.ts.map

package/dist/internal/proactive-curator-helpers.d.ts.map

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