@overdeck/contracts 0.49.1 → 0.50.0

package/dist/index.cjs

@@ -435,6 +435,72 @@ const EmbedProgressSnapshot = effect.Schema.Struct({
 	error: effect.Schema.optional(effect.Schema.String),
 	timestamp: effect.Schema.String
 });
+const ProjectCiSuite = effect.Schema.Struct({
+	status: effect.Schema.String,
+	conclusion: effect.Schema.NullOr(effect.Schema.String),
+	htmlUrl: effect.Schema.optional(effect.Schema.String),
+	/** GitHub's suite/run update time, used to reject delayed same-SHA events. */
+	observedAt: effect.Schema.optional(effect.Schema.String)
+});
+const ProjectCiSnapshot = effect.Schema.Struct({
+	projectKey: effect.Schema.String,
+	repo: effect.Schema.String,
+	branch: effect.Schema.String,
+	headSha: effect.Schema.String,
+	/** suiteId → suite. Only GitHub Actions suites ever appear here. */
+	suites: effect.Schema.Record(effect.Schema.String, ProjectCiSuite),
+	/** Newest `observedAt` folded into this record. */
+	updatedAt: effect.Schema.String
+});
+/** What kind of process asked for the voluntary dashboard restart. */
+const RestartGateKind = effect.Schema.Literals([
+	"deploy",
+	"reload",
+	"restart"
+]);
+/**
+* One live restart request. `requesterId` is stable for a single requester
+* invocation (e.g. `deploy:PAN-3724:<pid>`), so a re-poll refreshes the same
+* row instead of adding another.
+*/
+const RestartGateRequest = effect.Schema.Struct({
+	requesterId: effect.Schema.String,
+	kind: RestartGateKind,
+	reason: effect.Schema.String,
+	builtSha: effect.Schema.optional(effect.Schema.String),
+	requestedAt: effect.Schema.String
+});
+/**
+* How the last approval cycle ended, when the ending is worth telling the
+* operator about (PAN-3731). Present only inside the brief window after it
+* happened, so the banner can explain a click that restarted nothing.
+*
+* `pruned-unclaimed` — an approved epoch expired with nobody left to perform
+* the restart: every requester died before claiming, or a claimant lapsed and
+* the rest gave up. Either way nothing was restarted.
+*/
+const RestartGateOutcome = effect.Schema.Struct({
+	type: effect.Schema.Literals(["pruned-unclaimed"]),
+	at: effect.Schema.String
+});
+/**
+* The operator-facing view of the restart gate — identical to the body of
+* `GET /api/restart-gate`, so the banner and the CLI read the same shape.
+*
+* `idle` no live requests; `pending` requests are waiting for approval;
+* `approved` the operator approved an epoch that nobody has claimed yet;
+* `claimed` one requester holds the exclusive right to perform the restart.
+*/
+const RestartGateSnapshot = effect.Schema.Struct({
+	status: effect.Schema.Literals([
+		"idle",
+		"pending",
+		"approved",
+		"claimed"
+	]),
+	pending: effect.Schema.Array(RestartGateRequest),
+	lastOutcome: effect.Schema.optional(RestartGateOutcome)
+});
 const DashboardSnapshot = effect.Schema.Struct({
 	sequence: SequenceNumber,
 	agents: effect.Schema.Array(AgentSnapshot),
@@ -450,6 +516,8 @@ const DashboardSnapshot = effect.Schema.Struct({
 	enrichStats: effect.Schema.optional(effect.Schema.NullOr(EnrichStatsSnapshot)),
 	enrichProgressBySessionId: effect.Schema.optional(effect.Schema.Record(effect.Schema.String, EnrichProgressSnapshot)),
 	embedProgressBySessionId: effect.Schema.optional(effect.Schema.Record(effect.Schema.String, EmbedProgressSnapshot)),
+	ciByProjectKey: effect.Schema.optional(effect.Schema.Record(effect.Schema.String, ProjectCiSnapshot)),
+	restartGate: effect.Schema.optional(RestartGateSnapshot),
 	timestamp: effect.Schema.String
 });
 const WorkspaceDetail = effect.Schema.Struct({
@@ -1173,6 +1241,76 @@ const BeadsFreshnessChangedEvent = effect.Schema.Struct({
 		lastSyncedAt: effect.Schema.String
 	})
 });
+/**
+* One GitHub Actions check suite observed on a project's default branch
+* (PAN-3537).
+*
+* Emitted by the `check_suite` webhook handler for live updates, only after an
+* independent branch-head lookup verifies the payload SHA is still current.
+* `suiteId` is the check suite id — for GitHub Actions that is one suite per
+* workflow run. The webhook payload does not carry `htmlUrl`.
+*
+* Boot and periodic repair use `project.ci_head_observed`, which replaces the
+* complete projection after pagination. Both events feed
+* `ReadModelState.ciByProjectKey`, a disposable cache rebuilt from REST on every
+* boot — there is no durable CI store.
+*/
+const ProjectCiSuiteObservedEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("project.ci_suite_observed"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: effect.Schema.Struct({
+		projectKey: effect.Schema.String,
+		repo: effect.Schema.String,
+		branch: effect.Schema.String,
+		headSha: effect.Schema.String,
+		suiteId: effect.Schema.String,
+		status: effect.Schema.String,
+		conclusion: effect.Schema.NullOr(effect.Schema.String),
+		htmlUrl: effect.Schema.optional(effect.Schema.String),
+		observedAt: effect.Schema.String,
+		/** True only after the emitter verified headSha against the branch head. */
+		authoritativeHead: effect.Schema.optional(effect.Schema.Boolean)
+	})
+});
+/**
+* Complete GitHub Actions projection for the verified default-branch head.
+* The REST seed/repair emits one event after paginating every run and verifying
+* the branch head a second time. An empty suites record explicitly clears stale
+* CI when the current commit has no Actions runs.
+*/
+const ProjectCiHeadObservedEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("project.ci_head_observed"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: effect.Schema.Struct({
+		projectKey: effect.Schema.String,
+		repo: effect.Schema.String,
+		branch: effect.Schema.String,
+		headSha: effect.Schema.String,
+		suites: effect.Schema.Record(effect.Schema.String, ProjectCiSuite),
+		observedAt: effect.Schema.String
+	})
+});
+/**
+* The restart gate changed (PAN-3729).
+*
+* The payload is the COMPLETE gate projection, not a delta, so the reducer is a
+* plain replace and no ordering logic is needed. Emitted by the gate writer
+* (`src/dashboard/server/services/restart-gate.ts`) on every mutation and on
+* every sweep tick that drops an expired request, so the approval banner clears
+* itself when a requester dies without polling again.
+*
+* The gate is runtime-plane state (like `~/.overdeck/dashboard-restarting.json`),
+* so this event is emitted in-memory only — it is never persisted to the event
+* log and never replayed at boot.
+*/
+const RestartGateChangedEvent = effect.Schema.Struct({
+	type: effect.Schema.Literal("restart_gate.changed"),
+	sequence: SequenceNumber,
+	timestamp: effect.Schema.String,
+	payload: RestartGateSnapshot
+});
 /** Replaces socket.io `agents:changed` (event: 'started') */
 const AgentStartedEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("agent.started"),
