daftari 1.0.0

package/dist/cli.js

@@ -0,0 +1,216 @@
+#!/usr/bin/env node
+// Daftari CLI.
+//
+//   daftari --init [path]            scaffold a new vault
+//   daftari --vault <path> ...       start the MCP server against a vault
+//
+// Server flags (--vault, --user, --role, --reindex) are parsed by main() in
+// index.ts; this entry point only adds the --init scaffolding command and a
+// usage screen. Diagnostics go to stderr so stdout stays a clean JSON-RPC
+// stream when the server runs.
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { main, parseFlag } from "./index.js";
+import { reindexVault } from "./search/reindex.js";
+import { commit } from "./utils/git.js";
+const HERE = dirname(fileURLToPath(import.meta.url));
+const USAGE = `daftari — an MCP server that exposes a curated markdown vault to AI agents.
+
+Usage:
+  daftari --init [path]               Scaffold a new vault (default: ./daftari-vault)
+  daftari --vault <path> [options]    Start the MCP server (stdio) against a vault
+
+Server options:
+  --user <username>    Identity the server runs as (default: guest)
+  --role <rolename>    RBAC role from .daftari/config.yaml (default: deny-all guest)
+  --reindex            Rebuild the SQLite index from scratch, then exit
+
+Examples:
+  npx daftari --init ./my-vault
+  npx daftari --vault ./my-vault --user me --role admin
+  npx daftari --vault ./my-vault --reindex
+`;
+const COLLECTIONS = ["competitive-intel", "pricing", "moonshot", "_drafts"];
+const VAULT_GITIGNORE = `# Daftari rebuilds these from the markdown files — never commit them.
+.daftari/index.db
+.daftari/index.db-journal
+.daftari/index.db-wal
+.daftari/index.db-shm
+.daftari/locks.db
+.daftari/locks.db-journal
+.daftari/locks.db-wal
+.daftari/locks.db-shm
+`;
+// Example documents written by --init. Content is fictional: "Aurora" and
+// "Helios" are made-up products, not real companies.
+function exampleDocs(today) {
+    return [
+        {
+            path: "competitive-intel/aurora-pipelines-overview.md",
+            body: `---
+title: "Aurora Pipelines — Positioning Overview"
+domain: accumulation
+collection: competitive-intel
+status: canonical
+confidence: medium
+created: ${today}
+updated: ${today}
+updated_by: agent:daftari-init
+provenance: direct
+sources:
+  - aurora-product-page
+superseded_by: null
+ttl_days: 120
+tags: [aurora, ingestion, competitive]
+---
+
+# Aurora Pipelines — Positioning Overview
+
+Aurora Pipelines is a fictional data-movement product used here as an example.
+Its pitch: ingestion is an authored artifact you version and review, not a
+managed black box.
+
+## Questions Answered
+- How does Aurora frame the ingestion-vs-transformation boundary?
+
+## Questions Raised
+- Does an authored-pipeline model slow teams down at small scale?
+`,
+        },
+        {
+            path: "pricing/helios-consumption-pricing.md",
+            body: `---
+title: "Helios Consumption Pricing (Compute Credit Model)"
+domain: accumulation
+collection: pricing
+status: canonical
+confidence: high
+created: ${today}
+updated: ${today}
+updated_by: agent:daftari-init
+provenance: direct
+sources:
+  - helios-pricing-page
+superseded_by: null
+ttl_days: 45
+tags: [helios, pricing, consumption]
+---
+
+# Helios Consumption Pricing (Compute Credit Model)
+
+Helios is a fictional platform used here as an example. It bills in compute
+credits — a normalized compute-hour unit whose rate varies by workload tier.
+
+## Questions Answered
+- What is the unit of consumption billing?
+
+## Questions Raised
+- How predictable is monthly spend for spiky, agent-driven workloads?
+`,
+        },
+        {
+            path: "moonshot/zero-config-ingestion.md",
+            body: `---
+title: "Moonshot: Zero-Config Ingestion"
+domain: generative
+collection: moonshot
+status: draft
+confidence: low
+created: ${today}
+updated: ${today}
+updated_by: agent:daftari-init
+provenance: inferred
+sources: []
+superseded_by: null
+ttl_days: 30
+tags: [moonshot, ingestion, speculative]
+---
+
+# Moonshot: Zero-Config Ingestion
+
+A speculative sketch. Generative-domain notes are summaries, not compiled
+canon — the agent flags tensions here but does not resolve them.
+
+## Questions Answered
+- (none yet — this is a draft)
+
+## Questions Raised
+- What would ingestion look like with no authored schema at all?
+`,
+        },
+    ];
+}
+export async function initVault(targetPath) {
+    const vaultRoot = resolve(targetPath);
+    if (existsSync(vaultRoot) && readdirSync(vaultRoot).length > 0) {
+        process.stderr.write(`daftari: refusing to scaffold — ${vaultRoot} exists and is not empty\n`);
+        return 1;
+    }
+    // Directory structure: the vault root holds .daftari/ alongside one
+    // directory per collection.
+    mkdirSync(join(vaultRoot, ".daftari"), { recursive: true });
+    for (const c of COLLECTIONS) {
+        mkdirSync(join(vaultRoot, c), { recursive: true });
+    }
+    // RBAC config: copied from the package's bundled template.
+    const template = readFileSync(resolve(HERE, "..", "templates", "config.yaml"), "utf-8");
+    writeFileSync(join(vaultRoot, ".daftari", "config.yaml"), template);
+    writeFileSync(join(vaultRoot, ".gitignore"), VAULT_GITIGNORE);
+    const today = new Date().toISOString().slice(0, 10);
+    for (const doc of exampleDocs(today)) {
+        writeFileSync(join(vaultRoot, doc.path), doc.body);
+    }
+    // Git is the version layer — commit the scaffold so the vault has history
+    // from its first moment.
+    const committed = await commit(vaultRoot, ["."], "Initialize Daftari vault", "agent:daftari-init");
+    if (!committed.ok) {
+        process.stderr.write(`daftari: warning: could not commit the scaffold: ${committed.error.message}\n`);
+    }
+    // Initial index build so search works on first server start.
+    const indexed = await reindexVault(vaultRoot);
+    if (indexed.ok) {
+        process.stderr.write(`daftari: indexed ${indexed.value.documentCount} docs ` +
+            `(vectors ${indexed.value.vectorEnabled ? "on" : "off"})\n`);
+    }
+    else {
+        process.stderr.write(`daftari: warning: initial index build failed: ${indexed.error.message}\n`);
+    }
+    process.stdout.write(`Scaffolded a new Daftari vault at ${vaultRoot}\n\n` +
+        `  collections: ${COLLECTIONS.join(", ")}\n` +
+        `  config:      .daftari/config.yaml\n` +
+        `  examples:    3 markdown documents\n\n` +
+        `Next:\n` +
+        `  npx daftari --vault ${targetPath} --user me --role admin\n`);
+    return 0;
+}
+export async function run(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        process.stdout.write(USAGE);
+        return;
+    }
+    const wantsInit = argv.includes("--init") || argv.some((a) => a.startsWith("--init="));
+    if (wantsInit) {
+        const target = parseFlag(argv, "init") ?? "./daftari-vault";
+        process.exitCode = await initVault(target);
+        return;
+    }
+    if (parseFlag(argv, "vault")) {
+        await main(argv);
+        return;
+    }
+    process.stderr.write("daftari: nothing to do — pass --init or --vault\n\n");
+    process.stderr.write(USAGE);
+    process.exitCode = 1;
+}
+// Auto-run only when this module is the process entry point. When imported
+// (by tests) it stays inert so initVault / run can be exercised directly.
+const entryUrl = pathToFileURL(process.argv[1] ?? "").href;
+if (import.meta.url === entryUrl) {
+    run(process.argv.slice(2)).catch((e) => {
+        const reason = e instanceof Error ? (e.stack ?? e.message) : String(e);
+        process.stderr.write(`daftari: fatal: ${reason}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/curation/lint.d.ts

@@ -0,0 +1,20 @@
+import { type Result } from "../frontmatter/types.js";
+export declare const LINT_CHECKS: readonly ["staleFiles", "orphanFiles", "oldDrafts", "stagnantLowConfidence", "deprecatedStillLinked"];
+export type LintCheckName = (typeof LINT_CHECKS)[number];
+export interface LintFinding {
+    path: string;
+    detail: string;
+}
+export interface LintReport {
+    generatedAt: string;
+    checks: Record<LintCheckName, LintFinding[]>;
+    totalFindings: number;
+}
+export interface LintOptions {
+    now?: Date;
+    draftMaxDays?: number;
+    lowConfidenceMaxDays?: number;
+}
+export declare function extractLinks(content: string): string[];
+export declare function runLint(vaultRoot: string, opts?: LintOptions): Promise<Result<LintReport, Error>>;
+//# sourceMappingURL=lint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/curation/lint.ts"],"names":[],"mappings":"AASA,OAAO,EAAwB,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAI5E,eAAO,MAAM,WAAW,uGAMd,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,WAAW,EAAE,CAAC,CAAC;IAC7C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAYD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBtD;AAuED,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAkFpC"}

package/dist/curation/lint.js

@@ -0,0 +1,176 @@
+// vault_lint's engine — advisory cross-vault curation checks.
+//
+// Lint loads every document once, builds the inter-document link graph, then
+// runs five checks. It only ever *reports*: no file is edited, no status is
+// changed, nothing is auto-fixed. The output is a structured report grouped by
+// check, for a human (or an agent acting on a human's behalf) to triage.
+import { posix } from "node:path";
+import { parseDocument } from "../frontmatter/parser.js";
+import { ok } from "../frontmatter/types.js";
+import { listFiles, readFile, resolveVaultPath } from "../storage/local.js";
+import { ageInDays, computeStaleness } from "./staleness.js";
+export const LINT_CHECKS = [
+    "staleFiles",
+    "orphanFiles",
+    "oldDrafts",
+    "stagnantLowConfidence",
+    "deprecatedStillLinked",
+];
+// --- link extraction ------------------------------------------------------
+// Pulls every internal link target out of a markdown body: both [[wikilinks]]
+// and [text](target) markdown links. External URLs and anchors are dropped.
+export function extractLinks(content) {
+    const targets = [];
+    for (const m of content.matchAll(/\[\[([^\]]+)\]\]/g)) {
+        // A wikilink may carry a |display alias and/or a #heading anchor.
+        const raw = m[1].split("|")[0]?.split("#")[0]?.trim();
+        if (raw)
+            targets.push(raw);
+    }
+    for (const m of content.matchAll(/\[[^\]]*\]\(([^)\s]+)\)/g)) {
+        const raw = m[1].split("#")[0]?.trim();
+        if (!raw)
+            continue;
+        if (/^(https?:|mailto:|#)/i.test(raw))
+            continue;
+        targets.push(raw);
+    }
+    return targets;
+}
+// Resolves a raw link target to a vault-relative path, or null if it points
+// nowhere. Tries, in order: the target as-is, with a .md suffix, resolved
+// relative to the linking file's directory, then a bare basename match (the
+// common [[note-name]] wikilink form).
+function resolveLink(rawTarget, fromPath, byPath, byBasename) {
+    const withMd = (p) => (p.endsWith(".md") ? p : `${p}.md`);
+    if (byPath.has(rawTarget))
+        return rawTarget;
+    if (byPath.has(withMd(rawTarget)))
+        return withMd(rawTarget);
+    const relual = posix.normalize(posix.join(posix.dirname(fromPath), rawTarget));
+    if (byPath.has(relual))
+        return relual;
+    if (byPath.has(withMd(relual)))
+        return withMd(relual);
+    const base = posix.basename(rawTarget).replace(/\.md$/, "");
+    return byBasename.get(base) ?? null;
+}
+// --- check orchestration --------------------------------------------------
+async function loadDocuments(vaultRoot) {
+    const list = await listFiles(vaultRoot);
+    if (!list.ok)
+        return list;
+    const docs = [];
+    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;
+        docs.push({
+            path: relPath,
+            frontmatter: parsed.value.frontmatter,
+            content: parsed.value.content,
+        });
+    }
+    return ok(docs);
+}
+// Maps each document to the set of documents that link to it.
+function buildInboundMap(docs) {
+    const byPath = new Set(docs.map((d) => d.path));
+    const byBasename = new Map();
+    for (const d of docs) {
+        const base = posix.basename(d.path).replace(/\.md$/, "");
+        // First write wins, so a basename collision resolves deterministically.
+        if (!byBasename.has(base))
+            byBasename.set(base, d.path);
+    }
+    const inbound = new Map();
+    for (const d of docs) {
+        for (const raw of extractLinks(d.content)) {
+            const target = resolveLink(raw, d.path, byPath, byBasename);
+            if (!target || target === d.path)
+                continue;
+            if (!inbound.has(target))
+                inbound.set(target, new Set());
+            inbound.get(target).add(d.path);
+        }
+    }
+    return inbound;
+}
+// Runs every lint check across the vault and returns a grouped report.
+export async function runLint(vaultRoot, opts = {}) {
+    const loaded = await loadDocuments(vaultRoot);
+    if (!loaded.ok)
+        return loaded;
+    const docs = loaded.value;
+    const now = opts.now ?? new Date();
+    const draftMaxDays = opts.draftMaxDays ?? 30;
+    const lowConfidenceMaxDays = opts.lowConfidenceMaxDays ?? 30;
+    const inbound = buildInboundMap(docs);
+    const byPath = new Map(docs.map((d) => [d.path, d]));
+    const checks = {
+        staleFiles: [],
+        orphanFiles: [],
+        oldDrafts: [],
+        stagnantLowConfidence: [],
+        deprecatedStillLinked: [],
+    };
+    for (const doc of docs) {
+        const fm = doc.frontmatter;
+        // 1. Stale: a document at or past its TTL.
+        const staleness = computeStaleness({ updated: fm.updated, ttl_days: fm.ttl_days }, now);
+        if (staleness.expired) {
+            checks.staleFiles.push({
+                path: doc.path,
+                detail: `${staleness.ageDays}d since update, ttl ${staleness.ttlDays}d ` +
+                    `(decay score ${staleness.score.toFixed(2)})`,
+            });
+        }
+        // 2. Orphan: no other document links to it.
+        if (!inbound.has(doc.path)) {
+            checks.orphanFiles.push({
+                path: doc.path,
+                detail: "no inbound links from any vault document",
+            });
+        }
+        // 3. Old draft: still a draft well past the draft age limit.
+        if (fm.status === "draft") {
+            const anchor = fm.created || fm.updated;
+            const draftAge = ageInDays(anchor, now);
+            if (draftAge > draftMaxDays) {
+                checks.oldDrafts.push({
+                    path: doc.path,
+                    detail: `draft for ${draftAge}d (limit ${draftMaxDays}d)`,
+                });
+            }
+        }
+        // 4. Stagnant low-confidence: low confidence and untouched too long.
+        if (fm.confidence === "low") {
+            const idleDays = ageInDays(fm.updated, now);
+            if (idleDays >= lowConfidenceMaxDays) {
+                checks.stagnantLowConfidence.push({
+                    path: doc.path,
+                    detail: `low confidence, unchanged for ${idleDays}d ` + `(limit ${lowConfidenceMaxDays}d)`,
+                });
+            }
+        }
+        // 5. Deprecated but still linked from a canonical document.
+        if (fm.status === "deprecated") {
+            const linkers = [...(inbound.get(doc.path) ?? [])].filter((from) => byPath.get(from)?.frontmatter.status === "canonical");
+            if (linkers.length > 0) {
+                checks.deprecatedStillLinked.push({
+                    path: doc.path,
+                    detail: `still linked from canonical: ${linkers.sort().join(", ")}`,
+                });
+            }
+        }
+    }
+    const totalFindings = LINT_CHECKS.reduce((n, name) => n + checks[name].length, 0);
+    return ok({ generatedAt: now.toISOString(), checks, totalFindings });
+}
+//# sourceMappingURL=lint.js.map

package/dist/curation/lint.js.map

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

package/dist/curation/provenance.d.ts

@@ -0,0 +1,21 @@
+import type { Frontmatter } from "../frontmatter/types.js";
+import { type Result } from "../frontmatter/types.js";
+export type FrontmatterDiff = Record<string, {
+    before: unknown;
+    after: unknown;
+}>;
+export interface ProvenanceEntry {
+    timestamp: string;
+    tool: string;
+    file: string;
+    agent: string;
+    action: string;
+    frontmatter_diff?: FrontmatterDiff;
+}
+export declare function curationLogPath(vaultRoot: string): string;
+export declare function frontmatterDiff(before: Frontmatter | null, after: Frontmatter): FrontmatterDiff;
+export declare function recordProvenance(vaultRoot: string, entry: Omit<ProvenanceEntry, "timestamp"> & {
+    timestamp?: string;
+}): Promise<Result<ProvenanceEntry, Error>>;
+export declare function readProvenanceLog(vaultRoot: string): Promise<Result<ProvenanceEntry[], Error>>;
+//# sourceMappingURL=provenance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../../src/curation/provenance.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAG/D,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAElF,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,eAAe,CAAC;CACpC;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAKD,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,EAAE,WAAW,GAAG,eAAe,CAW/F;AAID,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACjE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAmBzC;AAKD,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,KAAK,CAAC,CAAC,CAoB3C"}

package/dist/curation/provenance.js

@@ -0,0 +1,80 @@
+// Provenance log — an append-only audit trail of every write to the vault.
+//
+// Each write tool appends one JSON line to .daftari/curation-log.jsonl. The
+// log is advisory: it records what happened, who did it, and how the
+// frontmatter changed, but it never blocks or alters a write. It is local
+// audit state, not vault content — it is git-ignored, not committed.
+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 function curationLogPath(vaultRoot) {
+    return join(vaultRoot, ".daftari", "curation-log.jsonl");
+}
+// Diffs two frontmatter blocks, returning only the fields that changed. A
+// `before` of null means the document is newly created — every field counts
+// as a change from `undefined`.
+export function frontmatterDiff(before, after) {
+    const diff = {};
+    const keys = new Set([...(before ? Object.keys(before) : []), ...Object.keys(after)]);
+    for (const key of keys) {
+        const b = before ? before[key] : undefined;
+        const a = after[key];
+        if (JSON.stringify(b) !== JSON.stringify(a)) {
+            diff[key] = { before: b, after: a };
+        }
+    }
+    return diff;
+}
+// Appends one entry to the curation log. The timestamp is stamped here so
+// callers cannot forget it. Creating the .daftari directory is idempotent.
+export async function recordProvenance(vaultRoot, entry) {
+    const full = {
+        timestamp: entry.timestamp ?? new Date().toISOString(),
+        tool: entry.tool,
+        file: entry.file,
+        agent: entry.agent,
+        action: entry.action,
+        ...(entry.frontmatter_diff && Object.keys(entry.frontmatter_diff).length > 0
+            ? { frontmatter_diff: entry.frontmatter_diff }
+            : {}),
+    };
+    try {
+        mkdirSync(join(vaultRoot, ".daftari"), { recursive: true });
+        await appendFile(curationLogPath(vaultRoot), `${JSON.stringify(full)}\n`);
+        return ok(full);
+    }
+    catch (e) {
+        const reason = e instanceof Error ? e.message : String(e);
+        return err(new Error(`cannot append to curation log: ${reason}`));
+    }
+}
+// Reads the curation log back, oldest entry first. A missing log is not an
+// error — it just means nothing has been written yet. Malformed lines are
+// skipped rather than aborting the read.
+export async function readProvenanceLog(vaultRoot) {
+    let raw;
+    try {
+        raw = await readFile(curationLogPath(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 curation log: ${reason}`));
+    }
+    const entries = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            entries.push(JSON.parse(trimmed));
+        }
+        catch {
+            // skip a corrupt line; the log is append-only and best-effort.
+        }
+    }
+    return ok(entries);
+}
+//# sourceMappingURL=provenance.js.map

