@pat-lewczuk/cezar 0.1.0

package/dist/workflows/types.d.ts

@@ -0,0 +1,202 @@
+import { z } from 'zod';
+/**
+ * A workflow is an ordered list of steps. Two step kinds:
+ *  - `agent` — one claude CLI run (prompt + optional skill + model + tools);
+ *  - `check` — a shell command; exit 0 passes, non-zero can loop back to an
+ *    earlier step via `onFail` (bounded by `max`).
+ *
+ * `{{task}}` in a prompt is replaced with the user's task text. When a check
+ * loops back, the failing output is appended to the retried agent's prompt.
+ */
+export declare const workflowStepSchema: z.ZodEffects<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    skill: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    allowedTools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    command: z.ZodOptional<z.ZodString>;
+    onFail: z.ZodOptional<z.ZodObject<{
+        retry: z.ZodString;
+        max: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        retry: string;
+        max: number;
+    }, {
+        retry: string;
+        max?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name?: string | undefined;
+    model?: string | undefined;
+    prompt?: string | undefined;
+    skill?: string | undefined;
+    allowedTools?: string[] | undefined;
+    bashAllowlist?: string[] | undefined;
+    command?: string | undefined;
+    onFail?: {
+        retry: string;
+        max: number;
+    } | undefined;
+}, {
+    id: string;
+    name?: string | undefined;
+    model?: string | undefined;
+    prompt?: string | undefined;
+    skill?: string | undefined;
+    allowedTools?: string[] | undefined;
+    bashAllowlist?: string[] | undefined;
+    command?: string | undefined;
+    onFail?: {
+        retry: string;
+        max?: number | undefined;
+    } | undefined;
+}>, {
+    id: string;
+    name?: string | undefined;
+    model?: string | undefined;
+    prompt?: string | undefined;
+    skill?: string | undefined;
+    allowedTools?: string[] | undefined;
+    bashAllowlist?: string[] | undefined;
+    command?: string | undefined;
+    onFail?: {
+        retry: string;
+        max: number;
+    } | undefined;
+}, {
+    id: string;
+    name?: string | undefined;
+    model?: string | undefined;
+    prompt?: string | undefined;
+    skill?: string | undefined;
+    allowedTools?: string[] | undefined;
+    bashAllowlist?: string[] | undefined;
+    command?: string | undefined;
+    onFail?: {
+        retry: string;
+        max?: number | undefined;
+    } | undefined;
+}>;
+export declare const workflowFileSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+        skill: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        allowedTools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        command: z.ZodOptional<z.ZodString>;
+        onFail: z.ZodOptional<z.ZodObject<{
+            retry: z.ZodString;
+            max: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            retry: string;
+            max: number;
+        }, {
+            retry: string;
+            max?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name?: string | undefined;
+        model?: string | undefined;
+        prompt?: string | undefined;
+        skill?: string | undefined;
+        allowedTools?: string[] | undefined;
+        bashAllowlist?: string[] | undefined;
+        command?: string | undefined;
+        onFail?: {
+            retry: string;
+            max: number;
+        } | undefined;
+    }, {
+        id: string;
+        name?: string | undefined;
+        model?: string | undefined;
+        prompt?: string | undefined;
+        skill?: string | undefined;
+        allowedTools?: string[] | undefined;
+        bashAllowlist?: string[] | undefined;
+        command?: string | undefined;
+        onFail?: {
+            retry: string;
+            max?: number | undefined;
+        } | undefined;
+    }>, {
+        id: string;
+        name?: string | undefined;
+        model?: string | undefined;
+        prompt?: string | undefined;
+        skill?: string | undefined;
+        allowedTools?: string[] | undefined;
+        bashAllowlist?: string[] | undefined;
+        command?: string | undefined;
+        onFail?: {
+            retry: string;
+            max: number;
+        } | undefined;
+    }, {
+        id: string;
+        name?: string | undefined;
+        model?: string | undefined;
+        prompt?: string | undefined;
+        skill?: string | undefined;
+        allowedTools?: string[] | undefined;
+        bashAllowlist?: string[] | undefined;
+        command?: string | undefined;
+        onFail?: {
+            retry: string;
+            max?: number | undefined;
+        } | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    steps: {
+        id: string;
+        name?: string | undefined;
+        model?: string | undefined;
+        prompt?: string | undefined;
+        skill?: string | undefined;
+        allowedTools?: string[] | undefined;
+        bashAllowlist?: string[] | undefined;
+        command?: string | undefined;
+        onFail?: {
+            retry: string;
+            max: number;
+        } | undefined;
+    }[];
+    description?: string | undefined;
+}, {
+    name: string;
+    steps: {
+        id: string;
+        name?: string | undefined;
+        model?: string | undefined;
+        prompt?: string | undefined;
+        skill?: string | undefined;
+        allowedTools?: string[] | undefined;
+        bashAllowlist?: string[] | undefined;
+        command?: string | undefined;
+        onFail?: {
+            retry: string;
+            max?: number | undefined;
+        } | undefined;
+    }[];
+    description?: string | undefined;
+}>;
+export type WorkflowStepDef = z.infer<typeof workflowStepSchema>;
+export interface WorkflowDef extends z.infer<typeof workflowFileSchema> {
+    source: 'built-in' | 'file';
+    path?: string;
+}
+export declare function stepKind(step: WorkflowStepDef): 'agent' | 'check';
+/** Tools an agent step gets when the workflow doesn't say otherwise. */
+export declare const DEFAULT_ALLOWED_TOOLS: string[];
+/** The zero-config workflow: one agent step that just does the task. */
+export declare const QUICK_TASK_WORKFLOW: WorkflowDef;

