@prestyj/cli 5.30.0 → 5.30.2

package/dist/core/bash-spawn-benchmark.js

@@ -1,139 +0,0 @@
-/**
- * Per-call spawn (what tools/bash.ts does today) vs a persistent shell session
- * (what oh-my-pi's embedded "brush" bash gives them) — local measurement, no
- * LLM calls needed.
- *
- * Strategy A — SPAWN (current): every command is `spawn("bash", ["-c", cmd])`,
- *   a fresh process with fresh env/cwd. Cost = fork/exec + shell startup per call.
- *
- * Strategy B — PERSISTENT: one long-lived `bash` process; commands are written
- *   to stdin and delimited with a sentinel echo. Cost ≈ pipe round-trip.
- *   Bonus property (qualitative): cd / env / shell state survive across calls.
- *
- * We run the same command list through both and report total + per-call wall
- * time. Commands are trivial on purpose — we are measuring HARNESS overhead,
- * not the commands themselves.
- *
- * Usage:
- *   npx tsx src/core/bash-spawn-benchmark.ts
- *
- * Env overrides:
- *   EZ_BASH_BENCH_N  (commands per strategy, default 30)
- */
-import { spawn } from "node:child_process";
-import { randomUUID } from "node:crypto";
-const COMMANDS = ["echo hello", "pwd", "ls / > /dev/null", "printf '%s' done", "true"];
-function buildCommandList(n) {
-    const out = [];
-    for (let i = 0; i < n; i++)
-        out.push(COMMANDS[i % COMMANDS.length]);
-    return out;
-}
-// ── Strategy A: fresh spawn per call (mirrors tools/bash.ts) ──
-function runSpawned(cmd) {
-    return new Promise((resolve, reject) => {
-        const start = performance.now();
-        const child = spawn("bash", ["-c", cmd], { stdio: ["ignore", "pipe", "pipe"] });
-        child.stdout.on("data", () => { });
-        child.stderr.on("data", () => { });
-        child.on("error", reject);
-        child.on("close", () => resolve(performance.now() - start));
-    });
-}
-// ── Strategy B: one persistent bash, sentinel-delimited ──
-class PersistentShell {
-    child = spawn("bash", ["--norc", "--noprofile"], {
-        stdio: ["pipe", "pipe", "pipe"],
-    });
-    buffer = "";
-    waiter = null;
-    constructor() {
-        this.child.stdout.on("data", (d) => {
-            this.buffer += d.toString();
-            if (this.waiter && this.buffer.includes(this.waiter.sentinel)) {
-                const w = this.waiter;
-                this.waiter = null;
-                this.buffer = "";
-                w.resolve();
-            }
-        });
-        this.child.stderr.on("data", () => { });
-    }
-    run(cmd) {
-        const start = performance.now();
-        const sentinel = `__EZ_DONE_${randomUUID()}__`;
-        return new Promise((resolve) => {
-            this.waiter = { sentinel, resolve: () => resolve(performance.now() - start) };
-            this.child.stdin.write(`${cmd}\necho ${sentinel}\n`);
-        });
-    }
-    /** Prove state persistence: cd + env var survive across run() calls. */
-    async statePersists() {
-        await this.run("cd /tmp && export EZ_BENCH_STATE=alive");
-        const sentinel = `__EZ_STATE_${randomUUID()}__`;
-        const out = await new Promise((resolve) => {
-            let acc = "";
-            const onData = (d) => {
-                acc += d.toString();
-                if (acc.includes(sentinel)) {
-                    this.child.stdout.off("data", onData);
-                    resolve(acc);
-                }
-            };
-            this.child.stdout.on("data", onData);
-            this.child.stdin.write(`pwd; echo "$EZ_BENCH_STATE"; echo ${sentinel}\n`);
-        });
-        return out.includes("/tmp") && out.includes("alive");
-    }
-    close() {
-        this.child.stdin.end();
-        this.child.kill();
-    }
-}
-// ── Stats ──
-function stats(samples) {
-    const sorted = [...samples].sort((a, b) => a - b);
-    const total = samples.reduce((s, x) => s + x, 0);
-    const at = (q) => sorted[Math.min(sorted.length - 1, Math.floor(q * sorted.length))];
-    return { total, mean: total / samples.length, p50: at(0.5), p95: at(0.95) };
-}
-function fmt(s) {
-    return (`total ${s.total.toFixed(0)}ms | mean ${s.mean.toFixed(1)}ms | ` +
-        `p50 ${s.p50.toFixed(1)}ms | p95 ${s.p95.toFixed(1)}ms`);
-}
-async function main() {
-    const n = Math.max(5, parseInt(process.env.EZ_BASH_BENCH_N ?? "30", 10));
-    const cmds = buildCommandList(n);
-    console.log(`\n🐚 Bash harness overhead — ${n} commands per strategy\n`);
-    // Warm both paths once so first-touch costs don't skew either side.
-    await runSpawned("true");
-    const shell = new PersistentShell();
-    await shell.run("true");
-    const spawnTimes = [];
-    for (const c of cmds)
-        spawnTimes.push(await runSpawned(c));
-    const persistTimes = [];
-    for (const c of cmds)
-        persistTimes.push(await shell.run(c));
-    const persists = await shell.statePersists();
-    shell.close();
-    const a = stats(spawnTimes);
-    const b = stats(persistTimes);
-    console.log(`SPAWN-PER-CALL (current):  ${fmt(a)}`);
-    console.log(`PERSISTENT SHELL (theirs): ${fmt(b)}`);
-    const saved = a.mean - b.mean;
-    console.log(`\nPer-call overhead saved: ${saved.toFixed(1)}ms ` +
-        `(${((saved / a.mean) * 100).toFixed(0)}% of mean call cost)`);
-    console.log(`State persistence across calls (cd/env): ${persists ? "YES" : "NO"}`);
-    console.log(`\nVerdict: persistent shell wins if per-call saving is meaningful at agent scale ` +
-        `(a long session runs hundreds of bash calls) AND state persistence is a UX win.\n`);
-}
-const isDirectRun = process.argv[1]?.endsWith("bash-spawn-benchmark.ts") ||
-    process.argv[1]?.endsWith("bash-spawn-benchmark.js");
-if (isDirectRun) {
-    main().catch((err) => {
-        console.error("Benchmark failed:", err);
-        process.exit(1);
-    });
-}
-//# sourceMappingURL=bash-spawn-benchmark.js.map

package/dist/core/bash-spawn-benchmark.js.map

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

package/dist/core/cache-warm-benchmark.d.ts

@@ -1,21 +0,0 @@
-/**
- * Prompt-cache warming micro-benchmark — isolates the cache effect.
- *
- * The existing api-benchmark grows the conversation each turn and uses a tiny
- * (~250 token) system prompt, which is BELOW Anthropic's minimum cacheable
- * prefix (1024 tok Sonnet/Opus, 2048 Haiku) — so caching never engages and the
- * A/B is dominated by turn-to-turn throughput variance.
- *
- * This test uses a large, FIXED prefix (well above the min) and a tiny variable
- * suffix, then measures, per arm:
- *   COLD  — fresh cache key, first hit (cache WRITE, no read).
- *   WARM  — prewarm the prefix, then measure the next call's cache_read + TTFT.
- *
- * It reports cache_read tokens and TTFT directly, so the cache effect is visible
- * regardless of throughput noise.
- *
- * Usage: npx tsx src/core/cache-warm-benchmark.ts
- * Env:   EZ_CW_PROVIDER (default anthropic), EZ_CW_MODEL (default claude-haiku-4-5-20251001),
- *        EZ_CW_REPS (default 4)
- */
-export {};

package/dist/core/cache-warm-benchmark.js

