Changelog — PHX Data Agent Starter
All notable changes to this product are documented here. This project follows
Semantic Versioning. Breaking changes link to an upgrade
note in docs/upgrading.md.
[2.1.0] — 2026-07-10
Added
-
Signature animated hero: a rotating three.js “data constellation” (points
wired to nearest neighbours with a query-pulse shader). three r165 is
vendored (
assets/vendor/three/, MIT) so fresh clones build offline; the scene ships as its own esbuild entry (js/hero.js) and is lazy-loaded by theHeroSceneLiveView hook only where the hero canvas renders. Pauses off-screen/hidden-tab, honoursprefers-reduced-motion, degrades to the CSS gradient without WebGL. - New logo: query-path-in-hexagon mark with adaptive wordmark, plus an SVG favicon.
Changed
- Landing hero fully redesigned as a dark band with honest product copy — natural language to policy-enforced read-only SQL, the MCP endpoint, and local models via Ollama — beside a truthful terminal mock of the shipped horses demo dataset (generated SQL, policy check, grounded answer).
- Header and navigation restyled for the dark hero (mobile panel included).
[2.0.3] — 2026-07-10
Fixed
-
Supported-version floor corrected again to Elixir >= 1.18 / OTP >= 27:
hermes_mcpuses Elixir 1.18’sJSONmodule (CI on 1.17 proved 2.0.2’s floor still too low).
[2.0.2] — 2026-07-10
Fixed
-
Supported-version floor raised to Elixir >= 1.17: the MCP stack’s
peridependency usesDuration(Elixir 1.17+) and cannot compile on 1.15/1.16. mix.exs, README, SECURITY.md, and the CI matrix now state the real floor.
[2.0.1] — 2026-07-10
Added
-
LICENSEfile carrying the PhxTemplates Commercial Licence (v2.0) summary with a pointer to the authoritative tier terms. -
README rewritten for the Data Agent Starter: model-free quickstart first,
Ollama optional (matching the opt-in auto_pull behaviour), supported version
floors aligned with SECURITY.md, and a customization guide. Added
.env.exampledocumenting the supported environment variables.
[2.0.0] — 2026-07-10
Fixed (final release hardening)
- External MCP clients can now call the natural_language_query tool: the handler previously crashed on the schema-validated (atom-keyed, question-only) params that standards-compliant clients send.
- The chat widget no longer collapses when a reply error arrives, so failures are actually visible.
- Removed the header’s dead “Log in” links (the starter has no auth) and pointed “Get Started” at the live demo section.
Security
- Removed all distributed credentials; secrets now load from the environment. Any key previously shipped in an archive must be treated as compromised and rotated (see the storefront security incident record).
Changed
-
Standardised setup,
.env.example, formatting, and the release gate against the shared PHX engineering baseline. -
Added
AGENTS.md/CLAUDE.mdagent-readiness guides.
Added
-
SECURITY.md,SUPPORT.md, and this changelog.