@quickchatai/pi-quickreview 0.0.0-stage → 1.1.0

package/dist/src/lensresult.d.ts

@@ -0,0 +1,94 @@
+/** The tools whose result carries lens children in `details.results`. */
+export declare const LENS_TOOL = "lens";
+export declare const LENS_WAVE_TOOL = "lens_wave";
+/** The tmux bot's spellings (pi's native subagent tool and the glue's
+ * launch_plan, which returns the same result). */
+export declare const LEGACY_LENS_TOOLS: readonly string[];
+/** Whether `name` is a tool whose result lists lens children. */
+export declare function isLensTool(name: unknown): boolean;
+/** One child's summed usage over its turns; `cost` is a NUMBER (the sum of each
+ * turn's cost.total), as the native result reports it. */
+export interface LensUsage {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cost: number;
+}
+/** One message of the child's transcript. Only the fields consumers read are
+ * typed; the rest of a pi message rides along untyped. */
+export interface LensMessage {
+    role: string;
+    /** Epoch ms. */
+    timestamp?: number;
+    content?: unknown;
+    [k: string]: unknown;
+}
+export interface LensResult {
+    /** The run's identity (= its ledger line's `id`). Absent in the native shape. */
+    id?: string;
+    agent: string;
+    model: string;
+    usage: LensUsage;
+    messages: LensMessage[];
+    /** 0 = finished clean; -1 = still running (parallel mode, live updates). */
+    exitCode: number;
+    stopReason?: string;
+    errorMessage?: string;
+    timedOut?: boolean;
+}
+export type LensLedgerKind = "lens" | "warmup";
+/** One line of a round's `lens-ledger.jsonl`. `timestamp` (ISO) is the run's
+ * END and is also the line's window stamp for usage.ts. A `warmup` line is a
+ * cache warm-up session: real spend with no tool result of its own. */
+export interface LensLedgerLine {
+    v: 1;
+    kind: LensLedgerKind;
+    id: string;
+    timestamp: string;
+    started_at?: string;
+    duration_ms?: number;
+    agent: string;
+    model: string;
+    usage: LensUsage;
+    exitCode?: number;
+    stopReason?: string;
+    errorMessage?: string;
+    timedOut?: boolean;
+}
+/** The usage a result or ledger line carries, every field a finite number. */
+export declare function lensUsageOf(value: unknown): LensUsage;
+/** The run id of a result or ledger line; null when it carries none. */
+export declare function lensIdOf(value: unknown): string | null;
+/** The lens children a tool result's `details.results` lists — [] for any
+ * other shape. `carrier` is the tool event's `result` or `partialResult`. */
+export declare function lensResultsOf(carrier: unknown): unknown[];
+/**
+ * Count-once bookkeeping for a consumer that can meet one lens run through
+ * several carriers. `claim(id)` is true the first time an id is seen and for
+ * every result with no id (the native shape); false on a repeat. Use ONE per
+ * measured scope (a case, a round) — never share across scopes.
+ */
+export declare class LensOnce {
+    private readonly seen;
+    claim(id: string | null): boolean;
+}
+/** A ledger line for `result`, ending at `endedAtMs`. */
+export declare function ledgerLineOf(kind: LensLedgerKind, id: string, result: Omit<LensResult, "id" | "messages"> & {
+    messages?: unknown;
+}, timing: {
+    endedAtMs: number;
+    startedAtMs?: number;
+}): LensLedgerLine;
+/** One JSONL line, newline-terminated, ready to append. */
+export declare function serializeLedgerLine(line: LensLedgerLine): string;
+/** A parsed record that is a v1 ledger line: `v` 1, a `kind` of lens or
+ * warmup, a non-empty `id` and a `usage` object. Anything else — a session
+ * record, a future version — is not one. */
+export declare function ledgerLineFrom(value: unknown): LensLedgerLine | null;
+/** Parse one ledger line; null for a blank, malformed or foreign line —
+ * never thrown. */
+export declare function parseLedgerLine(text: string): LensLedgerLine | null;
+/** Every ledger line in `text`, in file order. Split on LF only: a U+2028 or
+ * U+2029 inside a JSON string is not a record boundary. */
+export declare function parseLedger(text: string): LensLedgerLine[];
+//# sourceMappingURL=lensresult.d.ts.map

package/dist/src/lensresult.d.ts.map

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

package/dist/src/lensresult.js

