@overdeck/contracts 0.47.1 → 0.49.0

package/dist/index.cjs

@@ -116,7 +116,8 @@ const KNOWN_HARNESSES = new Set([
 	"claude-code",
 	"ohmypi",
 	"codex",
-	"acp"
+	"acp",
+	"kimi-code"
 ]);
 /**
 * Normalize a snapshot's runtime field to a known Harness value.
@@ -719,13 +720,14 @@ const ScanResult = effect.Schema.Struct({
 });
 //#endregion
 //#region src/memory.ts
+const MemoryAgentRole = effect.Schema.Union([Role, effect.Schema.Literal("conversation")]);
 const MemoryIdentity = effect.Schema.Struct({
 	projectId: effect.Schema.String,
 	workspaceId: effect.Schema.String,
-	issueId: IssueId,
+	issueId: effect.Schema.NullOr(IssueId),
 	runId: effect.Schema.String,
 	sessionId: effect.Schema.String,
-	agentRole: Role,
+	agentRole: MemoryAgentRole,
 	agentHarness: effect.Schema.String
 });
 const MemoryTokenUsage = effect.Schema.Struct({
@@ -738,10 +740,10 @@ const MemoryObservation = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	projectId: effect.Schema.String,
 	workspaceId: effect.Schema.String,
-	issueId: IssueId,
+	issueId: effect.Schema.NullOr(IssueId),
 	runId: effect.Schema.String,
 	sessionId: effect.Schema.String,
-	agentRole: Role,
+	agentRole: MemoryAgentRole,
 	agentHarness: effect.Schema.String,
 	gitBranch: effect.Schema.String,
 	sourceTranscriptOffset: effect.Schema.Number,
@@ -1179,6 +1181,7 @@ const AgentStartedEvent = effect.Schema.Struct({
 	payload: effect.Schema.Struct({
 		agentId: AgentId,
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		agent: AgentSnapshot
 	})
 });
@@ -1190,6 +1193,7 @@ const AgentStoppedEvent = effect.Schema.Struct({
 	payload: effect.Schema.Struct({
 		agentId: AgentId,
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		sessionId: effect.Schema.optional(effect.Schema.String)
 	})
 });
@@ -1200,6 +1204,7 @@ const AgentHeartbeatDeadEvent = effect.Schema.Struct({
 	payload: effect.Schema.Struct({
 		agentId: AgentId,
 		issueId: effect.Schema.optional(IssueId),
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		sessionId: effect.Schema.optional(effect.Schema.String)
 	})
 });
@@ -1210,6 +1215,7 @@ const WorkCompletedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		agentId: effect.Schema.optional(AgentId)
 	})
 });
@@ -1220,6 +1226,7 @@ const AgentCompletedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		agentId: effect.Schema.optional(AgentId),
 		role: effect.Schema.optional(Role)
 	})
@@ -1229,14 +1236,20 @@ const ReviewApprovedEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("review.approved"),
 	sequence: SequenceNumber,
 	timestamp: effect.Schema.String,
-	payload: effect.Schema.Struct({ issueId: IssueId })
+	payload: effect.Schema.Struct({
+		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String)
+	})
 });
 /** Role lifecycle — tests passed and shipping should prepare the branch. */
 const TestPassedEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("test.passed"),
 	sequence: SequenceNumber,
 	timestamp: effect.Schema.String,
-	payload: effect.Schema.Struct({ issueId: IssueId })
+	payload: effect.Schema.Struct({
+		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String)
+	})
 });
 /** Replaces socket.io `godview:status-change` */
 const AgentStatusChangedEvent = effect.Schema.Struct({
@@ -1246,6 +1259,7 @@ const AgentStatusChangedEvent = effect.Schema.Struct({
 	payload: effect.Schema.Struct({
 		agentId: AgentId,
 		issueId: effect.Schema.optional(IssueId),
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		status: AgentStatus,
 		previousStatus: effect.Schema.optional(AgentStatus),
 		hasLiveTmuxSession: effect.Schema.optional(effect.Schema.Boolean),
@@ -1306,6 +1320,8 @@ const AgentEnrichmentChangedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		agentId: AgentId,
+		issueId: effect.Schema.optional(IssueId),
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		role: effect.Schema.optional(Role),
 		hasPendingQuestion: effect.Schema.optional(effect.Schema.Boolean),
 		pendingQuestionCount: effect.Schema.optional(effect.Schema.Number),
@@ -1343,6 +1359,7 @@ const AgentCreatedEvent = effect.Schema.Struct({
 	payload: effect.Schema.Struct({
 		agentId: AgentId,
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		agent: AgentSnapshot
 	})
 });
@@ -1353,7 +1370,19 @@ const AgentActivityChangedEvent = effect.Schema.Struct({
 	payload: effect.Schema.Struct({
 		agentId: AgentId,
 		activity: Activity,
-		currentTool: effect.Schema.optional(effect.Schema.String)
+		currentTool: effect.Schema.optional(effect.Schema.String),
+		hookName: effect.Schema.optional(effect.Schema.String)
+	})
+});
+/** A registered harness hook fired without implying an agent activity transition. */
+const AgentHookFiredEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("agent.hook_fired"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: effect.Schema.Struct({
+		agentId: AgentId,
+		hookName: effect.Schema.String,
+		tool: effect.Schema.optional(effect.Schema.String)
 	})
 });
 const AgentThinkingStartedEvent = effect.Schema.Struct({
@@ -1417,6 +1446,7 @@ const AgentPermissionResolvedEvent = effect.Schema.Struct({
 		requestId: effect.Schema.String,
 		agentId: AgentId,
 		issueId: effect.Schema.optional(IssueId),
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		behavior: ClaudeChannelPermissionBehavior
 	})
 });
@@ -1525,6 +1555,7 @@ const PlanningStartedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		sessionName: effect.Schema.String,
 		harness: effect.Schema.optional(effect.Schema.String)
 	})
@@ -1536,6 +1567,7 @@ const PlanningFailedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		error: effect.Schema.String
 	})
 });
@@ -1546,6 +1578,7 @@ const PlanningSyncEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		status: effect.Schema.String,
 		progress: effect.Schema.optional(effect.Schema.Number),
 		message: effect.Schema.optional(effect.Schema.String)
@@ -1558,6 +1591,7 @@ const PlanItemStatusChangedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		itemId: effect.Schema.String,
 		status: effect.Schema.String
 	})
@@ -1569,6 +1603,7 @@ const PlanSubitemStatusChangedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		itemId: effect.Schema.String,
 		subItemId: effect.Schema.String,
 		status: effect.Schema.String
@@ -1581,6 +1616,7 @@ const PlanItemsUnblockedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		items: effect.Schema.Array(effect.Schema.String)
 	})
 });
@@ -1591,6 +1627,7 @@ const PipelineStatusChangedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		status: ReviewStatusSnapshot
 	})
 });
@@ -1599,7 +1636,10 @@ const MergeReadyEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("merge.ready"),
 	sequence: SequenceNumber,
 	timestamp: effect.Schema.String,
-	payload: effect.Schema.Struct({ issueId: IssueId })
+	payload: effect.Schema.Struct({
+		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String)
+	})
 });
 /** New — review status changed */
 const ReviewStatusChangedEvent = effect.Schema.Struct({
@@ -1608,6 +1648,7 @@ const ReviewStatusChangedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		status: ReviewStatusSnapshot
 	})
 });
@@ -1616,7 +1657,10 @@ const PipelineReviewStartedEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("pipeline.review-started"),
 	sequence: SequenceNumber,
 	timestamp: effect.Schema.String,
-	payload: effect.Schema.Struct({ issueId: IssueId })
+	payload: effect.Schema.Struct({
+		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String)
+	})
 });
 /** New — review specialist finished (passed or failed) */
 const PipelineReviewCompletedEvent = effect.Schema.Struct({
@@ -1625,6 +1669,7 @@ const PipelineReviewCompletedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		passed: effect.Schema.Boolean
 	})
 });
@@ -1633,7 +1678,10 @@ const PipelineTestStartedEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("pipeline.test-started"),
 	sequence: SequenceNumber,
 	timestamp: effect.Schema.String,
-	payload: effect.Schema.Struct({ issueId: IssueId })
+	payload: effect.Schema.Struct({
+		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String)
+	})
 });
 /** New — test specialist finished (passed or failed) */
 const PipelineTestCompletedEvent = effect.Schema.Struct({
@@ -1642,6 +1690,7 @@ const PipelineTestCompletedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		passed: effect.Schema.Boolean
 	})
 });
