@quickchatai/pi-quickreview 1.2.0 → 1.3.2

package/dist/src/scan/scanleaves.js.map

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

package/dist/src/scan/scanports.d.ts

@@ -0,0 +1,79 @@
+/** The reviewed checkout, read-only (the companion mounts it `:ro`). Every
+ * method is total: an unreadable checkout answers null, never throws. */
+export interface RepoReader {
+    /** Where the checkout is, for messages. */
+    readonly location: string;
+    /** Repo-relative paths of every tracked file, or null when there is no
+     * readable checkout. */
+    listFiles(): string[] | null;
+    /** A file's text, or null (missing, binary, over the reader's size cap). */
+    read(rel: string): string | null;
+    /** A file's line count (0 for an empty file), or null when unreadable. */
+    lines(rel: string): number | null;
+    /** The checked-out commit, or null when it cannot be read. */
+    head(): string | null;
+    /** Commits touching each file over the recent history — the survey's
+     * "most-changed" sample. Optional and total: absent or null when
+     * the history cannot be read, which only empties that one reason. */
+    changeCounts?(): Record<string, number> | null;
+}
+/** The filesystem rooted at the install's state home — PC-only, never shipped.
+ * Paths are relative to that root; the implementation refuses any that would
+ * leave it. The same shape roots the config home (`SetupPorts.config`). */
+export interface StateFs {
+    readonly location: string;
+    /** The file's text, or null when it does not exist. Throws only when it
+     * exists and cannot be read — the caller reports that, never overwrites. */
+    read(rel: string): string | null;
+    /** tmp+rename atomic write; creates parent directories. */
+    write(rel: string, text: string): void;
+}
+/** One case: a unit (or part of one) handed to background pi subagents inside
+ * the companion. */
+export interface CaseSpec {
+    id: string;
+    unit: string;
+    agent: string;
+    files: string[];
+    prompt: string;
+}
+/** How a case ended: the lens's final answer and what it cost (null when
+ * the runner could not tell), or why there is none. A failed or aborted case
+ * may still have spent money: `cost_usd` on a failure is what it spent before
+ * it ended (0 when it never started, null or absent when the runner cannot
+ * tell) — a caller holding a budget counts it. */
+export type CaseOutcome = {
+    ok: true;
+    output: string;
+    cost_usd: number | null;
+    /** The files the case's file-read tool calls opened (`read`, and
+     * `grep` given a `path`), in call order, each resolved to the absolute
+     * path the call opened (against the case's working directory, which is
+     * not the scanned tree) — `[]` when it read nothing. Absent when the
+     * runner cannot tell, which is unknown, never "read nothing". The scan
+     * judges a lens that read none of its focus files as no reading at all. */
+    reads?: string[];
+    /** Where the runner kept the case's event stream, relative to its
+     * transcript directory; absent when it kept none. */
+    transcript?: string;
+} | {
+    ok: false;
+    reason: string;
+    cost_usd?: number | null;
+    transcript?: string;
+};
+/** Runs cases as background subagents (survey, scan). The
+ * engine decides what runs when and how many at once; the runner runs one
+ * case to its end. Resolves for every outcome — a failed or aborted case is
+ * `{ok:false}`, never a rejection. `onCost`, when given, hears the case's
+ * running cost each time the runner learns more of it, so a caller with a
+ * hard cap can abort a case mid-flight rather than after the fact. */
+export interface CaseRunner {
+    run(spec: CaseSpec, signal: AbortSignal, onCost?: (spentSoFar: number) => void): Promise<CaseOutcome>;
+}
+/** A refusal: why nothing was done. */
+export type Refusal = {
+    ok: false;
+    errors: string[];
+};
+//# sourceMappingURL=scanports.d.ts.map

package/dist/src/scan/scanports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanports.d.ts","sourceRoot":"","sources":["../../../src/scan/scanports.ts"],"names":[],"mappings":"AAOA;yEACyE;AACzE,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;4BACwB;IACxB,SAAS,IAAI,MAAM,EAAE,GAAG,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,0EAA0E;IAC1E,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAClC,8DAA8D;IAC9D,IAAI,IAAI,MAAM,GAAG,IAAI,CAAC;IACtB;;yEAEqE;IACrE,YAAY,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAChD;AAED;;2EAE2E;AAC3E,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;gFAC4E;IAC5E,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,2DAA2D;IAC3D,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED;oBACoB;AACpB,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;kDAIkD;AAClD,MAAM,MAAM,WAAW,GACnB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;;+EAK2E;IAC3E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;yDACqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF;;;;;sEAKsE;AACtE,MAAM,WAAW,UAAU;IACzB,GAAG,CACD,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GACpC,OAAO,CAAC,WAAW,CAAC,CAAC;CACzB;AAED,uCAAuC;AACvC,MAAM,MAAM,OAAO,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC"}

package/dist/src/scan/scanports.js

@@ -0,0 +1,8 @@
+// The ports the scan engine and the unit cut run over, by shape: the
+// reviewed checkout read-only, the state home as a rooted filesystem, and the
+// case runner that runs one case as a background subagent. Every effect of
+// the engine goes through one of these, so a host decides where each one
+// lands: the app's companion and `qcr scan` driver, or the pi plugin's
+// /qcr-scan in the person's own pi.
+export {};
+//# sourceMappingURL=scanports.js.map

package/dist/src/scan/scanports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanports.js","sourceRoot":"","sources":["../../../src/scan/scanports.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,8EAA8E;AAC9E,2EAA2E;AAC3E,yEAAyE;AACzE,uEAAuE;AACvE,oCAAoC"}

package/dist/src/scan/scanrender.d.ts