@@ -2441,6 +2579,9 @@ const SweepRecommendationEvent = effect.Schema.Struct({
 const DomainEvent = effect.Schema.Union([
 	SystemHeartbeatEvent,
 	BeadsFreshnessChangedEvent,
+	ProjectCiSuiteObservedEvent,
+	ProjectCiHeadObservedEvent,
+	RestartGateChangedEvent,
 	AgentCreatedEvent,
 	AgentEnrichmentChangedEvent,
 	AgentStartedEvent,
@@ -3509,6 +3650,8 @@ const INITIAL_READ_MODEL_STATE = {
 	enrichStats: null,
 	enrichProgressBySessionId: {},
 	embedProgressBySessionId: {},
+	ciByProjectKey: {},
+	restartGate: null,
 	agentIdBySessionId: {},
 	dashboardLifecycle: {
 		active: false,
@@ -3634,6 +3777,8 @@ function syncSnapshot(state, snapshot) {
 		enrichStats: snapshot.enrichStats ?? null,
 		enrichProgressBySessionId: snapshot.enrichProgressBySessionId ?? {},
 		embedProgressBySessionId: snapshot.embedProgressBySessionId ?? {},
+		ciByProjectKey: snapshot.ciByProjectKey ?? state.ciByProjectKey,
+		restartGate: snapshot.restartGate ?? state.restartGate,
 		agentIdBySessionId
 	};
 }
@@ -3974,6 +4119,97 @@ function applyEvent(state, event) {
 			...state,
 			sequence: Math.max(state.sequence, event.sequence)
 		};
+		case "project.ci_suite_observed": {
+			const p = event.payload;
+			const existing = state.ciByProjectKey[p.projectKey];
+			const suite = {
+				status: p.status,
+				conclusion: p.conclusion,
+				htmlUrl: p.htmlUrl,
+				observedAt: p.observedAt
+			};
+			let next;
+			if (!existing) {
+				if (p.authoritativeHead !== true) return {
+					...state,
+					sequence: Math.max(state.sequence, event.sequence)
+				};
+				next = {
+					projectKey: p.projectKey,
+					repo: p.repo,
+					branch: p.branch,
+					headSha: p.headSha,
+					suites: { [p.suiteId]: suite },
+					updatedAt: p.observedAt
+				};
+			} else if (existing.headSha === p.headSha) {
+				const existingSuite = existing.suites[p.suiteId];
+				const existingSuiteObservedAt = existingSuite?.observedAt ?? existing.updatedAt;
+				if (existingSuite && p.observedAt < existingSuiteObservedAt) return {
+					...state,
+					sequence: Math.max(state.sequence, event.sequence)
+				};
+				next = {
+					...existing,
+					suites: {
+						...existing.suites,
+						[p.suiteId]: suite
+					},
+					updatedAt: p.observedAt > existing.updatedAt ? p.observedAt : existing.updatedAt
+				};
+			} else if (p.authoritativeHead === true && p.observedAt >= existing.updatedAt) next = {
+				projectKey: p.projectKey,
+				repo: p.repo,
+				branch: p.branch,
+				headSha: p.headSha,
+				suites: { [p.suiteId]: suite },
+				updatedAt: p.observedAt
+			};
+			else return {
+				...state,
+				sequence: Math.max(state.sequence, event.sequence)
+			};
+			return {
+				...state,
+				sequence: Math.max(state.sequence, event.sequence),
+				ciByProjectKey: {
+					...state.ciByProjectKey,
+					[p.projectKey]: next
+				}
+			};
+		}
+		case "project.ci_head_observed": {
+			const p = event.payload;
+			const existing = state.ciByProjectKey[p.projectKey];
+			if (existing && p.observedAt < existing.updatedAt) return {
+				...state,
+				sequence: Math.max(state.sequence, event.sequence)
+			};
+			return {
+				...state,
+				sequence: Math.max(state.sequence, event.sequence),
+				ciByProjectKey: {
+					...state.ciByProjectKey,
+					[p.projectKey]: {
+						projectKey: p.projectKey,
+						repo: p.repo,
+						branch: p.branch,
+						headSha: p.headSha,
+						suites: p.suites,
+						updatedAt: p.observedAt
+					}
+				}
+			};
+		}
+		case "restart_gate.changed": return {
+			...state,
+			sequence: Math.max(state.sequence, event.sequence),
+			restartGate: {
+				status: event.payload.status,
+				pending: event.payload.pending,
+				...event.payload.lastOutcome === void 0 ? {} : { lastOutcome: event.payload.lastOutcome }
+			}
+		};
 		case "resources.updated": return {
 			...state,
 			sequence: Math.max(state.sequence, event.sequence),
@@ -4822,6 +5058,29 @@ function applyEvents(state, events) {
 	return events.reduce(applyEvent, state);
 }
 //#endregion
+//#region src/project-ci.ts
+/** Conclusions that mean the suite failed. Mirrors FAILING_CHECK_CONCLUSIONS
+*  in src/lib/webhook-handlers.ts:196. */
+const FAILED = new Set([
+	"failure",
+	"timed_out",
+	"cancelled",
+	"action_required",
+	"startup_failure",
+	"stale"
+]);
+function deriveProjectCi(record) {
+	const suites = Object.values(record.suites);
+	const total = suites.length;
+	const completed = suites.filter((s) => s.status === "completed").length;
+	return {
+		state: suites.some((s) => s.conclusion != null && FAILED.has(s.conclusion.toLowerCase())) ? "failure" : suites.some((s) => s.status === "in_progress") ? "in_progress" : completed < total || total === 0 ? "queued" : "success",
+		completed,
+		total,
+		href: (total === 1 ? suites[0] : void 0)?.htmlUrl ?? `https://github.com/${record.repo}/commit/${record.headSha}/checks`
+	};
+}
+//#endregion
 //#region src/flywheel-stats.ts
 const FlywheelStatsCriterionStatus = effect.Schema.Literals([
 	"green",
@@ -5565,6 +5824,7 @@ const TELEMETRY_PROPERTY_DOMAINS = {
 		"deacon",
 		"sessions",
 		"awaiting-merge",
+		"workspace-new",
 		"workspace"
 	],
 	decision_subject: ["agent", "conversation"],
@@ -6539,7 +6799,7 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"id": "pan-handoff",
 		"path": ["handoff"],
 		"display": "/pan handoff",
-		"description": "Conversation handoff that spawns a new conversation; omit <conv> (or pass \"self\") to hand off the conversation you are in; trailing text becomes the focus — MAX 500 characters. Very large source conversations are auto-degraded (truncated smart summary → heuristic → focus-only) and still hand off without aborting.",
+		"description": "Conversation handoff that spawns a new conversation; omit <conv> (or pass \"self\") to hand off the conversation you are in; trailing text becomes the focus — MAX 10000 characters (keep it short; long briefs belong in a file the focus points at). Very large source conversations are auto-degraded (truncated smart summary → heuristic → focus-only) and still hand off without aborting.",
 		"args": [{
 			"name": "conv",
 			"required": false,
@@ -6580,6 +6840,12 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"required": true,
 				"valueHint": "id"
 			},
+			{
+				"flags": "--title <title>",
+				"description": "Title for the new conversation; defaults to \"Handoff: <focus>\" (first ~70 chars) or \"Handoff: <source title>\" without focus",
+				"required": true,
+				"valueHint": "title"
+			},
 			{
 				"flags": "--author <author>",
 				"description": "Who authors the handoff doc: external (default) or source",
@@ -7181,6 +7447,48 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Lifecycle"
 	},
+	{
+		"id": "pan-swarm-dispatch",
+		"path": ["swarm", "dispatch"],
+		"display": "/pan swarm dispatch",
+		"description": "Run one gated swarm dispatch pass",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--json",
+			"description": "Print structured dispatch results",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "Lifecycle"
+	},
+	{
+		"id": "pan-swarm-merge",
+		"path": ["swarm", "merge"],
+		"display": "/pan swarm merge",
+		"description": "Verify and merge one completed swarm slot",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}, {
+			"name": "slotIndex",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--json",
+			"description": "Print structured merge results",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "Lifecycle"
+	},
 	{
 		"id": "pan-swarm-recover",
 		"path": ["swarm", "recover"],
@@ -7197,9 +7505,14 @@ const COMPOSER_COMMAND_MANIFEST = [
 		}],
 		"options": [{
 			"flags": "--action <action>",
-			"description": "Recovery action: retry, drop, or handoff",
+			"description": "Recovery action: retry, drop, handoff, or reclaim",
 			"required": true,
 			"valueHint": "action"
+		}, {
+			"flags": "--operator",
+			"description": "Override the three-intervention limit for this failure class",
+			"required": false,
+			"valueHint": null
 		}],
 		"aliases": [],
 		"category": "Lifecycle"
@@ -7247,7 +7560,36 @@ const COMPOSER_COMMAND_MANIFEST = [
 			"required": true,
 			"variadic": false
 		}],
-		"options": [],
+		"options": [{
+			"flags": "--json",
+			"description": "Print structured status including foreman, hold, and interventions",
+			"required": false,
+			"valueHint": null
+		}],
+		"aliases": [],
+		"category": "Lifecycle"
+	},
+	{
+		"id": "pan-swarm-wait",
+		"path": ["swarm", "wait"],
+		"display": "/pan swarm wait",
+		"description": "Wait for a swarm slot, foreman, or hold state transition",
+		"args": [{
+			"name": "id",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [{
+			"flags": "--timeout <seconds>",
+			"description": "Maximum wait in seconds",
+			"required": true,
+			"valueHint": "seconds"
+		}, {
+			"flags": "--json",
+			"description": "Print the structured status delta",
+			"required": false,
+			"valueHint": null
+		}],
 		"aliases": [],
 		"category": "Lifecycle"
 	},
@@ -7518,6 +7860,49 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Lifecycle"
 	},
+	{
+		"id": "pan-task-reopen",
+		"path": ["task", "reopen"],
+		"display": "/pan task reopen",
+		"description": "",
+		"args": [{
+			"name": "issue",
+			"required": true,
+			"variadic": false
+		}, {
+			"name": "item",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [
+			{
+				"flags": "--reason <text>",
+				"description": "Reason for the status change",
+				"required": true,
+				"valueHint": "text"
+			},
+			{
+				"flags": "--expected-sequence <n>",
+				"description": "Require the current task sequence",
+				"required": true,
+				"valueHint": "n"
+			},
+			{
+				"flags": "--force",
+				"description": "Override a non-terminal transition or claim owner; requires --reason",
+				"required": false,
+				"valueHint": null
+			},
+			{
+				"flags": "--json",
+				"description": "Print JSON",
+				"required": false,
+				"valueHint": null
+			}
+		],
+		"aliases": [],
+		"category": "Lifecycle"
+	},
 	{
 		"id": "pan-task-cancel",
 		"path": ["task", "cancel"],
@@ -10999,6 +11384,20 @@ const COMPOSER_COMMAND_MANIFEST = [
 		"aliases": [],
 		"category": "Conversation"
 	},
+	{
+		"id": "pan-conversations-heal",
+		"path": ["conversations", "heal"],
+		"display": "/pan conversations heal",
+		"description": "Clear stale fork/spawn failure state for a live conversation",
+		"args": [{
+			"name": "query",
+			"required": true,
+			"variadic": false
+		}],
+		"options": [],
+		"aliases": [],
+		"category": "Conversation"
+	},
 	{
 		"id": "pan-conversations-current",
 		"path": ["conversations", "current"],
@@ -12173,11 +12572,27 @@ const COMPOSER_COMMAND_MANIFEST = [
 				"description": "Disable agent auto-resume on restart (opt out of the default-on auto-resume)",
 				"required": false,
 				"valueHint": null
+			},
+			{
+				"flags": "--now",
+				"description": "Skip the operator-approval wait: approve everything already waiting, then restart the dashboard immediately",
+				"required": false,
+				"valueHint": null
 			}
 		],
 		"aliases": [],
 		"category": "Core"
 	},
+	{
+		"id": "pan-restart-approve",
+		"path": ["restart", "approve"],
+		"display": "/pan restart approve",
+		"description": "Approve every dashboard restart request that is waiting for the operator",
+		"args": [],
+		"options": [],
+		"aliases": [],
+		"category": "Core"
+	},
 	{
 		"id": "pan-project",
 		"path": ["project"],
@@ -13213,6 +13628,10 @@ exports.PlanSubitemStatusChangedEvent = PlanSubitemStatusChangedEvent;
 exports.PlanningFailedEvent = PlanningFailedEvent;
 exports.PlanningStartedEvent = PlanningStartedEvent;
 exports.PlanningSyncEvent = PlanningSyncEvent;
+exports.ProjectCiHeadObservedEvent = ProjectCiHeadObservedEvent;
+exports.ProjectCiSnapshot = ProjectCiSnapshot;
+exports.ProjectCiSuite = ProjectCiSuite;
+exports.ProjectCiSuiteObservedEvent = ProjectCiSuiteObservedEvent;
 exports.ProjectContextLayerRecord = ProjectContextLayerRecord;
 exports.ProjectContextLayerTarget = ProjectContextLayerTarget;
 exports.ProjectSessionTree = ProjectSessionTree;
@@ -13235,6 +13654,11 @@ exports.ResolveFilePathExistsResult = ResolveFilePathExistsResult;
 exports.ResolveFilePathExistsRpc = ResolveFilePathExistsRpc;
 exports.ResourceStats = ResourceStats;
 exports.ResourcesUpdatedEvent = ResourcesUpdatedEvent;
+exports.RestartGateChangedEvent = RestartGateChangedEvent;
+exports.RestartGateKind = RestartGateKind;
+exports.RestartGateOutcome = RestartGateOutcome;
+exports.RestartGateRequest = RestartGateRequest;
+exports.RestartGateSnapshot = RestartGateSnapshot;
 exports.ReviewApprovedEvent = ReviewApprovedEvent;
 exports.ReviewCoordinatorDiedEvent = ReviewCoordinatorDiedEvent;
 exports.ReviewCoordinatorStartedEvent = ReviewCoordinatorStartedEvent;
@@ -13332,6 +13756,7 @@ exports.applyEvent = applyEvent;
 exports.applyEvents = applyEvents;
 exports.compareIssueIds = compareIssueIds;
 exports.decodeFlywheelStats = decodeFlywheelStats;
+exports.deriveProjectCi = deriveProjectCi;
 exports.encodeFlywheelStats = encodeFlywheelStats;
 exports.getHarness = getHarness;
 exports.getHarnessBehavior = getHarnessBehavior;