@jingyi0605/codingns 0.1.5 → 0.2.5

package/dist/server/storage/sqlite/schema.sql

@@ -38,11 +38,59 @@ CREATE TABLE IF NOT EXISTS workspaces (
   path TEXT NOT NULL UNIQUE,
   repo_root TEXT,
   favorite INTEGER NOT NULL DEFAULT 0 CHECK (favorite IN (0, 1)),
+  sort_order INTEGER NOT NULL DEFAULT 0,
   created_at TEXT NOT NULL,
   updated_at TEXT NOT NULL,
   removed_at TEXT
 );
 
+CREATE TABLE IF NOT EXISTS workspace_navigation_states (
+  workspace_id TEXT NOT NULL,
+  user_id TEXT NOT NULL,
+  collapsed INTEGER NOT NULL DEFAULT 0 CHECK (collapsed IN (0, 1)),
+  background_color TEXT,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (workspace_id, user_id),
+  FOREIGN KEY (workspace_id) REFERENCES workspaces(id),
+  FOREIGN KEY (user_id) REFERENCES auth_users(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_workspace_navigation_states_user_id
+  ON workspace_navigation_states(user_id, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS workspace_worktrees (
+  workspace_id TEXT PRIMARY KEY,
+  root_workspace_id TEXT NOT NULL,
+  parent_workspace_id TEXT NOT NULL,
+  source_workspace_id TEXT NOT NULL,
+  merge_target_workspace_id TEXT NOT NULL,
+  branch_name TEXT NOT NULL,
+  base_ref TEXT NOT NULL,
+  base_commit TEXT NOT NULL,
+  head_commit TEXT,
+  display_name TEXT NOT NULL,
+  depth INTEGER NOT NULL CHECK (depth >= 1),
+  lifecycle_status TEXT NOT NULL CHECK (
+    lifecycle_status IN ('active', 'merged', 'abandoned', 'removing', 'removed')
+  ),
+  merged_at TEXT,
+  removed_at TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (workspace_id) REFERENCES workspaces(id) ON DELETE CASCADE,
+  FOREIGN KEY (root_workspace_id) REFERENCES workspaces(id),
+  FOREIGN KEY (parent_workspace_id) REFERENCES workspaces(id),
+  FOREIGN KEY (source_workspace_id) REFERENCES workspaces(id),
+  FOREIGN KEY (merge_target_workspace_id) REFERENCES workspaces(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_workspace_worktrees_root_workspace_id
+  ON workspace_worktrees(root_workspace_id, depth ASC, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_workspace_worktrees_parent_workspace_id
+  ON workspace_worktrees(parent_workspace_id, updated_at DESC);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_workspace_worktrees_root_branch_name
+  ON workspace_worktrees(root_workspace_id, branch_name);
+
 CREATE TABLE IF NOT EXISTS commit_rule_profiles (
   id TEXT PRIMARY KEY,
   workspace_id TEXT NOT NULL UNIQUE,
@@ -76,6 +124,9 @@ CREATE TABLE IF NOT EXISTS session_indices (
   workspace_id TEXT NOT NULL,
   provider TEXT NOT NULL,
   parent_session_id TEXT,
+  session_kind TEXT NOT NULL DEFAULT 'default' CHECK (session_kind IN ('default', 'annotation')),
+  annotation_source_message_id TEXT,
+  annotation_source_text TEXT,
   is_subagent INTEGER NOT NULL DEFAULT 0 CHECK (is_subagent IN (0, 1)),
   subagent_label TEXT,
   title TEXT NOT NULL,
@@ -90,6 +141,33 @@ CREATE TABLE IF NOT EXISTS session_indices (
 
 CREATE INDEX IF NOT EXISTS idx_session_indices_workspace_id ON session_indices(workspace_id);
 
+CREATE TABLE IF NOT EXISTS session_forks (
+  session_id TEXT PRIMARY KEY,
+  parent_session_id TEXT NOT NULL,
+  provider TEXT NOT NULL,
+  fork_source_type TEXT NOT NULL CHECK (fork_source_type IN ('session', 'message')),
+  fork_source_session_id TEXT NOT NULL,
+  fork_source_message_id TEXT,
+  inherited_prefix_message_count INTEGER NOT NULL DEFAULT 0,
+  provider_parent_session_id TEXT,
+  provider_source_message_id TEXT,
+  fork_method TEXT NOT NULL CHECK (
+    fork_method IN (
+      'native_session_fork',
+      'native_message_fork',
+      'reconstructed_session_fork',
+      'reconstructed_message_fork'
+    )
+  ),
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (session_id) REFERENCES session_bindings(session_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_session_forks_parent_session_id
+  ON session_forks(parent_session_id);
+CREATE INDEX IF NOT EXISTS idx_session_forks_source_message_id
+  ON session_forks(fork_source_message_id);
+
 CREATE TABLE IF NOT EXISTS session_changed_files (
   session_id TEXT NOT NULL,
   workspace_id TEXT NOT NULL,
@@ -241,6 +319,21 @@ CREATE TABLE IF NOT EXISTS user_preference_profiles (
   FOREIGN KEY (user_id) REFERENCES auth_users(id)
 );
 
+CREATE TABLE IF NOT EXISTS git_remote_credentials (
+  user_id TEXT NOT NULL,
+  remote_url TEXT NOT NULL,
+  auth_mode TEXT NOT NULL CHECK (auth_mode IN ('basic', 'token')),
+  username_ciphertext TEXT NOT NULL,
+  secret_ciphertext TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (user_id, remote_url),
+  FOREIGN KEY (user_id) REFERENCES auth_users(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_git_remote_credentials_user_updated_at
+  ON git_remote_credentials(user_id, updated_at DESC);
+
 CREATE TABLE IF NOT EXISTS session_file_context_bindings (
   id TEXT PRIMARY KEY,
   session_id TEXT NOT NULL,
@@ -285,6 +378,20 @@ CREATE TABLE IF NOT EXISTS terminal_instances (
   closed_at TEXT,
   exit_code INTEGER,
   status_detail TEXT,
+  debug_runtime_session_id TEXT,
+  debug_target_id TEXT,
+  debug_service_id TEXT,
+  framework_analysis_id TEXT,
+  launcher_source_type TEXT CHECK (
+    launcher_source_type IS NULL OR launcher_source_type IN ('manual', 'debug_service')
+  ),
+  launch_stage TEXT,
+  failure_stage TEXT,
+  adapter_kind TEXT CHECK (
+    adapter_kind IS NULL OR adapter_kind IN ('cli', 'env', 'override', 'ai_fallback')
+  ),
+  env_patch_summary_json TEXT,
+  artifact_ref TEXT,
   FOREIGN KEY (workspace_id) REFERENCES workspaces(id),
   FOREIGN KEY (created_by_user_id) REFERENCES auth_users(id)
 );
@@ -376,6 +483,23 @@ CREATE TABLE IF NOT EXISTS terminal_command_templates (
       'conpty-git-bash'
     )
   ),
+  source_type TEXT CHECK (
+    source_type IS NULL OR source_type IN ('manual', 'debug_service')
+  ),
+  debug_target_id TEXT,
+  debug_service_id TEXT,
+  framework_analysis_id TEXT,
+  adapter_kind TEXT CHECK (
+    adapter_kind IS NULL OR adapter_kind IN ('cli', 'env', 'override', 'ai_fallback')
+  ),
+  injection_mode TEXT CHECK (
+    injection_mode IS NULL OR injection_mode IN ('cli', 'env', 'override', 'none')
+  ),
+  generated_artifact_ref TEXT,
+  service_discovery_mode TEXT CHECK (
+    service_discovery_mode IS NULL OR service_discovery_mode IN ('same_origin', 'api_base_url', 'none')
+  ),
+  managed_by_system INTEGER NOT NULL DEFAULT 0 CHECK (managed_by_system IN (0, 1)),
   created_at TEXT NOT NULL,
   updated_at TEXT NOT NULL,
   FOREIGN KEY (workspace_id) REFERENCES workspaces(id),
@@ -385,6 +509,150 @@ CREATE TABLE IF NOT EXISTS terminal_command_templates (
 CREATE INDEX IF NOT EXISTS idx_terminal_templates_workspace_id
   ON terminal_command_templates(workspace_id);
 
+CREATE TABLE IF NOT EXISTS debug_targets (
+  id TEXT PRIMARY KEY,
+  workspace_id TEXT NOT NULL,
+  root_path TEXT NOT NULL,
+  display_name TEXT NOT NULL,
+  stack_hint TEXT,
+  source_type TEXT NOT NULL CHECK (source_type IN ('repo', 'worktree')),
+  root_workspace_id TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (workspace_id) REFERENCES workspaces(id),
+  FOREIGN KEY (root_workspace_id) REFERENCES workspaces(id),
+  UNIQUE (workspace_id, root_path)
+);
+
+CREATE INDEX IF NOT EXISTS idx_debug_targets_workspace_id
+  ON debug_targets(workspace_id, updated_at DESC, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS debug_services (
+  id TEXT PRIMARY KEY,
+  target_id TEXT NOT NULL,
+  role TEXT NOT NULL CHECK (role IN ('frontend', 'backend', 'worker', 'mock', 'custom')),
+  name TEXT NOT NULL,
+  cwd TEXT NOT NULL,
+  command TEXT NOT NULL,
+  args_json TEXT NOT NULL,
+  env_json TEXT NOT NULL,
+  default_port_hint INTEGER,
+  protocol TEXT CHECK (protocol IS NULL OR protocol IN ('http', 'ws', 'tcp')),
+  health_path TEXT,
+  adapter_kind TEXT CHECK (
+    adapter_kind IS NULL OR adapter_kind IN ('cli', 'env', 'override', 'ai_fallback')
+  ),
+  framework_analysis_id TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (target_id) REFERENCES debug_targets(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_debug_services_target_id
+  ON debug_services(target_id, updated_at DESC, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS framework_analysis_results (
+  id TEXT PRIMARY KEY,
+  target_id TEXT NOT NULL,
+  service_id TEXT,
+  primary_framework TEXT,
+  confidence TEXT NOT NULL CHECK (confidence IN ('high', 'medium', 'low')),
+  compatibility_level TEXT NOT NULL CHECK (
+    compatibility_level IN ('supported', 'conditional', 'unsupported', 'unknown')
+  ),
+  recommended_injection_mode TEXT CHECK (
+    recommended_injection_mode IS NULL OR recommended_injection_mode IN ('cli', 'env', 'override', 'none')
+  ),
+  requires_service_discovery_handling INTEGER NOT NULL CHECK (
+    requires_service_discovery_handling IN (0, 1)
+  ),
+  requires_hmr_handling INTEGER NOT NULL CHECK (requires_hmr_handling IN (0, 1)),
+  requires_callback_handling INTEGER NOT NULL CHECK (requires_callback_handling IN (0, 1)),
+  ai_fallback_policy TEXT NOT NULL CHECK (ai_fallback_policy IN ('never', 'conditional', 'allowed')),
+  reasons_json TEXT NOT NULL,
+  detected_files_json TEXT NOT NULL DEFAULT '[]',
+  raw_evidence_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (target_id) REFERENCES debug_targets(id) ON DELETE CASCADE,
+  FOREIGN KEY (service_id) REFERENCES debug_services(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_framework_analysis_results_target_id
+  ON framework_analysis_results(target_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_framework_analysis_results_service_id
+  ON framework_analysis_results(service_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS debug_runtime_sessions (
+  id TEXT PRIMARY KEY,
+  target_id TEXT NOT NULL,
+  status TEXT NOT NULL CHECK (status IN ('PREPARING', 'RUNNING', 'FAILED', 'STOPPED')),
+  failure_stage TEXT,
+  started_at TEXT,
+  stopped_at TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (target_id) REFERENCES debug_targets(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_debug_runtime_sessions_target_id
+  ON debug_runtime_sessions(target_id, updated_at DESC, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS port_leases (
+  id TEXT PRIMARY KEY,
+  runtime_id TEXT NOT NULL,
+  service_id TEXT NOT NULL,
+  port INTEGER NOT NULL,
+  protocol TEXT NOT NULL CHECK (protocol IN ('tcp', 'udp')),
+  status TEXT NOT NULL CHECK (status IN ('LEASED', 'RELEASING', 'RELEASED', 'STALE')),
+  leased_at TEXT NOT NULL,
+  expires_at TEXT,
+  released_at TEXT,
+  FOREIGN KEY (runtime_id) REFERENCES debug_runtime_sessions(id) ON DELETE CASCADE,
+  FOREIGN KEY (service_id) REFERENCES debug_services(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_port_leases_runtime_id
+  ON port_leases(runtime_id, leased_at DESC);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_port_leases_active_port
+  ON port_leases(port, protocol)
+  WHERE status IN ('LEASED', 'RELEASING');
+
+CREATE TABLE IF NOT EXISTS runtime_bindings (
+  id TEXT PRIMARY KEY,
+  runtime_id TEXT NOT NULL,
+  service_id TEXT NOT NULL,
+  process_instance_id TEXT,
+  expected_port INTEGER,
+  leased_port INTEGER,
+  observed_port INTEGER,
+  proxy_path TEXT,
+  status TEXT NOT NULL CHECK (status IN ('ALLOCATED', 'LISTENING', 'FAILED', 'RELEASED')),
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (runtime_id) REFERENCES debug_runtime_sessions(id) ON DELETE CASCADE,
+  FOREIGN KEY (service_id) REFERENCES debug_services(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_runtime_bindings_runtime_id
+  ON runtime_bindings(runtime_id, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS ai_fallback_edits (
+  id TEXT PRIMARY KEY,
+  runtime_id TEXT NOT NULL,
+  service_id TEXT NOT NULL,
+  reason TEXT NOT NULL,
+  allowed_files_json TEXT NOT NULL,
+  target_port INTEGER NOT NULL,
+  patch_ref TEXT,
+  rollback_ref TEXT,
+  status TEXT NOT NULL CHECK (status IN ('PENDING', 'APPLIED', 'ROLLED_BACK', 'REJECTED')),
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (runtime_id) REFERENCES debug_runtime_sessions(id) ON DELETE CASCADE,
+  FOREIGN KEY (service_id) REFERENCES debug_services(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_ai_fallback_edits_runtime_id
+  ON ai_fallback_edits(runtime_id, created_at DESC);
+
 CREATE TABLE IF NOT EXISTS butler_profiles (
   id TEXT PRIMARY KEY CHECK (id = 'default'),
   display_name TEXT NOT NULL,

package/dist/server/types/domain.d.ts

@@ -1,4 +1,4 @@
-import type { ProviderId, SyncStatus } from "@codingns/session-sync-core";
+import type { ForkMethod, ForkSourceType, ProviderId, SyncStatus } from "@codingns/session-sync-core";
 export type SessionRunningState = "idle" | "starting" | "running" | "completed" | "interrupted" | "failed";
 export type SessionResolvedRunningState = SessionRunningState | "stale" | "unknown";
 export type SessionActivityState = "idle" | "running" | "completed_unread";
@@ -33,11 +33,39 @@ export interface Workspace {
     name: string;
     path: string;
     repoRoot: string | null;
+    backgroundColor?: string | null;
     favorite: boolean;
+    sortOrder: number;
     createdAt: string;
     updatedAt: string;
     removedAt?: string | null;
 }
+export type WorkspaceWorktreeLifecycleStatus = "active" | "merged" | "abandoned" | "removing" | "removed";
+export interface WorkspaceWorktreeRecord {
+    workspaceId: string;
+    rootWorkspaceId: string;
+    parentWorkspaceId: string;
+    sourceWorkspaceId: string;
+    mergeTargetWorkspaceId: string;
+    branchName: string;
+    baseRef: string;
+    baseCommit: string;
+    headCommit: string | null;
+    displayName: string;
+    depth: number;
+    lifecycleStatus: WorkspaceWorktreeLifecycleStatus;
+    mergedAt: string | null;
+    removedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WorkspaceNavigationStateRecord {
+    workspaceId: string;
+    userId: string;
+    collapsed: boolean;
+    backgroundColor: string | null;
+    updatedAt: string;
+}
 export interface SessionBinding {
     sessionId: string;
     workspaceId: string;
@@ -52,6 +80,9 @@ export interface SessionIndexRecord {
     workspaceId: string;
     provider: ProviderId;
     parentSessionId?: string | null;
+    sessionKind?: "default" | "annotation";
+    annotationSourceMessageId?: string | null;
+    annotationSourceText?: string | null;
     isSubagent?: boolean;
     subagentLabel?: string | null;
     title: string;
@@ -61,6 +92,19 @@ export interface SessionIndexRecord {
     createdAt: string;
     updatedAt: string;
 }
+export interface SessionForkRecord {
+    sessionId: string;
+    parentSessionId: string;
+    provider: ProviderId;
+    forkSourceType: ForkSourceType;
+    forkSourceSessionId: string;
+    forkSourceMessageId: string | null;
+    inheritedPrefixMessageCount: number;
+    providerParentSessionId: string | null;
+    providerSourceMessageId: string | null;
+    forkMethod: ForkMethod;
+    createdAt: string;
+}
 export interface SessionChangedFileRecord {
     sessionId: string;
     workspaceId: string;
@@ -142,6 +186,14 @@ export interface SessionListItem {
     providerSessionId: string;
     rawStoreRef: string;
     parentSessionId?: string | null;
+    sessionKind?: "default" | "annotation";
+    annotationSourceMessageId?: string | null;
+    annotationSourceText?: string | null;
+    forkMethod?: ForkMethod | null;
+    forkSourceType?: ForkSourceType | null;
+    forkSourceSessionId?: string | null;
+    forkSourceMessageId?: string | null;
+    inheritedPrefixMessageCount?: number | null;
     isSubagent?: boolean;
     subagentLabel?: string | null;
     isArchived: boolean;
@@ -229,6 +281,15 @@ export interface UserPreferenceProfileRecord extends UserPreferenceProfile {
     createdAt: string;
     updatedAt: string;
 }
+export interface GitRemoteCredentialRecord {
+    userId: string;
+    remoteUrl: string;
+    authMode: "basic" | "token";
+    usernameCiphertext: string;
+    secretCiphertext: string;
+    createdAt: string;
+    updatedAt: string;
+}
 export type ButlerProfileProviderId = "codex" | "claude-code";
 export type ButlerAgentsMode = "inline" | "file";
 export type ButlerControlSessionStatus = "idle" | "running" | "failed" | "closed";
@@ -493,6 +554,181 @@ export interface FileContextBinding {
     attachedBy: string;
     attachedAt: string;
 }
+export type DebugTargetSourceType = "repo" | "worktree";
+export type DebugServiceRole = "frontend" | "backend" | "worker" | "mock" | "custom";
+export type DebugServiceProtocol = "http" | "ws" | "tcp";
+export type FrameworkAnalysisConfidence = "high" | "medium" | "low";
+export type FrameworkCompatibilityLevel = "supported" | "conditional" | "unsupported" | "unknown";
+export type DebugInjectionMode = "cli" | "env" | "override" | "ai_fallback" | "none";
+export type DebugAdapterKind = "cli" | "env" | "override" | "ai_fallback";
+export type DebugAiFallbackPolicy = "never" | "conditional" | "allowed";
+export type DebugRuntimeSessionStatus = "PREPARING" | "RUNNING" | "FAILED" | "STOPPED";
+export type RuntimeBindingStatus = "ALLOCATED" | "LISTENING" | "FAILED" | "RELEASED";
+export type PortLeaseStatus = "LEASED" | "RELEASING" | "RELEASED" | "STALE";
+export type AiFallbackEditStatus = "PENDING" | "APPLIED" | "ROLLED_BACK" | "REJECTED";
+export type DebugLaunchAdapterAttemptStatus = "selected" | "skipped" | "blocked" | "fallback_required";
+export type LauncherSourceType = "manual" | "debug_service";
+export type ServiceDiscoveryMode = "same_origin" | "api_base_url" | "none";
+export interface DebugTargetProfile {
+    id: string;
+    workspaceId: string;
+    rootPath: string;
+    displayName: string;
+    stackHint?: string | null;
+    sourceType: DebugTargetSourceType;
+    rootWorkspaceId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DebugServiceSpec {
+    id: string;
+    targetId: string;
+    role: DebugServiceRole;
+    name: string;
+    cwd: string;
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+    defaultPortHint?: number | null;
+    protocol?: DebugServiceProtocol | null;
+    healthPath?: string | null;
+    adapterKind?: DebugAdapterKind | null;
+    frameworkAnalysisId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface FrameworkAnalysisResult {
+    id: string;
+    targetId: string;
+    serviceId?: string | null;
+    primaryFramework?: string | null;
+    confidence: FrameworkAnalysisConfidence;
+    compatibilityLevel: FrameworkCompatibilityLevel;
+    recommendedInjectionMode?: DebugInjectionMode | null;
+    requiresServiceDiscoveryHandling: boolean;
+    requiresHmrHandling: boolean;
+    requiresCallbackHandling: boolean;
+    aiFallbackPolicy: DebugAiFallbackPolicy;
+    reasons: string[];
+    detectedFiles: string[];
+    rawEvidence?: Record<string, unknown>;
+    createdAt: string;
+}
+export interface DebugRuntimeSession {
+    id: string;
+    targetId: string;
+    status: DebugRuntimeSessionStatus;
+    failureStage?: string | null;
+    startedAt?: string | null;
+    stoppedAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface RuntimeBinding {
+    id: string;
+    runtimeId: string;
+    serviceId: string;
+    processInstanceId?: string | null;
+    expectedPort?: number | null;
+    leasedPort?: number | null;
+    observedPort?: number | null;
+    proxyPath?: string | null;
+    status: RuntimeBindingStatus;
+    updatedAt: string;
+}
+export interface PortLeaseRecord {
+    id: string;
+    runtimeId: string;
+    serviceId: string;
+    port: number;
+    protocol: "tcp" | "udp";
+    status: PortLeaseStatus;
+    leasedAt: string;
+    expiresAt?: string | null;
+    releasedAt?: string | null;
+}
+export interface AiFallbackEditRecord {
+    id: string;
+    runtimeId: string;
+    serviceId: string;
+    reason: string;
+    allowedFiles: string[];
+    targetPort: number;
+    patchRef?: string | null;
+    rollbackRef?: string | null;
+    status: AiFallbackEditStatus;
+    createdAt: string;
+}
+export interface FrameworkCompatibilityMatrixItem {
+    framework: string;
+    compatibilityLevel: FrameworkCompatibilityLevel;
+    recommendedInjectionMode: DebugInjectionMode;
+    requiresServiceDiscoveryHandling: boolean;
+    requiresHmrHandling: boolean;
+    requiresCallbackHandling: boolean;
+    aiFallbackPolicy: DebugAiFallbackPolicy;
+    notes: string;
+}
+export interface DebugLaunchAdapterAttempt {
+    kind: DebugAdapterKind;
+    status: DebugLaunchAdapterAttemptStatus;
+    reason: string;
+}
+export interface DebugAiFallbackSummary {
+    eligible: boolean;
+    editId: string | null;
+    status: AiFallbackEditStatus | null;
+    reason: string;
+    allowedFiles: string[];
+}
+export interface DebugLaunchPlanServiceItem {
+    serviceId: string;
+    role: DebugServiceRole;
+    frameworkAnalysisId: string | null;
+    primaryFramework: string | null;
+    compatibilityLevel: FrameworkCompatibilityLevel;
+    adapterKind: DebugAdapterKind | null;
+    injectionMode: DebugInjectionMode | null;
+    command: string;
+    args: string[];
+    envPatch: Record<string, string>;
+    expectedPort: number | null;
+    leasedPort: number | null;
+    artifactRef: string | null;
+    runtimeBindingId: string;
+    portLeaseId: string | null;
+    requiresServiceDiscoveryHandling: boolean;
+    requiresHmrHandling: boolean;
+    requiresCallbackHandling: boolean;
+    failureStage: string | null;
+    adapterAttempts: DebugLaunchAdapterAttempt[];
+    aiFallback: DebugAiFallbackSummary | null;
+    missingRequirements: string[];
+    autoStartAllowed: boolean;
+}
+export interface DebugLaunchPlan {
+    runtimeSession: DebugRuntimeSession;
+    targetId: string;
+    autoStartAllowed: boolean;
+    services: DebugLaunchPlanServiceItem[];
+}
+export interface DebugRuntimeDetailServiceItem {
+    service: DebugServiceSpec;
+    analysis: FrameworkAnalysisResult | null;
+    binding: RuntimeBinding | null;
+    portLease: PortLeaseRecord | null;
+    processInstance: TerminalInstance | null;
+    aiFallbackEdits: AiFallbackEditRecord[];
+}
+export interface DebugRuntimeDetail {
+    runtimeSession: DebugRuntimeSession;
+    target: DebugTargetProfile;
+    services: DebugRuntimeDetailServiceItem[];
+}
+export interface DebugRuntimeHistoryEnvelope {
+    targetId: string;
+    items: DebugRuntimeDetail[];
+}
 export type PersistentTerminalRuntimeType = "tmux" | "conpty-powershell" | "conpty-cmd" | "conpty-git-bash";
 export type TerminalRuntimeType = PersistentTerminalRuntimeType | "embedded-pty";
 export type TerminalStatus = "creating" | "running" | "closed" | "error";
@@ -514,6 +750,16 @@ export interface TerminalInstance {
     closedAt: string | null;
     exitCode: number | null;
     statusDetail: string | null;
+    debugRuntimeSessionId?: string | null;
+    debugTargetId?: string | null;
+    debugServiceId?: string | null;
+    frameworkAnalysisId?: string | null;
+    launcherSourceType?: LauncherSourceType | null;
+    launchStage?: string | null;
+    failureStage?: string | null;
+    adapterKind?: DebugAdapterKind | null;
+    envPatchSummary?: Record<string, unknown>;
+    artifactRef?: string | null;
 }
 export interface TerminalRuntimeSession {
     id: string;
@@ -584,6 +830,15 @@ export interface TerminalCommandTemplate {
     runtimeType: TerminalRuntimeType | null;
     createdAt: string;
     updatedAt: string;
+    sourceType?: LauncherSourceType | null;
+    debugTargetId?: string | null;
+    debugServiceId?: string | null;
+    frameworkAnalysisId?: string | null;
+    adapterKind?: DebugAdapterKind | null;
+    injectionMode?: DebugInjectionMode | null;
+    generatedArtifactRef?: string | null;
+    serviceDiscoveryMode?: ServiceDiscoveryMode | null;
+    managedBySystem?: boolean;
 }
 export interface TerminalTemplateRuntimeStatus {
     templateId: string;