@ripast/cli 0.2.1 → 0.3.0

package/dist/cli.mjs

@@ -1,12 +1,12 @@
-import { mkdirSync, readFileSync, renameSync } from "node:fs";
+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, 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",
@@ -67,6 +67,35 @@ function resolveCliVerifyMode(verify, verifyMode) {
 	}
 	return resolveVerifyMode(verify);
 }
+function recoverSmushedPair(oldArg, newArg) {
+	const cwd = process.cwd();
+	if (!!oldArg && existsSync(resolve(cwd, oldArg)) && newArg) return {
+		old: oldArg,
+		new: newArg
+	};
+	if (!oldArg) return {
+		old: oldArg,
+		new: newArg
+	};
+	const candidates = [];
+	for (const sep of [
+		/\s+/,
+		/\s*,\s*/,
+		/\s*:\s*/
+	]) {
+		const parts = oldArg.split(sep).filter(Boolean);
+		if (parts.length === 2) candidates.push([parts[0], parts[1]]);
+	}
+	for (const [a, b] of candidates) if (existsSync(resolve(cwd, a)) && !existsSync(resolve(cwd, b))) return {
+		old: a,
+		new: b,
+		warning: `recovered smushed positional args: treating "${oldArg}" as old="${a}" new="${b}". Quote each path separately next time.`
+	};
+	return {
+		old: oldArg,
+		new: newArg
+	};
+}
 function resolveExportFilter(raw) {
 	if (raw !== "all" && raw !== "exported" && raw !== "local") {
 		process.stderr.write(`ripast: --exports must be "all", "exported", or "local".\n`);
@@ -407,7 +436,9 @@ const renameFileCmd = defineCommand({
 	},
 	async run({ args }) {
 		const verifyMode = resolveCliVerifyMode(args.verify, args.verifyMode);
-		const r = await runRenameFile(args.old, args.new, {
+		const recovered = recoverSmushedPair(args.old, args.new);
+		if (recovered.warning) process.stderr.write(`warning: ${recovered.warning}\n`);
+		const r = await runRenameFile(recovered.old, recovered.new, {
 			tsconfig: args.tsconfig,
 			verify: verifyMode
 		});
@@ -455,7 +486,7 @@ const renameFileCmd = defineCommand({
 		for (const w of r.warnings) process.stderr.write(`warning: ${w}\n`);
 		if (agentProfile) {
 			process.stdout.write(`${profileHeader()}\n`);
-			process.stdout.write(`rename-file: ${args.old} -> ${args.new}\n`);
+			process.stdout.write(`rename-file: ${recovered.old} -> ${recovered.new}\n`);
 			process.stdout.write(`consumers: ${r.changes.length}/${r.scanned}, +${s.linesAdded} -${s.linesRemoved} lines\n`);
 			if (selfChangeDisplay) process.stdout.write(`self: rewrote moved file's own relative imports\n`);
 			process.stdout.write(`mode: ${apply ? blockedByRegression ? "blocked" : "applied" : "dry-run"}\n`);
@@ -641,6 +672,145 @@ function resolveCssClassFileScanSort(raw) {
 	}
 	return raw;
 }
+const scopeArg = {
+	type: "string",
+	description: "Restrict to a single .vue file (skips glob/rg)."
+};
+const rootOnlyArg = {
+	type: "boolean",
+	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",
@@ -650,13 +820,109 @@ runMain(defineCommand({
 		"scan": scanCmd,
 		"tree": treeCmd,
 		"unused": unusedCmd,
+		"doctor": defineCommand({
+			meta: {
+				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: {
+				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. Default: all."
+				},
+				entry: {
+					type: "string",
+					description: "Comma-separated entry files exempt from orphan check (relative to cwd)."
+				},
+				fix: {
+					type: "boolean",
+					default: false,
+					description: "Compute safe fixes for inconsistent-import-path and dangling-reexport findings."
+				},
+				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 }) {
+				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,
+					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
+		"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.1",
+  "version": "0.3.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.1"
+    "@ripast/core": "0.3.0"
   },
   "scripts": {
     "build": "obuild",