Commit e0fe9ab
fix: stop lint_docs.py false-flagging generic btsnoop/btsnooz filename mentions
lint_docs.py's dead-filename check requires every backtick-quoted filename
to resolve to a real path, but the project's own prose frequently discusses
the two extraction-path naming conventions generically (e.g. "extracted via
the raw `btsnoop_hci.log` path", "not `-btsnooz_hci.log`") without a
CAP-NNN- prefix — these were never meant to be file references and have
been false-flagging as "dead filename reference" across
CAPTURE_BLUETOOTH_HCI_SNOOP.md, DESKRESEARCH_FINDINGS.md, TODO.md, and
several CAP-NNN-FINDINGS.md/EVENT-NOTES.md files, failing CI's Lint docs
check on every push that touches this topic (predates this session).
- scripts/lint_docs.py: added GENERIC_LOG_FILENAME_RE, matching the same
design pattern as the existing PLACEHOLDER_FILENAME_RE exemption, to skip
bare/dash-only `btsnoop_hci.log`/`btsnooz_hci.log` mentions specifically
(a real CAP-NNN-prefixed reference is still checked normally). Added
CAP-032-btsnooz_hci.log to KNOWN_HISTORICAL_REFERENCES — CAP-032's own
Corrections section quotes it as the pre-fix wrong value, same pattern as
the existing CAP-005-recoding.mp4 entry.
- DESKRESEARCH_FINDINGS.md: reworded one bare `FINDINGS.md` mention (added
in this session's audit-findings entry) to the established
`CAP-NNN-FINDINGS.md` convention instead of needing a linter exception.
Verified clean: `lint_docs: clean — no dead filenames, no unregistered IDs,
no stale project name, no missing footers.`
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Bjo12itgeoZW8rPFPXUZvz1 parent 9e75573 commit e0fe9ab
2 files changed
Lines changed: 20 additions & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
180 | 180 | | |
181 | 181 | | |
182 | 182 | | |
183 | | - | |
| 183 | + | |
184 | 184 | | |
185 | 185 | | |
186 | 186 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
39 | 39 | | |
40 | 40 | | |
41 | 41 | | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
42 | 55 | | |
43 | 56 | | |
44 | 57 | | |
| |||
58 | 71 | | |
59 | 72 | | |
60 | 73 | | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
61 | 78 | | |
62 | 79 | | |
63 | 80 | | |
| |||
200 | 217 | | |
201 | 218 | | |
202 | 219 | | |
| 220 | + | |
203 | 221 | | |
204 | 222 | | |
205 | 223 | | |
| |||
212 | 230 | | |
213 | 231 | | |
214 | 232 | | |
| 233 | + | |
215 | 234 | | |
216 | 235 | | |
217 | 236 | | |
| |||
0 commit comments