@apollion-dsi/scripts 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @apollion-dsi/scripts
 
+## 0.9.1
+
+### Patch Changes
+
+- b3e5d0c: Fix `scripts lint` / `scripts prettier` arg pass-through so flag-value pairs and the POSIX `--` end-of-options separator no longer break the underlying CLI invocation.
+
+  The previous heuristic in `command/lint.ts` + `command/prettier.ts` treated _any_ argv entry not starting with `-` as a "user-provided path" and handed full control to the user from there. Two real consumer invocations hit by that, surfaced via DEX-Aggregator integration:
+  - `scripts lint --max-warnings 0` — the literal `0` value of the flag was misread as a path, so the default `src` target was dropped and ESLint ran with no files (hard error).
+  - `scripts lint -- --fix` (the form previously suggested in `llms.txt`) — every arg started with `-`, so `src` was appended, but the surviving `--` separator forced ESLint to treat `--fix` and `src` as positional files (`No files matching pattern '--fix'`).
+
+  `command/check-types.ts` doesn't carry the same heuristic and isn't affected.
+
+  **Fix.** A new pure helper `utils/buildWrapperArgs` replaces the heuristic with a simpler rule: empty input falls back to the canonical defaults; otherwise the user argv (with `--` stripped) is followed by the default target (`src` for lint, `src/**/*.{ts,tsx,json,css,md}` for prettier). Consumers needing a non-default target invoke `eslint`/`prettier` directly from `node_modules/.bin`. Tested in `src/__tests__/buildWrapperArgs.test.ts`.
+
+  **Docs.** `packages/scripts/llms.txt` now shows the flag-direct form (`scripts lint --fix`, `scripts prettier --write`, `scripts check-types -p tsconfig.build.json`) and explicitly warns against the `--` separator.
+
+  **Backward compatibility.** Both `--flag=value` (the workaround currently shipping in DEX-Aggregator after the canonical-Apollion refactor) and the previously-broken `--flag value` form now resolve to the same eslint/prettier invocation. No consumer change required to consume the fix; consumers may revert the `=`-form workaround at their convenience.
+
 ## 0.9.0
 
 ### Minor Changes

package/coverage/clover.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<coverage generated="1780056951323" clover="3.2.0">
-  <project timestamp="1780056951323" name="All files">
-    <metrics statements="106" coveredstatements="101" conditionals="63" coveredconditionals="53" methods="18" coveredmethods="17" elements="187" coveredelements="171" complexity="0" loc="106" ncloc="106" packages="2" files="7" classes="7"/>
+<coverage generated="1780844477256" clover="3.2.0">
+  <project timestamp="1780844477256" name="All files">
+    <metrics statements="111" coveredstatements="106" conditionals="65" coveredconditionals="55" methods="20" coveredmethods="19" elements="196" coveredelements="180" complexity="0" loc="111" ncloc="111" packages="2" files="8" classes="8"/>
     <package name="config">
       <metrics statements="43" coveredstatements="41" conditionals="19" coveredconditionals="15" methods="12" coveredmethods="11"/>
       <file name="env.ts" path="/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/config/env.ts">
@@ -23,7 +23,7 @@
         <line num="69" count="1" type="stmt"/>
         <line num="72" count="2" type="stmt"/>
         <line num="74" count="2" type="stmt"/>
-        <line num="75" count="131" type="stmt"/>
+        <line num="75" count="111" type="stmt"/>
         <line num="76" count="1" type="stmt"/>
         <line num="100" count="2" type="stmt"/>
         <line num="101" count="13" type="stmt"/>
@@ -58,7 +58,15 @@
       </file>
     </package>
     <package name="utils">
-      <metrics statements="63" coveredstatements="60" conditionals="44" coveredconditionals="38" methods="6" coveredmethods="6"/>
+      <metrics statements="68" coveredstatements="65" conditionals="46" coveredconditionals="40" methods="8" coveredmethods="8"/>
+      <file name="buildWrapperArgs.ts" path="/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/utils/buildWrapperArgs.ts">
+        <metrics statements="5" coveredstatements="5" conditionals="2" coveredconditionals="2" methods="2" coveredmethods="2"/>
+        <line num="29" count="1" type="stmt"/>
+        <line num="30" count="11" type="cond" truecount="2" falsecount="0"/>
+        <line num="31" count="3" type="stmt"/>
+        <line num="34" count="15" type="stmt"/>
+        <line num="36" count="8" type="stmt"/>
+      </file>
       <file name="checkRequiredFiles.ts" path="/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/utils/checkRequiredFiles.ts">
         <metrics statements="15" coveredstatements="15" conditionals="4" coveredconditionals="2" methods="2" coveredmethods="2"/>
         <line num="1" count="1" type="stmt"/>

package/coverage/coverage-final.json

