agent-bober 0.18.0 → 0.19.0

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
 export { Logger, logger, type LogLevel } from "./logger.js";
-export { getCurrentBranch, createBranch, commitAll, getChangedFiles, getDiff, stashAndRestore, hasUncommittedChanges, } from "./git.js";
+export { getCurrentBranch, createBranch, commitAll, getChangedFiles, getDiff, hasUncommittedChanges, } from "./git.js";
 export { fileExists, readJson, writeJson, ensureDir, findProjectRoot, } from "./fs.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,OAAO,EACP,eAAe,EACf,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,SAAS,EACT,eAAe,GAChB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,OAAO,EACP,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,SAAS,EACT,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/utils/index.js

@@ -1,4 +1,4 @@
 export { Logger, logger } from "./logger.js";
-export { getCurrentBranch, createBranch, commitAll, getChangedFiles, getDiff, stashAndRestore, hasUncommittedChanges, } from "./git.js";
+export { getCurrentBranch, createBranch, commitAll, getChangedFiles, getDiff, hasUncommittedChanges, } from "./git.js";
 export { fileExists, readJson, writeJson, ensureDir, findProjectRoot, } from "./fs.js";
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,OAAO,EACP,eAAe,EACf,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,SAAS,EACT,eAAe,GAChB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,OAAO,EACP,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,SAAS,EACT,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/vault/conventions.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Vault conventions — canonical Dataview frontmatter status values and the
+ * gitignored attachments directory name. Single source of truth so the reindex
+ * path and downstream domains share ONE definition (no per-file duplicates).
+ *
+ * PURE: constants only — no fs, no clock, no network, no logic.
+ *
+ * bober: ATTACHMENTS_DIR names the binary-attachment convention but does NOT
+ *        enforce it at runtime (no mkdir, no .gitignore write) — documentation only.
+ *        Swap for a runtime guard if the evaluator ever requires enforcement.
+ */
+import type { NoteStatus } from "./types.js";
+/** Frontmatter status for a live note included in the active FactStore index. */
+export declare const ACTIVE_STATUS: NoteStatus;
+/** Frontmatter status that excludes a note from the active index (reindex skip). */
+export declare const SUPERSEDED_STATUS: NoteStatus;
+/**
+ * Vault subdirectory holding binary attachments (images, PDFs, etc.).
+ * Binary attachments stay OUT of git — add this directory to .gitignore.
+ * Convention only — nothing is auto-created or enforced at runtime.
+ */
+export declare const ATTACHMENTS_DIR: "attachments";
+//# sourceMappingURL=conventions.d.ts.map

package/dist/vault/conventions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventions.d.ts","sourceRoot":"","sources":["../../src/vault/conventions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,iFAAiF;AACjF,eAAO,MAAM,aAAa,EAAE,UAAqB,CAAC;AAElD,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,EAAE,UAAyB,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAG,aAAsB,CAAC"}

package/dist/vault/conventions.js

@@ -0,0 +1,22 @@
+/**
+ * Vault conventions — canonical Dataview frontmatter status values and the
+ * gitignored attachments directory name. Single source of truth so the reindex
+ * path and downstream domains share ONE definition (no per-file duplicates).
+ *
+ * PURE: constants only — no fs, no clock, no network, no logic.
+ *
+ * bober: ATTACHMENTS_DIR names the binary-attachment convention but does NOT
+ *        enforce it at runtime (no mkdir, no .gitignore write) — documentation only.
+ *        Swap for a runtime guard if the evaluator ever requires enforcement.
+ */
+/** Frontmatter status for a live note included in the active FactStore index. */
+export const ACTIVE_STATUS = "active";
+/** Frontmatter status that excludes a note from the active index (reindex skip). */
+export const SUPERSEDED_STATUS = "superseded";
+/**
+ * Vault subdirectory holding binary attachments (images, PDFs, etc.).
+ * Binary attachments stay OUT of git — add this directory to .gitignore.
+ * Convention only — nothing is auto-created or enforced at runtime.
+ */
+export const ATTACHMENTS_DIR = "attachments";
+//# sourceMappingURL=conventions.js.map

package/dist/vault/conventions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventions.js","sourceRoot":"","sources":["../../src/vault/conventions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,iFAAiF;AACjF,MAAM,CAAC,MAAM,aAAa,GAAe,QAAQ,CAAC;AAElD,oFAAoF;AACpF,MAAM,CAAC,MAAM,iBAAiB,GAAe,YAAY,CAAC;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,aAAsB,CAAC"}

