Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
127 changes: 127 additions & 0 deletions config-baseline.json
Original file line number Diff line number Diff line change
Expand Up @@ -8076,6 +8076,7 @@
"dynamic_dashboard_cards": false,
"crewmate_threads": false,
"crewmates_in_agent_picker": false,
"feature_previews": {},
"qr_session_until_restart": true,
"qr_session_persist_across_restart": false,
"restore_window_minutes": 30,
Expand Down Expand Up @@ -8487,6 +8488,132 @@
"enumValues": null,
"defaultValue": false
},
{
"path": "dashboard.feature_previews",
"kind": "core",
"type": "object",
"required": false,
"deprecated": false,
"sensitive": false,
"tags": [],
"label": "Feature previews",
"help": "Which unreleased dashboard features are turned on under Settings > Developer > Feature previews, by name, each true or false. Kept here so a switch stays as set on every browser, device and dashboard address of this gateway. A name that is absent reads as off. Takes effect on the next dashboard read; no restart.",
"hasChildren": true,
"enumValues": null,
"defaultValue": {}
},
{
"path": "dashboard.feature_previews.artifact_deploy",
"kind": "core",
"type": "boolean",
"required": false,
"deprecated": false,
"sensitive": false,
"tags": [],
"label": "Feature preview: artifact_deploy",
"help": "Turn on the 'artifact_deploy' feature preview.",
"hasChildren": false,
"enumValues": null,
"defaultValue": false
},
{
"path": "dashboard.feature_previews.crew_mode",
"kind": "core",
"type": "boolean",
"required": false,
"deprecated": false,
"sensitive": false,
"tags": [],
"label": "Feature preview: crew_mode",
"help": "Turn on the 'crew_mode' feature preview.",
"hasChildren": false,
"enumValues": null,
"defaultValue": false
},
{
"path": "dashboard.feature_previews.crewmate_harness",
"kind": "core",
"type": "boolean",
"required": false,
"deprecated": false,
"sensitive": false,
"tags": [],
"label": "Feature preview: crewmate_harness",
"help": "Turn on the 'crewmate_harness' feature preview.",
"hasChildren": false,
"enumValues": null,
"defaultValue": false
},
{
"path": "dashboard.feature_previews.folder_conductor",
"kind": "core",
"type": "boolean",
"required": false,
"deprecated": false,
"sensitive": false,
"tags": [],
"label": "Feature preview: folder_conductor",
"help": "Turn on the 'folder_conductor' feature preview.",
"hasChildren": false,
"enumValues": null,
"defaultValue": false
},
{
"path": "dashboard.feature_previews.layout_harness",
"kind": "core",
"type": "boolean",
"required": false,
"deprecated": false,
"sensitive": false,
"tags": [],
"label": "Feature preview: layout_harness",
"help": "Turn on the 'layout_harness' feature preview.",
"hasChildren": false,
"enumValues": null,
"defaultValue": false
},
{
"path": "dashboard.feature_previews.remote_crew_chat",
"kind": "core",
"type": "boolean",
"required": false,
"deprecated": false,
"sensitive": false,
"tags": [],
"label": "Feature preview: remote_crew_chat",
"help": "Turn on the 'remote_crew_chat' feature preview.",
"hasChildren": false,
"enumValues": null,
"defaultValue": false
},
{
"path": "dashboard.feature_previews.session_environments",
"kind": "core",
"type": "boolean",
"required": false,
"deprecated": false,
"sensitive": false,
"tags": [],
"label": "Feature preview: session_environments",
"help": "Turn on the 'session_environments' feature preview.",
"hasChildren": false,
"enumValues": null,
"defaultValue": false
},
{
"path": "dashboard.feature_previews.webhooks",
"kind": "core",
"type": "boolean",
"required": false,
"deprecated": false,
"sensitive": false,
"tags": [],
"label": "Feature preview: webhooks",
"help": "Turn on the 'webhooks' feature preview.",
"hasChildren": false,
"enumValues": null,
"defaultValue": false
},
{
"path": "dashboard.qr_session_until_restart",
"kind": "core",
Expand Down
2 changes: 1 addition & 1 deletion docs/system-specs/modules/learn-cron-dashboard.md
Original file line number Diff line number Diff line change
Expand Up @@ -5238,7 +5238,7 @@ polled by this watchdog.

**Nav sidebar** — Collapsible: full mode (236px with labels) or icon-only mode (74px). The sidebar toggle lives in the rail's own top "menu row" (hamburger, plus a `panel-left-close` collapse control on the right while expanded) — not in the topbar, which shows only the brand. State persisted in `localStorage('mc-nav')`. Three vertically-stacked regions: (1) **top-fixed** — menu row, then Sessions (the chat surface, formerly labeled "Chat"), Schedule, Artifacts, Knowledge, then an **Apps** section header whose right side is an accent-colored **Explore** link (lucide `layout-grid`) to the App Store at `/apps` (the store's surface is `hiddenFromNav`; the link carries the `data-onboarding-nav="apps"` anchor); (2) **Apps frame** — the enabled-apps list scrolls in its own frame (`flex-1 min-h-0 overflow-y-auto`) so many apps never push the pinned sections; drag-reorderable via dnd-kit sortable (`SortableAppNavRow` + `DndContext`/`SortableContext`/`DragOverlay`, `MouseSensor` 8px distance + `TouchSensor` press-and-hold so a plain click still navigates): rows reflow to open a gap as one is dragged, the source dims, and a `DragOverlay` ghost follows the cursor; order persists to `localStorage('mc-app-nav-order')` (`arrayMove`); reorder is scoped to the currently visible Apps rows (the "N more" overflow collapse hides the rest); (3) **bottom-fixed** — Customize, Developer (dev mode only), Settings, and a **Contact Us** row with icon links to kiro.dev, the GitHub repo, and the Discord community (folds away — `max-h-0` + `inert` — while collapsed). Collapsed mode renders icon-only rows with portaled hover labels; the Explore row fades in and slides up into place. The former Shortcuts nav row moved to **Settings → Shortcuts** (`ShortcutsPanel`, sharing the same content the Alt+K shortcuts modal shows; tab sits above Developer). The Alt+K modal has a search field that filters entries by action label, group name or chord (a `+` in the query also matches as a space, so `ctrl+k` finds "Ctrl K"); no match shows an empty state with a clear action, and Escape first clears a non-empty query, then closes the modal.

