@overdeck/contracts 0.50.4 → 0.60.0

package/dist/index.cjs

@@ -26,6 +26,143 @@ let effect_unstable_rpc_Rpc = require("effect/unstable/rpc/Rpc");
 effect_unstable_rpc_Rpc = __toESM(effect_unstable_rpc_Rpc, 1);
 let effect_unstable_rpc_RpcGroup = require("effect/unstable/rpc/RpcGroup");
 effect_unstable_rpc_RpcGroup = __toESM(effect_unstable_rpc_RpcGroup, 1);
+//#region src/backend-pane.ts
+const BackendPane = effect.Schema.Struct({
+	/** Stable pane identity: the backend-native pane handle. */
+	id: effect.Schema.String,
+	/** Issue the pane belongs to; absent for operator conversations. */
+	issue: effect.Schema.optional(effect.Schema.String),
+	role: effect.Schema.Literals([
+		"work",
+		"worker",
+		"review",
+		"test",
+		"uat",
+		"strike",
+		"plan"
+	]),
+	harness: effect.Schema.String,
+	model: effect.Schema.String,
+	state: effect.Schema.Literals([
+		"idle",
+		"working",
+		"blocked",
+		"done",
+		"exited",
+		"unknown"
+	]),
+	/** Epoch millis the pane entered `state`; drives the `stuck` attention. */
+	stateSince: effect.Schema.optional(effect.Schema.Number),
+	/** Handle the terminal WebSocket attaches to. */
+	terminalId: effect.Schema.optional(effect.Schema.String),
+	/** Working directory of the pane (the issue workspace path). */
+	workspace: effect.Schema.optional(effect.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 = effect.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 = effect.Schema.Literals([
+	"needs-you",
+	"stuck",
+	"api-error"
+]);
+/** Latest review decision on the PR, as the forge reports it. */
+const PrReviewState = effect.Schema.Literals([
+	"approved",
+	"changes-requested",
+	"review-requested",
+	"commented",
+	"none"
+]);
+/** Aggregate check-run conclusion for the PR head. */
+const PrChecksState = effect.Schema.Literals([
+	"green",
+	"red",
+	"pending"
+]);
+/** The pull request (or merge request) backing an issue. */
+const DerivedPrState = effect.Schema.Struct({
+	url: effect.Schema.String,
+	number: effect.Schema.Number,
+	reviewState: PrReviewState,
+	checks: PrChecksState,
+	/** Forge mergeability. `null` when the forge has not computed it yet. */
+	mergeable: effect.Schema.NullOr(effect.Schema.Boolean)
+});
+/** The issue's feature branch as git reports it. */
+const DerivedBranchState = effect.Schema.Struct({
+	name: effect.Schema.String,
+	aheadOfMain: effect.Schema.Number,
+	pushed: effect.Schema.Boolean
+});
+/** Everything the dashboard needs to render an issue's pipeline position. */
+const DerivedIssueState = effect.Schema.Struct({
+	issueId: effect.Schema.String,
+	state: IssueState,
+	attention: effect.Schema.optional(IssueAttention),
+	pr: effect.Schema.optional(DerivedPrState),
+	branch: effect.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: effect.Schema.optional(effect.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 = effect.Schema.String;
 const MEMBERSHIP_UNAVAILABLE_REASONS = [
@@ -66,52 +203,6 @@ const AgentResolution = effect.Schema.Literals([
 	"abandoned",
 	"api_error"
 ]);
-const ReviewStatusValue = effect.Schema.Literals([
-	"pending",
-	"reviewing",
-	"passed",
-	"failed",
-	"blocked",
-	"skipped"
-]);
-const TestStatusValue = effect.Schema.Literals([
-	"pending",
-	"testing",
-	"passed",
-	"failed",
-	"skipped",
-	"dispatch_failed"
-]);
-const UatStatusValue = effect.Schema.Literals([
-	"pending",
-	"testing",
-	"passed",
-	"failed"
-]);
-const MergeStatusValue = effect.Schema.Literals([
-	"pending",
-	"queued",
-	"merging",
-	"verifying",
-	"merged",
-	"failed"
-]);
-const ReleaseStatusValue = effect.Schema.Literals([
-	"pending",
-	"releasing",
-	"passed",
-	"failed",
-	"partial",
-	"rolled_back",
-	"skipped"
-]);
-const VerificationStatusValue = effect.Schema.Literals([
-	"pending",
-	"running",
-	"passed",
-	"failed",
-	"skipped"
-]);
 const KNOWN_HARNESSES = new Set([
 	"claude-code",
 	"ohmypi",
@@ -301,87 +392,6 @@ const AgentSnapshot = effect.Schema.Struct({
 	runtimeSnapshotSequence: effect.Schema.optional(SequenceNumber)
 });
 /** PAN-3151: A recorded cycle in the review convergence tracking series */
-const ReviewCycleEntry = effect.Schema.Struct({
-	cycle: effect.Schema.Number,
-	runId: effect.Schema.String,
-	atCommit: effect.Schema.optional(effect.Schema.String),
-	blockingCount: effect.Schema.Number,
-	recordedAt: effect.Schema.String
-});
-const ReviewStatusSnapshot = effect.Schema.Struct({
-	issueId: IssueId,
-	reviewStatus: effect.Schema.optional(ReviewStatusValue),
-	testStatus: effect.Schema.optional(TestStatusValue),
-	uatStatus: effect.Schema.optional(UatStatusValue),
-	uatNotes: effect.Schema.optional(effect.Schema.String),
-	mergeStatus: effect.Schema.optional(MergeStatusValue),
-	releaseStatus: effect.Schema.optional(ReleaseStatusValue),
-	releaseNotes: effect.Schema.optional(effect.Schema.String),
-	verificationStatus: effect.Schema.optional(VerificationStatusValue),
-	verificationNotes: effect.Schema.optional(effect.Schema.String),
-	verificationCycleCount: effect.Schema.optional(effect.Schema.Number),
-	readyForMerge: effect.Schema.optional(effect.Schema.Boolean),
-	updatedAt: effect.Schema.optional(effect.Schema.String),
-	prUrl: effect.Schema.optional(effect.Schema.String),
-	/** Persistent stuck flag — set by divergence guard, cleared by /unstick */
-	stuck: effect.Schema.optional(effect.Schema.Boolean),
-	stuckReason: effect.Schema.optional(effect.Schema.String),
-	stuckAt: effect.Schema.optional(effect.Schema.String),
-	stuckDetails: effect.Schema.optional(effect.Schema.String),
-	/** PAN-3151: review cycle history for convergence detection */
-	reviewCycleHistory: effect.Schema.optional(effect.Schema.Array(ReviewCycleEntry)),
-	/** Commit SHA at which review passed; deacon uses this to detect new pushes after review */
-	reviewedAtCommit: effect.Schema.optional(effect.Schema.String),
-	/** Commit SHA at which the pre-review verification gate last passed */
-	lastVerifiedCommit: effect.Schema.optional(effect.Schema.String),
-	/** Current merge pipeline step (granular visibility for the merge step tracker) */
-	mergeStep: effect.Schema.optional(effect.Schema.String),
-	/** PAN-699: timestamp when review agents were dispatched */
-	reviewSpawnedAt: effect.Schema.optional(effect.Schema.String),
-	/** PAN-699: number of test-agent dispatch retries */
-	testRetryCount: effect.Schema.optional(effect.Schema.Number),
-	/** PAN-794: parallel-review re-dispatch retry counter (current recovery cycle) */
-	reviewRetryCount: effect.Schema.optional(effect.Schema.Number),
-	/** PAN-796: review auto-requeue count (circuit breaker threshold) */
-	autoRequeueCount: effect.Schema.optional(effect.Schema.Number),
-	/** PAN-794: ISO timestamp marking the start of the current recovery cycle */
-	recoveryStartedAt: effect.Schema.optional(effect.Schema.String),
-	/** Human-requested patrol opt-out — when true, Deacon ignores this issue. */
-	deaconIgnored: effect.Schema.optional(effect.Schema.Boolean),
-	deaconIgnoredAt: effect.Schema.optional(effect.Schema.String),
-	deaconIgnoredReason: effect.Schema.optional(effect.Schema.String),
-	/** PAN-1691: per-issue auto-merge routing key. undefined = project default, true = auto-merge (fast lane), false = hold for UAT. */
-	autoMerge: effect.Schema.optional(effect.Schema.Boolean),
-	/** Active review orchestrator tmux session name (e.g. agent-pan-540-review). */
-	reviewCoordinatorSessionName: effect.Schema.optional(effect.Schema.String),
-	/** Active review sub-role tmux session names (e.g. agent-pan-540-review-correctness). Discovered at emission time. */
-	reviewSessionNames: effect.Schema.optional(effect.Schema.Array(effect.Schema.String)),
-	/** Per-role review completion status (keyed by role: 'correctness' | 'security' | ...) */
-	reviewSubStatuses: effect.Schema.optional(effect.Schema.Record(effect.Schema.String, effect.Schema.Literals(["running", "done"]))),
-	/** PAN-905: queue position in the merge queue */
-	queuePosition: effect.Schema.optional(effect.Schema.Number),
-	/** PAN-905: currently active specialist (e.g. 'merge-agent') */
-	activeSpecialist: effect.Schema.optional(effect.Schema.String),
-	/** PAN-905: number of merge retries attempted */
-	mergeRetryCount: effect.Schema.optional(effect.Schema.Number),
-	/** PAN-905: free-form notes about the merge attempt */
-	mergeNotes: effect.Schema.optional(effect.Schema.String),
-	/** Merge blocker reasons surfaced to operators. */
-	blockerReasons: effect.Schema.optional(effect.Schema.Array(effect.Schema.Struct({
-		type: effect.Schema.Literals([
-			"failing_checks",
-			"merge_conflict",
-			"unresolved_conversations",
-			"changes_requested",
-			"draft_pr",
-			"not_mergeable",
-			"unmerged_sibling_repo"
-		]),
-		summary: effect.Schema.String,
-		details: effect.Schema.optional(effect.Schema.String),
-		detectedAt: effect.Schema.String
-	})))
-});
 const TurnDiffFileChange = effect.Schema.Struct({
 	path: effect.Schema.String,
 	kind: effect.Schema.optional(effect.Schema.String),
@@ -507,7 +517,10 @@ const DashboardSnapshot = effect.Schema.Struct({
 	sequence: SequenceNumber,
 	agents: effect.Schema.Array(AgentSnapshot),
 	specialists: effect.Schema.Array(effect.Schema.Unknown),
-	reviewStatuses: effect.Schema.Array(ReviewStatusSnapshot),
+	/** PAN-3917 FR-6: the derived pipeline state of every known issue. */
+	derivedIssueStates: effect.Schema.Array(DerivedIssueState),
+	/** PAN-3917 FR-12: every live agent pane the terminal backend reports. */
+	backendPanes: effect.Schema.Array(BackendPane),
 	issues: effect.Schema.Array(effect.Schema.Unknown),
 	recentActivity: effect.Schema.optional(effect.Schema.Array(effect.Schema.Unknown)),
 	resources: effect.Schema.optional(effect.Schema.Unknown),
@@ -522,13 +535,6 @@ const DashboardSnapshot = effect.Schema.Struct({
 	restartGate: effect.Schema.optional(RestartGateSnapshot),
 	timestamp: effect.Schema.String
 });
-const WorkspaceDetail = effect.Schema.Struct({
-	workspace: effect.Schema.Unknown,
-	reviewStatus: effect.Schema.Unknown,
-	planning: effect.Schema.Unknown,
-	costs: effect.Schema.Unknown,
-	agentOutput: effect.Schema.Array(effect.Schema.String)
-});
 const ResourceStats = effect.Schema.Struct({ containers: effect.Schema.Array(effect.Schema.Struct({
 	name: effect.Schema.String,
 	cpu: effect.Schema.optional(effect.Schema.String),
@@ -613,14 +619,6 @@ const SessionNode = effect.Schema.Struct({
 		"tmux",
 		"supervisor"
 	])),
-	paused: effect.Schema.optional(effect.Schema.Boolean),
-	pausedReason: effect.Schema.optional(effect.Schema.String),
-	pausedAt: effect.Schema.optional(effect.Schema.String),
-	troubled: effect.Schema.optional(effect.Schema.Boolean),
-	troubledAt: effect.Schema.optional(effect.Schema.String),
-	troubledReason: effect.Schema.optional(effect.Schema.String),
-	consecutiveFailures: effect.Schema.optional(effect.Schema.Number),
-	queuedMailCount: effect.Schema.optional(effect.Schema.Number),
 	modelOrigin: effect.Schema.optional(ModelOrigin)
 });
 const FeatureNode = effect.Schema.Struct({
@@ -1760,16 +1758,32 @@ const PlanItemsUnblockedEvent = effect.Schema.Struct({
 		items: effect.Schema.Array(effect.Schema.String)
 	})
 });
-/** Replaces socket.io `pipeline:status` */
-const PipelineStatusChangedEvent = effect.Schema.Struct({
-	type: effect.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 = effect.Schema.Struct({
+	type: effect.Schema.Literal("issue_state.changed"),
 	sequence: SequenceNumber,
 	timestamp: effect.Schema.String,
-	payload: effect.Schema.Struct({
-		issueId: IssueId,
-		workspaceId: effect.Schema.optional(effect.Schema.String),
-		status: ReviewStatusSnapshot
-	})
+	payload: effect.Schema.Struct({ issueState: DerivedIssueState })
+});
+/** PAN-3917 FR-12 — a live agent pane appeared or changed. `emitOnly`. */
+const BackendPaneChangedEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("backend_pane.changed"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: effect.Schema.Struct({ pane: BackendPane })
+});
+/** PAN-3917 FR-12 — a pane left the backend inventory. `emitOnly`. */
+const BackendPaneRemovedEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("backend_pane.removed"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: effect.Schema.Struct({ paneId: effect.Schema.String })
 });
 /** Replaces socket.io `merge:ready` */
 const MergeReadyEvent = effect.Schema.Struct({
@@ -1781,17 +1795,6 @@ const MergeReadyEvent = effect.Schema.Struct({
 		workspaceId: effect.Schema.optional(effect.Schema.String)
 	})
 });
-/** New — review status changed */
-const ReviewStatusChangedEvent = effect.Schema.Struct({
-	type: effect.Schema.Literal("review.status_changed"),
-	sequence: SequenceNumber,
-	timestamp: effect.Schema.String,
-	payload: effect.Schema.Struct({
-		issueId: IssueId,
-		workspaceId: effect.Schema.optional(effect.Schema.String),
-		status: ReviewStatusSnapshot
-	})
-});
 /** New — review specialist dispatched */
 const PipelineReviewStartedEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("pipeline.review-started"),
@@ -2630,9 +2633,10 @@ const DomainEvent = effect.Schema.Union([
 	PlanItemStatusChangedEvent,
 	PlanSubitemStatusChangedEvent,
 	PlanItemsUnblockedEvent,
-	PipelineStatusChangedEvent,
+	IssueStateChangedEvent,
+	BackendPaneChangedEvent,
+	BackendPaneRemovedEvent,
 	MergeReadyEvent,
-	ReviewStatusChangedEvent,
 	PipelineReviewStartedEvent,
 	PipelineReviewCompletedEvent,
 	PipelineTestStartedEvent,
@@ -2862,248 +2866,66 @@ const OpenInEditorInput = effect.Schema.Struct({
 	editor: EditorIdSchema
 });
 //#endregion
-//#region src/flywheel.ts
-const FlywheelRunId = effect.Schema.String.check(effect.Schema.isPattern(/^RUN-\d+$/));
-const FlywheelHttpUrl = effect.Schema.String.check(effect.Schema.isPattern(/^https?:\/\/\S+$/i));
-const FlywheelHarness = effect.Schema.Literals([
-	"claude-code",
-	"pi",
-	"ohmypi",
-	"codex",
-	"acp",
-	"kimi-code",
-	"opencode",
-	"muse"
-]);
-const FlywheelEffort = effect.Schema.Literals([
-	"low",
-	"medium",
-	"high",
-	"xhigh",
-	"max"
-]);
-const FlywheelOrchestrator = effect.Schema.Struct({
-	harness: FlywheelHarness,
-	model: effect.Schema.String,
-	effort: FlywheelEffort,
-	ctxPercent: effect.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 effect.Schema.TaggedErrorClass()("PanRpcError", {
+	message: effect.Schema.String,
+	code: effect.Schema.optional(effect.Schema.String)
+}) {};
+const TerminalOutput = effect.Schema.Struct({
+	sessionName: effect.Schema.String,
+	data: effect.Schema.String
 });
-const FlywheelScope = effect.Schema.Literals(["pan-only", "all-tracked-projects"]);
-const FlywheelHeadline = effect.Schema.Struct({
-	bugsFixed: effect.Schema.Number,
-	swarmItemsMerged: effect.Schema.Number,
-	swarmItemsTotal: effect.Schema.Number,
-	prsMerged: effect.Schema.Number,
-	awaitingUat: effect.Schema.Number
+const AgentOutput = effect.Schema.Struct({
+	agentId: effect.Schema.String,
+	line: effect.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 = effect.Schema.Literals([
-	"planning",
-	"working",
-	"reviewing",
-	"testing",
-	"shipping",
-	"merging",
-	"blocked",
-	"parked"
-]);
-const FlywheelPipelineStatus = effect.Schema.Literals([
-	"queued",
-	"running",
-	"blocked",
-	"passed",
-	"failed",
-	"merged",
-	"parked"
-]);
-const FlywheelPipelineItem = effect.Schema.Struct({
-	issueId: effect.Schema.String,
-	title: effect.Schema.String,
-	verb: FlywheelPipelineVerb,
-	status: FlywheelPipelineStatus,
-	progressPercent: effect.Schema.optional(effect.Schema.Number),
-	agentId: effect.Schema.optional(effect.Schema.String),
-	pr: effect.Schema.optional(effect.Schema.Number),
-	mergeOrder: effect.Schema.optional(effect.Schema.Number),
-	conflictsWith: effect.Schema.optional(effect.Schema.Array(effect.Schema.String))
-});
-const FlywheelSubstrateBugStatus = effect.Schema.Literals([
-	"filed",
-	"fixed",
-	"workaround"
-]);
-const FlywheelSubstrateBug = effect.Schema.Struct({
-	issueId: effect.Schema.String,
-	title: effect.Schema.String,
-	status: FlywheelSubstrateBugStatus,
-	commitSha: effect.Schema.optional(effect.Schema.String),
-	url: effect.Schema.optional(FlywheelHttpUrl)
-});
-const FlywheelAgentStatus = effect.Schema.Literals([
-	"starting",
-	"running",
-	"waiting",
-	"idle",
-	"stopped",
-	"error"
-]);
-const FlywheelAgent = effect.Schema.Struct({
-	id: effect.Schema.String,
-	label: effect.Schema.String,
-	status: FlywheelAgentStatus,
-	issueId: effect.Schema.optional(effect.Schema.String),
-	role: effect.Schema.optional(effect.Schema.String),
-	model: effect.Schema.optional(effect.Schema.String),
-	ctxPercent: effect.Schema.optional(effect.Schema.Number),
-	currentAction: effect.Schema.optional(effect.Schema.String)
-});
-const FlywheelParkedItem = effect.Schema.Struct({
-	issueId: effect.Schema.String,
-	title: effect.Schema.String,
-	reason: effect.Schema.String,
-	parkedAt: effect.Schema.optional(effect.Schema.String)
-});
-const FlywheelSuggestionAction = effect.Schema.Literals([
-	"start",
-	"resume",
-	"plan",
-	"review",
-	"merge",
-	"unblock",
-	"park",
-	"investigate",
-	"wait"
-]);
-const FlywheelSuggestionPriority = effect.Schema.Literals([
-	"urgent",
-	"high",
-	"medium",
-	"low"
-]);
-const FlywheelSuggestion = effect.Schema.Struct({
-	action: FlywheelSuggestionAction,
-	issueId: effect.Schema.optional(effect.Schema.String),
-	rationale: effect.Schema.String,
-	priority: FlywheelSuggestionPriority,
-	filedBy: effect.Schema.optional(effect.Schema.Literals(["agent", "operator"])),
-	weight: effect.Schema.optional(effect.Schema.Number),
-	weightReason: effect.Schema.optional(effect.Schema.String)
-});
-const FlywheelSystemStatus = effect.Schema.Struct({
-	mainHead: effect.Schema.String,
-	ramUsedMb: effect.Schema.Number,
-	ramTotalMb: effect.Schema.Number,
-	swapUsedMb: effect.Schema.Number,
-	swapTotalMb: effect.Schema.Number,
-	agentsActive: effect.Schema.Number,
-	agentsCap: effect.Schema.Number
-});
-const FlywheelOrders = effect.Schema.Struct({
-	bookId: effect.Schema.String,
-	bookName: effect.Schema.String,
-	landed: effect.Schema.Number,
-	total: effect.Schema.Number,
-	laneAInFlight: effect.Schema.Array(effect.Schema.String),
-	laneBInFlight: effect.Schema.optional(effect.Schema.String),
-	drained: effect.Schema.Boolean
-});
-const FlywheelStatus = effect.Schema.Struct({
-	runId: FlywheelRunId,
-	startedAt: effect.Schema.String,
-	elapsedMs: effect.Schema.Number,
-	orchestrator: FlywheelOrchestrator,
-	headline: FlywheelHeadline,
-	activePipeline: effect.Schema.Array(FlywheelPipelineItem),
-	substrateBugs: effect.Schema.Array(FlywheelSubstrateBug),
-	agents: effect.Schema.Array(FlywheelAgent),
-	parked: effect.Schema.Array(FlywheelParkedItem),
-	suggestions: effect.Schema.Array(FlywheelSuggestion).pipe(effect.Schema.withDecodingDefaultKey(effect.Effect.succeed([]))),
-	system: FlywheelSystemStatus,
-	openQuestions: effect.Schema.Array(effect.Schema.String),
-	orders: effect.Schema.optional(FlywheelOrders),
-	scope: effect.Schema.optional(FlywheelScope),
-	ticks: effect.Schema.Number,
-	lastTickAt: effect.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 effect.Schema.TaggedErrorClass()("PanRpcError", {
-	message: effect.Schema.String,
-	code: effect.Schema.optional(effect.Schema.String)
-}) {};
-const TerminalOutput = effect.Schema.Struct({
-	sessionName: effect.Schema.String,
-	data: effect.Schema.String
-});
-const AgentOutput = effect.Schema.Struct({
-	agentId: effect.Schema.String,
-	line: effect.Schema.String
-});
-const ProposedPlan = effect.Schema.Struct({
-	id: effect.Schema.String,
-	plan: effect.Schema.String,
-	planFilePath: effect.Schema.optional(effect.Schema.String),
-	status: effect.Schema.Literals([
-		"pending",
-		"approved",
-		"rejected"
-	]),
-	createdAt: effect.Schema.String,
-	resolvedAt: effect.Schema.optional(effect.Schema.String)
+const ProposedPlan = effect.Schema.Struct({
+	id: effect.Schema.String,
+	plan: effect.Schema.String,
+	planFilePath: effect.Schema.optional(effect.Schema.String),
+	status: effect.Schema.Literals([
+		"pending",
+		"approved",
+		"rejected"
+	]),
+	createdAt: effect.Schema.String,
+	resolvedAt: effect.Schema.optional(effect.Schema.String)
 });
 const CompactBoundary = effect.Schema.Struct({
 	id: effect.Schema.String,
@@ -3305,12 +3127,6 @@ const TerminalCloseRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.terminalClose,
 	payload: effect.Schema.Struct({ sessionName: effect.Schema.String }),
 	error: PanRpcError
 });
-/** 10. Get batched workspace detail (unary) — replaces 5 separate HTTP calls */
-const GetWorkspaceDetailRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.getWorkspaceDetail, {
-	payload: effect.Schema.Struct({ issueId: IssueId }),
-	success: WorkspaceDetail,
-	error: PanRpcError
-});
 const ReadWorkspaceFileInput = effect.Schema.Struct({
 	issueId: IssueId,
 	relativePath: effect.Schema.String,
@@ -3457,13 +3273,6 @@ const SubscribeProjectSessionTreeRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.s
 	error: PanRpcError,
 	stream: true
 });
-/** 18. Subscribe to latest Flywheel status snapshots (stream) */
-const SubscribeFlywheelStatusRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.subscribeFlywheelStatus, {
-	payload: effect.Schema.Struct({}),
-	success: effect.Schema.NullOr(FlywheelStatus),
-	error: PanRpcError,
-	stream: true
-});
 /** 19. Open a workspace in an editor (PAN-966) */
 const ShellOpenInEditorRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.shellOpenInEditor, {
 	payload: OpenInEditorInput,
@@ -3641,7 +3450,7 @@ const GetConversationStatsRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.getConve
 	error: PanRpcError
 });
 /** All Overdeck WebSocket RPC methods */
-const PanRpcGroup = effect_unstable_rpc_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 = effect_unstable_rpc_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) {
@@ -3666,7 +3475,8 @@ const INITIAL_READ_MODEL_STATE = {
 	sequence: 0,
 	agentsById: {},
 	agentRuntimeById: {},
-	reviewStatusByIssueId: {},
+	derivedIssueStateByIssueId: {},
+	backendPanesById: {},
 	resources: null,
 	agentOutputById: {},
 	issuesRaw: [],
@@ -3783,8 +3593,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 ?? []) {
@@ -3800,7 +3612,8 @@ function syncSnapshot(state, snapshot) {
 		...state,
 		sequence: snapshot.sequence,
 		agentsById,
-		reviewStatusByIssueId,
+		derivedIssueStateByIssueId,
+		backendPanesById,
 		agentRuntimeById: snapshot.agentRuntimeById ?? state.agentRuntimeById,
 		channelPermissionRequestsById,
 		channelPermissionRequestIdsByAgentId,
@@ -3890,7 +3703,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 ? {
@@ -3919,7 +3741,7 @@ function applyEvent(state, event) {
 			return {
 				...state,
 				sequence: Math.max(state.sequence, event.sequence),
-				agentsById: rest,
+				agentsById: nextAgentsById,
 				agentRuntimeById: nextRuntimeById,
 				channelPermissionRequestsById: nextPermissionRequestsById,
 				channelPermissionRequestIdsByAgentId: restPendingIds,
@@ -4064,85 +3886,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":
@@ -5127,49 +4899,229 @@ function deriveProjectCi(record) {
 	};
 }
 //#endregion
-//#region src/flywheel-stats.ts
-const FlywheelStatsCriterionStatus = effect.Schema.Literals([
-	"green",
-	"yellow",
-	"red",
-	"insufficient_data"
+//#region src/flywheel.ts
+const FlywheelRunId = effect.Schema.String.check(effect.Schema.isPattern(/^RUN-\d+$/));
+const FlywheelHttpUrl = effect.Schema.String.check(effect.Schema.isPattern(/^https?:\/\/\S+$/i));
+const FlywheelHarness = effect.Schema.Literals([
+	"claude-code",
+	"pi",
+	"ohmypi",
+	"codex",
+	"acp",
+	"kimi-code",
+	"opencode",
+	"muse"
 ]);
-const FlywheelStatsTrend = effect.Schema.Literals([
-	"up",
-	"down",
-	"flat"
+const FlywheelEffort = effect.Schema.Literals([
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max"
 ]);
-const FlywheelStatsCriterionValueObject = effect.Schema.Record(effect.Schema.String, effect.Schema.Json);
-const FlywheelStatsCriterionValue = effect.Schema.Union([effect.Schema.Number, FlywheelStatsCriterionValueObject]);
-const FlywheelStatsCriterion = effect.Schema.Struct({
-	label: effect.Schema.String,
-	value: FlywheelStatsCriterionValue,
-	target: FlywheelStatsCriterionValue,
-	status: FlywheelStatsCriterionStatus,
-	trend: effect.Schema.optional(FlywheelStatsTrend),
-	sampleSize: effect.Schema.Number,
-	dataSufficient: effect.Schema.Boolean
-});
-const FlywheelStatsCriteria = effect.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 = effect.Schema.Struct({
+	harness: FlywheelHarness,
+	model: effect.Schema.String,
+	effort: FlywheelEffort,
+	ctxPercent: effect.Schema.Number
 });
-const FlywheelStats = effect.Schema.Struct({
-	window: effect.Schema.String,
-	generatedAt: effect.Schema.String,
-	criteria: FlywheelStatsCriteria
+const FlywheelScope = effect.Schema.Literals(["pan-only", "all-tracked-projects"]);
+const FlywheelHeadline = effect.Schema.Struct({
+	bugsFixed: effect.Schema.Number,
+	swarmItemsMerged: effect.Schema.Number,
+	swarmItemsTotal: effect.Schema.Number,
+	prsMerged: effect.Schema.Number,
+	awaitingUat: effect.Schema.Number
 });
-const decodeFlywheelStats = effect.Schema.decodeUnknownSync(FlywheelStats);
-const encodeFlywheelStats = effect.Schema.encodeSync(FlywheelStats);
-//#endregion
-//#region src/orders.ts
-const OrderBookLane = effect.Schema.Literals(["A", "B"]);
-const OrderBookStatus = effect.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 = effect.Schema.Literals([
+	"planning",
+	"working",
+	"reviewing",
+	"testing",
+	"shipping",
+	"merging",
+	"blocked",
+	"parked"
+]);
+const FlywheelPipelineStatus = effect.Schema.Literals([
+	"queued",
+	"running",
+	"blocked",
+	"passed",
+	"failed",
+	"merged",
+	"parked"
+]);
+const FlywheelPipelineItem = effect.Schema.Struct({
+	issueId: effect.Schema.String,
+	title: effect.Schema.String,
+	verb: FlywheelPipelineVerb,
+	status: FlywheelPipelineStatus,
+	progressPercent: effect.Schema.optional(effect.Schema.Number),
+	agentId: effect.Schema.optional(effect.Schema.String),
+	pr: effect.Schema.optional(effect.Schema.Number),
+	mergeOrder: effect.Schema.optional(effect.Schema.Number),
+	conflictsWith: effect.Schema.optional(effect.Schema.Array(effect.Schema.String))
+});
+const FlywheelSubstrateBugStatus = effect.Schema.Literals([
+	"filed",
+	"fixed",
+	"workaround"
+]);
+const FlywheelSubstrateBug = effect.Schema.Struct({
+	issueId: effect.Schema.String,
+	title: effect.Schema.String,
+	status: FlywheelSubstrateBugStatus,
+	commitSha: effect.Schema.optional(effect.Schema.String),
+	url: effect.Schema.optional(FlywheelHttpUrl)
+});
+const FlywheelAgentStatus = effect.Schema.Literals([
+	"starting",
+	"running",
+	"waiting",
+	"idle",
+	"stopped",
+	"error"
+]);
+const FlywheelAgent = effect.Schema.Struct({
+	id: effect.Schema.String,
+	label: effect.Schema.String,
+	status: FlywheelAgentStatus,
+	issueId: effect.Schema.optional(effect.Schema.String),
+	role: effect.Schema.optional(effect.Schema.String),
+	model: effect.Schema.optional(effect.Schema.String),
+	ctxPercent: effect.Schema.optional(effect.Schema.Number),
+	currentAction: effect.Schema.optional(effect.Schema.String)
+});
+const FlywheelParkedItem = effect.Schema.Struct({
+	issueId: effect.Schema.String,
+	title: effect.Schema.String,
+	reason: effect.Schema.String,
+	parkedAt: effect.Schema.optional(effect.Schema.String)
+});
+const FlywheelSuggestionAction = effect.Schema.Literals([
+	"start",
+	"resume",
+	"plan",
+	"review",
+	"merge",
+	"unblock",
+	"park",
+	"investigate",
+	"wait"
+]);
+const FlywheelSuggestionPriority = effect.Schema.Literals([
+	"urgent",
+	"high",
+	"medium",
+	"low"
+]);
+const FlywheelSuggestion = effect.Schema.Struct({
+	action: FlywheelSuggestionAction,
+	issueId: effect.Schema.optional(effect.Schema.String),
+	rationale: effect.Schema.String,
+	priority: FlywheelSuggestionPriority,
+	filedBy: effect.Schema.optional(effect.Schema.Literals(["agent", "operator"])),
+	weight: effect.Schema.optional(effect.Schema.Number),
+	weightReason: effect.Schema.optional(effect.Schema.String)
+});
+const FlywheelSystemStatus = effect.Schema.Struct({
+	mainHead: effect.Schema.String,
+	ramUsedMb: effect.Schema.Number,
+	ramTotalMb: effect.Schema.Number,
+	swapUsedMb: effect.Schema.Number,
+	swapTotalMb: effect.Schema.Number,
+	agentsActive: effect.Schema.Number,
+	agentsCap: effect.Schema.Number
+});
+const FlywheelOrders = effect.Schema.Struct({
+	bookId: effect.Schema.String,
+	bookName: effect.Schema.String,
+	landed: effect.Schema.Number,
+	total: effect.Schema.Number,
+	laneAInFlight: effect.Schema.Array(effect.Schema.String),
+	laneBInFlight: effect.Schema.optional(effect.Schema.String),
+	drained: effect.Schema.Boolean
+});
+const FlywheelStatus = effect.Schema.Struct({
+	runId: FlywheelRunId,
+	startedAt: effect.Schema.String,
+	elapsedMs: effect.Schema.Number,
+	orchestrator: FlywheelOrchestrator,
+	headline: FlywheelHeadline,
+	activePipeline: effect.Schema.Array(FlywheelPipelineItem),
+	substrateBugs: effect.Schema.Array(FlywheelSubstrateBug),
+	agents: effect.Schema.Array(FlywheelAgent),
+	parked: effect.Schema.Array(FlywheelParkedItem),
+	suggestions: effect.Schema.Array(FlywheelSuggestion).pipe(effect.Schema.withDecodingDefaultKey(effect.Effect.succeed([]))),
+	system: FlywheelSystemStatus,
+	openQuestions: effect.Schema.Array(effect.Schema.String),
+	orders: effect.Schema.optional(FlywheelOrders),
+	scope: effect.Schema.optional(FlywheelScope),
+	ticks: effect.Schema.Number,
+	lastTickAt: effect.Schema.String
+});
+//#endregion
+//#region src/flywheel-stats.ts
+const FlywheelStatsCriterionStatus = effect.Schema.Literals([
+	"green",
+	"yellow",
+	"red",
+	"insufficient_data"
+]);
+const FlywheelStatsTrend = effect.Schema.Literals([
+	"up",
+	"down",
+	"flat"
+]);
+const FlywheelStatsCriterionValueObject = effect.Schema.Record(effect.Schema.String, effect.Schema.Json);
+const FlywheelStatsCriterionValue = effect.Schema.Union([effect.Schema.Number, FlywheelStatsCriterionValueObject]);
+const FlywheelStatsCriterion = effect.Schema.Struct({
+	label: effect.Schema.String,
+	value: FlywheelStatsCriterionValue,
+	target: FlywheelStatsCriterionValue,
+	status: FlywheelStatsCriterionStatus,
+	trend: effect.Schema.optional(FlywheelStatsTrend),
+	sampleSize: effect.Schema.Number,
+	dataSufficient: effect.Schema.Boolean
+});
+const FlywheelStatsCriteria = effect.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 = effect.Schema.Struct({
+	window: effect.Schema.String,
+	generatedAt: effect.Schema.String,
+	criteria: FlywheelStatsCriteria
+});
+const decodeFlywheelStats = effect.Schema.decodeUnknownSync(FlywheelStats);
+const encodeFlywheelStats = effect.Schema.encodeSync(FlywheelStats);
+//#endregion
+//#region src/orders.ts
+const OrderBookLane = effect.Schema.Literals(["A", "B"]);
+const OrderBookStatus = effect.Schema.Literals([
 	"draft",
 	"ready",
 	"running",
@@ -5518,6 +5470,18 @@ const FeatureRegistryEntry = effect.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: [
@@ -5909,6 +5873,7 @@ const TELEMETRY_PROPERTY_DOMAINS = {
 		"sessions",
 		"awaiting-merge",
 		"workspace-new",
+		"project-new",
 		"workspace"
 	],
 	decision_subject: ["agent", "conversation"],
@@ -5951,7 +5916,11 @@ const TELEMETRY_PROPERTY_DOMAINS = {
 		"merged",
 		"closed_out"
 	],
-	project_mode: ["existing", "new"]
+	project_mode: [
+		"clone",
+		"existing",
+		"new"
+	]
 };
 const TELEMETRY_EVENT_CATALOG = {
 	dashboard_tab_viewed: { tab: "dashboard_tab" },
@@ -6271,12 +6240,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",
@@ -6291,19 +6254,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",
@@ -6355,32 +6312,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"],
@@ -6400,39 +6337,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"],
@@ -6447,24 +6351,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"],
@@ -6493,23 +6379,13 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"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"
 	},
@@ -6527,7 +6403,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,
@@ -6542,21 +6418,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"],
@@ -6768,25 +6629,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"],
@@ -6834,34 +6676,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"],
@@ -7105,13 +6919,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
 			}
@@ -7119,20 +6927,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"],
@@ -7181,27 +6975,36 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Lifecycle"
 	},
-	{
-		"id": "pan-destroy",
-		"path": ["destroy"],
-		"display": "/pan destroy",
-		"description": "Alias for workspace destroy: remove the issue workspace worktree and branch",
-		"args": [{
-			"name": "id",
-			"required": true,
-			"variadic": false
-		}],
-		"options": [{
-			"flags": "--force",
-			"description": "Force removal even with uncommitted changes",
-			"required": false,
-			"valueHint": null
-		}, {
-			"flags": "--project <path>",
-			"description": "Explicit project path (overrides registry)",
+	{
+		"id": "pan-destroy",
+		"path": ["destroy"],
+		"display": "/pan destroy",
+		"description": "Alias for workspace destroy: remove the issue workspace worktree and branch",
+		"args": [{
+			"name": "id",
 			"required": true,
-			"valueHint": "path"
+			"variadic": false
 		}],
+		"options": [
+			{
+				"flags": "--force",
+				"description": "Force removal even with uncommitted changes",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--project <path>",
+				"description": "Explicit project path (overrides registry)",
+				"required": true,
+				"valueHint": "path"
+			},
+			{
+				"flags": "--shape <shape>",
+				"description": "Limit to one shape: base|strike|slot|all (default: all)",
+				"required": true,
+				"valueHint": "shape"
+			}
+		],
 		"aliases": [],
 		"category": "Workspace"
 	},
@@ -7305,25 +7108,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"
 			},
@@ -7351,18 +7136,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)",
@@ -7418,8 +7191,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
 			}
@@ -7431,7 +7204,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,
@@ -7466,20 +7239,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"],
@@ -7746,7 +7505,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": [],
@@ -7808,32 +7567,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"
 	},
@@ -7841,7 +7580,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,
@@ -7851,32 +7590,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"
 	},
@@ -7894,32 +7613,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"
 	},
@@ -7937,32 +7636,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"
 	},
@@ -7980,32 +7659,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"
 	},
@@ -8023,32 +7682,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"
 	},
@@ -8238,6 +7877,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"description": "Include archived workspaces (only applies with --kind)",
 				"required": false,
 				"valueHint": null
+			},
+			{
+				"flags": "--stale",
+				"description": "Show reclaim candidates: merged branches still on disk, with sizes",
+				"required": false,
+				"valueHint": null
 			}
 		],
 		"aliases": [],
@@ -8247,7 +7892,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-workspace-destroy",
 		"path": ["workspace", "destroy"],
 		"display": "/pan workspace destroy",
-		"description": "Destroy workspace",
+		"description": "Destroy workspace (all shapes by default: base, strike, and slot worktrees)",
 		"args": [{
 			"name": "issueId",
 			"required": true,
@@ -8266,6 +7911,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": true,
 				"valueHint": "path"
 			},
+			{
+				"flags": "--shape <shape>",
+				"description": "Limit to one shape: base|strike|slot|all (default: all)",
+				"required": true,
+				"valueHint": "shape"
+			},
 			{
 				"flags": "--purge-memory",
 				"description": "Also permanently delete the workspace's memory home (irreversible)",
@@ -8983,7 +8634,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,
@@ -9853,47 +9504,18 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Flywheel"
 	},
-	{
-		"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",
-		"args": [],
-		"options": [{
-			"flags": "--json",
-			"description": "Print the raw parked rows as JSON",
-			"required": false,
-			"valueHint": null
-		}],
-		"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
-			}
-		],
+	{
+		"id": "pan-parked",
+		"path": ["parked"],
+		"display": "/pan parked",
+		"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",
+			"description": "Print the raw parked rows as JSON",
+			"required": false,
+			"valueHint": null
+		}],
 		"aliases": [],
 		"category": "CLI"
 	},
@@ -10017,32 +9639,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
 		}],
@@ -10050,91 +9658,79 @@ 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",
+		"id": "pan-admin-agents",
+		"path": ["admin", "agents"],
+		"display": "/pan admin agents",
+		"description": "Agent state plumbing",
 		"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.",
+		"id": "pan-admin-agents-exited",
+		"path": [
+			"admin",
+			"agents",
+			"exited"
+		],
+		"display": "/pan admin agents exited",
+		"description": "Record that an agent process exited (reported by its launcher; PAN-3848)",
 		"args": [{
-			"name": "issue-id",
-			"required": false,
+			"name": "agentId",
+			"required": true,
 			"variadic": false
 		}],
 		"options": [{
-			"flags": "--local",
-			"description": "Seed the current (container-local) OVERDECK_HOME directly, without a host wrapper step",
-			"required": false,
-			"valueHint": null
+			"flags": "--code <n>",
+			"description": "Process exit code",
+			"required": true,
+			"valueHint": "n"
 		}],
 		"aliases": [],
 		"category": "Admin"
@@ -10210,53 +9806,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"],
@@ -10345,7 +9894,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,
@@ -10362,12 +9911,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",
@@ -10731,30 +10274,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"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",
-			"required": false,
-			"valueHint": null
-		}],
-		"aliases": [],
-		"category": "Admin"
-	},
 	{
 		"id": "pan-admin-db-rebuild-workspaces",
 		"path": [
@@ -10817,105 +10336,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"],
@@ -11754,47 +11174,20 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"valueHint": null
 			},
 			{
-				"flags": "--skip-tts-daemon",
-				"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-tts-daemon",
+				"description": "Skip Qwen TTS daemon venv install (CUDA torch download is large)",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"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",
@@ -11950,111 +11343,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"
 	},
@@ -12062,107 +11430,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"],
@@ -12743,11 +12021,75 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"description": "Rally project OID (e.g., /project/822404704163)",
 				"required": true,
 				"valueHint": "oid"
+			},
+			{
+				"flags": "--dry-run",
+				"description": "Validate without creating (resolve-before-create pattern)",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Project"
+	},
+	{
+		"id": "pan-project-clone",
+		"path": ["project", "clone"],
+		"display": "/pan project clone",
+		"description": "Clone a GitHub or GitLab repository and register it as a project",
+		"args": [{
+			"name": "url",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [
+			{
+				"flags": "--parent <dir>",
+				"description": "Parent directory (default: ~/Projects)",
+				"required": true,
+				"valueHint": "dir"
+			},
+			{
+				"flags": "--name <name>",
+				"description": "Project name (default: repository name)",
+				"required": true,
+				"valueHint": "name"
+			},
+			{
+				"flags": "--issue-prefix <prefix>",
+				"description": "Issue prefix (default: derived from the name)",
+				"required": true,
+				"valueHint": "prefix"
+			},
+			{
+				"flags": "--dry-run",
+				"description": "Print the resolved intent as JSON and create nothing",
+				"required": false,
+				"valueHint": null
 			}
 		],
 		"aliases": [],
 		"category": "Project"
 	},
+	{
+		"id": "pan-project-finish-setup",
+		"path": ["project", "finish-setup"],
+		"display": "/pan project finish-setup",
+		"description": "Finish setup for a registered project whose creation did not complete",
+		"args": [{
+			"name": "key",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--path <path>",
+			"description": "Expected project path; refuses if it does not match the registration",
+			"required": true,
+			"valueHint": "path"
+		}],
+		"aliases": [],
+		"category": "Project"
+	},
 	{
 		"id": "pan-project-list",
 		"path": ["project", "list"],
@@ -12887,11 +12229,75 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"description": "Rally project OID (e.g., /project/822404704163)",
 				"required": true,
 				"valueHint": "oid"
+			},
+			{
+				"flags": "--dry-run",
+				"description": "Validate without creating (resolve-before-create pattern)",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Project"
+	},
+	{
+		"id": "pan-projects-clone",
+		"path": ["projects", "clone"],
+		"display": "/pan projects clone",
+		"description": "Clone a GitHub or GitLab repository and register it as a project",
+		"args": [{
+			"name": "url",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [
+			{
+				"flags": "--parent <dir>",
+				"description": "Parent directory (default: ~/Projects)",
+				"required": true,
+				"valueHint": "dir"
+			},
+			{
+				"flags": "--name <name>",
+				"description": "Project name (default: repository name)",
+				"required": true,
+				"valueHint": "name"
+			},
+			{
+				"flags": "--issue-prefix <prefix>",
+				"description": "Issue prefix (default: derived from the name)",
+				"required": true,
+				"valueHint": "prefix"
+			},
+			{
+				"flags": "--dry-run",
+				"description": "Print the resolved intent as JSON and create nothing",
+				"required": false,
+				"valueHint": null
 			}
 		],
 		"aliases": [],
 		"category": "Project"
 	},
+	{
+		"id": "pan-projects-finish-setup",
+		"path": ["projects", "finish-setup"],
+		"display": "/pan projects finish-setup",
+		"description": "Finish setup for a registered project whose creation did not complete",
+		"args": [{
+			"name": "key",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--path <path>",
+			"description": "Expected project path; refuses if it does not match the registration",
+			"required": true,
+			"valueHint": "path"
+		}],
+		"aliases": [],
+		"category": "Project"
+	},
 	{
 		"id": "pan-projects-list",
 		"path": ["projects", "list"],
@@ -13355,14 +12761,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"],
@@ -13497,7 +12895,26 @@ 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
+//#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
 exports.ACP_BEHAVIOR = ACP_BEHAVIOR;
+exports.AGENT_ROLES = AGENT_ROLES;
 exports.Activity = Activity;
 exports.ActivityDetailedEvent = ActivityDetailedEvent;
 exports.ActivityEntryEvent = ActivityEntryEvent;
@@ -13556,6 +12973,9 @@ exports.ArtifactUrls = ArtifactUrls;
 exports.ArtifactValidationCode = ArtifactValidationCode;
 exports.ArtifactValidationFinding = ArtifactValidationFinding;
 exports.ArtifactValidationResult = ArtifactValidationResult;
+exports.BackendPane = BackendPane;
+exports.BackendPaneChangedEvent = BackendPaneChangedEvent;
+exports.BackendPaneRemovedEvent = BackendPaneRemovedEvent;
 exports.BeadsFreshnessChangedEvent = BeadsFreshnessChangedEvent;
 exports.CHANNEL_REPLY_KIND_VALUES = CHANNEL_REPLY_KIND_VALUES;
 exports.CLAUDE_CODE_BEHAVIOR = CLAUDE_CODE_BEHAVIOR;
@@ -13607,6 +13027,9 @@ exports.DashboardLifecycleStartedEvent = DashboardLifecycleStartedEvent;
 exports.DashboardSnapshot = DashboardSnapshot;
 exports.DeepWipeRpc = DeepWipeRpc;
 exports.DeployStalenessSnapshot = DeployStalenessSnapshot;
+exports.DerivedBranchState = DerivedBranchState;
+exports.DerivedIssueState = DerivedIssueState;
+exports.DerivedPrState = DerivedPrState;
 exports.DiscoveredSessionSnapshot = DiscoveredSessionSnapshot;
 exports.DomainEvent = DomainEvent;
 exports.EDITORS = EDITORS;
@@ -13659,7 +13082,6 @@ exports.GetConversationStatsRpc = GetConversationStatsRpc;
 exports.GetDiscoveredSessionRpc = GetDiscoveredSessionRpc;
 exports.GetSessionsFeedFacetsRpc = GetSessionsFeedFacetsRpc;
 exports.GetSnapshotRpc = GetSnapshotRpc;
-exports.GetWorkspaceDetailRpc = GetWorkspaceDetailRpc;
 exports.GlobalContextLayerRecord = GlobalContextLayerRecord;
 exports.GlobalContextLayerTarget = GlobalContextLayerTarget;
 exports.HOOK_INVENTORY = HOOK_INVENTORY;
@@ -13671,7 +13093,13 @@ exports.HygieneFinding = HygieneFinding;
 exports.HygienePullRequest = HygienePullRequest;
 exports.HygieneReport = HygieneReport;
 exports.INITIAL_READ_MODEL_STATE = INITIAL_READ_MODEL_STATE;
+exports.ISSUE_ATTENTIONS = ISSUE_ATTENTIONS;
+exports.ISSUE_STATES = ISSUE_STATES;
+exports.ISSUE_STATE_PRECEDENCE = ISSUE_STATE_PRECEDENCE;
+exports.IssueAttention = IssueAttention;
 exports.IssueId = IssueId;
+exports.IssueState = IssueState;
+exports.IssueStateChangedEvent = IssueStateChangedEvent;
 exports.IssueStatusChangedEvent = IssueStatusChangedEvent;
 exports.IssueTransitionedEvent = IssueTransitionedEvent;
 exports.IssuesDeltaEvent = IssuesDeltaEvent;
@@ -13705,7 +13133,6 @@ exports.MemoryStatusPhase = MemoryStatusPhase;
 exports.MemoryStatusUpdatedEvent = MemoryStatusUpdatedEvent;
 exports.MemoryTokenUsage = MemoryTokenUsage;
 exports.MergeReadyEvent = MergeReadyEvent;
-exports.MergeStatusValue = MergeStatusValue;
 exports.ModelOrigin = ModelOrigin;
 exports.ModelOriginEntry = ModelOriginEntry;
 exports.OHMYPI_BEHAVIOR = OHMYPI_BEHAVIOR;
@@ -13726,7 +13153,6 @@ exports.PanRpcGroup = PanRpcGroup;
 exports.PendingTurn = PendingTurn;
 exports.PipelineReviewCompletedEvent = PipelineReviewCompletedEvent;
 exports.PipelineReviewStartedEvent = PipelineReviewStartedEvent;
-exports.PipelineStatusChangedEvent = PipelineStatusChangedEvent;
 exports.PipelineTestCompletedEvent = PipelineTestCompletedEvent;
 exports.PipelineTestStartedEvent = PipelineTestStartedEvent;
 exports.PipelineVerificationFailedEvent = PipelineVerificationFailedEvent;
@@ -13737,6 +13163,8 @@ exports.PlanSubitemStatusChangedEvent = PlanSubitemStatusChangedEvent;
 exports.PlanningFailedEvent = PlanningFailedEvent;
 exports.PlanningStartedEvent = PlanningStartedEvent;
 exports.PlanningSyncEvent = PlanningSyncEvent;
+exports.PrChecksState = PrChecksState;
+exports.PrReviewState = PrReviewState;
 exports.ProjectCiHeadObservedEvent = ProjectCiHeadObservedEvent;
 exports.ProjectCiSnapshot = ProjectCiSnapshot;
 exports.ProjectCiSuite = ProjectCiSuite;
@@ -13753,7 +13181,6 @@ exports.ReadFileAtPathRpc = ReadFileAtPathRpc;
 exports.ReadWorkspaceFileInput = ReadWorkspaceFileInput;
 exports.ReadWorkspaceFileResult = ReadWorkspaceFileResult;
 exports.ReadWorkspaceFileRpc = ReadWorkspaceFileRpc;
-exports.ReleaseStatusValue = ReleaseStatusValue;
 exports.ReplayEventsRpc = ReplayEventsRpc;
 exports.ResetMarker = ResetMarker;
 exports.ResetMarkerScope = ResetMarkerScope;
@@ -13771,13 +13198,9 @@ exports.RestartGateSnapshot = RestartGateSnapshot;
 exports.ReviewApprovedEvent = ReviewApprovedEvent;
 exports.ReviewCoordinatorDiedEvent = ReviewCoordinatorDiedEvent;
 exports.ReviewCoordinatorStartedEvent = ReviewCoordinatorStartedEvent;
-exports.ReviewCycleEntry = ReviewCycleEntry;
 exports.ReviewReviewerCompletedEvent = ReviewReviewerCompletedEvent;
 exports.ReviewReviewerStartedEvent = ReviewReviewerStartedEvent;
 exports.ReviewSpecialistTimedOutEvent = ReviewSpecialistTimedOutEvent;
-exports.ReviewStatusChangedEvent = ReviewStatusChangedEvent;
-exports.ReviewStatusSnapshot = ReviewStatusSnapshot;
-exports.ReviewStatusValue = ReviewStatusValue;
 exports.ReviewVerdictDispatchedEvent = ReviewVerdictDispatchedEvent;
 exports.ReviewVerdictRejectedEvent = ReviewVerdictRejectedEvent;
 exports.ReviewVerdictRestoreBlockedEvent = ReviewVerdictRestoreBlockedEvent;
@@ -13814,7 +13237,6 @@ exports.SubagentSummary = SubagentSummary;
 exports.SubscribeAgentOutputRpc = SubscribeAgentOutputRpc;
 exports.SubscribeConversationMessagesRpc = SubscribeConversationMessagesRpc;
 exports.SubscribeDomainEventsRpc = SubscribeDomainEventsRpc;
-exports.SubscribeFlywheelStatusRpc = SubscribeFlywheelStatusRpc;
 exports.SubscribeIssueEventsRpc = SubscribeIssueEventsRpc;
 exports.SubscribeProjectSessionTreeRpc = SubscribeProjectSessionTreeRpc;
 exports.SubscribeTerminalRpc = SubscribeTerminalRpc;
@@ -13830,18 +13252,16 @@ exports.TELEMETRY_CLI_VERBS = TELEMETRY_CLI_VERBS;
 exports.TELEMETRY_EVENT_CATALOG = TELEMETRY_EVENT_CATALOG;
 exports.TELEMETRY_EVENT_NAMES = TELEMETRY_EVENT_NAMES;
 exports.TELEMETRY_PROPERTY_DOMAINS = TELEMETRY_PROPERTY_DOMAINS;
+exports.TERMINAL_BACKEND_NAMES = TERMINAL_BACKEND_NAMES;
 exports.TerminalCloseRpc = TerminalCloseRpc;
 exports.TerminalOpenRpc = TerminalOpenRpc;
 exports.TerminalOutput = TerminalOutput;
 exports.TerminalResizeRpc = TerminalResizeRpc;
 exports.TerminalWriteRpc = TerminalWriteRpc;
 exports.TestPassedEvent = TestPassedEvent;
-exports.TestStatusValue = TestStatusValue;
 exports.ThinkingState = ThinkingState;
 exports.TurnDiffFileChange = TurnDiffFileChange;
 exports.TurnDiffSummary = TurnDiffSummary;
-exports.UatStatusValue = UatStatusValue;
-exports.VerificationStatusValue = VerificationStatusValue;
 exports.WIRED_HOOK_INVENTORY = WIRED_HOOK_INVENTORY;
 exports.WIRED_HOOK_NAMES = WIRED_HOOK_NAMES;
 exports.WS_METHODS = WS_METHODS;
@@ -13856,7 +13276,6 @@ exports.WorkspaceContextLayerTarget = WorkspaceContextLayerTarget;
 exports.WorkspaceCreatedEvent = WorkspaceCreatedEvent;
 exports.WorkspaceDeletedEvent = WorkspaceDeletedEvent;
 exports.WorkspaceDestroyedEvent = WorkspaceDestroyedEvent;
-exports.WorkspaceDetail = WorkspaceDetail;
 exports.WorkspaceWipeStartedEvent = WorkspaceWipeStartedEvent;
 exports.WriteFileAtPathInput = WriteFileAtPathInput;
 exports.WriteFileAtPathResult = WriteFileAtPathResult;
@@ -13874,7 +13293,12 @@ exports.getHarnessBehavior = getHarnessBehavior;
 exports.getMaxMemoryObservationsPerIssue = getMaxMemoryObservationsPerIssue;
 exports.getMaxTurnDiffSummariesPerAgent = getMaxTurnDiffSummariesPerAgent;
 exports.getRuntimeBehavior = getRuntimeBehavior;
+exports.isAgentRole = isAgentRole;
+exports.isAgentSessionName = isAgentSessionName;
 exports.isChannelReplyKind = isChannelReplyKind;
+exports.isIssueAttention = isIssueAttention;
+exports.isIssueState = isIssueState;
+exports.isTerminalBackendName = isTerminalBackendName;
 exports.isTerminalTurnDiffSummaryStatus = isTerminalTurnDiffSummaryStatus;
 exports.normalizeChannelReplyPayload = normalizeChannelReplyPayload;
 exports.omitTurnDiffSummariesForAgent = omitTurnDiffSummariesForAgent;