pi-harness-runtime 1.1.405 → 1.1.407

package/packages/tooling-preference/dist/quality-check.d.ts

@@ -0,0 +1,75 @@
+/**
+ * The post-change quality check of a JavaScript/TypeScript workspace.
+ *
+ * The check honors the saved preference: "prefer_biome" runs Biome on the
+ * changed files, "use_project_tools" runs the project's own lint script.
+ * The check never writes: it reports what it found and the agent fixes it.
+ */
+import type { ToolingContext } from "./detect.js";
+import type { ToolingPreference } from "./proposal.js";
+/** The tool that checks the changed files. */
+export type QualityCheckTool = "biome" | "project" | "none";
+export interface QualityCheckPlan {
+    /** The tool that would run. */
+    tool: QualityCheckTool;
+    /** The binary to run - never a shell string. */
+    command: string | null;
+    /** The arguments of the command. */
+    args: string[];
+    /** The files the check looks at. */
+    files: string[];
+    /** Why this plan - a human wording. */
+    reason: string;
+}
+export interface QualityCheckResult {
+    /** Did the check run? */
+    ran: boolean;
+    /** Did the check pass? Meaningless when the check did not run. */
+    passed: boolean;
+    /** The tool that ran. */
+    tool: QualityCheckTool;
+    /** How many files the check looked at. */
+    fileCount: number;
+    /** The exit code of the check. */
+    exitCode: number | null;
+    /** Did the check hit the timeout? */
+    timedOut: boolean;
+    /** The output of the check, truncated. */
+    output: string;
+    /** Why the result is what it is - a human wording. */
+    reason: string;
+}
+/** The scripts of the workspace, if it has a package.json. */
+export declare function readWorkspaceScripts(root: string): Record<string, string>;
+/**
+ * Choose the check that runs after a change.
+ *
+ * The preference decides the tool: Biome when the user asked for it, the
+ * project's own script otherwise. A workspace without a saved decision is
+ * never checked - the user has not chosen a tool yet.
+ */
+export declare function selectQualityCheck(options: {
+    context: ToolingContext;
+    preference: ToolingPreference | undefined;
+    files: string[];
+    scripts?: Record<string, string>;
+}): QualityCheckPlan;
+/**
+ * Run the check.
+ *
+ * The command is started without a shell, with a timeout, and it never
+ * writes: a check that wants to fix files is not a check.
+ */
+export declare function runQualityCheck(plan: QualityCheckPlan, options: {
+    cwd: string;
+    timeoutMs?: number;
+    maxOutputChars?: number;
+}): QualityCheckResult;
+/**
+ * The status line of the check.
+ *
+ * The line stays plain ASCII: it is read by the pi host and by terminals
+ * without a font of their own.
+ */
+export declare function formatQualityCheckStatus(result: QualityCheckResult): string;
+//# sourceMappingURL=quality-check.d.ts.map

package/packages/tooling-preference/dist/quality-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-check.d.ts","sourceRoot":"","sources":["../src/quality-check.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,8CAA8C;AAC9C,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAChC,+BAA+B;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IACvB,gDAAgD;IAChD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oCAAoC;IACpC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,oCAAoC;IACpC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IAClC,yBAAyB;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,kEAAkE;IAClE,MAAM,EAAE,OAAO,CAAC;IAChB,yBAAyB;IACzB,IAAI,EAAE,gBAAgB,CAAC;IACvB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;CACf;AAsCD,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAazE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC3C,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,GAAG,gBAAgB,CAiEnB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,kBAAkB,CAwEpB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAS3E"}

package/packages/tooling-preference/dist/quality-check.js

