@osdlc/repo-cleaner 0.14.0 → 0.14.2

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @osdlc/repo-cleaner
 
+## 0.14.2
+
+### Patch Changes
+
+- 5cba918: `apply` says `skipped`, not `dropped`, for rows it leaves alone, matching the `skip` label on each row: `skipped 12, not deleted: 8 needs-review (name with --row), 4 not-authorized (--allow abandon-unmerged)`. The counts name how to include each kind. The closing prune step reads `prune   worktree records`, with the repository on the progress board, instead of a bare `prune`. The JSON receipt and summary keep their `dropped` field.
+
+## 0.14.1
+
+### Patch Changes
+
+- Updated dependencies [a3ef86d]
+  - @osdlc/cli-tool@0.15.0
+
 ## 0.14.0
 
 ### Minor Changes

package/README.md

@@ -34,7 +34,7 @@ own bar, empty while it waits, half full while it runs and full with a `✓`
   ██████████ ✓ delete  local_branch  feat/a
   █████░░░░░ › delete  local_branch  feat/b
   ░░░░░░░░░░   delete  remote_branch  origin/feat/b
-  ░░░░░░░░░░   prune
+  ░░░░░░░░░░   prune   worktree records in /Users/me/work/api
   ████████░░░░░░░░░░░░░░░░░░░░░░ 1/4
 ```
 
@@ -395,13 +395,13 @@ asks `Delete N items? [y/N]`:
 /Users/me/work/api
   delete  local_branch   fix/login-redirect
           git update-ref -d refs/heads/fix/login-redirect 3f9c2e1d…
-  prune
+  prune   worktree records
           git -C /Users/me/work/api worktree prune
   skip    worktree       /Users/me/work/api/wt/spike
           needs-review: clean but no clear disposability signal; name it with --row to apply it
 
 would delete: 1 local branch
-dropped 1: 1 needs-review
+skipped 1, not deleted: 1 needs-review (name with --row)
 Delete 2 items? [y/N]
 ```
 
@@ -434,7 +434,7 @@ Every run ends with what it did:
 
 ```text
 deleted: 1 worktree, 3 local branches, 2 remote branches, 1 stale worktree pruned
-dropped 2: 1 needs-review, 1 duplicate
+skipped 2, not deleted: 1 needs-review (name with --row), 1 duplicate
 status: complete
 ```
 

package/dist/cli.js

