Skip to content

docs: correct the \bhabit stem rationale in the claim-language check - #388

Merged
abrignoni merged 1 commit into
mainfrom
fix/claim-language-habit-comment
Aug 1, 2026
Merged

docs: correct the \bhabit stem rationale in the claim-language check#388
abrignoni merged 1 commit into
mainfrom
fix/claim-language-habit-comment

Conversation

@abrignoni

Copy link
Copy Markdown
Owner

What

The comment above CLAIM_PATTERN in admin/scripts/check_claim_language.py justified the open \bhabit stem by saying the spelling "is kept deliberately in sync with the iLEAPP and ALEAPP implementations of the same check".

The ALEAPP half of that is false. ALEAPP uses the closed \bhabits?\b, and has in every revision of that file since it was written. Its own comment says the closed form is deliberate, because the open stem also matches "habitat". Only the iLEAPP half was true.

Change

Comment only. CLAIM_PATTERN is byte-for-byte unchanged — the open \bhabit stays.

The rationale now:

  • justifies the open stem on its own merits: it catches "habitual" and "habitually", the inference words most likely to appear in a description of app usage data, which the closed spelling misses
  • keeps the "habitat" cost, with a note on how it was verified (grep over scripts/artifacts)
  • records ALEAPP's closed spelling as a deliberate divergence rather than a sync

The same false line was corrected in iLEAPP as abrignoni/iLEAPP#1857; this mirrors that wording.

Verification

  • grep -rni habit scripts/artifacts/ → no matches at all, so no name or description uses "habitat" and the stated cost is accurate. This is a raw-text grep, so it also covers the 9 modules whose __artifacts_v2__ the checker cannot read statically.
  • python3 -m py_compile admin/scripts/check_claim_language.py → clean
  • python3 admin/scripts/check_claim_language.py → exit 0, 155 modules checked, no unsupported claim language (the 9 unreadable-metadata modules it reports are pre-existing and untouched here)
  • python3 admin/scripts/lint_changed.py --base-ref origin/main admin/scripts/check_claim_language.py → PASS, 0 new warnings

ALEAPP is intentionally left alone.

🤖 Generated with Claude Code

The comment above CLAIM_PATTERN said the open \bhabit stem "is kept
deliberately in sync with the iLEAPP and ALEAPP implementations of the
same check". The ALEAPP half of that is false: ALEAPP uses the closed
\bhabits?\b and has in every revision of that file since it was written,
with its own comment explaining that the closed form is deliberate
because the open stem also matches "habitat".

Justify the open stem on its own merits instead -- it catches "habitual"
and "habitually", which the closed spelling misses -- keep the "habitat"
cost with a note on how it was verified, and record the ALEAPP spelling
as a deliberate divergence rather than a sync.

Comment only; CLAIM_PATTERN is unchanged and the checker still exits 0.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@abrignoni
abrignoni merged commit e201bc1 into main Aug 1, 2026
1 check passed
@abrignoni
abrignoni deleted the fix/claim-language-habit-comment branch August 1, 2026 06:16
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