@@ -0,0 +1,216 @@
+/**
+ * The post-change quality check of a JavaScript/TypeScript workspace.
+ *
+ * The check honors the saved preference: "prefer_biome" runs Biome on the
+ * changed files, "use_project_tools" runs the project's own lint script.
+ * The check never writes: it reports what it found and the agent fixes it.
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/** How the tool is started with the package manager of the workspace. */
+function packageRunner(packageManager, binary) {
+    switch (packageManager) {
+        case "bun":
+            return { command: "bunx", args: [binary] };
+        case "pnpm":
+            return { command: "pnpm", args: ["exec", binary] };
+        case "yarn":
+            return { command: "yarn", args: [binary] };
+        case "npm":
+            return { command: "npx", args: ["--no-install", binary] };
+        default:
+            return { command: binary, args: [] };
+    }
+}
+/** How a package script is started with the package manager of the workspace. */
+function scriptRunner(packageManager, script) {
+    switch (packageManager) {
+        case "bun":
+            return { command: "bun", args: ["run", script] };
+        case "pnpm":
+            return { command: "pnpm", args: ["run", script] };
+        case "yarn":
+            return { command: "yarn", args: [script] };
+        default:
+            return { command: "npm", args: ["run", script] };
+    }
+}
+/** The scripts of the workspace, if it has a package.json. */
+export function readWorkspaceScripts(root) {
+    try {
+        const path = join(root, "package.json");
+        if (!existsSync(path))
+            return {};
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        const scripts = parsed?.scripts;
+        if (!scripts || typeof scripts !== "object")
+            return {};
+        return scripts;
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Choose the check that runs after a change.
+ *
+ * The preference decides the tool: Biome when the user asked for it, the
+ * project's own script otherwise. A workspace without a saved decision is
+ * never checked - the user has not chosen a tool yet.
+ */
+export function selectQualityCheck(options) {
+    const { context, preference, files } = options;
+    const scripts = options.scripts ?? readWorkspaceScripts(context.root);
+    const none = (reason) => ({
+        tool: "none",
+        command: null,
+        args: [],
+        files: [],
+        reason,
+    });
+    if (files.length === 0) {
+        return none("no JavaScript/TypeScript file changed");
+    }
+    if (!preference) {
+        return none("the user has not chosen a tool yet");
+    }
+    const projectScript = () => {
+        for (const name of ["lint", "typecheck"]) {
+            if (typeof scripts[name] === "string") {
+                return { script: name, spec: scriptRunner(context.packageManager, name) };
+            }
+        }
+        return null;
+    };
+    if (preference === "prefer_biome") {
+        if (!context.usesBiome) {
+            // The user asked for Biome, but the workspace does not have it
+            // (yet). The project's own tool is the honest fallback.
+            const fallback = projectScript();
+            if (!fallback) {
+                return none("Biome is not installed and the project has no lint script");
+            }
+            return {
+                tool: "project",
+                command: fallback.spec.command,
+                args: fallback.spec.args,
+                files,
+                reason: `Biome is not installed yet - the project script "${fallback.script}" runs instead`,
+            };
+        }
+        const runner = packageRunner(context.packageManager, "biome");
+        return {
+            tool: "biome",
+            command: runner.command,
+            args: [...runner.args, "check", ...files],
+            files,
+            reason: "the preference asks for Biome",
+        };
+    }
+    const script = projectScript();
+    if (!script) {
+        return none("the project has neither a lint nor a typecheck script");
+    }
+    return {
+        tool: "project",
+        command: script.spec.command,
+        args: script.spec.args,
+        files,
+        reason: `the project script "${script.script}" runs`,
+    };
+}
+/**
+ * Run the check.
+ *
+ * The command is started without a shell, with a timeout, and it never
+ * writes: a check that wants to fix files is not a check.
+ */
+export function runQualityCheck(plan, options) {
+    const maxOutputChars = options.maxOutputChars ?? 2000;
+    const base = {
+        tool: plan.tool,
+        fileCount: plan.files.length,
+    };
+    if (!plan.command) {
+        return {
+            ...base,
+            ran: false,
+            passed: false,
+            exitCode: null,
+            timedOut: false,
+            output: "",
+            reason: plan.reason,
+        };
+    }
+    try {
+        const result = spawnSync(plan.command, plan.args, {
+            cwd: options.cwd,
+            encoding: "utf8",
+            timeout: options.timeoutMs ?? 60_000,
+            maxBuffer: 8 * 1024 * 1024,
+            shell: false,
+            env: { ...process.env, CI: process.env.CI ?? "1" },
+        });
+        const output = `${result.stdout ?? ""}${result.stderr ?? ""}`.trim();
+        const error = result.error;
+        const timedOut = Boolean(error && /ETIMEDOUT/i.test(String(error.message)));
+        const exitCode = result.status ?? null;
+        if (error && !timedOut) {
+            // The binary does not exist: the check never started.
+            return {
+                ...base,
+                ran: false,
+                passed: false,
+                exitCode: null,
+                timedOut: false,
+                output: output.slice(0, maxOutputChars),
+                reason: `the check could not start: ${String(error.message).slice(0, 200)}`,
+            };
+        }
+        let reason = "the check reported problems";
+        if (timedOut) {
+            reason = "the check hit the timeout";
+        }
+        else if (exitCode === 0) {
+            reason = "the check passed";
+        }
+        return {
+            ...base,
+            ran: true,
+            passed: !timedOut && exitCode === 0,
+            exitCode,
+            timedOut,
+            output: output.slice(0, maxOutputChars),
+            reason,
+        };
+    }
+    catch (error) {
+        return {
+            ...base,
+            ran: false,
+            passed: false,
+            exitCode: null,
+            timedOut: false,
+            output: "",
+            reason: `the check could not start: ${String(error).slice(0, 200)}`,
+        };
+    }
+}
+/**
+ * The status line of the check.
+ *
+ * The line stays plain ASCII: it is read by the pi host and by terminals
+ * without a font of their own.
+ */
+export function formatQualityCheckStatus(result) {
+    if (!result.ran) {
+        return `[TOOL] no check: ${result.reason}`;
+    }
+    const tool = result.tool === "biome" ? "biome" : "project lint";
+    if (result.timedOut) {
+        return `[TOOL] ${tool}: ${result.fileCount} file(s), timeout`;
+    }
+    return `[TOOL] ${tool}: ${result.fileCount} file(s), ${result.passed ? "ok" : "failed"}`;
+}
+//# sourceMappingURL=quality-check.js.map

package/packages/tooling-preference/dist/quality-check.js.map

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

package/packages/tooling-preference/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/tooling-preference",
-  "version": "1.1.405",
+  "version": "1.1.407",
   "description": "pi-harness-runtime — JS/TS tooling preference (Biome vs ESLint/Prettier) proposal",
   "type": "module",
   "main": "./dist/index.js",

package/packages/tooling-preference/src/changed-files.ts

@@ -0,0 +1,147 @@
+/**
+ * The JavaScript/TypeScript files a session changed.
+ *
+ * The harness has no list of "the files Pi changed": the worktree is the
+ * only honest source. The detection reads the git status of the workspace
+ * (modified, staged and untracked files) and keeps the JavaScript and
+ * TypeScript ones. A workspace that is not a git repository yields nothing
+ * - the harness never guesses which files belong to the session.
+ */
+
+import { spawnSync } from "node:child_process";
+
+/** The extensions the quality check looks at. */
+export const JS_TS_EXTENSIONS = [
+	".ts",
+	".tsx",
+	".mts",
+	".cts",
+	".js",
+	".jsx",
+	".mjs",
+	".cjs",
+] as const;
+
+/** Directories that never hold source the check should read. */
+const IGNORED_PATH_PARTS = new Set([
+	"node_modules",
+	"dist",
+	"build",
+	"out",
+	"coverage",
+	".next",
+	".turbo",
+]);
+
+export interface ChangedFilesResult {
+	/** The changed JS/TS files, relative to the workspace root. */
+	files: string[];
+	/** Was the worktree read at all? */
+	detected: boolean;
+	/** Why the result is what it is - a human wording. */
+	reason: string;
+}
+
+/**
+ * Is this path a JavaScript or TypeScript source file?
+ */
+export function isJsTsFile(path: string): boolean {
+	const lower = path.toLowerCase();
+	return JS_TS_EXTENSIONS.some((extension) => lower.endsWith(extension));
+}
+
+/**
+ * Is this path inside a directory the check must not read?
+ */
+export function isIgnoredPath(path: string): boolean {
+	return path
+		.split("/")
+		.filter((part) => part.length > 0)
+		.some((part) => IGNORED_PATH_PARTS.has(part));
+}
+
+/**
+ * Parse the output of `git status --porcelain -z`.
+ *
+ * Every record is "XY <path>"; a rename or a copy carries the original
+ * path in the next record, which is not a change of its own.
+ */
+export function parseGitStatus(output: string): string[] {
+	const paths: string[] = [];
+	const records = output.split("\0").filter((record) => record.length > 0);
+
+	for (let index = 0; index < records.length; index++) {
+		const record = records[index];
+		if (!record || record.length < 4) continue;
+		const status = record.slice(0, 2);
+		const path = record.slice(3).trim();
+		if (!path) continue;
+		paths.push(path);
+		// A rename or a copy is followed by the original path.
+		if (status.includes("R") || status.includes("C")) index++;
+	}
+
+	return paths;
+}
+
+/**
+ * The JavaScript/TypeScript files that changed in the workspace.
+ *
+ * The detection never fails the session: a workspace without git (or
+ * without a repository) simply has no changed files.
+ */
+export function detectChangedJsTsFiles(
+	workspaceRoot: string,
+	options: { timeoutMs?: number; gitBin?: string } = {},
+): ChangedFilesResult {
+	const timeoutMs = options.timeoutMs ?? 5000;
+	const gitBin = options.gitBin ?? "git";
+
+	let output = "";
+	try {
+		const result = spawnSync(
+			gitBin,
+			["status", "--porcelain=v1", "-z", "--untracked-files=all"],
+			{
+				cwd: workspaceRoot,
+				encoding: "utf8",
+				timeout: timeoutMs,
+				maxBuffer: 8 * 1024 * 1024,
+			},
+		);
+		if (result.error || result.status !== 0) {
+			return {
+				files: [],
+				detected: false,
+				reason: result.error
+					? "git could not be run"
+					: "the workspace is not a git repository",
+			};
+		}
+		output = result.stdout ?? "";
+	} catch {
+		return { files: [], detected: false, reason: "git could not be run" };
+	}
+
+	const seen = new Set<string>();
+	const files: string[] = [];
+	for (const path of parseGitStatus(output)) {
+		const normalized = path.replace(/\\/g, "/");
+		if (seen.has(normalized)) continue;
+		if (!isJsTsFile(normalized) || isIgnoredPath(normalized)) continue;
+		seen.add(normalized);
+		files.push(normalized);
+	}
+	files.sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
+
+	let reason = "no changed file";
+	if (files.length > 0) {
+		reason = `${files.length} changed file(s)`;
+	}
+
+	return {
+		files,
+		detected: true,
+		reason,
+	};
+}

package/packages/tooling-preference/src/index.ts

@@ -42,3 +42,22 @@ export {
 	type ToolingRequest,
 	type ToolingResolution,
 } from "./registry.js";
+
+export {
+	detectChangedJsTsFiles,
+	isIgnoredPath,
+	isJsTsFile,
+	parseGitStatus,
+	JS_TS_EXTENSIONS,
+	type ChangedFilesResult,
+} from "./changed-files.js";
+
+export {
+	formatQualityCheckStatus,
+	readWorkspaceScripts,
+	runQualityCheck,
+	selectQualityCheck,
+	type QualityCheckPlan,
+	type QualityCheckResult,
+	type QualityCheckTool,
+} from "./quality-check.js";