@pat-lewczuk/cezar 0.1.0

package/dist/index.js

@@ -0,0 +1,294 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { spawn } from 'node:child_process';
+import { createServer } from 'node:net';
+import { mkdirSync, writeFileSync, existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { detectEnvironment } from './core/backend-detect.js';
+import { getRepoInfo } from './server/git.js';
+import { RunStore } from './runs/store.js';
+import { RunManager } from './workflows/run.js';
+import { loadWorkflows } from './workflows/load.js';
+import { startServer } from './server/server.js';
+const HELP = `cezar — local cockpit for AI agent tasks in your repo
+
+Usage:
+  cezar                     start the cockpit (server + GUI) for the current repo
+  cezar run "<task>"        run a task headless in the terminal
+  cezar init                scaffold .ai/cezar/ (example workflow + skill)
+
+Options:
+  -p, --port <n>              cockpit port (default 4321)
+      --repo <dir>            repo to operate on (default: cwd)
+      --workflow <name>       workflow for \`run\` (default: quick-task)
+      --model <model>         model override for \`run\`
+      --no-open               don't open the browser
+  -h, --help                  show this help
+
+Zero config: uses your logged-in \`claude\` CLI (and \`gh\` for GitHub bits).
+Skills live in .ai/skills/ or .ai/cezar/skills/; workflows in .ai/cezar/workflows/.`;
+async function main() {
+    const { values, positionals } = parseArgs({
+        options: {
+            port: { type: 'string', short: 'p', default: '4321' },
+            repo: { type: 'string' },
+            workflow: { type: 'string' },
+            model: { type: 'string' },
+            'no-open': { type: 'boolean', default: false },
+            help: { type: 'boolean', short: 'h', default: false },
+        },
+        allowPositionals: true,
+    });
+    if (values.help) {
+        console.log(HELP);
+        return;
+    }
+    const command = positionals[0] ?? 'serve';
+    const cwd = resolve(values.repo ?? process.cwd());
+    const repoInfo = await getRepoInfo(cwd);
+    const repoRoot = repoInfo?.root ?? cwd;
+    switch (command) {
+        case 'serve':
+            await serveCommand(repoRoot, Number(values.port), !values['no-open']);
+            return;
+        case 'run':
+            await runCommand(repoRoot, positionals.slice(1).join(' ').trim(), values.workflow, values.model);
+            return;
+        case 'init':
+            initCommand(repoRoot);
+            return;
+        default:
+            console.error(`unknown command: ${command}\n`);
+            console.log(HELP);
+            process.exitCode = 1;
+    }
+}
+// ---- serve -----------------------------------------------------------------
+async function serveCommand(repoRoot, preferredPort, openBrowser) {
+    const store = openStore(repoRoot);
+    const manager = new RunManager(store, repoRoot);
+    const version = readOwnVersion();
+    const checks = await detectEnvironment();
+    const repo = await getRepoInfo(repoRoot);
+    const port = await pickPort(preferredPort);
+    startServer({ repoRoot, store, manager, version }, port);
+    const url = `http://localhost:${port}`;
+    console.log(`\n  cezar v${version} — ${repoRoot}`);
+    console.log(`  ${repo ? `branch ${repo.branch}` : 'not a git repository (runs still work, repo view is empty)'}`);
+    for (const check of checks) {
+        const mark = check.available ? '✓' : '✗';
+        const detail = check.available ? (check.version ?? 'ok') : (check.hint ?? 'missing');
+        console.log(`  ${mark} ${check.name.padEnd(6)} ${detail}`);
+    }
+    if (port !== preferredPort)
+        console.log(`  (port ${preferredPort} was busy — using ${port})`);
+    console.log(`\n  cockpit → ${url}\n`);
+    const shutdown = () => {
+        store.flush();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    // Open the browser only once the server actually answers, so the first
+    // paint is the cockpit and never a connection error.
+    if (openBrowser) {
+        const healthy = await waitForHealth(`${url}/api/health`, 5_000);
+        if (healthy)
+            openUrl(url);
+    }
+}
+/** First free port starting at `start` (the launch.mjs pattern from janitor). */
+async function pickPort(start) {
+    for (let port = start; port < start + 50; port++) {
+        if (await canListen(port))
+            return port;
+    }
+    return start; // let the server fail loudly if 50 ports are somehow busy
+}
+function canListen(port) {
+    return new Promise((resolvePort) => {
+        const probe = createServer();
+        probe.once('error', () => resolvePort(false));
+        probe.once('listening', () => probe.close(() => resolvePort(true)));
+        probe.listen(port, '127.0.0.1');
+    });
+}
+async function waitForHealth(healthUrl, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        try {
+            const res = await fetch(healthUrl);
+            if (res.ok)
+                return true;
+        }
+        catch {
+            // not up yet
+        }
+        await new Promise((r) => setTimeout(r, 150));
+    }
+    return false;
+}
+// ---- run (headless) ----------------------------------------------------------
+async function runCommand(repoRoot, task, workflowName, model) {
+    if (!task) {
+        console.error('usage: cezar run "<task>" [--workflow name] [--model model]');
+        process.exitCode = 1;
+        return;
+    }
+    const { workflows, issues } = await loadWorkflows(repoRoot);
+    for (const issue of issues)
+        console.error(`! skipped ${issue.path}: ${issue.message}`);
+    const name = workflowName ?? 'quick-task';
+    const workflow = workflows.find((w) => w.name === name);
+    if (!workflow) {
+        console.error(`unknown workflow: ${name} (available: ${workflows.map((w) => w.name).join(', ')})`);
+        process.exitCode = 1;
+        return;
+    }
+    const store = openStore(repoRoot);
+    const manager = new RunManager(store, repoRoot);
+    store.on('event', ({ event }) => {
+        switch (event.type) {
+            case 'text':
+                console.log(String(event.text ?? ''));
+                break;
+            case 'tool-call':
+                console.log(`  → ${String(event.tool)} ${previewJson(event.input)}`);
+                break;
+            case 'tool-result':
+                console.log(`  ← ${firstLine(String(event.result ?? ''))}`);
+                break;
+            case 'check-output':
+                console.log(String(event.text ?? ''));
+                break;
+            case 'step-start':
+                console.log(`\n── step: ${String(event.name)} ${Number(event.iteration) > 1 ? `(attempt ${event.iteration})` : ''}`);
+                break;
+            case 'note':
+            case 'lifecycle':
+                console.log(`  · ${String(event.message ?? '')}`);
+                break;
+            case 'error':
+                console.error(`  ✗ ${String(event.message ?? '')}`);
+                break;
+        }
+    });
+    const run = manager.startRun(workflow, { task, model });
+    const final = await new Promise((resolveStatus) => {
+        store.on('run', (r) => {
+            if (r.id === run.id && ['done', 'failed', 'cancelled'].includes(r.status))
+                resolveStatus(r.status);
+        });
+    });
+    store.flush();
+    const record = store.getRun(run.id);
+    console.log(`\nrun ${final} — ${record?.tokensUsed ?? 0} tokens — details in the cockpit: npx cezar`);
+    process.exitCode = final === 'done' ? 0 : 1;
+}
+// ---- init --------------------------------------------------------------------
+function initCommand(repoRoot) {
+    const workflowsDir = join(repoRoot, '.ai/cezar', 'workflows');
+    const skillsDir = join(repoRoot, '.ai/cezar', 'skills');
+    mkdirSync(workflowsDir, { recursive: true });
+    mkdirSync(skillsDir, { recursive: true });
+    const examples = [
+        {
+            path: join(workflowsDir, 'fix-and-verify.yaml'),
+            content: `name: fix-and-verify
+description: Implement the task, then run your test command; on failure the agent retries with the failing output.
+steps:
+  - id: implement
+    name: Implement
+    prompt: "{{task}}"
+  - id: verify
+    name: Verify
+    command: "echo 'replace me with: npm test / yarn test / pytest'"
+    onFail:
+      retry: implement
+      max: 2
+`,
+        },
+        {
+            path: join(skillsDir, 'project-conventions.md'),
+            content: `---
+name: project-conventions
+description: House rules the agent should follow in this repo.
+---
+
+# Project conventions
+
+- Describe your stack, style and testing conventions here.
+- Reference this skill from a workflow step via \`skill: project-conventions\`.
+`,
+        },
+    ];
+    for (const example of examples) {
+        if (existsSync(example.path)) {
+            console.log(`  = ${example.path} (exists, left untouched)`);
+        }
+        else {
+            writeFileSync(example.path, example.content, 'utf8');
+            console.log(`  + ${example.path}`);
+        }
+    }
+    ensureDataGitignore(repoRoot);
+    console.log('\nDone. Start the cockpit with: npx cezar');
+}
+// ---- helpers -----------------------------------------------------------------
+function openStore(repoRoot) {
+    const dataDir = join(repoRoot, '.ai/cezar');
+    const store = RunStore.open(dataDir);
+    ensureDataGitignore(repoRoot);
+    return store;
+}
+/** Keep run data out of the user's repo history; workflows/skills stay committable. */
+function ensureDataGitignore(repoRoot) {
+    const path = join(repoRoot, '.ai/cezar', '.gitignore');
+    try {
+        mkdirSync(join(repoRoot, '.ai/cezar'), { recursive: true });
+        if (!existsSync(path))
+            writeFileSync(path, 'runs.json\nruns.json.tmp\nruns/\n', 'utf8');
+    }
+    catch {
+        // non-fatal
+    }
+}
+function readOwnVersion() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const pkg = JSON.parse(readFileSync(join(here, '..', 'package.json'), 'utf8'));
+        return pkg.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+function openUrl(url) {
+    const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'cmd' : 'xdg-open';
+    const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];
+    try {
+        spawn(cmd, args, { stdio: 'ignore', detached: true }).unref();
+    }
+    catch {
+        // the printed URL is enough
+    }
+}
+function previewJson(input) {
+    try {
+        const s = JSON.stringify(input);
+        return s.length > 120 ? `${s.slice(0, 117)}…` : s;
+    }
+    catch {
+        return '';
+    }
+}
+function firstLine(s) {
+    const line = s.split('\n')[0] ?? '';
+    return line.length > 120 ? `${line.slice(0, 117)}…` : line;
+}
+main().catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/runs/store.d.ts

