@webappwiz/cli 0.0.7 → 0.0.9

package/index-jbrs6gqt.js

@@ -1,418 +0,0 @@
-// judge.ts
-import {
-  agentCommand,
-  Files,
-  Harness,
-  prompt as reviewPrompt
-} from "@webappwiz/rules";
-import { ConsoleLogger, color as color3 } from "webappwiz/log";
-import {
-  NodeFs as NodeFs2,
-  NodeGlob,
-  NodePs as NodePs2
-} from "webappwiz/system";
-import { SystemClock } from "webappwiz/time";
-
-// changed.ts
-import { NodePs } from "webappwiz/system";
-async function changed(dir, ref, opts = {}) {
-  const ps = opts.ps ?? new NodePs;
-  const files = new Set;
-  for (const argv of [
-    ["diff", "--name-only", "--diff-filter=d", "--relative", ref],
-    ["ls-files", "--others", "--exclude-standard"]
-  ]) {
-    for (const line of (await git(ps, dir, argv)).split(`
-`)) {
-      if (line !== "") {
-        files.add(line);
-      }
-    }
-  }
-  return files;
-}
-async function diff(dir, ref, opts = {}) {
-  const ps = opts.ps ?? new NodePs;
-  const patch = await git(ps, dir, ["diff", "--relative", ref]);
-  const added = (await git(ps, dir, ["ls-files", "--others", "--exclude-standard"])).split(`
-`).filter((line) => line !== "");
-  return { patch: patch.trim(), added };
-}
-async function git(ps, dir, argv) {
-  const { exitCode, stdout, stderr } = await ps.spawnCapture([
-    "git",
-    "-C",
-    dir,
-    ...argv
-  ]);
-  if (exitCode !== 0) {
-    throw new Error(`git ${argv[0]} failed in ${dir}: ${stderr.trim() || `exit ${exitCode}`}`);
-  }
-  return stdout;
-}
-
-// cost.ts
-import { join } from "node:path";
-import { NodeFs } from "webappwiz/system";
-var PRICES = { haiku: 1, sonnet: 3, opus: 5 };
-var priced = () => Object.keys(PRICES);
-function floor(agent, tokens) {
-  const price = PRICES[agent];
-  return price === undefined ? undefined : tokens / 1e6 * price;
-}
-var FILE = join(".wiz", "judge-cost.json");
-async function overheads(dir, opts = {}) {
-  const fs = opts.fs ?? new NodeFs;
-  try {
-    const parsed = JSON.parse(await fs.read(join(dir, FILE)));
-    if (typeof parsed !== "object" || parsed === null) {
-      return {};
-    }
-    return Object.fromEntries(Object.entries(parsed).filter(([, call]) => typeof call === "number" && call > 0));
-  } catch {
-    return {};
-  }
-}
-async function calibrate(dir, agent, call, opts = {}) {
-  const fs = opts.fs ?? new NodeFs;
-  const recorded = { ...await overheads(dir, { fs }), [agent]: call };
-  await fs.mkdir(join(dir, ".wiz"));
-  await fs.write(join(dir, FILE), `${JSON.stringify(recorded, null, "\t")}
-`);
-}
-function predict(agent, tokens, calls, measured) {
-  const listed = floor(agent, tokens);
-  const call = measured[agent];
-  return listed === undefined || call === undefined ? listed : listed + call * calls;
-}
-
-// mode.ts
-function mode({ print, estimate, agent, exec }) {
-  const named = [
-    print === true ? "--print" : undefined,
-    estimate === true ? "--estimate" : undefined,
-    agent === undefined ? undefined : "--agent",
-    exec === undefined ? undefined : "--exec"
-  ].filter((flag) => flag !== undefined);
-  if (named.length > 1) {
-    throw new Error(`${named.join(" and ")} are different things to do with one run, so pass one`);
-  }
-  if (print === true) {
-    return "print";
-  }
-  return estimate === true ? "estimate" : "run";
-}
-
-// report.ts
-import { color as color2 } from "webappwiz/log";
-
-// table.ts
-import { color } from "webappwiz/log";
-var table = (rows) => {
-  const width = (cell) => color.strip(cell).length;
-  const widths = rows[0]?.map((_, i) => Math.max(...rows.map((row) => width(row[i] ?? ""))));
-  return rows.map((row) => row.map((cell, i) => cell.padEnd((widths?.[i] ?? 0) + cell.length - width(cell))).join("   ").trimEnd());
-};
-
-// report.ts
-var count = (total, word) => `${total} ${word}${total === 1 ? "" : "s"}`;
-var divider = (name) => {
-  if (name === undefined) {
-    return color2.dim("-".repeat(72));
-  }
-  const opening = `--- ${name} `;
-  return color2.dim(opening.padEnd(Math.max(72, opening.length + 3), "-"));
-};
-var compact = new Intl.NumberFormat("en", { notation: "compact" });
-var money = new Intl.NumberFormat("en", {
-  style: "currency",
-  currency: "USD",
-  minimumFractionDigits: 2,
-  maximumFractionDigits: 4
-});
-var usd = (amount) => money.format(amount);
-var tokens = (bytes) => Math.ceil(bytes / 4);
-function overBudget(estimate, budget, cost) {
-  const money2 = cost === undefined ? "" : ` That is ${color2.bold(usd(cost))} or more.`;
-  return `${color2.yellow("!")} this run reads at least ` + `${color2.bold(compact.format(estimate))} tokens, over the ` + `${color2.bold(compact.format(budget))} budget, and the real cost will be higher.${money2} ` + `Raise it with ${color2.bold("--budget")}.`;
-}
-function estimate(files, rules, calls, tokens2, overheads2) {
-  const agents = priced();
-  const measured = agents.some((agent) => overheads2[agent] !== undefined);
-  const rows = [
-    ["agent", "floor", ...measured ? ["measured"] : []].map(color2.dim)
-  ];
-  for (const agent of agents) {
-    const least = floor(agent, tokens2) ?? 0;
-    const whole = overheads2[agent] === undefined ? undefined : predict(agent, tokens2, calls, overheads2);
-    rows.push([
-      agent,
-      color2.green(`${usd(least)}+`),
-      ...measured ? [whole === undefined ? "" : color2.green(usd(whole))] : []
-    ]);
-  }
-  return [
-    ...planned({ files, rules, calls, estimate: tokens2 }),
-    ...table(rows).map((line) => `  ${line}`),
-    "",
-    color2.gray("floor: the listed input price for the files above, and nothing else. " + `Every call
-also pays for the agent's own system prompt and for whatever it re-reads.`),
-    ...measured ? [
-      color2.gray("measured: that floor plus what a call on the agent cost over it last time.")
-    ] : [
-      color2.gray("Run one of these and the estimate is measured against it next time.")
-    ]
-  ];
-}
-function planned({
-  files,
-  rules,
-  calls,
-  estimate: estimate2,
-  concurrency,
-  cost,
-  agent
-}) {
-  const rows = [
-    [color2.dim("files"), String(files)],
-    [color2.dim("rules"), String(rules)],
-    [
-      color2.dim("calls"),
-      String(calls) + (concurrency === undefined ? "" : color2.dim(`, ${concurrency} at a time`))
-    ],
-    [color2.dim("reading"), `${compact.format(estimate2)}+ tokens`]
-  ];
-  if (cost !== undefined) {
-    rows.push([color2.dim("cost"), color2.green(`${usd(cost)}+`)]);
-  }
-  if (agent !== undefined) {
-    rows.push([color2.dim("agent"), agent]);
-  }
-  return ["", ...table(rows).map((line) => `  ${line}`), ""];
-}
-function finished({
-  rules,
-  files,
-  violations,
-  took,
-  cost,
-  done,
-  total
-}) {
-  const heading = `${color2.gray(`[${done}/${total}]`)} ` + color2.gray(`(${count(rules.length, "rule")}, ${count(files, "file")})`);
-  const spent = cost === undefined ? "" : `  ${usd(cost)}`;
-  const tail = `${color2.gray(`in ${took.human()}${spent}`)}`;
-  if (violations.length === 0) {
-    return [`${color2.green("✓")} ${heading}: clean ${tail}`];
-  }
-  return [
-    `${color2.red("✗")} ${heading}: ${count(violations.length, "problem")} ${tail}`,
-    ...violations.flatMap(finding)
-  ];
-}
-function finding(violation) {
-  const level = violation.level === "error" ? color2.red("error") : color2.yellow(violation.level);
-  const lines = [
-    `  ${color2.bold(`${violation.file}:${violation.line}`)}  ${level}  ${violation.message} ${color2.gray(`(${violation.id})`)}`
-  ];
-  if (violation.code !== "") {
-    lines.push(color2.gray(`  │ ${violation.code}`));
-  }
-  return lines;
-}
-function summary(violations, took, cost) {
-  const spent = cost === undefined ? "" : `  ${usd(cost)} total`;
-  const elapsed = color2.gray(`in ${took.human()}${spent}`);
-  if (violations.length === 0) {
-    return `${color2.green("✓ no violations")} ${elapsed}`;
-  }
-  const errors = violations.filter((violation) => violation.level === "error").length;
-  const line = `✖ ${count(violations.length, "problem")} (${count(errors, "error")}, ${count(violations.length - errors, "warning")})`;
-  return `${errors > 0 ? color2.red(line) : color2.yellow(line)} ${elapsed}`;
-}
-
-// judge.ts
-var estimated = (reviews) => tokens(reviews.reduce((bytes, review) => bytes + review.bytes, 0));
-var isFileRule = (rule) => ("files" in rule);
-var title = (rule) => /^#\s+(.+)$/m.exec(rule.document)?.[1]?.trim() ?? rule.id;
-var ask = {
-  confirm: (question) => process.stdin.isTTY === true && /^y(es)?$/i.test((prompt(`${question} [y/N]`) ?? "").trim())
-};
-
-class JudgeCommands {
-  rules;
-  signoffRules;
-  confirmer;
-  log;
-  fs;
-  ps;
-  clock;
-  glob;
-  constructor(rules, opts = {}) {
-    this.rules = rules;
-    this.signoffRules = opts.signoffRules ?? [];
-    this.confirmer = opts.confirmer ?? ask;
-    this.log = opts.log ?? new ConsoleLogger;
-    this.fs = opts.fs ?? new NodeFs2;
-    this.ps = opts.ps ?? new NodePs2;
-    this.clock = opts.clock ?? new SystemClock;
-    this.glob = opts.glob ?? new NodeGlob;
-  }
-  ls() {
-    const rows = [["id", "rule", "set", "level", "files"].map(color3.dim)];
-    for (const rule of this.rules.rules) {
-      rows.push([rule.id, title(rule), "judge", rule.level, rule.files]);
-    }
-    for (const rule of this.signoffRules) {
-      rows.push([rule.id, title(rule), "signoff", "", ""]);
-    }
-    this.log.info(table(rows).join(`
-`));
-  }
-  show(opts) {
-    const all = [...this.rules.rules, ...this.signoffRules];
-    const rule = all.find((candidate) => candidate.id === opts.id);
-    if (!rule) {
-      throw new Error(`no rule "${opts.id}". Known ids: ${all.map((candidate) => candidate.id).join(", ")}`);
-    }
-    const rows = [
-      [color3.dim("id"), rule.id],
-      [color3.dim("rule"), title(rule)]
-    ];
-    if (isFileRule(rule)) {
-      rows.push([color3.dim("level"), rule.level], [color3.dim("files"), rule.files]);
-    }
-    this.log.info(table(rows).join(`
-`));
-    this.log.info("");
-    this.log.info(rule.document.trim());
-  }
-  async judge(opts) {
-    const how = mode(opts);
-    const config = this.rules;
-    const rules = config.rules;
-    const dir = opts.dir.replace(/\/+$/, "") || "/";
-    const only = opts.since === undefined ? undefined : await changed(dir, opts.since, { ps: this.ps });
-    if (only?.size === 0) {
-      this.log.info(`nothing has changed since ${opts.since}`);
-      return;
-    }
-    const files = new Files({ log: this.log, fs: this.fs, glob: this.glob });
-    const reviews = await files.plan(rules, dir, {
-      chunk: opts.chunk,
-      only
-    });
-    if (how === "print") {
-      for (const review of reviews) {
-        this.log.info(`
-${divider(`${review.label} (${count(review.files.length, "file")})`)}
-`);
-        this.log.info(reviewPrompt(review));
-      }
-      this.log.info(`
-${divider()}`);
-      return;
-    }
-    const read = new Set(reviews.flatMap((review) => review.files)).size;
-    const predicted = estimated(reviews);
-    const calls = reviews.length;
-    if (how === "estimate") {
-      for (const line of estimate(read, rules.length, calls, predicted, await overheads(this.ps.cwd(), { fs: this.fs }))) {
-        this.log.info(line);
-      }
-      return;
-    }
-    const agent = this.agent(config, opts);
-    const model = this.model(config, opts);
-    const root = this.ps.cwd();
-    const measured = await overheads(root, { fs: this.fs });
-    const started = this.clock.now();
-    const cost = model === undefined ? undefined : predict(model, predicted, calls, measured);
-    this.log.info(planned({
-      files: read,
-      rules: rules.length,
-      calls,
-      estimate: predicted,
-      concurrency: config.concurrency,
-      cost,
-      agent: agent.label
-    }).join(`
-`));
-    if (predicted > opts.budget) {
-      this.log.info(overBudget(predicted, opts.budget, cost));
-      if (!await this.confirmer.confirm("Run anyway?")) {
-        throw new Error("over budget");
-      }
-    }
-    let spent = 0;
-    let billed = false;
-    const found = [];
-    const harness = new Harness({
-      log: this.log,
-      ps: this.ps,
-      clock: this.clock
-    });
-    harness.events.on("finished", (review) => {
-      if (review.cost !== undefined) {
-        spent += review.cost;
-        billed = true;
-      }
-      const at = reviews[review.at];
-      if (!at) {
-        return;
-      }
-      const violations2 = files.violations(at, review.findings, dir);
-      found[review.at] = violations2;
-      for (const line of finished({
-        rules: review.rules,
-        files: at.files.length,
-        violations: violations2,
-        took: review.took,
-        cost: review.cost,
-        done: review.done,
-        total: review.total
-      })) {
-        this.log.info(line);
-      }
-    });
-    await harness.run(reviews, agent, {
-      cwd: dir,
-      concurrency: config.concurrency
-    });
-    const violations = found.flat();
-    this.log.info("");
-    this.log.info(summary(violations, this.clock.now().subtract(started), billed ? spent : undefined));
-    await this.record(model, root, predicted, calls, billed ? spent : undefined);
-    const errors = violations.filter((violation) => violation.level === "error").length;
-    if (errors > 0) {
-      throw new Error(count(errors, "error"));
-    }
-  }
-  async record(agent, root, predicted, calls, spent) {
-    if (agent === undefined || spent === undefined || calls <= 0) {
-      return;
-    }
-    const listed = floor(agent, predicted);
-    if (listed === undefined) {
-      return;
-    }
-    const call = (spent - listed) / calls;
-    if (call <= 0) {
-      return;
-    }
-    try {
-      await calibrate(root, agent, call, { fs: this.fs });
-    } catch (error) {
-      this.log.error(`could not record what this run cost: ${error}`);
-    }
-  }
-  agent(config, opts) {
-    const model = this.model(config, opts);
-    return agentCommand(model === undefined ? opts : { agent: model });
-  }
-  model(config, opts) {
-    return opts.exec === undefined ? opts.agent ?? config.agent : undefined;
-  }
-}
-
-export { diff, mode, table, count, divider, usd, tokens, overBudget, ask, JudgeCommands };

