Skip to content

chore: issue sweep — dead Justfile recipes, stray MAINTAINERS, stale pointers - #183

Merged
hyperpolymath merged 2 commits into
mainfrom
chore/issue-sweep-2026-10-01
Oct 1, 2026
Merged

hyperpolymath merged 2 commits into
mainfrom
chore/issue-sweep-2026-10-01

Conversation

@hyperpolymath

@hyperpolymath hyperpolymath commented Oct 1, 2026 •

Copy link
Copy Markdown
Owner

Closes #75. Closes #79. Closes #80. Closes #166.

What changes

Issue Change Evidence
#75 build-rescript was already gone; this removes the rest of the same class: every recipe targeting the deleted interpreters/ tree or a package.json that does not exist (14 recipes), npm/nodejs from install-provers-*, and a dead stats line. lint/format keep their names but now exit 1 with a message instead of reporting success (npm run lint || true could never fail). ls interpreters package.json → both absent; just --list parses; just lint → rc=1
#79 docs/MAINTAINERS.adoc is already a pointer to the root file. The residue was a third file, markdown MAINTAINERS, naming @metadatastician as Primary, contradicting canonical MAINTAINERS.adoc (sole maintainer @hyperpolymath). Removed; humans.txt now cites the root file. git grep finds no reference to the bare name except CODEOWNERS' MAINTAINERS* glob, which still covers the .adoc
#80 The wiki sync is already automated (wiki-sync.yml → scripts/wiki-sync.sh; just wiki-sync). Replaced the stale "Automation TODO" in docs/wiki/README.md. Wiki HEAD dcee58d = "Sync from absolute-zero/docs/wiki@3e959cb" (2026-09-26); the 09-30 run logged "Wiki is already up to date"
#166 Criterion 1 was fixed in b7c780f (#174). This PR fixes the stale LambdaCNO.v:356 pointer by citing the triage row by identifier, so it cannot drift again. below

Also: self-validating/README.adoc example cp paths named contractiles/self-validating/, which does not exist.

#166 acceptance, measured on this head

  1. asciidoctor -o /dev/null docs/proof-debt.adoc → exit 0, no ERROR:.
  2. Rendered rows = source |<line> rows for all three Lean QuantumCNO tables: 7/7, 4/4, 3/3.
  3. y_not_cno carries (* AXIOM: [CLASS-A] y_not_cno: … *) (line 399), and its leading comment now cites the triage row by identifier.
  4. Mutant: reverting one \|0⟩ to a bare |0⟩ reproduces ERROR: … dropping cells from incomplete row.

Deliberately not in this PR

  • governance: .machine_readable/contractiles/Justfile byte-identical to root Justfile #76 (contractiles Justfile byte-identical to root): this is the rsr-template-repo convention. The template ships .machine_readable/contractiles/Justfile byte-identical to its own root Justfile (both blob 78b18ce, 720 lines), as do six other RSR repos. Deleting it here would diverge from the template, and a template sync would re-add it. This PR keeps the copy in sync. Whether the duplicate should exist is a template-level decision.
  • Cookbooks (0331f43): removed the sections and list entries for every recipe this PR deletes, and regenerated the JUSTFILE-COOKBOOK appendix list and dependency graph from just --list. Nine older sections describe recipes that did not exist before this PR either (build-z3, check-tools, clean-all, docs-*, install-help, loc, quick-check). A banner names them; the full rewrite is left for a separate PR.

🤖 Generated with Claude Code

https://claude.ai/code/session_01WRvDivYwLSeVCJUrfjic3f

…pointers

- Justfile (+ its contractiles copy, kept byte-identical per the RSR
  template convention): remove every recipe that targets the deleted
  `interpreters/` tree or a `package.json` that does not exist
  (build-affinescript, build-typescript, test-typescript,
  test-interpreters, run-example/-brainfuck/-whitespace/-malbolge,
  clean-typescript, clean-affinescript, watch, install, install-npm,
  install-python), drop npm/nodejs from install-provers-*, and drop the
  dead "Implementation code" stats line. `lint` and `format` are kept
  as names but now fail loudly instead of reporting a no-op as success
  (`npm run lint || true` could never fail). Refs #75.
- Remove the stray markdown `MAINTAINERS`, which named a different
  primary maintainer than the canonical `MAINTAINERS.adoc`;
  `docs/MAINTAINERS.adoc` is already a pointer. humans.txt now cites the
  root file. Refs #79.
- docs/wiki/README.md: replace the stale "Automation TODO" with a
  description of the wiki-sync workflow that already exists. Refs #80.