@@ -0,0 +1,162 @@
+// LensResult v1 and the lens ledger: the shape one lens pass reports, and the
+// per-round `lens-ledger.jsonl` that records every lens (and cache warm-up)
+// session the engine ran. NEUTRAL on purpose: no imports, no I/O. The daemon
+// side (usage.ts feeds est_usd) and the bench consumers (cost.ts, aacr.ts,
+// whatif.ts) and the pi extensions all read these shapes, so the module must
+// not live under src/engine/ — the daemon may not import that tree.
+//
+// LensResult v1 is the SUBSET of pi's native subagent result that consumers
+// read: `agent`, `model`, `usage{input,output,cacheRead,cost}`, the child's
+// `messages` (with timestamps), `exitCode`, `stopReason`, `errorMessage`,
+// `timedOut`. v1 adds one field the native shape never had, `id`: the lens
+// run's identity, equal to the `id` of its ledger line. It is how a consumer
+// counts a lens ONCE when it can see the same run twice (a `lens_wave` result
+// returning a wave the engine already launched, a later `lens_wave` call
+// repeating it, the ledger beside the transcript). A result with no `id` is
+// the native shape: every such result counts, exactly as before.
+//
+// Tool names (owner ruling): the engine routes expose `lens` and
+// `lens_wave`; the tmux bot still runs `subagent` and `launch_plan`. A consumer
+// accepts all four (`isLensTool`) until the old pair is retired.
+/** The tools whose result carries lens children in `details.results`. */
+export const LENS_TOOL = "lens";
+export const LENS_WAVE_TOOL = "lens_wave";
+/** The tmux bot's spellings (pi's native subagent tool and the glue's
+ * launch_plan, which returns the same result). */
+export const LEGACY_LENS_TOOLS = ["subagent", "launch_plan"];
+const LENS_TOOLS = new Set([LENS_TOOL, LENS_WAVE_TOOL, ...LEGACY_LENS_TOOLS]);
+/** Whether `name` is a tool whose result lists lens children. */
+export function isLensTool(name) {
+    return typeof name === "string" && LENS_TOOLS.has(name);
+}
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function finite(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+/** A usage `cost` is a number, or (an assistant message's shape) `{total}`. */
+function costOf(value) {
+    return finite(record(value) ? record(value)["total"] : value);
+}
+/** The usage a result or ledger line carries, every field a finite number. */
+export function lensUsageOf(value) {
+    const u = record(value);
+    return {
+        input: finite(u?.["input"]),
+        output: finite(u?.["output"]),
+        cacheRead: finite(u?.["cacheRead"]),
+        cost: costOf(u?.["cost"]),
+    };
+}
+/** The run id of a result or ledger line; null when it carries none. */
+export function lensIdOf(value) {
+    const id = record(value)?.["id"];
+    return typeof id === "string" && id.length > 0 ? id : null;
+}
+/** The lens children a tool result's `details.results` lists — [] for any
+ * other shape. `carrier` is the tool event's `result` or `partialResult`. */
+export function lensResultsOf(carrier) {
+    const results = record(record(carrier)?.["details"])?.["results"];
+    return Array.isArray(results) ? results : [];
+}
+/**
+ * Count-once bookkeeping for a consumer that can meet one lens run through
+ * several carriers. `claim(id)` is true the first time an id is seen and for
+ * every result with no id (the native shape); false on a repeat. Use ONE per
+ * measured scope (a case, a round) — never share across scopes.
+ */
+export class LensOnce {
+    seen = new Set();
+    claim(id) {
+        if (id === null)
+            return true;
+        if (this.seen.has(id))
+            return false;
+        this.seen.add(id);
+        return true;
+    }
+}
+// ---- the ledger ------------------------------------------------------------
+/** A ledger line for `result`, ending at `endedAtMs`. */
+export function ledgerLineOf(kind, id, result, timing) {
+    return {
+        v: 1,
+        kind,
+        id,
+        timestamp: new Date(timing.endedAtMs).toISOString(),
+        ...(timing.startedAtMs !== undefined
+            ? {
+                started_at: new Date(timing.startedAtMs).toISOString(),
+                duration_ms: Math.max(0, timing.endedAtMs - timing.startedAtMs),
+            }
+            : {}),
+        agent: result.agent,
+        model: result.model,
+        usage: lensUsageOf(result.usage),
+        exitCode: result.exitCode,
+        ...(result.stopReason !== undefined ? { stopReason: result.stopReason } : {}),
+        ...(result.errorMessage !== undefined ? { errorMessage: result.errorMessage } : {}),
+        ...(result.timedOut !== undefined ? { timedOut: result.timedOut } : {}),
+    };
+}
+/** One JSONL line, newline-terminated, ready to append. */
+export function serializeLedgerLine(line) {
+    return `${JSON.stringify(line)}\n`;
+}
+/** A parsed record that is a v1 ledger line: `v` 1, a `kind` of lens or
+ * warmup, a non-empty `id` and a `usage` object. Anything else — a session
+ * record, a future version — is not one. */
+export function ledgerLineFrom(value) {
+    const r = record(value);
+    if (!r || r["v"] !== 1)
+        return null;
+    if (r["kind"] !== "lens" && r["kind"] !== "warmup")
+        return null;
+    if (lensIdOf(r) === null || !record(r["usage"]))
+        return null;
+    if (typeof r["agent"] !== "string")
+        return null;
+    return {
+        v: 1,
+        kind: r["kind"],
+        id: r["id"],
+        timestamp: typeof r["timestamp"] === "string" ? r["timestamp"] : "",
+        ...(typeof r["started_at"] === "string" ? { started_at: r["started_at"] } : {}),
+        ...(typeof r["duration_ms"] === "number" ? { duration_ms: r["duration_ms"] } : {}),
+        agent: r["agent"],
+        model: typeof r["model"] === "string" ? r["model"] : "unknown",
+        usage: lensUsageOf(r["usage"]),
+        ...(typeof r["exitCode"] === "number" ? { exitCode: r["exitCode"] } : {}),
+        ...(typeof r["stopReason"] === "string" ? { stopReason: r["stopReason"] } : {}),
+        ...(typeof r["errorMessage"] === "string" ? { errorMessage: r["errorMessage"] } : {}),
+        ...(typeof r["timedOut"] === "boolean" ? { timedOut: r["timedOut"] } : {}),
+    };
+}
+/** Parse one ledger line; null for a blank, malformed or foreign line —
+ * never thrown. */
+export function parseLedgerLine(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith("{"))
+        return null;
+    try {
+        return ledgerLineFrom(JSON.parse(trimmed));
+    }
+    catch {
+        return null;
+    }
+}
+/** Every ledger line in `text`, in file order. Split on LF only: a U+2028 or
+ * U+2029 inside a JSON string is not a record boundary. */
+export function parseLedger(text) {
+    const out = [];
+    for (const raw of text.split("\n")) {
+        const line = parseLedgerLine(raw);
+        if (line !== null)
+            out.push(line);
+    }
+    return out;
+}
+//# sourceMappingURL=lensresult.js.map

