Skip to content

feat(harness): signal-impact ablation tool + deterministic-signal conventions (5.3.0)#499

Merged
devswha merged 3 commits into
mainfrom
bot/harness-conventions
Jun 15, 2026
Merged

feat(harness): signal-impact ablation tool + deterministic-signal conventions (5.3.0)#499
devswha merged 3 commits into
mainfrom
bot/harness-conventions

Conversation

@devswha

@devswha devswha commented Jun 15, 2026

Copy link
Copy Markdown
Owner

Summary

Defines and consolidates patina's measurement harness and signal-authoring conventions after a burst of additions. Bumps to 5.3.0 (minor — contributor-facing tooling + workflow; no CLI/schema/detection-behavior change, all four languages byte-identical).

What's added

Signal-impact harnessscripts/signal-impact.mjs (npm run benchmark:signal-impact)

  • Joins a labeled manifest (expected_hot) to its local text, runs analyzeText() once per row, then recomputes the document hot verdict with each signal ablated to report each signal's marginal contribution: attributable TP/FP (rows it alone keeps hot) + Δrecall/Δfpr/ΔF1, plus catch-by-model-family.
  • Deterministic and gitignore-safe (reads local/private corpus, emits aggregate metrics only). recomputeHot() mirrors the analyzeText OR rule; a unit test pins the signal list.
  • Replaces the ad-hoc eval-kernel measurement used to calibrate the 5.2.0 KO signal. Reproduces it exactly: --ablate ko_ending_monotony → attributable TP 15 / FP 3, Δrecall +11.6, ΔF1 +0.072.

Harness mapdocs/HARNESS.md

  • Index of every measurement/calibration/gate tool: deterministic vs LLM, command, and link to detailed docs. Linked from README* and tests/quality/README.md.

ConventionCONTRIBUTING.md + CONTRIBUTING_KR.md "Adding a Deterministic Detection Signal"

  • Codifies the calibration loop: diagnose with evidence → FP-safe discriminator (length/register-matched) → first-class implementation (never couple an advisory payload) → mirror every surface (Node, playground, rebaseline-score, core/stylometry.md, SKILL.md, tests) → measure with the harness → version. Plus the FP-tolerance bar and acceptance criteria.

Verification

  • npm test791 pass / 0 fail (4 new signal-impact unit tests)
  • npm run lint — syntax OK (159 files), cspell 0 issues
  • npm run release:check — OK for 5.3.0
  • npm run check:no-private-assets — OK (311 packed)
  • npm run benchmark — 49-fixture suite still 100%

devswha added 2 commits June 15, 2026 19:31
…ventions

Adds scripts/signal-impact.mjs (npm run benchmark:signal-impact): joins a
labeled manifest to its local text, runs analyzeText() per row, and recomputes
the hot verdict with each signal ablated to report each signal's marginal
catch/FP (attributable TP/FP) + Δrecall/Δfpr/ΔF1. Deterministic and
gitignore-safe. Replaces the ad-hoc eval-kernel measurement used for the 5.2.0
KO signal; unit-tested with synthetic inputs.

Adds docs/HARNESS.md (index of every measurement/calibration/gate tool) and a
"Adding a Deterministic Detection Signal" convention to CONTRIBUTING.md +
CONTRIBUTING_KR.md (diagnose -> FP-safe discriminator -> first-class impl ->
mirror every surface -> measure with the harness -> version). Links from
README*, tests/quality/README.md.
Minor bump for the contributor-facing signal-impact harness + deterministic
detection-signal conventions. No CLI/schema/pattern/detection-behavior change;
all four languages byte-identical. Syncs version surfaces + CHANGELOG.
@vercel

vercel Bot commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
patina Ready Ready Preview, Comment Jun 15, 2026 10:47am

Request Review

@devswha devswha merged commit 4032265 into main Jun 15, 2026
8 checks passed
@devswha devswha deleted the bot/harness-conventions branch June 15, 2026 10:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant