docs(completist): audit completist data and generate report - #4080
docs(completist): audit completist data and generate report#4080dieterolson wants to merge 6 commits into
Conversation
Co-authored-by: dieterolson <198168927+dieterolson@users.noreply.github.com>
|
👋 Jules, reporting for duty! I'm here to lend a hand with this pull request. When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down. I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job! For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with New to Jules? Learn more at jules.google/docs. For security, I will only act on instructions from the user who triggered this task. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: b67cd1f6e3
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| ## Critical Incomplete (Top 50) | ||
| | File | Line | Type | Impact | Coverage | Complexity | | ||
| |---|---|---|---|---|---| | ||
| | `src/shared/python/ai/integrations/github_mcp/integration.py` | 36 | Stub | 5 | 3 | 4 | |
There was a problem hiding this comment.
Exclude protocol declarations from incomplete stubs
Remove these Protocol method declarations from the critical-gap set: the referenced ... bodies intentionally define structural typing contracts, and concrete implementations are supplied by conforming classes or test fakes. Treating them as missing logic inflates the reported 130 critical gaps and generated ten false critical issue files, directing the Completist toward code that must remain declaration-only.
AGENTS.md reference: AGENTS.md:L410-L418
Useful? React with 👍 / 👎.
| @@ -1,28 +0,0 @@ | |||
| --- | |||
There was a problem hiding this comment.
Preserve referenced assessment artifacts
Do not delete this artifact without updating its consumers: docs/assessments/A-N_Assessment_2026-04-17.md:214 and docs/assessments/assessment_summary.json:258 still cite this exact path as security evidence. The commit similarly removes several other referenced issue documents, leaving assessment navigation and machine-readable evidence entries dangling.
Useful? React with 👍 / 👎.
| | `./generate_real_assessments.py` | todos = run_cmd("grep -rnw 'TODO' src/ \| wc -l").strip() | TRACKED_TASK | | ||
| | `./scripts/generate_comprehensive_assessment.py` | stats["todos"] += content.count("TODO") | TRACKED_TASK | | ||
| | `./scripts/generate_comprehensive_assessment.py` | grades["O"] = (max(0, score_o), f"Technical Debt (TODO+FIXME): {debt}") | TRACKED_TASK | | ||
| | `./tests/tools/test_matlab_quality_utils.py` | Path("script.m"), "% TODO: fix this", 5, issues | TRACKED_TASK | |
There was a problem hiding this comment.
Filter scanner and fixture literals from feature gaps
Exclude these lexical matches before counting feature gaps: the rows are the assessment generator searching for TODO, code that counts the token, and a test fixture verifying marker detection—not outstanding implementations. Including them as TRACKED_TASK findings makes the executive count and implementation order inaccurate; the Completist scope calls for actual tracked incomplete work rather than occurrences inside its own tooling and tests.
AGENTS.md reference: AGENTS.md:L410-L418
Useful? React with 👍 / 👎.
Performance Benchmark ResultsNo benchmark results available. |
|
Co-authored-by: dieterolson <198168927+dieterolson@users.noreply.github.com>
|
Superseded by #4450 (CONS-A4), which merges this PR together with #4411 into one merge boundary. Containment verified by ancestry, not by title: Carried forward: the 5 Two things in this branch were reverted, both documented in #4450:
Also reverted: this branch's Auto-merge was disarmed here before #4450 was opened so this cannot merge itself and duplicate the content. |
Pull request was closed
…diagnostics (#4450) CONS-A4. Consolidates the last two remaining open Tools PRs into one squash commit. Supersedes and closes: * #4080 jules-12248824925126103807-8eacfe8f - completist data audit + report * #4411 research/shoulder-velocity-drift-transfer - pendulum drift-transfer Containment verified by ancestry before either was closed: verify_coverage.sh reported covered=2 NOT-covered=0 against consolidated/docs-pendulum-2026-08-13, so both head refs are true ancestors of this commit. Two unrelated subsystems kept in one PR because they provably do not interfere - #4411 merged into #4080 with zero conflicts and their final file sets are disjoint - and because every extra PR costs ~28 workflow runs and ~4 self-hosted fleet slots, which is the problem this consolidation drive exists to fix. From #4411 (closes #4406, supports D-sorganization/UpstreamDrift#8551): a model-neutral transfer-signal contract with exact drift/control grip-force closure checks, phase-window work/braking/impulse metrics, mixed-objective Pareto ranking, a qualified double-pendulum adapter, and a PyQt Drift Transfer tab that fails closed for unqualified model tiers. Carried across byte-for-byte from its own head, which forked from current main and so is free of the formatting churn #4080 swept through src/pendulum_simulator/. From #4080: regenerated completist scan data (5 .jules/completist_data/*.txt), Completist_Report_2026-08-02.md, 6 new Issue_0NN_*.md, 4 renames, the COMPLETIST_LATEST.md refresh, and - the most immediately valuable part - two fleet-load fixes hoisting cheap `if:` pre-filters onto the pick-runner jobs of Jules-Issue-Mention-Handler.yml and PR-Comment-Responder.yml, so a non-matching comment costs zero d-sorg-fleet capacity instead of occupying two runners to be skipped one job later. Reverted from #4080: * 90 deleted documentation files restored - 19 dated historical Completist_Report_*.md (2026-03-08..2026-07-23), 7 hand-written docs/assessments/issues/ISSUE_*.md, 57 generated Issue_NNNN_*.md, and docs/development/professional-scada-epic.md. An agent regression, not tool behaviour: the PR body describes no deletion, and scripts/analyze_completist_data.py has no unlink/rmtree/remove - it only globs ISSUES_DIR to deduplicate and count. The regenerated set also restarts numbering at Issue_005 instead of continuing from Issue_2027, so it is not a superset of what it removed. * A stale-base removal of the two Bolt learnings main gained from #4071/#4176. * ~290 files of pre-commit formatting churn (commits ba3730a, 35bec2d, c70755b). It was produced by a ruff build disagreeing with the CI-pinned 0.14.10 - 281 of 299 changed .py files failed ruff format --check under the pin - it displaced `# noqa` comments into uselessness (9 live F841 errors, a UP017 rewrite, 2 lost SLF001 suppressions), and it reformatted ruff-excluded trees. 280 of 295 were proven content-neutral by format-normalisation before reverting; the other 15 by provenance. * 6 committed .codex-worktrees/ gitlinks removed (unreachable on any remote). Net: 323 files -> 29; 299 changed .py files -> 5. Closes #4406 Verification: ruff check + ruff format --check clean under the CI-pinned 0.14.10; 0 files fall inside CI's gated set since the only changed .py are the 5 under the excluded src/pendulum_simulator/ tree, checked anyway and clean; double_pendulum_golf.transfer_strategy imports cleanly; no conflict markers; no bare `from datetime import UTC`; zero gitlinks. #4411's pytest run could not be completed locally - pytest-qt aborts with ImportError on QtCore, the known PyQt6 6.10 / Qt6Core.dll fault on that machine, not a defect.
.jules/completist_data.docs/assessments/issues.docs/assessments/completist/.PR created automatically by Jules for task 12248824925126103807 started by @dieterolson