Merge pull request #25 from PyAutoLabs/feature/memory-structure-cleanup

Restructure: wiki/ + bibliography consolidation, structure lint (#24)

Author: Jammy2211

.github/workflows/validate.yml

@@ -0,0 +1,18 @@
+name: validate
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: pip install pytest
+      - run: make validate
+      - run: make test

.gitignore

@@ -34,6 +34,7 @@ desktop.ini
 *.swp
 *~
 __pycache__/
+.pytest_cache/
 *.pyc
 
 # LaTeX build artefacts
@@ -48,4 +49,4 @@ __pycache__/
 *.toc
 
 # Exception — the wiki's own log.md is text and must be tracked
-!lensing_wiki/log.md
+!wiki/*/log.md

AGENTS.md

@@ -15,13 +15,31 @@ packaging, tooling, and workflow tasks.
 When you do read:
 
 1. **Index first.** Start at [`index.md`](index.md), then the relevant
-   sub-wiki's own `index.md` (`lensing_wiki/`, `smbh_wiki/`, `cti_wiki/`,
-   `methods_wiki/`, `galaxies_wiki/`).
+   sub-wiki's own `index.md` (`wiki/lensing/`, `wiki/smbh/`, `wiki/cti/`,
+   `wiki/methods/`, `wiki/galaxies/`).
 2. **Then at most 2–3 pages.** Read only the concept/entity/source pages the
    index points you to. **Never bulk-load a sub-wiki.**
 3. **Do not couple to the internal layout** — reach pages through the indexes,
    not hard-coded paths.
 
+## The write contract (layout rules)
+
+The repo has exactly **two content homes**, enforced by
+`make validate-structure` (CI runs it on every push/PR):
+
+- **`wiki/<domain>/`** — every sub-wiki, following the shared schema in
+  [`wiki/CLAUDE.md`](wiki/CLAUDE.md). New sub-wikis are added beside the
+  existing ones, never at the repo root.
+- **`bibliography/`** — the *only* place BibTeX lives. One canonical file
+  (`pyautomemory.bib`) plus `bibkey_aliases.yaml`; never add loose `.bib`
+  files anywhere else.
+
+**Source PDFs live off-repo.** Never commit a paper (PDF/HTML, with or
+without a file extension) — read it, stub it in the right
+`wiki/<domain>/sources/*.md`, add its canonical entry to `bibliography/`,
+and run `make validate`. Unrecognised top-level files/folders fail the lint;
+the allowlist is in `scripts/validate_structure.py`.
+
 ## What does NOT live here
 
 - **Operational history** — what the organism *did* (prior tasks, decisions,

CTI/Hall1952Theory

@@ -1,4 +1,12 @@
-.PHONY: validate-literature-citations
+.PHONY: validate validate-literature-citations validate-structure test
+
+validate: validate-literature-citations validate-structure
 
 validate-literature-citations:
 	python scripts/validate_literature_citations.py
+
+validate-structure:
+	python scripts/validate_structure.py
+
+test:
+	python -m pytest tests/ -q