Skip to content

Reorganize the repository: Website/, grouped Scripts, Docs, Benchmarks, app and tests - #495

Merged
stevyhacker merged 9 commits into
masterfrom
claude/repo-restructure
Nov 13, 2026
Merged

stevyhacker merged 9 commits into
masterfrom
claude/repo-restructure

Conversation

@stevyhacker

@stevyhacker stevyhacker commented Nov 13, 2026 •

Copy link
Copy Markdown
Owner

Reorganizes the repository so each kind of file has one home. It moves files and rewrites the references to them; no app behavior changes.

What moved

Before After
web/, cloudflare/, CLOUDFLARE.md, web/CLAUDE.md, the page generator and its templates in Scripts/ Website/public/, Website/worker/, Website/HOSTING.md, Website/AGENTS.md, Website/generator/ (+ templates/)
64 loose entries in Scripts/, plus script/build_and_run.sh Scripts/build/, release/, test/, media/, cotyping/, dev/ (ci/ and tests/ unchanged)
Flat Docs/ Docs/development/, releasing/, guides/, designs/, plans/, reports/, archive/; HACKATHON.md → Docs/meta-hackathon/README.md
DEVELOPMENT.md (29,000 words) An index; one page per topic in Docs/development/
RELEASING.md (1,068 lines) The Mac release runbook stays; one-time setup, Linux and Windows, package repositories, Android, Homebrew and MCP Registry move to Docs/releasing/
26 flat Benchmarks/ folders Benchmarks/transcribe/, think/, autocomplete/, search/, voice/
LokalBot/Views (135), Services (113), Models (90) flat Feature subfolders, with the same feature name in each layer (Meetings/, Speakers/, Timeline/, ScreenMemory/, ModelSetup/, …)
435 test files in LokalBotTests/ Same folders as the code they test; Integration/ for cross-feature replay, upgrade and benchmark tests; TestSupport/ for helpers (was Support/ + Helpers/)
Docs/meta-hackathon/demo-files (read by tests) LokalBotTests/Fixtures/meta-hackathon/demo-files
Two finished films Video/archive/

Docs/development/project-layout.md describes the new layout, and AGENTS.md points to it.

Removed

  • vercel.json: no Vercel deployment from this repository since 2026-09-14; the site deploys through Cloudflare Workers Builds.
  • The per-file .gitignore list of private drafts, replaced by one ignored Local/ folder. Docs/archive/superpowers/ was tracked while .gitignore ignored it; it no longer is. Vendor/ is anchored to the root, and tool caches (.ruff_cache, .wrangler, .cloudflare, muter_logs, /build, /output) are ignored.

Kept on purpose

  • wrangler.jsonc stays at the root: Workers Builds runs wrangler deploy there. It now points at Website/public and Website/worker.
  • README.md, PRIVACY.md, LICENSE, THIRD_PARTY_NOTICES.md, SECURITY.md, SUPPORT.md, AGENT_SETUP.md, CONTEXT.md stay at the root (GitHub, the app bundle and the CLI expect them there).
  • Benchmark evidence archives (*.tar.gz) and the launch-film MP4s stay tracked: about 40 reports and their reproduction commands use the archives, and history keeps them either way.
  • Recorded benchmark results (JSON, JSONL, CSV, logs) are not rewritten, even where they name old paths.

Links outside this repository

GitHub doesn't redirect moved files, so links to blob/master/<old path> from outside the repo will 404 after merge:

  • The Hugging Face Space's benchmark links (its source in Distribution/huggingface/ is updated here; the Space needs re-publishing).
  • Posts and pages elsewhere that link a benchmark report on master.
  • HACKATHON.md on master. The film links the meta-hackathon branch, which still has it.

In-repo links, including the website's and the HF Space source's links to master, are updated.

Checks

  • python3 -m unittest discover -s Scripts/tests: 222 tests pass.
  • python3 Website/generator/render_web.py --check: all 40 generated pages up to date.
  • Benchmark harness tests (Cotyping, OCR, MemoryRetention, Dictation) pass; every harness REPO/ROOT assignment (46) and every script's cd "$(dirname "$0")/…" (31) resolves to the repository root.
  • No new broken relative links in Markdown or HTML (181 before, 181 after; all pre-existing, in vendored model cards and old evidence).
  • xcodegen generate and swiftlint lint --strict pass.
  • Full local unit suite (Scripts/test/unit-tests.sh): two failures. CodingAgentSessionTests.testChangedFilesAreNamedRelativeToTheProject came from the move rewriting a made-up web/page.tsx in a test expectation; that's fixed in ec38358. SelectionActionsControllerTests.testBlockedCaptureRunsNothing is a timing test whose file only moved. Both classes then passed on their own (24 and 10 tests).
  • Cloudflare Workers Builds built the site from the root wrangler.jsonc pointing at Website/.
  • The UI-test runner detector in coding-agent activity (CodingAgentText.testRun, Rust TEST_RUN) now accepts Scripts/test/ui-tests.sh as well as the old path, with a test on each side.