package/dist/workflows/types.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+/**
+ * A workflow is an ordered list of steps. Two step kinds:
+ *  - `agent` — one claude CLI run (prompt + optional skill + model + tools);
+ *  - `check` — a shell command; exit 0 passes, non-zero can loop back to an
+ *    earlier step via `onFail` (bounded by `max`).
+ *
+ * `{{task}}` in a prompt is replaced with the user's task text. When a check
+ * loops back, the failing output is appended to the retried agent's prompt.
+ */
+export const workflowStepSchema = z
+    .object({
+    id: z.string().min(1),
+    name: z.string().optional(),
+    // agent step
+    prompt: z.string().optional(),
+    skill: z.string().optional(),
+    model: z.string().optional(),
+    allowedTools: z.array(z.string()).optional(),
+    bashAllowlist: z.array(z.string()).optional(),
+    // check step
+    command: z.string().optional(),
+    onFail: z
+        .object({
+        retry: z.string().min(1),
+        max: z.number().int().positive().default(2),
+    })
+        .optional(),
+})
+    .refine((s) => Boolean(s.command) !== Boolean(s.prompt ?? s.skill), {
+    message: 'a step is either an agent step (prompt/skill) or a check step (command), not both',
+});
+export const workflowFileSchema = z.object({
+    name: z.string().min(1),
+    description: z.string().optional(),
+    steps: z.array(workflowStepSchema).min(1),
+});
+export function stepKind(step) {
+    return step.command ? 'check' : 'agent';
+}
+/** Tools an agent step gets when the workflow doesn't say otherwise. */
+export const DEFAULT_ALLOWED_TOOLS = ['Read', 'Edit', 'Write', 'Grep', 'Glob', 'Bash'];
+/** The zero-config workflow: one agent step that just does the task. */
+export const QUICK_TASK_WORKFLOW = {
+    name: 'quick-task',
+    description: 'One agent run on your task — no ceremony.',
+    source: 'built-in',
+    steps: [
+        {
+            id: 'task',
+            name: 'Do the task',
+            prompt: '{{task}}',
+        },
+    ],
+};
+//# sourceMappingURL=types.js.map

