daftari 1.29.0 → 1.31.0

package/dist/tools/tier2.js

@@ -0,0 +1,344 @@
+// vault_tier2_queue / vault_tier2_verdict — the tier-2 protocol surface
+// (#232). The server does NOT run an LLM: the calling agent is the judge.
+// The queue tool prepares the constrained judgments (specific claim against
+// specific usage — never "do these two documents conflict"); the verdict
+// tool records the typed answer and, for a break, logs a real tension
+// through the existing taxonomy. See src/curation/tier2.ts for the model.
+//
+// RBAC (#217): any-read gate on both tools. A queue item names two
+// documents, so it is listed only when the caller can read BOTH — omission,
+// no counts, no coarse remainder (lists omit; only summaries coarsen). A
+// verdict on a pair the caller cannot fully read is refused with the SAME
+// error a pair with nothing pending produces — no existence signal.
+import { hasAnyRead } from "../access/rbac.js";
+import { upstreamStaleness } from "../curation/edge-staleness.js";
+import { listEdges } from "../curation/edges.js";
+import { readProvenanceLog } from "../curation/provenance.js";
+import { addTension, LOGGABLE_TENSION_KINDS, } from "../curation/tension.js";
+import { sourceReadable } from "../curation/tension-access.js";
+import { accumulateFieldChanges, extractUsageSpan, latestUnitChangeTs, NO_CHANGE_TS, readTier2Verdicts, recordTier2Verdict, } from "../curation/tier2.js";
+import { loadDocuments } from "../curation/vault-docs.js";
+import { err, ok } from "../frontmatter/types.js";
+import { canonicalVaultRelPath } from "../storage/local.js";
+import { readRunId } from "../utils/run-id.js";
+import { openIndexForAccessOrNull } from "./search.js";
+async function loadQueueSources(vaultRoot) {
+    const provenance = await readProvenanceLog(vaultRoot);
+    if (!provenance.ok)
+        return provenance;
+    const verdicts = await readTier2Verdicts(vaultRoot);
+    if (!verdicts.ok)
+        return verdicts;
+    const docs = await loadDocuments(vaultRoot);
+    if (!docs.ok)
+        return docs;
+    const edges = await listEdges(vaultRoot);
+    if (!edges.ok)
+        return edges;
+    const earnedByFrom = new Map();
+    for (const e of edges.value) {
+        if (e.status === "revoked")
+            continue;
+        const list = earnedByFrom.get(e.fromPath) ?? [];
+        list.push({ unit: e.toPath, lastRederived: e.lastRederived });
+        earnedByFrom.set(e.fromPath, list);
+    }
+    return ok({
+        provenance: provenance.value,
+        verdicts: verdicts.value,
+        docs: docs.value,
+        earnedByFrom,
+    });
+}
+// The artifact's pending-unchecked rows — the tier-2 residual. Compiled
+// edges are excluded at the source (consumes: []): tier 1 decides them
+// mechanically and they never queue.
+function residualRows(sources, doc) {
+    return upstreamStaleness({
+        artifact: doc.path,
+        consumes: [],
+        provenance: sources.provenance,
+        declaredUnits: doc.frontmatter.sources,
+        earned: sources.earnedByFrom.get(doc.path) ?? [],
+        verdicts: sources.verdicts,
+    }).filter((r) => r.staleness === "pending-unchecked");
+}
+function workItem(sources, doc, row) {
+    const unitDoc = sources.docs.find((d) => d.path === row.unit);
+    const fieldChanges = row.baseline === null
+        ? accumulateFieldChanges(sources.provenance, row.unit, NO_CHANGE_TS)
+        : accumulateFieldChanges(sources.provenance, row.unit, row.baseline);
+    const span = extractUsageSpan(doc.content, {
+        path: row.unit,
+        title: unitDoc?.frontmatter.title,
+    });
+    const changeDesc = row.changed_fields.length > 0
+        ? `changed [${row.changed_fields.join(", ")}]`
+        : "has never been checked against this dependent";
+    return {
+        artifact: doc.path,
+        unit: row.unit,
+        edge_class: row.edge_class,
+        baseline: row.baseline,
+        changed_fields: row.changed_fields,
+        field_changes: fieldChanges,
+        usage_span: span,
+        question: `${row.unit} ${changeDesc}` +
+            `${row.baseline ? ` since ${row.baseline}` : ""}. ${doc.path} depends on it via a ` +
+            `${row.edge_class} edge. Given field_changes and the dependent's usage ` +
+            `(usage_span, or read the documents), does the dependent's claim still hold? ` +
+            `Record the judgment with vault_tier2_verdict: 'still-valid', or 'broken' with a ` +
+            `tension_kind (${LOGGABLE_TENSION_KINDS.join(" | ")}) and both claims.`,
+    };
+}
+export async function vaultTier2Queue(vaultRoot, args, access) {
+    if (access && !hasAnyRead(access.role)) {
+        return err(new Error(`access denied: role '${access.roleName}' cannot use vault_tier2_queue`));
+    }
+    let unitFilter = null;
+    if (args.unit !== undefined && args.unit !== null) {
+        if (typeof args.unit !== "string" || args.unit.trim().length === 0) {
+            return err(new Error("vault_tier2_queue 'unit' must be a non-empty string"));
+        }
+        const canon = canonicalVaultRelPath(vaultRoot, args.unit);
+        if (!canon.ok)
+            return canon;
+        unitFilter = canon.value;
+    }
+    const sources = await loadQueueSources(vaultRoot);
+    if (!sources.ok)
+        return sources;
+    const db = access ? openIndexForAccessOrNull(vaultRoot) : null;
+    try {
+        const items = [];
+        for (const doc of sources.value.docs) {
+            // #217 omission: an item names both endpoints, so both must be
+            // readable. An unreadable artifact drops with all its rows; an
+            // unreadable unit drops that row. No counts, no remainder.
+            if (access && !sourceReadable(db, access, doc.path))
+                continue;
+            for (const row of residualRows(sources.value, doc)) {
+                if (unitFilter !== null && row.unit !== unitFilter)
+                    continue;
+                if (access && !sourceReadable(db, access, row.unit))
+                    continue;
+                items.push(workItem(sources.value, doc, row));
+            }
+        }
+        items.sort((a, b) => a.unit.localeCompare(b.unit) || a.artifact.localeCompare(b.artifact));
+        return ok({ items, total: items.length });
+    }
+    finally {
+        db?.close();
+    }
+}
+export async function vaultTier2Verdict(vaultRoot, args, access) {
+    if (access && !hasAnyRead(access.role)) {
+        return err(new Error(`access denied: role '${access.roleName}' cannot use vault_tier2_verdict`));
+    }
+    const str = (field) => {
+        const v = args[field];
+        if (typeof v !== "string" || v.trim().length === 0) {
+            return err(new Error(`vault_tier2_verdict requires a non-empty '${field}' argument`));
+        }
+        return ok(v.trim());
+    };
+    const artifactRaw = str("artifact");
+    if (!artifactRaw.ok)
+        return artifactRaw;
+    const unitRaw = str("unit");
+    if (!unitRaw.ok)
+        return unitRaw;
+    const reasoning = str("reasoning");
+    if (!reasoning.ok)
+        return reasoning;
+    const agent = str("agent");
+    if (!agent.ok)
+        return agent;
+    const verdict = args.verdict;
+    if (verdict !== "still-valid" && verdict !== "broken") {
+        return err(new Error("vault_tier2_verdict 'verdict' must be 'still-valid' or 'broken'"));
+    }
+    const runId = readRunId(args, "vault_tier2_verdict");
+    if (!runId.ok)
+        return runId;
+    let tensionKind = null;
+    let claimArtifact = null;
+    let claimUnit = null;
+    if (verdict === "broken") {
+        const kind = args.tension_kind;
+        if (typeof kind !== "string" || !LOGGABLE_TENSION_KINDS.includes(kind)) {
+            return err(new Error(`a 'broken' verdict requires 'tension_kind' — one of: ${LOGGABLE_TENSION_KINDS.join(", ")}`));
+        }
+        tensionKind = kind;
+        const ca = str("claim_artifact");
+        if (!ca.ok)
+            return ca;
+        const cu = str("claim_unit");
+        if (!cu.ok)
+            return cu;
+        claimArtifact = ca.value;
+        claimUnit = cu.value;
+    }
+    else if (args.tension_kind !== undefined) {
+        return err(new Error("'tension_kind' applies only to a 'broken' verdict"));
+    }
+    const artifact = canonicalVaultRelPath(vaultRoot, artifactRaw.value);
+    if (!artifact.ok)
+        return artifact;
+    const unit = canonicalVaultRelPath(vaultRoot, unitRaw.value);
+    if (!unit.ok)
+        return unit;
+    const noPendingError = () => err(new Error(`vault_tier2_verdict: no pending semantic review for ${artifact.value} ← ${unit.value}` +
+        ` — see vault_tier2_queue`));
+    // Disclosure: a pair the caller cannot fully read is refused with the
+    // exact error a pair with nothing pending produces — decided BEFORE any
+    // queue state is computed, so the response cannot depend on it.
+    if (access) {
+        const db = openIndexForAccessOrNull(vaultRoot);
+        try {
+            if (!sourceReadable(db, access, artifact.value) || !sourceReadable(db, access, unit.value)) {
+                return noPendingError();
+            }
+        }
+        finally {
+            db?.close();
+        }
+    }
+    const sources = await loadQueueSources(vaultRoot);
+    if (!sources.ok)
+        return sources;
+    const doc = sources.value.docs.find((d) => d.path === artifact.value);
+    const candidates = doc
+        ? residualRows(sources.value, doc).filter((r) => r.unit === unit.value)
+        : [];
+    if (candidates.length === 0)
+        return noPendingError();
+    let row;
+    if (args.edge_class !== undefined && args.edge_class !== null) {
+        const match = candidates.find((r) => r.edge_class === args.edge_class);
+        if (!match)
+            return noPendingError();
+        row = match;
+    }
+    else if (candidates.length === 1) {
+        row = candidates[0];
+    }
+    else {
+        return err(new Error(`vault_tier2_verdict: ${artifact.value} ← ${unit.value} is pending on several edge ` +
+            `classes (${candidates.map((r) => r.edge_class).join(", ")}) — pass 'edge_class'`));
+    }
+    // A break is a real tension, logged through the existing taxonomy — the
+    // durable, caller-visible artifact of the judgment.
+    let tensionId = null;
+    if (verdict === "broken" && tensionKind && claimArtifact && claimUnit) {
+        const tension = await addTension(vaultRoot, {
+            title: `tier-2: ${unit.value} change breaks ${artifact.value}`,
+            kind: tensionKind,
+            sourceA: artifact.value,
+            claimA: claimArtifact,
+            sourceB: unit.value,
+            claimB: claimUnit,
+            loggedBy: agent.value,
+        });
+        if (!tension.ok)
+            return tension;
+        tensionId = tension.value.id ?? null;
+    }
+    const recorded = await recordTier2Verdict(vaultRoot, {
+        artifact: artifact.value,
+        unit: unit.value,
+        edge_class: row.edge_class,
+        judged_change_ts: latestUnitChangeTs(sources.value.provenance, unit.value) ?? NO_CHANGE_TS,
+        verdict,
+        ...(tensionKind ? { tension_kind: tensionKind } : {}),
+        ...(tensionId ? { tension_id: tensionId } : {}),
+        reasoning: reasoning.value,
+        agent: agent.value,
+        ...(access?.user != null ? { principal: access.user } : {}),
+        ...(runId.value ? { run_id: runId.value } : {}),
+    });
+    if (!recorded.ok) {
+        return err(new Error(`${recorded.error.message}${tensionId ? ` (tension ${tensionId} was already logged)` : ""}`));
+    }
+    return ok({ recorded: recorded.value, tension_id: tensionId });
+}
+export const tier2Tools = [
+    {
+        name: "vault_tier2_queue",
+        title: "Semantic-review queue (tier 2)",
+        annotations: { readOnlyHint: true },
+        description: "The tier-2 semantic-review queue (#232): every declared/earned " +
+            "dependency whose upstream changed but whose compatibility the " +
+            "structure could not decide (tier 1's residual — #234's " +
+            "pending-unchecked class), minus pairs an existing verdict already " +
+            "covers. Each item is a CONSTRAINED judgment: the net per-field " +
+            "before/after since the edge's baseline, the dependent's usage span, " +
+            "and the specific question to answer — never 'do these documents " +
+            "conflict'. YOU are the judge: answer items with vault_tier2_verdict. " +
+            "Pass 'unit' to scope the queue to one changed document. Compiled " +
+            "edges never appear — tier 1 decides them mechanically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                unit: {
+                    type: "string",
+                    description: "Optional vault-relative path: only items judging this changed document",
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (vaultRoot, args, access) => vaultTier2Queue(vaultRoot, args, access),
+    },
+    {
+        name: "vault_tier2_verdict",
+        title: "Record a tier-2 semantic verdict",
+        annotations: { readOnlyHint: false, idempotentHint: false },
+        description: "Record the answer to a vault_tier2_queue item (#232 tier 2). " +
+            "verdict 'still-valid' certifies the dependent's use of the changed " +
+            "unit still holds; 'broken' requires a tension_kind from the tension " +
+            "taxonomy plus claim_artifact/claim_unit, and logs a real tension via " +
+            "the existing machinery (the tension id is returned). The verdict " +
+            "covers the unit's CURRENT change only — a later write to the unit " +
+            "re-queues the pair automatically. Refused when the pair has nothing " +
+            "pending. Staleness surfaces (vault_staleness) read verdicts: a " +
+            "covered pair reports pending-compatible or pending-broken instead " +
+            "of pending-unchecked.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                artifact: { type: "string", description: "The dependent document being judged" },
+                unit: { type: "string", description: "The changed upstream it was judged against" },
+                edge_class: {
+                    type: "string",
+                    enum: ["declared", "earned"],
+                    description: "Required only when the pair is pending on both classes",
+                },
+                verdict: { type: "string", enum: ["still-valid", "broken"] },
+                tension_kind: {
+                    type: "string",
+                    enum: [...LOGGABLE_TENSION_KINDS],
+                    description: "Required for 'broken': the tension taxonomy kind",
+                },
+                claim_artifact: {
+                    type: "string",
+                    description: "For 'broken': what the dependent asserts (becomes the tension's claimA)",
+                },
+                claim_unit: {
+                    type: "string",
+                    description: "For 'broken': what the changed unit now says (becomes claimB)",
+                },
+                reasoning: { type: "string", description: "The judgment's reasoning, recorded verbatim" },
+                agent: {
+                    type: "string",
+                    description: "Judging agent's identity, e.g. agent:curation-loop",
+                },
+                run_id: { type: "string", description: "Optional trace/run identifier of the calling run" },
+            },
+            required: ["artifact", "unit", "verdict", "reasoning", "agent"],
+            additionalProperties: false,
+        },
+        handler: (vaultRoot, args, access) => vaultTier2Verdict(vaultRoot, args, access),
+    },
+];
+//# sourceMappingURL=tier2.js.map