@@ -1,170 +0,0 @@
-/**
- * Prompt-cache warming micro-benchmark — isolates the cache effect.
- *
- * The existing api-benchmark grows the conversation each turn and uses a tiny
- * (~250 token) system prompt, which is BELOW Anthropic's minimum cacheable
- * prefix (1024 tok Sonnet/Opus, 2048 Haiku) — so caching never engages and the
- * A/B is dominated by turn-to-turn throughput variance.
- *
- * This test uses a large, FIXED prefix (well above the min) and a tiny variable
- * suffix, then measures, per arm:
- *   COLD  — fresh cache key, first hit (cache WRITE, no read).
- *   WARM  — prewarm the prefix, then measure the next call's cache_read + TTFT.
- *
- * It reports cache_read tokens and TTFT directly, so the cache effect is visible
- * regardless of throughput noise.
- *
- * Usage: npx tsx src/core/cache-warm-benchmark.ts
- * Env:   EZ_CW_PROVIDER (default anthropic), EZ_CW_MODEL (default claude-haiku-4-5-20251001),
- *        EZ_CW_REPS (default 4)
- */
-import { stream } from "@prestyj/ai";
-import { AuthStorage } from "./auth-storage.js";
-/** Build a large, realistic coding-agent system prompt (~well above 2048 tok). */
-function bigPrefix() {
-    const toolDoc = (name, desc) => `### ${name}\n${desc}\nParameters are validated with a Zod schema and converted to JSON Schema at the provider boundary. ` +
-        `Errors are returned as structured tool results so the agent can self-correct in the same turn. `;
-    const tools = [
-        toolDoc("read", "Read a file's contents with cat -n style numbered lines, truncated to 2000 lines or 50KB."),
-        toolDoc("write", "Write content to a file, creating parent directories. Existing files must be read first."),
-        toolDoc("edit", "Replace text via search/replace blocks applied sequentially with a fuzzy fallback ladder."),
-        toolDoc("bash", "Execute a shell command in a non-interactive bash shell with combined stdout/stderr."),
-        toolDoc("grep", "Search file contents using regex, returning filepath:line:content matches."),
-        toolDoc("find", "Find files matching a glob pattern, respecting .gitignore."),
-        toolDoc("ls", "List directory contents with file types and sizes."),
-        toolDoc("web_fetch", "Fetch and read web page content as Markdown, extracting main content."),
-        toolDoc("subagent", "Spawn an isolated sub-agent with its own context window for a focused task."),
-        toolDoc("task_output", "Read new output from a background process by id."),
-    ];
-    // Repeat the tool block several times so the prefix clears Anthropic's
-    // minimum cacheable size (1024 tok Sonnet/Opus, 2048 Haiku) with headroom.
-    const bulkTools = [];
-    for (let r = 0; r < 22; r++)
-        bulkTools.push(...tools, `<!-- tool block repetition ${r} for prefix sizing -->`);
-    return [
-        "You are EZ Coder — a coding agent that works directly in the user's codebase.",
-        "You explore, understand, change, and verify code end-to-end.",
-        "",
-        "## How to Talk",
-        "Lead with the outcome. One idea per line. Bottom line first. No preamble or recap.",
-        "Stay silent between tool calls unless you hit a decision, tradeoff, or question.",
-        "",
-        "## How to Work",
-        "Read before edit/write; re-read after formatters, codegen, or any disk mutator.",
-        "Match neighbouring code style. Keep edits small; plan multi-file work first.",
-        "Choose targeted verification appropriate to the change; read and fix failures.",
-        "Do not assume APIs, CLI flags, config schema, or error wording — verify against source.",
-        "",
-        "## Tools",
-        ...bulkTools,
-        "",
-        "## Code Quality",
-        "Intent-revealing names; reuse existing deps. Types first; handle I/O, input, and external API errors.",
-        "No dead or commented-out code, placeholders, or unasked refactors.",
-        "",
-        "## Environment",
-        "Working directory: /home/user/project. Platform: darwin.",
-    ].join("\n");
-}
-async function call(cfg, system, user, promptCacheKey, cacheRetention) {
-    const messages = [
-        { role: "system", content: system },
-        { role: "user", content: user },
-    ];
-    const start = Date.now();
-    let ttftMs = 0;
-    let first = true;
-    const result = stream({
-        provider: cfg.provider,
-        model: cfg.model,
-        messages,
-        maxTokens: 16,
-        apiKey: cfg.apiKey,
-        baseUrl: cfg.baseUrl,
-        accountId: cfg.accountId,
-        promptCacheKey,
-        cacheRetention,
-    });
-    for await (const event of result) {
-        if (first && (event.type === "text_delta" || event.type === "thinking_delta")) {
-            ttftMs = Date.now() - start;
-            first = false;
-        }
-    }
-    const response = await result.response;
-    return {
-        ttftMs: ttftMs || Date.now() - start,
-        wallMs: Date.now() - start,
-        inputTokens: response.usage.inputTokens,
-        cacheRead: response.usage.cacheRead ?? 0,
-        cacheWrite: response.usage.cacheWrite ?? 0,
-        outputTokens: response.usage.outputTokens,
-    };
-}
-function sleep(ms) {
-    return new Promise((r) => setTimeout(r, ms));
-}
-async function main() {
-    const provider = process.env.EZ_CW_PROVIDER ?? "anthropic";
-    const model = process.env.EZ_CW_MODEL ?? "claude-haiku-4-5-20251001";
-    const reps = parseInt(process.env.EZ_CW_REPS ?? "4", 10);
-    const auth = new AuthStorage();
-    await auth.load();
-    const c = await auth.resolveCredentials(provider);
-    const cfg = {
-        provider,
-        model,
-        apiKey: c.accessToken,
-        baseUrl: c.baseUrl,
-        accountId: c.accountId,
-    };
-    const system = bigPrefix();
-    // Rough token size of the prefix (chars/3.3) for context.
-    console.log(`\n🔥 Cache-warm micro-benchmark: ${provider}/${model}`);
-    console.log(`   Prefix ~${Math.round(system.length / 3.3)} tokens, ${reps} reps per arm\n`);
-    // ── COLD arm: every rep uses a UNIQUE cache key → never reads cache ──
-    console.log("▶ COLD (no warming — fresh cache key each call):");
-    // Each cold rep gets UNIQUE prefix content (Anthropic caches by content, not
-    // by key) so every call is a true cache miss — otherwise rep 2+ would read
-    // rep 1's cache and pollute the cold baseline.
-    const cold = [];
-    for (let i = 0; i < reps; i++) {
-        const uniqueSystem = `<!-- cold-sample-${Date.now()}-${i} -->\n${system}`;
-        const m = await call(cfg, uniqueSystem, `Question ${i}: name one tool.`, `cold-${Date.now()}-${i}`, "short");
-        cold.push(m);
-        console.log(`   rep ${i + 1}: TTFT ${m.ttftMs}ms | in ${m.inputTokens} | cacheRead ${m.cacheRead} | cacheWrite ${m.cacheWrite}`);
-        await sleep(1500);
-    }
-    await sleep(3000);
-    // ── WARM arm: prewarm a SHARED key, then measure subsequent calls (cache reads) ──
-    console.log("\n▶ WARM (prewarm shared prefix, then measure cache reads):");
-    const warmKey = `warm-${Date.now()}`;
-    // Prewarm: a throwaway call that writes the cache.
-    const pw = await call(cfg, system, "warm.", warmKey, "long");
-    console.log(`   prewarm: cacheWrite ${pw.cacheWrite} (cache primed)`);
-    await sleep(1500);
-    const warm = [];
-    for (let i = 0; i < reps; i++) {
-        const m = await call(cfg, system, `Question ${i}: name one tool.`, warmKey, "long");
-        warm.push(m);
-        console.log(`   rep ${i + 1}: TTFT ${m.ttftMs}ms | in ${m.inputTokens} | cacheRead ${m.cacheRead} | cacheWrite ${m.cacheWrite}`);
-        await sleep(1500);
-    }
-    const avg = (xs, f) => xs.reduce((s, m) => s + f(m), 0) / xs.length;
-    const coldTtft = avg(cold, (m) => m.ttftMs);
-    const warmTtft = avg(warm, (m) => m.ttftMs);
-    const coldRead = avg(cold, (m) => m.cacheRead);
-    const warmRead = avg(warm, (m) => m.cacheRead);
-    console.log("\n══════════════════════ RESULTS ══════════════════════");
-    console.log(`Avg cacheRead tokens : cold ${coldRead.toFixed(0)}  →  warm ${warmRead.toFixed(0)}`);
-    console.log(`Avg TTFT             : cold ${coldTtft.toFixed(0)}ms  →  warm ${warmTtft.toFixed(0)}ms  ` +
-        `(${coldTtft > warmTtft ? "-" : "+"}${Math.abs(((coldTtft - warmTtft) / coldTtft) * 100).toFixed(0)}%)`);
-    const warmHitRate = warm.filter((m) => m.cacheRead > 0).length / warm.length;
-    console.log(`Warm cache hit rate  : ${(warmHitRate * 100).toFixed(0)}%`);
-    console.log(`Verdict: ${warmRead > 0 ? "caching ENGAGES when prefix exceeds the min — warming converts cold writes to reads" : "caching did NOT engage (prefix below provider minimum, or OAuth path strips cache_control)"}`);
-}
-main().catch((err) => {
-    console.error("Benchmark failed:", err);
-    process.exit(1);
-});
-//# sourceMappingURL=cache-warm-benchmark.js.map

