@quickchatai/pi-quickreview 1.1.0 → 1.3.1

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

@@ -1,34 +1,33 @@
+import type { CoreConfig } from "../reviewconfig.js";
+import { type AssembledScan } from "../scan/scanassemble.js";
+import type { CaseRunner, Refusal } from "../scan/scanports.js";
+import { type ScanVerbs } from "../scan/scanrender.js";
+import type { ScanRun } from "../scan/scanrun.js";
+import { type FindingJson } from "../scan/scanverbs.js";
+import { UnitCutStore } from "../scan/unitcutstore.js";
+import { pluginScanCases } from "./scancases.js";
 import type { PluginHost, SessionUi } from "./session.js";
-/** The npm package that carries the `qcr` CLI. */
+/** The npm package of the QuickReview app (the `qcr` CLI). The scan does not
+ * need it; /qcr-setup's checks still name it. */
 export declare const QCR_PACKAGE = "@quickchatai/quickreview";
-/** The `qcr scan` subcommands passed through as typed. */
+/** The scan subcommands, as `qcr scan` names them. */
 export declare const SCAN_SUBCOMMANDS: readonly ["preview", "start", "status", "stop", "findings", "matches", "match", "suggestions", "stage2", "dismiss", "units", "login", "doctor", "rebuild"];
-/** Subcommands that need a terminal of their own: `login` drives pi's
- * interactive /login, `rebuild` a long docker build. /scan names the shell
- * command instead of running them with no terminal. */
-export declare const TERMINAL_SUBCOMMANDS: readonly string[];
-export declare const SCAN_COMMAND_USAGE = "usage: /scan [--sandbox docker] [--delta] [--sha REF] | /scan <qcr scan subcommand> \u2026";
-export declare const NO_QCR: string;
-/** A scan finding as `qcr scan findings --json` lists it (the fields used here). */
-export interface ScanFinding {
-    fingerprint: string;
-    file: string | null;
-    range?: {
-        start: number | null;
-        end: number | null;
-    } | null;
-    lens?: string;
-    severity?: string | null;
-    claim?: string;
-    [k: string]: unknown;
-}
+/** The subcommands that are the app's: the scan sandbox's, and the triage's
+ * dismissal (it writes reviewer memory, which the plugin has none of). */
+export declare const APP_SUBCOMMANDS: readonly string[];
+export declare const SCAN_COMMAND_USAGE = "usage: /qcr-scan [--delta] [--sha REF] [--preview] | /qcr-scan <scan subcommand> \u2026";
+/** How the scan's answers name the next step here. */
+export declare const PLUGIN_SCAN_VERBS: ScanVerbs;
+/** A scan finding as the scan's `--json` lists it. */
+export type ScanFinding = FindingJson;
 /** The guided run's options. */
 export interface ScanOptions {
-    sandbox?: string;
     delta: boolean;
     sha?: string;
+    /** Price it, start nothing. */
+    preview?: boolean;
 }