package/dist/tools/tier2.js.map

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

package/dist/tools/witness.d.ts

@@ -0,0 +1,9 @@
+import { type AccessContext } from "../access/rbac.js";
+import { type Result } from "../frontmatter/types.js";
+import { type WitnessResult } from "../witness/track-record.js";
+import type { ToolDefinition } from "./read.js";
+export declare function vaultWitness(vaultRoot: string, args: Record<string, unknown>, access?: AccessContext): Promise<Result<WitnessResult | {
+    principal: unknown;
+}, Error>>;
+export declare const witnessTools: ToolDefinition[];
+//# sourceMappingURL=witness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"witness.d.ts","sourceRoot":"","sources":["../../src/tools/witness.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,aAAa,GAAG;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,EAAE,KAAK,CAAC,CAAC,CAwBhE;AAED,eAAO,MAAM,YAAY,EAAE,cAAc,EAkCxC,CAAC"}

package/dist/tools/witness.js

@@ -0,0 +1,66 @@
+// vault_witness — per-principal track records from the ledger, priced by
+// the wager schedule. Read-only: the witness testifies from what the vault
+// already recorded (provenance, tensions, staged actions); it never grades
+// beyond deterministic arithmetic on exported provisional constants, and it
+// never enforces — routing a write by a track record is the caller's
+// judgment, not the vault's.
+import { hasAnyRead } from "../access/rbac.js";
+import { err, ok } from "../frontmatter/types.js";
+import { buildWitness } from "../witness/track-record.js";
+export async function vaultWitness(vaultRoot, args, access) {
+    if (access && !hasAnyRead(access.role)) {
+        return err(new Error(`access denied: role '${access.roleName}' cannot use vault_witness`));
+    }
+    const witness = await buildWitness(vaultRoot, new Date(), access);
+    if (!witness.ok)
+        return witness;
+    if (args.principal !== undefined) {
+        if (typeof args.principal !== "string" || args.principal.length === 0) {
+            return err(new Error("vault_witness 'principal' must be a non-empty string"));
+        }
+        const match = witness.value.principals.find((p) => p.principal === args.principal);
+        if (!match) {
+            return err(new Error(`vault_witness: no record for principal '${args.principal}'`));
+        }
+        return ok({
+            principal: match,
+            concentration: witness.value.concentration,
+            flatCurveWarning: witness.value.flatCurveWarning,
+        });
+    }
+    return witness;
+}
+export const witnessTools = [
+    {
+        name: "vault_witness",
+        title: "Per-principal track records",
+        annotations: { readOnlyHint: true },
+        description: "Per-principal track records aggregated from the vault's own ledgers " +
+            "(provenance log, tension log, staged actions), priced by the wager " +
+            "schedule: writing a claim at a confidence level stakes points " +
+            "(low 0 / medium 1 / high 3, provisional); a claim later corrected or " +
+            "retired burns the stake; a claim maintained through a full TTL cycle " +
+            "earns credit. Returns, per principal: write volume and span, docs " +
+            "authored, live claims with open exposure, contested claims with " +
+            "stake at risk, the settled book (lost/burned vs survived/credited, " +
+            "balance), proposal outcomes (ratified/rejected/expired), and tensions " +
+            "logged. Includes the flat-curve monitor: when one principal holds " +
+            "≥95% of writes, track records are declared uninformative rather than " +
+            "reported as signal. Read-only, deterministic, advisory — nothing is " +
+            "enforced and no document is touched. Pass 'principal' to fetch one " +
+            "record.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                principal: {
+                    type: "string",
+                    description: "Optional identity to fetch a single record for, e.g. " +
+                        "agent:claude-code or human:mihir.",
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (vaultRoot, args, access) => vaultWitness(vaultRoot, args, access),
+    },
+];
+//# sourceMappingURL=witness.js.map