@@ -207,7 +207,7 @@ const applyCli = () => defineCli({
         output: OUTPUT,
     },
     epilogue: `risks: abandon-unmerged, discard-changes, confirm-open-pr
-A row that carries a risk you did not --allow is dropped, never deleted.`,
+A row that carries a risk you did not --allow is skipped, never deleted.`,
 });
 const terminalConfirm = (question) => (canPrompt() ? askYesNo(question) : null);
 const PAUSE = new Int32Array(new SharedArrayBuffer(4));

package/dist/render.d.ts

@@ -94,7 +94,7 @@ export interface ApplySummary {
 export declare function summarizeReceipt(receipt: Receipt): ApplySummary;
 /** Rows a receipt deletes or prunes, which is what a person is asked to approve. */
 export declare function rowsActedOn(summary: ApplySummary): number;
-/** The closing lines of an apply run: what it deleted, dropped and could not finish. */
+/** The closing lines of an apply run: what it deleted, skipped and could not finish. */
 export declare function renderApplySummary(receipt: Receipt): string[];
 /** The word a preview shows for a step: what it does to the row. */
 export declare const STEP_VERB: Record<Step['action'], string>;

package/dist/render.js

@@ -352,7 +352,27 @@ export function rowsActedOn(summary) {
     return d.worktree + d.local_branch + d.remote_branch + summary.pruned;
 }
 const plural = (n, one, many) => `${n} ${n === 1 ? one : many}`;
-/** The closing lines of an apply run: what it deleted, dropped and could not finish. */
+/**
+ * How to include a skipped row next time, for the reasons a person can act
+ * on. A `not-authorized` detail is `needs <risk>, <risk>` (see `recheck`).
+ */
+function dropHints(receipt) {
+    const risks = new Set();
+    for (const d of receipt.dropped) {
+        if (d.reason !== 'not-authorized')
+            continue;
+        for (const risk of d.detail.replace(/^needs /, '').split(', '))
+            if (risk)
+                risks.add(risk);
+    }
+    return {
+        'needs-review': 'name with --row',
+        ...(risks.size > 0
+            ? { 'not-authorized': [...risks].map((r) => `--allow ${r}`).join(', ') }
+            : {}),
+    };
+}
+/** The closing lines of an apply run: what it deleted, skipped and could not finish. */
 export function renderApplySummary(receipt) {
     const s = summarizeReceipt(receipt);
     const dry = receipt.status === 'dry-run';
@@ -372,7 +392,12 @@ export function renderApplySummary(receipt) {
     const dropped = Object.entries(s.dropped);
     if (dropped.length > 0) {
         const total = dropped.reduce((n, [, c]) => n + c, 0);
-        lines.push(`dropped ${total}: ${dropped.map(([reason, c]) => `${c} ${reason}`).join(', ')}`);
+        const hints = dropHints(receipt);
+        const counts = dropped.map(([reason, c]) => {
+            const hint = hints[reason];
+            return hint === undefined ? `${c} ${reason}` : `${c} ${reason} (${hint})`;
+        });
+        lines.push(`skipped ${total}, not deleted: ${counts.join(', ')}`);
     }
     if (s.failed > 0) {
         lines.push(`stopped at a failed step; ${plural(s.notRun, 'row', 'rows')} not run`);
@@ -421,7 +446,9 @@ export function renderPreview(receipt, style = PLAIN) {
         for (const s of receipt.steps.filter((s) => s.repo === repo)) {
             const verb = STEP_VERB[s.action];
             const color = actionStyle(style, verb === 'unlock' ? 'review' : verb);
-            lines.push(s.row === null ? `  ${color(verb)}` : `  ${color(pad(verb, 6))}  ${row(s.row)}`);
+            lines.push(s.row === null
+                ? `  ${color(pad(verb, 6))}  worktree records`
+                : `  ${color(pad(verb, 6))}  ${row(s.row)}`);
             lines.push(`          ${style.muted(stripControls(s.command))}`);
         }
         for (const d of receipt.dropped.filter((d) => d.repo === repo)) {
@@ -456,7 +483,7 @@ export function renderReceipt(receipt, receiptPath, style = PLAIN, opts = {}) {
     // A run shown live has printed its dropped rows and steps already.
     for (const d of opts.steps === false ? [] : receipt.dropped) {
         const shown = stripControls(`${d.category}:${d.id} — ${d.reason} (${d.detail})`);
-        lines.push(`${style.review('dropped  ')}${shown}`);
+        lines.push(`${style.review('skipped  ')}${shown}`);
     }
     for (const s of opts.steps === false ? [] : receipt.steps) {
         const what = s.row === null ? s.command : `${s.row.category}:${s.row.id} — ${s.command}`;

package/dist/step-board.js

@@ -13,8 +13,9 @@ const BAR = 10;
 const TOTAL_BAR = 30;
 function label(step) {
     const verb = STEP_VERB[step.action];
+    // The closing prune belongs to no row: it clears the repository's stale worktree records.
     if (step.row === null)
-        return verb;
+        return stripControls(`${verb.padEnd(6)}  worktree records in ${step.repo}`);
     return stripControls(`${verb.padEnd(6)}  ${step.row.category}  ${step.row.id}`);
 }
 /**

package/dist/version.generated.d.ts

@@ -1,2 +1,2 @@
 /** This package's version, from its package.json when it was built. */
-export declare const VERSION = "0.14.0";
+export declare const VERSION = "0.14.2";

package/dist/version.generated.js

@@ -1,3 +1,3 @@
 // Generated by cli-tool-stamp-version from package.json. Do not edit.
 /** This package's version, from its package.json when it was built. */
-export const VERSION = '0.14.0';
+export const VERSION = '0.14.2';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osdlc/repo-cleaner",
-  "version": "0.14.0",
+  "version": "0.14.2",
   "description": "What has been merged into the default branch, and what can go away. Inventories local branches, worktrees and remote branches across one repository or many, classifying each with the evidence behind the verdict and the command that would act on it. Plans and applies approved deletes, compare-and-swap.",
   "license": "MIT OR Apache-2.0",
   "author": "sksizer",
@@ -49,10 +49,10 @@
   },
   "dependencies": {
     "zod": "^4.6.6",
-    "@osdlc/command-seam": "^0.14.0",
+    "@osdlc/cli-tool": "^0.15.0",
     "@osdlc/path-guard": "^0.3.1",
+    "@osdlc/command-seam": "^0.14.0",
     "@osdlc/typed-gh": "^0.14.1",
-    "@osdlc/cli-tool": "^0.14.0",
     "@osdlc/typed-git": "^0.12.0",
     "@osdlc/ux": "^0.1.1"
   },
@@ -63,8 +63,8 @@
     "prettier": "3.9.6",
     "typescript": "~6.0.3",
     "vitest": "^5.0.5",
-    "@osdlc/tsconfig": "^0.4.1",
-    "@osdlc/prettier-config": "^0.3.1"
+    "@osdlc/prettier-config": "^0.3.1",
+    "@osdlc/tsconfig": "^0.4.1"
   },
   "scripts": {
     "build": "cli-tool-stamp-version && tsc -p tsconfig.build.json",