package/dist/vault/frontmatter.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Frontmatter parse / serialize — PURE functions for Obsidian YAML frontmatter.
+ *
+ * Covers the documented Dataview conventions:
+ *   - string scalars (unquoted)
+ *   - number scalars (integer or float, including negative)
+ *   - ISO-8601 date strings — kept as strings, never coerced to Date
+ *   - block-style lists (`- item` under the key line)
+ *   - inline-style lists (`[a, b, c]`)
+ *   - status enum strings (e.g. "active", "superseded") — just strings
+ *
+ * PURE: Never calls Date.now() or new Date() — no clock dependency.
+ *       Never touches the filesystem — no fs or network imports.
+ *
+ * bober: hand-rolled YAML subset — covers the six Dataview scalar/list
+ *        conventions documented above. Quoted strings, nested objects, and
+ *        multi-line scalars are NOT supported. Swap for a vetted YAML library
+ *        if those are needed.
+ */
+import type { VaultNote } from "./types.js";
+/**
+ * Parse the leading YAML frontmatter block and return the structured
+ * frontmatter together with the verbatim body that follows.
+ *
+ * If the input does not begin with `---`, returns `{ frontmatter: {}, body: raw }`.
+ */
+export declare function parseFrontmatter(raw: string): {
+    frontmatter: Record<string, unknown>;
+    body: string;
+};
+/**
+ * Serialize a frontmatter object and body back to a complete note string.
+ *
+ * Produces `---\n<yaml>\n---\n<body>`. Array values are serialized as
+ * block-style lists (one `  - item` line per element).
+ */
+export declare function serializeFrontmatter(frontmatter: Record<string, unknown>, body: string): string;
+/**
+ * Parse a raw note string into a `VaultNote`.
+ * The `path` parameter is stored verbatim — no filesystem access occurs here.
+ */
+export declare function parseNote(raw: string, path: string): VaultNote;
+/**
+ * Serialize a `VaultNote` back to a raw string suitable for writing to disk.
+ */
+export declare function serializeNote(note: VaultNote): string;
+//# sourceMappingURL=frontmatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/vault/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA0B5C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC7C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd,CA+EA;AAID;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,MAAM,CAgBR;AAID;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAG9D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAErD"}

package/dist/vault/frontmatter.js