package/dist/tools/witness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"witness.js","sourceRoot":"","sources":["../../src/tools/witness.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,2EAA2E;AAC3E,2EAA2E;AAC3E,4EAA4E;AAC5E,qEAAqE;AACrE,6BAA6B;AAE7B,OAAO,EAAsB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAsB,MAAM,4BAA4B,CAAC;AAG9E,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAiB,EACjB,IAA6B,EAC7B,MAAsB;IAEtB,IAAI,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,QAAQ,4BAA4B,CAAC,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IAClE,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC;IAEhC,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtE,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC,CAAC;QAChF,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC;QACnF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,2CAA2C,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,EAAE,CAAC;YACR,SAAS,EAAE,KAAK;YAChB,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,aAAa;YAC1C,gBAAgB,EAAE,OAAO,CAAC,KAAK,CAAC,gBAAgB;SACZ,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QACnC,WAAW,EACT,sEAAsE;YACtE,qEAAqE;YACrE,gEAAgE;YAChE,uEAAuE;YACvE,uEAAuE;YACvE,oEAAoE;YACpE,kEAAkE;YAClE,qEAAqE;YACrE,wEAAwE;YACxE,oEAAoE;YACpE,uEAAuE;YACvE,sEAAsE;YACtE,qEAAqE;YACrE,SAAS;QACX,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,uDAAuD;wBACvD,mCAAmC;iBACtC;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC;KAC5E;CACF,CAAC"}