-/** `/scan`'s arguments: the guided run's flags, or a subcommand to pass on. */
+/** `/qcr-scan`'s arguments: the guided run's flags, or a subcommand. */
 export declare function parseScanCommand(line: string): {
     kind: "guided";
     o: ScanOptions;
@@ -42,12 +41,47 @@ export declare function parseScanCommand(line: string): {
  * repo's directory name and a hash of its real path, so two repos never share
  * a unit cut, a ledger or a findings store. */
 export declare function repoScanHome(env: NodeJS.ProcessEnv, cwd: string): string;
-/** The env a `qcr scan` child runs under: the person's, with the repo pi
- * stands in named as the reviewed repo, that repo's own state home (unless
- * the person set one), and the shipped defaults as the config when the
- * person has no qcr config. */
-export declare function scanEnv(host: PluginHost): NodeJS.ProcessEnv;
-/** The findings as markdown, worst first as qcr lists them. */
+/** Where this repo's scan keeps its state: `QCR_STATE_HOME` when the person
+ * set one, else the repo's own home under the qcr state home. */
+export declare function scanStateHome(host: Pick<PluginHost, "env" | "cwd">): string;
+/** The seams a test replaces. */
+export interface ScanCommandDeps {
+    /** The core's data root. */
+    root: () => string;
+    /** The case runner a run's cases go to. Default: SDK sessions of this pi. */
+    cases: (o: Parameters<typeof pluginScanCases>[0]) => CaseRunner;
+}
+export declare const SCAN_DEPS: ScanCommandDeps;
+/** The scan engine of one repo in this session. */
+interface RepoScan extends AssembledScan {
+    /** The host the latest command came from: the cases borrow its login. */
+    host: PluginHost;
+    units: UnitCutStore;
+    /** The config as it reads now, or why it cannot be read. */
+    config: () => {
+        ok: true;
+        cfg: CoreConfig;
+    } | Refusal;
+    log: (line: string) => void;
+}
+/** A session's scans: one engine per repo (so a run started here is the one
+ * every later `/qcr-scan` sees), and at most one run in flight. */
+export declare class ScanSessions {
+    private readonly engines;
+    private current;
+    /** What is being scanned now; null when nothing is. */
+    get running(): string | null;
+    /** Resolves once no scan runs. */
+    idle(): Promise<void>;
+    /** Hold `done` as the run in flight until it settles. */
+    hold(label: string, done: Promise<void>): void;
+    /** The engine of the repo `host` stands in, built on first use. */
+    engine(host: PluginHost, deps: ScanCommandDeps): RepoScan;
+}
+/** The status line for the run in flight: its cases, what it spent against
+ * its hard stop, and the time since it started. */
+export declare function scanStatusLine(run: ScanRun | null, startedAt: number, now: number): string;
+/** The findings as markdown, worst first as the scan lists them. */
 export declare function renderScanFindings(findings: readonly ScanFinding[], total: number): string;
 /** What a guided run ended with. */
 export type GuidedScan = {
@@ -60,20 +94,22 @@ export type GuidedScan = {
     error: string;
 };
 /**
- * Price, ask, start, wait, list: the guided scan. The person confirms the
- * price; with nobody to ask, nothing is started. Esc (or the session ending)
- * stops the run through `qcr scan stop`.
+ * Price, ask, start, wait, list: the guided scan, waited for to its end. The
+ * person confirms the price; with nobody to ask, nothing is started. Esc (or
+ * the session ending) stops the run.
  */
-export declare function guidedScan(host: PluginHost, ui: SessionUi, o: ScanOptions): Promise<GuidedScan>;
-/** /scan. */
-export declare function runScanCommand(line: string, host: PluginHost, ui: SessionUi): Promise<void>;
-/** The message /selfimprove hands the agent: the fix loop, then the findings. */
-export declare function selfImproveBrief(o: {
-    cwd: string;
-    sha: string | null;
-    findings: readonly ScanFinding[];
-    total: number;
-}): string;
-/** /selfimprove: scan the repo, then hand the agent the findings and the fix loop. */
-export declare function runSelfImproveCommand(line: string, host: PluginHost, ui: SessionUi): Promise<void>;
+export declare function guidedScan(host: PluginHost, ui: SessionUi, o: ScanOptions, opts?: {
+    sessions?: ScanSessions;
+    deps?: ScanCommandDeps;
+}): Promise<GuidedScan>;
+/**
+ * /qcr-scan. The guided run starts in the background and the command returns
+ * (pi's print mode, where nobody can confirm a price, starts nothing); a
+ * subcommand is answered here. Never throws: every refusal reaches the person.
+ */
+export declare function runScanCommand(line: string, host: PluginHost, ui: SessionUi, o?: {
+    sessions?: ScanSessions;
+    deps?: ScanCommandDeps;
+}): Promise<void>;
+export {};
 //# sourceMappingURL=scan.d.ts.map

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

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