package/dist/workflows/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workflows/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,aAAa;IACb,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,aAAa;IACb,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACxB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;KAC5C,CAAC;SACD,QAAQ,EAAE;CACd,CAAC;KACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE;IAClE,OAAO,EAAE,mFAAmF;CAC7F,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1C,CAAC,CAAC;AASH,MAAM,UAAU,QAAQ,CAAC,IAAqB;IAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AAC1C,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvF,wEAAwE;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC9C,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,2CAA2C;IACxD,MAAM,EAAE,UAAU;IAClB,KAAK,EAAE;QACL;YACE,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,UAAU;SACnB;KACF;CACF,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@pat-lewczuk/cezar",
+  "version": "0.1.0",
+  "description": "Local cockpit for running and tracking AI agent tasks in your repo. Uses your logged-in `claude` CLI and `gh` — zero config, zero database.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "cezar": "dist/index.js",
+    "cez": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "web",
+    "scripts",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.13.0",
+    "hono": "^4.6.0",
+    "yaml": "^2.5.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/open-mercato/cezar"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/mock-claude.mjs

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+// Mock `claude` binary for CEZ_DRY_RUN=1 — emits a plausible stream-json
+// session so the engine / store / GUI can be exercised without tokens.
+// Mirrors the real CLI's contract in SESSION mode: keeps reading {type:user}
+// NDJSON lines from stdin, answers each with a scripted turn (assistant
+// events + a terminal `result`), and exits when stdin closes (EOF).
+
+import { createInterface } from 'node:readline';
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const emit = (obj) => process.stdout.write(`${JSON.stringify(obj)}\n`);
+
+emit({ type: 'system', subtype: 'init' });
+
+let turn = 0;
+
+async function respond(userText, imageCount) {
+  turn += 1;
+  await sleep(250);
+
+  if (turn === 1) {
+    emit({
+      type: 'assistant',
+      message: {
+        role: 'assistant',
+        content: [{ type: 'text', text: `Okay — looking into: ${userText.slice(0, 120)}` }],
+        usage: { input_tokens: 850, output_tokens: 40 },
+      },
+    });
+    await sleep(300);
+    emit({
+      type: 'assistant',
+      message: {
+        role: 'assistant',
+        content: [{ type: 'tool_use', id: `toolu_mock_${turn}`, name: 'Bash', input: { command: 'git status --short' } }],
+        usage: { input_tokens: 120, output_tokens: 55 },
+      },
+    });
+    await sleep(300);
+    emit({
+      type: 'user',
+      message: {
+        role: 'user',
+        content: [{ type: 'tool_result', tool_use_id: `toolu_mock_${turn}`, content: ' M src/example.ts' }],
+      },
+    });
+    await sleep(300);
+    emit({
+      type: 'assistant',
+      message: {
+        role: 'assistant',
+        content: [{ type: 'text', text: 'Done with the first pass — opened a draft PR: https://github.com/open-mercato/demo/pull/123. Anything to adjust? (dry-run mock)' }],
+        usage: { input_tokens: 300, output_tokens: 90 },
+      },
+    });
+    await sleep(150);
+    emit({
+      type: 'result',
+      subtype: 'success',
+      result: 'Done with the first pass (dry run).',
+      usage: { input_tokens: 1270, output_tokens: 185 },
+      total_cost_usd: 0.0342,
+    });
+    return;
+  }
+
+  const imgNote = imageCount > 0 ? ` I can see ${imageCount} image(s) you attached.` : '';
+  emit({
+    type: 'assistant',
+    message: {
+      role: 'assistant',
+      content: [{ type: 'text', text: `Follow-up #${turn - 1} received: "${userText.slice(0, 100)}".${imgNote} Applied (dry run).` }],
+      usage: { input_tokens: 200, output_tokens: 60 },
+    },
+  });
+  await sleep(150);
+  emit({
+    type: 'result',
+    subtype: 'success',
+    result: `Follow-up #${turn - 1} handled (dry run).`,
+    usage: { input_tokens: 200, output_tokens: 60 },
+    total_cost_usd: 0.0051,
+  });
+}
+
+const rl = createInterface({ input: process.stdin });
+let queue = Promise.resolve();
+rl.on('line', (line) => {
+  const trimmed = line.trim();
+  if (!trimmed) return;
+  let userText = '(unparseable message)';
+  let imageCount = 0;
+  try {
+    const msg = JSON.parse(trimmed);
+    const blocks = msg?.message?.content ?? [];
+    userText = blocks.filter((b) => b.type === 'text').map((b) => b.text).join('\n') || '(no text)';
+    imageCount = blocks.filter((b) => b.type === 'image').length;
+  } catch {
+    // keep placeholders
+  }
+  queue = queue.then(() => respond(userText, imageCount));
+});
+rl.on('close', () => {
+  // EOF = session over; finish any in-flight turn then exit cleanly.
+  queue.then(() => process.exit(0));
+});