zelari-code 1.42.0 → 1.43.0

package/dist/cli/workspace/planStore.js

@@ -0,0 +1,213 @@
+/**
+ * workspace/planStore.ts — Durable workspace task store (ADR-0018, slice 3a).
+ *
+ * Canonical, versioned view of `.zelari/plan.json`, shared by the agent-loop
+ * `task_*` tools (src/cli/tools/planTaskTools.ts) and the council stubs
+ * (createPlan/createTask/updateTask — src/cli/workspace/stubs.ts).
+ *
+ * Contract (docs/decisions/0018-workspace-task-store-plan-json.md):
+ *  - Envelope v1: root carries `schemaVersion`, `counter`, `tasks`; every
+ *    other root field (`phases`, `milestones`, council metadata, …) is
+ *    preserved verbatim in pass-through. Unknown fields on a task are kept
+ *    unless explicitly overwritten.
+ *  - Status: `pending | in_progress | completed | cancelled | blocked`.
+ *    Legacy council `done` is normalized to `completed` on read; `task_*`
+ *    writes use the v1 vocabulary. Council readers were patched to accept
+ *    both (workspaceSummary.ts).
+ *  - Ids: `t<N>` sequential via the persisted `counter` — never collides
+ *    with council ids (`<phaseId>-<slug>-<N>`).
+ *  - Concurrency: same in-process keyed mutex as the council stubs
+ *    (`workspaceMutex`, key `<root>:plan`) + atomic tmp+rename write, with a
+ *    `plan.json.bak` backup before rewriting an existing file. Cross-process
+ *    races (two CLIs on the same cwd) remain best-effort until a lock file
+ *    lands (ADR-0018 hardening, out of scope for 3a).
+ *
+ * @since v1.43.0
+ */
+import { copyFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { resolveWorkspaceRoot } from './paths.js';
+import { Storage, workspaceMutex } from './storage.js';
+export const PLAN_SCHEMA_VERSION = 1;
+export const PLAN_MAX_TASKS = 100;
+export const PLAN_TITLE_MAX = 200;
+export const PLAN_NOTES_MAX = 2000;
+export const PLAN_TAG_MAX = 64;
+export const PLAN_TASK_STATUSES = [
+    'pending',
+    'in_progress',
+    'completed',
+    'cancelled',
+    'blocked',
+];
+/** Typed store error — corrupt file never gets overwritten silently. */
+export class PlanStoreError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'PlanStoreError';
+    }
+}
+/** Resolved plan.json path for a project root (creates nothing). */
+export function planJsonPathFor(projectRoot = process.cwd()) {
+    return join(resolveWorkspaceRoot(projectRoot), 'plan.json');
+}
+/**
+ * Read-modify-write the plan store under the shared workspace mutex.
+ * Corrupt JSON → PlanStoreError('PLAN_CORRUPT') and the file is left intact.
+ */
+export async function withPlanStore(projectRoot, fn) {
+    const rootDir = resolveWorkspaceRoot(projectRoot);
+    return workspaceMutex.run(`${rootDir}:plan`, () => {
+        const handle = loadHandle(rootDir);
+        const out = fn(handle);
+        saveHandle(rootDir, handle);
+        return out;
+    });
+}
+/** Allocate the next `t<N>` id (increments the persisted counter). */
+export function nextPlanTaskId(store) {
+    const maxExisting = store.tasks.reduce((max, t) => {
+        const m = /^t(\d+)$/.exec(t.id);
+        return m ? Math.max(max, parseInt(m[1], 10)) : max;
+    }, 0);
+    store.counter = Math.max(store.counter, maxExisting) + 1;
+    return `t${store.counter}`;
+}
+/** Write/refresh the per-task artifact the workspace summary links to. */
+export function writePlanTaskArtifact(rootDir, task) {
+    const path = join(rootDir, 'plan-tasks', `${task.id}.md`);
+    mkdirSync(dirname(path), { recursive: true });
+    const meta = {
+        kind: 'task',
+        id: task.id,
+        name: task.title,
+        phaseId: task.phaseId,
+        status: task.status,
+        priority: task.priority ?? 'medium',
+        updatedAt: task.updatedAt,
+    };
+    const body = [
+        `# Task ${task.id}: ${task.title}`,
+        '',
+        `- Status: **${task.status}**`,
+        `- Priority: ${task.priority ?? 'medium'}`,
+        task.phaseId ? `- Phase: ${task.phaseId}` : null,
+        task.agent ? `- Agent: ${task.agent}` : null,
+        '',
+        task.notes?.trim() ? task.notes.trim() : '_(no notes)_',
+        '',
+    ]
+        .filter((l) => l !== null)
+        .join('\n');
+    new Storage().write(path, meta, body);
+}
+// ── internals ─────────────────────────────────────────────────────────
+function loadHandle(rootDir) {
+    const jsonPath = join(rootDir, 'plan.json');
+    if (!existsSync(jsonPath)) {
+        return { rootDir, tasks: [], counter: 0, rootFields: {} };
+    }
+    let parsed;
+    try {
+        const raw = JSON.parse(readFileSync(jsonPath, 'utf8'));
+        if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+            throw new Error('root is not a JSON object');
+        }
+        parsed = raw;
+    }
+    catch {
+        throw new PlanStoreError(`PLAN_CORRUPT: ${jsonPath} is not valid JSON — refusing to overwrite a ` +
+            `possibly hand-edited or crashed write. Fix or remove the file (a ` +
+            `.bak may exist), then retry.`, 'PLAN_CORRUPT');
+    }
+    const { tasks: rawTasks, counter, schemaVersion: _schemaVersion, ...rootFields } = parsed;
+    const tasks = (Array.isArray(rawTasks) ? rawTasks : [])
+        .map(normalizeTask)
+        .filter((t) => typeof t.id === 'string' && t.id.length > 0);
+    const numericCounter = typeof counter === 'number' && Number.isFinite(counter) && counter >= 0
+        ? Math.floor(counter)
+        : 0;
+    return { rootDir, tasks, counter: numericCounter, rootFields };
+}
+function saveHandle(rootDir, handle) {
+    if (handle.tasks.length > PLAN_MAX_TASKS) {
+        throw new PlanStoreError(`PLAN_TOO_MANY_TASKS: plan.json would exceed ${PLAN_MAX_TASKS} tasks ` +
+            `(${handle.tasks.length}) — cancel or complete tasks first.`, 'PLAN_TOO_MANY_TASKS');
+    }
+    const jsonPath = join(rootDir, 'plan.json');
+    mkdirSync(rootDir, { recursive: true });
+    if (existsSync(jsonPath)) {
+        copyFileSync(jsonPath, `${jsonPath}.bak`);
+    }
+    const file = {
+        ...handle.rootFields,
+        schemaVersion: PLAN_SCHEMA_VERSION,
+        counter: handle.counter,
+        tasks: handle.tasks,
+    };
+    const tmp = `${jsonPath}.tmp-${process.pid}`;
+    writeFileSync(tmp, JSON.stringify(file, null, 2) + '\n', 'utf8');
+    renameSync(tmp, jsonPath);
+}
+/** Normalize a raw task record (council or v1) into the contract shape. */
+function normalizeTask(raw) {
+    const t = (raw !== null && typeof raw === 'object'
+        ? { ...raw }
+        : {});
+    if (typeof t.id === 'string') {
+        t.id = t.id.trim().slice(0, 64);
+    }
+    const titleSource = firstString(t.title) ??
+        firstString(t.name) ??
+        firstString(t.description) ??
+        '';
+    t.title = titleSource.slice(0, PLAN_TITLE_MAX);
+    // Council readers (buildPlanSummary) render `name` — keep the alias in
+    // sync so t<N> tasks display correctly there too.
+    if (t.title && !firstString(t.name)) {
+        t.name = t.title;
+    }
+    t.status = normalizeStatus(t.status);
+    if (typeof t.notes === 'string') {
+        t.notes = t.notes.slice(0, PLAN_NOTES_MAX);
+    }
+    if (typeof t.phaseId === 'string') {
+        t.phaseId = t.phaseId.slice(0, PLAN_TAG_MAX);
+    }
+    if (typeof t.agent === 'string') {
+        t.agent = t.agent.slice(0, PLAN_TAG_MAX);
+    }
+    return t;
+}
+function normalizeStatus(raw) {
+    const s = typeof raw === 'string' ? raw.trim().toLowerCase() : '';
+    switch (s) {
+        case 'in_progress':
+        case 'in-progress':
+        case 'doing':
+        case 'started':
+        case 'active':
+            return 'in_progress';
+        case 'completed':
+        case 'complete':
+        case 'done':
+        case 'finished':
+            return 'completed';
+        case 'cancelled':
+        case 'canceled':
+        case 'closed':
+            return 'cancelled';
+        case 'blocked':
+        case 'on-hold':
+        case 'on hold':
+            return 'blocked';
+        default:
+            return 'pending';
+    }
+}
+function firstString(v) {
+    return typeof v === 'string' && v.trim().length > 0 ? v : null;
+}
+//# sourceMappingURL=planStore.js.map