package/signoff.d.ts

@@ -1,63 +0,0 @@
-import { type Rule } from "@webappwiz/rules";
-import { type Logger } from "webappwiz/log";
-import { type Ps } from "webappwiz/system";
-import { type Clock } from "webappwiz/time";
-import { type Confirm } from "./judge.js";
-export interface SignoffRunOptions {
-    /** The directory whose change is being weighed. */
-    dir: string;
-    agent?: string;
-    exec?: string;
-    /** Print the rules to the logger and spawn nothing, for the reader who is
-     * going to apply them itself. */
-    print?: boolean;
-    /** The ref the change is measured against: everything since it is the
-     * change. */
-    since: string;
-    /** Tokens a run may read before it asks whether you meant it. */
-    budget: number;
-}
-/**
- * Weighs a change against the rules that decide whether it can merge on its
- * own or needs a person to look at it first.
- *
- * One agent call over the diff, rather than one per file like `judge`: these
- * rules are about the change as a whole, and a run that saw one file at a time
- * could not answer them. Exits 1 with a reason when the change needs a person,
- * so it reads the same to a merge gate as to whoever ran it.
- */
-/** What a `Signoff` runs through. */
-export interface SignoffOptions {
-    /** Who is asked before a run goes over budget; the terminal by default. */
-    confirmer?: Confirm;
-    log?: Logger;
-    ps?: Ps;
-    clock?: Clock;
-}
-export declare class Signoff {
-    private rules;
-    private defaultAgent;
-    private confirmer;
-    private log;
-    private ps;
-    private clock;
-    constructor(rules: Rule[], defaultAgent: string, opts?: SignoffOptions);
-    run(opts: SignoffRunOptions): Promise<void>;
-    /** The one call, and what it says about the change. */
-    private judge;
-    /**
-     * The verdict, and a reason for each rule that wants a person. Throws on any
-     * of them: an agent that ran this before merging should escalate rather than
-     * merge, and an exit code is what says so whoever is reading.
-     */
-    private say;
-    /** The change as the agent reads it, priced by the prompt: what a new file
-     * costs to open is the agent's business and unknowable from here. */
-    private review;
-    /**
-     * The rules in full, for the reader who is going to apply them. Nothing has
-     * to run these: an agent about to merge its own work can weigh it against
-     * them itself, and that is the cheapest signoff there is.
-     */
-    private print;
-}

package/signoff.js

@@ -1,7 +0,0 @@
-import {
-  Signoff
-} from "./index-3k3rtw49.js";
-import"./index-jbrs6gqt.js";
-export {
-  Signoff
-};