docs: add repository cleanup audit (issues, docs inventory, deferred work) - #101
Merged
Merged
Conversation
…work) Read-only audit producing findings and proposals only; no code, config, or existing document is changed. - Part 1: true status of all five open issues against the code on dev — #63 and #83 are fully resolved (#89, #87) and only open because closing keywords never fire on a dev-targeted PR; #98 and #52 are live waiver trackers; #75 needs a release. - Part 2: full recursive docs/ inventory with a KEEP/ARCHIVE/DELETE disposition per file, the inbound-reference blast radius for each proposed removal, and a proposed docs/history/ structure. - Part 3: consolidated list of deferred work still outstanding in ARCHIVE.md section 14, separating items with a live tracking reference from the three recorded in prose only. - Part 4: ARCHIVE.md navigability (including 14 deviation entries misfiled under the Build performance heading), ROADMAP items now done, the Unreleased changelog backlog, 33 prunable merged branches, and proposed CLAUDE.md wording for two operational lessons.
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.
Summary
Adds
docs/reviews/CLEANUP-AUDIT.md, a read-only audit of the repository's open issues, the fulldocs/tree, deferred work buried indocs/ARCHIVE.md§14, and general hygiene. This PR adds one file and changes nothing else — no issue was closed, no document amended, no file deleted or moved. Every proposal is written to be approved or rejected line by line.What changed
One new file:
docs/reviews/CLEANUP-AUDIT.md.The audit is organized in four parts, led by a "recommended actions, highest value first" table.
Part 1 — Open issues. True status of all five open issues, determined against the code on
devat96264fband cited atfile:line, not against issue state. The default branch ismainwhile PRs targetdev, so GitHub's closing keywords never fire and open-ness carries no information:docker/docker-compose.yml:140plus seven regression tests, and the last acceptance item (a live Docker-capable host run) was discharged on 2026-07-26.frontend/src/auth/AuthContext.tsx:78-83with five jsdom cases.:latestis still v0.1.0 from 2026-07-09 and is 17 days of security work behinddev.Part 2 —
docs/inventory. Every file and folder underdocs/recursively (18 files, ~430 KB) with size, last meaningful update from git history, purpose, and a KEEP / ARCHIVE / DELETE disposition. ConfirmsSTATUS.md§1 is empty and argues it is now a historical artifact except for two operational follow-ups that should move toROADMAP.md. Proposes deletingdocs/upgrades/python-3.14.mdand the folder, and flags every other document still carrying the superseded CVE-2025-15366 claim — includingCHANGELOG.mdlines 18-23, which is user-facing release-note text. Each proposed DELETE or ARCHIVE lists its full inbound-reference blast radius from a repo-wide grep, including code comments in.github/dependabot.yml. Ends with a proposeddocs/structure and a disposition for the audit file itself.Part 3 — Deferred work in §14. Consolidated list of everything still outstanding, each with its source entry date, separating items with a live tracking reference from the three recorded in prose only (repo Settings work from 2026-07-06 and 2026-07-09 that never reached the ROADMAP governance checklist). Cross-checked against
ROADMAP.mdand the open issues so nothing is double-counted; ten previously-deferred items verified as since closed.Part 4 — Other cleanup.
ARCHIVE.mdnavigability, including a structural defect: fourteen dated deviation entries covering 2026-07-09 through 2026-07-26 sit underneath the## Build performanceheading rather than §14, plus one dead in-file link atARCHIVE.md:1004. FourROADMAP.mditems now done, one of which states something false about the secret-store AAD binding. The four accumulatedUnreleasedchangelog entries and why a v0.2.0 promotion is warranted, including the operational cost ofmainbeing 30 commits behind. 33 merged remote branches verified safe to prune, with the six PR-less review branches verified by content diff. Four aging Dependabot PRs. Proposed wording for two unrecorded CLAUDE.md operational rules (stacked-PR retargeting needsgit rebase --onto;on: pull_requestdefault types excludeedited, so a base change never re-runs CI).The appendix states the verification method and explicitly lists what was not verified: the specific CVE list behind #75, and all GitHub repository settings.
Notes
docs/ARCHIVE.md§ Deviations entry: this PR only adds an audit document and implements none of its recommendations. The deviation entry belongs with whichever proposals are accepted and acted on.