dep-radius 0.1.0 → 0.2.0

package/README.md

@@ -10,6 +10,7 @@ Which changes in a dependency update land on code you actually wrote.
 npx dep-radius                 # every direct dependency with an update waiting
 npx dep-radius schemakit       # one package
 npx dep-radius schemakit@3.2.0 # an exact target
+npx dep-radius --since main    # the dependencies whose version changed since that commit
 ```
 
 ```
@@ -56,9 +57,10 @@ quiet verdict that stood on one net only is marked `*`.
 
 ## Options
 
-`--json`, `--markdown` (a pull request comment), `--offline`, `--min-age <duration>` (default 1d, or
-the project's `minimumReleaseAge`), `--latest`, `--no-notes`, `--no-surface`, `--prod`, `--verbose`.
-Set `GITHUB_TOKEN`, or log in with `gh`, to lift GitHub's limit from 60 to 5000 requests an hour.
+`--json`, `--markdown` (a pull request comment), `--since <git-ref>` (compare with a commit, reading
+its lockfile, nothing installed), `--offline`, `--min-age <duration>` (default 1d, or the project's
+`minimumReleaseAge`), `--latest`, `--no-notes`, `--no-surface`, `--prod`, `--verbose`. Set
+`GITHUB_TOKEN`, or log in with `gh`, to lift GitHub's limit from 60 to 5000 requests an hour.
 
 `--json` is a stable contract, `schemaVersion: 1`, described by
 [`brief-v1.schema.json`](../core/schema/brief-v1.schema.json), shipped in `@dep-radius/core` as

package/dist/cli.js

@@ -12,6 +12,8 @@ const HELP = `radius: which changes in a dependency update land on code you wrot
 usage
   radius [path]                      every direct dependency with an update waiting
   radius <pkg>[@<version|tag>] ...   only these packages (a version analyses that exact target)
+  radius --since <git-ref>           the dependencies whose version changed since that commit,
+                                     for a pull request or right after an upgrade
 
 options
   --json                 the brief as JSON (schemaVersion 1)
@@ -49,6 +51,7 @@ async function main(argv) {
                 offline: { type: "boolean" },
                 "min-age": { type: "string" },
                 latest: { type: "boolean" },
+                since: { type: "string" },
                 notes: { type: "boolean", default: true },
                 surface: { type: "boolean", default: true },
                 prod: { type: "boolean" },
@@ -78,6 +81,10 @@ async function main(argv) {
         process.stderr.write("radius: --json and --markdown cannot be combined\n");
         return 3;
     }
+    if (v.since !== undefined && v.latest) {
+        process.stderr.write("radius: --since and --latest cannot be combined\n");
+        return 3;
+    }
     let root = process.cwd();
     const specs = [];
     // a path is written like one (./x, ../x, /x, a/b that exists); a bare word is a package, so a
@@ -126,6 +133,7 @@ async function main(argv) {
         offline: !!v.offline,
         minAgeMs,
         latest: !!v.latest,
+        ...(v.since ? { since: v.since } : {}),
         notes: v.notes !== false,
         surface: v.surface !== false,
         prod: !!v.prod,

package/dist/render/terminal.js

@@ -1,5 +1,5 @@
 import { styleText } from "node:util";
-import { ago, coverageLabel, groupBriefs, oneNetOnly, opaqueLabel, siteLabel, sitesFor, surfaceLabel, } from "@dep-radius/core/render";
+import { ago, coverageLabel, groupBriefs, oneNetOnly, opaqueLabel, sinceLabel, siteLabel, sitesFor, surfaceLabel, } from "@dep-radius/core/render";
 export function renderTerminal(brief, opts) {
     const c = (style, s) => (opts.color ? styleText(style, s) : s);
     const out = [];
@@ -7,7 +7,9 @@ export function renderTerminal(brief, opts) {
     const sources = [...new Set(brief.packages.map((p) => p.versionSource))].join(", ") ||
         "none";
     out.push(`${c("bold", "radius")}  ${brief.root}`);
-    out.push(c("dim", `${brief.manifests} ${brief.manifests === 1 ? "manifest" : "manifests"} · ${brief.packages.length} with an update · ${brief.upToDate} up to date · versions from ${sources}`));
+    out.push(c("dim", brief.since
+        ? `${brief.manifests} ${brief.manifests === 1 ? "manifest" : "manifests"} · since ${sinceLabel(brief.since)} · ${brief.packages.length} changed · ${brief.upToDate} unchanged`
+        : `${brief.manifests} ${brief.manifests === 1 ? "manifest" : "manifests"} · ${brief.packages.length} with an update · ${brief.upToDate} up to date · versions from ${sources}`));
     out.push("");
     const siteCap = opts.verbose ? Number.POSITIVE_INFINITY : 5;
     for (const p of g.detailed) {
@@ -53,7 +55,7 @@ export function renderTerminal(brief, opts) {
     }
     const count = (v) => brief.packages.filter((p) => p.verdict === v).length;
     out.push("");
-    out.push(`${c("bold", `${brief.packages.length} with an update`)}  ${c("green", `${count("quiet")} quiet`)} · ${c("yellow", `${count("review")} review`)} · ${c("red", `${count("blocked")} blocked`)}  ${c("dim", `· ${brief.upToDate} up to date`)}`);
+    out.push(`${c("bold", `${brief.packages.length} ${brief.since ? "changed" : "with an update"}`)}  ${c("green", `${count("quiet")} quiet`)} · ${c("yellow", `${count("review")} review`)} · ${c("red", `${count("blocked")} blocked`)}  ${c("dim", `· ${brief.upToDate} ${brief.since ? "unchanged" : "up to date"}`)}`);
     return `${out.join("\n")}\n`;
 }
 function packageBlock(p, c, siteCap, opts) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dep-radius",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Tells you which changes in a dependency update land on code you actually wrote.",
   "license": "MIT",
   "author": "prakticode",
@@ -41,7 +41,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.8.0",
-    "@dep-radius/core": "^0.1.0"
+    "@dep-radius/core": "^0.2.0"
   },
   "devDependencies": {
     "@repo/eslint-config": "0.0.0",