@@ -0,0 +1,149 @@
+/**
+ * Frontmatter parse / serialize — PURE functions for Obsidian YAML frontmatter.
+ *
+ * Covers the documented Dataview conventions:
+ *   - string scalars (unquoted)
+ *   - number scalars (integer or float, including negative)
+ *   - ISO-8601 date strings — kept as strings, never coerced to Date
+ *   - block-style lists (`- item` under the key line)
+ *   - inline-style lists (`[a, b, c]`)
+ *   - status enum strings (e.g. "active", "superseded") — just strings
+ *
+ * PURE: Never calls Date.now() or new Date() — no clock dependency.
+ *       Never touches the filesystem — no fs or network imports.
+ *
+ * bober: hand-rolled YAML subset — covers the six Dataview scalar/list
+ *        conventions documented above. Quoted strings, nested objects, and
+ *        multi-line scalars are NOT supported. Swap for a vetted YAML library
+ *        if those are needed.
+ */
+// ── Scalar parsing ──────────────────────────────────────────────────
+/** Matches an integer or float (with optional leading minus), no surrounding dashes. */
+const NUM_REGEX = /^-?\d+(\.\d+)?$/;
+/** Matches an inline YAML list: `[item1, item2, ...]`. */
+const INLINE_LIST_REGEX = /^\[(.+)\]$/;
+/** Matches a block list item line: optional leading whitespace then `- `. */
+const BLOCK_ITEM_REGEX = /^\s+-\s/;
+/**
+ * Parse a raw scalar string (already trimmed) to its typed value.
+ * Number stays numeric; everything else stays a string.
+ */
+function parseScalar(raw) {
+    if (NUM_REGEX.test(raw)) {
+        return Number(raw);
+    }
+    return raw;
+}
+// ── YAML frontmatter parser ─────────────────────────────────────────
+/**
+ * Parse the leading YAML frontmatter block and return the structured
+ * frontmatter together with the verbatim body that follows.
+ *
+ * If the input does not begin with `---`, returns `{ frontmatter: {}, body: raw }`.
+ */
+export function parseFrontmatter(raw) {
+    const lines = raw.split("\n");
+    if (lines[0]?.trim() !== "---") {
+        return { frontmatter: {}, body: raw };
+    }
+    // Find the closing `---` delimiter (must be at least line 1).
+    let closingIdx = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === "---") {
+            closingIdx = i;
+            break;
+        }
+    }
+    if (closingIdx === -1) {
+        // No closing delimiter — treat the whole content as body.
+        return { frontmatter: {}, body: raw };
+    }
+    const yamlLines = lines.slice(1, closingIdx);
+    // Body: everything after the closing delimiter line, joined back.
+    const body = lines.slice(closingIdx + 1).join("\n");
+    const frontmatter = {};
+    let i = 0;
+    while (i < yamlLines.length) {
+        const line = yamlLines[i];
+        // Skip blank lines or lines that don't look like key: ... entries.
+        const colonIdx = line.indexOf(":");
+        if (colonIdx < 0) {
+            i++;
+            continue;
+        }
+        const key = line.slice(0, colonIdx).trim();
+        if (key === "") {
+            i++;
+            continue;
+        }
+        const rawVal = line.slice(colonIdx + 1).trim();
+        if (rawVal === "") {
+            // Could be a block list or an empty value.
+            const listItems = [];
+            let j = i + 1;
+            while (j < yamlLines.length && BLOCK_ITEM_REGEX.test(yamlLines[j])) {
+                // Strip the leading `- ` (with any surrounding whitespace).
+                listItems.push(yamlLines[j].replace(/^\s*-\s+/, "").trim());
+                j++;
+            }
+            if (listItems.length > 0) {
+                frontmatter[key] = listItems;
+                i = j;
+                continue;
+            }
+            // Empty value — store as empty string.
+            frontmatter[key] = "";
+            i++;
+            continue;
+        }
+        // Check for an inline list: `[a, b, c]`.
+        const inlineMatch = INLINE_LIST_REGEX.exec(rawVal);
+        if (inlineMatch !== null) {
+            frontmatter[key] = inlineMatch[1].split(",").map((s) => s.trim());
+            i++;
+            continue;
+        }
+        frontmatter[key] = parseScalar(rawVal);
+        i++;
+    }
+    return { frontmatter, body };
+}
+// ── YAML frontmatter serializer ─────────────────────────────────────
+/**
+ * Serialize a frontmatter object and body back to a complete note string.
+ *
+ * Produces `---\n<yaml>\n---\n<body>`. Array values are serialized as
+ * block-style lists (one `  - item` line per element).
+ */
+export function serializeFrontmatter(frontmatter, body) {
+    const lines = ["---"];
+    for (const [key, val] of Object.entries(frontmatter)) {
+        if (Array.isArray(val)) {
+            lines.push(`${key}:`);
+            for (const item of val) {
+                lines.push(`  - ${String(item)}`);
+            }
+        }
+        else {
+            lines.push(`${key}: ${String(val)}`);
+        }
+    }
+    lines.push("---");
+    return lines.join("\n") + "\n" + body;
+}
+// ── VaultNote helpers ───────────────────────────────────────────────
+/**
+ * Parse a raw note string into a `VaultNote`.
+ * The `path` parameter is stored verbatim — no filesystem access occurs here.
+ */
+export function parseNote(raw, path) {
+    const { frontmatter, body } = parseFrontmatter(raw);
+    return { frontmatter, body, path };
+}
+/**
+ * Serialize a `VaultNote` back to a raw string suitable for writing to disk.
+ */
+export function serializeNote(note) {
+    return serializeFrontmatter(note.frontmatter, note.body);
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/vault/frontmatter.js.map

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

package/dist/vault/index-map.d.ts

@@ -0,0 +1,35 @@
+/**
+ * index-map — PURE mapping from a VaultNote's frontmatter to FactInput records.
+ *
+ * PURE: Never calls Date.now() or new Date() — timestamps are injected via `opts.now`.
+ *       Never touches the filesystem — no fs or network imports.
+ *
+ * bober: one FactInput per frontmatter key; empty-stringified values are skipped
+ *        to satisfy FactSchema's value.min(1) constraint. Arrays/objects use
+ *        JSON.stringify for stable deterministic ids.
+ */
+import type { VaultNote } from "./types.js";
+import type { FactInput } from "../state/facts.js";
+/**
+ * Map a single VaultNote to one FactInput per frontmatter key.
+ *
+ * subject resolution:
+ *   - frontmatter.id (as string) if present and non-empty
+ *   - otherwise: note.path
+ *
+ * value stringification:
+ *   - string scalars: as-is
+ *   - number/boolean: String()
+ *   - arrays/objects: JSON.stringify (stable, preserves structure)
+ *   - empty-stringified values are SKIPPED (FactSchema value.min(1))
+ *
+ * status:superseded filtering belongs in reindexNotes, NOT here.
+ * This function maps ALL keys unconditionally.
+ */
+export declare function noteToFacts(note: VaultNote, opts: {
+    scope: string;
+    now: string;
+    sourceRunId?: string | null;
+}): FactInput[];
+export { SUPERSEDED_STATUS } from "./conventions.js";
+//# sourceMappingURL=index-map.d.ts.map

package/dist/vault/index-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-map.d.ts","sourceRoot":"","sources":["../../src/vault/index-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAkBnD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAChE,SAAS,EAAE,CAsBb;AAGD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/vault/index-map.js

@@ -0,0 +1,67 @@
+/**
+ * index-map — PURE mapping from a VaultNote's frontmatter to FactInput records.
+ *
+ * PURE: Never calls Date.now() or new Date() — timestamps are injected via `opts.now`.
+ *       Never touches the filesystem — no fs or network imports.
+ *
+ * bober: one FactInput per frontmatter key; empty-stringified values are skipped
+ *        to satisfy FactSchema's value.min(1) constraint. Arrays/objects use
+ *        JSON.stringify for stable deterministic ids.
+ */
+// ── Value stringification ───────────────────────────────────────────────────
+/**
+ * Stringify a frontmatter value stably so identical input yields identical fact ids.
+ * Scalars use String() which is stable and lossless for primitives.
+ * Arrays/objects use JSON.stringify so deterministic fact ids stay stable across runs.
+ */
+function stringifyValue(v) {
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number" || typeof v === "boolean")
+        return String(v);
+    if (v === null || v === undefined)
+        return "";
+    return JSON.stringify(v);
+}
+// ── Mapping ──────────────────────────────────────────────────────────────────
+/**
+ * Map a single VaultNote to one FactInput per frontmatter key.
+ *
+ * subject resolution:
+ *   - frontmatter.id (as string) if present and non-empty
+ *   - otherwise: note.path
+ *
+ * value stringification:
+ *   - string scalars: as-is
+ *   - number/boolean: String()
+ *   - arrays/objects: JSON.stringify (stable, preserves structure)
+ *   - empty-stringified values are SKIPPED (FactSchema value.min(1))
+ *
+ * status:superseded filtering belongs in reindexNotes, NOT here.
+ * This function maps ALL keys unconditionally.
+ */
+export function noteToFacts(note, opts) {
+    const subject = typeof note.frontmatter.id === "string" && note.frontmatter.id.length > 0
+        ? note.frontmatter.id
+        : note.path;
+    const facts = [];
+    for (const [key, val] of Object.entries(note.frontmatter)) {
+        const value = stringifyValue(val);
+        if (value.length === 0)
+            continue; // guard against FactSchema value.min(1)
+        facts.push({
+            scope: opts.scope,
+            subject,
+            predicate: key,
+            value,
+            confidence: 1,
+            sourceRunId: opts.sourceRunId ?? null,
+            tValid: opts.now,
+            tCreated: opts.now,
+        });
+    }
+    return facts;
+}
+// ── Sprint 5 convergence: canonical status lives in conventions.ts ───────────
+export { SUPERSEDED_STATUS } from "./conventions.js";
+//# sourceMappingURL=index-map.js.map

package/dist/vault/index-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-map.js","sourceRoot":"","sources":["../../src/vault/index-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,+EAA+E;AAE/E;;;;GAIG;AACH,SAAS,cAAc,CAAC,CAAU;IAChC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CACzB,IAAe,EACf,IAAiE;IAEjE,MAAM,OAAO,GACX,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC;QACvE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE;QACrB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAEhB,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS,CAAC,wCAAwC;QAC1E,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO;YACP,SAAS,EAAE,GAAG;YACd,KAAK;YACL,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;YACrC,MAAM,EAAE,IAAI,CAAC,GAAG;YAChB,QAAQ,EAAE,IAAI,CAAC,GAAG;SACnB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/vault/mcp-adapter.d.ts

@@ -0,0 +1,96 @@
+/**
+ * VaultMcpAdapter — read/write/list Obsidian vault notes via a WRAPPED on-device MCP server.
+ *
+ * Design:
+ *   - Accepts any object satisfying McpServerLike (constructor-injected), so tests can
+ *     inject a hand-rolled fake without spawning a subprocess.
+ *   - Resolves tool names from config.toolNames overrides before falling back to
+ *     DEFAULT_VAULT_TOOL_NAMES (cyanheads/obsidian-mcp-server convention).
+ *   - Runs an isOnDevice() guard before the first server interaction; rejects any
+ *     declaration whose mcpCommand implies a non-local network transport.
+ *
+ * SECURITY: mcpEnv may contain secrets. This module NEVER includes mcpEnv values in
+ * error messages, log lines, or thrown strings. Only config.name is safe to surface.
+ *
+ * bober: on-device-only guard inspects mcpCommand/mcpArgs (never mcpEnv). If a
+ *        remote-transport MCP server is ever needed, add a new adapter — do not relax
+ *        this guard; it is a deliberate security/privacy boundary.
+ */
+import type { ToolDescriptor } from "../mcp/external-client.js";
+import type { VaultSection } from "../config/schema.js";
+import type { VaultNote } from "./types.js";
+/**
+ * Minimal interface satisfied by ExternalMcpServer.
+ * Tests inject a hand-rolled fake; no concrete class dependency for the adapter's core.
+ */
+export interface McpServerLike {
+    start(): Promise<void>;
+    listTools(): Promise<ToolDescriptor[]>;
+    callTool(name: string, args: unknown): Promise<unknown>;
+    stop(): Promise<void>;
+}
+/**
+ * Default MCP tool names for cyanheads/obsidian-mcp-server.
+ * Override any entry via config.obsidian.toolNames to support alternative servers
+ * (e.g., Obsidian Local REST API plugin's built-in MCP).
+ */
+export declare const DEFAULT_VAULT_TOOL_NAMES: {
+    readonly readNote: "obsidian_read_file";
+    readonly writeNote: "obsidian_update_file";
+    readonly listNotes: "obsidian_list_files_in_dir";
+};
+/**
+ * Returns true when the obsidian config describes an on-device (local) MCP server.
+ *
+ * Predicate:
+ *   REJECT if mcpCommand matches a remote URL scheme (https?|wss?|ftp|tcp://).
+ *   REJECT if any mcpArgs element embeds a non-loopback host (e.g. --url=https://cloud.example.com).
+ *   ACCEPT bare executables (node, npx, /abs/path) with no remote-pointing args.
+ *
+ * SECURITY: Never inspects mcpEnv values — those are secrets and must not drive guard logic.
+ */
+export declare function isOnDevice(cfg: NonNullable<VaultSection["obsidian"]>): boolean;
+/**
+ * Thin adapter that exposes readNote / writeNote / listNotes over an injected MCP server.
+ *
+ * Usage (production):
+ *   const server = new ExternalMcpServer(provider);  // satisfies McpServerLike
+ *   const adapter = new VaultMcpAdapter(server, config.vault.obsidian);
+ *   await adapter.readNote("Notes/Foo.md");
+ *
+ * Usage (tests): inject a hand-rolled fake that satisfies McpServerLike.
+ */
+export declare class VaultMcpAdapter {
+    private readonly server;
+    private readonly config;
+    private readonly toolNames;
+    constructor(server: McpServerLike, config: NonNullable<VaultSection["obsidian"]>);
+    /**
+     * Guard that MUST be called before any method that would invoke server.start().
+     * Throws a clear Error (naming only config.name) when the declaration is not on-device.
+     * SECURITY: error message never includes mcpEnv.
+     */
+    private guardOnDevice;
+    /**
+     * Read a note at the given vault-relative path.
+     * Starts the server (after the on-device guard), calls the configured read tool,
+     * and parses the returned markdown into a VaultNote via sprint-1 parseNote.
+     */
+    readNote(path: string): Promise<VaultNote>;
+    /**
+     * Write a note to the vault.
+     * Serializes the VaultNote to markdown via sprint-1 serializeNote, then calls
+     * the configured write tool with the note's path and serialized content.
+     */
+    writeNote(note: VaultNote): Promise<void>;
+    /**
+     * List notes in a vault directory.
+     * Calls the configured list tool and returns an array of path strings.
+     */
+    listNotes(dir?: string): Promise<string[]>;
+    /**
+     * Stop the underlying MCP server. Safe to call even if start() was never called.
+     */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=mcp-adapter.d.ts.map

package/dist/vault/mcp-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-adapter.d.ts","sourceRoot":"","sources":["../../src/vault/mcp-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK5C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAID;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;CAI3B,CAAC;AAqBX;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,WAAW,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,GAAG,OAAO,CAM9E;AAqCD;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAQxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAIxB;gBAGiB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,WAAW,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IAUhE;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAUrB;;;;OAIG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAQhD;;;;OAIG;IACG,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C;;;OAGG;IACG,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOhD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}