@untestutils/cli 0.5.0 → 0.5.1

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@untestutils/cli",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "CLI for untestutils: init, convert, ai, doctor, and monorepo commands",
-  "license": "MIT",
   "homepage": "https://s00d.github.io/untestutils/",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/s00d/untestutils.git",
@@ -40,9 +40,9 @@
     "pathe": "^2.0.3",
     "tinyglobby": "^0.2.17",
     "tsx": "^4.23.13",
-    "@untestutils/ai": "0.5.0",
-    "@untestutils/core": "0.5.0",
-    "@untestutils/perf": "0.5.0"
+    "@untestutils/ai": "0.5.1",
+    "@untestutils/core": "0.5.1",
+    "@untestutils/perf": "0.5.1"
   },
   "devDependencies": {
     "@types/node": "^26.6.1",

package/src/commands/ai.ts

@@ -1,51 +1,53 @@
-import { defineCommand } from 'citty';
+import { defineCommand, type CommandDef } from 'citty';
 import { consola } from 'consola';
 import { resolve } from 'pathe';
 import { aiTest, aiTestFromFile } from '@untestutils/ai';
 import { writeText } from '../utils/fs';
 
-export const aiCommand = defineCommand({
+const aiArgs = {
+  prompt: {
+    type: 'string',
+    description: 'Scenario text',
+    alias: 'p',
+  },
+  file: {
+    type: 'string',
+    description: 'Markdown with frontmatter (id/root/recipes/focus)',
+    alias: 'f',
+  },
+  id: {
+    type: 'string',
+    description: 'Generation id',
+    default: 'cli',
+  },
+  root: {
+    type: 'string',
+    description: 'Project root',
+    default: '.',
+  },
+  recipes: {
+    type: 'string',
+    description: 'Comma-separated recipe ids',
+    default: '',
+  },
+  focus: {
+    type: 'string',
+    description: 'Comma-separated focus file hints',
+    default: '',
+  },
+  out: {
+    type: 'string',
+    description: 'Copy generated file to this path',
+  },
+} as const;
+
+export const aiCommand: CommandDef<typeof aiArgs> = defineCommand({
   meta: {
     name: 'ai',
     alias: ['generate'],
     description: 'Generate an e2e test from a prompt or markdown file',
   },
-  args: {
-    prompt: {
-      type: 'string',
-      description: 'Scenario text',
-      alias: 'p',
-    },
-    file: {
-      type: 'string',
-      description: 'Markdown with frontmatter (id/root/recipes/focus)',
-      alias: 'f',
-    },
-    id: {
-      type: 'string',
-      description: 'Generation id',
-      default: 'cli',
-    },
-    root: {
-      type: 'string',
-      description: 'Project root',
-      default: '.',
-    },
-    recipes: {
-      type: 'string',
-      description: 'Comma-separated recipe ids',
-      default: '',
-    },
-    focus: {
-      type: 'string',
-      description: 'Comma-separated focus file hints',
-      default: '',
-    },
-    out: {
-      type: 'string',
-      description: 'Copy generated file to this path',
-    },
-  },
+  args: aiArgs,
   async run({ args }) {
     const root = resolve(String(args.root));
     const recipes = String(args.recipes || '')

package/src/commands/convert.ts

@@ -1,33 +1,35 @@
-import { defineCommand } from 'citty';
+import { defineCommand, type CommandDef } from 'citty';
 import { consola } from 'consola';
 import { resolve, dirname, basename, join } from 'pathe';
 import { convertTestFile } from '@untestutils/ai';
 import { writeText, pathExists } from '../utils/fs';
 import { copyFile } from 'node:fs/promises';
 
-export const convertCommand = defineCommand({
+const convertArgs = {
+  path: {
+    type: 'positional',
+    description: 'Test file path',
+    required: true,
+  },
+  'in-place': {
+    type: 'boolean',
+    description: 'Overwrite source (writes .bak backup)',
+    default: false,
+    alias: 'i',
+  },
+  root: {
+    type: 'string',
+    description: 'Project root for AI tools',
+    default: '.',
+  },
+} as const;
+
+export const convertCommand: CommandDef<typeof convertArgs> = defineCommand({
   meta: {
     name: 'convert',
     description: 'Convert existing tests to the untestutils API via AI',
   },
-  args: {
-    path: {
-      type: 'positional',
-      description: 'Test file path',
-      required: true,
-    },
-    'in-place': {
-      type: 'boolean',
-      description: 'Overwrite source (writes .bak backup)',
-      default: false,
-      alias: 'i',
-    },
-    root: {
-      type: 'string',
-      description: 'Project root for AI tools',
-      default: '.',
-    },
-  },
+  args: convertArgs,
   async run({ args }) {
     const file = resolve(String(args.path));
     if (!(await pathExists(file))) {

package/src/commands/cover.ts

@@ -1,50 +1,52 @@
-import { defineCommand } from 'citty';
+import { defineCommand, type CommandDef } from 'citty';
 import { consola } from 'consola';
 import { resolve } from 'pathe';
 import { coverMissingTests } from '@untestutils/ai';
 
-export const coverCommand = defineCommand({
+const coverArgs = {
+  root: {
+    type: 'string',
+    description: 'Project root',
+    default: '.',
+  },
+  recipes: {
+    type: 'string',
+    description: 'Comma-separated recipe ids',
+    default: '',
+  },
+  focus: {
+    type: 'string',
+    description: 'Comma-separated focus paths',
+    default: '',
+  },
+  'base-url': {
+    type: 'string',
+    description: 'Live app URL for browser_snapshot tools',
+  },
+  browser: {
+    type: 'boolean',
+    description: 'Force browser tools',
+    default: false,
+  },
+  'out-dir': {
+    type: 'string',
+    description: 'Directory for new tests',
+    default: 'tests/e2e',
+  },
+  write: {
+    type: 'boolean',
+    description: 'Write files into the project',
+    default: true,
+  },
+} as const;
+
+export const coverCommand: CommandDef<typeof coverArgs> = defineCommand({
   meta: {
     name: 'cover',
     alias: ['write-tests'],
     description: 'Write missing e2e tests via AI (explores recipes/pages; optional browser)',
   },
-  args: {
-    root: {
-      type: 'string',
-      description: 'Project root',
-      default: '.',
-    },
-    recipes: {
-      type: 'string',
-      description: 'Comma-separated recipe ids',
-      default: '',
-    },
-    focus: {
-      type: 'string',
-      description: 'Comma-separated focus paths',
-      default: '',
-    },
-    'base-url': {
-      type: 'string',
-      description: 'Live app URL for browser_snapshot tools',
-    },
-    browser: {
-      type: 'boolean',
-      description: 'Force browser tools',
-      default: false,
-    },
-    'out-dir': {
-      type: 'string',
-      description: 'Directory for new tests',
-      default: 'tests/e2e',
-    },
-    write: {
-      type: 'boolean',
-      description: 'Write files into the project',
-      default: true,
-    },
-  },
+  args: coverArgs,
   async run({ args }) {
     const recipes = String(args.recipes || '')
       .split(',')

package/src/commands/doctor.ts

@@ -1,4 +1,4 @@
-import { defineCommand } from 'citty';
+import { defineCommand, type CommandDef } from 'citty';
 import { consola } from 'consola';
 import { existsSync } from 'node:fs';
 import { resolve, join } from 'pathe';
@@ -17,18 +17,20 @@ function canResolve(id: string, cwd: string): boolean {
   }
 }
 
-export const doctorCommand = defineCommand({
+const doctorArgs = {
+  cwd: {
+    type: 'string',
+    description: 'Project directory',
+    default: '.',
+  },
+} as const;
+
+export const doctorCommand: CommandDef<typeof doctorArgs> = defineCommand({
   meta: {
     name: 'doctor',
     description: 'Check untestutils environment and configs',
   },
-  args: {
-    cwd: {
-      type: 'string',
-      description: 'Project directory',
-      default: '.',
-    },
-  },
+  args: doctorArgs,
   async run({ args }) {
     const cwd = resolve(String(args.cwd));
     const checks: Check[] = [];

package/src/commands/fix.ts

@@ -1,4 +1,4 @@
-import { defineCommand } from 'citty';
+import { defineCommand, type CommandDef } from 'citty';
 import { consola } from 'consola';
 import { readFile } from 'node:fs/promises';
 import { resolve } from 'pathe';
@@ -6,55 +6,57 @@ import { execSync } from 'node:child_process';
 import { fixBrokenTests } from '@untestutils/ai';
 import { pathExists, writeText } from '../utils/fs';
 
-export const fixCommand = defineCommand({
+const fixArgs = {
+  path: {
+    type: 'positional',
+    description: 'Failing test file',
+    required: true,
+  },
+  log: {
+    type: 'string',
+    description: 'Path to failure log file (or use --run)',
+    alias: 'l',
+  },
+  run: {
+    type: 'string',
+    description: 'Shell command that fails (stdout/stderr captured as log)',
+  },
+  root: {
+    type: 'string',
+    description: 'Project root',
+    default: '.',
+  },
+  recipes: {
+    type: 'string',
+    description: 'Comma-separated recipe ids',
+    default: '',
+  },
+  'base-url': {
+    type: 'string',
+    description: 'App base URL for Playwright page tools',
+  },
+  browser: {
+    type: 'boolean',
+    description: 'Enable browser tools even without --base-url',
+    default: false,
+  },
+  write: {
+    type: 'boolean',
+    description: 'Overwrite the failing file in place',
+    default: true,
+  },
+  out: {
+    type: 'string',
+    description: 'Write fixed source to this path instead',
+  },
+} as const;
+
+export const fixCommand: CommandDef<typeof fixArgs> = defineCommand({
   meta: {
     name: 'fix',
     description: 'Fix a broken untestutils test via AI (failure log + optional browser tools)',
   },
-  args: {
-    path: {
-      type: 'positional',
-      description: 'Failing test file',
-      required: true,
-    },
-    log: {
-      type: 'string',
-      description: 'Path to failure log file (or use --run)',
-      alias: 'l',
-    },
-    run: {
-      type: 'string',
-      description: 'Shell command that fails (stdout/stderr captured as log)',
-    },
-    root: {
-      type: 'string',
-      description: 'Project root',
-      default: '.',
-    },
-    recipes: {
-      type: 'string',
-      description: 'Comma-separated recipe ids',
-      default: '',
-    },
-    'base-url': {
-      type: 'string',
-      description: 'App base URL for Playwright page tools',
-    },
-    browser: {
-      type: 'boolean',
-      description: 'Enable browser tools even without --base-url',
-      default: false,
-    },
-    write: {
-      type: 'boolean',
-      description: 'Overwrite the failing file in place',
-      default: true,
-    },
-    out: {
-      type: 'string',
-      description: 'Write fixed source to this path instead',
-    },
-  },
+  args: fixArgs,
   async run({ args }) {
     const file = resolve(String(args.path));
     if (!(await pathExists(file))) {

package/src/commands/index.ts

@@ -1,3 +1,4 @@
+import type { SubCommandsDef } from 'citty';
 import { initCommand } from './init';
 import { convertCommand } from './convert';
 import { aiCommand } from './ai';
@@ -6,7 +7,7 @@ import { fixCommand } from './fix';
 import { coverCommand } from './cover';
 import { perfCommand } from './perf';
 
-export const commands = {
+export const commands: SubCommandsDef = {
   init: initCommand,
   convert: convertCommand,
   ai: aiCommand,

package/src/commands/init.ts

@@ -1,4 +1,4 @@
-import { defineCommand } from 'citty';
+import { defineCommand, type CommandDef } from 'citty';
 import { consola } from 'consola';
 import { addDependency } from 'nypm';
 import { resolve } from 'pathe';
@@ -6,34 +6,36 @@ import { applyPreset, peersForPreset, type InitPreset } from '../utils/templates
 
 const PRESETS: InitPreset[] = ['vitest', 'playwright', 'nuxt', 'full'];
 
-export const initCommand = defineCommand({
+const initArgs = {
+  preset: {
+    type: 'string',
+    description: 'Preset: vitest | playwright | nuxt | full',
+    default: 'vitest',
+    alias: 'p',
+  },
+  cwd: {
+    type: 'string',
+    description: 'Project directory',
+    default: '.',
+  },
+  force: {
+    type: 'boolean',
+    description: 'Overwrite existing files',
+    default: false,
+  },
+  install: {
+    type: 'boolean',
+    description: 'Install peer dependencies via nypm',
+    default: true,
+  },
+} as const;
+
+export const initCommand: CommandDef<typeof initArgs> = defineCommand({
   meta: {
     name: 'init',
     description: 'Add base untestutils configs and example tests to a project',
   },
-  args: {
-    preset: {
-      type: 'string',
-      description: 'Preset: vitest | playwright | nuxt | full',
-      default: 'vitest',
-      alias: 'p',
-    },
-    cwd: {
-      type: 'string',
-      description: 'Project directory',
-      default: '.',
-    },
-    force: {
-      type: 'boolean',
-      description: 'Overwrite existing files',
-      default: false,
-    },
-    install: {
-      type: 'boolean',
-      description: 'Install peer dependencies via nypm',
-      default: true,
-    },
-  },
+  args: initArgs,
   async run({ args }) {
     const preset = String(args.preset) as InitPreset;
     if (!PRESETS.includes(preset)) {

package/src/commands/perf.ts

@@ -1,9 +1,35 @@
-import { defineCommand } from 'citty';
+import { defineCommand, type CommandDef } from 'citty';
 import { pathToFileURL } from 'node:url';
 import { resolve } from 'pathe';
 import { consola } from 'consola';
 
-export const perfCommand = defineCommand({
+const perfArgs = {
+  config: {
+    type: 'string',
+    required: true,
+    description: 'Path to perf.config.ts exporting definePerfSuite(...) or default suite',
+  },
+  only: {
+    type: 'string',
+    description: 'Target id(s), comma-separated',
+  },
+  runs: {
+    type: 'string',
+    description: 'Override consecutive runs',
+  },
+  skipLoad: {
+    type: 'boolean',
+    default: false,
+    description: 'Measure builds only (skip autocannon/artillery)',
+  },
+  json: {
+    type: 'boolean',
+    default: false,
+    description: 'Also write JSON report under artifactsDir',
+  },
+} as const;
+
+export const perfCommand: CommandDef<typeof perfArgs> = defineCommand({
   meta: {
     name: 'perf',
     description: [
@@ -15,31 +41,7 @@ export const perfCommand = defineCommand({
       '  untestutils perf --config ./perf.config.ts --runs 3 --json',
     ].join('\n'),
   },
-  args: {
-    config: {
-      type: 'string',
-      required: true,
-      description: 'Path to perf.config.ts exporting definePerfSuite(...) or default suite',
-    },
-    only: {
-      type: 'string',
-      description: 'Target id(s), comma-separated',
-    },
-    runs: {
-      type: 'string',
-      description: 'Override consecutive runs',
-    },
-    skipLoad: {
-      type: 'boolean',
-      default: false,
-      description: 'Measure builds only (skip autocannon/artillery)',
-    },
-    json: {
-      type: 'boolean',
-      default: false,
-      description: 'Also write JSON report under artifactsDir',
-    },
-  },
+  args: perfArgs,
   async run({ args }) {
     const configPath = resolve(args.config);
     const mod = (await import(pathToFileURL(configPath).href)) as {

package/src/main.ts

@@ -1,7 +1,7 @@
 import { createRequire } from 'node:module';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { defineCommand } from 'citty';
+import { defineCommand, type CommandDef } from 'citty';
 import { commands } from './commands';
 
 function readOwnVersion(): string {
@@ -27,7 +27,7 @@ function readOwnVersion(): string {
   return '0.0.0';
 }
 
-export const main = defineCommand({
+export const main: CommandDef = defineCommand({
   meta: {
     name: 'untestutils',
     version: readOwnVersion(),

package/src/utils/workspace.ts

@@ -3,7 +3,7 @@ import { fileURLToPath } from 'node:url';
 import { existsSync, readFileSync } from 'node:fs';
 
 /** Untestutils monorepo root when the CLI runs inside this repository. */
-export function findMonorepoRoot(start = process.cwd()): string | null {
+export function findMonorepoRoot(start: string = process.cwd()): string | null {
   let dir = start;
   for (let i = 0; i < 12; i++) {
     if (