@zigrivers/scaffold 3.25.1 → 3.26.0

package/dist/observability/engine/harvester.js

@@ -0,0 +1,106 @@
+import { access, appendFile, copyFile, mkdir, readFile, readdir, rename, rm, stat, unlink } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { lock } from 'proper-lockfile';
+import { readIdentityAsync } from './identity.js';
+import { ledgerPath } from './ledger-writer.js';
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export function archiveDir(primaryRoot) {
+    return join(primaryRoot, '.scaffold', 'activity-archive');
+}
+export function activeArchiveFile(primaryRoot, worktreeId) {
+    return join(archiveDir(primaryRoot), 'active', `${worktreeId}.jsonl`);
+}
+export async function harvestWorktree(input) {
+    const sourceLedger = ledgerPath(input.worktreeRoot);
+    try {
+        await access(sourceLedger);
+    }
+    catch {
+        return;
+    }
+    const id = await readIdentityAsync(input.worktreeRoot);
+    if (!id) {
+        throw new Error(`worktree at ${input.worktreeRoot} has no .scaffold/identity.json`);
+    }
+    // UUID validation prevents path traversal via a crafted identity file.
+    if (!UUID_RE.test(id.worktree_id)) {
+        throw new Error(`invalid worktree_id format: ${id.worktree_id}`);
+    }
+    const dest = activeArchiveFile(input.primaryRoot, id.worktree_id);
+    await mkdir(join(archiveDir(input.primaryRoot), 'active'), { recursive: true });
+    // Hold the same lock as writeEvent for a consistent snapshot.
+    // rename is inside the lock scope so a slower concurrent harvester cannot
+    // overwrite a newer archive produced by a faster one.
+    const release = await lock(sourceLedger, {
+        retries: { retries: 10, factor: 1.5, minTimeout: 50, maxTimeout: 500 },
+        stale: 30_000,
+    });
+    const tmp = `${dest}.tmp.${randomUUID()}`;
+    try {
+        await copyFile(sourceLedger, tmp);
+        await rename(tmp, dest);
+    }
+    catch (err) {
+        try {
+            await unlink(tmp);
+        }
+        catch { /* tmp may not exist if copyFile never created it */ }
+        throw err;
+    }
+    finally {
+        await release();
+    }
+}
+function defaultListWorktrees(primaryRoot) {
+    try {
+        const out = execFileSync('git', ['worktree', 'list', '--porcelain'], { cwd: primaryRoot, encoding: 'utf8' });
+        return out.split('\n').filter((l) => l.startsWith('worktree ')).map((l) => l.slice('worktree '.length).trim());
+    }
+    catch {
+        return [];
+    }
+}
+async function readWorktreeId(worktreePath) {
+    const idPath = join(worktreePath, '.scaffold/identity.json');
+    if (!existsSync(idPath))
+        return null;
+    try {
+        const obj = JSON.parse(await readFile(idPath, 'utf8'));
+        return obj.worktree_id ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function recoverStaleArchives(input) {
+    const activeDir = join(input.primaryRoot, '.scaffold/activity-archive/active');
+    if (!existsSync(activeDir))
+        return { rotated: [] };
+    const liveWorktrees = (input.listWorktrees ?? (() => defaultListWorktrees(input.primaryRoot)))();
+    const liveIdPromises = liveWorktrees.map((wt) => readWorktreeId(wt));
+    const liveIdResults = await Promise.all(liveIdPromises);
+    const liveIds = new Set(liveIdResults.filter((id) => id !== null));
+    const rotated = [];
+    const files = await readdir(activeDir);
+    for (const file of files) {
+        if (!file.endsWith('.jsonl'))
+            continue;
+        const wtId = basename(file, '.jsonl');
+        if (liveIds.has(wtId))
+            continue;
+        const activeFile = join(activeDir, file);
+        const fileStat = await stat(activeFile);
+        const ym = fileStat.mtime.toISOString().slice(0, 7);
+        const archiveFile = join(input.primaryRoot, `.scaffold/activity-archive/${ym}.jsonl`);
+        await mkdir(join(input.primaryRoot, '.scaffold/activity-archive'), { recursive: true });
+        const content = await readFile(activeFile, 'utf8');
+        await appendFile(archiveFile, content, { mode: 0o644 });
+        await rm(activeFile);
+        rotated.push(wtId);
+    }
+    return { rotated };
+}
+//# sourceMappingURL=harvester.js.map

package/dist/observability/engine/harvester.js.map

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

package/dist/observability/engine/harvester.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=harvester.test.d.ts.map

package/dist/observability/engine/harvester.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harvester.test.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/harvester.test.ts"],"names":[],"mappings":""}

package/dist/observability/engine/harvester.test.js

@@ -0,0 +1,99 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, readFileSync, existsSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { harvestWorktree, activeArchiveFile } from './harvester.js';
+import { writeEvent } from './ledger-writer.js';
+import { ensureIdentity, readIdentity } from './identity.js';
+describe('harvester', () => {
+    let primary;
+    let worktree;
+    beforeEach(() => {
+        primary = mkdtempSync(join(tmpdir(), 'observe-primary-'));
+        worktree = mkdtempSync(join(tmpdir(), 'observe-wt-'));
+        ensureIdentity(worktree, 'agent-alice');
+    });
+    afterEach(() => {
+        rmSync(primary, { recursive: true, force: true });
+        rmSync(worktree, { recursive: true, force: true });
+    });
+    it('copies worktree ledger to <primary>/.scaffold/activity-archive/active/<id>.jsonl atomically', async () => {
+        await writeEvent(worktree, { type: 'task_claimed', branch: 'b', task_id: 'T-1', payload: { task_title: 'Hi' } });
+        const id = readIdentity(worktree);
+        await harvestWorktree({ primaryRoot: primary, worktreeRoot: worktree });
+        const archived = activeArchiveFile(primary, id.worktree_id);
+        expect(existsSync(archived)).toBe(true);
+        const lines = readFileSync(archived, 'utf8').trim().split('\n');
+        expect(lines).toHaveLength(1);
+        expect(JSON.parse(lines[0]).type).toBe('task_claimed');
+    });
+    it('overwrites prior archive (idempotent full-file replacement)', async () => {
+        await writeEvent(worktree, { type: 'task_claimed', branch: 'b', task_id: 'T-1', payload: { task_title: 'Hi' } });
+        await harvestWorktree({ primaryRoot: primary, worktreeRoot: worktree });
+        await writeEvent(worktree, {
+            type: 'task_completed', branch: 'b', task_id: 'T-1',
+            payload: { outcome: 'pr_submitted', pr_number: 42 },
+        });
+        await harvestWorktree({ primaryRoot: primary, worktreeRoot: worktree });
+        const id = readIdentity(worktree);
+        const archived = activeArchiveFile(primary, id.worktree_id);
+        const lines = readFileSync(archived, 'utf8').trim().split('\n');
+        expect(lines).toHaveLength(2);
+        expect(JSON.parse(lines[1]).type).toBe('task_completed');
+    });
+    it('does nothing (returns silently) if the worktree has no ledger yet', async () => {
+        const empty = mkdtempSync(join(tmpdir(), 'observe-empty-'));
+        ensureIdentity(empty, 'agent-bob');
+        try {
+            await harvestWorktree({ primaryRoot: primary, worktreeRoot: empty });
+            const id = readIdentity(empty);
+            const archived = activeArchiveFile(primary, id.worktree_id);
+            expect(existsSync(archived)).toBe(false);
+        }
+        finally {
+            rmSync(empty, { recursive: true, force: true });
+        }
+    });
+});
+import { mkdirSync, writeFileSync, readdirSync } from 'node:fs';
+import { recoverStaleArchives } from './harvester.js';
+describe('harvester.recoverStaleArchives', () => {
+    let primary;
+    beforeEach(() => {
+        primary = mkdtempSync(join(tmpdir(), 'observe-recover-'));
+    });
+    afterEach(() => { rmSync(primary, { recursive: true, force: true }); });
+    it('rotates active-archive entries whose worktree path no longer exists', async () => {
+        const activeDir = join(primary, '.scaffold/activity-archive/active');
+        mkdirSync(activeDir, { recursive: true });
+        const staleEntry = JSON.stringify({
+            event_id: 'ulid-x', worktree_id: 'aaaa', actor_label: 'orphan', branch: 'b',
+            task_id: 'T-1', type: 'task_claimed', ts: '2026-04-01T00:00:00Z', payload: { task_title: 'gone' },
+        });
+        writeFileSync(join(activeDir, 'aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee.jsonl'), `${staleEntry}\n`);
+        const result = await recoverStaleArchives({ primaryRoot: primary });
+        expect(result.rotated).toContain('aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee');
+        expect(existsSync(join(activeDir, 'aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee.jsonl'))).toBe(false);
+        const archiveFiles = readdirSync(join(primary, '.scaffold/activity-archive'));
+        expect(archiveFiles.some((f) => /^\d{4}-\d{2}\.jsonl(\.gz)?$/.test(f))).toBe(true);
+    });
+    it('leaves active archives whose worktree still exists alone', async () => {
+        const activeDir = join(primary, '.scaffold/activity-archive/active');
+        mkdirSync(activeDir, { recursive: true });
+        const wtId = 'bbbbbbbb-cccc-4ddd-8eee-ffffffffffff';
+        const wtPath = mkdtempSync(join(tmpdir(), 'observe-recover-wt-'));
+        try {
+            mkdirSync(join(wtPath, '.scaffold'), { recursive: true });
+            const identity = JSON.stringify({ worktree_id: wtId, worktree_label: 'live', created_at: '2026-05-04T00:00:00Z' });
+            writeFileSync(join(wtPath, '.scaffold/identity.json'), identity);
+            writeFileSync(join(activeDir, `${wtId}.jsonl`), '{}\n');
+            const result = await recoverStaleArchives({ primaryRoot: primary, listWorktrees: () => [wtPath] });
+            expect(result.rotated).toEqual([]);
+            expect(existsSync(join(activeDir, `${wtId}.jsonl`))).toBe(true);
+        }
+        finally {
+            rmSync(wtPath, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=harvester.test.js.map

package/dist/observability/engine/harvester.test.js.map

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

package/dist/observability/engine/identity.d.ts

@@ -0,0 +1,6 @@
+import type { WorktreeIdentity } from './types.js';
+export declare function identityPath(worktreeRoot: string): string;
+export declare function readIdentity(worktreeRoot: string): WorktreeIdentity | null;
+export declare function readIdentityAsync(worktreeRoot: string): Promise<WorktreeIdentity | null>;
+export declare function ensureIdentity(worktreeRoot: string, label: string): WorktreeIdentity;
+//# sourceMappingURL=identity.d.ts.map

package/dist/observability/engine/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/identity.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAc1E;AAED,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAY9F;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAWpF"}

package/dist/observability/engine/identity.js

@@ -0,0 +1,50 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+export function identityPath(worktreeRoot) {
+    return join(worktreeRoot, '.scaffold', 'identity.json');
+}
+export function readIdentity(worktreeRoot) {
+    const path = identityPath(worktreeRoot);
+    if (!existsSync(path))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(path, 'utf8'));
+        if (typeof data?.worktree_id !== 'string' ||
+            typeof data?.worktree_label !== 'string' ||
+            typeof data?.created_at !== 'string')
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+export async function readIdentityAsync(worktreeRoot) {
+    try {
+        const data = JSON.parse(await readFile(identityPath(worktreeRoot), 'utf8'));
+        if (typeof data?.worktree_id !== 'string' ||
+            typeof data?.worktree_label !== 'string' ||
+            typeof data?.created_at !== 'string')
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+export function ensureIdentity(worktreeRoot, label) {
+    const existing = readIdentity(worktreeRoot);
+    if (existing)
+        return existing;
+    const id = {
+        worktree_id: randomUUID(),
+        worktree_label: label,
+        created_at: new Date().toISOString(),
+    };
+    mkdirSync(dirname(identityPath(worktreeRoot)), { recursive: true });
+    writeFileSync(identityPath(worktreeRoot), JSON.stringify(id, null, 2) + '\n', { mode: 0o644 });
+    return id;
+}
+//# sourceMappingURL=identity.js.map

package/dist/observability/engine/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../src/observability/engine/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,OAAO,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,eAAe,CAAC,CAAA;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,MAAM,IAAI,GAAG,YAAY,CAAC,YAAY,CAAC,CAAA;IACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAClC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAA8B,CAAA;QAChF,IACE,OAAO,IAAI,EAAE,WAAW,KAAK,QAAQ;YACrC,OAAO,IAAI,EAAE,cAAc,KAAK,QAAQ;YACxC,OAAO,IAAI,EAAE,UAAU,KAAK,QAAQ;YACpC,OAAO,IAAI,CAAA;QACb,OAAO,IAAwB,CAAA;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,YAAoB;IAC1D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAA8B,CAAA;QACxG,IACE,OAAO,IAAI,EAAE,WAAW,KAAK,QAAQ;YACrC,OAAO,IAAI,EAAE,cAAc,KAAK,QAAQ;YACxC,OAAO,IAAI,EAAE,UAAU,KAAK,QAAQ;YACpC,OAAO,IAAI,CAAA;QACb,OAAO,IAAwB,CAAA;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,YAAoB,EAAE,KAAa;IAChE,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAA;IAC3C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC7B,MAAM,EAAE,GAAqB;QAC3B,WAAW,EAAE,UAAU,EAAE;QACzB,cAAc,EAAE,KAAK;QACrB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAA;IACD,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnE,aAAa,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAC9F,OAAO,EAAE,CAAA;AACX,CAAC"}

package/dist/observability/engine/identity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=identity.test.d.ts.map

package/dist/observability/engine/identity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.test.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/identity.test.ts"],"names":[],"mappings":""}

package/dist/observability/engine/identity.test.js

@@ -0,0 +1,29 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, existsSync, readFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { ensureIdentity, readIdentity, identityPath } from './identity.js';
+describe('identity', () => {
+    let dir;
+    beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'observe-id-')); });
+    afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
+    it('creates .scaffold/identity.json with a UUID and the given label when missing', () => {
+        const id = ensureIdentity(dir, 'agent-alice');
+        expect(id.worktree_label).toBe('agent-alice');
+        expect(id.worktree_id).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/);
+        expect(existsSync(identityPath(dir))).toBe(true);
+        const written = JSON.parse(readFileSync(identityPath(dir), 'utf8'));
+        expect(written.worktree_id).toBe(id.worktree_id);
+        expect(written.created_at).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+    });
+    it('does not overwrite an existing identity file', () => {
+        const first = ensureIdentity(dir, 'agent-alice');
+        const second = ensureIdentity(dir, 'something-else');
+        expect(second.worktree_id).toBe(first.worktree_id);
+        expect(second.worktree_label).toBe(first.worktree_label);
+    });
+    it('readIdentity returns null when the file does not exist', () => {
+        expect(readIdentity(dir)).toBeNull();
+    });
+});
+//# sourceMappingURL=identity.test.js.map

package/dist/observability/engine/identity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.test.js","sourceRoot":"","sources":["../../../src/observability/engine/identity.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE1E,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,IAAI,GAAW,CAAA;IAEf,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;IACtE,SAAS,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;IAElE,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACtF,MAAM,EAAE,GAAG,cAAc,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;QAC7C,MAAM,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QAC7C,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,uEAAuE,CAAC,CAAA;QACvG,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;QACnE,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,CAAA;QAChD,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;QAChD,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAA;QACpD,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QAClD,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IACtC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/observability/engine/ledger-writer.d.ts

@@ -0,0 +1,10 @@
+import type { EventType } from './types.js';
+export interface WriteEventInput {
+    type: EventType;
+    branch: string;
+    task_id: string | null;
+    payload: Record<string, unknown>;
+}
+export declare function ledgerPath(worktreeRoot: string): string;
+export declare function writeEvent(worktreeRoot: string, input: WriteEventInput): Promise<void>;
+//# sourceMappingURL=ledger-writer.d.ts.map

package/dist/observability/engine/ledger-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-writer.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/ledger-writer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAO3C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAsB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAsC5F"}

package/dist/observability/engine/ledger-writer.js

@@ -0,0 +1,50 @@
+import { appendFile, mkdir, writeFile } from 'node:fs/promises';
+import { join, basename } from 'node:path';
+import { ulid } from 'ulid';
+import { lock } from 'proper-lockfile';
+import { validateEvent } from './event-schemas.js';
+import { redactEvent } from './redact.js';
+import { ensureIdentity } from './identity.js';
+const MAX_EVENT_BYTES = 4096;
+export function ledgerPath(worktreeRoot) {
+    return join(worktreeRoot, '.scaffold', 'activity.jsonl');
+}
+export async function writeEvent(worktreeRoot, input) {
+    const id = ensureIdentity(worktreeRoot, deriveLabel(worktreeRoot));
+    const candidate = {
+        event_id: ulid(),
+        worktree_id: id.worktree_id,
+        actor_label: id.worktree_label,
+        branch: input.branch,
+        task_id: input.task_id,
+        type: input.type,
+        ts: new Date().toISOString(),
+        payload: input.payload,
+    };
+    const validated = validateEvent(candidate);
+    if (!validated.ok) {
+        throw new Error(`event validation failed: ${validated.errors.join('; ')}`);
+    }
+    const redacted = redactEvent(validated.event);
+    const line = JSON.stringify(redacted) + '\n';
+    if (Buffer.byteLength(line, 'utf8') > MAX_EVENT_BYTES) {
+        throw new Error(`event too large (>${MAX_EVENT_BYTES} bytes / 4 KiB): split or summarize the payload`);
+    }
+    const path = ledgerPath(worktreeRoot);
+    await mkdir(join(worktreeRoot, '.scaffold'), { recursive: true });
+    await writeFile(path, '', { flag: 'a', mode: 0o644 });
+    const release = await lock(path, {
+        retries: { retries: 10, factor: 1.5, minTimeout: 50, maxTimeout: 500 },
+        stale: 30_000,
+    });
+    try {
+        await appendFile(path, line, { mode: 0o644 });
+    }
+    finally {
+        await release();
+    }
+}
+function deriveLabel(worktreeRoot) {
+    return basename(worktreeRoot) || 'primary';
+}
+//# sourceMappingURL=ledger-writer.js.map

package/dist/observability/engine/ledger-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-writer.js","sourceRoot":"","sources":["../../../src/observability/engine/ledger-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,eAAe,GAAG,IAAI,CAAA;AAS5B,MAAM,UAAU,UAAU,CAAC,YAAoB;IAC7C,OAAO,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAA;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,YAAoB,EAAE,KAAsB;IAC3E,MAAM,EAAE,GAAG,cAAc,CAAC,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC,CAAA;IAElE,MAAM,SAAS,GAAG;QAChB,QAAQ,EAAE,IAAI,EAAE;QAChB,WAAW,EAAE,EAAE,CAAC,WAAW;QAC3B,WAAW,EAAE,EAAE,CAAC,cAAc;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAA;IAED,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,CAAA;IAC1C,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,4BAA4B,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC5E,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAA;IAC5C,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,eAAe,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,qBAAqB,eAAe,iDAAiD,CAAC,CAAA;IACxG,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,CAAA;IACrC,MAAM,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACjE,MAAM,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAErD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE;QAC/B,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE;QACtE,KAAK,EAAE,MAAM;KACd,CAAC,CAAA;IACF,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAC/C,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,CAAA;IACjB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,YAAoB;IACvC,OAAO,QAAQ,CAAC,YAAY,CAAC,IAAI,SAAS,CAAA;AAC5C,CAAC"}

package/dist/observability/engine/ledger-writer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ledger-writer.test.d.ts.map

package/dist/observability/engine/ledger-writer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-writer.test.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/ledger-writer.test.ts"],"names":[],"mappings":""}

package/dist/observability/engine/ledger-writer.test.js

@@ -0,0 +1,72 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, readFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { writeEvent } from './ledger-writer.js';
+import { ensureIdentity } from './identity.js';
+describe('ledger-writer (basic append)', () => {
+    let dir;
+    beforeEach(() => {
+        dir = mkdtempSync(join(tmpdir(), 'observe-lw-'));
+        ensureIdentity(dir, 'agent-alice');
+    });
+    afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
+    it('appends a valid task_claimed event as a single JSONL line', async () => {
+        await writeEvent(dir, {
+            type: 'task_claimed',
+            branch: 'alice-feat',
+            task_id: 'T-001',
+            payload: { task_title: 'Hello' },
+        });
+        const text = readFileSync(join(dir, '.scaffold/activity.jsonl'), 'utf8');
+        const lines = text.trim().split('\n');
+        expect(lines).toHaveLength(1);
+        const obj = JSON.parse(lines[0]);
+        expect(obj.type).toBe('task_claimed');
+        expect(obj.task_id).toBe('T-001');
+        expect(obj.event_id).toMatch(/^[0-9A-HJKMNP-TV-Z]{26}$/); // ULID
+        expect(obj.worktree_id).toMatch(/^[0-9a-f-]{36}$/);
+        expect(obj.ts).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+    });
+    it('rejects events larger than 4 KiB', async () => {
+        // 100 long paths in affects passes schema validation but pushes the JSON line over 4 KiB.
+        const manyPaths = Array.from({ length: 100 }, (_, i) => `/src/observability/engine/module-${i}.ts`);
+        await expect(writeEvent(dir, {
+            type: 'decision_recorded', branch: 'b', task_id: 'T-002',
+            payload: { key: 'k', summary: 'ok', affects: manyPaths },
+        })).rejects.toThrow(/4 KiB|too large/i);
+    });
+    it('rejects schema-invalid events', async () => {
+        await expect(writeEvent(dir, {
+            type: 'task_claimed', branch: 'b', task_id: null,
+            payload: { task_title: 'h' }, // missing payload.unplanned=true for null task_id
+        })).rejects.toThrow(/unplanned/);
+    });
+});
+describe('ledger-writer (concurrency)', () => {
+    let dir;
+    beforeEach(() => {
+        dir = mkdtempSync(join(tmpdir(), 'observe-lw-conc-'));
+        ensureIdentity(dir, 'agent-concurrent');
+    });
+    afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
+    it('serializes 10 concurrent writes without data loss or corruption', async () => {
+        const N = 10;
+        const writes = Array.from({ length: N }, (_, i) => writeEvent(dir, {
+            type: 'task_claimed',
+            branch: `branch-${i}`,
+            task_id: `T-${String(i).padStart(3, '0')}`,
+            payload: { task_title: `Task ${i}` },
+        }));
+        await Promise.all(writes);
+        const text = readFileSync(join(dir, '.scaffold/activity.jsonl'), 'utf8');
+        const lines = text.trim().split('\n');
+        expect(lines).toHaveLength(N);
+        for (const line of lines) {
+            expect(() => JSON.parse(line)).not.toThrow();
+        }
+        const taskIds = new Set(lines.map(l => JSON.parse(l).task_id));
+        expect(taskIds.size).toBe(N);
+    });
+});
+//# sourceMappingURL=ledger-writer.test.js.map

package/dist/observability/engine/ledger-writer.test.js.map

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

package/dist/observability/engine/llm-dispatcher.d.ts

@@ -0,0 +1,16 @@
+export interface DispatchInput {
+    prompt: string;
+    command: string;
+    timeoutMs: number;
+}
+export type DispatchResult = {
+    ok: true;
+    parsed: unknown;
+    raw: string;
+} | {
+    ok: false;
+    reason: string;
+    raw?: string;
+};
+export declare function dispatchLlm(input: DispatchInput): Promise<DispatchResult>;
+//# sourceMappingURL=llm-dispatcher.d.ts.map

package/dist/observability/engine/llm-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/llm-dispatcher.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/C,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAqFzE"}