tend-cli 0.1.1 → 0.2.1

package/README.md

@@ -1,13 +1,19 @@
 # tend
 
+[![CI](https://github.com/Njunge11/tend/actions/workflows/ci.yml/badge.svg)](https://github.com/Njunge11/tend/actions/workflows/ci.yml)
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=Njunge11_tend&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=Njunge11_tend)
+[![Coverage](https://img.shields.io/sonar/coverage/Njunge11_tend?server=https%3A%2F%2Fsonarcloud.io)](https://sonarcloud.io/summary/new_code?id=Njunge11_tend)
+[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=Njunge11_tend&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=Njunge11_tend)
+[![npm version](https://img.shields.io/npm/v/tend-cli)](https://www.npmjs.com/package/tend-cli)
 ![status: alpha](https://img.shields.io/badge/status-alpha-yellow)
 
 *Tend your code now so it never becomes an overgrown mess.*
 
 > [!NOTE]
 > **Early days (v0.x).** tend works, but it's young — flags and config may still
-> change before 1.0. As with any tool that edits code, run it on a committed repo
-> and review the changes. Feedback and issues are very welcome.
+> change before 1.0. The fix sessions run on Claude via [Claude Code](https://www.anthropic.com/claude-code)
+> for now; support for other models is planned. As with any tool that edits code, run it on a
+> committed repo and review the changes. Feedback and issues are very welcome.
 
 An open-source CLI that audits a JS/TS repo with standard scanners, then fixes the findings
 with parallel AI sessions in a safe **scan → fix → re-scan** loop. It never commits — fixes
@@ -21,8 +27,9 @@ npx tend-cli src/app lib/    # only findings under these paths
 npx tend-cli --all           # the entire backlog, repo-wide
 ```
 
-Requires **Node ≥ 20** and a git repo. Review the edits with `tend diff`; undo the whole run
-with `tend undo`.
+Requires **Node ≥ 20**, a git repo, and the [Claude Code](https://www.anthropic.com/claude-code)
+CLI (`claude`) installed and signed in — tend drives it to make the fixes. Review the edits with
+`tend diff`; undo the whole run with `tend undo`.
 
 ## 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-B5rO-fvz.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-DMOjMbMD.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";
@@ -1053,25 +1053,28 @@ function makeFixUnit(deps) {
 			prompt: renderPrompt(unit)
 		});
 		if (res.usage) usage = addUsage(usage, res.usage);
-		if (!changedOnDisk()) return {
-			kept: false,
-			reason: "session-error",
-			usage
-		};
 		if (!res.ok) {
-			restore();
+			if (changedOnDisk()) restore();
 			return {
 				kept: false,
 				reason: "session-error",
+				detail: res.error,
 				usage
 			};
 		}
+		if (!changedOnDisk()) return {
+			kept: false,
+			reason: "session-error",
+			detail: "Session completed without changing owned files",
+			usage
+		};
 		const supp = antiSuppression(buildDiff(before, diskNow()));
 		if (!supp.ok) {
 			restore();
 			return {
 				kept: false,
 				reason: supp.reason,
+				detail: supp.detail,
 				usage
 			};
 		}
@@ -1084,9 +1087,11 @@ function makeFixUnit(deps) {
 			return {
 				kept: false,
 				reason: tc.reason,
+				detail: tc.detail,
 				usage
 			};
 		}
+		let repairFailureDetail;
 		const phase = await runTestPhase({
 			baseline: deps.baseline,
 			runRelated: () => deps.runRelated(unit.files),
@@ -1097,6 +1102,7 @@ function makeFixUnit(deps) {
 					prompt: `${renderPrompt(unit)}\n\nThe previous edit left a test red — diagnose and fix.`
 				});
 				if (repair.usage) usage = addUsage(usage, repair.usage);
+				if (!repair.ok) repairFailureDetail = `Repair session failed: ${repair.error}`;
 			},
 			maxRepairs: deps.maxRepairs,
 			hasTestRunner: deps.hasTestRunner
@@ -1106,6 +1112,7 @@ function makeFixUnit(deps) {
 			return {
 				kept: false,
 				reason: phase.reason,
+				detail: repairFailureDetail ?? phase.detail,
 				usage
 			};
 		}
@@ -1116,6 +1123,7 @@ function makeFixUnit(deps) {
 			return {
 				kept: false,
 				reason: regression.reason,
+				detail: regression.detail,
 				usage
 			};
 		}

package/dist/{config-B5rO-fvz.js → config-DMOjMbMD.js}

@@ -126,6 +126,7 @@ const FindingSchema = z.object({
 		"typecheck",
 		"session-error"
 	]).optional(),
+	revertDetail: z.string().optional(),
 	firstSeenLoop: z.number(),
 	lastSeenLoop: z.number(),
 	inScope: z.boolean().optional()
@@ -705,6 +706,17 @@ var ClaudeSession = class {
 	}
 };
 
+//#endregion
+//#region src/findings/revert-detail.ts
+const MAX_REVERT_DETAIL_LENGTH = 500;
+/** Keep persisted diagnostics readable and bounded for report.json. */
+function normalizeRevertDetail(detail) {
+	const trimmed = detail?.replace(/\s+/g, " ").trim();
+	if (!trimmed) return void 0;
+	if (trimmed.length <= MAX_REVERT_DETAIL_LENGTH) return trimmed;
+	return `${trimmed.slice(0, MAX_REVERT_DETAIL_LENGTH - 3)}...`;
+}
+
 //#endregion
 //#region src/findings/store.ts
 const StoreSchema = z.array(FindingSchema);
@@ -728,7 +740,11 @@ var FindingStore = class FindingStore {
 	*/
 	reconcile(fresh, loop) {
 		const freshIds = new Set(fresh.map((f) => f.id));
-		for (const known of this.findings.values()) if (!freshIds.has(known.id)) known.status = "fixed";
+		for (const known of this.findings.values()) if (!freshIds.has(known.id)) {
+			known.status = "fixed";
+			delete known.revertReason;
+			delete known.revertDetail;
+		}
 		for (const incoming of fresh) {
 			const known = this.findings.get(incoming.id);
 			if (known) {
@@ -746,11 +762,14 @@ var FindingStore = class FindingStore {
 		return this.all().filter((f) => (filter.track === void 0 || f.track === filter.track) && (filter.status === void 0 || f.status === filter.status) && (filter.file === void 0 || f.file === filter.file));
 	}
 	/** Record a failed fix attempt against a finding's fingerprint. */
-	recordFailedAttempt(id, reason) {
+	recordFailedAttempt(id, reason, detail) {
 		const finding = this.findings.get(id);
 		if (!finding) return;
 		finding.attempts += 1;
 		finding.revertReason = reason;
+		const normalizedDetail = normalizeRevertDetail(detail);
+		if (normalizedDetail) finding.revertDetail = normalizedDetail;
+		else delete finding.revertDetail;
 	}
 	/** A finding's per-issue budget is exhausted once it has used `budget` attempts. */
 	isBudgetExhausted(id, budget) {
@@ -838,9 +857,12 @@ function statusAttemptSnapshot(store) {
 	return store.all().map((f) => `${f.id}:${f.status}:${f.attempts}`).sort().join("|");
 }
 function applyOutcome(store, unit, outcome, budget) {
-	for (const finding of unit.findings) if (outcome.kept) finding.status = "fixed";
-	else {
-		store.recordFailedAttempt(finding.id, outcome.reason ?? "session-error");
+	for (const finding of unit.findings) if (outcome.kept) {
+		finding.status = "fixed";
+		delete finding.revertReason;
+		delete finding.revertDetail;
+	} else {
+		store.recordFailedAttempt(finding.id, outcome.reason ?? "session-error", outcome.detail);
 		if (store.isBudgetExhausted(finding.id, budget)) finding.status = "unfixable";
 	}
 }
@@ -1081,7 +1103,11 @@ var ReportBuilder = class {
 	}
 	/** Record (or update) a finding's final outcome by fingerprint. */
 	recordOutcome(finding) {
-		this.outcomes.set(finding.id, finding);
+		const normalized = normalizeRevertDetail(finding.revertDetail);
+		const outcome = { ...finding };
+		if (normalized) outcome.revertDetail = normalized;
+		else delete outcome.revertDetail;
+		this.outcomes.set(finding.id, outcome);
 	}
 	recordOutcomes(findings) {
 		for (const f of findings) this.recordOutcome(f);
@@ -1636,6 +1662,7 @@ function showCommand(id, findings) {
 		`attempts: ${finding.attempts}`
 	];
 	if (finding.revertReason) lines$1.push(`last revert reason: ${finding.revertReason}`);
+	if (finding.revertDetail) lines$1.push(`last revert detail: ${finding.revertDetail}`);
 	if (finding.flowPath?.length) {
 		lines$1.push("flow path:");
 		for (const step of finding.flowPath) lines$1.push(`  → ${step.file}:${step.line}`);
@@ -1675,6 +1702,7 @@ async function retryCommand(id, deps) {
 	if (outcome.kept) {
 		finding.status = "fixed";
 		delete finding.revertReason;
+		delete finding.revertDetail;
 		if (deps.report) syncDerivedReportFields(deps.report);
 		return {
 			outcome: "fixed",
@@ -1685,6 +1713,9 @@ async function retryCommand(id, deps) {
 	const reason = outcome.reason ?? "session-error";
 	finding.attempts += 1;
 	finding.revertReason = reason;
+	const detail = normalizeRevertDetail(outcome.detail);
+	if (detail) finding.revertDetail = detail;
+	else delete finding.revertDetail;
 	finding.status = finding.attempts >= largerBudget ? "unfixable" : "reverted";
 	if (deps.report) syncDerivedReportFields(deps.report);
 	return {

package/dist/index.d.ts

@@ -45,6 +45,7 @@ declare const FindingSchema: z.ZodObject<{
   status: z.ZodEnum<["pending", "fixing", "fixed", "reverted", "unfixable", "skipped"]>;
   attempts: z.ZodNumber;
   revertReason: z.ZodOptional<z.ZodEnum<["broke-test", "suppression", "regression", "typecheck", "session-error"]>>;
+  revertDetail: z.ZodOptional<z.ZodString>;
   firstSeenLoop: z.ZodNumber;
   lastSeenLoop: z.ZodNumber;
   inScope: z.ZodOptional<z.ZodBoolean>;
@@ -75,6 +76,7 @@ declare const FindingSchema: z.ZodObject<{
   }[] | undefined;
   remediation?: string | undefined;
   revertReason?: "broke-test" | "suppression" | "regression" | "typecheck" | "session-error" | undefined;
+  revertDetail?: string | undefined;
   inScope?: boolean | undefined;
 }, {
   id: string;
@@ -103,6 +105,7 @@ declare const FindingSchema: z.ZodObject<{
   }[] | undefined;
   remediation?: string | undefined;
   revertReason?: "broke-test" | "suppression" | "regression" | "typecheck" | "session-error" | undefined;
+  revertDetail?: string | undefined;
   inScope?: boolean | undefined;
 }>;
 type Finding = z.infer<typeof FindingSchema>;
@@ -163,7 +166,7 @@ declare class FindingStore {
     file?: string;
   }): Finding[];
   /** Record a failed fix attempt against a finding's fingerprint. */
-  recordFailedAttempt(id: string, reason: RevertReason$1): void;
+  recordFailedAttempt(id: string, reason: RevertReason$1, detail?: string): void;
   /** A finding's per-issue budget is exhausted once it has used `budget` attempts. */
   isBudgetExhausted(id: string, budget: number): boolean;
   /** Serialize to a plain array — `report.json`'s findings section. */
@@ -611,6 +614,7 @@ declare const ReportSchema: z.ZodObject<{
     status: z.ZodEnum<["pending", "fixing", "fixed", "reverted", "unfixable", "skipped"]>;
     attempts: z.ZodNumber;
     revertReason: z.ZodOptional<z.ZodEnum<["broke-test", "suppression", "regression", "typecheck", "session-error"]>>;
+    revertDetail: z.ZodOptional<z.ZodString>;
     firstSeenLoop: z.ZodNumber;
     lastSeenLoop: z.ZodNumber;
     inScope: z.ZodOptional<z.ZodBoolean>;
@@ -641,6 +645,7 @@ declare const ReportSchema: z.ZodObject<{
     }[] | undefined;
     remediation?: string | undefined;
     revertReason?: "broke-test" | "suppression" | "regression" | "typecheck" | "session-error" | undefined;
+    revertDetail?: string | undefined;
     inScope?: boolean | undefined;
   }, {
     id: string;
@@ -669,6 +674,7 @@ declare const ReportSchema: z.ZodObject<{
     }[] | undefined;
     remediation?: string | undefined;
     revertReason?: "broke-test" | "suppression" | "regression" | "typecheck" | "session-error" | undefined;
+    revertDetail?: string | undefined;
     inScope?: boolean | undefined;
   }>, "many">;
   secrets: z.ZodArray<z.ZodObject<{
@@ -712,6 +718,7 @@ declare const ReportSchema: z.ZodObject<{
     status: z.ZodEnum<["pending", "fixing", "fixed", "reverted", "unfixable", "skipped"]>;
     attempts: z.ZodNumber;
     revertReason: z.ZodOptional<z.ZodEnum<["broke-test", "suppression", "regression", "typecheck", "session-error"]>>;
+    revertDetail: z.ZodOptional<z.ZodString>;
     firstSeenLoop: z.ZodNumber;
     lastSeenLoop: z.ZodNumber;
     inScope: z.ZodOptional<z.ZodBoolean>;
@@ -742,6 +749,7 @@ declare const ReportSchema: z.ZodObject<{
     }[] | undefined;
     remediation?: string | undefined;
     revertReason?: "broke-test" | "suppression" | "regression" | "typecheck" | "session-error" | undefined;
+    revertDetail?: string | undefined;
     inScope?: boolean | undefined;
   }, {
     id: string;
@@ -770,6 +778,7 @@ declare const ReportSchema: z.ZodObject<{
     }[] | undefined;
     remediation?: string | undefined;
     revertReason?: "broke-test" | "suppression" | "regression" | "typecheck" | "session-error" | undefined;
+    revertDetail?: string | undefined;
     inScope?: boolean | undefined;
   }>, "many">;
   depBumps: z.ZodArray<z.ZodObject<{
@@ -861,6 +870,7 @@ declare const ReportSchema: z.ZodObject<{
     }[] | undefined;
     remediation?: string | undefined;
     revertReason?: "broke-test" | "suppression" | "regression" | "typecheck" | "session-error" | undefined;
+    revertDetail?: string | undefined;
     inScope?: boolean | undefined;
   }[];
   secrets: {
@@ -890,6 +900,7 @@ declare const ReportSchema: z.ZodObject<{
     }[] | undefined;
     remediation?: string | undefined;
     revertReason?: "broke-test" | "suppression" | "regression" | "typecheck" | "session-error" | undefined;
+    revertDetail?: string | undefined;
     inScope?: boolean | undefined;
   }[];
   depBumps: {
@@ -945,6 +956,7 @@ declare const ReportSchema: z.ZodObject<{
     }[] | undefined;
     remediation?: string | undefined;
     revertReason?: "broke-test" | "suppression" | "regression" | "typecheck" | "session-error" | undefined;
+    revertDetail?: string | undefined;
     inScope?: boolean | undefined;
   }[];
   secrets: {
@@ -974,6 +986,7 @@ declare const ReportSchema: z.ZodObject<{
     }[] | undefined;
     remediation?: string | undefined;
     revertReason?: "broke-test" | "suppression" | "regression" | "typecheck" | "session-error" | undefined;
+    revertDetail?: string | undefined;
     inScope?: boolean | undefined;
   }[];
   depBumps: {
@@ -1155,6 +1168,7 @@ type AuditResult = {
 type FixOutcome = {
   kept: boolean;
   reason?: RevertReason;
+  detail?: string;
   usage?: AiUsage;
 };
 type OrchestrateDeps = {

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-B5rO-fvz.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-DMOjMbMD.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.1.1",
+  "version": "0.2.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",
@@ -11,7 +11,16 @@
     "static-analysis"
   ],
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Njunge11/tend.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Njunge11/tend/issues"
+  },
+  "homepage": "https://github.com/Njunge11/tend#readme",
   "type": "module",
+  "packageManager": "pnpm@10.33.0",
   "engines": {
     "node": ">=20"
   },
@@ -33,6 +42,7 @@
     "prepublishOnly": "tsdown",
     "test": "vitest run",
     "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {