pi-harness-runtime 1.1.403 → 1.1.405

package/packages/tooling-preference/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,gCAAgC,EAChC,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,mBAAmB,EACnB,gCAAgC,EAChC,2BAA2B,EAC3B,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACN,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,uBAAuB,GAC5B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACN,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACtB,MAAM,eAAe,CAAC"}

package/packages/tooling-preference/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * The JS/TS tooling preference of a workspace.
+ *
+ * The harness offers the user to replace ESLint and Prettier with Biome.js
+ * in a JavaScript/TypeScript workspace. The offer is a decision of its own:
+ * it never pauses the work and never travels through the task-approval
+ * path.
+ */
+export { detectPackageManager, detectToolingContext, evaluateBiomeProposalEligibility, } from "./detect.js";
+export { buildToolingButtons, buildToolingImplementationPrompt, buildToolingProposalMessage, buildToolingRequestId, buildToolingUserKey, parseToolingTarget, TOOLING_ACTION, } from "./proposal.js";
+export { harnessRuntimeDir, shouldAskAgain, ToolingPreferenceStore, toolingPreferenceKey, } from "./store.js";
+export { ToolingRequestRegistry, } from "./registry.js";
+//# sourceMappingURL=index.js.map

package/packages/tooling-preference/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,gCAAgC,GAGhC,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,mBAAmB,EACnB,gCAAgC,EAChC,2BAA2B,EAC3B,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,GAKd,MAAM,eAAe,CAAC;AAEvB,OAAO,EACN,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,GAEpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACN,sBAAsB,GAGtB,MAAM,eAAe,CAAC"}

package/packages/tooling-preference/dist/proposal.d.ts

@@ -0,0 +1,70 @@
+/**
+ * The tooling proposal: request IDs, buttons and the wording.
+ *
+ * The proposal is a decision of its own. It never travels through the
+ * task-approval path, because a "No" there pauses the work and a "Yes"
+ * there resumes it - neither belongs to a tooling preference.
+ */
+import type { ToolingContext } from "./detect.js";
+/**
+ * The callback action of the proposal.
+ *
+ * The callback data is parsed by splitting on "_", so an action must be a
+ * single token: an action that carries an underscore would be read as the
+ * action up to that underscore, and the rest as the target.
+ */
+export declare const TOOLING_ACTION = "biome";
+/** The answer of the user. */
+export type ToolingChoice = "yes" | "no";
+/** The saved preference of a user in a workspace. */
+export type ToolingPreference = "prefer_biome" | "use_project_tools";
+export interface ToolingButton {
+    /** The label of the button. */
+    text: string;
+    /** The callback action - always `TOOLING_ACTION`. */
+    action: string;
+    /** The choice and the request ID, e.g. `yes-biome-<hash>`. */
+    targetId: string;
+}
+export interface ToolingTarget {
+    choice: ToolingChoice;
+    requestId: string;
+}
+/**
+ * The canonical request ID of one proposal.
+ *
+ * The request ID is the correlation key: both channels send the same ID,
+ * and the first answer wins. It only holds hex characters and dashes so it
+ * survives the "_" split of the callback data.
+ */
+export declare function buildToolingRequestId(userKey: string, workspaceRoot: string): string;
+/**
+ * The key of the user the proposal is sent to.
+ *
+ * The identity is hashed: the store holds the key of a user, never the id
+ * of the user.
+ */
+export declare function buildToolingUserKey(identity: string): string;
+/**
+ * The two buttons of the proposal.
+ */
+export declare function buildToolingButtons(requestId: string): ToolingButton[];
+/**
+ * Read the choice and the request ID out of a callback target.
+ *
+ * A target that does not belong to the proposal returns `null` - a click on
+ * a foreign button must never resolve a preference.
+ */
+export declare function parseToolingTarget(targetId: string | undefined): ToolingTarget | null;
+/**
+ * The wording of the proposal.
+ */
+export declare function buildToolingProposalMessage(context: ToolingContext): string;
+/**
+ * The instruction the agent receives after a "Yes".
+ *
+ * The agent does the repository work: the harness only records the
+ * decision and starts the implementation.
+ */
+export declare function buildToolingImplementationPrompt(context: ToolingContext, workspaceRoot: string): string;
+//# sourceMappingURL=proposal.d.ts.map

