daftari 1.0.0

package/dist/tools/curation.js

@@ -0,0 +1,202 @@
+// Curation-path tools: vault_tension_log, vault_lint, vault_provenance.
+//
+// These are the advisory surface of the curation engine. vault_lint reports
+// problems but fixes nothing; vault_tension_log records a contradiction but
+// resolves nothing; vault_provenance just reads back write history. Each tool
+// exposes a pure logic function (returns Result, never throws) plus an MCP
+// ToolDefinition, mirroring the read- and write-path tools.
+import { hasAnyRead } from "../access/rbac.js";
+import { LINT_CHECKS, runLint } from "../curation/lint.js";
+import { readProvenanceLog } from "../curation/provenance.js";
+import { addTension } from "../curation/tension.js";
+import { ok } from "../frontmatter/types.js";
+// Curation tools are open to any role with at least one read grant. A guest
+// (or any role with no read access) is denied.
+function requireReadAccess(tool, access) {
+    if (access && !hasAnyRead(access.role)) {
+        return {
+            ok: false,
+            error: new Error(`access denied: role '${access.roleName}' cannot use ${tool}`),
+        };
+    }
+    return ok(undefined);
+}
+// ---------------------------------------------------------------------------
+// vault_tension_log
+// ---------------------------------------------------------------------------
+export async function vaultTensionLog(vaultRoot, args, access) {
+    const allowed = requireReadAccess("vault_tension_log", access);
+    if (!allowed.ok)
+        return allowed;
+    const str = (field) => {
+        const v = args[field];
+        if (typeof v !== "string" || v.trim().length === 0) {
+            return {
+                ok: false,
+                error: new Error(`vault_tension_log requires a non-empty '${field}' argument`),
+            };
+        }
+        return ok(v);
+    };
+    const title = str("title");
+    if (!title.ok)
+        return title;
+    const sourceA = str("sourceA");
+    if (!sourceA.ok)
+        return sourceA;
+    const sourceB = str("sourceB");
+    if (!sourceB.ok)
+        return sourceB;
+    const claimA = str("claimA");
+    if (!claimA.ok)
+        return claimA;
+    const claimB = str("claimB");
+    if (!claimB.ok)
+        return claimB;
+    const agent = str("agent");
+    if (!agent.ok)
+        return agent;
+    return addTension(vaultRoot, {
+        title: title.value,
+        sourceA: sourceA.value,
+        sourceB: sourceB.value,
+        claimA: claimA.value,
+        claimB: claimB.value,
+        loggedBy: agent.value,
+    });
+}
+export async function vaultLint(vaultRoot, args = {}, access) {
+    const allowed = requireReadAccess("vault_lint", access);
+    if (!allowed.ok)
+        return allowed;
+    let filter = null;
+    if (args.filter !== undefined && args.filter !== null) {
+        if (typeof args.filter !== "string" ||
+            !LINT_CHECKS.includes(args.filter)) {
+            return {
+                ok: false,
+                error: new Error(`vault_lint 'filter' must be one of: ${LINT_CHECKS.join(", ")}`),
+            };
+        }
+        filter = args.filter;
+    }
+    const report = await runLint(vaultRoot);
+    if (!report.ok)
+        return report;
+    if (filter) {
+        const findings = report.value.checks[filter];
+        return ok({
+            generatedAt: report.value.generatedAt,
+            filter,
+            checks: { [filter]: findings },
+            totalFindings: findings.length,
+        });
+    }
+    return ok({
+        generatedAt: report.value.generatedAt,
+        filter: null,
+        checks: report.value.checks,
+        totalFindings: report.value.totalFindings,
+    });
+}
+// Returns the write history of a single document, oldest entry first, read
+// from the .daftari/curation-log.jsonl provenance trail.
+export async function vaultProvenance(vaultRoot, args, access) {
+    const allowed = requireReadAccess("vault_provenance", access);
+    if (!allowed.ok)
+        return allowed;
+    const filePath = args.filePath;
+    if (typeof filePath !== "string" || filePath.trim().length === 0) {
+        return {
+            ok: false,
+            error: new Error("vault_provenance requires a non-empty 'filePath' argument"),
+        };
+    }
+    const log = await readProvenanceLog(vaultRoot);
+    if (!log.ok)
+        return log;
+    const history = log.value.filter((e) => e.file === filePath);
+    return ok({ path: filePath, count: history.length, history });
+}
+// ---------------------------------------------------------------------------
+// MCP tool definitions
+// ---------------------------------------------------------------------------
+export const curationTools = [
+    {
+        name: "vault_tension_log",
+        description: "Record a tension — a contradiction or unresolved pull between two " +
+            "vault documents — to the advisory tension log. Records the tension; " +
+            "does not resolve it. Entries are logged with status 'unresolved'.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: {
+                    type: "string",
+                    description: "Short title summarizing the tension",
+                },
+                sourceA: {
+                    type: "string",
+                    description: "Vault path of the first document",
+                },
+                claimA: {
+                    type: "string",
+                    description: "What source A claims",
+                },
+                sourceB: {
+                    type: "string",
+                    description: "Vault path of the second document",
+                },
+                claimB: {
+                    type: "string",
+                    description: "What source B claims",
+                },
+                agent: {
+                    type: "string",
+                    description: "Identity logging the tension, e.g. 'agent:claude-code'",
+                },
+            },
+            required: ["title", "sourceA", "claimA", "sourceB", "claimB", "agent"],
+            additionalProperties: false,
+        },
+        handler: (vaultRoot, args, access) => vaultTensionLog(vaultRoot, args, access),
+    },
+    {
+        name: "vault_lint",
+        description: "Run the advisory curation checks across the vault: stale files past " +
+            "TTL, orphan files with no inbound links, old drafts, stagnant " +
+            "low-confidence files, and deprecated files still linked from " +
+            "canonical ones. Reports problems; never auto-fixes. Optionally filter " +
+            "to a single check.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filter: {
+                    type: "string",
+                    enum: [...LINT_CHECKS],
+                    description: "Restrict the report to a single check",
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (vaultRoot, args, access) => vaultLint(vaultRoot, args, access),
+    },
+    {
+        name: "vault_provenance",
+        description: "Return the write history of a single document from the provenance " +
+            "log: every create, update, append, promote, and deprecate recorded " +
+            "for it, oldest first.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filePath: {
+                    type: "string",
+                    description: "Vault-relative path of the document to query",
+                },
+            },
+            required: ["filePath"],
+            additionalProperties: false,
+        },
+        handler: (vaultRoot, args, access) => vaultProvenance(vaultRoot, args, access),
+    },
+];
+//# sourceMappingURL=curation.js.map

