fix: error on unknown CLI flags instead of ignoring them

CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to this project are documented here, following
 [Keep a Changelog](https://keepachangelog.com/) and semantic versioning.
 
+## [0.1.9] - 2026-09-12
+
+### Fixed
+
+- Reject unknown CLI flags (for example `--wriet`) with exit code 2 instead of
+  silently ignoring them and running report-only.
+
 ## [0.1.8] - 2026-09-12
 
 ### Added

package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctxtrim",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Trim what bloats your AI coding context. Scan a repo, find the high-cost/low-value files ballooning your Claude Code / Cursor / Codex context, and write ignore files to cut token cost. Zero dependencies.",
   "type": "module",
   "bin": {

src/cli.js

@@ -47,6 +47,7 @@ function parse(argv) {
     else if (has("--top")) o.top = Number(val());
     else if (has("--format")) o.format = val();
     else if (has("--fail-on-waste")) o.failOnWaste = Number(val());
+    else if (a.startsWith("-")) return { ...o, error: `ctxtrim: unknown option: ${a}\n` };
     else if (!a.startsWith("-")) {
       if (o.path !== null) return { ...o, error: "ctxtrim: only one path may be supplied\n" };
       o.path = a;

test/ctxtrim.test.js

@@ -190,6 +190,12 @@ test("CLI fails only when waste reaches the threshold", () => {
   assert.equal(pass.status, 0, `clean repo should pass a 50%% threshold\n${pass.stderr}`);
 });
 
+test("CLI rejects unknown flags", () => {
+  const result = spawnSync(process.execPath, [cli, repo, "--wriet"], { encoding: "utf8" });
+  assert.equal(result.status, 2, `--wriet should fail with exit 2\n${result.stderr}`);
+  assert.match(result.stderr, /ctxtrim: unknown (option|flag).*--wriet/i);
+});
+
 test("CLI rejects non-finite and negative numeric options", () => {
   const invalid = [
     ["--max-tokens", "abc"],