@@ -1,6 +1,7 @@
-{"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/config/env.ts": {"path":"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/config/env.ts","statementMap":{"0":{"start":{"line":16,"column":0},"end":{"line":16,"column":16}},"1":{"start":{"line":69,"column":0},"end":{"line":69,"column":24}},"2":{"start":{"line":1,"column":0},"end":{"line":1,"column":20}},"3":{"start":{"line":2,"column":0},"end":{"line":2,"column":24}},"4":{"start":{"line":17,"column":28},"end":{"line":17,"column":39}},"5":{"start":{"line":19,"column":2},"end":{"line":21,"column":3}},"6":{"start":{"line":20,"column":4},"end":{"line":20,"column":92}},"7":{"start":{"line":23,"column":22},"end":{"line":33,"column":36}},"8":{"start":{"line":38,"column":2},"end":{"line":46,"column":5}},"9":{"start":{"line":39,"column":4},"end":{"line":45,"column":5}},"10":{"start":{"line":40,"column":6},"end":{"line":44,"column":8}},"11":{"start":{"line":48,"column":23},"end":{"line":48,"column":53}},"12":{"start":{"line":49,"column":2},"end":{"line":53,"column":26}},"13":{"start":{"line":51,"column":24},"end":{"line":51,"column":58}},"14":{"start":{"line":52,"column":21},"end":{"line":52,"column":55}},"15":{"start":{"line":72,"column":20},"end":{"line":72,"column":34}},"16":{"start":{"line":74,"column":14},"end":{"line":98,"column":6}},"17":{"start":{"line":75,"column":21},"end":{"line":75,"column":40}},"18":{"start":{"line":76,"column":26},"end":{"line":76,"column":73}},"19":{"start":{"line":100,"column":22},"end":{"line":102,"column":4}},"20":{"start":{"line":101,"column":57},"end":{"line":101,"column":112}},"21":{"start":{"line":104,"column":2},"end":{"line":104,"column":30}}},"fnMap":{"0":{"name":"getEnviroment","decl":{"start":{"line":16,"column":16},"end":{"line":16,"column":29}},"loc":{"start":{"line":16,"column":35},"end":{"line":54,"column":1}}},"1":{"name":"(anonymous_2)","decl":{"start":{"line":38,"column":22},"end":{"line":38,"column":23}},"loc":{"start":{"line":38,"column":37},"end":{"line":46,"column":3}}},"2":{"name":"(anonymous_3)","decl":{"start":{"line":51,"column":12},"end":{"line":51,"column":13}},"loc":{"start":{"line":51,"column":24},"end":{"line":51,"column":58}}},"3":{"name":"(anonymous_4)","decl":{"start":{"line":52,"column":9},"end":{"line":52,"column":10}},"loc":{"start":{"line":52,"column":21},"end":{"line":52,"column":55}}},"4":{"name":"getClientEnvironment","decl":{"start":{"line":69,"column":24},"end":{"line":69,"column":44}},"loc":{"start":{"line":69,"column":88},"end":{"line":105,"column":1}}},"5":{"name":"(anonymous_6)","decl":{"start":{"line":75,"column":12},"end":{"line":75,"column":13}},"loc":{"start":{"line":75,"column":21},"end":{"line":75,"column":40}}},"6":{"name":"(anonymous_7)","decl":{"start":{"line":76,"column":12},"end":{"line":76,"column":13}},"loc":{"start":{"line":76,"column":26},"end":{"line":76,"column":73}}},"7":{"name":"(anonymous_8)","decl":{"start":{"line":101,"column":43},"end":{"line":101,"column":44}},"loc":{"start":{"line":101,"column":57},"end":{"line":101,"column":112}}}},"branchMap":{"0":{"loc":{"start":{"line":19,"column":2},"end":{"line":21,"column":3}},"type":"if","locations":[{"start":{"line":19,"column":2},"end":{"line":21,"column":3}},{"start":{},"end":{}}]},"1":{"loc":{"start":{"line":29,"column":4},"end":{"line":29,"column":50}},"type":"binary-expr","locations":[{"start":{"line":29,"column":4},"end":{"line":29,"column":23}},{"start":{"line":29,"column":27},"end":{"line":29,"column":50}}]},"2":{"loc":{"start":{"line":39,"column":4},"end":{"line":45,"column":5}},"type":"if","locations":[{"start":{"line":39,"column":4},"end":{"line":45,"column":5}},{"start":{},"end":{}}]},"3":{"loc":{"start":{"line":49,"column":27},"end":{"line":49,"column":54}},"type":"binary-expr","locations":[{"start":{"line":49,"column":27},"end":{"line":49,"column":48}},{"start":{"line":49,"column":52},"end":{"line":49,"column":54}}]},"4":{"loc":{"start":{"line":51,"column":24},"end":{"line":51,"column":58}},"type":"binary-expr","locations":[{"start":{"line":51,"column":24},"end":{"line":51,"column":30}},{"start":{"line":51,"column":34},"end":{"line":51,"column":58}}]},"5":{"loc":{"start":{"line":79,"column":16},"end":{"line":79,"column":53}},"type":"binary-expr","locations":[{"start":{"line":79,"column":16},"end":{"line":79,"column":36}},{"start":{"line":79,"column":40},"end":{"line":79,"column":53}}]}},"s":{"0":1,"1":1,"2":1,"3":1,"4":2,"5":2,"6":1,"7":1,"8":1,"9":5,"10":0,"11":1,"12":1,"13":1,"14":0,"15":2,"16":2,"17":131,"18":1,"19":2,"20":13,"21":2},"f":{"0":2,"1":5,"2":1,"3":0,"4":2,"5":131,"6":1,"7":13},"b":{"0":[1,1],"1":[1,0],"2":[0,5],"3":[1,1],"4":[1,0],"5":[2,1]}}
+{"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/config/env.ts": {"path":"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/config/env.ts","statementMap":{"0":{"start":{"line":16,"column":0},"end":{"line":16,"column":16}},"1":{"start":{"line":69,"column":0},"end":{"line":69,"column":24}},"2":{"start":{"line":1,"column":0},"end":{"line":1,"column":20}},"3":{"start":{"line":2,"column":0},"end":{"line":2,"column":24}},"4":{"start":{"line":17,"column":28},"end":{"line":17,"column":39}},"5":{"start":{"line":19,"column":2},"end":{"line":21,"column":3}},"6":{"start":{"line":20,"column":4},"end":{"line":20,"column":92}},"7":{"start":{"line":23,"column":22},"end":{"line":33,"column":36}},"8":{"start":{"line":38,"column":2},"end":{"line":46,"column":5}},"9":{"start":{"line":39,"column":4},"end":{"line":45,"column":5}},"10":{"start":{"line":40,"column":6},"end":{"line":44,"column":8}},"11":{"start":{"line":48,"column":23},"end":{"line":48,"column":53}},"12":{"start":{"line":49,"column":2},"end":{"line":53,"column":26}},"13":{"start":{"line":51,"column":24},"end":{"line":51,"column":58}},"14":{"start":{"line":52,"column":21},"end":{"line":52,"column":55}},"15":{"start":{"line":72,"column":20},"end":{"line":72,"column":34}},"16":{"start":{"line":74,"column":14},"end":{"line":98,"column":6}},"17":{"start":{"line":75,"column":21},"end":{"line":75,"column":40}},"18":{"start":{"line":76,"column":26},"end":{"line":76,"column":73}},"19":{"start":{"line":100,"column":22},"end":{"line":102,"column":4}},"20":{"start":{"line":101,"column":57},"end":{"line":101,"column":112}},"21":{"start":{"line":104,"column":2},"end":{"line":104,"column":30}}},"fnMap":{"0":{"name":"getEnviroment","decl":{"start":{"line":16,"column":16},"end":{"line":16,"column":29}},"loc":{"start":{"line":16,"column":35},"end":{"line":54,"column":1}}},"1":{"name":"(anonymous_2)","decl":{"start":{"line":38,"column":22},"end":{"line":38,"column":23}},"loc":{"start":{"line":38,"column":37},"end":{"line":46,"column":3}}},"2":{"name":"(anonymous_3)","decl":{"start":{"line":51,"column":12},"end":{"line":51,"column":13}},"loc":{"start":{"line":51,"column":24},"end":{"line":51,"column":58}}},"3":{"name":"(anonymous_4)","decl":{"start":{"line":52,"column":9},"end":{"line":52,"column":10}},"loc":{"start":{"line":52,"column":21},"end":{"line":52,"column":55}}},"4":{"name":"getClientEnvironment","decl":{"start":{"line":69,"column":24},"end":{"line":69,"column":44}},"loc":{"start":{"line":69,"column":88},"end":{"line":105,"column":1}}},"5":{"name":"(anonymous_6)","decl":{"start":{"line":75,"column":12},"end":{"line":75,"column":13}},"loc":{"start":{"line":75,"column":21},"end":{"line":75,"column":40}}},"6":{"name":"(anonymous_7)","decl":{"start":{"line":76,"column":12},"end":{"line":76,"column":13}},"loc":{"start":{"line":76,"column":26},"end":{"line":76,"column":73}}},"7":{"name":"(anonymous_8)","decl":{"start":{"line":101,"column":43},"end":{"line":101,"column":44}},"loc":{"start":{"line":101,"column":57},"end":{"line":101,"column":112}}}},"branchMap":{"0":{"loc":{"start":{"line":19,"column":2},"end":{"line":21,"column":3}},"type":"if","locations":[{"start":{"line":19,"column":2},"end":{"line":21,"column":3}},{"start":{},"end":{}}]},"1":{"loc":{"start":{"line":29,"column":4},"end":{"line":29,"column":50}},"type":"binary-expr","locations":[{"start":{"line":29,"column":4},"end":{"line":29,"column":23}},{"start":{"line":29,"column":27},"end":{"line":29,"column":50}}]},"2":{"loc":{"start":{"line":39,"column":4},"end":{"line":45,"column":5}},"type":"if","locations":[{"start":{"line":39,"column":4},"end":{"line":45,"column":5}},{"start":{},"end":{}}]},"3":{"loc":{"start":{"line":49,"column":27},"end":{"line":49,"column":54}},"type":"binary-expr","locations":[{"start":{"line":49,"column":27},"end":{"line":49,"column":48}},{"start":{"line":49,"column":52},"end":{"line":49,"column":54}}]},"4":{"loc":{"start":{"line":51,"column":24},"end":{"line":51,"column":58}},"type":"binary-expr","locations":[{"start":{"line":51,"column":24},"end":{"line":51,"column":30}},{"start":{"line":51,"column":34},"end":{"line":51,"column":58}}]},"5":{"loc":{"start":{"line":79,"column":16},"end":{"line":79,"column":53}},"type":"binary-expr","locations":[{"start":{"line":79,"column":16},"end":{"line":79,"column":36}},{"start":{"line":79,"column":40},"end":{"line":79,"column":53}}]}},"s":{"0":1,"1":1,"2":1,"3":1,"4":2,"5":2,"6":1,"7":1,"8":1,"9":5,"10":0,"11":1,"12":1,"13":1,"14":0,"15":2,"16":2,"17":111,"18":1,"19":2,"20":13,"21":2},"f":{"0":2,"1":5,"2":1,"3":0,"4":2,"5":111,"6":1,"7":13},"b":{"0":[1,1],"1":[1,0],"2":[0,5],"3":[1,1],"4":[1,0],"5":[2,1]}}
 ,"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/config/paths.ts": {"path":"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/config/paths.ts","statementMap":{"0":{"start":{"line":70,"column":0},"end":{"line":70,"column":16}},"1":{"start":{"line":1,"column":0},"end":{"line":1,"column":20}},"2":{"start":{"line":2,"column":0},"end":{"line":2,"column":24}},"3":{"start":{"line":4,"column":0},"end":{"line":4,"column":61}},"4":{"start":{"line":45,"column":13},"end":{"line":57,"column":2}},"5":{"start":{"line":71,"column":23},"end":{"line":71,"column":48}},"6":{"start":{"line":72,"column":21},"end":{"line":72,"column":79}},"7":{"start":{"line":72,"column":39},"end":{"line":72,"column":79}},"8":{"start":{"line":74,"column":25},"end":{"line":74,"column":51}},"9":{"start":{"line":76,"column":26},"end":{"line":79,"column":null}},"10":{"start":{"line":83,"column":24},"end":{"line":91,"column":3}},"11":{"start":{"line":84,"column":22},"end":{"line":84,"column":104}},"12":{"start":{"line":84,"column":57},"end":{"line":84,"column":103}},"13":{"start":{"line":86,"column":4},"end":{"line":88,"column":5}},"14":{"start":{"line":87,"column":6},"end":{"line":87,"column":51}},"15":{"start":{"line":90,"column":4},"end":{"line":90,"column":39}},"16":{"start":{"line":93,"column":26},"end":{"line":93,"column":52}},"17":{"start":{"line":94,"column":28},"end":{"line":94,"column":58}},"18":{"start":{"line":95,"column":29},"end":{"line":95,"column":60}},"19":{"start":{"line":97,"column":23},"end":{"line":97,"column":93}},"20":{"start":{"line":99,"column":2},"end":{"line":116,"column":4}},"21":{"start":{"line":119,"column":0},"end":{"line":119,"column":32}}},"fnMap":{"0":{"name":"createAppPaths","decl":{"start":{"line":70,"column":16},"end":{"line":70,"column":30}},"loc":{"start":{"line":70,"column":63},"end":{"line":117,"column":1}}},"1":{"name":"(anonymous_2)","decl":{"start":{"line":72,"column":21},"end":{"line":72,"column":22}},"loc":{"start":{"line":72,"column":39},"end":{"line":72,"column":79}}},"2":{"name":"(anonymous_3)","decl":{"start":{"line":83,"column":24},"end":{"line":83,"column":25}},"loc":{"start":{"line":83,"column":48},"end":{"line":91,"column":3}}},"3":{"name":"(anonymous_4)","decl":{"start":{"line":84,"column":48},"end":{"line":84,"column":49}},"loc":{"start":{"line":84,"column":57},"end":{"line":84,"column":103}}}},"branchMap":{"0":{"loc":{"start":{"line":70,"column":31},"end":{"line":70,"column":63}},"type":"default-arg","locations":[{"start":{"line":70,"column":50},"end":{"line":70,"column":63}}]},"1":{"loc":{"start":{"line":86,"column":4},"end":{"line":88,"column":5}},"type":"if","locations":[{"start":{"line":86,"column":4},"end":{"line":88,"column":5}},{"start":{},"end":{}}]},"2":{"loc":{"start":{"line":97,"column":23},"end":{"line":97,"column":93}},"type":"cond-expr","locations":[{"start":{"line":97,"column":65},"end":{"line":97,"column":83}},{"start":{"line":97,"column":86},"end":{"line":97,"column":93}}]},"3":{"loc":{"start":{"line":97,"column":23},"end":{"line":97,"column":62}},"type":"binary-expr","locations":[{"start":{"line":97,"column":23},"end":{"line":97,"column":40}},{"start":{"line":97,"column":44},"end":{"line":97,"column":62}}]}},"s":{"0":2,"1":2,"2":2,"3":2,"4":2,"5":4,"6":4,"7":118,"8":4,"9":4,"10":4,"11":8,"12":62,"13":8,"14":6,"15":2,"16":4,"17":4,"18":4,"19":4,"20":4,"21":2},"f":{"0":4,"1":118,"2":8,"3":62},"b":{"0":[2],"1":[6,2],"2":[4,0],"3":[4,4]}}
 ,"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/config/shared.ts": {"path":"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/config/shared.ts","statementMap":{"0":{"start":{"line":33,"column":13},"end":{"line":42,"column":2}}},"fnMap":{},"branchMap":{},"s":{"0":1},"f":{},"b":{}}
+,"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/utils/buildWrapperArgs.ts": {"path":"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/utils/buildWrapperArgs.ts","statementMap":{"0":{"start":{"line":29,"column":0},"end":{"line":29,"column":16}},"1":{"start":{"line":30,"column":2},"end":{"line":32,"column":3}},"2":{"start":{"line":31,"column":4},"end":{"line":31,"column":33}},"3":{"start":{"line":34,"column":22},"end":{"line":34,"column":56}},"4":{"start":{"line":34,"column":45},"end":{"line":34,"column":55}},"5":{"start":{"line":36,"column":2},"end":{"line":36,"column":42}}},"fnMap":{"0":{"name":"buildWrapperArgs","decl":{"start":{"line":29,"column":16},"end":{"line":29,"column":32}},"loc":{"start":{"line":29,"column":100},"end":{"line":37,"column":1}}},"1":{"name":"(anonymous_1)","decl":{"start":{"line":34,"column":38},"end":{"line":34,"column":39}},"loc":{"start":{"line":34,"column":45},"end":{"line":34,"column":55}}}},"branchMap":{"0":{"loc":{"start":{"line":30,"column":2},"end":{"line":32,"column":3}},"type":"if","locations":[{"start":{"line":30,"column":2},"end":{"line":32,"column":3}},{"start":{},"end":{}}]}},"s":{"0":1,"1":11,"2":3,"3":8,"4":15,"5":8},"f":{"0":11,"1":15},"b":{"0":[3,8]}}
 ,"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/utils/checkRequiredFiles.ts": {"path":"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/utils/checkRequiredFiles.ts","statementMap":{"0":{"start":{"line":15,"column":0},"end":{"line":15,"column":24}},"1":{"start":{"line":1,"column":0},"end":{"line":1,"column":20}},"2":{"start":{"line":2,"column":0},"end":{"line":2,"column":24}},"3":{"start":{"line":4,"column":0},"end":{"line":4,"column":26}},"4":{"start":{"line":17,"column":2},"end":{"line":30,"column":3}},"5":{"start":{"line":18,"column":4},"end":{"line":21,"column":7}},"6":{"start":{"line":19,"column":6},"end":{"line":19,"column":33}},"7":{"start":{"line":20,"column":6},"end":{"line":20,"column":49}},"8":{"start":{"line":22,"column":4},"end":{"line":22,"column":16}},"9":{"start":{"line":24,"column":20},"end":{"line":24,"column":72}},"10":{"start":{"line":25,"column":21},"end":{"line":25,"column":74}},"11":{"start":{"line":26,"column":4},"end":{"line":26,"column":62}},"12":{"start":{"line":27,"column":4},"end":{"line":27,"column":67}},"13":{"start":{"line":28,"column":4},"end":{"line":28,"column":73}},"14":{"start":{"line":29,"column":4},"end":{"line":29,"column":17}}},"fnMap":{"0":{"name":"checkRequiredFiles","decl":{"start":{"line":15,"column":24},"end":{"line":15,"column":42}},"loc":{"start":{"line":15,"column":58},"end":{"line":31,"column":1}}},"1":{"name":"(anonymous_2)","decl":{"start":{"line":18,"column":18},"end":{"line":18,"column":19}},"loc":{"start":{"line":18,"column":31},"end":{"line":21,"column":5}}}},"branchMap":{"0":{"loc":{"start":{"line":24,"column":20},"end":{"line":24,"column":72}},"type":"cond-expr","locations":[{"start":{"line":24,"column":38},"end":{"line":24,"column":67}},{"start":{"line":24,"column":70},"end":{"line":24,"column":72}}]},"1":{"loc":{"start":{"line":25,"column":21},"end":{"line":25,"column":74}},"type":"cond-expr","locations":[{"start":{"line":25,"column":39},"end":{"line":25,"column":69}},{"start":{"line":25,"column":72},"end":{"line":25,"column":74}}]}},"s":{"0":1,"1":1,"2":1,"3":1,"4":3,"5":3,"6":4,"7":4,"8":2,"9":1,"10":1,"11":1,"12":1,"13":1,"14":1},"f":{"0":3,"1":4},"b":{"0":[1,0],"1":[1,0]}}
 ,"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/utils/formatWebpackMessages.ts": {"path":"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/utils/formatWebpackMessages.ts","statementMap":{"0":{"start":{"line":39,"column":0},"end":{"line":39,"column":24}},"1":{"start":{"line":11,"column":2},"end":{"line":11,"column":30}},"2":{"start":{"line":11,"column":20},"end":{"line":11,"column":30}},"3":{"start":{"line":12,"column":2},"end":{"line":12,"column":44}},"4":{"start":{"line":12,"column":32},"end":{"line":12,"column":44}},"5":{"start":{"line":13,"column":2},"end":{"line":26,"column":3}},"6":{"start":{"line":14,"column":20},"end":{"line":14,"column":31}},"7":{"start":{"line":15,"column":4},"end":{"line":20,"column":5}},"8":{"start":{"line":16,"column":19},"end":{"line":16,"column":21}},"9":{"start":{"line":17,"column":6},"end":{"line":17,"column":71}},"10":{"start":{"line":17,"column":30},"end":{"line":17,"column":71}},"11":{"start":{"line":18,"column":6},"end":{"line":18,"column":32}},"12":{"start":{"line":19,"column":6},"end":{"line":19,"column":20}},"13":{"start":{"line":21,"column":4},"end":{"line":25,"column":5}},"14":{"start":{"line":22,"column":6},"end":{"line":22,"column":37}},"15":{"start":{"line":24,"column":6},"end":{"line":24,"column":29}},"16":{"start":{"line":27,"column":2},"end":{"line":27,"column":22}},"17":{"start":{"line":40,"column":17},"end":{"line":40,"column":77}},"18":{"start":{"line":41,"column":19},"end":{"line":41,"column":83}},"19":{"start":{"line":42,"column":2},"end":{"line":42,"column":30}}},"fnMap":{"0":{"name":"toString","decl":{"start":{"line":10,"column":9},"end":{"line":10,"column":17}},"loc":{"start":{"line":10,"column":31},"end":{"line":28,"column":1}}},"1":{"name":"formatWebpackMessages","decl":{"start":{"line":39,"column":24},"end":{"line":39,"column":45}},"loc":{"start":{"line":39,"column":55},"end":{"line":43,"column":1}}}},"branchMap":{"0":{"loc":{"start":{"line":11,"column":2},"end":{"line":11,"column":30}},"type":"if","locations":[{"start":{"line":11,"column":2},"end":{"line":11,"column":30}},{"start":{},"end":{}}]},"1":{"loc":{"start":{"line":12,"column":2},"end":{"line":12,"column":44}},"type":"if","locations":[{"start":{"line":12,"column":2},"end":{"line":12,"column":44}},{"start":{},"end":{}}]},"2":{"loc":{"start":{"line":13,"column":2},"end":{"line":26,"column":3}},"type":"if","locations":[{"start":{"line":13,"column":2},"end":{"line":26,"column":3}},{"start":{},"end":{}}]},"3":{"loc":{"start":{"line":15,"column":4},"end":{"line":20,"column":5}},"type":"if","locations":[{"start":{"line":15,"column":4},"end":{"line":20,"column":5}},{"start":{},"end":{}}]},"4":{"loc":{"start":{"line":17,"column":6},"end":{"line":17,"column":71}},"type":"if","locations":[{"start":{"line":17,"column":6},"end":{"line":17,"column":71}},{"start":{},"end":{}}]},"5":{"loc":{"start":{"line":40,"column":17},"end":{"line":40,"column":77}},"type":"cond-expr","locations":[{"start":{"line":40,"column":47},"end":{"line":40,"column":72}},{"start":{"line":40,"column":75},"end":{"line":40,"column":77}}]},"6":{"loc":{"start":{"line":41,"column":19},"end":{"line":41,"column":83}},"type":"cond-expr","locations":[{"start":{"line":41,"column":51},"end":{"line":41,"column":78}},{"start":{"line":41,"column":81},"end":{"line":41,"column":83}}]}},"s":{"0":1,"1":7,"2":0,"3":7,"4":2,"5":5,"6":3,"7":3,"8":2,"9":2,"10":1,"11":2,"12":2,"13":1,"14":1,"15":0,"16":2,"17":7,"18":7,"19":7},"f":{"0":7,"1":7},"b":{"0":[0,7],"1":[2,5],"2":[3,2],"3":[2,1],"4":[1,1],"5":[4,3],"6":[2,5]}}
 ,"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/utils/getPublicUrlOrPath.ts": {"path":"/Volumes/External-Fedbalves/Projects/apollion/packages/scripts/src/utils/getPublicUrlOrPath.ts","statementMap":{"0":{"start":{"line":22,"column":0},"end":{"line":22,"column":24}},"1":{"start":{"line":1,"column":0},"end":{"line":1,"column":26}},"2":{"start":{"line":27,"column":21},"end":{"line":27,"column":51}},"3":{"start":{"line":29,"column":2},"end":{"line":38,"column":3}},"4":{"start":{"line":30,"column":21},"end":{"line":30,"column":33}},"5":{"start":{"line":31,"column":4},"end":{"line":31,"column":53}},"6":{"start":{"line":31,"column":35},"end":{"line":31,"column":53}},"7":{"start":{"line":32,"column":4},"end":{"line":37,"column":5}},"8":{"start":{"line":33,"column":29},"end":{"line":33,"column":60}},"9":{"start":{"line":34,"column":6},"end":{"line":34,"column":106}},"10":{"start":{"line":36,"column":6},"end":{"line":36,"column":24}},"11":{"start":{"line":40,"column":2},"end":{"line":55,"column":3}},"12":{"start":{"line":41,"column":21},"end":{"line":41,"column":29}},"13":{"start":{"line":42,"column":4},"end":{"line":42,"column":53}},"14":{"start":{"line":42,"column":35},"end":{"line":42,"column":53}},"15":{"start":{"line":43,"column":4},"end":{"line":54,"column":5}},"16":{"start":{"line":44,"column":36},"end":{"line":44,"column":76}},"17":{"start":{"line":45,"column":6},"end":{"line":51,"column":34}},"18":{"start":{"line":53,"column":6},"end":{"line":53,"column":24}},"19":{"start":{"line":57,"column":2},"end":{"line":57,"column":13}}},"fnMap":{"0":{"name":"getPublicUrlOrPath","decl":{"start":{"line":22,"column":24},"end":{"line":22,"column":42}},"loc":{"start":{"line":25,"column":34},"end":{"line":58,"column":1}}}},"branchMap":{"0":{"loc":{"start":{"line":29,"column":2},"end":{"line":38,"column":3}},"type":"if","locations":[{"start":{"line":29,"column":2},"end":{"line":38,"column":3}},{"start":{},"end":{}}]},"1":{"loc":{"start":{"line":31,"column":4},"end":{"line":31,"column":53}},"type":"if","locations":[{"start":{"line":31,"column":4},"end":{"line":31,"column":53}},{"start":{},"end":{}}]},"2":{"loc":{"start":{"line":34,"column":13},"end":{"line":34,"column":105}},"type":"cond-expr","locations":[{"start":{"line":34,"column":33},"end":{"line":34,"column":91}},{"start":{"line":34,"column":95},"end":{"line":34,"column":105}}]},"3":{"loc":{"start":{"line":34,"column":33},"end":{"line":34,"column":91}},"type":"cond-expr","locations":[{"start":{"line":34,"column":62},"end":{"line":34,"column":65}},{"start":{"line":34,"column":68},"end":{"line":34,"column":91}}]},"4":{"loc":{"start":{"line":40,"column":2},"end":{"line":55,"column":3}},"type":"if","locations":[{"start":{"line":40,"column":2},"end":{"line":55,"column":3}},{"start":{},"end":{}}]},"5":{"loc":{"start":{"line":42,"column":4},"end":{"line":42,"column":53}},"type":"if","locations":[{"start":{"line":42,"column":4},"end":{"line":42,"column":53}},{"start":{},"end":{}}]},"6":{"loc":{"start":{"line":45,"column":13},"end":{"line":51,"column":33}},"type":"cond-expr","locations":[{"start":{"line":46,"column":10},"end":{"line":48,"column":33}},{"start":{"line":49,"column":10},"end":{"line":51,"column":33}}]},"7":{"loc":{"start":{"line":46,"column":10},"end":{"line":48,"column":33}},"type":"cond-expr","locations":[{"start":{"line":47,"column":12},"end":{"line":47,"column":15}},{"start":{"line":48,"column":12},"end":{"line":48,"column":33}}]},"8":{"loc":{"start":{"line":49,"column":10},"end":{"line":51,"column":33}},"type":"cond-expr","locations":[{"start":{"line":50,"column":12},"end":{"line":50,"column":22}},{"start":{"line":51,"column":12},"end":{"line":51,"column":33}}]}},"s":{"0":3,"1":3,"2":12,"3":12,"4":3,"5":3,"6":1,"7":3,"8":3,"9":3,"10":0,"11":9,"12":7,"13":7,"14":1,"15":7,"16":7,"17":7,"18":0,"19":2},"f":{"0":12},"b":{"0":[3,9],"1":[1,2],"2":[2,1],"3":[1,1],"4":[7,2],"5":[1,6],"6":[1,6],"7":[0,1],"8":[1,5]}}

package/coverage/lcov-report/config/env.ts.html

@@ -242,7 +242,7 @@
 <span class="cline-any cline-yes">2x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">131x</span>
+<span class="cline-any cline-yes">111x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -385,7 +385,7 @@ export default function getClientEnvironment(publicUrl: string, config: CustomCo
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-29T12:15:51.314Z
+                at 2026-06-07T15:01:17.247Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/config/index.html

@@ -131,7 +131,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-29T12:15:51.314Z
+                at 2026-06-07T15:01:17.247Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/config/paths.ts.html

@@ -427,7 +427,7 @@ export default createAppPaths();
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-29T12:15:51.314Z
+                at 2026-06-07T15:01:17.247Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/config/shared.ts.html

@@ -196,7 +196,7 @@ export const defaultDevConfig = {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-29T12:15:51.314Z
+                at 2026-06-07T15:01:17.247Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/index.html

@@ -23,30 +23,30 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">94.69% </span>
+                <span class="strong">94.95% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>107/113</span>
+                <span class='fraction'>113/119</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">84.12% </span>
+                <span class="strong">84.61% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>53/63</span>
+                <span class='fraction'>55/65</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">94.44% </span>
+                <span class="strong">95% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>17/18</span>
+                <span class='fraction'>19/20</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">95.28% </span>
+                <span class="strong">95.49% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>101/106</span>
+                <span class='fraction'>106/111</span>
             </div>
         
             
@@ -95,17 +95,17 @@
 
 <tr>
 	<td class="file high" data-value="utils"><a href="utils/index.html">utils</a></td>
-	<td data-value="94.11" class="pic high">
+	<td data-value="94.59" class="pic high">
 	<div class="chart"><div class="cover-fill" style="width: 94%"></div><div class="cover-empty" style="width: 6%"></div></div>
 	</td>
-	<td data-value="94.11" class="pct high">94.11%</td>
-	<td data-value="68" class="abs high">64/68</td>
-	<td data-value="86.36" class="pct high">86.36%</td>
-	<td data-value="44" class="abs high">38/44</td>
+	<td data-value="94.59" class="pct high">94.59%</td>
+	<td data-value="74" class="abs high">70/74</td>
+	<td data-value="86.95" class="pct high">86.95%</td>
+	<td data-value="46" class="abs high">40/46</td>
 	<td data-value="100" class="pct high">100%</td>
-	<td data-value="6" class="abs high">6/6</td>
-	<td data-value="95.23" class="pct high">95.23%</td>
-	<td data-value="63" class="abs high">60/63</td>
+	<td data-value="8" class="abs high">8/8</td>
+	<td data-value="95.58" class="pct high">95.58%</td>
+	<td data-value="68" class="abs high">65/68</td>
 	</tr>
 
 </tbody>
@@ -116,7 +116,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-29T12:15:51.314Z
+                at 2026-06-07T15:01:17.247Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/utils/buildWrapperArgs.ts.html

@@ -0,0 +1,196 @@
+
+<!doctype html>
+<html lang="en">
+
+<head>
+    <title>Code coverage report for utils/buildWrapperArgs.ts</title>
+    <meta charset="utf-8" />
+    <link rel="stylesheet" href="../prettify.css" />
+    <link rel="stylesheet" href="../base.css" />
+    <link rel="shortcut icon" type="image/x-icon" href="../favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style type='text/css'>
+        .coverage-summary .sorter {
+            background-image: url(../sort-arrow-sprite.png);
+        }
+    </style>
+</head>
+    
+<body>
+<div class='wrapper'>
+    <div class='pad1'>
+        <h1><a href="../index.html">All files</a> / <a href="index.html">utils</a> buildWrapperArgs.ts</h1>
+        <div class='clearfix'>
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>6/6</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>2/2</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>2/2</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>5/5</span>
+            </div>
+        
+            
+        </div>
+        <p class="quiet">
+            Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
+        </p>
+        <template id="filterTemplate">
+            <div class="quiet">
+                Filter:
+                <input type="search" id="fileSearch">
+            </div>
+        </template>
+    </div>
+    <div class='status-line high'></div>
+    <pre><table class="coverage">
+<tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
+<a name='L2'></a><a href='#L2'>2</a>
+<a name='L3'></a><a href='#L3'>3</a>
+<a name='L4'></a><a href='#L4'>4</a>
+<a name='L5'></a><a href='#L5'>5</a>
+<a name='L6'></a><a href='#L6'>6</a>
+<a name='L7'></a><a href='#L7'>7</a>
+<a name='L8'></a><a href='#L8'>8</a>
+<a name='L9'></a><a href='#L9'>9</a>
+<a name='L10'></a><a href='#L10'>10</a>
+<a name='L11'></a><a href='#L11'>11</a>
+<a name='L12'></a><a href='#L12'>12</a>
+<a name='L13'></a><a href='#L13'>13</a>
+<a name='L14'></a><a href='#L14'>14</a>
+<a name='L15'></a><a href='#L15'>15</a>
+<a name='L16'></a><a href='#L16'>16</a>
+<a name='L17'></a><a href='#L17'>17</a>
+<a name='L18'></a><a href='#L18'>18</a>
+<a name='L19'></a><a href='#L19'>19</a>
+<a name='L20'></a><a href='#L20'>20</a>
+<a name='L21'></a><a href='#L21'>21</a>
+<a name='L22'></a><a href='#L22'>22</a>
+<a name='L23'></a><a href='#L23'>23</a>
+<a name='L24'></a><a href='#L24'>24</a>
+<a name='L25'></a><a href='#L25'>25</a>
+<a name='L26'></a><a href='#L26'>26</a>
+<a name='L27'></a><a href='#L27'>27</a>
+<a name='L28'></a><a href='#L28'>28</a>
+<a name='L29'></a><a href='#L29'>29</a>
+<a name='L30'></a><a href='#L30'>30</a>
+<a name='L31'></a><a href='#L31'>31</a>
+<a name='L32'></a><a href='#L32'>32</a>
+<a name='L33'></a><a href='#L33'>33</a>
+<a name='L34'></a><a href='#L34'>34</a>
+<a name='L35'></a><a href='#L35'>35</a>
+<a name='L36'></a><a href='#L36'>36</a>
+<a name='L37'></a><a href='#L37'>37</a>
+<a name='L38'></a><a href='#L38'>38</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">11x</span>
+<span class="cline-any cline-yes">3x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">15x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">8x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">/**
+ * Build the argv passed to an underlying CLI (eslint, prettier) for a
+ * `scripts &lt;cmd&gt;` wrapper, from the user-provided argv.
+ *
+ * - Empty input → `defaults` verbatim (the canonical no-args
+ *   invocation, e.g. `['src', '--quiet']` for lint).
+ * - Non-empty input → user args (with the POSIX `--` end-of-options
+ *   marker removed) followed by `target`.
+ *
+ * The previous heuristic tried to detect "user-provided path" by
+ * scanning for any argv entry not starting with `-`, then handed full
+ * control to the user. That broke two real consumer invocations:
+ *
+ * 1. `scripts lint --max-warnings 0` — the `0` value of the flag was
+ *    misread as a path, so `src` was dropped and ESLint ran with no
+ *    files.
+ * 2. `scripts lint -- --fix` — every arg started with `-`, so `src`
+ *    was appended, but the surviving `--` separator forced ESLint to
+ *    treat `--fix` and `src` as positional files.
+ *
+ * The wrapper is intentionally narrow: pass flags, get the default
+ * target. Consumers that need a non-default target should invoke the
+ * underlying CLI directly (`node_modules/.bin/eslint &lt;path&gt;`).
+ *
+ * @param userArgs - argv after `scripts &lt;cmd&gt;` (i.e. `process.argv.slice(2)`).
+ * @param options.defaults - argv to use when `userArgs` is empty.
+ * @param options.target - path/glob appended after user flags otherwise.
+ */
+export function buildWrapperArgs(userArgs: string[], options: { defaults: string[]; target: string }): string[] {
+  if (userArgs.length === 0) {
+    return [...options.defaults];
+  }
+&nbsp;
+  const passthrough = userArgs.filter((a) =&gt; a !== '--');
+&nbsp;
+  return [...passthrough, options.target];
+}
+&nbsp;</pre></td></tr></table></pre>
+
+                <div class='push'></div><!-- for sticky footer -->
+            </div><!-- /wrapper -->
+            <div class='footer quiet pad2 space-top1 center small'>
+                Code coverage generated by
+                <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
+                at 2026-06-07T15:01:17.247Z
+            </div>
+        <script src="../prettify.js"></script>
+        <script>
+            window.onload = function () {
+                prettyPrint();
+            };
+        </script>
+        <script src="../sorter.js"></script>
+        <script src="../block-navigation.js"></script>
+    </body>
+</html>
+    

package/coverage/lcov-report/utils/checkRequiredFiles.ts.html

@@ -163,7 +163,7 @@ export default function checkRequiredFiles(files: string[]): boolean {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-29T12:15:51.314Z
+                at 2026-06-07T15:01:17.247Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/utils/formatWebpackMessages.ts.html

@@ -199,7 +199,7 @@ export default function formatWebpackMessages(json: any): FormattedMessages {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-29T12:15:51.314Z
+                at 2026-06-07T15:01:17.247Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/utils/getPublicUrlOrPath.ts.html

@@ -244,7 +244,7 @@ export default function getPublicUrlOrPath(
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-29T12:15:51.314Z
+                at 2026-06-07T15:01:17.247Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/utils/index.html

@@ -23,30 +23,30 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">94.11% </span>
+                <span class="strong">94.59% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>64/68</span>
+                <span class='fraction'>70/74</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">86.36% </span>
+                <span class="strong">86.95% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>38/44</span>
+                <span class='fraction'>40/46</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
                 <span class="strong">100% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>6/6</span>
+                <span class='fraction'>8/8</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">95.23% </span>
+                <span class="strong">95.58% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>60/63</span>
+                <span class='fraction'>65/68</span>
             </div>
         
             
@@ -79,6 +79,21 @@
 </tr>
 </thead>
 <tbody><tr>
+	<td class="file high" data-value="buildWrapperArgs.ts"><a href="buildWrapperArgs.ts.html">buildWrapperArgs.ts</a></td>
+	<td data-value="100" class="pic high">
+	<div class="chart"><div class="cover-fill cover-full" style="width: 100%"></div><div class="cover-empty" style="width: 0%"></div></div>
+	</td>
+	<td data-value="100" class="pct high">100%</td>
+	<td data-value="6" class="abs high">6/6</td>
+	<td data-value="100" class="pct high">100%</td>
+	<td data-value="2" class="abs high">2/2</td>
+	<td data-value="100" class="pct high">100%</td>
+	<td data-value="2" class="abs high">2/2</td>
+	<td data-value="100" class="pct high">100%</td>
+	<td data-value="5" class="abs high">5/5</td>
+	</tr>
+
+<tr>
 	<td class="file high" data-value="checkRequiredFiles.ts"><a href="checkRequiredFiles.ts.html">checkRequiredFiles.ts</a></td>
 	<td data-value="100" class="pic high">
 	<div class="chart"><div class="cover-fill cover-full" style="width: 100%"></div><div class="cover-empty" style="width: 0%"></div></div>
@@ -146,7 +161,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-29T12:15:51.314Z
+                at 2026-06-07T15:01:17.247Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/utils/resolveBin.ts.html

@@ -178,7 +178,7 @@ export function resolveBin(pkgName: string, binName: string = <span class="branc
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-29T12:15:51.314Z
+                at 2026-06-07T15:01:17.247Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov.info

@@ -15,7 +15,7 @@ FNDA:5,(anonymous_2)
 FNDA:1,(anonymous_3)
 FNDA:0,(anonymous_4)
 FNDA:2,getClientEnvironment
-FNDA:131,(anonymous_6)
+FNDA:111,(anonymous_6)
 FNDA:1,(anonymous_7)
 FNDA:13,(anonymous_8)
 DA:1,1
@@ -35,7 +35,7 @@ DA:52,0
 DA:69,1
 DA:72,2
 DA:74,2
-DA:75,131
+DA:75,111
 DA:76,1
 DA:100,2
 DA:101,13
@@ -112,6 +112,26 @@ BRF:0
 BRH:0
 end_of_record
 TN:
+SF:src/utils/buildWrapperArgs.ts
+FN:29,buildWrapperArgs
+FN:34,(anonymous_1)
+FNF:2
+FNH:2
+FNDA:11,buildWrapperArgs
+FNDA:15,(anonymous_1)
+DA:29,1
+DA:30,11
+DA:31,3
+DA:34,15
+DA:36,8
+LF:5
+LH:5
+BRDA:30,0,0,3
+BRDA:30,0,1,8
+BRF:2
+BRH:2
+end_of_record
+TN:
 SF:src/utils/checkRequiredFiles.ts
 FN:15,checkRequiredFiles
 FN:18,(anonymous_2)

package/lib/command/lint.js

@@ -4,28 +4,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const cross_spawn_1 = __importDefault(require("cross-spawn"));
+const buildWrapperArgs_1 = require("../utils/buildWrapperArgs");
 const resolveBin_1 = require("../utils/resolveBin");
 /**
- * `scripts lint` — ESLint over `src` with `--quiet`. ESLint 9 flat
- * config uses `eslint.config.js#files` for filtering (no `--ext`).
+ * `scripts lint` — ESLint over `src`. ESLint 9 flat config uses
+ * `eslint.config.js#files` for filtering (no `--ext`).
  *
- * If the consumer passes any path-like arg, they own the invocation
- * entirely. Flag-only invocations (e.g. `scripts lint --fix`) keep the
- * default `src` target so the common case Just Works.
+ * Flag args pass through; the default `src` target is always appended
+ * so the common case (`scripts lint --fix`, `scripts lint
+ * --max-warnings 0`, `scripts lint -- --fix`) Just Works. Consumers
+ * that need a different target should call `eslint` directly from
+ * `node_modules/.bin`.
  */
 const eslintBin = (0, resolveBin_1.resolveBin)('eslint');
 const userArgs = process.argv.slice(2);
-const userProvidedPath = userArgs.some((a) => !a.startsWith('-'));
-let args;
-if (userArgs.length === 0) {
-    args = ['src', '--quiet'];
-}
-else if (userProvidedPath) {
-    args = userArgs;
-}
-else {
-    args = [...userArgs, 'src'];
-}
+const args = (0, buildWrapperArgs_1.buildWrapperArgs)(userArgs, {
+    defaults: ['src', '--quiet'],
+    target: 'src',
+});
 const result = cross_spawn_1.default.sync(process.execPath, [eslintBin, ...args], { stdio: 'inherit' });
 process.exit(result.status ?? 1);
 //# sourceMappingURL=lint.js.map

package/lib/command/lint.js.map

@@ -1 +1 @@
-{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/command/lint.ts"],"names":[],"mappings":";;;;;AAAA,8DAAgC;AAEhC,oDAAiD;AAEjD;;;;;;;GAOG;AACH,MAAM,SAAS,GAAG,IAAA,uBAAU,EAAC,QAAQ,CAAC,CAAC;AAEvC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEvC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AAElE,IAAI,IAAc,CAAC;AAEnB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC1B,IAAI,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAC5B,CAAC;KAAM,IAAI,gBAAgB,EAAE,CAAC;IAC5B,IAAI,GAAG,QAAQ,CAAC;AAClB,CAAC;KAAM,CAAC;IACN,IAAI,GAAG,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,MAAM,GAAG,qBAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AAExF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC"}
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/command/lint.ts"],"names":[],"mappings":";;;;;AAAA,8DAAgC;AAEhC,gEAA6D;AAC7D,oDAAiD;AAEjD;;;;;;;;;GASG;AACH,MAAM,SAAS,GAAG,IAAA,uBAAU,EAAC,QAAQ,CAAC,CAAC;AAEvC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEvC,MAAM,IAAI,GAAG,IAAA,mCAAgB,EAAC,QAAQ,EAAE;IACtC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC;IAC5B,MAAM,EAAE,KAAK;CACd,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,qBAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AAExF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC"}

package/lib/command/prettier.js

@@ -4,28 +4,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const cross_spawn_1 = __importDefault(require("cross-spawn"));
+const buildWrapperArgs_1 = require("../utils/buildWrapperArgs");
 const resolveBin_1 = require("../utils/resolveBin");
 /**
  * `scripts prettier` — `--check` over `src/**\/*.{ts,tsx,json,css,md}`.
  *
- * Flag-only user args (e.g. `scripts prettier --write`) keep the default
- * glob so `--write` is enough. A path-like arg switches to fully
- * user-controlled invocation.
+ * Flag args pass through; the default glob is always appended so
+ * `scripts prettier --write` Just Works. Consumers that need a
+ * different target should call `prettier` directly from
+ * `node_modules/.bin`.
  */
 const prettierBin = (0, resolveBin_1.resolveBin)('prettier');
 const DEFAULT_GLOB = 'src/**/*.{ts,tsx,json,css,md}';
 const userArgs = process.argv.slice(2);
-const userProvidedPath = userArgs.some((a) => !a.startsWith('-'));
-let args;
-if (userArgs.length === 0) {
-    args = ['--check', DEFAULT_GLOB];
-}
-else if (userProvidedPath) {
-    args = userArgs;
-}
-else {
-    args = [...userArgs, DEFAULT_GLOB];
-}
+const args = (0, buildWrapperArgs_1.buildWrapperArgs)(userArgs, {
+    defaults: ['--check', DEFAULT_GLOB],
+    target: DEFAULT_GLOB,
+});
 const result = cross_spawn_1.default.sync(process.execPath, [prettierBin, ...args], { stdio: 'inherit' });
 process.exit(result.status ?? 1);
 //# sourceMappingURL=prettier.js.map

package/lib/command/prettier.js.map

@@ -1 +1 @@
-{"version":3,"file":"prettier.js","sourceRoot":"","sources":["../../src/command/prettier.ts"],"names":[],"mappings":";;;;;AAAA,8DAAgC;AAEhC,oDAAiD;AAEjD;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,IAAA,uBAAU,EAAC,UAAU,CAAC,CAAC;AAE3C,MAAM,YAAY,GAAG,+BAA+B,CAAC;AAErD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEvC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AAElE,IAAI,IAAc,CAAC;AAEnB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC1B,IAAI,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AACnC,CAAC;KAAM,IAAI,gBAAgB,EAAE,CAAC;IAC5B,IAAI,GAAG,QAAQ,CAAC;AAClB,CAAC;KAAM,CAAC;IACN,IAAI,GAAG,CAAC,GAAG,QAAQ,EAAE,YAAY,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,MAAM,GAAG,qBAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AAE1F,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC"}
+{"version":3,"file":"prettier.js","sourceRoot":"","sources":["../../src/command/prettier.ts"],"names":[],"mappings":";;;;;AAAA,8DAAgC;AAEhC,gEAA6D;AAC7D,oDAAiD;AAEjD;;;;;;;GAOG;AACH,MAAM,WAAW,GAAG,IAAA,uBAAU,EAAC,UAAU,CAAC,CAAC;AAE3C,MAAM,YAAY,GAAG,+BAA+B,CAAC;AAErD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEvC,MAAM,IAAI,GAAG,IAAA,mCAAgB,EAAC,QAAQ,EAAE;IACtC,QAAQ,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC;IACnC,MAAM,EAAE,YAAY;CACrB,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,qBAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AAE1F,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC"}

package/lib/utils/buildWrapperArgs.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Build the argv passed to an underlying CLI (eslint, prettier) for a
+ * `scripts <cmd>` wrapper, from the user-provided argv.
+ *
+ * - Empty input → `defaults` verbatim (the canonical no-args
+ *   invocation, e.g. `['src', '--quiet']` for lint).
+ * - Non-empty input → user args (with the POSIX `--` end-of-options
+ *   marker removed) followed by `target`.
+ *
+ * The previous heuristic tried to detect "user-provided path" by
+ * scanning for any argv entry not starting with `-`, then handed full
+ * control to the user. That broke two real consumer invocations:
+ *
+ * 1. `scripts lint --max-warnings 0` — the `0` value of the flag was
+ *    misread as a path, so `src` was dropped and ESLint ran with no
+ *    files.
+ * 2. `scripts lint -- --fix` — every arg started with `-`, so `src`
+ *    was appended, but the surviving `--` separator forced ESLint to
+ *    treat `--fix` and `src` as positional files.
+ *
+ * The wrapper is intentionally narrow: pass flags, get the default
+ * target. Consumers that need a non-default target should invoke the
+ * underlying CLI directly (`node_modules/.bin/eslint <path>`).
+ *
+ * @param userArgs - argv after `scripts <cmd>` (i.e. `process.argv.slice(2)`).
+ * @param options.defaults - argv to use when `userArgs` is empty.
+ * @param options.target - path/glob appended after user flags otherwise.
+ */
+export declare function buildWrapperArgs(userArgs: string[], options: {
+    defaults: string[];
+    target: string;
+}): string[];

package/lib/utils/buildWrapperArgs.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildWrapperArgs = buildWrapperArgs;
+/**
+ * Build the argv passed to an underlying CLI (eslint, prettier) for a
+ * `scripts <cmd>` wrapper, from the user-provided argv.
+ *
+ * - Empty input → `defaults` verbatim (the canonical no-args
+ *   invocation, e.g. `['src', '--quiet']` for lint).
+ * - Non-empty input → user args (with the POSIX `--` end-of-options
+ *   marker removed) followed by `target`.
+ *
+ * The previous heuristic tried to detect "user-provided path" by
+ * scanning for any argv entry not starting with `-`, then handed full
+ * control to the user. That broke two real consumer invocations:
+ *
+ * 1. `scripts lint --max-warnings 0` — the `0` value of the flag was
+ *    misread as a path, so `src` was dropped and ESLint ran with no
+ *    files.
+ * 2. `scripts lint -- --fix` — every arg started with `-`, so `src`
+ *    was appended, but the surviving `--` separator forced ESLint to
+ *    treat `--fix` and `src` as positional files.
+ *
+ * The wrapper is intentionally narrow: pass flags, get the default
+ * target. Consumers that need a non-default target should invoke the
+ * underlying CLI directly (`node_modules/.bin/eslint <path>`).
+ *
+ * @param userArgs - argv after `scripts <cmd>` (i.e. `process.argv.slice(2)`).
+ * @param options.defaults - argv to use when `userArgs` is empty.
+ * @param options.target - path/glob appended after user flags otherwise.
+ */
+function buildWrapperArgs(userArgs, options) {
+    if (userArgs.length === 0) {
+        return [...options.defaults];
+    }
+    const passthrough = userArgs.filter((a) => a !== '--');
+    return [...passthrough, options.target];
+}
+//# sourceMappingURL=buildWrapperArgs.js.map

package/lib/utils/buildWrapperArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildWrapperArgs.js","sourceRoot":"","sources":["../../src/utils/buildWrapperArgs.ts"],"names":[],"mappings":";;AA4BA,4CAQC;AApCD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,gBAAgB,CAAC,QAAkB,EAAE,OAA+C;IAClG,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAEvD,OAAO,CAAC,GAAG,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/llms.txt

@@ -21,8 +21,12 @@ behind four commands: `create`, `dev`, `build`, `test`.
 | `audit` | `yarn npm audit --severity moderate --no-deprecations` (falls back to `npm audit --audit-level=moderate`) |
 | `validate` | Pre-merge gate: `check-types` + `prettier` + `lint` in parallel, then `test --watchAll=false`. `--skip=lint,prettier` to drop steps. |
 
-Every command accepts pass-through args — `scripts lint -- --fix`,
-`scripts prettier -- --write src/`, `scripts check-types -- -p tsconfig.build.json`, etc.
+Every command accepts pass-through args — `scripts lint --fix`,
+`scripts prettier --write`, `scripts check-types -p tsconfig.build.json`, etc.
+Do **not** use the POSIX `--` end-of-options separator: `lint` and
+`prettier` always append the default target (`src` / the default glob),
+so `eslint -- --fix src` would treat `--fix` and `src` as positional
+files. Pass flags directly.
 
 Use via `package.json#scripts` — the whole consumer file becomes thin:
 
@@ -33,8 +37,9 @@ Use via `package.json#scripts` — the whole consumer file becomes thin:
     "build": "scripts build",
     "test": "scripts test",
     "lint": "scripts lint",
-    "lint:fix": "scripts lint -- --fix",
+    "lint:fix": "scripts lint --fix",
     "prettier": "scripts prettier",
+    "format": "scripts prettier --write",
     "check-types": "scripts check-types",
     "audit-dependencies": "scripts audit",
     "validate": "scripts validate"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apollion-dsi/scripts",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Apollion Framework CLI",
   "main": "lib/index.js",
   "bin": "lib/bin.js",

package/src/__tests__/buildWrapperArgs.test.ts

@@ -0,0 +1,73 @@
+import { buildWrapperArgs } from '../utils/buildWrapperArgs';
+
+describe('buildWrapperArgs', () => {
+  const lintOptions = { defaults: ['src', '--quiet'], target: 'src' };
+  const prettierOptions = {
+    defaults: ['--check', 'src/**/*.{ts,tsx,json,css,md}'],
+    target: 'src/**/*.{ts,tsx,json,css,md}',
+  };
+
+  describe('lint wrapper semantics', () => {
+    it('falls back to defaults when no user args', () => {
+      expect(buildWrapperArgs([], lintOptions)).toEqual(['src', '--quiet']);
+    });
+
+    it('returns a fresh defaults copy (does not alias the input array)', () => {
+      const defaults = ['src', '--quiet'];
+      const result = buildWrapperArgs([], { defaults, target: 'src' });
+
+      expect(result).not.toBe(defaults);
+    });
+
+    it('appends target after a single flag (lint --fix)', () => {
+      expect(buildWrapperArgs(['--fix'], lintOptions)).toEqual(['--fix', 'src']);
+    });
+
+    it('appends target after --flag=value form', () => {
+      expect(buildWrapperArgs(['--max-warnings=0'], lintOptions)).toEqual(['--max-warnings=0', 'src']);
+    });
+
+    it('appends target after --flag value (space-separated) form', () => {
+      // Regression: previously the literal `0` was misread as a path,
+      // dropping `src` from the eslint invocation so it ran with no files.
+      expect(buildWrapperArgs(['--max-warnings', '0'], lintOptions)).toEqual(['--max-warnings', '0', 'src']);
+    });
+
+    it('strips a POSIX `--` end-of-options marker before appending target', () => {
+      // Regression: the `--` previously survived into argv, so eslint
+      // treated `--fix` and `src` as positional file arguments and failed
+      // with "No files matching pattern '--fix'".
+      expect(buildWrapperArgs(['--', '--fix'], lintOptions)).toEqual(['--fix', 'src']);
+    });
+
+    it('strips multiple `--` markers (defensive)', () => {
+      expect(buildWrapperArgs(['--', '--fix', '--'], lintOptions)).toEqual(['--fix', 'src']);
+    });
+
+    it('preserves the order of user flags', () => {
+      expect(buildWrapperArgs(['--cache', '--max-warnings=0', '--fix'], lintOptions)).toEqual([
+        '--cache',
+        '--max-warnings=0',
+        '--fix',
+        'src',
+      ]);
+    });
+  });
+
+  describe('prettier wrapper semantics', () => {
+    it('falls back to --check + DEFAULT_GLOB when no user args', () => {
+      expect(buildWrapperArgs([], prettierOptions)).toEqual(['--check', 'src/**/*.{ts,tsx,json,css,md}']);
+    });
+
+    it('appends DEFAULT_GLOB after --write', () => {
+      expect(buildWrapperArgs(['--write'], prettierOptions)).toEqual(['--write', 'src/**/*.{ts,tsx,json,css,md}']);
+    });
+
+    it('strips the `--` separator before appending DEFAULT_GLOB', () => {
+      expect(buildWrapperArgs(['--', '--write'], prettierOptions)).toEqual([
+        '--write',
+        'src/**/*.{ts,tsx,json,css,md}',
+      ]);
+    });
+  });
+});

package/src/command/lint.ts

@@ -1,30 +1,26 @@
 import spawn from 'cross-spawn';
 
+import { buildWrapperArgs } from '../utils/buildWrapperArgs';
 import { resolveBin } from '../utils/resolveBin';
 
 /**
- * `scripts lint` — ESLint over `src` with `--quiet`. ESLint 9 flat
- * config uses `eslint.config.js#files` for filtering (no `--ext`).
+ * `scripts lint` — ESLint over `src`. ESLint 9 flat config uses
+ * `eslint.config.js#files` for filtering (no `--ext`).
  *
- * If the consumer passes any path-like arg, they own the invocation
- * entirely. Flag-only invocations (e.g. `scripts lint --fix`) keep the
- * default `src` target so the common case Just Works.
+ * Flag args pass through; the default `src` target is always appended
+ * so the common case (`scripts lint --fix`, `scripts lint
+ * --max-warnings 0`, `scripts lint -- --fix`) Just Works. Consumers
+ * that need a different target should call `eslint` directly from
+ * `node_modules/.bin`.
  */
 const eslintBin = resolveBin('eslint');
 
 const userArgs = process.argv.slice(2);
 
-const userProvidedPath = userArgs.some((a) => !a.startsWith('-'));
-
-let args: string[];
-
-if (userArgs.length === 0) {
-  args = ['src', '--quiet'];
-} else if (userProvidedPath) {
-  args = userArgs;
-} else {
-  args = [...userArgs, 'src'];
-}
+const args = buildWrapperArgs(userArgs, {
+  defaults: ['src', '--quiet'],
+  target: 'src',
+});
 
 const result = spawn.sync(process.execPath, [eslintBin, ...args], { stdio: 'inherit' });
 

package/src/command/prettier.ts

@@ -1,13 +1,15 @@
 import spawn from 'cross-spawn';
 
+import { buildWrapperArgs } from '../utils/buildWrapperArgs';
 import { resolveBin } from '../utils/resolveBin';
 
 /**
  * `scripts prettier` — `--check` over `src/**\/*.{ts,tsx,json,css,md}`.
  *
- * Flag-only user args (e.g. `scripts prettier --write`) keep the default
- * glob so `--write` is enough. A path-like arg switches to fully
- * user-controlled invocation.
+ * Flag args pass through; the default glob is always appended so
+ * `scripts prettier --write` Just Works. Consumers that need a
+ * different target should call `prettier` directly from
+ * `node_modules/.bin`.
  */
 const prettierBin = resolveBin('prettier');
 
@@ -15,17 +17,10 @@ const DEFAULT_GLOB = 'src/**/*.{ts,tsx,json,css,md}';
 
 const userArgs = process.argv.slice(2);
 
-const userProvidedPath = userArgs.some((a) => !a.startsWith('-'));
-
-let args: string[];
-
-if (userArgs.length === 0) {
-  args = ['--check', DEFAULT_GLOB];
-} else if (userProvidedPath) {
-  args = userArgs;
-} else {
-  args = [...userArgs, DEFAULT_GLOB];
-}
+const args = buildWrapperArgs(userArgs, {
+  defaults: ['--check', DEFAULT_GLOB],
+  target: DEFAULT_GLOB,
+});
 
 const result = spawn.sync(process.execPath, [prettierBin, ...args], { stdio: 'inherit' });
 

package/src/utils/buildWrapperArgs.ts

@@ -0,0 +1,37 @@
+/**
+ * Build the argv passed to an underlying CLI (eslint, prettier) for a
+ * `scripts <cmd>` wrapper, from the user-provided argv.
+ *
+ * - Empty input → `defaults` verbatim (the canonical no-args
+ *   invocation, e.g. `['src', '--quiet']` for lint).
+ * - Non-empty input → user args (with the POSIX `--` end-of-options
+ *   marker removed) followed by `target`.
+ *
+ * The previous heuristic tried to detect "user-provided path" by
+ * scanning for any argv entry not starting with `-`, then handed full
+ * control to the user. That broke two real consumer invocations:
+ *
+ * 1. `scripts lint --max-warnings 0` — the `0` value of the flag was
+ *    misread as a path, so `src` was dropped and ESLint ran with no
+ *    files.
+ * 2. `scripts lint -- --fix` — every arg started with `-`, so `src`
+ *    was appended, but the surviving `--` separator forced ESLint to
+ *    treat `--fix` and `src` as positional files.
+ *
+ * The wrapper is intentionally narrow: pass flags, get the default
+ * target. Consumers that need a non-default target should invoke the
+ * underlying CLI directly (`node_modules/.bin/eslint <path>`).
+ *
+ * @param userArgs - argv after `scripts <cmd>` (i.e. `process.argv.slice(2)`).
+ * @param options.defaults - argv to use when `userArgs` is empty.
+ * @param options.target - path/glob appended after user flags otherwise.
+ */
+export function buildWrapperArgs(userArgs: string[], options: { defaults: string[]; target: string }): string[] {
+  if (userArgs.length === 0) {
+    return [...options.defaults];
+  }
+
+  const passthrough = userArgs.filter((a) => a !== '--');
+
+  return [...passthrough, options.target];
+}