@@ -1650,7 +1699,10 @@ const PipelineVerificationStartedEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("pipeline.verification-started"),
 	sequence: SequenceNumber,
 	timestamp: effect.Schema.String,
-	payload: effect.Schema.Struct({ issueId: IssueId })
+	payload: effect.Schema.Struct({
+		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String)
+	})
 });
 /** New — verification gate failed (carries failedCheck for gate failures, message for infra errors) */
 const PipelineVerificationFailedEvent = effect.Schema.Struct({
@@ -1659,6 +1711,7 @@ const PipelineVerificationFailedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		failedCheck: effect.Schema.optional(effect.Schema.String),
 		message: effect.Schema.optional(effect.Schema.String)
 	})
@@ -1672,6 +1725,7 @@ const IssueTransitionedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		state: effect.Schema.String
 	})
 });
@@ -1681,6 +1735,7 @@ const OperatorInterventionEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		kind: effect.Schema.Literals([
 			"tell",
 			"pause",
@@ -1745,6 +1800,7 @@ const SubstrateBugFiledEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		runId: effect.Schema.optional(effect.Schema.String),
 		filedBy: effect.Schema.Literals(["agent", "operator"]),
 		discoveredIn: effect.Schema.optional(IssueId),
@@ -1766,6 +1822,7 @@ const ReviewReviewerStartedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		role: effect.Schema.String,
 		sessionName: effect.Schema.String
 	})
@@ -1780,6 +1837,7 @@ const ReviewReviewerCompletedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		role: effect.Schema.String
 	})
 });
@@ -1794,6 +1852,7 @@ const ReviewSpecialistTimedOutEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		role: effect.Schema.String,
 		sessionName: effect.Schema.String,
 		attempt: effect.Schema.Number,
@@ -1812,6 +1871,7 @@ const ReviewCoordinatorStartedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		sessionName: effect.Schema.String
 	})
 });
@@ -1822,10 +1882,62 @@ const ReviewCoordinatorDiedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		sessionName: effect.Schema.String,
 		reason: effect.Schema.String
 	})
 });
+/** A terminal review verdict was rejected due to stale evidence. */
+const ReviewVerdictRejectedEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("review.verdict_rejected"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: effect.Schema.Struct({
+		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
+		writer: effect.Schema.String,
+		verdict: effect.Schema.String,
+		evidenceHead: effect.Schema.String,
+		rowHead: effect.Schema.String,
+		reason: effect.Schema.String
+	})
+});
+/** A terminal review verdict was landed and dispatched with a fresh evidence head. */
+const ReviewVerdictDispatchedEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("review.verdict_dispatched"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: effect.Schema.Struct({
+		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
+		writer: effect.Schema.String,
+		verdict: effect.Schema.String,
+		evidenceHead: effect.Schema.String,
+		rowHead: effect.Schema.String,
+		classification: effect.Schema.String,
+		testGateReset: effect.Schema.Boolean
+	})
+});
+/**
+* A recovery path found a fresh verdict artifact but declined to restore it,
+* because the artifact's head evidence disagrees with the row's anchor. The
+* verdict is NOT lost silently — it is reported here so the operator can see a
+* finished review that recovery refused to write (PAN-3511).
+*/
+const ReviewVerdictRestoreBlockedEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("review.verdict_restore_blocked"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: effect.Schema.Struct({
+		issueId: IssueId,
+		/** Recovery path that attempted the restore (orphan-reset, sweeper, …). */
+		caller: effect.Schema.String,
+		verdict: effect.Schema.String,
+		artifactHead: effect.Schema.String,
+		rowHead: effect.Schema.String,
+		reason: effect.Schema.String
+	})
+});
 const SpecialistLifecycleState = effect.Schema.Literals([
 	"active",
 	"sleeping",
@@ -1851,7 +1963,8 @@ const SpecialistCompletedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		name: Role,
-		issueId: effect.Schema.optional(IssueId)
+		issueId: effect.Schema.optional(IssueId),
+		workspaceId: effect.Schema.optional(effect.Schema.String)
 	})
 });
 /** New — role-backed specialist failed */
@@ -1862,6 +1975,7 @@ const SpecialistFailedEvent = effect.Schema.Struct({
 	payload: effect.Schema.Struct({
 		name: Role,
 		issueId: effect.Schema.optional(IssueId),
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		error: effect.Schema.String
 	})
 });
@@ -1901,7 +2015,10 @@ const IssuesUpdatedEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("issues.updated"),
 	sequence: SequenceNumber,
 	timestamp: effect.Schema.String,
-	payload: effect.Schema.Struct({ issueId: effect.Schema.optional(IssueId) })
+	payload: effect.Schema.Struct({
+		issueId: effect.Schema.optional(IssueId),
+		workspaceId: effect.Schema.optional(effect.Schema.String)
+	})
 });
 /** Patch a single issue's status in the read model without a full snapshot refresh. */
 const IssueStatusChangedEvent = effect.Schema.Struct({
@@ -1910,6 +2027,7 @@ const IssueStatusChangedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		status: effect.Schema.String,
 		canonicalStatus: effect.Schema.String,
 		labels: effect.Schema.optional(effect.Schema.Array(effect.Schema.String))
@@ -1942,6 +2060,7 @@ const ActivityEntryEvent = effect.Schema.Struct({
 		details: effect.Schema.optional(effect.Schema.String),
 		output: effect.Schema.optional(effect.Schema.String),
 		issueId: effect.Schema.optional(IssueId),
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		/** Dashboard route the feed navigates to on click (e.g. /conv/<name>, /flywheel). */
 		link: effect.Schema.optional(effect.Schema.String),
 		/** PAN-1862 (FR-12): fire a desktop notification for this entry (operator-facing warnings). */
@@ -1960,6 +2079,7 @@ const ActivityDetailedEvent = effect.Schema.Struct({
 		message: effect.Schema.String,
 		details: effect.Schema.optional(effect.Schema.String),
 		issueId: effect.Schema.optional(IssueId),
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		triggeringEvent: effect.Schema.optional(effect.Schema.String)
 	})
 });
@@ -1973,6 +2093,7 @@ const ActivityTtsEvent = effect.Schema.Struct({
 		utterance: effect.Schema.String,
 		priority: effect.Schema.optional(effect.Schema.Number),
 		issueId: effect.Schema.optional(IssueId),
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		source: effect.Schema.optional(effect.Schema.String),
 		eventType: effect.Schema.optional(effect.Schema.String)
 	})
@@ -1985,6 +2106,7 @@ const DashboardLifecycleStartedEvent = effect.Schema.Struct({
 	payload: effect.Schema.Struct({
 		reason: effect.Schema.String,
 		issueId: effect.Schema.optional(IssueId),
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		trigger: effect.Schema.String
 	})
 });
@@ -1996,6 +2118,7 @@ const DashboardLifecycleCompletedEvent = effect.Schema.Struct({
 	payload: effect.Schema.Struct({
 		reason: effect.Schema.String,
 		issueId: effect.Schema.optional(IssueId),
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		durationMs: effect.Schema.Number
 	})
 });
@@ -2007,6 +2130,7 @@ const DashboardLifecycleFailedEvent = effect.Schema.Struct({
 	payload: effect.Schema.Struct({
 		reason: effect.Schema.String,
 		issueId: effect.Schema.optional(IssueId),
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		error: effect.Schema.String
 	})
 });
@@ -2017,6 +2141,7 @@ const ShadowInferenceUpdateEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		content: effect.Schema.String
 	})
 });
@@ -2027,6 +2152,7 @@ const WorkspaceCreatedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		workspacePath: effect.Schema.String
 	})
 });
@@ -2035,21 +2161,30 @@ const WorkspaceWipeStartedEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("workspace.wipe_started"),
 	sequence: SequenceNumber,
 	timestamp: effect.Schema.String,
-	payload: effect.Schema.Struct({ issueId: IssueId })
+	payload: effect.Schema.Struct({
+		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String)
+	})
 });
 /** New — deep-wipe completed, workspace fully destroyed */
 const WorkspaceDestroyedEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("workspace.destroyed"),
 	sequence: SequenceNumber,
 	timestamp: effect.Schema.String,
-	payload: effect.Schema.Struct({ issueId: IssueId })
+	payload: effect.Schema.Struct({
+		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String)
+	})
 });
 /** New — cleanup-workspace completed, workspace directory removed */
 const WorkspaceDeletedEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("workspace.deleted"),
 	sequence: SequenceNumber,
 	timestamp: effect.Schema.String,
