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