daftari 1.0.0

package/dist/curation/tension.d.ts

@@ -0,0 +1,20 @@
+import { type Result } from "../frontmatter/types.js";
+export declare const DEFAULT_TENSION_STATUS = "unresolved";
+export interface TensionEntry {
+    date: string;
+    title: string;
+    sourceA: string;
+    claimA: string;
+    sourceB: string;
+    claimB: string;
+    status: string;
+    loggedBy: string;
+}
+export type TensionInput = Omit<TensionEntry, "date" | "status"> & {
+    date?: string;
+    status?: string;
+};
+export declare function tensionsPath(vaultRoot: string): string;
+export declare function addTension(vaultRoot: string, input: TensionInput): Promise<Result<TensionEntry, Error>>;
+export declare function listTensions(vaultRoot: string, status?: string): Promise<Result<TensionEntry[], Error>>;
+//# sourceMappingURL=tension.d.ts.map

package/dist/curation/tension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tension.d.ts","sourceRoot":"","sources":["../../src/curation/tension.ts"],"names":[],"mappings":"AAaA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAE/D,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAiBD,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CA2BtC;AAsDD,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,KAAK,CAAC,CAAC,CAoBxC"}

package/dist/curation/tension.js

@@ -0,0 +1,134 @@
+// Tension log — the cross-domain-connection half of the curation engine.
+//
+// A "tension" is a recorded contradiction or pull between two documents: two
+// sources that say things which sit uneasily together. Daftari records the
+// tension; it never resolves it. Resolution is a human/curatorial act, so an
+// entry just carries a Status the curator updates by hand.
+//
+// The log is a human-readable markdown file, .daftari/tensions.md — append-only
+// from this module's side. Each entry is one `## ` block.
+import { mkdirSync } from "node:fs";
+import { appendFile, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { err, ok } from "../frontmatter/types.js";
+export const DEFAULT_TENSION_STATUS = "unresolved";
+export function tensionsPath(vaultRoot) {
+    return join(vaultRoot, ".daftari", "tensions.md");
+}
+// Renders one entry in the canonical block format. The blank trailing line
+// keeps consecutive entries visually separated in the file.
+function renderEntry(entry) {
+    return (`## ${entry.date} — ${entry.title}\n` +
+        `- **Source A:** ${entry.sourceA} says ${entry.claimA}\n` +
+        `- **Source B:** ${entry.sourceB} says ${entry.claimB}\n` +
+        `- **Status:** ${entry.status}\n` +
+        `- **Logged by:** ${entry.loggedBy}\n`);
+}
+// Appends a tension entry to .daftari/tensions.md. Date defaults to today and
+// status to "unresolved" — a freshly logged tension is unresolved by
+// definition.
+export async function addTension(vaultRoot, input) {
+    for (const field of ["title", "sourceA", "claimA", "sourceB", "claimB", "loggedBy"]) {
+        if (typeof input[field] !== "string" || input[field].trim().length === 0) {
+            return err(new Error(`addTension requires a non-empty '${field}'`));
+        }
+    }
+    const entry = {
+        date: input.date ?? new Date().toISOString().slice(0, 10),
+        title: input.title.trim(),
+        sourceA: input.sourceA.trim(),
+        claimA: input.claimA.trim(),
+        sourceB: input.sourceB.trim(),
+        claimB: input.claimB.trim(),
+        status: input.status ?? DEFAULT_TENSION_STATUS,
+        loggedBy: input.loggedBy.trim(),
+    };
+    try {
+        mkdirSync(join(vaultRoot, ".daftari"), { recursive: true });
+        // A leading blank line keeps this block separated from the previous one.
+        await appendFile(tensionsPath(vaultRoot), `\n${renderEntry(entry)}`);
+        return ok(entry);
+    }
+    catch (e) {
+        const reason = e instanceof Error ? e.message : String(e);
+        return err(new Error(`cannot append to tension log: ${reason}`));
+    }
+}
+// `- **Source A:** <path> says <claim>` → { path, claim }. The path is
+// everything before the first " says "; the claim is the rest.
+function parseSourceLine(value) {
+    const marker = value.indexOf(" says ");
+    if (marker === -1)
+        return { path: value.trim(), claim: "" };
+    return {
+        path: value.slice(0, marker).trim(),
+        claim: value.slice(marker + " says ".length).trim(),
+    };
+}
+function parseBlock(block) {
+    const lines = block.split("\n");
+    const header = lines[0]?.replace(/^##\s+/, "") ?? "";
+    const headerMatch = header.match(/^(\d{4}-\d{2}-\d{2})\s+—\s+(.+)$/);
+    if (!headerMatch)
+        return null;
+    const entry = {
+        date: headerMatch[1],
+        title: headerMatch[2].trim(),
+        sourceA: "",
+        claimA: "",
+        sourceB: "",
+        claimB: "",
+        status: DEFAULT_TENSION_STATUS,
+        loggedBy: "",
+    };
+    for (const line of lines.slice(1)) {
+        const m = line.match(/^-\s+\*\*(.+?):\*\*\s*(.*)$/);
+        if (!m)
+            continue;
+        const label = m[1].toLowerCase();
+        const value = m[2];
+        if (label === "source a") {
+            const s = parseSourceLine(value);
+            entry.sourceA = s.path;
+            entry.claimA = s.claim;
+        }
+        else if (label === "source b") {
+            const s = parseSourceLine(value);
+            entry.sourceB = s.path;
+            entry.claimB = s.claim;
+        }
+        else if (label === "status") {
+            entry.status = value.trim();
+        }
+        else if (label === "logged by") {
+            entry.loggedBy = value.trim();
+        }
+    }
+    return entry;
+}
+// Reads back every logged tension, optionally filtered to one status. A
+// missing log is not an error — it just means no tensions have been logged.
+export async function listTensions(vaultRoot, status) {
+    let raw;
+    try {
+        raw = await readFile(tensionsPath(vaultRoot), "utf-8");
+    }
+    catch (e) {
+        if (e.code === "ENOENT")
+            return ok([]);
+        const reason = e instanceof Error ? e.message : String(e);
+        return err(new Error(`cannot read tension log: ${reason}`));
+    }
+    const entries = [];
+    // Each entry starts at a line beginning with "## ".
+    for (const block of raw.split(/(?=^## )/m)) {
+        const trimmed = block.trim();
+        if (!trimmed.startsWith("## "))
+            continue;
+        const entry = parseBlock(trimmed);
+        if (entry)
+            entries.push(entry);
+    }
+    return ok(status ? entries.filter((e) => e.status === status) : entries);
+}
+//# sourceMappingURL=tension.js.map

package/dist/curation/tension.js.map

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

package/dist/frontmatter/parser.d.ts

@@ -0,0 +1,10 @@
+import { type Frontmatter, type Result, type ValidationReport } from "./types.js";
+export interface ParsedDocument {
+    frontmatter: Frontmatter;
+    content: string;
+    raw: Record<string, unknown>;
+    validation: ValidationReport;
+    hasFrontmatter: boolean;
+}
+export declare function parseDocument(source: string): Result<ParsedDocument, Error>;
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/frontmatter/parser.ts"],"names":[],"mappings":"AASA,OAAO,EAAO,KAAK,WAAW,EAAM,KAAK,MAAM,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE3F,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,CAmB3E"}

package/dist/frontmatter/parser.js

@@ -0,0 +1,29 @@
+// Parses a markdown document into its frontmatter and body.
+//
+// gray-matter does the YAML extraction; validateFrontmatter coerces and checks
+// it. Parsing fails (Result.err) only when the YAML itself is malformed.
+// Frontmatter that parses but violates the schema is NOT a failure — the
+// validation report carries those issues so a read can still return content.
+import matter from "gray-matter";
+import { validateFrontmatter } from "./schema.js";
+import { err, ok } from "./types.js";
+export function parseDocument(source) {
+    let extracted;
+    try {
+        extracted = matter(source);
+    }
+    catch (e) {
+        const reason = e instanceof Error ? e.message : String(e);
+        return err(new Error(`malformed YAML frontmatter: ${reason}`));
+    }
+    const raw = (extracted.data ?? {});
+    const { frontmatter, report } = validateFrontmatter(raw);
+    return ok({
+        frontmatter,
+        content: extracted.content,
+        raw,
+        validation: report,
+        hasFrontmatter: Object.keys(raw).length > 0,
+    });
+}
+//# sourceMappingURL=parser.js.map

package/dist/frontmatter/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/frontmatter/parser.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,+EAA+E;AAC/E,yEAAyE;AACzE,yEAAyE;AACzE,6EAA6E;AAE7E,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,GAAG,EAAoB,EAAE,EAAsC,MAAM,YAAY,CAAC;AAU3F,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,IAAI,SAAwC,CAAC;IAC7C,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1D,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,+BAA+B,MAAM,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;IAC9D,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAEzD,OAAO,EAAE,CAAC;QACR,WAAW;QACX,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,GAAG;QACH,UAAU,EAAE,MAAM;QAClB,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;KAC5C,CAAC,CAAC;AACL,CAAC"}

package/dist/frontmatter/schema.d.ts

@@ -0,0 +1,7 @@
+import { type Frontmatter, type ValidationReport } from "./types.js";
+export interface FrontmatterValidation {
+    frontmatter: Frontmatter;
+    report: ValidationReport;
+}
+export declare function validateFrontmatter(data: Record<string, unknown>): FrontmatterValidation;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/frontmatter/schema.ts"],"names":[],"mappings":"AAQA,OAAO,EAKL,KAAK,WAAW,EAMhB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,qBAAqB,CAqGxF"}

package/dist/frontmatter/schema.js

@@ -0,0 +1,115 @@
+// Hand-rolled, dependency-free frontmatter validator.
+//
+// Validation is advisory and best-effort: it always produces a complete
+// Frontmatter object (filling defaults for anything missing or malformed) so
+// downstream readers never crash, and it returns a ValidationReport listing
+// every structural problem. It does NOT enforce curation rules (staleness,
+// tension, superseded_by consistency) — that is the curation engine's job.
+import { CONFIDENCES, DOMAINS, PROVENANCES, STATUSES, } from "./types.js";
+export function validateFrontmatter(data) {
+    const issues = [];
+    const requireString = (field) => {
+        const v = data[field];
+        if (typeof v === "string" && v.length > 0)
+            return v;
+        if (v === undefined || v === null || v === "") {
+            issues.push({ field, message: "missing required field" });
+        }
+        else {
+            issues.push({ field, message: `expected string, got ${typeof v}` });
+        }
+        return "";
+    };
+    const requireEnum = (field, allowed, fallback) => {
+        const v = data[field];
+        if (typeof v === "string" && allowed.includes(v)) {
+            return v;
+        }
+        if (v === undefined || v === null) {
+            issues.push({ field, message: "missing required field" });
+        }
+        else {
+            issues.push({
+                field,
+                message: `expected one of [${allowed.join(", ")}], got ${JSON.stringify(v)}`,
+            });
+        }
+        return fallback;
+    };
+    const requireDate = (field) => {
+        const v = data[field];
+        // js-yaml parses unquoted ISO dates into Date objects.
+        if (v instanceof Date && !Number.isNaN(v.getTime())) {
+            return v.toISOString().slice(0, 10);
+        }
+        if (typeof v === "string") {
+            if (/^\d{4}-\d{2}-\d{2}$/.test(v))
+                return v;
+            issues.push({ field, message: `expected YYYY-MM-DD date, got "${v}"` });
+            return v;
+        }
+        if (v === undefined || v === null) {
+            issues.push({ field, message: "missing required field" });
+        }
+        else {
+            issues.push({ field, message: `expected date, got ${typeof v}` });
+        }
+        return "";
+    };
+    // Optional arrays default to []; only malformed values are flagged.
+    const optionalStringArray = (field) => {
+        const v = data[field];
+        if (v === undefined || v === null)
+            return [];
+        if (Array.isArray(v)) {
+            const out = [];
+            v.forEach((item, i) => {
+                if (typeof item === "string")
+                    out.push(item);
+                else
+                    issues.push({ field, message: `element ${i} is not a string` });
+            });
+            return out;
+        }
+        issues.push({ field, message: `expected array, got ${typeof v}` });
+        return [];
+    };
+    const optionalString = (field) => {
+        const v = data[field];
+        if (v === undefined || v === null)
+            return null;
+        if (typeof v === "string")
+            return v;
+        issues.push({ field, message: `expected string or null, got ${typeof v}` });
+        return null;
+    };
+    const optionalNumber = (field) => {
+        const v = data[field];
+        if (v === undefined || v === null)
+            return null;
+        if (typeof v === "number" && Number.isFinite(v))
+            return v;
+        issues.push({ field, message: `expected number or null, got ${typeof v}` });
+        return null;
+    };
+    const frontmatter = {
+        title: requireString("title"),
+        domain: requireEnum("domain", DOMAINS, "accumulation"),
+        collection: requireString("collection"),
+        status: requireEnum("status", STATUSES, "draft"),
+        confidence: requireEnum("confidence", CONFIDENCES, "low"),
+        created: requireDate("created"),
+        updated: requireDate("updated"),
+        updated_by: requireString("updated_by"),
+        provenance: requireEnum("provenance", PROVENANCES, "inferred"),
+        sources: optionalStringArray("sources"),
+        superseded_by: optionalString("superseded_by"),
+        ttl_days: optionalNumber("ttl_days"),
+        tags: optionalStringArray("tags"),
+    };
+    return {
+        frontmatter,
+        report: { valid: issues.length === 0, issues },
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/frontmatter/schema.js.map

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

package/dist/frontmatter/types.d.ts

@@ -0,0 +1,41 @@
+export type Result<T, E = Error> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: E;
+};
+export declare const ok: <T>(value: T) => Result<T, never>;
+export declare const err: <E = Error>(error: E) => Result<never, E>;
+export declare const DOMAINS: readonly ["accumulation", "generative"];
+export type Domain = (typeof DOMAINS)[number];
+export declare const STATUSES: readonly ["draft", "canonical", "deprecated", "superseded", "archived"];
+export type Status = (typeof STATUSES)[number];
+export declare const CONFIDENCES: readonly ["low", "medium", "high"];
+export type Confidence = (typeof CONFIDENCES)[number];
+export declare const PROVENANCES: readonly ["direct", "synthesized", "inferred"];
+export type Provenance = (typeof PROVENANCES)[number];
+export interface Frontmatter {
+    title: string;
+    domain: Domain;
+    collection: string;
+    status: Status;
+    confidence: Confidence;
+    created: string;
+    updated: string;
+    updated_by: string;
+    provenance: Provenance;
+    sources: string[];
+    superseded_by: string | null;
+    ttl_days: number | null;
+    tags: string[];
+}
+export interface ValidationIssue {
+    field: string;
+    message: string;
+}
+export interface ValidationReport {
+    valid: boolean;
+    issues: ValidationIssue[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/frontmatter/types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAEpF,eAAO,MAAM,EAAE,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAA0B,CAAC;AAC3E,eAAO,MAAM,GAAG,GAAI,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC,KAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAA2B,CAAC;AAErF,eAAO,MAAM,OAAO,yCAA0C,CAAC;AAC/D,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C,eAAO,MAAM,QAAQ,yEAA0E,CAAC;AAChG,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,eAAO,MAAM,WAAW,oCAAqC,CAAC;AAC9D,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,eAAO,MAAM,WAAW,gDAAiD,CAAC;AAC1E,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAItD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAID,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B"}

package/dist/frontmatter/types.js

@@ -0,0 +1,8 @@
+// Core shared types for Daftari: the Result pattern and the frontmatter schema.
+export const ok = (value) => ({ ok: true, value });
+export const err = (error) => ({ ok: false, error });
+export const DOMAINS = ["accumulation", "generative"];
+export const STATUSES = ["draft", "canonical", "deprecated", "superseded", "archived"];
+export const CONFIDENCES = ["low", "medium", "high"];
+export const PROVENANCES = ["direct", "synthesized", "inferred"];
+//# sourceMappingURL=types.js.map

package/dist/frontmatter/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/frontmatter/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAMhF,MAAM,CAAC,MAAM,EAAE,GAAG,CAAI,KAAQ,EAAoB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,GAAG,GAAG,CAAY,KAAQ,EAAoB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAErF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,cAAc,EAAE,YAAY,CAAU,CAAC;AAG/D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,CAAU,CAAC;AAGhG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAG9D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAU,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export declare function parseFlag(argv: string[], name: string): string | null;
+export declare function parseVaultArg(argv: string[]): string | null;
+export declare function main(argv?: string[]): Promise<void>;
+//# 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":"AAmBA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASrE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAE3D;AAED,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DhF"}

package/dist/index.js

@@ -0,0 +1,94 @@
+// Daftari MCP server entry point.
+//
+// Parses `--vault <path>`, verifies the vault directory exists, loads the RBAC
+// config, builds the search index, then serves the tools over stdio under the
+// access identity given by `--user` / `--role`. Diagnostics go to stderr so
+// they never corrupt the stdio JSON-RPC stream on stdout.
+//
+// `--reindex` rebuilds the search index and exits without starting the server.
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { GUEST_ROLE, resolveAccess } from "./access/rbac.js";
+import { reindexVault } from "./search/reindex.js";
+import { createServer } from "./server.js";
+import { directoryExists } from "./storage/local.js";
+import { loadConfig } from "./utils/config.js";
+// Reads `--name value` or `--name=value` from argv; null if absent.
+export function parseFlag(argv, name) {
+    const flag = `--${name}`;
+    const flagIndex = argv.indexOf(flag);
+    if (flagIndex !== -1 && flagIndex + 1 < argv.length) {
+        return argv[flagIndex + 1] ?? null;
+    }
+    const inline = argv.find((a) => a.startsWith(`${flag}=`));
+    if (inline)
+        return inline.slice(`${flag}=`.length);
+    return null;
+}
+export function parseVaultArg(argv) {
+    return parseFlag(argv, "vault");
+}
+export async function main(argv = process.argv.slice(2)) {
+    const vaultArg = parseVaultArg(argv);
+    if (!vaultArg) {
+        process.stderr.write("daftari: missing required --vault <path> argument\n");
+        process.exitCode = 1;
+        return;
+    }
+    const vaultRoot = resolve(vaultArg);
+    if (!(await directoryExists(vaultRoot))) {
+        process.stderr.write(`daftari: vault directory not found: ${vaultRoot}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    // Load the RBAC config. A malformed config fails loud: the server must not
+    // start serving content under a policy it could not parse.
+    const config = loadConfig(vaultRoot);
+    if (!config.ok) {
+        process.stderr.write(`daftari: ${config.error.message}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    // Resolve the access identity. With no --role the server runs as the
+    // deny-all guest; an unknown role name resolves the same way.
+    const user = parseFlag(argv, "user") ?? "guest";
+    const roleName = parseFlag(argv, "role") ?? GUEST_ROLE;
+    const access = resolveAccess(config.value, user, roleName);
+    if (access.role === null && roleName !== GUEST_ROLE) {
+        process.stderr.write(`daftari: warning: role '${roleName}' not found in config — running as deny-all guest\n`);
+    }
+    // Build (or rebuild) the search index. With --reindex this is the whole job.
+    const reindexed = await reindexVault(vaultRoot);
+    if (reindexed.ok) {
+        const r = reindexed.value;
+        process.stderr.write(`daftari: indexed ${r.documentCount} docs, ${r.chunkCount} chunks ` +
+            `(vectors ${r.vectorEnabled ? "on" : "off"})\n`);
+    }
+    else {
+        // A failed index is not fatal: lexical search still works and the search
+        // tools retry indexing lazily on first use.
+        process.stderr.write(`daftari: warning: index build failed: ${reindexed.error.message}\n`);
+    }
+    if (argv.includes("--reindex")) {
+        if (!reindexed.ok)
+            process.exitCode = 1;
+        return;
+    }
+    const server = createServer(vaultRoot, access);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(`daftari: serving vault at ${vaultRoot} (stdio) — ` +
+        `user=${access.user} role=${access.roleName}\n`);
+}
+// Auto-run only when this module is the process entry point (e.g. `tsx
+// src/index.ts`). When imported (by cli.ts or tests) it stays inert.
+const entryUrl = pathToFileURL(process.argv[1] ?? "").href;
+if (import.meta.url === entryUrl) {
+    main().catch((e) => {
+        const reason = e instanceof Error ? (e.stack ?? e.message) : String(e);
+        process.stderr.write(`daftari: fatal: ${reason}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/search/bm25.d.ts

@@ -0,0 +1,19 @@
+export declare function tokenize(text: string): string[];
+export interface Bm25Document {
+    path: string;
+    tokens: string[];
+}
+export interface Bm25Model {
+    termFreqs: Map<string, Map<string, number>>;
+    docFreqs: Map<string, number>;
+    docLengths: Map<string, number>;
+    docCount: number;
+    avgDocLength: number;
+}
+export declare function buildBm25(docs: Bm25Document[]): Bm25Model;
+export interface Bm25Hit {
+    path: string;
+    score: number;
+}
+export declare function searchBm25(model: Bm25Model, queryTokens: string[]): Bm25Hit[];
+//# sourceMappingURL=bm25.d.ts.map

package/dist/search/bm25.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../../src/search/bm25.ts"],"names":[],"mappings":"AA4DA,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/C;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IAExB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAE5C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,SAAS,CA0BzD;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAKD,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAsB7E"}