@blzsky/variant 0.2.0 → 0.3.0-canary.0

package/dist/cli.js

@@ -4,14 +4,14 @@ import {
   resolveColorChoice,
   writeGlobalColorChoice
 } from "./chunk-YYGCSKIQ.js";
-import {
-  CliUsageError,
-  VariantError
-} from "./chunk-RVXUCJYA.js";
 import {
   Printer,
   setGlobalPrinter
-} from "./chunk-V22IPJ7A.js";
+} from "./chunk-EISTWXDW.js";
+import {
+  CliUsageError,
+  VariantError
+} from "./chunk-ACTY42RE.js";
 
 // src/cli/index.ts
 import { readFileSync } from "fs";
@@ -120,35 +120,41 @@ var program = new Command().name("variant").description(
 });
 var impactCmd = program.command("impact").description(
   "Predict which tests a change requires \u2014 report-only; the full suite should still run"
-).option("--base <ref>", "git ref to compare against", "HEAD~1").option("--json", "output the report as JSON").action(async (opts) => {
-  const { registerImpactAction } = await import("./impact-AF453PLK.js");
+).option(
+  "--base <ref>",
+  "git ref to compare against (default: detected from git and CI)"
+).option(
+  "--head-sha <sha>",
+  "record the prediction against this commit instead of HEAD"
+).option("--json", "output the report as JSON").action(async (opts) => {
+  const { registerImpactAction } = await import("./impact-DPZIAJR4.js");
   await registerImpactAction({
-    base: opts.base,
+    ...opts.base !== void 0 && { base: opts.base },
+    ...opts.headSha !== void 0 && { headSha: opts.headSha },
+    ...opts.json === true && { json: true }
+  });
+});
+impactCmd.command("verify <report...>").description(
+  "Reconcile a logged prediction against one or more Vitest/Jest JSON reports \u2014 reports false skips"
+).option("--head-sha <sha>", "reconcile the prediction made at this commit").option("--json", "output the reconciliation as JSON").action(async (reports, _opts, command) => {
+  const { registerImpactVerifyAction } = await import("./impact-DPZIAJR4.js");
+  const opts = command.optsWithGlobals();
+  await registerImpactVerifyAction(reports, {
+    ...opts.headSha !== void 0 && { headSha: opts.headSha },
     ...opts.json === true && { json: true }
   });
 });
-impactCmd.command("verify <report>").description(
-  "Reconcile a logged prediction against a Vitest/Jest JSON report \u2014 reports false skips"
-).option("--head-sha <sha>", "reconcile the prediction made at this commit").option("--json", "output the reconciliation as JSON").action(
-  async (report, opts) => {
-    const { registerImpactVerifyAction } = await import("./impact-AF453PLK.js");
-    await registerImpactVerifyAction(report, {
-      ...opts.headSha !== void 0 && { headSha: opts.headSha },
-      ...opts.json === true && { json: true }
-    });
-  }
-);
 program.command("diff <file>").description(
   "Classify a TypeScript file change as non-impacting / internal / breaking"
 ).option("--base <ref>", "git ref to compare against", "HEAD~1").action(async (file, opts) => {
-  const { registerDiffAction } = await import("./diff-GFI6RAEA.js");
+  const { registerDiffAction } = await import("./diff-A3TQWWUJ.js");
   await registerDiffAction(file, { base: opts.base });
 });
 var workspaceCmd = program.command("workspace").description("Workspace-level analysis commands");
 workspaceCmd.command("check").description(
   "Detect packages importing dependencies they do not declare (CI gate: exits 1 on violations)"
 ).option("--json", "output the result as JSON").action(async (opts) => {
-  const { registerWorkspaceCheckAction } = await import("./workspace-X5FUBTY3.js");
+  const { registerWorkspaceCheckAction } = await import("./workspace-PIQXG4ZD.js");
   await registerWorkspaceCheckAction({
     ...opts.json === true && { json: true }
   });
@@ -156,14 +162,28 @@ workspaceCmd.command("check").description(
 var prCmd = program.command("pr").description("PR-aware analysis commands");
 prCmd.command("check").description(
   "Classify all TypeScript changes in this PR and report a build verdict"
-).option("--base <ref>", "base branch or ref for the PR diff", "main").action(async (opts) => {
-  const { registerPrCheckAction } = await import("./pr-UFZRZX6S.js");
-  await registerPrCheckAction({ base: opts.base });
+).option(
+  "--base <ref>",
+  "base branch or ref for the PR diff (default: the target or default branch)"
+).action(async (opts) => {
+  const { registerPrCheckAction } = await import("./pr-6CYMM2XU.js");
+  await registerPrCheckAction({
+    ...opts.base !== void 0 && { base: opts.base }
+  });
 });
-prCmd.command("report").description("Render `pr check` as a structured JSON or markdown report").option("--base <ref>", "base branch or ref for the PR diff", "main").option("--markdown", "output a markdown summary instead of JSON").option("--output <file>", "write report to file instead of stdout").action(
+prCmd.command("report").description(
+  "Describe what this PR changes and what must be verified before it merges"
+).option(
+  "--base <ref>",
+  "base branch or ref for the PR diff (default: the target or default branch)"
+).option("--markdown", "output a markdown summary instead of JSON").option("--output <file>", "write report to file instead of stdout").action(
   async (opts) => {
-    const { registerPrReportAction } = await import("./pr-UFZRZX6S.js");
-    await registerPrReportAction(opts);
+    const { registerPrReportAction } = await import("./pr-6CYMM2XU.js");
+    await registerPrReportAction({
+      ...opts.base !== void 0 && { base: opts.base },
+      ...opts.markdown === true && { markdown: true },
+      ...opts.output !== void 0 && { output: opts.output }
+    });
   }
 );
 program.command("build").description("Run the build task").option("-c, --concurrency <n>", "max tasks per DAG level").option(
@@ -171,7 +191,7 @@ program.command("build").description("Run the build task").option("-c, --concurr
   "run only packages affected by changes since baseRef (includes cascade dependents)"
 ).option("--dry-run", "print the task plan without executing").action(
   async (opts) => {
-    const { registerBuildAction } = await import("./build-2LO7GD2S.js");
+    const { registerBuildAction } = await import("./build-GKWNLU4Q.js");
     const concurrency = parseConcurrency(opts);
     await registerBuildAction({
       ...concurrency !== void 0 && { concurrency },
@@ -185,7 +205,7 @@ program.command("run <task>").description("Run a named task").option(
   "max tasks to run concurrently per DAG level"
 ).option("--dry-run", "print the task plan without executing").action(
   async (taskName, opts) => {
-    const { registerRunAction } = await import("./run-6PNH4QRA.js");
+    const { registerRunAction } = await import("./run-44PKMOV5.js");
     const concurrency = parseConcurrency(opts);
     await registerRunAction(taskName, {
       ...concurrency !== void 0 && { concurrency },
@@ -193,28 +213,47 @@ program.command("run <task>").description("Run a named task").option(
     });
   }
 );
-program.command("init").description("Scaffold variant.config.ts in the current directory").action(async () => {
-  const { registerInitAction } = await import("./init-KJIUNGAN.js");
-  await registerInitAction();
-});
+program.command("init").description(
+  "Set variant up in this repository: detect how it is tested, show the changes, apply them"
+).option("--dry-run", "show what would change and stop").option("-y, --yes", "apply without asking").option("--no-install", "do not install @blzsky/variant; print the command").option(
+  "--package <spec>",
+  "install this in place of the running version (a tarball path or a spec)"
+).option("--tasks", "write variant.config.ts for the task runner instead").action(
+  async (opts) => {
+    const { registerInitAction } = await import("./init-VNK5E4H3.js");
+    await registerInitAction({
+      version: _pkg.version,
+      ...opts.dryRun === true && { dryRun: true },
+      ...opts.yes === true && { yes: true },
+      ...opts.install === false && { install: false },
+      ...opts.package !== void 0 && { package: opts.package },
+      ...opts.tasks === true && { tasks: true }
+    });
+  }
+);
 program.command("doctor").description("Validate config and diagnose common issues").action(async () => {
-  const { registerDoctorAction } = await import("./doctor-GH4RZVEH.js");
+  const { registerDoctorAction } = await import("./doctor-6ONS6LKY.js");
   await registerDoctorAction();
 });
 program.command("insight").description("Show task timing and cache hit stats").action(async () => {
-  const { registerInsightAction } = await import("./insight-DZ5NQY6D.js");
+  const { registerInsightAction } = await import("./insight-LNYVMCAE.js");
   await registerInsightAction();
 });
 program.command("env").description(
   "Show detected environment (runtime, package manager, framework)"
 ).action(async () => {
-  const { registerEnvAction } = await import("./env-QORDD6FQ.js");
+  const { registerEnvAction } = await import("./env-XF2US3CB.js");
   await registerEnvAction();
 });
 program.command("check").description("Validate config and task graph (no execution)").action(async () => {
-  const { registerCheckAction } = await import("./check-ZTKGGF4M.js");
+  const { registerCheckAction } = await import("./check-KO5VY67Z.js");
   await registerCheckAction();
 });
+for (const stream of [process.stdout, process.stderr]) {
+  stream.on("error", (error) => {
+    if (error.code !== "EPIPE" && error.code !== "EOF") throw error;
+  });
+}
 program.parseAsync(process.argv).catch((err) => {
   if (err instanceof VariantError) {
     renderError(err);

package/dist/{diff-GFI6RAEA.js → diff-A3TQWWUJ.js}

@@ -2,16 +2,19 @@ import {
   DEFAULT_DIFF_BASE_REF,
   classifyFileAgainstRef,
   toWorkspaceRelative
-} from "./chunk-NSNZOH5P.js";
-import "./chunk-LJDDS4RR.js";
-import "./chunk-XUBWCTJZ.js";
+} from "./chunk-YII4TAKS.js";
+import {
+  assertBaseRef
+} from "./chunk-MAK3HG46.js";
 import {
   lines
 } from "./chunk-6J4XDG44.js";
 import {
   getPrinter
-} from "./chunk-V22IPJ7A.js";
-import "./chunk-O4LZKXNZ.js";
+} from "./chunk-EISTWXDW.js";
+import "./chunk-RSIOYQOQ.js";
+import "./chunk-DSQDMFQ6.js";
+import "./chunk-ACTY42RE.js";
 
 // src/cli/render/diff.ts
 var CLASS_MEANING = {
@@ -50,6 +53,7 @@ async function registerDiffAction(filePath, opts = {}) {
   const cwd = process.cwd();
   const baseRef = opts.base ?? DEFAULT_DIFF_BASE_REF;
   const relPath = toWorkspaceRelative(cwd, filePath);
+  await assertBaseRef(cwd, baseRef);
   renderClassification(
     await classifyFileAgainstRef(cwd, relPath, baseRef),
     baseRef

package/dist/{doctor-GH4RZVEH.js → doctor-6ONS6LKY.js}

@@ -1,17 +1,17 @@
 import {
   findVariantConfigPath,
   loadConfig
-} from "./chunk-RGD422OM.js";
+} from "./chunk-RJBFCURK.js";
 import {
   getColors
 } from "./chunk-YYGCSKIQ.js";
-import "./chunk-RVXUCJYA.js";
 import {
   lines
 } from "./chunk-6J4XDG44.js";
 import {
   getPrinter
-} from "./chunk-V22IPJ7A.js";
+} from "./chunk-EISTWXDW.js";
+import "./chunk-ACTY42RE.js";
 
 // src/core/doctor/diagnostics.ts
 import { readdir, stat } from "fs/promises";
@@ -71,9 +71,9 @@ async function checkConfig(cwd) {
   if (!configPath) {
     return [
       {
-        level: "error",
+        level: "warn",
         label: "No variant.config.ts found",
-        detail: "Run `variant init` to create one."
+        detail: "`impact`, `diff`, `pr` and `workspace check` work without one. `build` and `run` need it: `variant init --tasks` creates one."
       }
     ];
   }

package/dist/{env-QORDD6FQ.js → env-XF2US3CB.js}

@@ -1,18 +1,18 @@
 import {
   renderEnv
-} from "./chunk-ISRF5F3Q.js";
+} from "./chunk-QRPI6TJE.js";
 import {
   createContext
-} from "./chunk-SWPVR2DF.js";
+} from "./chunk-CN25SRKD.js";
 import "./chunk-V5CTGXMM.js";
-import "./chunk-RGD422OM.js";
-import "./chunk-YYGCSKIQ.js";
-import "./chunk-MZZOE7L4.js";
+import "./chunk-RJBFCURK.js";
+import "./chunk-DMDAJPFJ.js";
 import "./chunk-3E5LBU3O.js";
-import "./chunk-RVXUCJYA.js";
-import "./chunk-XUBWCTJZ.js";
+import "./chunk-YYGCSKIQ.js";
 import "./chunk-6J4XDG44.js";
-import "./chunk-V22IPJ7A.js";
+import "./chunk-EISTWXDW.js";
+import "./chunk-RSIOYQOQ.js";
+import "./chunk-ACTY42RE.js";
 
 // src/cli/commands/env.ts
 async function registerEnvAction() {

package/dist/git-W6N3WMYQ.js

@@ -0,0 +1,24 @@
+import {
+  defaultBranchRef,
+  listChangedFiles,
+  listChangedFilesSinceMergeBase,
+  listRepositoryFiles,
+  mergeBase,
+  readFileAtRef,
+  readFilesAtRef,
+  readHeadSha,
+  repositoryRoot,
+  resolveCommit
+} from "./chunk-RSIOYQOQ.js";
+export {
+  defaultBranchRef,
+  listChangedFiles,
+  listChangedFilesSinceMergeBase,
+  listRepositoryFiles,
+  mergeBase,
+  readFileAtRef,
+  readFilesAtRef,
+  readHeadSha,
+  repositoryRoot,
+  resolveCommit
+};

package/dist/impact-DPZIAJR4.js

@@ -0,0 +1,263 @@
+import {
+  predictImpact,
+  verdictText
+} from "./chunk-KCEGA56S.js";
+import "./chunk-IFFZ46YS.js";
+import "./chunk-GDSZFIHM.js";
+import {
+  classificationLabel,
+  plural
+} from "./chunk-CXNXZLDG.js";
+import "./chunk-DMDAJPFJ.js";
+import "./chunk-3E5LBU3O.js";
+import {
+  getColors
+} from "./chunk-YYGCSKIQ.js";
+import {
+  verifyImpact
+} from "./chunk-MT4BOAAV.js";
+import {
+  changeBaseDeps,
+  detectHeadSha
+} from "./chunk-H5C4SE73.js";
+import "./chunk-X3VVGTEV.js";
+import "./chunk-NFFXYYM6.js";
+import "./chunk-MAK3HG46.js";
+import {
+  lines
+} from "./chunk-6J4XDG44.js";
+import {
+  getPrinter
+} from "./chunk-EISTWXDW.js";
+import "./chunk-RSIOYQOQ.js";
+import "./chunk-DSQDMFQ6.js";
+import {
+  NoBaseCommitError
+} from "./chunk-ACTY42RE.js";
+
+// src/cli/render/impact.ts
+var MAX_LISTED_FILES = 20;
+var count = (value) => value.toLocaleString("en-US");
+var NO_PREDICTION_MESSAGE = "impact verify: no logged prediction to reconcile against. Run `variant impact` before the test run, or pass --head-sha for a specific commit.";
+function shortRef(ref) {
+  return /^[0-9a-f]{40}$/.test(ref) ? ref.slice(0, 12) : ref;
+}
+function renderNoBaseCommit(reason, json, printer = getPrinter()) {
+  lines(
+    printer,
+    json ? JSON.stringify(
+      { prediction: null, code: "NO_BASE_COMMIT", reason },
+      null,
+      2
+    ) : `impact: ${reason}; no prediction was made.`
+  );
+}
+function renderImpactJson(report, printer = getPrinter()) {
+  const { result, ...rest } = report;
+  lines(
+    printer,
+    JSON.stringify(
+      { ...rest, radius: result.radius, tests: result.tests },
+      null,
+      2
+    )
+  );
+}
+function renderImpact(report, printer = getPrinter()) {
+  const { radius, tests } = report.result;
+  lines(
+    printer,
+    "",
+    `Base ref: ${shortRef(report.baseRef)}${report.baseLabel === report.baseRef ? "" : ` (${report.baseLabel})`}`,
+    `Workspace: ${report.packagesFound === 0 ? "no workspace packages found" : plural(report.packagesFound, "package")}`,
+    "",
+    `You changed ${plural(radius.changed.length, "file")}.`
+  );
+  for (const impact of radius.changed.slice(0, MAX_LISTED_FILES)) {
+    const symbols = impact.impactedSymbols.length > 0 ? `  (${impact.impactedSymbols.join(", ")})` : "";
+    lines(
+      printer,
+      `  ${classificationLabel(impact.classification)}  ${impact.filePath}${symbols}`
+    );
+  }
+  if (radius.changed.length > MAX_LISTED_FILES) {
+    lines(
+      printer,
+      `  \u2026 and ${count(radius.changed.length - MAX_LISTED_FILES)} more`
+    );
+  }
+  const packages = radius.affectedPackages.length > 0 ? `, ${plural(radius.affectedPackages.length, "package")} (${radius.affectedPackages.join(", ")})` : "";
+  lines(
+    printer,
+    "",
+    `Impact: ${plural(radius.affectedFiles.length, "file")}${packages}`
+  );
+  const skipped = tests.totalTests - tests.affectedTests.length;
+  lines(
+    printer,
+    "",
+    `Run:   ${plural(tests.affectedTests.length, "test file")}`,
+    `Skip:  ${plural(skipped, "test file")} (of ${count(tests.totalTests)} total)`
+  );
+  if (tests.unreached.length > 0) {
+    const listed = tests.unreached.slice(0, MAX_LISTED_FILES).join(", ");
+    const more = tests.unreached.length > MAX_LISTED_FILES ? `, \u2026 ${count(tests.unreached.length - MAX_LISTED_FILES)} more` : "";
+    const one = tests.unreached.length === 1;
+    lines(
+      printer,
+      "",
+      `${getColors().yellow("Unreached:")} ${plural(tests.unreached.length, "changed file")} no test reaches (${listed}${more}). No test is selected for ${one ? "it: it is" : "them: they are"} untested, or used in a way variant cannot follow.`
+    );
+  }
+  if (tests.unselectedTests.length > 0) {
+    const listed = tests.unselectedTests.slice(0, MAX_LISTED_FILES).join(", ");
+    const more = tests.unselectedTests.length > MAX_LISTED_FILES ? `, \u2026 ${count(tests.unselectedTests.length - MAX_LISTED_FILES)} more` : "";
+    const one = tests.unselectedTests.length === 1;
+    lines(
+      printer,
+      "",
+      `${getColors().yellow("Not selected:")} ${plural(tests.unselectedTests.length, "changed test file")} ${one ? "is" : "are"} JavaScript (${listed}${more}). variant does not index JavaScript tests, so it cannot select them; run them yourself.`
+    );
+  }
+  const nothingAnalyzed = !tests.selectAll && radius.changed.length > 0 && radius.changed.every((impact) => impact.classification === "unanalyzed");
+  if (nothingAnalyzed) {
+    lines(
+      printer,
+      "",
+      "Nothing in this change was analyzed: none of the changed files is TypeScript that variant indexes."
+    );
+  }
+  lines(
+    printer,
+    "",
+    `Verdict:    ${verdictText(report.verdict)}`,
+    `Confidence: ${tests.resolution} (${Math.round(tests.confidence * 100)}%)  (report-only \u2014 run the full suite; skipping unlocks after shadow-mode validation)`
+  );
+  const notes = [...radius.notes, ...tests.notes];
+  if (notes.length > 0) {
+    lines(printer, "", "Notes:");
+    for (const note of notes) lines(printer, `  - ${note}`);
+  }
+  const standing = [...radius.repositoryNotes, ...tests.repositoryNotes];
+  if (standing.length > 0 && printer.mode === "verbose") {
+    lines(printer, "", "Repository (the same whatever changed):");
+    for (const note of standing) lines(printer, `  - ${note}`);
+  } else if (standing.length > 0) {
+    lines(
+      printer,
+      "",
+      `Repository: ${plural(standing.length, "standing note")}, the same whatever changed (-v lists them)`
+    );
+  }
+  if (!report.historyLogged) {
+    lines(
+      printer,
+      "",
+      "(warning: could not write .variant/history/impact.jsonl \u2014 shadow-mode logging skipped)"
+    );
+  }
+}
+function renderImpactVerifyJson(result, printer = getPrinter()) {
+  const { prediction, ...rest } = result;
+  lines(
+    printer,
+    JSON.stringify(
+      { ...rest, predictedAt: prediction.at, baseRef: prediction.baseRef },
+      null,
+      2
+    )
+  );
+}
+function renderImpactVerify(result, printer = getPrinter()) {
+  const { prediction } = result;
+  lines(
+    printer,
+    "",
+    `Prediction: ${prediction.at} (${prediction.headSha ?? "no commit recorded"})`,
+    `Matched by: ${result.matchedBy === "head-sha" ? "head SHA" : "most recent \u2014 verify this is the right run"}`,
+    "",
+    `Predicted:  ${count(prediction.affectedTests.length)} of ${count(prediction.totalTests)} test files${prediction.selectAll ? " (selected all)" : ""}`,
+    `Ran:        ${plural(result.ranTests, "test file")}, ${count(result.predictedRan)} of them predicted`,
+    `Failed:     ${plural(result.failedTests.length, "test file")}`
+  );
+  if (result.failedTests.length === 0) {
+    lines(
+      printer,
+      "",
+      "No failures in this run, so it neither confirms nor refutes the prediction."
+    );
+    return;
+  }
+  lines(
+    printer,
+    "",
+    `Caught:      ${count(result.caught.length)} (inside the predicted set)`,
+    `False skips: ${count(result.falseSkips.length)} (would have been missed)`
+  );
+  if (result.falseSkips.length > 0) {
+    lines(printer, "", "False skips:");
+    for (const test of result.falseSkips.slice(0, MAX_LISTED_FILES)) {
+      lines(printer, `  ${test}`);
+    }
+    if (result.falseSkips.length > MAX_LISTED_FILES) {
+      lines(
+        printer,
+        `  \u2026 and ${count(result.falseSkips.length - MAX_LISTED_FILES)} more`
+      );
+    }
+  }
+  lines(
+    printer,
+    "",
+    `False-skip rate this run: ${(result.falseSkipRate * 100).toFixed(1)}%`,
+    "One run is not a rate. Reconcile many before reading anything into it."
+  );
+  if (!result.historyLogged) {
+    lines(
+      printer,
+      "",
+      "(warning: could not write .variant/history/reconciliation.jsonl)"
+    );
+  }
+}
+
+// src/cli/commands/impact.ts
+async function registerImpactAction(opts = {}) {
+  let report;
+  try {
+    report = await predictImpact(process.cwd(), opts);
+  } catch (error) {
+    if (!(error instanceof NoBaseCommitError)) throw error;
+    renderNoBaseCommit(error.message, opts.json === true);
+    return;
+  }
+  if (opts.json === true) {
+    renderImpactJson(report);
+    return;
+  }
+  renderImpact(report);
+}
+async function registerImpactVerifyAction(reportPaths, opts = {}) {
+  const cwd = process.cwd();
+  const detected = opts.headSha === void 0 ? await detectHeadSha(changeBaseDeps(cwd)) : void 0;
+  const headSha = opts.headSha ?? detected;
+  let result = await verifyImpact(cwd, reportPaths, {
+    ...headSha !== void 0 && { headSha }
+  });
+  if (result === null && opts.headSha === void 0 && detected !== void 0) {
+    result = await verifyImpact(cwd, reportPaths);
+  }
+  if (result === null) {
+    lines(getPrinter(), NO_PREDICTION_MESSAGE);
+    return;
+  }
+  if (opts.json === true) {
+    renderImpactVerifyJson(result);
+    return;
+  }
+  renderImpactVerify(result);
+}
+export {
+  registerImpactAction,
+  registerImpactVerifyAction
+};

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   defineConfig
-} from "./chunk-RGD422OM.js";
-import "./chunk-RVXUCJYA.js";
+} from "./chunk-RJBFCURK.js";
+import "./chunk-ACTY42RE.js";
 export {
   defineConfig
 };