@quickchatai/pi-quickreview 0.0.0-stage → 1.1.0

package/dist/src/lenstuning.js

@@ -0,0 +1,326 @@
+// Per-lens tuning from the repo profile.
+//
+// `profile.toml` may carry one `[lenses.<pass>]` table per lens, five keys
+// (and a sixth for the style lens alone):
+//
+//   [lenses.pass-security]
+//   min_tier = "sol-high"      # the lowest tier the plan may run it at
+//   effort = "high"            # low | medium | high — that lens's thinking only
+//   max_severity = "P0"        # the lens's severity ceiling (raise or lower)
+//   emphasis = "Auth is the product here; …"   # words for that lens
+//
+//   [lenses.pass-ui]
+//   enabled = false            # remove the lens from the plan and the add list
+//
+//   [lenses.pass-style]
+//   guide = "style-guide.md"   # a guide file in this profile's dir
+//
+// The resolved map (the whole `extends` chain merged, child-wins per key —
+// packages/pi-plugin/src/profiles.ts `loadProfileLensTuning`) rides the `Config` as `cfg.lenses`,
+// overlaid by `applyProfileTuning` AFTER config.toml and its preset are
+// parsed: **the profile wins** over config.toml, the preset and the code
+// defaults. Every consumer then reads one place:
+//
+//   * `min_tier` — plan time (src/dispatch.ts `buildPassPlan`): a FLOOR under
+//     whatever tier the plan would otherwise choose, so plan rows, `raisable_to`,
+//     the sweep rows and the add rule's variant all move with it. A floor never
+//     lowers: a risk pass stays at `sol-high`, the validator stays at or above
+//     its configured tier. A lens's floor never moves the validator (it is
+//     not raised to match any lens).
+//   * `effort` — build time, through the per-variant model hook
+//     (`BuildAgentsOptions.models`): only that lens's `<pass>--<tier>` specs get
+//     the new thinking suffix. `high` means the model's ceiling
+//     (`[models] effort_max`), exactly as the global `[models] effort` does.
+//   * `enabled` — `false` removes the lens from selection and from the addable
+//     list, whatever selected it (the path core, a heuristic, a sub-lens
+//     trigger, a `[review]` lever). A separate, profile-level subtraction:
+//     heuristics stay ADD-only. `true` is the default and only matters for a
+//     lens a `[review]` lever gates (sub-lenses, the sweep, the tests, quality
+//     and style lenses) — there it switches that one lens on whatever the lever
+//     says. It never plans an addable-only lens or anything else the
+//     selector did not choose. `false` on `pass-validate` switches the
+//     validator off: the round then posts the merged candidates
+//     with no adversary in front of them, and nothing is doubted.
+//   * `emphasis` and `max_severity` — compiled into addenda
+//     (`lensTuningAddenda`) that wire.ts and the bench compose after the
+//     profile's own pack, so the addendum registry stays the ONLY route into a
+//     pass body (rule 6). The ceiling binds at the validator, which enforces
+//     every other cap, and is also told to the lens itself.
+//   * `guide` (`pass-style` only) — a style guide drafted into the
+//     profile for a repo that writes none: a file path RELATIVE to the
+//     profile's own directory (so it lives in the config home), read and
+//     checked at load. Plan time: the style lens is planned on it only when
+//     the repo's own guide (packages/pi-plugin/src/styleguide.ts) finds nothing — **a guide the
+//     repo writes wins**. Build time: the text is compiled into an addendum
+//     for `pass-style` and the validator, like `emphasis`, so it reaches the
+//     session wherever the session runs. Style findings stay `nit` against
+//     either guide unless `max_severity` raises the lens's ceiling.
+import { readFileSync, realpathSync, statSync } from "node:fs";
+import { isAbsolute, join, relative, sep } from "node:path";
+import { effortLevel, normalizeEffort, withThinking } from "./reviewconfig.js";
+import { passTierModels, sweepLightVariants, VALIDATE_PASS as VALIDATE, } from "./include.js";
+import { SEVERITIES } from "./severity.js";
+import { flooredToMin, PASS_TIER_ORDER } from "./types.js";
+export const LENS_TUNING_KEYS = [
+    "min_tier",
+    "effort",
+    "enabled",
+    "emphasis",
+    "max_severity",
+    "guide",
+];
+/** The one lens a profile may point at a guide. */
+export 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 const PROFILE_GUIDE_MAX_CHARS = 32_000;
+/** An emphasis is a few sentences for one lens, not a second rulebook. */
+export 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 const PROFILE_CAP_WORD = "profile-over-cap";
+const EMPHASIS_ID_PREFIX = "lens-emphasis-";
+const CEILING_ID_PREFIX = "lens-ceiling-";
+const GUIDE_ID_PREFIX = "lens-guide-";
+/** Ids the compiled tuning addenda take — a profile pack may not claim them. */
+export const LENS_TUNING_ID_PREFIXES = [
+    EMPHASIS_ID_PREFIX,
+    CEILING_ID_PREFIX,
+    GUIDE_ID_PREFIX,
+];
+/** Read the guide a profile's `[lenses.pass-style] guide` names: a relative
+ * path that stays inside the profile's directory (symlinks resolved), a
+ * readable, non-empty file within the size cap. Anything else throws. */
+function readProfileGuide(at, value, dir) {
+    if (typeof value !== "string" || value.trim() === "")
+        throw new Error(`${at} guide must be a file name in the profile's directory`);
+    if (dir === undefined)
+        throw new Error(`${at} guide needs the profile's directory to resolve`);
+    const file = value.trim();
+    if (isAbsolute(file) || file.split(/[\\/]/).includes(".."))
+        throw new Error(`${at} guide ${JSON.stringify(file)} must be relative to the profile's directory, without '..'`);
+    const path = join(dir, file);
+    let text;
+    try {
+        const real = realpathSync(path);
+        const inside = relative(realpathSync(dir), real);
+        if (inside === "" || inside.startsWith(`..${sep}`) || isAbsolute(inside))
+            throw new Error("resolves outside the profile's directory");
+        if (!statSync(real).isFile())
+            throw new Error("is not a file");
+        text = readFileSync(real, "utf8");
+    }
+    catch (err) {
+        throw new Error(`${at} guide ${JSON.stringify(file)}: cannot use ${path}: ${err.message}`, {
+            cause: err,
+        });
+    }
+    if (text.trim() === "")
+        throw new Error(`${at} guide ${path} is empty`);
+    if (text.length > PROFILE_GUIDE_MAX_CHARS)
+        throw new Error(`${at} guide ${path} is over ${PROFILE_GUIDE_MAX_CHARS} characters`);
+    return { file, text };
+}
+/**
+ * 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 function parseLensTable(where, raw, known, dir) {
+    const table = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+    if (!table(raw))
+        throw new Error(`${where} [lenses] must be a table of [lenses.<pass>] tables`);
+    const out = {};
+    for (const [lens, body] of Object.entries(raw)) {
+        const at = `${where} [lenses.${lens}]`;
+        if (!known.includes(lens)) {
+            throw new Error(`${at} is not a known lens — one of: ${known.join(", ")}`);
+        }
+        if (!table(body))
+            throw new Error(`${at} must be a table`);
+        const t = {};
+        for (const [key, value] of Object.entries(body)) {
+            switch (key) {
+                case "min_tier":
+                    if (!PASS_TIER_ORDER.includes(value))
+                        throw new Error(`${at} min_tier must be one of ${PASS_TIER_ORDER.join(", ")}`);
+                    t.min_tier = value;
+                    break;
+                case "effort": {
+                    const effort = normalizeEffort(value);
+                    if (effort === null)
+                        throw new Error(`${at} effort must be "low", "medium" or "high"`);
+                    t.effort = effort;
+                    break;
+                }
+                case "enabled":
+                    if (typeof value !== "boolean")
+                        throw new Error(`${at} enabled must be true or false`);
+                    t.enabled = value;
+                    break;
+                case "emphasis":
+                    if (typeof value !== "string" || value.trim() === "")
+                        throw new Error(`${at} emphasis must be a non-empty string`);
+                    if (value.length > EMPHASIS_MAX_CHARS)
+                        throw new Error(`${at} emphasis is over ${EMPHASIS_MAX_CHARS} characters`);
+                    t.emphasis = value.trim();
+                    break;
+                case "max_severity":
+                    if (lens === VALIDATE)
+                        throw new Error(`${at} max_severity — the validator raises no findings to cap`);
+                    if (!SEVERITIES.includes(value))
+                        throw new Error(`${at} max_severity must be one of ${SEVERITIES.join(", ")}`);
+                    t.max_severity = value;
+                    break;
+                case "guide":
+                    if (lens !== STYLE_LENS)
+                        throw new Error(`${at} guide — only [lenses.${STYLE_LENS}] judges against a guide`);
+                    t.guide = readProfileGuide(at, value, dir);
+                    break;
+                default:
+                    throw new Error(`${at} unknown key "${key}" — allowed: ${LENS_TUNING_KEYS.join(", ")}`);
+            }
+        }
+        out[lens] = t;
+    }
+    return out;
+}
+/** 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 function mergeLensTuning(base, child) {
+    const out = { ...base };
+    for (const [lens, t] of Object.entries(child))
+        out[lens] = { ...out[lens], ...t };
+    return out;
+}
+/** Is `lens` on? An explicit `enabled` wins; otherwise `lever` — the
+ * `[review]` switch that gates this lens, or `true` for an ungated one. */
+export function lensEnabled(lenses, lens, lever = true) {
+    return lenses?.[lens]?.enabled ?? lever;
+}
+/** `tier`, raised to the lens's `min_tier` when the profile sets one. */
+export function flooredTier(lenses, lens, tier) {
+    return flooredToMin(tier, lenses?.[lens]?.min_tier);
+}
+/**
+ * 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 function lensModelOverrides(models, lenses) {
+    const out = {};
+    for (const [lens, t] of Object.entries(lenses ?? {})) {
+        if (!t.effort)
+            continue;
+        for (const tier of PASS_TIER_ORDER)
+            out[`${lens}--${tier}`] = effortSpec(models, tier, t.effort);
+    }
+    return out;
+}
+/** `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 function effortSpec(models, tier, effort) {
+    return withThinking(models.tiers[tier], effortLevel(effort, models.effort_max));
+}
+/**
+ * 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 function roundAgentModels(cfg) {
+    return passTierModels(cfg.models.pass_tiers, cfg.models.tiers, lensModelOverrides(cfg.models, cfg.lenses), cfg.models.pass_models, sweepLightVariants(cfg.review, cfg.lenses), cfg.lenses);
+}
+function ceilingText(lens, sev) {
+    const rule = sev === "P0"
+        ? `\`${lens}\` findings may carry any severity: judge each at its own severity like any other lens's.`
+        : `A \`${lens}\` finding may carry any severity up to \`${sev}\`; one arriving above \`${sev}\` is capped down to \`${sev}\` with the one-word downgrade reason \`${PROFILE_CAP_WORD}\` (axis: severity), then follows the ordinary posting map unchanged.`;
+    return (`\n## Severity ceiling for \`${lens}\`: \`${sev}\` (this repo's profile)\n` +
+        `This repo's profile sets the severity ceiling of the \`${lens}\` lens at \`${sev}\`. ` +
+        `It REPLACES every other cap these instructions put on \`${lens}\`, higher or lower. ${rule}\n`);
+}
+/** When the profile's guide is the standard: a PR round's plan row says
+ * (dispatch picks the repo's own guide first); a whole-repo scan has no plan
+ * row, so the rule is stated outright. */
+const GUIDE_WHEN = {
+    pr: `It is the standard ONLY in a round whose \`${STYLE_LENS}\` plan row names "this repo's profile style guide"; ` +
+        `when that row names a guide the repo itself writes, the repo's guide is the only standard and this section does not apply. `,
+    scan: `This is a whole-repo scan, which has no plan row: it is the standard wherever the repo writes no style guide of its own ` +
+        `(a style guide file, a CONTRIBUTING style section, the style sections of its agent-directive files); ` +
+        `where the repo writes one, the repo's guide is the only standard and this section does not apply. `,
+};
+/** How a finding against the guide anchors: a PR round cites the changed
+ * line; a scan reads whole files, so it cites the line in the code as it is. */
+const GUIDE_CITE = {
+    pr: `and cites the CHANGED line that breaks it, exactly as for a repo guide. `,
+    scan: `and cites the line that breaks it, exactly as for a repo guide. `,
+};
+function guideText(g, mode) {
+    return (`\n## This repo's profile style guide (\`${g.file}\`)\n` +
+        `This repo's profile carries a style guide for \`${STYLE_LENS}\`, below, for when the repo writes none of its own. ` +
+        GUIDE_WHEN[mode] +
+        `It is not a file in the repo: do not look for it at head — the guide is the text below, so "guide missing or unreadable at head, answer NONE" never applies to it. ` +
+        `A \`${STYLE_LENS}\` finding against it quotes the rule verbatim and cites it as \`profile style guide ${g.file}\` in place of a repo file and line, ` +
+        GUIDE_CITE[mode] +
+        `Validator: audit such a finding against this text as you would a repo guide — a rule it does not state is \`refuted\`, and so is a finding citing it in a round whose style row named the repo's own guide.\n\n` +
+        `----- begin profile style guide -----\n${g.text.replace(/\n*$/, "\n")}----- end profile style guide -----\n`);
+}
+/**
+ * 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 function lensTuningAddenda(lenses) {
+    const out = [];
+    for (const lens of Object.keys(lenses ?? {}).sort()) {
+        const t = lenses[lens];
+        if (t.emphasis !== undefined) {
+            out.push({
+                id: `${EMPHASIS_ID_PREFIX}${lens}`,
+                scope: [lens],
+                text: `\n## What this repo asks of this lens (this repo's profile)\n${t.emphasis}\n`,
+            });
+        }
+        if (t.max_severity !== undefined) {
+            out.push({
+                id: `${CEILING_ID_PREFIX}${lens}`,
+                scope: [lens, VALIDATE],
+                text: ceilingText(lens, t.max_severity),
+            });
+        }
+        if (t.guide !== undefined) {
+            out.push({
+                id: `${GUIDE_ID_PREFIX}${lens}`,
+                scope: [lens, VALIDATE],
+                mode: "pr",
+                text: guideText(t.guide, "pr"),
+            }, {
+                id: `${GUIDE_ID_PREFIX}${lens}-scan`,
+                scope: [lens, VALIDATE],
+                mode: "scan",
+                text: guideText(t.guide, "scan"),
+            });
+        }
+    }
+    return out;
+}
+/** The config with the profile's resolved lens tuning overlaid — the profile
+ * wins over config.toml, the preset and the defaults. */
+export function applyProfileTuning(cfg, lenses) {
+    return { ...cfg, lenses };
+}
+//# sourceMappingURL=lenstuning.js.map