package/dist/tools/write.d.ts

@@ -6,7 +6,7 @@ export declare function applyExtensionDefaults(raw: Record<string, unknown>, ext
 export declare function serializeDocument(fm: Frontmatter, body: string, extensions?: SchemaExtension[], raw?: Record<string, unknown>): string;
 export interface WriteResult {
     path: string;
-    action: "create" | "update" | "append" | "promote" | "deprecate" | "supersede" | "merge" | "confidence-set";
+    action: "create" | "update" | "append" | "promote" | "deprecate" | "supersede" | "merge" | "confidence-set" | "tier-set" | "staged";
     commit: string | null;
     committed: boolean;
     status: string;
@@ -14,12 +14,20 @@ export interface WriteResult {
     validation: ValidationReport;
     indexUpdated: boolean;
     shadow?: boolean;
+    supersede_hint?: string;
+    domain_warnings?: string[];
+    staged_id?: string;
+    expires_at?: string;
+    conflicts_with?: string[];
+    tension_id?: string | null;
+    tension_error?: string;
 }
 export declare function vaultWrite(vaultRoot: string, args: Record<string, unknown>, access?: AccessContext): Promise<Result<WriteResult, Error>>;
 export declare function vaultAppend(vaultRoot: string, args: Record<string, unknown>, access?: AccessContext): Promise<Result<WriteResult, Error>>;
 export declare function vaultPromote(vaultRoot: string, args: Record<string, unknown>, access?: AccessContext): Promise<Result<WriteResult, Error>>;
 export declare function vaultDeprecate(vaultRoot: string, args: Record<string, unknown>, access?: AccessContext): Promise<Result<WriteResult, Error>>;
 export declare function vaultSetConfidence(vaultRoot: string, args: Record<string, unknown>, access?: AccessContext): Promise<Result<WriteResult, Error>>;
+export declare function vaultSetTier(vaultRoot: string, args: Record<string, unknown>, access?: AccessContext): Promise<Result<WriteResult, Error>>;
 export declare function vaultSupersede(vaultRoot: string, args: Record<string, unknown>, access?: AccessContext): Promise<Result<WriteResult, Error>>;
 export declare function vaultMerge(vaultRoot: string, args: Record<string, unknown>, access?: AccessContext): Promise<Result<WriteResult, Error>>;
 export declare const writeTools: ToolDefinition[];

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

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