codemble 0.3.0__tar.gz → 0.3.1__tar.gz

{codemble-0.3.0 → codemble-0.3.1}/CHANGELOG.md

@@ -5,6 +5,16 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) · Versioning:
 
 ## [Unreleased]
 
+## [0.3.1] - 2026-07-19
+
+### Changed
+- Packaging metadata only, no behavior change: added PyPI classifiers (Beta
+  status, Python 3.11-3.13, Apache-2.0 license, dev/education audience), moved
+  license metadata to the PEP 639 SPDX form so the License field is concise
+  instead of dumping the full Apache text, made README links absolute so the
+  PyPI project page renders them, and excluded internal tooling directories
+  from the sdist.
+
 ## [0.3.0] - 2026-07-19
 
 ### Added

codemble-0.3.1/PKG-INFO

@@ -0,0 +1,219 @@
+Metadata-Version: 2.4
+Name: codemble
+Version: 0.3.1
+Summary: A learning game that turns the code AI wrote for you into a galaxy you light up by understanding it.
+Project-URL: Homepage, https://udhawan97.github.io/Codemble/
+Project-URL: Repository, https://github.com/udhawan97/Codemble
+Author-email: Umang Dhawan <umangdhawan97@gmail.com>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Education
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.115
+Requires-Dist: tree-sitter-javascript<0.26,>=0.25
+Requires-Dist: tree-sitter-typescript<0.24,>=0.23.2
+Requires-Dist: tree-sitter<0.27,>=0.25
+Requires-Dist: uvicorn>=0.30
+Provides-Extra: dev
+Requires-Dist: httpx>=0.27; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+
+<p align="center">
+  <a href="https://udhawan97.github.io/Codemble/">
+    <img src="https://github.com/udhawan97/Codemble/raw/main/docs-site/public/brand/mark-animated.svg" alt="Codemble — an open lapis ensō whose amber star systems light up" width="152">
+  </a>
+</p>
+
+<h1 align="center">Codemble</h1>
+
+<p align="center"><strong>Turn AI-built code into a galaxy you actually understand.</strong></p>
+
+<p align="center">
+  Codemble is a local-first learning game for projects built with Claude Code,
+  Codex, and other coding agents. It maps real parser evidence into a 3D galaxy,
+  then lights each region only after you prove you understand it.
+</p>
+
+<p align="center"><strong>Your project · Your key · Your machine · No invented structure</strong></p>
+
+<p align="center">
+  <a href="https://github.com/udhawan97/Codemble/releases/latest"><img src="https://img.shields.io/github/v/release/udhawan97/Codemble?style=flat-square&label=release&color=2b4d96" alt="Latest release"></a>
+  <a href="https://github.com/udhawan97/Codemble/actions/workflows/ci.yml"><img src="https://github.com/udhawan97/Codemble/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI status"></a>
+  <img src="https://img.shields.io/badge/Python-3.11+-2b4d96?style=flat-square" alt="Python 3.11 or newer">
+  <img src="https://img.shields.io/badge/maps-Python_·_JavaScript_·_TypeScript-3f6ac0?style=flat-square" alt="Maps Python, JavaScript, and TypeScript projects">
+  <img src="https://img.shields.io/badge/license-Apache_2.0-070b1c?style=flat-square" alt="Apache 2.0 license">
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick start</a> ·
+  <a href="#how-the-learning-loop-works">Learning loop</a> ·
+  <a href="https://udhawan97.github.io/Codemble/">Documentation</a> ·
+  <a href="https://github.com/udhawan97/Codemble/blob/main/TESTING.md">Test Codemble</a>
+</p>
+
+<p align="center">
+  <img src="https://github.com/udhawan97/Codemble/raw/main/assets/demo.gif" alt="Codemble maps a project, enters Home, runs graph-derived checks, and lights the system" width="960">
+</p>
+
+> [!IMPORTANT]
+> **Codemble is in its Phase 1 tester release.** It maps Python,
+> JavaScript, TypeScript, and mixed projects in one parser-proven galaxy,
+> installable straight from PyPI with an in-app project picker. The
+> technical release is complete; unaided learner runs are the evidence still
+> being collected. [Try the ten-minute tester loop](https://github.com/udhawan97/Codemble/blob/main/TESTING.md).
+
+## Quick start
+
+```bash
+uvx codemble            # or: pipx install codemble && codemble
+```
+
+Codemble opens your browser — pick your project folder there. To skip the
+picker, pass a path: `codemble ./your-ai-built-project`.
+
+The wheel already contains the web app, so Node.js is not required. No API key
+is needed for the galaxy, source viewer, language Lens, checks, lighting, or
+saved progress. Add your own Anthropic or OpenAI key only if you want grounded
+prose explanations:
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...   # or OPENAI_API_KEY=sk-...
+```
+
+[Installation, configuration, and troubleshooting →](https://udhawan97.github.io/Codemble/installation/)
+
+## How the learning loop works
+
+| Step | What Codemble does | What you gain |
+| --- | --- | --- |
+| **1. Chart** | Parses your project without running its code or package scripts | A deterministic map made from source evidence |
+| **2. Navigate** | Guides you from galaxy → system → study on scripted camera rails | Orientation without getting lost in free flight |
+| **3. Study** | Shows the real source, exact line numbers, neighbors, and parser-detected language idioms | Context tied to code you can inspect |
+| **4. Prove** | Generates and scores checks from the graph—never from the model | A region lights only when understanding is demonstrated |
+| **5. Return** | Saves progress locally; changing one file re-dims only its module | A living map that stays honest as the project changes |
+
+No XP. No streaks. No leaderboard. The visible reward is the useful one: more
+of your own code becomes a sky you understand.
+
+## Read the galaxy
+
+| In the galaxy | In your project |
+| --- | --- |
+| A star system | One source module |
+| A planet | A function or class |
+| The Home system | The selected parser-ranked entrypoint |
+| A route or edge | An import or call; approximate calls are labeled **possible** |
+| Size | Lines of code |
+| Brightness | Structural centrality |
+| Dim → lit | Not yet proven → understood |
+
+Python-only, JavaScript-only, TypeScript-only, and mixed projects share the same
+graph contract. Language focus changes only what you are looking at; it never
+changes coordinates, progress, or parser truth.
+
+## Honest by construction
+
+Codemble is built for learners who may not yet be able to spot a confident
+mistake. Accuracy therefore outranks spectacle:
+
+- Structure, entrypoints, concepts, imports, and calls come from parsers.
+- Every explanation points to a real `file:line` and may name only supplied
+  identifiers and relationships.
+- Language Lens notes appear only where a parser detected the construct.
+- Check answers come from the graph, never an LLM.
+- Approximate relationships stay visibly uncertain.
+- Provider output that fails grounding validation is withheld instead of being
+  softened into a guess.
+
+Read the full [correctness contract](https://udhawan97.github.io/Codemble/correctness/).
+A wrong explanation is a highest-severity bug—[report it without mercy](https://github.com/udhawan97/Codemble/issues).
+
+## Local-first, with an explicit AI boundary
+
+| Stays on your machine | Leaves only when you ask |
+| --- | --- |
+| Project discovery and parsing | The bounded Study context sent to your configured provider |
+| Graph, language Lens, and checks | A request triggered only when you open Study |
+| Local server and packaged web app | Nothing in the background |
+| Progress and explanation cache in `~/.codemble/` | No accounts, telemetry, or Codemble cloud |
+
+No key? Codemble remains a complete parser-backed map and learning game; only
+the optional prose narration is unavailable.
+
+## Boundaries that keep the map truthful
+
+- **Supported source:** Python 3.11+, JavaScript/JSX, TypeScript/TSX, and mixed
+  projects. Unsupported languages stay outside the graph rather than being guessed.
+- **Scale:** above roughly 300 supported source files, choose a subdirectory —
+  the in-app picker prompts for the scope, or pass
+  `codemble --path ./project/subdirectory`.
+- **Ambiguous Home:** choose a parser-ranked entrypoint in the app or pass
+  `--entrypoint NODE_ID`.
+- **Broken source:** syntax errors remain visible; Codemble maps safe partial
+  evidence instead of crashing or inventing the missing structure.
+- **Rendering:** WebGL is required. There is intentionally no misleading 2D
+  fallback in this release.
+
+## Help test the release
+
+The most valuable contribution right now is not a feature request. It is a
+first run on a real AI-built project:
+
+1. Follow the [ten-minute tester guide](https://github.com/udhawan97/Codemble/blob/main/TESTING.md).
+2. Light at least one system.
+3. Report confusion verbatim—never paste private source or API keys.
+
+[Open an early-tester report →](https://github.com/udhawan97/Codemble/issues/new?template=early_tester.yml)
+
+## Develop
+
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest && ruff check .
+
+(cd web && npm install && npm run check)
+(cd docs-site && npm install && npm run check && npm run build)
+```
+
+The load-bearing design and architecture contracts are documented, not implied:
+
+- [Architecture](https://udhawan97.github.io/Codemble/architecture/)
+- [Contributing](https://github.com/udhawan97/Codemble/blob/main/CONTRIBUTING.md)
+- [Formal Edo design system](https://github.com/udhawan97/Codemble/blob/main/docs-site/design.md)
+- [Agent operating guide and current state](https://github.com/udhawan97/Codemble/blob/main/CLAUDE.md)
+
+## Roadmap
+
+| Horizon | Work |
+| --- | --- |
+| **Now** | Collect unaided first-run evidence on the current release across supported project types |
+| **Next** | Go, Rust, and Java adapters; level-of-detail rendering for larger repositories |
+| **Later** | Read-only share links, new quest types, and the coordinated public launch |
+
+The [public roadmap](https://udhawan97.github.io/Codemble/roadmap/) separates
+shipped work from planned work. Milestones move only when their acceptance
+evidence exists.
+
+## License
+
+Codemble is released under the [Apache License 2.0](https://github.com/udhawan97/Codemble/blob/main/LICENSE).
+
+---
+
+<p align="center"><sub>
+  Built for the moment after “AI made it work” and before “I know how it works.”
+</sub></p>

{codemble-0.3.0 → codemble-0.3.1}/README.md

@@ -1,8 +1,7 @@
-<!-- Hallmark · pre-emit critique: P5 H5 E5 S5 R5 V4 -->
 
 <p align="center">
   <a href="https://udhawan97.github.io/Codemble/">
-    <img src="docs-site/public/brand/mark-animated.svg" alt="Codemble — an open lapis ensō whose amber star systems light up" width="152">
+    <img src="https://github.com/udhawan97/Codemble/raw/main/docs-site/public/brand/mark-animated.svg" alt="Codemble — an open lapis ensō whose amber star systems light up" width="152">
   </a>
 </p>
 
@@ -30,18 +29,19 @@
   <a href="#quick-start">Quick start</a> ·
   <a href="#how-the-learning-loop-works">Learning loop</a> ·
   <a href="https://udhawan97.github.io/Codemble/">Documentation</a> ·
-  <a href="TESTING.md">Test v0.2.0</a>
+  <a href="https://github.com/udhawan97/Codemble/blob/main/TESTING.md">Test Codemble</a>
 </p>
 
 <p align="center">
-  <img src="assets/demo.gif" alt="Codemble maps a project, enters Home, runs graph-derived checks, and lights the system" width="960">
+  <img src="https://github.com/udhawan97/Codemble/raw/main/assets/demo.gif" alt="Codemble maps a project, enters Home, runs graph-derived checks, and lights the system" width="960">
 </p>
 
 > [!IMPORTANT]
-> **v0.2.0 is the current Phase 1 tester release.** It maps Python,
-> JavaScript, TypeScript, and mixed projects in one parser-proven galaxy. The
+> **Codemble is in its Phase 1 tester release.** It maps Python,
+> JavaScript, TypeScript, and mixed projects in one parser-proven galaxy,
+> installable straight from PyPI with an in-app project picker. The
 > technical release is complete; unaided learner runs are the evidence still
-> being collected. [Try the ten-minute tester loop](TESTING.md).
+> being collected. [Try the ten-minute tester loop](https://github.com/udhawan97/Codemble/blob/main/TESTING.md).
 
 ## Quick start
 
@@ -52,17 +52,10 @@ uvx codemble            # or: pipx install codemble && codemble
 Codemble opens your browser — pick your project folder there. To skip the
 picker, pass a path: `codemble ./your-ai-built-project`.
 
-> Until the first PyPI release (v0.3.0) lands, install from the tag instead —
-> v0.2.0 has no picker yet, so pass your project path:
->
-> ```bash
-> pipx install git+https://github.com/udhawan97/Codemble.git@v0.2.0
-> codemble ./your-ai-built-project
-> ```
-
-The wheel already contains the web app, so Node.js is not required. No API key is needed for the galaxy,
-source viewer, language Lens, checks, lighting, or saved progress. Add your own
-Anthropic or OpenAI key only if you want grounded prose explanations:
+The wheel already contains the web app, so Node.js is not required. No API key
+is needed for the galaxy, source viewer, language Lens, checks, lighting, or
+saved progress. Add your own Anthropic or OpenAI key only if you want grounded
+prose explanations:
 
 ```bash
 export ANTHROPIC_API_KEY=sk-ant-...   # or OPENAI_API_KEY=sk-...
@@ -147,7 +140,7 @@ the optional prose narration is unavailable.
 The most valuable contribution right now is not a feature request. It is a
 first run on a real AI-built project:
 
-1. Follow the [ten-minute tester guide](TESTING.md).
+1. Follow the [ten-minute tester guide](https://github.com/udhawan97/Codemble/blob/main/TESTING.md).
 2. Light at least one system.
 3. Report confusion verbatim—never paste private source or API keys.
 
@@ -167,15 +160,15 @@ pytest && ruff check .
 The load-bearing design and architecture contracts are documented, not implied:
 
 - [Architecture](https://udhawan97.github.io/Codemble/architecture/)
-- [Contributing](CONTRIBUTING.md)
-- [Formal Edo design system](docs-site/design.md)
-- [Agent operating guide and current state](CLAUDE.md)
+- [Contributing](https://github.com/udhawan97/Codemble/blob/main/CONTRIBUTING.md)
+- [Formal Edo design system](https://github.com/udhawan97/Codemble/blob/main/docs-site/design.md)
+- [Agent operating guide and current state](https://github.com/udhawan97/Codemble/blob/main/CLAUDE.md)
 
 ## Roadmap
 
 | Horizon | Work |
 | --- | --- |
-| **Now** | Collect unaided first-run evidence on v0.2.0 across supported project types |
+| **Now** | Collect unaided first-run evidence on the current release across supported project types |
 | **Next** | Go, Rust, and Java adapters; level-of-detail rendering for larger repositories |
 | **Later** | Read-only share links, new quest types, and the coordinated public launch |
 
@@ -185,7 +178,7 @@ evidence exists.
 
 ## License
 
-Codemble is released under the [Apache License 2.0](LICENSE).
+Codemble is released under the [Apache License 2.0](https://github.com/udhawan97/Codemble/blob/main/LICENSE).
 
 ---
 

{codemble-0.3.0 → codemble-0.3.1}/TESTING.md

@@ -1,4 +1,4 @@
-# Test Codemble v0.2.0
+# Test Codemble
 
 Codemble needs people who built a small Python, JavaScript, TypeScript, or mixed
 project with AI and want to understand it better. This is a ten-minute first-run
@@ -24,9 +24,6 @@ uvx codemble            # or: pipx install codemble && codemble
 Codemble opens your browser to an in-app picker — pick your project folder
 there, or pass one directly: `codemble ./path-to-your-project`.
 
-> Until the first PyPI release (v0.3.0) lands, install from the tag instead:
-> `pipx install git+https://github.com/udhawan97/Codemble.git@v0.2.0`
-
 Then, without reading the docs first:
 
 1. Identify Home, or choose it if Codemble asks.

{codemble-0.3.0 → codemble-0.3.1}/codemble/__init__.py

@@ -1,4 +1,4 @@
 """Codemble — a learning game that turns the code AI wrote for you into a galaxy
 you light up by understanding it. See CLAUDE.md for the agent brief and roadmap."""
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"

{codemble-0.3.0 → codemble-0.3.1}/docs-site/package.json

@@ -1,7 +1,7 @@
 {
   "name": "codemble-docs",
   "type": "module",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "private": true,
   "scripts": {
     "dev": "astro dev",

{codemble-0.3.0 → codemble-0.3.1}/docs-site/src/content/docs/early-testing.md

@@ -1,6 +1,6 @@
 ---
 title: Early testing
-description: A ten-minute, privacy-safe first-run test for Codemble v0.2.0.
+description: A ten-minute, privacy-safe first-run test for Codemble.
 ---
 
 Codemble needs learners who built a small Python, JavaScript, TypeScript, or
@@ -16,9 +16,6 @@ uvx codemble            # or: pipx install codemble && codemble
 Codemble opens your browser to an in-app picker — pick your project folder
 there, or pass one directly: `codemble ./path-to-your-project`.
 
-> Until the first PyPI release (v0.3.0) lands, install from the tag instead:
-> `pipx install git+https://github.com/udhawan97/Codemble.git@v0.2.0`
-
 An API key is optional. Do not read the rest of the docs before the first run;
 the product should teach the loop itself.
 

{codemble-0.3.0 → codemble-0.3.1}/docs-site/src/content/docs/installation.md

@@ -3,7 +3,7 @@ title: Installation
 description: Requirements and setup, including bring-your-own-key configuration.
 ---
 
-:::note[v0.2.0 polyglot tester release]
+:::note[Polyglot tester release]
 The complete learning loop supports Python, JavaScript, TypeScript, and mixed
 projects. Human first-run evidence is still being collected separately.
 :::
@@ -22,18 +22,10 @@ An Anthropic or OpenAI key is optional and enables only explanation prose.
 uvx codemble            # or: pipx install codemble && codemble
 ```
 
-From v0.3.0, Codemble opens your browser to an in-app picker — browse your
+Codemble opens your browser to an in-app picker — browse your
 home folders or reopen a recent project, no path typing required. To skip the
 picker, pass a path directly: `codemble ./your-project`.
 
-> Until the first PyPI release (v0.3.0) lands, install from the tag instead.
-> v0.2.0 has no picker yet, so pass your project path:
->
-> ```bash
-> pipx install git+https://github.com/udhawan97/Codemble.git@v0.2.0
-> codemble ./your-project
-> ```
-
 The Python wheel already contains the production web app. Node is needed only
 when developing Codemble itself.
 
@@ -65,8 +57,8 @@ language lens, and checks — only the prose explanations need the model.
 ## Limits that fail honestly
 
 - More than 300 supported source files: run
-  `codemble --path ./project/subdirectory`; from v0.3.0, the picker prompts
-  for the same busiest-first subdirectory choice in the UI.
+  `codemble --path ./project/subdirectory`; the picker prompts for the same
+  busiest-first subdirectory choice in the UI.
 - Ambiguous startup: choose Home in the app or pass a parser-ranked node with
   `--entrypoint NODE_ID`.
 - Syntax error: the file remains visible as **Unchartable**, with raw source;

{codemble-0.3.0 → codemble-0.3.1}/docs-site/src/content/docs/introduction.md

@@ -32,8 +32,9 @@ own it. You bring your own Claude or OpenAI API key; everything else runs
 locally on your machine.
 
 :::note[Status]
-v0.2.0 is the Phase 1 tester release. Python, JavaScript, TypeScript, and mixed
-projects run through the same local learning loop. The original unaided Python
+Codemble is in its Phase 1 tester release, installable from PyPI. Python,
+JavaScript, TypeScript, and mixed projects run through the same local learning
+loop. The original unaided Python
 learner-acceptance issue remains open; technical completion does not substitute
 for human evidence. Follow on [GitHub](https://github.com/udhawan97/Codemble) —
 the roadmap stays public.

{codemble-0.3.0 → codemble-0.3.1}/docs-site/src/content/docs/quickstart.md

@@ -17,9 +17,6 @@ mixed project. To skip the picker, pass a path directly:
 codemble ./my-project
 ```
 
-> Until the first PyPI release (v0.3.0) lands, install from the tag instead:
-> `pipx install git+https://github.com/udhawan97/Codemble.git@v0.2.0`
-
 Codemble parses locally, chooses a free localhost port, and opens the galaxy.
 It keeps syntax-error files visible and labels unresolved calls instead of
 guessing. Use `--no-open` when you want to copy the printed URL yourself.

{codemble-0.3.0 → codemble-0.3.1}/docs-site/src/content/docs/roadmap.md

@@ -9,7 +9,7 @@ only when milestones actually complete. The shape:
 
 ## NOW — Phase 1 tester evidence
 
-The v0.2.0 technical release maps Python, JavaScript, TypeScript, and mixed
+The Phase 1 technical release maps Python, JavaScript, TypeScript, and mixed
 projects through one local parser-proven learning loop. The current work is
 first-run evidence and correctness reports on real learner projects. The
 original v0.1.0 Python learner-acceptance issue remains open and is not treated

{codemble-0.3.0 → codemble-0.3.1}/docs-site/src/pages/index.astro

@@ -63,8 +63,6 @@ const contract = [
 
 const langs = ["Python", "JavaScript", "TypeScript", "Mixed projects"];
 const install = "uvx codemble";
-const tagInstall =
-  "pipx install git+https://github.com/udhawan97/Codemble.git@v0.2.0";
 ---
 
 <!doctype html>
@@ -184,9 +182,7 @@ const tagInstall =
             </button>
           </div>
           <p class="hero-note">
-            Python 3.11+ · opens your browser to pick a project · until
-            v0.3.0 lands on PyPI,
-            <a href={doc("installation")}>install from the tag</a>
+            Python 3.11+ · opens your browser to pick a project
           </p>
         </div>
       </section>
@@ -322,16 +318,8 @@ const tagInstall =
           </div>
           <p class="install-note">
             Codemble opens your browser — pick your project folder there, or
-            skip the picker with <code>codemble ./your-project</code>. Until
-            the first PyPI release (v0.3.0) lands, install from the tag
-            instead:
+            skip the picker with <code>codemble ./your-project</code>.
           </p>
-          <div class="cmd cmd-block">
-            <code>{tagInstall}</code>
-            <button type="button" data-copy={tagInstall} class="cmd-copy">
-              <span data-copy-label>Copy</span>
-            </button>
-          </div>
           <p class="install-note">
             Your code is parsed locally. The only network calls are the LLM
             requests you configure, sent from your machine straight to your
@@ -358,7 +346,7 @@ const tagInstall =
         <div class="foot-row">
           <p class="foot-mark">
             <img src={`${base}/brand/mark.svg`} alt="" width="22" height="22" />
-            Codemble · v0.2.0 tester release · Apache-2.0
+            Codemble · Phase 1 tester release · Apache-2.0
           </p>
           <nav class="foot-links" aria-label="Footer">
             <a href={doc("introduction")}>Docs</a>

{codemble-0.3.0 → codemble-0.3.1}/pyproject.toml

@@ -4,12 +4,26 @@ build-backend = "hatchling.build"
 
 [project]
 name = "codemble"
-version = "0.3.0"
+version = "0.3.1"
 description = "A learning game that turns the code AI wrote for you into a galaxy you light up by understanding it."
 readme = "README.md"
-license = { file = "LICENSE" }
+license = "Apache-2.0"
+license-files = ["LICENSE"]
 authors = [{ name = "Umang Dhawan", email = "umangdhawan97@gmail.com" }]
 requires-python = ">=3.11"
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Education",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Operating System :: OS Independent",
+  "Environment :: Web Environment",
+  "Topic :: Software Development :: Documentation",
+  "Topic :: Education",
+]
 dependencies = [
   "fastapi>=0.115",
   "tree-sitter>=0.25,<0.27",
@@ -36,3 +50,6 @@ exclude = ["tests/fixtures"]
 [tool.hatch.build.targets.wheel]
 packages = ["codemble"]
 include = ["codemble/web_dist/**"]
+
+[tool.hatch.build.targets.sdist]
+exclude = [".remember", ".hallmark", ".claude", ".superpowers", "docs-site/node_modules", "web/node_modules"]

{codemble-0.3.0 → codemble-0.3.1}/web/package.json

@@ -1,7 +1,7 @@
 {
   "name": "codemble-web",
   "private": true,
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "scripts": {
     "dev": "vite",

codemble-0.3.0/.hallmark/log.json

@@ -1,37 +0,0 @@
-[
-  {
-    "date": "2026-07-19",
-    "macrostructure": "Map / Diagram",
-    "theme": "Observatory Instrument",
-    "enrichment": "none",
-    "brief": "Codemble deterministic galaxy renderer",
-    "critique": "P5 H5 E5 S5 R5 V5",
-    "slop_test": "pass (1-57, including 38a)"
-  },
-  {
-    "date": "2026-07-19",
-    "macrostructure": "Progress Ledger",
-    "theme": "Observatory Instrument",
-    "enrichment": "none",
-    "brief": "Codemble language star chart",
-    "variation": "syntax inventory rows with graph-derived progress"
-  },
-  {
-    "date": "2026-07-19",
-    "macrostructure": "Focused Readout",
-    "theme": "Observatory Instrument",
-    "enrichment": "none",
-    "brief": "Codemble graph-only active recall",
-    "variation": "one-question system overlay with a single illumination payoff",
-    "slop_test": "pass (plain controls, complete states, 320 px verified)"
-  },
-  {
-    "date": "2026-07-19",
-    "macrostructure": "Calibration Readout",
-    "theme": "Observatory Instrument",
-    "enrichment": "real product demo GIF",
-    "brief": "Codemble ambiguous Home and Unchartable states",
-    "variation": "ranked evidence rows, raw-source failure state, one 420ms glow pulse",
-    "slop_test": "pass (desktop and 320 px, reduced motion, no new visual language)"
-  }
-]

codemble-0.3.0/.hallmark/preflight.json

@@ -1,9 +0,0 @@
-{
-  "date": "2026-07-19",
-  "design_system": "docs-site/design.md",
-  "font_stack": ["Sora", "Inter", "JetBrains Mono"],
-  "framework": "Vite + React",
-  "motion": "custom house easing; no motion library",
-  "palette": "locked Observatory Instrument tokens",
-  "spacing": "4-point scale"
-}

codemble-0.3.0/.remember/now.md

@@ -1,3 +0,0 @@
-
-## 07:08 | friendly-wizard-claude/work-planning-f2e933
-Committed modes & Ollama spec (3-tier: struct + Gemma 4 12B + cloud), reversed Non-Goal, fixed cache & endpoint bugs, phases 1-3 (backend) queued.

codemble-0.3.0/.remember/tmp/last-ndc.ts

@@ -1 +0,0 @@
-1784461401

codemble-0.3.0/.remember/tmp/last-save-ts

@@ -1 +0,0 @@
-1784462904

codemble-0.3.0/.remember/tmp/last-save.json

@@ -1 +0,0 @@
-{"session": "391dcaa8-2bc2-4cf0-b18d-6a3dca5df88e", "line": 354}

codemble-0.3.0/.remember/tmp/save-session.pid

@@ -1 +0,0 @@
-77217

codemble-0.3.0/.remember/today-2026-07-19.md

@@ -1,10 +0,0 @@
-## 01:49 | friendly-helper-claude/codemble-website-redesign-235ec9
-Codemble: hero→Edo atlas+tatebanko parallax (Tatebanko.astro, build-plates.mjs); expandable search+docs/nav (Search.astro); landing→numbered plates.
-## 01:50 | friendly-helper-claude/codemble-website-redesign-235ec9
-Redesigned Codemble website (Edo star atlas); SVG plates; Tatebanko parallax hero; expandable Search; Starlight docs
-## 04:35 | friendly-wizard-claude/what-to-work-on-next-c1f75f
-Dogfood learner loop; fixed checks/service.py (4+ ans → 0 distract); verified 5 TESTING.md steps; began UI palette
-```
-## 06:42 | friendly-wizard-claude/work-planning-f2e933
-Reopened #13; defer v0.2.1 pending web-app-install-ux merge; scope coverage: 4 streams (HTML/CSS adapters, deepen langs, lens enrichment, easy/expert modes)
-```