Skip to content

chore: src-layout, notebooks→examples, distribute working docs out of root - #49

Merged
mikessh merged 1 commit into
masterfrom
chore/repo-cleanup
Jul 19, 2026
Merged

chore: src-layout, notebooks→examples, distribute working docs out of root#49
mikessh merged 1 commit into
masterfrom
chore/repo-cleanup

Conversation

@mikessh

@mikessh mikessh commented Jul 19, 2026

Copy link
Copy Markdown
Member

Repo hygiene for the 3.4.0 release — no change to the installed package (import name, API, and wheel contents are identical).

Changes

  • src-layout: mir/src/mir/. Hatch packages = ["src/mir"] maps it to mir at the wheel root; verified the built wheel has mir/__init__.py at root, mir/cli.py, and bundled mir/resources/…, with no src/ leak. Coverage omit-paths + docs/conf.py sys.path updated.
  • notebooks/examples/ (the [examples] extra + the docs examples page updated).
  • Distributed the working result/plan docs out of the repo root (they already lived richer in the analysis repo; only the stale experiments/-path dupes were here):
    • THEORY.md2026-mirpy-ms (beside the theory appendix).
    • BENCHMARKS.md, REPERTOIRE_EMBEDDING.md, REPERTOIRE_LESSONS.md, SQRT_D_MIGRATION.md, ROADMAP.md2026-mirpy-analysis/benchmarks/.
    • Root now keeps only README / CHANGELOG / CLAUDE / SOURCES. README/docs/CLAUDE references repointed to the sibling repos.

Verification

  • Fast suite (uv .venv): 131 passed, 6 skipped.
  • Zero-warning Sphinx build.
  • py3-none-any wheel + twine check PASSED.

Folds into the unpublished 3.4.0 (CHANGELOG updated under 3.4.0 → Changed).

🤖 Generated with Claude Code

… root

Repo hygiene for the 3.4.0 release; no change to the installed package.

- src-layout: mir/ -> src/mir/ (hatch packages=["src/mir"] maps it to `mir` at the
  wheel root; import name and API unchanged). Coverage/omit paths + docs sys.path updated.
- notebooks/ -> examples/ (the [examples] extra + docs/examples page updated).
- Removed the working result/plan docs from the repo root, distributed to the sibling
  repos: THEORY.md -> 2026-mirpy-ms; BENCHMARKS.md, REPERTOIRE_{EMBEDDING,LESSONS}.md,
  SQRT_D_MIGRATION.md, ROADMAP.md -> 2026-mirpy-analysis/benchmarks/. Root keeps
  README/CHANGELOG/CLAUDE/SOURCES. README/docs/CLAUDE references repointed.

Verified: 131 passed / 6 skipped (fast tier) in the uv .venv; zero-warning Sphinx
build; py3-none-any wheel (mir/ at root, resources bundled) + twine check PASSED.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@mikessh
mikessh merged commit 045daad into master Jul 19, 2026
4 checks passed
@mikessh
mikessh deleted the chore/repo-cleanup branch July 19, 2026 05:55
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