tend-cli 0.3.0 → 0.4.1

package/README.md

@@ -25,8 +25,8 @@ Run the latest published package directly from the registry:
 
 ```bash
 npx tend-cli@latest              # changed files vs HEAD (the default)
-npx tend-cli@latest run src/app lib/  # only findings under these paths
-npx tend-cli@latest run --all    # the entire backlog, repo-wide
+npx tend-cli@latest src/scanners # only findings under this path
+npx tend-cli@latest --all        # the entire backlog, repo-wide
 ```
 
 Or install it and use the product command:
@@ -34,8 +34,9 @@ Or install it and use the product command:
 ```bash
 npm install -g tend-cli
 tend                 # changed files vs HEAD (the default)
-tend run src/app lib/
-tend run --all
+tend src/scanners
+tend --all
+tend run src/scanners # explicit form is also available
 ```
 
 Requires **Node ≥ 20**, a git repo, and the [Claude Code](https://www.anthropic.com/claude-code)
@@ -47,7 +48,7 @@ do not need to match: `tend` is the command users run, and `tend-cli` is the reg
 When developing inside this repo, use the local script instead of `npx tend-cli`:
 
 ```bash
-pnpm cli run src/scanners
+pnpm cli -- src/scanners
 ```
 
 ## What it does

package/dist/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { ClaudeSession, EFFORT_LEVELS, EventBus, ReportBuilder, ReportSchema, Snapshot, addUsage, applyCliOverrides, assertGitRepo, buildProgram, changedVsHead, createGit, detectPackageManager, filesUnder, filterToChanged, formatClock, loadConfig, makeTheme, normalize, orchestrate, planWork, reasonLabel, renderSummary, resolveRetryTarget, retryCommand, runScanner, scannerStatus, showCommand, zeroUsage } from "./config-DMOjMbMD.js";
+import { ClaudeSession, EFFORT_LEVELS, EventBus, ReportBuilder, ReportSchema, Snapshot, addUsage, applyCliOverrides, assertGitRepo, buildProgram, changedVsHead, createGit, detectPackageManager, filesUnder, filterToChanged, formatClock, loadConfig, makeTheme, normalize, orchestrate, planWork, reasonLabel, renderSummary, resolveRetryTarget, retryCommand, runScanner, scannerStatus, showCommand, zeroUsage } from "./config-pmGLB0x1.js";
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { execa } from "execa";
@@ -1763,8 +1763,7 @@ const program = buildProgram({
 	},
 	retry: (id) => runRetry(id)
 });
-const argv = process.argv.slice(2).length === 0 ? [...process.argv, "run"] : process.argv;
-program.parseAsync(argv).catch((e) => {
+program.parseAsync(process.argv).catch((e) => {
 	if (e instanceof Error && e.name === "CommanderError") {
 		process.exitCode = e.exitCode ?? 1;
 		return;

package/dist/{config-DMOjMbMD.js → config-pmGLB0x1.js}

@@ -13,12 +13,65 @@ import gradient from "gradient-string";
 import { cosmiconfig } from "cosmiconfig";
 
 //#region src/cli.ts
+const COMMAND_NAMES = new Set([
+	"diff",
+	"help",
+	"retry",
+	"run",
+	"show",
+	"undo"
+]);
+const RUN_OPTION_NAMES = new Set([
+	"--all",
+	"--effort",
+	"--include-tests",
+	"--max-loops",
+	"--max-sessions",
+	"--model",
+	"--no-color",
+	"--plain",
+	"--verbose"
+]);
+function addRunOptions(command) {
+	return command.option("--all", "fix the entire backlog, not just changed files").option("--max-loops <n>", "cap on fix loops", (v) => parseInt(v, 10)).option("--max-sessions <n>", "concurrent AI sessions", (v) => parseInt(v, 10)).option("--model <model>", "model for fixes: sonnet (default), opus, haiku, or a full model id").option("--effort <level>", "reasoning effort for fixes: low | medium | high | xhigh | max").option("--include-tests", "also fix findings in test files (excluded by default)").option("--plain", "plain one-line-per-event output for pipes/CI (no color, no spinners)").option("--no-color", "disable color output").option("--verbose", "show the full per-tool / per-finding breakdown in the summary");
+}
+function looksLikePath(value) {
+	return value.includes("/") || value.includes("\\") || value.startsWith(".") || existsSync(value);
+}
+function isRunOption(value) {
+	const name = value.split("=")[0] ?? value;
+	return RUN_OPTION_NAMES.has(name);
+}
+function shouldInsertRun(args) {
+	const first = args[0];
+	if (!first) return true;
+	if (first === "--help" || first === "-h" || COMMAND_NAMES.has(first)) return false;
+	return isRunOption(first) || looksLikePath(first);
+}
+function withDefaultRun(argv, from) {
+	const prefixLength = from === "user" ? 0 : 2;
+	const prefix = argv.slice(0, prefixLength);
+	const args = argv.slice(prefixLength);
+	return shouldInsertRun(args) ? [
+		...prefix,
+		"run",
+		...args
+	] : [...argv];
+}
+function enableDefaultRun(program) {
+	const parse = program.parse.bind(program);
+	const parseAsync = program.parseAsync.bind(program);
+	program.parse = (argv, options) => parse(withDefaultRun(argv ?? process.argv, options?.from), options);
+	program.parseAsync = (argv, options) => parseAsync(withDefaultRun(argv ?? process.argv, options?.from), options);
+}
 /** Build the commander program wiring each subcommand to a handler. */
 function buildProgram(handlers) {
 	const program = new Command();
 	program.name("tend").description("Audit a JS/TS repo and fix findings with AI in a safe loop.");
 	program.exitOverride();
-	program.command("run").description("snapshot → audit → fix loop → report (changed files)").argument("[paths...]", "fix only findings under these files/dirs (committed or not)").option("--all", "fix the entire backlog, not just changed files").option("--max-loops <n>", "cap on fix loops", (v) => parseInt(v, 10)).option("--max-sessions <n>", "concurrent AI sessions", (v) => parseInt(v, 10)).option("--model <model>", "model for fixes: sonnet (default), opus, haiku, or a full model id").option("--effort <level>", "reasoning effort for fixes: low | medium | high | xhigh | max").option("--include-tests", "also fix findings in test files (excluded by default)").option("--plain", "plain one-line-per-event output for pipes/CI (no color, no spinners)").option("--no-color", "disable color output").option("--verbose", "show the full per-tool / per-finding breakdown in the summary").action((paths, opts) => handlers.run({
+	program.addHelpCommand(true);
+	const run = program.command("run").description("snapshot → audit → fix loop → report (changed files)").argument("[paths...]", "fix only findings under these files/dirs (committed or not)");
+	addRunOptions(run).action((paths, opts) => handlers.run({
 		...opts,
 		paths
 	}));
@@ -26,6 +79,7 @@ function buildProgram(handlers) {
 	program.command("undo").description("restore the pre-run snapshot").action(() => handlers.undo());
 	program.command("show <id>").description("full detail on one finding").action((id) => handlers.show(id));
 	program.command("retry <id>").description("re-attempt a stubborn finding with a larger budget").action((id) => handlers.retry(id));
+	enableDefaultRun(program);
 	return program;
 }
 
@@ -328,9 +382,11 @@ function revertFile(snapshot, file) {
 //#endregion
 //#region src/git/client.ts
 const UNSAFE_GIT_ENV_KEYS = [
+	"EDITOR",
+	"VISUAL",
 	"GIT_EDITOR",
-	"GIT_PAGER",
 	"GIT_SEQUENCE_EDITOR",
+	"GIT_PAGER",
 	"PAGER"
 ];
 function gitEnv(extra = {}) {
@@ -341,8 +397,8 @@ function gitEnv(extra = {}) {
 	for (const key of UNSAFE_GIT_ENV_KEYS) delete env[key];
 	return env;
 }
-function createGit(root) {
-	return simpleGit(root).env(gitEnv());
+function createGit(root, extraEnv = {}) {
+	return simpleGit(root).env(gitEnv(extraEnv));
 }
 
 //#endregion
@@ -360,7 +416,7 @@ let indexCounter = 0;
 async function writeWorkingTree(root) {
 	const idxPath = join(tmpdir(), `tend-index-${process.pid}-${indexCounter++}`);
 	try {
-		const g = createGit(root).env(gitEnv({ GIT_INDEX_FILE: idxPath }));
+		const g = createGit(root, { GIT_INDEX_FILE: idxPath });
 		await g.raw(["add", "-A"]);
 		return (await g.raw(["write-tree"])).trim();
 	} finally {
@@ -404,7 +460,8 @@ var Snapshot = class Snapshot {
 		this.root = root;
 		this.sha = sha;
 	}
-	static async capture(git, cwd) {
+	static async capture(_git, cwd) {
+		const git = createGit(cwd);
 		const root = (await git.revparse(["--show-toplevel"])).trim();
 		const gitDir = (await git.revparse(["--absolute-git-dir"])).trim();
 		ensureTendIgnored(gitDir);

package/dist/index.d.ts

@@ -404,7 +404,7 @@ declare class Snapshot {
   private readonly root;
   private readonly sha;
   private constructor();
-  static capture(git: SimpleGit, cwd: string): Promise<Snapshot>;
+  static capture(_git: SimpleGit, cwd: string): Promise<Snapshot>;
   /** Serialize to a tiny object for `.tend/snapshot.json` (powers `undo` across invocations). */
   toJSON(): {
     cwd: string;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { ClaudeSession, ConfigSchema, EventBus, FindingSchema, FindingStore, ReportBuilder, ReportSchema, Snapshot, addUsage, applyCliOverrides, assertGitRepo, buildProgram, changedFiles, changedVsHead, detectPackageManager, dispatch, filterToChanged, fingerprint, groupRemaining, isAvailable, loadConfig, normalize, orchestrate, planWork, renderSummary, retryCommand, revertFile, route, runScanner, scopeFindings, showCommand, trackForTool, zeroUsage } from "./config-DMOjMbMD.js";
+import { ClaudeSession, ConfigSchema, EventBus, FindingSchema, FindingStore, ReportBuilder, ReportSchema, Snapshot, addUsage, applyCliOverrides, assertGitRepo, buildProgram, changedFiles, changedVsHead, detectPackageManager, dispatch, filterToChanged, fingerprint, groupRemaining, isAvailable, loadConfig, normalize, orchestrate, planWork, renderSummary, retryCommand, revertFile, route, runScanner, scopeFindings, showCommand, trackForTool, zeroUsage } from "./config-pmGLB0x1.js";
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tend-cli",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Audit a JS/TS repo with established scanners, then fix the findings with parallel AI sessions in a safe scan-fix-rescan loop.",
   "keywords": [
     "lint",
@@ -39,7 +39,7 @@
   ],
   "scripts": {
     "build": "tsdown",
-    "cli": "pnpm build && node dist/bin.js",
+    "cli": "node scripts/cli-dev.mjs",
     "prepublishOnly": "tsdown",
     "test": "vitest run",
     "test:watch": "vitest",