Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
8 changes: 3 additions & 5 deletions STATUS.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
# BatLLM Status

Last updated: 2026-05-10 00:51

## Project Purpose
Last updated: 2026-05-10 01:04
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Use the local wall-clock STATUS timestamp

This update records 01:04, but the reviewed commit was made in this UTC workspace at 2026-05-10 04:06:21 +0000, so the required Last updated value is already several hours stale. The repository instructions call a stale or incorrectly formatted STATUS.md timestamp a blocking documentation error, and the final line must be updated to the same corrected value as well.

Useful? React with 👍 / 👎.


BatLLM is a Python/Kivy research, education, and game project for exploring AI-mediated play, prompt quality, LLM behaviour, and local-model workflows. The repository currently contains a playable local desktop game, a standalone read-only Game Analyzer, local Ollama lifecycle and model-management helpers routed through `modelito`, release-bundle tooling, Homebrew formula generation, generated API reference artefacts, and maintained user/developer documentation.

Expand Down Expand Up @@ -89,7 +87,7 @@ This status update followed a repository-wide audit on 2026-05-09. The audit ins
- Mock-Ollama smoke validation now accepts a responding `/api/version` endpoint when process-level inspection cannot identify the mock server as an Ollama process.
- Generated Doxygen output under `docs/code/` was regenerated after source and version changes. Existing Doxygen warnings are mostly undocumented Kivy/test helper classes and remain non-blocking documentation debt.
- Architecture and runtime-flow SVG diagrams were redrawn with larger canvases, wrapped text, boundary-aligned connectors, plain arrow labels, and clearer label placement.
- `docs/index.html` is now the public GitHub Pages showcase site for `https://krahd.github.io/BatLLM/`; GitHub Pages now serves from branch `main` and path `/docs`, the hero no longer uses a diagram background or top-of-page gameplay image, the page uses a darker modernised visual system, grant/provenance notes are surfaced in a dedicated section, Tomas Laurenzo attribution remains in provenance/footer copy, the demo GIF is used once in-page, and inline text links are no longer bolded.
- `docs/index.html` is now the public GitHub Pages showcase site for `https://krahd.github.io/BatLLM/`; GitHub Pages now serves from branch `main` and path `/docs`, the hero no longer uses a diagram background or top-of-page gameplay image, the page uses a darker modernised visual system, grant/provenance notes are surfaced in a dedicated section, Tomas Laurenzo attribution remains in provenance/footer copy, the demo GIF is used once in-page, inline text links are no longer bolded, the hero eyebrow label has been removed, the hero right column shows the project logo at large scale, the screenshot has rectangular (zero-radius) corners, and documentation links in the hero and links grid point to the rendered GitHub pages for README, USER_GUIDE, CONTRIBUTING, and CREDITS.
- The git worktree was clean at the start of this audit; current changes are intentional audit/remediation updates.

## Current Implementation State
Expand Down Expand Up @@ -277,4 +275,4 @@ The previous status report recorded these successful checks from the same releas
- Design the 2.0 server contract before adding web or repository-backed prompt/game sharing.
- Add broader tests for malformed model responses, slow startup, missing models, session compatibility, analyzer edge cases, and packaged first-run behaviour.

Last updated: 2026-05-10 00:51
Last updated: 2026-05-10 01:04
48 changes: 26 additions & 22 deletions docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -185,26 +185,21 @@
width: 100%;
margin: 0 auto;
padding: 92px 28px 118px;
display: grid;
grid-template-columns: 1fr auto;
gap: 60px;
align-items: center;
}

.hero-copy {
max-width: 680px;
}

.eyebrow {
display: inline-flex;
align-items: center;
gap: 10px;
margin-bottom: 18px;
padding: 8px 14px;
border: 1px solid rgba(255, 255, 255, 0.12);
border-radius: 999px;
background: rgba(255, 255, 255, 0.04);
color: rgba(243, 246, 248, 0.82);
font-size: 12px;
font-weight: 800;
letter-spacing: 0.12em;
text-transform: uppercase;
.hero-logo img {
width: 300px;
height: 300px;
object-fit: contain;
opacity: 0.88;
}

h1 {
Expand Down Expand Up @@ -361,7 +356,7 @@

.media-frame {
border: 1px solid var(--line);
border-radius: 24px;
border-radius: 0;
background: rgba(255, 255, 255, 0.04);
box-shadow: var(--shadow);
overflow: hidden;
Expand Down Expand Up @@ -507,6 +502,13 @@

.hero-inner {
padding-top: 74px;
grid-template-columns: 1fr;
}

.hero-logo img {
width: 180px;
height: 180px;
margin: 0 auto;
}

.support-panel,
Expand Down Expand Up @@ -585,7 +587,6 @@
<section class="hero" aria-label="BatLLM overview">
<div class="hero-inner">
<div class="hero-copy">
<span class="eyebrow">Local-first AI play and analysis</span>
<h1>BatLLM</h1>
<p>
A local AI-mediated battle game for studying prompts, model behaviour, strategy,
Expand All @@ -596,6 +597,9 @@ <h1>BatLLM</h1>
<a class="button secondary" href="https://github.com/krahd/BatLLM">View Source</a>
</div>
</div>
<div class="hero-logo">
<img src="./images/logo-small.png" alt="BatLLM logo">
</div>
</div>
</section>

Expand Down Expand Up @@ -690,8 +694,8 @@ <h2 id="local-models-title">Local model workflows stay visible</h2>
and repeatable analyzer sessions.
</p>
<div class="hero-actions">
<a class="button ghost" href="./README.md">Read The Overview</a>
<a class="button ghost" href="./USER_GUIDE.md">Open The User Guide</a>
<a class="button ghost" href="https://github.com/krahd/BatLLM/blob/main/docs/README.md">Read The Overview</a>
<a class="button ghost" href="https://github.com/krahd/BatLLM/blob/main/docs/USER_GUIDE.md">Open The User Guide</a>
</div>
</div>
</section>
Expand All @@ -703,19 +707,19 @@ <h2 id="docs-title">Build, play, inspect, and contribute</h2>
keeps the research framing, setup notes, tests, packaging details, and release criteria together.
</p>
<div class="links-grid">
<a class="link-card" href="./README.md">
<a class="link-card" href="https://github.com/krahd/BatLLM/blob/main/docs/README.md">
<strong>README</strong>
<p>Project overview, setup, compatibility, Homebrew notes, and troubleshooting.</p>
</a>
<a class="link-card" href="./USER_GUIDE.md">
<a class="link-card" href="https://github.com/krahd/BatLLM/blob/main/docs/USER_GUIDE.md">
<strong>User Guide</strong>
<p>Rules, match flow, settings, Ollama screens, analyzer workflow, and saved sessions.</p>
</a>
<a class="link-card" href="./CONTRIBUTING.md">
<a class="link-card" href="https://github.com/krahd/BatLLM/blob/main/docs/CONTRIBUTING.md">
<strong>Contributing</strong>
<p>Developer setup, architecture, tests, release workflow, and documentation process.</p>
</a>
<a class="link-card" href="./CREDITS.md">
<a class="link-card" href="https://github.com/krahd/BatLLM/blob/main/docs/CREDITS.md">
<strong>Credits</strong>
<p>Project authorship, grant support, institutional context, and acknowledgements.</p>
</a>
Expand Down
Loading