package/dist/src/lensresult.js.map

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

package/dist/src/lenstuning.d.ts

@@ -0,0 +1,97 @@
+import type { ModelsConfig, ReviewEffort } from "./reviewconfig.js";
+import { type PassAddendum } from "./include.js";
+import { type Severity } from "./severity.js";
+import { type PassTier } from "./types.js";
+/** A style guide a profile points `pass-style` at. */
+export interface ProfileStyleGuide {
+    /** As `profile.toml` spells it — relative to the profile's directory. */
+    file: string;
+    text: string;
+}
+/** The keys of one `[lenses.<pass>]` table, after validation. */
+export interface LensTuning {
+    min_tier?: PassTier;
+    effort?: Exclude<ReviewEffort, "">;
+    enabled?: boolean;
+    emphasis?: string;
+    max_severity?: Severity;
+    /** `pass-style` only. */
+    guide?: ProfileStyleGuide;
+}
+/** Pass name → its resolved tuning. Empty ⇒ untuned (the shipped behaviour). */
+export type LensTuningMap = Readonly<Record<string, LensTuning>>;
+export declare const LENS_TUNING_KEYS: readonly ["min_tier", "effort", "enabled", "emphasis", "max_severity", "guide"];
+/** The one lens a profile may point at a guide. */
+export declare const STYLE_LENS = "pass-style";
+/** A drafted guide is a guide, not a manual: it is compiled into two built
+ * bodies (the style lens and the validator). */
+export declare const PROFILE_GUIDE_MAX_CHARS = 32000;
+/** An emphasis is a few sentences for one lens, not a second rulebook. */
+export declare const EMPHASIS_MAX_CHARS = 2000;
+/** The downgrade word the validator records when a profile ceiling caps a
+ * candidate (packages/pi-plugin/src/findingsrecord.ts DOWNGRADE_WORDS). */
+export declare const PROFILE_CAP_WORD = "profile-over-cap";
+/** Ids the compiled tuning addenda take — a profile pack may not claim them. */
+export declare const LENS_TUNING_ID_PREFIXES: readonly ["lens-emphasis-", "lens-ceiling-", "lens-guide-"];
+/**
+ * Parse one profile's `[lenses]` table. `where` names the file in every
+ * error; `known` is every pass the system knows (dispatch.ts ALL_PASSES);
+ * `dir` is the profile's directory, which a `guide` resolves against.
+ * Anything malformed throws — an unknown lens, an unknown key, a bad value,
+ * giving the validator a ceiling, a guide on any lens but `pass-style` or one
+ * that cannot be read: a profile that asked for something this cannot honour
+ * must fail the boot, never review as if it had. Switching the validator off
+ * IS honoured.
+ */
+export declare function parseLensTable(where: string, raw: unknown, known: readonly string[], dir?: string): Record<string, LensTuning>;
+/** Merge a child profile's lens tables over its base's: per lens, per key,
+ * the child wins (the profile chain's scalar rule). */
+export declare function mergeLensTuning(base: Record<string, LensTuning>, child: Record<string, LensTuning>): Record<string, LensTuning>;
+/** Is `lens` on? An explicit `enabled` wins; otherwise `lever` — the
+ * `[review]` switch that gates this lens, or `true` for an ungated one. */
+export declare function lensEnabled(lenses: LensTuningMap | undefined, lens: string, lever?: boolean): boolean;
+/** `tier`, raised to the lens's `min_tier` when the profile sets one. */
+export declare function flooredTier(lenses: LensTuningMap | undefined, lens: string, tier: PassTier): PassTier;
+/**
+ * The per-VARIANT model specs a lens's `effort` asks for, keyed
+ * `<pass>--<tier>` — the `BuildAgentsOptions.models` hook. Every tier gets a
+ * key (the build reads only the variants it writes); the spec is the tier's
+ * own, already through the global `[models] effort`, with only its thinking
+ * suffix replaced. Untuned lenses get no key, so their built bytes are
+ * unchanged.
+ */
+export declare function lensModelOverrides(models: Pick<ModelsConfig, "tiers" | "effort_max">, lenses: LensTuningMap | undefined): Record<string, string>;
+/** `tier`'s model spec at a configured `effort` — `high` is the model's
+ * ceiling (`[models] effort_max`). A lens's profile `effort` and the scan's
+ * `[scan] effort` resolve through this one rule. */
+export declare function effortSpec(models: Pick<ModelsConfig, "tiers" | "effort_max">, tier: PassTier, effort: Exclude<ReviewEffort, "">): string;
+/**
+ * The per-variant model map a PR round's agent build takes: the profile's
+ * per-lens `effort` (`lensModelOverrides`), with `[models.pass_tiers]` pins
+ * and `[models.pass_models]` overrides on top (`passTierModels`). The daemon,
+ * the bench and the setup replay all build through this one recipe, so each
+ * runs a lens at the same model.
+ */
+export declare function roundAgentModels(cfg: {
+    models: Pick<ModelsConfig, "tiers" | "effort_max" | "pass_tiers" | "pass_models">;
+    lenses?: LensTuningMap | undefined;
+    review: {
+        sweep_light_tier?: "" | PassTier;
+    };
+}): Record<string, string>;
+/**
+ * The addenda a profile's `emphasis`, `max_severity` and `guide` compile
+ * into, in a deterministic order (lens name; emphasis, ceiling, guide). An
+ * emphasis binds its lens alone; a ceiling binds its lens (so it knows how
+ * high it may go) and the validator (which enforces it); a guide binds the
+ * style lens (its standard) and the validator (which audits against it).
+ * Composed after the profile's own pack, so a ceiling is the last word on a
+ * lens's cap.
+ */
+export declare function lensTuningAddenda(lenses: LensTuningMap | undefined): PassAddendum[];
+/** The config with the profile's resolved lens tuning overlaid — the profile
+ * wins over config.toml, the preset and the defaults. */
+export declare function applyProfileTuning<C extends {
+    lenses?: LensTuningMap;
+}>(cfg: C, lenses: LensTuningMap): C;
+//# sourceMappingURL=lenstuning.d.ts.map

package/dist/src/lenstuning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lenstuning.d.ts","sourceRoot":"","sources":["../../src/lenstuning.ts"],"names":[],"mappings":"AA2DA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAiC,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE1E,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,yBAAyB;IACzB,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,gFAAgF;AAChF,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAEjE,eAAO,MAAM,gBAAgB,iFAOnB,CAAC;AAEX,mDAAmD;AACnD,eAAO,MAAM,UAAU,eAAe,CAAC;AAEvC;gDACgD;AAChD,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;2EAC2E;AAC3E,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAMnD,gFAAgF;AAChF,eAAO,MAAM,uBAAuB,6DAI1B,CAAC;AAqCX;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAuD5B;AAED;uDACuD;AACvD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAI5B;AAED;2EAC2E;AAC3E,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,IAAI,EAAE,MAAM,EACZ,KAAK,UAAO,GACX,OAAO,CAET;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,GACb,QAAQ,CAEV;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,YAAY,CAAC,EAClD,MAAM,EAAE,aAAa,GAAG,SAAS,GAChC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB;AAED;;oDAEoD;AACpD,wBAAgB,UAAU,CACxB,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,YAAY,CAAC,EAClD,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,GAChC,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE;IACpC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC,CAAC;IAClF,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE;QAAE,gBAAgB,CAAC,EAAE,EAAE,GAAG,QAAQ,CAAA;KAAE,CAAC;CAC9C,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASzB;AA+CD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,EAAE,CAoCnF;AAED;yDACyD;AACzD,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,MAAM,CAAC,EAAE,aAAa,CAAA;CAAE,EACrE,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,aAAa,GACpB,CAAC,CAEH"}