@qontinui/shared-types 0.8.1 → 0.12.0

package/dist/index.d.cts

@@ -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 };