@peachlife/artisan 0.1.2 → 0.1.3

package/README.md

@@ -1,32 +1,49 @@
 # Artisan
 
-> **End-to-end artifact testing for CLIs.** Stop merging green unit tests for broken binaries.
+> **End-to-end artifact testing for CLIs.**
+> Stop merging green unit tests for broken binaries.
 
-Unit tests verify your logic. Artisan proves your binary actually executes. 
+Unit tests verify your logic. Artisan proves your binary actually executes.
 
-Artisan mounts your compiled CLI into ephemeral Linux containers across a distro matrix (Debian, Alpine, Arch) and lets you assert stdout, stderr, exit codes, and real filesystem mutations using a familiar Vitest API.
+Artisan mounts your compiled CLI into ephemeral Linux containers across a
+distro matrix (Debian, Alpine, Arch) and lets you assert stdout, stderr,
+exit codes, and real filesystem mutations using a familiar Vitest API.
 
 Backed by **Testcontainers**, **Execa**, and **Vitest**.
 
 ## Why Artisan?
 
-*   **Catch runtime blindspots:** Detect `glibc` vs `musl` mismatches, missing system dependencies, and hardcoded host paths.
-*   **Agent-proof your workflow:** LLMs are great at writing passing unit tests for code that fails at runtime. Artisan enforces that "done" means the *artifact* works.
-*   **Zero-config discovery:** Automatically finds executables in `package.json#bin`, `./dist`, or `./bin`.
+* **Catch runtime blindspots:** Detect `glibc` vs `musl` mismatches,
+  missing system dependencies, and hardcoded host paths.
+* **Agent-proof your workflow:** LLMs are great at writing passing unit
+  tests for code that fails at runtime. Artisan enforces that "done" means
+  the *artifact* works.
+* **Zero-config discovery:** Automatically finds executables in
+  `package.json#bin`, `./dist`, or `./bin`.
 
 ## Quickstart
 
-Run Artisan directly. If you don't have tests yet, it will automatically bootstrap your environment, install dependencies, and generate a starter test.
+Build your project, then run Artisan. It auto-discovers a single executable
+in `dist/` or `bin/` — no config needed.
 
 ```bash
-npx @peachlife/artisan test --artifact ./dist/mycli
+npx @peachlife/artisan test
 ```
 
+If you don't have tests yet, Artisan bootstraps your environment, installs
+dependencies, and generates a starter test on the first run.
+
+If you have multiple binaries or a non-standard output path, point to
+a single artifact:
+
+```bash
+npx @peachlife/artisan test --artifact ./build/my-cli
 ```
 
 ## The API
 
-Test what users actually observe. Assert on exit codes, output, and container filesystem side-effects.
+Test what users actually observe. Assert on exit codes, output, and
+container filesystem side-effects.
 
 ```javascript
 // tests/artisan/cli.artisan.test.mjs
@@ -57,20 +74,25 @@ test("writes expected output to the filesystem", async ({ run, setup }) => {
 
 ## Matrix Testing via Config
 
-Need to test across different environments? Drop an `artisan.config.json` in your root:
+Need to test across different environments? Drop an `artisan.config.json`
+in your root:
 
 ```json
 {
-  "artifact": "./dist/mycli",
   "distros": ["debian:stable-slim", "alpine:latest", "archlinux/archlinux:latest"],
   "testMatch": "**/*.artisan.test.mjs",
   "parallel": true
 }
 ```
 
+Set `"artifact"` only if auto-discovery can't find your binary (multiple
+executables or a non-standard path).
+
 ## Config Fixtures
 
-Config parsing is where most CLIs silently fail (`~` paths, wrong XDG locations, missing files). Artisan can capture your host configuration, scrub secrets, and mount it cleanly into the sandbox's `$XDG_CONFIG_HOME`.
+Config parsing is where most CLIs silently fail (`~` paths, wrong XDG
+locations, missing files). Artisan can capture your host configuration,
+scrub secrets, and mount it cleanly into the sandbox's `$XDG_CONFIG_HOME`.
 
 ```bash
 # Capture, sanitize, and inject real config into your tests
@@ -80,17 +102,17 @@ npx @peachlife/artisan add config ~/.config/mycli --name mycli-config
 ## CLI Reference
 
 | Command | Description |
-|---|---|
+| --- | --- |
 | `npx @peachlife/artisan test` | Run all tests across the configured matrix |
 | `npx @peachlife/artisan test <file>` | Run a specific test file |
 | `npx @peachlife/artisan test -t "auth"` | Filter test execution by regex |
-| `npx @peachlife/artisan test --serial` | Run distros sequentially (ideal for debugging) |
+| `npx @peachlife/artisan test --serial` | Run distros sequentially |
 | `npx @peachlife/artisan init` | Scaffold setup without running tests |
 
 ### Exit Codes
 
 | Code | Meaning |
