@jingyi0605/codingns 0.2.0 → 0.3.0

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,
@@ -271,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,
@@ -315,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)
 );
@@ -406,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),
@@ -415,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,
@@ -721,6 +959,71 @@ CREATE INDEX IF NOT EXISTS idx_verification_runs_project_created_at
 CREATE INDEX IF NOT EXISTS idx_verification_runs_project_status
   ON verification_runs(project_id, status, created_at DESC);
 
+CREATE TABLE IF NOT EXISTS instance_tailscale_config (
+  id TEXT PRIMARY KEY CHECK (id = 'default'),
+  enabled INTEGER NOT NULL DEFAULT 0 CHECK (enabled IN (0, 1)),
+  control_server_url TEXT,
+  hostname TEXT,
+  state_dir TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS instance_tailscale_status (
+  id TEXT PRIMARY KEY CHECK (id = 'default'),
+  phase TEXT NOT NULL CHECK (
+    phase IN (
+      'disabled',
+      'blocked_uninitialized',
+      'starting',
+      'needs_login',
+      'running',
+      'stopping',
+      'error'
+    )
+  ),
+  connected INTEGER NOT NULL DEFAULT 0 CHECK (connected IN (0, 1)),
+  login_url TEXT,
+  control_server_url TEXT,
+  hostname TEXT,
+  account_name TEXT,
+  tailnet_fqdn TEXT,
+  tailnet_ipv4 TEXT,
+  tailnet_ipv6 TEXT,
+  reachable_base_url TEXT,
+  last_error TEXT,
+  observed_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS managed_skills (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  directory_name TEXT NOT NULL UNIQUE,
+  source_type TEXT NOT NULL CHECK (source_type IN ('builtin', 'local-import', 'managed-copy')),
+  source_path TEXT,
+  content_hash TEXT NOT NULL,
+  managed_state TEXT NOT NULL CHECK (managed_state IN ('active', 'conflicted', 'missing')),
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_managed_skills_state
+  ON managed_skills(managed_state, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS skill_target_bindings (
+  skill_id TEXT NOT NULL,
+  target_cli TEXT NOT NULL CHECK (target_cli IN ('codex', 'claude-code', 'gemini', 'opencode')),
+  enabled INTEGER NOT NULL DEFAULT 1 CHECK (enabled IN (0, 1)),
+  sync_status TEXT NOT NULL CHECK (sync_status IN ('synced', 'pending', 'failed', 'conflicted')),
+  last_synced_at TEXT,
+  last_error_code TEXT,
+  last_error_detail TEXT,
+  PRIMARY KEY (skill_id, target_cli),
+  FOREIGN KEY (skill_id) REFERENCES managed_skills(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_skill_target_bindings_target_cli
+  ON skill_target_bindings(target_cli, sync_status, enabled);
+
 INSERT INTO bootstrap_state (id, initialized)
 VALUES ('default', 0)
 ON CONFLICT(id) DO NOTHING;

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

@@ -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;
@@ -253,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";
@@ -517,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";
@@ -538,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;
@@ -608,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;
@@ -617,3 +848,75 @@ export interface TerminalTemplateRuntimeStatus {
     processName: string | null;
     processCommandLine: string | null;
 }
+export type SkillSourceType = "builtin" | "local-import" | "managed-copy";
+export type ManagedSkillState = "active" | "conflicted" | "missing";
+export type SkillTargetCli = "codex" | "claude-code" | "gemini" | "opencode";
+export type SkillTargetSyncStatus = "synced" | "pending" | "failed" | "conflicted";
+export interface ManagedSkillRecord {
+    id: string;
+    name: string;
+    directoryName: string;
+    sourceType: SkillSourceType;
+    sourcePath: string | null;
+    contentHash: string;
+    managedState: ManagedSkillState;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SkillTargetBindingRecord {
+    skillId: string;
+    targetCli: SkillTargetCli;
+    enabled: boolean;
+    syncStatus: SkillTargetSyncStatus;
+    lastSyncedAt: string | null;
+    lastErrorCode: string | null;
+    lastErrorDetail: string | null;
+}
+export type SkillScanManagementState = "managed" | "unmanaged" | "conflicted";
+export interface SkillScanEntry {
+    targetCli: SkillTargetCli;
+    directoryPath: string;
+    directoryName: string;
+    name: string;
+    contentHash: string;
+    managementState: SkillScanManagementState;
+    managedSkillId: string | null;
+}
+export interface SkillScanDiagnostic {
+    targetCli: SkillTargetCli;
+    rootDir: string;
+    code: string;
+    detail: string;
+    directoryName: string | null;
+    directoryPath: string | null;
+    managedSkillId: string | null;
+}
+export interface SkillScanResult {
+    managed: SkillScanEntry[];
+    unmanaged: SkillScanEntry[];
+    conflicted: SkillScanEntry[];
+    diagnostics: SkillScanDiagnostic[];
+    scannedAt: string;
+}
+export type TailscalePhase = "disabled" | "blocked_uninitialized" | "starting" | "needs_login" | "running" | "stopping" | "error";
+export interface InstanceTailscaleConfig {
+    enabled: boolean;
+    controlServerUrl: string | null;
+    hostname: string | null;
+    stateDir: string;
+    updatedAt: string;
+}
+export interface InstanceTailscaleStatus {
+    phase: TailscalePhase;
+    connected: boolean;
+    loginUrl: string | null;
+    controlServerUrl: string | null;
+    hostname: string | null;
+    accountName: string | null;
+    tailnetFqdn: string | null;
+    tailnetIpv4: string | null;
+    tailnetIpv6: string | null;
+    reachableBaseUrl: string | null;
+    lastError: string | null;
+    observedAt: string | null;
+}