server.js

import http from 'node:http';
import { spawn } from 'node:child_process';
import { createHash, randomBytes, randomUUID, timingSafeEqual } from 'node:crypto';
import { appendFile, copyFile, mkdir, readFile, writeFile, stat, rename, readdir, unlink, statfs, readlink, realpath } from 'node:fs/promises';
import { chmodSync, copyFileSync, createReadStream, statSync } from 'node:fs';
import path from 'node:path';
import { fileURLToPath } from 'node:url';
import { createSerialExecutor, createSingleFlight } from './server-concurrency.js';
import { createSqliteMessageStore, stateMetadataSnapshot } from './state-store.js';
import { versionSessionStatus } from './session-status.js';
import { compactBriefMessages } from './public/brief-view.js';
import {
  SECRETARY_QUICK_TASKS,
  createSecretaryAuditEntry,
  normalizeSecretaryControl,
  normalizeSecretarySettings,
  parseSecretaryAudit,
  secretaryAutonomyPrompt,
  selectSecretaryTrigger,
  secretaryQuickPrompt
} from './secretary-agent.js';

const __dirname = path.dirname(fileURLToPath(import.meta.url));
const HOST = process.env.HOST || '127.0.0.1';
const PORT = Number(process.env.PORT || 7072);
const DATA_DIR = process.env.DATA_DIR || path.join(__dirname, 'data');
const PUBLIC_DIR = path.join(__dirname, 'public');
const STATE_FILE = path.join(DATA_DIR, 'state.json');
const MESSAGE_DB_FILE = path.join(DATA_DIR, 'messages.sqlite3');
const RESTART_MARKER_FILE = path.join(DATA_DIR, 'restart-marker.json');
const PASSWORD_FILE = path.join(DATA_DIR, 'admin-password.txt');
const SKILL_REGISTRY_FILE = path.join(DATA_DIR, 'skill-registry.json');
const SECRETARY_AUDIT_FILE = path.join(DATA_DIR, 'secretary-audit.jsonl');
const SECRETARY_PROJECT_DIR = path.resolve(process.env.SECRETARY_PROJECT_DIR || '/root/Projects/secretary-agent');
const SECRETARY_TASK_FILE = path.join(SECRETARY_PROJECT_DIR, 'data', 'tasks.json');
const UPLOAD_DIR = path.join(DATA_DIR, 'uploads');
const CODEX_HOME = process.env.CODEX_HOME || '/root/.codex';
const SKILL_ROOTS = (process.env.SKILL_ROOTS || `${path.join(CODEX_HOME, 'skills')},/root/.agents/skills`)
  .split(',')
  .map((item) => item.trim())
  .filter(Boolean);
const CODEX_BIN = process.env.CODEX_BIN || '/usr/bin/codex';
const CODEX_NODE = process.env.CODEX_NODE || process.execPath;
const CODEX_BIN_DIR = path.dirname(CODEX_BIN);
const COOKIE_NAME = 'cmc_session';
const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
const RUNTIME_DIR = path.join(__dirname, 'runtime');
const SERVICE_STARTED_AT = new Date().toISOString();
const DEFAULT_STORAGE_SETTINGS = {
  autoCleanup: false,
  uploadRetentionDays: 30,
  runtimeRetentionDays: 7,
  maxUploadMb: 1024
};
const DEFAULT_APP_UPDATE_SETTINGS = {
  autoUpdate: false,
  checkIntervalHours: 6
};
const MAX_SESSION_RUNS = 200;
const MAX_RUN_EVENTS = 80;
const MAX_AUDIT_EVENTS = 200;
const SMART_TAG_RULE_VERSION = 4;
const COMMAND_KILL_GRACE_MS = 3000;
const APP_UPDATE_CHECK_TIMEOUT_MS = 18000;
const APP_UPDATE_MANIFEST_URL = process.env.APP_UPDATE_MANIFEST_URL || process.env.UPDATE_MANIFEST_URL || '';
const CODEX_UPGRADE_TIMEOUT_MS = 10 * 60 * 1000;
const PROJECTS_ROOT = path.resolve(process.env.PROJECTS_ROOT || '/root/Projects');
const SITE_MOUNT_ROOT = path.resolve(process.env.SITE_MOUNT_ROOT || '/root/Projects');
const SITE_MOUNT_CANDIDATES = ['dist', 'build', 'out', 'site', 'preview', 'web', '.'];
const SITE_MOUNT_BLOCKED_PARTS = new Set(['.git', '.hg', '.svn', 'node_modules', 'data', 'runtime']);
const SITE_MOUNT_BLOCKED_FILES = new Set(['.env', '.env.local', '.env.production', '.env.development']);
const SITE_MOUNT_SAFE_EXTENSIONS = new Set([
  '.html', '.css', '.js', '.mjs', '.json', '.svg', '.png', '.jpg', '.jpeg', '.webp', '.gif',
  '.ico', '.txt', '.map', '.wasm', '.woff', '.woff2', '.ttf', '.otf', '.mp3', '.mp4', '.webm'
]);

const contentTypes = {
  '.html': 'text/html; charset=utf-8',
  '.css': 'text/css; charset=utf-8',
  '.js': 'text/javascript; charset=utf-8',
  '.mjs': 'text/javascript; charset=utf-8',
  '.json': 'application/json; charset=utf-8',
  '.svg': 'image/svg+xml; charset=utf-8',
  '.png': 'image/png',
  '.jpg': 'image/jpeg',
  '.jpeg': 'image/jpeg',
  '.webp': 'image/webp',
  '.gif': 'image/gif',
  '.ico': 'image/x-icon',
  '.txt': 'text/plain; charset=utf-8',
  '.map': 'application/json; charset=utf-8',
  '.wasm': 'application/wasm',
  '.woff': 'font/woff',
  '.woff2': 'font/woff2',
  '.ttf': 'font/ttf',
  '.otf': 'font/otf',
  '.mp3': 'audio/mpeg',
  '.mp4': 'video/mp4',
  '.webm': 'video/webm'
};

let adminPassword = '';
let state = {
  version: 1,
  nextSeq: 1,
  authSessions: {},
  sessions: {}
};
const clients = new Map();
const running = new Map();
const codexUsageCache = new Map();
const codexMessagesCache = new Map();
const runCodexImportSingleFlight = createSingleFlight();
const runStateWriteSerial = createSerialExecutor();
const secretaryAuditWriteSerial = createSerialExecutor();
const messageStore = createSqliteMessageStore({ databaseFile: MESSAGE_DB_FILE });
const clockTick = Number(process.env.CLK_TCK || 100);
let totalRequests = 0;
let activeRequests = 0;
let packageMetaCache = null;
let skillRegistry = {
  version: 1,
  roots: SKILL_ROOTS,
  skills: [],
  lastScanAt: '',
  scanStatus: 'idle',
  scanError: ''
};
let skillScanPromise = null;
let skillMaintenanceTimer = null;
let skillRegistryFileMtimeMs = 0;
let codexUpgradeTask = null;
let appUpdateTask = null;
let appUpdateMaintenanceTimer = null;
let appAutoUpdateInFlight = false;
let secretaryAutonomyTimer = null;
let secretaryAutonomyInFlight = false;

function commandPath() {
  const fallback = `/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:${CODEX_BIN_DIR}`;
  const value = process.env.PATH || fallback;
  return value.split(path.delimiter).includes(CODEX_BIN_DIR) ? value : `${value}${path.delimiter}${CODEX_BIN_DIR}`;
}

function commandEnv() {
  return {
    ...process.env,
    PATH: commandPath(),
    GIT_TERMINAL_PROMPT: process.env.GIT_TERMINAL_PROMPT || '0',
    GIT_ASKPASS: process.env.GIT_ASKPASS || '/bin/false',
    GIT_SSH_COMMAND: process.env.GIT_SSH_COMMAND || 'ssh -o BatchMode=yes -o ConnectTimeout=8 -o StrictHostKeyChecking=accept-new'
  };
}

function terminateChildProcess(child, signal = 'SIGTERM') {
  if (!child) return;
  try {
    if (child.pid && process.platform !== 'win32') process.kill(-child.pid, signal);
    else child.kill(signal);
  } catch {
    try {
      child.kill(signal);
    } catch {
      // Best effort. The close/error handler reconciles final state.
    }
  }
}

async function exists(file) {
  try {
    await stat(file);
    return true;
  } catch {
    return false;
  }
}

async function init() {
  await mkdir(DATA_DIR, { recursive: true });
  await mkdir(UPLOAD_DIR, { recursive: true });
  await loadSkillRegistry();
  if (!(await exists(PASSWORD_FILE))) {
    const password = randomBytes(18).toString('base64url');
    await writeFile(PASSWORD_FILE, `${password}\n`, { mode: 0o600 });
  }
  adminPassword = (await readFile(PASSWORD_FILE, 'utf8')).trim();
  await messageStore.initialize();
  if (await exists(STATE_FILE)) {
    state = JSON.parse(await readFile(STATE_FILE, 'utf8'));
    state.authSessions ||= {};
    state.sessions ||= {};
    state.hiddenCodexSessions ||= {};
    state.codexSessionTitles ||= {};
    state.codexSessionTags ||= {};
    state.codexSessionProjects ||= {};
    state.starredMessages ||= {};
    state.siteMounts ||= {};
    state.storageSettings = normalizeStorageSettings(state.storageSettings);
    state.appUpdateSettings = normalizeAppUpdateSettings(state.appUpdateSettings);
    state.secretary = normalizeSecretaryControl(state.secretary);
    state.nextSeq ||= 1;
  } else {
    state.hiddenCodexSessions ||= {};
    state.codexSessionTitles ||= {};
    state.codexSessionTags ||= {};
    state.codexSessionProjects ||= {};
    state.starredMessages ||= {};
    state.siteMounts ||= {};
    state.storageSettings = normalizeStorageSettings(state.storageSettings);
    state.appUpdateSettings = normalizeAppUpdateSettings(state.appUpdateSettings);
    state.secretary = normalizeSecretaryControl(state.secretary);
    await saveState();
  }
  await recoverSecretaryAuditHead();
  const hydratedFromSqlite = await messageStore.hydrateState(state);
  if (!hydratedFromSqlite && Object.values(state.sessions || {}).some((session) => Array.isArray(session.messages) && session.messages.length)) {
    await saveState();
  }
  for (const session of Object.values(state.sessions || {})) ensureSessionHarness(session);
  retagSessionsIfNeeded();
  const restartMarker = await consumeRestartMarker();
  reconcileRunningSessions(restartMarker);
  pruneAuthSessions();
  startStorageMaintenance();
  startRunMonitor();
  startSkillMaintenance();
  startAppUpdateMaintenance();
  startSecretaryAutonomy();
}

function normalizeStorageSettings(value = {}) {
  return {
    autoCleanup: value.autoCleanup === true,
    uploadRetentionDays: clampInteger(value.uploadRetentionDays, 0, 3650, DEFAULT_STORAGE_SETTINGS.uploadRetentionDays),
    runtimeRetentionDays: clampInteger(value.runtimeRetentionDays, 0, 3650, DEFAULT_STORAGE_SETTINGS.runtimeRetentionDays),
    maxUploadMb: clampInteger(value.maxUploadMb, 0, 102400, DEFAULT_STORAGE_SETTINGS.maxUploadMb)
  };
}

function normalizeAppUpdateSettings(value = {}) {
  return {
    autoUpdate: value.autoUpdate === true || (!Object.hasOwn(value, 'autoUpdate') && Boolean(APP_UPDATE_MANIFEST_URL)),
    checkIntervalHours: clampInteger(value.checkIntervalHours, 1, 168, DEFAULT_APP_UPDATE_SETTINGS.checkIntervalHours),
    lastAutoCheckAt: String(value.lastAutoCheckAt || ''),
    lastAutoUpdateAt: String(value.lastAutoUpdateAt || ''),
    lastAutoError: String(value.lastAutoError || '').slice(0, 500)
  };
}

function cleanShortString(value, limit = 120) {
  return String(value || '').trim().replace(/\s+/g, ' ').slice(0, limit);
}

function cleanLineList(value, limit = 12) {
  const source = Array.isArray(value) ? value : String(value || '').split(/\r?\n/);
  return source
    .map((item) => String(item || '').trim())
    .filter(Boolean)
    .slice(0, limit);
}

function cleanConfigOverrides(value) {
  return cleanLineList(value, 20)
    .filter((item) => /^[A-Za-z0-9_.-]+\s*=/.test(item))
    .map((item) => item.replace(/\s*=\s*/, '='));
}

function normalizeSessionConfig(value = {}, current = {}) {
  const sandbox = ['read-only', 'workspace-write', 'danger-full-access'].includes(value.sandbox)
    ? value.sandbox
    : current.sandbox || 'workspace-write';
  const approval = ['untrusted', 'on-request', 'on-failure', 'never'].includes(value.approval)
    ? value.approval
    : current.approval || 'on-request';
  const reasoningEffort = ['', 'minimal', 'low', 'medium', 'high'].includes(value.reasoningEffort)
    ? value.reasoningEffort
    : current.reasoningEffort || '';

  return {
    model: cleanShortString(value.model ?? current.model ?? '', 100),
    profile: cleanShortString(value.profile ?? current.profile ?? '', 80),
    reasoningEffort,
    sandbox,
    approval,
    addDirs: cleanLineList(value.addDirs ?? current.addDirs ?? [], 10),
    configOverrides: cleanConfigOverrides(value.configOverrides ?? current.configOverrides ?? []),
    strictConfig: value.strictConfig === undefined ? current.strictConfig === true : value.strictConfig === true,
    ignoreUserConfig: value.ignoreUserConfig === undefined ? current.ignoreUserConfig === true : value.ignoreUserConfig === true,
    ignoreRules: value.ignoreRules === undefined ? current.ignoreRules === true : value.ignoreRules === true
  };
}

function parseTopLevelTomlConfig(text = '') {
  const result = {};
  for (const rawLine of String(text || '').split(/\r?\n/)) {
    const line = rawLine.trim();
    if (!line || line.startsWith('#')) continue;
    if (line.startsWith('[')) break;
    const match = line.match(/^([A-Za-z0-9_.-]+)\s*=\s*(.+)$/);
    if (!match) continue;
    const key = match[1];
    let value = match[2].trim();
    const commentIndex = value.search(/\s+#/);
    if (commentIndex >= 0) value = value.slice(0, commentIndex).trim();
    const quoted = value.match(/^"([\s\S]*)"$/) || value.match(/^'([\s\S]*)'$/);
    result[key] = quoted ? quoted[1] : value;
  }
  return result;
}

async function codexConfigSummary() {
  const configPath = path.join(CODEX_HOME, 'config.toml');
  let topLevel = {};
  let exists = false;
  try {
    topLevel = parseTopLevelTomlConfig(await readFile(configPath, 'utf8'));
    exists = true;
  } catch {
    topLevel = {};
  }

  let profiles = [];
  try {
    const entries = await readdir(CODEX_HOME, { withFileTypes: true });
    profiles = entries
      .filter((entry) => entry.isFile() && entry.name.endsWith('.config.toml'))
      .map((entry) => entry.name.replace(/\.config\.toml$/, ''))
      .sort((a, b) => a.localeCompare(b))
      .slice(0, 30);
  } catch {
    profiles = [];
  }

  return {
    codexHome: CODEX_HOME,
    configPath,
    exists,
    profiles,
    values: {
      model: topLevel.model || '',
      modelProvider: topLevel.model_provider || '',
      reasoningEffort: topLevel.model_reasoning_effort || '',
      approvalPolicy: topLevel.approval_policy || '',
      sandboxMode: topLevel.sandbox_mode || '',
      disableResponseStorage: topLevel.disable_response_storage || '',
      preferredAuthMethod: topLevel.preferred_auth_method || ''
    }
  };
}

function clampInteger(value, min, max, fallback) {
  const next = Number(value);
  if (!Number.isFinite(next)) return fallback;
  return Math.max(min, Math.min(max, Math.floor(next)));
}

async function writeRestartMarker(reason = 'manual') {
  const marker = {
    version: 1,
    reason,
    requestedAt: nowIso(),
    pid: process.pid,
    running: [...running.keys()]
  };
  const tmp = `${RESTART_MARKER_FILE}.tmp`;
  await writeFile(tmp, JSON.stringify(marker, null, 2), { mode: 0o600 });
  await rename(tmp, RESTART_MARKER_FILE);
  return marker;
}

async function consumeRestartMarker() {
  try {
    const marker = JSON.parse(await readFile(RESTART_MARKER_FILE, 'utf8'));
    await unlink(RESTART_MARKER_FILE).catch(() => {});
    return marker;
  } catch {
    return null;
  }
}

function summarizeRunPrompt(activeRun) {
  const prompt = String(activeRun?.prompt || '').replace(/\s+/g, ' ').trim();
  if (!prompt) return '';
  return prompt.length > 180 ? `${prompt.slice(0, 180)}...` : prompt;
}

function compactEventText(value, limit = 800) {
  return String(value || '').replace(/\s+/g, ' ').trim().slice(0, limit);
}

function ensureSessionHarness(session) {
  if (!session) return session;
  session.messages ||= [];
  session.queue ||= [];
  session.runs = Array.isArray(session.runs) ? session.runs : [];
  session.audit = Array.isArray(session.audit) ? session.audit : [];
  session.tags = normalizeSessionTags(session.tags || []);
  if (session.runs.length > MAX_SESSION_RUNS) session.runs = session.runs.slice(-MAX_SESSION_RUNS);
  if (session.audit.length > MAX_AUDIT_EVENTS) session.audit = session.audit.slice(-MAX_AUDIT_EVENTS);
  return session;
}

function normalizeSessionTags(tags = []) {
  const source = Array.isArray(tags) ? tags : String(tags || '').split(/[,\s，、]+/);
  const seen = new Set();
  const normalized = [];
  for (const raw of source) {
    const tag = String(raw || '').trim().replace(/^#/, '').slice(0, 18);
    if (!tag || seen.has(tag)) continue;
    seen.add(tag);
    normalized.push(tag);
    if (normalized.length >= 8) break;
  }
  return normalized;
}

function snapshotSessionTags() {
  const web = {};
  const codex = {};
  for (const [id, session] of Object.entries(state.sessions || {})) {
    web[id] = normalizeSessionTags(session.tags || []);
  }
  for (const [id, tags] of Object.entries(state.codexSessionTags || {})) {
    codex[id] = normalizeSessionTags(tags || []);
  }
  state.lastTagSnapshot = {
    version: 1,
    createdAt: nowIso(),
    web,
    codex
  };
}

function tagSummaryFromSessions(sessions = []) {
  const tags = new Map();
  for (const session of sessions) {
    for (const tag of normalizeSessionTags(session.tags || [])) {
      const item = tags.get(tag) || {
        tag,
        count: 0,
        webCount: 0,
        codexCount: 0,
        latestActivityAt: ''
      };
      item.count += 1;
      if (session.source === 'codex') item.codexCount += 1;
      else item.webCount += 1;
      const activityAt = session.activityAt || session.updatedAt || session.createdAt || '';
      if (String(activityAt) > String(item.latestActivityAt)) item.latestActivityAt = activityAt;
      tags.set(tag, item);
    }
  }
  return [...tags.values()].sort((a, b) => b.count - a.count || a.tag.localeCompare(b.tag, 'zh-Hans-CN'));
}

async function allPublicSessionsForTags() {
  const webSessions = Object.values(state.sessions || {}).map(publicSession);
  const codexSessions = await listCodexSessions();
  return sortPublicSessions([...webSessions, ...codexSessions]);
}

async function tagManagementSummary() {
  const sessions = await allPublicSessionsForTags();
  return {
    tags: tagSummaryFromSessions(sessions),
    sessions,
    lastSnapshotAt: state.lastTagSnapshot?.createdAt || '',
    smartTagRuleVersion: SMART_TAG_RULE_VERSION
  };
}

function applyTagTransform(transform) {
  let changed = 0;
  for (const session of Object.values(state.sessions || {})) {
    ensureSessionHarness(session);
    const next = normalizeSessionTags(transform(session.tags || []));
    if (JSON.stringify(next) === JSON.stringify(normalizeSessionTags(session.tags || []))) continue;
    session.tags = next;
    auditSession(session, 'tags.updated', { summary: session.tags.join(', ') || 'none' });
    changed += 1;
  }
  state.codexSessionTags ||= {};
  for (const [codexSessionId, tags] of Object.entries(state.codexSessionTags)) {
    const next = normalizeSessionTags(transform(tags || []));
    if (JSON.stringify(next) === JSON.stringify(normalizeSessionTags(tags || []))) continue;
    state.codexSessionTags[codexSessionId] = next;
    changed += 1;
  }
  return changed;
}

function inferSessionTags(session) {
  const tags = new Set();
  const title = String(session.title || '').toLowerCase();
  const cwd = String(session.cwd || '');
  const base = path.basename(cwd).trim();
  const text = [
    title,
    cwd.toLowerCase()
  ].join(' ');
  const keywordMap = [
    ['购物', ['购物', '买', '价格', '京东', '淘宝', '苏宁', '商品', '品牌', '好物', '调研', '冰箱', '手机', '笔记本', '电脑', '数码', '烘干机', '洗衣', '家电']],
    ['学习网站', ['学习', '课程', '教程', '知识库', '文档站', '教育', '笔记', 'academy', 'wiki']],
    ['开发平台', ['codex', 'console', '平台', '控制台', '开发平台', '开发工具', 'github', 'api', '插件', 'skill', 'skills']],
    ['服务器维护', ['服务器', '部署', '域名', 'https', 'caddy', 'nginx', 'systemd', '端口', '服务', '重启', '运维', 'ssh']],
    ['娱乐网站', ['娱乐', '视频', 'youtube', '游戏', '旅行', '旅游', '活动', '世界杯', '音乐', '影视', '上饶', '北海']],
    ['工作项目', ['客户', '业务', '项目', 'crm', '后台', '管理', '报表']],
    ['个人工具', ['工具', '效率', '自动化', '脚本', '快捷', '本机']],
    ['内容创作', ['图片', '截图', '分享', 'markdown', '表格', '文案', '生成', '编辑']],
    ['问题排查', ['bug', '修复', '报错', '失败', '卡死', '卡顿', '性能', '重试', '恢复']],
    ['系统设置', ['设置', '配置', 'config', 'profile', 'model', 'sandbox', 'approval']]
  ];
  for (const [tag, words] of keywordMap) {
    if (words.some((word) => text.includes(word))) tags.add(tag);
  }
  if (!tags.size && /\/root\/Projects/i.test(cwd)) tags.add('开发平台');
  if (!tags.size && session.source === 'codex') tags.add('开发平台');
  if (!tags.size) tags.add('其他');
  return normalizeSessionTags([...tags]);
}

function applySmartTagsToState() {
  snapshotSessionTags();
  const webSessions = Object.values(state.sessions || {});
  for (const session of webSessions) {
    ensureSessionHarness(session);
    session.tags = inferSessionTags(session);
    auditSession(session, 'tags.inferred', { summary: session.tags.join(', ') || 'none' });
  }
  state.codexSessionTags = {};
  state.smartTagRuleVersion = SMART_TAG_RULE_VERSION;
  return webSessions.length;
}

function retagSessionsIfNeeded() {
  if (Number(state.smartTagRuleVersion || 0) >= SMART_TAG_RULE_VERSION) return;
  applySmartTagsToState();
  scheduleSave();
}

function runAttachments(images = [], files = []) {
  return {
    imageCount: images.length,
    fileCount: files.length,
    images: images.slice(0, 12).map((image) => ({
      name: image.name || image.fileName || '',
      type: image.type || '',
      url: image.url || ''
    })),
    files: files.slice(0, 12).map((file) => ({
      name: file.name || file.fileName || '',
      type: file.type || '',
      size: Number(file.size || 0),
      url: file.url || ''
    }))
  };
}

function auditSession(session, type, detail = {}) {
  ensureSessionHarness(session);
  const entry = {
    id: randomUUID(),
    at: nowIso(),
    type,
    runId: detail.runId || '',
    messageId: detail.messageId || '',
    summary: compactEventText(detail.summary || detail.error || detail.prompt || detail.status || type, 500)
  };
  session.audit.push(entry);
  if (session.audit.length > MAX_AUDIT_EVENTS) session.audit = session.audit.slice(-MAX_AUDIT_EVENTS);
  if (isSecretarySession(session)) {
    appendSecretaryAudit(type, {
      sessionId: session.id,
      runId: entry.runId,
      messageId: entry.messageId,
      summary: entry.summary
    });
  }
  return entry;
}

function secretaryControl() {
  state.secretary = normalizeSecretaryControl(state.secretary);
  return state.secretary;
}

function isSecretarySession(session) {
  return Boolean(session && (session.kind === 'secretary' || session.id === state.secretary?.sessionId));
}

function appendSecretaryAudit(type, detail = {}) {
  const result = createSecretaryAuditEntry(secretaryControl(), { type, ...detail });
  state.secretary = result.control;
  secretaryAuditWriteSerial(() => appendFile(SECRETARY_AUDIT_FILE, `${JSON.stringify(result.entry)}\n`, { mode: 0o600 }))
    .catch((error) => console.error('secretary audit append failed', error));
  return result.entry;
}

async function recentSecretaryAudit(limit = 80) {
  try {
    return parseSecretaryAudit(await readFile(SECRETARY_AUDIT_FILE, 'utf8'), limit);
  } catch {
    return [];
  }
}

async function recoverSecretaryAuditHead() {
  const entries = await recentSecretaryAudit(1);
  const latest = entries.at(-1);
  if (!latest?.hash) return;
  const control = secretaryControl();
  state.secretary = {
    ...control,
    auditSeq: Math.max(control.auditSeq, Number(latest.seq || 0)),
    auditHead: String(latest.hash),
    lastEventAt: String(latest.at || control.lastEventAt || '')
  };
}

function findRun(session, runId) {
  ensureSessionHarness(session);
  if (!runId) return null;
  return session.runs.find((run) => run.id === runId) || null;
}

function findRunByMessage(session, messageId) {
  ensureSessionHarness(session);
  if (!messageId) return null;
  return session.runs.find((run) => run.userMessageId === messageId || run.clientMessageId === messageId) || null;
}

function latestRun(session) {
  ensureSessionHarness(session);
  return session.runs.at(-1) || null;
}

function activeRunRecord(session) {
  ensureSessionHarness(session);
  return findRun(session, session.activeRun?.runId) || findRunByMessage(session, session.activeRun?.messageId) || null;
}

function publicRun(run) {
  if (!run) return null;
  return {
    id: run.id,
    userMessageId: run.userMessageId || '',
    clientMessageId: run.clientMessageId || '',
    status: run.status || 'unknown',
    promptSummary: run.promptSummary || summarizeRunPrompt(run),
    elevated: run.elevated === true,
    origin: run.origin || '',
    triggerType: run.triggerType || '',
    codexSessionId: run.codexSessionId || '',
    pid: run.pid || 0,
    queuedAt: run.queuedAt || '',
    startedAt: run.startedAt || '',
    endedAt: run.endedAt || '',
    exitCode: run.exitCode ?? null,
    signalCode: run.signalCode || null,
    errorCode: run.errorCode || '',
    errorSummary: run.errorSummary || '',
    tokenSnapshot: run.tokenSnapshot || null,
    outputCount: run.outputCount || 0,
    toolCount: run.toolCount || 0,
    eventCount: Array.isArray(run.events) ? run.events.length : 0,
    attachments: run.attachments || { imageCount: 0, fileCount: 0, images: [], files: [] }
  };
}

function createHarnessRun(session, props = {}) {
  ensureSessionHarness(session);
  const existing = props.runId ? findRun(session, props.runId) : null;
  if (existing) return existing;
  const prompt = String(props.prompt || '');
  const run = {
    id: props.runId || randomUUID(),
    userMessageId: props.messageId || '',
    clientMessageId: props.clientMessageId || '',
    status: props.status || 'submitted',
    prompt: compactText(prompt, 12000),
    promptSummary: summarizeRunPrompt({ prompt }),
    elevated: props.elevated === true,
    origin: String(props.origin || '').slice(0, 40),
    triggerType: String(props.triggerType || '').slice(0, 80),
    signalId: String(props.signalId || '').slice(0, 120),
    codexSessionId: session.codexSessionId || '',
    pid: 0,
    queuedAt: props.status === 'queued' ? nowIso() : '',
    createdAt: nowIso(),
    startedAt: '',
    endedAt: '',
    exitCode: null,
    signalCode: null,
    errorCode: '',
    errorSummary: '',
    tokenSnapshot: null,
    outputCount: 0,
    toolCount: 0,
    attachments: runAttachments(props.images || [], props.files || []),
    outputMessageIds: [],
    events: []
  };
  session.runs.push(run);
  if (session.runs.length > MAX_SESSION_RUNS) session.runs = session.runs.slice(-MAX_SESSION_RUNS);
  auditSession(session, 'run.created', { runId: run.id, messageId: run.userMessageId, prompt: run.promptSummary });
  return run;
}

function appendRunEvent(session, type, detail = {}, options = {}) {
  ensureSessionHarness(session);
  const run = findRun(session, options.runId)
    || findRunByMessage(session, options.messageId)
    || activeRunRecord(session)
    || latestRun(session);
  if (!run) return null;
  const event = {
    at: nowIso(),
    type,
    summary: compactEventText(detail.summary || detail.error || detail.message || detail.text || type, 800)
  };
  if (detail.exitCode !== undefined) event.exitCode = detail.exitCode;
  if (detail.status) event.status = detail.status;
  if (detail.errorCode) event.errorCode = detail.errorCode;
  if (detail.contextTokens !== undefined) event.contextTokens = detail.contextTokens;
  if (detail.contextRemaining !== undefined) event.contextRemaining = detail.contextRemaining;
  run.events ||= [];
  run.events.push(event);
  if (run.events.length > MAX_RUN_EVENTS) run.events = run.events.slice(-MAX_RUN_EVENTS);
  if (isSecretarySession(session)) {
    appendSecretaryAudit(`run.${type}`, {
      sessionId: session.id,
      runId: run.id,
      messageId: run.userMessageId,
      summary: event.summary
    });
  }
  return event;
}

function updateRunStatus(session, runId, status, patch = {}) {
  ensureSessionHarness(session);
  const run = findRun(session, runId) || findRunByMessage(session, runId);
  if (!run) return null;
  run.status = status;
  Object.assign(run, patch);
  if (status === 'queued' && !run.queuedAt) run.queuedAt = nowIso();
  if (['running', 'stopping'].includes(status) && !run.startedAt) run.startedAt = nowIso();
  if (['completed', 'failed', 'stopped', 'recovered', 'merged'].includes(status)) run.endedAt ||= nowIso();
  auditSession(session, `run.${status}`, {
    runId: run.id,
    messageId: run.userMessageId,
    summary: patch.errorSummary || run.promptSummary || status
  });
  return run;
}

function contextHealthFromUsage(usage) {
  if (!usage?.modelContextWindow) {
    return { state: 'unknown', label: '上下文未知', severity: 'neutral', action: '' };
  }
  if (codexContextIsFull(usage)) {
    return {
      state: 'full',
      label: '上下文已满',
      severity: 'danger',
      action: 'new_session',
      detail: `${usage.contextTokens}/${usage.modelContextWindow}`
    };
  }
  if (usage.contextPercent >= 90 || usage.contextRemaining <= 16000) {
    return {
      state: 'warning',
      label: '上下文接近上限',
      severity: 'warn',
      action: 'compact_or_new_session',
      detail: `${usage.contextTokens}/${usage.modelContextWindow}`
    };
  }
  return {
    state: 'ok',
    label: '上下文正常',
    severity: 'ok',
    action: '',
    detail: `${usage.contextTokens}/${usage.modelContextWindow}`
  };
}

function queueStatusFingerprint(queue = []) {
  const compact = queue.map((item) => ({
    id: item.id || '',
    runId: item.runId || '',
    messageId: item.messageId || '',
    clientMessageId: item.clientMessageId || '',
    prompt: item.displayPrompt || item.prompt || '',
    elevated: item.elevated === true,
    createdAt: item.createdAt || '',
    images: (item.images || []).map((image) => [image.id || '', image.name || image.fileName || '', image.path || '', image.url || '']),
    files: (item.files || []).map((file) => [file.id || '', file.name || file.fileName || '', file.path || '', file.url || '', Number(file.size || 0)])
  }));
  return createHash('sha256').update(JSON.stringify(compact)).digest('hex');
}

function classifyCodexFailure({ code, lastError = '', session, spawnError = null, wasStopping = false } = {}) {
  const errorText = String(lastError || spawnError?.message || '').trim();
  if (wasStopping) return { code: 'process_killed', retryable: true, summary: '任务已停止。' };
  if (codexContextIsFull(session?.lastCodexUsage)) {
    return {
      code: 'context_full',
      retryable: false,
      summary: `Codex 上下文已满（${session.lastCodexUsage.contextTokens}/${session.lastCodexUsage.modelContextWindow} tokens），请新建干净会话或先压缩原生会话。`
    };
  }
  if (spawnError?.code === 'ENOENT') {
    return { code: 'codex_not_found', retryable: false, summary: 'Codex 命令不可用，检查 CODEX_BIN 或 PATH。' };
  }
  if (/no such file or directory|cwd|ENOENT/i.test(errorText)) {
    return { code: 'cwd_missing', retryable: false, summary: `工作目录或文件不存在：${compactEventText(errorText, 260)}` };
  }
  if (/permission denied|EACCES/i.test(errorText)) {
    return { code: 'permission_denied', retryable: true, summary: `权限不足：${compactEventText(errorText, 260)}` };
  }
  if (/stream disconnected|upstream request failed|reconnecting/i.test(errorText)) {
    return { code: 'upstream_disconnected', retryable: true, summary: `Codex 上游连接中断：${compactEventText(errorText, 260)}` };
  }
  if (code !== undefined && code !== 0) {
    return {
      code: 'unknown_exit',
      retryable: true,
      summary: errorText ? `Codex 退出码 ${code}：${compactEventText(errorText, 260)}` : `Codex 退出码 ${code}。`
    };
  }
  return { code: 'unknown', retryable: true, summary: errorText || '未知 Codex 失败。' };
}

function deriveSessionStatusSummary(session) {
  ensureSessionHarness(session);
  const runtimeRunning = running.has(session.id);
  const active = activeRunRecord(session);
  const isStopping = runtimeRunning && session.status === 'stopping';
  const queueCount = session.queue.length;
  const contextHealth = contextHealthFromUsage(session.lastCodexUsage);
  let status = 'idle';
  if (runtimeRunning) status = isStopping ? 'stopping' : 'running';
  else if (session.status === 'error') status = 'error';
  else if (queueCount > 0) status = 'queued';
  else if (['running', 'stopping'].includes(session.status)) status = 'idle';
  else status = session.status || 'idle';
  const labels = {
    running: '运行中',
    stopping: '停止中',
    queued: '有排队',
    error: '失败',
    idle: '空闲'
  };
  const previousRevision = Number(session.statusRevision || 0);
  const summary = versionSessionStatus(session, {
    status,
    label: labels[status] || status,
    running: runtimeRunning,
    canStop: runtimeRunning && !isStopping,
    queueCount,
    activeRunId: active?.id || session.activeRun?.runId || '',
    lastRunStatus: latestRun(session)?.status || '',
    contextHealth
  }, nowIso, queueStatusFingerprint(session.queue));
  if (summary.revision !== previousRevision) scheduleSave();
  return summary;
}

function reconcileRunningSessions(restartMarker = null) {
  const planned = Boolean(restartMarker);
  for (const session of Object.values(state.sessions || {})) {
    ensureSessionHarness(session);
    if (session.status === 'running' || session.status === 'stopping') {
      const activeRun = session.activeRun;
      const promptSummary = summarizeRunPrompt(activeRun);
      session.status = planned ? 'idle' : 'error';
      if (activeRun?.messageId) {
        updateMessageRunState(session, activeRun.messageId, planned ? 'recovered' : 'failed', {
          delivery: planned ? 'recovered' : 'failed'
        });
      }
      updateRunStatus(session, activeRun?.runId || activeRun?.messageId, planned ? 'recovered' : 'failed', {
        errorCode: planned ? 'service_restarted' : 'service_crashed',
        errorSummary: planned
          ? 'Service restarted with a recovery marker.'
          : 'Service restarted unexpectedly while Codex was running.'
      });
      delete session.activeRun;
      auditSession(session, planned ? 'service.restart.recovered' : 'service.restart.unexpected', {
        runId: activeRun?.runId || '',
        messageId: activeRun?.messageId || '',
        summary: promptSummary
      });
      addMessage(session, {
        role: 'system',
        text: [
          planned
            ? 'Service restarted with a recovery marker. The session was restored to an operable state.'
            : 'Service restarted unexpectedly while Codex was running. The session status was reconciled.',
          promptSummary ? `Interrupted prompt: ${promptSummary}` : '',
          'The interrupted prompt was not replayed automatically to avoid repeating file changes or commands.'
        ].filter(Boolean).join('\n'),
        status: session.status,
        queuedCount: session.queue.length
      });
    }
  }
}

function updateMessageRunState(session, messageId, runState, extra = {}) {
  if (!messageId) return null;
  const message = (session.messages || []).find((item) => item.id === messageId || item.clientMessageId === messageId);
  if (!message) return null;
  message.runState = runState;
  message.completedAt = ['completed', 'failed', 'stopped', 'recovered', 'merged'].includes(runState) ? nowIso() : message.completedAt;
  Object.assign(message, extra);
  messageStore.markSessionDirty(session.id);
  scheduleSave();
  broadcastEvent(session.id, 'message_update', message);
  return message;
}

function queueItemMatchesId(item, id) {
  return item?.id === id || item?.clientMessageId === id || item?.messageId === id;
}

function mergeQueuedItems(session, selectedIds = []) {
  session.queue ||= [];
  const ids = Array.isArray(selectedIds) ? selectedIds.map((id) => String(id || '').trim()).filter(Boolean) : [];
  const selected = ids.length
    ? session.queue.filter((item) => ids.some((id) => queueItemMatchesId(item, id)))
    : session.queue;
  if (selected.length < 2) return null;
  const selectedSet = new Set(selected.map((item) => item.id || item.clientMessageId || item.messageId));
  const isSelected = (item) => selectedSet.has(item.id || item.clientMessageId || item.messageId);
  const items = selected;
  let imageCursor = 1;
  const mergedPrompt = [
    '以下是合并后的多条排队输入，请按顺序一起处理：',
    '每条输入的“对应图片”和“对应文件”指合并后附件顺序，请不要混用不同输入的附件。',
    ...items.map((item, index) => {
      const prompt = String(item.displayPrompt || item.prompt || '').trim() || '(空输入)';
      const images = item.images || [];
      const files = item.files || [];
      let imageText = '对应图片：无';
      if (images.length) {
        const start = imageCursor;
        const end = imageCursor + images.length - 1;
        imageCursor = end + 1;
        const range = start === end ? `第 ${start} 张` : `第 ${start}-${end} 张`;
        const names = images
          .map((image, imageIndex) => `${start + imageIndex}. ${image.name || '未命名图片'}`)
          .join('\n');
        imageText = `对应图片：${range}\n图片清单：\n${names}`;
      }
      const fileText = files.length
        ? `对应文件：\n${files.map((file, fileIndex) => `${fileIndex + 1}. ${file.name || file.fileName || '未命名文件'}\n   路径: ${file.path}\n   类型: ${file.type || '未知'}\n   大小: ${uploadSizeText(file.size)}`).join('\n')}`
        : '对应文件：无';
      return `\n## ${index + 1}\n${imageText}\n${fileText}\n内容：\n${prompt}`;
    })
  ].join('\n');
  const mergedImages = items.flatMap((item) => item.images || []);
  const mergedFiles = items.flatMap((item) => item.files || []);
  const primary = items[0];
  primary.prompt = mergedPrompt;
  primary.displayPrompt = mergedPrompt;
  primary.elevated = items.some((item) => item.elevated === true);
  primary.images = mergedImages;
  primary.files = mergedFiles;
  const primaryRun = findRun(session, primary.runId);
  if (primaryRun) {
    primaryRun.prompt = compactText(mergedPrompt, 12000);
    primaryRun.promptSummary = summarizeRunPrompt({ prompt: mergedPrompt });
    primaryRun.elevated = primary.elevated;
    primaryRun.attachments = runAttachments(mergedImages, mergedFiles);
    appendRunEvent(session, 'queue.merged_primary', { summary: `merged ${items.length} queued inputs` }, { runId: primaryRun.id });
  }
  let inserted = false;
  session.queue = session.queue.flatMap((item) => {
    if (!isSelected(item)) return [item];
    if (inserted) return [];
    inserted = true;
    return [primary];
  });

  const primaryMessage = (session.messages || []).find((entry) => entry.id === primary.messageId || entry.clientMessageId === primary.clientMessageId);
  if (primaryMessage) {
    primaryMessage.text = mergedPrompt;
    primaryMessage.images = mergedImages;
    primaryMessage.files = mergedFiles;
    primaryMessage.elevated = primary.elevated;
    primaryMessage.updatedAt = nowIso();
    messageStore.markSessionDirty(session.id);
    broadcastEvent(session.id, 'message_update', primaryMessage);
  }

  for (const item of items.slice(1)) {
    updateMessageRunState(session, item.messageId || item.clientMessageId, 'merged', { delivery: 'merged' });
    updateRunStatus(session, item.runId || item.messageId || item.clientMessageId, 'merged', {
      errorCode: 'merged_into_queue_item',
      errorSummary: `Merged into ${primary.runId || primary.id}`
    });
  }

  session.updatedAt = nowIso();
  auditSession(session, 'queue.merged', { runId: primary.runId || '', messageId: primary.messageId || '', summary: `${items.length} items` });
  scheduleSave();
  broadcastSession(session);
  return { primary, primaryMessage, mergedCount: items.length };
}

function incompleteRunMessages(session) {
  return (session.messages || []).filter((message) => (
    message.role === 'user'
    && ['submitted', 'running', 'queued', 'stopping'].includes(message.runState)
  ));
}

function recoverStaleSession(session, reason = 'monitor') {
  ensureSessionHarness(session);
  const activeMessageId = session.activeRun?.messageId;
  const activeRunId = session.activeRun?.runId || activeMessageId;
  for (const message of incompleteRunMessages(session)) {
    const isQueued = session.queue.some((item) => item.clientMessageId === message.clientMessageId || item.messageId === message.id);
    if (isQueued) continue;
    updateMessageRunState(session, message.id, 'recovered', { delivery: 'recovered' });
    updateRunStatus(session, message.runId || message.id || message.clientMessageId, 'recovered', {
      errorCode: 'stale_without_process',
      errorSummary: `Recovered stale run state (${reason}).`
    });
  }
  updateRunStatus(session, activeRunId, 'recovered', {
    errorCode: 'stale_without_process',
    errorSummary: `Recovered stale run state (${reason}).`
  });
  delete session.activeRun;
  session.status = 'idle';
  session.updatedAt = nowIso();
  auditSession(session, 'session.recovered_stale', { runId: activeRunId || '', messageId: activeMessageId || '', summary: reason });
  addMessage(session, {
    role: 'system',
    text: `Recovered stale run state (${reason}). No Codex process was active for this session.`,
    status: 'idle',
    queuedCount: session.queue.length,
    recoveredMessageId: activeMessageId || ''
  });
}

function reconcileSessionRunState(session, reason = 'snapshot') {
  if (!session || session.source === 'codex') return false;
  ensureSessionHarness(session);
  const hasChild = running.has(session.id);
  const hasQueue = session.queue.length > 0;
  const staleStatus = ['running', 'stopping'].includes(session.status) && !hasChild;
  const staleMessages = incompleteRunMessages(session).some((message) => {
    if (message.runState === 'queued') return !hasQueue;
    return !hasChild;
  });
  if (!staleStatus && !staleMessages) return false;
  recoverStaleSession(session, reason);
  return true;
}

let saveTimer = null;
let restartRequested = false;
let shuttingDown = false;
function scheduleSave() {
  if (shuttingDown) return;
  clearTimeout(saveTimer);
  saveTimer = setTimeout(() => saveState().catch(console.error), 100);
}

async function saveState() {
  return runStateWriteSerial(async () => {
    const generation = Number(state.storageGeneration || 0) + 1;
    await messageStore.persistMessages(state, { generation });
    const snapshot = JSON.stringify({ ...stateMetadataSnapshot(state), storageGeneration: generation }, null, 2);
    const tmp = `${STATE_FILE}.${process.pid}.${randomUUID()}.tmp`;
    await writeFile(tmp, snapshot, { mode: 0o600 });
    await rename(tmp, STATE_FILE);
    state.storageGeneration = generation;
  });
}

async function prepareForShutdown(reason = 'signal') {
  if (running.size > 0) await writeRestartMarker(reason);
  clearTimeout(saveTimer);
  saveTimer = null;
  clearInterval(secretaryAutonomyTimer);
  secretaryAutonomyTimer = null;
  await secretaryAuditWriteSerial(async () => {});
  await saveState();
}

function nowIso() {
  return new Date().toISOString();
}

function json(res, code, body, extraHeaders = {}) {
  const payload = JSON.stringify(body);
  res.writeHead(code, {
    'content-type': 'application/json; charset=utf-8',
    'cache-control': 'no-store',
    'content-length': Buffer.byteLength(payload),
    ...extraHeaders
  });
  res.end(payload);
}

function readBody(req, limit = 1024 * 1024) {
  return new Promise((resolve, reject) => {
    let body = '';
    let done = false;
    const finish = (error, value) => {
      if (done) return;
      done = true;
      if (error) reject(error);
      else resolve(value);
    };
    req.on('data', (chunk) => {
      if (done) return;
      body += chunk;
      if (body.length > limit) {
        finish(new Error('body_too_large'));
        req.destroy();
      }
    });
    req.on('end', () => finish(null, body));
    req.on('error', (error) => finish(error));
  });
}

async function readJson(req, limit) {
  const raw = await readBody(req, limit);
  if (!raw) return {};
  return JSON.parse(raw);
}

function parseCookies(req) {
  const out = {};
  for (const part of String(req.headers.cookie || '').split(';')) {
    const [key, ...rest] = part.trim().split('=');
    if (!key) continue;
    out[key] = decodeURIComponent(rest.join('='));
  }
  return out;
}

function cookieHeader(token, maxAgeSeconds) {
  const secure = process.env.COOKIE_SECURE === '0' ? '' : '; Secure';
  return `${COOKIE_NAME}=${encodeURIComponent(token)}; Path=/; HttpOnly; SameSite=Lax; Max-Age=${maxAgeSeconds}${secure}`;
}

function pruneAuthSessions() {
  const now = Date.now();
  for (const [token, session] of Object.entries(state.authSessions)) {
    const testSessionExpired = session?.client === 'mobile-ui-check' && session.createdAt + 60 * 60 * 1000 <= now;
    if (!session || session.expiresAt <= now || testSessionExpired) delete state.authSessions[token];
  }
}

function getAuth(req) {
  pruneAuthSessions();
  const token = parseCookies(req)[COOKIE_NAME];
  if (!token) return null;
  const session = state.authSessions[token];
  if (!session || session.expiresAt <= Date.now()) return null;
  session.lastSeenAt = Date.now();
  return { token, session };
}

function requireAuth(req, res) {
  const auth = getAuth(req);
  if (!auth) {
    json(res, 401, { error: 'unauthorized' });
    return null;
  }
  return auth;
}

function safeCompare(a, b) {
  const left = Buffer.from(createHash('sha256').update(String(a)).digest('hex'));
  const right = Buffer.from(createHash('sha256').update(String(b)).digest('hex'));
  return timingSafeEqual(left, right);
}

function escapeHtml(value) {
  return String(value ?? '')
    .replace(/&/g, '&amp;')
    .replace(/</g, '&lt;')
    .replace(/>/g, '&gt;')
    .replace(/"/g, '&quot;')
    .replace(/'/g, '&#39;');
}

function isInsidePath(root, target) {
  const relative = path.relative(root, target);
  return relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative));
}

function slugify(value, fallback = 'site') {
  const slug = String(value || '')
    .toLowerCase()
    .replace(/[^a-z0-9]+/g, '-')
    .replace(/^-+|-+$/g, '')
    .slice(0, 48);
  return slug || fallback;
}

function uniqueSiteSlug(base, currentId = '') {
  const existing = new Set(Object.values(state.siteMounts || {})
    .filter((mount) => !currentId || mount.id !== currentId)
    .map((mount) => mount.slug));
  let slug = base;
  let index = 2;
  while (existing.has(slug)) {
    slug = `${base}-${index}`;
    index += 1;
  }
  return slug;
}

function publicSiteMount(mount) {
  return {
    id: mount.id,
    type: mount.type || 'local',
    slug: mount.slug,
    title: mount.title,
    url: mount.type === 'external' ? mount.url : `/sites/${mount.slug}/`,
    sessionId: mount.sessionId || '',
    createdAt: mount.createdAt || '',
    updatedAt: mount.updatedAt || ''
  };
}

function publicSiteMountsForSession(sessionId) {
  return Object.values(state.siteMounts || {})
    .filter((mount) => mount.sessionId === sessionId && !mount.deletedAt)
    .sort((a, b) => String(b.updatedAt || b.createdAt).localeCompare(String(a.updatedAt || a.createdAt)))
    .map(publicSiteMount);
}

async function createOrUpdateSiteMount(session, rootDir) {
  if (!session?.id || !session.cwd || !rootDir) return null;
  const root = await realpath(rootDir).catch(() => '');
  if (!root || !isInsidePath(SITE_MOUNT_ROOT, root)) return null;
  const info = await stat(root).catch(() => null);
  if (!info?.isDirectory()) return null;
  if (!(await exists(path.join(root, 'index.html')))) return null;

  const existing = Object.values(state.siteMounts || {})
    .find((mount) => mount.sessionId === session.id && mount.root === root && !mount.deletedAt);
  const now = nowIso();
  if (existing) {
    existing.updatedAt = now;
    return existing;
  }

  const relative = path.relative(session.cwd, root);
  const label = relative && !relative.startsWith('..') ? relative : path.basename(root);
  const baseSlug = slugify(`${session.title || path.basename(session.cwd)}-${label}`);
  const id = randomUUID();
  const mount = {
    id,
    sessionId: session.id,
    type: 'local',
    slug: uniqueSiteSlug(baseSlug, id),
    title: label === '.' ? (session.title || '站点') : label,
    root,
    createdAt: now,
    updatedAt: now
  };
  state.siteMounts ||= {};
  state.siteMounts[id] = mount;
  return mount;
}

async function autoMountSessionSites(session) {
  if (!session?.id || !session.cwd || session.source === 'codex') return [];
  const cwd = await realpath(session.cwd).catch(() => '');
  if (!cwd || !isInsidePath(SITE_MOUNT_ROOT, cwd)) return [];
  const existingIds = new Set(Object.values(state.siteMounts || {})
    .filter((mount) => mount.sessionId === session.id && !mount.deletedAt)
    .map((mount) => mount.id));
  const mounts = [];
  for (const candidate of SITE_MOUNT_CANDIDATES) {
    const mount = await createOrUpdateSiteMount(session, path.join(cwd, candidate));
    if (mount && !existingIds.has(mount.id)) mounts.push(mount);
  }
  return mounts;
}

function safeHttpUrl(value) {
  try {
    const url = new URL(String(value || '').trim());
    if (!['http:', 'https:'].includes(url.protocol)) return '';
    url.hash = '';
    return url.toString();
  } catch {
    return '';
  }
}

function isLoopbackHost(hostname) {
  const value = String(hostname || '').toLowerCase();
  return value === 'localhost' || value === '127.0.0.1' || value === '::1' || value === '[::1]';
}

function safeLocalServiceUrl(value) {
  try {
    const url = new URL(String(value || '').trim());
    if (url.protocol !== 'http:') return '';
    if (!isLoopbackHost(url.hostname)) return '';
    const port = Number(url.port || 80);
    if (!Number.isInteger(port) || port < 1 || port > 65535) return '';
    url.hash = '';
    return url.toString();
  } catch {
    return '';
  }
}

function extractAttrValue(attrs, name) {
  const match = String(attrs || '').match(new RegExp(`${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s>]+))`, 'i'));
  return match ? (match[1] || match[2] || match[3] || '').trim() : '';
}

function extractJsonSiteMarkers(value, tagName, type) {
  const out = [];
  const pattern = new RegExp(`<${tagName}>\\s*([\\s\\S]*?)\\s*<\\/${tagName}>`, 'i');
  const match = String(value || '').match(pattern);
  if (!match) return out;
  try {
    const parsed = JSON.parse(match[1]);
    const items = Array.isArray(parsed) ? parsed : [parsed];
    for (const item of items) {
      const url = type === 'service' ? safeLocalServiceUrl(item?.url) : safeHttpUrl(item?.url);
      if (url) out.push({ type, url, title: String(item?.title || '').trim() });
    }
  } catch {
    // Ignore malformed registration blocks; Codex can retry with the exact marker format.
  }
  return out;
}

function extractSiteLinkMarkers(text) {
  const value = String(text || '');
  const out = [
    ...extractJsonSiteMarkers(value, 'codex-site-links', 'external'),
    ...extractJsonSiteMarkers(value, 'codex-site-services', 'service')
  ];
  for (const match of value.matchAll(/<codex-site-link\b([^>]*)\/?>/gi)) {
    const url = safeHttpUrl(extractAttrValue(match[1], 'url'));
    if (url) out.push({ type: 'external', url, title: extractAttrValue(match[1], 'title') });
  }
  for (const match of value.matchAll(/<codex-site-service\b([^>]*)\/?>/gi)) {
    const url = safeLocalServiceUrl(extractAttrValue(match[1], 'url'));
    if (url) out.push({ type: 'service', url, title: extractAttrValue(match[1], 'title') });
  }
  const seen = new Set();
  return out.filter((item) => {
    if (seen.has(item.url)) return false;
    seen.add(item.url);
    return true;
  }).slice(0, 20);
}

function createOrUpdateServiceSiteMount(session, link) {
  if (!session?.id || !link?.url) return null;
  const url = safeLocalServiceUrl(link.url);
  if (!url) return null;
  const now = nowIso();
  state.siteMounts ||= {};
  const existing = Object.values(state.siteMounts)
    .find((mount) => mount.sessionId === session.id && mount.type === 'service' && mount.targetUrl === url && !mount.deletedAt);
  if (existing) {
    existing.title = String(link.title || existing.title || '').slice(0, 80) || existing.title;
    existing.updatedAt = now;
    return existing;
  }
  const parsed = new URL(url);
  const title = String(link.title || `服务 ${parsed.port || 80}`).trim().slice(0, 80);
  const id = randomUUID();
  const mount = {
    id,
    sessionId: session.id,
    type: 'service',
    slug: uniqueSiteSlug(slugify(`${session.title || 'session'}-${parsed.port || 'service'}`), id),
    title,
    targetUrl: url,
    createdAt: now,
    updatedAt: now
  };
  state.siteMounts[id] = mount;
  return mount;
}

function createOrUpdateExternalSiteMount(session, link) {
  if (!session?.id || !link?.url) return null;
  const url = safeHttpUrl(link.url);
  if (!url) return null;
  if (safeLocalServiceUrl(url)) return createOrUpdateServiceSiteMount(session, { ...link, url });
  const now = nowIso();
  state.siteMounts ||= {};
  const existing = Object.values(state.siteMounts)
    .find((mount) => mount.sessionId === session.id && mount.type === 'external' && mount.url === url && !mount.deletedAt);
  if (existing) {
    existing.title = String(link.title || existing.title || '').slice(0, 80) || existing.title;
    existing.updatedAt = now;
    return existing;
  }
  const parsed = new URL(url);
  const title = String(link.title || parsed.hostname || '外部站点').trim().slice(0, 80);
  const id = randomUUID();
  const mount = {
    id,
    sessionId: session.id,
    type: 'external',
    slug: uniqueSiteSlug(slugify(`${session.title || 'session'}-${parsed.hostname}`), id),
    title,
    url,
    createdAt: now,
    updatedAt: now
  };
  state.siteMounts[id] = mount;
  return mount;
}

function registerSiteLinksFromText(session, text) {
  const links = extractSiteLinkMarkers(text);
  if (!links.length) return [];
  const before = new Set(Object.values(state.siteMounts || {}).map((mount) => mount.id));
  const mounts = links
    .map((link) => link.type === 'service' ? createOrUpdateServiceSiteMount(session, link) : createOrUpdateExternalSiteMount(session, link))
    .filter(Boolean);
  return mounts.filter((mount) => !before.has(mount.id));
}

function sessionActivityAt(session) {
  const messages = Array.isArray(session?.messages) ? session.messages : [];
  for (let index = messages.length - 1; index >= 0; index -= 1) {
    const message = messages[index];
    const at = message?.at || message?.timestamp || message?.createdAt || message?.updatedAt || '';
    if (at) return at;
  }
  return session?.activityAt || session?.updatedAt || session?.createdAt || '';
}

function publicSession(session) {
  ensureSessionHarness(session);
  const statusSummary = deriveSessionStatusSummary(session);
  const activeRun = activeRunRecord(session);
  const lastRun = latestRun(session);
  const effectiveStatus = statusSummary.status === 'queued' ? 'idle' : statusSummary.status;
  const runCounts = session.runs.reduce((acc, run) => {
    const key = run.status || 'unknown';
    acc[key] = (acc[key] || 0) + 1;
    return acc;
  }, {});
  return {
    id: session.id,
    kind: session.kind || '',
    autonomous: session.autonomous === true,
    source: session.source || 'web',
    title: session.title,
    cwd: session.cwd,
    linkedProjectPath: session.linkedProjectPath || '',
    model: session.model || '',
    profile: session.profile || '',
    reasoningEffort: session.reasoningEffort || '',
    sandbox: session.sandbox,
    approval: session.approval,
    addDirs: Array.isArray(session.addDirs) ? session.addDirs : [],
    configOverrides: Array.isArray(session.configOverrides) ? session.configOverrides : [],
    strictConfig: session.strictConfig === true,
    ignoreUserConfig: session.ignoreUserConfig === true,
    ignoreRules: session.ignoreRules === true,
    tags: normalizeSessionTags(session.tags || []),
    codexSessionId: session.codexSessionId || '',
    status: effectiveStatus,
    statusSummary,
    statusRevision: statusSummary.revision,
    statusUpdatedAt: statusSummary.updatedAt,
    storedStatus: session.status,
    isRunning: statusSummary.running,
    canStop: statusSummary.canStop,
    activeRun: publicRun(activeRun),
    lastRun: publicRun(lastRun),
    runCounts,
    siteMounts: publicSiteMountsForSession(session.id),
    contextHealth: statusSummary.contextHealth,
    recentAudit: (session.audit || []).slice(-10),
    trashedAt: session.trashedAt || '',
    createdAt: session.createdAt,
    updatedAt: session.updatedAt,
    activityAt: sessionActivityAt(session),
    lastSeq: session.lastSeq || 0,
    queuedCount: session.queue.length,
    queue: session.queue.map((item) => ({
      id: item.id,
      runId: item.runId || '',
      messageId: item.messageId || '',
      clientMessageId: item.clientMessageId || '',
      prompt: item.prompt,
      displayPrompt: item.displayPrompt || item.prompt,
      elevated: item.elevated === true,
      imageCount: item.images?.length || 0,
      images: (item.images || []).map((image) => ({
        name: image.name,
        type: image.type,
        url: image.url
      })),
      fileCount: item.files?.length || 0,
      files: (item.files || []).map((file) => ({
        name: file.name,
        type: file.type,
        size: file.size,
        url: file.url
      })),
      createdAt: item.createdAt
    })),
    messageCount: session.messages.length,
    runCount: session.runs.length
  };
}

async function ensureSecretarySession() {
  await mkdir(SECRETARY_PROJECT_DIR, { recursive: true });
  const control = secretaryControl();
  let session = state.sessions[control.sessionId]
    || Object.values(state.sessions || {}).find((item) => item.kind === 'secretary');
  if (!session) {
    const id = randomUUID();
    const now = nowIso();
    session = {
      id,
      kind: 'secretary',
      autonomous: true,
      title: '专家秘书',
      cwd: SECRETARY_PROJECT_DIR,
      linkedProjectPath: SECRETARY_PROJECT_DIR,
      ...normalizeSessionConfig({
        sandbox: 'danger-full-access',
        approval: 'never',
        reasoningEffort: 'high',
        addDirs: [PROJECTS_ROOT]
      }),
      tags: ['秘书', '自治'],
      codexSessionId: '',
      status: 'idle',
      createdAt: now,
      updatedAt: now,
      lastSeq: 0,
      queue: [],
      runs: [],
      audit: [],
      messages: []
    };
    state.sessions[id] = session;
    state.secretary = {
      ...control,
      sessionId: id,
      createdAt: control.createdAt || now,
      updatedAt: now
    };
    auditSession(session, 'secretary.created', { summary: SECRETARY_PROJECT_DIR });
    addMessage(session, {
      role: 'system',
      text: '专家秘书已就绪。该会话默认使用高权限自治执行；控制台保留完整审计与总停止能力。'
    });
    scheduleSave();
  } else {
    session.kind = 'secretary';
    session.autonomous = true;
    session.title ||= '专家秘书';
    session.cwd = SECRETARY_PROJECT_DIR;
    session.sandbox = 'danger-full-access';
    session.approval = 'never';
    session.reasoningEffort ||= 'high';
    session.addDirs = [...new Set([...(session.addDirs || []), PROJECTS_ROOT])];
    session.tags = normalizeSessionTags([...(session.tags || []), '秘书', '自治']);
    session.trashedAt = '';
    state.secretary = {
      ...control,
      sessionId: session.id,
      createdAt: control.createdAt || session.createdAt || nowIso(),
      updatedAt: nowIso()
    };
  }
  return session;
}

async function readSecretaryTaskLedger() {
  try {
    const parsed = JSON.parse(await readFile(SECRETARY_TASK_FILE, 'utf8'));
    const tasks = (Array.isArray(parsed.tasks) ? parsed.tasks : []).slice(0, 300).map((task) => ({
      id: String(task.id || randomUUID()).slice(0, 160),
      title: String(task.title || task.id || '未命名任务').replace(/\s+/g, ' ').trim().slice(0, 240),
      status: ['pending', 'in_progress', 'blocked', 'completed'].includes(task.status) ? task.status : 'pending',
      priority: Number.isFinite(Number(task.priority)) ? Number(task.priority) : 999,
      createdAt: String(task.createdAt || ''),
      updatedAt: String(task.updatedAt || ''),
      completedAt: String(task.completedAt || ''),
      nextAction: String(task.nextAction || '').replace(/\s+/g, ' ').trim().slice(0, 600),
      outcome: String(task.outcome || '').replace(/\s+/g, ' ').trim().slice(0, 600),
      blocker: String(task.blocker || '').replace(/\s+/g, ' ').trim().slice(0, 600)
    })).sort((a, b) => a.priority - b.priority || a.title.localeCompare(b.title, 'zh-Hans-CN'));
    return {
      version: Number(parsed.version || 1),
      tasks,
      pendingCount: tasks.filter((task) => ['pending', 'in_progress'].includes(task.status)).length,
      blockedCount: tasks.filter((task) => task.status === 'blocked').length,
      completedCount: tasks.filter((task) => task.status === 'completed').length,
      error: ''
    };
  } catch (error) {
    return { version: 1, tasks: [], pendingCount: 0, blockedCount: 0, completedCount: 0, error: String(error.message || error) };
  }
}

function addSecretaryNotification(detail = {}) {
  const control = secretaryControl();
  const notification = {
    id: randomUUID(),
    at: nowIso(),
    type: String(detail.type || 'info').slice(0, 40),
    title: compactEventText(detail.title || '秘书动态', 120),
    body: compactEventText(detail.body || '', 800),
    runId: String(detail.runId || '').slice(0, 120),
    read: false
  };
  state.secretary = {
    ...control,
    notifications: [...control.notifications, notification].slice(-120),
    updatedAt: notification.at
  };
  appendSecretaryAudit('secretary.notification.created', {
    sessionId: control.sessionId,
    runId: notification.runId,
    summary: `${notification.title}: ${notification.body}`
  });
  scheduleSave();
  return notification;
}

function queueSecretaryPrompt(session, prompt, options = {}) {
  const displayPrompt = String(options.displayPrompt || prompt).trim();
  const wasRunning = running.has(session.id);
  const userMessage = addMessage(session, {
    role: 'user',
    text: displayPrompt,
    elevated: true,
    origin: options.origin || 'manual',
    triggerType: options.triggerType || '',
    runState: wasRunning ? 'queued' : 'submitted',
    delivery: wasRunning ? 'queued' : 'submitted'
  });
  const run = createHarnessRun(session, {
    prompt,
    elevated: true,
    origin: options.origin || 'manual',
    triggerType: options.triggerType || '',
    signalId: options.signalId || '',
    messageId: userMessage.id,
    status: wasRunning ? 'queued' : 'submitted'
  });
  userMessage.runId = run.id;
  broadcastEvent(session.id, 'message_update', userMessage);
  if (wasRunning) {
    session.queue.push({
      id: randomUUID(),
      runId: run.id,
      prompt,
      displayPrompt,
      elevated: true,
      origin: run.origin,
      triggerType: run.triggerType,
      signalId: run.signalId,
      images: [],
      files: [],
      createdAt: nowIso(),
      messageId: userMessage.id
    });
    updateRunStatus(session, run.id, 'queued');
    auditSession(session, 'queue.added', { runId: run.id, messageId: userMessage.id, prompt: displayPrompt });
  } else {
    runCodex(session, prompt, { runId: run.id, elevated: true, messageId: userMessage.id });
  }
  scheduleSave();
  return { queued: wasRunning, run, userMessage };
}

function markSecretaryTriggerStarted(trigger, now = new Date()) {
  const control = secretaryControl();
  const localDate = trigger.localDate || now.toISOString().slice(0, 10);
  const scheduler = control.scheduler;
  const dailyRunCount = scheduler.dailyRunDate === localDate ? scheduler.dailyRunCount + 1 : 1;
  const nextScheduler = {
    ...scheduler,
    lastRunAt: now.toISOString(),
    lastTrigger: trigger.type,
    dailyRunDate: localDate,
    dailyRunCount,
    lastError: ''
  };
  if (trigger.type === 'daily-brief') nextScheduler.lastDailyBriefDate = localDate;
  if (trigger.type === 'daily-review') nextScheduler.lastDailyReviewDate = localDate;
  if (trigger.type === 'learn') nextScheduler.lastLearningAt = now.toISOString();
  const signals = control.signals.map((signal) => signal.id === trigger.signalId ? { ...signal, status: 'processing' } : signal);
  state.secretary = { ...control, scheduler: nextScheduler, signals, updatedAt: now.toISOString() };
}

function latestAssistantSummaryForRun(session, runId) {
  for (let index = session.messages.length - 1; index >= 0; index -= 1) {
    const message = session.messages[index];
    if (message.runId === runId && message.role === 'assistant' && message.text) {
      return compactEventText(message.text, 500);
    }
  }
  return '';
}

function completeSecretaryAutonomousRun(session, run, status, failure) {
  if (!isSecretarySession(session) || run?.origin !== 'autonomy') return;
  const control = secretaryControl();
  const now = nowIso();
  const signals = control.signals.map((signal) => signal.id === run.signalId
    ? { ...signal, status: status === 'completed' ? 'completed' : 'failed' }
    : signal);
  state.secretary = {
    ...control,
    signals,
    scheduler: {
      ...control.scheduler,
      lastCompletedAt: now,
      lastError: failure?.summary || ''
    },
    updatedAt: now
  };
  const summary = latestAssistantSummaryForRun(session, run.id) || failure?.summary || run.promptSummary || status;
  addSecretaryNotification({
    type: status === 'completed' ? 'completed' : status === 'stopped' ? 'stopped' : 'failed',
    title: status === 'completed' ? `秘书已完成：${run.triggerType || '自主任务'}` : `秘书任务${status === 'stopped' ? '已停止' : '失败'}`,
    body: summary,
    runId: run.id
  });
}

async function runSecretaryAutonomyTick(reason = 'timer') {
  if (secretaryAutonomyInFlight) return null;
  secretaryAutonomyInFlight = true;
  try {
    const control = secretaryControl();
    const now = new Date();
    const lastTick = Date.parse(control.scheduler.lastTickAt || '');
    const checkMs = control.settings.checkIntervalMinutes * 60_000;
    if (reason === 'timer' && lastTick && now.getTime() - lastTick < checkMs) return null;
    state.secretary = {
      ...control,
      scheduler: {
        ...control.scheduler,
        lastTickAt: now.toISOString(),
        nextCheckAt: new Date(now.getTime() + checkMs).toISOString()
      },
      updatedAt: now.toISOString()
    };
    if (control.killSwitch || !control.settings.enabled) {
      scheduleSave();
      return null;
    }
    const session = await ensureSecretarySession();
    const tasks = await readSecretaryTaskLedger();
    const trigger = selectSecretaryTrigger(secretaryControl(), {
      now,
      running: running.has(session.id),
      pendingTaskCount: tasks.pendingCount
    });
    if (!trigger) {
      scheduleSave();
      return null;
    }
    const signal = secretaryControl().signals.find((item) => item.id === trigger.signalId) || null;
    const prompt = secretaryAutonomyPrompt(trigger, { tasks: tasks.tasks, signal });
    markSecretaryTriggerStarted(trigger, now);
    const result = queueSecretaryPrompt(session, prompt, {
      displayPrompt: `【自主任务 · ${trigger.label}】\n${prompt}`,
      origin: 'autonomy',
      triggerType: trigger.type,
      signalId: trigger.signalId || ''
    });
    addSecretaryNotification({
      type: 'started',
      title: `秘书开始：${trigger.label}`,
      body: result.queued ? '当前任务完成后自动执行。' : '已经开始自主执行。',
      runId: result.run.id
    });
    auditSession(session, 'secretary.autonomy.triggered', { runId: result.run.id, messageId: result.userMessage.id, summary: `${reason}:${trigger.type}` });
    return result;
  } catch (error) {
    const control = secretaryControl();
    state.secretary = {
      ...control,
      scheduler: { ...control.scheduler, lastError: String(error.message || error).slice(0, 800) },
      updatedAt: nowIso()
    };
    appendSecretaryAudit('secretary.autonomy.failed', { summary: error.message || String(error) });
    scheduleSave();
    return null;
  } finally {
    secretaryAutonomyInFlight = false;
  }
}

function startSecretaryAutonomy() {
  clearInterval(secretaryAutonomyTimer);
  secretaryAutonomyTimer = setInterval(() => runSecretaryAutonomyTick('timer').catch(() => {}), 60_000);
  secretaryAutonomyTimer.unref?.();
  setTimeout(() => runSecretaryAutonomyTick('startup').catch(() => {}), 12_000).unref?.();
}

async function secretaryStatusPayload() {
  const control = secretaryControl();
  const session = state.sessions[control.sessionId]
    || Object.values(state.sessions || {}).find((item) => item.kind === 'secretary')
    || null;
  const tasks = await readSecretaryTaskLedger();
  return {
    control,
    session: session ? publicSession(session) : null,
    running: Boolean(session && running.has(session.id)),
    workspace: SECRETARY_PROJECT_DIR,
    quickTasks: Object.keys(SECRETARY_QUICK_TASKS),
    tasks,
    unreadCount: control.notifications.filter((item) => !item.read).length,
    audit: await recentSecretaryAudit(80)
  };
}

function clearSecretaryQueue(session) {
  const queue = [...(session.queue || [])];
  session.queue = [];
  for (const item of queue) {
    updateMessageRunState(session, item.messageId || item.clientMessageId, 'stopped', { delivery: 'stopped' });
    updateRunStatus(session, item.runId || item.messageId || item.clientMessageId, 'stopped', {
      errorCode: 'secretary_kill_switch',
      errorSummary: 'Secretary kill switch stopped the queued run.'
    });
  }
  return queue.length;
}

async function stopSecretary() {
  const control = secretaryControl();
  const now = nowIso();
  state.secretary = { ...control, killSwitch: true, stoppedAt: now, updatedAt: now };
  const session = state.sessions[control.sessionId]
    || Object.values(state.sessions || {}).find((item) => item.kind === 'secretary')
    || null;
  let stopped = false;
  let cleared = 0;
  if (session) {
    cleared = clearSecretaryQueue(session);
    stopped = stopRunningSession(session);
    if (!stopped) session.status = 'idle';
    session.updatedAt = now;
    auditSession(session, 'secretary.kill_switch.enabled', { summary: `running:${stopped} queued:${cleared}` });
    addMessage(session, {
      role: 'system',
      text: '秘书总停止已启用。当前执行和排队任务已停止，新任务已锁定。',
      status: stopped ? 'stopping' : 'idle'
    });
    broadcastSession(session);
  } else {
    appendSecretaryAudit('secretary.kill_switch.enabled', { summary: 'No secretary session existed.' });
  }
  scheduleSave();
  return { stopped, cleared };
}

async function resumeSecretary() {
  const session = await ensureSecretarySession();
  const control = secretaryControl();
  const now = nowIso();
  state.secretary = { ...control, sessionId: session.id, killSwitch: false, resumedAt: now, updatedAt: now };
  auditSession(session, 'secretary.kill_switch.disabled', { summary: 'Autonomous execution resumed.' });
  addMessage(session, { role: 'system', text: '秘书总停止已解除，可以继续接收和执行任务。', status: 'idle' });
  broadcastSession(session);
  scheduleSave();
  return session;
}

function parseProcStat(raw) {
  const end = raw.lastIndexOf(')');
  if (end < 0) return null;
  const pid = Number(raw.slice(0, raw.indexOf(' ')));
  const comm = raw.slice(raw.indexOf('(') + 1, end);
  const rest = raw.slice(end + 2).trim().split(/\s+/);
  return {
    pid,
    comm,
    state: rest[0],
    ppid: Number(rest[1]),
    pgrp: Number(rest[2]),
    session: Number(rest[3]),
    ttyNr: Number(rest[4]),
    utime: Number(rest[11]),
    stime: Number(rest[12]),
    starttime: Number(rest[19]),
    rssPages: Number(rest[21])
  };
}

async function readProcessInfo(pid) {
  try {
    const [statRaw, statusRaw, cmdlineRaw] = await Promise.all([
      readFile(`/proc/${pid}/stat`, 'utf8'),
      readFile(`/proc/${pid}/status`, 'utf8').catch(() => ''),
      readFile(`/proc/${pid}/cmdline`).catch(() => Buffer.alloc(0))
    ]);
    const parsed = parseProcStat(statRaw);
    if (!parsed) return null;
    const status = Object.fromEntries(statusRaw.split('\n').map((line) => {
      const index = line.indexOf(':');
      return index > 0 ? [line.slice(0, index), line.slice(index + 1).trim()] : null;
    }).filter(Boolean));
    const cmdline = cmdlineRaw.toString('utf8').split('\0').filter(Boolean);
    let cwd = '';
    try {
      cwd = await readlink(`/proc/${pid}/cwd`);
    } catch {
      cwd = '';
    }
    const cpuMs = Math.round(((parsed.utime + parsed.stime) / clockTick) * 1000);
    return {
      pid,
      ppid: parsed.ppid,
      pgrp: parsed.pgrp,
      state: parsed.state,
      name: status.Name || parsed.comm,
      cmdline,
      cwd,
      threads: Number(status.Threads || 0),
      memoryKb: Number(String(status.VmRSS || '').match(/\d+/)?.[0] || 0),
      cpuMs
    };
  } catch {
    return null;
  }
}

async function processChildrenMap() {
  const entries = await readdir('/proc', { withFileTypes: true });
  const map = new Map();
  await Promise.all(entries
    .filter((entry) => entry.isDirectory() && /^\d+$/.test(entry.name))
    .map(async (entry) => {
      try {
        const raw = await readFile(`/proc/${entry.name}/stat`, 'utf8');
        const parsed = parseProcStat(raw);
        if (!parsed) return;
        if (!map.has(parsed.ppid)) map.set(parsed.ppid, []);
        map.get(parsed.ppid).push(parsed.pid);
      } catch {
        // Process disappeared while scanning.
      }
    }));
  return map;
}

async function processTree(rootPid) {
  if (!rootPid) return [];
  const children = await processChildrenMap();
  const seen = new Set();
  const ordered = [];
  const visit = (pid, depth) => {
    if (!pid || seen.has(pid)) return;
    seen.add(pid);
    ordered.push({ pid, depth });
    for (const childPid of children.get(pid) || []) visit(childPid, depth + 1);
  };
  visit(rootPid, 0);
  const infos = await Promise.all(ordered.map(async (item) => ({
    ...item,
    ...(await readProcessInfo(item.pid))
  })));
  return infos.filter((item) => item.name);
}

function normalizeUsage(value = {}) {
  return {
    inputTokens: Number(value.input_tokens || 0),
    cachedInputTokens: Number(value.cached_input_tokens || 0),
    outputTokens: Number(value.output_tokens || 0),
    reasoningOutputTokens: Number(value.reasoning_output_tokens || 0),
    totalTokens: Number(value.total_tokens || 0)
  };
}

function parseCodexUsageLine(item, current = {}) {
  const payload = item.payload || {};
  if (item.type === 'turn_context') {
    return {
      ...current,
      model: payload.model || current.model || '',
      effort: payload.effort || current.effort || '',
      summary: payload.summary || current.summary || ''
    };
  }
  if (payload.type === 'task_started') {
    return {
      ...current,
      modelContextWindow: Number(payload.model_context_window || current.modelContextWindow || 0)
    };
  }
  if (payload.type !== 'token_count') return current;

  const info = payload.info || {};
  const modelContextWindow = Number(info.model_context_window || current.modelContextWindow || 0);
  const last = normalizeUsage(info.last_token_usage);
  const total = normalizeUsage(info.total_token_usage);
  const effectiveInputTokens = last.inputTokens
    || total.inputTokens
    || (modelContextWindow && total.totalTokens >= modelContextWindow ? total.totalTokens : 0);
  const contextTokens = modelContextWindow
    ? Math.min(modelContextWindow, effectiveInputTokens)
    : effectiveInputTokens;
  const contextRemaining = modelContextWindow ? Math.max(0, modelContextWindow - contextTokens) : 0;
  const contextPercent = modelContextWindow ? Math.min(100, Math.round((contextTokens / modelContextWindow) * 1000) / 10) : 0;
  return {
    ...current,
    available: true,
    updatedAt: item.timestamp || current.updatedAt || '',
    modelContextWindow,
    contextTokens,
    contextRemaining,
    contextPercent,
    lastTokenUsage: last,
    totalTokenUsage: total,
    compactEstimate: {
      thresholdKnown: false,
      remainingTokens: contextRemaining,
      note: 'Codex exposes context window and current request tokens, but not the exact auto-compact threshold.'
    },
    rateLimits: payload.rate_limits || current.rateLimits || null
  };
}

function summarizeCodexEvent(event) {
  if (!event) return null;
  if (event.type === 'error' && event.message) return String(event.message);
  if (event.type === 'turn.failed') {
    return String(event.error?.message || event.message || 'Codex turn failed.');
  }
  const payload = event.payload || {};
  if (payload.type === 'error' && (payload.message || payload.error)) {
    return String(payload.message || payload.error);
  }
  return null;
}

function updateSessionUsageFromEvent(session, event) {
  const before = session.lastCodexUsage || {};
  const next = parseCodexUsageLine(event, before);
  if (next === before) return;
  session.lastCodexUsage = next;
  const run = activeRunRecord(session);
  if (run && next.available) {
    run.tokenSnapshot = {
      updatedAt: next.updatedAt || nowIso(),
      modelContextWindow: next.modelContextWindow || 0,
      contextTokens: next.contextTokens || 0,
      contextRemaining: next.contextRemaining || 0,
      contextPercent: next.contextPercent || 0
    };
    appendRunEvent(session, 'token_count', {
      contextTokens: run.tokenSnapshot.contextTokens,
      contextRemaining: run.tokenSnapshot.contextRemaining,
      summary: `context ${run.tokenSnapshot.contextTokens}/${run.tokenSnapshot.modelContextWindow}`
    }, { runId: run.id });
  }
}

function codexContextIsFull(usage) {
  return Boolean(
    usage?.modelContextWindow
    && usage.contextRemaining === 0
    && usage.contextPercent >= 100
  );
}

function codexExitMessage(code, session, lastError) {
  if (codexContextIsFull(session.lastCodexUsage)) {
    return [
      `Codex exited with code ${code}.`,
      `Codex context is full (${session.lastCodexUsage.contextTokens}/${session.lastCodexUsage.modelContextWindow} tokens).`,
      'Start a fresh Codex session for this project, or compact this native Codex session before retrying.'
    ].join('\n');
  }
  if (lastError) {
    return `Codex exited with code ${code}: ${lastError}`;
  }
  return `Codex exited with code ${code}.`;
}

async function codexUsageInfo(codexSessionId) {
  if (!codexSessionId) return null;
  const codexSession = await findCodexSession(codexSessionId);
  if (!codexSession?.file) return null;
  let info;
  try {
    info = await stat(codexSession.file);
  } catch {
    return null;
  }
  const cached = codexUsageCache.get(codexSession.file);
  if (cached && cached.mtimeMs === info.mtimeMs && cached.size === info.size) return cached.value;

  const raw = await readFile(codexSession.file, 'utf8');
  let value = {
    available: false,
    codexSessionId,
    sessionFile: codexSession.file,
    fileBytes: info.size,
    fileUpdatedAt: new Date(info.mtimeMs).toISOString(),
    model: '',
    effort: '',
    summary: '',
    modelContextWindow: 0,
    contextTokens: 0,
    contextRemaining: 0,
    contextPercent: 0,
    lastTokenUsage: null,
    totalTokenUsage: null,
    compactEstimate: null,
    rateLimits: null
  };
  for (const line of raw.split('\n')) {
    if (!line.trim()) continue;
    try {
      value = parseCodexUsageLine(JSON.parse(line), value);
    } catch {
      // Ignore malformed historical lines.
    }
  }
  codexUsageCache.set(codexSession.file, { mtimeMs: info.mtimeMs, size: info.size, value });
  return value;
}

async function runtimeInfo(session) {
  ensureSessionHarness(session);
  const child = running.get(session.id);
  const rootPid = child?.pid || 0;
  const startedAt = session.activeRun?.startedAt || '';
  const uptimeMs = startedAt ? Math.max(0, Date.now() - Date.parse(startedAt)) : 0;
  const view = sessionView(session);
  const [processes, codexUsage, service] = await Promise.all([
    processTree(rootPid),
    codexUsageInfo(session.codexSessionId),
    serviceRuntimeInfo()
  ]);
  if (codexUsage?.available) session.lastCodexUsage = codexUsage;
  return {
    session: view.session,
    view,
    statusSummary: view.statusSummary,
    contextHealth: view.contextHealth,
    taskDetail: view.taskDetail,
    running: Boolean(child),
    pid: rootPid,
    killed: child?.killed === true,
    exitCode: child?.exitCode ?? null,
    signalCode: child?.signalCode ?? null,
    activeRun: session.activeRun ? {
      ...session.activeRun,
      prompt: summarizeRunPrompt(session.activeRun),
      imageCount: session.activeRun.imagePaths?.length || 0,
      fileCount: session.activeRun.files?.length || 0,
      imagePaths: undefined
    } : null,
    queue: session.queue || [],
    uptimeMs,
    processCount: processes.length,
    memoryKb: processes.reduce((sum, item) => sum + (item.memoryKb || 0), 0),
    cpuMs: processes.reduce((sum, item) => sum + (item.cpuMs || 0), 0),
    processes,
    codexUsage,
    harness: {
      activeRun: publicRun(activeRunRecord(session)),
      lastRun: publicRun(latestRun(session)),
      recentRuns: session.runs.slice(-8).map(publicRun),
      recentAudit: session.audit.slice(-20)
    },
    service,
    checkedAt: nowIso()
  };
}

function queueSummary(session) {
  ensureSessionHarness(session);
  return {
    count: session.queue.length,
    items: session.queue.map((item, index) => ({
      index,
      id: item.id,
      runId: item.runId || '',
      messageId: item.messageId || '',
      clientMessageId: item.clientMessageId || '',
      promptSummary: summarizeRunPrompt({ prompt: item.displayPrompt || item.prompt || '' }),
      imageCount: item.images?.length || 0,
      fileCount: item.files?.length || 0,
      createdAt: item.createdAt || ''
    }))
  };
}

function sessionView(session) {
  ensureSessionHarness(session);
  const statusSummary = deriveSessionStatusSummary(session);
  const child = running.get(session.id);
  const active = activeRunRecord(session);
  const last = latestRun(session);
  return {
    version: 1,
    session: publicSession(session),
    statusSummary,
    activeRun: publicRun(active),
    lastRun: publicRun(last),
    queueSummary: queueSummary(session),
    contextHealth: statusSummary.contextHealth,
    runtimeSummary: {
      running: Boolean(child),
      pid: child?.pid || 0,
      startedAt: session.activeRun?.startedAt || '',
      canStop: statusSummary.canStop
    },
    recentAudit: session.audit.slice(-20),
    taskDetail: {
      run: publicRun(active || last),
      recentEvents: (active || last)?.events?.slice(-12) || [],
      failure: (active || last)?.errorSummary ? {
        code: (active || last)?.errorCode || '',
        summary: (active || last)?.errorSummary || ''
      } : null
    }
  };
}

function publicExternalSession(session) {
  const codexSessionId = session.codexSessionId;
  state.codexSessionTags ||= {};
  state.codexSessionProjects ||= {};
  return {
    id: `codex:${codexSessionId}`,
    source: 'codex',
    title: state.codexSessionTitles?.[codexSessionId] || session.title,
    cwd: session.cwd,
    linkedProjectPath: state.codexSessionProjects[codexSessionId] || '',
    model: '',
    profile: '',
    reasoningEffort: '',
    sandbox: '',
    approval: '',
    addDirs: [],
    configOverrides: [],
    strictConfig: false,
    ignoreUserConfig: false,
    ignoreRules: false,
    tags: normalizeSessionTags(state.codexSessionTags[codexSessionId] || []),
    codexSessionId,
    status: 'external',
    trashedAt: state.hiddenCodexSessions?.[codexSessionId] || '',
    createdAt: session.createdAt || session.updatedAt,
    updatedAt: session.updatedAt,
    activityAt: session.activityAt || session.updatedAt || session.createdAt || '',
    lastSeq: 0,
    messageCount: null
  };
}

function sortPublicSessions(sessions) {
  return sessions.sort((a, b) => String(b.activityAt || b.updatedAt || '').localeCompare(String(a.activityAt || a.updatedAt || '')));
}

function textFromContent(content) {
  if (!content) return '';
  if (typeof content === 'string') return content;
  if (Array.isArray(content)) {
    return content
      .map((part) => {
        if (typeof part === 'string') return part;
        return part?.text || part?.output_text || part?.input_text || '';
      })
      .filter(Boolean)
      .join('\n');
  }
  return content.text || content.output_text || content.input_text || '';
}

function compactText(text, limit = 8000) {
  const value = String(text || '').trim();
  if (value.length <= limit) return value;
  return `${value.slice(0, limit)}\n...[truncated]`;
}

const imageTypes = new Map([
  ['image/png', '.png'],
  ['image/jpeg', '.jpg'],
  ['image/gif', '.gif'],
  ['image/webp', '.webp']
]);
const replyImageExtensions = new Set(['.png', '.jpg', '.jpeg', '.webp', '.gif']);
const safeUploadTypes = new Set([
  '.txt', '.md', '.json', '.jsonl', '.csv', '.tsv', '.log',
  '.pdf', '.doc', '.docx', '.xls', '.xlsx', '.ppt', '.pptx',
  '.xml', '.yaml', '.yml', '.html', '.css', '.js', '.jsx', '.ts', '.tsx',
  '.py', '.go', '.rs', '.java', '.c', '.cc', '.cpp', '.h', '.hpp',
  '.sh', '.sql', '.zip', '.gz', '.tgz'
]);

function uploadUrl(fileName) {
  return `/api/uploads/${encodeURIComponent(fileName)}`;
}

function imageContentType(ext) {
  return contentTypes[ext] || 'application/octet-stream';
}

function uploadSizeText(bytes) {
  const value = Number(bytes || 0);
  if (value >= 1024 * 1024) return `${(value / 1024 / 1024).toFixed(1)}MB`;
  if (value >= 1024) return `${Math.round(value / 1024)}KB`;
  return `${value}B`;
}

function safeUploadExtension(file) {
  const type = String(file.type || '').toLowerCase();
  if (imageTypes.has(type)) return imageTypes.get(type);
  const ext = path.extname(String(file.name || '')).toLowerCase();
  if (safeUploadTypes.has(ext)) return ext;
  return '.bin';
}

function candidateImagePaths(text) {
  const value = String(text || '');
  if (!value) return [];
  const matches = new Set();
  const patterns = [
    /!\[[^\]]*]\(([^)\s]+?\.(?:png|jpe?g|webp|gif))\)/gi,
    /[`"']([^`"']+?\.(?:png|jpe?g|webp|gif))[`"']/gi,
    /((?:file:\/\/|\/|\.{1,2}\/|[A-Za-z0-9_.-]+\/)[^\s'"`)<]+?\.(?:png|jpe?g|webp|gif))/gi,
    /(?:^|\s)([A-Za-z0-9_.-]+?\.(?:png|jpe?g|webp|gif))(?:\s|$)/gi
  ];
  for (const pattern of patterns) {
    for (const match of value.matchAll(pattern)) {
      const raw = match[1];
      if (raw) matches.add(raw.replace(/^<|>$/g, '').trim());
      if (matches.size >= 12) return [...matches];
    }
  }
  return [...matches];
}

function resolveReplyImagePath(session, rawPath) {
  let value = String(rawPath || '').trim();
  if (!value || /^https?:\/\//i.test(value) || /^data:/i.test(value)) return '';
  if (value.startsWith('file://')) value = value.slice('file://'.length);
  try {
    value = decodeURIComponent(value);
  } catch {
    // Keep the original value when it is not URI encoded.
  }
  const cwd = session.cwd ? path.resolve(session.cwd) : '';
  if (!cwd || cwd === path.resolve('.')) return '';
  const resolved = path.resolve(path.isAbsolute(value) ? value : path.join(cwd, value));
  const uploadRoot = path.resolve(UPLOAD_DIR);
  if (!resolved.startsWith(`${cwd}${path.sep}`) && resolved !== cwd && !resolved.startsWith(`${uploadRoot}${path.sep}`)) return '';
  return resolved;
}

function attachReplyImages(session, entry) {
  if (!['assistant', 'tool'].includes(entry.role || '') || !entry.text) return entry;
  const seen = new Set((entry.images || []).map((image) => image.path || image.url || image.fileName).filter(Boolean));
  const images = [...(entry.images || [])];
  for (const rawPath of candidateImagePaths(entry.text)) {
    if (images.length >= 8) break;
    const resolved = resolveReplyImagePath(session, rawPath);
    if (!resolved || seen.has(resolved)) continue;
    const ext = path.extname(resolved).toLowerCase();
    if (!replyImageExtensions.has(ext)) continue;
    let info = null;
    try {
      info = statSync(resolved);
    } catch {
      continue;
    }
    if (!info.isFile() || info.size <= 0 || info.size > 12 * 1024 * 1024) continue;
    const uploadExt = ext === '.jpeg' ? '.jpg' : ext;
    const fileName = `${randomUUID()}${uploadExt}`;
    const filePath = path.join(UPLOAD_DIR, fileName);
    try {
      copyFileSync(resolved, filePath);
      chmodSync(filePath, 0o600);
    } catch {
      continue;
    }
    seen.add(resolved);
    images.push({
      name: path.basename(resolved).slice(0, 160),
      type: imageContentType(uploadExt),
      size: info.size,
      fileName,
      path: filePath,
      url: uploadUrl(fileName),
      source: 'codex-output'
    });
  }
  if (images.length) entry.images = images;
  return entry;
}

async function savePromptImages(images) {
  if (!Array.isArray(images) || !images.length) return [];
  const saved = [];
  for (const image of images.slice(0, 4)) {
    const type = String(image.type || '').toLowerCase();
    const ext = imageTypes.get(type);
    if (!ext) throw new Error('unsupported_image_type');
    const value = String(image.data || '');
    const base64 = value.includes(',') ? value.split(',').pop() : value;
    const buffer = Buffer.from(base64, 'base64');
    if (!buffer.length || buffer.length > 8 * 1024 * 1024) throw new Error('invalid_image_size');
    const fileName = `${randomUUID()}${ext}`;
    const filePath = path.join(UPLOAD_DIR, fileName);
    await writeFile(filePath, buffer, { mode: 0o600 });
    saved.push({
      name: String(image.name || fileName).slice(0, 120),
      type,
      fileName,
      path: filePath,
      url: uploadUrl(fileName)
    });
  }
  return saved;
}

async function savePromptFiles(files) {
  if (!Array.isArray(files) || !files.length) return [];
  const saved = [];
  let totalBytes = 0;
  for (const file of files.slice(0, 6)) {
    const value = String(file.data || '');
    const base64 = value.includes(',') ? value.split(',').pop() : value;
    const buffer = Buffer.from(base64, 'base64');
    totalBytes += buffer.length;
    if (!buffer.length || buffer.length > 10 * 1024 * 1024 || totalBytes > 24 * 1024 * 1024) {
      throw new Error('invalid_file_size');
    }
    const ext = safeUploadExtension(file);
    const fileName = `${randomUUID()}${ext}`;
    const filePath = path.join(UPLOAD_DIR, fileName);
    await writeFile(filePath, buffer, { mode: 0o600 });
    saved.push({
      name: String(file.name || fileName).slice(0, 160),
      type: String(file.type || 'application/octet-stream').slice(0, 120),
      size: buffer.length,
      fileName,
      path: filePath,
      url: uploadUrl(fileName)
    });
  }
  return saved;
}

function promptWithAttachments(prompt, images = [], files = []) {
  const base = String(prompt || '').trim()
    || (images.length ? '请分析这些图片。' : '请分析这些文件。');
  const imageText = images.map((image, index) => [
    `${index + 1}. ${image.name || image.fileName || '未命名图片'}`,
    `   本机路径: ${image.path}`,
    `   访问地址: ${image.url || ''}`,
    `   类型: ${image.type || '未知'}`
  ].join('\n')).join('\n');
  const fileText = files.map((file, index) => [
    `${index + 1}. ${file.name || file.fileName || '未命名文件'}`,
    `   路径: ${file.path}`,
    `   类型: ${file.type || '未知'}`,
    `   大小: ${uploadSizeText(file.size)}`
  ].join('\n')).join('\n');
  const sections = [base];
  if (images.length) {
    sections.push(
      '',
      '附加图片已保存到本机，并且也会通过 Codex 图片输入传入。若需要定位原图，请使用这些路径或地址：',
      imageText
    );
  }
  if (files.length) {
    sections.push(
      '',
      '附加文件已保存到本机，按需读取这些路径，不要猜测文件内容：',
      fileText
    );
  }
  return sections.join('\n');
}

async function collectFiles(root, out = []) {
  let entries = [];
  try {
    entries = await readdir(root, { withFileTypes: true });
  } catch {
    return out;
  }
  for (const entry of entries) {
    const full = path.join(root, entry.name);
    if (entry.isDirectory()) await collectFiles(full, out);
    else if (entry.isFile()) {
      try {
        const info = await stat(full);
        out.push({ path: full, name: entry.name, size: info.size, mtimeMs: info.mtimeMs });
      } catch {
        // Ignore files that disappear during scanning.
      }
    }
  }
  return out;
}

async function directoryBytes(root) {
  const files = await collectFiles(root);
  return files.reduce((sum, file) => sum + file.size, 0);
}

function referencedUploadNames() {
  const refs = new Set();
  const addUpload = (upload) => {
    if (!upload) return;
    if (upload.fileName) refs.add(upload.fileName);
    if (upload.path) refs.add(path.basename(upload.path));
    if (upload.url) refs.add(path.basename(decodeURIComponent(String(upload.url).split('/').pop() || '')));
  };
  for (const session of Object.values(state.sessions || {})) {
    for (const message of session.messages || []) {
      for (const image of message.images || []) addUpload(image);
      for (const file of message.files || []) addUpload(file);
    }
    for (const item of session.queue || []) {
      for (const image of item.images || []) addUpload(image);
      for (const file of item.files || []) addUpload(file);
    }
  }
  return refs;
}

async function storageStats() {
  const [dataBytes, uploadFiles, runtimeBytes] = await Promise.all([
    directoryBytes(DATA_DIR),
    collectFiles(UPLOAD_DIR),
    directoryBytes(RUNTIME_DIR)
  ]);
  let stateBytes = 0;
  let messageDatabaseBytes = 0;
  try {
    stateBytes = (await stat(STATE_FILE)).size;
  } catch {
    stateBytes = 0;
  }
  try {
    messageDatabaseBytes = (await stat(MESSAGE_DB_FILE)).size;
  } catch {
    messageDatabaseBytes = 0;
  }
  const messageDatabase = await messageStore.stats().catch(() => ({ messageCount: 0, sessionCount: 0 }));
  let disk = null;
  try {
    const info = await statfs(__dirname);
    disk = {
      totalBytes: info.blocks * info.bsize,
      freeBytes: info.bavail * info.bsize
    };
  } catch {
    disk = null;
  }
  const refs = referencedUploadNames();
  const uploadBytes = uploadFiles.reduce((sum, file) => sum + file.size, 0);
  const orphanFiles = uploadFiles.filter((file) => !refs.has(file.name));
  return {
    settings: normalizeStorageSettings(state.storageSettings),
    dataBytes,
    uploadBytes,
    uploadCount: uploadFiles.length,
    orphanUploadBytes: orphanFiles.reduce((sum, file) => sum + file.size, 0),
    orphanUploadCount: orphanFiles.length,
    runtimeBytes,
    stateBytes,
    messageDatabaseBytes,
    messageDatabase,
    disk,
    updatedAt: nowIso()
  };
}

async function packageMeta() {
  if (packageMetaCache) return packageMetaCache;
  try {
    const pkg = JSON.parse(await readFile(path.join(__dirname, 'package.json'), 'utf8'));
    packageMetaCache = {
      name: String(pkg.name || 'codex-mobile-console'),
      version: String(pkg.version || '')
    };
  } catch {
    packageMetaCache = { name: 'codex-mobile-console', version: '' };
  }
  return packageMetaCache;
}

async function serviceRuntimeInfo() {
  const [pkg, diskInfo] = await Promise.all([
    packageMeta(),
    statfs(__dirname).catch(() => null)
  ]);
  const memory = process.memoryUsage();
  const disk = diskInfo ? {
    totalBytes: diskInfo.blocks * diskInfo.bsize,
    freeBytes: diskInfo.bavail * diskInfo.bsize
  } : null;
  return {
    name: pkg.name,
    version: pkg.version,
    pid: process.pid,
    node: process.version,
    host: HOST,
    port: PORT,
    startedAt: SERVICE_STARTED_AT,
    uptimeMs: Math.round(process.uptime() * 1000),
    memory: {
      rssBytes: memory.rss,
      heapUsedBytes: memory.heapUsed,
      heapTotalBytes: memory.heapTotal,
      externalBytes: memory.external
    },
    activeRequests,
    totalRequests,
    sseClients: [...clients.values()].reduce((sum, set) => sum + set.size, 0),
    runningSessions: running.size,
    sessionCount: Object.keys(state.sessions || {}).length,
    authSessionCount: Object.keys(state.authSessions || {}).length,
    dataDir: DATA_DIR,
    codexHome: CODEX_HOME,
    codexBin: CODEX_BIN,
    disk
  };
}

function runCommand(command, args = [], options = {}) {
  const timeoutMs = Math.max(1, Number(options.timeoutMs || 8000));
  return new Promise((resolve) => {
    const child = spawn(command, args, {
      cwd: options.cwd || __dirname,
      detached: process.platform !== 'win32',
      env: commandEnv(),
      stdio: ['ignore', 'pipe', 'pipe']
    });
    let stdout = '';
    let stderr = '';
    let settled = false;
    let timedOut = false;
    let killTimer = null;
    const finish = (result) => {
      if (settled) return;
      settled = true;
      clearTimeout(timer);
      clearTimeout(killTimer);
      const code = timedOut ? 124 : result.code;
      const signal = timedOut ? 'timeout' : result.signal || '';
      resolve({
        ok: !timedOut && result.code === 0,
        code,
        signal,
        stdout: stdout.trim(),
        stderr: stderr.trim()
      });
    };
    const timer = setTimeout(() => {
      timedOut = true;
      stderr += `\nCommand timed out after ${timeoutMs}ms.`;
      terminateChildProcess(child, 'SIGTERM');
      killTimer = setTimeout(() => {
        terminateChildProcess(child, 'SIGKILL');
        finish({ code: 124, signal: 'timeout' });
      }, COMMAND_KILL_GRACE_MS);
      killTimer.unref?.();
    }, timeoutMs);
    timer.unref?.();
    child.stdout.on('data', (chunk) => {
      stdout += chunk.toString();
      if (stdout.length > 20000) stdout = stdout.slice(-20000);
    });
    child.stderr.on('data', (chunk) => {
      stderr += chunk.toString();
      if (stderr.length > 20000) stderr = stderr.slice(-20000);
    });
    child.on('error', (error) => {
      stderr += error.message || String(error);
      finish({ code: 127 });
    });
    child.on('close', (code, signal) => finish({ code, signal }));
  });
}

async function restartMarkerInfo() {
  try {
    return JSON.parse(await readFile(RESTART_MARKER_FILE, 'utf8'));
  } catch {
    return null;
  }
}

async function codexVersionInfo(options = {}) {
  const includeLatest = options.latest !== false;
  const currentResult = await runCommand(CODEX_BIN, ['--version'], { timeoutMs: 6000 });
  const currentText = currentResult.stdout || currentResult.stderr || '';
  const currentVersion = (currentText.match(/(\d+\.\d+\.\d+(?:[-+][\w.-]+)?)/) || [])[1] || '';
  const latestResult = includeLatest
    ? await runCommand('npm', ['view', '@openai/codex', 'version'], { timeoutMs: 10000 })
    : null;
  const latestVersion = latestResult ? (latestResult.stdout.match(/(\d+\.\d+\.\d+(?:[-+][\w.-]+)?)/) || [])[1] || '' : '';
  return {
    codexBin: CODEX_BIN,
    node: CODEX_NODE,
    currentVersion,
    currentText,
    currentOk: currentResult.ok,
    currentError: currentResult.ok ? '' : currentResult.stderr || currentResult.stdout || 'codex_version_failed',
    latestVersion,
    latestOk: latestResult ? latestResult.ok : false,
    latestError: latestResult && !latestResult.ok ? latestResult.stderr || latestResult.stdout || 'npm_view_failed' : '',
    updateAvailable: Boolean(currentVersion && latestVersion && currentVersion !== latestVersion),
    checkedAt: nowIso(),
    upgradeTask: codexUpgradeTask
  };
}

async function systemHealth() {
  const [service, storage, codex, restartMarker, app] = await Promise.all([
    serviceRuntimeInfo(),
    storageStats(),
    codexVersionInfo({ latest: false }),
    restartMarkerInfo(),
    appVersionInfo({ checkRemote: false })
  ]);
  const sessions = Object.values(state.sessions || {});
  const staleRecovered = sessions.filter((session) => reconcileSessionRunState(session, 'health-check')).length;
  if (staleRecovered) scheduleSave();
  const queuedMessages = sessions.reduce((sum, session) => sum + (session.queue?.length || 0), 0);
  const failedRuns = sessions.reduce((sum, session) => sum + (session.runs || []).filter((run) => run.status === 'failed').length, 0);
  const warnings = [];
  if (running.size > 0) warnings.push(`${running.size} 个 Codex 任务运行中，升级或重启会等待或被阻止。`);
  if (storage.disk && storage.disk.freeBytes / Math.max(1, storage.disk.totalBytes) < 0.1) warnings.push('磁盘剩余低于 10%，上传和状态保存可能失败。');
  if (!codex.currentOk) warnings.push('Codex 命令不可用或版本读取失败。');
  if (restartMarker) warnings.push('存在重启恢复标记，说明上次重启前有运行中任务。');
  return {
    ok: warnings.length === 0,
    service,
    storage,
    codex,
    app,
    restartMarker,
    sessions: {
      total: sessions.length,
      running: running.size,
      queuedMessages,
      failedRuns,
      staleRecovered
    },
    sseClients: service.sseClients,
    upgradeTask: codexUpgradeTask,
    warnings,
    checkedAt: nowIso()
  };
}

async function startCodexUpgrade() {
  if (codexUpgradeTask?.status === 'running') return codexUpgradeTask;
  if (running.size > 0) {
    const error = new Error('sessions_running');
    error.code = 'sessions_running';
    throw error;
  }
  const before = await codexVersionInfo({ latest: false });
  codexUpgradeTask = {
    id: randomUUID(),
    status: 'running',
    startedAt: nowIso(),
    finishedAt: '',
    currentVersion: before.currentVersion || '',
    target: 'latest',
    code: null,
    signal: '',
    timeoutMs: CODEX_UPGRADE_TIMEOUT_MS,
    log: '',
    restart: null
  };
  const task = codexUpgradeTask;
  const child = spawn('npm', ['install', '-g', '@openai/codex@latest'], {
    cwd: __dirname,
    detached: process.platform !== 'win32',
    env: commandEnv(),
    stdio: ['ignore', 'pipe', 'pipe']
  });
  let settled = false;
  let timedOut = false;
  let killTimer = null;
  const append = (chunk) => {
    task.log += chunk.toString();
    if (task.log.length > 20000) task.log = task.log.slice(-20000);
  };
  const finish = async (code, signal = '') => {
    if (settled) return;
    settled = true;
    clearTimeout(timeoutTimer);
    clearTimeout(killTimer);
    task.code = timedOut ? 124 : code;
    task.signal = timedOut ? 'timeout' : signal || '';
    task.finishedAt = nowIso();
    if (!timedOut && code === 0) {
      task.status = 'finished';
      task.after = await codexVersionInfo({ latest: false }).catch(() => null);
      task.restart = await requestServiceRestart('codex-upgrade').catch((error) => ({ error: error.message || String(error) }));
    } else {
      task.status = 'failed';
    }
  };
  const timeoutTimer = setTimeout(() => {
    timedOut = true;
    append(`\nCodex upgrade timed out after ${CODEX_UPGRADE_TIMEOUT_MS}ms.`);
    terminateChildProcess(child, 'SIGTERM');
    killTimer = setTimeout(() => {
      terminateChildProcess(child, 'SIGKILL');
      finish(124, 'timeout');
    }, COMMAND_KILL_GRACE_MS);
    killTimer.unref?.();
  }, CODEX_UPGRADE_TIMEOUT_MS);
  timeoutTimer.unref?.();
  child.stdout.on('data', append);
  child.stderr.on('data', append);
  child.on('error', (error) => {
    append(`\n${error.message || error}`);
    finish(127, 'error');
  });
  child.on('close', (code, signal) => {
    finish(code, signal);
  });
  return task;
}

function shortGitRef(value = '') {
  return String(value || '').trim().slice(0, 12);
}

async function gitInfo() {
  const [commit, branch, status, remote, tag] = await Promise.all([
    runCommand('git', ['rev-parse', 'HEAD'], { timeoutMs: 6000 }),
    runCommand('git', ['branch', '--show-current'], { timeoutMs: 6000 }),
    runCommand('git', ['status', '--short'], { timeoutMs: 6000 }),
    runCommand('git', ['remote', 'get-url', 'origin'], { timeoutMs: 6000 }),
    runCommand('git', ['describe', '--tags', '--exact-match'], { timeoutMs: 6000 })
  ]);
  return {
    ok: commit.ok,
    commit: commit.stdout || '',
    shortCommit: shortGitRef(commit.stdout),
    branch: branch.stdout || '',
    dirty: Boolean(status.stdout),
    dirtySummary: status.stdout.split('\n').filter(Boolean).slice(0, 12),
    remote: remote.stdout || '',
    tag: tag.ok ? tag.stdout : '',
    errors: [commit, branch, status, remote].filter((item) => !item.ok).map((item) => item.stderr || item.stdout).filter(Boolean)
  };
}

async function appVersionInfo(options = {}) {
  const [pkg, git, rollback] = await Promise.all([
    packageMeta(),
    gitInfo(),
    Promise.resolve(state.appRollback || null)
  ]);
  let latest = null;
  if (options.checkRemote) latest = await appUpdateCheck();
  return {
    name: pkg.name,
    version: pkg.version,
    git,
    rollback,
    updateTask: appUpdateTask,
    updateSettings: normalizeAppUpdateSettings(state.appUpdateSettings),
    latest,
    checkedAt: nowIso()
  };
}

async function fetchJson(url, timeoutMs = 10000) {
  const controller = new AbortController();
  const timer = setTimeout(() => controller.abort(), timeoutMs);
  timer.unref?.();
  try {
    const response = await fetch(url, {
      signal: controller.signal,
      headers: { accept: 'application/json' }
    });
    const text = await response.text();
    if (!response.ok) {
      const error = new Error(text || `HTTP ${response.status}`);
      error.status = response.status;
      throw error;
    }
    return text ? JSON.parse(text) : {};
  } finally {
    clearTimeout(timer);
  }
}

function withTimeout(promise, timeoutMs, fallback) {
  let timer = null;
  return Promise.race([
    Promise.resolve(promise).finally(() => clearTimeout(timer)),
    new Promise((resolve) => {
      timer = setTimeout(() => resolve(typeof fallback === 'function' ? fallback() : fallback), timeoutMs);
      timer.unref?.();
    })
  ]);
}

function normalizeUpdateManifest(raw = {}) {
  const version = String(raw.version || '').trim();
  const tag = String(raw.tag || (version ? `v${version}` : '')).trim();
  return {
    version,
    tag,
    commit: String(raw.commit || '').trim(),
    bundleUrl: String(raw.bundleUrl || raw.bundle || '').trim(),
    bundleSha256: String(raw.bundleSha256 || raw.sha256 || '').trim().toLowerCase(),
    publishedAt: String(raw.publishedAt || '').trim()
  };
}

async function manifestUpdateCheck(pkg, git) {
  if (!APP_UPDATE_MANIFEST_URL) return null;
  const result = {
    source: 'manifest',
    manifestUrl: APP_UPDATE_MANIFEST_URL,
    ok: true,
    latestVersion: '',
    latestTag: '',
    latestTagCommit: '',
    latestRemoteCommit: '',
    updateAvailable: false,
    target: '',
    mode: '',
    bundleUrl: '',
    bundleSha256: '',
    warnings: [],
    checkedAt: nowIso()
  };
  try {
    const manifest = normalizeUpdateManifest(await fetchJson(APP_UPDATE_MANIFEST_URL, 10000));
    result.latestVersion = manifest.version;
    result.latestTag = manifest.tag;
    result.latestTagCommit = manifest.commit;
    result.latestRemoteCommit = manifest.commit;
    result.bundleUrl = manifest.bundleUrl;
    result.bundleSha256 = manifest.bundleSha256;
    if (!manifest.version || !isSemverTag(manifest.tag)) {
      result.ok = false;
      result.warnings.push('OSS 更新清单缺少有效 version/tag。');
      return result;
    }
    if (compareSemver(manifest.version, pkg.version) <= 0 && (!manifest.commit || manifest.commit === git.commit)) {
      return result;
    }
    if (!manifest.bundleUrl || !manifest.bundleSha256) {
      result.ok = false;
      result.warnings.push('OSS 更新清单缺少 bundleUrl/bundleSha256，无法安全升级。');
      return result;
    }
    result.updateAvailable = true;
    result.target = manifest.bundleUrl;
    result.mode = 'bundle';
    return result;
  } catch (error) {
    result.ok = false;
    result.warnings.push(`OSS 更新源不可用：${error.message || String(error)}`);
    return result;
  }
}

function versionFromTag(tag = '') {
  return String(tag || '').replace(/^v/i, '');
}

function isSemverTag(tag = '') {
  return /^v?\d+\.\d+\.\d+(?:[-+][\w.-]+)?$/.test(String(tag || '').trim());
}

function compareSemver(a = '', b = '') {
  const parse = (value) => versionFromTag(value).split(/[.-]/).slice(0, 3).map((part) => Number(part) || 0);
  const left = parse(a);
  const right = parse(b);
  for (let index = 0; index < 3; index += 1) {
    if (left[index] !== right[index]) return left[index] - right[index];
  }
  return 0;
}

function projectIdFromPath(projectPath = '') {
  return createHash('sha1').update(path.resolve(projectPath)).digest('hex').slice(0, 16);
}

function isProjectCandidate(entry) {
  return entry.isDirectory()
    && !entry.name.startsWith('.')
    && !['node_modules', 'runtime', 'data'].includes(entry.name);
}

async function readJsonFile(file, fallback = null) {
  try {
    return JSON.parse(await readFile(file, 'utf8'));
  } catch {
    return fallback;
  }
}

async function packageInfo(projectPath) {
  const pkg = await readJsonFile(path.join(projectPath, 'package.json'), null);
  if (!pkg) return { exists: false, name: '', version: '', scripts: {} };
  return {
    exists: true,
    name: String(pkg.name || ''),
    version: String(pkg.version || ''),
    scripts: pkg.scripts && typeof pkg.scripts === 'object' ? pkg.scripts : {}
  };
}

function defaultEvolutionConfig(projectPath, pkg = {}) {
  const name = pkg.name || path.basename(projectPath);
  const checkCommands = [];
  const scripts = pkg.scripts || {};
  for (const scriptName of ['check:state', 'check:mobile-ui', 'test', 'lint']) {
    if (scripts[scriptName]) checkCommands.push(`npm run ${scriptName}`);
  }
  if (checkCommands.length === 0 && pkg.exists) checkCommands.push('node --check server.js');
  return {
    version: 1,
    project: name,
    objective: '',
    autonomyLevel: 'L1',
    qualityGoals: ['主流程稳定', '错误可诊断', '变更可验证'],
    signals: ['git status --short', 'git log --oneline -5', 'runtime logs', 'user feedback'],
    checkCommands,
    allowedAutonomousChanges: ['文档', '测试', '日志增强', '错误提示', '低风险 UI 修复'],
    requiresHumanApproval: ['认证授权', '删除数据', '大重构', '依赖升级', '自动发布']
  };
}

function normalizeEvolutionConfig(config = {}, projectPath = '', pkg = {}) {
  const base = defaultEvolutionConfig(projectPath, pkg);
  const list = (value, fallback) => Array.isArray(value)
    ? value.map((item) => String(item || '').trim()).filter(Boolean).slice(0, 50)
    : fallback;
  return {
    version: 1,
    project: String(config.project || base.project || path.basename(projectPath)).slice(0, 120),
    objective: String(config.objective || base.objective || '').slice(0, 500),
    autonomyLevel: ['L0', 'L1', 'L2', 'L3'].includes(config.autonomyLevel) ? config.autonomyLevel : base.autonomyLevel,
    qualityGoals: list(config.qualityGoals, base.qualityGoals),
    signals: list(config.signals, base.signals),
    checkCommands: list(config.checkCommands, base.checkCommands).slice(0, 12),
    allowedAutonomousChanges: list(config.allowedAutonomousChanges, base.allowedAutonomousChanges),
    requiresHumanApproval: list(config.requiresHumanApproval, base.requiresHumanApproval)
  };
}

async function projectGitSummary(projectPath) {
  const [inside, branch, commit, status, log] = await Promise.all([
    runCommand('git', ['rev-parse', '--is-inside-work-tree'], { cwd: projectPath, timeoutMs: 4000 }),
    runCommand('git', ['branch', '--show-current'], { cwd: projectPath, timeoutMs: 4000 }),
    runCommand('git', ['rev-parse', '--short', 'HEAD'], { cwd: projectPath, timeoutMs: 4000 }),
    runCommand('git', ['status', '--short'], { cwd: projectPath, timeoutMs: 4000 }),
    runCommand('git', ['log', '--oneline', '-5'], { cwd: projectPath, timeoutMs: 4000 })
  ]);
  const ok = inside.ok && inside.stdout === 'true';
  return {
    ok,
    branch: ok ? branch.stdout : '',
    commit: ok ? commit.stdout : '',
    dirty: ok ? Boolean(status.stdout) : false,
    dirtySummary: ok ? status.stdout.split('\n').filter(Boolean).slice(0, 10) : [],
    recent: ok ? log.stdout.split('\n').filter(Boolean) : []
  };
}

async function resolveEvolutionProject(projectId) {
  const projects = await listEvolutionProjects({ includeDetails: false });
  return projects.find((project) => project.id === projectId) || null;
}

async function normalizeLinkedProjectPath(value = '') {
  const raw = String(value || '').trim();
  if (!raw) return '';
  const resolved = path.resolve(raw);
  const real = await realpath(resolved).catch(() => '');
  if (!real || !isInsidePath(PROJECTS_ROOT, real)) {
    const error = new Error('关联项目必须在项目根目录下。');
    error.code = 'invalid_linked_project';
    throw error;
  }
  return real;
}

async function publicEvolutionProject(projectPath, options = {}) {
  const real = await realpath(projectPath).catch(() => '');
  if (!real || !isInsidePath(PROJECTS_ROOT, real)) return null;
  const pkg = await packageInfo(real);
  const configPath = path.join(real, 'evolution.json');
  const rawConfig = await readJsonFile(configPath, null);
  const config = normalizeEvolutionConfig(rawConfig || {}, real, pkg);
  const git = options.includeDetails === false ? null : await projectGitSummary(real);
  return {
    id: projectIdFromPath(real),
    name: config.project || pkg.name || path.basename(real),
    path: real,
    relativePath: path.relative(PROJECTS_ROOT, real) || '.',
    hasConfig: Boolean(rawConfig),
    config,
    package: pkg,
    git
  };
}

async function listEvolutionProjects(options = {}) {
  const entries = await readdir(PROJECTS_ROOT, { withFileTypes: true }).catch(() => []);
  const projects = [];
  for (const entry of entries.filter(isProjectCandidate).slice(0, 80)) {
    const project = await publicEvolutionProject(path.join(PROJECTS_ROOT, entry.name), options);
    if (project) projects.push(project);
  }
  return projects.sort((a, b) => a.name.localeCompare(b.name));
}

async function initEvolutionProject(projectId) {
  const project = await resolveEvolutionProject(projectId);
  if (!project) return null;
  const full = await publicEvolutionProject(project.path);
  await writeFile(path.join(project.path, 'evolution.json'), `${JSON.stringify(full.config, null, 2)}\n`, { mode: 0o644 });
  return publicEvolutionProject(project.path);
}

async function updateEvolutionConfig(projectId, patch = {}) {
  const project = await resolveEvolutionProject(projectId);
  if (!project) return null;
  const full = await publicEvolutionProject(project.path);
  const nextPatch = {};
  if ('objective' in patch) nextPatch.objective = String(patch.objective || '').trim().slice(0, 500);
  const nextConfig = normalizeEvolutionConfig({
    ...full.config,
    ...nextPatch
  }, project.path, full.package);
  await writeFile(path.join(project.path, 'evolution.json'), `${JSON.stringify(nextConfig, null, 2)}\n`, { mode: 0o644 });
  return publicEvolutionProject(project.path);
}

async function linkedSessionsForProject(projectPath) {
  const external = await listCodexSessions();
  return [
    ...Object.values(state.sessions || {}),
    ...external
  ].filter((session) => session.linkedProjectPath === projectPath && !session.trashedAt);
}

async function projectLinkedHistoryText(projectPath) {
  const sessions = await linkedSessionsForProject(projectPath);
  const chunks = [];
  for (const session of sessions.slice(0, 8)) {
    chunks.push(`${session.title || ''} ${session.cwd || ''}`);
    chunks.push(await sessionHistoryMatchText(session));
  }
  return chunks.join('\n').slice(-60000);
}

function hasAnyText(text, words) {
  return words.some((word) => text.includes(word));
}

function uniqueObjectiveSuggestions(items) {
  const seen = new Set();
  const out = [];
  for (const item of items) {
    const text = String(item || '').replace(/\s+/g, ' ').trim();
    if (!text || seen.has(text)) continue;
    seen.add(text);
    out.push(text);
  }
  return out.slice(0, 5);
}

async function suggestEvolutionObjectives(projectId) {
  const project = await resolveEvolutionProject(projectId);
  if (!project) return null;
  const full = await publicEvolutionProject(project.path, { includeDetails: false });
  const name = full.name || path.basename(full.path);
  const history = normalizeProjectMatchText([
    full.config.objective,
    full.package?.name,
    full.relativePath,
    await projectLinkedHistoryText(full.path)
  ].join('\n'));
  const suggestions = [];

  if (hasAnyText(history, ['手机', 'mobile', 'ui', '界面', '卡顿', '滚动', '侧边栏', '按钮', '交互'])) {
    suggestions.push(`持续提升 ${name} 的移动端使用体验，重点优化界面密度、交互流畅度、状态反馈和低卡顿操作。`);
  }
  if (hasAnyText(history, ['会话', 'session', '队列', '停止', '运行', '状态', '恢复', '重启', '上下文'])) {
    suggestions.push(`完善 ${name} 的会话生命周期管理，确保运行状态准确、任务可恢复、队列可控、历史上下文可追踪。`);
  }
  if (hasAnyText(history, ['进化', '目标', '关联', '项目', '巡检', '推荐', '自演进', 'loop'])) {
    suggestions.push(`为 ${name} 建立项目自演进能力，围绕目标、会话关联、巡检建议和低风险优化形成可持续迭代流程。`);
  }
  if (hasAnyText(history, ['部署', '发布', '版本', '更新', 'github', 'oss', 'release', '自动升级'])) {
    suggestions.push(`提升 ${name} 的部署和更新可靠性，确保版本检查、发布分发、自动升级和回滚流程清晰可验证。`);
  }
  if (hasAnyText(history, ['图片', '附件', '文件', 'markdown', '表格', '截图', '复制', '分享'])) {
    suggestions.push(`增强 ${name} 的富内容输入输出能力，让图片、文件、Markdown、表格和分享内容在手机端稳定易用。`);
  }
  if (hasAnyText(history, ['skill', '技能', '工具', 'runtime', '运行时', '日志', '诊断'])) {
    suggestions.push(`强化 ${name} 的工具化和诊断能力，让 Skill、运行时信息、日志和异常排查更容易被发现和使用。`);
  }

  suggestions.push(`持续提升 ${name} 的稳定性、可维护性和可验证性，优先保障核心流程可靠运行并降低后续迭代风险。`);
  suggestions.push(`围绕真实使用场景优化 ${name}，把高频操作做得更顺手，把异常状态做得更可诊断。`);

  return {
    project: full,
    linkedSessionCount: (await linkedSessionsForProject(full.path)).length,
    suggestions: uniqueObjectiveSuggestions(suggestions)
  };
}

function evolutionPrompt(project, audit = {}) {
  return [
    '你是本项目的维护代理。请基于项目自演进配置进行一轮低风险优化。',
    '',
    `项目：${project.name}`,
    `路径：${project.path}`,
    `自治等级：${project.config.autonomyLevel}`,
    `目标：${project.config.objective || '未填写，请先根据项目代码和 README 推断。'}`,
    '',
    `质量目标：${project.config.qualityGoals.join('；')}`,
    `允许自动修改：${project.config.allowedAutonomousChanges.join('；')}`,
    `必须人工确认：${project.config.requiresHumanApproval.join('；')}`,
    '',
    '请执行：',
    '1. 读取 evolution.json、README、最近 git log 和可用日志。',
    '2. 生成 5 个候选优化项，并按用户影响、风险、成本、可验证性评分。',
    '3. 只选择一个低风险、高价值、可验证的小任务实现。',
    '4. 运行项目 checkCommands 中的检查。',
    '5. 如果涉及必须人工确认的范围，只输出方案，不要修改。',
    '',
    audit.candidates?.length ? `本次巡检候选：\n${audit.candidates.map((item, index) => `${index + 1}. ${item.title} - ${item.reason}`).join('\n')}` : ''
  ].filter(Boolean).join('\n');
}

async function auditEvolutionProject(projectId) {
  const project = await resolveEvolutionProject(projectId);
  if (!project) return null;
  const full = await publicEvolutionProject(project.path);
  const candidates = [];
  if (!full.hasConfig) candidates.push({ title: '初始化 evolution.json', reason: '项目还没有自演进配置。', risk: 'low' });
  if (full.git?.dirty) candidates.push({ title: '清理或提交工作区改动', reason: `存在 ${full.git.dirtySummary.length} 条未提交改动。`, risk: 'medium' });
  if (full.config.checkCommands.length === 0) candidates.push({ title: '补充检查命令', reason: '缺少可自动验证的 checkCommands。', risk: 'low' });
  if (!full.config.objective) candidates.push({ title: '补充项目目标', reason: 'objective 为空，AI 难以判断优化方向。', risk: 'low' });
  const todo = await runCommand('rg', ['-n', 'TODO|FIXME', '.', '--glob', '!node_modules', '--glob', '!data', '--glob', '!runtime'], { cwd: project.path, timeoutMs: 5000 });
  const todoCount = todo.ok ? todo.stdout.split('\n').filter(Boolean).length : 0;
  if (todoCount > 0) candidates.push({ title: '梳理 TODO/FIXME', reason: `检测到 ${todoCount} 条 TODO/FIXME。`, risk: 'low' });
  if (candidates.length === 0) candidates.push({ title: '进行一轮低风险体验/可靠性巡检', reason: '未发现明确异常，可从日志、测试和 README 寻找小步优化。', risk: 'low' });
  return {
    project: full,
    candidates,
    prompt: evolutionPrompt(full, { candidates }),
    checkedAt: nowIso()
  };
}

async function runEvolutionChecks(projectId) {
  const project = await resolveEvolutionProject(projectId);
  if (!project) return null;
  const full = await publicEvolutionProject(project.path);
  const results = [];
  for (const command of full.config.checkCommands.slice(0, 8)) {
    const result = await runCommand('/bin/bash', ['-lc', command], { cwd: project.path, timeoutMs: 120000 });
    results.push({
      command,
      ok: result.ok,
      code: result.code,
      stdout: result.stdout.slice(-4000),
      stderr: result.stderr.slice(-4000)
    });
    if (!result.ok) break;
  }
  return { project: full, results, ok: results.every((item) => item.ok), checkedAt: nowIso() };
}

function normalizeProjectMatchText(value = '') {
  return String(value || '')
    .toLowerCase()
    .replace(/[^a-z0-9\u4e00-\u9fa5]+/g, '');
}

function projectAliases(project) {
  return [
    project.name,
    project.relativePath,
    path.basename(project.path || ''),
    project.package?.name
  ]
    .map((item) => String(item || '').trim())
    .filter(Boolean);
}

async function sessionHistoryMatchText(session) {
  try {
    const messages = await displayMessages(session, 140);
    return messages
      .slice(-140)
      .map((message) => [
        message.role || '',
        message.text || '',
        ...(message.files || []).map((file) => file.name || file.path || ''),
        ...(message.images || []).map((image) => image.name || '')
      ].join(' '))
      .join('\n')
      .slice(-28000);
  } catch {
    return '';
  }
}

function bestProjectAliasMatch(projects, text, baseConfidence, reasonPrefix) {
  const normalizedText = normalizeProjectMatchText(text);
  if (!normalizedText) return null;
  let best = null;
  for (const project of projects) {
    for (const alias of projectAliases(project)) {
      const normalizedAlias = normalizeProjectMatchText(alias);
      if (normalizedAlias.length < 4) continue;
      if (!normalizedText.includes(normalizedAlias)) continue;
      const confidence = Math.min(96, baseConfidence + Math.min(8, Math.floor(normalizedAlias.length / 4)));
      if (!best || confidence > best.confidence || normalizedAlias.length > best.aliasLength) {
        best = {
          project,
          confidence,
          reason: `${reasonPrefix} ${alias}`,
          aliasLength: normalizedAlias.length
        };
      }
    }
  }
  return best ? { project: best.project, confidence: best.confidence, reason: best.reason } : null;
}

async function inferLinkedProjectForSession(session, projects) {
  if (session.linkedProjectPath) return null;
  const cwd = session.cwd ? path.resolve(session.cwd) : '';
  const cwdProject = projects
    .filter((project) => cwd && cwd !== PROJECTS_ROOT && (cwd === project.path || cwd.startsWith(`${project.path}${path.sep}`)))
    .sort((a, b) => b.path.length - a.path.length)[0];
  if (cwdProject) {
    return { project: cwdProject, confidence: 100, reason: '工作目录在项目目录内' };
  }

  const titleMatch = bestProjectAliasMatch(projects, `${session.title || ''} ${session.cwd || ''}`, 84, '标题匹配');
  if (titleMatch) return titleMatch;

  const historyText = await sessionHistoryMatchText(session);
  const historyMatch = bestProjectAliasMatch(projects, historyText, 80, '历史上下文匹配');
  if (historyMatch) return historyMatch;
  return null;
}

async function inferEvolutionSessionLinks({ apply = false } = {}) {
  const projects = await listEvolutionProjects({ includeDetails: false });
  const sessions = [
    ...Object.values(state.sessions || {}),
    ...(await listCodexSessions())
  ].filter((session) => !session.trashedAt);
  const suggestions = [];
  let applied = 0;
  for (const session of sessions) {
    const match = await inferLinkedProjectForSession(session, projects);
    if (!match) continue;
    const suggestion = {
      sessionId: session.id,
      sessionTitle: session.title || '',
      sessionCwd: session.cwd || '',
      projectName: match.project.name,
      projectPath: match.project.path,
      confidence: match.confidence,
      reason: match.reason,
      applied: false
    };
    if (apply && match.confidence >= 82) {
      if (session.id.startsWith('codex:')) {
        state.codexSessionProjects ||= {};
        state.codexSessionProjects[session.codexSessionId] = match.project.path;
      } else if (state.sessions[session.id]) {
        state.sessions[session.id].linkedProjectPath = match.project.path;
        state.sessions[session.id].updatedAt = nowIso();
      }
      suggestion.applied = true;
      applied += 1;
    }
    suggestions.push(suggestion);
  }
  if (applied > 0) scheduleSave();
  return {
    ok: true,
    apply,
    applied,
    suggested: suggestions.length,
    suggestions: suggestions.slice(0, 200),
    sessions: sortPublicSessions([...Object.values(state.sessions || {}).map(publicSession), ...(await listCodexSessions())])
  };
}

async function appUpdateCheck() {
  const [git, pkg] = await Promise.all([gitInfo(), packageMeta()]);
  const result = {
    source: APP_UPDATE_MANIFEST_URL ? 'github-fallback' : 'github',
    manifestUrl: APP_UPDATE_MANIFEST_URL,
    ok: git.ok,
    currentCommit: git.commit,
    currentShortCommit: git.shortCommit,
    currentBranch: git.branch,
    currentTag: git.tag,
    dirty: git.dirty,
    remote: git.remote,
    latestTag: '',
    latestTagCommit: '',
    latestRemoteCommit: '',
    updateAvailable: false,
    target: '',
    mode: '',
    bundleUrl: '',
    bundleSha256: '',
    warnings: [],
    checkedAt: nowIso()
  };
  if (!git.ok) {
    result.ok = false;
    result.warnings.push('当前目录不是可用的 git 仓库，无法自动检测控制台更新。');
    return result;
  }

  const manifestResult = await manifestUpdateCheck(pkg, git);
  if (manifestResult?.ok) {
    if (git.dirty) manifestResult.warnings.push('本地工作区有未提交改动，自动升级会被阻止。');
    return manifestResult;
  }
  if (manifestResult?.warnings?.length) result.warnings.push(...manifestResult.warnings);

  const branch = git.branch || 'main';
  const remoteTags = await withTimeout(
    runCommand('git', ['ls-remote', '--tags', 'origin', 'v*'], { timeoutMs: 12000 }),
    APP_UPDATE_CHECK_TIMEOUT_MS,
    { ok: false, stdout: '', stderr: `GitHub 远端版本检查超过 ${Math.round(APP_UPDATE_CHECK_TIMEOUT_MS / 1000)} 秒。` }
  );
  if (!remoteTags.ok) {
    result.ok = false;
    result.warnings.push(remoteTags.stderr || remoteTags.stdout || '无法读取 GitHub 远端标签。');
    return result;
  }

  const remoteTagMap = new Map();
  for (const line of remoteTags.stdout.split('\n')) {
    const [commit, ref] = line.trim().split(/\s+/);
    if (!commit || !ref) continue;
    const peeled = ref.endsWith('^{}');
    const tag = ref.replace(/^refs\/tags\//, '').replace(/\^\{\}$/, '');
    if (!isSemverTag(tag)) continue;
    const entry = remoteTagMap.get(tag) || {};
    if (peeled) entry.peeledCommit = commit;
    else entry.commit = commit;
    remoteTagMap.set(tag, entry);
  }
  const latestTag = [...remoteTagMap.keys()].sort((a, b) => -compareSemver(a, b))[0] || '';
  result.latestTag = latestTag;
  if (latestTag) {
    const tagInfo = remoteTagMap.get(latestTag) || {};
    result.latestTagCommit = tagInfo.peeledCommit || tagInfo.commit || '';
  }

  const remoteCommit = await runCommand('git', ['ls-remote', 'origin', `refs/heads/${branch}`], { timeoutMs: 8000 });
  result.latestRemoteCommit = remoteCommit.stdout || '';
  if (remoteCommit.ok && remoteCommit.stdout) {
    result.latestRemoteCommit = remoteCommit.stdout.trim().split(/\s+/)[0] || '';
  }
  if (!remoteCommit.ok) {
    result.warnings.push(remoteCommit.stderr || remoteCommit.stdout || `无法读取远端分支 ${branch}。`);
  }
  if (latestTag && result.latestTagCommit && result.latestTagCommit !== git.commit && compareSemver(latestTag, pkg.version) > 0) {
    result.updateAvailable = true;
    result.target = latestTag;
    result.mode = 'tag';
  } else if (result.latestRemoteCommit && result.latestRemoteCommit !== git.commit) {
    result.updateAvailable = true;
    result.target = `origin/${branch}`;
    result.mode = 'branch';
  }
  if (git.dirty) result.warnings.push('本地工作区有未提交改动，自动升级会被阻止。');
  return result;
}

async function runAppUpdateSteps(task, steps) {
  for (const step of steps) {
    task.step = step.label;
    task.log += `\n$ ${step.label}`;
    const result = await runCommand(step.command, step.args, { timeoutMs: step.timeoutMs || 60000 });
    task.log += `\n${[result.stdout, result.stderr].filter(Boolean).join('\n')}`.slice(0, 12000);
    if (!result.ok) {
      const error = new Error(result.stderr || result.stdout || `${step.label} failed`);
      error.code = 'step_failed';
      throw error;
    }
  }
}

function appUpdateValidationSteps() {
  return [
    { label: 'npm install --omit=dev', command: 'npm', args: ['install', '--omit=dev'], timeoutMs: 120000 },
    { label: 'node --check server.js', command: 'node', args: ['--check', 'server.js'], timeoutMs: 30000 },
    { label: 'node --check public/app.js', command: 'node', args: ['--check', 'public/app.js'], timeoutMs: 30000 }
  ];
}

function buildAppUpdateSteps(mode, target, check = {}) {
  if (mode === 'bundle') {
    return [
      {
        label: `apply update bundle ${check.latestTag || target}`,
        command: 'node',
        args: [
          'scripts/apply-release-bundle.mjs',
          '--url', target,
          '--sha256', check.bundleSha256 || '',
          '--tag', check.latestTag || '',
          '--root', __dirname
        ],
        timeoutMs: 180000
      },
      ...appUpdateValidationSteps()
    ];
  }
  return [
    { label: 'git fetch --tags origin', command: 'git', args: ['fetch', '--tags', 'origin'], timeoutMs: 30000 },
    mode === 'branch'
      ? { label: `git merge --ff-only ${target}`, command: 'git', args: ['merge', '--ff-only', target], timeoutMs: 30000 }
      : { label: `git checkout ${target}`, command: 'git', args: ['checkout', target], timeoutMs: 30000 },
    ...appUpdateValidationSteps()
  ];
}

async function startAppUpdate(options = {}) {
  if (appUpdateTask?.status === 'running') return appUpdateTask;
  if (running.size > 0) {
    const error = new Error('sessions_running');
    error.code = 'sessions_running';
    throw error;
  }
  const current = await gitInfo();
  if (!current.ok) {
    const error = new Error('git_unavailable');
    error.code = 'git_unavailable';
    throw error;
  }
  if (current.dirty) {
    const error = new Error('dirty_worktree');
    error.code = 'dirty_worktree';
    error.detail = current.dirtySummary.join('\n');
    throw error;
  }
  const check = await appUpdateCheck();
  if (!check.ok) {
    const error = new Error(check.warnings.join('\n') || 'update_check_failed');
    error.code = 'update_check_failed';
    throw error;
  }
  const target = String(options.target || check.target || '').trim();
  const mode = ['tag', 'branch', 'bundle'].includes(options.mode) ? options.mode : check.mode || (target.startsWith('origin/') ? 'branch' : 'tag');
  if (!target) {
    const error = new Error('update_not_available');
    error.code = 'update_not_available';
    throw error;
  }
  state.appRollback = {
    commit: current.commit,
    shortCommit: current.shortCommit,
    branch: current.branch,
    version: (await packageMeta()).version,
    createdAt: nowIso()
  };
  scheduleSave();
  appUpdateTask = {
    id: randomUUID(),
    type: 'update',
    status: 'running',
    startedAt: nowIso(),
    finishedAt: '',
    fromCommit: current.commit,
    fromShortCommit: current.shortCommit,
    target,
    mode,
    step: 'starting',
    code: null,
    log: '',
    restart: null
  };
  const task = appUpdateTask;
  (async () => {
    try {
      await runAppUpdateSteps(task, buildAppUpdateSteps(mode, target, check));
      const after = await gitInfo();
      task.status = 'finished';
      task.finishedAt = nowIso();
      task.afterCommit = after.commit;
      task.afterShortCommit = after.shortCommit;
      task.restart = await requestServiceRestart('app-update');
    } catch (error) {
      task.status = 'failed';
      task.finishedAt = nowIso();
      task.error = error.message || String(error);
    }
  })();
  return task;
}

async function runAutoAppUpdate(reason = 'timer') {
  if (appAutoUpdateInFlight) return;
  const settings = normalizeAppUpdateSettings(state.appUpdateSettings);
  if (!settings.autoUpdate) return;
  if (appUpdateTask?.status === 'running') return;
  if (running.size > 0) return;

  appAutoUpdateInFlight = true;
  state.appUpdateSettings = {
    ...settings,
    lastAutoCheckAt: nowIso(),
    lastAutoError: ''
  };
  scheduleSave();
  try {
    const check = await appUpdateCheck();
    if (!check.ok) {
      state.appUpdateSettings.lastAutoError = (check.warnings || []).join('\n').slice(0, 500) || 'update_check_failed';
      return;
    }
    if (check.dirty) {
      state.appUpdateSettings.lastAutoError = '本地工作区有未提交改动，自动更新已跳过。';
      return;
    }
    if (!check.updateAvailable) return;
    await startAppUpdate({ target: check.target, mode: check.mode, reason });
    state.appUpdateSettings.lastAutoUpdateAt = nowIso();
  } catch (error) {
    state.appUpdateSettings.lastAutoError = String(error.message || error).slice(0, 500);
  } finally {
    appAutoUpdateInFlight = false;
    state.appUpdateSettings = normalizeAppUpdateSettings(state.appUpdateSettings);
    scheduleSave();
  }
}

function startAppUpdateMaintenance() {
  clearInterval(appUpdateMaintenanceTimer);
  const tick = () => {
    const settings = normalizeAppUpdateSettings(state.appUpdateSettings);
    if (!settings.autoUpdate) return;
    const last = Date.parse(settings.lastAutoCheckAt || '') || 0;
    const intervalMs = settings.checkIntervalHours * 60 * 60 * 1000;
    if (!last || Date.now() - last >= intervalMs) {
      runAutoAppUpdate('scheduled').catch(() => {});
    }
  };
  appUpdateMaintenanceTimer = setInterval(tick, 5 * 60 * 1000);
  appUpdateMaintenanceTimer.unref?.();
  setTimeout(tick, 30 * 1000).unref?.();
}

async function startAppRollback() {
  if (appUpdateTask?.status === 'running') return appUpdateTask;
  if (running.size > 0) {
    const error = new Error('sessions_running');
    error.code = 'sessions_running';
    throw error;
  }
  const rollback = state.appRollback;
  if (!rollback?.commit) {
    const error = new Error('rollback_not_found');
    error.code = 'rollback_not_found';
    throw error;
  }
  const current = await gitInfo();
  if (current.dirty) {
    const error = new Error('dirty_worktree');
    error.code = 'dirty_worktree';
    error.detail = current.dirtySummary.join('\n');
    throw error;
  }
  appUpdateTask = {
    id: randomUUID(),
    type: 'rollback',
    status: 'running',
    startedAt: nowIso(),
    finishedAt: '',
    fromCommit: current.commit,
    fromShortCommit: current.shortCommit,
    target: rollback.commit,
    mode: 'rollback',
    step: 'starting',
    code: null,
    log: '',
    restart: null
  };
  const task = appUpdateTask;
  (async () => {
    try {
      await runAppUpdateSteps(task, [
        { label: `git checkout ${rollback.commit}`, command: 'git', args: ['checkout', rollback.commit], timeoutMs: 30000 },
        { label: 'npm install --omit=dev', command: 'npm', args: ['install', '--omit=dev'], timeoutMs: 120000 },
        { label: 'node --check server.js', command: 'node', args: ['--check', 'server.js'], timeoutMs: 30000 },
        { label: 'node --check public/app.js', command: 'node', args: ['--check', 'public/app.js'], timeoutMs: 30000 }
      ]);
      const after = await gitInfo();
      task.status = 'finished';
      task.finishedAt = nowIso();
      task.afterCommit = after.commit;
      task.afterShortCommit = after.shortCommit;
      task.restart = await requestServiceRestart('app-rollback');
    } catch (error) {
      task.status = 'failed';
      task.finishedAt = nowIso();
      task.error = error.message || String(error);
    }
  })();
  return task;
}

async function cleanupStorage(mode = 'all', options = {}) {
  const settings = normalizeStorageSettings(state.storageSettings);
  const result = {
    mode,
    deletedFiles: 0,
    deletedBytes: 0,
    skippedReferencedUploads: 0,
    autoCleanup: options.auto === true
  };
  if (mode === 'all' || mode === 'orphanUploads' || mode === 'uploads') {
    const uploadResult = await cleanupUploads(settings, options);
    Object.assign(result, {
      deletedFiles: result.deletedFiles + uploadResult.deletedFiles,
      deletedBytes: result.deletedBytes + uploadResult.deletedBytes,
      skippedReferencedUploads: uploadResult.skippedReferencedUploads
    });
  }
  if (mode === 'all' || mode === 'runtime') {
    const runtimeResult = await cleanupRuntime(settings, options);
    result.deletedFiles += runtimeResult.deletedFiles;
    result.deletedBytes += runtimeResult.deletedBytes;
  }
  return result;
}

async function cleanupUploads(settings, options = {}) {
  const refs = referencedUploadNames();
  const files = await collectFiles(UPLOAD_DIR);
  const now = Date.now();
  const maxBytes = settings.maxUploadMb > 0 ? settings.maxUploadMb * 1024 * 1024 : Infinity;
  const retentionMs = settings.uploadRetentionDays > 0 ? settings.uploadRetentionDays * 24 * 60 * 60 * 1000 : Infinity;
  const candidates = files
    .filter((file) => !refs.has(file.name))
    .filter((file) => options.manual === true || now - file.mtimeMs > retentionMs)
    .sort((a, b) => a.mtimeMs - b.mtimeMs);
  let totalBytes = files.reduce((sum, file) => sum + file.size, 0);
  const overLimit = totalBytes > maxBytes;
  const selected = [];
  for (const file of candidates) {
    if (options.manual === true || overLimit || now - file.mtimeMs > retentionMs) {
      selected.push(file);
      totalBytes -= file.size;
      if (!options.manual && totalBytes <= maxBytes && retentionMs === Infinity) break;
    }
  }
  const result = { deletedFiles: 0, deletedBytes: 0, skippedReferencedUploads: files.length - candidates.length };
  for (const file of selected) {
    try {
      await unlink(file.path);
      result.deletedFiles += 1;
      result.deletedBytes += file.size;
    } catch {
      // Ignore files already gone.
    }
  }
  return result;
}

async function cleanupRuntime(settings, options = {}) {
  const files = await collectFiles(RUNTIME_DIR);
  const retentionMs = options.manual === true || settings.runtimeRetentionDays <= 0
    ? 0
    : settings.runtimeRetentionDays * 24 * 60 * 60 * 1000;
  const now = Date.now();
  const result = { deletedFiles: 0, deletedBytes: 0 };
  for (const file of files) {
    if (retentionMs && now - file.mtimeMs <= retentionMs) continue;
    try {
      await unlink(file.path);
      result.deletedFiles += 1;
      result.deletedBytes += file.size;
    } catch {
      // Ignore files already gone.
    }
  }
  return result;
}

let storageMaintenanceTimer = null;
function startStorageMaintenance() {
  clearInterval(storageMaintenanceTimer);
  storageMaintenanceTimer = setInterval(() => {
    if (normalizeStorageSettings(state.storageSettings).autoCleanup) {
      cleanupStorage('all', { auto: true }).catch(console.error);
    }
  }, 24 * 60 * 60 * 1000);
  storageMaintenanceTimer.unref();
  if (normalizeStorageSettings(state.storageSettings).autoCleanup) {
    cleanupStorage('all', { auto: true }).catch(console.error);
  }
}

let runMonitorTimer = null;
function startRunMonitor() {
  clearInterval(runMonitorTimer);
  runMonitorTimer = setInterval(() => {
    for (const session of Object.values(state.sessions || {})) {
      if (reconcileSessionRunState(session, 'monitor')) broadcastSession(session);
    }
  }, 10000);
  runMonitorTimer.unref();
}

function stableMessageId(...parts) {
  return createHash('sha1').update(parts.map((part) => String(part || '')).join('\0')).digest('hex').slice(0, 24);
}

function shouldSkipCodexText(role, text) {
  if (!text) return true;
  if (role === 'system' || role === 'developer') return true;
  if (text.includes('<permissions instructions>')) return true;
  if (text.includes('<skills_instructions>')) return true;
  if (text.includes('<environment_context>')) return true;
  if (text.includes('encrypted_content')) return true;
  return false;
}

function stripCodexImageTags(text) {
  return String(text || '')
    .replace(/<image\b[^>]*>\s*<\/image>/gi, '')
    .replace(/<image\b[^>]*\/>/gi, '')
    .trim();
}

function parseSkillMarkdown(raw, fallbackName) {
  const text = String(raw || '');
  const meta = {};
  const match = text.match(/^---\n([\s\S]*?)\n---/);
  if (match) {
    for (const line of match[1].split('\n')) {
      const item = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
      if (item) meta[item[1]] = item[2].trim().replace(/^["']|["']$/g, '');
    }
  }
  const heading = text.match(/^#\s+(.+)$/m)?.[1]?.trim() || '';
  return {
    name: meta.name || fallbackName,
    description: meta.description || meta['short-description'] || '',
    title: heading || meta.name || fallbackName,
    shortDescription: meta['short-description'] || ''
  };
}

function defaultSkillRegistry() {
  return {
    version: 1,
    roots: SKILL_ROOTS,
    skills: [],
    lastScanAt: '',
    scanStatus: 'idle',
    scanError: ''
  };
}

function normalizeSkillRegistry(value = {}) {
  const parsed = value && typeof value === 'object' ? value : {};
  const version = Number(parsed.version || 1);
  return {
    ...defaultSkillRegistry(),
    version: Number.isFinite(version) ? version : 1,
    roots: SKILL_ROOTS,
    skills: Array.isArray(parsed.skills) ? parsed.skills : [],
    lastScanAt: typeof parsed.lastScanAt === 'string' ? parsed.lastScanAt : '',
    scanStatus: ['idle', 'scanning', 'error'].includes(parsed.scanStatus) ? parsed.scanStatus : 'idle',
    scanError: typeof parsed.scanError === 'string' ? parsed.scanError : ''
  };
}

async function loadSkillRegistry() {
  try {
    const parsed = JSON.parse(await readFile(SKILL_REGISTRY_FILE, 'utf8'));
    skillRegistry = normalizeSkillRegistry(parsed);
    const info = await stat(SKILL_REGISTRY_FILE);
    skillRegistryFileMtimeMs = info.mtimeMs;
  } catch {
    skillRegistry = defaultSkillRegistry();
    skillRegistryFileMtimeMs = 0;
  }
}

async function saveSkillRegistry() {
  skillRegistry = normalizeSkillRegistry(skillRegistry);
  const tmp = `${SKILL_REGISTRY_FILE}.tmp`;
  await writeFile(tmp, JSON.stringify(skillRegistry, null, 2), { mode: 0o600 });
  await rename(tmp, SKILL_REGISTRY_FILE);
  const info = await stat(SKILL_REGISTRY_FILE);
  skillRegistryFileMtimeMs = info.mtimeMs;
}

async function reloadSkillRegistryIfChanged() {
  try {
    const info = await stat(SKILL_REGISTRY_FILE);
    if (info.mtimeMs !== skillRegistryFileMtimeMs) await loadSkillRegistry();
  } catch {
    if (skillRegistryFileMtimeMs !== 0) await loadSkillRegistry();
  }
}

function publicSkillRegistry() {
  const pendingSummarySkills = (skillRegistry.skills || []).filter((skill) => skill.summaryStatus !== 'ready');
  return {
    roots: skillRegistry.roots,
    skills: skillRegistry.skills,
    lastScanAt: skillRegistry.lastScanAt,
    scanStatus: skillRegistry.scanStatus,
    scanError: skillRegistry.scanError,
    pendingSummaryCount: pendingSummarySkills.length,
    summaryPrompt: pendingSummarySkills.length ? skillSummaryPrompt(pendingSummarySkills) : ''
  };
}

function skillContentHash(raw) {
  return createHash('sha256').update(String(raw || '')).digest('hex');
}

function skillSource(root, file) {
  const normalizedRoot = path.resolve(root);
  const normalizedFile = path.resolve(file);
  const relative = path.relative(normalizedRoot, normalizedFile);
  const parts = relative.split(path.sep).filter(Boolean);
  const system = parts.includes('.system');
  if (normalizedRoot.includes(`${path.sep}.agents${path.sep}`)) return system ? 'agents-system' : 'agents';
  return system ? 'codex-system' : 'codex';
}

async function walkSkillFiles(root, out = [], limit = 200) {
  if (out.length >= limit) return out;
  let entries = [];
  try {
    entries = await readdir(root, { withFileTypes: true });
  } catch {
    return out;
  }
  for (const entry of entries) {
    if (out.length >= limit) break;
    const full = path.join(root, entry.name);
    if (entry.isDirectory()) {
      if (entry.name === 'node_modules' || entry.name === '.git') continue;
      await walkSkillFiles(full, out, limit);
    } else if (entry.isFile() && entry.name === 'SKILL.md') {
      out.push(full);
    }
  }
  return out;
}

async function listInstalledSkills() {
  const byName = new Map();
  for (const root of SKILL_ROOTS) {
    const files = await walkSkillFiles(root);
    for (const file of files) {
      try {
        const raw = await readFile(file, 'utf8');
        const info = await stat(file);
        const fallbackName = path.basename(path.dirname(file));
        const parsed = parseSkillMarkdown(raw, fallbackName);
        const source = skillSource(root, file);
        const skill = {
          name: parsed.name,
          title: parsed.title,
          description: parsed.description,
          shortDescription: parsed.shortDescription,
          source,
          system: source.includes('system'),
          path: file,
          hash: skillContentHash(raw),
          updatedAt: new Date(info.mtimeMs).toISOString()
        };
        const existing = byName.get(skill.name);
        if (!existing || existing.system && !skill.system) byName.set(skill.name, skill);
      } catch {
        // Ignore unreadable skill files; the rest of the list is still useful.
      }
    }
  }
  return [...byName.values()].sort((a, b) => {
    if (a.system !== b.system) return a.system ? 1 : -1;
    return a.name.localeCompare(b.name);
  });
}

function refreshSkillRegistry() {
  if (skillScanPromise) return skillScanPromise;
  skillScanPromise = Promise.resolve()
    .then(async () => {
      await reloadSkillRegistryIfChanged();
      skillRegistry.scanStatus = 'scanning';
      skillRegistry.scanError = '';
      await saveSkillRegistry().catch(() => {});
      const skills = await listInstalledSkills();
      const previous = new Map((skillRegistry.skills || []).map((skill) => [`${skill.source}:${skill.name}`, skill]));
      skillRegistry = {
        ...skillRegistry,
        version: 1,
        roots: SKILL_ROOTS,
        skills: skills.map((skill) => {
          const old = previous.get(`${skill.source}:${skill.name}`);
          return {
            ...skill,
            summary: old?.hash === skill.hash ? old.summary || null : null,
            summaryStatus: old?.hash === skill.hash && old?.summary ? 'ready' : 'pending',
            summaryUpdatedAt: old?.hash === skill.hash ? old?.summaryUpdatedAt || '' : ''
          };
        }),
        lastScanAt: nowIso(),
        scanStatus: 'idle',
        scanError: ''
      };
      await saveSkillRegistry();
    })
    .catch(async (error) => {
      skillRegistry.scanStatus = 'error';
      skillRegistry.scanError = String(error.message || error).slice(0, 300);
      await saveSkillRegistry().catch(() => {});
    })
    .finally(() => {
      skillScanPromise = null;
    });
  return skillScanPromise;
}

function startSkillMaintenance() {
  clearInterval(skillMaintenanceTimer);
  setTimeout(() => {
    refreshSkillRegistry().catch(() => {});
  }, 2000).unref();
  skillMaintenanceTimer = setInterval(() => {
    refreshSkillRegistry().catch(() => {});
  }, 15 * 60 * 1000);
  skillMaintenanceTimer.unref();
}

function skillSummaryPrompt(skills) {
  const targets = skills.map((skill) => ({
    name: skill.name,
    source: skill.source,
    path: skill.path,
    hash: skill.hash,
    title: skill.title || skill.name,
    description: skill.description || skill.shortDescription || ''
  }));
  return [
    '请更新 Codex Mobile Console 的 skill 中文总结缓存。',
    '',
    '要求：',
    '1. 读取下面每个 skill 的 SKILL.md 文件。',
    '2. 更新 /root/Projects/codex-mobile-console/data/skill-registry.json 中对应 skill 的 summary、summaryStatus、summaryUpdatedAt 字段。',
    '3. summary 格式为 {"title":"一句话标题","overview":"80字以内介绍","bullets":["适用场景","使用方式","实现要点"]}。',
    '4. 不要直接展示或大段复述 SKILL.md 原文。',
    '5. 只更新 hash 匹配的条目；如果文件 hash 已变化，先重新计算并以当前文件为准。',
    '6. 所有下面列出的待更新 skill 都要一次性更新，不要分批。',
    '7. 保留 registry 文件里和本次总结无关的字段，不要重启服务，不要调用应用内接口。',
    '',
    `待更新 skill JSON:\n${JSON.stringify(targets, null, 2)}`
  ].join('\n');
}

async function readCodexThreadNames() {
  const indexFile = path.join(CODEX_HOME, 'session_index.jsonl');
  const names = new Map();
  try {
    const raw = await readFile(indexFile, 'utf8');
    for (const line of raw.split('\n')) {
      if (!line.trim()) continue;
      try {
        const item = JSON.parse(line);
        if (item.id) names.set(item.id, {
          title: item.thread_name || item.id,
          updatedAt: item.updated_at || ''
        });
      } catch {
        // Ignore corrupt historical index lines.
      }
    }
  } catch {
    // The index is optional; session files are the source of truth.
  }
  return names;
}

function codexSessionFilePath(codexSessionId, date = new Date()) {
  const year = String(date.getUTCFullYear());
  const month = String(date.getUTCMonth() + 1).padStart(2, '0');
  const day = String(date.getUTCDate()).padStart(2, '0');
  const stamp = date.toISOString().replace(/\.\d{3}Z$/, '').replaceAll(':', '-');
  return path.join(CODEX_HOME, 'sessions', year, month, day, `rollout-${stamp}-${codexSessionId}.jsonl`);
}

async function walkFiles(root, out = [], limit = 800) {
  if (out.length >= limit) return out;
  let entries = [];
  try {
    entries = await readdir(root, { withFileTypes: true });
  } catch {
    return out;
  }
  for (const entry of entries) {
    if (out.length >= limit) break;
    const full = path.join(root, entry.name);
    if (entry.isDirectory()) await walkFiles(full, out, limit);
    if (entry.isFile() && entry.name.endsWith('.jsonl')) out.push(full);
  }
  return out;
}

async function readCodexSessionFile(file, names) {
  const info = await stat(file);
  const updatedAt = new Date(info.mtimeMs).toISOString();
  const raw = await readFile(file, 'utf8');
  for (const line of raw.split('\n').slice(0, 80)) {
    if (!line.trim()) continue;
    let item;
    try {
      item = JSON.parse(line);
    } catch {
      continue;
    }
    if (item.type !== 'session_meta') continue;
    const payload = item.payload || {};
    const codexSessionId = payload.id;
    if (!codexSessionId) return null;
    const indexed = names.get(codexSessionId) || {};
    return {
      codexSessionId,
      title: indexed.title || payload.thread_name || path.basename(payload.cwd || file),
      cwd: payload.cwd || '',
      createdAt: payload.timestamp || item.timestamp || updatedAt,
      updatedAt: indexed.updatedAt || updatedAt,
      file
    };
  }
  return null;
}

async function findCodexSession(codexSessionId) {
  const names = await readCodexThreadNames();
  const files = await walkFiles(path.join(CODEX_HOME, 'sessions'));
  for (const file of files) {
    try {
      const session = await readCodexSessionFile(file, names);
      if (session?.codexSessionId === codexSessionId) return session;
    } catch {
      // Ignore malformed historical files.
    }
  }
  return null;
}

async function readCodexMessages(codexSessionId) {
  const session = await findCodexSession(codexSessionId);
  if (!session?.file) return [];

  let info;
  try {
    info = await stat(session.file);
  } catch {
    return [];
  }
  const cached = codexMessagesCache.get(session.file);
  if (cached && cached.mtimeMs === info.mtimeMs && cached.size === info.size) {
    return cached.messages.map((message) => ({
      ...message,
      starred: message.starred === true || state.starredMessages?.[message.id] === true
    }));
  }

  const raw = await readFile(session.file, 'utf8');
  const messages = [];
  let seq = -1000000;

  for (const line of raw.split('\n')) {
    if (!line.trim()) continue;
    let item;
    try {
      item = JSON.parse(line);
    } catch {
      continue;
    }

    const at = item.timestamp || session.updatedAt || nowIso();
    const payload = item.payload || {};
    let message = null;

    if (item.type === 'event_msg') {
      if (payload.type === 'user_message') {
        message = { role: 'user', text: payload.message || '' };
      } else if (payload.type === 'agent_message') {
        message = { role: 'assistant', text: payload.message || '', phase: payload.phase || '' };
      } else if (payload.type === 'exec_command_end') {
        const command = Array.isArray(payload.command) ? payload.command.join(' ') : payload.command || '';
        const output = payload.aggregated_output || payload.stdout || payload.stderr || '';
        const status = payload.status || (payload.exit_code === 0 ? 'completed' : 'failed');
        message = { role: 'tool', text: [`$ ${command}`, `[${status}]`, output].filter(Boolean).join('\n') };
      }
    } else if (item.type === 'response_item') {
      if (payload.type === 'function_call') {
        const args = typeof payload.arguments === 'string' ? payload.arguments : JSON.stringify(payload.arguments || {});
        message = { role: 'tool', text: `${payload.name || 'tool'} ${args}` };
      } else if (payload.type === 'function_call_output') {
        message = { role: 'tool', text: payload.output || '' };
      } else if (payload.type === 'message') {
        const role = payload.role || 'assistant';
        message = { role, text: textFromContent(payload.content) };
      }
    } else if (item.type === 'item.completed') {
      const completed = item.item || {};
      if (completed.type === 'agent_message') message = { role: 'assistant', text: completed.text || '' };
      if (completed.type === 'tool_call' || completed.type === 'function_call') {
        message = { role: 'tool', text: JSON.stringify(completed) };
      }
    }

    if (message) message.text = stripCodexImageTags(message.text);
    if (!message || shouldSkipCodexText(message.role, message.text)) continue;
    const text = compactText(message.text);
    const id = stableMessageId(codexSessionId, item.timestamp, item.type, message.role, text);
    messages.push({
      seq: seq++,
      id,
      at,
      source: 'codex',
      role: message.role,
      text,
      phase: message.phase || '',
      starred: state.starredMessages?.[id] === true
    });
  }

  codexMessagesCache.set(session.file, { mtimeMs: info.mtimeMs, size: info.size, messages });
  if (codexMessagesCache.size > 20) {
    const firstKey = codexMessagesCache.keys().next().value;
    codexMessagesCache.delete(firstKey);
  }
  return messages.map((message) => ({ ...message }));
}

async function deleteCodexSessionFile(codexSessionId) {
  const session = await findCodexSession(codexSessionId);
  if (!session?.file) return false;
  const sessionsRoot = path.resolve(CODEX_HOME, 'sessions');
  const file = path.resolve(session.file);
  if (!file.startsWith(`${sessionsRoot}${path.sep}`)) throw new Error('invalid_codex_session_path');
  await unlink(file);
  return true;
}

function forkTitle(title = '') {
  const base = String(title || '').trim() || 'Codex session';
  return `${base.replace(/\s+fork(?: \d+)?$/i, '')} fork`.slice(0, 80);
}

async function forkCodexSession(codexSessionId, title = '') {
  const source = await findCodexSession(codexSessionId);
  if (!source?.file) return null;

  const sessionsRoot = path.resolve(CODEX_HOME, 'sessions');
  const sourceFile = path.resolve(source.file);
  if (!sourceFile.startsWith(`${sessionsRoot}${path.sep}`)) throw new Error('invalid_codex_session_path');

  const newCodexSessionId = randomUUID();
  const createdAt = new Date();
  const newFile = codexSessionFilePath(newCodexSessionId, createdAt);
  await mkdir(path.dirname(newFile), { recursive: true });

  const raw = await readFile(sourceFile, 'utf8');
  let rewroteMeta = false;
  const lines = raw.split('\n').map((line) => {
    if (!line.trim()) return line;
    try {
      const item = JSON.parse(line);
      if (item.type !== 'session_meta') return line;
      item.timestamp = createdAt.toISOString();
      item.payload ||= {};
      item.payload.id = newCodexSessionId;
      item.payload.timestamp = createdAt.toISOString();
      item.payload.forked_from = codexSessionId;
      item.payload.forked_from_id = codexSessionId;
      rewroteMeta = true;
      return JSON.stringify(item);
    } catch {
      return line;
    }
  });
  if (!rewroteMeta) throw new Error('codex_session_meta_not_found');

  await writeFile(newFile, lines.join('\n'), { mode: 0o600 });
  let shellSnapshotCount = 0;
  const snapshotDir = path.join(CODEX_HOME, 'shell_snapshots');
  try {
    await mkdir(snapshotDir, { recursive: true });
    const snapshots = await readdir(snapshotDir, { withFileTypes: true });
    await Promise.all(snapshots
      .filter((entry) => entry.isFile() && entry.name.startsWith(`${codexSessionId}.`) && entry.name.endsWith('.sh'))
      .slice(0, 200)
      .map(async (entry) => {
        const suffix = entry.name.slice(codexSessionId.length);
        await copyFile(path.join(snapshotDir, entry.name), path.join(snapshotDir, `${newCodexSessionId}${suffix}`));
        shellSnapshotCount += 1;
      }));
  } catch {
    shellSnapshotCount = 0;
  }
  const nextTitle = forkTitle(title || source.title);
  state.codexSessionTitles ||= {};
  state.codexSessionTitles[newCodexSessionId] = nextTitle;
  await appendFile(
    path.join(CODEX_HOME, 'session_index.jsonl'),
    `${JSON.stringify({ id: newCodexSessionId, thread_name: nextTitle, updated_at: createdAt.toISOString() })}\n`,
    { mode: 0o600 }
  );
  return {
    codexSessionId: newCodexSessionId,
    title: nextTitle,
    cwd: source.cwd,
    file: newFile,
    shellSnapshotCount,
    sourceCodexSessionId: codexSessionId
  };
}

async function displayMessages(session, limit = 500) {
  const page = await displayMessagePage(session, { limit, offset: 0 });
  return page.messages;
}

function displayMessageText(message) {
  return String(message?.text || '').replace(/\s+/g, ' ').trim();
}

function displayMessageTime(message) {
  const value = Date.parse(message?.at || '');
  return Number.isFinite(value) ? value : 0;
}

function displayIsCodex(message) {
  return message?.source === 'codex';
}

function sameDisplayMessage(left, right) {
  if (!left || !right) return false;
  if ((left.role || '') !== (right.role || '')) return false;
  const text = displayMessageText(left);
  if (!text || text !== displayMessageText(right)) return false;
  if (displayIsCodex(left) === displayIsCodex(right) && !displayIsCodex(left)) return false;
  const leftAt = displayMessageTime(left);
  const rightAt = displayMessageTime(right);
  if (!leftAt || !rightAt) return true;
  return Math.abs(leftAt - rightAt) <= 5 * 60 * 1000;
}

function displayMessageDedupeKey(message) {
  const text = displayMessageText(message);
  if (!text) return '';
  return `${message.role || ''}\0${text}`;
}

function mergeDisplayMessage(existing, incoming) {
  const preferExisting = !displayIsCodex(existing) && displayIsCodex(incoming);
  const base = preferExisting ? incoming : existing;
  const overlay = preferExisting ? existing : incoming;
  const next = { ...base, ...overlay };
  const existingImages = existing.images || [];
  const incomingImages = incoming.images || [];
  const existingFiles = existing.files || [];
  const incomingFiles = incoming.files || [];
  next.images = existingImages.length >= incomingImages.length ? existingImages : incomingImages;
  next.files = existingFiles.length >= incomingFiles.length ? existingFiles : incomingFiles;
  next.starred = existing.starred === true || incoming.starred === true;
  return next;
}

function compareDisplayMessages(a, b) {
  const byTime = displayMessageTime(a) - displayMessageTime(b);
  if (byTime) return byTime;
  return Number(a.seq || 0) - Number(b.seq || 0);
}

async function indexedDisplayMessages(session) {
  const codexMessages = session.codexSessionId ? await readCodexMessages(session.codexSessionId) : [];
  const out = [];
  const byDedupeKey = new Map();
  for (const message of [...codexMessages, ...(session.messages || [])]) {
    const next = {
      ...message,
      starred: message.starred === true || state.starredMessages?.[message.id] === true
    };
    const dedupeKey = displayMessageDedupeKey(next);
    const candidates = dedupeKey ? byDedupeKey.get(dedupeKey) || [] : [];
    const index = candidates.find((candidateIndex) => sameDisplayMessage(out[candidateIndex], next)) ?? -1;
    if (index >= 0) {
      out[index] = mergeDisplayMessage(out[index], next);
      continue;
    }
    out.push(next);
    if (dedupeKey) {
      candidates.push(out.length - 1);
      byDedupeKey.set(dedupeKey, candidates);
    }
  }
  return out.sort(compareDisplayMessages).map((message, index) => ({
    ...message,
    orderSeq: index + 1
  }));
}

function normalizeMessageQueryLimit(value, fallback = 500) {
  const raw = Number(value ?? fallback);
  return Number.isFinite(raw) ? Math.max(0, Math.min(5000, Math.floor(raw))) : fallback;
}

function normalizeMessageQueryOffset(value) {
  const raw = Number(value ?? 0);
  return Number.isFinite(raw) ? Math.max(0, Math.min(50000, Math.floor(raw))) : 0;
}

async function displayMessagePage(session, options = {}) {
  const limit = normalizeMessageQueryLimit(options.limit, 500);
  const offset = normalizeMessageQueryOffset(options.offset);
  const sorted = await indexedDisplayMessages(session);
  const total = sorted.length;
  const end = Math.max(0, total - offset);
  const start = limit > 0 ? Math.max(0, end - limit) : 0;
  const messages = sorted.slice(start, end);
  return {
    messages,
    limit,
    offset,
    loaded: messages.length,
    total,
    nextOffset: offset + messages.length,
    hasMore: start > 0
  };
}

async function displayMessageRange(session, options = {}) {
  const limit = normalizeMessageQueryLimit(options.limit, 120);
  const sorted = await indexedDisplayMessages(session);
  const total = sorted.length;
  const firstSeq = sorted[0]?.orderSeq || 0;
  const latestSeq = sorted.at(-1)?.orderSeq || 0;
  const afterSeq = Number(options.afterSeq || 0);
  const beforeSeq = Number(options.beforeSeq || 0);
  const previousTurn = options.previousTurn === true || options.previousTurn === '1' || options.previousTurn === 'true';

  if (Number.isFinite(afterSeq) && afterSeq > 0) {
    const messages = sorted.filter((message) => Number(message.orderSeq || 0) > afterSeq).slice(0, limit);
    return {
      messages,
      limit,
      total,
      firstSeq,
      latestSeq,
      beforeSeq: messages[0]?.orderSeq || 0,
      afterSeq,
      hasMoreBefore: Boolean(messages.length && messages[0].orderSeq > firstSeq),
      hasMoreAfter: Boolean(messages.length && messages.at(-1).orderSeq < latestSeq)
    };
  }

  const endIndex = Number.isFinite(beforeSeq) && beforeSeq > 0
    ? sorted.findIndex((message) => Number(message.orderSeq || 0) >= beforeSeq)
    : sorted.length;
  const end = endIndex < 0 ? sorted.length : Math.max(0, endIndex);
  let start = limit > 0 ? Math.max(0, end - limit) : 0;
  if (previousTurn) {
    start = Math.max(0, end - 1);
    while (start > 0 && sorted[start]?.role !== 'user') start -= 1;
  }
  const rangeMessages = sorted.slice(start, end);
  const messages = options.brief === true || options.brief === '1' || options.brief === 'true'
    ? compactBriefMessages(rangeMessages)
    : rangeMessages;
  return {
    messages,
    limit,
    total,
    firstSeq,
    latestSeq,
    beforeSeq: rangeMessages[0]?.orderSeq || 0,
    afterSeq: rangeMessages.at(-1)?.orderSeq || 0,
    hasMoreBefore: start > 0,
    hasMoreAfter: end < sorted.length
  };
}

async function listCodexSessions() {
  const names = await readCodexThreadNames();
  const files = await walkFiles(path.join(CODEX_HOME, 'sessions'));
  const imported = new Set(Object.values(state.sessions || {}).map((session) => session.codexSessionId).filter(Boolean));
  const byId = new Map();
  for (const file of files) {
    try {
      const session = await readCodexSessionFile(file, names);
      if (!session || imported.has(session.codexSessionId)) continue;
      const existing = byId.get(session.codexSessionId);
      if (!existing || String(session.updatedAt) > String(existing.updatedAt)) {
        byId.set(session.codexSessionId, session);
      }
    } catch {
      // Keep the index usable if an old session file is malformed.
    }
  }
  return Array.from(byId.values())
    .sort((a, b) => String(b.updatedAt).localeCompare(String(a.updatedAt)))
    .map(publicExternalSession);
}

async function importCodexSession(codexSessionId, options = {}) {
  const normalizedId = String(codexSessionId || '').trim();
  const existing = Object.values(state.sessions || {}).find((session) => session.codexSessionId === normalizedId);
  if (existing) return existing;

  return runCodexImportSingleFlight(normalizedId, () => createImportedCodexSession(normalizedId, options));
}

async function createImportedCodexSession(codexSessionId, options = {}) {
  const existing = Object.values(state.sessions || {}).find((session) => session.codexSessionId === codexSessionId);
  if (existing) return existing;

  const external = await findCodexSession(codexSessionId);
  if (!external) return null;
  const importedDuringRead = Object.values(state.sessions || {}).find((session) => session.codexSessionId === codexSessionId);
  if (importedDuringRead) return importedDuringRead;
  delete state.hiddenCodexSessions?.[codexSessionId];

  const id = randomUUID();
  const now = nowIso();
  const history = await readCodexMessages(codexSessionId);
  state.sessions[id] = {
    id,
    source: 'web',
    title: options.title || state.codexSessionTitles?.[codexSessionId] || external.title || `Codex ${codexSessionId.slice(0, 8)}`,
    cwd: external.cwd || '/root/Projects',
    model: '',
    sandbox: 'workspace-write',
    approval: 'on-request',
    tags: normalizeSessionTags(state.codexSessionTags?.[codexSessionId] || []),
    codexSessionId,
    status: 'idle',
    createdAt: now,
    updatedAt: now,
    lastSeq: 0,
    queue: [],
    runs: [],
    audit: [],
    messages: history
  };
  auditSession(state.sessions[id], 'session.imported', { summary: codexSessionId });
  addMessage(state.sessions[id], {
    role: 'system',
    text: options.systemText || `Imported Codex thread ${codexSessionId}. Loaded ${history.length} saved messages.`
  });
  return state.sessions[id];
}

async function listDirectories(dir) {
  const current = path.resolve(dir || '/root/Projects');
  const entries = [];
  const items = await readdir(current, { withFileTypes: true });
  for (const item of items) {
    if (item.name === 'node_modules' || item.name === '.git') continue;
    const full = path.join(current, item.name);
    let isDirectory = item.isDirectory();
    let isSymlink = false;
    if (!isDirectory && item.isSymbolicLink()) {
      isSymlink = true;
      try {
        isDirectory = (await stat(full)).isDirectory();
      } catch {
        isDirectory = false;
      }
    }
    if (!isDirectory) continue;
    entries.push({ name: item.name, path: full, symlink: isSymlink });
  }
  entries.sort((a, b) => a.name.localeCompare(b.name));
  return {
    path: current,
    parent: path.dirname(current) === current ? '' : path.dirname(current),
    entries
  };
}

function addMessage(session, message) {
  ensureSessionHarness(session);
  const entry = {
    seq: state.nextSeq++,
    id: randomUUID(),
    at: nowIso(),
    ...message
  };
  const run = activeRunRecord(session);
  if (!entry.runId && run && ['assistant', 'tool', 'system'].includes(entry.role || '')) entry.runId = run.id;
  attachReplyImages(session, entry);
  session.messages.push(entry);
  messageStore.markSessionDirty(session.id);
  if (run && ['assistant', 'tool'].includes(entry.role || '')) {
    run.outputMessageIds ||= [];
    run.outputMessageIds.push(entry.id);
    if (entry.role === 'assistant') run.outputCount = (run.outputCount || 0) + 1;
    if (entry.role === 'tool') run.toolCount = (run.toolCount || 0) + 1;
    appendRunEvent(session, entry.role === 'assistant' ? 'assistant_message' : 'tool_message', {
      messageId: entry.id,
      summary: entry.text || entry.rawType || entry.role
    }, { runId: run.id });
  }
  session.lastSeq = entry.seq;
  session.updatedAt = entry.at;
  const registeredSites = entry.role === 'assistant' ? registerSiteLinksFromText(session, entry.text) : [];
  scheduleSave();
  broadcast(session.id, entry);
  if (registeredSites.length) broadcastSession(session);
  return entry;
}

function broadcast(sessionId, message) {
  broadcastEvent(sessionId, 'message', message);
}

function broadcastSession(session) {
  if (!session?.id) return;
  broadcastEvent(session.id, 'session', publicSession(session));
}

function broadcastEvent(sessionId, event, data) {
  const set = clients.get(sessionId);
  if (!set) return;
  const line = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
  for (const res of [...set]) {
    if (res.destroyed || res.writableEnded) {
      set.delete(res);
      continue;
    }
    try {
      res.write(line);
    } catch {
      set.delete(res);
    }
  }
  if (set.size === 0) clients.delete(sessionId);
}

function sendSse(res, event, data) {
  if (res.destroyed || res.writableEnded) return false;
  try {
    res.write(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
    return true;
  } catch {
    return false;
  }
}

async function requestServiceRestart(reason = 'api') {
  await writeRestartMarker(reason);
  restartRequested = true;
  if (running.size > 0) return { queued: true, running: running.size };
  scheduleServiceRestart();
  return { queued: false, running: 0 };
}

function scheduleServiceRestart() {
  if (!restartRequested || running.size > 0) return;
  restartRequested = false;
  setTimeout(() => {
    const child = spawn('/bin/systemctl', ['restart', 'codex-mobile-console.service'], {
      detached: true,
      stdio: 'ignore'
    });
    child.unref();
  }, 250).unref();
}

function buildCodexArgs(session, prompt, options = {}) {
  const config = normalizeSessionConfig(session);
  const appendCommonArgs = (args, resume = false) => {
    if (config.model) args.push('-m', config.model);
    if (!resume && config.profile) args.push('-p', config.profile);
    if (config.reasoningEffort) args.push('-c', `model_reasoning_effort="${config.reasoningEffort}"`);
    if (config.approval) args.push('-c', `approval_policy="${config.approval}"`);
    if (config.strictConfig) args.push('--strict-config');
    if (config.ignoreUserConfig) args.push('--ignore-user-config');
    if (config.ignoreRules) args.push('--ignore-rules');
    for (const override of config.configOverrides) args.push('-c', override);
    for (const imagePath of options.imagePaths || []) args.push('--image', imagePath);
    return args;
  };

  if (session.codexSessionId) {
    const args = ['exec', 'resume', '--json', '--skip-git-repo-check'];
    appendCommonArgs(args, true);
    if (options.elevated) args.push('--dangerously-bypass-approvals-and-sandbox');
    else if (config.sandbox) args.push('-c', `sandbox_mode="${config.sandbox}"`);
    args.push(session.codexSessionId, '-');
    return args;
  }

  const args = ['exec', '--json', '-C', session.cwd, '--skip-git-repo-check'];
  appendCommonArgs(args, false);
  if (options.elevated) {
    args.push('--dangerously-bypass-approvals-and-sandbox');
  } else if (config.sandbox) {
    args.push('-s', config.sandbox);
  }
  for (const dir of config.addDirs) args.push('--add-dir', dir);
  args.push('-');
  return args;
}

function deriveMessageFromCodexEvent(event) {
  if (event?.type === 'thread.started' && event.thread_id) {
    return { role: 'system', text: `Codex thread ${event.thread_id} started.`, rawType: event.type };
  }

  if (event?.type === 'turn.started') {
    return null;
  }

  if (event?.type === 'turn.completed') {
    return null;
  }

  if (event?.type === 'item.completed') {
    const item = event.item || {};
    if (item.type === 'agent_message' && item.text) {
      return { role: 'assistant', text: item.text, rawType: event.type };
    }
    if (item.type === 'tool_call' || item.type === 'function_call') {
      return { role: 'tool', text: JSON.stringify(item).slice(0, 3000), rawType: event.type };
    }
  }

  if (event?.type === 'event_msg') {
    const payload = event.payload || {};
    if (payload.type === 'agent_message' && payload.message) {
      return {
        role: 'assistant',
        phase: payload.phase || 'message',
        text: payload.message,
        rawType: payload.type
      };
    }
    if (payload.type === 'task_started') {
      return { role: 'system', text: 'Codex run started.', rawType: payload.type };
    }
    if (payload.type === 'exec_command_end') {
      const command = Array.isArray(payload.command) ? payload.command.join(' ') : '';
      const output = String(payload.aggregated_output || payload.stdout || '').trim();
      const status = payload.status || (payload.exit_code === 0 ? 'completed' : 'failed');
      return {
        role: 'tool',
        text: [`$ ${command}`, `[${status}]`, output.slice(0, 3000)].filter(Boolean).join('\n'),
        rawType: payload.type
      };
    }
  }

  if (event?.type === 'response_item') {
    const payload = event.payload || {};
    if (payload.type === 'function_call') {
      const name = payload.name || 'tool';
      let args = payload.arguments || '';
      if (typeof args !== 'string') args = JSON.stringify(args);
      return { role: 'tool', text: `${name} ${args}`.slice(0, 1200), rawType: payload.type };
    }
    if (payload.type === 'message' && payload.role === 'assistant') {
      const text = (payload.content || [])
        .map((part) => part.text || part.output_text || '')
        .filter(Boolean)
        .join('\n');
      if (text) return { role: 'assistant', text, rawType: payload.type };
    }
  }

  return null;
}

function updateCodexSessionId(session, event) {
  if (event?.type === 'thread.started' && event.thread_id) {
    session.codexSessionId = event.thread_id;
    return;
  }

  const id = event?.payload?.id || event?.payload?.session_id || event?.payload?.payload?.id;
  if (event?.type === 'session_meta' && event?.payload?.id) session.codexSessionId = event.payload.id;
  if (event?.type === 'event_msg' && event?.payload?.type === 'session_meta' && id) session.codexSessionId = id;
  if (event?.type === 'response_item' && event?.payload?.type === 'session_meta' && id) session.codexSessionId = id;
  if (event?.type === 'session_meta' && id) session.codexSessionId = id;
}

function runCodex(session, prompt, options = {}) {
  if (running.has(session.id)) throw new Error('session_running');

  ensureSessionHarness(session);
  const run = createHarnessRun(session, {
    runId: options.runId,
    prompt,
    elevated: options.elevated === true,
    images: options.images || [],
    files: options.files || [],
    messageId: options.messageId || '',
    clientMessageId: options.clientMessageId || '',
    status: 'submitted'
  });
  updateRunStatus(session, run.id, 'running', {
    startedAt: nowIso(),
    elevated: options.elevated === true,
    codexSessionId: session.codexSessionId || run.codexSessionId || ''
  });
  session.activeRun = {
    runId: run.id,
    prompt,
    elevated: options.elevated === true,
    imagePaths: options.imagePaths || [],
    files: options.files || [],
    messageId: options.messageId || '',
    clientMessageId: options.clientMessageId || '',
    startedAt: nowIso()
  };
  updateMessageRunState(session, options.messageId || options.clientMessageId, 'running', { delivery: 'running', runId: run.id });
  session.status = 'running';
  session.updatedAt = nowIso();
  auditSession(session, 'run.spawn.requested', { runId: run.id, messageId: run.userMessageId, summary: run.promptSummary });
  scheduleSave();
  addMessage(session, {
    role: 'system',
    text: options.elevated ? 'Codex is working with elevated permissions for this run.' : 'Codex is working.',
    status: 'running',
    queuedCount: session.queue?.length || 0
  });

  const args = buildCodexArgs(session, prompt, options);
  const command = CODEX_BIN.endsWith('.js') ? CODEX_NODE : CODEX_BIN;
  const commandArgs = CODEX_BIN.endsWith('.js') ? [CODEX_BIN, ...args] : args;
  const child = spawn(command, commandArgs, {
    cwd: session.cwd,
    detached: true,
    env: {
      ...process.env,
      PATH: `${CODEX_BIN_DIR}:${process.env.PATH || ''}`,
      NO_COLOR: '1'
    },
    stdio: ['pipe', 'pipe', 'pipe']
  });
  running.set(session.id, child);
  updateRunStatus(session, run.id, 'running', { pid: child.pid || 0 });
  appendRunEvent(session, 'process.spawned', { summary: `${command} ${commandArgs.slice(0, 6).join(' ')}` }, { runId: run.id });
  broadcastSession(session);

  child.stdin.write(prompt);
  child.stdin.end();

  let stdoutBuffer = '';
  let lastCodexError = '';
  child.stdout.on('data', (chunk) => {
    stdoutBuffer += chunk.toString('utf8');
    const lines = stdoutBuffer.split('\n');
    stdoutBuffer = lines.pop() || '';
    for (const line of lines) {
      const result = handleCodexLine(session, line);
      if (result?.error) lastCodexError = result.error;
    }
  });

  child.stderr.on('data', (chunk) => {
    const text = chunk.toString('utf8').trim();
    if (text) {
      lastCodexError = text;
      addMessage(session, { role: 'tool', text, rawType: 'stderr' });
    }
  });

  child.on('error', (error) => {
    running.delete(session.id);
    const failure = classifyCodexFailure({ spawnError: error, session });
    session.status = 'error';
    updateRunStatus(session, session.activeRun?.runId || run.id, 'failed', {
      endedAt: nowIso(),
      errorCode: failure.code,
      errorSummary: failure.summary
    });
    appendRunEvent(session, 'process.error', { errorCode: failure.code, error: failure.summary }, { runId: session.activeRun?.runId || run.id });
    updateMessageRunState(session, session.activeRun?.messageId || session.activeRun?.clientMessageId, 'failed', {
      delivery: 'failed',
      errorCode: failure.code,
      errorSummary: failure.summary
    });
    completeSecretaryAutonomousRun(session, findRun(session, session.activeRun?.runId || run.id), 'failed', failure);
    delete session.activeRun;
    addMessage(session, {
      role: 'system',
      text: `Failed to start Codex: ${failure.summary}`,
      status: 'error'
    });
    broadcastSession(session);
    scheduleSave();
  });

  child.on('close', (code) => {
    if (!running.has(session.id) && session.status === 'error') return;
    if (stdoutBuffer.trim()) {
      const result = handleCodexLine(session, stdoutBuffer);
      if (result?.error) lastCodexError = result.error;
    }
    running.delete(session.id);
    const wasStopping = session.status === 'stopping';
    const next = session.queue?.shift() || null;
    const nextStatus = code === 0 || wasStopping ? 'idle' : 'error';
    const finalRunState = wasStopping ? 'stopped' : code === 0 ? 'completed' : 'failed';
    const failure = finalRunState === 'failed'
      ? classifyCodexFailure({ code, lastError: lastCodexError, session, wasStopping })
      : null;
    const activeRunId = session.activeRun?.runId || run.id;
    updateRunStatus(session, activeRunId, finalRunState, {
      endedAt: nowIso(),
      exitCode: code,
      signalCode: child.signalCode || null,
      errorCode: failure?.code || '',
      errorSummary: failure?.summary || ''
    });
    appendRunEvent(session, 'process.exit', {
      exitCode: code,
      status: finalRunState,
      errorCode: failure?.code || '',
      summary: failure?.summary || `Codex exited with ${code}`
    }, { runId: activeRunId });
    updateMessageRunState(session, session.activeRun?.messageId || session.activeRun?.clientMessageId, finalRunState, {
      delivery: finalRunState,
      errorCode: failure?.code || '',
      errorSummary: failure?.summary || ''
    });
    completeSecretaryAutonomousRun(session, findRun(session, activeRunId), finalRunState, failure);
    delete session.activeRun;
    session.status = nextStatus;
    session.updatedAt = nowIso();
    addMessage(session, {
      role: 'system',
      runId: activeRunId,
      text: next?.prompt
        ? wasStopping ? 'Codex run stopped. Starting next queued prompt.' : 'Codex run finished. Starting next queued prompt.'
        : wasStopping ? 'Codex run stopped.' : code === 0 ? 'Codex run finished.' : codexExitMessage(code, session, lastCodexError),
      status: next?.prompt ? 'running' : nextStatus,
      queuedCount: session.queue?.length || 0
    });
    if (finalRunState === 'completed') {
      autoMountSessionSites(session).then((mounts) => {
        if (!mounts.length) return;
        addMessage(session, {
          role: 'system',
          text: `子站点已挂载：${mounts.map((mount) => `/sites/${mount.slug}/`).join(' ')}`,
          status: 'completed'
        });
        broadcastSession(session);
        scheduleSave();
      }).catch((error) => {
        appendRunEvent(session, 'site_mount.failed', { error: error.message || String(error) }, { runId: activeRunId });
        scheduleSave();
      });
    }
    if (next?.prompt) {
      scheduleSave();
      runCodex(session, next.prompt, {
        runId: next.runId,
        elevated: next.elevated,
        imagePaths: (next.images || []).map((image) => image.path),
        images: next.images || [],
        files: next.files || [],
        messageId: next.messageId,
        clientMessageId: next.clientMessageId
      });
      return;
    }

    broadcastSession(session);
    scheduleSave();
    scheduleServiceRestart();
  });
}

function stopRunningSession(session) {
  const child = running.get(session.id);
  if (!child) return false;

  session.status = 'stopping';
  session.updatedAt = nowIso();
  const queuedCount = session.queue?.length || 0;
  updateRunStatus(session, session.activeRun?.runId || session.activeRun?.messageId, 'stopping');
  appendRunEvent(session, 'stop.requested', { summary: `queued:${queuedCount}` }, { runId: session.activeRun?.runId });
  updateMessageRunState(session, session.activeRun?.messageId || session.activeRun?.clientMessageId, 'stopping', { delivery: 'stopping' });
  addMessage(session, {
    role: 'system',
    text: queuedCount ? `Stop requested. ${queuedCount} queued prompt${queuedCount === 1 ? '' : 's'} will continue.` : 'Stop requested.',
    status: 'stopping',
    queuedCount
  });
  broadcastSession(session);

  terminateChildProcess(child, 'SIGTERM');

  setTimeout(() => {
    if (!running.has(session.id)) return;
    terminateChildProcess(child, 'SIGKILL');
  }, 3000).unref();

  scheduleSave();
  return true;
}

function handleCodexLine(session, line) {
  const text = line.trim();
  if (!text) return null;
  let event = null;
  try {
    event = JSON.parse(text);
  } catch {
    addMessage(session, { role: 'tool', text, rawType: 'stdout' });
    return null;
  }

  updateCodexSessionId(session, event);
  const run = activeRunRecord(session);
  if (run && session.codexSessionId) run.codexSessionId = session.codexSessionId;
  updateSessionUsageFromEvent(session, event);
  const error = summarizeCodexEvent(event);
  if (event.type === 'thread.started' && event.thread_id) {
    appendRunEvent(session, 'thread.started', { summary: event.thread_id }, { runId: run?.id });
  } else if (event.type === 'turn.started') {
    appendRunEvent(session, 'turn.started', { summary: 'turn started' }, { runId: run?.id });
  } else if (event.type === 'turn.failed' || error) {
    appendRunEvent(session, 'turn.failed', { errorCode: 'turn_failed', error }, { runId: run?.id });
  } else if (event.payload?.type === 'task_started') {
    appendRunEvent(session, 'task.started', { summary: 'task started' }, { runId: run?.id });
  } else if (event.payload?.type === 'exec_command_end') {
    appendRunEvent(session, 'exec.end', {
      status: event.payload.status || '',
      summary: Array.isArray(event.payload.command) ? event.payload.command.join(' ') : ''
    }, { runId: run?.id });
  }
  const message = deriveMessageFromCodexEvent(event);
  if (message) addMessage(session, message);
  return { event, error };
}

async function serveStatic(req, res, pathname) {
  let file = pathname === '/' ? '/index.html' : pathname;
  file = path.normalize(file).replace(/^(\.\.[/\\])+/, '');
  const fullPath = path.join(PUBLIC_DIR, file);
  if (!fullPath.startsWith(PUBLIC_DIR)) {
    res.writeHead(403);
    res.end('Forbidden');
    return;
  }

  try {
    await stat(fullPath);
    const ext = path.extname(fullPath);
    const cacheControl = ext === '.html' ? 'no-store' : pathname === '/sw.js' ? 'no-cache' : 'public, max-age=3600';
    res.writeHead(200, {
      'content-type': contentTypes[ext] || 'application/octet-stream',
      'cache-control': cacheControl
    });
    createReadStream(fullPath).pipe(res);
  } catch {
    if (!pathname.startsWith('/api/') && !pathname.startsWith('/events')) {
      const index = path.join(PUBLIC_DIR, 'index.html');
      res.writeHead(200, { 'content-type': contentTypes['.html'], 'cache-control': 'no-store' });
      createReadStream(index).pipe(res);
      return;
    }
    json(res, 404, { error: 'not_found' });
  }
}

function siteNavigationHtml(session) {
  const mounts = publicSiteMountsForSession(session.id);
  const items = mounts.map((mount) => `
    <a class="site-card" href="${escapeHtml(mount.url)}" target="_blank" rel="noopener">
      <span>${escapeHtml(mount.type === 'external' ? '外部域名' : mount.type === 'service' ? 'Web 服务' : '本地子站')}</span>
      <strong>${escapeHtml(mount.title || mount.slug || '站点')}</strong>
      <small>${escapeHtml(mount.url)}</small>
    </a>
  `).join('');
  return `<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
  <title>${escapeHtml(session.title || '会话')} · 子站点</title>
  <style>
    :root { color-scheme: dark; font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; background: #101215; color: #f5f5f0; }
    body { margin: 0; min-height: 100vh; background: #101215; }
    main { width: min(920px, calc(100% - 28px)); margin: 0 auto; padding: max(18px, env(safe-area-inset-top)) 0 28px; }
    header { display: grid; gap: 6px; margin-bottom: 16px; }
    h1 { margin: 0; font-size: clamp(22px, 6vw, 34px); line-height: 1.08; }
    p { margin: 0; color: #a7aaa2; font-size: 14px; }
    .grid { display: grid; gap: 10px; }
    .site-card { display: grid; gap: 5px; padding: 13px 14px; border: 1px solid #343832; border-radius: 12px; background: #181b18; color: inherit; text-decoration: none; }
    .site-card:focus-visible { outline: 2px solid #6da8ff; outline-offset: 2px; }
    .site-card span { color: #7fd7a3; font-size: 12px; font-weight: 800; }
    .site-card strong { font-size: 16px; overflow-wrap: anywhere; }
    .site-card small { color: #a7aaa2; overflow-wrap: anywhere; }
    .empty { padding: 16px; border: 1px dashed #343832; border-radius: 12px; color: #a7aaa2; }
  </style>
</head>
<body>
  <main>
    <header>
      <h1>${escapeHtml(session.title || '当前会话')} · 子站点导航</h1>
      <p>${mounts.length ? `共 ${mounts.length} 个站点` : '当前会话还没有注册站点'}</p>
    </header>
    <section class="grid">${items || '<div class="empty">在会话菜单里点击“注册站点”，让 Codex 自动生成或注册访问地址。</div>'}</section>
  </main>
</body>
</html>`;
}

async function serveSessionSiteNavigation(req, res, sessionId) {
  const auth = requireAuth(req, res);
  if (!auth) return;
  const session = state.sessions[sessionId];
  if (!session) return json(res, 404, { error: 'session_not_found' });
  res.writeHead(200, {
    'content-type': 'text/html; charset=utf-8',
    'cache-control': 'no-store',
    'x-content-type-options': 'nosniff'
  });
  res.end(siteNavigationHtml(session));
}

async function proxyServiceMount(req, res, mount, requestPath, search = '') {
  const targetBase = safeLocalServiceUrl(mount.targetUrl);
  if (!targetBase) return json(res, 404, { error: 'site_service_not_found' });
  const base = new URL(targetBase);
  const basePath = base.pathname.endsWith('/') ? base.pathname.slice(0, -1) : base.pathname;
  const suffix = requestPath === '/' ? '/' : requestPath;
  const target = new URL(base);
  target.pathname = path.posix.normalize(`${basePath}${suffix}`);
  if (!target.pathname.startsWith('/')) target.pathname = `/${target.pathname}`;
  target.search = search || '';

  const headers = { ...req.headers };
  delete headers.host;
  delete headers.connection;
  delete headers['content-length'];
  headers.host = target.host;
  headers['x-forwarded-host'] = req.headers.host || '';
  headers['x-forwarded-proto'] = 'https';
  headers['x-forwarded-prefix'] = `/sites/${mount.slug}`;

  const proxyReq = http.request(target, {
    method: req.method,
    headers,
    timeout: 30_000
  }, (proxyRes) => {
    const responseHeaders = { ...proxyRes.headers };
    delete responseHeaders['content-security-policy'];
    delete responseHeaders['content-security-policy-report-only'];
    if (responseHeaders.location) {
      try {
        const location = new URL(String(responseHeaders.location), target);
        if (location.origin === target.origin) {
          const basePath = base.pathname.endsWith('/') ? base.pathname.slice(0, -1) : base.pathname;
          const relativePath = location.pathname.startsWith(basePath)
            ? location.pathname.slice(basePath.length) || '/'
            : location.pathname;
          responseHeaders.location = `/sites/${mount.slug}${relativePath}${location.search || ''}`;
        }
      } catch {
        // Keep the upstream Location header if it is not parseable.
      }
    }
    res.writeHead(proxyRes.statusCode || 502, responseHeaders);
    proxyRes.pipe(res);
  });

  proxyReq.on('timeout', () => {
    proxyReq.destroy(new Error('proxy_timeout'));
  });
  proxyReq.on('error', (error) => {
    if (res.headersSent) {
      res.destroy(error);
      return;
    }
    json(res, 502, { error: 'site_service_unavailable', message: error.message || String(error) });
  });
  req.pipe(proxyReq);
}

async function serveSiteMount(req, res, url) {
  const auth = requireAuth(req, res);
  if (!auth) return;
  const navigationMatch = url.pathname.match(/^\/sites\/session\/([^/]+)\/?$/);
  if (navigationMatch) {
    let sessionId = '';
    try {
      sessionId = decodeURIComponent(navigationMatch[1]);
    } catch {
      return json(res, 400, { error: 'bad_site_path' });
    }
    return serveSessionSiteNavigation(req, res, sessionId);
  }
  const match = url.pathname.match(/^\/sites\/([^/]+)(\/.*)?$/);
  if (!match) return json(res, 404, { error: 'site_not_found' });
  let slug = '';
  try {
    slug = decodeURIComponent(match[1]);
  } catch {
    return json(res, 400, { error: 'bad_site_path' });
  }
  const mount = Object.values(state.siteMounts || {}).find((item) => item.slug === slug && !item.deletedAt);
  if (!mount) return json(res, 404, { error: 'site_not_found' });
  if (!match[2]) {
    res.writeHead(302, { location: `/sites/${encodeURIComponent(slug)}/` });
    res.end();
    return;
  }
  if (mount.type === 'external') {
    res.writeHead(302, { location: mount.url });
    res.end();
    return;
  }
  if (mount.type === 'service') {
    return proxyServiceMount(req, res, mount, match[2] || '/', url.search || '');
  }

  const root = await realpath(mount.root).catch(() => '');
  if (!root || !isInsidePath(SITE_MOUNT_ROOT, root)) return json(res, 404, { error: 'site_not_found' });
  let requestFile = match[2] === '/' ? '/index.html' : match[2];
  try {
    requestFile = decodeURIComponent(requestFile);
  } catch {
    return json(res, 400, { error: 'bad_site_path' });
  }
  const requestParts = requestFile.split('/').filter(Boolean);
  if (requestParts.some((part) => SITE_MOUNT_BLOCKED_PARTS.has(part) || part.startsWith('.'))) {
    return json(res, 403, { error: 'forbidden' });
  }
  if (SITE_MOUNT_BLOCKED_FILES.has(path.basename(requestFile).toLowerCase())) {
    return json(res, 403, { error: 'forbidden' });
  }
  const filePath = path.resolve(root, `.${path.normalize(requestFile)}`);
  if (!isInsidePath(root, filePath)) return json(res, 403, { error: 'forbidden' });

  const sendFile = async (target) => {
    const ext = path.extname(target).toLowerCase();
    if (!SITE_MOUNT_SAFE_EXTENSIONS.has(ext)) return json(res, 403, { error: 'forbidden' });
    const cacheControl = ext === '.html' ? 'no-store' : 'private, max-age=120';
    res.writeHead(200, {
      'content-type': contentTypes[ext] || 'application/octet-stream',
      'cache-control': cacheControl,
      'x-content-type-options': 'nosniff'
    });
    createReadStream(target).pipe(res);
  };

  try {
    const info = await stat(filePath);
    if (info.isDirectory()) {
      const index = path.join(filePath, 'index.html');
      if (await exists(index)) return sendFile(index);
      return json(res, 404, { error: 'site_file_not_found' });
    }
    return sendFile(filePath);
  } catch {
    const index = path.join(root, 'index.html');
    if (await exists(index)) return sendFile(index);
    return json(res, 404, { error: 'site_file_not_found' });
  }
}

async function handleApi(req, res, url) {
  if (url.pathname === '/api/healthz') return json(res, 200, { ok: true });

  if (url.pathname === '/api/login' && req.method === 'POST') {
    const body = await readJson(req);
    if (!safeCompare(body.password || '', adminPassword)) {
      return json(res, 401, { error: 'bad_password' });
    }
    const token = randomBytes(32).toString('base64url');
    state.authSessions[token] = {
      createdAt: Date.now(),
      lastSeenAt: Date.now(),
      expiresAt: Date.now() + THIRTY_DAYS,
      client: body.client === 'mobile-ui-check' ? 'mobile-ui-check' : ''
    };
    scheduleSave();
    return json(res, 200, { ok: true, expiresAt: state.authSessions[token].expiresAt }, {
      'set-cookie': cookieHeader(token, THIRTY_DAYS / 1000)
    });
  }

  if (url.pathname === '/api/logout' && req.method === 'POST') {
    const token = parseCookies(req)[COOKIE_NAME];
    if (token) delete state.authSessions[token];
    scheduleSave();
    return json(res, 200, { ok: true }, { 'set-cookie': cookieHeader('', 0) });
  }

  const auth = requireAuth(req, res);
  if (!auth) return;

  if (url.pathname === '/api/me') {
    return json(res, 200, { ok: true, expiresAt: auth.session.expiresAt });
  }

  if (url.pathname === '/api/storage' && req.method === 'GET') {
    return json(res, 200, await storageStats());
  }

  if (url.pathname === '/api/storage' && req.method === 'PATCH') {
    const body = await readJson(req);
    state.storageSettings = normalizeStorageSettings({
      ...state.storageSettings,
      ...body
    });
    scheduleSave();
    startStorageMaintenance();
    return json(res, 200, await storageStats());
  }

  if (url.pathname === '/api/storage/cleanup' && req.method === 'POST') {
    const body = await readJson(req);
    const mode = ['all', 'orphanUploads', 'runtime'].includes(body.mode) ? body.mode : 'all';
    const result = await cleanupStorage(mode, { manual: true });
    return json(res, 200, { ok: true, result, storage: await storageStats() });
  }

  if (url.pathname === '/api/codex/config' && req.method === 'GET') {
    return json(res, 200, await codexConfigSummary());
  }

  if (url.pathname === '/api/system/health' && req.method === 'GET') {
    return json(res, 200, await systemHealth());
  }

  if (url.pathname === '/api/app/version' && req.method === 'GET') {
    return json(res, 200, await appVersionInfo({ checkRemote: false }));
  }

  if (url.pathname === '/api/app/update-check' && req.method === 'GET') {
    return json(res, 200, await appVersionInfo({ checkRemote: true }));
  }

  if (url.pathname === '/api/app/update-settings' && req.method === 'GET') {
    return json(res, 200, { settings: normalizeAppUpdateSettings(state.appUpdateSettings) });
  }

  if (url.pathname === '/api/app/update-settings' && req.method === 'PATCH') {
    const body = await readJson(req).catch(() => ({}));
    state.appUpdateSettings = normalizeAppUpdateSettings({
      ...state.appUpdateSettings,
      autoUpdate: body.autoUpdate === true,
      checkIntervalHours: body.checkIntervalHours
    });
    scheduleSave();
    startAppUpdateMaintenance();
    return json(res, 200, { settings: state.appUpdateSettings });
  }

  if (url.pathname === '/api/app/update' && req.method === 'POST') {
    try {
      const body = await readJson(req).catch(() => ({}));
      const task = await startAppUpdate(body);
      return json(res, 202, { ok: true, task });
    } catch (error) {
      if (error.code === 'sessions_running') return json(res, 409, { error: 'sessions_running', message: '有 Codex 任务正在运行，等待结束后再升级。', running: running.size });
      if (error.code === 'dirty_worktree') return json(res, 409, { error: 'dirty_worktree', message: '本地有未提交改动，自动升级已阻止。', detail: error.detail || '' });
      if (error.code === 'update_not_available') return json(res, 409, { error: 'update_not_available', message: '当前没有可升级版本。' });
      return json(res, 500, { error: error.code || 'app_update_failed', message: error.message || String(error) });
    }
  }

  if (url.pathname === '/api/app/rollback' && req.method === 'POST') {
    try {
      const task = await startAppRollback();
      return json(res, 202, { ok: true, task });
    } catch (error) {
      if (error.code === 'sessions_running') return json(res, 409, { error: 'sessions_running', message: '有 Codex 任务正在运行，等待结束后再回滚。', running: running.size });
      if (error.code === 'dirty_worktree') return json(res, 409, { error: 'dirty_worktree', message: '本地有未提交改动，自动回滚已阻止。', detail: error.detail || '' });
      if (error.code === 'rollback_not_found') return json(res, 404, { error: 'rollback_not_found', message: '没有可用的上个版本回滚点。' });
      return json(res, 500, { error: error.code || 'app_rollback_failed', message: error.message || String(error) });
    }
  }

  if (url.pathname === '/api/codex/upgrade-check' && req.method === 'GET') {
    return json(res, 200, await codexVersionInfo({ latest: true }));
  }

  if (url.pathname === '/api/codex/upgrade' && req.method === 'POST') {
    try {
      const task = await startCodexUpgrade();
      return json(res, 202, { ok: true, task });
    } catch (error) {
      if (error.code === 'sessions_running') {
        return json(res, 409, { error: 'sessions_running', message: '有 Codex 任务正在运行，等待结束后再升级。', running: running.size });
      }
      return json(res, 500, { error: 'upgrade_failed', message: error.message || String(error) });
    }
  }

  if (url.pathname === '/api/skills' && req.method === 'GET') {
    await reloadSkillRegistryIfChanged();
    return json(res, 200, publicSkillRegistry());
  }

  if (url.pathname === '/api/skills/refresh' && req.method === 'POST') {
    refreshSkillRegistry().catch(() => {});
    return json(res, 202, {
      ok: true,
      ...publicSkillRegistry(),
      scanStatus: skillScanPromise ? 'scanning' : skillRegistry.scanStatus
    });
  }

  if (url.pathname === '/api/secretary' && req.method === 'GET') {
    return json(res, 200, await secretaryStatusPayload());
  }

  if (url.pathname === '/api/secretary/activate' && req.method === 'POST') {
    const session = await ensureSecretarySession();
    return json(res, 200, { ok: true, ...(await secretaryStatusPayload()), session: publicSession(session) });
  }

  if (url.pathname === '/api/secretary/resume' && req.method === 'POST') {
    const session = await resumeSecretary();
    return json(res, 200, { ok: true, ...(await secretaryStatusPayload()), session: publicSession(session) });
  }

  if (url.pathname === '/api/secretary/kill' && req.method === 'POST') {
    const result = await stopSecretary();
    return json(res, 200, { ok: true, ...result, ...(await secretaryStatusPayload()) });
  }

  if (url.pathname === '/api/secretary/settings' && req.method === 'PATCH') {
    const body = await readJson(req);
    const control = secretaryControl();
    const settings = normalizeSecretarySettings({ ...control.settings, ...(body.settings || body) });
    state.secretary = { ...control, settings, updatedAt: nowIso() };
    appendSecretaryAudit('secretary.settings.updated', {
      sessionId: control.sessionId,
      summary: JSON.stringify(settings)
    });
    scheduleSave();
    if (settings.enabled && !control.killSwitch) setTimeout(() => runSecretaryAutonomyTick('settings').catch(() => {}), 50).unref?.();
    return json(res, 200, { ok: true, ...(await secretaryStatusPayload()) });
  }

  if (url.pathname === '/api/secretary/wake' && req.method === 'POST') {
    const control = secretaryControl();
    if (control.killSwitch) return json(res, 423, { error: 'secretary_stopped', message: '秘书总停止已启用。' });
    const session = await ensureSecretarySession();
    const tasks = await readSecretaryTaskLedger();
    const trigger = { type: 'manual', label: '立即唤醒', localDate: nowIso().slice(0, 10) };
    const prompt = secretaryAutonomyPrompt(trigger, { tasks: tasks.tasks });
    markSecretaryTriggerStarted(trigger, new Date());
    const result = queueSecretaryPrompt(session, prompt, {
      displayPrompt: `【自主任务 · 立即唤醒】\n${prompt}`,
      origin: 'autonomy',
      triggerType: 'manual'
    });
    addSecretaryNotification({
      type: 'started',
      title: '秘书已被唤醒',
      body: result.queued ? '任务已经进入队列。' : '正在检查状态并自主执行。',
      runId: result.run.id
    });
    return json(res, 202, { ok: true, queued: result.queued, ...(await secretaryStatusPayload()) });
  }

  if (url.pathname === '/api/secretary/events' && req.method === 'POST') {
    const body = await readJson(req);
    const title = String(body.title || '').trim();
    if (!title) return json(res, 400, { error: 'missing_event_title' });
    const control = secretaryControl();
    const signal = {
      id: randomUUID(),
      at: nowIso(),
      type: String(body.type || 'external').slice(0, 80),
      title: title.slice(0, 160),
      detail: String(body.detail || '').slice(0, 1600),
      priority: ['urgent', 'high', 'normal', 'low'].includes(body.priority) ? body.priority : 'normal',
      status: 'pending'
    };
    state.secretary = { ...control, signals: [...control.signals, signal].slice(-80), updatedAt: signal.at };
    appendSecretaryAudit('secretary.signal.received', { sessionId: control.sessionId, summary: `${signal.priority}:${signal.type}:${signal.title}` });
    scheduleSave();
    setTimeout(() => runSecretaryAutonomyTick('event').catch(() => {}), 50).unref?.();
    return json(res, 202, { ok: true, signal, ...(await secretaryStatusPayload()) });
  }

  if (url.pathname === '/api/secretary/notifications/read' && req.method === 'POST') {
    const body = await readJson(req).catch(() => ({}));
    const ids = new Set((Array.isArray(body.ids) ? body.ids : []).map(String));
    const control = secretaryControl();
    state.secretary = {
      ...control,
      notifications: control.notifications.map((item) => (!ids.size || ids.has(item.id)) ? { ...item, read: true } : item),
      updatedAt: nowIso()
    };
    scheduleSave();
    return json(res, 200, { ok: true, ...(await secretaryStatusPayload()) });
  }

  if (url.pathname === '/api/secretary/quick-task' && req.method === 'POST') {
    const body = await readJson(req);
    const prompt = secretaryQuickPrompt(body.kind);
    if (!prompt) return json(res, 400, { error: 'unknown_secretary_quick_task' });
    const session = await ensureSecretarySession();
    if (secretaryControl().killSwitch) {
      return json(res, 423, { error: 'secretary_stopped', message: '秘书总停止已启用。' });
    }
    const result = queueSecretaryPrompt(session, prompt, { origin: 'quick', triggerType: String(body.kind || '') });
    return json(res, 202, { ok: true, queued: result.queued, session: publicSession(session) });
  }

  if (url.pathname === '/api/admin/restart' && req.method === 'POST') {
    const body = req.method === 'POST' ? await readJson(req).catch(() => ({})) : {};
    const result = await requestServiceRestart(String(body.reason || 'api').slice(0, 80));
    return json(res, 202, { ok: true, ...result });
  }

  const uploadMatch = url.pathname.match(/^\/api\/uploads\/([^/]+)$/);
  if (uploadMatch && req.method === 'GET') {
    const fileName = decodeURIComponent(uploadMatch[1]);
    if (!/^[a-f0-9-]+\.[a-z0-9]{1,12}$/.test(fileName)) return json(res, 400, { error: 'invalid_upload_name' });
    const filePath = path.join(UPLOAD_DIR, fileName);
    const resolved = path.resolve(filePath);
    if (!resolved.startsWith(`${path.resolve(UPLOAD_DIR)}${path.sep}`)) return json(res, 403, { error: 'forbidden' });
    try {
      await stat(resolved);
      const ext = path.extname(resolved);
      const type = imageContentType(ext);
      res.writeHead(200, {
        'content-type': type,
        'cache-control': 'private, max-age=3600',
        'x-content-type-options': 'nosniff'
      });
      createReadStream(resolved).pipe(res);
    } catch {
      json(res, 404, { error: 'upload_not_found' });
    }
    return;
  }

  const messageListMatch = url.pathname.match(/^\/api\/sessions\/([^/]+)\/messages$/);
  if (messageListMatch && req.method === 'GET') {
    const session = state.sessions[decodeURIComponent(messageListMatch[1])];
    if (!session) return json(res, 404, { error: 'session_not_found' });
    reconcileSessionRunState(session, 'message-list');
    const range = await displayMessageRange(session, {
      limit: url.searchParams.get('limit'),
      beforeSeq: url.searchParams.get('beforeSeq'),
      afterSeq: url.searchParams.get('afterSeq'),
      previousTurn: url.searchParams.get('previousTurn'),
      brief: url.searchParams.get('brief')
    });
    return json(res, 200, { session: publicSession(session), view: sessionView(session), ...range });
  }

  if (url.pathname === '/api/projects') {
    return json(res, 200, {
      roots: [PROJECTS_ROOT, '/root/data/disk/Projects'],
      defaultCwd: PROJECTS_ROOT
    });
  }

  if (url.pathname === '/api/evolution/projects' && req.method === 'GET') {
    return json(res, 200, { projects: await listEvolutionProjects({ includeDetails: false }) });
  }

  if (url.pathname === '/api/evolution/session-links/infer' && req.method === 'POST') {
    const body = await readJson(req).catch(() => ({}));
    return json(res, 200, await inferEvolutionSessionLinks({ apply: body.apply !== false }));
  }

  const evolutionMatch = url.pathname.match(/^\/api\/evolution\/projects\/([^/]+)\/(init|audit|check|config|objective-suggestions)$/);
  if (evolutionMatch && (req.method === 'POST' || req.method === 'PATCH')) {
    const projectId = decodeURIComponent(evolutionMatch[1]);
    const action = evolutionMatch[2];
    if (action === 'init' && req.method === 'POST') {
      const project = await initEvolutionProject(projectId);
      if (!project) return json(res, 404, { error: 'project_not_found' });
      return json(res, 200, { project });
    }
    if (action === 'audit' && req.method === 'POST') {
      const audit = await auditEvolutionProject(projectId);
      if (!audit) return json(res, 404, { error: 'project_not_found' });
      return json(res, 200, audit);
    }
    if (action === 'check' && req.method === 'POST') {
      const result = await runEvolutionChecks(projectId);
      if (!result) return json(res, 404, { error: 'project_not_found' });
      return json(res, 200, result);
    }
    if (action === 'config' && req.method === 'PATCH') {
      const body = await readJson(req).catch(() => ({}));
      const project = await updateEvolutionConfig(projectId, body);
      if (!project) return json(res, 404, { error: 'project_not_found' });
      return json(res, 200, { project });
    }
    if (action === 'objective-suggestions' && req.method === 'POST') {
      const result = await suggestEvolutionObjectives(projectId);
      if (!result) return json(res, 404, { error: 'project_not_found' });
      return json(res, 200, result);
    }
  }

  if (url.pathname === '/api/sessions' && req.method === 'GET') {
    for (const session of Object.values(state.sessions)) reconcileSessionRunState(session, 'session-list');
    const webSessions = Object.values(state.sessions).map(publicSession);
    const codexSessions = await listCodexSessions();
    const sessions = sortPublicSessions([...webSessions, ...codexSessions]);
    return json(res, 200, { sessions });
  }

  if (url.pathname === '/api/codex-sessions/import' && req.method === 'POST') {
    const body = await readJson(req);
    const codexSessionId = String(body.codexSessionId || '').trim();
    if (!codexSessionId) return json(res, 400, { error: 'missing_codex_session_id' });
    const session = await importCodexSession(codexSessionId);
    if (!session) return json(res, 404, { error: 'codex_session_not_found' });
    scheduleSave();
    return json(res, 201, { session: publicSession(session) });
  }

  if (url.pathname === '/api/fs' && req.method === 'GET') {
    const dir = url.searchParams.get('path') || '/root/Projects';
    try {
      return json(res, 200, await listDirectories(dir));
    } catch (error) {
      return json(res, 400, { error: 'cannot_read_directory', message: String(error.message || error) });
    }
  }

  if (url.pathname === '/api/sessions' && req.method === 'POST') {
    const body = await readJson(req);
    const id = randomUUID();
    const cwd = path.resolve(body.cwd || '/root/Projects');
    const title = String(body.title || path.basename(cwd) || 'Codex session').slice(0, 80);
    const sessionConfig = normalizeSessionConfig(body);
    let linkedProjectPath = '';
    try {
      linkedProjectPath = await normalizeLinkedProjectPath(body.linkedProjectPath || '');
    } catch (error) {
      return json(res, 400, { error: error.code || 'invalid_linked_project', message: error.message || '关联项目无效' });
    }
    state.sessions[id] = {
      id,
      title,
      cwd,
      linkedProjectPath,
      ...sessionConfig,
      tags: normalizeSessionTags(body.tags || []),
      codexSessionId: '',
      status: 'idle',
      createdAt: nowIso(),
      updatedAt: nowIso(),
      lastSeq: 0,
      queue: [],
      runs: [],
      audit: [],
      messages: []
    };
    auditSession(state.sessions[id], 'session.created', { summary: cwd });
    addMessage(state.sessions[id], { role: 'system', text: `Session created in ${cwd}.` });
    scheduleSave();
    return json(res, 201, { session: publicSession(state.sessions[id]) });
  }

  if (url.pathname === '/api/sessions/tags/infer' && req.method === 'POST') {
    const webCount = applySmartTagsToState();
    const codexSessions = await listCodexSessions();
    state.codexSessionTags ||= {};
    for (const session of codexSessions) {
      const codexSessionId = session.codexSessionId;
      if (!codexSessionId) continue;
      session.tags = inferSessionTags(session);
      state.codexSessionTags[codexSessionId] = session.tags;
    }
    scheduleSave();
    return json(res, 200, {
      ok: true,
      count: webCount + codexSessions.length,
      sessions: sortPublicSessions([...Object.values(state.sessions || {}).map(publicSession), ...codexSessions])
    });
  }

  if (url.pathname === '/api/tags' && req.method === 'GET') {
    return json(res, 200, await tagManagementSummary());
  }

  if (url.pathname === '/api/sessions/tags/undo' && req.method === 'POST') {
    const snapshot = state.lastTagSnapshot;
    if (!snapshot) return json(res, 404, { error: 'snapshot_not_found' });
    for (const [id, tags] of Object.entries(snapshot.web || {})) {
      if (state.sessions?.[id]) state.sessions[id].tags = normalizeSessionTags(tags || []);
    }
    state.codexSessionTags = {};
    for (const [id, tags] of Object.entries(snapshot.codex || {})) {
      state.codexSessionTags[id] = normalizeSessionTags(tags || []);
    }
    state.lastTagSnapshot = null;
    scheduleSave();
    return json(res, 200, { ok: true, restoredAt: nowIso(), ...(await tagManagementSummary()) });
  }

  if (url.pathname === '/api/tags/action' && req.method === 'POST') {
    const body = await readJson(req);
    const action = String(body.action || '');
    const from = normalizeSessionTags([body.tag || body.from || ''])[0] || '';
    const to = normalizeSessionTags([body.toTag || body.to || ''])[0] || '';
    if (!['rename', 'merge', 'delete'].includes(action)) return json(res, 400, { error: 'invalid_action' });
    if (!from) return json(res, 400, { error: 'missing_tag' });
    if ((action === 'rename' || action === 'merge') && !to) return json(res, 400, { error: 'missing_target_tag' });
    if ((action === 'rename' || action === 'merge') && from === to) return json(res, 400, { error: 'same_tag' });
    snapshotSessionTags();
    const changed = applyTagTransform((tags) => {
      if (action === 'delete') return normalizeSessionTags(tags).filter((tag) => tag !== from);
      return normalizeSessionTags(tags).map((tag) => tag === from ? to : tag);
    });
    scheduleSave();
    return json(res, 200, { ok: true, changed, ...(await tagManagementSummary()) });
  }

  const sessionMatch = url.pathname.match(/^\/api\/sessions\/([^/]+)$/);
  if (sessionMatch && req.method === 'PATCH') {
    const sessionId = decodeURIComponent(sessionMatch[1]);
    const body = await readJson(req);
    const hasConfigPatch = body.config && typeof body.config === 'object';
    const hasTagsPatch = body.tags !== undefined;
    const hasProjectPatch = body.linkedProjectPath !== undefined;
    const title = body.title === undefined ? '' : String(body.title || '').trim().slice(0, 80);
    if (!hasConfigPatch && !hasTagsPatch && !hasProjectPatch && !title) return json(res, 400, { error: 'empty_patch' });

    if (sessionId.startsWith('codex:')) {
      if (hasConfigPatch) return json(res, 400, { error: 'external_session_config_readonly' });
      const codexSessionId = sessionId.slice('codex:'.length);
      if (title) {
        state.codexSessionTitles ||= {};
        state.codexSessionTitles[codexSessionId] = title;
        for (const session of Object.values(state.sessions || {})) {
          if (session.codexSessionId === codexSessionId) {
            session.title = title;
            session.updatedAt = nowIso();
          }
        }
      }
      if (hasTagsPatch) {
        state.codexSessionTags ||= {};
        state.codexSessionTags[codexSessionId] = normalizeSessionTags(body.tags || []);
      }
      if (hasProjectPatch) {
        state.codexSessionProjects ||= {};
        try {
          state.codexSessionProjects[codexSessionId] = await normalizeLinkedProjectPath(body.linkedProjectPath);
        } catch (error) {
          return json(res, 400, { error: error.code || 'invalid_linked_project', message: error.message || '关联项目无效' });
        }
      }
      scheduleSave();
      const external = await findCodexSession(codexSessionId);
      return json(res, 200, {
        session: publicExternalSession(external || { codexSessionId, title: title || state.codexSessionTitles?.[codexSessionId] || 'Codex session', cwd: '', updatedAt: nowIso(), createdAt: nowIso() })
      });
    }

    const session = state.sessions[sessionId];
    if (!session) return json(res, 404, { error: 'session_not_found' });
    if (title) session.title = title;
    if (hasConfigPatch) Object.assign(session, normalizeSessionConfig(body.config, session));
    if (hasTagsPatch) session.tags = normalizeSessionTags(body.tags || []);
    if (hasProjectPatch) {
      try {
        session.linkedProjectPath = await normalizeLinkedProjectPath(body.linkedProjectPath);
      } catch (error) {
        return json(res, 400, { error: error.code || 'invalid_linked_project', message: error.message || '关联项目无效' });
      }
    }
    if (title || hasConfigPatch || hasProjectPatch) session.updatedAt = nowIso();
    scheduleSave();
    return json(res, 200, { session: publicSession(session) });
  }

  if (sessionMatch && req.method === 'GET') {
    const sessionId = decodeURIComponent(sessionMatch[1]);
    const session = state.sessions[sessionId];
    if (!session) return json(res, 404, { error: 'session_not_found' });
    reconcileSessionRunState(session, 'session-load');
    const rawLimit = Number(url.searchParams.get('limit') ?? 500);
    const rawOffset = Number(url.searchParams.get('offset') ?? 0);
    const limit = Number.isFinite(rawLimit) ? Math.max(0, Math.min(5000, Math.floor(rawLimit))) : 500;
    const offset = Number.isFinite(rawOffset) ? Math.max(0, Math.min(50000, Math.floor(rawOffset))) : 0;
    const page = await displayMessagePage(session, { limit, offset });
    return json(res, 200, { session: publicSession(session), view: sessionView(session), ...page });
  }

  const runtimeMatch = url.pathname.match(/^\/api\/sessions\/([^/]+)\/runtime$/);
  if (runtimeMatch && req.method === 'GET') {
    const session = state.sessions[decodeURIComponent(runtimeMatch[1])];
    if (!session) return json(res, 404, { error: 'session_not_found' });
    reconcileSessionRunState(session, 'runtime');
    return json(res, 200, await runtimeInfo(session));
  }

  const sessionViewMatch = url.pathname.match(/^\/api\/sessions\/([^/]+)\/view$/);
  if (sessionViewMatch && req.method === 'GET') {
    const session = state.sessions[decodeURIComponent(sessionViewMatch[1])];
    if (!session) return json(res, 404, { error: 'session_not_found' });
    reconcileSessionRunState(session, 'session-view');
    return json(res, 200, sessionView(session));
  }

  const forkMatch = url.pathname.match(/^\/api\/sessions\/([^/]+)\/fork$/);
  if (forkMatch && req.method === 'POST') {
    const sessionId = decodeURIComponent(forkMatch[1]);
    const body = await readJson(req).catch(() => ({}));
    let codexSessionId = '';
    let sourceTitle = '';
    let sourceSession = null;

    if (sessionId.startsWith('codex:')) {
      codexSessionId = sessionId.slice('codex:'.length);
      const external = await findCodexSession(codexSessionId);
      if (!external) return json(res, 404, { error: 'codex_session_not_found' });
      sourceTitle = state.codexSessionTitles?.[codexSessionId] || external.title || '';
    } else {
      sourceSession = state.sessions[sessionId];
      if (!sourceSession) return json(res, 404, { error: 'session_not_found' });
      reconcileSessionRunState(sourceSession, 'fork');
      if (running.has(sessionId) || ['running', 'stopping'].includes(sourceSession.status)) {
        return json(res, 409, { error: 'session_running', message: '会话正在运行，停止或等待结束后再 fork。' });
      }
      codexSessionId = sourceSession.codexSessionId || '';
      sourceTitle = sourceSession.title || '';
      if (!codexSessionId) {
        return json(res, 409, { error: 'codex_session_missing', message: '当前会话还没有绑定 Codex 原始会话，先运行一次后再 fork。' });
      }
    }

    const forked = await forkCodexSession(codexSessionId, String(body.title || sourceTitle || ''));
    if (!forked) return json(res, 404, { error: 'codex_session_not_found' });
    const session = await importCodexSession(forked.codexSessionId, {
      title: forked.title,
      systemText: `Forked Codex thread ${codexSessionId} into ${forked.codexSessionId}.`
    });
    if (!session) return json(res, 500, { error: 'fork_import_failed' });
    session.model = sourceSession?.model || session.model || '';
    session.profile = sourceSession?.profile || session.profile || '';
    session.reasoningEffort = sourceSession?.reasoningEffort || session.reasoningEffort || '';
    session.sandbox = sourceSession?.sandbox || session.sandbox || 'workspace-write';
    session.approval = sourceSession?.approval || session.approval || 'on-request';
    session.addDirs = Array.isArray(sourceSession?.addDirs) ? [...sourceSession.addDirs] : (session.addDirs || []);
    session.configOverrides = Array.isArray(sourceSession?.configOverrides) ? [...sourceSession.configOverrides] : (session.configOverrides || []);
    session.strictConfig = sourceSession?.strictConfig === true || session.strictConfig === true;
    session.ignoreUserConfig = sourceSession?.ignoreUserConfig === true || session.ignoreUserConfig === true;
    session.ignoreRules = sourceSession?.ignoreRules === true || session.ignoreRules === true;
    session.tags = normalizeSessionTags(sourceSession?.tags || session.tags || []);
    session.updatedAt = nowIso();
    scheduleSave();
    return json(res, 201, { ok: true, forked, session: publicSession(session) });
  }

  const restoreMatch = url.pathname.match(/^\/api\/sessions\/([^/]+)\/restore$/);
  if (restoreMatch && req.method === 'POST') {
    const sessionId = decodeURIComponent(restoreMatch[1]);
    if (sessionId.startsWith('codex:')) {
      const codexSessionId = sessionId.slice('codex:'.length);
      delete state.hiddenCodexSessions?.[codexSessionId];
      scheduleSave();
      const external = await findCodexSession(codexSessionId);
      return json(res, 200, {
        ok: true,
        session: publicExternalSession(external || { codexSessionId, title: state.codexSessionTitles?.[codexSessionId] || `Codex ${codexSessionId.slice(0, 8)}`, cwd: '', updatedAt: nowIso(), createdAt: nowIso() })
      });
    }

    const session = state.sessions[sessionId];
    if (!session) return json(res, 404, { error: 'session_not_found' });
    delete session.trashedAt;
    session.updatedAt = nowIso();
    scheduleSave();
    return json(res, 200, { ok: true, session: publicSession(session) });
  }

  if (sessionMatch && req.method === 'DELETE') {
    const sessionId = decodeURIComponent(sessionMatch[1]);
    const body = await readJson(req);
    if (sessionId.startsWith('codex:')) {
      const codexSessionId = sessionId.slice('codex:'.length);
      let deletedCodex = false;
      if (body.permanent === true) {
        deletedCodex = await deleteCodexSessionFile(codexSessionId);
        delete state.hiddenCodexSessions?.[codexSessionId];
        if (state.codexSessionTitles) delete state.codexSessionTitles[codexSessionId];
        if (state.codexSessionTags) delete state.codexSessionTags[codexSessionId];
      } else {
        state.hiddenCodexSessions ||= {};
        state.hiddenCodexSessions[codexSessionId] = nowIso();
      }
      scheduleSave();
      const external = body.permanent === true ? null : await findCodexSession(codexSessionId);
      return json(res, 200, {
        ok: true,
        trashed: body.permanent !== true,
        deletedCodex,
        session: external ? publicExternalSession(external) : null
      });
    }

    const session = state.sessions[sessionId];
    if (!session) return json(res, 404, { error: 'session_not_found' });
    if (running.has(sessionId)) return json(res, 409, { error: 'session_running' });
    if (body.permanent !== true) {
      session.trashedAt = nowIso();
      session.updatedAt = session.trashedAt;
      scheduleSave();
      return json(res, 200, { ok: true, trashed: true, session: publicSession(session) });
    }
    let deletedCodex = false;
    if (body.deleteCodex === true && session.codexSessionId) {
      deletedCodex = await deleteCodexSessionFile(session.codexSessionId);
      if (state.codexSessionTitles) delete state.codexSessionTitles[session.codexSessionId];
      if (state.codexSessionTags) delete state.codexSessionTags[session.codexSessionId];
    }
    delete state.sessions[sessionId];
    await cleanupStorage('orphanUploads', { manual: true });
    scheduleSave();
    return json(res, 200, { ok: true, deletedCodex });
  }

  const sendMatch = url.pathname.match(/^\/api\/sessions\/([^/]+)\/messages$/);
  if (sendMatch && req.method === 'POST') {
    const session = state.sessions[decodeURIComponent(sendMatch[1])];
    if (!session) return json(res, 404, { error: 'session_not_found' });
    const body = await readJson(req, 80 * 1024 * 1024);
    const prompt = String(body.prompt || '').trim();
    if (isSecretarySession(session) && secretaryControl().killSwitch) {
      return json(res, 423, { error: 'secretary_stopped', message: '秘书总停止已启用，请先恢复。' });
    }
    const elevated = isSecretarySession(session) || body.elevated === true;
    const clientMessageId = String(body.clientMessageId || '').trim().slice(0, 120);
    const queueId = clientMessageId || randomUUID();
    const images = await savePromptImages(body.images || []);
    const files = await savePromptFiles(body.files || []);
    if (!prompt && !images.length && !files.length) return json(res, 400, { error: 'empty_prompt' });
    const displayPrompt = prompt || (images.length ? '请分析这些图片。' : '请分析这些文件。');
    const effectivePrompt = promptWithAttachments(displayPrompt, images, files);
    const userMessage = addMessage(session, {
      role: 'user',
      text: displayPrompt,
      elevated,
      clientMessageId,
      images,
      files,
      runState: running.has(session.id) ? 'queued' : 'submitted',
      delivery: running.has(session.id) ? 'queued' : 'submitted'
    });
    const run = createHarnessRun(session, {
      prompt: effectivePrompt,
      elevated,
      images,
      files,
      messageId: userMessage.id,
      clientMessageId,
      status: running.has(session.id) ? 'queued' : 'submitted'
    });
    userMessage.runId = run.id;
    broadcastEvent(session.id, 'message_update', userMessage);
    if (running.has(session.id)) {
      session.queue ||= [];
      session.queue.push({ id: queueId, runId: run.id, prompt: effectivePrompt, displayPrompt, elevated, images, files, createdAt: nowIso(), clientMessageId, messageId: userMessage.id });
      updateRunStatus(session, run.id, 'queued');
      auditSession(session, 'queue.added', { runId: run.id, messageId: userMessage.id, prompt: displayPrompt });
      session.updatedAt = nowIso();
      scheduleSave();
      return json(res, 202, { session: publicSession(session), queued: true });
    }
    try {
      runCodex(session, effectivePrompt, {
        runId: run.id,
        elevated,
        imagePaths: images.map((image) => image.path),
        images,
        files,
        messageId: userMessage.id,
        clientMessageId
      });
    } catch (error) {
      session.status = 'error';
      updateMessageRunState(session, userMessage.id, 'failed', { delivery: 'failed' });
      addMessage(session, { role: 'system', text: String(error.message || error), status: 'error' });
    }
    return json(res, 202, { session: publicSession(session) });
  }

  const queueMergeMatch = url.pathname.match(/^\/api\/sessions\/([^/]+)\/queue\/merge$/);
  if (queueMergeMatch && req.method === 'POST') {
    const session = state.sessions[decodeURIComponent(queueMergeMatch[1])];
    if (!session) return json(res, 404, { error: 'session_not_found' });
    const body = await readJson(req).catch(() => ({}));
    const merged = mergeQueuedItems(session, body.queueIds || body.ids || []);
    if (!merged) return json(res, 400, { error: 'queue_merge_needs_multiple_items', session: publicSession(session) });
    return json(res, 200, {
      ok: true,
      mergedCount: merged.mergedCount,
      session: publicSession(session),
      message: merged.primaryMessage
    });
  }

  const queueMatch = url.pathname.match(/^\/api\/sessions\/([^/]+)\/queue\/([^/]+)$/);
  if (queueMatch && req.method === 'PATCH') {
    const session = state.sessions[decodeURIComponent(queueMatch[1])];
    if (!session) return json(res, 404, { error: 'session_not_found' });
    const queueId = decodeURIComponent(queueMatch[2]);
    const index = (session.queue || []).findIndex((item) => item.id === queueId || item.clientMessageId === queueId);
    if (index < 0) return json(res, 404, { error: 'queue_item_not_found', session: publicSession(session) });
    const body = await readJson(req);
    const item = session.queue[index];
    let message = null;

    if (body.action === 'top' && index > 0) {
      session.queue.splice(index, 1);
      session.queue.unshift(item);
      auditSession(session, 'queue.topped', { runId: item.runId || '', messageId: item.messageId || '', summary: item.displayPrompt || item.prompt || '' });
    }

    if (typeof body.prompt === 'string') {
      const prompt = body.prompt.trim();
      if (!prompt) return json(res, 400, { error: 'empty_prompt' });
      item.prompt = promptWithAttachments(prompt, item.images || [], item.files || []);
      item.displayPrompt = prompt;
      const run = findRun(session, item.runId);
      if (run) {
        run.prompt = compactText(item.prompt, 12000);
        run.promptSummary = summarizeRunPrompt({ prompt });
        run.attachments = runAttachments(item.images || [], item.files || []);
        appendRunEvent(session, 'queue.edited', { summary: prompt }, { runId: run.id });
      }
      message = (session.messages || []).find((entry) => entry.id === item.messageId || entry.clientMessageId === item.clientMessageId);
      if (message) {
        message.text = prompt;
        message.pending = false;
        message.failed = false;
        message.runId = item.runId || message.runId;
        message.updatedAt = nowIso();
        messageStore.markSessionDirty(session.id);
        broadcastEvent(session.id, 'message_update', message);
      }
      auditSession(session, 'queue.edited', { runId: item.runId || '', messageId: item.messageId || '', prompt });
    }

    session.updatedAt = nowIso();
    scheduleSave();
    return json(res, 200, { ok: true, session: publicSession(session), message });
  }

  if (queueMatch && req.method === 'DELETE') {
    const session = state.sessions[decodeURIComponent(queueMatch[1])];
    if (!session) return json(res, 404, { error: 'session_not_found' });
    const queueId = decodeURIComponent(queueMatch[2]);
    const index = (session.queue || []).findIndex((item) => item.id === queueId || item.clientMessageId === queueId);
    if (index < 0) return json(res, 404, { error: 'queue_item_not_found', session: publicSession(session) });
    const [removed] = session.queue.splice(index, 1);
    updateMessageRunState(session, removed?.messageId || removed?.clientMessageId, 'stopped', { delivery: 'stopped' });
    updateRunStatus(session, removed?.runId || removed?.messageId || removed?.clientMessageId, 'stopped', {
      errorCode: 'queue_cancelled',
      errorSummary: 'Queued run was cancelled.'
    });
    auditSession(session, 'queue.cancelled', { runId: removed?.runId || '', messageId: removed?.messageId || '', summary: removed?.displayPrompt || removed?.prompt || '' });
    session.updatedAt = nowIso();
    scheduleSave();
    return json(res, 200, { ok: true, session: publicSession(session) });
  }

  const messageRetryMatch = url.pathname.match(/^\/api\/sessions\/([^/]+)\/messages\/([^/]+)\/retry$/);
  if (messageRetryMatch && req.method === 'POST') {
    const session = state.sessions[decodeURIComponent(messageRetryMatch[1])];
    if (!session) return json(res, 404, { error: 'session_not_found' });
    if (isSecretarySession(session) && secretaryControl().killSwitch) {
      return json(res, 423, { error: 'secretary_stopped', message: '秘书总停止已启用，请先恢复。' });
    }
    reconcileSessionRunState(session, 'retry');
    const messageId = decodeURIComponent(messageRetryMatch[2]);
    const message = (session.messages || []).find((item) => (
      item.id === messageId
      || item.clientMessageId === messageId
      || String(item.seq) === messageId
    ));
    if (!message || message.role !== 'user') return json(res, 404, { error: 'message_not_found' });
    if (!['failed', 'stopped', 'recovered'].includes(message.runState) && message.delivery !== 'failed' && message.failed !== true) {
      return json(res, 409, { error: 'message_not_retryable', session: publicSession(session) });
    }
    if (contextHealthFromUsage(session.lastCodexUsage).state === 'full') {
      return json(res, 409, {
        error: 'context_full',
        message: '当前 Codex 原生会话上下文已满，普通重试大概率继续失败。请新建干净会话或先压缩原生会话。',
        session: publicSession(session)
      });
    }
    const displayPrompt = String(message.text || '').trim()
      || ((message.images || []).length ? '请分析这些图片。' : '请分析这些文件。');
    const images = Array.isArray(message.images) ? message.images : [];
    const files = Array.isArray(message.files) ? message.files : [];
    const effectivePrompt = promptWithAttachments(displayPrompt, images, files);
    const retryId = randomUUID();
    const run = createHarnessRun(session, {
      prompt: effectivePrompt,
      elevated: message.elevated === true,
      images,
      files,
      messageId: message.id,
      clientMessageId: message.clientMessageId || '',
      status: running.has(session.id) ? 'queued' : 'submitted'
    });
    message.retryOf = message.retryOf || message.id || message.clientMessageId || '';
    message.failed = false;
    message.pending = false;
    message.runState = running.has(session.id) ? 'queued' : 'submitted';
    message.delivery = message.runState;
    message.runId = run.id;
    message.updatedAt = nowIso();
    messageStore.markSessionDirty(session.id);
    broadcastEvent(session.id, 'message_update', message);
    if (running.has(session.id)) {
      session.queue ||= [];
      session.queue.push({
        id: retryId,
        runId: run.id,
        prompt: effectivePrompt,
        displayPrompt,
        elevated: message.elevated === true,
        images,
        files,
        createdAt: nowIso(),
        clientMessageId: message.clientMessageId || '',
        messageId: message.id
      });
      updateRunStatus(session, run.id, 'queued');
      auditSession(session, 'queue.retry_added', { runId: run.id, messageId: message.id, prompt: displayPrompt });
      session.updatedAt = nowIso();
      scheduleSave();
      return json(res, 202, { ok: true, queued: true, session: publicSession(session), message });
    }
    try {
      runCodex(session, effectivePrompt, {
        runId: run.id,
        elevated: message.elevated === true,
        imagePaths: images.map((image) => image.path).filter(Boolean),
        images,
        files,
        messageId: message.id,
        clientMessageId: message.clientMessageId || ''
      });
    } catch (error) {
      session.status = 'error';
      updateMessageRunState(session, message.id, 'failed', { delivery: 'failed' });
      addMessage(session, { role: 'system', text: String(error.message || error), status: 'error' });
    }
    return json(res, 202, { ok: true, session: publicSession(session), message });
  }

  const messagePatchMatch = url.pathname.match(/^\/api\/sessions\/([^/]+)\/messages\/([^/]+)$/);
  if (messagePatchMatch && req.method === 'PATCH') {
    const session = state.sessions[decodeURIComponent(messagePatchMatch[1])];
    if (!session) return json(res, 404, { error: 'session_not_found' });
    const messageId = decodeURIComponent(messagePatchMatch[2]);
    const body = await readJson(req);
    const starred = body.starred === true;
    const message = (session.messages || []).find((item) => item.id === messageId || String(item.seq) === messageId);
    if (message) {
      message.starred = starred;
      messageStore.markSessionDirty(session.id);
    }
    state.starredMessages ||= {};
    if (starred) state.starredMessages[messageId] = true;
    else delete state.starredMessages[messageId];
    session.updatedAt = nowIso();
    scheduleSave();
    return json(res, 200, { ok: true, messageId, starred, session: publicSession(session) });
  }

  const stopMatch = url.pathname.match(/^\/api\/sessions\/([^/]+)\/stop$/);
  if (stopMatch && req.method === 'POST') {
    const session = state.sessions[decodeURIComponent(stopMatch[1])];
    if (!session) return json(res, 404, { error: 'session_not_found' });
    reconcileSessionRunState(session, 'stop');
    const stopped = stopRunningSession(session);
    return json(res, 200, { ok: true, stopped, session: publicSession(session) });
  }

  json(res, 404, { error: 'not_found' });
}

function handleEvents(req, res, url) {
  const auth = requireAuth(req, res);
  if (!auth) return;
  const sessionId = url.searchParams.get('sessionId');
  const session = state.sessions[sessionId];
  if (!session) return json(res, 404, { error: 'session_not_found' });

  const after = Number(url.searchParams.get('after') || 0);
  res.writeHead(200, {
    'content-type': 'text/event-stream; charset=utf-8',
    'cache-control': 'no-store',
    'connection': 'keep-alive'
  });
  sendSse(res, 'hello', { sessionId, session: publicSession(session), view: sessionView(session), now: nowIso() });
  for (const message of session.messages || []) {
    if (message.seq > after) sendSse(res, 'message', message);
  }

  let set = clients.get(sessionId);
  if (!set) {
    set = new Set();
    clients.set(sessionId, set);
  }
  set.add(res);
  const ping = setInterval(() => sendSse(res, 'ping', { now: nowIso() }), 25000);
  const cleanup = () => {
    clearInterval(ping);
    set.delete(res);
    if (set.size === 0) clients.delete(sessionId);
  };
  res.on('error', cleanup);
  res.on('close', cleanup);
  req.on('close', cleanup);
}

const server = http.createServer((req, res) => {
  totalRequests += 1;
  activeRequests += 1;
  let counted = true;
  const finishRequest = () => {
    if (!counted) return;
    counted = false;
    activeRequests = Math.max(0, activeRequests - 1);
  };
  res.on('finish', finishRequest);
  res.on('close', finishRequest);

  const url = new URL(req.url, `http://${req.headers.host || `${HOST}:${PORT}`}`);
  if (req.method === 'OPTIONS') {
    res.writeHead(204, {
      'access-control-allow-methods': 'GET,POST,OPTIONS',
      'access-control-allow-headers': 'content-type'
    });
    res.end();
    return;
  }

  if (url.pathname === '/api/events') return handleEvents(req, res, url);
  if (url.pathname.startsWith('/sites/')) {
    serveSiteMount(req, res, url).catch((error) => json(res, 500, { error: 'internal', message: String(error.message || error) }));
    return;
  }
  if (url.pathname.startsWith('/api/')) {
    handleApi(req, res, url).catch((error) => json(res, 500, { error: 'internal', message: String(error.message || error) }));
    return;
  }

  serveStatic(req, res, url.pathname).catch((error) => json(res, 500, { error: 'internal', message: String(error.message || error) }));
});

await init();
server.listen(PORT, HOST, () => {
  console.log(`codex-mobile-console listening on http://${HOST}:${PORT}`);
});

function stopAcceptingHttp() {
  server.close(() => {});
  for (const responses of clients.values()) {
    for (const response of responses) {
      if (!response.writableEnded) response.end();
    }
  }
  clients.clear();
}

async function waitForRequestsToSettle(timeoutMs = 2000) {
  const deadline = Date.now() + timeoutMs;
  while (activeRequests > 0 && Date.now() < deadline) {
    await new Promise((resolve) => setTimeout(resolve, 25));
  }
}

async function shutdown(signal) {
  if (shuttingDown) return;
  shuttingDown = true;
  try {
    stopAcceptingHttp();
    await waitForRequestsToSettle();
    await prepareForShutdown(signal.toLowerCase());
  } catch (error) {
    console.error(error);
  } finally {
    process.exit(0);
  }
}

process.on('SIGTERM', () => {
  shutdown('SIGTERM');
});
process.on('SIGINT', () => {
  shutdown('SIGINT');
});