@@ -0,0 +1,128 @@
+import type { FindingsFilter, MatchQuestionView, MatchResult, ScanFinding, ValidityView } from "./findings.js";
+import { type ScanStopRequest } from "./scanreport.js";
+import { type FindingsStore } from "./findings.js";
+import { type StoredStage2Proposal } from "./stage2request.js";
+import { type ScanRunner, type ScanPreview, type ScanRun, type ScanSettings, type ScanStatus, type StoredSuggestion } from "./scanrun.js";
+/** What closing the tickets of the findings a match fixed did: the tickets
+ * closed, and the closes the tracker refused. A host with no tracker has no
+ * such step. */
+export interface TicketsClosed {
+    closed: ReadonlyArray<{
+        ref: string;
+    }>;
+    problems: readonly string[];
+}
+/** How a rendering names the next step: the companion's tools, or the
+ * `qcr scan` CLI's subcommands — the same words around either. */
+export interface ScanVerbs {
+    /** How to start the previewed run. */
+    start(p: Pick<ScanPreview, "key" | "sha" | "mode">): string;
+    /** Where the pending match question is shown. */
+    matches: string;
+    /** How to answer the match question `key`: what precedes "that are the
+     * SAME finding". */
+    match(key: string): string;
+    /** How to start the stored stage-2 proposal `key`, and only some of its rows. */
+    stage2Start(key: string): string;
+    /** The progress and stop verbs a start names. */
+    status: string;
+    stop: string;
+}
+export declare const TOOL_VERBS: ScanVerbs;
+export declare const CLI_VERBS: ScanVerbs;
+export declare function renderPreview(p: ScanPreview, verbs?: ScanVerbs): string;
+export declare function renderStatus(s: ScanStatus, verbs?: ScanVerbs): string;
+/** Findings in validity order — confirmed, likely, doubtful, unknown — the
+ * store's order (most severe first) kept inside each tier, a finding that
+ * looks like a dismissed one below the rest of its tier. */
+export declare function byValidity(fs: readonly ScanFinding[]): ScanFinding[];
+export declare function renderFindings(fs: readonly ScanFinding[], total: number): string;
+export declare function renderQuestion(q: MatchQuestionView | null, verbs?: ScanVerbs): string;
+export declare function renderSuggestions(sugs: readonly StoredSuggestion[], settings: ScanSettings | null): string;
+export declare function renderProposal(p: StoredStage2Proposal, verbs?: ScanVerbs): string;
+/** A preview's structured result: its cases summarised (counts, not files). */
+export declare function previewDetails(p: ScanPreview): Record<string, unknown>;
+/** A started run, as a start answers it. */
+export declare function startedDetails(run: ScanRun): {
+    id: string;
+    mode: ScanRun["mode"];
+    sha: string;
+    cases: number;
+    cap_usd: number;
+};
+export { FINDING_STATES } from "./findings.js";
+/** How many findings a listing shows unless told otherwise, and at most. */
+export declare const FINDINGS_LIMIT = 50;
+export declare const FINDINGS_LIMIT_MAX = 200;
+/** A findings filter from loose parameters (a tool call's, the CLI's flags),
+ * or what is wrong with one. */
+export declare function findingsFilter(p: Record<string, unknown>): {
+    ok: true;
+    filter: FindingsFilter;
+} | {
+    ok: false;
+    error: string;
+};
+/** The stored findings a filter keeps, in validity order (`byValidity`),
+ * with the count in each tier — or why the store cannot be read. */
+export declare function listFindings(findings: FindingsStore, filter: FindingsFilter): {
+    ok: true;
+    findings: ScanFinding[];
+    validity: Record<ValidityView, number>;
+} | {
+    ok: false;
+    error: string;
+};
+/** Answer the match question whole, then close the tickets of the promoted
+ * findings it fixed — and the lines that say what was settled. */
+export declare function answerMatch(findings: FindingsStore, args: {
+    key?: unknown;
+    pairs?: unknown;
+}, afterMatch: (() => Promise<TicketsClosed>) | null): Promise<Extract<MatchResult, {
+    ok: false;
+}> | (Extract<MatchResult, {
+    ok: true;
+}> & {
+    tickets: TicketsClosed | null;
+    lines: string[];
+})>;
+/** A stored proposal's summary, as a propose answers it. */
+export declare function proposalDetails(p: StoredStage2Proposal): {
+    key: string;
+    sha: string;
+    cap_usd: number;
+    runnable: number;
+    rows: number;
+    depth: "standard" | "deep";
+    floor_rows: number;
+    floor_usd: number;
+};
+/** The line a stage-2 start answers: how many rows run (of how many, when
+ * narrowed), and the hard stop. */
+export declare function stage2StartedLine(run: ScanRun, runnable: number | null, narrowed: boolean, verbs?: ScanVerbs): string;
+/** The line a stage-1 start answers. */
+export declare function startedLine(run: ScanRun, verbs?: ScanVerbs): string;
+/** How often a stop through the channel looks for its answer, and how long
+ * it waits for one. */
+export declare const STOP_POLL_MS = 2000;
+export declare const STOP_WAIT_MS = 15000;
+/** Where a stop of a run another process drives goes: the stop channel
+ * under the state home, answered by whichever process holds the run. */
+export interface StopChannel {
+    home: string;
+    by?: ScanStopRequest["by"];
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+}
+/** Stop the recorded run: here when this runner drives it, else through the
+ * stop channel the driving process answers — the companion, or a
+ * `qcr scan` driver. No answer within STOP_WAIT_MS: nothing drives it. */
+export declare function stopScan(scan: ScanRunner, ch: StopChannel): Promise<{
+    ok: true;
+    run: string;
+    answer: string;
+} | {
+    ok: false;
+    errors: string[];
+}>;
+//# sourceMappingURL=scanrender.d.ts.map

package/dist/src/scan/scanrender.d.ts.map

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