@schnick371/devsteps-shared 1.1.0-next.3 → 2.0.0-next.1

package/dist/core/unlink.js

@@ -5,27 +5,16 @@
  * Core unlink operation
  * Removes a relationship between two work items and updates both sides.
  */
-import { writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { getCurrentTimestamp, parseItemId, TYPE_TO_DIRECTORY } from '../utils/index.js';
+import { getCurrentTimestamp, parseItemId } from '../utils/index.js';
 import { getItem } from './get.js';
-/** Bi-directional inverse relation map. */
-const INVERSE_RELATIONS = {
-    implements: 'implemented-by',
-    'implemented-by': 'implements',
-    'tested-by': 'tests',
-    tests: 'tested-by',
-    blocks: 'blocked-by',
-    'blocked-by': 'blocks',
-    'depends-on': 'required-by',
-    'required-by': 'depends-on',
-    'relates-to': 'relates-to',
-    supersedes: 'superseded-by',
-    'superseded-by': 'supersedes',
-};
+import { listItemIds, writeItemMetadata } from './item-store.js';
+import { withRelationshipLock } from './relationship-lock.js';
+import { INVERSE_RELATIONS } from './relationship-map.js';
 /**
  * Remove a relationship between two items bi-directionally.
  * Idempotent: calling when the relation already does not exist returns success.
+ * A target that no longer exists has no inverse to remove, so only the source's dangling entry
+ * goes, which is the repair `doctor` advises for a broken reference (BUG-145).
  */
 export async function unlinkItem(devstepsDir, args) {
     const { sourceId, relationType, targetId } = args;
@@ -35,44 +24,61 @@ export async function unlinkItem(devstepsDir, args) {
         throw new Error(`Invalid source item ID: ${sourceId}`);
     if (!targetParsed)
         throw new Error(`Invalid target item ID: ${targetId}`);
-    const sourceFolder = TYPE_TO_DIRECTORY[sourceParsed.type];
-    const targetFolder = TYPE_TO_DIRECTORY[targetParsed.type];
-    const sourcePath = join(devstepsDir, sourceFolder, `${sourceId}.json`);
-    const targetPath = join(devstepsDir, targetFolder, `${targetId}.json`);
-    // Load both items (getItem throws on not-found)
-    const { metadata: sourceMeta } = await getItem(devstepsDir, sourceId);
-    const { metadata: targetMeta } = await getItem(devstepsDir, targetId);
-    let changed = false;
-    // Remove targetId from source's relation array
-    const sourceLinks = sourceMeta.linked_items;
-    const sourceArray = sourceLinks[relationType];
-    const sourceIdx = sourceArray.indexOf(targetId);
-    if (sourceIdx !== -1) {
-        sourceArray.splice(sourceIdx, 1);
-        sourceMeta.updated = getCurrentTimestamp();
-        writeFileSync(sourcePath, JSON.stringify(sourceMeta, null, 2));
-        changed = true;
-    }
-    // Remove sourceId from target's inverse relation array
-    const inverseRelation = INVERSE_RELATIONS[relationType];
-    const targetLinks = targetMeta.linked_items;
-    const targetArray = targetLinks[inverseRelation];
-    const targetIdx = targetArray.indexOf(sourceId);
-    if (targetIdx !== -1) {
-        targetArray.splice(targetIdx, 1);
-        targetMeta.updated = getCurrentTimestamp();
-        writeFileSync(targetPath, JSON.stringify(targetMeta, null, 2));
-        changed = true;
-    }
-    const message = changed
-        ? `Unlinked ${sourceId} -/${relationType}/-> ${targetId}`
-        : `Relation ${sourceId} --${relationType}--> ${targetId} was not present (no-op)`;
-    return {
-        success: true,
-        message,
-        sourceId,
-        targetId,
-        relation: relationType,
-    };
+    return withRelationshipLock([sourceId, targetId], async () => {
+        // Load both items (getItem throws on not-found); the stamps guard the writes (STORY-428)
+        const { metadata: sourceMeta, stamp: sourceStamp } = await getItem(devstepsDir, sourceId);
+        if (!listItemIds(devstepsDir, targetParsed.type).includes(targetId)) {
+            const links = sourceMeta.linked_items;
+            const dangling = links[relationType].includes(targetId);
+            if (dangling) {
+                links[relationType] = links[relationType].filter((id) => id !== targetId);
+                sourceMeta.updated = getCurrentTimestamp();
+                writeItemMetadata(devstepsDir, sourceMeta, sourceStamp);
+            }
+            return {
+                success: true,
+                message: dangling
+                    ? `Target ${targetId} is missing - dangling relation ${sourceId} --${relationType}--> ${targetId} removed`
+                    : `Target ${targetId} is missing and ${sourceId} has no ${relationType} relation to it (no-op)`,
+                sourceId,
+                targetId,
+                relation: relationType,
+                target_missing: true,
+            };
+        }
+        const { metadata: targetMeta, stamp: targetStamp } = await getItem(devstepsDir, targetId);
+        let changed = false;
+        // Remove targetId from source's relation array
+        const sourceLinks = sourceMeta.linked_items;
+        const sourceArray = sourceLinks[relationType];
+        const sourceIdx = sourceArray.indexOf(targetId);
+        if (sourceIdx !== -1) {
+            sourceArray.splice(sourceIdx, 1);
+            sourceMeta.updated = getCurrentTimestamp();
+            writeItemMetadata(devstepsDir, sourceMeta, sourceStamp);
+            changed = true;
+        }
+        // Remove sourceId from target's inverse relation array
+        const inverseRelation = INVERSE_RELATIONS[relationType];
+        const targetLinks = targetMeta.linked_items;
+        const targetArray = targetLinks[inverseRelation];
+        const targetIdx = targetArray.indexOf(sourceId);
+        if (targetIdx !== -1) {
+            targetArray.splice(targetIdx, 1);
+            targetMeta.updated = getCurrentTimestamp();
+            writeItemMetadata(devstepsDir, targetMeta, targetStamp);
+            changed = true;
+        }
+        const message = changed
+            ? `Unlinked ${sourceId} -/${relationType}/-> ${targetId}`
+            : `Relation ${sourceId} --${relationType}--> ${targetId} was not present (no-op)`;
+        return {
+            success: true,
+            message,
+            sourceId,
+            targetId,
+            relation: relationType,
+        };
+    });
 }
 //# sourceMappingURL=unlink.js.map

package/dist/core/unlink.js.map

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

package/dist/core/update-category-receipt.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * BUG-236: moving a classified item into another category needs the receipt of the
+ * target leaf, as add does. The check is the add gate's own `requireLeaf`.
+ */
+/**
+ * Throws a ClassificationGateError (`missing_receipt` / `stale_receipt`) when `id` moves from
+ * `from` into the registry node `target` of a category-required type without the current receipt
+ * of the target leaf. Unchanged categories, other types and projects without a registry pass.
+ */
+export declare function requireMoveReceipt(devstepsDir: string, move: {
+    id: string;
+    type: string;
+    from: string | undefined;
+    target: string;
+}, receipt: string | undefined): Promise<void>;
+//# sourceMappingURL=update-category-receipt.d.ts.map

package/dist/core/update-category-receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-category-receipt.d.ts","sourceRoot":"","sources":["../../src/core/update-category-receipt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC5E,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/core/update-category-receipt.js

@@ -0,0 +1,25 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * BUG-236: moving a classified item into another category needs the receipt of the
+ * target leaf, as add does. The check is the add gate's own `requireLeaf`.
+ */
+import { requireLeaf } from './classification-gate.js';
+import { loadClassificationRegistry } from './classification-registry.js';
+/**
+ * Throws a ClassificationGateError (`missing_receipt` / `stale_receipt`) when `id` moves from
+ * `from` into the registry node `target` of a category-required type without the current receipt
+ * of the target leaf. Unchanged categories, other types and projects without a registry pass.
+ */
+export async function requireMoveReceipt(devstepsDir, move, receipt) {
+    const registry = loadClassificationRegistry(devstepsDir);
+    const required = registry.source === 'project' && (registry.required.category ?? []).includes(move.type);
+    if (!required || move.from === move.target || !registry.category[move.target])
+        return;
+    await requireLeaf(devstepsDir, registry, { type: move.type, leaf_receipt: receipt }, move.target, [], (leaf_receipt) => ({
+        tool: 'update',
+        arguments: { id: move.id, category: move.target, leaf_receipt },
+    }));
+}
+//# sourceMappingURL=update-category-receipt.js.map

package/dist/core/update-category-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-category-receipt.js","sourceRoot":"","sources":["../../src/core/update-category-receipt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,IAA4E,EAC5E,OAA2B;IAE3B,MAAM,QAAQ,GAAG,0BAA0B,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,QAAQ,GACZ,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1F,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO;IAEtF,MAAM,WAAW,CACf,WAAW,EACX,QAAQ,EACR,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,EAC1C,IAAI,CAAC,MAAM,EACX,EAAE,EACF,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACjB,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE;KAChE,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/core/update-category.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Category resolution for updateItem.
+ */
+/**
+ * STORY-421: a required type may only take a registry node; other types keep
+ * free values but are canonicalised when they happen to name a node.
+ */
+export declare function resolveCategoryForUpdate(devstepsDir: string, type: string, value: string): string;
+//# sourceMappingURL=update-category.d.ts.map

package/dist/core/update-category.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-category.d.ts","sourceRoot":"","sources":["../../src/core/update-category.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA2CjG"}

package/dist/core/update-category.js

@@ -0,0 +1,59 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Category resolution for updateItem.
+ */
+import { ClassificationGateError } from './classification-gate.js';
+import { loadClassificationRegistry, UNCLASSIFIED } from './classification-registry.js';
+import { resolveNode } from './classification-resolve.js';
+/**
+ * STORY-421: a required type may only take a registry node; other types keep
+ * free values but are canonicalised when they happen to name a node.
+ */
+export function resolveCategoryForUpdate(devstepsDir, type, value) {
+    const registry = loadClassificationRegistry(devstepsDir);
+    const required = registry.source === 'project' && (registry.required.category ?? []).includes(type);
+    const given = value.trim();
+    if (!given || given === UNCLASSIFIED) {
+        if (!required)
+            return UNCLASSIFIED;
+        throw new ClassificationGateError(`A ${type} needs a category from the registry`, {
+            kind: 'missing_category',
+            nodes: Object.entries(registry.category).map(([name, spec]) => ({
+                name,
+                q: spec.q,
+                status: spec.status,
+                open_count: 0,
+            })),
+            hint: 'Pass a registry category.',
+        });
+    }
+    const resolution = resolveNode(registry.category, given);
+    if (resolution.kind === 'resolved') {
+        const spec = registry.category[resolution.node];
+        if (required && spec.status === 'deprecated') {
+            throw new ClassificationGateError(`Category "${resolution.node}" is deprecated`, {
+                kind: 'deprecated_category',
+                category: resolution.node,
+                successors: spec.superseded_by ?? [],
+                hint: 'Choose one of the successors.',
+            });
+        }
+        return resolution.node;
+    }
+    if (!required)
+        return given;
+    throw new ClassificationGateError(`Unknown category "${given}"`, {
+        kind: 'unknown_category',
+        category: given,
+        candidates: resolution.candidates.map((c) => ({
+            name: c.node,
+            q: registry.category[c.node]?.q,
+            status: registry.category[c.node]?.status,
+            open_count: 0,
+        })),
+        hint: 'Use one of the candidates, or declare the category through add with new_node.',
+    });
+}
+//# sourceMappingURL=update-category.js.map

package/dist/core/update-category.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-category.js","sourceRoot":"","sources":["../../src/core/update-category.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAmB,EAAE,IAAY,EAAE,KAAa;IACvF,MAAM,QAAQ,GAAG,0BAA0B,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,QAAQ,GACZ,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrF,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;QACrC,IAAI,CAAC,QAAQ;YAAE,OAAO,YAAY,CAAC;QACnC,MAAM,IAAI,uBAAuB,CAAC,KAAK,IAAI,qCAAqC,EAAE;YAChF,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9D,IAAI;gBACJ,CAAC,EAAE,IAAI,CAAC,CAAC;gBACT,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,UAAU,EAAE,CAAC;aACd,CAAC,CAAC;YACH,IAAI,EAAE,2BAA2B;SAClC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACzD,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAC7C,MAAM,IAAI,uBAAuB,CAAC,aAAa,UAAU,CAAC,IAAI,iBAAiB,EAAE;gBAC/E,IAAI,EAAE,qBAAqB;gBAC3B,QAAQ,EAAE,UAAU,CAAC,IAAI;gBACzB,UAAU,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE;gBACpC,IAAI,EAAE,+BAA+B;aACtC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,UAAU,CAAC,IAAI,CAAC;IACzB,CAAC;IACD,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,MAAM,IAAI,uBAAuB,CAAC,qBAAqB,KAAK,GAAG,EAAE;QAC/D,IAAI,EAAE,kBAAkB;QACxB,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM;YACzC,UAAU,EAAE,CAAC;SACd,CAAC,CAAC;QACH,IAAI,EAAE,+EAA+E;KACtF,CAAC,CAAC;AACL,CAAC"}

package/dist/core/update-reminders.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Reminders of an update (EPIC-059): reads what the pure rules need (the master document after
+ * the write, the review queue) and returns their messages for the update warnings.
+ */
+import type { ItemMetadata, ItemStatus } from '../schemas/index.js';
+/** Every work item in review, in ID order; decisions, questions and docs are left out. */
+export declare function reviewQueue(devstepsDir: string): string[];
+export interface UpdateReminderInput {
+    /** The metadata as written. */
+    metadata: ItemMetadata;
+    oldStatus: ItemStatus;
+    /** The status the update set, also when it equals the old one. */
+    status?: ItemStatus;
+    superseded_by?: string;
+    descriptionChanged: boolean;
+    descriptionAppended?: boolean;
+    /** True when the update set the title. */
+    titleChanged?: boolean;
+    descriptionPath: string;
+    /** False leaves the batch reminder to the caller, as the bulk path does. */
+    batchReminder: boolean;
+}
+/** The reminders of one written update: decision and question rules, then the write rules. */
+export declare function updateReminders(devstepsDir: string, input: UpdateReminderInput): string[];
+/** The one batch reminder of a bulk update that moved at least one work item to review. */
+export declare function bulkBatchReminder(devstepsDir: string, movedToReview: boolean): string | null;
+//# sourceMappingURL=update-reminders.d.ts.map

package/dist/core/update-reminders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-reminders.d.ts","sourceRoot":"","sources":["../../src/core/update-reminders.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAUpE,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAMzD;AAED,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,UAAU,CAAC;IACtB,kEAAkE;IAClE,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,0CAA0C;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAwBzF;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAG5F"}

package/dist/core/update-reminders.js

@@ -0,0 +1,48 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Reminders of an update (EPIC-059): reads what the pure rules need (the master document after
+ * the write, the review queue) and returns their messages for the update warnings.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { decisionQuestionStatusReminders } from './decision-question-status.js';
+import { readAllItemMetadata } from './item-store.js';
+import { batchRunDiagnostic, diagnosticMessages, isBatchWorkItem, writeDiagnostics, } from './write-diagnostics.js';
+/** Every work item in review, in ID order; decisions, questions and docs are left out. */
+export function reviewQueue(devstepsDir) {
+    return readAllItemMetadata(devstepsDir)
+        .items.map((entry) => entry.metadata)
+        .filter((metadata) => metadata.status === 'review' && isBatchWorkItem(metadata.type))
+        .map((metadata) => metadata.id)
+        .sort((a, b) => a.localeCompare(b, 'en', { numeric: true }));
+}
+/** The reminders of one written update: decision and question rules, then the write rules. */
+export function updateReminders(devstepsDir, input) {
+    const { metadata, oldStatus } = input;
+    if (!input.status && !input.descriptionChanged && !input.titleChanged)
+        return [];
+    const description = existsSync(input.descriptionPath)
+        ? readFileSync(input.descriptionPath, 'utf-8')
+        : '';
+    const enteredReview = metadata.status === 'review' && oldStatus !== 'review' && isBatchWorkItem(metadata.type);
+    const statusReminders = decisionQuestionStatusReminders(metadata, { status: input.status, superseded_by: input.superseded_by }, description);
+    const diagnostics = writeDiagnostics({
+        operation: 'update',
+        item: { id: metadata.id, type: metadata.type, status: metadata.status, title: metadata.title },
+        titleChanged: input.titleChanged === true,
+        previousStatus: oldStatus,
+        description,
+        descriptionChanged: input.descriptionChanged,
+        descriptionAppended: input.descriptionAppended,
+        ...(input.batchReminder && enteredReview ? { reviewQueue: reviewQueue(devstepsDir) } : {}),
+    });
+    return [...statusReminders, ...diagnosticMessages(diagnostics)];
+}
+/** The one batch reminder of a bulk update that moved at least one work item to review. */
+export function bulkBatchReminder(devstepsDir, movedToReview) {
+    if (!movedToReview)
+        return null;
+    return batchRunDiagnostic(reviewQueue(devstepsDir))?.message ?? null;
+}
+//# sourceMappingURL=update-reminders.js.map

package/dist/core/update-reminders.js.map

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

package/dist/core/update.d.ts

@@ -5,8 +5,12 @@
  * Core update-item operation
  * Patches item metadata fields and synchronizes the distributed index.
  */
+import type { WorkflowRunEventInput } from '../runtime/workflow-v2-run-events.js';
 import type { EisenhowerQuadrant, ItemMetadata, ItemStatus } from '../schemas/index.js';
-export interface UpdateItemArgs {
+import { type DescriptionChange, type DescriptionPatchInput } from './description-patch.js';
+import { type ExpectedItemStamps } from './item-store.js';
+import { type WorkflowAuthoringDiagnostic } from './workflow-v2-authoring.js';
+export interface UpdateItemArgs extends DescriptionPatchInput {
     id: string;
     status?: ItemStatus;
     eisenhower?: EisenhowerQuadrant;
@@ -15,15 +19,55 @@ export interface UpdateItemArgs {
     description?: string;
     append_description?: string;
     assignee?: string;
+    category?: string;
+    /** Receipt of the target leaf (list with category); a classified item's move needs it. */
+    leaf_receipt?: string;
     tags?: string[];
     affected_paths?: string[];
+    reviewed_at?: string;
+    commit_hash?: string;
+    process_definition?: Record<string, unknown>;
 }
 export interface UpdateItemResult {
     metadata: ItemMetadata;
     oldStatus: ItemStatus;
+    /** Authoring warnings of a v2 process_definition; errors reject the update. */
+    diagnostics?: WorkflowAuthoringDiagnostic[];
+    /**
+     * In-band hints that never block the write: coordination text in a work item (BUG-153), the
+     * decision and question status rules, and the write-time reminders (EPIC-059).
+     */
+    warnings?: string[];
+    /** Open runs of the definition that took the new process_definition (STORY-465). */
+    revised_runs?: string[];
+    /** Targeted description edits, with line ranges instead of the description body. */
+    description_changes?: DescriptionChange[];
+}
+export interface UpdateItemOptions {
+    /** Internal callers (registry rename) move items without a leaf receipt; adapters never set it. */
+    skipLeafReceipt?: boolean;
+    /** False leaves the batch reminder to the caller; the bulk path sends it once (EPIC-059). */
+    batchReminder?: boolean;
+    /** Who revises the open runs of a changed process_definition; default an unnamed agent. */
+    runActor?: WorkflowRunEventInput;
+    /**
+     * The stamps the caller read the item under (BUG-199): the update refuses with
+     * `StaleItemError` when the item changed since, up to the description's rename.
+     */
+    expected?: ExpectedItemStamps;
 }
 /**
  * Core business logic for updating an item
  */
-export declare function updateItem(devstepsDir: string, args: UpdateItemArgs): Promise<UpdateItemResult>;
+export declare function updateItem(devstepsDir: string, args: UpdateItemArgs, options?: UpdateItemOptions): Promise<UpdateItemResult>;
+export interface AddCommitReferencesResult {
+    success: string[];
+    failed: Array<{
+        id: string;
+        error: string;
+    }>;
+    commit_hash: string;
+}
+/** Append one canonical commit reference to every existing target item. */
+export declare function addCommitReferences(devstepsDir: string, ids: readonly string[], commitHash: string): Promise<AddCommitReferencesResult>;
 //# sourceMappingURL=update.d.ts.map

package/dist/core/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/core/update.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKxF,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,UAAU,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAiH3B"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/core/update.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAWxF,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAE3B,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAGL,KAAK,kBAAkB,EAGxB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,cAAe,SAAQ,qBAAqB;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,UAAU,CAAC;IACtB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,2BAA2B,EAAE,CAAC;IAC5C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,oFAAoF;IACpF,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,mGAAmG;IACnG,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6FAA6F;IAC7F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAYD;;GAEG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAuM3B;AA6BD,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,2EAA2E;AAC3E,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,yBAAyB,CAAC,CA0BpC"}