package/dist/cli/workspace/planStore.js.map

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

package/dist/cli/workspace/planStore.test.js

@@ -0,0 +1,295 @@
+/**
+ * planStore + planTaskTools tests — ADR-0018 slice 3a acceptance.
+ *
+ * Covers: v1 envelope persistence, coexistence with council plan tasks
+ * (normalization done→completed, name→title alias, no id collisions, root
+ * pass-through), caps, corrupt-file safety, .bak backup, and the council
+ * writePlan round-trip preserving the v1 root fields.
+ *
+ * @since v1.43.0
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createPlanTaskTools } from '../tools/planTaskTools.js';
+import { createWorkspaceContext, createWorkspaceStubs } from './stubs.js';
+let dir;
+beforeEach(() => {
+    dir = mkdtempSync(join(tmpdir(), 'zelari-plan-'));
+});
+afterEach(() => {
+    rmSync(dir, { recursive: true, force: true });
+});
+function planPath() {
+    return join(dir, '.zelari', 'plan.json');
+}
+function readPlanJson() {
+    return JSON.parse(readFileSync(planPath(), 'utf8'));
+}
+function seedPlanJson(content) {
+    mkdirSync(join(dir, '.zelari'), { recursive: true });
+    writeFileSync(planPath(), JSON.stringify(content), 'utf8');
+}
+function toolCtx() {
+    return {
+        signal: new AbortController().signal,
+        cwd: dir,
+        audit: () => { },
+        sessionId: 'plan-store-test',
+    };
+}
+function makeTools(onTaskEvent) {
+    const tools = createPlanTaskTools({ projectRoot: dir, onTaskEvent });
+    return {
+        create: tools[0],
+        update: tools[1],
+        list: tools[2],
+    };
+}
+describe('planStore / task_* tools (ADR-0018 3a)', () => {
+    it('task_create persists the v1 envelope and the per-task artifact', async () => {
+        const { create } = makeTools();
+        const res = await create.execute({ title: 'Extract RunCoordinator' }, toolCtx());
+        expect(res.ok).toBe(true);
+        if (!res.ok)
+            return;
+        expect(res.value.id).toBe('t1');
+        expect(res.value.task.status).toBe('pending');
+        const file = readPlanJson();
+        expect(file.schemaVersion).toBe(1);
+        expect(file.counter).toBe(1);
+        expect(file.tasks[0].id).toBe('t1');
+        expect(file.tasks[0].title).toBe('Extract RunCoordinator');
+        expect(file.tasks[0].name).toBe('Extract RunCoordinator'); // council alias
+        expect(existsSync(join(dir, '.zelari', 'plan-tasks', 't1.md'))).toBe(true);
+    });
+    it('coexists with council tasks: normalization, no id collision, root pass-through', async () => {
+        seedPlanJson({
+            phases: [{ kind: 'phase', id: 'p1', name: 'P1', order: 1 }],
+            tasks: [
+                {
+                    kind: 'task',
+                    id: 'p1-foo-1',
+                    name: 'Council task',
+                    phaseId: 'p1',
+                    status: 'done',
+                    priority: 'high',
+                    description: 'council extra field',
+                },
+            ],
+            milestones: [],
+            xCouncilMeta: 'keep-me',
+        });
+        const { create, list } = makeTools();
+        const l1 = await list.execute({}, toolCtx());
+        expect(l1.ok).toBe(true);
+        if (!l1.ok)
+            return;
+        expect(l1.value.tasks).toHaveLength(1);
+        expect(l1.value.tasks[0].title).toBe('Council task'); // name → title
+        expect(l1.value.tasks[0].status).toBe('completed'); // done → completed
+        expect(l1.value.done).toBe(1);
+        expect(l1.value.total).toBe(1);
+        const res = await create.execute({ title: 'Agent task', phaseId: 'p1' }, toolCtx());
+        expect(res.ok).toBe(true);
+        if (!res.ok)
+            return;
+        expect(res.value.id).toBe('t1'); // counter starts fresh, no collision with p1-foo-1
+        const file = readPlanJson();
+        expect(file.xCouncilMeta).toBe('keep-me'); // unknown root field preserved
+        expect(file.phases).toHaveLength(1);
+        const council = file.tasks.find((t) => t.id === 'p1-foo-1');
+        expect(council.name).toBe('Council task');
+        expect(council.description).toBe('council extra field'); // task pass-through
+        expect(council.status).toBe('completed'); // normalized on rewrite
+    });
+    it('task_update applies fields, appendNote, and errors PLAN_TASK_NOT_FOUND', async () => {
+        const { create, update } = makeTools();
+        const created = await create.execute({ title: 'Fix auth refresh' }, toolCtx());
+        expect(created.ok).toBe(true);
+        const up = await update.execute({ id: 't1', status: 'in_progress', priority: 'high' }, toolCtx());
+        expect(up.ok).toBe(true);
+        if (!up.ok)
+            return;
+        expect(up.value.task.status).toBe('in_progress');
+        expect(up.value.task.priority).toBe('high');
+        const up2 = await update.execute({ id: 't1', appendNote: 'wip on refresh token' }, toolCtx());
+        expect(up2.ok).toBe(true);
+        const up3 = await update.execute({ id: 't1', appendNote: 'second note' }, toolCtx());
+        expect(up3.ok).toBe(true);
+        if (!up3.ok)
+            return;
+        expect(String(up3.value.task.notes)).toContain('wip on refresh token');
+        expect(String(up3.value.task.notes)).toContain('second note');
+        const nf = await update.execute({ id: 't9', status: 'pending' }, toolCtx());
+        expect(nf.ok).toBe(false);
+        if (nf.ok)
+            return;
+        expect(nf.error).toContain('PLAN_TASK_NOT_FOUND');
+    });
+    it('task_list filters by status and phaseId', async () => {
+        const { create, update, list } = makeTools();
+        await create.execute({ title: 'A', phaseId: 'p1' }, toolCtx());
+        await create.execute({ title: 'B', phaseId: 'p2' }, toolCtx());
+        await update.execute({ id: 't1', status: 'completed' }, toolCtx());
+        const byStatus = await list.execute({ status: 'completed' }, toolCtx());
+        expect(byStatus.ok && byStatus.value.tasks.map((t) => t.id)).toEqual(['t1']);
+        const byPhase = await list.execute({ phaseId: 'p2' }, toolCtx());
+        expect(byPhase.ok && byPhase.value.tasks.map((t) => t.id)).toEqual(['t2']);
+        const all = await list.execute({}, toolCtx());
+        expect(all.ok && all.value.total).toBe(2);
+        expect(all.ok && all.value.done).toBe(1);
+    });
+    it('defensive caps: oversized title is truncated, 101st task rejected', async () => {
+        const { create } = makeTools();
+        // Bypassing zod (registry validates; execute is called directly here) —
+        // the store must still enforce the cap defensively.
+        const res = await create.execute({ title: 'x'.repeat(250) }, toolCtx());
+        expect(res.ok).toBe(true);
+        if (!res.ok)
+            return;
+        expect(res.value.task.title.length).toBe(200);
+        const tasks = Array.from({ length: 100 }, (_, i) => ({
+            kind: 'task',
+            id: `t${i + 1}`,
+            name: `bulk ${i + 1}`,
+            phaseId: 'p0',
+            status: 'pending',
+        }));
+        seedPlanJson({
+            schemaVersion: 1,
+            counter: 100,
+            tasks,
+            phases: [],
+            milestones: [],
+        });
+        const over = await create.execute({ title: 'one too many' }, toolCtx());
+        expect(over.ok).toBe(false);
+        if (over.ok)
+            return;
+        expect(over.error).toContain('PLAN_TOO_MANY_TASKS');
+    });
+    it('corrupt plan.json → PLAN_CORRUPT error and the file is left untouched', async () => {
+        mkdirSync(join(dir, '.zelari'), { recursive: true });
+        writeFileSync(planPath(), '{ broken json', 'utf8');
+        const { create, list } = makeTools();
+        const res = await create.execute({ title: 'X' }, toolCtx());
+        expect(res.ok).toBe(false);
+        if (res.ok)
+            return;
+        expect(res.error).toContain('PLAN_CORRUPT');
+        const ls = await list.execute({}, toolCtx());
+        expect(ls.ok).toBe(false);
+        expect(readFileSync(planPath(), 'utf8')).toBe('{ broken json'); // not overwritten
+    });
+    it('a second write keeps a .bak of the previous state', async () => {
+        const { create } = makeTools();
+        await create.execute({ title: 'first' }, toolCtx());
+        await create.execute({ title: 'second' }, toolCtx());
+        const bak = JSON.parse(readFileSync(`${planPath()}.bak`, 'utf8'));
+        expect(bak.tasks[0].title).toBe('first');
+        const cur = readPlanJson();
+        expect(cur.tasks).toHaveLength(2);
+        expect(cur.counter).toBe(2);
+    });
+    it('council writePlan round-trip preserves schemaVersion/counter (stub interop)', async () => {
+        seedPlanJson({
+            schemaVersion: 1,
+            counter: 3,
+            phases: [{ kind: 'phase', id: 'p1', name: 'P1', order: 1 }],
+            tasks: [
+                {
+                    kind: 'task',
+                    id: 't1',
+                    name: 'Agent task',
+                    title: 'Agent task',
+                    phaseId: 'p1',
+                    status: 'pending',
+                },
+            ],
+            milestones: [],
+        });
+        const wsCtx = createWorkspaceContext(dir);
+        const updateTask = createWorkspaceStubs(wsCtx).find((s) => s.name === 'updateTask');
+        expect(updateTask).toBeTruthy();
+        const out = await updateTask.execute({ taskId: 't1', status: 'done' }, wsCtx);
+        expect(String(out)).toContain('t1');
+        const file = readPlanJson();
+        expect(file.schemaVersion).toBe(1); // ADR-0018 pass-through root fields
+        expect(file.counter).toBe(3);
+        expect(file.tasks[0].status).toBe('done'); // council writer vocabulary
+        expect(file.phases).toHaveLength(1);
+    });
+});
+describe('task_* first-class events (ADR-0018 3b)', () => {
+    it('task_create emits task_update with the created payload', async () => {
+        const events = [];
+        const { create } = makeTools((e) => events.push(e));
+        const res = await create.execute({ title: 'Event slice', priority: 'high', phaseId: 'p9' }, toolCtx());
+        expect(res.ok).toBe(true);
+        expect(events).toEqual([
+            {
+                type: 'task_update',
+                source: 'workspace_plan',
+                task: {
+                    id: 't1',
+                    title: 'Event slice',
+                    status: 'pending',
+                    phaseId: 'p9',
+                    priority: 'high',
+                },
+            },
+        ]);
+    });
+    it('task_update emits task_update with the mutated status', async () => {
+        const events = [];
+        const { create, update } = makeTools((e) => events.push(e));
+        await create.execute({ title: 'A' }, toolCtx());
+        const res = await update.execute({ id: 't1', status: 'in_progress' }, toolCtx());
+        expect(res.ok).toBe(true);
+        const last = events[events.length - 1];
+        expect(last.type).toBe('task_update');
+        if (last.type !== 'task_update')
+            return;
+        expect(last.task.id).toBe('t1');
+        expect(last.task.status).toBe('in_progress');
+    });
+    it('task_list emits a FULL snapshot regardless of filters', async () => {
+        const events = [];
+        const { create, update, list } = makeTools((e) => events.push(e));
+        await create.execute({ title: 'One' }, toolCtx());
+        await create.execute({ title: 'Two' }, toolCtx());
+        await update.execute({ id: 't1', status: 'completed' }, toolCtx());
+        const res = await list.execute({ status: 'pending' }, toolCtx());
+        expect(res.ok).toBe(true);
+        if (!res.ok)
+            return;
+        expect(res.value.tasks).toHaveLength(1); // filtered view for the agent
+        const snap = events.find((e) => e.type === 'task_snapshot');
+        expect(snap).toBeDefined();
+        if (!snap || snap.type !== 'task_snapshot')
+            return;
+        expect(snap.tasks).toHaveLength(2); // full view for frontends
+        expect(snap.tasks.map((t) => `${t.id}:${t.status}`).sort()).toEqual([
+            't1:completed',
+            't2:pending',
+        ]);
+    });
+    it('no events on tool errors; a throwing sink never breaks the tool', async () => {
+        const events = [];
+        const ok = makeTools((e) => events.push(e));
+        const bad = makeTools(() => {
+            throw new Error('sink exploded');
+        });
+        const missing = await ok.update.execute({ id: 'nope', status: 'pending' }, toolCtx());
+        expect(missing.ok).toBe(false);
+        expect(events).toHaveLength(0);
+        const res = await bad.create.execute({ title: 'Still works' }, toolCtx());
+        expect(res.ok).toBe(true);
+        if (!res.ok)
+            return;
+        expect(res.value.id).toBe('t1');
+    });
+});
+//# sourceMappingURL=planStore.test.js.map

package/dist/cli/workspace/planStore.test.js.map

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

package/dist/cli/workspace/stubs.js

@@ -46,10 +46,14 @@ function readPlan(ctx) {
     if (existsSync(jsonPath)) {
         try {
             const parsed = JSON.parse(readFileSync(jsonPath, "utf8"));
+            // ADR-0018: keep unknown root fields (schemaVersion/counter/…) so the
+            // next writePlan round-trips them for the task_* tool store.
+            const { phases, tasks, milestones, ...root } = parsed;
             return {
-                phases: Array.isArray(parsed.phases) ? parsed.phases : [],
-                tasks: Array.isArray(parsed.tasks) ? parsed.tasks : [],
-                milestones: Array.isArray(parsed.milestones) ? parsed.milestones : [],
+                phases: Array.isArray(phases) ? phases : [],
+                tasks: Array.isArray(tasks) ? tasks : [],
+                milestones: Array.isArray(milestones) ? milestones : [],
+                root,
             };
         }
         catch {
@@ -79,7 +83,13 @@ function writePlan(ctx, summary) {
     const jsonPath = planJsonPath(ctx);
     mkdirSync(dirname(jsonPath), { recursive: true });
     const tmp = jsonPath + ".tmp-" + process.pid;
-    writeFileSync(tmp, JSON.stringify(summary, null, 2), "utf8");
+    // ADR-0018: spread pass-through root fields first; canonical arrays win.
+    writeFileSync(tmp, JSON.stringify({
+        ...(summary.root ?? {}),
+        phases: summary.phases,
+        tasks: summary.tasks,
+        milestones: summary.milestones,
+    }, null, 2), "utf8");
     renameSync(tmp, jsonPath);
     const mdPath = workspaceFile(ctx.rootDir, "plan");
     const summaryMeta = {