Changed test expectations

  • Scripts/tests/test_localization.py keys view sources by file name instead of their path under Views/, so moving a view between feature folders keeps its entries in untranslated_view_literals.json; it asserts view file names stay unique.
  • Scripts/tests/test_build_relevance.py and the Build/XcodeGen workflow filters treat Website/** as docs-only (previously web/**, cloudflare/** and six named generator scripts).

…tes in Website/

web/ becomes Website/public/, cloudflare/ becomes Website/worker/, and the page
generator with its templates moves from Scripts/ to Website/generator/.
CLOUDFLARE.md becomes Website/HOSTING.md and web/CLAUDE.md becomes
Website/AGENTS.md. wrangler.jsonc stays at the root because Workers Builds runs
the deploy command there. vercel.json goes: no Vercel deployment since
2026-09-14.
build/ fetches runtimes, builds and installs; release/ versions, packages and
signs releases and keeps the release notes; test/ runs the test suites and makes
their data; media/ films and renders README and marketing media; cotyping/ holds
the autocomplete comparison tools; dev/ has the Codex run action (formerly
script/build_and_run.sh) and the sample meeting generator. ci/ and tests/ stay.
Each moved script now resolves the repository root from its new depth.
Dated files go to Docs/designs, plans and reports (dependency updates in their
own folder), the how-to kits to Docs/guides, and old working files, including
the June–July plans that .gitignore was hiding, to Docs/archive. HACKATHON.md
becomes Docs/meta-hackathon/README.md, and the two demo files the unit and UI
tests read move to LokalBotTests/Fixtures/meta-hackathon.

DEVELOPMENT.md is now an index of one page per topic under Docs/development.
RELEASING.md keeps the release runbook; its one-time setup and the Linux and
Windows, package repository, Android, Homebrew and MCP Registry sections move to
Docs/releasing. Links to their old anchors point at the new pages.
transcribe/, think/, autocomplete/, search/ and voice/ hold the 26 benchmark
folders. Harnesses that climb to the repository root do so from their new
depth, and in-repo links, including the website's and the Hugging Face Space
source's links to master, point at the new paths. Recorded results are not
rewritten.
…r code

Inside each layer, files move into feature folders that keep the same name
across layers (Meetings, Speakers, Timeline, ScreenMemory, ModelSetup, ...).
Existing Services subfolders stay. LokalBotTests mirrors LokalBot: each test
sits in its subject's folder, cross-feature replay, upgrade and benchmark tests
go to Integration/, and the test helpers in Support/ and Helpers/ become
TestSupport/. The localization test keys view sources by file name so a view
can move between folders without touching its literal list.
.gitignore replaces the per-file list of private drafts with Local/, anchors
Vendor/ to the root, ignores tool caches and output, and stops ignoring the
tracked Docs/archive/superpowers. Two finished films move to Video/archive.
Docs/development/project-layout.md describes the new layout and AGENTS.md
points to it. The Companion workflows' build-sync path filters follow the
script to Scripts/build/.
The detector matched only the old Scripts/ui-tests.sh path, so UI test runs
through the moved script would no longer show as "ran tests". Both paths now
match, on the Mac and in the port, with tests for each.
@stevyhacker
stevyhacker marked this pull request as ready for review November 13, 2026 15:16
The website move turned the made-up "web/page.tsx" in a displayPath test
expectation into a repository path; it is sample data, so it goes back. The
port's new UI-runner test follows rustfmt's layout.
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
lokalbot 93cb959 Commit Preview URL

Branch Preview URL
Nov 13 2026, 03:49 PM

generate.sh reads the seed script as the release shipped it, with git show
v<version>:<path>. Tags before the reorganization have it at
Scripts/seed_demo_library.py, so try the new path first and fall back to the
old one.
@stevyhacker
stevyhacker merged commit 00f32ce into master Nov 13, 2026
36 of 40 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant