=============== LIBRARY RULES =============== From library maintainers: - For an existing repository, start with npx @diffci.com/diffci@latest check or use observe --no-send for analysis without test execution. - Keep required CI tests authoritative; a selected command or SKIP_CANDIDATE is advisory. - Treat REFUSED, ERROR, incomplete evidence, and unsupported configuration as reasons to run the repository's normal full tests. ### Clone, build, test, and run DiffCI Core locally Source: https://github.com/diffci/core/blob/main/README.md Clones the repository, installs dependencies, builds, runs tests, and executes a plan command. Requires Git and Node.js 22.5 or later. The target must be a clean Git repository root checked out at --head; fetch the base commit beforehand if using a shallow clone. JSON goes to stdout; analysis errors exit nonzero and recommend full CI. ```sh git clone https://github.com/DiffCI/core.git cd core npm ci npm run build npm test node dist/cli.js plan --repo /path/to/clean-checkout --base HEAD~1 --head HEAD ``` -------------------------------- ### Run DiffCI check command Source: https://github.com/diffci/core/blob/main/docs/using-diffci.md Run the DiffCI check command from the root of an existing Git checkout with Git and Node.js 22.5 or later installed. It analyzes the checkout, infers the full test command, and runs full and proposed selected commands when safe to compare, reporting measured paired runtime only when both commands pass. ```sh npx @diffci.com/diffci@latest check ``` -------------------------------- ### Run typecheck, audit, and benchmark scripts Source: https://github.com/diffci/core/blob/main/README.md Runs the typecheck, audit:boundary, and benchmark npm scripts. The benchmark constructs 100 modules and 100 tests locally and measures three graph builds; it does not measure CI savings. Carbon and energy outputs are modeled estimates using caller-supplied assumptions, not physical measurements or verified avoided emissions. ```sh npm run typecheck npm run audit:boundary npm run benchmark ``` -------------------------------- ### Configure Maven goal and profiles in diffci.json Source: https://github.com/diffci/core/blob/main/README.md Declares a Maven lifecycle goal and profiles for CI jobs that run other than the default 'test' goal. This changes the proposed command, such as 'mvn -pl tools -am verify -P run-its'; Core still does not run it. Confirm the command against the repository's CI workflow before using it for execution. ```json { "maven": { "goal": "verify", "profiles": ["run-its"] } } ``` -------------------------------- ### Run DiffCI check command in PowerShell Source: https://github.com/diffci/core/blob/main/docs/using-diffci.md On Windows PowerShell, quote the package name to run the DiffCI check command. This is the PowerShell equivalent of the standard npx invocation. ```powershell npx '@diffci.com/diffci@latest' check ``` -------------------------------- ### Analyze without running tests using observe --no-send Source: https://github.com/diffci/core/blob/main/docs/using-diffci.md Run DiffCI in observe mode without sending a report. It reports selected tests, fallback reasons, and command availability without executing the repository's tests or sending a report. It does not establish runtime savings. ```sh npx @diffci.com/diffci@latest observe --no-send ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.