package/dist/tools/curation.js.map

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

package/dist/tools/read.d.ts

@@ -0,0 +1,74 @@
+import { type AccessContext } from "../access/rbac.js";
+import { type ProvenanceEntry } from "../curation/provenance.js";
+import { type Frontmatter, type Result, type ValidationReport } from "../frontmatter/types.js";
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    handler: (vaultRoot: string, args: Record<string, unknown>, access?: AccessContext) => Promise<Result<unknown, Error>>;
+}
+export interface VaultReadResult {
+    path: string;
+    content: string;
+    frontmatter: Frontmatter;
+    raw: Record<string, unknown>;
+    validation: ValidationReport;
+    hasFrontmatter: boolean;
+}
+export declare function vaultRead(vaultRoot: string, path: string, access?: AccessContext): Promise<Result<VaultReadResult, Error>>;
+export interface VaultIndexFilters {
+    collection?: string;
+    status?: string;
+    domain?: string;
+    tags?: string[];
+}
+export interface VaultIndexEntry {
+    path: string;
+    title: string;
+    collection: string;
+    domain: string;
+    status: string;
+    confidence: string;
+    updated: string;
+    tags: string[];
+    valid: boolean;
+}
+export interface VaultIndexResult {
+    count: number;
+    entries: VaultIndexEntry[];
+}
+export declare function vaultIndex(vaultRoot: string, filters?: VaultIndexFilters, access?: AccessContext): Promise<Result<VaultIndexResult, Error>>;
+export interface StalenessDistribution {
+    fresh: number;
+    aging: number;
+    stale: number;
+    total: number;
+}
+export interface TensionSummary {
+    title: string;
+    date: string;
+}
+export interface UnresolvedTensions {
+    count: number;
+    recent: TensionSummary[];
+}
+export interface RecentWrites {
+    count: number;
+    entries: ProvenanceEntry[];
+}
+export interface VaultStatusResult {
+    vault: string;
+    fileCount: number;
+    collections: {
+        collection: string;
+        count: number;
+    }[];
+    invalidCount: number;
+    generatedAt: string;
+    stalenessDistribution: StalenessDistribution;
+    unresolvedTensions: UnresolvedTensions;
+    recentWrites: RecentWrites;
+}
+export declare function vaultStatus(vaultRoot: string, access?: AccessContext): Promise<Result<VaultStatusResult, Error>>;
+export declare const readTools: ToolDefinition[];
+//# sourceMappingURL=read.d.ts.map

package/dist/tools/read.d.ts.map

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

package/dist/tools/read.js

@@ -0,0 +1,254 @@
+// Read-path tools: vault_read, vault_index, vault_status.
+//
+// Each tool exposes a pure async logic function (returns Result, never throws)
+// plus an MCP ToolDefinition that wraps it. server.ts registers the
+// definitions; tests call the logic functions directly.
+import { canRead, filterByReadPermission } from "../access/rbac.js";
+import { readProvenanceLog } from "../curation/provenance.js";
+import { listStaleFiles } from "../curation/staleness.js";
+import { DEFAULT_TENSION_STATUS, listTensions } from "../curation/tension.js";
+import { parseDocument } from "../frontmatter/parser.js";
+import { DOMAINS, err, ok, STATUSES, } from "../frontmatter/types.js";
+import { listFiles, readFile, resolveVaultPath } from "../storage/local.js";
+export async function vaultRead(vaultRoot, path, access) {
+    if (typeof path !== "string" || path.length === 0) {
+        return err(new Error("vault_read requires a non-empty 'path' argument"));
+    }
+    const resolved = resolveVaultPath(vaultRoot, path);
+    if (!resolved.ok)
+        return resolved;
+    const file = await readFile(resolved.value);
+    if (!file.ok)
+        return file;
+    const parsed = parseDocument(file.value);
+    if (!parsed.ok)
+        return parsed;
+    if (access) {
+        const collection = collectionOf(path, parsed.value.frontmatter);
+        if (!canRead(access.role, collection)) {
+            return err(new Error(`access denied: role '${access.roleName}' cannot read ` + `collection '${collection}'`));
+        }
+    }
+    return ok({
+        path,
+        content: parsed.value.content,
+        frontmatter: parsed.value.frontmatter,
+        raw: parsed.value.raw,
+        validation: parsed.value.validation,
+        hasFrontmatter: parsed.value.hasFrontmatter,
+    });
+}
+// A document's collection is its frontmatter `collection`, falling back to the
+// top-level directory of its vault-relative path.
+function collectionOf(relPath, fm) {
+    if (fm.collection)
+        return fm.collection;
+    const top = relPath.split("/")[0];
+    return top ?? "";
+}
+export async function vaultIndex(vaultRoot, filters = {}, access) {
+    const list = await listFiles(vaultRoot);
+    if (!list.ok)
+        return list;
+    const entries = [];
+    for (const relPath of list.value) {
+        const resolved = resolveVaultPath(vaultRoot, relPath);
+        if (!resolved.ok)
+            continue;
+        const file = await readFile(resolved.value);
+        if (!file.ok)
+            continue;
+        const parsed = parseDocument(file.value);
+        if (!parsed.ok)
+            continue;
+        const fm = parsed.value.frontmatter;
+        const collection = collectionOf(relPath, fm);
+        if (filters.collection && collection !== filters.collection)
+            continue;
+        if (filters.status && fm.status !== filters.status)
+            continue;
+        if (filters.domain && fm.domain !== filters.domain)
+            continue;
+        if (filters.tags && filters.tags.length > 0) {
+            const hasAll = filters.tags.every((t) => fm.tags.includes(t));
+            if (!hasAll)
+                continue;
+        }
+        entries.push({
+            path: relPath,
+            title: fm.title,
+            collection,
+            domain: fm.domain,
+            status: fm.status,
+            confidence: fm.confidence,
+            updated: fm.updated,
+            tags: fm.tags,
+            valid: parsed.value.validation.valid,
+        });
+    }
+    // RBAC: drop documents in collections the role cannot read.
+    const visible = access ? filterByReadPermission(access.role, entries) : entries;
+    return ok({ count: visible.length, entries: visible });
+}
+// The collection a bare vault-relative path belongs to: its top-level
+// directory. tension/provenance records carry only a path (no frontmatter),
+// so RBAC on those falls back to this path-based collection.
+function topCollection(relPath) {
+    return relPath.split("/")[0] ?? "";
+}
+export async function vaultStatus(vaultRoot, access) {
+    // vault_status reports only over the documents the role can read.
+    const index = await vaultIndex(vaultRoot, {}, access);
+    if (!index.ok)
+        return index;
+    const byCollection = new Map();
+    let invalidCount = 0;
+    for (const entry of index.value.entries) {
+        byCollection.set(entry.collection, (byCollection.get(entry.collection) ?? 0) + 1);
+        if (!entry.valid)
+            invalidCount += 1;
+    }
+    const collections = [...byCollection.entries()]
+        .sort((a, b) => a[0].localeCompare(b[0]))
+        .map(([collection, count]) => ({ collection, count }));
+    // Staleness: score every file, then keep only those the index already
+    // deemed visible, so the distribution honours RBAC. Threshold 0 makes
+    // listStaleFiles return every document with its decay score.
+    const visiblePaths = new Set(index.value.entries.map((e) => e.path));
+    const staleScan = await listStaleFiles(vaultRoot, 0);
+    if (!staleScan.ok)
+        return staleScan;
+    const stalenessDistribution = {
+        fresh: 0,
+        aging: 0,
+        stale: 0,
+        total: 0,
+    };
+    for (const file of staleScan.value) {
+        if (!visiblePaths.has(file.path))
+            continue;
+        stalenessDistribution.total += 1;
+        const score = file.staleness.score;
+        if (score >= 1)
+            stalenessDistribution.stale += 1;
+        else if (score >= 0.5)
+            stalenessDistribution.aging += 1;
+        else
+            stalenessDistribution.fresh += 1;
+    }
+    // Unresolved tensions. A tension links two files; with an access context we
+    // show it only when the role can read the collections of BOTH sources, so
+    // the dashboard never leaks the existence of a doc in a denied collection.
+    const tensions = await listTensions(vaultRoot, DEFAULT_TENSION_STATUS);
+    if (!tensions.ok)
+        return tensions;
+    const visibleTensions = access
+        ? tensions.value.filter((t) => canRead(access.role, topCollection(t.sourceA)) &&
+            canRead(access.role, topCollection(t.sourceB)))
+        : tensions.value;
+    const recentTensions = [...visibleTensions]
+        .sort((a, b) => b.date.localeCompare(a.date))
+        .slice(0, 5)
+        .map((t) => ({ title: t.title, date: t.date }));
+    // Recent writes from the provenance log (oldest first in the file). Each
+    // entry is gated by the role's read access to the written file's collection.
+    const log = await readProvenanceLog(vaultRoot);
+    if (!log.ok)
+        return log;
+    const visibleWrites = access
+        ? log.value.filter((e) => canRead(access.role, topCollection(e.file)))
+        : log.value;
+    return ok({
+        vault: vaultRoot,
+        fileCount: index.value.count,
+        collections,
+        invalidCount,
+        generatedAt: new Date().toISOString(),
+        stalenessDistribution,
+        unresolvedTensions: {
+            count: visibleTensions.length,
+            recent: recentTensions,
+        },
+        recentWrites: {
+            count: visibleWrites.length,
+            entries: visibleWrites.slice(-10),
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// MCP tool definitions
+// ---------------------------------------------------------------------------
+function asString(v) {
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+function asStringArray(v) {
+    if (!Array.isArray(v))
+        return undefined;
+    const out = v.filter((x) => typeof x === "string");
+    return out.length > 0 ? out : undefined;
+}
+export const readTools = [
+    {
+        name: "vault_read",
+        description: "Read a single vault document. Returns its markdown body, parsed " +
+            "frontmatter, and a validation report. Path is relative to the vault root.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Vault-relative path to the markdown file, e.g. competitive-intel/foo.md",
+                },
+            },
+            required: ["path"],
+            additionalProperties: false,
+        },
+        handler: (vaultRoot, args, access) => vaultRead(vaultRoot, String(args.path ?? ""), access),
+    },
+    {
+        name: "vault_index",
+        description: "List vault documents with their metadata. Optionally filter by " +
+            "collection, status, domain, or tags (tags match is conjunctive).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                collection: { type: "string", description: "Filter by collection name" },
+                status: {
+                    type: "string",
+                    enum: [...STATUSES],
+                    description: "Filter by document status",
+                },
+                domain: {
+                    type: "string",
+                    enum: [...DOMAINS],
+                    description: "Filter by domain",
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Filter to documents that have all of these tags",
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (vaultRoot, args, access) => vaultIndex(vaultRoot, {
+            collection: asString(args.collection),
+            status: asString(args.status),
+            domain: asString(args.domain),
+            tags: asStringArray(args.tags),
+        }, access),
+    },
+    {
+        name: "vault_status",
+        description: "Vault health dashboard: total file count, per-collection counts, " +
+            "count of documents with invalid frontmatter, a staleness distribution " +
+            "(fresh/aging/stale), unresolved tensions, and recent write history.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            additionalProperties: false,
+        },
+        handler: (vaultRoot, _args, access) => vaultStatus(vaultRoot, access),
+    },
+];
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

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

package/dist/tools/search.d.ts

@@ -0,0 +1,13 @@
+import { type AccessContext } from "../access/rbac.js";
+import { type Result } from "../frontmatter/types.js";
+import { type HybridSearchResult, type RelatedSearchResult } from "../search/hybrid.js";
+import { type ReindexResult } from "../search/reindex.js";
+import type { ToolDefinition } from "./read.js";
+export declare function vaultSearch(vaultRoot: string, args: Record<string, unknown>, access?: AccessContext): Promise<Result<HybridSearchResult, Error>>;
+export declare function vaultSearchRelated(vaultRoot: string, args: Record<string, unknown>, access?: AccessContext): Promise<Result<RelatedSearchResult, Error>>;
+export interface VaultReindexResult extends ReindexResult {
+    vault: string;
+}
+export declare function vaultReindex(vaultRoot: string): Promise<Result<VaultReindexResult, Error>>;
+export declare const searchTools: ToolDefinition[];
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,aAAa,EAAW,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAEL,KAAK,kBAAkB,EAGvB,KAAK,mBAAmB,EAEzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,sBAAsB,CAAC;AAExE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AA6ChD,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC,CA2B5C;AAMD,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC,CA2B7C;AAMD,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC,CAIhG;AAgBD,eAAO,MAAM,WAAW,EAAE,cAAc,EA2DvC,CAAC"}