**Preview-gated surfaces** — a registry entry may carry `previewFlag`, the localStorage key of a per-device opt-in (`utils/previewFlags.ts`, all keys prefixed `mc-preview-`). While the flag is off the surface is not advertised **anywhere**. The safe list has a name: consumers read **`getAdvertisedSurfaces()`** (= `getBuiltinSurfaces()` minus gated entries) rather than filtering per call site, because a call site that reaches for the unfiltered list and forgets the filter leaks an unreleased surface silently. `useAppRailOrder` (`shell/nav/appRail.tsx`) derives `advertisedNavItems` once and feeds BOTH rail list paths (Main and the Apps group) from it; the Search Everywhere Pages provider reads the same accessor. The bottom-fixed rows are looked up by id (`settings`, `capabilities`) and are core surfaces that are never gated. Gated surfaces deliberately REMAIN in `getBuiltinSurfaces()` so registry-wide invariants (every surface carries a translatable `labelKey`) still cover them. Their route stays registered, which is what makes the surface reachable once the flag is on. The flags are listed as one card per feature on **Settings → Developer → Feature Previews** (the section is `pages/settings/FeaturePreviewsSection.tsx`, the first page of `DeveloperPanel`'s SubNav, above the internals pages. It keeps the registry's "surface" vocabulary in code while its copy says "features" and "pages". The old `/developer?tab=feature-previews` link is replace-redirected by `DeveloperPage` to `/settings/developer/feature-previews?highlight=key:feature-previews-section`, whose `key:` form rings the element carrying that `data-setting-key` — the section's wrapper, so the whole moved section is ringed rather than one card. Because the file lives under `pages/settings/`, its three toggles ARE indexed into Settings search via `PANEL_TAB_MAP` — the search hit reaches the labelled opt-in switch, not the page it holds, which stays un-advertised until the flag is on), which fires `mc-preview-flag-changed`; `usePreviewFlagRevision()` turns that into a revision number the rail uses both to re-render and as a memo dep, so the row appears without a reload. A cross-tab `storage` event on any `mc-preview-` key does the same. One occupant today: `/webhooks` (the endpoint is supported, the page is not finished). A `previewFlag` alone does not cover the **browser-tab attention count**: it reads the registry directly rather than `getAdvertisedSurfaces()`, so `selectAllSurfacesAttention` applies the predicate itself — the tab title is an advertisement too, and a gated surface that still contributed would show a `(1)` with no rail row to trace it to. `hiddenFromNav` is the deliberate opposite there: it keeps contributing, because it IS advertised, just on the topbar bell rather than the rail. The gate is on the INGRESS only: a gated route stays routable, so turning the flag off never orphans existing work. Retiring a gate is deleting the `previewFlag` and the feature's card. This is distinct from `hiddenFromNav`, which is permanent and means "rendered elsewhere" (the App Store's Explore link, the topbar notifications bell).
**Preview-gated surfaces** — a registry entry may carry `previewFlag`, the key of an opt-in switch (`utils/previewFlags.ts`, all keys prefixed `mc-preview-`). The switch is kept on the gateway under `dashboard.feature_previews.<name>` (the key without its prefix, in snake_case), so every origin starts from the same stored value. localStorage under the `mc-preview-` key is a cache, which surfaces read synchronously; it can briefly differ from the gateway while a write is in flight, and a switch whose carry-up was refused stays on in that browser only. `usePreviewFlagServerSync` (mounted in `shell/appShell.tsx`) keeps the two in step: the gateway value wins over the cache except for a switch whose write is still in flight, each toggle is written through the owner-only config PATCH with one switch's writes sent in click order, a refused toggle puts the switch back to the value it had before the click (moved on by any write the gateway accepted since) with a notice naming it, and a switch set only in this browser before the gateway kept the switches is carried up with `if_unset`, once per page load until the gateway holds a value for it. A non-owner session reads the owner's switches but cannot change them; a switch it already had on in that browser stays on there only while the gateway holds no value for it. While the flag is off the surface is not advertised **anywhere**. The safe list has a name: consumers read **`getAdvertisedSurfaces()`** (= `getBuiltinSurfaces()` minus gated entries) rather than filtering per call site, because a call site that reaches for the unfiltered list and forgets the filter leaks an unreleased surface silently. `useAppRailOrder` (`shell/nav/appRail.tsx`) derives `advertisedNavItems` once and feeds BOTH rail list paths (Main and the Apps group) from it; the Search Everywhere Pages provider reads the same accessor. The bottom-fixed rows are looked up by id (`settings`, `capabilities`) and are core surfaces that are never gated. Gated surfaces deliberately REMAIN in `getBuiltinSurfaces()` so registry-wide invariants (every surface carries a translatable `labelKey`) still cover them. Their route stays registered, which is what makes the surface reachable once the flag is on. The flags are listed as one card per feature on **Settings → Developer → Feature Previews** (the section is `pages/settings/FeaturePreviewsSection.tsx`, the first page of `DeveloperPanel`'s SubNav, above the internals pages. It keeps the registry's "surface" vocabulary in code while its copy says "features" and "pages". The old `/developer?tab=feature-previews` link is replace-redirected by `DeveloperPage` to `/settings/developer/feature-previews?highlight=key:feature-previews-section`, whose `key:` form rings the element carrying that `data-setting-key` — the section's wrapper, so the whole moved section is ringed rather than one card. Because the file lives under `pages/settings/`, its three toggles ARE indexed into Settings search via `PANEL_TAB_MAP` — the search hit reaches the labelled opt-in switch, not the page it holds, which stays un-advertised until the flag is on), which fires `mc-preview-flag-changed`; `usePreviewFlagRevision()` turns that into a revision number the rail uses both to re-render and as a memo dep, so the row appears without a reload. A cross-tab `storage` event on any `mc-preview-` key does the same. One occupant today: `/webhooks` (the endpoint is supported, the page is not finished). A `previewFlag` alone does not cover the **browser-tab attention count**: it reads the registry directly rather than `getAdvertisedSurfaces()`, so `selectAllSurfacesAttention` applies the predicate itself — the tab title is an advertisement too, and a gated surface that still contributed would show a `(1)` with no rail row to trace it to. `hiddenFromNav` is the deliberate opposite there: it keeps contributing, because it IS advertised, just on the topbar bell rather than the rail. The gate is on the INGRESS only: a gated route stays routable, so turning the flag off never orphans existing work. Retiring a gate is deleting the `previewFlag` and the feature's card. This is distinct from `hiddenFromNav`, which is permanent and means "rendered elsewhere" (the App Store's Explore link, the topbar notifications bell).

**Agent monitor — `Ctrl+G`** (`useKeyboardShortcuts.ts`, predicate `isAgentMonitorChord`): opens the **Subagents** activity tab (`openActivityToTab('subagents')`) and routes to `/chat`, since the activity panel is owned by the chat page. This is the one chord that is **literal Ctrl on every platform** rather than ⌘-on-Mac: the kiro-cli backend emits `Press ctrl+g to monitor progress.` into its crew-pipeline tool result, that string lives inside the backend binary and cannot be re-worded per OS, so the chord the user is told to press must be the chord that fires (on macOS find-next is ⌘G, leaving ⌃G free). It requires exactly one primary modifier and no Alt/Shift, and deliberately fires **inside text fields** — the hint is read while a crew is running and focus is normally in the composer, so an input bail-out would make it dead exactly when it is needed. It is skipped for `.xterm` targets, where Ctrl+G is BEL and belongs to the PTY. Because the branch requires `ctrlKey && !altKey`, `KeyG` is deliberately **not** added to `RESERVED_PANEL_CODES`: it cannot shadow a downstream Alt+G panel registration, so reserving it would over-claim the panel-navigation extension seam.

Expand Down
1 change: 1 addition & 0 deletions src/kiro_crew/change_card_catalog.py
Original file line number Diff line number Diff line change
Expand Up @@ -829,6 +829,7 @@ def s(value: Any, limit: int = 60) -> str:
from kiro_crew import mate_capability_catalog as _mate_catalog # noqa: F401
from kiro_crew.config.sections import ( # noqa: F401
DEFAULT_MODEL,
FEATURE_PREVIEW_FLAGS,
MEMBER_APPROVAL_MODES,
effective_pin_scope,
normalize_agent_model,
Expand Down
6 changes: 5 additions & 1 deletion src/kiro_crew/change_card_catalog_kinds.py
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@

from kiro_crew import mate_capability_catalog as _mate_catalog
from kiro_crew import member_goals as _goals
from kiro_crew.config.sections import MEMBER_APPROVAL_MODES
from kiro_crew.config.sections import FEATURE_PREVIEW_FLAGS, MEMBER_APPROVAL_MODES
from kiro_crew.terminal_safe import _is_invisible

KIND_SETTING_CHANGE = "setting.change"
Expand Down Expand Up @@ -219,6 +219,10 @@
"computer_use.screenshot_max_px",
"dashboard.crewmate_threads",
"dashboard.dynamic_dashboard_cards",
# A feature preview only decides whether the dashboard OFFERS an
# unreleased page or menu entry; the feature's own routes and checks
# are the same either way.
*(f"dashboard.feature_previews.{_name}" for _name in FEATURE_PREVIEW_FLAGS),
"dashboard.folder_sort",
"dashboard.mcp_probe_timeout_secs",
"dashboard.prevent_sleep",
Expand Down
1 change: 1 addition & 0 deletions src/kiro_crew/config/loader.py
Original file line number Diff line number Diff line change
Expand Up @@ -725,6 +725,7 @@ def build_provider_factory(cfg: "KiroCrewConfig") -> Callable:
_crew_mode_agent_or_default,
_default_memory_mode_from,
_default_session_folder_or_empty,
_feature_previews,
_folder_sort_from,
_jira_auth_entry,
_load_idle_exempt_keys,
Expand Down
17 changes: 17 additions & 0 deletions src/kiro_crew/config/loader_builders.py
Original file line number Diff line number Diff line change
Expand Up @@ -1036,6 +1036,22 @@ def _default_session_folder_or_empty(value: object) -> str:
return value.strip() if isinstance(value, str) else ""


def _feature_previews(value: object, default: dict) -> dict:
"""``dashboard.feature_previews`` as ``{name: bool}`` over the known preview names.

A non-object reads as *default* (nothing on). Inside it, a name this build does
not know and a value that is not a literal ``true``/``false`` are dropped, so a
hand-edited ``"yes"`` or ``1`` reads as absent (off) rather than as on.
"""
if not isinstance(value, dict):
return default
return {
name: flag
for name, flag in value.items()
if name in _sections.FEATURE_PREVIEW_FLAGS and isinstance(flag, bool)
}


def _build_dashboard_config(_degraded: set[str], dashboard_data: dict) -> DashboardConfig:
section = _sections.SectionReader(DashboardConfig, dashboard_data)
gitlab_hosts = _coerce_gitlab_hosts(section.get("gitlab_hosts"))
Expand All @@ -1058,6 +1074,7 @@ def _build_dashboard_config(_degraded: set[str], dashboard_data: dict) -> Dashbo
restore_sessions=section.get("restore_sessions"),
crewmate_threads=section.read("crewmate_threads", _safe_bool),
crewmates_in_agent_picker=section.read("crewmates_in_agent_picker", _safe_bool),
feature_previews=section.read("feature_previews", _feature_previews),
dynamic_dashboard_cards=section.read("dynamic_dashboard_cards", _safe_bool),
qr_session_until_restart=section.read("qr_session_until_restart", _safe_bool),
qr_session_persist_across_restart=section.read(
Expand Down
1 change: 1 addition & 0 deletions src/kiro_crew/config/sections.py
Original file line number Diff line number Diff line change
Expand Up @@ -214,6 +214,7 @@
CHAT_ENTRY_CACHE_ENTRIES_MAX,
CHAT_ENTRY_CACHE_ENTRIES_MIN,
EXTERNAL_TERMINAL_APPS,
FEATURE_PREVIEW_FLAGS,
LEGACY_VERBOSITY_ALIASES,
LINK_PATTERN_PATTERN_MAX_LEN,
LINK_PATTERN_URL_MAX_LEN,
Expand Down
Loading
Loading