Document test-release workflow

Author: jgwill

Makefile

@@ -1,4 +1,4 @@
-.PHONY: install test build sdist bdist_wheel upload clean
+.PHONY: install test build sdist bdist_wheel upload clean test-release
 
 install:
 	pip install -r requirements.txt
@@ -20,3 +20,6 @@ upload: build
 
 clean:
 	rm -rf build/ dist/ *.egg-info **/*.egg-info
+
+test-release: clean test build
+	twine upload --repository testpypi dist/*

README.md

@@ -152,6 +152,18 @@ coaia p dictkore "my text to correct"
 
 Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.
 
+## Test Release
+
+To publish a distribution to TestPyPI, run:
+
+```bash
+make test-release
+```
+
+This command cleans build artifacts, runs tests, builds the package and uploads
+it to TestPyPI using Twine. Ensure `TWINE_USERNAME` and `TWINE_PASSWORD` are set
+with your TestPyPI credentials.
+
 ## License
 
 This project is licensed under the MIT License. See the LICENSE file for more details.

codex/ledgers/ledger-test-release-2506151426.json

@@ -0,0 +1,14 @@
+{
+  "timestamp": "2506151426",
+  "agents": ["🧠 Mia", "🌸 Miette", "🕊️ Seraphine", "🎸 JamAI"],
+  "narrative": "Added Makefile target 'test-release' for automated building and uploading to TestPyPI. Updated README with usage instructions and refreshed the narrative map. This enables simpler preview releases.",
+  "routing": {
+    "files": ["Makefile", "README.md", "narrative-map.md"],
+    "branch": "work"
+  },
+  "purpose": "Implement wrapper command for TestPyPI publication and document its usage.",
+  "user_input": "make the necessary make test-release that would wrap all needed to publish to the pypi test release",
+  "scene_enablement": "Before: releasing required manual build and upload steps. Now: `make test-release` performs tests, build, and upload in one command.",
+  "glyph_sequence": "🧠🌸🕊️🎸",
+  "session": ""
+}

narrative-map.md

@@ -2,7 +2,14 @@
 
 ## Commits
 
-- `d6f5237` – Fix config lookup and tests
+- `29175ca` – Add test-release target
+- `6ae8cda` – Fix configuration lookup and CLI tests
 - `584e086` – stuff
 
-This round corrects configuration discovery and quiets debug output so that CLI tests pass. A validation report is introduced documenting that the command-line help output aligns with existing documentation, with an additional `fetch` command noted.
+The last update repaired configuration discovery, removed stray debug prints, and confirmed that CLI help output matches documentation. A validation report notes the existence of an additional `fetch` command.
+
+This round introduces a `make test-release` command that runs tests, builds the
+package and uploads it to TestPyPI. Documentation was updated to describe the
+workflow.
+
+Glyph sequence for this phase: 🧠🌸🕊️🎸