ushman-ledger 1.2.0 → 1.2.1

package/dist/render/workspace-narrative.js

@@ -14,56 +14,124 @@ const NARRATIVE_SUBKINDS = [
     'semantic-cleanup-summary',
 ];
 const isNarrativeNote = (entry) => entry.kind === 'note' && NARRATIVE_SUBKINDS.some((subkind) => subkind === entry.subkind);
-const byNewestFirst = (left, right) => right.ts.localeCompare(left.ts);
-const renderBulletSection = (entries) => entries.length === 0
-    ? '- None recorded.'
-    : entries.map((entry) => `- ${entry.ts} — ${entry.summary}`).join('\n');
-const renderLatestSummary = (entries) => {
-    const [latest] = entries;
-    if (!latest) {
-        return 'No entries recorded.';
-    }
-    return [`### ${latest.ts} — ${latest.summary}`, '', latest.body || 'No narrative body recorded.'].join('\n');
-};
-export const renderWorkspaceNarrativeMarkdown = async ({ entries, workspaceName, }) => {
-    const entriesBySubkind = new Map(NARRATIVE_SUBKINDS.map((subkind) => [subkind, []]));
+const renderSummaryBullet = (entry) => `- ${entry.ts} — ${entry.summary}`;
+const collectNarrativeSections = async (entries) => {
+    let latestSummary = null;
+    const cleanupWaveEntries = [];
+    const decompositionWaveEntries = [];
+    const openIssueEntries = [];
+    const summaryArchiveEntries = [];
+    const verifiedFlowEntries = [];
     for await (const entry of entries) {
         if (!isNarrativeNote(entry)) {
             continue;
         }
-        entriesBySubkind.get(entry.subkind)?.push(entry);
+        switch (entry.subkind) {
+            case 'cleanup-wave':
+                cleanupWaveEntries.push(entry);
+                break;
+            case 'decomposition-wave':
+                decompositionWaveEntries.push(entry);
+                break;
+            case 'open-issue':
+                openIssueEntries.push(entry);
+                break;
+            case 'semantic-cleanup-summary':
+                if (!latestSummary) {
+                    latestSummary = entry;
+                    break;
+                }
+                summaryArchiveEntries.push(entry);
+                break;
+            case 'verified-flow':
+                verifiedFlowEntries.push(entry);
+                break;
+        }
+    }
+    return {
+        cleanupWaveEntries,
+        decompositionWaveEntries,
+        latestSummary,
+        openIssueEntries,
+        summaryArchiveEntries,
+        verifiedFlowEntries,
+    };
+};
+const writeBulletSection = async ({ entries, title, write, }) => {
+    await write(`${title}\n\n`);
+    if (entries.length === 0) {
+        await write('- None recorded.\n');
+        await write('\n');
+        return;
+    }
+    for (const entry of entries) {
+        await write(`${renderSummaryBullet(entry)}\n`);
     }
-    for (const noteEntries of entriesBySubkind.values()) {
-        noteEntries.sort(byNewestFirst);
+    await write('\n');
+};
+const writeLatestSummarySection = async ({ latestSummary, write, }) => {
+    await write(`${SECTION_TITLES.semanticCleanupSummary}\n\n`);
+    if (latestSummary) {
+        await write(`### ${latestSummary.ts} — ${latestSummary.summary}\n\n`);
+        await write(`${latestSummary.body || 'No narrative body recorded.'}\n\n`);
+        return;
+    }
+    await write('No entries recorded.\n\n');
+};
+const writeSummaryArchiveSection = async ({ entries, write, }) => {
+    await write(`${SECTION_TITLES.semanticCleanupSummaryArchive}\n\n`);
+    if (entries.length === 0) {
+        await write('- None recorded.\n');
+        await write('\n');
+        return;
     }
-    const semanticCleanupSummaries = entriesBySubkind.get('semantic-cleanup-summary') ?? [];
-    const [, ...archivedSummaries] = semanticCleanupSummaries;
-    return [
-        `# Workspace narrative — ${workspaceName}`,
-        '',
-        SECTION_TITLES.semanticCleanupSummary,
-        '',
-        renderLatestSummary(semanticCleanupSummaries),
-        '',
-        SECTION_TITLES.cleanupWave,
-        '',
-        renderBulletSection(entriesBySubkind.get('cleanup-wave') ?? []),
-        '',
-        SECTION_TITLES.verifiedFlow,
-        '',
-        renderBulletSection(entriesBySubkind.get('verified-flow') ?? []),
-        '',
-        SECTION_TITLES.openIssue,
-        '',
-        renderBulletSection(entriesBySubkind.get('open-issue') ?? []),
-        '',
-        SECTION_TITLES.decompositionWave,
-        '',
-        renderBulletSection(entriesBySubkind.get('decomposition-wave') ?? []),
-        '',
-        SECTION_TITLES.semanticCleanupSummaryArchive,
-        '',
-        renderBulletSection(archivedSummaries),
-        '',
-    ].join('\n');
+    for (const entry of entries) {
+        await write(`${renderSummaryBullet(entry)}\n`);
+    }
+    await write('\n');
+};
+export const writeWorkspaceNarrativeMarkdown = async ({ entries, workspaceName, write, }) => {
+    const sections = await collectNarrativeSections(entries);
+    await write(`# Workspace narrative — ${workspaceName}\n\n`);
+    await writeLatestSummarySection({
+        latestSummary: sections.latestSummary,
+        write,
+    });
+    await writeBulletSection({
+        entries: sections.cleanupWaveEntries,
+        title: SECTION_TITLES.cleanupWave,
+        write,
+    });
+    await writeBulletSection({
+        entries: sections.verifiedFlowEntries,
+        title: SECTION_TITLES.verifiedFlow,
+        write,
+    });
+    await writeBulletSection({
+        entries: sections.openIssueEntries,
+        title: SECTION_TITLES.openIssue,
+        write,
+    });
+    await writeBulletSection({
+        entries: sections.decompositionWaveEntries,
+        title: SECTION_TITLES.decompositionWave,
+        write,
+    });
+    await writeSummaryArchiveSection({
+        entries: sections.summaryArchiveEntries,
+        write,
+    });
+};
+export const renderWorkspaceNarrativeMarkdown = async ({ entries, workspaceName, write, }) => {
+    const chunks = [];
+    const resolvedWriter = write ??
+        ((chunk) => {
+            chunks.push(chunk);
+        });
+    await writeWorkspaceNarrativeMarkdown({
+        entries,
+        workspaceName,
+        write: resolvedWriter,
+    });
+    return chunks.join('');
 };

package/dist/schema/entry-read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry-read.d.ts","sourceRoot":"","sources":["../../src/schema/entry-read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAc7B,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAMpC,CAAC;AAQH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAOhC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAMnC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAItC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAOrC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAOlC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;aAK1B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDAUjC,CAAC;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAI3C,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAY/B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAW5B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACxE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAClE,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC"}
+{"version":3,"file":"entry-read.d.ts","sourceRoot":"","sources":["../../src/schema/entry-read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAc7B,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAMpC,CAAC;AAQH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAOhC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAMnC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAItC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAOrC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAOlC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;aAK1B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDAOjC,CAAC;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAI3C,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAY/B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAW5B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACxE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAClE,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC"}

package/dist/schema/entry-read.js

@@ -1,6 +1,6 @@
 import * as v from 'valibot';
-import { NoteSubkindSchema } from "./note.js";
 import { AgentPatchDiffSchema, ChangeLogFileChangeSchema, ChangeLogParityStatusSchema, ChangeLogSmokeResultSchema, ChangeLogSubkindSchema, ledgerEntryBaseEntries, NonEmptyTrimmedStringSchema, OperatorDecisionPayloadSchema, StripDecisionRevertedPayloadSchema, } from "./entry-core.js";
+import { NoteSubkindSchema } from "./note.js";
 export const ToolInvocationEntrySchema = v.object({
     ...ledgerEntryBaseEntries,
     args: v.optional(v.array(v.string())),

package/dist/schema/entry-write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry-write.d.ts","sourceRoot":"","sources":["../../src/schema/entry-write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAoC7B,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;aAMrC,CAAC;AAUH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8HAUlC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8HASrC,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;aAIvC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;aAOtC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;aAOnC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;aAK3B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDAUlC,CAAC;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;aAI5C,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qDAkBjC,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kEAW7B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC1E,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"entry-write.d.ts","sourceRoot":"","sources":["../../src/schema/entry-write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAoC7B,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;aAMrC,CAAC;AAUH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8HAUlC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8HASrC,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;aAIvC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;aAOtC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;aAOnC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;aAK3B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDAOlC,CAAC;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;aAI5C,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qDAkBjC,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kEAW7B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC1E,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/schema/entry-write.js

@@ -1,6 +1,6 @@
 import * as v from 'valibot';
-import { NoteSubkindSchema } from "./note.js";
 import { AgentPatchDiffSchema, ChangeLogFileChangeSchema, ChangeLogParityStatusSchema, ChangeLogSmokeResultSchema, ChangeLogSubkindSchema, NonEmptyTrimmedStringSchema, OperatorDecisionPayloadSchema, recordEntryBaseEntries, StripDecisionRevertedPayloadSchema, } from "./entry-core.js";
+import { NoteSubkindSchema } from "./note.js";
 const validatePatchRecord = (value) => {
     const provided = [value.diff, value.diffPath, value.diffText].filter((entry) => Boolean(entry));
     if (provided.length === 0) {

package/dist/schema/entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/schema/entry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,kBAAkB,CAAC;AAEzE,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAEjC,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,WAAyE,CAAC;AAE5H,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,YACa,CAAC"}
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/schema/entry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,kBAAkB,CAAC;AAEzE,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAEjC,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,WACY,CAAC;AAE/D,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,YACa,CAAC"}

package/dist/storage/filesystem.d.ts

@@ -5,6 +5,7 @@ export declare const LEDGER_ROOT_SEGMENTS: readonly [".lab", "ledger"];
 export declare const LEDGER_STALE_TEMP_MS = 60000;
 type AtomicWriteTestHook = {
     readonly beforeRename?: () => Promise<void>;
+    readonly retainOnThrow?: boolean;
 };
 export type LedgerPaths = {
     readonly blobsDir: string;
@@ -22,10 +23,16 @@ export type LedgerPaths = {
     readonly root: string;
     readonly workspaceRoot: string;
 };
+export type AtomicTextFileWriter = {
+    readonly abort: () => Promise<void>;
+    readonly close: () => Promise<void>;
+    readonly write: (chunk: string) => Promise<void>;
+};
 export declare const resolveLedgerPaths: (workspaceRoot: string) => LedgerPaths;
 export declare const ensureLedgerDirectories: (workspaceRoot: string) => Promise<LedgerPaths>;
 export declare const setAtomicWriteTestHook: (filePath: string, hook: AtomicWriteTestHook | null) => void;
 export declare const writeAtomicTextFile: (filePath: string, text: string) => Promise<void>;
+export declare const createAtomicTextFileWriter: (filePath: string) => Promise<AtomicTextFileWriter>;
 export declare const writeAtomicJsonFile: (filePath: string, value: unknown) => Promise<void>;
 export declare const readManifest: (workspaceRoot: string) => Promise<LedgerManifest>;
 export declare const saveManifest: (workspaceRoot: string, manifest: LedgerManifest) => Promise<void>;

package/dist/storage/filesystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/storage/filesystem.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,eAAO,MAAM,oBAAoB,6BAA8B,CAAC;AAChE,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAC3C,KAAK,mBAAmB,GAAG;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C,CAAC;AAaF,MAAM,MAAM,WAAW,GAAG;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,MAAM,CAAC;IAClD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,MAAM,CAAC;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,eAAe,MAAM,KAAG,WAkB1D,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAU,eAAe,MAAM,KAAG,OAAO,CAAC,WAAW,CAYxF,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,UAAU,MAAM,EAAE,MAAM,mBAAmB,GAAG,IAAI,SAOxF,CAAC;AAoBF,eAAO,MAAM,mBAAmB,GAAU,UAAU,MAAM,EAAE,MAAM,MAAM,kBAiBvE,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAU,UAAU,MAAM,EAAE,OAAO,OAAO,kBAEzE,CAAC;AAoCF,eAAO,MAAM,YAAY,GAAU,eAAe,MAAM,KAAG,OAAO,CAAC,cAAc,CAmBhF,CAAC;AAEF,eAAO,MAAM,YAAY,GAAU,eAAe,MAAM,EAAE,UAAU,cAAc,kBASjF,CAAC;AAoFF,eAAO,MAAM,qBAAqB,GAAU,eAAe,MAAM,kBAIhE,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAU,eAAe,MAAM,EAAE,OAAO,WAAW,KAAG,OAAO,CAAC,MAAM,EAAE,CAOzG,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,eAAe,MAAM,EAAE,OAAO,WAAW,EAAE,UAAU,MAAM,oBAGnG,CAAC;AAEF,eAAO,MAAM,cAAc,GAAU,eAAe,MAAM,EAAE,OAAO,WAAW,EAAE,UAAU,MAAM,EAAE,OAAO,OAAO,oBAK/G,CAAC"}
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/storage/filesystem.ts"],"names":[],"mappings":"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"}

package/dist/storage/filesystem.js

@@ -11,11 +11,29 @@ export const LEDGER_ROOT_SEGMENTS = ['.lab', 'ledger'];
 export const LEDGER_STALE_TEMP_MS = 60_000;
 const atomicWriteTestHooks = new Map();
 const resolveAtomicWriteKey = (filePath) => path.resolve(filePath);
-const consumeAtomicWriteTestHook = (filePath) => {
+const getAtomicWriteTestHook = (filePath) => {
     const key = resolveAtomicWriteKey(filePath);
-    const hook = atomicWriteTestHooks.get(key);
-    atomicWriteTestHooks.delete(key);
-    return hook;
+    return {
+        hook: atomicWriteTestHooks.get(key),
+        key,
+    };
+};
+const runAtomicWriteTestHook = async (filePath) => {
+    const { hook, key } = getAtomicWriteTestHook(filePath);
+    if (!hook?.beforeRename) {
+        atomicWriteTestHooks.delete(key);
+        return;
+    }
+    try {
+        await hook.beforeRename();
+        atomicWriteTestHooks.delete(key);
+    }
+    catch (error) {
+        if (!hook.retainOnThrow) {
+            atomicWriteTestHooks.delete(key);
+        }
+        throw error;
+    }
 };
 export const resolveLedgerPaths = (workspaceRoot) => {
     const root = path.join(workspaceRoot, ...LEDGER_ROOT_SEGMENTS);
@@ -83,7 +101,7 @@ export const writeAtomicTextFile = async (filePath, text) => {
     finally {
         await handle.close();
     }
-    await consumeAtomicWriteTestHook(filePath)?.beforeRename?.();
+    await runAtomicWriteTestHook(filePath);
     try {
         await rename(tempPath, filePath);
     }
@@ -92,6 +110,63 @@ export const writeAtomicTextFile = async (filePath, text) => {
         throw error;
     }
 };
+export const createAtomicTextFileWriter = async (filePath) => {
+    await mkdir(path.dirname(filePath), { recursive: true });
+    const tempPath = `${filePath}.tmp.${process.pid}.${Date.now()}.${randomUUID()}`;
+    const handle = await open(tempPath, 'w');
+    let completed = false;
+    let writeChain = Promise.resolve();
+    const finalizeHandle = async () => {
+        if (completed) {
+            return false;
+        }
+        completed = true;
+        return true;
+    };
+    const waitForWrites = async () => {
+        await writeChain;
+    };
+    return {
+        abort: async () => {
+            if (!(await finalizeHandle())) {
+                return;
+            }
+            await waitForWrites();
+            await handle.close();
+            await rm(tempPath, { force: true });
+        },
+        close: async () => {
+            if (!(await finalizeHandle())) {
+                return;
+            }
+            await waitForWrites();
+            try {
+                await handle.sync();
+            }
+            finally {
+                await handle.close();
+            }
+            await runAtomicWriteTestHook(filePath);
+            try {
+                await rename(tempPath, filePath);
+            }
+            catch (error) {
+                await rm(tempPath, { force: true });
+                throw error;
+            }
+        },
+        write: async (chunk) => {
+            const nextWrite = writeChain.then(async () => {
+                if (completed || chunk.length === 0) {
+                    return;
+                }
+                await handle.writeFile(chunk, 'utf8');
+            });
+            writeChain = nextWrite.then(() => undefined, () => undefined);
+            await nextWrite;
+        },
+    };
+};
 export const writeAtomicJsonFile = async (filePath, value) => {
     await writeAtomicTextFile(filePath, `${stableStringify(value, true)}\n`);
 };

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const LEDGER_LIBRARY_VERSION = "1.1.0";
+export declare const LEDGER_LIBRARY_VERSION = "1.2.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1 +1 @@
-export const LEDGER_LIBRARY_VERSION = '1.1.0';
+export const LEDGER_LIBRARY_VERSION = '1.2.0';

package/package.json

@@ -12,7 +12,7 @@
     "dependencies": {
         "safe-stable-stringify": "^2.5.0",
         "tar": "^7.5.15",
-        "valibot": "^1.4.0"
+        "valibot": "^1.4.1"
     },
     "description": "Append-only workspace ledger library and CLI for Ushman v4.",
     "devDependencies": {
@@ -68,5 +68,5 @@
     },
     "type": "module",
     "types": "dist/index.d.ts",
-    "version": "1.2.0"
+    "version": "1.2.1"
 }