@nikovirtala/adr 0.3.0 → 0.4.0

package/dist/types/write.d.ts

@@ -4,7 +4,7 @@ import { type DecisionLog, type DecisionsRead } from "./log.js";
 /** `adr <write command> --json` (design §5.5, §6.1). */
 export interface WriteResultJson {
     readonly format: "adr-write/v1";
-    readonly command: "new" | "accept" | "supersede" | "reject" | "withdraw" | "deprecate" | "note" | "link" | "scope";
+    readonly command: "new" | "accept" | "supersede" | "reject" | "withdraw" | "deprecate" | "note" | "link" | "scope" | "update";
     readonly ok: boolean;
     /**
      * The decision after the write; before it when `ok` is false (`null` for a refused `new`).
@@ -68,6 +68,14 @@ export interface WritePlan {
     readonly subject: string;
     /** New files, repo-relative path → bytes, in write order: body, materialized template, events. */
     readonly files: Readonly<Record<string, Uint8Array>>;
+    /**
+     * Existing files to replace, path → the new bytes and the bytes the plan read; written only if
+     * the file still holds `expected` (a draft update).
+     */
+    readonly replace?: Readonly<Record<string, {
+        readonly bytes: Uint8Array;
+        readonly expected: Uint8Array;
+    }>>;
     readonly events: readonly EventEnvelope[];
     /** Paths to stage: every new file, plus the existing body for accept. */
     readonly stage: readonly string[];
@@ -126,6 +134,21 @@ export type PlanResult = {
 export declare function planPropose(read: DecisionsRead, input: ProposeInput, c: PlanContext, o?: {
     readonly refuseIncomplete?: boolean;
 }): Promise<PlanResult>;
+/** Input of a draft update: the decision and the sections to replace (section id → markdown). */
+export interface UpdateDraftInput {
+    readonly id: string;
+    readonly sections: Readonly<Record<string, string>>;
+}
+/**
+ * Plans a draft update (design §6.6): the given sections of a proposed decision's body replaced in
+ * place, every other line kept, written only if the body still holds the bytes read. Refused
+ * (`ok: false`) when the decision isn't proposed or its body or template version is missing or
+ * unreadable, and with `refuseIncomplete` when the new draft fails its template lint. An unknown
+ * section, a missing heading or a heading in the content is a `UsageError`.
+ */
+export declare function planUpdateDraft(read: DecisionsRead, input: UpdateDraftInput, c: PlanContext, o?: {
+    readonly refuseIncomplete?: boolean;
+}): Promise<PlanResult>;
 /** Plans `adr accept`: `accepted` with the body hash, and `superseded` on each declared target. */
 export declare function planAccept(read: DecisionsRead, input: {
     readonly id: string;
@@ -250,6 +273,13 @@ export interface AppliedPlan {
  * 2b D5): the batch is already in the log, so a rerun is refused, writes nothing or duplicates it.
  */
 export declare const WRITE_RERUN = "Don't run the command again: the log already holds the change, so a rerun would be refused, do nothing, or write it a second time.";
+/**
+ * Applies a plan (§5.4): refuses a commit whose scope has unstaged or needed untracked paths,
+ * writes the files (removing them again if a write fails), stages them, runs `afterStage`, and
+ * commits `plan.stage` plus the involved subjects' already-staged files with exact trailers. A
+ * failed `git commit` throws `CommitFailedError` with the manual command (design 2b D5) and the
+ * notes made so far.
+ */
 export declare function applyPlan(log: DecisionLog, plan: WritePlan, o: {
     readonly commit: boolean;
     /** The commit message, without trailers; required when committing. */
@@ -336,6 +366,14 @@ export declare function linkDecision(log: DecisionLog, input: LinkInput, o?: Wri
  * and commits with `commit`. An unchanged set writes nothing.
  */
 export declare function scopeDecision(log: DecisionLog, input: ScopeInput, o?: WriteOptions, deps?: WriteDeps): Promise<WriteResultJson>;
+/**
+ * Replaces sections of a proposed decision's draft (design §6.6), stages the body, and commits
+ * with `commit` (default `[policy] auto_commit`). A body with unstaged changes is a `UsageError`,
+ * so nobody's unsaved edit is folded into this write; a body changed between plan and write is
+ * `FileChangedError`. A commit is never made of a draft that fails its template lint: it is
+ * refused (`ok: false`, nothing written), as for `proposeDecision` without an editor.
+ */
+export declare function updateDraft(log: DecisionLog, input: UpdateDraftInput, o?: WriteOptions, deps?: WriteDeps): Promise<WriteResultJson>;
 /**
  * `adr scope [<decision>] --follow-renames` (design §6.8): rewrites the scope globs of the given
  * decision, or of every decision, after the renames staged against `HEAD`, and stages one

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nikovirtala/adr",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Architecture decision records kept as event logs in git: frozen bodies, computed status and supersession chains. CLI and library.",
   "keywords": [
     "adr",
@@ -45,7 +45,10 @@
     "provenance": true
   },
   "dependencies": {
-    "@nikovirtala/ledger": "^0.5.0"
+    "@nikovirtala/ledger": "^0.6.0"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "1.32.2"
   },
   "scripts": {
     "build": "tsdown",