Repository navigation
Add a lifecycle status to tool pages, and fill it for 55 of them - #14
Merged
wero1414 merged 2 commits intoSep 28, 2026
Merged
Conversation
Status fields now live in scripts/seed-tools.mjs and src/data/protocol-tools/*.json, so regenerating the tool pages keeps them. - Each status carries a statusSource url next to its note and check date. - Notes rewritten to keep only what the cited source confirms. - Status changed where the evidence did not support it: btlejack, mobileinsight-core, openbts, dwm3000-dwt-driver and esp32-deauther-ganesh to stale, zbdsniff to mature. esp32-bt-exp is left unassessed. - successor is accepted with eol or stale, and the page says "See instead". - Tool checks moved into checkTool() with unit tests. - Removed the duplicate tool page "crocodilehunter 2.md".
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
tools/has no way to say that an entry is archived, discontinued or frozen-but-fine, so today that information lives in prose where it ages quietly. This adds astatusfield, fills it for 55 entries, and makes the catalogue report its own coverage.What is in here
TOOL_STATUSESinsrc/lib/taxonomy.js, next to the vocabularies that were already there.status,statusNote,statusCheckedandsuccessoron the tools schema.scripts/validate.mjs: asuccessormust resolve to a real slug, any status other thanactiveneeds astatusNote, any status needs astatusCheckeddate, andsuccessoris only accepted witheol./tools, computed at build time.Nothing is deleted and no existing field changes.
Why a vocabulary and not commit dates
I measured all 151 entries first — GitHub's
archivedflag and the last commit on the default branch for the 116 with arepo, the effective HTTP response for the 47 with ahomepage— and then went back over the 44 findings one by one with sources rather than timestamps.That second pass is the reason this PR proposes a vocabulary. Of the 34 entries that looked stale by date, roughly 14 turned out to be mature (frozen by design, still the right tool), 11 are EOL with an identifiable successor, about 7 are genuinely stale and 2 are research artefacts that were never products. A status field encoding age would have been wrong about four out of five.
Three cases that show it:
gr-gsm— upstream frozen since 2021 and its GNU Radio 3.10 PR closed unmerged, but Debian and Kali do not package that repo: they packagebkerler'smaint-3.10fork, which builds against current GNU Radio. The tool works; the page pointed at the wrong tree.waving-zvsscapy-radio— both attack Z-Wave, both untouched for years, opposite fates. waving-z is ten files of C++11 and Boost talking tortl_sdrover stdin, and G.9959 did not change. scapy-radio carries Python 2 and the GNU Radio 3.7 API. Same age, different dependency surface.ubertooth-onevsubertooth-tools— the same repository, and now two different statuses. Great Scott Gadgets lists the hardware as "a retired product… no plan to manufacture more" while the software is actively developed. This is whystatusbelongs to the page and not to the repo;chip-toolandconnectedhomeiphave the same shape, as dokillerbeeandzbdsniff.Two ways a repo looks more alive than it is
Worth writing down, because anything automated here will hit both:
pushed_atcounts pushes to any branch.scapy-radiois seven years away from its default-branch commit,mfcuksix,openbts41 months,falcon35,gr-gsm46.rtl-zwave's 2023 commit is "Create LICENSE.md" — the last code change is from 2015.mfdread's 2024 commit is "Create LICENSE"; its code is from 2020.The part that is not a judgement call
Six entries pointed at an archived repository, and three of them did not say so:
universal-radio-hacker(12,579★),crocodilehunter— whose README says EFF no longer maintains it and does not recommend it for new projects — andpython-matter-server, whose README names 8.1.2 as the final release. The other three already said it in prose, which is the argument in miniature: this project is already tracking lifecycle by hand, so half of it goes stale unnoticed.universal-radio-hackeralso shows the label has consequences: it froze in a good state (v2.10.0 still installs from PyPI) but Homebrew marked itdeprecatedwith reasonrepo_archivedand a disable date of 2027-07-17.Three wording corrections that come with it
gr-zwave_pooresaid "a maintained GNU Radio block path". Its repo keeps a branch per GNU Radio version, so the reading was reasonable, but the last code commit is 2022-08-26. It is still functional because FISSURE vendors and builds it — which is what thestatusNotenow says.adsb-outsaid "Stable but inactive". Stable is true of the code and false of the experience: it is Python 2 andpython3 -m py_compilefails on line 401, so it does not start on a current distribution.mdek1001said Qorvo points new designs at the QM33 series. PCN 25-0154 declares no alternate part; the single-board DWM1001-DEV is still available, which is what the page says now. The PCN does confirm the page's dates.Coverage
/toolsnow renders, at build time:statusis optional on purpose. Defaulting toactivewould have asserted that 97 unreviewed entries are current; leaving it unset says plainly that nobody has looked, and makes the gap something a contributor can pick up.Scope
The 55 values are a starting point, not a verdict. The call between
mature,archivedandstaleis a judgement I would rather you made than I did — tell me where you disagree and I will change them. Related pages already open as separate PRs: #10, #12 and #13. I can post the full 151-row table with dates, HTTP codes and sources if that helps review.