Skip to content

docs(crew-mode): describe the Bot sessions preview and drop "no list reads mate_root" - #30728

Open
JiaDe-Wu wants to merge 1 commit into
kirodotdev:mainfrom
JiaDe-Wu:docs/crew-mode-spec-mate-sessions-preview
Open

JiaDe-Wu wants to merge 1 commit into
kirodotdev:mainfrom
JiaDe-Wu:docs/crew-mode-spec-mate-sessions-preview

Conversation

@JiaDe-Wu

@JiaDe-Wu JiaDe-Wu commented Nov 5, 2026

Copy link
Copy Markdown
Contributor

Problem / Motivation

Goal: The Crew Mode spec describes the Bot sessions preview and no longer says no list reads the Bot lineage stamps.

docs/system-specs/modules/crew-mode.md still says of a Bot thread's mate_root and mate_dispatched_by stamps "No list reads the two fields yet", and no row covers the preview that #30220 added behind dashboard.feature_previews.mate_sessions. With the preview on, two lists read the stamps: crew_mode.list_view on the server and crewModeView in the dashboard. This is item 3 of #30721.

Why it matters

A reader of the spec cannot tell that a Bot's sessions can leave the person's lists, that the server and the dashboard hide different rows after a Bot's thread closes, or that the setting applies to the whole gateway.

Not a goal

What changed (motivation → approach → change)

The Bot thread row now says two lists read the stamps, both behind the preview. A new row describes the preview: its setting and where it is switched on, what the server's default view drops (list_view drops every mate_root row) against what the dashboard drops (crewModeView, only while the Bot's thread is live), that an agent's read and ?crew=all keep every row, that the setting lives in the gateway config with the browser's copy as a cache so it applies gateway-wide, and the breadcrumb shown for a session opened while it is on.

Backwards compatibility

Compatible. Documentation only.

Removes nothing: no code, config or behaviour changes.

Tests

N/A, documentation only. ./scripts/docs-lint.sh passes (exit 0) and the brand-name gate is clean.

Proof: not provable -- docs or config only

Manual verification

Read against main: mate_sessions_hidden and list_view in crew_mode.py; mateSessionsHidden, hiddenMateRootOf and crewModeView in website/src/lib/crewMode.ts; the mate mode of CrewWorkerBreadcrumb.tsx; mate_sessions in FEATURE_PREVIEW_FLAGS; and the preview-flag storage note in website/src/utils/previewFlags.ts.

Related Issues

Refs #30721 (item 3 only; the issue stays open for the code items)

Checklist

  • At most two commits (one is the norm), with a Conventional Commits title
  • Existing tests pass and new tests added for new functionality — N/A, documentation only
  • Self-review completed; code follows project style guidelines
  • Documentation updated (if applicable)
  • No secrets, credentials, or internal references in the diff

@JiaDe-Wu
JiaDe-Wu requested review from a team and KiroCrewCaptain as code owners November 5, 2026 19:43
@JiaDe-Wu
JiaDe-Wu requested a review from iamwhatever November 5, 2026 19:43
@github-actions github-actions Bot added fork Pull request from a fork (external contributor) readiness: action required A blocking check or review needs attention merge conflict Branch has merge conflicts with its base — author must resolve before merge labels Nov 5, 2026
…reads mate_root"

crew-mode.md still says no list reads mate_root and mate_dispatched_by,
and no row covers the Bot sessions preview that kirodotdev#30220 put behind
dashboard.feature_previews.mate_sessions. Two lists read the stamps with
it on: crew_mode.list_view on the server and crewModeView in the
dashboard.

The new row records what the code does, including that the two halves
hide different rows (the server drops every mate_root row, the dashboard
only while the Bot's thread is live), that the setting is stored in the
gateway config so it applies gateway-wide, and the breadcrumb a hidden
session shows. The Bot thread row now points at it.

Refs kirodotdev#30721
@JiaDe-Wu
JiaDe-Wu force-pushed the docs/crew-mode-spec-mate-sessions-preview branch from 38f6176 to 1c99d72 Compare November 6, 2026 16:30
@github-actions github-actions Bot removed the merge conflict Branch has merge conflicts with its base — author must resolve before merge label Nov 6, 2026
@github-actions github-actions Bot added the merge conflict Branch has merge conflicts with its base — author must resolve before merge label Nov 14, 2026
@neilieva

Copy link
Copy Markdown
Contributor

The preview this row documents has been retired on main. docs/decisions/2026-11-15-a-bots-sessions-leave-the-session-list-by-default.md:9-14 says a stored mate_sessions switch is now ignored. Each Bot has a show_sessions_in_list switch instead, off by default.

On main, list_view drops a live Bot thread's sessions unless that Bot's switch is on, and ?crew=all and agent reads still keep every row (src/kiro_crew/crew_mode.py:605-624). crewModeView applies the same rule (website/src/lib/crewMode.ts:284-298), so the server and client no longer disagree the way the row says.

The stale "No list reads the two fields yet" sentence is still on main (docs/system-specs/modules/crew-mode.md:36), so the fix is still worth having. Main also renamed "Ultra Mode" to "conductor mode" in that table (crew-mode.md:33-36), which is where the conflict comes from. Could you rewrite both the new row and the edited sentence for the per-Bot switch? Both still describe the retired preview.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

fork Pull request from a fork (external contributor) merge conflict Branch has merge conflicts with its base — author must resolve before merge readiness: action required A blocking check or review needs attention

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants