Skip to content

Close remaining automatable release tasks #11

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
krahd merged 1 commit into from
May 9, 2026
Merged

Close remaining automatable release tasks #11

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 12 additions & 4 deletions STATUS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# BatLLM Status

Last updated: 2026-05-09 14:13
Last updated: 2026-05-09 18:35

## Project Purpose

Expand Down Expand Up @@ -77,6 +77,7 @@ The codebase is currently aligned on `modelito==1.4.0` and now uses structured r

## Recent Changes

- Re-ran the full automatable release-readiness pass on 2026-05-09; all non-manual validation and packaging steps completed successfully.
- Release-preparation work is functionally complete for the automatable path: release bundles build, Homebrew formula generation works, and packaging smoke validation passes.
- The repository remains on version `0.3.5`; the earlier `1.0.0` notes are retained only as draft reference material and are not the active release line.
- Root launchers and `run_tests.py` were stabilised so repository-root execution works without ad-hoc `PYTHONPATH` setup.
Expand All @@ -90,6 +91,13 @@ The codebase is currently aligned on `modelito==1.4.0` and now uses structured r

Recent verified commands:

- `/Users/tom/devel/ml-llm/llm/BatLLM/.venv_BatLLM/bin/python -m pytest -q` -> `151 passed, 2 skipped`.
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot May 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Replace machine-specific validation paths

These new STATUS entries commit /Users/tom/.../.venv_BatLLM/bin/python paths, which are machine-specific and violate the repository's AGENTS.md rule to avoid committing machine-specific absolute paths. In the project status report this also makes the recorded validation commands non-reusable for anyone outside that local workstation; prefer repository-relative commands such as python -m pytest -q or note that they were run inside the project virtual environment.

Useful? React with 👍 / 👎.

- `/Users/tom/devel/ml-llm/llm/BatLLM/.venv_BatLLM/bin/python run_tests.py full` -> core smoke `4 passed`; full suite `153 passed`; live-Ollama lifecycle start/stop verified.
- `/Users/tom/devel/ml-llm/llm/BatLLM/.venv_BatLLM/bin/python create_release_bundles.py` -> generated `dist/releases/BatLLM-v0.3.5-{source.zip,source.tar.gz,windows.zip,macos.zip,linux.tar.gz}`.
- `/Users/tom/devel/ml-llm/llm/BatLLM/.venv_BatLLM/bin/python create_homebrew_formula.py --create-worktree-archive /tmp/BatLLM-homebrew-source.tar.gz --formula-out /tmp/batllm.rb` -> completed successfully and wrote `/tmp/batllm.rb`.
- `/Users/tom/devel/ml-llm/llm/BatLLM/.venv_BatLLM/bin/python -m pytest -q src/tests/test_homebrew_packaging.py` -> `7 passed`.
- `/Users/tom/devel/ml-llm/llm/BatLLM/.venv_BatLLM/bin/python validate_packaging_smoke.py` -> `Packaging smoke validation passed.`
- `gh api repos/krahd/BatLLM/branches/main/protection --jq '.required_status_checks.contexts'` -> confirmed required checks: `ubuntu-latest`, `windows-latest`, `macos-latest`, `Homebrew dry-run`, `Smoke: Ollama integration`.
- `python run_tests.py full` -> core smoke `4 passed`; full suite `153 passed`; live-Ollama lifecycle start/stop verified.
- `pytest -q` -> `151 passed, 2 skipped`.
- `pytest -q src/tests/test_homebrew_packaging.py` -> `7 passed`.
Expand All @@ -103,8 +111,6 @@ Recent verified commands:
- `doxygen docs/code/dox_config.properties` -> completed successfully; generated docs align with version `0.3.5`.
- `gh api repos/krahd/BatLLM/branches/main/protection` -> verified the live required-check configuration on `main`.

This PR is documentation-only; no additional code execution was required for the STATUS sanitisation itself.

## Known Issues, Risks, And Limitations

- `src/llm/service.py` still owns BatLLM-specific overlay logic and timeout policy; avoid re-expanding it into a generic provider abstraction already handled by `modelito`.
Expand Down Expand Up @@ -136,6 +142,8 @@ Remaining external maintainer actions (not fully automatable from this workspace
1. Complete Linux and Windows manual first-run checklist execution and finalise checklist sign-off as complete.
2. Perform final release branch freeze/tag workflow (`v0.3.5`) once the manual platform sign-offs are complete.

No additional automatable next steps remain open in this workspace.

## Longer-Term Steps

1. Decide GUI direction for web-app surface versus Kivy-only roadmap. Analysis: this is the highest-leverage product decision because multiplayer, prompt sharing, and deployment choices all depend on whether Kivy remains the only client. Kivy and a web surface can coexist, but the added complexity yields no clear gain before 1.0. Decision: defer a web surface until after 1.0; revisit only if cross-device or teacher-mode use cases demand it. Comparable projects (Jan, GPT4All) gained traction without a web surface first.
Expand All @@ -148,4 +156,4 @@ Remaining external maintainer actions (not fully automatable from this workspace

---

Last updated: 2026-05-09 14:13
Last updated: 2026-05-09 18:35
10 changes: 9 additions & 1 deletion docs/FIRST_RUN_RELEASE_CHECKLIST.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ Use this checklist before each release candidate.
## Sign-off

- checklist completed by maintainer: in progress (Copilot-assisted local run)
- date: 2026-05-08
- date: 2026-05-09
- release candidate tag: v0.3.5-rc1

## Current Execution Record (2026-05-08)
Expand All @@ -62,3 +62,11 @@ Use this checklist before each release candidate.
- Linux: pending manual first-run checklist execution on a Linux host.
- Windows: pending manual first-run checklist execution on a Windows host.
- Release policy note: keep the project on the `0.x` line pending maintainer testing sign-off.

## Current Execution Record (2026-05-09)

- Re-ran the full automated validation stack locally: `pytest -q` (`151 passed, 2 skipped`) and `python run_tests.py full` (`4 passed` core smoke; `153 passed` full).
- Re-ran packaging/release automation locally: `python create_release_bundles.py`, Homebrew formula generation to `/tmp/batllm.rb`, `python -m pytest -q src/tests/test_homebrew_packaging.py` (`7 passed`), and `python validate_packaging_smoke.py` (passed).
- Reconfirmed `main` branch protection required checks: `ubuntu-latest`, `windows-latest`, `macos-latest`, `Homebrew dry-run`, `Smoke: Ollama integration`.
- Linux: still pending manual first-run checklist execution on a Linux host.
- Windows: still pending manual first-run checklist execution on a Windows host.
Loading