-	payload: effect.Schema.Struct({ issueId: IssueId })
+	payload: effect.Schema.Struct({
+		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String)
+	})
 });
 /** New — planning aborted, workspace returned to idle state */
 const WorkspaceAbortedEvent = effect.Schema.Struct({
@@ -2058,6 +2193,7 @@ const WorkspaceAbortedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		sessionName: effect.Schema.optional(effect.Schema.String)
 	})
 });
@@ -2107,6 +2243,7 @@ const MemoryHealthChangedEvent = effect.Schema.Struct({
 	payload: effect.Schema.Struct({
 		projectId: effect.Schema.String,
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		status: effect.Schema.Literals([
 			"healthy",
 			"degraded",
@@ -2125,6 +2262,7 @@ const CostEventRecordedEvent = effect.Schema.Struct({
 	payload: effect.Schema.Struct({
 		agentId: AgentId,
 		issueId: IssueId,
+		workspaceId: effect.Schema.optional(effect.Schema.String),
 		cost: effect.Schema.Number,
 		inputTokens: effect.Schema.Number,
 		outputTokens: effect.Schema.Number
@@ -2148,6 +2286,18 @@ const ConversationCreatedEvent = effect.Schema.Struct({
 	timestamp: effect.Schema.String,
 	payload: effect.Schema.Struct({ conversationName: effect.Schema.String })
 });
+/** Emitted (in-memory only, not persisted) when a conversation's project
+* assignment override changes, so the sidebar can re-group it live instead of
+* waiting for its poll tick. */
+const ConversationMovedEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("conversation.moved"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: effect.Schema.Struct({
+		conversationName: effect.Schema.String,
+		projectKey: effect.Schema.String
+	})
+});
 /** Emitted (in-memory only) when a conversation title changes, so the sidebar
 * list can refresh immediately instead of waiting for its poll tick. */
 const ConversationTitleChangedEvent = effect.Schema.Struct({
@@ -2248,6 +2398,45 @@ const EmbedProgressEvent = effect.Schema.Struct({
 		error: effect.Schema.optional(effect.Schema.String)
 	})
 });
+/** The parked population changed — carries the full new population (compact rows). */
+const SweepScanEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("sweep.scan"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: effect.Schema.Struct({
+		issueCount: effect.Schema.Number,
+		rowCount: effect.Schema.Number,
+		rows: effect.Schema.Array(effect.Schema.Struct({
+			issueId: effect.Schema.String,
+			orbit: effect.Schema.String,
+			parkedAt: effect.Schema.String
+		}))
+	})
+});
+/** A parked row was (re-)surfaced to the operator — gates respected, TTL re-surface, or exhaustion. */
+const SweepEscalatedEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("sweep.escalated"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: effect.Schema.Struct({
+		issueId: effect.Schema.String,
+		orbit: effect.Schema.String,
+		reason: effect.Schema.String
+	})
+});
+/** The sweeper recommended a remedy for a parked row (observability-only — never an action, PAN-3551). */
+const SweepRecommendationEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("sweep.recommendation"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: effect.Schema.Struct({
+		issueId: effect.Schema.String,
+		orbit: effect.Schema.String,
+		recommendation: effect.Schema.String,
+		recurring: effect.Schema.optional(effect.Schema.Boolean),
+		agentId: effect.Schema.optional(effect.Schema.String)
+	})
+});
 /** All domain events — the shape streamed via subscribeDomainEvents RPC */
 const DomainEvent = effect.Schema.Union([
 	SystemHeartbeatEvent,
@@ -2264,6 +2453,7 @@ const DomainEvent = effect.Schema.Union([
 	AgentStatusChangedEvent,
 	AgentOutputReceivedEvent,
 	AgentActivityChangedEvent,
+	AgentHookFiredEvent,
 	AgentThinkingStartedEvent,
 	AgentThinkingStoppedEvent,
 	AgentWaitingStartedEvent,
@@ -2305,6 +2495,9 @@ const DomainEvent = effect.Schema.Union([
 	ReviewSpecialistTimedOutEvent,
 	ReviewCoordinatorStartedEvent,
 	ReviewCoordinatorDiedEvent,
+	ReviewVerdictRejectedEvent,
+	ReviewVerdictDispatchedEvent,
+	ReviewVerdictRestoreBlockedEvent,
 	SpecialistStartedEvent,
 	SpecialistCompletedEvent,
 	SpecialistFailedEvent,
@@ -2334,6 +2527,7 @@ const DomainEvent = effect.Schema.Union([
 	DashboardLifecycleFailedEvent,
 	ConversationCompactingChangedEvent,
 	ConversationCreatedEvent,
+	ConversationMovedEvent,
 	ConversationTitleChangedEvent,
 	ConversationPermissionChangedEvent,
 	ScanStartedEvent,
@@ -2341,7 +2535,10 @@ const DomainEvent = effect.Schema.Union([
 	ScanCompleteEvent,
 	EnrichProgressEvent,
 	EnrichCompleteEvent,
-	EmbedProgressEvent
+	EmbedProgressEvent,
+	SweepScanEvent,
+	SweepEscalatedEvent,
+	SweepRecommendationEvent
 ]);
 //#endregion
 //#region src/editor.ts
@@ -2516,7 +2713,8 @@ const FlywheelHarness = effect.Schema.Literals([
 	"pi",
 	"ohmypi",
 	"codex",
-	"acp"
+	"acp",
+	"kimi-code"
 ]);
 const FlywheelEffort = effect.Schema.Literals([
 	"low",
@@ -2709,6 +2907,8 @@ const WS_METHODS = {
 	replayEvents: "pan.replayEvents",
 	getWorkspaceDetail: "pan.getWorkspaceDetail",
 	readWorkspaceFile: "pan.readWorkspaceFile",
+	readFileAtPath: "pan.readFileAtPath",
+	writeFileAtPath: "pan.writeFileAtPath",
 	resolveFilePathExists: "pan.resolveFilePathExists",
 	terminalOpen: "pan.terminalOpen",
 	terminalWrite: "pan.terminalWrite",
@@ -2854,12 +3054,17 @@ const SessionTreeDelta = effect.Schema.Struct({
 		"session_added",
 		"session_removed",
 		"presence_changed",
-		"status_changed"
+		"status_changed",
+		"pending_input_changed"
 	]),
 	issueId: effect.Schema.String,
 	sessionId: effect.Schema.String,
 	presence: effect.Schema.optional(SessionNodePresence),
 	status: effect.Schema.optional(AgentStatus),
+	awaitingInput: effect.Schema.optional(effect.Schema.Boolean),
+	awaitingInputPrompt: effect.Schema.optional(effect.Schema.String),
+	awaitingInputReason: effect.Schema.optional(effect.Schema.String),
+	pendingInputKinds: effect.Schema.optional(effect.Schema.Array(effect.Schema.String)),
 	timestamp: effect.Schema.String
 });
 /** 1. Subscribe to the live domain event stream (stream) */
@@ -2960,6 +3165,44 @@ const ReadWorkspaceFileRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.readWorkspa
 	success: ReadWorkspaceFileResult,
 	error: PanRpcError
 });
+const ReadFileAtPathInput = effect.Schema.Struct({ path: effect.Schema.String });
+const ReadFileAtPathResult = effect.Schema.Struct({
+	text: effect.Schema.String,
+	lang: effect.Schema.String,
+	mtimeMs: effect.Schema.Number,
+	totalLines: effect.Schema.Number
+});
+/**
+* 10b-2. Read an allowlisted markdown file by absolute path (PAN-3260).
+*
+* Unlike ReadWorkspaceFileRpc this takes no issueId — the internal markdown
+* editor pane opens files reached from surfaces with no workspace context
+* (e.g. a repo-root file chip inside a conversation). The server validates
+* `path` against registered project roots + OVERDECK_HOME before reading.
+*/
+const ReadFileAtPathRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.readFileAtPath, {
+	payload: ReadFileAtPathInput,
+	success: ReadFileAtPathResult,
+	error: PanRpcError
+});
+const WriteFileAtPathInput = effect.Schema.Struct({
+	path: effect.Schema.String,
+	content: effect.Schema.String,
+	expectedMtimeMs: effect.Schema.optional(effect.Schema.Number)
+});
+const WriteFileAtPathResult = effect.Schema.Struct({ mtimeMs: effect.Schema.Number });
+/**
+* 10b-3. Write an allowlisted markdown file by absolute path (PAN-3260).
+*
+* `expectedMtimeMs` enables optimistic concurrency: a stale value is
+* rejected with a PanRpcError code of WRITE_CONFLICT and nothing is
+* written. Omitting it (e.g. an explicit Overwrite action) skips the check.
+*/
+const WriteFileAtPathRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.writeFileAtPath, {
+	payload: WriteFileAtPathInput,
+	success: WriteFileAtPathResult,
+	error: PanRpcError
+});
 /**
 * 10c. Resolve whether a file path candidate exists on disk (PAN-1457).
 *
@@ -2977,7 +3220,7 @@ const ReadWorkspaceFileRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.readWorkspa
 *     chat happens outside any single workspace.
 */
 const ResolveFilePathExistsInput = effect.Schema.Struct({
-	cwd: effect.Schema.String,
+	cwd: effect.Schema.optional(effect.Schema.String),
 	path: effect.Schema.String
 });
 const ResolveFilePathExistsResult = effect.Schema.Struct({
@@ -3234,7 +3477,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, 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, 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);
 //#endregion
 //#region src/event-reducers.ts
 const INITIAL_READ_MODEL_STATE = {
@@ -3891,7 +4134,8 @@ function applyEvent(state, event) {
 		};
 		case "memory.observation_created": {
 			const observation = event.payload.observation;
-			const existing = state.observationsByIssueId[observation.issueId] ?? [];
+			const observationKey = observation.issueId ?? observation.workspaceId;
+			const existing = state.observationsByIssueId[observationKey] ?? [];
 			const index = existing.findIndex((entry) => entry.id === observation.id);
 			const updated = trimMemoryObservations(index === -1 ? [...existing, observation] : existing.map((entry, entryIndex) => entryIndex === index ? observation : entry));
 			return {
@@ -3899,7 +4143,7 @@ function applyEvent(state, event) {
 				sequence: Math.max(state.sequence, event.sequence),
 				observationsByIssueId: {
 					...state.observationsByIssueId,
-					[observation.issueId]: updated
+					[observationKey]: updated
 				}
 			};
 		}
@@ -3968,6 +4212,10 @@ function applyEvent(state, event) {
 				}
 			};
 		}
+		case "agent.hook_fired": return {
+			...state,
+			sequence: Math.max(state.sequence, event.sequence)
+		};
 		case "agent.activity_changed": {
 			const { agentId, activity, currentTool } = event.payload;
 			const prev = state.agentRuntimeById[agentId] ?? defaultRuntimeSnapshot(agentId, event.timestamp, event.sequence);
@@ -4425,6 +4673,10 @@ function applyEvent(state, event) {
 			...state,
 			conversationsListRevision: state.conversationsListRevision + 1
 		};
+		case "conversation.moved": return {
+			...state,
+			conversationsListRevision: state.conversationsListRevision + 1
+		};
 		case "conversation.title_changed": return {
 			...state,
 			conversationsListRevision: state.conversationsListRevision + 1
@@ -4666,7 +4918,8 @@ const CONTEXT_PREVIEW_HARNESSES = [
 	"claude-code",
 	"ohmypi",
 	"codex",
-	"acp"
+	"acp",
+	"kimi-code"
 ];
 const ContextLayerKind = effect.Schema.Literals(CONTEXT_LAYER_KINDS);
 const ContextPreviewHarness = effect.Schema.Literals(CONTEXT_PREVIEW_HARNESSES);
@@ -4774,6 +5027,7 @@ const ContextHarnessPreviews = effect.Schema.Struct({
 	ohmypi: effect.Schema.String,
 	codex: effect.Schema.String,
 	acp: effect.Schema.String,
+	"kimi-code": effect.Schema.String,
 	fullPrompt: effect.Schema.String
 });
 const ContextPreviewDiagnostic = effect.Schema.Struct({
@@ -4829,6 +5083,7 @@ const ArtifactAgentHarness = effect.Schema.Literals([
 	"ohmypi",
 	"codex",
 	"acp",
+	"kimi-code",
 	"user"
 ]);
 const ArtifactLifecycleState = effect.Schema.Literals([
@@ -5062,16 +5317,40 @@ const ACP_BEHAVIOR = {
 	workAgentMode: "acp-host",
 	readyTimeoutSeconds: 30
 };
+const KIMI_CODE_BEHAVIOR = {
+	displayName: "Kimi Code",
+	nativeCommands: [],
+	executableName: "kimi",
+	processNames: ["kimi"],
+	launchCommandKind: "kimi-code-tui",
+	deliveryKind: "pty-supervisor",
+	readinessKind: "kimi-session-signal",
+	transcriptKind: "kimi-wire-jsonl",
+	sessionIdSource: "kimi-session-newest",
+	contextLayerKind: "kimi-code",
+	feedKind: "kimi_code",
+	supportsPtySupervisor: true,
+	supportsChannelsBridge: false,
+	supportsConversationStreaming: true,
+	supportsPatchProjection: false,
+	usesRpcFifo: false,
+	usesCodexHome: false,
+	injectsPromptTimeMemory: false,
+	workAgentMode: "kimi-code-tui",
+	readyTimeoutSeconds: 60
+};
 const BEHAVIORS = {
 	"claude-code": CLAUDE_CODE_BEHAVIOR,
 	ohmypi: OHMYPI_BEHAVIOR,
 	codex: CODEX_BEHAVIOR,
-	acp: ACP_BEHAVIOR
+	acp: ACP_BEHAVIOR,
+	"kimi-code": KIMI_CODE_BEHAVIOR
 };
 function getHarnessBehavior(harness) {
 	if (harness === "ohmypi" || harness === "pi") return OHMYPI_BEHAVIOR;
 	if (harness === "codex") return CODEX_BEHAVIOR;
 	if (harness === "acp") return ACP_BEHAVIOR;
+	if (harness === "kimi-code") return KIMI_CODE_BEHAVIOR;
 	return CLAUDE_CODE_BEHAVIOR;
 }
 function getRuntimeBehavior(runtime) {
@@ -5285,7 +5564,8 @@ const TELEMETRY_PROPERTY_DOMAINS = {
 		"god-view",
 		"deacon",
 		"sessions",
-		"awaiting-merge"
+		"awaiting-merge",
+		"workspace"
 	],
 	decision_subject: ["agent", "conversation"],
 	duration_bucket: [
@@ -5304,7 +5584,8 @@ const TELEMETRY_PROPERTY_DOMAINS = {
 		"claude-code",
 		"ohmypi",
 		"codex",
-		"acp"
+		"acp",
+		"kimi-code"
 	],
 	merge_kind: ["pipeline"],
 	model_family: [
@@ -5818,29 +6099,11 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Review"
 	},
-	{
-		"id": "pan-review-scope",
-		"path": ["review", "scope"],
-		"display": "/pan review scope",
-		"description": "Set per-issue re-review scope (all, changed, or blockers) — which convoy reviewers re-run (PAN-1874)",
-		"args": [{
-			"name": "id",
-			"required": true,
-			"variadic": false
-		}, {
-			"name": "scope",
-			"required": true,
-			"variadic": false
-		}],
-		"options": [],
-		"aliases": [],
-		"category": "Review"
-	},
 	{
 		"id": "pan-review-restart",
 		"path": ["review", "restart"],
 		"display": "/pan review restart",
-		"description": "Kill running reviewers and dispatch fresh review pipeline",
+		"description": "Resume review and re-dispatch reviewers missing a report",
 		"args": [{
 			"name": "id",
 			"required": true,
@@ -5965,7 +6228,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 			},
 			{
 				"flags": "--harness <harness>",
-				"description": "Coding-agent harness: claude-code | pi | codex | acp (defaults to role/provider settings)",
+				"description": "Coding-agent harness: claude-code | pi | codex | acp | kimi-code (defaults to role/provider settings)",
 				"required": true,
 				"valueHint": "harness"
 			},
@@ -6069,6 +6332,24 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Lifecycle"
 	},
+	{
+		"id": "pan-answer",
+		"path": ["answer"],
+		"display": "/pan answer",
+		"description": "Show a pending pane choice, or answer its numbered option",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}, {
+			"name": "option",
+			"required": false,
+			"variadic": false
+		}],
+		"options": [],
+		"aliases": [],
+		"category": "CLI"
+	},
 	{
 		"id": "pan-monitor",
 		"path": ["monitor"],
@@ -6140,6 +6421,20 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Lifecycle"
 	},
+	{
+		"id": "pan-reset-session",
+		"path": ["reset-session"],
+		"display": "/pan reset-session",
+		"description": "Clear saved session pointers so the next start creates a fresh session",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [],
+		"aliases": [],
+		"category": "Lifecycle"
+	},
 	{
 		"id": "pan-pause",
 		"path": ["pause"],
@@ -6187,6 +6482,20 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"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"],
@@ -6210,6 +6519,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": true,
 				"valueHint": "path"
 			},
+			{
+				"flags": "--project <key>",
+				"description": "Project (yaml key or display name) for the new conversation; defaults to inheriting the source conversation's project",
+				"required": true,
+				"valueHint": "key"
+			},
 			{
 				"flags": "--plain",
 				"description": "Skip summary generation and copy raw conversation history",
@@ -6253,6 +6568,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": true,
 				"valueHint": "path"
 			},
+			{
+				"flags": "--project <key>",
+				"description": "Project (yaml key or display name) for the new conversation; defaults to inheriting the source conversation's project",
+				"required": true,
+				"valueHint": "key"
+			},
 			{
 				"flags": "--issue <id>",
 				"description": "Issue ID to associate with the new conversation",
@@ -6571,9 +6892,15 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": false,
 				"valueHint": null
 			},
+			{
+				"flags": "--accept-ship",
+				"description": "Accept a missed DoD row 7 (Version strings propagated) — recorded as an explicit override in the close-out record",
+				"required": false,
+				"valueHint": null
+			},
 			{
 				"flags": "--accept-deploy",
-				"description": "Accept a missed DoD row 7 (Deployed) — recorded as an explicit override in the close-out record",
+				"description": "Accept a missed DoD row 8 (Deployed) — recorded as an explicit override in the close-out record",
 				"required": false,
 				"valueHint": null
 			},
@@ -6582,6 +6909,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"description": "Record an abandoned disposition (PAN-3211): skip the DoD gate and close without landing evidence. Operator-conversation only; cannot be combined with --accept-* flags",
 				"required": true,
 				"valueHint": "reason"
+			},
+			{
+				"flags": "--residue <reason>",
+				"description": "Record a residue disposition (PAN-3396): close stale convention PRs/MRs, skip the DoD gate with verified evidence, and mark terminal without merge claim. Operator-conversation only; cannot be combined with --abandon or --accept-* flags",
+				"required": true,
+				"valueHint": "reason"
 			}
 		],
 		"aliases": [],
@@ -6624,7 +6957,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 			},
 			{
 				"flags": "--harness <harness>",
-				"description": "Coding-agent harness: claude-code | pi | codex | acp (defaults to role/provider settings)",
+				"description": "Coding-agent harness: claude-code | pi | codex | acp | kimi-code (defaults to role/provider settings)",
 				"required": true,
 				"valueHint": "harness"
 			},
@@ -6690,7 +7023,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 			},
 			{
 				"flags": "--force",
-				"description": "Clear a paused agent gate and start anyway",
+				"description": "Clear paused and pending-operator-decision gates and start anyway",
 				"required": false,
 				"valueHint": null
 			},
@@ -6741,7 +7074,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 			},
 			{
 				"flags": "--harness <harness>",
-				"description": "Coding-agent harness: claude-code | pi | codex | acp (defaults to role/provider settings)",
+				"description": "Coding-agent harness: claude-code | pi | codex | acp | kimi-code (defaults to role/provider settings)",
 				"required": true,
 				"valueHint": "harness"
 			},
@@ -7390,17 +7723,32 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"display": "/pan workspace list",
 		"description": "List all workspaces",
 		"args": [],
-		"options": [{
-			"flags": "--json",
-			"description": "Output as JSON",
-			"required": false,
-			"valueHint": null
-		}, {
-			"flags": "--all",
-			"description": "List workspaces across all registered projects",
-			"required": false,
-			"valueHint": null
-		}],
+		"options": [
+			{
+				"flags": "--json",
+				"description": "Output as JSON",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--all",
+				"description": "List workspaces across all registered projects",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--kind <kind>",
+				"description": "Filter by workspace kind (main|issue|scratch), reading through the resolver",
+				"required": true,
+				"valueHint": "kind"
+			},
+			{
+				"flags": "--archived",
+				"description": "Include archived workspaces (only applies with --kind)",
+				"required": false,
+				"valueHint": null
+			}
+		],
 		"aliases": [],
 		"category": "Workspace"
 	},
@@ -7414,25 +7762,160 @@ const COMPOSER_COMMAND_MANIFEST = [
 			"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)",
-			"required": true,
-			"valueHint": "path"
-		}],
+		"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": "--purge-memory",
+				"description": "Also permanently delete the workspace's memory home (irreversible)",
+				"required": false,
+				"valueHint": null
+			}
+		],
 		"aliases": [],
 		"category": "Workspace"
 	},
 	{
-		"id": "pan-workspace-render-devcontainer",
-		"path": ["workspace", "render-devcontainer"],
-		"display": "/pan workspace render-devcontainer",
-		"description": "Re-render <workspace>/.devcontainer/ from the project compose template",
+		"id": "pan-workspace-new",
+		"path": ["workspace", "new"],
+		"display": "/pan workspace new",
+		"description": "Create a scratch workspace (shared dir by default; --isolated for a git worktree)",
+		"args": [{
+			"name": "name",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [
+			{
+				"flags": "--project <key>",
+				"description": "Registered project key (defaults to the sole project, or the one resolved from cwd)",
+				"required": true,
+				"valueHint": "key"
+			},
+			{
+				"flags": "--isolated",
+				"description": "Create an isolated git worktree instead of sharing the project directory",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--parent-branch <branch>",
+				"description": "Parent branch for the isolated worktree (default: inferred from the project's current branch)",
+				"required": true,
+				"valueHint": "branch"
+			},
+			{
+				"flags": "--target-path <dir>",
+				"description": "Target an existing directory as the workspace path (rejects --isolated)",
+				"required": true,
+				"valueHint": "dir"
+			},
+			{
+				"flags": "--dry-run",
+				"description": "Print the resolved intent as JSON and create nothing",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Workspace"
+	},
+	{
+		"id": "pan-workspace-main",
+		"path": ["workspace", "main"],
+		"display": "/pan workspace main",
+		"description": "Resolve or create the project's singleton main workspace",
+		"args": [],
+		"options": [{
+			"flags": "--project <key>",
+			"description": "Registered project key (defaults to the sole project, or the one resolved from cwd)",
+			"required": true,
+			"valueHint": "key"
+		}],
+		"aliases": [],
+		"category": "Workspace"
+	},
+	{
+		"id": "pan-workspace-get",
+		"path": ["workspace", "get"],
+		"display": "/pan workspace get",
+		"description": "Show a workspace row by id",
+		"args": [{
+			"name": "ws",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [],
+		"aliases": [],
+		"category": "Workspace"
+	},
+	{
+		"id": "pan-workspace-activate",
+		"path": ["workspace", "activate"],
+		"display": "/pan workspace activate",
+		"description": "Touch a workspace's last-accessed time and print its layout hint",
+		"args": [{
+			"name": "ws",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [],
+		"aliases": [],
+		"category": "Workspace"
+	},
+	{
+		"id": "pan-workspace-archive",
+		"path": ["workspace", "archive"],
+		"display": "/pan workspace archive",
+		"description": "Archive a workspace (reversible; refuses kind=main)",
+		"args": [{
+			"name": "ws",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [],
+		"aliases": [],
+		"category": "Workspace"
+	},
+	{
+		"id": "pan-workspace-relocate",
+		"path": ["workspace", "relocate"],
+		"display": "/pan workspace relocate",
+		"description": "Point a workspace at a new path (refuses kind=issue; kind=main requires --force)",
+		"args": [{
+			"name": "ws",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--path <dir>",
+			"description": "New path (must be an existing directory)",
+			"required": true,
+			"valueHint": "dir"
+		}, {
+			"flags": "--force",
+			"description": "Allow relocating the main workspace, diverging it from projects.yaml",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "Workspace"
+	},
+	{
+		"id": "pan-workspace-render-devcontainer",
+		"path": ["workspace", "render-devcontainer"],
+		"display": "/pan workspace render-devcontainer",
+		"description": "Re-render <workspace>/.devcontainer/ from the project compose template",
 		"args": [{
 			"name": "featureName",
 			"required": true,
@@ -8061,10 +8544,10 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"valueHint": "id"
 			},
 			{
-				"flags": "--workspace <id>",
-				"description": "Workspace ID",
+				"flags": "--workspace <id|name>",
+				"description": "Workspace id or name",
 				"required": true,
-				"valueHint": "id"
+				"valueHint": "id|name"
 			},
 			{
 				"flags": "--issue <id>",
@@ -8084,6 +8567,18 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": false,
 				"valueHint": null
 			},
+			{
+				"flags": "--global",
+				"description": "Search across all registered projects instead of just one",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--target [path]",
+				"description": "Search all workspaces whose path targets a directory (bare flag = cwd); mutually exclusive with --workspace/--issue/--global",
+				"required": false,
+				"valueHint": "path"
+			},
 			{
 				"flags": "--include-archived",
 				"description": "Include observations hidden by reset markers",
@@ -8110,23 +8605,106 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-memory-status",
 		"path": ["memory", "status"],
 		"display": "/pan memory status",
-		"description": "Show current memory status for an issue",
+		"description": "Show current memory status for an issue, a workspace, or the current directory",
 		"args": [{
 			"name": "issue",
-			"required": true,
+			"required": false,
 			"variadic": false
 		}],
-		"options": [{
-			"flags": "--project <id>",
-			"description": "Project ID",
+		"options": [
+			{
+				"flags": "--project <id>",
+				"description": "Project ID",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--workspace <id|name>",
+				"description": "Workspace id or name instead of an issue positional",
+				"required": true,
+				"valueHint": "id|name"
+			},
+			{
+				"flags": "--history <n>",
+				"description": "Also print up to N archived statuses, newest first (max 50)",
+				"required": true,
+				"valueHint": "n"
+			},
+			{
+				"flags": "--json",
+				"description": "Output JSON",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Observation"
+	},
+	{
+		"id": "pan-memory-timeline",
+		"path": ["memory", "timeline"],
+		"display": "/pan memory timeline",
+		"description": "Print chronological observations for a workspace or the current directory",
+		"args": [],
+		"options": [
+			{
+				"flags": "--workspace <id|name>",
+				"description": "Workspace id or name (defaults to the workspace owning the cwd)",
+				"required": true,
+				"valueHint": "id|name"
+			},
+			{
+				"flags": "--days <n>",
+				"description": "Most recent N days, today counting as day 1 (default 7)",
+				"required": true,
+				"valueHint": "n"
+			},
+			{
+				"flags": "--limit <n>",
+				"description": "Maximum observation rows",
+				"required": true,
+				"valueHint": "n"
+			},
+			{
+				"flags": "--json",
+				"description": "Output JSON",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Observation"
+	},
+	{
+		"id": "pan-memory-read",
+		"path": ["memory", "read"],
+		"display": "/pan memory read",
+		"description": "Print a file from a workspace's memory home (path is relative to that home)",
+		"args": [{
+			"name": "path",
 			"required": true,
-			"valueHint": "id"
-		}, {
-			"flags": "--json",
-			"description": "Output JSON",
-			"required": false,
-			"valueHint": null
+			"variadic": false
 		}],
+		"options": [
+			{
+				"flags": "--workspace <id|name>",
+				"description": "Workspace id or name (defaults to the workspace owning the cwd)",
+				"required": true,
+				"valueHint": "id|name"
+			},
+			{
+				"flags": "--from <n>",
+				"description": "First line to print, 1-based",
+				"required": true,
+				"valueHint": "n"
+			},
+			{
+				"flags": "--lines <n>",
+				"description": "Maximum number of lines to print",
+				"required": true,
+				"valueHint": "n"
+			}
+		],
 		"aliases": [],
 		"category": "Observation"
 	},
@@ -8177,10 +8755,10 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-memory-summary",
 		"path": ["memory", "summary"],
 		"display": "/pan memory summary",
-		"description": "Generate a daily markdown memory summary",
+		"description": "Generate a daily markdown memory summary for an issue, a workspace, or the current directory",
 		"args": [{
 			"name": "issue",
-			"required": true,
+			"required": false,
 			"variadic": false
 		}],
 		"options": [
@@ -8190,6 +8768,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": true,
 				"valueHint": "id"
 			},
+			{
+				"flags": "--workspace <id|name>",
+				"description": "Workspace id or name instead of an issue positional",
+				"required": true,
+				"valueHint": "id|name"
+			},
 			{
 				"flags": "--date <yyyy-mm-dd>",
 				"description": "Summary date",
@@ -8226,6 +8810,136 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Observation"
 	},
+	{
+		"id": "pan-memory-backfill",
+		"path": ["memory", "backfill"],
+		"display": "/pan memory backfill",
+		"description": "Backfill memory observations from historical Claude Code JSONL transcripts",
+		"args": [],
+		"options": [
+			{
+				"flags": "--workspace <id>",
+				"description": "Only backfill sessions resolved to this workspace id",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--project <id>",
+				"description": "Only backfill sessions resolved to this project id",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--dry-run",
+				"description": "Report matched sessions without extracting or writing anything",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--json",
+				"description": "Output JSON",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Observation"
+	},
+	{
+		"id": "pan-memory-pin",
+		"path": ["memory", "pin"],
+		"display": "/pan memory pin",
+		"description": "Pin a doc for prompt-time memory injection (path is stored project-relative)",
+		"args": [{
+			"name": "doc-path",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [
+			{
+				"flags": "--project <id>",
+				"description": "Project key to pin at project scope",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--workspace <id>",
+				"description": "Workspace id to pin at workspace scope (overrides --project)",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--json",
+				"description": "Output JSON",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Observation"
+	},
+	{
+		"id": "pan-memory-unpin",
+		"path": ["memory", "unpin"],
+		"display": "/pan memory unpin",
+		"description": "Remove a pinned doc",
+		"args": [{
+			"name": "doc-path",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [
+			{
+				"flags": "--project <id>",
+				"description": "Project key the pin was made at project scope",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--workspace <id>",
+				"description": "Workspace id the pin was made at workspace scope (overrides --project)",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--json",
+				"description": "Output JSON",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Observation"
+	},
+	{
+		"id": "pan-memory-pins",
+		"path": ["memory", "pins"],
+		"display": "/pan memory pins",
+		"description": "List pinned docs for a project or workspace",
+		"args": [],
+		"options": [
+			{
+				"flags": "--project <id>",
+				"description": "Project key to list project-scoped pins for",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--workspace <id>",
+				"description": "Workspace id to list workspace-scoped pins for (overrides --project)",
+				"required": true,
+				"valueHint": "id"
+			},
+			{
+				"flags": "--json",
+				"description": "Output JSON",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Observation"
+	},
 	{
 		"id": "pan-memory-config",
 		"path": ["memory", "config"],
@@ -8464,7 +9178,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 			"required": true,
 			"variadic": false
 		}],
-		"options": [],
+		"options": [{
+			"flags": "--project <key>",
+			"description": "Resolve the order book in another registered project",
+			"required": true,
+			"valueHint": "key"
+		}],
 		"aliases": [],
 		"category": "Flywheel"
 	},
@@ -8474,7 +9193,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"display": "/pan orders list",
 		"description": "List order books",
 		"args": [],
-		"options": [],
+		"options": [{
+			"flags": "--project <key>",
+			"description": "Resolve the order book in another registered project",
+			"required": true,
+			"valueHint": "key"
+		}],
 		"aliases": [],
 		"category": "Flywheel"
 	},
@@ -8488,7 +9212,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 			"required": true,
 			"variadic": false
 		}],
-		"options": [],
+		"options": [{
+			"flags": "--project <key>",
+			"description": "Resolve the order book in another registered project",
+			"required": true,
+			"valueHint": "key"
+		}],
 		"aliases": [],
 		"category": "Flywheel"
 	},
@@ -8524,6 +9253,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"description": "Require PRD re-verification before pickup",
 				"required": false,
 				"valueHint": null
+			},
+			{
+				"flags": "--project <key>",
+				"description": "Resolve the order book in another registered project",
+				"required": true,
+				"valueHint": "key"
 			}
 		],
 		"aliases": [],
@@ -8543,7 +9278,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 			"required": true,
 			"variadic": false
 		}],
-		"options": [],
+		"options": [{
+			"flags": "--project <key>",
+			"description": "Resolve the order book in another registered project",
+			"required": true,
+			"valueHint": "key"
+		}],
 		"aliases": [],
 		"category": "Flywheel"
 	},
@@ -8561,16 +9301,44 @@ const COMPOSER_COMMAND_MANIFEST = [
 			"required": true,
 			"variadic": false
 		}],
-		"options": [{
-			"flags": "--lane <lane>",
-			"description": "Target lane: A or B",
+		"options": [
+			{
+				"flags": "--lane <lane>",
+				"description": "Target lane: A or B",
+				"required": true,
+				"valueHint": "lane"
+			},
+			{
+				"flags": "--order <n>",
+				"description": "One-based position in the target lane",
+				"required": true,
+				"valueHint": "n"
+			},
+			{
+				"flags": "--project <key>",
+				"description": "Resolve the order book in another registered project",
+				"required": true,
+				"valueHint": "key"
+			}
+		],
+		"aliases": [],
+		"category": "Flywheel"
+	},
+	{
+		"id": "pan-orders-queue",
+		"path": ["orders", "queue"],
+		"display": "/pan orders queue",
+		"description": "Mark a draft order book ready for dispatch",
+		"args": [{
+			"name": "id",
 			"required": true,
-			"valueHint": "lane"
-		}, {
-			"flags": "--order <n>",
-			"description": "One-based position in the target lane",
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--project <key>",
+			"description": "Resolve the order book in another registered project",
 			"required": true,
-			"valueHint": "n"
+			"valueHint": "key"
 		}],
 		"aliases": [],
 		"category": "Flywheel"
@@ -8585,10 +9353,59 @@ const COMPOSER_COMMAND_MANIFEST = [
 			"required": true,
 			"variadic": false
 		}],
-		"options": [],
+		"options": [{
+			"flags": "--project <key>",
+			"description": "Resolve the order book in another registered project",
+			"required": true,
+			"valueHint": "key"
+		}],
 		"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
+			}
+		],
+		"aliases": [],
+		"category": "CLI"
+	},
 	{
 		"id": "pan-docs",
 		"path": ["docs"],
@@ -8764,6 +9581,29 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Admin"
 	},
+	{
+		"id": "pan-admin-state-backfill-agents",
+		"path": [
+			"admin",
+			"state",
+			"backfill-agents"
+		],
+		"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"],
@@ -8779,6 +9619,35 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Admin"
 	},
+	{
+		"id": "pan-admin-migrate-legacy-agent-dirs",
+		"path": ["admin", "migrate-legacy-agent-dirs"],
+		"display": "/pan admin migrate-legacy-agent-dirs",
+		"description": "Copy pre-rebrand conv-* agent dirs into the configured Overdeck home without overwriting",
+		"args": [],
+		"options": [],
+		"aliases": [],
+		"category": "Admin"
+	},
+	{
+		"id": "pan-admin-seed-uat-fixtures",
+		"path": ["admin", "seed-uat-fixtures"],
+		"display": "/pan admin seed-uat-fixtures",
+		"description": "Seed the obviously-fake FIX-1 issue fixture into a workspace container for UI UAT. Host mode: `pan admin seed-uat-fixtures <issue-id>` seeds and restarts that issue's workspace container from the host. `--local` runs the seed itself against the current OVERDECK_HOME — used by the host wrapper, or manually inside a container.",
+		"args": [{
+			"name": "issue-id",
+			"required": false,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--local",
+			"description": "Seed the current (container-local) OVERDECK_HOME directly, without a host wrapper step",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "Admin"
+	},
 	{
 		"id": "pan-admin-cloister",
 		"path": ["admin", "cloister"],
@@ -8977,28 +9846,6 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Admin"
 	},
-	{
-		"id": "pan-admin-specialists-discovery-ready",
-		"path": [
-			"admin",
-			"specialists",
-			"discovery-ready"
-		],
-		"display": "/pan admin specialists discovery-ready",
-		"description": "Signal that the review parent finished shared discovery — forks + launches the convoy (PAN-1862)",
-		"args": [{
-			"name": "type",
-			"required": true,
-			"variadic": false
-		}, {
-			"name": "issueId",
-			"required": true,
-			"variadic": false
-		}],
-		"options": [],
-		"aliases": [],
-		"category": "Admin"
-	},
 	{
 		"id": "pan-admin-specialists-done",
 		"path": [
@@ -9037,16 +9884,22 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"valueHint": "notes"
 			},
 			{
-				"flags": "--run-id <runId>",
-				"description": "Review cycle ID used to deduplicate review feedback",
+				"flags": "--uat-status <status>",
+				"description": "Test only: required browser UAT result (passed or failed)",
 				"required": true,
-				"valueHint": "runId"
+				"valueHint": "status"
+			},
+			{
+				"flags": "--uat-notes <notes>",
+				"description": "Test only: browser UAT evidence or blocking condition",
+				"required": true,
+				"valueHint": "notes"
 			},
 			{
-				"flags": "--reviewers <verdicts>",
-				"description": "PAN-1862 (review only): per-reviewer verdicts, e.g. \"security=passed,correctness=blocked\"",
+				"flags": "--run-id <runId>",
+				"description": "Review cycle ID used to deduplicate review feedback",
 				"required": true,
-				"valueHint": "verdicts"
+				"valueHint": "runId"
 			}
 		],
 		"aliases": [],
@@ -9411,6 +10264,30 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Admin"
 	},
+	{
+		"id": "pan-admin-db-rebuild-workspaces",
+		"path": [
+			"admin",
+			"db",
+			"rebuild-workspaces"
+		],
+		"display": "/pan admin db rebuild-workspaces",
+		"description": "Rebuild the projects/workspaces tables from projects.yaml, worktree scan, and memory-home identity records (PAN-1990)",
+		"args": [],
+		"options": [{
+			"flags": "--dry-run",
+			"description": "Show what would be created without writing",
+			"required": false,
+			"valueHint": null
+		}, {
+			"flags": "--verbose",
+			"description": "Log each processed workspace",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "Admin"
+	},
 	{
 		"id": "pan-admin-db-gc-agents",
 		"path": [
@@ -10104,6 +10981,24 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": ["transcript"],
 		"category": "Conversation"
 	},
+	{
+		"id": "pan-conversations-move",
+		"path": ["conversations", "move"],
+		"display": "/pan conversations move",
+		"description": "Reassign a conversation to a different project (exact name, then fuzzy title match)",
+		"args": [{
+			"name": "query",
+			"required": true,
+			"variadic": false
+		}, {
+			"name": "projectKey",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [],
+		"aliases": [],
+		"category": "Conversation"
+	},
 	{
 		"id": "pan-conversations-current",
 		"path": ["conversations", "current"],
@@ -10717,7 +11612,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-flywheel-report",
 		"path": ["flywheel", "report"],
 		"display": "/pan flywheel report",
-		"description": "Finalize the active Flywheel run: write report.md, commit FLYWHEEL-STATE.md changes, and clear the active-run gate. Refuses to run while the orchestrator session is alive (pause or abort first).",
+		"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",
@@ -10828,7 +11723,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 			},
 			{
 				"flags": "--agent-harness <harness>",
-				"description": "Agent harness: claude-code, pi, codex, acp, or user",
+				"description": "Agent harness: claude-code, pi, ohmypi, codex, acp, kimi-code, or user",
 				"required": true,
 				"valueHint": "harness"
 			},
@@ -11403,6 +12298,30 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Project"
 	},
+	{
+		"id": "pan-project-add-target",
+		"path": ["project", "add-target"],
+		"display": "/pan project add-target",
+		"description": "Add a secondary target path for a registered project",
+		"args": [{
+			"name": "project",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--path <path>",
+			"description": "Target path to add",
+			"required": true,
+			"valueHint": "path"
+		}, {
+			"flags": "--primary",
+			"description": "Make this the primary target (demotes any existing primary)",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "Project"
+	},
 	{
 		"id": "pan-projects",
 		"path": ["projects"],
@@ -11523,6 +12442,30 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Project"
 	},
+	{
+		"id": "pan-projects-add-target",
+		"path": ["projects", "add-target"],
+		"display": "/pan projects add-target",
+		"description": "Add a secondary target path for a registered project",
+		"args": [{
+			"name": "project",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--path <path>",
+			"description": "Target path to add",
+			"required": true,
+			"valueHint": "path"
+		}, {
+			"flags": "--primary",
+			"description": "Make this the primary target (demotes any existing primary)",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "Project"
+	},
 	{
 		"id": "pan-health",
 		"path": ["health"],
@@ -11933,6 +12876,106 @@ const COMPOSER_COMMAND_VARIANTS = [
 	}
 ];
 //#endregion
+//#region src/hook-inventory.ts
+const HOOK_INVENTORY = [
+	{
+		name: "PreToolUse",
+		wired: true,
+		color: "#00d4ff"
+	},
+	{
+		name: "PostToolUse",
+		wired: true,
+		color: "#39ff14"
+	},
+	{
+		name: "PostToolUseFailure",
+		wired: true,
+		color: "#ff4444"
+	},
+	{
+		name: "Stop",
+		wired: true,
+		color: "#ff2d7c"
+	},
+	{
+		name: "SessionStart",
+		wired: true,
+		color: "#9d4edd"
+	},
+	{
+		name: "Notification",
+		wired: true,
+		color: "#ffb800"
+	},
+	{
+		name: "UserPromptSubmit",
+		wired: true,
+		color: "#00d4ff"
+	},
+	{
+		name: "PreCompact",
+		wired: true,
+		color: "#ff7700"
+	},
+	{
+		name: "PostCompact",
+		wired: true,
+		color: "#ff7700"
+	},
+	{
+		name: "PermissionRequest",
+		wired: true,
+		color: "#ffb800"
+	},
+	{
+		name: "SessionEnd",
+		wired: false
+	},
+	{
+		name: "SubagentStart",
+		wired: false
+	},
+	{
+		name: "SubagentStop",
+		wired: false
+	},
+	{
+		name: "StopFailure",
+		wired: false
+	},
+	{
+		name: "PermissionDenied",
+		wired: false
+	},
+	{
+		name: "TaskCreated",
+		wired: false
+	},
+	{
+		name: "TaskCompleted",
+		wired: false
+	},
+	{
+		name: "TeammateIdle",
+		wired: false
+	},
+	{
+		name: "ConfigChange",
+		wired: false
+	},
+	{
+		name: "WorktreeCreate",
+		wired: false
+	},
+	{
+		name: "InstructionsLoaded",
+		wired: false
+	}
+];
+const WIRED_HOOK_INVENTORY = HOOK_INVENTORY.filter((hook) => hook.wired);
+const WIRED_HOOK_NAMES = WIRED_HOOK_INVENTORY.map((hook) => hook.name);
+//#endregion
 exports.ACP_BEHAVIOR = ACP_BEHAVIOR;
 exports.Activity = Activity;
 exports.ActivityDetailedEvent = ActivityDetailedEvent;
@@ -11952,6 +12995,7 @@ exports.AgentHealthKind = AgentHealthKind;
 exports.AgentHealthSnapshot = AgentHealthSnapshot;
 exports.AgentHealthStatus = AgentHealthStatus;
 exports.AgentHeartbeatDeadEvent = AgentHeartbeatDeadEvent;
+exports.AgentHookFiredEvent = AgentHookFiredEvent;
 exports.AgentId = AgentId;
 exports.AgentMessageReceivedEvent = AgentMessageReceivedEvent;
 exports.AgentModelSetEvent = AgentModelSetEvent;
@@ -12029,6 +13073,7 @@ exports.ConversationCostSummary = ConversationCostSummary;
 exports.ConversationCreatedEvent = ConversationCreatedEvent;
 exports.ConversationEvent = ConversationEvent;
 exports.ConversationFilter = ConversationFilter;
+exports.ConversationMovedEvent = ConversationMovedEvent;
 exports.ConversationPermissionChangedEvent = ConversationPermissionChangedEvent;
 exports.ConversationResponse = ConversationResponse;
 exports.ConversationTitleChangedEvent = ConversationTitleChangedEvent;
@@ -12096,6 +13141,7 @@ exports.GetSnapshotRpc = GetSnapshotRpc;
 exports.GetWorkspaceDetailRpc = GetWorkspaceDetailRpc;
 exports.GlobalContextLayerRecord = GlobalContextLayerRecord;
 exports.GlobalContextLayerTarget = GlobalContextLayerTarget;
+exports.HOOK_INVENTORY = HOOK_INVENTORY;
 exports.HealthReason = HealthReason;
 exports.HealthState = HealthState;
 exports.HostHealthMetrics = HostHealthMetrics;
@@ -12109,6 +13155,8 @@ exports.IssueStatusChangedEvent = IssueStatusChangedEvent;
 exports.IssueTransitionedEvent = IssueTransitionedEvent;
 exports.IssuesSnapshotEvent = IssuesSnapshotEvent;
 exports.IssuesUpdatedEvent = IssuesUpdatedEvent;
+exports.KIMI_CODE_BEHAVIOR = KIMI_CODE_BEHAVIOR;
+exports.KNOWN_HARNESSES = KNOWN_HARNESSES;
 exports.LegacySystemHealthSummary = LegacySystemHealthSummary;
 exports.LegacyWebhookRelaySummary = LegacyWebhookRelaySummary;
 exports.LinearMcpAuthCallbackRelayedEvent = LinearMcpAuthCallbackRelayedEvent;
@@ -12122,6 +13170,7 @@ exports.MAX_CHANNEL_REPLY_ARTIFACT_REFS = MAX_CHANNEL_REPLY_ARTIFACT_REFS;
 exports.MAX_CHANNEL_REPLY_ARTIFACT_URI_LENGTH = MAX_CHANNEL_REPLY_ARTIFACT_URI_LENGTH;
 exports.MAX_CHANNEL_REPLY_SUMMARY_LENGTH = MAX_CHANNEL_REPLY_SUMMARY_LENGTH;
 exports.MEMBERSHIP_UNAVAILABLE_REASONS = MEMBERSHIP_UNAVAILABLE_REASONS;
+exports.MemoryAgentRole = MemoryAgentRole;
 exports.MemoryHealthChangedEvent = MemoryHealthChangedEvent;
 exports.MemoryIdentity = MemoryIdentity;
 exports.MemoryObservation = MemoryObservation;
@@ -12170,6 +13219,9 @@ exports.ProjectSessionTree = ProjectSessionTree;
 exports.ProposedPlan = ProposedPlan;
 exports.RagDecision = RagDecision;
 exports.RagDecisionSource = RagDecisionSource;
+exports.ReadFileAtPathInput = ReadFileAtPathInput;
+exports.ReadFileAtPathResult = ReadFileAtPathResult;
+exports.ReadFileAtPathRpc = ReadFileAtPathRpc;
 exports.ReadWorkspaceFileInput = ReadWorkspaceFileInput;
 exports.ReadWorkspaceFileResult = ReadWorkspaceFileResult;
 exports.ReadWorkspaceFileRpc = ReadWorkspaceFileRpc;
@@ -12193,6 +13245,9 @@ exports.ReviewSpecialistTimedOutEvent = ReviewSpecialistTimedOutEvent;
 exports.ReviewStatusChangedEvent = ReviewStatusChangedEvent;
 exports.ReviewStatusSnapshot = ReviewStatusSnapshot;
 exports.ReviewStatusValue = ReviewStatusValue;
+exports.ReviewVerdictDispatchedEvent = ReviewVerdictDispatchedEvent;
+exports.ReviewVerdictRejectedEvent = ReviewVerdictRejectedEvent;
+exports.ReviewVerdictRestoreBlockedEvent = ReviewVerdictRestoreBlockedEvent;
 exports.ReviewerRoundMetadata = ReviewerRoundMetadata;
 exports.ReviewerRoundSummary = ReviewerRoundSummary;
 exports.Role = Role;
@@ -12231,6 +13286,9 @@ exports.SubscribeIssueEventsRpc = SubscribeIssueEventsRpc;
 exports.SubscribeProjectSessionTreeRpc = SubscribeProjectSessionTreeRpc;
 exports.SubscribeTerminalRpc = SubscribeTerminalRpc;
 exports.SubstrateBugFiledEvent = SubstrateBugFiledEvent;
+exports.SweepEscalatedEvent = SweepEscalatedEvent;
+exports.SweepRecommendationEvent = SweepRecommendationEvent;
+exports.SweepScanEvent = SweepScanEvent;
 exports.SystemHealthConsumer = SystemHealthConsumer;
 exports.SystemHealthSeverityChangedEvent = SystemHealthSeverityChangedEvent;
 exports.SystemHealthSnapshot = SystemHealthSnapshot;
@@ -12251,6 +13309,8 @@ 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;
 exports.WaitingReason = WaitingReason;
 exports.WaitingState = WaitingState;
@@ -12265,6 +13325,9 @@ exports.WorkspaceDeletedEvent = WorkspaceDeletedEvent;
 exports.WorkspaceDestroyedEvent = WorkspaceDestroyedEvent;
 exports.WorkspaceDetail = WorkspaceDetail;
 exports.WorkspaceWipeStartedEvent = WorkspaceWipeStartedEvent;
+exports.WriteFileAtPathInput = WriteFileAtPathInput;
+exports.WriteFileAtPathResult = WriteFileAtPathResult;
+exports.WriteFileAtPathRpc = WriteFileAtPathRpc;
 exports.applyEvent = applyEvent;
 exports.applyEvents = applyEvents;
 exports.compareIssueIds = compareIssueIds;