- LambdaCNO.v: y_not_cno's triage pointer cited a drifted line number
  (`LambdaCNO.v:356`, now 399/400); cite the triage row by identifier
  instead. Refs #166.
- self-validating/README.adoc: example `cp` paths named
  `contractiles/self-validating/`, which does not exist.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WRvDivYwLSeVCJUrfjic3f
@coderabbitai

coderabbitai Bot commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 93617541-da3e-40d8-9fdc-60d91a4faf2e

📥 Commits

Reviewing files that changed from the base of the PR and between 8007381 and 3eb2284.

📒 Files selected for processing (7)
  • .machine_readable/contractiles/Justfile
  • .machine_readable/self-validating/README.adoc
  • Justfile
  • MAINTAINERS
  • docs/wiki/README.md
  • proofs/coq/lambda/LambdaCNO.v
  • www/.well-known/humans.txt
💤 Files with no reviewable changes (1)
  • MAINTAINERS

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

📜 Recent review details
⏰ Context from checks skipped due to timeout. (23)
  • GitHub Check: scan / rust-secrets
  • GitHub Check: scan / gitleaks
  • GitHub Check: governance / Workflow security linter
  • GitHub Check: governance / Licence consistency
  • GitHub Check: governance / Actions lockfile verify
  • GitHub Check: governance / Language / package anti-pattern policy
  • GitHub Check: scorecard / Run Scorecard PR
  • GitHub Check: governance / Allowlist Preflight
  • GitHub Check: governance / Debt ratchet
  • GitHub Check: governance / Trusted-base reduction policy
  • GitHub Check: governance / Live Actions policy (credentialed advisory)
  • GitHub Check: governance / Code quality + docs
  • GitHub Check: governance / Check Workflow Staleness
  • GitHub Check: hypatia / Hypatia Neurosymbolic Analysis
  • GitHub Check: rust-ci / Detect Cargo.toml
  • GitHub Check: PR (address)
  • GitHub Check: Lean — core CNO (6 modules + axiom audit)
  • GitHub Check: Coq — CNO + OND (14 theories)
  • GitHub Check: Agda — CNO + OND
  • GitHub Check: Z3 — CNO + OND bounded checks
  • GitHub Check: analyze (actions, none)
  • GitHub Check: analyze (rust, none)
  • GitHub Check: semgrep-cloud-platform/scan
🧰 Additional context used
🪛 LanguageTool
docs/wiki/README.md