package/dist/src/lenstuning.js.map

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

package/dist/src/lintconfig.d.ts

@@ -0,0 +1,31 @@
+/** One tool a CI job of the repo runs, with the config that sets its rules. */
+export interface CiLinter {
+    /** The tool's name as the plan and the lens see it. */
+    tool: string;
+    /** Repo-relative config files found for it (may be empty: defaults). */
+    configs: string[];
+    /** Repo-relative CI files that invoke it. */
+    ci: string[];
+    /** File extensions its rules cover. */
+    covers: RegExp;
+}
+/**
+ * The real path of `rel` under `root` when it resolves inside `realRoot` (the
+ * checkout's own real path), else null: a link that leaves the checkout, a
+ * missing path or the root itself are all null.
+ */
+export declare function resolveInsideCheckout(root: string, realRoot: string, rel: string): string | null;
+/**
+ * The linters and formatters a CI job of the repo under `root` runs — found
+ * by reading the CI definitions and the wrapper scripts they call (a CI step
+ * `npm run lint` whose package script runs `eslint` counts). [] when the
+ * repo runs none, or the tree cannot be read.
+ *
+ * `packageJson` = `"whole"` reads a CI-called package.json whole, as this
+ * module did before it followed scripts — kept so a test can hold the
+ * followed reading to finding everything the whole reading found.
+ */
+export declare function findCiLinters(root: string, packageJson?: "called" | "whole"): CiLinter[];
+/** The CI linters whose rules cover at least one changed file. */
+export declare function lintersForFiles(linters: readonly CiLinter[], filenames: readonly string[]): CiLinter[];
+//# sourceMappingURL=lintconfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lintconfig.d.ts","sourceRoot":"","sources":["../../src/lintconfig.ts"],"names":[],"mappings":"AAWA,+EAA+E;AAC/E,MAAM,WAAW,QAAQ;IACvB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6CAA6C;IAC7C,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AA6HD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQhG;AAkSD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,GAAE,QAAQ,GAAG,OAAkB,GACzC,QAAQ,EAAE,CA2EZ;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,QAAQ,EAAE,EAC5B,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,QAAQ,EAAE,CAEZ"}