mandrel 2.102.0 → 2.103.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -25,3 +25,11 @@ Self-check your change against this lens's concerns before you ship:
25
25
  - [ ] Toolchain by ecosystem, never one library.
26
26
  - [ ] Vacuous property tests.
27
27
  - [ ] Name the property.
28
+ - [ ] Boundary-Value Coverage — Domain Edges Nobody Picked.
29
+ - [ ] Emptiness and extent
30
+ - [ ] Numbers
31
+ - [ ] Text
32
+ - [ ] Paths and names
33
+ - [ ] Time
34
+ - [ ] Presence
35
+ - [ ] Ordering
@@ -199,13 +199,85 @@ Evaluate the gathered context against the following test quality dimensions:
199
199
  terminal state") plus its generator shape (the input domain to draw
200
200
  from) — never a bare "add property tests".
201
201
 
202
+ 9. **Boundary-Value Coverage — Domain Edges Nobody Picked.** Flag a unit
203
+ that mishandles an input at the edge of its own domain when no test
204
+ drives that edge. This dimension owns **pure code only**: a function's
205
+ own input domain where no external dependency, no concurrency and no
206
+ trust boundary is involved. Dimension 8 owns a *stated* invariant; this
207
+ dimension owns the unstated edges every domain has. Walk each candidate
208
+ unit against the edge catalogue and keep only the edges it demonstrably
209
+ mishandles:
210
+
211
+ - **Emptiness and extent** — an empty collection or string, a single
212
+ element, the off-by-one at a length (`arr[length]`, a `slice` at the
213
+ end), an input larger than any fixture.
214
+ - **Numbers** — zero, a negative, `NaN`, `Infinity`, `-0`, the max safe
215
+ integer, a float where an integer is assumed, a numeric string.
216
+ - **Text** — a combining character or surrogate pair where `length` is
217
+ read as a glyph count, a BOM, `CRLF`, a trailing newline, surrounding
218
+ whitespace, a locale-sensitive compare.
219
+ - **Paths and names** — a trailing slash, `..`, an absolute path where a
220
+ relative one is assumed, a Windows separator, a case-only difference.
221
+ - **Time** — a DST transition, a leap day, a month end, epoch zero, a
222
+ timezone other than the author's, a clock that goes backwards.
223
+ - **Presence** — `null` versus `undefined` versus a missing key versus an
224
+ empty string, an optional field at its default, a field present with
225
+ the wrong type.
226
+ - **Ordering** — a sort that assumes stability or a single key, a
227
+ deduplication that assumes insertion order, a first-wins or last-wins
228
+ merge the callers disagree on.
229
+
230
+ **The reproduction gate (every finding).** "What if it is null" is not a
231
+ finding. A boundary finding names all four of the following or is
232
+ dropped: (a) **the input** as a concrete value, not a class (`[]`, never
233
+ "an empty collection"); (b) **the line** — the `path:line` that
234
+ mishandles it and what it does instead (returns `NaN`, throws
235
+ `TypeError`, drops the last element); (c) **the producer** — an in-repo
236
+ call site, config key, CLI flag or exported signature that can supply
237
+ that value, cited by `path:line` — a value no caller can produce is not a
238
+ finding, and a public entry point counts as a producer; (d) **the test**
239
+ — the assertion that would fail today, in the tier
240
+ [`rules/testing-standards.md`](../rules/testing-standards.md) assigns the
241
+ unit, so the gap is a named missing test and never a bare "add edge-case
242
+ tests".
243
+
244
+ **Evidence: `reproduced` or `reasoned`.** A finding is `reproduced` when
245
+ you drove the unit with the input in a throwaway process and quote the
246
+ command and the output line that shows the wrong result — e.g.
247
+ `node --input-type=module -e "import { f } from './lib/f.js'; console.log(f([]))"`,
248
+ `python -c`, or the ecosystem's equivalent, run from the repo root or as
249
+ a scratch script under the workspace `temp/` tree. Importing a module
250
+ into a throwaway process is a read, not the suite run the Constraint
251
+ forbids, and it is permitted only for a unit whose sole side effect is
252
+ its return value — a function that writes a file, sends a request or
253
+ mutates shared state stays `reasoned`. **High requires `reproduced`**: a
254
+ `reasoned` finding caps at Medium whatever its consequence.
255
+
256
+ - Severity: the mishandled edge corrupts or silently drops data, feeds an
257
+ irreversible write, or decides a gate or guard → **High**; it returns a
258
+ wrong value or throws on a reachable input → **Medium**; the wrong
259
+ output is a message or a cosmetic rendering → **Low**.
260
+ - Category: file under `Coverage`. Rank candidates by Step 0's churn ×
261
+ coverage gap and cite the `baselines/` coverage row of the branch the
262
+ edge lives on where one exists; cap the batch at the top eight and roll
263
+ the remainder into one finding per catalogue row.
264
+ - Not a finding: a defensive check on an input no producer supplies, or
265
+ an edge a sibling lens owns whole — cite the sibling when you drop it.
266
+ An external call's timeout or empty-on-outage is `audit-resilience`'s;
267
+ a check-then-act race is `audit-performance`'s Interleaving dimension;
268
+ an input crossing a trust boundary is `audit-security`'s Tier B; a
269
+ poisoned or exhausting input is `audit-red-team`'s Hostile Operations;
270
+ an empty `catch` is `audit-clean-code`'s Error Handling.
271
+
202
272
  ## Constraint (lens-specific carve-out)
203
273
 
204
274
  Do NOT **run** the test suite (do not invoke `npm test`, a coverage run, or a
205
275
  mutation run — those mutate state and cost minutes). Reading the **committed**
206
276
  coverage / CRAP / mutation artifacts under `baselines/` is explicitly permitted
207
277
  and required (Step 0): citing an already-computed metric is read-only analysis,
208
- not a suite run.
278
+ not a suite run. So is dimension 9's reproduction — one pure unit driven with
279
+ one input in a throwaway process — which runs no test file and writes nothing
280
+ outside the workspace `temp/` tree.
209
281
 
210
282
  ## Report additions
211
283
 
package/docs/CHANGELOG.md CHANGED
@@ -15,6 +15,13 @@ All notable changes to this project will be documented in this file.
15
15
  -->
16
16
  <!-- markdownlint-disable-file MD004 MD012 MD037 -->
17
17
 
18
+ ## [2.103.0](https://github.com/dsj1984/mandrel/compare/mandrel-v2.102.0...mandrel-v2.103.0) (2026-10-25)
19
+
20
+
21
+ ### Added
22
+
23
+ * **audit-quality:** add a Boundary-Value Coverage dimension gated on input, line, producer and test ([#5895](https://github.com/dsj1984/mandrel/issues/5895)) ([3344213](https://github.com/dsj1984/mandrel/commit/3344213eb8ad5d9686eb13a0658f9e808eb10466))
24
+
18
25
  ## [2.102.0](https://github.com/dsj1984/mandrel/compare/mandrel-v2.101.0...mandrel-v2.102.0) (2026-10-23)
19
26
 
20
27
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mandrel",
3
- "version": "2.102.0",
3
+ "version": "2.103.0",
4
4
  "description": "Claude Code-first opinionated workflow framework: instructions, skills, rules, and SDLC workflows that govern AI coding assistants.",
5
5
  "files": [
6
6
  ".agents/",