[uncategorized] ~38-~38: The official name of this software platform is spelled with a capital “H”.
Context: This is automated: .github/workflows/wiki-sync.yml runs `scripts/...

(GITHUB)

🔇 Additional comments (6)
www/.well-known/humans.txt (1)

10-10: LGTM!

proofs/coq/lambda/LambdaCNO.v (1)

397-398: LGTM!

docs/wiki/README.md (1)

38-40: LGTM!

.machine_readable/contractiles/Justfile (1)

124-124: LGTM!

Also applies to: 159-159, 180-181, 183-183, 185-186, 188-188

Justfile (1)

124-124: LGTM!

Also applies to: 159-159, 180-181, 183-183, 185-186, 188-188

.machine_readable/self-validating/README.adoc (1)

82-82: 🎯 Functional Correctness

The three referenced example files are tracked and present at the documented paths. The cp commands therefore use valid source paths.


📝 Summary

Summary by CodeRabbit

  • Documentation
    • Updated the wiki guidance to explain automatic synchronisation, while retaining manual steps as a fallback.
    • Corrected example component copy instructions and updated a contributor reference.
  • Tooling
    • Streamlined project commands around proof testing and Coq and Lean cleanup.
    • Formatting and linting commands now report that no formatter or linter is configured.

Walkthrough

The root and contractiles Justfiles remove legacy build, test, cleanup, and installation recipes. Documentation updates change example paths and wiki-sync instructions. The MAINTAINERS file is removed, its contributor reference is updated, and a proof-debt comment now uses a row identifier.

Changes

Legacy task recipe removal

Layer / File(s) Summary
Remove legacy tasks and update remaining targets
.machine_readable/contractiles/Justfile, Justfile
Both Justfiles remove AffineScript and TypeScript builds, interpreter tests, related cleanup and installation targets, and implementation-code statistics. test-all now depends only on test-proofs. The format and lint targets report that no tool is configured and exit with status 1.

Self-validating example paths

Layer / File(s) Summary
Update example-copy source paths
.machine_readable/self-validating/README.adoc
Three example-copy commands now source files from .machine_readable/self-validating/examples/; destination paths remain unchanged.

Wiki synchronisation instructions

Layer / File(s) Summary
Document wiki synchronisation
docs/wiki/README.md
The README describes the workflow trigger, sync script, and local just wiki-sync command. It retains the manual steps as a fallback.

Maintainer record reference

Layer / File(s) Summary
Remove record and update contributor reference
MAINTAINERS, www/.well-known/humans.txt
The MAINTAINERS file is removed. The contributor reference changes to MAINTAINERS.adoc at the repository root.

Proof-debt comment reference

Layer / File(s) Summary
Update axiom comment reference
proofs/coq/lambda/LambdaCNO.v
The y_not_cno comment now cites the [y_not_cno] proof-debt row identifier instead of a line number.

Priority: ➖ Normal

Estimated code review effort: 2 (Simple) | ~12 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to 3eb22

The cleanup removes obsolete tasks and refreshes documentation without an established regression. Formatting and linting intentionally report unavailable tooling; the change is mergeable after normal checks.

Architecture Summary

Architecture risk: 🔵 Low · up to 3eb22

The change affects 5 systems.

Changed systems: docs, Justfile, MAINTAINERS, proofs, www

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

  • observed — docs (service) was modified; 1 changed file maps to changed impact.
  • observed — Justfile (service) was modified; 1 changed file maps to changed impact.
  • observed — MAINTAINERS (service) was modified; 1 changed file maps to changed impact.
  • observed — proofs (service) was modified; 1 changed file maps to changed impact.

Before / after behavior

  • observed — Modified behavior in Justfile: The AffineScript interpreter build target was removed.
  • observed — Modified behavior in Justfile: The TypeScript build target was removed.
  • observed — Modified behavior in Justfile: test-all now depends only on test-proofs; the interpreter-testing target and its Brainfuck and Whitespace commands were removed. test-proofs remains unchanged.
  • observed — Modified behavior in Justfile: clean no longer invokes the removed TypeScript and AffineScript cleanup targets; it cleans only Coq and Lean.
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Out of Scope Changes check ⚠️ Warning The changes to .machine_readable/self-validating/README.adoc correct example cp paths for Kennel, Yard, and Hunt. These paths do not implement the requirements in [#75], [#79], [#80], or [#166]. T… Remove the unrelated self-validating/README.adoc path changes from this pull request, or link them to a directly relevant active issue and include that issue in the stated scope.
✅ Passed checks (4 passed)
Check name Status Explanation
Linked Issues check ✅ Passed The PR satisfies the coding requirements for all four active linked issues. For [#75], Justfile removes dead interpreter and package-tool recipes, removes npm-related installation use, and makes `li…
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Description check ✅ Passed The description clearly relates to the changeset. It covers the Justfile cleanup, MAINTAINERS removal, wiki documentation, proof comment, and corrected example paths.
Title check ✅ Passed The title accurately summarises the main changes: removal of dead Justfile recipes, removal of the stray MAINTAINERS file, and correction of stale references.
Full details: Out of Scope Changes check

Explanation

The changes to .machine_readable/self-validating/README.adoc correct example cp paths for Kennel, Yard, and Hunt. These paths do not implement the requirements in [#75], [#79], [#80], or [#166]. The linked issues do not establish scope for this example-document correction.

  • Fix all pre-merge checks with AI
  • Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

A rabbit checks the task list twice
Old build commands hop away
Three examples find their paths
A row now names the proof
The wiki notes the syncing way

Comment @coderabbitai help to get the list of available commands.

coderabbitai[bot]
coderabbitai Bot previously approved these changes Oct 1, 2026
…pe list

JUSTFILE-COOKBOOK.adoc:
- remove the build-typescript, test-typescript and watch sections;
- correct the build-all, test-all and clean dependency lines;
- regenerate the appendix recipe list from `just --list` and the dependency graph from the Justfile;
- add a banner naming the nine sections that describe recipes the Justfile has not defined since before this PR.

COOKBOOK.adoc: drop the test-typescript and watch-typescript lines.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WRvDivYwLSeVCJUrfjic3f
@hyperpolymath
hyperpolymath enabled auto-merge (squash) October 1, 2026 14:57
@hyperpolymath
hyperpolymath merged commit dba634a into main Oct 1, 2026
42 checks passed
@hyperpolymath
hyperpolymath deleted the chore/issue-sweep-2026-10-01 branch October 1, 2026 14:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant