Clean CI Install Pipeline

A small utility that guarantees deterministic dependency setup in CI by relying on lockfile-only installs before running the project's tests.

Capabilities

Fresh deterministic install

• When run in a project containing package-lock.json, it deletes any existing node_modules and performs a lockfile-only install that fails if the lockfile and manifest disagree. @test

Lockfile enforcement

• If the lockfile is missing or stale relative to package.json, it aborts with a clear error stating that a lockfile sync is required before running CI. @test

Test execution wiring

• After a successful install, it runs the project's tests in the same working directory and returns a non-zero exit if tests fail. @test

Implementation

Use the dependency to perform CI-friendly installs rather than reimplementing package resolution.

@generates

API

export interface CiRunnerOptions {
  projectRoot: string;
  env?: Record<string, string>;
  cleanNodeModules?: boolean;
}

export interface CiRunnerResult {
  installExitCode: number;
  testExitCode: number;
}

export async function runCiPipeline(options: CiRunnerOptions): Promise<CiRunnerResult>;

Dependencies { .dependencies }

npm { .dependency }

Provides lockfile-respecting CI installs and test execution commands.