package/dist/core/cache-warm-benchmark.js.map

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

package/dist/core/fast-apply-benchmark.d.ts

@@ -1,25 +0,0 @@
-/**
- * Fast-apply vs current-edit benchmark — real-API measurement.
- *
- * Two strategies for the same edit task, measured end-to-end against live models:
- *
- *   BASELINE (what ezcoder does today): the frontier model emits full
- *   search/replace edit blocks (old_text + new_text, verbatim context). Our
- *   edit tool then applies them LOCALLY and instantly (no apply model).
- *
- *   FAST-APPLY (the proposed feature): the frontier model emits a terse "lazy"
- *   edit using `// ... existing code ...` markers (far fewer output tokens), and
- *   a cheap/fast "apply" model merges that lazy edit into the full file —
- *   regenerating the whole file as output.
- *
- * We measure, per task: frontier output tokens + time, apply-model output tokens
- * + time, total wall-clock, and an anchor-based correctness check.
- *
- * Usage:
- *   npx tsx src/core/fast-apply-benchmark.ts
- *
- * Env overrides:
- *   EZ_FA_FRONTIER_PROVIDER / EZ_FA_FRONTIER_MODEL   (default openai / gpt-6.1-sol)
- *   EZ_FA_APPLY_PROVIDER     / EZ_FA_APPLY_MODEL      (default gemini / gemini-3.1-flash-lite)
- */
-export {};