0.5.6 — 2026-07-07

Upgrade notes for admins

• Rebuild the frontend after pulling: docker compose up -d --build frontend.
  No migrations, no new env vars.

Added

• New shared components (frontend/src/admin/components/wizard.tsx,
  forms.tsx):
  • WizardSectionHeading — a bold zero-padded step number (01, 02, …)
    in lime plus a title and one-line explanation, rendered directly above
    a form section's own card instead of duplicating the title in a
    separate overview bar.
  • Toggle / ToggleField — a rectangular (not pill), lime-when-on switch
    with a fixed white thumb, replacing checkboxes for boolean fields.
    ToggleField additionally renders an inline label + explanation beside
    the switch (e.g. "Is active" / "Read only").
• Restructured the following "Add" forms' create flow into stacked/paired
  sections — identity first, required configuration next, optional/advanced
  fields last:
  • Add Database Connection (/admin/databases/new): Identity & Status
    (Name, Description, Is active / Read only toggles) and Host & Database
    sit side by side; Connection String and Extra Options are merged into a
    single "Optional Configurations" card with both fields side by side.
    The engine picker's "Change" control was removed from the Host &
    Database card — the page title now shows the engine's icon and name
    directly instead of a text subtitle.
  • Register Documentation Folder (/admin/docsources/register):
    Identity & Status (folder, description, is-active) and Configuration
    (type) side by side; File patterns moved into its own "Optional
    Configurations" section.
  • Generate single document (/admin/docsources/generate): Identity
    (file name, destination) and Configuration (type, source material,
    agent) side by side; Scope & goals moved into its own "Optional
    Configurations" section.
  • Generate a library (/admin/docsources/library): Identity (library
    name) and Configuration (library type, source material, agent) side by
    side — this flow has no optional fields, so there's no third section.
  • Add MCP Server (/admin/mcp-servers/new, both the Remote HTTP and
    Local subprocess kinds): Identity & Status (Name, Description, Is active
    toggle) and Configuration (URL + Transport, or Command + Args) side by
    side; Auth token + Headers (remote) or Command env (local) moved into a
    single "Optional Configurations" section. The kind picker's inline
    "Change" control was removed from the Connection card — the page title
    now shows the picked kind's name directly instead of a text subtitle
    (no icon here — unlike the database engines, MCP kinds aren't brands).
  • New Report (/admin/reports/new): Identity & Status (Name,
    Description, Is active toggle) and Configuration (Database, SQL query)
    side by side; Schedule, Delivery, and Allowed roles moved into their own
    "Optional Configurations" section.
  • New Dashboard (/admin/dashboards/new): Identity & Status (Name,
    Description, Is active toggle) and Optional Configurations (auto-refresh
    schedule, Allowed roles) side by side — this flow has no separate
    required-configuration step, since refresh and access are both optional.
  • Generate Dashboard (/admin/dashboards/generate): Identity
    (dashboard name) and Configuration (style, source material, agent) side
    by side; Custom instructions moved into its own "Optional
    Configurations" section.
  • Add Chart (/admin/dashboards/:dashId/charts/new, and its Edit
    form): Identity & Status, Configuration (database, SQL query, d3 code),
    and Optional Configurations (width, height, position) are stacked
    (not paired side by side, since the live preview + AI editor sidebar
    already occupies the other half of the page).
  • New Tether (/admin/tethers/new): Identity & Status (Name,
    Description, Is active toggle) and Configuration (codebase/codebase-docs
    source, database documentation source) side by side; Allowed roles moved
    into its own "Optional Configurations" section.
  • Add Agent (/admin/agents/new): Identity (Name) and Configuration
    (Service URL, Model, Reasoning Effort, and the type-specific credential)
    side by side; System Prompt moved into its own "Optional Configurations"
    section. This form has no Is active toggle — agent activation is a
    separate action on the agents list.
  • Add Codebase (/admin/codebases/new): Identity & Status (Name,
    Description, Is active toggle) and Configuration (Repository URL) side
    by side; Branch, Subpath, Include/Exclude globs, and Access token moved
    into their own "Optional Configurations" section.

Changed

• Edit forms for databases, doc sources, MCP servers, reports, dashboards,
  charts, tethers, agents, and codebases keep their original card layout,
  but fields were regrouped to match the new identity/configuration split,
  and their checkboxes were swapped for the new ToggleField switches for
  consistency with the create flow.
• Renamed the .engine-title-tag CSS class to .title-icon-tag (still only
  used by the database form, for its brand-logo + engine-name title).