@qontinui/shared-types 0.8.1 → 0.12.0

package/dist/index.d.ts

@@ -327,6 +327,417 @@ interface SpecValidation {
  */
 type ProposalStatus = "proposed" | "pending" | "promoted";
 
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * A project the user has told the runner about (typically via the setup
+ * wizard's project picker, the new-project flow, or the Projects
+ * dashboard's "find on disk" discovery).
+ *
+ * Persisted to `settings.json` under the `saved_projects` key.
+ *
+ * `id` is the stable key: a project's `path` can move on disk (renamed
+ * folder, relocated workspace) but its identity must not. Entries persisted
+ * before `id` existed are backfilled with a freshly-minted UUID on first
+ * load — `#[serde(default)]` exists only so that load succeeds, never as a
+ * legitimate steady-state value.
+ *
+ * `project_type` is deliberately a free-form `String` so a new framework
+ * never requires a schema change.
+ * `Default` exists so a producer that only knows a few fields can write
+ * `SavedProject { path, name, ..Default::default() }` — the new-project flow
+ * and the setup wizard both do. A defaulted `id` is the empty string, which
+ * the registry treats as "mint me one" (see the field docs), never as a key.
+ */
+interface SavedProject {
+  /**
+   * Accent colour for the card, as a CSS colour string.
+   */
+  color?: string | null;
+  /**
+   * One-line plain-English description ("Website for the pizzeria, with
+   * menu + ordering"). Shown on the project card under the name.
+   */
+  description?: string | null;
+  /**
+   * Emoji used as the card's visual identity (e.g. "🍕").
+   */
+  emoji?: string | null;
+  /**
+   * The project's front page ("http://localhost:3000"). Seeded from the
+   * setup wizard's dev-server port detection; user-correctable.
+   */
+  frontPageUrl?: string | null;
+  /**
+   * Stable identifier (UUID). Survives a path move; the registry key.
+   */
+  id: string;
+  /**
+   * Unix epoch milliseconds of the last time the project was activated.
+   */
+  lastOpenedMs?: number | null;
+  /**
+   * Manifest file that identified the project (e.g. "package.json").
+   */
+  manifest: string;
+  /**
+   * Human-friendly display name (usually the directory basename).
+   */
+  name: string;
+  /**
+   * The user's own free-form notes about the project.
+   */
+  notes?: string | null;
+  /**
+   * Absolute path to the project root.
+   */
+  path: string;
+  /**
+   * Pinned projects sort first and render as sidebar entries.
+   */
+  pinned: boolean;
+  /**
+   * Ids of the `ProcessConfig` entries this project owns.
+   */
+  processIds: string[];
+  /**
+   * Framework/language tag, e.g. "react", "python", "rust", "node".
+   */
+  projectType: string;
+  /**
+   * `owner/name` GitHub slug, from `repo_detection::detect_repo_slug`.
+   */
+  repoSlug?: string | null;
+  /**
+   * Bound Terminal page id.
+   *
+   * **A hint, not a handle.** Terminal pages persist to the frontend's
+   * `instanceStorage` (localStorage, port-namespaced), which Rust cannot
+   * read, so this id can name a page that does not exist in the current
+   * window. Activation must treat an unknown id as "not created yet" —
+   * create a page named after the project and rewrite the id — and must
+   * never fail on a dangling value.
+   */
+  terminalPageId?: string | null;
+  /**
+   * Terminal zone profile to restore when the project is activated.
+   */
+  zoneProfile?: string | null;
+}
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * One commit in [`GitLite::last_commits`].
+ */
+interface GitCommitLite {
+  /**
+   * Unix epoch milliseconds of the commit timestamp.
+   */
+  committedMs: number;
+  /**
+   * Abbreviated commit sha.
+   */
+  sha: string;
+  /**
+   * Commit subject line.
+   */
+  subject: string;
+}
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+
+
+/**
+ * Git state of the project root. `None` on the snapshot when the root is
+ * not a git working tree (or git is unavailable).
+ */
+interface GitLite {
+  /**
+   * Current branch. `None` on a detached HEAD.
+   */
+  branch?: string | null;
+  /**
+   * Number of `git status --porcelain` entries (uncommitted changes).
+   */
+  dirtyCount: number;
+  /**
+   * Newest commits first.
+   */
+  lastCommits: GitCommitLite[];
+}
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Traffic-light level for [`HealthLite`].
+ */
+type HealthLevel = "green" | "amber" | "red" | "unknown";
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+
+
+/**
+ * One green/amber/red answer to "is it broken?", plus the plain-English
+ * reason behind it.
+ */
+interface HealthLite {
+  /**
+   * Names of the processes driving an amber/red verdict.
+   */
+  failingProcesses: string[];
+  /**
+   * The traffic light.
+   */
+  level?: HealthLevel & string;
+  /**
+   * Why — a sentence a non-developer can read
+   * ("The website still starts up fine").
+   */
+  reason: string;
+}
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * A question an agent is blocked on, awaiting the user's answer.
+ */
+interface PendingQuestion {
+  /**
+   * Unix epoch milliseconds the question was raised.
+   */
+  createdAtMs?: number | null;
+  /**
+   * `deferred_questions.id`.
+   */
+  id: string;
+  /**
+   * The question text, as shown to the user.
+   */
+  question: string;
+  /**
+   * Risk level the asking agent assigned ("low" | "medium" | "high").
+   */
+  riskLevel?: string | null;
+  /**
+   * The session that asked.
+   */
+  taskRunId: string;
+}
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * State of a managed process.
+ *
+ * Ordering mirrors the lifecycle progression:
+ * `Stopped → Starting → (Building) → Running → Healthy → Stopping → Stopped`,
+ * or to `Failed` on any abnormal exit.
+ * `ExternallyOwned` is a special out-of-band state meaning "a process is
+ * running on our port, but this runner did not spawn it" — used by the
+ * process-reconcile feature to surface port squatters without touching the
+ * normal lifecycle.
+ */
+type ProcessState =
+  | (
+      | "stopped"
+      | "starting"
+      | "building"
+      | "running"
+      | "healthy"
+      | "stopping"
+      | "failed"
+    )
+  | "externally_owned";
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+
+
+/**
+ * A managed process attributed to a project, reduced to what the dashboard
+ * renders. Full detail stays in `ProcessStatus` / `ProcessConfig`.
+ */
+interface ProcessStatusLite {
+  /**
+   * Working directory — the field that attributed this process to the
+   * project in the first place.
+   */
+  cwd: string;
+  /**
+   * Health port, when the process declares one.
+   */
+  healthPort?: number | null;
+  /**
+   * `ProcessConfig.id`.
+   */
+  id: string;
+  /**
+   * Human-readable process name ("Website").
+   */
+  name: string;
+  /**
+   * Whether the health port is currently responding. `None` when the
+   * process declares no health port.
+   */
+  portHealthy?: boolean | null;
+  state: ProcessState;
+}
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Where a [`SessionLite`] was observed.
+ */
+type SessionSource = "terminal" | "touched_files";
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+
+
+/**
+ * One session attributed to a project — either a live terminal or an AI
+ * session reconstructed from its touched files.
+ */
+interface SessionLite {
+  /**
+   * Number of distinct files this session touched **under this project
+   * root**. Zero for terminal-sourced rows.
+   */
+  filesTouched: number;
+  /**
+   * `task_runs.id` for AI sessions, the terminal id for live terminals.
+   */
+  id: string;
+  /**
+   * Unix epoch milliseconds of the most recent observed activity —
+   * `max(recorded_at)` over the session's touched files, or the
+   * terminal's creation time.
+   */
+  lastActivityMs?: number | null;
+  /**
+   * Session name — `task_runs.task_name` or the terminal's title.
+   */
+  name?: string | null;
+  source: SessionSource;
+  /**
+   * `task_runs.status` ("running", "completed", …) for AI sessions;
+   * `None` for terminals (liveness is `is_alive` in the terminal list).
+   */
+  status?: string | null;
+  /**
+   * Working directory, when known (terminal sessions always carry one).
+   */
+  workingDir?: string | null;
+}
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+
+
+/**
+ * The joined dashboard view of one project.
+ *
+ * Every field on both the grid card and the detail page is a projection of
+ * this single struct — computed server-side in one call so the page never
+ * fans out.
+ */
+interface ProjectSnapshot {
+  /**
+   * Git state of the root, when it is a git working tree.
+   */
+  git?: GitLite | null;
+  /**
+   * The project's traffic light.
+   */
+  health?: HealthLite & {};
+  /**
+   * Unix epoch milliseconds of the newest activity of any kind.
+   */
+  lastActivityMs?: number | null;
+  /**
+   * Live terminal sessions whose `working_dir` is under the project root.
+   */
+  liveSessions: SessionLite[];
+  /**
+   * Managed processes whose `cwd` is under the project root.
+   */
+  processes: ProcessStatusLite[];
+  project: SavedProject;
+  /**
+   * Questions waiting on the user, from `deferred_questions`.
+   */
+  questions: PendingQuestion[];
+  /**
+   * Recent AI sessions, newest first, attributed via
+   * `coord.session_touched_files`.
+   */
+  recentSessions: SessionLite[];
+  /**
+   * Rolling 7-day spend attributed to this project, in USD. `None` when
+   * cost data is unavailable — distinct from `Some(0.0)`, which means
+   * "measured, and it was free".
+   */
+  spend7dUsd?: number | null;
+}
+
 /* eslint-disable */
 /**
  * This file was automatically generated.
@@ -1553,4 +1964,4 @@ declare const DETECTION_METHODS: {
     label: string;
 }[];
 
-export { type AcceptanceCriteriaData, type AlertData, type CanvasComponentType, type CanvasPanel, type CanvasUpdateEvent, type ChecklistData, type CodeDiffData, type ComponentRenderLogEntry, type CostBreakdownData, type CreateKnownIssueRequest, type CreatePatternTemplateRequest, type CreateRenderLogRequest, DETECTION_METHODS, type DependencyGraphData, type DetectionMethod, type DiscoveredState, type DiscoveredStateImage, type DiscoveredTransition, type DiscoveryBoundingBox, type DiscoverySourceType, type DiscoveryTransitionTrigger, type DomElementSnapshot, type DomMutationType, type DomSnapshot, type DomSnapshotRenderLogEntry, type ElementRect, type FileTreeData, type FindingListData, type FormSnapshot, ISSUE_CATEGORIES, ISSUE_SEVERITIES, type ImageSnapshot, type IssueCategory, type IssuePatternTemplate, type IssueProvenance, type IssueStatus, type IterationComparisonData, type KeyValueData, type KnownIssue, type KnownIssueSeverity, type LinkSnapshot, type ListKnownIssuesQuery, type MarkdownData, type MemoryListQuery, type MemoryListResponse, type MemoryRestoreRequest, type MemoryRow, type MemorySummary, type MemoryUpsertRequest, type MemoryUpsertResponse, type MemoryWithHistory, type MissionBriefData, type PhaseDistributionData, type PhaseTimelineData, type ProgressChartData, type ProposalStatus, type RenderLogEntry, type RenderLogEntryBase, type RenderLogList, type RenderLogResponse, type RenderLogStats, type RenderLogSummary, type RenderLogTrigger, SOURCE_TYPE_COLORS, SOURCE_TYPE_LABELS, type ScopeType, type SparklineData, type SpecValidation, type StateDiscoveryResult, type StateDiscoveryResultCreate, type StateDiscoveryResultListResponse, type StateDiscoveryResultSummary, type StateDiscoveryResultUpdate, type StateMachineExport, type StateMachineImport, type StateTimelineData, type StepDurationChartData, type SummaryStatsData, type TableData, type TemplateParameter, type TerminalData, type TimelineData, type TransitionTriggerType, type UpdateKnownIssueRequest, type WaffleChartData, type WaterfallData, isComponentRenderLog, isDomSnapshotRenderLog, toDiscoveredState, toDiscoveredStateImage, toDiscoveredTransition, toStateDiscoveryResult, toStateDiscoveryResultSummary };
+export { type AcceptanceCriteriaData, type AlertData, type CanvasComponentType, type CanvasPanel, type CanvasUpdateEvent, type ChecklistData, type CodeDiffData, type ComponentRenderLogEntry, type CostBreakdownData, type CreateKnownIssueRequest, type CreatePatternTemplateRequest, type CreateRenderLogRequest, DETECTION_METHODS, type DependencyGraphData, type DetectionMethod, type DiscoveredState, type DiscoveredStateImage, type DiscoveredTransition, type DiscoveryBoundingBox, type DiscoverySourceType, type DiscoveryTransitionTrigger, type DomElementSnapshot, type DomMutationType, type DomSnapshot, type DomSnapshotRenderLogEntry, type ElementRect, type FileTreeData, type FindingListData, type FormSnapshot, type GitCommitLite, type GitLite, type HealthLevel, type HealthLite, ISSUE_CATEGORIES, ISSUE_SEVERITIES, type ImageSnapshot, type IssueCategory, type IssuePatternTemplate, type IssueProvenance, type IssueStatus, type IterationComparisonData, type KeyValueData, type KnownIssue, type KnownIssueSeverity, type LinkSnapshot, type ListKnownIssuesQuery, type MarkdownData, type MemoryListQuery, type MemoryListResponse, type MemoryRestoreRequest, type MemoryRow, type MemorySummary, type MemoryUpsertRequest, type MemoryUpsertResponse, type MemoryWithHistory, type MissionBriefData, type PendingQuestion, type PhaseDistributionData, type PhaseTimelineData, type ProcessStatusLite, type ProgressChartData, type ProjectSnapshot, type ProposalStatus, type RenderLogEntry, type RenderLogEntryBase, type RenderLogList, type RenderLogResponse, type RenderLogStats, type RenderLogSummary, type RenderLogTrigger, SOURCE_TYPE_COLORS, SOURCE_TYPE_LABELS, type SavedProject, type ScopeType, type SessionLite, type SessionSource, type SparklineData, type SpecValidation, type StateDiscoveryResult, type StateDiscoveryResultCreate, type StateDiscoveryResultListResponse, type StateDiscoveryResultSummary, type StateDiscoveryResultUpdate, type StateMachineExport, type StateMachineImport, type StateTimelineData, type StepDurationChartData, type SummaryStatsData, type TableData, type TemplateParameter, type TerminalData, type TimelineData, type TransitionTriggerType, type UpdateKnownIssueRequest, type WaffleChartData, type WaterfallData, isComponentRenderLog, isDomSnapshotRenderLog, toDiscoveredState, toDiscoveredStateImage, toDiscoveredTransition, toStateDiscoveryResult, toStateDiscoveryResultSummary };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/shared-types",
-  "version": "0.8.1",
+  "version": "0.12.0",
   "description": "Shared TypeScript types for the Qontinui ecosystem",
   "type": "module",
   "main": "./dist/index.js",

package/src/generated/AgentCommand.d.ts

@@ -0,0 +1,81 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * An account-scoped **override** of a runner-embedded default agent command.
+ *
+ * Presence of this record means "this organization has customized the command
+ * named `name`"; absence means the embedded default applies. See the module
+ * docs for the full resolution order and the delete-is-reset semantics.
+ *
+ * `body` is the whole markdown procedure — the exact bytes written to
+ * `.claude/commands/<name>.md`. It is **untrusted remote content** from the
+ * runner's point of view: it is markdown rather than code, but it is
+ * instructions to an agent, so consumers fail soft (a malformed override falls
+ * back to the embedded default and warns) and never fetch cross-org.
+ */
+export interface AgentCommand {
+  /**
+   * The full markdown body of the command.
+   */
+  body: string;
+  /**
+   * Content hash of [`body`](Self::body), for cheap change detection
+   * (cache invalidation, diff-against-default). `None` on rows written
+   * before a checksum was computed.
+   *
+   * Computed by [`agent_command_checksum`] — `"sha256-<hex>"` over the
+   * LF-normalized body. Do not hand-roll it; a producer that hashes raw
+   * bytes disagrees with one that hashes a CRLF round-trip.
+   */
+  checksum?: string | null;
+  /**
+   * ISO 8601 (RFC 3339) creation timestamp.
+   */
+  created_at: string;
+  /**
+   * User who last authored this override. **Attribution only** — it does not
+   * scope visibility; [`organization_id`](Self::organization_id) does.
+   */
+  created_by_user_id?: string | null;
+  /**
+   * Head of the version chain — the `version_number` of the
+   * [`AgentCommandVersion`] whose body this record currently carries.
+   * Starts at 1 and only ever increases (a revert bumps it; see the module
+   * docs).
+   */
+  current_version: number;
+  /**
+   * Override record id (UUID v4 string).
+   */
+  id: string;
+  /**
+   * Whether this override is visible to the whole organization rather than
+   * only its author. Absent means `false`.
+   */
+  is_shared: boolean;
+  /**
+   * The command slug, e.g. `vet-plan` or `implement-plan`. This is the
+   * override key: it must equal the name of the embedded default it
+   * replaces, and it is the filename stem under `.claude/commands/`.
+   *
+   * Because it becomes a path component, it is a write-boundary value —
+   * validate it with [`validate_agent_command_name`] before persisting.
+   */
+  name: string;
+  /**
+   * Owning organization (`auth.organizations.id`). `None` where the row has
+   * been orphaned by an organization deletion (`ondelete SET NULL`); such a
+   * row is not resolvable by any account and behaves as no override.
+   */
+  organization_id?: string | null;
+  /**
+   * ISO 8601 (RFC 3339) last-modification timestamp.
+   */
+  updated_at: string;
+  [k: string]: unknown;
+}

package/src/generated/AgentCommandError.d.ts

@@ -0,0 +1,23 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Failure modes for agent-command overrides. Mirrors the tagged-enum shape of
+ * [`crate::apps::AppError`], so the qontinui-web layer can surface a rejected
+ * override the same way it surfaces a rejected app registration.
+ */
+export type AgentCommandError =
+  | {
+      name: string;
+      reason: "invalid-name";
+      [k: string]: unknown;
+    }
+  | {
+      name: string;
+      reason: "reserved-name";
+      [k: string]: unknown;
+    };

package/src/generated/AgentCommandVersion.d.ts

@@ -0,0 +1,67 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * One immutable entry in an [`AgentCommand`]'s append-only version chain.
+ *
+ * Rows are **only ever inserted**. An edit appends the next `version_number`;
+ * a revert appends a new version whose `body` is copied from an older one and
+ * whose [`restored_from`](Self::restored_from) names that older version.
+ * Nothing in the chain is updated or deleted, so the chain is the complete
+ * edit history and "revert" is itself a recorded edit.
+ */
+export interface AgentCommandVersion {
+  /**
+   * The [`AgentCommand`] this version belongs to. Deleting the override
+   * cascades to its versions — resetting to the default discards the
+   * account's edit history along with the override.
+   */
+  agent_command_id: string;
+  /**
+   * The full markdown body as of this version.
+   */
+  body: string;
+  /**
+   * Free-text note describing what changed, supplied by the editor. Revert
+   * writes a generated one (e.g. `"Restored from version 2"`).
+   */
+  change_description?: string | null;
+  /**
+   * Content hash of [`body`](Self::body) at this version, from
+   * [`agent_command_checksum`]. Equal checksums on two versions mean the
+   * bodies are identical — which is what lets the UI show a revert as
+   * "back to v2's content" without refetching either body.
+   */
+  checksum?: string | null;
+  /**
+   * ISO 8601 (RFC 3339) creation timestamp. Versions are immutable, so
+   * there is deliberately no `updated_at`.
+   */
+  created_at: string;
+  /**
+   * User who authored this version. Attribution only.
+   */
+  created_by_user_id?: string | null;
+  /**
+   * Version-row id (UUID v4 string).
+   */
+  id: string;
+  /**
+   * Provenance for a revert: the `version_number` this version's body was
+   * copied from. `None` for an ordinary edit. Present only on versions
+   * produced by a restore, which is how the UI distinguishes "edited" from
+   * "reverted to v2" in the history list.
+   */
+  restored_from?: number | null;
+  /**
+   * Monotonic version number within this command, starting at 1. Unique per
+   * `(agent_command_id, version_number)`; the DB constraint — not
+   * application code — is what rejects a duplicate under concurrent appends.
+   */
+  version_number: number;
+  [k: string]: unknown;
+}

package/src/generated/App.d.ts

@@ -7,10 +7,44 @@
 
 export interface App {
   appId: string;
+  /**
+   * Whether this app requires authentication before spec checks.
+   * If true, workflows will auto-inject an auth setup step.
+   */
+  authRequired: boolean;
+  /**
+   * Build command to run after pulling updated source (P3 auto-fresh).
+   * Ignored if `update_strategy` is "pull_only". Optional; if None,
+   * the auto-fresh engine skips build and goes straight to start_command.
+   */
+  buildCommand?: string | null;
   createdAtMs: number;
   displayName: string;
   lastSeenAtMs: number;
+  /**
+   * Red threshold for spec match rates (0.0–1.0). Match rates below this are Red (fail).
+   * Must be less than `yellow_threshold`. Defaults to 0.5.
+   */
+  redThreshold: number;
   repoRoot: string;
+  /**
+   * Start command to run after a successful build (P3 auto-fresh).
+   * Restarts the deployed instance and updates app_deploy_state.
+   * Ignored if `update_strategy` is "pull_only". Optional.
+   */
+  startCommand?: string | null;
   uiBridgeUrl: string;
+  /**
+   * Auto-fresh update strategy: "pull_only" (pull code, no restart) or
+   * "pull_build" (pull, run build_command, run start_command). Used by the
+   * runner's P3 auto-fresh engine to decide what actions to take when
+   * pulling updated source code. Defaults to "pull_only".
+   */
+  updateStrategy: string;
+  /**
+   * Yellow threshold for spec match rates (0.0–1.0). Match rates >= this are Green (pass),
+   * below are Yellow (warn). Must be greater than `red_threshold`. Defaults to 0.8.
+   */
+  yellowThreshold: number;
   [k: string]: unknown;
 }

package/src/generated/AppError.d.ts

@@ -30,4 +30,9 @@ export type AppError =
       appId: string;
       reason: "already-registered";
       [k: string]: unknown;
+    }
+  | {
+      reason: "invalid-update-strategy";
+      updateStrategy: string;
+      [k: string]: unknown;
     };