@mediadatafusion/pi-workflow-suite 0.0.18 → 0.0.20

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable public releases will be documented in this file.
 
+## [0.0.20] - 2026-06-12
+
+### Improved
+
+- Added platform-aware Workflow Suite shortcuts so macOS keeps the existing `Ctrl+Shift` shortcuts while Windows and Linux use function-key shortcuts for Standard, Plan, Mission, widget, and preset controls.
+- Updated inline shortcut hints, widget documentation, and package README output so Windows and Linux users see shortcuts that match the active platform profile.
+
+### Hardened
+
+- Added regression coverage that keeps shortcut registration, inline hints, README examples, and fallback commands aligned with the centralized shortcut registry.
+
+## [0.0.19] - 2026-06-10
+
+### Improved
+
+- Improved workflow widget and settings UI documentation.
+- Refined editor hint readability controls.
+
 ## [0.0.18] - 2026-06-10
 
 ### Improved

package/README.md

@@ -4,7 +4,7 @@
 
 [![Install](https://cdn.jsdelivr.net/npm/@mediadatafusion/pi-workflow-suite@0.0.12/docs/assets/readme-link-install.svg)](#installation) [![Quick Start](https://cdn.jsdelivr.net/npm/@mediadatafusion/pi-workflow-suite@0.0.12/docs/assets/readme-link-quick-start.svg)](#quick-start) [![Commands](https://cdn.jsdelivr.net/npm/@mediadatafusion/pi-workflow-suite@0.0.12/docs/assets/readme-link-commands.svg)](#core-commands) [![Settings](https://cdn.jsdelivr.net/npm/@mediadatafusion/pi-workflow-suite@0.0.12/docs/assets/readme-link-settings.svg)](#settings-reference)
 
-**Workflow Suite Version:** `v0.0.18`
+**Workflow Suite Version:** `v0.0.20`
 
 ## Overview
 
@@ -49,6 +49,7 @@ See Pi Workflow Suite in action: structured workflow modes, settings, runtime st
 - [Workflow Roles And Model Selection](#workflow-roles-and-model-selection)
 - [Workflow Settings UI](#workflow-settings-ui)
 - [Workflow Presets](#workflow-presets)
+- [Workflow Widgets And Editor Hints](#workflow-widgets-and-editor-hints)
 - [Themes And UI](#themes-and-ui)
 - [Sub-Agents And Parallel Work](#sub-agents-and-parallel-work)
 - [Review, Validation, Repair, And Retry](#review-validation-repair-and-retry)
@@ -114,7 +115,7 @@ Pi Workflow Suite turns Pi into a guided workflow environment:
 | Standard Mode | Direct active work with optional dynamic task-specific To Do tracking, configurable clarification, widgets, shared or Standard-specific model roles, presets, safety controls, and sub-agent orchestration. |
 | Plan Mode | Approval-gated planning and execution where Planner, Reviewer, Executor, and Validator can each use the provider/model and thinking level that fits the phase. |
 | Mission Mode | Long-running milestone workflows with approval, checkpoints, Mission-specific model overrides, validation gates, repair/retry, pause/resume, final-validation controls, and continuity tracking. |
-| Themes And Startup UI | Workflow Suite themes, startup visual cards, startup logo modes, custom terminal logo text, custom brand cards, footer/status styling, widgets, and optional input border styling. |
+| Themes And Startup UI | Workflow Suite themes, startup visual cards, startup logo modes, custom terminal logo text, custom brand cards, editor hint/status styling, widgets, and optional input border styling. |
 | Interactive Diagrams | `workflow_diagram` Mermaid support with terminal preview, SVG-first clickable artifacts, PNG/runtime rendering support, dark-mode-friendly styling, and runtime artifact storage. |
 | Web Research & Browser Verification | First-party `workflow_web_search`, `workflow_web_fetch`, and `workflow_browser_check` tools. Search and fetch for public web evidence with source URLs, blocked local/private/internal hosts, and time/size limits. Headless browser verification for runtime web app validation with interactive UI actions (click, type, read, screenshot, evaluate). |
 | Repo Lock | Project-scoped Global Safety control that constrains normal file tools, bash path checks, and sub-agents to the active repository, with protected configuration paths and clear non-sandbox caveats. |
@@ -122,18 +123,18 @@ Pi Workflow Suite turns Pi into a guided workflow environment:
 | Token Budgets | Optional per-mode token and runtime caps (`maxTokens`, `maxRuntimeHours`) for Plan, Mission, and Standard Mode. Off by default (unlimited). When enabled, Workflow Suite tracks cumulative usage and blocks further agent turns when the budget is exceeded. |
 | Workflow Roles | Planner, Executor, Reviewer, Validator, Mission, and compaction responsibilities are separated by phase so each job has clear boundaries and can be matched to the right model. |
 | Model Selection | Configure which provider/model and thinking level powers each workflow role, with shared defaults plus Standard-specific and Mission-specific overrides for simpler or higher-rigor setups. |
-| Presets | Built-in and custom workflow profiles with selector commands and Ctrl+Shift+U cycling while active modes are running. |
+| Presets | Built-in and custom workflow profiles with selector commands and platform-aware cycling shortcuts while active modes are running: macOS `Ctrl+Shift+U`, Windows/Linux `F4`. |
 | Settings | Interactive grouped settings UI plus direct commands for Standard, Plan, Mission, model selection, sub-agents, widgets, compaction, themes, and safety. |
 | Sub-agents And Skills | Bundled workflow agents and skills for discovery, planning, safe execution, validation, git-safe summaries, and project-rule audits, with clear capability boundaries. |
-| Widgets And Status | Mode-aware top/bottom widgets, footer hints, shortcut controls, progress display, runtime summaries, and current-setting visibility. |
+| Widgets And Status | Mode-aware top/bottom widgets, editor hints, shortcut controls, progress display, runtime summaries, and current-setting visibility. |
 | Safety And Recovery | Phase-specific tool restrictions, destructive-command blocking, validation gates, install backup, live verification, audit, quarantine, sync, resume, and checkpoint tooling. |
 
 ## Feature Overview
 
 - Idle Mode as the default management state when no Standard, Plan, or Mission workflow is active.
-- Standard Mode through `/standard` and `Ctrl+Shift+S` for direct active work with optional dynamic To Do tracking.
-- Plan Mode through `/p` and `/plan` for approval-gated planned execution.
-- Mission Mode through `/mission`, `/m`, and `Ctrl+Shift+M` for durable milestone workflows.
+- Standard Mode through `/standard` and the platform shortcut: macOS `Ctrl+Shift+S`, Windows/Linux `F6`.
+- Plan Mode through `/p`, `/plan`, and the platform shortcut: macOS `Ctrl+Shift+L`, Windows/Linux `F7`.
+- Mission Mode through `/mission`, `/m`, and the platform shortcut: macOS `Ctrl+Shift+M`, Windows/Linux `F8`.
 - Configurable clarification in Standard Mode, plus dynamic clarification in Plan Mode and Mission Mode.
 - Review, execution, validation, repair, retry, checkpoint, and final-validation controls where the selected mode supports them.
 - Plan history, mission checkpoint history, Standard runtime tracking, and Mission runtime tracking.
@@ -153,7 +154,7 @@ Pi Workflow Suite turns Pi into a guided workflow environment:
 
 Idle Mode is the default no-active-workflow state. It means there is no active Standard task, approved Plan execution, or Mission milestone running, but Workflow Suite still provides its management, inspection, and configuration surfaces.
 
-Idle Mode is a first-class part of the Workflow Suite hierarchy. Users can inspect workflow status, open settings, change themes, preview startup visuals, review widget/footer behavior, inspect Repo Lock status through Global Safety settings, configure compaction, review installed workflow resources, and run safe runtime hygiene/status checks. Idle Mode is also where footer hints expose the primary entry points for Standard, Plan, and Mission.
+Idle Mode is a first-class part of the Workflow Suite hierarchy. Users can inspect workflow status, open settings, change themes, preview startup visuals, review widget and editor hint behavior, inspect Repo Lock status through Global Safety settings, configure compaction, review installed workflow resources, and run safe runtime hygiene/status checks. Idle Mode is also where editor hints expose the primary entry points for Standard, Plan, and Mission.
 
 Idle Mode is not a sandbox and does not imply Pi is unable to run commands. It only means Workflow Suite is not currently inside an active Standard, Plan, or Mission workflow. Repo Lock, tool guards, Pi permissions, and sub-agent configuration still determine what can run.
 
@@ -213,7 +214,7 @@ Configurable clarification:
 
 Core behavior:
 
-- `/standard` or `Ctrl+Shift+S` enters Standard Mode.
+- `/standard` enters Standard Mode. The platform shortcut is macOS `Ctrl+Shift+S`, Windows/Linux `F6`.
 - `/standard <task>` enters Standard Mode and starts that task.
 - `/standard status` shows active Standard settings, latest auto-check decisions, and To Do progress.
 - `/standard todo` shows dynamic To Do tracking.
@@ -597,7 +598,8 @@ Quick access:
 
 ```text
 /workflow presets              # open preset selector
-Ctrl+Shift+U                   # cycle presets from the footer/status line while Standard/Plan/Mission Mode is active
+macOS: Ctrl+Shift+U            # cycle presets while Standard/Plan/Mission Mode is active
+Windows/Linux: F4              # cycle presets while Standard/Plan/Mission Mode is active
 /workflow presets list
 /workflow presets apply <name>
 /workflow presets next
@@ -609,7 +611,9 @@ Ctrl+Shift+U                   # cycle presets from the footer/status line while
 /workflow presets delete <name>
 ```
 
-The footer/status line stays mode-specific and avoids idle clutter. By default, active workflows display compact, human-readable hints and the other workflow mode:
+The inline editor hints stay mode-specific and avoid idle clutter. By default, active workflows display compact, human-readable shortcuts for the active platform.
+
+macOS examples:
 
 ```text
 Idle:     Standard:Ctrl+Shift+S Plan:Ctrl+Shift+L Mission:Ctrl+Shift+M
@@ -618,7 +622,16 @@ Standard: Widgets:Ctrl+Shift+T/B Preset:deep Ctrl+Shift+U Plan:Ctrl+Shift+L Miss
 Mission:  Widgets:Ctrl+Shift+T/B Preset:deep Ctrl+Shift+U Standard:Ctrl+Shift+S Plan:Ctrl+Shift+L
 ```
 
-Cross-switching is enabled by default (`Ctrl+Shift+S` toggles Standard Mode, `Ctrl+Shift+M` from Plan Mode enters Mission Mode, and `Ctrl+Shift+L` from Mission Mode enters Plan Mode).
+Windows and Linux examples:
+
+```text
+Idle:     Standard:F6 Plan:F7 Mission:F8
+Plan:     Widgets:F2/F3 Preset:deep F4 Standard:F6 Mission:F8
+Standard: Widgets:F2/F3 Preset:deep F4 Plan:F7 Mission:F8
+Mission:  Widgets:F2/F3 Preset:deep F4 Standard:F6 Plan:F7
+```
+
+Cross-switching is enabled by default. On macOS, `Ctrl+Shift+S` toggles Standard Mode, `Ctrl+Shift+M` from Plan Mode enters Mission Mode, and `Ctrl+Shift+L` from Mission Mode enters Plan Mode. On Windows and Linux, the matching shortcuts are `F6`, `F8`, and `F7`.
 
 Human-friendly names are normalized for command use. For example, creating `Joe simple preset` saves it as `joe-simple-preset`, then lists the exact command to apply it. Custom presets can include Standard Mode To Do/clarification settings as well as shared Plan, Mission, sub-agent, workflow, and UI settings.
 
@@ -631,9 +644,60 @@ Workflow Suite settings are separate from Pi core settings. Workflow Suite setti
 
 Pi core settings use a different file pair: global `~/.pi/agent/settings.json` plus exact-current-directory project settings at `<cwd>/.pi/settings.json`. Pi core project settings do not walk parent directories. Use `./scripts/audit-settings.sh [target-cwd]` to report both scopes without printing secrets.
 
+## Workflow Widgets And Editor Hints
+
+Workflow widgets are one of the core Workflow Suite surfaces. Standard, Plan, and Mission Mode can show active workflow status directly in the terminal through mode-aware top and bottom widgets.
+
+The top and bottom widgets are independent visibility surfaces. Users can show either one or both, and toggling a widget does not change the underlying workflow state. The widgets are designed to keep long-running work readable without requiring users to repeatedly ask for status.
+
+Depending on the active mode and settings, widgets can show:
+
+- active workflow mode and lifecycle state,
+- current and next task, step, or milestone,
+- segmented progress bars,
+- Standard Mode To Do progress,
+- Plan Mode approval, execution, validation, and repair state,
+- Mission Mode milestone, checkpoint, validation, retry, and runtime state,
+- selected model route and thinking level,
+- active preset and shortcut hints,
+- sub-agent activity when worker orchestration is active.
+
+Workflow shortcuts are platform-aware. The macOS shortcuts preserve the original Workflow Suite behavior. Windows and Linux use function-key shortcuts because common terminal hosts may not reliably deliver `Ctrl+Shift+letter` chords to Pi.
+
+| Action | macOS | Windows | Linux / WSL | Fallback command |
+|---|---:|---:|---:|---|
+| Toggle Standard Mode | `Ctrl+Shift+S` | `F6` | `F6` | `/standard` |
+| Enter Plan Mode | `Ctrl+Shift+L` | `F7` | `F7` | `/plan` |
+| Toggle Mission Mode | `Ctrl+Shift+M` | `F8` | `F8` | `/mission` |
+| Toggle active workflow top widget | `Ctrl+Shift+T` | `F2` | `F2` | `/workflow widgets toggle top` |
+| Toggle active workflow bottom widget | `Ctrl+Shift+B` | `F3` | `F3` | `/workflow widgets toggle bottom` |
+| Cycle workflow presets while Standard, Plan, or Mission Mode is active | `Ctrl+Shift+U` | `F4` | `F4` | `/workflow presets next` |
+
+The inline editor hints use the active platform profile. A Windows or Linux user should not see macOS-only `Ctrl+Shift+letter` hints for Workflow Suite actions.
+
+Widget commands:
+
+```text
+/workflow widgets status
+/workflow widgets list
+/workflow widgets configure
+/workflow widgets toggle top
+/workflow widgets toggle bottom
+/workflow widgets on
+/workflow widgets off
+```
+
+Editor hints are compact inline hints shown in the editor/input area. They can show entry shortcuts while idle and widget, preset, and mode-switch shortcuts while a workflow is active. Editor hints are configurable separately from the widget commands themselves, including visibility and contrast.
+
+The interactive settings path is:
+
+```text
+/workflow settings UI Widgets
+```
+
 ## Themes And UI
 
-Workflow Suite themes control the palette used by Workflow Suite visual surfaces: status/footer text, Standard/Plan/Mission widgets, startup visuals, and optional input-area border styling. They are Workflow Suite settings, separate from Pi core themes.
+Workflow Suite themes control the palette used by Workflow Suite visual surfaces: status text, editor hints, Standard/Plan/Mission widgets, startup visuals, and optional input-area border styling. They are Workflow Suite settings, separate from Pi core themes.
 
 Open the interactive theme menu from the public settings surface:
 
@@ -657,7 +721,7 @@ Workflow Theme
 
 How the pieces fit together:
 
-- **Theme** changes Workflow Suite colors for widgets, footer/status text, startup visuals, and optional input border styling.
+- **Theme** changes Workflow Suite colors for widgets, editor hints, status text, startup visuals, and optional input border styling.
 - **Widget Text Style** controls the text treatment used by active workflow widgets.
 - **Startup Visual** chooses the startup card layout: `none`, `minimal`, `workflow_duo`, `mission_control`, `diagnostic_center`, `data_stream`, `neural_grid`, or `custom_brand`.
 - **Startup Text Style** controls startup visual text independently from active workflow widgets.
@@ -953,30 +1017,7 @@ Runtime tracking is active-runtime based:
 - Paused, blocked, stopped, completed, failed, draft, planned, and approved states do not accumulate active runtime.
 - `maxRuntimeHours` is enforced against active runtime at mission start/continue/validation/repair gates.
 
-Workflow entry and widget controls are available through `/standard`, `/plan`, `/mission`, and `/workflow widgets`. Keyboard shortcuts keep the footer mode-specific:
-
-```text
-Ctrl+Shift+S  toggle Standard Mode
-Ctrl+Shift+L  enter Plan Mode
-Ctrl+Shift+M  enter Mission Mode
-Ctrl+Shift+T  toggle active Standard/Plan/Mission top widget
-Ctrl+Shift+B  toggle active Standard/Plan/Mission bottom widget
-Ctrl+Shift+U  cycle presets while Standard/Plan/Mission Mode is active
-```
-
-Widget commands:
-
-```text
-/workflow widgets status
-/workflow widgets list
-/workflow widgets configure
-/workflow widgets toggle top
-/workflow widgets toggle bottom
-/workflow widgets on
-/workflow widgets off
-```
-
-Footer hints can be tuned without disabling the actual commands/shortcuts. The interactive path is `/workflow settings UI Widgets` → `Footer Hints`.
+Workflow entry and widget controls are available through `/standard`, `/plan`, `/mission`, and `/workflow widgets`. See [Workflow Widgets And Editor Hints](#workflow-widgets-and-editor-hints) for the top widget, bottom widget, shortcut, and editor hint controls.
 
 Mission heartbeat and stale-status fields are tracked and displayed. Checkpoint interval settings record the preferred cadence for future timed checkpoint automation, while recovery actions remain user-supervised for safety.
 
@@ -1014,8 +1055,8 @@ pi install -l npm:@mediadatafusion/pi-workflow-suite
 ### Installing specific versions
 
 ```bash
-pi install npm:@mediadatafusion/pi-workflow-suite@0.0.18
-pi install -l npm:@mediadatafusion/pi-workflow-suite@0.0.18
+pi install npm:@mediadatafusion/pi-workflow-suite@0.0.20
+pi install -l npm:@mediadatafusion/pi-workflow-suite@0.0.20
 ```
 
 An unversioned install follows normal update behavior: `pi update` and `pi update --extensions` will pick up new package releases. A versioned install pins the package to that version. Pinned package specs are intentionally skipped by Pi's normal package update commands. To move a pinned install to a newer version, reinstall with the desired version. To switch back to latest tracking, use the unversioned install command without `@<version>`.
@@ -1132,7 +1173,7 @@ Primary settings areas:
 - `missions` — Mission Mode autonomy, runtime, checkpoints, validation, repair, and mission-specific model selection.
 - `subagents` — workflow phase policies, worker targets, activity indicator, parallelism preferences, and edit-concurrency guidance. These settings do not edit arbitrary sub-agent tool permissions.
 - `context` — compaction provider/model, auto-trigger behavior, trigger percentage, cooldown, reserve tokens, and keep-recent tokens.
-- `ui` — widgets, shortcuts, Workflow Suite theme selection, startup visuals, startup logo text styling, footer/status hints, and optional themed input borders.
+- `ui` — widgets, shortcuts, Workflow Suite theme selection, startup visuals, startup logo text styling, editor hints, status text, and optional themed input borders.
 - `safety` — bash/tool guard settings.
 
 Important Standard Mode settings:
@@ -1221,10 +1262,10 @@ See `docs/TROUBLESHOOTING.md` for detailed diagnostics.
 
 ## Versioning
 
-The current preparation version is `v0.0.18`. Version information is intentionally aligned across:
+The current preparation version is `v0.0.20`. Version information is intentionally aligned across:
 
-- `VERSION` (`v0.0.18`),
-- `package.json` (`0.0.18`),
+- `VERSION` (`v0.0.20`),
+- `package.json` (`0.0.20`),
 - `package-lock.json`,
 - this README,
 - Workflow Suite settings/about output.

package/VERSION

@@ -1 +1 @@
-v0.0.18
+v0.0.20

package/config/workflow-settings.example.json

@@ -254,6 +254,7 @@
     "showActiveWorkflowSwitchHint": true,
     "showWidgetShortcutHint": true,
     "showPresetShortcutHint": true,
+    "editorHintContrast": "normal",
     "workflowTheme": "aurora",
     "workflowThemeOverrides": {},
     "startupVisual": "mission_control",

package/extensions/workflow-model-router.ts

@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { getAgentDir, type ExtensionAPI, type ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { workflowPresetCycleShortcutLabel } from "./workflow-shortcuts.js";
 
 export type WorkflowRole = "planner" | "executor" | "validator" | "reviewer";
 export type MissionModelRole = WorkflowRole;
@@ -38,6 +39,7 @@ export type WorkflowStartupLogoFont = "block" | "shadow" | "outline" | "wide" |
 export type WorkflowStartupLogoShadowDirection = "down_right" | "down" | "up" | "left" | "right";
 export type WorkflowStartupLogoColorStyle = "theme" | "primary" | "split";
 export type WorkflowWidgetTextPreset = "normal" | "bold" | "light" | "rich" | "italic" | "underline" | "terminal" | "smallcaps" | "typewriter";
+export type WorkflowEditorHintContrast = "subtle" | "normal" | "bright" | "high";
 export type CustomBrandBaseVisual = "minimal" | "diagnostic_center" | "workflow_duo" | "mission_control" | "data_stream" | "neural_grid";
 export type RepairRetryGateName = "review" | "validation" | "missionValidation" | "missionFinalValidation";
 
@@ -239,6 +241,7 @@ export interface WorkflowSettings {
     showActiveWorkflowSwitchHint?: boolean;
     showWidgetShortcutHint?: boolean;
     showPresetShortcutHint?: boolean;
+    editorHintContrast?: WorkflowEditorHintContrast;
     workflowTheme?: string;
     workflowThemeOverrides?: Record<string, string>;
     widgetTextStyle?: WorkflowWidgetTextPreset;
@@ -528,6 +531,7 @@ const BUILTIN_DEFAULT_WORKFLOW_SETTINGS = {
     "showActiveWorkflowSwitchHint": true,
     "showWidgetShortcutHint": true,
     "showPresetShortcutHint": true,
+    "editorHintContrast": "normal",
     "workflowTheme": "aurora",
     "workflowThemeOverrides": {},
     "widgetTextStyle": undefined,
@@ -1221,7 +1225,7 @@ export function renderWorkflowPresets(settings: WorkflowSettings = loadGlobalSet
   const active = settings.presets?.activePreset ?? WORKFLOW_CUSTOM_PRESET_MARKER;
   const names = workflowPresetNames(settings);
   const cards = [renderWorkflowPresetCard(WORKFLOW_CUSTOM_PRESET_MARKER, undefined, active === WORKFLOW_CUSTOM_PRESET_MARKER), ...names.map((name) => renderWorkflowPresetCard(name, catalog[name], name === active))];
-  return `# Workflow Presets\n\nActive Preset: ${activeWorkflowPresetLabel(settings)}\nShortcut: Ctrl+Shift+U cycles saved presets while Plan/Mission/Standard Mode is active\nSelector: /workflow presets\n\n${cards.join("\n\n") || "No presets available."}\n\nQuick commands:\n- /workflow presets list\n- /workflow presets apply <name>\n- /workflow presets next\n- /workflow presets prev\n- /workflow presets save <name>\n- /workflow presets create <name> from simple|standard|deep|maximum\n- /workflow presets edit <name>\n- /workflow presets rename <old> to <new>\n- /workflow presets delete <name>\n\nBuilt-in presets are package-defined and sync with the extension. User-named custom presets are saved entries in workflow-settings.json and stay in hotkey cycling. The reserved custom marker only means no built-in or user-named preset is active. Extension updates preserve workflow-settings.json and do not overwrite custom presets. Presets adjust workflow behavior only and preserve model/provider choices, API keys, auth/session files, runtime workflow state, and shared compaction settings.`;
+  return `# Workflow Presets\n\nActive Preset: ${activeWorkflowPresetLabel(settings)}\nShortcut: ${workflowPresetCycleShortcutLabel()} cycles saved presets while Plan/Mission/Standard Mode is active\nSelector: /workflow presets\n\n${cards.join("\n\n") || "No presets available."}\n\nQuick commands:\n- /workflow presets list\n- /workflow presets apply <name>\n- /workflow presets next\n- /workflow presets prev\n- /workflow presets save <name>\n- /workflow presets create <name> from simple|standard|deep|maximum\n- /workflow presets edit <name>\n- /workflow presets rename <old> to <new>\n- /workflow presets delete <name>\n\nBuilt-in presets are package-defined and sync with the extension. User-named custom presets are saved entries in workflow-settings.json and stay in hotkey cycling. The reserved custom marker only means no built-in or user-named preset is active. Extension updates preserve workflow-settings.json and do not overwrite custom presets. Presets adjust workflow behavior only and preserve model/provider choices, API keys, auth/session files, runtime workflow state, and shared compaction settings.`;
 }
 
 export function applyWorkflowPreset(cwd: string, requestedScope: WorkflowSettingsScope | undefined, name: string): SettingsWriteResult {