-|---|---|
+| --- | --- |
 | `0` | All tests passed |
 | `1` | One or more tests failed / timed out |
 | `2` | Usage or configuration error |
@@ -101,7 +123,9 @@ npx @peachlife/artisan add config ~/.config/mycli --name mycli-config
 
 Artisan runs perfectly in CI as long as the runner has Docker access.
 
-> **CI tip:** if your pipeline manages its own `npm ci` step, pass `--no-install` to `artisan init` or `artisan test --bootstrap` to skip the redundant install.
+> **CI tip:** if your pipeline manages its own `npm ci` step, pass
+> `--no-install` to `artisan init` or `artisan test --bootstrap` to skip
+> the redundant install.
 
 ```yaml
 name: Artifact Tests
@@ -117,7 +141,7 @@ jobs:
           node-version: 22
       - run: npm ci
       - run: npm run build # Ensure your artifact is compiled!
-      - run: npx @peachlife/artisan test --no-color
+      - run: npx @peachlife/artisan test --artifact <my-cli> --no-color
 ```
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@peachlife/artisan",
-	"version": "0.1.2",
+	"version": "0.1.3",
 	"type": "module",
 	"bin": {
 		"artisan": "./bin/artisan.mjs"

package/src/cli/bootstrap.mjs

@@ -101,7 +101,7 @@ export function parseDistros(distrosRaw) {
 	return distros;
 }
 
-async function writeConfig({ cwd, artifact, distros, force }) {
+async function writeConfig({ cwd, distros, force }) {
 	const configPath = join(cwd, "artisan.config.json");
 	if (!force && (await fileExists(configPath))) {
 		console.log(
@@ -111,10 +111,7 @@ async function writeConfig({ cwd, artifact, distros, force }) {
 	}
 	const tmpl = await readTemplate(TEMPLATES_DIR, "config.json.tmpl");
 	const distrosJson = distros.map((d) => JSON.stringify(d)).join(", ");
-	const content = renderTemplate(tmpl, {
-		ARTIFACT: artifact,
-		DISTROS: distrosJson,
-	});
+	const content = renderTemplate(tmpl, { DISTROS: distrosJson });
 	await writeFile(configPath, content, "utf8");
 	console.log("Created artisan.config.json");
 }
@@ -154,14 +151,13 @@ async function installDependencies({ cwd, installer }) {
  */
 export async function bootstrapProject({
 	cwd = process.cwd(),
-	artifact = "./dist/mycli",
 	distros = DEFAULT_DISTROS.join(","),
 	force = false,
 	install = false,
 	installer = runInstall,
 } = {}) {
 	const distroList = parseDistros(distros);
-	await writeConfig({ cwd, artifact, distros: distroList, force });
+	await writeConfig({ cwd, distros: distroList, force });
 	await writeStarterTest({ cwd, force });
 	if (install) {
 		await installDependencies({ cwd, installer });

package/src/cli/commands/init.mjs

@@ -10,7 +10,6 @@ import { bootstrapProject } from "../bootstrap.mjs";
 export async function runInit(options = {}) {
 	await bootstrapProject({
 		cwd: process.cwd(),
-		artifact: options.artifact,
 		distros: options.distros,
 		force: options.force ?? false,
 		install: options.install === true,

package/src/cli/parser.mjs

@@ -57,10 +57,7 @@ export function createProgram() {
 	program
 		.command("init")
 		.description("Scaffold Artisan into the current project")
-		.option("-a, --artifact <path>", "Path to compiled CLI binary")
 		.option("-d, --distros <list>", "Comma-separated Docker images")
-		.option("--testMatch <glob>", "Test file glob pattern")
-		.option("-y, --yes", "Skip prompts, use defaults/flags")
 		.option("--force", "Overwrite existing config/test files")
 		.option("--no-install", "Skip dependency installation")
 		.action((options) => runInit(options));

package/src/core/artifact-manager.mjs

@@ -94,11 +94,11 @@ async function discoverArtifact(cwd) {
 	if (executable.length === 1) return executable[0];
 	if (executable.length > 1) {
 		throw new UsageError(
-			`Multiple executable artifacts found: ${executable.join(", ")}. Pass --artifact or set "artifact" in artisan.config.json`,
+			`Multiple executables found in dist/ and bin/ — cannot choose automatically:\n  ${executable.join("\n  ")}\n\nSet "artifact" in artisan.config.json or pass --artifact to pick one.`,
 		);
 	}
 	throw new UsageError(
-		'No artifact specified and no executable artifact was auto-discovered. Set "artifact" in artisan.config.json or pass --artifact',
+		"No executable found in dist/ or bin/. Build your project first, then run artisan again.\nOr pass --artifact to point directly to your binary.",
 	);
 }
 

package/templates/config.json.tmpl

@@ -1,5 +1,4 @@
 {
-  "artifact": "{{ARTIFACT}}",
   "distros": [{{DISTROS}}],
   "testMatch": "**/*.artisan.test.mjs",
   "parallel": true,