dev-diagnosis-cli 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -1,6 +1,19 @@
 # Changelog
 
-## 0.1.3 — unreleased
+## 0.1.4 — unreleased
+
+- Fix: a large file now carries a suggestion — its exact path from the
+  repo root — so `context --fix` writes it into `.aiignore` and a
+  re-scan comes back clean. Large files used to carry no suggestion, so
+  on any repo with one oversized file the fix wrote everything else and
+  the next scan still failed on the same file, including this project's
+  own demo fixture (its 1.7 MB `data/export.json`). The documented
+  "`--fix` followed by a re-scan comes back clean" promise now holds
+  for every kind of noise. (54 tests.)
+- Docs: the 0.1.3 entry below is now dated — it went live on npm on
+  2026-11-11 but the entry still said "unreleased".
+
+## 0.1.3 — 2026-11-11
 
 - Fix: nested build-output directories are reported by their full path
   from the repo root (`packages/foo/dist/`) instead of a bare `dist/` —

package/README.md

@@ -58,6 +58,7 @@ Worth a look before sharing:
   .env.example — environment template (usually safe to share)
 Fix: add these to .aiignore (or the agent's ignore list):
   *.log
+  data/export.json
   dist/
   package-lock.json
 FAIL  some context noise found (score 75/100)
@@ -92,7 +93,7 @@ The demo repo is intentionally noisy, so `all` exits 1: the context and flakes c
 
 ### `context` — what an AI agent should not read
 
-Walks the repo (skipping `.git`, `node_modules` and other hidden directories) and classifies every file: build output, large files over 1 MB, lockfiles, logs, binary payloads, secret-like files and environment templates. It prints a 0–100 score, the bytes lost per category, the noisy files, the files worth a look before sharing, and the `.aiignore` entries that would fix it. Build-output directories are reported by their full path from the repo root (`packages/foo/dist/`, not a bare `dist/`) and rolled up into one row per directory, so the entry `--fix` writes matches nested build output too. Files the repo's `.aiignore` already lists are excluded from the scan entirely — they are what the agent will not be handed, so they are not noise any more. `context --fix` writes the suggestions into `.aiignore` for you; `--json` includes the fix outcome in the output.
+Walks the repo (skipping `.git`, `node_modules` and other hidden directories) and classifies every file: build output, large files over 1 MB, lockfiles, logs, binary payloads, secret-like files and environment templates. It prints a 0–100 score, the bytes lost per category, the noisy files, the files worth a look before sharing, and the `.aiignore` entries that would fix it. Build-output directories are reported by their full path from the repo root (`packages/foo/dist/`, not a bare `dist/`) and rolled up into one row per directory, so the entry `--fix` writes matches nested build output too. A large file is fixed by its exact path from the repo root — no glob can single one file out — so `--fix` followed by a re-scan comes back clean even when the noise is a single oversized file. Files the repo's `.aiignore` already lists are excluded from the scan entirely — they are what the agent will not be handed, so they are not noise any more. `context --fix` writes the suggestions into `.aiignore` for you; `--json` includes the fix outcome in the output.
 
 The score is the *noise-only* part of ai-context-doctor's score: 100 minus the category-weighted share of noise bytes (build 40, large 25, lockfile 20, log 15). The full ai-context-doctor score also weighs context volume, one file dominating, file sprawl and binary payloads, so its composite number reads lower on the same repo. The file classification itself is the same.
 
@@ -111,7 +112,7 @@ Reads JUnit XML across CI runs — each subdirectory of `<junit-dir>` is one run
 ## Development
 
 ```sh
-npm test            # node:test, no extra dependencies — 53 tests
+npm test            # node:test, no extra dependencies — 54 tests
 npm run example     # run the CLI against the demo fixture
 ```
 

package/lib/context.mjs

@@ -114,7 +114,13 @@ export function classifyPath(relativePath, size = 0) {
     return { noise: { label: normalized, reason: 'local log file' }, suggestion: '*.log' };
   }
   if (size > LARGE_FILE_THRESHOLD_BYTES) {
-    return { noise: { label: normalized, reason: 'large file' }, suggestion: null };
+    // A large file has no pattern that fixes it — a glob would be wrong —
+    // so the fix is its exact path from the repo root. Without that, a
+    // repo with one oversized file could never come back clean: --fix
+    // would write everything else and the next scan would still fail on
+    // the same file, which is exactly what the --fix round-trip promises
+    // not to do.
+    return { noise: { label: normalized, reason: 'large file' }, suggestion: normalized };
   }
   if (isTemplateFile(basename)) {
     return { review: { label: normalized, reason: 'environment template (usually safe to share)' }, suggestion: null };

package/package.json

@@ -1 +1 @@
-{"author":"WJDdidi-1","bin":{"dev-diagnosis":"bin/dev-diagnosis.js"},"bugs":{"url":"https://github.com/WJDdidi-1/dev-doctor/issues"},"description":"One offline CLI that diagnoses a repo the way four small tools do: context noise for AI agents, missing CLI commands, build-cache value, and flaky tests.","engines":{"node":">=18"},"files":["bin/","lib/","examples/","README.md","LICENSE","CHANGELOG.md"],"homepage":"https://github.com/WJDdidi-1/dev-doctor#readme","keywords":["cli","diagnostics","ai-coding","context","build-cache","flaky-tests","path","developer-tools","offline"],"license":"Apache-2.0","name":"dev-diagnosis-cli","repository":{"type":"git","url":"git+https://github.com/WJDdidi-1/dev-doctor.git"},"scripts":{"example":"node examples/demo.mjs","test":"node --test"},"type":"module","version":"0.1.3"}
+{"author":"WJDdidi-1","bin":{"dev-diagnosis":"bin/dev-diagnosis.js"},"bugs":{"url":"https://github.com/WJDdidi-1/dev-doctor/issues"},"description":"One offline CLI that diagnoses a repo the way four small tools do: context noise for AI agents, missing CLI commands, build-cache value, and flaky tests.","engines":{"node":">=18"},"files":["bin/","lib/","examples/","README.md","LICENSE","CHANGELOG.md"],"homepage":"https://github.com/WJDdidi-1/dev-doctor#readme","keywords":["cli","diagnostics","ai-coding","context","build-cache","flaky-tests","path","developer-tools","offline"],"license":"Apache-2.0","name":"dev-diagnosis-cli","repository":{"type":"git","url":"git+https://github.com/WJDdidi-1/dev-doctor.git"},"scripts":{"example":"node examples/demo.mjs","test":"node --test"},"type":"module","version":"0.1.4"}