package/packages/tooling-preference/dist/proposal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal.d.ts","sourceRoot":"","sources":["../src/proposal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,8BAA8B;AAC9B,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,IAAI,CAAC;AAEzC,qDAAqD;AACrD,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,mBAAmB,CAAC;AAErE,MAAM,WAAW,aAAa;IAC7B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAatE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,IAAI,CAKrF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAwB3E;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC/C,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,MAAM,GACnB,MAAM,CAoCR"}

package/packages/tooling-preference/dist/proposal.js

@@ -0,0 +1,137 @@
+/**
+ * The tooling proposal: request IDs, buttons and the wording.
+ *
+ * The proposal is a decision of its own. It never travels through the
+ * task-approval path, because a "No" there pauses the work and a "Yes"
+ * there resumes it - neither belongs to a tooling preference.
+ */
+import { createHash } from "node:crypto";
+/**
+ * The callback action of the proposal.
+ *
+ * The callback data is parsed by splitting on "_", so an action must be a
+ * single token: an action that carries an underscore would be read as the
+ * action up to that underscore, and the rest as the target.
+ */
+export const TOOLING_ACTION = "biome";
+function shortHash(value, length = 16) {
+    return createHash("sha256").update(value).digest("hex").slice(0, length);
+}
+/**
+ * The canonical request ID of one proposal.
+ *
+ * The request ID is the correlation key: both channels send the same ID,
+ * and the first answer wins. It only holds hex characters and dashes so it
+ * survives the "_" split of the callback data.
+ */
+export function buildToolingRequestId(userKey, workspaceRoot) {
+    return `biome-${shortHash(`${userKey} ${workspaceRoot}`)}`;
+}
+/**
+ * The key of the user the proposal is sent to.
+ *
+ * The identity is hashed: the store holds the key of a user, never the id
+ * of the user.
+ */
+export function buildToolingUserKey(identity) {
+    const trimmed = identity.trim();
+    if (!trimmed)
+        return "default";
+    return `u-${shortHash(`user:${trimmed}`)}`;
+}
+/**
+ * The two buttons of the proposal.
+ */
+export function buildToolingButtons(requestId) {
+    return [
+        {
+            text: "Yes - use Biome.js",
+            action: TOOLING_ACTION,
+            targetId: `yes-${requestId}`,
+        },
+        {
+            text: "No - keep the current tools",
+            action: TOOLING_ACTION,
+            targetId: `no-${requestId}`,
+        },
+    ];
+}
+/**
+ * Read the choice and the request ID out of a callback target.
+ *
+ * A target that does not belong to the proposal returns `null` - a click on
+ * a foreign button must never resolve a preference.
+ */
+export function parseToolingTarget(targetId) {
+    if (!targetId)
+        return null;
+    const match = /^(yes|no)-(.+)$/.exec(targetId);
+    if (!match)
+        return null;
+    return { choice: match[1], requestId: match[2] };
+}
+/**
+ * The wording of the proposal.
+ */
+export function buildToolingProposalMessage(context) {
+    const frameworks = [];
+    if (context.isNextJs)
+        frameworks.push("Next.js");
+    if (context.isReact && !context.isNextJs)
+        frameworks.push("React");
+    const tools = [];
+    if (context.usesEslint)
+        tools.push("ESLint");
+    if (context.usesPrettier)
+        tools.push("Prettier");
+    const lines = [];
+    lines.push(frameworks.length > 0
+        ? `This workspace looks like a ${frameworks.join(" + ")} project that still uses ${tools.join(" and ")}.`
+        : `This workspace looks like a JavaScript/TypeScript project that still uses ${tools.join(" and ")}.`);
+    lines.push("");
+    lines.push("Biome.js can replace both: one tool for linting, formatting and import order.");
+    lines.push("");
+    lines.push(`Detected: ${tools.join(", ")}${context.packageManager ? ` - ${context.packageManager}` : ""}`);
+    lines.push("");
+    lines.push("Yes adds Biome and migrates the lint/format setup here. No keeps the current tools. Nothing changes until you answer.");
+    return lines.join("\n");
+}
+/**
+ * The instruction the agent receives after a "Yes".
+ *
+ * The agent does the repository work: the harness only records the
+ * decision and starts the implementation.
+ */
+export function buildToolingImplementationPrompt(context, workspaceRoot) {
+    const frameworks = [];
+    if (context.isNextJs)
+        frameworks.push("Next.js");
+    if (context.isReact && !context.isNextJs)
+        frameworks.push("React");
+    const manager = context.packageManager;
+    let install = "install it as a dev dependency with the package manager of the workspace";
+    if (manager === "npm") {
+        install = "install it with npm install --save-dev";
+    }
+    else if (manager) {
+        install = `install it with ${manager} add --save-dev`;
+    }
+    const lines = [];
+    lines.push(`The user chose to use Biome.js in this workspace (${workspaceRoot}). Implement it now.`);
+    lines.push("");
+    lines.push("1. Add Biome to the dev dependencies: " + install + " @biomejs/biome.");
+    lines.push("2. Add a biome.json that fits the project:");
+    if (frameworks.length > 0) {
+        lines.push(`   - enable the ${frameworks.join(" and ")} rules,`);
+    }
+    lines.push("   - enable the formatter, the linter and the import organizer,");
+    lines.push("   - keep the settings that match the existing code style (indentation, quotes, semicolons).");
+    lines.push("3. Replace the lint and format scripts in package.json with the Biome equivalents (biome check, biome format, biome ci).");
+    lines.push("4. Migrate the ESLint and Prettier configuration that Biome replaces and remove the files Biome fully replaces.");
+    lines.push("5. Keep the type check and the tests as they are - Biome does not replace them.");
+    lines.push("6. Run the Biome check, fix what it reports in the files you touched, and report the result.");
+    lines.push("");
+    lines.push("Do not touch files outside this workspace and do not change the public behaviour of the code.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=proposal.js.map

package/packages/tooling-preference/dist/proposal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal.js","sourceRoot":"","sources":["../src/proposal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAsBtC,SAAS,SAAS,CAAC,KAAa,EAAE,MAAM,GAAG,EAAE;IAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,aAAqB;IAC3E,OAAO,SAAS,SAAS,CAAC,GAAG,OAAO,IAAI,aAAa,EAAE,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IACnD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,KAAK,SAAS,CAAC,QAAQ,OAAO,EAAE,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACpD,OAAO;QACN;YACC,IAAI,EAAE,oBAAoB;YAC1B,MAAM,EAAE,cAAc;YACtB,QAAQ,EAAE,OAAO,SAAS,EAAE;SAC5B;QACD;YACC,IAAI,EAAE,6BAA6B;YACnC,MAAM,EAAE,cAAc;YACtB,QAAQ,EAAE,MAAM,SAAS,EAAE;SAC3B;KACD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAA4B;IAC9D,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAkB,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAuB;IAClE,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,OAAO,CAAC,QAAQ;QAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEnE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,OAAO,CAAC,YAAY;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEjD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CACT,UAAU,CAAC,MAAM,GAAG,CAAC;QACpB,CAAC,CAAC,+BAA+B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,4BAA4B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG;QACzG,CAAC,CAAC,6EAA6E,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CACtG,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IAC5F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3G,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACT,uHAAuH,CACvH,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAC/C,OAAuB,EACvB,aAAqB;IAErB,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,OAAO,CAAC,QAAQ;QAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEnE,MAAM,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IACvC,IAAI,OAAO,GAAG,0EAA0E,CAAC;IACzF,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACvB,OAAO,GAAG,wCAAwC,CAAC;IACpD,CAAC;SAAM,IAAI,OAAO,EAAE,CAAC;QACpB,OAAO,GAAG,mBAAmB,OAAO,iBAAiB,CAAC;IACvD,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CACT,qDAAqD,aAAa,sBAAsB,CACxF,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,wCAAwC,GAAG,OAAO,GAAG,kBAAkB,CAAC,CAAC;IACpF,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IACzD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,mBAAmB,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,8FAA8F,CAAC,CAAC;IAC3G,KAAK,CAAC,IAAI,CACT,0HAA0H,CAC1H,CAAC;IACF,KAAK,CAAC,IAAI,CACT,iHAAiH,CACjH,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;IAC9F,KAAK,CAAC,IAAI,CAAC,8FAA8F,CAAC,CAAC;IAC3G,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,+FAA+F,CAAC,CAAC;IAC5G,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/packages/tooling-preference/dist/registry.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The pending proposals of this session.
+ *
+ * The first answer wins: a second click on the other button changes
+ * nothing. The registry is in memory only - a proposal that was never
+ * answered simply disappears with the session.
+ */
+import type { ToolingChoice, ToolingPreference } from "./proposal.js";
+export interface ToolingRequest {
+    /** The canonical request ID of the proposal. */
+    requestId: string;
+    /** The workspace the proposal belongs to. */
+    workspaceRoot: string;
+    /** The user the proposal was sent to. */
+    userKey: string;
+    /** The tooling facts of the workspace. */
+    frameworks: string[];
+}
+export interface ToolingResolution {
+    choice: ToolingChoice;
+    preference: ToolingPreference;
+    channel?: string;
+}
+export declare class ToolingRequestRegistry {
+    private readonly pending;
+    private readonly resolved;
+    /**
+     * Register a proposal. A request ID that is already known is refused.
+     */
+    register(request: ToolingRequest): boolean;
+    /**
+     * Is the request still waiting for an answer?
+     */
+    has(requestId: string): boolean;
+    /**
+     * Claim a request for an answer.
+     *
+     * The claim removes the request, so a second click finds nothing and the
+     * first answer stays the one that counts.
+     */
+    claim(requestId: string, choice: ToolingChoice, channel?: string): {
+        request: ToolingRequest;
+        resolution: ToolingResolution;
+    } | null;
+    /**
+     * The answer of a request that was already resolved.
+     */
+    resolutionOf(requestId: string): ToolingResolution | undefined;
+}
+//# sourceMappingURL=registry.d.ts.map

package/packages/tooling-preference/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC9B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,sBAAsB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IAEjE;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAMzC;IAED;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE9B;IAED;;;;;OAKG;IACH,KAAK,CACJ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,MAAM,GACd;QAAE,OAAO,EAAE,cAAc,CAAC;QAAC,UAAU,EAAE,iBAAiB,CAAA;KAAE,GAAG,IAAI,CAWnE;IAED;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAE7D;CACD"}

package/packages/tooling-preference/dist/registry.js

@@ -0,0 +1,53 @@
+/**
+ * The pending proposals of this session.
+ *
+ * The first answer wins: a second click on the other button changes
+ * nothing. The registry is in memory only - a proposal that was never
+ * answered simply disappears with the session.
+ */
+export class ToolingRequestRegistry {
+    pending = new Map();
+    resolved = new Map();
+    /**
+     * Register a proposal. A request ID that is already known is refused.
+     */
+    register(request) {
+        if (this.pending.has(request.requestId) || this.resolved.has(request.requestId)) {
+            return false;
+        }
+        this.pending.set(request.requestId, request);
+        return true;
+    }
+    /**
+     * Is the request still waiting for an answer?
+     */
+    has(requestId) {
+        return this.pending.has(requestId);
+    }
+    /**
+     * Claim a request for an answer.
+     *
+     * The claim removes the request, so a second click finds nothing and the
+     * first answer stays the one that counts.
+     */
+    claim(requestId, choice, channel) {
+        const request = this.pending.get(requestId);
+        if (!request)
+            return null;
+        this.pending.delete(requestId);
+        const resolution = {
+            choice,
+            preference: choice === "yes" ? "prefer_biome" : "use_project_tools",
+            ...(channel ? { channel } : {}),
+        };
+        this.resolved.set(requestId, resolution);
+        return { request, resolution };
+    }
+    /**
+     * The answer of a request that was already resolved.
+     */
+    resolutionOf(requestId) {
+        return this.resolved.get(requestId);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/packages/tooling-preference/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH,MAAM,OAAO,sBAAsB;IACjB,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC5C,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEjE;;OAEG;IACH,QAAQ,CAAC,OAAuB;QAC/B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACjF,OAAO,KAAK,CAAC;QACd,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CACJ,SAAiB,EACjB,MAAqB,EACrB,OAAgB;QAEhB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/B,MAAM,UAAU,GAAsB;YACrC,MAAM;YACN,UAAU,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,mBAAmB;YACnE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/B,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;CACD"}

package/packages/tooling-preference/dist/store.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The saved tooling preference of a user in a workspace.
+ *
+ * The store is a plain JSON file under the harness runtime directory: it
+ * works in every runtime (a SQLite file would not - `node:sqlite` is
+ * missing in some of them) and it stays readable for the user.
+ */
+import type { ToolingPreference } from "./proposal.js";
+export interface ToolingPreferenceRecord {
+    /** The saved decision, when the user answered. */
+    decision?: ToolingPreference;
+    /** When the proposal was sent. */
+    askedAt?: string;
+    /** When the user answered. */
+    decidedAt?: string;
+    /** The request ID of the proposal that was sent. */
+    requestId?: string;
+    /** The workspace the record belongs to. */
+    workspaceRoot?: string;
+    /** The channel the answer came from. */
+    channel?: string;
+}
+/**
+ * The key of one record: the user and the workspace.
+ */
+export declare function toolingPreferenceKey(userKey: string, workspaceRoot: string): string;
+/**
+ * The runtime directory of the harness.
+ */
+export declare function harnessRuntimeDir(): string;
+export declare class ToolingPreferenceStore {
+    private readonly filePath;
+    constructor(filePath: string);
+    /**
+     * The default store: `~/.pi-harness-runtime/tooling-preference.json`.
+     */
+    static defaultFilePath(): string;
+    /**
+     * The record of one user in one workspace.
+     */
+    read(userKey: string, workspaceRoot: string): ToolingPreferenceRecord | undefined;
+    /**
+     * Remember that the proposal was sent.
+     */
+    markAsked(userKey: string, workspaceRoot: string, requestId: string, now?: Date): void;
+    /**
+     * Save the answer of the user.
+     */
+    recordDecision(userKey: string, workspaceRoot: string, decision: ToolingPreference, requestId: string, channel?: string, now?: Date): void;
+    private load;
+    private save;
+}
+/**
+ * May the proposal be sent again?
+ *
+ * A workspace that was asked and never answered is asked again after the
+ * cooldown - the user may have missed it. A workspace with a decision is
+ * never asked again.
+ */
+export declare function shouldAskAgain(record: ToolingPreferenceRecord | undefined, cooldownMs: number, now?: Date): boolean;
+//# sourceMappingURL=store.d.ts.map

package/packages/tooling-preference/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,WAAW,uBAAuB;IACvC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AAED,qBAAa,sBAAsB;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAArC,YAA6B,QAAQ,EAAE,MAAM,EAAI;IAEjD;;OAEG;IACH,MAAM,CAAC,eAAe,IAAI,MAAM,CAE/B;IAED;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAGhF;IAED;;OAEG;IACH,SAAS,CACR,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,IAAiB,GACpB,IAAI,CAWN;IAED;;OAEG;IACH,cAAc,CACb,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,GAAG,GAAE,IAAiB,GACpB,IAAI,CAcN;IAED,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,IAAI;CAYZ;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,uBAAuB,GAAG,SAAS,EAC3C,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,IAAiB,GACpB,OAAO,CAOT"}

package/packages/tooling-preference/dist/store.js

@@ -0,0 +1,129 @@
+/**
+ * The saved tooling preference of a user in a workspace.
+ *
+ * The store is a plain JSON file under the harness runtime directory: it
+ * works in every runtime (a SQLite file would not - `node:sqlite` is
+ * missing in some of them) and it stays readable for the user.
+ */
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+function shortHash(value, length = 16) {
+    return createHash("sha256").update(value).digest("hex").slice(0, length);
+}
+/**
+ * The key of one record: the user and the workspace.
+ */
+export function toolingPreferenceKey(userKey, workspaceRoot) {
+    return `${userKey}::${shortHash(workspaceRoot)}`;
+}
+/**
+ * The runtime directory of the harness.
+ */
+export function harnessRuntimeDir() {
+    const configured = process.env.PI_HARNESS_HOME?.trim();
+    if (configured)
+        return configured;
+    return join(homedir(), ".pi-harness-runtime");
+}
+export class ToolingPreferenceStore {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    /**
+     * The default store: `~/.pi-harness-runtime/tooling-preference.json`.
+     */
+    static defaultFilePath() {
+        return join(harnessRuntimeDir(), "tooling-preference.json");
+    }
+    /**
+     * The record of one user in one workspace.
+     */
+    read(userKey, workspaceRoot) {
+        const data = this.load();
+        return data[toolingPreferenceKey(userKey, workspaceRoot)];
+    }
+    /**
+     * Remember that the proposal was sent.
+     */
+    markAsked(userKey, workspaceRoot, requestId, now = new Date()) {
+        const key = toolingPreferenceKey(userKey, workspaceRoot);
+        const data = this.load();
+        const existing = data[key] ?? {};
+        data[key] = {
+            ...existing,
+            askedAt: now.toISOString(),
+            requestId,
+            workspaceRoot,
+        };
+        this.save(data);
+    }
+    /**
+     * Save the answer of the user.
+     */
+    recordDecision(userKey, workspaceRoot, decision, requestId, channel, now = new Date()) {
+        const key = toolingPreferenceKey(userKey, workspaceRoot);
+        const data = this.load();
+        const existing = data[key] ?? {};
+        data[key] = {
+            ...existing,
+            decision,
+            decidedAt: now.toISOString(),
+            askedAt: existing.askedAt ?? now.toISOString(),
+            requestId,
+            workspaceRoot,
+            ...(channel ? { channel } : {}),
+        };
+        this.save(data);
+    }
+    load() {
+        if (!existsSync(this.filePath))
+            return {};
+        try {
+            const parsed = JSON.parse(readFileSync(this.filePath, "utf8"));
+            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+                return {};
+            return parsed;
+        }
+        catch {
+            // A broken store must not stop the harness: the proposal is
+            // simply asked again.
+            return {};
+        }
+    }
+    save(data) {
+        try {
+            mkdirSync(dirname(this.filePath), { recursive: true });
+            const temporary = `${this.filePath}.tmp`;
+            writeFileSync(temporary, `${JSON.stringify(data, null, 2)}\n`, "utf8");
+            // The rename keeps a half written file from being read.
+            renameSync(temporary, this.filePath);
+        }
+        catch {
+            // A store that cannot be written is a lost preference, not a
+            // broken harness.
+        }
+    }
+}
+/**
+ * May the proposal be sent again?
+ *
+ * A workspace that was asked and never answered is asked again after the
+ * cooldown - the user may have missed it. A workspace with a decision is
+ * never asked again.
+ */
+export function shouldAskAgain(record, cooldownMs, now = new Date()) {
+    if (!record)
+        return true;
+    if (record.decision)
+        return false;
+    if (!record.askedAt)
+        return true;
+    const askedAt = Date.parse(record.askedAt);
+    if (Number.isNaN(askedAt))
+        return true;
+    return now.getTime() - askedAt >= cooldownMs;
+}
+//# sourceMappingURL=store.js.map

package/packages/tooling-preference/dist/store.js.map

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

package/packages/tooling-preference/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@pi-harness/tooling-preference",
+  "version": "1.1.405",
+  "description": "pi-harness-runtime — JS/TS tooling preference (Biome vs ESLint/Prettier) proposal",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test"
+  }
+}