@ripast/cli 0.2.2 → 0.4.0

package/dist/cli.mjs

@@ -1,12 +1,12 @@
 import { existsSync, mkdirSync, readFileSync, renameSync } from "node:fs";
 import { dirname, relative, resolve } from "node:path";
 import process from "node:process";
-import { buildDeclarationTree, buildScanGraph, buildUnusedDeclarations, formatAgentDeclarationTree, formatAgentFileScanHits, formatAgentHits, formatAgentScanHits, formatDeclarationTree, formatFileScanHits, formatHits, formatRegressions, formatScanGraph, formatScanHits, formatUnusedDeclarations, printDiffs, resolveVerifyMode, runCssClassFileScan, runCssClassRename, runCssClassScan, runDelete, runMove, runRename, runRenameFile, runReplace, runVueTemplateUnwrap, runVueTemplateWrap, scan, summarize, writeChanges } from "@ripast/core";
+import { buildComponentDetail, buildComponentInventory, buildDeclarationTree, buildDoctorFixes, buildScanGraph, buildUnusedDeclarations, formatAgentDeclarationTree, formatAgentDoctorReport, formatAgentFileScanHits, formatAgentHits, formatAgentInventory, formatAgentScanHits, formatDeclarationTree, formatDetail, formatDoctorReport, formatFileScanHits, formatHits, formatInventory, formatRegressions, formatScanGraph, formatScanHits, formatUnusedDeclarations, getChangedFiles, printDiffs, resolveVerifyMode, runCssClassFileScan, runCssClassRename, runCssClassScan, runDelete, runDoctor, runMove, runRename, runRenameFile, runReplace, runVueTemplateUnwrap, runVueTemplateWrap, scan, summarize, writeChanges } from "@ripast/core";
 import { defineCommand, runMain } from "citty";
 import { agent, isAgent } from "std-env";
 const globArg = {
 	type: "string",
-	description: "File glob(s), comma-separated. Defaults to *.ts,*.tsx,*.vue,...  Respects .gitignore."
+	description: "File glob(s), comma-separated. Prefix with ! to exclude (e.g. \"*.ts,!.nuxt/**,!**/*.d.ts\"). Defaults to *.ts,*.tsx,*.vue,...  Respects .gitignore."
 };
 const applyArg = {
 	type: "boolean",
@@ -265,13 +265,13 @@ const unusedCmd = defineCommand({
 		glob: globArg,
 		exports: {
 			type: "string",
-			description: "Declaration filter: all, exported, or local. Defaults to local."
+			description: "Declaration filter: all, exported, or local. Defaults to exported (unused local declarations are already caught by tsc noUnusedLocals)."
 		},
 		tsconfig: { type: "string" },
 		json: jsonArg
 	},
 	run({ args }) {
-		const exportFilter = args.exports == null ? "local" : resolveExportFilter(args.exports);
+		const exportFilter = args.exports == null ? "exported" : resolveExportFilter(args.exports);
 		const unused = buildUnusedDeclarations({
 			glob: args.glob ? args.glob.split(",") : void 0,
 			exports: exportFilter,
@@ -349,6 +349,7 @@ const deleteCmd = defineCommand({
 });
 function emitResult(r, apply, verify = false, json = false, agentProfile = false) {
 	const s = summarize(r.changes);
+	const warnings = r.warnings ?? [];
 	if (json) {
 		const blockedByRegression = verify && apply && r.regressions.length > 0;
 		const wrote = apply && !blockedByRegression;
@@ -365,12 +366,14 @@ function emitResult(r, apply, verify = false, json = false, agentProfile = false
 				before: c.before,
 				after: c.after
 			})),
-			regressions: r.regressions
+			regressions: r.regressions,
+			warnings
 		};
 		process.stdout.write(`${JSON.stringify(payload)}\n`);
 		if (blockedByRegression) process.exit(1);
 		return;
 	}
+	for (const w of warnings) process.stderr.write(`warning: ${w}\n`);
 	if (agentProfile) {
 		const blockedByRegression = verify && apply && r.regressions.length > 0;
 		process.stdout.write(`${profileHeader()}\n`);
@@ -681,6 +684,136 @@ const rootOnlyArg = {
 	default: false,
 	description: "Match only template-root elements (direct children of <template>); ignores nested matches."
 };
+const vueTemplateWrapCmd = defineCommand({
+	meta: {
+		name: "vue-template-wrap",
+		description: "Wrap every matching element in a Vue <template> with a parent component. Selector: \"Tag\" or \"Tag[attr]\" / \"Tag[attr=value]\". Wrapper: tag name with optional inline attributes (e.g. \"ProPageStates name=\\\"lh\\\"\")."
+	},
+	args: {
+		selector: {
+			type: "positional",
+			required: true
+		},
+		wrapper: {
+			type: "positional",
+			required: true
+		},
+		glob: globArg,
+		scope: scopeArg,
+		rootOnly: rootOnlyArg,
+		apply: applyArg,
+		profile: profileArg,
+		json: jsonArg
+	},
+	async run({ args }) {
+		emitResult(await runVueTemplateWrap(args.selector, args.wrapper, {
+			glob: args.glob ? args.glob.split(",") : void 0,
+			scope: args.scope,
+			rootOnly: args.rootOnly
+		}), !!args.apply, false, !!args.json, resolveProfile(args.profile).agentProfile);
+	}
+});
+const vueTemplateUnwrapCmd = defineCommand({
+	meta: {
+		name: "vue-template-unwrap",
+		description: "Remove every matching element in a Vue <template>, hoisting its children up one level. Inverse of vue-template-wrap."
+	},
+	args: {
+		selector: {
+			type: "positional",
+			required: true
+		},
+		glob: globArg,
+		scope: scopeArg,
+		rootOnly: rootOnlyArg,
+		apply: applyArg,
+		profile: profileArg,
+		json: jsonArg
+	},
+	async run({ args }) {
+		emitResult(await runVueTemplateUnwrap(args.selector, {
+			glob: args.glob ? args.glob.split(",") : void 0,
+			scope: args.scope,
+			rootOnly: args.rootOnly
+		}), !!args.apply, false, !!args.json, resolveProfile(args.profile).agentProfile);
+	}
+});
+const componentsCmd = defineCommand({
+	meta: {
+		name: "components",
+		description: "Inventory Vue/Nuxt components (manifest-first, glob fallback); flag shadowed entries and duplicate-name groups. Pass a name positional for the focused view."
+	},
+	args: {
+		name: {
+			type: "positional",
+			required: false,
+			description: "Component name. If given, prints file, aliases, usages, and same-name candidates."
+		},
+		glob: globArg,
+		source: {
+			type: "string",
+			description: "Discovery source: auto, manifest, or filesystem. Default: auto."
+		},
+		dups: {
+			type: "boolean",
+			default: false,
+			description: "Print only duplicate-name groups."
+		},
+		profile: profileArg,
+		json: jsonArg
+	},
+	async run({ args }) {
+		const { agentProfile } = resolveProfile(args.profile);
+		const opts = {
+			glob: args.glob ? args.glob.split(",") : void 0,
+			source: resolveComponentsSource(args.source)
+		};
+		if (args.name) {
+			const detail = await buildComponentDetail(args.name, opts);
+			if (!detail) {
+				process.stderr.write(`ripast components: no component named "${args.name}".\n`);
+				process.exit(1);
+			}
+			if (args.json) {
+				process.stdout.write(`${JSON.stringify(detail, null, 2)}\n`);
+				return;
+			}
+			process.stdout.write(`${formatDetail(detail)}\n`);
+			return;
+		}
+		const inv = await buildComponentInventory(opts);
+		if (args.json) {
+			process.stdout.write(`${JSON.stringify(args.dups ? inv.duplicates : inv, null, 2)}\n`);
+			return;
+		}
+		if (args.dups) {
+			if (!inv.duplicates.length) {
+				process.stdout.write("no duplicate-name groups\n");
+				return;
+			}
+			const lines = [];
+			for (const dup of inv.duplicates) {
+				lines.push(dup.name);
+				for (const e of dup.entries) lines.push(`  ${e.rel}${e.shadowed ? " (shadowed)" : ""}`);
+			}
+			process.stdout.write(`${lines.join("\n")}\n`);
+			return;
+		}
+		if (agentProfile) {
+			process.stdout.write(`${profileHeader()}\n${formatAgentInventory(inv)}\n`);
+			return;
+		}
+		process.stdout.write(`${formatInventory(inv)}\n`);
+	}
+});
+function resolveComponentsSource(raw) {
+	if (raw == null) return void 0;
+	if (raw !== "auto" && raw !== "manifest" && raw !== "filesystem") {
+		process.stderr.write(`ripast components: --source must be "auto", "manifest", or "filesystem".\n`);
+		process.exit(2);
+	}
+	return raw;
+}
 runMain(defineCommand({
 	meta: {
 		name: "ripast",
@@ -690,67 +823,109 @@ runMain(defineCommand({
 		"scan": scanCmd,
 		"tree": treeCmd,
 		"unused": unusedCmd,
-		"rename": renameCmd,
-		"replace": replaceCmd,
-		"rename-file": renameFileCmd,
-		"move": moveCmd,
-		"delete": deleteCmd,
-		"css-class-rename": cssClassRenameCmd,
-		"css-class-scan": cssClassScanCmd,
-		"vue-template-wrap": defineCommand({
+		"doctor": defineCommand({
 			meta: {
-				name: "vue-template-wrap",
-				description: "Wrap every matching element in a Vue <template> with a parent component. Selector: \"Tag\" or \"Tag[attr]\" / \"Tag[attr=value]\". Wrapper: tag name with optional inline attributes (e.g. \"ProPageStates name=\\\"lh\\\"\")."
+				name: "doctor",
+				description: "Health checks over the AST graph. Suppress per-file with `// ripast-doctor-ignore-file[: c1,c2]` or per-line with `// ripast-doctor-ignore-next-line[: c1,c2]`."
 			},
 			args: {
-				selector: {
-					type: "positional",
-					required: true
+				glob: globArg,
+				checks: {
+					type: "string",
+					description: "Comma-separated subset: dangling-reexport, stale-reexport, stale-import, duplicate-export, orphan-file, orphan-test, inconsistent-import-path, circular-dep, phantom-component, shadowed-component, cross-realm-import, stale-nuxt-config-ref. Default: all (adapter checks run when their framework is detected)."
 				},
-				wrapper: {
-					type: "positional",
-					required: true
+				entry: {
+					type: "string",
+					description: "Comma-separated entry files exempt from orphan check (relative to cwd)."
 				},
-				glob: globArg,
-				scope: scopeArg,
-				rootOnly: rootOnlyArg,
-				apply: applyArg,
-				profile: profileArg,
-				json: jsonArg
-			},
-			async run({ args }) {
-				emitResult(await runVueTemplateWrap(args.selector, args.wrapper, {
-					glob: args.glob ? args.glob.split(",") : void 0,
-					scope: args.scope,
-					rootOnly: args.rootOnly
-				}), !!args.apply, false, !!args.json, resolveProfile(args.profile).agentProfile);
-			}
-		}),
-		"vue-template-unwrap": defineCommand({
-			meta: {
-				name: "vue-template-unwrap",
-				description: "Remove every matching element in a Vue <template>, hoisting its children up one level. Inverse of vue-template-wrap."
-			},
-			args: {
-				selector: {
-					type: "positional",
-					required: true
+				fix: {
+					type: "boolean",
+					default: false,
+					description: "Compute safe fixes for inconsistent-import-path and dangling-reexport findings."
 				},
-				glob: globArg,
-				scope: scopeArg,
-				rootOnly: rootOnlyArg,
 				apply: applyArg,
+				changed: {
+					type: "string",
+					description: "Report only findings on files changed vs git. No value = dirty working tree (staged+unstaged+untracked). With value (e.g. main, HEAD~1) = diff against that ref. Full project is still scanned so cross-file checks stay accurate."
+				},
 				profile: profileArg,
 				json: jsonArg
 			},
 			async run({ args }) {
-				emitResult(await runVueTemplateUnwrap(args.selector, {
+				const { agentProfile } = resolveProfile(args.profile);
+				const checks = args.checks ? args.checks.split(",") : void 0;
+				const entry = args.entry ? args.entry.split(",") : void 0;
+				let changedFiles;
+				if (args.changed != null) {
+					const ref = typeof args.changed === "string" && args.changed !== "" && args.changed !== "true" ? args.changed : void 0;
+					changedFiles = getChangedFiles({
+						cwd: process.cwd(),
+						ref
+					});
+					if (!changedFiles.length) {
+						process.stderr.write(`ripast doctor: --changed${ref ? ` ${ref}` : ""} matched no files; nothing to report.\n`);
+						return;
+					}
+				}
+				const report = await runDoctor({
 					glob: args.glob ? args.glob.split(",") : void 0,
-					scope: args.scope,
-					rootOnly: args.rootOnly
-				}), !!args.apply, false, !!args.json, resolveProfile(args.profile).agentProfile);
+					checks,
+					entry,
+					changedFiles
+				});
+				if (args.fix) {
+					const fix = buildDoctorFixes(report, process.cwd());
+					if (args.json) {
+						process.stdout.write(`${JSON.stringify({
+							findings: report.findings,
+							filesScanned: report.filesScanned,
+							fix: {
+								applied: !!args.apply,
+								files: fix.changes.length,
+								fixed: fix.fixed,
+								skipped: fix.skipped.length
+							},
+							changes: args.apply ? void 0 : fix.changes.map((c) => ({
+								path: c.rel,
+								before: c.before,
+								after: c.after
+							}))
+						})}\n`);
+						if (args.apply && fix.changes.length) writeChanges(fix.changes);
+						if (fix.skipped.length) process.exit(1);
+						return;
+					}
+					const s = summarize(fix.changes);
+					process.stdout.write(`doctor --fix: ${fix.fixed.length} fixable / ${fix.skipped.length} non-fixable findings\n`);
+					process.stdout.write(`${fix.changes.length} file${fix.changes.length === 1 ? "" : "s"}, +${s.linesAdded} -${s.linesRemoved} lines\n\n`);
+					if (!args.apply) {
+						printDiffs(fix.changes);
+						process.stdout.write(`\n(dry run, pass --apply to write)\n`);
+					} else {
+						writeChanges(fix.changes);
+						for (const c of fix.changes) process.stdout.write(`wrote ${c.rel}\n`);
+					}
+					if (fix.skipped.length) process.exit(1);
+					return;
+				}
+				if (agentProfile && !args.json) {
+					process.stdout.write(`${profileHeader()}\n${formatAgentDoctorReport(report)}\n`);
+					return;
+				}
+				process.stdout.write(formatDoctorReport(report, !!args.json));
+				if (report.findings.length) process.exit(1);
 			}
-		})
+		}),
+		"rename": renameCmd,
+		"replace": replaceCmd,
+		"rename-file": renameFileCmd,
+		"move": moveCmd,
+		"delete": deleteCmd,
+		"components": componentsCmd,
+		"css-class-rename": cssClassRenameCmd,
+		"css-class-scan": cssClassScanCmd,
+		"vue-template-wrap": vueTemplateWrapCmd,
+		"vue-template-unwrap": vueTemplateUnwrapCmd
 	}
 }));
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ripast/cli",
   "type": "module",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "CLI for ripast. Deterministic AST refactors (rename, move, find-usages, tailwind/CSS class migration) for TypeScript and frontend frameworks. Auto-installs framework adapters as needed.",
   "author": {
     "name": "Harlan Wilton",
@@ -50,7 +50,7 @@
   "dependencies": {
     "citty": "^0.2.2",
     "std-env": "^4.1.0",
-    "@ripast/core": "0.2.2"
+    "@ripast/core": "0.4.0"
   },
   "scripts": {
     "build": "obuild",