test: add vitest with coverage for non-interactive agentic flow

Test suite (91 tests) focused on the agent-facing interface:

- nonInteractive: flag validation (missing/invalid name, mode, features),
  full-mode execution (operation order, all features in output, postInstall),
  custom-mode execution (feature selection, partial postInstall),
  edge cases (empty features, trailing commas, whitespace trimming),
  error handling (operation failures produce JSON errors),
  JSON output format (parseable, required fields, absolute path)
- info: JSON structure, all features present with description/default,
  postInstall conditional, no internal fields leaked, modes present
- operations: cloneRepo (5-step sequence, execFile for user input,
  exec only for shell substitution, no projectName in shell strings),
  createEnvFile (correct cp command and cwd),
  installPackages (full/custom/all-selected modes, pnpm remove with
  correct packages, postinstall after remove, selected packages excluded),
  cleanupFiles (full-mode no-op, per-feature file removal, subgraph
  compound condition, package.json script patching, .install-files last)
- utils: isValidName, isFeatureSelected, getPackagesToRemove,
  getPostInstallMessages

Coverage: nonInteractive 95%, info/config/all operations 100%.

Author: fernandomg

AGENTS.md

@@ -0,0 +1,42 @@
+# AGENTS.md
+
+This file provides guidance to AI coding agents working with code in this repository.
+
+## What This Is
+
+A CLI installer tool for dAppBooster projects, built with React + Ink (terminal UI framework). It walks users through an interactive setup flow: project naming, repo cloning, installation mode selection, optional packages, and post-install steps.
+
+## Commands
+
+- `pnpm build` — compile TypeScript (`tsc`)
+- `pnpm dev` — watch mode compilation
+- `pnpm test` — run tests (`vitest run`)
+- `pnpm lint` — run Biome linter (`biome check`)
+- `pnpm lint:fix` — auto-fix lint issues (`biome check --write`)
+
+## Architecture
+
+Entry: `source/cli.tsx` → renders the Ink React app.
+
+`source/app.tsx` is the main component — a step-based state machine (`currentStep` integer) that renders each installer step in sequence. Steps advance via a `finishStep` callback.
+
+### Key directories
+
+- `source/components/steps/` — each installer step as a React component (ProjectName, CloneRepo, InstallationMode, OptionalPackages, Install, FileCleanup, PostInstall)
+- `source/components/` — reusable UI components (Ask, Divider, MainTitle, Multiselect)
+- `source/constants/config.ts` — feature package mappings and repo URL
+- `source/types/types.ts` — shared TypeScript types
+- `source/utils/utils.ts` — helper functions (validation, step visibility)
+
+## Code Conventions
+
+- **ESM**: `"type": "module"` — imports use explicit `.js` extensions
+- **Formatting**: Biome — single quotes, no semicolons, 2-space indent, 100-char line width
+- **Components**: Functional components with TypeScript (`FC<Props>`)
+- **State**: Local `useState` only, props/callbacks for parent-child communication
+- **Skip pattern**: Steps accept a `skip` prop to conditionally bypass themselves
+- **Node**: Requires v20+ (see `.nvmrc`)
+
+## Release
+
+GitHub Actions workflow (`.github/workflows/release.yml`) triggers on GitHub release events. Pre-releases do a dry-run; full releases publish to npm.

package.json

@@ -10,6 +10,8 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "lint": "pnpm biome check",
     "lint:fix": "pnpm biome check --write"
   },
@@ -31,8 +33,10 @@
     "@sindresorhus/tsconfig": "^7.0.0",
     "@types/node": "^22.15.21",
     "@types/react": "^18.3.22",
+    "@vitest/coverage-v8": "^4.1.0",
     "ts-node": "^10.9.1",
-    "typescript": "^5.8.3"
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.0"
   },
   "pnpm": {
     "onlyBuiltDependencies": ["@biomejs/biome"]