@@ -0,0 +1,218 @@
+import { EventEmitter } from 'node:events';
+import { z } from 'zod';
+export type RunStatus = 'queued' | 'running' | 'waiting' | 'done' | 'failed' | 'cancelled';
+export type StepStatus = 'pending' | 'running' | 'waiting' | 'done' | 'failed' | 'cancelled' | 'skipped';
+declare const stepStateSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    kind: z.ZodEnum<["agent", "check"]>;
+    status: z.ZodEnum<["pending", "running", "waiting", "done", "failed", "cancelled", "skipped"]>;
+    iterations: z.ZodNumber;
+    tokensUsed: z.ZodNumber;
+    startedAt: z.ZodOptional<z.ZodString>;
+    finishedAt: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    /** Latest claude session id — the user can `claude --resume <id>` with it. */
+    sessionId: z.ZodOptional<z.ZodString>;
+    /** Dollar cost reported by the claude CLI for this step's turns. */
+    costUsd: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    status: "running" | "waiting" | "done" | "failed" | "cancelled" | "pending" | "skipped";
+    id: string;
+    kind: "agent" | "check";
+    iterations: number;
+    tokensUsed: number;
+    startedAt?: string | undefined;
+    finishedAt?: string | undefined;
+    error?: string | undefined;
+    sessionId?: string | undefined;
+    costUsd?: number | undefined;
+}, {
+    name: string;
+    status: "running" | "waiting" | "done" | "failed" | "cancelled" | "pending" | "skipped";
+    id: string;
+    kind: "agent" | "check";
+    iterations: number;
+    tokensUsed: number;
+    startedAt?: string | undefined;
+    finishedAt?: string | undefined;
+    error?: string | undefined;
+    sessionId?: string | undefined;
+    costUsd?: number | undefined;
+}>;
+declare const runRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    workflow: z.ZodString;
+    task: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["queued", "running", "waiting", "done", "failed", "cancelled"]>;
+    createdAt: z.ZodString;
+    startedAt: z.ZodOptional<z.ZodString>;
+    finishedAt: z.ZodOptional<z.ZodString>;
+    tokensUsed: z.ZodNumber;
+    costUsd: z.ZodOptional<z.ZodNumber>;
+    /** First GitHub PR URL spotted in the transcript (the janitor trick). */
+    pullRequestUrl: z.ZodOptional<z.ZodString>;
+    archived: z.ZodDefault<z.ZodBoolean>;
+    archivedAt: z.ZodOptional<z.ZodString>;
+    currentStepId: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        kind: z.ZodEnum<["agent", "check"]>;
+        status: z.ZodEnum<["pending", "running", "waiting", "done", "failed", "cancelled", "skipped"]>;
+        iterations: z.ZodNumber;
+        tokensUsed: z.ZodNumber;
+        startedAt: z.ZodOptional<z.ZodString>;
+        finishedAt: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        /** Latest claude session id — the user can `claude --resume <id>` with it. */
+        sessionId: z.ZodOptional<z.ZodString>;
+        /** Dollar cost reported by the claude CLI for this step's turns. */
+        costUsd: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        status: "running" | "waiting" | "done" | "failed" | "cancelled" | "pending" | "skipped";
+        id: string;
+        kind: "agent" | "check";
+        iterations: number;
+        tokensUsed: number;
+        startedAt?: string | undefined;
+        finishedAt?: string | undefined;
+        error?: string | undefined;
+        sessionId?: string | undefined;
+        costUsd?: number | undefined;
+    }, {
+        name: string;
+        status: "running" | "waiting" | "done" | "failed" | "cancelled" | "pending" | "skipped";
+        id: string;
+        kind: "agent" | "check";
+        iterations: number;
+        tokensUsed: number;
+        startedAt?: string | undefined;
+        finishedAt?: string | undefined;
+        error?: string | undefined;
+        sessionId?: string | undefined;
+        costUsd?: number | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    status: "queued" | "running" | "waiting" | "done" | "failed" | "cancelled";
+    id: string;
+    tokensUsed: number;
+    title: string;
+    workflow: string;
+    task: string;
+    createdAt: string;
+    archived: boolean;
+    steps: {
+        name: string;
+        status: "running" | "waiting" | "done" | "failed" | "cancelled" | "pending" | "skipped";
+        id: string;
+        kind: "agent" | "check";
+        iterations: number;
+        tokensUsed: number;
+        startedAt?: string | undefined;
+        finishedAt?: string | undefined;
+        error?: string | undefined;
+        sessionId?: string | undefined;
+        costUsd?: number | undefined;
+    }[];
+    startedAt?: string | undefined;
+    finishedAt?: string | undefined;
+    error?: string | undefined;
+    costUsd?: number | undefined;
+    model?: string | undefined;
+    pullRequestUrl?: string | undefined;
+    archivedAt?: string | undefined;
+    currentStepId?: string | undefined;
+}, {
+    status: "queued" | "running" | "waiting" | "done" | "failed" | "cancelled";
+    id: string;
+    tokensUsed: number;
+    title: string;
+    workflow: string;
+    task: string;
+    createdAt: string;
+    steps: {
+        name: string;
+        status: "running" | "waiting" | "done" | "failed" | "cancelled" | "pending" | "skipped";
+        id: string;
+        kind: "agent" | "check";
+        iterations: number;
+        tokensUsed: number;
+        startedAt?: string | undefined;
+        finishedAt?: string | undefined;
+        error?: string | undefined;
+        sessionId?: string | undefined;
+        costUsd?: number | undefined;
+    }[];
+    startedAt?: string | undefined;
+    finishedAt?: string | undefined;
+    error?: string | undefined;
+    costUsd?: number | undefined;
+    model?: string | undefined;
+    pullRequestUrl?: string | undefined;
+    archived?: boolean | undefined;
+    archivedAt?: string | undefined;
+    currentStepId?: string | undefined;
+}>;
+export type StepState = z.infer<typeof stepStateSchema>;
+export type RunRecord = z.infer<typeof runRecordSchema>;
+/** One persisted event line; `type` mirrors AgentEvent plus engine lifecycle. */
+export interface RunEvent {
+    seq: number;
+    ts: string;
+    stepId?: string;
+    type: string;
+    [key: string]: unknown;
+}
+/**
+ * File-backed run store: `runs.json` index (atomic tmp+rename writes, the
+ * pattern from @cezar/core's IssueStore) plus one append-only NDJSON event
+ * file per run. Also the in-process event bus the SSE endpoints subscribe to:
+ * emits `('run', RunRecord)` and `('event', { runId, event: RunEvent })`.
+ */
+export declare class RunStore extends EventEmitter {
+    private readonly dataDir;
+    private runs;
+    private saveTimer;
+    private constructor();
+    static open(dataDir: string): RunStore;
+    listRuns(): RunRecord[];
+    getRun(id: string): RunRecord | undefined;
+    createRun(input: {
+        title: string;
+        workflow: string;
+        task: string;
+        model?: string;
+        steps: Array<Pick<StepState, 'id' | 'name' | 'kind'>>;
+    }): RunRecord;
+    updateRun(id: string, patch: Partial<Omit<RunRecord, 'id' | 'steps'>>): RunRecord | undefined;
+    /** Append a step to an existing run (used by "Continue" — spec 003). */
+    addStep(runId: string, step: Pick<StepState, 'id' | 'name' | 'kind'>): void;
+    updateStep(runId: string, stepId: string, patch: Partial<Omit<StepState, 'id'>>): void;
+    setArchived(id: string, archived: boolean): RunRecord | undefined;
+    /** Bulk-archive every finished run; returns how many were archived. */
+    archiveFinished(): number;
+    appendEvent(runId: string, event: {
+        type: string;
+        stepId?: string;
+        [key: string]: unknown;
+    }): RunEvent;
+    readEvents(runId: string): RunEvent[];
+    deleteRun(id: string): boolean;
+    /** Write the index out now (used on shutdown). */
+    flush(): void;
+    private seqs;
+    private nextSeq;
+    private eventsPath;
+    private touch;
+    private pruneOldRuns;
+    /** Debounced so token-usage updates don't rewrite the index per event. */
+    private scheduleSave;
+    private saveNow;
+}
+export {};