@overdeck/contracts 0.51.0 → 0.60.0

package/dist/index.mjs

@@ -1,6 +1,143 @@
 import { Effect, Schema, SchemaGetter } from "effect";
 import * as Rpc from "effect/unstable/rpc/Rpc";
 import * as RpcGroup from "effect/unstable/rpc/RpcGroup";
+//#region src/backend-pane.ts
+const BackendPane = Schema.Struct({
+	/** Stable pane identity: the backend-native pane handle. */
+	id: Schema.String,
+	/** Issue the pane belongs to; absent for operator conversations. */
+	issue: Schema.optional(Schema.String),
+	role: Schema.Literals([
+		"work",
+		"worker",
+		"review",
+		"test",
+		"uat",
+		"strike",
+		"plan"
+	]),
+	harness: Schema.String,
+	model: Schema.String,
+	state: Schema.Literals([
+		"idle",
+		"working",
+		"blocked",
+		"done",
+		"exited",
+		"unknown"
+	]),
+	/** Epoch millis the pane entered `state`; drives the `stuck` attention. */
+	stateSince: Schema.optional(Schema.Number),
+	/** Handle the terminal WebSocket attaches to. */
+	terminalId: Schema.optional(Schema.String),
+	/** Working directory of the pane (the issue workspace path). */
+	workspace: Schema.optional(Schema.String)
+});
+//#endregion
+//#region src/derived-issue-state.ts
+/**
+* The nine pipeline states of the FR-6 table. They are mutually exclusive and
+* resolved in this precedence (highest first), because the underlying facts
+* overlap:
+*
+*   closed > merged > ready > changes-requested > in-review > working >
+*   parked > planned > backlog
+*/
+const IssueState = Schema.Literals([
+	"backlog",
+	"parked",
+	"planned",
+	"working",
+	"in-review",
+	"changes-requested",
+	"ready",
+	"merged",
+	"closed"
+]);
+/** Something the operator has to look at. Orthogonal to `IssueState`. */
+const IssueAttention = Schema.Literals([
+	"needs-you",
+	"stuck",
+	"api-error"
+]);
+/** Latest review decision on the PR, as the forge reports it. */
+const PrReviewState = Schema.Literals([
+	"approved",
+	"changes-requested",
+	"review-requested",
+	"commented",
+	"none"
+]);
+/** Aggregate check-run conclusion for the PR head. */
+const PrChecksState = Schema.Literals([
+	"green",
+	"red",
+	"pending"
+]);
+/** The pull request (or merge request) backing an issue. */
+const DerivedPrState = Schema.Struct({
+	url: Schema.String,
+	number: Schema.Number,
+	reviewState: PrReviewState,
+	checks: PrChecksState,
+	/** Forge mergeability. `null` when the forge has not computed it yet. */
+	mergeable: Schema.NullOr(Schema.Boolean)
+});
+/** The issue's feature branch as git reports it. */
+const DerivedBranchState = Schema.Struct({
+	name: Schema.String,
+	aheadOfMain: Schema.Number,
+	pushed: Schema.Boolean
+});
+/** Everything the dashboard needs to render an issue's pipeline position. */
+const DerivedIssueState = Schema.Struct({
+	issueId: Schema.String,
+	state: IssueState,
+	attention: Schema.optional(IssueAttention),
+	pr: Schema.optional(DerivedPrState),
+	branch: Schema.optional(DerivedBranchState),
+	/**
+	* No tracker answered for this issue, so `closed` — the top of the
+	* precedence — could not be ruled in or out. Present only in that case; an
+	* unresolved tracker read is never reported as an open issue.
+	*/
+	trackerUnknown: Schema.optional(Schema.Literal(true))
+});
+const ISSUE_STATES = [
+	"backlog",
+	"parked",
+	"planned",
+	"working",
+	"in-review",
+	"changes-requested",
+	"ready",
+	"merged",
+	"closed"
+];
+/** Highest precedence first — the order `deriveIssueState` resolves in. */
+const ISSUE_STATE_PRECEDENCE = [
+	"closed",
+	"merged",
+	"ready",
+	"changes-requested",
+	"in-review",
+	"working",
+	"parked",
+	"planned",
+	"backlog"
+];
+const ISSUE_ATTENTIONS = [
+	"needs-you",
+	"stuck",
+	"api-error"
+];
+function isIssueState(value) {
+	return typeof value === "string" && ISSUE_STATES.includes(value);
+}
+function isIssueAttention(value) {
+	return typeof value === "string" && ISSUE_ATTENTIONS.includes(value);
+}
+//#endregion
 //#region src/types.ts
 const IssueId = Schema.String;
 const MEMBERSHIP_UNAVAILABLE_REASONS = [
@@ -41,52 +178,6 @@ const AgentResolution = Schema.Literals([
 	"abandoned",
 	"api_error"
 ]);
-const ReviewStatusValue = Schema.Literals([
-	"pending",
-	"reviewing",
-	"passed",
-	"failed",
-	"blocked",
-	"skipped"
-]);
-const TestStatusValue = Schema.Literals([
-	"pending",
-	"testing",
-	"passed",
-	"failed",
-	"skipped",
-	"dispatch_failed"
-]);
-const UatStatusValue = Schema.Literals([
-	"pending",
-	"testing",
-	"passed",
-	"failed"
-]);
-const MergeStatusValue = Schema.Literals([
-	"pending",
-	"queued",
-	"merging",
-	"verifying",
-	"merged",
-	"failed"
-]);
-const ReleaseStatusValue = Schema.Literals([
-	"pending",
-	"releasing",
-	"passed",
-	"failed",
-	"partial",
-	"rolled_back",
-	"skipped"
-]);
-const VerificationStatusValue = Schema.Literals([
-	"pending",
-	"running",
-	"passed",
-	"failed",
-	"skipped"
-]);
 const KNOWN_HARNESSES = new Set([
 	"claude-code",
 	"ohmypi",
@@ -276,87 +367,6 @@ const AgentSnapshot = Schema.Struct({
 	runtimeSnapshotSequence: Schema.optional(SequenceNumber)
 });
 /** PAN-3151: A recorded cycle in the review convergence tracking series */
-const ReviewCycleEntry = Schema.Struct({
-	cycle: Schema.Number,
-	runId: Schema.String,
-	atCommit: Schema.optional(Schema.String),
-	blockingCount: Schema.Number,
-	recordedAt: Schema.String
-});
-const ReviewStatusSnapshot = Schema.Struct({
-	issueId: IssueId,
-	reviewStatus: Schema.optional(ReviewStatusValue),
-	testStatus: Schema.optional(TestStatusValue),
-	uatStatus: Schema.optional(UatStatusValue),
-	uatNotes: Schema.optional(Schema.String),
-	mergeStatus: Schema.optional(MergeStatusValue),
-	releaseStatus: Schema.optional(ReleaseStatusValue),
-	releaseNotes: Schema.optional(Schema.String),
-	verificationStatus: Schema.optional(VerificationStatusValue),
-	verificationNotes: Schema.optional(Schema.String),
-	verificationCycleCount: Schema.optional(Schema.Number),
-	readyForMerge: Schema.optional(Schema.Boolean),
-	updatedAt: Schema.optional(Schema.String),
-	prUrl: Schema.optional(Schema.String),
-	/** Persistent stuck flag — set by divergence guard, cleared by /unstick */
-	stuck: Schema.optional(Schema.Boolean),
-	stuckReason: Schema.optional(Schema.String),
-	stuckAt: Schema.optional(Schema.String),
-	stuckDetails: Schema.optional(Schema.String),
-	/** PAN-3151: review cycle history for convergence detection */
-	reviewCycleHistory: Schema.optional(Schema.Array(ReviewCycleEntry)),
-	/** Commit SHA at which review passed; deacon uses this to detect new pushes after review */
-	reviewedAtCommit: Schema.optional(Schema.String),
-	/** Commit SHA at which the pre-review verification gate last passed */
-	lastVerifiedCommit: Schema.optional(Schema.String),
-	/** Current merge pipeline step (granular visibility for the merge step tracker) */
-	mergeStep: Schema.optional(Schema.String),
-	/** PAN-699: timestamp when review agents were dispatched */
-	reviewSpawnedAt: Schema.optional(Schema.String),
-	/** PAN-699: number of test-agent dispatch retries */
-	testRetryCount: Schema.optional(Schema.Number),
-	/** PAN-794: parallel-review re-dispatch retry counter (current recovery cycle) */
-	reviewRetryCount: Schema.optional(Schema.Number),
-	/** PAN-796: review auto-requeue count (circuit breaker threshold) */
-	autoRequeueCount: Schema.optional(Schema.Number),
-	/** PAN-794: ISO timestamp marking the start of the current recovery cycle */
-	recoveryStartedAt: Schema.optional(Schema.String),
-	/** Human-requested patrol opt-out — when true, Deacon ignores this issue. */
-	deaconIgnored: Schema.optional(Schema.Boolean),
-	deaconIgnoredAt: Schema.optional(Schema.String),
-	deaconIgnoredReason: Schema.optional(Schema.String),
-	/** PAN-1691: per-issue auto-merge routing key. undefined = project default, true = auto-merge (fast lane), false = hold for UAT. */
-	autoMerge: Schema.optional(Schema.Boolean),
-	/** Active review orchestrator tmux session name (e.g. agent-pan-540-review). */
-	reviewCoordinatorSessionName: Schema.optional(Schema.String),
-	/** Active review sub-role tmux session names (e.g. agent-pan-540-review-correctness). Discovered at emission time. */
-	reviewSessionNames: Schema.optional(Schema.Array(Schema.String)),
-	/** Per-role review completion status (keyed by role: 'correctness' | 'security' | ...) */
-	reviewSubStatuses: Schema.optional(Schema.Record(Schema.String, Schema.Literals(["running", "done"]))),
-	/** PAN-905: queue position in the merge queue */
-	queuePosition: Schema.optional(Schema.Number),
-	/** PAN-905: currently active specialist (e.g. 'merge-agent') */
-	activeSpecialist: Schema.optional(Schema.String),
-	/** PAN-905: number of merge retries attempted */
-	mergeRetryCount: Schema.optional(Schema.Number),
-	/** PAN-905: free-form notes about the merge attempt */
-	mergeNotes: Schema.optional(Schema.String),
-	/** Merge blocker reasons surfaced to operators. */
-	blockerReasons: Schema.optional(Schema.Array(Schema.Struct({
-		type: Schema.Literals([
-			"failing_checks",
-			"merge_conflict",
-			"unresolved_conversations",
-			"changes_requested",
-			"draft_pr",
-			"not_mergeable",
-			"unmerged_sibling_repo"
-		]),
-		summary: Schema.String,
-		details: Schema.optional(Schema.String),
-		detectedAt: Schema.String
-	})))
-});
 const TurnDiffFileChange = Schema.Struct({
 	path: Schema.String,
 	kind: Schema.optional(Schema.String),
@@ -482,7 +492,10 @@ const DashboardSnapshot = Schema.Struct({
 	sequence: SequenceNumber,
 	agents: Schema.Array(AgentSnapshot),
 	specialists: Schema.Array(Schema.Unknown),
-	reviewStatuses: Schema.Array(ReviewStatusSnapshot),
+	/** PAN-3917 FR-6: the derived pipeline state of every known issue. */
+	derivedIssueStates: Schema.Array(DerivedIssueState),
+	/** PAN-3917 FR-12: every live agent pane the terminal backend reports. */
+	backendPanes: Schema.Array(BackendPane),
 	issues: Schema.Array(Schema.Unknown),
 	recentActivity: Schema.optional(Schema.Array(Schema.Unknown)),
 	resources: Schema.optional(Schema.Unknown),
@@ -497,13 +510,6 @@ const DashboardSnapshot = Schema.Struct({
 	restartGate: Schema.optional(RestartGateSnapshot),
 	timestamp: Schema.String
 });
-const WorkspaceDetail = Schema.Struct({
-	workspace: Schema.Unknown,
-	reviewStatus: Schema.Unknown,
-	planning: Schema.Unknown,
-	costs: Schema.Unknown,
-	agentOutput: Schema.Array(Schema.String)
-});
 const ResourceStats = Schema.Struct({ containers: Schema.Array(Schema.Struct({
 	name: Schema.String,
 	cpu: Schema.optional(Schema.String),
@@ -588,14 +594,6 @@ const SessionNode = Schema.Struct({
 		"tmux",
 		"supervisor"
 	])),
-	paused: Schema.optional(Schema.Boolean),
-	pausedReason: Schema.optional(Schema.String),
-	pausedAt: Schema.optional(Schema.String),
-	troubled: Schema.optional(Schema.Boolean),
-	troubledAt: Schema.optional(Schema.String),
-	troubledReason: Schema.optional(Schema.String),
-	consecutiveFailures: Schema.optional(Schema.Number),
-	queuedMailCount: Schema.optional(Schema.Number),
 	modelOrigin: Schema.optional(ModelOrigin)
 });
 const FeatureNode = Schema.Struct({
@@ -1735,16 +1733,32 @@ const PlanItemsUnblockedEvent = Schema.Struct({
 		items: Schema.Array(Schema.String)
 	})
 });
-/** Replaces socket.io `pipeline:status` */
-const PipelineStatusChangedEvent = Schema.Struct({
-	type: Schema.Literal("pipeline.status_changed"),
+/**
+* PAN-3917 FR-6 — an issue's derived pipeline state changed.
+*
+* Emitted with `emitOnly`: derived state is recomputed from the tracker, the
+* forge and the terminal backend on every boot, so persisting it would be
+* storing a status Overdeck can derive.
+*/
+const IssueStateChangedEvent = Schema.Struct({
+	type: Schema.Literal("issue_state.changed"),
 	sequence: SequenceNumber,
 	timestamp: Schema.String,
-	payload: Schema.Struct({
-		issueId: IssueId,
-		workspaceId: Schema.optional(Schema.String),
-		status: ReviewStatusSnapshot
-	})
+	payload: Schema.Struct({ issueState: DerivedIssueState })
+});
+/** PAN-3917 FR-12 — a live agent pane appeared or changed. `emitOnly`. */
+const BackendPaneChangedEvent = Schema.Struct({
+	type: Schema.Literal("backend_pane.changed"),
+	sequence: SequenceNumber,
+	timestamp: Schema.String,
+	payload: Schema.Struct({ pane: BackendPane })
+});
+/** PAN-3917 FR-12 — a pane left the backend inventory. `emitOnly`. */
+const BackendPaneRemovedEvent = Schema.Struct({
+	type: Schema.Literal("backend_pane.removed"),
+	sequence: SequenceNumber,
+	timestamp: Schema.String,
+	payload: Schema.Struct({ paneId: Schema.String })
 });
 /** Replaces socket.io `merge:ready` */
 const MergeReadyEvent = Schema.Struct({
@@ -1756,17 +1770,6 @@ const MergeReadyEvent = Schema.Struct({
 		workspaceId: Schema.optional(Schema.String)
 	})
 });
-/** New — review status changed */
-const ReviewStatusChangedEvent = Schema.Struct({
-	type: Schema.Literal("review.status_changed"),
-	sequence: SequenceNumber,
-	timestamp: Schema.String,
-	payload: Schema.Struct({
-		issueId: IssueId,
-		workspaceId: Schema.optional(Schema.String),
-		status: ReviewStatusSnapshot
-	})
-});
 /** New — review specialist dispatched */
 const PipelineReviewStartedEvent = Schema.Struct({
 	type: Schema.Literal("pipeline.review-started"),
@@ -2605,9 +2608,10 @@ const DomainEvent = Schema.Union([
 	PlanItemStatusChangedEvent,
 	PlanSubitemStatusChangedEvent,
 	PlanItemsUnblockedEvent,
-	PipelineStatusChangedEvent,
+	IssueStateChangedEvent,
+	BackendPaneChangedEvent,
+	BackendPaneRemovedEvent,
 	MergeReadyEvent,
-	ReviewStatusChangedEvent,
 	PipelineReviewStartedEvent,
 	PipelineReviewCompletedEvent,
 	PipelineTestStartedEvent,
@@ -2837,248 +2841,66 @@ const OpenInEditorInput = Schema.Struct({
 	editor: EditorIdSchema
 });
 //#endregion
-//#region src/flywheel.ts
-const FlywheelRunId = Schema.String.check(Schema.isPattern(/^RUN-\d+$/));
-const FlywheelHttpUrl = Schema.String.check(Schema.isPattern(/^https?:\/\/\S+$/i));
-const FlywheelHarness = Schema.Literals([
-	"claude-code",
-	"pi",
-	"ohmypi",
-	"codex",
-	"acp",
-	"kimi-code",
-	"opencode",
-	"muse"
-]);
-const FlywheelEffort = Schema.Literals([
-	"low",
-	"medium",
-	"high",
-	"xhigh",
-	"max"
-]);
-const FlywheelOrchestrator = Schema.Struct({
-	harness: FlywheelHarness,
-	model: Schema.String,
-	effort: FlywheelEffort,
-	ctxPercent: Schema.Number
+//#region src/rpc.ts
+const WS_METHODS = {
+	scanConversations: "pan.scanConversations",
+	searchConversations: "pan.searchConversations",
+	listDiscoveredSessions: "pan.listDiscoveredSessions",
+	listSessionsFeed: "pan.listSessionsFeed",
+	getSessionsFeedFacets: "pan.getSessionsFeedFacets",
+	getDiscoveredSession: "pan.getDiscoveredSession",
+	enrichSessions: "pan.enrichSessions",
+	embedSessions: "pan.embedSessions",
+	getConversationCost: "pan.getConversationCost",
+	getConversationCostByWorkspace: "pan.getConversationCostByWorkspace",
+	getConversationStats: "pan.getConversationStats",
+	subscribeDomainEvents: "pan.subscribeDomainEvents",
+	subscribeIssueEvents: "pan.subscribeIssueEvents",
+	subscribeTerminal: "pan.subscribeTerminal",
+	subscribeAgentOutput: "pan.subscribeAgentOutput",
+	subscribeConversationMessages: "pan.subscribeConversationMessages",
+	subscribeProjectSessionTree: "pan.subscribeProjectSessionTree",
+	getSnapshot: "pan.getSnapshot",
+	replayEvents: "pan.replayEvents",
+	readWorkspaceFile: "pan.readWorkspaceFile",
+	readFileAtPath: "pan.readFileAtPath",
+	writeFileAtPath: "pan.writeFileAtPath",
+	resolveFilePathExists: "pan.resolveFilePathExists",
+	terminalOpen: "pan.terminalOpen",
+	terminalWrite: "pan.terminalWrite",
+	terminalResize: "pan.terminalResize",
+	terminalClose: "pan.terminalClose",
+	startPlanning: "pan.startPlanning",
+	startAgent: "pan.startAgent",
+	deepWipe: "pan.deepWipe",
+	sendTerminalInput: "pan.sendTerminalInput",
+	resizeTerminal: "pan.resizeTerminal",
+	shellOpenInEditor: "pan.shellOpenInEditor",
+	getAvailableEditors: "pan.getAvailableEditors"
+};
+var PanRpcError = class extends Schema.TaggedErrorClass()("PanRpcError", {
+	message: Schema.String,
+	code: Schema.optional(Schema.String)
+}) {};
+const TerminalOutput = Schema.Struct({
+	sessionName: Schema.String,
+	data: Schema.String
 });
-const FlywheelScope = Schema.Literals(["pan-only", "all-tracked-projects"]);
-const FlywheelHeadline = Schema.Struct({
-	bugsFixed: Schema.Number,
-	swarmItemsMerged: Schema.Number,
-	swarmItemsTotal: Schema.Number,
-	prsMerged: Schema.Number,
-	awaitingUat: Schema.Number
+const AgentOutput = Schema.Struct({
+	agentId: Schema.String,
+	line: Schema.String
 });
-/**
-* Pipeline verbs — display state only. They no longer gate the merge queue.
-*
-* History worth keeping (PAN-1736 / PAN-1759): the merge queue used to be
-* derived by filtering these verbs, treating only "shipping" or "merging" as
-* "at the merge gate". Any other verb on an issue that was ready_for_merge in
-* the review DB silently dropped it from the queue and from UAT batch
-* assembly — RUN-18 shipped an empty queue with five ready issues exactly that
-* way — and the queue existed only while a run was emitting a pipeline at all.
-*
-* PAN-1696 removed that coupling. The ready set is now sourced from the
-* review-status records per project (`listEligibleCandidatesByProject` +
-* `computeMergeQueueFromCandidates` in src/lib/flywheel-merge-order.ts), which
-* needs no flywheel run and cannot be affected by which verb an orchestrator
-* chose to report. Adding a verb here therefore has no merge-queue consequence;
-* it only changes what the dashboard displays.
-*/
-const FlywheelPipelineVerb = Schema.Literals([
-	"planning",
-	"working",
-	"reviewing",
-	"testing",
-	"shipping",
-	"merging",
-	"blocked",
-	"parked"
-]);
-const FlywheelPipelineStatus = Schema.Literals([
-	"queued",
-	"running",
-	"blocked",
-	"passed",
-	"failed",
-	"merged",
-	"parked"
-]);
-const FlywheelPipelineItem = Schema.Struct({
-	issueId: Schema.String,
-	title: Schema.String,
-	verb: FlywheelPipelineVerb,
-	status: FlywheelPipelineStatus,
-	progressPercent: Schema.optional(Schema.Number),
-	agentId: Schema.optional(Schema.String),
-	pr: Schema.optional(Schema.Number),
-	mergeOrder: Schema.optional(Schema.Number),
-	conflictsWith: Schema.optional(Schema.Array(Schema.String))
-});
-const FlywheelSubstrateBugStatus = Schema.Literals([
-	"filed",
-	"fixed",
-	"workaround"
-]);
-const FlywheelSubstrateBug = Schema.Struct({
-	issueId: Schema.String,
-	title: Schema.String,
-	status: FlywheelSubstrateBugStatus,
-	commitSha: Schema.optional(Schema.String),
-	url: Schema.optional(FlywheelHttpUrl)
-});
-const FlywheelAgentStatus = Schema.Literals([
-	"starting",
-	"running",
-	"waiting",
-	"idle",
-	"stopped",
-	"error"
-]);
-const FlywheelAgent = Schema.Struct({
-	id: Schema.String,
-	label: Schema.String,
-	status: FlywheelAgentStatus,
-	issueId: Schema.optional(Schema.String),
-	role: Schema.optional(Schema.String),
-	model: Schema.optional(Schema.String),
-	ctxPercent: Schema.optional(Schema.Number),
-	currentAction: Schema.optional(Schema.String)
-});
-const FlywheelParkedItem = Schema.Struct({
-	issueId: Schema.String,
-	title: Schema.String,
-	reason: Schema.String,
-	parkedAt: Schema.optional(Schema.String)
-});
-const FlywheelSuggestionAction = Schema.Literals([
-	"start",
-	"resume",
-	"plan",
-	"review",
-	"merge",
-	"unblock",
-	"park",
-	"investigate",
-	"wait"
-]);
-const FlywheelSuggestionPriority = Schema.Literals([
-	"urgent",
-	"high",
-	"medium",
-	"low"
-]);
-const FlywheelSuggestion = Schema.Struct({
-	action: FlywheelSuggestionAction,
-	issueId: Schema.optional(Schema.String),
-	rationale: Schema.String,
-	priority: FlywheelSuggestionPriority,
-	filedBy: Schema.optional(Schema.Literals(["agent", "operator"])),
-	weight: Schema.optional(Schema.Number),
-	weightReason: Schema.optional(Schema.String)
-});
-const FlywheelSystemStatus = Schema.Struct({
-	mainHead: Schema.String,
-	ramUsedMb: Schema.Number,
-	ramTotalMb: Schema.Number,
-	swapUsedMb: Schema.Number,
-	swapTotalMb: Schema.Number,
-	agentsActive: Schema.Number,
-	agentsCap: Schema.Number
-});
-const FlywheelOrders = Schema.Struct({
-	bookId: Schema.String,
-	bookName: Schema.String,
-	landed: Schema.Number,
-	total: Schema.Number,
-	laneAInFlight: Schema.Array(Schema.String),
-	laneBInFlight: Schema.optional(Schema.String),
-	drained: Schema.Boolean
-});
-const FlywheelStatus = Schema.Struct({
-	runId: FlywheelRunId,
-	startedAt: Schema.String,
-	elapsedMs: Schema.Number,
-	orchestrator: FlywheelOrchestrator,
-	headline: FlywheelHeadline,
-	activePipeline: Schema.Array(FlywheelPipelineItem),
-	substrateBugs: Schema.Array(FlywheelSubstrateBug),
-	agents: Schema.Array(FlywheelAgent),
-	parked: Schema.Array(FlywheelParkedItem),
-	suggestions: Schema.Array(FlywheelSuggestion).pipe(Schema.withDecodingDefaultKey(Effect.succeed([]))),
-	system: FlywheelSystemStatus,
-	openQuestions: Schema.Array(Schema.String),
-	orders: Schema.optional(FlywheelOrders),
-	scope: Schema.optional(FlywheelScope),
-	ticks: Schema.Number,
-	lastTickAt: Schema.String
-});
-//#endregion
-//#region src/rpc.ts
-const WS_METHODS = {
-	scanConversations: "pan.scanConversations",
-	searchConversations: "pan.searchConversations",
-	listDiscoveredSessions: "pan.listDiscoveredSessions",
-	listSessionsFeed: "pan.listSessionsFeed",
-	getSessionsFeedFacets: "pan.getSessionsFeedFacets",
-	getDiscoveredSession: "pan.getDiscoveredSession",
-	enrichSessions: "pan.enrichSessions",
-	embedSessions: "pan.embedSessions",
-	getConversationCost: "pan.getConversationCost",
-	getConversationCostByWorkspace: "pan.getConversationCostByWorkspace",
-	getConversationStats: "pan.getConversationStats",
-	subscribeDomainEvents: "pan.subscribeDomainEvents",
-	subscribeIssueEvents: "pan.subscribeIssueEvents",
-	subscribeTerminal: "pan.subscribeTerminal",
-	subscribeAgentOutput: "pan.subscribeAgentOutput",
-	subscribeConversationMessages: "pan.subscribeConversationMessages",
-	subscribeProjectSessionTree: "pan.subscribeProjectSessionTree",
-	subscribeFlywheelStatus: "pan.subscribeFlywheelStatus",
-	getSnapshot: "pan.getSnapshot",
-	replayEvents: "pan.replayEvents",
-	getWorkspaceDetail: "pan.getWorkspaceDetail",
-	readWorkspaceFile: "pan.readWorkspaceFile",
-	readFileAtPath: "pan.readFileAtPath",
-	writeFileAtPath: "pan.writeFileAtPath",
-	resolveFilePathExists: "pan.resolveFilePathExists",
-	terminalOpen: "pan.terminalOpen",
-	terminalWrite: "pan.terminalWrite",
-	terminalResize: "pan.terminalResize",
-	terminalClose: "pan.terminalClose",
-	startPlanning: "pan.startPlanning",
-	startAgent: "pan.startAgent",
-	deepWipe: "pan.deepWipe",
-	sendTerminalInput: "pan.sendTerminalInput",
-	resizeTerminal: "pan.resizeTerminal",
-	shellOpenInEditor: "pan.shellOpenInEditor",
-	getAvailableEditors: "pan.getAvailableEditors"
-};
-var PanRpcError = class extends Schema.TaggedErrorClass()("PanRpcError", {
-	message: Schema.String,
-	code: Schema.optional(Schema.String)
-}) {};
-const TerminalOutput = Schema.Struct({
-	sessionName: Schema.String,
-	data: Schema.String
-});
-const AgentOutput = Schema.Struct({
-	agentId: Schema.String,
-	line: Schema.String
-});
-const ProposedPlan = Schema.Struct({
-	id: Schema.String,
-	plan: Schema.String,
-	planFilePath: Schema.optional(Schema.String),
-	status: Schema.Literals([
-		"pending",
-		"approved",
-		"rejected"
-	]),
-	createdAt: Schema.String,
-	resolvedAt: Schema.optional(Schema.String)
+const ProposedPlan = Schema.Struct({
+	id: Schema.String,
+	plan: Schema.String,
+	planFilePath: Schema.optional(Schema.String),
+	status: Schema.Literals([
+		"pending",
+		"approved",
+		"rejected"
+	]),
+	createdAt: Schema.String,
+	resolvedAt: Schema.optional(Schema.String)
 });
 const CompactBoundary = Schema.Struct({
 	id: Schema.String,
@@ -3280,12 +3102,6 @@ const TerminalCloseRpc = Rpc.make(WS_METHODS.terminalClose, {
 	payload: Schema.Struct({ sessionName: Schema.String }),
 	error: PanRpcError
 });
-/** 10. Get batched workspace detail (unary) — replaces 5 separate HTTP calls */
-const GetWorkspaceDetailRpc = Rpc.make(WS_METHODS.getWorkspaceDetail, {
-	payload: Schema.Struct({ issueId: IssueId }),
-	success: WorkspaceDetail,
-	error: PanRpcError
-});
 const ReadWorkspaceFileInput = Schema.Struct({
 	issueId: IssueId,
 	relativePath: Schema.String,
@@ -3432,13 +3248,6 @@ const SubscribeProjectSessionTreeRpc = Rpc.make(WS_METHODS.subscribeProjectSessi
 	error: PanRpcError,
 	stream: true
 });
-/** 18. Subscribe to latest Flywheel status snapshots (stream) */
-const SubscribeFlywheelStatusRpc = Rpc.make(WS_METHODS.subscribeFlywheelStatus, {
-	payload: Schema.Struct({}),
-	success: Schema.NullOr(FlywheelStatus),
-	error: PanRpcError,
-	stream: true
-});
 /** 19. Open a workspace in an editor (PAN-966) */
 const ShellOpenInEditorRpc = Rpc.make(WS_METHODS.shellOpenInEditor, {
 	payload: OpenInEditorInput,
@@ -3616,7 +3425,7 @@ const GetConversationStatsRpc = Rpc.make(WS_METHODS.getConversationStats, {
 	error: PanRpcError
 });
 /** All Overdeck WebSocket RPC methods */
-const PanRpcGroup = RpcGroup.make(SubscribeDomainEventsRpc, SubscribeIssueEventsRpc, SubscribeTerminalRpc, SubscribeAgentOutputRpc, GetSnapshotRpc, ReplayEventsRpc, GetWorkspaceDetailRpc, ReadWorkspaceFileRpc, ReadFileAtPathRpc, WriteFileAtPathRpc, ResolveFilePathExistsRpc, TerminalOpenRpc, TerminalWriteRpc, TerminalResizeRpc, TerminalCloseRpc, StartPlanningRpc, StartAgentRpc, DeepWipeRpc, SendTerminalInputRpc, ResizeTerminalRpc, SubscribeConversationMessagesRpc, SubscribeProjectSessionTreeRpc, SubscribeFlywheelStatusRpc, ShellOpenInEditorRpc, GetAvailableEditorsRpc, ScanConversationsRpc, SearchConversationsRpc, ListDiscoveredSessionsRpc, ListSessionsFeedRpc, GetSessionsFeedFacetsRpc, GetDiscoveredSessionRpc, EnrichSessionsRpc, EmbedSessionsRpc, GetConversationCostRpc, GetConversationCostByWorkspaceRpc, GetConversationStatsRpc);
+const PanRpcGroup = RpcGroup.make(SubscribeDomainEventsRpc, SubscribeIssueEventsRpc, SubscribeTerminalRpc, SubscribeAgentOutputRpc, GetSnapshotRpc, ReplayEventsRpc, ReadWorkspaceFileRpc, ReadFileAtPathRpc, WriteFileAtPathRpc, ResolveFilePathExistsRpc, TerminalOpenRpc, TerminalWriteRpc, TerminalResizeRpc, TerminalCloseRpc, StartPlanningRpc, StartAgentRpc, DeepWipeRpc, SendTerminalInputRpc, ResizeTerminalRpc, SubscribeConversationMessagesRpc, SubscribeProjectSessionTreeRpc, ShellOpenInEditorRpc, GetAvailableEditorsRpc, ScanConversationsRpc, SearchConversationsRpc, ListDiscoveredSessionsRpc, ListSessionsFeedRpc, GetSessionsFeedFacetsRpc, GetDiscoveredSessionRpc, EnrichSessionsRpc, EmbedSessionsRpc, GetConversationCostRpc, GetConversationCostByWorkspaceRpc, GetConversationStatsRpc);
 //#endregion
 //#region src/issue-delta.ts
 function createIssueDelta(previous, next) {
@@ -3641,7 +3450,8 @@ const INITIAL_READ_MODEL_STATE = {
 	sequence: 0,
 	agentsById: {},
 	agentRuntimeById: {},
-	reviewStatusByIssueId: {},
+	derivedIssueStateByIssueId: {},
+	backendPanesById: {},
 	resources: null,
 	agentOutputById: {},
 	issuesRaw: [],
@@ -3758,8 +3568,10 @@ function bumpRuntimeSnapshotSequence(agentsById, agentId, sequence) {
 function syncSnapshot(state, snapshot) {
 	const agentsById = {};
 	for (const agent of snapshot.agents) agentsById[agent.id] = agent;
-	const reviewStatusByIssueId = {};
-	for (const rs of snapshot.reviewStatuses) reviewStatusByIssueId[rs.issueId] = rs;
+	const derivedIssueStateByIssueId = {};
+	for (const derived of snapshot.derivedIssueStates ?? []) derivedIssueStateByIssueId[derived.issueId] = derived;
+	const backendPanesById = {};
+	for (const pane of snapshot.backendPanes ?? []) backendPanesById[pane.id] = pane;
 	const channelPermissionRequestsById = {};
 	const channelPermissionRequestIdsByAgentId = {};
 	for (const request of snapshot.channelPermissionRequests ?? []) {
@@ -3775,7 +3587,8 @@ function syncSnapshot(state, snapshot) {
 		...state,
 		sequence: snapshot.sequence,
 		agentsById,
-		reviewStatusByIssueId,
+		derivedIssueStateByIssueId,
+		backendPanesById,
 		agentRuntimeById: snapshot.agentRuntimeById ?? state.agentRuntimeById,
 		channelPermissionRequestsById,
 		channelPermissionRequestIdsByAgentId,
@@ -3865,7 +3678,16 @@ function applyEvent(state, event) {
 			};
 		}
 		case "agent.stopped": {
-			const { [event.payload.agentId]: _removed, ...rest } = state.agentsById;
+			const stoppedAgent = state.agentsById[event.payload.agentId];
+			const nextAgentsById = stoppedAgent ? {
+				...state.agentsById,
+				[event.payload.agentId]: {
+					...stoppedAgent,
+					status: "stopped",
+					hasLiveTmuxSession: false,
+					lastActivity: event.timestamp
+				}
+			} : state.agentsById;
 			const runtimeById = state.agentRuntimeById ?? {};
 			const prevRuntime = runtimeById[event.payload.agentId];
 			const nextRuntimeById = prevRuntime ? {
@@ -3894,7 +3716,7 @@ function applyEvent(state, event) {
 			return {
 				...state,
 				sequence: Math.max(state.sequence, event.sequence),
-				agentsById: rest,
+				agentsById: nextAgentsById,
 				agentRuntimeById: nextRuntimeById,
 				channelPermissionRequestsById: nextPermissionRequestsById,
 				channelPermissionRequestIdsByAgentId: restPendingIds,
@@ -4039,85 +3861,35 @@ function applyEvent(state, event) {
 				}
 			};
 		}
-		case "pipeline.status_changed":
-		case "review.status_changed": return {
+		case "issue_state.changed": return {
 			...state,
 			sequence: Math.max(state.sequence, event.sequence),
-			reviewStatusByIssueId: {
-				...state.reviewStatusByIssueId,
-				[event.payload.issueId]: event.payload.status
+			derivedIssueStateByIssueId: {
+				...state.derivedIssueStateByIssueId,
+				[event.payload.issueState.issueId]: event.payload.issueState
 			}
 		};
-		case "review.reviewer_started": {
-			const { issueId, role, sessionName } = event.payload;
-			const existing = state.reviewStatusByIssueId[issueId];
-			const prevSubs = existing?.reviewSubStatuses ?? {};
-			const prevNames = existing?.reviewSessionNames ?? [];
-			const nextNames = prevNames.includes(sessionName) ? prevNames : [...prevNames, sessionName];
-			const nextStatus = {
-				...existing ?? { issueId },
-				reviewSubStatuses: {
-					...prevSubs,
-					[role]: "running"
-				},
-				reviewSessionNames: nextNames
-			};
-			return {
-				...state,
-				sequence: Math.max(state.sequence, event.sequence),
-				reviewStatusByIssueId: {
-					...state.reviewStatusByIssueId,
-					[issueId]: nextStatus
-				}
-			};
-		}
-		case "review.reviewer_completed": {
-			const { issueId, role } = event.payload;
-			const existing = state.reviewStatusByIssueId[issueId];
-			if (!existing) return {
-				...state,
-				sequence: Math.max(state.sequence, event.sequence)
-			};
-			const prevSubs = existing.reviewSubStatuses ?? {};
-			const nextStatus = {
-				...existing,
-				reviewSubStatuses: {
-					...prevSubs,
-					[role]: "done"
-				}
-			};
-			return {
-				...state,
-				sequence: Math.max(state.sequence, event.sequence),
-				reviewStatusByIssueId: {
-					...state.reviewStatusByIssueId,
-					[issueId]: nextStatus
-				}
-			};
-		}
-		case "review.specialist.timed_out": return {
+		case "backend_pane.changed": return {
 			...state,
-			sequence: Math.max(state.sequence, event.sequence)
+			sequence: Math.max(state.sequence, event.sequence),
+			backendPanesById: {
+				...state.backendPanesById,
+				[event.payload.pane.id]: event.payload.pane
+			}
 		};
-		case "review.coordinator_started": {
-			const { issueId, sessionName } = event.payload;
-			const nextStatus = {
-				...state.reviewStatusByIssueId[issueId] ?? { issueId },
-				reviewCoordinatorSessionName: sessionName
-			};
+		case "backend_pane.removed": {
+			const { [event.payload.paneId]: _removed, ...rest } = state.backendPanesById;
 			return {
 				...state,
 				sequence: Math.max(state.sequence, event.sequence),
-				reviewStatusByIssueId: {
-					...state.reviewStatusByIssueId,
-					[issueId]: nextStatus
-				}
+				backendPanesById: rest
 			};
 		}
-		case "review.coordinator.died": return {
-			...state,
-			sequence: Math.max(state.sequence, event.sequence)
-		};
+		case "review.reviewer_started":
+		case "review.reviewer_completed":
+		case "review.specialist.timed_out":
+		case "review.coordinator_started":
+		case "review.coordinator.died":
 		case "pipeline.review-started":
 		case "pipeline.review-completed":
 		case "pipeline.test-started":
@@ -5102,49 +4874,229 @@ function deriveProjectCi(record) {
 	};
 }
 //#endregion
-//#region src/flywheel-stats.ts
-const FlywheelStatsCriterionStatus = Schema.Literals([
-	"green",
-	"yellow",
-	"red",
-	"insufficient_data"
+//#region src/flywheel.ts
+const FlywheelRunId = Schema.String.check(Schema.isPattern(/^RUN-\d+$/));
+const FlywheelHttpUrl = Schema.String.check(Schema.isPattern(/^https?:\/\/\S+$/i));
+const FlywheelHarness = Schema.Literals([
+	"claude-code",
+	"pi",
+	"ohmypi",
+	"codex",
+	"acp",
+	"kimi-code",
+	"opencode",
+	"muse"
 ]);
-const FlywheelStatsTrend = Schema.Literals([
-	"up",
-	"down",
-	"flat"
+const FlywheelEffort = Schema.Literals([
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max"
 ]);
-const FlywheelStatsCriterionValueObject = Schema.Record(Schema.String, Schema.Json);
-const FlywheelStatsCriterionValue = Schema.Union([Schema.Number, FlywheelStatsCriterionValueObject]);
-const FlywheelStatsCriterion = Schema.Struct({
-	label: Schema.String,
-	value: FlywheelStatsCriterionValue,
-	target: FlywheelStatsCriterionValue,
-	status: FlywheelStatsCriterionStatus,
-	trend: Schema.optional(FlywheelStatsTrend),
-	sampleSize: Schema.Number,
-	dataSufficient: Schema.Boolean
-});
-const FlywheelStatsCriteria = Schema.Struct({
-	c1_bugRate: FlywheelStatsCriterion,
-	c2_p0Bugs: FlywheelStatsCriterion,
-	c3_passRate: FlywheelStatsCriterion,
-	c4_mttr: FlywheelStatsCriterion,
-	c5_intervention: FlywheelStatsCriterion,
-	c6_timeConsistency: FlywheelStatsCriterion,
-	c7_flake: FlywheelStatsCriterion
+const FlywheelOrchestrator = Schema.Struct({
+	harness: FlywheelHarness,
+	model: Schema.String,
+	effort: FlywheelEffort,
+	ctxPercent: Schema.Number
 });
-const FlywheelStats = Schema.Struct({
-	window: Schema.String,
-	generatedAt: Schema.String,
-	criteria: FlywheelStatsCriteria
+const FlywheelScope = Schema.Literals(["pan-only", "all-tracked-projects"]);
+const FlywheelHeadline = Schema.Struct({
+	bugsFixed: Schema.Number,
+	swarmItemsMerged: Schema.Number,
+	swarmItemsTotal: Schema.Number,
+	prsMerged: Schema.Number,
+	awaitingUat: Schema.Number
 });
-const decodeFlywheelStats = Schema.decodeUnknownSync(FlywheelStats);
-const encodeFlywheelStats = Schema.encodeSync(FlywheelStats);
-//#endregion
-//#region src/orders.ts
-const OrderBookLane = Schema.Literals(["A", "B"]);
-const OrderBookStatus = Schema.Literals([
+/**
+* Pipeline verbs — display state only. They no longer gate the merge queue.
+*
+* History worth keeping (PAN-1736 / PAN-1759): the merge queue used to be
+* derived by filtering these verbs, treating only "shipping" or "merging" as
+* "at the merge gate". Any other verb on an issue that was ready_for_merge in
+* the review DB silently dropped it from the queue and from UAT batch
+* assembly — RUN-18 shipped an empty queue with five ready issues exactly that
+* way — and the queue existed only while a run was emitting a pipeline at all.
+*
+* PAN-1696 removed that coupling. The ready set is now sourced from the
+* review-status records per project (`listEligibleCandidatesByProject` +
+* `computeMergeQueueFromCandidates` in src/lib/flywheel-merge-order.ts), which
+* needs no flywheel run and cannot be affected by which verb an orchestrator
+* chose to report. Adding a verb here therefore has no merge-queue consequence;
+* it only changes what the dashboard displays.
+*/
+const FlywheelPipelineVerb = Schema.Literals([
+	"planning",
+	"working",
+	"reviewing",
+	"testing",
+	"shipping",
+	"merging",
+	"blocked",
+	"parked"
+]);
+const FlywheelPipelineStatus = Schema.Literals([
+	"queued",
+	"running",
+	"blocked",
+	"passed",
+	"failed",
+	"merged",
+	"parked"
+]);
+const FlywheelPipelineItem = Schema.Struct({
+	issueId: Schema.String,
+	title: Schema.String,
+	verb: FlywheelPipelineVerb,
+	status: FlywheelPipelineStatus,
+	progressPercent: Schema.optional(Schema.Number),
+	agentId: Schema.optional(Schema.String),
+	pr: Schema.optional(Schema.Number),
+	mergeOrder: Schema.optional(Schema.Number),
+	conflictsWith: Schema.optional(Schema.Array(Schema.String))
+});
+const FlywheelSubstrateBugStatus = Schema.Literals([
+	"filed",
+	"fixed",
+	"workaround"
+]);
+const FlywheelSubstrateBug = Schema.Struct({
+	issueId: Schema.String,
+	title: Schema.String,
+	status: FlywheelSubstrateBugStatus,
+	commitSha: Schema.optional(Schema.String),
+	url: Schema.optional(FlywheelHttpUrl)
+});
+const FlywheelAgentStatus = Schema.Literals([
+	"starting",
+	"running",
+	"waiting",
+	"idle",
+	"stopped",
+	"error"
+]);
+const FlywheelAgent = Schema.Struct({
+	id: Schema.String,
+	label: Schema.String,
+	status: FlywheelAgentStatus,
+	issueId: Schema.optional(Schema.String),
+	role: Schema.optional(Schema.String),
+	model: Schema.optional(Schema.String),
+	ctxPercent: Schema.optional(Schema.Number),
+	currentAction: Schema.optional(Schema.String)
+});
+const FlywheelParkedItem = Schema.Struct({
+	issueId: Schema.String,
+	title: Schema.String,
+	reason: Schema.String,
+	parkedAt: Schema.optional(Schema.String)
+});
+const FlywheelSuggestionAction = Schema.Literals([
+	"start",
+	"resume",
+	"plan",
+	"review",
+	"merge",
+	"unblock",
+	"park",
+	"investigate",
+	"wait"
+]);
+const FlywheelSuggestionPriority = Schema.Literals([
+	"urgent",
+	"high",
+	"medium",
+	"low"
+]);
+const FlywheelSuggestion = Schema.Struct({
+	action: FlywheelSuggestionAction,
+	issueId: Schema.optional(Schema.String),
+	rationale: Schema.String,
+	priority: FlywheelSuggestionPriority,
+	filedBy: Schema.optional(Schema.Literals(["agent", "operator"])),
+	weight: Schema.optional(Schema.Number),
+	weightReason: Schema.optional(Schema.String)
+});
+const FlywheelSystemStatus = Schema.Struct({
+	mainHead: Schema.String,
+	ramUsedMb: Schema.Number,
+	ramTotalMb: Schema.Number,
+	swapUsedMb: Schema.Number,
+	swapTotalMb: Schema.Number,
+	agentsActive: Schema.Number,
+	agentsCap: Schema.Number
+});
+const FlywheelOrders = Schema.Struct({
+	bookId: Schema.String,
+	bookName: Schema.String,
+	landed: Schema.Number,
+	total: Schema.Number,
+	laneAInFlight: Schema.Array(Schema.String),
+	laneBInFlight: Schema.optional(Schema.String),
+	drained: Schema.Boolean
+});
+const FlywheelStatus = Schema.Struct({
+	runId: FlywheelRunId,
+	startedAt: Schema.String,
+	elapsedMs: Schema.Number,
+	orchestrator: FlywheelOrchestrator,
+	headline: FlywheelHeadline,
+	activePipeline: Schema.Array(FlywheelPipelineItem),
+	substrateBugs: Schema.Array(FlywheelSubstrateBug),
+	agents: Schema.Array(FlywheelAgent),
+	parked: Schema.Array(FlywheelParkedItem),
+	suggestions: Schema.Array(FlywheelSuggestion).pipe(Schema.withDecodingDefaultKey(Effect.succeed([]))),
+	system: FlywheelSystemStatus,
+	openQuestions: Schema.Array(Schema.String),
+	orders: Schema.optional(FlywheelOrders),
+	scope: Schema.optional(FlywheelScope),
+	ticks: Schema.Number,
+	lastTickAt: Schema.String
+});
+//#endregion
+//#region src/flywheel-stats.ts
+const FlywheelStatsCriterionStatus = Schema.Literals([
+	"green",
+	"yellow",
+	"red",
+	"insufficient_data"
+]);
+const FlywheelStatsTrend = Schema.Literals([
+	"up",
+	"down",
+	"flat"
+]);
+const FlywheelStatsCriterionValueObject = Schema.Record(Schema.String, Schema.Json);
+const FlywheelStatsCriterionValue = Schema.Union([Schema.Number, FlywheelStatsCriterionValueObject]);
+const FlywheelStatsCriterion = Schema.Struct({
+	label: Schema.String,
+	value: FlywheelStatsCriterionValue,
+	target: FlywheelStatsCriterionValue,
+	status: FlywheelStatsCriterionStatus,
+	trend: Schema.optional(FlywheelStatsTrend),
+	sampleSize: Schema.Number,
+	dataSufficient: Schema.Boolean
+});
+const FlywheelStatsCriteria = Schema.Struct({
+	c1_bugRate: FlywheelStatsCriterion,
+	c2_p0Bugs: FlywheelStatsCriterion,
+	c3_passRate: FlywheelStatsCriterion,
+	c4_mttr: FlywheelStatsCriterion,
+	c5_intervention: FlywheelStatsCriterion,
+	c6_timeConsistency: FlywheelStatsCriterion,
+	c7_flake: FlywheelStatsCriterion
+});
+const FlywheelStats = Schema.Struct({
+	window: Schema.String,
+	generatedAt: Schema.String,
+	criteria: FlywheelStatsCriteria
+});
+const decodeFlywheelStats = Schema.decodeUnknownSync(FlywheelStats);
+const encodeFlywheelStats = Schema.encodeSync(FlywheelStats);
+//#endregion
+//#region src/orders.ts
+const OrderBookLane = Schema.Literals(["A", "B"]);
+const OrderBookStatus = Schema.Literals([
 	"draft",
 	"ready",
 	"running",
@@ -5493,6 +5445,18 @@ const FeatureRegistryEntry = Schema.Struct({
 });
 //#endregion
 //#region src/harness-behavior.ts
+const AGENT_SESSION_PREFIXES = [
+	"agent-",
+	"planning-",
+	"specialist-",
+	"strike-",
+	"inspect-"
+];
+const AGENT_SESSION_SINGLETONS = new Set(["flywheel-orchestrator", "conv-flywheel-orchestrator"]);
+/** Canonical synthetic agent-session identity shared by dashboard client/server. */
+function isAgentSessionName(name) {
+	return AGENT_SESSION_SINGLETONS.has(name) || AGENT_SESSION_PREFIXES.some((prefix) => name.startsWith(prefix));
+}
 const CLAUDE_CODE_BEHAVIOR = {
 	displayName: "Claude Code",
 	nativeCommands: [
@@ -6251,12 +6215,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": false,
 				"valueHint": null
 			},
-			{
-				"flags": "--shadow-only",
-				"description": "Show only shadowed issues",
-				"required": false,
-				"valueHint": null
-			},
 			{
 				"flags": "--triage",
 				"description": "Show triage queue",
@@ -6271,19 +6229,13 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-show",
 		"path": ["show"],
 		"display": "/pan show",
-		"description": "Unified lens: shadow state, CV, context, health for one issue",
+		"description": "Unified lens: derived issue state, CV, context, health for one issue",
 		"args": [{
 			"name": "id",
 			"required": true,
 			"variadic": false
 		}],
 		"options": [
-			{
-				"flags": "--shadow",
-				"description": "Shadow state details only",
-				"required": false,
-				"valueHint": null
-			},
 			{
 				"flags": "--cv",
 				"description": "Agent work history only",
@@ -6335,32 +6287,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-review",
 		"path": ["review"],
 		"display": "/pan review",
-		"description": "Review-loop management: pending items, request re-review, reset cycles",
+		"description": "Review-loop management: request re-review, abort reviewers, restart a round",
 		"args": [],
 		"options": [],
 		"aliases": [],
 		"category": "Review"
 	},
-	{
-		"id": "pan-review-pending",
-		"path": ["review", "pending"],
-		"display": "/pan review pending",
-		"description": "List completed work awaiting review",
-		"args": [],
-		"options": [{
-			"flags": "--ready",
-			"description": "List issues ready for merge (review+test green, not merged) regardless of origin",
-			"required": false,
-			"valueHint": null
-		}, {
-			"flags": "--blocked",
-			"description": "List issues blocked in review/test/merge from the SQLite review-status store",
-			"required": false,
-			"valueHint": null
-		}],
-		"aliases": [],
-		"category": "Review"
-	},
 	{
 		"id": "pan-review-request",
 		"path": ["review", "request"],
@@ -6380,39 +6312,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Review"
 	},
-	{
-		"id": "pan-review-reset",
-		"path": ["review", "reset"],
-		"display": "/pan review reset",
-		"description": "Reset review/test/merge cycles (human override)",
-		"args": [{
-			"name": "id",
-			"required": true,
-			"variadic": false
-		}],
-		"options": [{
-			"flags": "--session",
-			"description": "Also clear all saved Claude review-session pointers",
-			"required": false,
-			"valueHint": null
-		}],
-		"aliases": [],
-		"category": "Review"
-	},
-	{
-		"id": "pan-review-resync",
-		"path": ["review", "resync"],
-		"display": "/pan review resync",
-		"description": "Re-emit canonical review status (heal a lost pipeline event)",
-		"args": [{
-			"name": "id",
-			"required": true,
-			"variadic": false
-		}],
-		"options": [],
-		"aliases": [],
-		"category": "Review"
-	},
 	{
 		"id": "pan-review-abort",
 		"path": ["review", "abort"],
@@ -6427,24 +6326,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Review"
 	},
-	{
-		"id": "pan-review-mode",
-		"path": ["review", "mode"],
-		"display": "/pan review mode",
-		"description": "Set per-issue review mode (quick, full, or none)",
-		"args": [{
-			"name": "id",
-			"required": true,
-			"variadic": false
-		}, {
-			"name": "mode",
-			"required": true,
-			"variadic": false
-		}],
-		"options": [],
-		"aliases": [],
-		"category": "Review"
-	},
 	{
 		"id": "pan-review-restart",
 		"path": ["review", "restart"],
@@ -6469,56 +6350,17 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Review"
 	},
-	{
-		"id": "pan-verify",
-		"path": ["verify"],
-		"display": "/pan verify",
-		"description": "Verification-gate overrides",
-		"args": [],
-		"options": [],
-		"aliases": [],
-		"category": "CLI"
-	},
-	{
-		"id": "pan-verify-waive-test-removal",
-		"path": ["verify", "waive-test-removal"],
-		"display": "/pan verify waive-test-removal",
-		"description": "Record an operator waiver letting a net test-call removal past the test-skip gate at the current head",
-		"args": [{
-			"name": "id",
-			"required": true,
-			"variadic": false
-		}],
-		"options": [{
-			"flags": "--reason <reason>",
-			"description": "Why the removed tests are not coming back",
-			"required": true,
-			"valueHint": "reason"
-		}],
-		"aliases": [],
-		"category": "CLI"
-	},
 	{
 		"id": "pan-staffing",
 		"path": ["staffing"],
 		"display": "/pan staffing",
-		"description": "Show or set per-issue work-model and swarm overrides",
+		"description": "Show the work model and swarm policy in effect for an issue",
 		"args": [{
 			"name": "id",
 			"required": true,
 			"variadic": false
 		}],
-		"options": [{
-			"flags": "--model <model>",
-			"description": "Set the work model, or default to clear the override",
-			"required": true,
-			"valueHint": "model"
-		}, {
-			"flags": "--swarm <mode>",
-			"description": "Set swarm mode (off, auto, always), or default to clear the override",
-			"required": true,
-			"valueHint": "mode"
-		}],
+		"options": [],
 		"aliases": [],
 		"category": "Lifecycle"
 	},
@@ -6536,7 +6378,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-backlog-write-sequence",
 		"path": ["backlog", "write-sequence"],
 		"display": "/pan backlog write-sequence",
-		"description": "Validate a SequenceDoc JSON file and write it to .pan/backlog/sequence.md (triggers auto-commit)",
+		"description": "Validate a SequenceDoc JSON file, write it to .pan/backlog/sequence.md, and commit it",
 		"args": [{
 			"name": "file",
 			"required": true,
@@ -6551,21 +6393,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Lifecycle"
 	},
-	{
-		"id": "pan-backlog-forecast",
-		"path": ["backlog", "forecast"],
-		"display": "/pan backlog forecast",
-		"description": "Pickup forecast (waves / needs-planning / cohort / stats) from sequence.md + SQLite — no HTTP (sandbox-safe)",
-		"args": [],
-		"options": [{
-			"flags": "-n, --n <n>",
-			"description": "Wave size (default 5)",
-			"required": true,
-			"valueHint": "n"
-		}],
-		"aliases": [],
-		"category": "Lifecycle"
-	},
 	{
 		"id": "pan-plan",
 		"path": ["plan"],
@@ -6777,25 +6604,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": ["stop"],
 		"category": "Lifecycle"
 	},
-	{
-		"id": "pan-reset-to-planned",
-		"path": ["reset-to-planned"],
-		"display": "/pan reset-to-planned",
-		"description": "Return a finalized issue to post-planning without deleting its workspace, plan, commits, or branch",
-		"args": [{
-			"name": "id",
-			"required": true,
-			"variadic": false
-		}],
-		"options": [{
-			"flags": "--dry-run",
-			"description": "Show the exact reset without changing state",
-			"required": false,
-			"valueHint": null
-		}],
-		"aliases": [],
-		"category": "Lifecycle"
-	},
 	{
 		"id": "pan-reset-session",
 		"path": ["reset-session"],
@@ -6843,34 +6651,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Lifecycle"
 	},
-	{
-		"id": "pan-untroubled",
-		"path": ["untroubled"],
-		"display": "/pan untroubled",
-		"description": "Clear an agent troubled gate without spawning it",
-		"args": [{
-			"name": "id",
-			"required": true,
-			"variadic": false
-		}],
-		"options": [],
-		"aliases": [],
-		"category": "Lifecycle"
-	},
-	{
-		"id": "pan-unstick",
-		"path": ["unstick"],
-		"display": "/pan unstick",
-		"description": "Clear an issue stuck gate without resetting a merged lifecycle",
-		"args": [{
-			"name": "id",
-			"required": true,
-			"variadic": false
-		}],
-		"options": [],
-		"aliases": [],
-		"category": "CLI"
-	},
 	{
 		"id": "pan-fork",
 		"path": ["fork"],
@@ -7114,13 +6894,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 			},
 			{
 				"flags": "--strike",
-				"description": "Strike-agent shape: skip review-pipeline dispatch (used by `pan strike` agents that merged directly to main)",
-				"required": false,
-				"valueHint": null
-			},
-			{
-				"flags": "--json",
-				"description": "Output as JSON",
+				"description": "Strike shape: verify the strike branch is contained in origin/main; no PR is opened",
 				"required": false,
 				"valueHint": null
 			}
@@ -7128,20 +6902,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Lifecycle"
 	},
-	{
-		"id": "pan-approve",
-		"path": ["approve"],
-		"display": "/pan approve",
-		"description": "[REMOVED] Use dashboard MERGE button instead",
-		"args": [{
-			"name": "id",
-			"required": true,
-			"variadic": false
-		}],
-		"options": [],
-		"aliases": [],
-		"category": "Lifecycle"
-	},
 	{
 		"id": "pan-reopen",
 		"path": ["reopen"],
@@ -7323,25 +7083,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"options": [
 			{
 				"flags": "--model <model>",
-				"description": "Work model to use and persist for later respawns (defaults to Cloister config)",
-				"required": true,
-				"valueHint": "model"
-			},
-			{
-				"flags": "--swarm <mode>",
-				"description": "Per-issue swarm policy: off | auto | always",
-				"required": true,
-				"valueHint": "mode"
-			},
-			{
-				"flags": "--review-mode <mode>",
-				"description": "Per-issue review mode: quick | full | none",
-				"required": true,
-				"valueHint": "mode"
-			},
-			{
-				"flags": "--review-model <model>",
-				"description": "Per-issue review model override",
+				"description": "Work model for this session (defaults to Cloister config)",
 				"required": true,
 				"valueHint": "model"
 			},
@@ -7369,18 +7111,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": false,
 				"valueHint": null
 			},
-			{
-				"flags": "--shadow",
-				"description": "Enable shadow mode",
-				"required": false,
-				"valueHint": null
-			},
-			{
-				"flags": "--no-shadow",
-				"description": "Disable shadow mode",
-				"required": false,
-				"valueHint": null
-			},
 			{
 				"flags": "--remote",
 				"description": "Use remote workspace (Fly.io)",
@@ -7436,8 +7166,8 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"valueHint": null
 			},
 			{
-				"flags": "--off-book",
-				"description": "Allow one work-agent dispatch outside the active order book and log the override",
+				"flags": "--skip-freshness",
+				"description": "Bypass the plan-freshness preflight and spawn even if the plan names files that no longer exist",
 				"required": false,
 				"valueHint": null
 			}
@@ -7449,7 +7179,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-strike",
 		"path": ["strike"],
 		"display": "/pan strike",
-		"description": "Spawn strike agent(s) — implement and push a strike branch for Deacon to land through the verified merge door. Bypasses plan/review/test/ship.",
+		"description": "Spawn strike agent(s) — implement a fix on a strike branch and open a PR against main for the operator to merge. Bypasses plan/review/test/ship.",
 		"args": [{
 			"name": "ids",
 			"required": true,
@@ -7484,20 +7214,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Lifecycle"
 	},
-	{
-		"id": "pan-strike-ready",
-		"path": ["strike-ready"],
-		"display": "/pan strike-ready",
-		"description": "Persist readiness for a pushed strike branch so Deacon can land it",
-		"args": [{
-			"name": "id",
-			"required": true,
-			"variadic": false
-		}],
-		"options": [],
-		"aliases": [],
-		"category": "Lifecycle"
-	},
 	{
 		"id": "pan-knowledge",
 		"path": ["knowledge"],
@@ -7764,7 +7480,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-task",
 		"path": ["task"],
 		"display": "/pan task",
-		"description": "Read and update xBRIEF task state for one issue",
+		"description": "Read and update xBRIEF item state for one issue",
 		"args": [],
 		"options": [],
 		"aliases": [],
@@ -7826,32 +7542,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 			"required": true,
 			"variadic": false
 		}],
-		"options": [
-			{
-				"flags": "--reason <text>",
-				"description": "Reason for the status change",
-				"required": true,
-				"valueHint": "text"
-			},
-			{
-				"flags": "--expected-sequence <n>",
-				"description": "Require the current task sequence",
-				"required": true,
-				"valueHint": "n"
-			},
-			{
-				"flags": "--force",
-				"description": "Override a non-terminal transition or claim owner; requires --reason",
-				"required": false,
-				"valueHint": null
-			},
-			{
-				"flags": "--json",
-				"description": "Print JSON",
-				"required": false,
-				"valueHint": null
-			}
-		],
+		"options": [{
+			"flags": "--json",
+			"description": "Print JSON",
+			"required": false,
+			"valueHint": null
+		}],
 		"aliases": [],
 		"category": "Lifecycle"
 	},
@@ -7859,7 +7555,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-task-done",
 		"path": ["task", "done"],
 		"display": "/pan task done",
-		"description": "",
+		"description": "Record an item as done. Requires a commit carrying \"Item: <item>\" on a pushed branch.",
 		"args": [{
 			"name": "issue",
 			"required": true,
@@ -7869,32 +7565,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 			"required": true,
 			"variadic": false
 		}],
-		"options": [
-			{
-				"flags": "--reason <text>",
-				"description": "Reason for the status change",
-				"required": true,
-				"valueHint": "text"
-			},
-			{
-				"flags": "--expected-sequence <n>",
-				"description": "Require the current task sequence",
-				"required": true,
-				"valueHint": "n"
-			},
-			{
-				"flags": "--force",
-				"description": "Override a non-terminal transition or claim owner; requires --reason",
-				"required": false,
-				"valueHint": null
-			},
-			{
-				"flags": "--json",
-				"description": "Print JSON",
-				"required": false,
-				"valueHint": null
-			}
-		],
+		"options": [{
+			"flags": "--json",
+			"description": "Print JSON",
+			"required": false,
+			"valueHint": null
+		}],
 		"aliases": [],
 		"category": "Lifecycle"
 	},
@@ -7912,75 +7588,35 @@ const COMPOSER_COMMAND_MANIFEST = [
 			"required": true,
 			"variadic": false
 		}],
-		"options": [
-			{
-				"flags": "--reason <text>",
-				"description": "Reason for the status change",
-				"required": true,
-				"valueHint": "text"
-			},
-			{
-				"flags": "--expected-sequence <n>",
-				"description": "Require the current task sequence",
-				"required": true,
-				"valueHint": "n"
-			},
-			{
-				"flags": "--force",
-				"description": "Override a non-terminal transition or claim owner; requires --reason",
-				"required": false,
-				"valueHint": null
-			},
-			{
-				"flags": "--json",
-				"description": "Print JSON",
-				"required": false,
-				"valueHint": null
-			}
-		],
+		"options": [{
+			"flags": "--json",
+			"description": "Print JSON",
+			"required": false,
+			"valueHint": null
+		}],
 		"aliases": [],
 		"category": "Lifecycle"
 	},
 	{
-		"id": "pan-task-unblock",
-		"path": ["task", "unblock"],
-		"display": "/pan task unblock",
-		"description": "",
-		"args": [{
-			"name": "issue",
-			"required": true,
-			"variadic": false
-		}, {
-			"name": "item",
-			"required": true,
-			"variadic": false
-		}],
-		"options": [
-			{
-				"flags": "--reason <text>",
-				"description": "Reason for the status change",
-				"required": true,
-				"valueHint": "text"
-			},
-			{
-				"flags": "--expected-sequence <n>",
-				"description": "Require the current task sequence",
-				"required": true,
-				"valueHint": "n"
-			},
-			{
-				"flags": "--force",
-				"description": "Override a non-terminal transition or claim owner; requires --reason",
-				"required": false,
-				"valueHint": null
-			},
-			{
-				"flags": "--json",
-				"description": "Print JSON",
-				"required": false,
-				"valueHint": null
-			}
-		],
+		"id": "pan-task-unblock",
+		"path": ["task", "unblock"],
+		"display": "/pan task unblock",
+		"description": "",
+		"args": [{
+			"name": "issue",
+			"required": true,
+			"variadic": false
+		}, {
+			"name": "item",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--json",
+			"description": "Print JSON",
+			"required": false,
+			"valueHint": null
+		}],
 		"aliases": [],
 		"category": "Lifecycle"
 	},
@@ -7998,32 +7634,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 			"required": true,
 			"variadic": false
 		}],
-		"options": [
-			{
-				"flags": "--reason <text>",
-				"description": "Reason for the status change",
-				"required": true,
-				"valueHint": "text"
-			},
-			{
-				"flags": "--expected-sequence <n>",
-				"description": "Require the current task sequence",
-				"required": true,
-				"valueHint": "n"
-			},
-			{
-				"flags": "--force",
-				"description": "Override a non-terminal transition or claim owner; requires --reason",
-				"required": false,
-				"valueHint": null
-			},
-			{
-				"flags": "--json",
-				"description": "Print JSON",
-				"required": false,
-				"valueHint": null
-			}
-		],
+		"options": [{
+			"flags": "--json",
+			"description": "Print JSON",
+			"required": false,
+			"valueHint": null
+		}],
 		"aliases": [],
 		"category": "Lifecycle"
 	},
@@ -8041,32 +7657,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 			"required": true,
 			"variadic": false
 		}],
-		"options": [
-			{
-				"flags": "--reason <text>",
-				"description": "Reason for the status change",
-				"required": true,
-				"valueHint": "text"
-			},
-			{
-				"flags": "--expected-sequence <n>",
-				"description": "Require the current task sequence",
-				"required": true,
-				"valueHint": "n"
-			},
-			{
-				"flags": "--force",
-				"description": "Override a non-terminal transition or claim owner; requires --reason",
-				"required": false,
-				"valueHint": null
-			},
-			{
-				"flags": "--json",
-				"description": "Print JSON",
-				"required": false,
-				"valueHint": null
-			}
-		],
+		"options": [{
+			"flags": "--json",
+			"description": "Print JSON",
+			"required": false,
+			"valueHint": null
+		}],
 		"aliases": [],
 		"category": "Lifecycle"
 	},
@@ -9013,7 +8609,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-rollout-status",
 		"path": ["rollout", "status"],
 		"display": "/pan rollout status",
-		"description": "Print the release set for an issue (releaseStatus + per-component status)",
+		"description": "Print the release set for an issue (overall + per-component status)",
 		"args": [{
 			"name": "issueId",
 			"required": true,
@@ -9887,7 +9483,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-parked",
 		"path": ["parked"],
 		"display": "/pan parked",
-		"description": "List every issue parked in a stall orbit (stuck flags, gates, failed merges, zombies), oldest first, with why + release condition",
+		"description": "List every issue parked in a stall orbit (operator gates, zombie sessions, idle-running agents), oldest first, with why + release condition",
 		"args": [],
 		"options": [{
 			"flags": "--json",
@@ -9898,35 +9494,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "CLI"
 	},
-	{
-		"id": "pan-parked-ack",
-		"path": ["parked", "ack"],
-		"display": "/pan parked ack",
-		"description": "Batch-acknowledge parked rows (default orbit: needs-you), then print the flywheel hand-off",
-		"args": [],
-		"options": [
-			{
-				"flags": "--orbit <orbit>",
-				"description": "Parked orbit to acknowledge",
-				"required": true,
-				"valueHint": "orbit"
-			},
-			{
-				"flags": "--older-than <days>",
-				"description": "Only rows parked at least this many days",
-				"required": true,
-				"valueHint": "days"
-			},
-			{
-				"flags": "--dry-run",
-				"description": "List what would be acknowledged without writing",
-				"required": false,
-				"valueHint": null
-			}
-		],
-		"aliases": [],
-		"category": "CLI"
-	},
 	{
 		"id": "pan-docs",
 		"path": ["docs"],
@@ -10047,32 +9614,18 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"category": "Admin"
 	},
 	{
-		"id": "pan-admin-state",
-		"path": ["admin", "state"],
-		"display": "/pan admin state",
-		"description": "Permanent state administration",
-		"args": [],
-		"options": [],
-		"aliases": [],
-		"category": "Admin"
-	},
-	{
-		"id": "pan-admin-state-migrate",
-		"path": [
-			"admin",
-			"state",
-			"migrate"
-		],
-		"display": "/pan admin state migrate",
-		"description": "Move permanent state to the orphan overdeck-state branch",
+		"id": "pan-admin-seed-uat-fixtures",
+		"path": ["admin", "seed-uat-fixtures"],
+		"display": "/pan admin seed-uat-fixtures",
+		"description": "Seed the obviously-fake FIX-1 issue fixture into a workspace container for UI UAT. Host mode: `pan admin seed-uat-fixtures <issue-id>` seeds and restarts that issue's workspace container from the host. `--local` runs the seed itself against the current OVERDECK_HOME — used by the host wrapper, or manually inside a container.",
 		"args": [{
-			"name": "project",
-			"required": true,
+			"name": "issue-id",
+			"required": false,
 			"variadic": false
 		}],
 		"options": [{
-			"flags": "--dry-run",
-			"description": "Print the exact migration plan without mutating anything",
+			"flags": "--local",
+			"description": "Seed the current (container-local) OVERDECK_HOME directly, without a host wrapper step",
 			"required": false,
 			"valueHint": null
 		}],
@@ -10080,92 +9633,47 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"category": "Admin"
 	},
 	{
-		"id": "pan-admin-state-migrate-xbrief",
-		"path": [
-			"admin",
-			"state",
-			"migrate-xbrief"
-		],
-		"display": "/pan admin state migrate-xbrief",
-		"description": "Rename state documents to .xbrief.json and migrate legacy envelopes",
+		"id": "pan-admin-migrate-plan-home",
+		"path": ["admin", "migrate-plan-home"],
+		"display": "/pan admin migrate-plan-home",
+		"description": "One-time bridge: copy open-issue planning artifacts and item progress from ~/.overdeck/state/<project>/ into <planHome>/.pan/ (PAN-3917 D8)",
 		"args": [{
-			"name": "project",
+			"name": "project-key",
 			"required": true,
 			"variadic": false
 		}],
-		"options": [{
-			"flags": "--dry-run",
-			"description": "Print the exact xBRIEF migration plan without mutating anything",
-			"required": false,
-			"valueHint": null
-		}],
-		"aliases": [],
-		"category": "Admin"
-	},
-	{
-		"id": "pan-admin-state-backfill-agents",
-		"path": [
-			"admin",
-			"state",
-			"backfill-agents"
+		"options": [
+			{
+				"flags": "--commit",
+				"description": "Commit the copied artifacts in the plan home",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--dry-run",
+				"description": "Preview what would be copied without writing anything",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--state-root <dir>",
+				"description": "Override the state worktree root (tests / odd setups)",
+				"required": true,
+				"valueHint": "dir"
+			},
+			{
+				"flags": "--plan-home <dir>",
+				"description": "Override the plan home (tests / odd setups)",
+				"required": true,
+				"valueHint": "dir"
+			},
+			{
+				"flags": "--open-issues <file>",
+				"description": "Read open issue ids from a file instead of calling the tracker",
+				"required": true,
+				"valueHint": "file"
+			}
 		],
-		"display": "/pan admin state backfill-agents",
-		"description": "Reconstruct durable agent runtime records from local and retained state",
-		"args": [{
-			"name": "project",
-			"required": false,
-			"variadic": false
-		}],
-		"options": [{
-			"flags": "--dry-run",
-			"description": "Report the records and sessions that would be written",
-			"required": false,
-			"valueHint": null
-		}],
-		"aliases": [],
-		"category": "Admin"
-	},
-	{
-		"id": "pan-admin-reconcile-labels",
-		"path": ["admin", "reconcile-labels"],
-		"display": "/pan admin reconcile-labels",
-		"description": "Reconcile pipeline labels from permanent issue truth",
-		"args": [],
-		"options": [{
-			"flags": "--dry-run",
-			"description": "Print changes without mutating labels",
-			"required": false,
-			"valueHint": null
-		}],
-		"aliases": [],
-		"category": "Admin"
-	},
-	{
-		"id": "pan-admin-migrate-legacy-agent-dirs",
-		"path": ["admin", "migrate-legacy-agent-dirs"],
-		"display": "/pan admin migrate-legacy-agent-dirs",
-		"description": "Copy pre-rebrand conv-* agent dirs into the configured Overdeck home without overwriting",
-		"args": [],
-		"options": [],
-		"aliases": [],
-		"category": "Admin"
-	},
-	{
-		"id": "pan-admin-seed-uat-fixtures",
-		"path": ["admin", "seed-uat-fixtures"],
-		"display": "/pan admin seed-uat-fixtures",
-		"description": "Seed the obviously-fake FIX-1 issue fixture into a workspace container for UI UAT. Host mode: `pan admin seed-uat-fixtures <issue-id>` seeds and restarts that issue's workspace container from the host. `--local` runs the seed itself against the current OVERDECK_HOME — used by the host wrapper, or manually inside a container.",
-		"args": [{
-			"name": "issue-id",
-			"required": false,
-			"variadic": false
-		}],
-		"options": [{
-			"flags": "--local",
-			"description": "Seed the current (container-local) OVERDECK_HOME directly, without a host wrapper step",
-			"required": false,
-			"valueHint": null
-		}],
 		"aliases": [],
 		"category": "Admin"
 	},
@@ -10273,53 +9781,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Admin"
 	},
-	{
-		"id": "pan-admin-cloister-brake",
-		"path": [
-			"admin",
-			"cloister",
-			"brake"
-		],
-		"display": "/pan admin cloister brake",
-		"description": "Emergency brake - trim running work agents down to the concurrency cap (idle-first, resumable)",
-		"args": [],
-		"options": [{
-			"flags": "--json",
-			"description": "Output in JSON format",
-			"required": false,
-			"valueHint": null
-		}],
-		"aliases": [],
-		"category": "Admin"
-	},
-	{
-		"id": "pan-admin-cloister-freeze",
-		"path": [
-			"admin",
-			"cloister",
-			"freeze"
-		],
-		"display": "/pan admin cloister freeze",
-		"description": "Globally pause the Deacon (patrols run but skip all actions); running agents unaffected",
-		"args": [],
-		"options": [],
-		"aliases": [],
-		"category": "Admin"
-	},
-	{
-		"id": "pan-admin-cloister-unfreeze",
-		"path": [
-			"admin",
-			"cloister",
-			"unfreeze"
-		],
-		"display": "/pan admin cloister unfreeze",
-		"description": "Resume the Deacon from a global pause",
-		"args": [],
-		"options": [],
-		"aliases": [],
-		"category": "Admin"
-	},
 	{
 		"id": "pan-admin-specialists",
 		"path": ["admin", "specialists"],
@@ -10408,7 +9869,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 			"done"
 		],
 		"display": "/pan admin specialists done",
-		"description": "Signal specialist completion (deterministic status update)",
+		"description": "Post a specialist verdict to the issue's pull/merge request (review, test, uat)",
 		"args": [{
 			"name": "type",
 			"required": true,
@@ -10425,12 +9886,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": true,
 				"valueHint": "status"
 			},
-			{
-				"flags": "--item <itemId>",
-				"description": "xBRIEF item ID (required for inspect verdicts)",
-				"required": true,
-				"valueHint": "itemId"
-			},
 			{
 				"flags": "--notes <notes>",
 				"description": "Optional notes about the result",
@@ -10781,40 +10236,16 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"path": [
 			"admin",
 			"db",
-			"config"
-		],
-		"display": "/pan admin db config",
-		"description": "Show database configuration for a project",
-		"args": [{
-			"name": "project",
-			"required": false,
-			"variadic": false
-		}],
-		"options": [],
-		"aliases": [],
-		"category": "Admin"
-	},
-	{
-		"id": "pan-admin-db-rebuild-agents",
-		"path": [
-			"admin",
-			"db",
-			"rebuild-agents"
-		],
-		"display": "/pan admin db rebuild-agents",
-		"description": "Rebuild the SQLite agents table from state.json rollback sources (PAN-1908)",
-		"args": [],
-		"options": [{
-			"flags": "--dry-run",
-			"description": "Show what would be backfilled without writing",
-			"required": false,
-			"valueHint": null
-		}, {
-			"flags": "--verbose",
-			"description": "Log each processed agent",
+			"config"
+		],
+		"display": "/pan admin db config",
+		"description": "Show database configuration for a project",
+		"args": [{
+			"name": "project",
 			"required": false,
-			"valueHint": null
+			"variadic": false
 		}],
+		"options": [],
 		"aliases": [],
 		"category": "Admin"
 	},
@@ -10880,105 +10311,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Admin"
 	},
-	{
-		"id": "pan-admin-db-backfill-records",
-		"path": [
-			"admin",
-			"db",
-			"backfill-records"
-		],
-		"display": "/pan admin db backfill-records",
-		"description": "Backfill per-issue permanent records into the infra repo (PAN-1908)",
-		"args": [],
-		"options": [
-			{
-				"flags": "--issue-id <id>",
-				"description": "Backfill only this issue",
-				"required": true,
-				"valueHint": "id"
-			},
-			{
-				"flags": "--force",
-				"description": "Overwrite records even if unchanged",
-				"required": false,
-				"valueHint": null
-			},
-			{
-				"flags": "--verbose",
-				"description": "Log each processed issue",
-				"required": false,
-				"valueHint": null
-			}
-		],
-		"aliases": [],
-		"category": "Admin"
-	},
-	{
-		"id": "pan-admin-db-restore-verdicts",
-		"path": [
-			"admin",
-			"db",
-			"restore-verdicts"
-		],
-		"display": "/pan admin db restore-verdicts",
-		"description": "Rebuild review_status verdicts from per-issue records + live GitHub PR state (PAN-1922)",
-		"args": [],
-		"options": [
-			{
-				"flags": "--issue-id <id>",
-				"description": "Restore only this issue",
-				"required": true,
-				"valueHint": "id"
-			},
-			{
-				"flags": "--dry-run",
-				"description": "Show what would be restored without writing",
-				"required": false,
-				"valueHint": null
-			},
-			{
-				"flags": "--verbose",
-				"description": "Log each processed issue",
-				"required": false,
-				"valueHint": null
-			}
-		],
-		"aliases": [],
-		"category": "Admin"
-	},
-	{
-		"id": "pan-admin-db-reconcile-merges",
-		"path": [
-			"admin",
-			"db",
-			"reconcile-merges"
-		],
-		"display": "/pan admin db reconcile-merges",
-		"description": "Backfill fulfilled merge state from tracked PR and branch ancestry evidence (PAN-2311)",
-		"args": [],
-		"options": [
-			{
-				"flags": "--issue-id <id>",
-				"description": "Reconcile only this issue",
-				"required": true,
-				"valueHint": "id"
-			},
-			{
-				"flags": "--dry-run",
-				"description": "Show what would be reconciled without writing",
-				"required": false,
-				"valueHint": null
-			},
-			{
-				"flags": "--verbose",
-				"description": "Log each processed issue",
-				"required": false,
-				"valueHint": null
-			}
-		],
-		"aliases": [],
-		"category": "Admin"
-	},
 	{
 		"id": "pan-admin-config",
 		"path": ["admin", "config"],
@@ -11821,43 +11153,16 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"description": "Skip Qwen TTS daemon venv install (CUDA torch download is large)",
 				"required": false,
 				"valueHint": null
-			}
-		],
-		"aliases": [],
-		"category": "Core"
-	},
-	{
-		"id": "pan-inspect",
-		"path": ["inspect"],
-		"display": "/pan inspect",
-		"description": "Request inspection of a completed xBRIEF item before proceeding to the next",
-		"args": [{
-			"name": "issueId",
-			"required": true,
-			"variadic": false
-		}],
-		"options": [
-			{
-				"flags": "--item <itemId>",
-				"description": "xBRIEF item ID to inspect",
-				"required": true,
-				"valueHint": "itemId"
-			},
-			{
-				"flags": "--workspace <path>",
-				"description": "Workspace path (auto-detected if not provided)",
-				"required": true,
-				"valueHint": "path"
 			},
 			{
-				"flags": "--deep",
-				"description": "Use the deep inspection sub-role",
+				"flags": "--skip-herdr",
+				"description": "Skip Herdr terminal backend install/verify (tmux-only hosts)",
 				"required": false,
 				"valueHint": null
 			}
 		],
 		"aliases": [],
-		"category": "Lifecycle"
+		"category": "Core"
 	},
 	{
 		"id": "pan-caveman-compress",
@@ -12013,111 +11318,86 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"category": "Lifecycle"
 	},
 	{
-		"id": "pan-flywheel",
-		"path": ["flywheel"],
-		"display": "/pan flywheel",
-		"description": "Flywheel orchestrator lifecycle and status helpers",
-		"args": [],
-		"options": [],
-		"aliases": [],
-		"category": "Flywheel"
-	},
-	{
-		"id": "pan-flywheel-merge-blockers",
-		"path": ["flywheel", "merge-blockers"],
-		"display": "/pan flywheel merge-blockers",
-		"description": "PRs that passed review but cannot merge (GitHub-native reasons) — reads SQLite directly, no HTTP (sandbox-safe)",
-		"args": [],
-		"options": [{
-			"flags": "--json",
-			"description": "Output JSON",
-			"required": false,
-			"valueHint": null
-		}],
-		"aliases": [],
-		"category": "Flywheel"
-	},
-	{
-		"id": "pan-flywheel-weights",
-		"path": ["flywheel", "weights"],
-		"display": "/pan flywheel weights",
-		"description": "Weighted substrate bugs by affected v1.0 criterion — reads SQLite directly, no HTTP (sandbox-safe)",
+		"id": "pan-spawn",
+		"path": ["spawn"],
+		"display": "/pan spawn",
+		"description": "Create a worker pane for one xBRIEF item in the issue workspace",
 		"args": [],
 		"options": [
 			{
 				"flags": "--issue <id>",
-				"description": "Filter to a single issue",
+				"description": "Issue the worker belongs to",
 				"required": true,
 				"valueHint": "id"
 			},
 			{
-				"flags": "--window <dur>",
-				"description": "Stats window like 30d, 7d (default 30d)",
+				"flags": "--item <item>",
+				"description": "xBRIEF item the worker takes",
 				"required": true,
-				"valueHint": "dur"
+				"valueHint": "item"
 			},
 			{
-				"flags": "--json",
-				"description": "Output JSON",
-				"required": false,
-				"valueHint": null
+				"flags": "--model <model>",
+				"description": "Model the worker runs on",
+				"required": true,
+				"valueHint": "model"
+			},
+			{
+				"flags": "--harness <harness>",
+				"description": "Coding-agent harness (default: claude-code)",
+				"required": true,
+				"valueHint": "harness"
 			}
 		],
 		"aliases": [],
-		"category": "Flywheel"
+		"category": "CLI"
 	},
 	{
-		"id": "pan-flywheel-start",
-		"path": ["flywheel", "start"],
-		"display": "/pan flywheel start",
-		"description": "Start the Flywheel orchestrator",
+		"id": "pan-flywheel",
+		"path": ["flywheel"],
+		"display": "/pan flywheel",
+		"description": "Start, stop, or check the flywheel conversation",
 		"args": [],
-		"options": [{
-			"flags": "--brief <path>",
-			"description": "Path to the Flywheel brief",
-			"required": true,
-			"valueHint": "path"
-		}, {
-			"flags": "--orders <book-id>",
-			"description": "Bind the run to a validated order book",
-			"required": true,
-			"valueHint": "book-id"
-		}],
+		"options": [],
 		"aliases": [],
 		"category": "Flywheel"
 	},
 	{
-		"id": "pan-flywheel-emit-status",
-		"path": ["flywheel", "emit-status"],
-		"display": "/pan flywheel emit-status",
-		"description": "Validate and publish a FlywheelStatus JSON snapshot to the local dashboard",
+		"id": "pan-flywheel-start",
+		"path": ["flywheel", "start"],
+		"display": "/pan flywheel start",
+		"description": "Launch a conversation running /pan-flywheel",
 		"args": [],
-		"options": [{
-			"flags": "--file <path>",
-			"description": "Path to FlywheelStatus JSON, or - to read from stdin",
-			"required": true,
-			"valueHint": "path"
-		}],
+		"options": [
+			{
+				"flags": "--model <model>",
+				"description": "Model for the flywheel conversation",
+				"required": true,
+				"valueHint": "model"
+			},
+			{
+				"flags": "--harness <harness>",
+				"description": "Harness for the flywheel conversation",
+				"required": true,
+				"valueHint": "harness"
+			},
+			{
+				"flags": "--cwd <path>",
+				"description": "Working directory (default: cwd)",
+				"required": true,
+				"valueHint": "path"
+			}
+		],
 		"aliases": [],
 		"category": "Flywheel"
 	},
 	{
-		"id": "pan-flywheel-config",
-		"path": ["flywheel", "config"],
-		"display": "/pan flywheel config",
-		"description": "Get or set Flywheel autonomy configuration",
+		"id": "pan-flywheel-stop",
+		"path": ["flywheel", "stop"],
+		"display": "/pan flywheel stop",
+		"description": "Stop the flywheel conversation",
 		"args": [],
-		"options": [{
-			"flags": "--get [key]",
-			"description": "Print Flywheel config values",
-			"required": false,
-			"valueHint": "key"
-		}, {
-			"flags": "--set <key=value>",
-			"description": "Set a Flywheel config boolean",
-			"required": true,
-			"valueHint": "key=value"
-		}],
+		"options": [],
 		"aliases": [],
 		"category": "Flywheel"
 	},
@@ -12125,107 +11405,17 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-flywheel-status",
 		"path": ["flywheel", "status"],
 		"display": "/pan flywheel status",
-		"description": "Show the active Flywheel run status",
-		"args": [],
-		"options": [{
-			"flags": "--json",
-			"description": "Emit the raw FlywheelStatus JSON",
-			"required": false,
-			"valueHint": null
-		}],
-		"aliases": [],
-		"category": "Flywheel"
-	},
-	{
-		"id": "pan-flywheel-stats",
-		"path": ["flywheel", "stats"],
-		"display": "/pan flywheel stats",
-		"description": "Show Flywheel v1.0 readiness stats",
+		"description": "Say whether the flywheel conversation is running",
 		"args": [],
 		"options": [{
-			"flags": "--window <duration>",
-			"description": "Stats window duration",
-			"required": true,
-			"valueHint": "duration"
-		}, {
 			"flags": "--json",
-			"description": "Emit the raw FlywheelStats JSON",
-			"required": false,
-			"valueHint": null
-		}],
-		"aliases": [],
-		"category": "Flywheel"
-	},
-	{
-		"id": "pan-flywheel-pause",
-		"path": ["flywheel", "pause"],
-		"display": "/pan flywheel pause",
-		"description": "Pause the active Flywheel orchestrator run",
-		"args": [],
-		"options": [],
-		"aliases": [],
-		"category": "Flywheel"
-	},
-	{
-		"id": "pan-flywheel-resume",
-		"path": ["flywheel", "resume"],
-		"display": "/pan flywheel resume",
-		"description": "Resume the paused Flywheel orchestrator run",
-		"args": [],
-		"options": [],
-		"aliases": [],
-		"category": "Flywheel"
-	},
-	{
-		"id": "pan-flywheel-report",
-		"path": ["flywheel", "report"],
-		"display": "/pan flywheel report",
-		"description": "Finalize the active Flywheel run: write report.md, compact over-threshold FLYWHEEL-STATE.md history, commit State changes, and clear the active-run gate. Refuses to run while the orchestrator session is alive (pause or abort first).",
-		"args": [],
-		"options": [{
-			"flags": "--force",
-			"description": "Bypass the orchestrator-alive guard. Intended for the orchestrator role's own end-of-run call.",
-			"required": false,
-			"valueHint": null
-		}],
-		"aliases": [],
-		"category": "Flywheel"
-	},
-	{
-		"id": "pan-flywheel-complete",
-		"path": ["flywheel", "complete"],
-		"display": "/pan flywheel complete",
-		"description": "Complete a drained order-book run, write its report and retrospective, then continue mechanically",
-		"args": [],
-		"options": [{
-			"flags": "--force",
-			"description": "Complete even when the order book still has non-terminal items",
+			"description": "Output as JSON",
 			"required": false,
 			"valueHint": null
 		}],
 		"aliases": [],
 		"category": "Flywheel"
 	},
-	{
-		"id": "pan-flywheel-stop",
-		"path": ["flywheel", "stop"],
-		"display": "/pan flywheel stop",
-		"description": "Stop the Flywheel orchestrator gracefully: kill any live session, write report.md, commit FLYWHEEL-STATE.md changes, and clear the active-run gate",
-		"args": [],
-		"options": [],
-		"aliases": [],
-		"category": "Flywheel"
-	},
-	{
-		"id": "pan-flywheel-abort",
-		"path": ["flywheel", "abort"],
-		"display": "/pan flywheel abort",
-		"description": "Discard the active Flywheel run without writing a report",
-		"args": [],
-		"options": [],
-		"aliases": [],
-		"category": "Flywheel"
-	},
 	{
 		"id": "pan-merge",
 		"path": ["merge"],
@@ -13546,14 +12736,6 @@ const COMPOSER_COMMAND_VARIANTS = [
 		"insert": "/pan plan --auto --auto-start ",
 		"category": "Lifecycle"
 	},
-	{
-		"id": "pan-review-reset-session",
-		"path": ["review", "reset"],
-		"display": "/pan review reset --session",
-		"description": "Reset review and clear saved Claude session",
-		"insert": "/pan review reset --session",
-		"category": "Review"
-	},
 	{
 		"id": "pan-fork-plain",
 		"path": ["fork"],
@@ -13688,6 +12870,24 @@ const HOOK_INVENTORY = [
 const WIRED_HOOK_INVENTORY = HOOK_INVENTORY.filter((hook) => hook.wired);
 const WIRED_HOOK_NAMES = WIRED_HOOK_INVENTORY.map((hook) => hook.name);
 //#endregion
-export { ACP_BEHAVIOR, Activity, ActivityDetailedEvent, ActivityEntryEvent, ActivityTtsEvent, ActivityUpdatedEvent, AdmissionState, AgentActivityChangedEvent, AgentChannelReply, AgentChannelReplyEvent, AgentCompletedEvent, AgentContextSaturationChangedEvent, AgentCreatedEvent, AgentCurrentIssueSetEvent, AgentEnrichmentChangedEvent, AgentHealthKind, AgentHealthSnapshot, AgentHealthStatus, AgentHeartbeatDeadEvent, AgentHookFiredEvent, AgentId, AgentMessageReceivedEvent, AgentModelSetEvent, AgentOutput, AgentOutputReceivedEvent, AgentPermissionRequestedEvent, AgentPermissionResolvedEvent, AgentResolution, AgentResolutionChangedEvent, AgentRuntimeSnapshot, AgentSnapshot, AgentStartedEvent, AgentStateRestoredEvent, AgentStatus, AgentStatusChangedEvent, AgentStoppedEvent, AgentThinkingStartedEvent, AgentThinkingStoppedEvent, AgentTurnDiffCompletedEvent, AgentWaitingClearedEvent, AgentWaitingStartedEvent, ArtifactAgentHarness, ArtifactAgentRole, ArtifactCreateResponse, ArtifactDetailResponse, ArtifactHash, ArtifactId, ArtifactLifecycleState, ArtifactListEntry, ArtifactListResponse, ArtifactMetadata, ArtifactPublishResponse, ArtifactSlug, ArtifactStatusResponse, ArtifactUnshareResponse, ArtifactUrls, ArtifactValidationCode, ArtifactValidationFinding, ArtifactValidationResult, BeadsFreshnessChangedEvent, CHANNEL_REPLY_KIND_VALUES, CLAUDE_CODE_BEHAVIOR, CODEX_BEHAVIOR, COMPOSER_COMMAND_INSERT_OVERRIDES, COMPOSER_COMMAND_MANIFEST, COMPOSER_COMMAND_VARIANTS, CONTEXT_LAYER_KINDS, CONTEXT_PREVIEW_HARNESSES, ChannelPermissionRequestSnapshot, ChannelReplyArtifactRef, ChannelReplyKind, ChatMessage, ClaudeChannelPermissionBehavior, CompactBoundary, ContextEditableLayerRecord, ContextHarnessPreviews, ContextLayerDraft, ContextLayerKind, ContextLayerSaveRequest, ContextLayerSaveResponse, ContextLayerTarget, ContextLayersResponse, ContextPreviewDiagnostic, ContextPreviewHarness, ContextPreviewRequest, ContextPreviewResponse, ContextProjectSummary, ContextSyncRequest, ContextSyncResponse, ContextSyncTarget, ContextUsage, ContextWorkspaceSummary, ConversationCompactingChangedEvent, ConversationCostSummary, ConversationCreatedEvent, ConversationEvent, ConversationFilter, ConversationMovedEvent, ConversationPermissionChangedEvent, ConversationResponse, ConversationTitleChangedEvent, CostEventRecordedEvent, DEFAULT_MAX_MEMORY_OBSERVATIONS_PER_ISSUE, DEFAULT_MAX_TURN_DIFF_SUMMARIES_PER_AGENT, DashboardLifecycleCompletedEvent, DashboardLifecycleFailedEvent, DashboardLifecycleStartedEvent, DashboardSnapshot, DeepWipeRpc, DeployStalenessSnapshot, DiscoveredSessionSnapshot, DomainEvent, EDITORS, EditorIdSchema, EmbedProgressEvent, EmbedProgressSnapshot, EmbedSessionsRpc, EnrichCompleteEvent, EnrichProgressEvent, EnrichProgressSnapshot, EnrichSessionsRpc, EnrichStatsSnapshot, ExtractionProviderConfig, ExtractionProviderTarget, FeatureNode, FeatureRegistryEntry, FeatureRegistryStatus, FlywheelAgent, FlywheelAgentStatus, FlywheelEffort, FlywheelHarness, FlywheelHeadline, FlywheelHttpUrl, FlywheelOrchestrator, FlywheelOrders, FlywheelParkedItem, FlywheelPipelineItem, FlywheelPipelineStatus, FlywheelPipelineVerb, FlywheelRunId, FlywheelScope, FlywheelStats, FlywheelStatsCriteria, FlywheelStatsCriterion, FlywheelStatsCriterionStatus, FlywheelStatsCriterionValue, FlywheelStatsCriterionValueObject, FlywheelStatsTrend, FlywheelStatus, FlywheelSubstrateBug, FlywheelSubstrateBugStatus, FlywheelSuggestion, FlywheelSuggestionAction, FlywheelSuggestionPriority, FlywheelSystemStatus, GetAvailableEditorsRpc, GetConversationCostByWorkspaceRpc, GetConversationCostRpc, GetConversationStatsRpc, GetDiscoveredSessionRpc, GetSessionsFeedFacetsRpc, GetSnapshotRpc, GetWorkspaceDetailRpc, GlobalContextLayerRecord, GlobalContextLayerTarget, HOOK_INVENTORY, HealthReason, HealthState, HostHealthMetrics, HostPlatform, HygieneFinding, HygienePullRequest, HygieneReport, INITIAL_READ_MODEL_STATE, IssueId, IssueStatusChangedEvent, IssueTransitionedEvent, IssuesDeltaEvent, IssuesSnapshotEvent, IssuesUpdatedEvent, KIMI_CODE_BEHAVIOR, KNOWN_HARNESSES, LegacySystemHealthSummary, LegacyWebhookRelaySummary, LinearMcpAuthCallbackRelayedEvent, LinearMcpAuthHealthyEvent, LinearMcpAuthNotifiedEvent, LinearMcpAuthRequiredEvent, ListDiscoveredSessionsRpc, ListSessionsFeedRpc, MAX_CHANNEL_REPLY_ARTIFACT_LABEL_LENGTH, MAX_CHANNEL_REPLY_ARTIFACT_REFS, MAX_CHANNEL_REPLY_ARTIFACT_URI_LENGTH, MAX_CHANNEL_REPLY_SUMMARY_LENGTH, MEMBERSHIP_UNAVAILABLE_REASONS, MUSE_BEHAVIOR, MemoryAgentRole, MemoryHealthChangedEvent, MemoryIdentity, MemoryObservation, MemoryObservationCreatedEvent, MemoryResetMarkerCreatedEvent, MemoryRollupTriggeredEvent, MemoryStatus, MemoryStatusPhase, MemoryStatusUpdatedEvent, MemoryTokenUsage, MergeReadyEvent, MergeStatusValue, ModelOrigin, ModelOriginEntry, OHMYPI_BEHAVIOR, OPENCODE_BEHAVIOR, OVERDECK_AGENT_PROTOCOL_VERSION, OVERDECK_DASHBOARD_PROTOCOL_VERSION, OpenInEditorInput, OperatorInterventionEvent, OrderBook, OrderBookIndexEntry, OrderBookItem, OrderBookLane, OrderBookPosture, OrderBookSettings, OrderBookStatus, PanRpcError, PanRpcGroup, PendingTurn, PipelineReviewCompletedEvent, PipelineReviewStartedEvent, PipelineStatusChangedEvent, PipelineTestCompletedEvent, PipelineTestStartedEvent, PipelineVerificationFailedEvent, PipelineVerificationStartedEvent, PlanItemStatusChangedEvent, PlanItemsUnblockedEvent, PlanSubitemStatusChangedEvent, PlanningFailedEvent, PlanningStartedEvent, PlanningSyncEvent, ProjectCiHeadObservedEvent, ProjectCiSnapshot, ProjectCiSuite, ProjectCiSuiteObservedEvent, ProjectContextLayerRecord, ProjectContextLayerTarget, ProjectSessionTree, ProposedPlan, RagDecision, RagDecisionSource, ReadFileAtPathInput, ReadFileAtPathResult, ReadFileAtPathRpc, ReadWorkspaceFileInput, ReadWorkspaceFileResult, ReadWorkspaceFileRpc, ReleaseStatusValue, ReplayEventsRpc, ResetMarker, ResetMarkerScope, ResizeTerminalRpc, ResolveFilePathExistsInput, ResolveFilePathExistsResult, ResolveFilePathExistsRpc, ResourceStats, ResourcesUpdatedEvent, RestartGateChangedEvent, RestartGateKind, RestartGateOutcome, RestartGateRequest, RestartGateSnapshot, ReviewApprovedEvent, ReviewCoordinatorDiedEvent, ReviewCoordinatorStartedEvent, ReviewCycleEntry, ReviewReviewerCompletedEvent, ReviewReviewerStartedEvent, ReviewSpecialistTimedOutEvent, ReviewStatusChangedEvent, ReviewStatusSnapshot, ReviewStatusValue, ReviewVerdictDispatchedEvent, ReviewVerdictRejectedEvent, ReviewVerdictRestoreBlockedEvent, ReviewerRoundMetadata, ReviewerRoundSummary, Role, ScanCompleteEvent, ScanConversationsRpc, ScanProgressEvent, ScanProgressSnapshot, ScanResult, ScanStartedEvent, SearchConversationsRpc, SendTerminalInputRpc, SequenceNumber, ServiceHealthSnapshot, ServiceHealthStatus, SessionNode, SessionNodePresence, SessionNodeType, SessionTreeDelta, SessionsFeedFacetsSnapshot, SessionsFeedRowSnapshot, SessionsFeedSource, ShadowInferenceUpdateEvent, ShellOpenInEditorRpc, SpecialistCompletedEvent, SpecialistFailedEvent, SpecialistLifecycle, SpecialistStartedEvent, StartAgentRpc, StartPlanningRpc, SubagentSummary, SubscribeAgentOutputRpc, SubscribeConversationMessagesRpc, SubscribeDomainEventsRpc, SubscribeFlywheelStatusRpc, SubscribeIssueEventsRpc, SubscribeProjectSessionTreeRpc, SubscribeTerminalRpc, SubstrateBugFiledEvent, SweepEscalatedEvent, SweepRecommendationEvent, SweepScanEvent, SystemHealthConsumer, SystemHealthSeverityChangedEvent, SystemHealthSnapshot, SystemHeartbeatEvent, TELEMETRY_CLI_VERBS, TELEMETRY_EVENT_CATALOG, TELEMETRY_EVENT_NAMES, TELEMETRY_PROPERTY_DOMAINS, TerminalCloseRpc, TerminalOpenRpc, TerminalOutput, TerminalResizeRpc, TerminalWriteRpc, TestPassedEvent, TestStatusValue, ThinkingState, TurnDiffFileChange, TurnDiffSummary, UatStatusValue, VerificationStatusValue, WIRED_HOOK_INVENTORY, WIRED_HOOK_NAMES, WS_METHODS, WaitingReason, WaitingState, WorkCompletedEvent, WorkLogEntry, WorkspaceAbortedEvent, WorkspaceArtifactsResponse, WorkspaceContextLayerRecord, WorkspaceContextLayerTarget, WorkspaceCreatedEvent, WorkspaceDeletedEvent, WorkspaceDestroyedEvent, WorkspaceDetail, WorkspaceWipeStartedEvent, WriteFileAtPathInput, WriteFileAtPathResult, WriteFileAtPathRpc, applyEvent, applyEvents, applyIssueDelta, compareIssueIds, createIssueDelta, decodeFlywheelStats, deriveProjectCi, encodeFlywheelStats, getHarness, getHarnessBehavior, getMaxMemoryObservationsPerIssue, getMaxTurnDiffSummariesPerAgent, getRuntimeBehavior, isChannelReplyKind, isTerminalTurnDiffSummaryStatus, normalizeChannelReplyPayload, omitTurnDiffSummariesForAgent, projectLegacySystemHealthSummary, syncSnapshot, trimMemoryObservations, trimTurnDiffSummaries };
+//#region src/terminal-backend.ts
+const TERMINAL_BACKEND_NAMES = ["herdr", "tmux"];
+const AGENT_ROLES = [
+	"work",
+	"worker",
+	"review",
+	"test",
+	"uat",
+	"strike",
+	"plan"
+];
+function isTerminalBackendName(value) {
+	return typeof value === "string" && TERMINAL_BACKEND_NAMES.includes(value);
+}
+function isAgentRole(value) {
+	return typeof value === "string" && AGENT_ROLES.includes(value);
+}
+//#endregion
+export { ACP_BEHAVIOR, AGENT_ROLES, Activity, ActivityDetailedEvent, ActivityEntryEvent, ActivityTtsEvent, ActivityUpdatedEvent, AdmissionState, AgentActivityChangedEvent, AgentChannelReply, AgentChannelReplyEvent, AgentCompletedEvent, AgentContextSaturationChangedEvent, AgentCreatedEvent, AgentCurrentIssueSetEvent, AgentEnrichmentChangedEvent, AgentHealthKind, AgentHealthSnapshot, AgentHealthStatus, AgentHeartbeatDeadEvent, AgentHookFiredEvent, AgentId, AgentMessageReceivedEvent, AgentModelSetEvent, AgentOutput, AgentOutputReceivedEvent, AgentPermissionRequestedEvent, AgentPermissionResolvedEvent, AgentResolution, AgentResolutionChangedEvent, AgentRuntimeSnapshot, AgentSnapshot, AgentStartedEvent, AgentStateRestoredEvent, AgentStatus, AgentStatusChangedEvent, AgentStoppedEvent, AgentThinkingStartedEvent, AgentThinkingStoppedEvent, AgentTurnDiffCompletedEvent, AgentWaitingClearedEvent, AgentWaitingStartedEvent, ArtifactAgentHarness, ArtifactAgentRole, ArtifactCreateResponse, ArtifactDetailResponse, ArtifactHash, ArtifactId, ArtifactLifecycleState, ArtifactListEntry, ArtifactListResponse, ArtifactMetadata, ArtifactPublishResponse, ArtifactSlug, ArtifactStatusResponse, ArtifactUnshareResponse, ArtifactUrls, ArtifactValidationCode, ArtifactValidationFinding, ArtifactValidationResult, BackendPane, BackendPaneChangedEvent, BackendPaneRemovedEvent, BeadsFreshnessChangedEvent, CHANNEL_REPLY_KIND_VALUES, CLAUDE_CODE_BEHAVIOR, CODEX_BEHAVIOR, COMPOSER_COMMAND_INSERT_OVERRIDES, COMPOSER_COMMAND_MANIFEST, COMPOSER_COMMAND_VARIANTS, CONTEXT_LAYER_KINDS, CONTEXT_PREVIEW_HARNESSES, ChannelPermissionRequestSnapshot, ChannelReplyArtifactRef, ChannelReplyKind, ChatMessage, ClaudeChannelPermissionBehavior, CompactBoundary, ContextEditableLayerRecord, ContextHarnessPreviews, ContextLayerDraft, ContextLayerKind, ContextLayerSaveRequest, ContextLayerSaveResponse, ContextLayerTarget, ContextLayersResponse, ContextPreviewDiagnostic, ContextPreviewHarness, ContextPreviewRequest, ContextPreviewResponse, ContextProjectSummary, ContextSyncRequest, ContextSyncResponse, ContextSyncTarget, ContextUsage, ContextWorkspaceSummary, ConversationCompactingChangedEvent, ConversationCostSummary, ConversationCreatedEvent, ConversationEvent, ConversationFilter, ConversationMovedEvent, ConversationPermissionChangedEvent, ConversationResponse, ConversationTitleChangedEvent, CostEventRecordedEvent, DEFAULT_MAX_MEMORY_OBSERVATIONS_PER_ISSUE, DEFAULT_MAX_TURN_DIFF_SUMMARIES_PER_AGENT, DashboardLifecycleCompletedEvent, DashboardLifecycleFailedEvent, DashboardLifecycleStartedEvent, DashboardSnapshot, DeepWipeRpc, DeployStalenessSnapshot, DerivedBranchState, DerivedIssueState, DerivedPrState, DiscoveredSessionSnapshot, DomainEvent, EDITORS, EditorIdSchema, EmbedProgressEvent, EmbedProgressSnapshot, EmbedSessionsRpc, EnrichCompleteEvent, EnrichProgressEvent, EnrichProgressSnapshot, EnrichSessionsRpc, EnrichStatsSnapshot, ExtractionProviderConfig, ExtractionProviderTarget, FeatureNode, FeatureRegistryEntry, FeatureRegistryStatus, FlywheelAgent, FlywheelAgentStatus, FlywheelEffort, FlywheelHarness, FlywheelHeadline, FlywheelHttpUrl, FlywheelOrchestrator, FlywheelOrders, FlywheelParkedItem, FlywheelPipelineItem, FlywheelPipelineStatus, FlywheelPipelineVerb, FlywheelRunId, FlywheelScope, FlywheelStats, FlywheelStatsCriteria, FlywheelStatsCriterion, FlywheelStatsCriterionStatus, FlywheelStatsCriterionValue, FlywheelStatsCriterionValueObject, FlywheelStatsTrend, FlywheelStatus, FlywheelSubstrateBug, FlywheelSubstrateBugStatus, FlywheelSuggestion, FlywheelSuggestionAction, FlywheelSuggestionPriority, FlywheelSystemStatus, GetAvailableEditorsRpc, GetConversationCostByWorkspaceRpc, GetConversationCostRpc, GetConversationStatsRpc, GetDiscoveredSessionRpc, GetSessionsFeedFacetsRpc, GetSnapshotRpc, GlobalContextLayerRecord, GlobalContextLayerTarget, HOOK_INVENTORY, HealthReason, HealthState, HostHealthMetrics, HostPlatform, HygieneFinding, HygienePullRequest, HygieneReport, INITIAL_READ_MODEL_STATE, ISSUE_ATTENTIONS, ISSUE_STATES, ISSUE_STATE_PRECEDENCE, IssueAttention, IssueId, IssueState, IssueStateChangedEvent, IssueStatusChangedEvent, IssueTransitionedEvent, IssuesDeltaEvent, IssuesSnapshotEvent, IssuesUpdatedEvent, KIMI_CODE_BEHAVIOR, KNOWN_HARNESSES, LegacySystemHealthSummary, LegacyWebhookRelaySummary, LinearMcpAuthCallbackRelayedEvent, LinearMcpAuthHealthyEvent, LinearMcpAuthNotifiedEvent, LinearMcpAuthRequiredEvent, ListDiscoveredSessionsRpc, ListSessionsFeedRpc, MAX_CHANNEL_REPLY_ARTIFACT_LABEL_LENGTH, MAX_CHANNEL_REPLY_ARTIFACT_REFS, MAX_CHANNEL_REPLY_ARTIFACT_URI_LENGTH, MAX_CHANNEL_REPLY_SUMMARY_LENGTH, MEMBERSHIP_UNAVAILABLE_REASONS, MUSE_BEHAVIOR, MemoryAgentRole, MemoryHealthChangedEvent, MemoryIdentity, MemoryObservation, MemoryObservationCreatedEvent, MemoryResetMarkerCreatedEvent, MemoryRollupTriggeredEvent, MemoryStatus, MemoryStatusPhase, MemoryStatusUpdatedEvent, MemoryTokenUsage, MergeReadyEvent, ModelOrigin, ModelOriginEntry, OHMYPI_BEHAVIOR, OPENCODE_BEHAVIOR, OVERDECK_AGENT_PROTOCOL_VERSION, OVERDECK_DASHBOARD_PROTOCOL_VERSION, OpenInEditorInput, OperatorInterventionEvent, OrderBook, OrderBookIndexEntry, OrderBookItem, OrderBookLane, OrderBookPosture, OrderBookSettings, OrderBookStatus, PanRpcError, PanRpcGroup, PendingTurn, PipelineReviewCompletedEvent, PipelineReviewStartedEvent, PipelineTestCompletedEvent, PipelineTestStartedEvent, PipelineVerificationFailedEvent, PipelineVerificationStartedEvent, PlanItemStatusChangedEvent, PlanItemsUnblockedEvent, PlanSubitemStatusChangedEvent, PlanningFailedEvent, PlanningStartedEvent, PlanningSyncEvent, PrChecksState, PrReviewState, ProjectCiHeadObservedEvent, ProjectCiSnapshot, ProjectCiSuite, ProjectCiSuiteObservedEvent, ProjectContextLayerRecord, ProjectContextLayerTarget, ProjectSessionTree, ProposedPlan, RagDecision, RagDecisionSource, ReadFileAtPathInput, ReadFileAtPathResult, ReadFileAtPathRpc, ReadWorkspaceFileInput, ReadWorkspaceFileResult, ReadWorkspaceFileRpc, ReplayEventsRpc, ResetMarker, ResetMarkerScope, ResizeTerminalRpc, ResolveFilePathExistsInput, ResolveFilePathExistsResult, ResolveFilePathExistsRpc, ResourceStats, ResourcesUpdatedEvent, RestartGateChangedEvent, RestartGateKind, RestartGateOutcome, RestartGateRequest, RestartGateSnapshot, ReviewApprovedEvent, ReviewCoordinatorDiedEvent, ReviewCoordinatorStartedEvent, ReviewReviewerCompletedEvent, ReviewReviewerStartedEvent, ReviewSpecialistTimedOutEvent, ReviewVerdictDispatchedEvent, ReviewVerdictRejectedEvent, ReviewVerdictRestoreBlockedEvent, ReviewerRoundMetadata, ReviewerRoundSummary, Role, ScanCompleteEvent, ScanConversationsRpc, ScanProgressEvent, ScanProgressSnapshot, ScanResult, ScanStartedEvent, SearchConversationsRpc, SendTerminalInputRpc, SequenceNumber, ServiceHealthSnapshot, ServiceHealthStatus, SessionNode, SessionNodePresence, SessionNodeType, SessionTreeDelta, SessionsFeedFacetsSnapshot, SessionsFeedRowSnapshot, SessionsFeedSource, ShadowInferenceUpdateEvent, ShellOpenInEditorRpc, SpecialistCompletedEvent, SpecialistFailedEvent, SpecialistLifecycle, SpecialistStartedEvent, StartAgentRpc, StartPlanningRpc, SubagentSummary, SubscribeAgentOutputRpc, SubscribeConversationMessagesRpc, SubscribeDomainEventsRpc, SubscribeIssueEventsRpc, SubscribeProjectSessionTreeRpc, SubscribeTerminalRpc, SubstrateBugFiledEvent, SweepEscalatedEvent, SweepRecommendationEvent, SweepScanEvent, SystemHealthConsumer, SystemHealthSeverityChangedEvent, SystemHealthSnapshot, SystemHeartbeatEvent, TELEMETRY_CLI_VERBS, TELEMETRY_EVENT_CATALOG, TELEMETRY_EVENT_NAMES, TELEMETRY_PROPERTY_DOMAINS, TERMINAL_BACKEND_NAMES, TerminalCloseRpc, TerminalOpenRpc, TerminalOutput, TerminalResizeRpc, TerminalWriteRpc, TestPassedEvent, ThinkingState, TurnDiffFileChange, TurnDiffSummary, WIRED_HOOK_INVENTORY, WIRED_HOOK_NAMES, WS_METHODS, WaitingReason, WaitingState, WorkCompletedEvent, WorkLogEntry, WorkspaceAbortedEvent, WorkspaceArtifactsResponse, WorkspaceContextLayerRecord, WorkspaceContextLayerTarget, WorkspaceCreatedEvent, WorkspaceDeletedEvent, WorkspaceDestroyedEvent, WorkspaceWipeStartedEvent, WriteFileAtPathInput, WriteFileAtPathResult, WriteFileAtPathRpc, applyEvent, applyEvents, applyIssueDelta, compareIssueIds, createIssueDelta, decodeFlywheelStats, deriveProjectCi, encodeFlywheelStats, getHarness, getHarnessBehavior, getMaxMemoryObservationsPerIssue, getMaxTurnDiffSummariesPerAgent, getRuntimeBehavior, isAgentRole, isAgentSessionName, isChannelReplyKind, isIssueAttention, isIssueState, isTerminalBackendName, isTerminalTurnDiffSummaryStatus, normalizeChannelReplyPayload, omitTurnDiffSummariesForAgent, projectLegacySystemHealthSummary, syncSnapshot, trimMemoryObservations, trimTurnDiffSummaries };
 
 //# sourceMappingURL=index.mjs.map