chain-studio-flow-editor/CHANGELOG.md

# Changelog

## 0.26.0

Sample flows follow the hub's wire flag (sealed-areas rework):

- **`FlowEditorPage.sampleFlowNames`** — the host passes the set of
  flow names the hub reports as bundled samples
  (`FlowSummary.sample`). This is now the ONLY source of the
  "Example" chip; the editor's own content-marker scan is gone (it
  had silently drifted from the hub's renamed sample header and
  missed every current sample). Null = no host info = no chips.
- **Examples group.** Sample flows collapse under one
  "Examples (N)" row below the operator's own flows, expanded on
  demand — or by default when there is nothing else to show.
- **`FlowEditorPage.onImportSamples`** — optional empty-list action
  ("Import example flows"); sealed areas start without samples, so
  hosts wire this as the deliberate pull. The list refreshes itself
  after the import.
- `FaiEmptyState` gained an optional `action` slot.
- The editor reloads its file list when the host changes `flowsDir`
  or delivers the sample set after an async fetch.

## 0.25.0

Honest install badge — the flow list and analyzer only offer
"Install" for capabilities a configured store can actually resolve:

- **Store-resolvability split in the flow list.** Missing
  capabilities are classified BEFORE any click: store-resolvable
  ones keep the amber chip + Install link (which now installs only
  those), the rest render a quiet "not in store" chip whose tooltip
  explains the three recovery paths (local install via
  `chain install --link`, adding the providing store, configuring
  the MCP/n8n integration). Previously the Install action covered
  every missing capability and could end in the hub's
  "no store entry for '<name>'" error.
- New host contract: `_FileList` consumes the host's
  `storeCapabilities` (already exposed on `FlowEditorPage`) for the
  split; hosts should pass only capabilities the store can install
  (installable status, native kind).
- **Analyzer not-in-store message** now names all three recovery
  paths instead of only the local-install hint (EN + DE).

Project separation in the flow list:

- **Workspace filter.** The file list filters by the host's
  `activeProject`; flows without a `project:` key count as
  `general` (display semantics — the file stays the truth and is
  never rewritten). A project with no flows gets its own honest
  empty state naming the project and the way out.
- **New flows are stamped** with the active project's `project:`
  key (`general` and "all projects" stay unstamped — no key
  already means general).
- **`toolbarTrailing` slot** on `FlowEditorPage`: the host can
  place its workspace switcher in the editor's single toolbar.
- **`flowsDir` injection** on `FlowEditorPage`: tests (and other
  hosts) point the editor at any directory instead of the
  hard-wired `~/.chain/data/flows` — the new widget tests run
  against a temp dir, never the operator's flows.

Disturbance hardening:

- **Unknown ≠ absent.** `storeCapabilities` is nullable now
  (null = store state unknown): missing capabilities then render
  the plain missing chip with an honest tooltip — no install
  offer, no "not in store" claim — and the analyzer message says
  the store cannot be checked right now (EN + DE). Previously an
  unreachable store made every missing capability claim
  "not in store".

## 0.24.1

- No ALL-CAPS "FLOWS" panel header: the page toolbar already names
  the page — the duplicate label read as a broken title hierarchy.
  The refresh action moved next to the list filter.
- Doc comments name the current CLI (`chain install`).

## 0.24.0

Usertest-panel fixes (flow list + language):

- **Builtin-capability truth from the hub.** Removed the hardcoded
  client-side builtin set (`{'debug.echo'}`): missing-module
  detection now trusts the host-supplied capability list alone,
  which already includes the hub's real builtins. Fixes the bundled
  `hello` flow showing a play button on hubs that don't have
  `debug.echo` installed.
- **Missing-modules badge redesigned.** Status ("N Module fehlen",
  quiet neutral chip with an amber dot) and the install action
  (own link, never truncated) are separate elements; the former
  combined orange chip read as an error wall and ellipsized the
  action word.
- **Flow-list filter.** Case-insensitive substring filter above the
  list, with an honest "no flow matches" empty state.
- **Formal address (Sie) in all German strings** plus missing
  commas/quotes in the empty-state sentences.
- Analyzer hint now names the current CLI (`chain install --link`,
  was `fai install --link`).

## 0.23.0

- Run tab file inputs accept a host-injected native file picker
  (`FlowEditorPage.onPickFile`, new `PickedFileData` /
  `PickFileCallback` contract). The manual path-entry dialog remains
  only as the no-host fallback — typing an absolute path by hand is
  a last resort, not an input method.

All notable changes to `chain_studio_flow_editor` recorded here.
Studio bumps its `pubspec.yaml` git ref to a specific release
of this package on every editor change.

## 0.22.0 — 2026-07-12

### Added

- **Project chip (multi-project stage ②).** When the open flow file
  declares its own top-level `project:`, the editor shows it as a chip
  in the tab action strip. If the file's project differs from the host's
  active workspace, the chip becomes an amber "file wins" pill with a
  one-click *Switch to <project>* action — the file always wins for the
  run; switching only aligns the workspace view. New optional
  `FlowEditorPage.activeProject` + `onSwitchToFileProject`; the parse +
  normalize logic (mirrors the hub's `normalize_project_slug`) lives in
  `flow_project.dart` and is unit-tested.

## 0.21.2 — 2026-07-11

### Added

- **Per-row start button.** Runnable flows (no missing modules) get a
  play button in the flow list that opens them directly on the Run
  tab — one click from the list to entering inputs and starting
  (usertest quick win).

## 0.21.1 — 2026-07-11

### Fixed

- **Toolbar names the page, not the missing state.** With no flow
  open the header said "No flow open" / "Kein Flow geöffnet" — the
  usertest read it as a confusing page title. It now says "Flows";
  the state sentence stays in the centered empty state.
- **"Needs N modules" chip no longer overflows the flow list.** The
  label ellipsizes inside the narrow sidebar (the tooltip keeps the
  full text); previously it tripped a RenderFlex overflow by a few
  pixels on longer German labels.

## 0.21.0 — 2026-06-09

### Added

- **Diagnostic-strip "Beheben" button** opens a focused modal
  enumerating every issue with its quick-fix actions plus an
  "apply every quick fix" master button. Replaces the
  cramped expand-strip workflow for operators who want a
  deliberate dialog instead of scrolling in a 200-px footer.

- **Inline Approve / Reject in the Run tab**. When the hub
  pauses a flow on `system.approval@^0`, the Run tab now
  renders a complete approve / reject form directly under the
  awaiting step. The operator no longer needs to switch to the
  Approvals page mid-run.

- **`FlowRunDriver` extended** with three new methods (default
  implementations throw with a clear message so legacy hosts
  keep compiling): `pendingApprovalIdForStep`,
  `approveApproval`, `rejectApproval`.

## 0.20.1 — 2026-06-09

### Changed

- **Flow list rows** in the sidebar get a leading 28×28 icon
  tile (`account_tree_outlined`), active-row accent + weight,
  and compact byte formatting (B / KB / MB). Long names no
  longer overflow into a multi-line ellipsis; size strings
  read as `4.3 KB` instead of `4321 B`.

## 0.20.0 — 2026-06-09

### Added

- **Localised analyzer + strip + run messages**. Every analyzer
  message and every quick-fix label flows through the new
  `AnalyzerStrings` adapter, populated from the editor's locale.
  Strip + hover card + run-block tooltip + inline message
  + step row + CopyableErrorBox tooltips all moved to the
  string table.

### Fixed

- **Real monospace font everywhere**. The editor previously
  used `fontFamily: 'JetBrains Mono'` as a bare string with no
  fallback. The package never bundled the font; only Studio
  pre-loaded it via `google_fonts`. Hosts without Studio's
  setup saw the YAML editor render in the system proportional
  default. New `_monoTextStyle()` helper pins
  `fontFamilyFallback` to a cross-platform monospace chain.

## 0.19.0 — 2026-06-08

### Added

- **Persistent diagnostic strip** below the TabBarView. Same
  issue list visible on Graph + Text + Run tabs.
- **Run button blocked** when the analyzer reports errors.
  Both the action-strip Run and the RunTab Start button gate
  on `analyzerErrorCount`.
- **Run failures copyable** via a new `_CopyableErrorBox`.

## 0.18.0 — 2026-06-08

### Added

- **Graph nodes pulse on error**. Steps + pseudo-nodes
  (inputs / outputs) carrying analyzer issues render a
  breathing halo in the matching severity colour.
- **Store-aware install / add-source**. Analyzer takes a
  `storeCapabilities` closure; unknown-capability fixes
  switch between "Install" (in store) and "Add source for…"
  (not in store).
- **Did-you-mean suggestion** within Levenshtein distance 2.

## 0.17.0 — 2026-06-08

### Added

- **Copyable diagnostics + hover tooltip + quick fixes**. Strip
  rows use SelectableText with per-row Copy. Wavy underlines
  publish hover-tooltip requests via a ValueNotifier; an
  OverlayEntry card renders the message + fix buttons near
  the cursor.
- **`InstallCapabilityFix`** delegates to a host callback
  (`onInstallCapability`).

## 0.16.0 — 2026-06-08

### Fixed

- **Editor gutter glitches**. The `flutter_code_editor` gutter
  hard-positioned an `Icons.cancel` pin in a 16-px slot with a
  popup that painted over the code area. Hidden via
  `showErrors: false`; replaced with a bottom diagnostic strip
  the editor owns.

## 0.15.x — 0.14.x

Earlier development. See git log.