v0.17.0 — constellations you can follow
Tagged from main, 2026-08-13.
This release makes the Galaxy easier to read without turning decoration into a
claim. It also lands three parser-grounded orientation and handoff features,
the architecture deepening behind the renderer and language adapters, and the
current-main user-flow repairs.
A subtler link between related systems
Systems already carried the colour of their import community, but the routes
between them all used the same ink. That made colour useful for spotting a
cluster and much less useful for tracing it.
Now a proven import inside one coloured community inherits a restrained
mix of that community hue. A route between communities remains neutral. A
possible import remains dashed in the uncertainty colour even when its two
systems share a family. The hierarchy is deliberate:
| Signal | Meaning |
|---|---|
| Shared subtle hue | Two systems and this proven route belong to one import community |
| Neutral solid bridge | A proven route crosses communities |
| Dashed possible route | The parser could not prove the import; colour never upgrades it |
| Amber | Understanding earned through checks, never architecture |
The Key spells out the same distinctions with words and line styles, so colour
is not the only channel.
Exploration that keeps its subject
- The Galaxy opens at a steeper overview angle, making spatial depth easier to
read without adding free-flight controls. - Hover or keyboard selection promotes the active system and its one-hop
neighbours on the current route mesh into the label budget. - Keyboard selection persists when focus moves into the Key; pointer exit
clears a transient hover rather than leaving a stale constellation behind. - The Key is an opaque, bordered, scrollable panel at narrow reflow widths. It
no longer disappears or lets live WebGL labels read through its text.
First Flight, cycles, and a portable brief
- First Flight starts at parser-resolved Home and visits at most five direct,
proven imports. It is deterministic, keyboard reachable, reduced-motion safe,
re-runnable, and uses the normal travel path so each landing records only
exploration—not understanding. - Import cycle groups are schema 10 graph truth computed only from certain
import edges. The Map, project overview, and export show the same canonical
strongly connected member groups; possible-only loops are excluded. Member
order is not presented as a direct import path. - Export project brief downloads a local Markdown handoff containing the
parser-owned project overview, Home result, language and structure counts,
most-called modules, certainty coverage, unsupported sources, and learning
progress. It makes no network request.
Reliability behind the surface
- One Galaxy Runtime now owns the renderer lifetime, while React stays the
shallow projection and keyboard adapter. - One Canvas Occlusion measurement feeds role-aware facts to framing and label
placement without merging their separate decisions. - Five tree-sitter adapters share one private discovery, parse, finalization,
and error-translation lifecycle while retaining language-owned evidence. - Home calibration, Study-to-check focus, and project-picker outage recovery
now keep the choice, foreground focus, and last successful local result
visible through their full compact and cross-engine flows.
Release integrity
The wheel and source archive are reproducible from a pinned build backend and a
committed UTC build epoch. The publish workflow refuses bytes that disagree
with the public manifest, sends those bytes to PyPI, mirrors the same files on
the GitHub release, adds SHA256SUMS.txt, and then verifies PyPI metadata,
GitHub metadata, fresh downloads, and both digests from the outside.
Known limits
- Community tint covers only the eight largest import communities; assigning a
reused colour to unrelated smaller groups would be less honest than no hue. - First Flight is orientation, not progression: it has no completion reward or
saved step, and it is absent when Home is unresolved. - The Galaxy still needs WebGL. The flat Architecture and Workflow maps remain
the fallback and read the same parser-owned graph. - Proven import cycles do not claim runtime deadlock, recursion, or a bug. They
state only that certain imports form a structural cycle. - Human first-run evidence requested in issue #13 remains outstanding; passing
technical gates does not substitute for that learner evidence.
Verification
- 441 Python tests; Ruff clean
- Full frontend contract suite, including Galaxy data, runtime, view, Name
Atlas, First Flight, project brief, import cycles, and deterministic build - Real packaged-app space matrix from 1440px to 320px in Easy and Expert
- 104 Escape/focus assertions across 1440, 768, 375, and 320px
- 12 repaired user-flow assertions in Chromium and WebKit
- Reproducible wheel and sdist build proven byte-for-byte before publication