package/dist/curation/provenance.js.map

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

package/dist/curation/staleness.d.ts

@@ -0,0 +1,19 @@
+import { type Result } from "../frontmatter/types.js";
+export declare function ageInDays(dateISO: string, now?: Date): number;
+export interface StalenessResult {
+    score: number;
+    ageDays: number;
+    ttlDays: number | null;
+    expired: boolean;
+}
+export declare function computeStaleness(input: {
+    updated: string;
+    ttl_days: number | null;
+}, now?: Date): StalenessResult;
+export interface StaleFile {
+    path: string;
+    title: string;
+    staleness: StalenessResult;
+}
+export declare function listStaleFiles(vaultRoot: string, threshold?: number, now?: Date): Promise<Result<StaleFile[], Error>>;
+//# sourceMappingURL=staleness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.d.ts","sourceRoot":"","sources":["../../src/curation/staleness.ts"],"names":[],"mappings":"AAWA,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAO1D,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAIzE;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAKD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACnD,GAAG,GAAE,IAAiB,GACrB,eAAe,CAejB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,eAAe,CAAC;CAC5B;AAKD,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,SAAI,EACb,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,CAAC,CAAC,CAsBrC"}

package/dist/curation/staleness.js

@@ -0,0 +1,67 @@
+// Staleness — the time-decay half of the advisory curation engine.
+//
+// A document carries an optional `ttl_days` in its frontmatter: a soft
+// expectation of how long the note stays accurate. Staleness measures how far
+// past that expectation a document has drifted, as a decay score from 0.0
+// (just updated) to 1.0 (fully stale — at or past its TTL).
+//
+// This is advisory only. Nothing here edits a file or changes a status; it
+// reports a number the curator (vault_lint, vault_status) can act on.
+import { parseDocument } from "../frontmatter/parser.js";
+import { ok } from "../frontmatter/types.js";
+import { listFiles, readFile, resolveVaultPath } from "../storage/local.js";
+const MS_PER_DAY = 86_400_000;
+// Whole days between an ISO date (YYYY-MM-DD) and `now`. Negative if the date
+// is in the future; NaN-safe — an unparseable date yields 0.
+export function ageInDays(dateISO, now = new Date()) {
+    const then = Date.parse(`${dateISO}T00:00:00Z`);
+    if (Number.isNaN(then))
+        return 0;
+    return Math.floor((now.getTime() - then) / MS_PER_DAY);
+}
+// Computes the decay score for a document from its `updated` date and
+// `ttl_days`. A document with no TTL never goes stale (score 0): it has made
+// no freshness promise to break.
+export function computeStaleness(input, now = new Date()) {
+    const ageDays = ageInDays(input.updated, now);
+    const ttlDays = input.ttl_days;
+    if (ttlDays === null) {
+        return { score: 0, ageDays, ttlDays: null, expired: false };
+    }
+    if (ttlDays <= 0) {
+        // A non-positive TTL means "stale the moment it ages at all".
+        const expired = ageDays > 0;
+        return { score: expired ? 1 : 0, ageDays, ttlDays, expired };
+    }
+    const ratio = ageDays / ttlDays;
+    const score = Math.min(1, Math.max(0, ratio));
+    return { score, ageDays, ttlDays, expired: ageDays >= ttlDays };
+}
+// Scans the whole vault and returns documents whose decay score is at or above
+// `threshold`, most stale first. The default threshold of 1.0 reports only
+// documents at or past their TTL.
+export async function listStaleFiles(vaultRoot, threshold = 1, now = new Date()) {
+    const list = await listFiles(vaultRoot);
+    if (!list.ok)
+        return list;
+    const stale = [];
+    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 staleness = computeStaleness({ updated: fm.updated, ttl_days: fm.ttl_days }, now);
+        if (staleness.score >= threshold) {
+            stale.push({ path: relPath, title: fm.title, staleness });
+        }
+    }
+    stale.sort((a, b) => b.staleness.score - a.staleness.score);
+    return ok(stale);
+}
+//# sourceMappingURL=staleness.js.map

package/dist/curation/staleness.js.map

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