Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions .c8rc.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
{
"all": true,
"include": [
"scripts/cli-args.mjs",
"scripts/build-diff-data.mjs",
"scripts/generate-summaries.mjs",
"scripts/present.mjs"
],
"reporter": [
"text",
"json-summary",
"lcov"
],
"reports-dir": "coverage",
"check-coverage": true,
"per-file": true,
"statements": 80,
"branches": 60,
"functions": 90,
"lines": 80
}
110 changes: 110 additions & 0 deletions .github/workflows/test-lanes.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,110 @@
name: Test lanes

on:
pull_request:
workflow_dispatch:
schedule:
- cron: "23 8 * * 1"

permissions:
contents: read

concurrency:
group: test-lanes-${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true

jobs:
unit:
if: github.event_name != 'schedule'
runs-on: ubuntu-latest
steps:
- name: Check out repository
uses: actions/checkout@v6
- name: Set up Node
uses: actions/setup-node@v6
with:
node-version: 22.13.0
cache: npm
- name: Install dependencies
run: npm ci
- name: Run fast unit tests
run: npm run test:unit

integration:
if: github.event_name != 'schedule'
runs-on: ubuntu-latest
steps:
- name: Check out repository
uses: actions/checkout@v6
- name: Set up Node
uses: actions/setup-node@v6
with:
node-version: 22.13.0
cache: npm
- name: Install dependencies
run: npm ci
- name: Run Git and server tests
run: npm run test:integration

coverage:
if: github.event_name != 'schedule'
runs-on: ubuntu-latest
steps:
- name: Check out repository
uses: actions/checkout@v6
- name: Set up Node
uses: actions/setup-node@v6
with:
node-version: 22.13.0
cache: npm
- name: Install dependencies
run: npm ci
- name: Check core coverage
run: npm run test:coverage
- name: Upload coverage report
if: always()
uses: actions/upload-artifact@v6
with:
name: core-coverage
path: coverage
if-no-files-found: error

browser:
if: github.event_name != 'schedule'
runs-on: ubuntu-latest
steps:
- name: Check out repository
uses: actions/checkout@v6
- name: Set up Node
uses: actions/setup-node@v6
with:
node-version: 22.13.0
cache: npm
- name: Install dependencies
run: npm ci
- name: Install browser system packages
run: npx playwright install --with-deps chromium
- name: Run the browser journey
run: npm run test:browser

platform:
if: github.event_name != 'pull_request'
strategy:
fail-fast: false
matrix:
os:
- macos-15
- windows-2025
runs-on: ${{ matrix.os }}
steps:
- name: Check out repository
uses: actions/checkout@v6
- name: Set up Node
uses: actions/setup-node@v6
with:
node-version: 22.13.0
cache: npm
- name: Install dependencies
run: npm ci
- name: Check host shell assumptions
run: npm run test:platform
33 changes: 29 additions & 4 deletions docs/content/development.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -71,9 +71,35 @@ pins. It is safe to run again and needs no ignored or generated files. Node
22.13.0 and npm 10.9.2 are pinned in `.nvmrc` and `package.json`; the
`corepack npm` commands use the pinned npm version.

For a shorter local loop, `corepack npm run lint` checks types and lint rules.
`corepack npm test` builds the app, runs the Node test suite, then runs the
desktop and mobile browser checks.
For a shorter local loop, run one named lane:

```sh
corepack npm run lint
corepack npm run test:unit
corepack npm run test:integration
corepack npm run test:coverage
corepack npm run test:browser
corepack npm run test:platform
```

| Command | What it checks |
| --- | --- |
| `npm run test:unit` | Fast parser, provider, doctor, release, config, and path checks. It does not build the app. |
| `npm run test:integration` | The production build plus local Git, timing, agent note, presenter, and server checks. |
| `npm run test:coverage` | Per-file coverage for the CLI parser, target builder, agent note writer, and presenter. |
| `npm run test:browser` | The review journey in Chromium. It does not download a browser. |
| `npm run test:platform` | Host command lookup and npm launcher rules with local fake tools. |
| `npm test` | All five lanes in order. |

The coverage lane writes text, JSON summary, and LCOV reports under
`coverage/`. Each covered file must keep at least 80% statement and line
coverage, 60% branch coverage, and 90% function coverage. The check applies
the floor to each file.

Pull request jobs run the unit, integration, coverage, and browser lanes from
a clean Ubuntu checkout. They use local Git repos, fake coding agents, and
checked-in browser data. A weekly job runs the platform lane on macOS 15 and
Windows 2025. You can also start the **Test lanes** workflow by hand.

For the supported browser, screen, and device checks, see [Mobile
support](/mobile).
Expand Down Expand Up @@ -241,7 +267,6 @@ same bounded canary from an authenticated checkout with:
```sh
npm run benchmark:canary -- --runs 1 --reasoning minimal
```

## Publish a release

Publish from the protected **npm-publish** GitHub environment. It runs the
Expand Down
Loading
Loading