@vortex-os/memory-extended 0.5.1

package/dist/internal/proactive-curator-helpers.js

@@ -0,0 +1,162 @@
+import { existsSync } from "node:fs";
+import { appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+// ── (2) Decline store — verbatim from the curator's `decline-store.ts` ──────
+//
+// Persistence layer for declined and accepted proposals under
+// `<cwd>/data/_proactive-curator/`:
+//   - `declined.json` — keyed by proposal kind + fingerprint; entries expire
+//     after `expiryDays` (default 30), filtered out at read time and purged at
+//     write time.
+//   - `accepted.log` — append-only JSON-lines audit trail.
+// All operations are functional (no in-memory state); last-write-wins on the
+// rare concurrent write.
+const STORE_DIR = "data/_proactive-curator";
+const DECLINED_FILE = "declined.json";
+const ACCEPTED_LOG = "accepted.log";
+const DEFAULT_EXPIRY_DAYS = 30;
+/**
+ * Load the active (un-expired) declined fingerprints. Missing or corrupt store
+ * files return an empty set rather than throwing.
+ */
+export async function loadDeclinedFingerprints(cwd, now) {
+    const parsed = await readDeclinedFile(cwd);
+    if (!parsed)
+        return new Set();
+    const active = new Set();
+    const nowMs = now.getTime();
+    for (const kind of ["capture-insight", "create-hub", "mcp-document"]) {
+        const entries = parsed[kind] ?? {};
+        for (const [fp, entry] of Object.entries(entries)) {
+            if (isActive(entry, nowMs))
+                active.add(fp);
+        }
+    }
+    return active;
+}
+/**
+ * Persist a decline. Purges expired entries from disk in the same write so the
+ * store does not grow unbounded.
+ */
+export async function recordDecline(cwd, args) {
+    await ensureStoreDir(cwd);
+    const existing = (await readDeclinedFile(cwd)) ?? emptyDeclinedFile();
+    const expiryDays = args.expiryDays ?? DEFAULT_EXPIRY_DAYS;
+    const expiresAt = new Date(args.now.getTime() + expiryDays * 24 * 60 * 60 * 1000).toISOString();
+    const updated = {
+        "capture-insight": purgeExpired(existing["capture-insight"], args.now),
+        "create-hub": purgeExpired(existing["create-hub"], args.now),
+        "mcp-document": purgeExpired(existing["mcp-document"], args.now),
+    };
+    const entry = {
+        declinedAt: args.now.toISOString(),
+        topic: args.topic,
+        expiresAt,
+        actionKind: args.actionKind,
+        targetPath: args.targetPath,
+        ...(args.sourceDocs ? { sourceDocs: args.sourceDocs } : {}),
+    };
+    updated[args.kind] = { ...updated[args.kind], [args.fingerprint]: entry };
+    await writeFile(join(cwd, STORE_DIR, DECLINED_FILE), JSON.stringify(updated, null, 2) + "\n", "utf8");
+}
+/**
+ * Append an acceptance record to the audit trail. Newline-delimited JSON so
+ * the file is grep-/tail-friendly without a parser.
+ */
+export async function recordAcceptance(cwd, args) {
+    await ensureStoreDir(cwd);
+    const line = JSON.stringify({
+        acceptedAt: args.now.toISOString(),
+        kind: args.kind,
+        fingerprint: args.fingerprint,
+        topic: args.topic,
+        actionKind: args.actionKind,
+        writtenPath: args.writtenPath,
+    });
+    await appendFile(join(cwd, STORE_DIR, ACCEPTED_LOG), line + "\n", "utf8");
+}
+function isActive(entry, nowMs) {
+    const expiresMs = new Date(entry.expiresAt).getTime();
+    return Number.isFinite(expiresMs) && expiresMs > nowMs;
+}
+// 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) {
+    if (!entries)
+        return {};
+    const out = Object.create(null);
+    const nowMs = now.getTime();
+    for (const [fp, entry] of Object.entries(entries)) {
+        if (DANGEROUS_KEYS.has(fp))
+            continue;
+        if (isActive(entry, nowMs))
+            out[fp] = entry;
+    }
+    return out;
+}
+async function readDeclinedFile(cwd) {
+    const file = join(cwd, STORE_DIR, DECLINED_FILE);
+    if (!existsSync(file))
+        return null;
+    try {
+        const raw = await readFile(file, "utf8");
+        const parsed = JSON.parse(raw);
+        // Backward compatible: an old declined.json predating the `mcp-document`
+        // kind simply lacks that key, so it defaults to an empty record.
+        return {
+            "capture-insight": parsed["capture-insight"] ?? {},
+            "create-hub": parsed["create-hub"] ?? {},
+            "mcp-document": parsed["mcp-document"] ?? {},
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function emptyDeclinedFile() {
+    return { "capture-insight": {}, "create-hub": {}, "mcp-document": {} };
+}
+async function ensureStoreDir(cwd) {
+    await mkdir(join(cwd, STORE_DIR), { recursive: true });
+}
+/**
+ * Reserved filename code points: path separators and the Windows-reserved set,
+ * listed by code so this source carries no literal separator/reserved bytes.
+ * The codes are 60,62,58,34,47,92,124,63,42 = the angle brackets, colon, double
+ * quote, both slashes, pipe, question mark, asterisk. The colon matters on NTFS,
+ * where a name containing it opens an alternate data stream instead of a plain
+ * file. Control characters (code points below 0x20) are rejected separately.
+ */
+const RESERVED_FILENAME_CODES = new Set([60, 62, 58, 34, 47, 92, 124, 63, 42]);
+/**
+ * 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 function assertSafeBasename(name) {
+    const trimmed = (name ?? "").trim();
+    let bad = trimmed.length === 0 || trimmed === "." || trimmed === "..";
+    if (!bad) {
+        for (let i = 0; i < name.length; i++) {
+            const code = name.charCodeAt(i);
+            if (code < 32 || RESERVED_FILENAME_CODES.has(code)) {
+                bad = true;
+                break;
+            }
+        }
+    }
+    if (bad) {
+        throw new Error("Unsafe filename " + JSON.stringify(name) +
+            ": must be a plain basename (no path separators, traversal, control, or reserved characters such as the colon).");
+    }
+}
+//# sourceMappingURL=proactive-curator-helpers.js.map

package/dist/internal/proactive-curator-helpers.js.map

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

package/dist/mcp/document-tools.d.ts

@@ -0,0 +1,144 @@
+export declare const SUGGEST_DOCUMENT_TOOL_NAME = "suggest_document";
+export declare const WRITE_DOCUMENT_TOOL_NAME = "write_document";
+export declare const DECLINE_DOCUMENT_TOOL_NAME = "decline_document";
+export declare const suggestDocumentToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            topic: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const writeDocumentToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            topic: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const declineDocumentToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            topic: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface DocumentArgs {
+    readonly topic: string;
+    readonly name: string;
+    readonly title?: string;
+    readonly content: string;
+    readonly description?: string;
+    readonly tags?: readonly string[];
+}
+export interface DocumentToolDeps {
+    /** Absolute path to the instance data dir (the parent of data/<topic>/). */
+    readonly cwd: string;
+    /** Inject the current date (tests pass a fixed Date; the bin passes new Date()). */
+    readonly now?: Date;
+}
+export interface SuggestResult {
+    readonly ok: boolean;
+    readonly error?: string;
+    readonly fingerprint?: string;
+    readonly targetPath?: string;
+    readonly relPath?: string;
+    readonly alreadyExists?: boolean;
+    readonly previouslyDeclined?: boolean;
+    readonly preview?: string;
+}
+export interface WriteResult {
+    readonly ok: boolean;
+    readonly error?: string;
+    readonly writtenPath?: string;
+    readonly relPath?: string;
+}
+export interface DeclineResult {
+    readonly ok: boolean;
+    readonly error?: string;
+    readonly fingerprint?: string;
+}
+export declare function renderDocumentBody(args: DocumentArgs, now: Date): string;
+export declare function documentFingerprint(relPath: string, body: string): string;
+export declare function declineFingerprint(relPath: string): string;
+/** Build a proposal preview. Writes nothing. */
+export declare function runSuggestDocument(args: DocumentArgs, deps: DocumentToolDeps): Promise<SuggestResult>;
+/** Write the document (create-file; never overwrites) and record acceptance. */
+export declare function runWriteDocument(args: DocumentArgs, deps: DocumentToolDeps): Promise<WriteResult>;
+/** Record a decline so the same suggestion is suppressed for 30 days. */
+export declare function runDeclineDocument(args: {
+    readonly topic: string;
+    readonly name: string;
+    readonly content?: string;
+}, deps: DocumentToolDeps): Promise<DeclineResult>;
+//# sourceMappingURL=document-tools.d.ts.map

package/dist/mcp/document-tools.d.ts.map

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

package/dist/mcp/document-tools.js

@@ -0,0 +1,319 @@
+import { mkdir, writeFile, access } from "node:fs/promises";
+import { join, normalize, sep } from "node:path";
+import { createHash } from "node:crypto";
+/**
+ * Slice 4 — document tools. A PROPOSE-then-write pair for saving content as a
+ * formal knowledge document under `data/<topic>/<name>.md`. This is the only
+ * write-ish MCP surface, and it is deliberately split in two so the boundary
+ * "writes only happen on explicit acceptance" is enforced by tool separation,
+ * not by a flag:
+ *
+ *   - suggest_document: pure. Builds the target path + rendered body + a
+ *     fingerprint, writes NOTHING. Flags if this fingerprint was already
+ *     declined (so the host can avoid re-proposing).
+ *   - write_document: the explicit second step. Writes the file (create-file
+ *     semantics, never overwrites) and records the acceptance.
+ *   - decline_document: records a decline so the same suggestion can be
+ *     suppressed for a while (30-day expiry, via the shared decline store).
+ *
+ * Unlike consolidate/insight proposers, there is NO decision-LLM here: in an
+ * MCP setting the *host* model is the judge — it decides whether to call
+ * suggest, shows the preview to the user, and only calls write on a yes. So
+ * proposal generation is a pure render, not an LLM gate.
+ *
+ * The decline store reuse is intentional: the record/load functions are
+ * stateless and idempotent, so a one-shot MCP tool can call them directly.
+ * They were the proactive-curator decline store; they are now inlined in
+ * `internal/proactive-curator-helpers.ts` so this add-on stays self-contained
+ * (no dependency on a separately published `@vortex-os/proactive-curator`).
+ */
+import { assertSafeBasename, loadDeclinedFingerprints, recordDecline, recordAcceptance, } from "../internal/proactive-curator-helpers.js";
+export const SUGGEST_DOCUMENT_TOOL_NAME = "suggest_document";
+export const WRITE_DOCUMENT_TOOL_NAME = "write_document";
+export const DECLINE_DOCUMENT_TOOL_NAME = "decline_document";
+const PROPOSAL_KIND = "mcp-document";
+export const suggestDocumentToolDefinition = {
+    name: SUGGEST_DOCUMENT_TOOL_NAME,
+    description: "Propose saving content as a formal knowledge document under data/<topic>/<name>.md. " +
+        "Writes NOTHING — returns a preview, the resolved target path, and a fingerprint. " +
+        "Show the preview to the user; only call write_document if they accept. Operational " +
+        "records (memories, decision-log, worklog) are auto-kept elsewhere — this tool is for " +
+        "curating prose into a durable, structured document the user chooses to keep.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            topic: { type: "string", description: "Topic folder under data/ (e.g. 'notes', 'projects/acme')." },
+            name: { type: "string", description: "Document name / filename stem (no .md), e.g. 'onboarding-summary'." },
+            title: { type: "string", description: "Human title for the document (frontmatter + H1)." },
+            content: { type: "string", description: "Markdown body of the document." },
+            description: { type: "string", description: "One-line description for frontmatter." },
+            tags: { type: "array", items: { type: "string" }, description: "Optional frontmatter tags." },
+        },
+        required: ["topic", "name", "content"],
+    },
+};
+export const writeDocumentToolDefinition = {
+    name: WRITE_DOCUMENT_TOOL_NAME,
+    description: "Write a document proposed by suggest_document, AFTER the user has explicitly accepted. " +
+        "Creates data/<topic>/<name>.md with frontmatter (never overwrites an existing file) and " +
+        "records the acceptance. Do not call this without a preceding suggest_document and a user yes.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            topic: { type: "string", description: "Same topic passed to suggest_document." },
+            name: { type: "string", description: "Same name passed to suggest_document." },
+            title: { type: "string", description: "Same title." },
+            content: { type: "string", description: "Same markdown body." },
+            description: { type: "string", description: "Same one-line description." },
+            tags: { type: "array", items: { type: "string" }, description: "Same tags." },
+        },
+        required: ["topic", "name", "content"],
+    },
+};
+export const declineDocumentToolDefinition = {
+    name: DECLINE_DOCUMENT_TOOL_NAME,
+    description: "Record that the user declined a suggest_document proposal, so the same suggestion is " +
+        "suppressed for a while (30-day expiry). Pass the same topic + name.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            topic: { type: "string", description: "Same topic passed to suggest_document." },
+            name: { type: "string", description: "Same name passed to suggest_document." },
+        },
+        required: ["topic", "name"],
+    },
+};
+// ── path safety ──────────────────────────────────────────────────────────────
+// topic/name come from a model; refuse anything that could escape data/ or that
+// contains path separators in the name. Returns an error string or null if ok.
+//
+// The underscore-meta guard checks the NORMALIZED path, not the raw first
+// segment: a raw first-segment check (`topic.split('/')[0]`) is bypassable by a
+// leading `.` (e.g. './_memory' has first segment '.', but join+normalize
+// collapses it to '_memory/…', planting a file in the auto-managed memory SoT
+// dir). Normalizing first closes every '.'/'.//' variant at once.
+/** Non-underscore top-level dirs VortEX maintains structurally — never a doc target. */
+const RESERVED_TOP_DIRS = new Set(["worklog", "decision-log", "runbooks", "hubs"]);
+function validate(args) {
+    const topic = (args.topic ?? "").trim();
+    const name = (args.name ?? "").trim();
+    if (topic.length === 0)
+        return "topic is required";
+    if (name.length === 0)
+        return "name is required";
+    if ((args.content ?? "").trim().length === 0)
+        return "content is required";
+    // The filename must be a safe basename: no separators, control chars, or
+    // Windows-reserved characters (notably the colon, which on NTFS opens an
+    // alternate data stream). assertSafeBasename throws; surface its message.
+    try {
+        assertSafeBasename(name);
+    }
+    catch (e) {
+        return e.message;
+    }
+    // No traversal, no absolute, no backslash/forward escapes.
+    const bad = /(^|[\\/])\.\.([\\/]|$)/;
+    if (bad.test(topic))
+        return `topic must not contain '..': ${topic}`;
+    if (name.includes("/") || name.includes("\\"))
+        return `name must not contain path separators: ${name}`;
+    if (topic.startsWith("/") || topic.startsWith("\\") || /^[a-zA-Z]:/.test(topic))
+        return `topic must be a relative path under data/: ${topic}`;
+    // topic must not reach into the underscore meta dirs (those are auto-managed).
+    // Normalize first so `./_memory`, `.//_memory`, `a/../_memory`, etc. all
+    // collapse to their real on-disk segments before the check.
+    const relNorm = normalize(topic).replace(/\\/g, "/");
+    if (relNorm.startsWith(".."))
+        return `topic must be a relative path under data/: ${topic}`;
+    const segs = relNorm.split("/").filter((s) => s.length > 0 && s !== ".");
+    if (segs.some((s) => s.startsWith("_")))
+        return `topic must not target an auto-managed _ directory: ${topic}`;
+    if (segs.length > 0 && RESERVED_TOP_DIRS.has(segs[0]))
+        return `topic must not target a reserved system directory (${segs[0]}): ${topic}`;
+    return null;
+}
+function ymd(d) {
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, "0");
+    const day = String(d.getDate()).padStart(2, "0");
+    return `${y}-${m}-${day}`;
+}
+function relTarget(topic, name) {
+    // Always forward-slash for the rel path we report/​fingerprint, and normalize
+    // the topic first so the canonical on-disk path is what gets fingerprinted /
+    // decline-bookkept (e.g. './notes' and 'notes' resolve to the same rel path).
+    const canonical = normalize(topic.trim()).replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+$/, "");
+    return `data/${canonical}/${name}.md`;
+}
+function absTarget(cwd, topic, name) {
+    return join(cwd, "data", topic, `${name}.md`);
+}
+export function renderDocumentBody(args, now) {
+    const date = ymd(now);
+    const title = (args.title ?? args.name).trim();
+    const desc = (args.description ?? "").trim();
+    const tags = ["document", ...(args.tags ?? [])];
+    const fm = [
+        "---",
+        `title: ${title}`,
+        desc ? `description: ${desc}` : null,
+        "type: document",
+        `created: ${date}`,
+        `updated: ${date}`,
+        `tags: [${tags.join(", ")}]`,
+        "---",
+    ]
+        .filter((l) => l !== null)
+        .join("\n");
+    return `${fm}\n\n# ${title}\n\n${args.content.trim()}\n`;
+}
+export function documentFingerprint(relPath, body) {
+    return createHash("sha256").update(`${relPath}\n${body}`).digest("hex").slice(0, 16);
+}
+// Coarser, path-level key for declines. A decline can't see the body (content
+// may not be re-sent), so both the recorded decline and the suggest-side
+// suppression check key off the rel path alone — they MUST stay identical, so
+// they share this one helper.
+export function declineFingerprint(relPath) {
+    return createHash("sha256").update(relPath).digest("hex").slice(0, 16);
+}
+async function exists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// The shared decline store, inlined in `internal/proactive-curator-helpers.ts`.
+// These functions are now always present (no separate package to resolve), so
+// this returns them directly. The signature still returns the object (rather
+// than the functions inline) so the call sites keep their best-effort try/catch
+// wrappers unchanged — the propose/write flow never depends on the store, and a
+// runtime fs error in decline-bookkeeping is still swallowed at the call site.
+//
+// `recordDecline` / `recordAcceptance` are called with `kind: "mcp-document"`,
+// which is now a tracked `ProposalKind`. The loose `Record<string, unknown>`
+// arg type still preserves the original call boundary (the prior lazy import
+// cast to the same loose shape). As of FIX M3 the `mcp-document` decline IS
+// read back by `loadDeclinedFingerprints` (it scans all three kinds), so a
+// recorded decline actually suppresses a later matching suggest.
+function loadDeclineStore() {
+    return {
+        loadDeclinedFingerprints,
+        recordDecline: recordDecline,
+        recordAcceptance: recordAcceptance,
+    };
+}
+/** Build a proposal preview. Writes nothing. */
+export async function runSuggestDocument(args, deps) {
+    const err = validate(args);
+    if (err)
+        return { ok: false, error: err };
+    const now = deps.now ?? new Date();
+    const rel = relTarget(args.topic, args.name);
+    const body = renderDocumentBody(args, now);
+    const fingerprint = documentFingerprint(rel, body);
+    const abs = absTarget(deps.cwd, args.topic.trim(), args.name.trim());
+    // runDeclineDocument can't know the body (content may not be re-sent on a
+    // decline), so it records a rel-ONLY fingerprint. Match it on the suggest
+    // side with the SAME key so a prior decline suppresses this suggestion. We
+    // also keep the body-based fingerprint check (a decline made with the full
+    // rel+body fingerprint, were one ever recorded, still matches).
+    const declineKey = declineFingerprint(rel);
+    let previouslyDeclined = false;
+    const store = loadDeclineStore();
+    try {
+        const declined = await store.loadDeclinedFingerprints(deps.cwd, now);
+        previouslyDeclined = declined.has(fingerprint) || declined.has(declineKey);
+    }
+    catch {
+        /* best-effort: a decline-store read error must not block the preview */
+    }
+    return {
+        ok: true,
+        fingerprint,
+        targetPath: abs,
+        relPath: rel,
+        alreadyExists: await exists(abs),
+        previouslyDeclined,
+        preview: body,
+    };
+}
+/** Write the document (create-file; never overwrites) and record acceptance. */
+export async function runWriteDocument(args, deps) {
+    const err = validate(args);
+    if (err)
+        return { ok: false, error: err };
+    const now = deps.now ?? new Date();
+    const rel = relTarget(args.topic, args.name);
+    const body = renderDocumentBody(args, now);
+    const abs = absTarget(deps.cwd, args.topic.trim(), args.name.trim());
+    // Defense-in-depth: confirm the resolved absolute path stays under data/.
+    const dataRoot = normalize(join(deps.cwd, "data")) + sep;
+    if (!(normalize(abs) + sep).startsWith(dataRoot)) {
+        return { ok: false, error: `resolved path escapes data/: ${abs}` };
+    }
+    if (await exists(abs)) {
+        return { ok: false, error: `file already exists (refusing to overwrite): ${rel}` };
+    }
+    await mkdir(join(deps.cwd, "data", args.topic.trim()), { recursive: true });
+    // Exclusive create — close the check-then-write race (another writer could
+    // land between the exists() check above and here). EEXIST maps to the same
+    // clean "refusing to overwrite" result the pre-check returns.
+    try {
+        await writeFile(abs, body, { encoding: "utf8", flag: "wx" });
+    }
+    catch (e) {
+        if (e.code === "EEXIST") {
+            return { ok: false, error: `file already exists (refusing to overwrite): ${rel}` };
+        }
+        throw e;
+    }
+    const store = loadDeclineStore();
+    try {
+        await store.recordAcceptance(deps.cwd, {
+            kind: PROPOSAL_KIND,
+            fingerprint: documentFingerprint(rel, body),
+            topic: args.topic.trim(),
+            actionKind: "create-file",
+            writtenPath: abs,
+            now,
+        });
+    }
+    catch {
+        /* acceptance log is best-effort */
+    }
+    return { ok: true, writtenPath: abs, relPath: rel };
+}
+/** Record a decline so the same suggestion is suppressed for 30 days. */
+export async function runDeclineDocument(args, deps) {
+    const topic = (args.topic ?? "").trim();
+    const name = (args.name ?? "").trim();
+    if (topic.length === 0 || name.length === 0)
+        return { ok: false, error: "topic and name are required" };
+    const now = deps.now ?? new Date();
+    const rel = relTarget(topic, name);
+    // Fingerprint over rel path only here (content may not be re-sent on decline);
+    // suggest fingerprints over rel+body, so decline is a coarser path-level guard.
+    // Shared helper with the suggest-side check so the two keys never drift.
+    const fingerprint = declineFingerprint(rel);
+    const store = loadDeclineStore();
+    try {
+        await store.recordDecline(deps.cwd, {
+            kind: PROPOSAL_KIND,
+            fingerprint,
+            topic,
+            actionKind: "create-file",
+            targetPath: rel,
+            now,
+        });
+    }
+    catch (e) {
+        return { ok: false, error: e.message };
+    }
+    return { ok: true, fingerprint };
+}
+//# sourceMappingURL=document-tools.js.map

package/dist/mcp/document-tools.js.map

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