@apptoolkit/harness 1.0.3 → 1.0.5

package/package.json

@@ -1,37 +1,98 @@
 {
   "name": "@apptoolkit/harness",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "A portable harness for configuring AI coding agents and engineering workflows.",
+  "license": "MIT",
   "type": "module",
+  "bin": {
+    "harness": "./harness.js"
+  },
+  "files": [
+    "harness.js",
+    "payload/HARNESS.md",
+    "payload/author-style/README.md",
+    "payload/author-style/biome-core.json",
+    "payload/author-style/biome-react.json",
+    "payload/author-style/biome-sql.json",
+    "payload/author-style/bun.lock",
+    "payload/author-style/check.llm.md",
+    "payload/author-style/check.test.llm.md",
+    "payload/author-style/check.test.ts",
+    "payload/author-style/check.ts",
+    "payload/author-style/member-spacing.test.ts",
+    "payload/author-style/member-spacing.ts",
+    "payload/author-style/package.json",
+    "payload/author-style/plugins/class-member-order.grit",
+    "payload/author-style/plugins/event-handler-names.grit",
+    "payload/author-style/plugins/explicit-arrow-body.grit",
+    "payload/author-style/plugins/explicit-source-constructs.grit",
+    "payload/author-style/plugins/react-arrow-body.grit",
+    "payload/author-style/plugins/sql-style.grit",
+    "payload/author-style/react-module.llm.md",
+    "payload/author-style/react-module.test.ts",
+    "payload/author-style/react-module.ts",
+    "payload/author-style/source-policy.llm.md",
+    "payload/author-style/source-policy.test.ts",
+    "payload/author-style/source-policy.ts",
+    "payload/author-style/spacing.llm.md",
+    "payload/author-style/spacing.test.ts",
+    "payload/author-style/spacing.ts",
+    "payload/harness/LEARNING.md",
+    "payload/harness/POLICY.md",
+    "payload/harness/PROJECT.md",
+    "payload/harness/REVIEW.md",
+    "payload/harness/TEMPLATES.md",
+    "payload/harness/WORKFLOWS.md",
+    "payload/harness/runtime/ZOD-LICENSE",
+    "payload/harness/runtime/harness.mjs",
+    "payload/harness/services/README.md",
+    "payload/harness/services/penpot.json",
+    "payload/harness/services/plane.json",
+    "payload/harness/workflows/W01.md",
+    "payload/harness/workflows/W02.md",
+    "payload/harness/workflows/W03.md",
+    "payload/harness/workflows/W04.md",
+    "payload/harness/workflows/W05.md",
+    "payload/harness/workflows/W06.md",
+    "payload/harness/workflows/W07.md",
+    "payload/harness/workflows/W08.md",
+    "payload/harness/workflows/W09.md",
+    "payload/harness/workflows/W10.md",
+    "payload/harness/workflows/W11.md",
+    "payload/harness/workflows/W12.md",
+    "payload/harness/workflows/W13.md",
+    "payload/harness/workflows/W14.md",
+    "payload/harness/workflows/W15.md",
+    "payload/harness/workflows/W16.md",
+    "payload/harness/workflows/W17.md",
+    "payload/harness/workflows/W18.md",
+    "payload/harness/workflows/W19.md",
+    "payload/harness/workflows/W20.md",
+    "payload/harness/workflows/W21.md",
+    "payload/harness/workflows/W22.md",
+    "payload/harness/workflows/W23.md",
+    "payload/harness/workflows/W24.md",
+    "payload/harness/workflows/W25.md",
+    "payload/harness/workflows/W26.md",
+    "payload/harness/workflows/W27.md",
+    "payload/harness/workflows/W28.md",
+    "payload/harness/workflows/W29.md",
+    "payload/harness/workflows/W30.md",
+    "payload/harness/workflows/W31.md",
+    "payload/harness/workflows/W32.md",
+    "payload/harness/workflows/W33.md",
+    "payload/harness/workflows/W34.md",
+    "payload/harness/workflows/W35.md",
+    "payload/harness/workflows/W36.md",
+    "payload/harness/workflows/W37.md"
+  ],
   "packageManager": "bun@1.4.2",
-  "files": [],
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "scripts": {
-    "check:code": "bun --no-env-file llm/tools/check-code.ts",
-    "acquire": "bun --no-env-file src/acquisition/acquire.ts",
-    "build:harness": "bun --no-env-file src/harness/release/build.ts",
-    "build:harness:native": "bun --no-env-file src/harness/release/build.ts --native",
-    "pack:harness": "bun --no-env-file src/harness/release/build.ts --pack",
-    "test": "bun test --no-env-file ./src/acquisition",
-    "test:harness": "bun test --no-env-file ./src/harness",
-    "test:all": "bun test --no-env-file --no-orphans --timeout 30000 --path-ignore-patterns '**/raw/**' --path-ignore-patterns '**/processing/**' --path-ignore-patterns '**/dist/**' ./src/acquisition ./src/harness ./src/author-style ./llm/tools/check-code.test.ts",
-    "typecheck": "bun --no-env-file node_modules/typescript/bin/tsc --noEmit"
-  },
   "dependencies": {
     "ink": "7.1.1",
-    "react": "19.3.1",
-    "zod": "4.6.7"
-  },
-  "devDependencies": {
-    "@types/node": "24.10.0",
-    "@types/react": "19.3.0",
-    "react-devtools-core": "6.1.5",
-    "typescript": "5.9.3"
-  },
-  "engines": {
-    "bun": ">=1.4.2"
+    "react": "19.3.1"
   }
 }

package/payload/HARNESS.md

@@ -0,0 +1,28 @@
+# AppToolkit Harness
+
+Use this index when adopting a project or opening a fresh agent session. Resolve the project, read its applicable rules, and open the smallest workflow that matches the request.
+
+## Every session
+
+1. Resolve the active repository and its rules with the [project guide](harness/PROJECT.md) and [operating policy](harness/POLICY.md). Use the workflow index for the task. The native setup command is for init and update.
+2. Look up relevant prior work in [project knowledge](harness-local/KNOWLEDGE.md). Use the matching record and bounded evidence. Prefer tested [project tools](harness-local/TOOLS.md) for deterministic work.
+3. At each decision, correction, useful discovery, repeated operation or handoff, follow the [learning and improvement procedure](harness/LEARNING.md). Maintain applicable sibling source maps after code changes and verify the latest links before handoff.
+
+| Need | Start here |
+| --- | --- |
+| Find the procedure for a natural request | [Workflow index](harness/WORKFLOWS.md) |
+| Start a new feature or an unresolved change | [W16 Feature definition](harness/workflows/W16.md) |
+| Adopt, initialize or update this installation | [W20 Adoption](harness/workflows/W20.md) |
+| Resolve repositories, services and project conventions | [Project guide](harness/PROJECT.md) |
+| Check permissions, engineering rules and learning | [Operating policy](harness/POLICY.md) |
+| Apply a lesson, preserve research or improve a check | [Learning and improvement](harness/LEARNING.md) |
+| Audit a claim or independently review code | [Independent review](harness/REVIEW.md) |
+| Prepare a decision, work unit or checkpoint | [Templates](harness/TEMPLATES.md) |
+| Verify coverage against an explicit source inventory | [W23 Verification](harness/workflows/W23.md) |
+| Verify authored TypeScript without a compatible project Biome configuration | [Style tools](author-style/README.md) |
+
+Begin with the installed workspace and project records for the active root. Apply the nearest repository guidance as well as shared decisions relevant to that repository. Use source maps to locate the relevant sections. For a natural request such as “Give me my pending list” or “Dame mi lista de pendientes”, open only [W01](harness/workflows/W01.md), resolve its target and use the project's authorized sources.
+
+Run `rtk proxy bun --no-env-file llm/harness/runtime/harness.mjs context llm/HARNESS.md` from the installation root to list heading locators without returning the body. If only Node.js is available, replace `bun --no-env-file` with `node` in installed runtime commands. Add `--section line:1` with the locator reported for the desired heading. An exact title or anchor also works when unique. Select a line locator for repeated titles. The reader opens regular project-relative Markdown files, rejects protected locations and symbolic links, and returns a bounded section with its source line range.
+
+Open an indexed workflow directly with `rtk proxy bunx --bun @apptoolkit/harness workflow W01` or `rtk proxy npx @apptoolkit/harness workflow W01`. Use [W21](harness/workflows/W21.md) to plan local source-map protection and [W23](harness/workflows/W23.md) to check a fresh LCOV report.

package/payload/author-style/README.md

@@ -0,0 +1,58 @@
+# Personal code style
+
+Use this profile whenever an agent writes or changes authored TypeScript in a project without an applicable Biome configuration. It supplies a pinned Biome dependency, configuration, structural lint rules and a small TypeScript parser supplement. The tool reads only the explicitly selected source files for its supplementary checks and never writes target files.
+
+- [Writing rules](#writing-rules): Read before editing code.
+- [Deterministic checks](#deterministic-checks): Select an appropriate profile.
+- [Install and run](#install-and-run): Run after each code edit batch and before handoff. See the [checker map](check.llm.md) when maintaining the tool.
+- [Evidence and precedence](#evidence-and-precedence): Apply the target project rules and verify changes.
+
+## Writing rules
+
+1. Write code in execution order. Name intermediate values when nesting hides decisions. Use explicit guards and braces, keep related steps together and separate preparation, reads, decisions, writes and returns when they serve different purposes. Keep a simple expression concise.
+2. Define domain contracts before behavior. Keep a schema and its inferred types together and validate untrusted data before it enters domain logic. Reuse the accepted validation contract. Ask before adding Zod to a target that does not have it. Use explicit projections at public boundaries.
+3. Keep transport and framework adapters focused. Separate domain decisions from persistence and wire explicit dependencies. Preserve the project's established class, module or functional organization. In classes, order static properties and methods before the constructor and instance properties and methods after it. Put private or protected members before public members in the corresponding group. Prefer constructor parameter properties for retained values and keep related operations in workflow order.
+4. Use descriptive names and structure to explain behavior. Preserve rationale in the project's decision, ticket or review record. Keep a cause and useful context when operations fail. Prove guards, recovery and failure behavior through focused tests. Do not copy historical workarounds or weaken types to make checks pass.
+5. Scope component rules to reusable React components. Prefer a named PascalCase `const`, explicit `FC` props and a default export when compatible with local rules. Keep props near their component and keep inline event callbacks to a single simple call. Use descriptive local `handle…` names. Treat framework entry points, generic components and library-owned wrappers according to their actual contract.
+
+## Deterministic checks
+
+| Area | Enforcement |
+| --- | --- |
+| Format | Biome uses two spaces, LF, a 120-column line width, single quotes in TypeScript, double quotes in JSX, semicolons, trailing commas and parenthesized arrow parameters. |
+| Structure | Biome and the bundled Grit plugins check braces, explicit class accessibility, supported member-order inversions, multiline or branching arrow bodies and increment/decrement operators. The TypeScript supplement checks statement phase boundaries and class member separation, keeping overloads grouped. |
+| Types and source | Biome rejects explicit `any`, non-null assertions, selected suppression directives and configured unsafe type patterns. Grit rejects explicit `unknown` type nodes. The TypeScript supplement checks double assertions, explanatory comments and top-level inferred types derived directly from a same-file schema via a recognized Zod import. It preserves parsed TypeScript reference directives and exact SQL markers before supported tagged templates. |
+| `react` | Includes the common checks plus selected JSX components, exports, `FC` typing, inline event call shape and local event names. It recognizes direct imported React `memo` and `forwardRef`. Select reusable component files. Other wrappers, arbitrary aliases and semantic event binding still need review. |
+| `sql` | Includes the common checks plus a lexical check for supported templates with a direct `sql` tag. Select it only where the project's `sql` tag is PostgreSQL. It does not resolve aliases or parse the SQL dialect. Unsupported fragments remain outside the check. |
+
+Keep the native type checker, focused behavior tests, independent technical audit and separate code review. Static checks do not prove meaningful names, correct schema ownership, safe public exposure, awaited authorization, rejection handling, transaction semantics or test adequacy. A successful check reports a result for the selected files and patterns. It does not establish whole-project coverage.
+
+## Install and run
+
+Use the installed `llm/author-style/` directory in the adopting project. Keep its package manifest and `bun.lock` together. Run these commands from the adopting project's root with RTK and Bun 1.4.2 or later.
+
+```text
+rtk proxy bun install --cwd llm/author-style --frozen-lockfile --ignore-scripts
+rtk proxy bun run --cwd llm/author-style check --root /absolute/project path/to/changed.ts
+```
+
+The Bun install command installs the isolated verifier and its platform binary inside `llm/author-style/`. Keep the application's own dependencies, lockfile and package manager. Use explicit paths under the actual project root. Quote paths containing spaces and pass `--` before paths beginning with a hyphen. Supported inputs are `.ts`, `.tsx`, `.mts` and `.cts`. A selection can include new and existing files. The verifier reads the whole selected file, so keep inherited violations separate and do not reformat unrelated code. The command rejects symlinks, known generated or dependency directories, generated headers and out-of-root paths.
+
+```text
+rtk proxy bun run --cwd llm/author-style check --root /absolute/project --profile react src/Panel.tsx
+rtk proxy bun run --cwd llm/author-style check --root /absolute/project --profile sql src/queries.ts
+rtk proxy bun run --cwd llm/author-style check --root /absolute/project --lint-only src/service.ts
+rtk proxy bun run --cwd llm/author-style test
+```
+
+For an existing project, follow its own rules and tools first. The verifier refuses a selected file when it finds a native `biome.json` or `biome.jsonc` in its directory or an ancestor. If another formatter is authoritative and its lint policy is compatible, select `--lint-only` to omit personal formatting and spacing. If the existing lint policy conflicts, follow the project and record the difference. The verifier does not select or replace an ESLint, Prettier or other configuration on its own. Native Biome warnings, including an oversized selected file, cause a failed check. A native failure prevents the supplementary checks from running. Resolve the reported cause and rerun the same selection.
+
+Record the selected paths and result in the normal verification evidence. Add this instruction to the adopting agent's entry point or shared verification instructions. Every agent should run the same command after a code edit batch and before delivery. The package installs no editor, Git, CI or model-specific hook.
+
+For an agent-only rule confirmed by project review, keep its configuration in a project-owned path such as `llm/harness-local/biome-agent.json`. Set `linter.rules.recommended` to false and add the scoped rules and project-owned plugins. Run the same checker with `--project-config llm/harness-local/biome-agent.json` and explicit authored paths. The checker runs the pinned profile first, followed by a separate lint pass for the local configuration. Use the corresponding `--profile` when its supplementary checks apply. A project-wide Biome configuration keeps its native command.
+
+> After each code edit batch and before handoff, run the project's applicable Biome checks. When no applicable Biome configuration exists, run the compatible profile in `llm/author-style/README.md` on the edited TypeScript files. Use the project's established formatter and lint policy first. Record the result with the other verification evidence.
+
+## Evidence and precedence
+
+Use the target project rules where established. Document and test a mechanical correction before changing a shared rule.

package/payload/author-style/biome-core.json

@@ -0,0 +1,57 @@
+{
+  "root": true,
+  "plugins": [
+    "./plugins/class-member-order.grit",
+    "./plugins/explicit-arrow-body.grit",
+    "./plugins/explicit-source-constructs.grit"
+  ],
+  "formatter": {
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineEnding": "lf",
+    "lineWidth": 120
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "jsxQuoteStyle": "double",
+      "quoteProperties": "asNeeded",
+      "trailingCommas": "all",
+      "semicolons": "always",
+      "arrowParentheses": "always",
+      "bracketSameLine": false,
+      "bracketSpacing": true
+    }
+  },
+  "assist": {
+    "enabled": false
+  },
+  "linter": {
+    "rules": {
+      "recommended": false,
+      "correctness": {
+        "noUnusedImports": "error",
+        "noUnusedPrivateClassMembers": "error",
+        "noUnusedVariables": "error"
+      },
+      "nursery": {
+        "noFloatingPromises": "error",
+        "noMisusedPromises": "error",
+        "noUnsafeTypeAssertion": "error"
+      },
+      "style": {
+        "noNonNullAssertion": "error",
+        "useBlockStatements": "error",
+        "useConsistentMemberAccessibility": {
+          "level": "error",
+          "options": { "accessibility": "explicit" }
+        },
+        "useImportType": "error"
+      },
+      "suspicious": {
+        "noExplicitAny": "error",
+        "noTsIgnore": "error"
+      }
+    }
+  }
+}

package/payload/author-style/biome-react.json

@@ -0,0 +1,9 @@
+{
+  "extends": ["./biome-core.json"],
+  "plugins": [
+    "./plugins/class-member-order.grit",
+    "./plugins/react-arrow-body.grit",
+    "./plugins/explicit-source-constructs.grit",
+    "./plugins/event-handler-names.grit"
+  ]
+}

package/payload/author-style/biome-sql.json

@@ -0,0 +1,9 @@
+{
+  "extends": ["./biome-core.json"],
+  "plugins": [
+    "./plugins/class-member-order.grit",
+    "./plugins/explicit-arrow-body.grit",
+    "./plugins/explicit-source-constructs.grit",
+    "./plugins/sql-style.grit"
+  ]
+}

package/payload/author-style/bun.lock

@@ -0,0 +1,37 @@
+{
+  "lockfileVersion": 2,
+  "configVersion": 0,
+  "workspaces": {
+    "": {
+      "name": "harness-author-style",
+      "devDependencies": {
+        "@biomejs/biome": "2.5.15",
+        "typescript": "5.9.3",
+        "zod": "4.6.7",
+      },
+    },
+  },
+  "packages": {
+    "@biomejs/biome": ["@biomejs/biome@2.5.15", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "2.5.15", "@biomejs/cli-darwin-x64": "2.5.15", "@biomejs/cli-linux-arm64": "2.5.15", "@biomejs/cli-linux-arm64-musl": "2.5.15", "@biomejs/cli-linux-x64": "2.5.15", "@biomejs/cli-linux-x64-musl": "2.5.15", "@biomejs/cli-win32-arm64": "2.5.15", "@biomejs/cli-win32-x64": "2.5.15" }, "bin": { "biome": "bin/biome" } }, "sha512-WZTW4slm/pdkh92K6t/3aEN++44JD1PQ7squ7RCMLI1flHGl43DVOIGXvCjHiZgBMO1V4uYxoFNtqrIA4qGuIQ=="],
+
+    "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@2.5.15", "", { "os": "darwin", "cpu": "arm64" }, "sha512-BZVzFhJ/mUvTLMYbc9x6el0o2Uv5zP7bACYyhFb6fSc1giroXm7PL0a5KqMJ9F+/BnkYRjagD/ROSDVOZ6eapg=="],
+
+    "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@2.5.15", "", { "os": "darwin", "cpu": "x64" }, "sha512-V5Kw63V+fVGNFhFrizDxMbGXAzZCh8kYzJpy3GI6gTapWDg7bZK9oYC9CbVgQSEdTnupz0U5Efz8Ev+5vdBBXw=="],
+
+    "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@2.5.15", "", { "os": "linux", "cpu": "arm64" }, "sha512-XaG7P7eeSLYETD3K9grfB0mQmpLQZjygdbsxekWBJAg4am79fGAtRpfRyNnTvXB2fZFNnJZG3nXm7HBat0+VUw=="],
+
+    "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@2.5.15", "", { "os": "linux", "cpu": "arm64" }, "sha512-tGzZUTcJCV7tj5Adh/Gn6nR4MycqA3iohq2LEcrarAgRBkU0h0OKd2UzCRkOsOYOuUGaUJb4YmqRqyy2feGGSw=="],
+
+    "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@2.5.15", "", { "os": "linux", "cpu": "x64" }, "sha512-xE4iEW/3LqlYj9GFgGrFsFSH51dEEpUbYWBfeOv0q87WkUDxK2o/HhreSb7qMJqck70RVM6Lg96hgedcAYcOkA=="],
+
+    "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@2.5.15", "", { "os": "linux", "cpu": "x64" }, "sha512-IlxUcyxilVGPsE008x13pWdkTbU3nQpP2i9b5UrbOYj6goBkKsRX1XB7yJLcV+O1H9LBchIIm4adOaVLZBX0ZQ=="],
+
+    "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@2.5.15", "", { "os": "win32", "cpu": "arm64" }, "sha512-2kPKzhNlm8C+Ru3GcO0Me2ODkCBLrVOUNuyi84RJyWDVKAA4+Kjj3jMjL938lF6BRfvltC4vB2nPY9SvN51Ovg=="],
+
+    "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@2.5.15", "", { "os": "win32", "cpu": "x64" }, "sha512-yAzh4UqEImV6Hcy0zjUqNfJAsUhoD64FBQCdTG8Md/Z2wQeVP/ZmJ3XRYAs1g8J9fjTFyl2fCtc5FB5til47+g=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "zod": ["zod@4.6.7", "", {}, "sha512-g8W2D2kU6a8untc053fX1uVBKzM7yqAxW/3zwk83+6RyF2+SKOuV+c0wBDhUwzV1PaGapmZH+rmcUzPf+3CGwg=="],
+  }
+}

package/payload/author-style/check.llm.md

@@ -0,0 +1,17 @@
+# Author style checker map
+
+- [Inputs and project authority](#inputs-and-project-authority)
+- [Native and parser checks](#native-and-parser-checks)
+- [Verification and recovery](#verification-and-recovery)
+
+## Inputs and project authority
+
+Start in `check.ts` at `checkFiles`. The request schema describes the project root, selected files, profile and mode. `targetRelativePath` establishes containment and `configuredBiome` detects local Biome configuration. See [install and run](README.md#install-and-run) for adoption, supported files and exclusions.
+
+## Native and parser checks
+
+The `configurations` map selects the isolated Biome configuration. The checker uses the locked package, clears `BIOME_BINARY`, and starts Bun without dotenv loading or automatic installs. It propagates the native status. `findSourcePolicyIssues`, `findSpacingIssues`, `findMemberSpacingIssues` and `findReactModuleIssues` inspect the selected source without writing. The [check matrix](README.md#deterministic-checks) lists supported patterns and separate review boundaries.
+
+## Verification and recovery
+
+`check.test.ts` covers installation layout, native and project authority checks, selected inputs and supplementary results. The individual parser test files cover exact constructs and boundaries. See [install and run](README.md#install-and-run) for the test command. Do not treat a skipped, failed or interrupted check as evidence that selected code passed.

package/payload/author-style/check.test.llm.md

@@ -0,0 +1,17 @@
+# Checker integration test map
+
+- [Installed layout and source selection](#installed-layout-and-source-selection)
+- [Native profiles and policy](#native-profiles-and-policy)
+- [Failure paths](#failure-paths)
+
+## Installed layout and source selection
+
+`runs when the profile is installed under the adopting project llm directory` covers private configuration discovery. `uses the isolated formatter and linter on exact paths outside the harness without writing` covers exact file names, unselected files and byte preservation.
+
+## Native profiles and policy
+
+`enforces core types, explicit updates, braces, branches and class layout` exercises the real engine and a rejected environment override. `uses the pinned Biome launcher when the target dotenv defines another binary` covers Bun subprocess isolation. `uses separately selected React and tagged SQL checks` distinguishes profile findings from the common configuration.
+
+## Failure paths
+
+`fails a mixed selection when Biome cannot check an oversized file` protects against partial checks reported as success. `refuses existing configurations, generated files, symlinks and an empty file selection` checks scope and authority. Supplementary parser cases have their own focused test files.

package/payload/author-style/check.test.ts

@@ -0,0 +1,264 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { cpSync, mkdirSync, mkdtempSync, readFileSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { test } from 'node:test';
+import { fileURLToPath } from 'node:url';
+
+const checker = fileURLToPath(new URL('check.ts', import.meta.url));
+
+function executeFrom(entry: string, root: string, args: string[], env = process.env) {
+  const result = spawnSync(process.execPath, [entry, '--root', root, ...args], { encoding: 'utf8', env });
+
+  if (result.error) {
+    throw result.error;
+  }
+
+  return result;
+}
+
+function execute(root: string, ...args: string[]) {
+  return executeFrom(checker, root, args);
+}
+
+test('runs when the profile is installed under the adopting project llm directory', (context) => {
+  const root = mkdtempSync(join(tmpdir(), 'harness-style-'));
+
+  context.after(() => rmSync(root, { recursive: true, force: true }));
+
+  const profile = join(root, 'llm', 'author-style');
+
+  mkdirSync(profile, { recursive: true });
+
+  const packageDirectory = fileURLToPath(new URL('.', import.meta.url));
+
+  for (const file of [
+    'check.ts',
+    'source-policy.ts',
+    'spacing.ts',
+    'member-spacing.ts',
+    'react-module.ts',
+    'package.json',
+    'biome-core.json',
+    'plugins',
+  ]) {
+    cpSync(join(packageDirectory, file), join(profile, file), { recursive: true });
+  }
+
+  symlinkSync(join(packageDirectory, 'node_modules'), join(profile, 'node_modules'), 'dir');
+  writeFileSync(join(root, 'entry.ts'), 'export const sample = true;\n');
+
+  const result = executeFrom(join(profile, 'check.ts'), root, ['entry.ts']);
+
+  assert.equal(result.status, 0, result.stderr);
+  assert.match(result.stdout, /Checked 1 file/);
+});
+
+test('uses the isolated formatter and linter on exact paths outside the harness without writing', (context) => {
+  const root = mkdtempSync(join(tmpdir(), 'harness-style-'));
+
+  context.after(() => rmSync(root, { recursive: true, force: true }));
+
+  const clean = join(root, 'has spaces.ts');
+  const poorlyFormatted = "export const label='one'\n";
+
+  writeFileSync(clean, poorlyFormatted);
+  writeFileSync(join(root, 'unselected.ts'), 'export const counter: any = 0;\n');
+
+  const failure = execute(root, 'has spaces.ts');
+
+  assert.equal(failure.status, 1);
+  assert.match(failure.stderr, /Formatter would have printed/);
+  assert.equal(readFileSync(clean, 'utf8'), poorlyFormatted);
+
+  const lintOnly = execute(root, '--lint-only', 'has spaces.ts');
+
+  assert.equal(lintOnly.status, 0, lintOnly.stderr);
+
+  writeFileSync(clean, 'export const label = `line\n// @generated\nline`;\n');
+
+  const success = execute(root, clean);
+
+  assert.equal(success.status, 0, success.stderr);
+  assert.match(success.stdout, /Checked 1 file/);
+});
+
+test('checks learned project rules in isolation and keeps adjacent unselected files out of scope', (context) => {
+  const root = mkdtempSync(join(tmpdir(), 'harness-style-'));
+  const directory = join(root, 'llm');
+  const profile = fileURLToPath(new URL('biome-core.json', import.meta.url));
+
+  context.after(() => rmSync(root, { recursive: true, force: true }));
+  mkdirSync(directory);
+  writeFileSync(
+    join(directory, 'review.json'),
+    JSON.stringify({ linter: { rules: { recommended: false, suspicious: { noConsole: 'error' } } } }),
+  );
+  writeFileSync(join(root, 'good.ts'), 'export const value = 1;\n');
+  writeFileSync(join(root, 'bad.ts'), "console.log('noise');\n");
+
+  const good = execute(root, '--project-config', 'llm/review.json', 'good.ts');
+  const bad = execute(root, '--project-config', 'llm/review.json', 'bad.ts');
+
+  assert.equal(good.status, 0, good.stderr);
+  assert.equal(bad.status, 1);
+  assert.match(bad.stderr, /noConsole/u);
+  assert.equal(execute(root, 'bad.ts').status, 0);
+  assert.match(execute(root, '--project-config', profile, 'good.ts').stderr, /inside/u);
+  symlinkSync('review.json', join(directory, 'alias.json'));
+  assert.match(execute(root, '--project-config', 'llm/alias.json', 'good.ts').stderr, /project-owned/u);
+});
+
+test('enforces core types, explicit updates, braces, branches and class layout', (context) => {
+  const root = mkdtempSync(join(tmpdir(), 'harness-style-'));
+
+  context.after(() => rmSync(root, { recursive: true, force: true }));
+
+  writeFileSync(
+    join(root, 'shape.ts'),
+    [
+      'export class Selection {',
+      '  public choose(flag: boolean): number {',
+      '    let count = 1;',
+      '    if (flag) count++;',
+      '    return count;',
+      '  }',
+      '  public static create(): Selection {',
+      '    return new Selection();',
+      '  }',
+      '}',
+      'export const resolve = (value: boolean): string => (value ? "a" : "b");',
+      'export const loose: any = 1;',
+      'export const ambiguous: unknown = 2;',
+    ].join('\n'),
+  );
+
+  const result = executeFrom(checker, root, ['--lint-only', 'shape.ts'], {
+    ...process.env,
+    BIOME_BINARY: process.execPath,
+  });
+
+  assert.equal(result.status, 1);
+  assert.match(result.stderr, /Use an explicit update/);
+  assert.match(result.stderr, /useBlockStatements/);
+  assert.match(result.stderr, /explicit return/);
+  assert.match(result.stderr, /class member order/i);
+  assert.match(result.stderr, /noExplicitAny/);
+  assert.match(result.stderr, /Use an explicit domain type/);
+});
+
+test('uses the pinned Biome launcher when the target dotenv defines another binary', (context) => {
+  const root = mkdtempSync(join(tmpdir(), 'harness-style-'));
+
+  context.after(() => rmSync(root, { recursive: true, force: true }));
+
+  writeFileSync(join(root, '.env'), `BIOME_BINARY=${process.execPath}\n`);
+  writeFileSync(join(root, 'entry.ts'), 'export const sample = true;\n');
+
+  const result = execute(root, 'entry.ts');
+
+  assert.equal(result.status, 0, result.stderr);
+  assert.match(result.stdout, /Checked 1 file/);
+});
+
+test('uses separately selected React and tagged SQL checks', (context) => {
+  const root = mkdtempSync(join(tmpdir(), 'harness-style-'));
+
+  context.after(() => rmSync(root, { recursive: true, force: true }));
+
+  writeFileSync(join(root, 'Panel.tsx'), 'export default function Panel() { return <p>Hello</p>; }\n');
+  writeFileSync(join(root, 'Card.tsx'), 'const Card = () => <p>Hello</p>;\nexport default Card;\n');
+  writeFileSync(join(root, 'helper.ts'), 'export const UppercaseHelper = () => 1;\n');
+  writeFileSync(
+    join(root, 'query.ts'),
+    'export const find = (sql: (strings: TemplateStringsArray) => string) => sql`select id from records`;\n',
+  );
+
+  const core = execute(root, '--lint-only', 'Panel.tsx', 'query.ts');
+
+  assert.equal(core.status, 0, core.stderr);
+
+  const react = execute(root, '--profile', 'react', '--lint-only', 'Panel.tsx');
+
+  assert.equal(react.status, 1);
+  assert.match(react.stderr, /named const component/);
+
+  const arrow = execute(root, '--profile', 'react', '--lint-only', 'Card.tsx');
+
+  assert.equal(arrow.status, 1);
+  assert.match(arrow.stderr, /Annotate React arrow components/);
+
+  const helper = execute(root, '--profile', 'react', '--lint-only', 'helper.ts');
+
+  assert.equal(helper.status, 0, helper.stderr);
+
+  writeFileSync(
+    join(root, 'event.tsx'),
+    'export const view = <button onClick={() => { console.log("clicked"); }}>Go</button>;\n',
+  );
+
+  const plainEvent = execute(root, '--lint-only', 'event.tsx');
+
+  assert.equal(plainEvent.status, 0, plainEvent.stderr);
+
+  const reactEvent = execute(root, '--profile', 'react', '--lint-only', 'event.tsx');
+
+  assert.equal(reactEvent.status, 1);
+  assert.match(reactEvent.stderr, /inline JSX handler as one call expression/);
+
+  const sql = execute(root, '--profile', 'sql', '--lint-only', 'query.ts');
+
+  assert.equal(sql.status, 1);
+  assert.match(sql.stderr, /SQL keywords/i);
+});
+
+test('fails a mixed selection when Biome cannot check an oversized file', (context) => {
+  const root = mkdtempSync(join(tmpdir(), 'harness-style-'));
+
+  context.after(() => rmSync(root, { recursive: true, force: true }));
+  writeFileSync(join(root, 'small.ts'), 'export const sample = true;\n');
+  writeFileSync(join(root, 'large.ts'), `export const sample = '${'a'.repeat(1024 * 1024)}';\n`);
+
+  const result = execute(root, '--lint-only', 'small.ts', 'large.ts');
+
+  assert.equal(result.status, 1);
+  assert.match(result.stderr, /exceeds the configured maximum/);
+});
+
+test('refuses existing configurations, generated files, symlinks and an empty file selection', (context) => {
+  const root = mkdtempSync(join(tmpdir(), 'harness-style-'));
+
+  context.after(() => rmSync(root, { recursive: true, force: true }));
+
+  mkdirSync(join(root, 'app'));
+  writeFileSync(join(root, 'app', 'biome.jsonc'), '{}\n');
+  writeFileSync(join(root, 'app', 'module.ts'), 'export const sample = true;\n');
+  writeFileSync(join(root, 'generated.ts'), '// @generated\nexport const sample = true;\n');
+  symlinkSync(join(root, 'generated.ts'), join(root, 'linked.ts'));
+
+  const expected = [
+    { files: ['app/module.ts'], message: /project's configured Biome checks/ },
+    { files: ['generated.ts'], message: /instead of a generated artifact/ },
+    { files: ['linked.ts'], message: /instead of a symbolic link/ },
+    { files: ['../outside.ts'], message: /inside/ },
+    { files: [], message: /Supply the files you changed/ },
+  ];
+
+  for (const { files, message } of expected) {
+    const result = execute(root, ...files);
+
+    assert.equal(result.status, 1);
+    assert.match(result.stderr, message);
+  }
+
+  const child = join(root, 'app', 'child');
+
+  mkdirSync(child);
+  writeFileSync(join(child, 'module.ts'), 'export const sample = true;\n');
+
+  const parentConfiguration = execute(child, 'module.ts');
+
+  assert.equal(parentConfiguration.status, 1);
+  assert.match(parentConfiguration.stderr, /project's configured Biome checks/);
+});