Repository navigation
docs: close the project, and correct what the docs got wrong - #3
Merged
Merged
Conversation
Development has ended. The READMEs now say so, and record what worked and what did not, rather than leaving a green test badge to imply the first and hide the second. Why it ended, stated in the root README: two load-bearing premises failed while the engineering was succeeding. P3 -- the economics do not close; scripts/economics.py puts a realistic host at $2.256/1M tokens against a $0.150 commodity price, ~15x, with break-even utilisation unreachable. P2 -- the desk review found the NAT-traversal falsifier true as written, which relocates the whole claim onto cross-party pooling (P1), for which there was never any evidence. D7 never got its human reviewer. Discrepancies found by reading the code and fixed here: - packages/website/README.md called the project "a globally distributed, community-owned AI infrastructure" -- the thing D6 decided not to build and D2 priced out of existence. The site's own landing component had been corrected; this file had not. It also listed 5 of 9 pages, omitting dashboard, playground and status (the functional ones), and described the sibling packages as separate repositories a year after the migration. - packages/node/README.md claimed the Ollama proxy was "the only backend runtime.py assigns". It is not a runtime.py backend at all. runtime.py:282 assigns EchoBackend and nothing else, ever; OllamaBackend is never constructed outside a test; nothing in src ever enqueues onto task_queue. The live path is api/inference.py -> clients/ollama.py, a different class. So Runtime._worker_loop -> InferenceBackend -> ArtifactStore is dead code kept alive by a test named test_end_to_end_pipeline that feeds the queue by hand. Recorded in the node README and in ROADMAP's closure header. - The "155-word vocabulary" figure for LocalBoundaryEngine was wrong and had propagated to five files: ROADMAP.md, CLAUDE.md, experimental/README.md, .claude/rules/node.md and the root README. The list holds 116 words plus 4 special tokens, against a declared vocab_size of 32000. Counted, not recalled. CLAUDE.md warns that prose cannot notice when it goes stale; this number was never in scope of the mechanism built to act on that warning. - The v1.0.1 tag names a tree that declares itself 1.0.0 in all four packages. test_every_package_declares_the_same_version compares the four to each other and never to the tag, so V3's fix converged them on the previous version and the ratchet passed. Left as found and documented: bumping now would produce a tree claiming to be v1.0.1 that is not the released v1.0.1. - "Python 3.11-3.14" in ROADMAP implied four interpreters; ci.yml names three (3.11, 3.12, 3.14). 3.13 is not in the matrix. STATUS.md regenerated with the script, not by hand: 906 passed, 1 skipped across the three suites. It still reads CI UNVERIFIABLE because there is no gh CLI here; the root README explains that and cites run #33 on main at e5d1e7c, read through the API, which concluded success. Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PgHmwMuw5ivVZTCdiUaEmN
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.
Development has ended. This marks the project closed in the READMEs and corrects five things the docs claimed that the code contradicts.
Why it ended
Two load-bearing premises failed while the engineering was succeeding:
scripts/economics.pyputs a realistic host at $2.256/1M tokens against a $0.150 commodity price (~15×), with break-even utilisation unreachable. That killed the marketplace and the reason a stranger would contribute hardware (D2).D7 (a second pair of eyes) never got its human reviewer, and 1.5 — a request served across a real NAT — was never earned, despite being the product.
Discrepancies found by reading the code, and fixed here
packages/node/README.mdhad the architecture backwards. It said the Ollama proxy was "the only backendruntime.pyassigns". It is not aruntime.pybackend at all:runtime.py:282assignsEchoBackendand nothing else, ever;OllamaBackendis never constructed outside a test; and nothing insrcever enqueues ontotask_queue. SoRuntime._worker_loop → InferenceBackend → ArtifactStoreis dead code in production, kept alive by a test namedtest_end_to_end_pipelinethat feeds the queue by hand. The live path isapi/inference.py → clients/ollama.py, a different class.The "155-word vocabulary" figure was never true.
LocalBoundaryEngineholds 116 words plus 4 special tokens, against a declaredvocab_sizeof 32,000. Counted, not recalled. The wrong number had propagated to five files, includingCLAUDE.mdand.claude/rules/node.md— the file governing how agents work in this repo.The
v1.0.1tag names a tree that declares itself1.0.0in all four packages.test_every_package_declares_the_same_versioncompares the four to each other and never to the tag, so V3's fix converged them on the previous version and the ratchet passed. Left as found and documented rather than bumped: a tree claiming to bev1.0.1that is not the releasedv1.0.1is the same confusion in a different hat.packages/website/README.mdcalled the project "a globally distributed, community-owned AI infrastructure" — the thing D6 decided not to build and D2 priced out. The site's own landing component had been corrected; the README had not. It also listed 5 of 9 pages, omittingdashboard,playgroundandstatus(the functional ones), and described the sibling packages as separate repositories."Python 3.11–3.14" implied four interpreters;
ci.ymlnames three (3.11, 3.12, 3.14). 3.13 is not in the matrix.Verification
./scripts/verify.shrun as a separate pass against the committed tree: PASS, 25 checks, commitd9dc89c9, clean tree.Two checks are UNVERIFIED, not passed — the gate names them itself:
compile under python3.14(interpreter not installed in this environment)website lint + tests(nonode_modules)CI on this PR runs both, which is the point of landing it this way.
Test evidence from the session that wrote this: 906 passed, 1 skipped — 397 scheduler / 260 node / 249 root.
STATUS.mdwas regenerated withscripts/generate_status.py, not hand-edited. It still reads CIUNVERIFIABLEbecause there is noghCLI in this environment; the root README explains that and cites run #33 onmainate5d1e7c, read through the API, which concluded success.Note
The repository is deliberately not being archived on GitHub — it stays writable. The READMEs state plainly that it is unmaintained, that there is no security response process, and that issues and PRs are not monitored.
Generated by Claude Code