@24klynx/cli 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,970 @@
+import { Database, LynxPaths } from "@lynx/core";
+import { SessionManager } from "@lynx/session";
+import { ToolRegistry } from "@lynx/tools";
+import { HookRegistry, ManifestRegistry, PluginLoader, PredictiveLoader } from "@lynx/plugins";
+import { AgentConfig, McpManager, McpServerConfig, MemoryManager, QueryEngine, SkillDefinition, SkillRegistry } from "@lynx/agent";
+import { RuleEngine } from "@lynx/permissions";
+import { ChannelRegistry, FeishuConfig } from "@lynx/channels";
+import { Command } from "commander";
+import { LlmProvider } from "@lynx/llm";
+import { EventEmitter } from "node:events";
+
+//#region src/bootstrap.d.ts
+/** Bridge between the agent engine's permission checks and the TUI's permission dialog. */
+interface PermissionBridge {
+  /**
+   * Called by the agent engine before executing a tool.
+   * Returns true if the tool is allowed, false if denied.
+   * May await user interaction via the TUI dialog.
+   */
+  requestPermission(toolName: string, safety: "Safe" | "WorkspaceSafe" | "RequiresApproval" | "Dangerous", description: string): Promise<boolean>;
+  /**
+   * Called by the TUI's onPermissionReply callback.
+   * Resolves the pending permission Promise.
+   */
+  handleReply(requestId: string, approved: boolean): void;
+  /**
+   * Called by the TUI after mount to register the dialog trigger.
+   * The handler pushes a permission view onto the TUI stack.
+   */
+  setTuiHandler(handler: ((req: {
+    requestId: string;
+    toolName: string;
+    description: string;
+    safety: "Safe" | "WorkspaceSafe" | "RequiresApproval" | "Dangerous";
+  }) => void) | null): void;
+}
+interface AppContext {
+  db: Database;
+  sessionMgr: SessionManager;
+  toolRegistry: ToolRegistry;
+  pluginRegistry: {
+    manifestRegistry: ManifestRegistry;
+    loader: PluginLoader;
+    hooks: HookRegistry;
+  };
+  ruleEngine: RuleEngine;
+  engine: QueryEngine;
+  provider: LlmProvider;
+  /** Mutable agent config — model can be changed at runtime without recreating the engine. */
+  agentConfig: AgentConfig;
+  /** Permission bridge for tool approval flow. */
+  permissionBridge: PermissionBridge;
+  /** Skill registry for progressive disclosure (built‑in + user skills). */
+  skillRegistry: SkillRegistry;
+  /** Current skill definitions for prompt injection. */
+  skills: SkillDefinition[];
+  /** MCP connection manager for external tool servers. */
+  mcpManager: McpManager;
+  /** Predictive loader — pre‑warms plugin modules during idle time. */
+  predictiveLoader: PredictiveLoader;
+  /** Channel registry — manages messaging channel adapters (飞书 etc.). */
+  channelRegistry: ChannelRegistry;
+  /** Memory manager for persistent cross-session recall. */
+  memoryManager: MemoryManager;
+  /** Persistent memory facts loaded from disk. */
+  memoryFacts: string[];
+  /** Textual rules loaded from disk for prompt injection. */
+  rules: string[];
+  /** Destroy all resources (close DB, stop timers, etc.). */
+  destroy(): void;
+}
+interface BootstrapConfig {
+  homeDir: string;
+  provider: LlmProvider;
+  model: string;
+  /** Workspace directory (defaults to cwd). Used for loading project-level memory/rules/skills. */
+  workspace?: string;
+  /** Path to built‑in skills directory (SKILL.md files). */
+  skillsDir?: string;
+  /** MCP server configurations to connect on startup. */
+  mcpServers?: McpServerConfig[];
+  /** 飞书 channel configuration (optional — channel not created if omitted). */
+  feishu?: FeishuConfig;
+}
+/**
+ * Bootstrap the entire Lynx application.
+ *
+ * This is the ONLY place where cross‑package wiring happens.
+ * Every other module only talks to its immediate dependencies
+ * through explicit factory‑injected interfaces.
+ */
+declare function bootstrap(config: BootstrapConfig): AppContext;
+//#endregion
+//#region src/args.d.ts
+/** Create the full CLI program with all sub‑commands registered. */
+declare function createProgram(): Command;
+/** Parse argv and run the matching command. */
+declare function runCli(argv?: string[]): Promise<void>;
+//#endregion
+//#region src/startup.d.ts
+interface Phase1Result {
+  paths: LynxPaths;
+  db: Database;
+  /** Wall‑clock ms for Phase 1. */
+  elapsedMs: number;
+}
+interface StartupResult extends Phase1Result {
+  /** Wall‑clock ms for Phase 2. */
+  phase2ElapsedMs: number;
+}
+/** Result of a single Phase 2 background task. */
+interface Phase2TaskResult {
+  name: string;
+  ok: boolean;
+  error?: string;
+  elapsedMs: number;
+}
+/**
+ * Run Phase 1 — blocking startup that must finish before
+ * the user sees anything useful.
+ *
+ * Returns a database handle the rest of the app can use.
+ */
+declare function runPhase1(): Phase1Result;
+/**
+ * Run Phase 2 — background work that executes after the TUI is rendered.
+ *
+ * Tasks run sequentially with a setImmediate gap between each so the
+ * event loop stays responsive. Each task is independently try‑catched
+ * so a single failure doesn't block the rest.
+ *
+ * Returns the elapsed time in ms.
+ */
+declare function runPhase2(result: Phase1Result): Promise<Phase2TaskResult[]>;
+//#endregion
+//#region src/catalog.d.ts
+/**
+ * CommandCatalog — structured command registration with
+ * per‑command policy (permission mode, tool visibility, etc.).
+ *
+ * Each command is registered with a name, handler, and a set
+ * of policies that control how the agent behaves while executing
+ * that command.
+ */
+interface CommandPolicy {
+  /** Permission mode for this command. */
+  permissionMode: "default" | "auto" | "yolo" | "headless" | "plan";
+  /** Which tools are visible when this command runs. */
+  allowedTools?: string[];
+  /** Can this command modify files? */
+  allowWrites: boolean;
+}
+interface CommandEntry {
+  name: string;
+  description: string;
+  policy: CommandPolicy;
+  /** Lazily‑loaded handler module path. */
+  handlerPath: string;
+}
+/** The master list of registered commands. */
+declare const CATALOG: CommandEntry[];
+/** Look up a command by name. */
+declare function findCommand(name: string): CommandEntry | undefined;
+//#endregion
+//#region src/debug.d.ts
+/**
+ * Debug logging infrastructure — writes structured JSONL logs
+ * to disk for post‑mortem analysis.
+ *
+ * Uses pino for formatting and rotation. Production logs are
+ * JSONL with daily rotation; development uses pino‑pretty.
+ */
+type LogLevel = "trace" | "debug" | "info" | "warn" | "error";
+interface DebugLogger {
+  trace(msg: string, data?: unknown): void;
+  debug(msg: string, data?: unknown): void;
+  info(msg: string, data?: unknown): void;
+  warn(msg: string, data?: unknown): void;
+  error(msg: string, data?: unknown): void;
+}
+/**
+ * Create a file‑based debug logger.
+ *
+ * @param logDir Directory for log files (defaults to ~/.lynx/logs).
+ * @param minLevel Minimum level to emit.
+ */
+declare function createDebugLogger(logDir: string, minLevel?: LogLevel): DebugLogger;
+//#endregion
+//#region src/doctor/runner.d.ts
+/**
+ * Doctor — system health checks.
+ *
+ * Runs a series of diagnostic checks and prints a report.
+ * Each check returns pass/fail with an optional detail message.
+ */
+interface CheckResult {
+  name: string;
+  passed: boolean;
+  detail?: string;
+}
+interface DoctorReport {
+  checks: CheckResult[];
+  allPassed: boolean;
+}
+/** Run all health checks and return the report. */
+declare function runChecks(): DoctorReport;
+/** Print the doctor report to stdout. */
+declare function printReport(report: DoctorReport): void;
+/** Entry point for the `lynx doctor` command. */
+declare function runDoctor(): Promise<void>;
+//#endregion
+//#region src/crestodian/runner.d.ts
+/**
+ * Crestodian — non‑interactive LLM query mode.
+ *
+ * Takes a message from CLI args, sends it to the LLM provider,
+ * and prints the response to stdout. No TUI, no interaction.
+ *
+ * This is the `node lynx.mjs crestodian --message "..."` path.
+ */
+/**
+ * Run a non‑interactive query against the LLM.
+ *
+ * Reads API keys from environment variables (DEEPSEEK_API_KEY
+ * or OPENAI_API_KEY) and streams the response to stdout.
+ */
+declare function runCrestodian(message: string, _model?: string): Promise<void>;
+//#endregion
+//#region src/commands/session.d.ts
+/**
+ * Session command — list, resume, fork, and delete sessions
+ * from the command line.
+ *
+ * Uses SessionManager for persistence and SessionPicker for
+ * interactive selection when no ID is provided.
+ */
+interface SessionCommandOptions {
+  action: string;
+  id?: string;
+  label?: string;
+}
+/** Handle the `lynx sessions` command. */
+declare function handleSessionCommand(opts: SessionCommandOptions): Promise<void>;
+//#endregion
+//#region src/commands/config.d.ts
+interface ConfigCommandOptions {
+  show?: boolean;
+  set?: string;
+  value?: string;
+  path?: boolean;
+}
+/** 处理 `lynx config` 命令。 */
+declare function handleConfigCommand(opts: ConfigCommandOptions): Promise<void>;
+//#endregion
+//#region src/entry.d.ts
+/**
+ * Unified entry point — the first code that runs after `lynx.mjs`.
+ *
+ * Responsibilities:
+ *   1. Version check (bail early if Node.js < 22.19).
+ *   2. Parse CLI args and route to the correct handler.
+ *   3. For interactive mode: bootstrap services + launch TUI.
+ *   4. For sub‑commands: lazily import the handler.
+ *
+ * This file intentionally avoids importing heavy modules
+ * (Ink, provider implementations) at the top level so that
+ * `lynx --version` returns in < 100 ms.
+ */
+/** Main entry point. Invoked from `lynx.mjs`. */
+declare function main(argv?: string[]): Promise<void>;
+//#endregion
+//#region src/tui-launcher.d.ts
+/**
+ * TUI launcher — boots the application and renders the Ink UI.
+ *
+ * This module is lazily loaded only when the user enters
+ * interactive mode (no sub‑command given).
+ */
+/**
+ * Launch the interactive TUI.
+ *
+ * Phase 1: bootstrap services (DB, sessions, tools, agent engine).
+ * Phase 2: render the Ink TUI.
+ */
+declare function launchTui(): Promise<void>;
+//#endregion
+//#region src/process-lifecycle.d.ts
+interface LifecycleConfig {
+  /** AppContext for graceful cleanup. */
+  ctx: AppContext;
+  /** Callback to abort the current LLM request. */
+  onAbortLl: () => void;
+  /** Callback to abort the current tool execution. */
+  onAbortTool: () => void;
+  /** Current abort layer counter (0‑3). Gets incremented by SIGINT. */
+  getAbortLayer: () => number;
+  /** Increment and return the next abort layer. */
+  incrementAbortLayer: () => number;
+  /** Reset abort layer counter. */
+  resetAbortLayer: () => void;
+  /** Whether the TUI is currently streaming (in an active turn). */
+  isStreaming: () => boolean;
+}
+/**
+ * Install process lifecycle handlers.
+ *
+ * Only call once. Subsequent calls are no‑ops.
+ * Handles SIGINT (3‑layer abort), SIGTERM (graceful shutdown),
+ * SIGHUP (graceful shutdown), and terminal loss.
+ */
+declare function installProcessLifecycle(config: LifecycleConfig): void;
+/**
+ * Register a cleanup handler that runs during graceful shutdown.
+ * Replaces any previously registered handler.
+ */
+declare function onCleanup(handler: () => void): void;
+/**
+ * Remove all process lifecycle handlers (for testing).
+ */
+declare function uninstallProcessLifecycle(): void;
+//#endregion
+//#region src/terminal-mode.d.ts
+/**
+ * Terminal mode management — alt buffer, mouse tracking, DEC sync.
+ *
+ * Provides functions to enter/exit the alternate screen buffer,
+ * enable/disable mouse tracking, and wrap output with DEC
+ * Synchronized Update markers for flicker‑free rendering.
+ *
+ * All escape sequences are no‑ops on unsupported terminals
+ * (graceful degradation).
+ */
+/** Enter fullscreen mode: alt buffer only (no mouse tracking). */
+declare function enterFullscreen(): void;
+/** Exit fullscreen mode: restore main buffer. */
+declare function exitFullscreen(): void;
+declare function beginSync(): void;
+declare function endSync(): void;
+/**
+ * Execute a callback within a DEC synchronized update region.
+ * Exceptions propagate; sync is always ended.
+ */
+declare function withSync<T>(fn: () => T): T;
+//#endregion
+//#region src/worker-pool.d.ts
+/**
+ * WorkerPool — bounded thread pool for CPU‑bound tasks.
+ *
+ * Manages a fixed number of worker threads (2‑8) with a FIFO task
+ * queue. All workers share the same worker script; tasks differ
+ * only by their postMessage payload.
+ *
+ * Design:
+ *   - Fixed pool size, configurable at creation time
+ *   - FIFO queue — tasks are executed in submission order
+ *   - Auto‑restart — crashed workers replaced up to maxRetries times
+ *   - Idle shrink — workers idle for > 30s are terminated (min 2 kept)
+ *   - Graceful shutdown — drain remaining tasks before exit
+ */
+/** A unit of work submitted to the pool. */
+interface PoolTask<T = unknown> {
+  /** Unique task identifier. */
+  id: string;
+  /** Data passed to the worker via postMessage. */
+  workerData?: T;
+  /** Resolve the task with the worker's result. */
+  resolve: (result: unknown) => void;
+  /** Reject the task on failure. */
+  reject: (error: Error) => void;
+  /** Number of times this task has been retried after worker crash. */
+  retries: number;
+}
+/** Configuration for the worker pool. */
+interface WorkerPoolConfig {
+  /** Path to the worker script that all workers execute. */
+  workerScript: string | URL;
+  /** Number of workers in the pool (clamped to 2‑8). Default: 2. */
+  size?: number;
+  /** Max restarts per worker before the pool rejects queued tasks. Default: 3. */
+  maxRetries?: number;
+  /** Idle timeout in ms before shrinking a worker. Default: 30_000. */
+  idleTimeoutMs?: number;
+}
+/** Status of the worker pool for introspection. */
+interface PoolStatus {
+  size: number;
+  active: number;
+  idle: number;
+  queued: number;
+  totalRestarts: number;
+}
+/**
+ * Bounded worker thread pool.
+ *
+ * Usage:
+ * ```ts
+ * const pool = new WorkerPool({ workerScript: "./heavy-task.js", size: 4 });
+ * const result = await pool.enqueue({ input: 42 });
+ * await pool.shutdown();
+ * ```
+ */
+declare class WorkerPool {
+  private config;
+  private workerScript;
+  private queue;
+  private workers;
+  private runningTasks;
+  private nextWorkerId;
+  private destroyed;
+  private totalRestarts;
+  constructor(config: WorkerPoolConfig);
+  /**
+   * Enqueue a task for execution.
+   *
+   * Returns a Promise that resolves with the worker's result
+   * or rejects if the pool is destroyed.
+   */
+  enqueue<TResult = unknown>(data?: unknown): Promise<TResult>;
+  /** Current pool status for monitoring. */
+  status(): PoolStatus;
+  /**
+   * Gracefully shut down the pool.
+   *
+   * Waits for active tasks to finish, then terminates all workers.
+   * Queued tasks that haven't started are rejected.
+   */
+  shutdown(): Promise<void>;
+  /** Spawn a new worker thread. */
+  private spawnWorker;
+  /** Replace a crashed worker and re-queue or reject its active task. */
+  private handleWorkerCrash;
+  /** Try to dequeue and execute pending tasks. */
+  private drain;
+  /** Execute a single task on a worker. */
+  private runTask;
+  /** Start or reset the idle timer for a worker. */
+  private startIdleTimer;
+  /** Attempt to shrink idle workers if above minimum. */
+  private maybeShrink;
+  /** Terminate a specific idle worker. */
+  private shrinkWorker;
+}
+//#endregion
+//#region src/memory-monitor.d.ts
+/** Alert severity levels. */
+type MemoryAlertLevel = "warn" | "danger" | "fatal";
+/** A memory alert event. */
+interface MemoryAlert {
+  level: MemoryAlertLevel;
+  /** Current heap usage in bytes. */
+  heapUsed: number;
+  /** Heap usage as percentage of configured threshold. */
+  percentage: number;
+  /** Threshold that was breached in bytes. */
+  threshold: number;
+  /** ISO timestamp of the sample. */
+  timestamp: string;
+}
+/** Configuration for the memory monitor. */
+interface MemoryMonitorConfig {
+  /** Sampling interval in ms. Default: 30_000. */
+  intervalMs?: number;
+  /** Warn threshold in bytes. Default: 700 * 1024 * 1024. */
+  warnThreshold?: number;
+  /** Danger threshold in bytes. Default: 900 * 1024 * 1024. */
+  dangerThreshold?: number;
+  /** Fatal threshold in bytes. Default: 950 * 1024 * 1024. */
+  fatalThreshold?: number;
+}
+/** Current memory snapshot. */
+interface MemorySnapshot {
+  heapUsed: number;
+  heapTotal: number;
+  external: number;
+  rss: number;
+  timestamp: string;
+}
+/**
+ * Proactive heap monitor with three‑level alerting.
+ *
+ * Usage:
+ * ```ts
+ * const monitor = new MemoryMonitor({ intervalMs: 30_000 });
+ * monitor.on("alert", (alert) => {
+ *   if (alert.level === "fatal") console.error("OOM imminent!");
+ * });
+ * monitor.start();
+ * ```
+ */
+declare class MemoryMonitor extends EventEmitter {
+  private config;
+  private timer;
+  private running;
+  /** Track the last alert level to avoid repeated warnings. */
+  private lastAlertLevel;
+  constructor(config?: MemoryMonitorConfig);
+  /** Emitted when a memory alert is triggered. */
+  onAlert(listener: (alert: MemoryAlert) => void): this;
+  /** Emitted on each sample (for dashboards). */
+  onSample(listener: (snapshot: MemorySnapshot) => void): this;
+  /** Emitted when compaction is requested. */
+  onCompact(listener: (info: {
+    reason: string;
+    heapUsed: number;
+  }) => void): this;
+  /** Emitted when caches should be flushed. */
+  onFlushCaches(listener: (info: {
+    reason: string;
+    heapUsed: number;
+  }) => void): this;
+  /** Start periodic heap sampling. No‑op if already running. */
+  start(): void;
+  /** Stop periodic sampling. */
+  stop(): void;
+  /** Take a manual snapshot and return it. */
+  snapshot(): MemorySnapshot;
+  /** Sample heap usage and fire alerts if thresholds are breached. */
+  private sample;
+  /** Execute the appropriate action for each alert level. */
+  private actOnAlert;
+  /** Trigger V8 garbage collection if --expose-gc is enabled. */
+  private triggerGc;
+}
+//#endregion
+//#region src/update-check.d.ts
+/**
+ * UpdateChecker — asynchronous, non‑blocking version check.
+ *
+ * Queries npm and GitHub for the latest Lynx release and compares
+ * against the running version. Designed to never block startup:
+ * the check runs in the background and fires a callback when
+ * complete.
+ *
+ * Design (§5.9k):
+ *   - Async, non‑blocking — fire and forget
+ *   - O_EXCL lock — only one check runs at a time per process
+ *   - Dual channel: npm registry + GitHub releases
+ *   - GitHub as fallback when npm is slow or unreachable
+ *   - Result cached for the session lifetime
+ *   - Respects NO_UPDATE_CHECK env var
+ */
+/** Result of an update check. */
+interface UpdateResult {
+  /** Current installed version. */
+  current: string;
+  /** Latest available version, or null if unknown. */
+  latest: string | null;
+  /** Whether a newer version is available. */
+  hasUpdate: boolean;
+  /** Release notes URL for the latest version. */
+  releaseUrl: string | null;
+  /** Time the check was performed (ISO string). */
+  checkedAt: string;
+  /** Which channel provided the result. */
+  source: "npm" | "github" | "cache" | "error";
+  /** Error message if the check failed. */
+  error?: string;
+}
+/** Configuration for the update checker. */
+interface UpdateCheckConfig {
+  /** Current version string (e.g. "0.1.0"). */
+  currentVersion: string;
+  /** npm package name. Default: "lynx". */
+  packageName?: string;
+  /** GitHub repository in "owner/repo" format. Default: "loongcrown/lynx". */
+  githubRepo?: string;
+  /** Timeout per request in ms. Default: 5_000. */
+  timeoutMs?: number;
+  /** Cache duration in ms. Default: 3_600_000 (1 hour). */
+  cacheTtlMs?: number;
+}
+/**
+ * Check for updates asynchronously.
+ *
+ * Only one check runs at a time — concurrent calls return the
+ * same Promise. Results are cached for the configured TTL.
+ *
+ * Callers should never await this at startup — fire‑and‑forget
+ * and read the result from the cache on next call.
+ */
+declare function checkForUpdates(config: UpdateCheckConfig): Promise<UpdateResult>;
+/**
+ * Synchronously return the last cached update result.
+ * Returns null if no check has been performed yet.
+ */
+declare function getLastUpdateResult(): UpdateResult | null;
+/**
+ * Clear the cached update result (for testing).
+ */
+declare function clearUpdateCache(): void;
+//#endregion
+//#region src/commands/plugin.d.ts
+/**
+ * Plugin command — manage installed plugins.
+ *
+ * Sub‑commands:
+ *   list              — list installed plugins with status
+ *   enable <name>     — enable a disabled plugin
+ *   disable <name>    — disable a plugin (without uninstalling)
+ *   install <path>    — install a plugin from a local path
+ *   remove <name>     — uninstall a plugin
+ */
+interface PluginCommandOptions {
+  list?: boolean;
+  enable?: string;
+  disable?: string;
+  install?: string;
+  remove?: string;
+}
+/** Handle the `lynx plugin` command. */
+declare function handlePluginCommand(opts: PluginCommandOptions): Promise<void>;
+//#endregion
+//#region src/commands/git-commit.d.ts
+/**
+ * /commit 命令 — 创建 Git 提交并推送。
+ *
+ * 生成中文指令，引导模型执行完整的提交工作流：
+ *   1. 检查工作区状态和变更摘要
+ *   2. 基于用户消息（或自动生成）创建约定式提交
+ *   3. git add → git commit → git push
+ *   4. --all 标志表示暂存所有变更
+ */
+interface CommitCommandArgs {
+  /** 用户自定义的提交消息（可选，省略时自动生成）。 */
+  message?: string;
+  /** 是否暂存所有变更（git add -A）。 */
+  all?: boolean;
+}
+/**
+ * 处理 /commit 命令，返回一段中文指令引导模型完成提交。
+ */
+declare function handleCommitCommand(args: CommitCommandArgs): {
+  instruction: string;
+};
+//#endregion
+//#region src/commands/git-review.d.ts
+/**
+ * /review 命令 — 审查 GitHub Pull Request。
+ *
+ * 生成中文指令，引导模型获取 PR 变更并给出结构化审查意见：
+ *   1. 获取 PR 信息（列表或详情）
+ *   2. 获取 PR diff 内容
+ *   3. 系统化分析：bug、风格、测试、安全
+ *   4. 输出结构化审查报告
+ */
+interface ReviewCommandArgs {
+  /** PR 编号（可选，省略时列出所有待审查的 PR）。 */
+  number?: number;
+  /** 目标分支（用于 gh pr list 的 --base 过滤）。 */
+  base?: string;
+}
+/**
+ * 处理 /review 命令，返回一段中文指令引导模型完成代码审查。
+ */
+declare function handleReviewCommand(args: ReviewCommandArgs): {
+  instruction: string;
+};
+//#endregion
+//#region src/commands/git-pr-comments.d.ts
+/**
+ * /pr-comments 命令 — 处理 PR 审查评论。
+ *
+ * 生成中文指令，引导模型：
+ *   1. 获取 PR 所有评论
+ *   2. 处理未解决的评论（修改代码）
+ *   3. 回复已解决的评论（确认）
+ */
+interface PrCommentsCommandArgs {
+  /** PR 编号（可选，省略时从最近 PR 推断）。 */
+  number?: number;
+}
+/**
+ * 处理 /pr-comments 命令，返回一段中文指令引导模型处理 PR 评论。
+ */
+declare function handlePrCommentsCommand(args: PrCommentsCommandArgs): {
+  instruction: string;
+};
+//#endregion
+//#region src/commands/git-issue.d.ts
+/**
+ * /issue 命令 — 管理 GitHub Issue。
+ *
+ * 生成中文指令，引导模型执行 Issue 操作：
+ *   create — 创建新 Issue
+ *   list   — 列出仓库 Issue
+ *   view   — 查看指定 Issue 详情
+ */
+interface IssueCommandArgs {
+  /** 操作类型：create 创建、list 列出、view 查看。 */
+  action?: "create" | "list" | "view";
+  /** Issue 标题（create 时使用）。 */
+  title?: string;
+  /** Issue 编号（view 时使用）。 */
+  number?: number;
+}
+/**
+ * 处理 /issue 命令，返回一段中文指令引导模型完成 Issue 操作。
+ */
+declare function handleIssueCommand(args: IssueCommandArgs): {
+  instruction: string;
+};
+//#endregion
+//#region src/commands/git-autofix.d.ts
+/**
+ * /autofix-pr 命令 — 自动修复 PR 问题。
+ *
+ * ⚠️ 功能正在开发中，当前为占位实现。
+ * 后续将与 gh cli 集成，实现自动分析 PR 失败检查并生成修复方案。
+ */
+interface AutoFixCommandArgs {
+  /** PR 编号（可选）。 */
+  number?: number;
+  /** 要修复的问题描述（可选）。 */
+  issue?: string;
+}
+/**
+ * 处理 /autofix-pr 命令。
+ *
+ * 当前为占位实现，返回开发中提示信息。
+ * 后续将实现完整的自动修复管线。
+ */
+declare function handleAutoFixCommand(_args: AutoFixCommandArgs): {
+  instruction: string;
+};
+//#endregion
+//#region src/commands/git-diff.d.ts
+/**
+ * /diff 命令 — 展示 Git 工作区变更。
+ *
+ * 生成中文指令，引导模型：
+ *   1. 运行 git diff 获取未暂存变更
+ *   2. 运行 git diff --staged 获取已暂存变更
+ *   3. 以结构化格式展示，高亮关键变更
+ */
+interface DiffCommandArgs {
+  /** 是否仅显示已暂存的变更（git diff --staged）。 */
+  staged?: boolean;
+  /** 指定要查看 diff 的文件列表（可选）。 */
+  files?: string[];
+}
+/**
+ * 处理 /diff 命令，返回一段中文指令引导模型展示代码变更。
+ */
+declare function handleDiffCommand(args: DiffCommandArgs): {
+  instruction: string;
+};
+//#endregion
+//#region src/commands/ant-trace.d.ts
+/**
+ * /ant-trace — 工具调用链追踪可视化。
+ *
+ * 返回 model instruction，指示模型从会话历史中提取 tool_use / tool_result 配对，
+ * 构建父子调用树并标注耗时与错误。TUI 层用 local-jsx 渲染为可折叠树形组件。
+ *
+ * 用法：/ant-trace [--session <id>]  默认追踪当前会话。
+ */
+interface AntTraceOptions {
+  /** 可选：要追踪的会话 ID，默认当前会话。 */
+  sessionId?: string;
+}
+/**
+ * 处理 /ant-trace 命令。
+ *
+ * 返回一条 model instruction，驱动模型检查会话历史中的
+ * 工具调用链并生成结构化诊断输出。
+ */
+declare function handleAntTraceCommand(opts: AntTraceOptions): {
+  instruction: string;
+};
+//#endregion
+//#region src/commands/debug-tool-call.d.ts
+/**
+ * /debug-tool-call — 单步工具调用调试器。
+ *
+ * 用于排查单个工具调用的输入、输出、错误和耗时细分。
+ * 支持按工具名称或步骤索引定位调用，不带参数时列出最近的调用概览。
+ *
+ * 用法：
+ *   /debug-tool-call                     列出最近调用
+ *   /debug-tool-call --tool <name>        查看指定工具的最后一次调用
+ *   /debug-tool-call --step <index>       查看指定步骤索引处的工具调用
+ */
+interface DebugToolCallOptions {
+  /** 按工具名称过滤，查看该工具的最后一次调用详情。 */
+  tool?: string;
+  /** 按步骤索引定位（从 1 开始），查看该步骤的工具调用。 */
+  step?: string;
+}
+/**
+ * 处理 /debug-tool-call 命令。
+ *
+ * 返回一条 model instruction，驱动模型检查会话历史中的
+ * 工具调用并输出调试信息。
+ */
+declare function handleDebugToolCall(opts: DebugToolCallOptions): {
+  instruction: string;
+};
+//#endregion
+//#region src/commands/tasks.d.ts
+/**
+ * /tasks — 后台任务监视与控制。
+ *
+ * 列出当前后台任务状态，支持取消运行中的任务和查看任务详情。
+ * 该命令与 TUI 层的 TasksPanel 组件配合使用：
+ *   - list：打开任务面板，展示实时状态（带色彩编码）
+ *   - cancel：通过 taskId 取消指定任务
+ *   - detail：展示任务的完整输出流
+ *
+ * 用法：
+ *   /tasks                   列出所有任务（默认）
+ *   /tasks --action cancel --taskId <id>   取消任务
+ *   /tasks --action detail --taskId <id>   查看任务详情
+ */
+interface TasksCommandOptions {
+  /** 操作类型：list（默认）、cancel、detail。 */
+  action?: string;
+  /** cancel 或 detail 操作时必填。 */
+  taskId?: string;
+}
+/**
+ * 处理 /tasks 命令。
+ *
+ * 根据 action 返回不同的 model instruction，驱动模型
+ * 执行相应的任务管理操作。
+ */
+declare function handleTasksCommand(opts: TasksCommandOptions): {
+  instruction: string;
+};
+//#endregion
+//#region src/commands/heapdump.d.ts
+/**
+ * /heapdump — V8 堆快照，用于内存泄漏诊断。
+ *
+ * 调用 Node.js 内置的 writeHeapSnapshot() 生成 .heapsnapshot 文件，
+ * 保存到 ~/.lynx/heapdumps/ 目录下。可在 Chrome DevTools 的
+ * Memory 面板中加载分析。
+ *
+ * 用法：/heapdump
+ */
+/**
+ * 处理 /heapdump 命令。
+ *
+ * 生成立即堆快照并返回文件路径。这是 local 类型命令——
+ * 不经过模型，直接在 CLI 进程中执行。
+ */
+declare function handleHeapdumpCommand(): Promise<{
+  output: string;
+}>;
+//#endregion
+//#region src/commands/perf-issue.d.ts
+/**
+ * /perf-issue — 性能问题诊断。
+ *
+ * 返回 model instruction，驱动模型分析性能问题、检查日志、
+ * 筛查慢调用和内存使用模式，并给出优化建议。
+ *
+ * 用法：
+ *   /perf-issue                      通用性能健康检查
+ *   /perf-issue --issue <描述>        针对具体问题的诊断
+ */
+interface PerfIssueOptions {
+  /** 可选：用户描述的具体性能问题。不提供则执行通用健康检查。 */
+  issue?: string;
+}
+/**
+ * 处理 /perf-issue 命令。
+ *
+ * 返回 model instruction，驱动模型执行性能诊断分析。
+ */
+declare function handlePerfIssueCommand(opts: PerfIssueOptions): {
+  instruction: string;
+};
+//#endregion
+//#region src/commands/share.d.ts
+/**
+ * /share — 将会话导出为可分享的 Markdown 文件。
+ *
+ * 从 ~/.lynx/sessions/{sessionId}.json 读取消息，
+ * 格式化为干净的 Markdown 后写入 ~/.lynx/exports/ 目录。
+ */
+interface ShareCommandOptions {
+  sessionId?: string;
+  output?: string;
+}
+/**
+ * 处理 /share 命令。
+ *
+ * 将会话消息导出为 Markdown 文件，方便分享。
+ * 默认导出最近一次会话，可通过 --session-id 指定。
+ */
+declare function handleShareCommand(opts: ShareCommandOptions): Promise<{
+  output: string;
+}>;
+//#endregion
+//#region src/commands/export.d.ts
+/**
+ * /export — 以多种格式导出会话。
+ *
+ * 支持三种输出格式：
+ *   - markdown：与 /share 相同，格式化为可读的 Markdown
+ *   - json：导出原始消息数组（格式化 JSON）
+ *   - html：将 Markdown 包裹在基础 HTML 模板中
+ */
+interface ExportCommandOptions {
+  sessionId?: string;
+  format?: "markdown" | "json" | "html";
+  output?: string;
+}
+/**
+ * 处理 /export 命令。
+ *
+ * 以指定格式导出会话，支持 markdown / json / html。
+ * 默认导出最近一次会话为 markdown 格式。
+ */
+declare function handleExportCommand(opts: ExportCommandOptions): Promise<{
+  output: string;
+}>;
+//#endregion
+//#region src/commands/tag.d.ts
+/**
+ * /tag — 为会话打标签，用于分类管理。
+ *
+ * 标签数据存储在 ~/.lynx/session-tags.json 中。
+ * 支持三种操作：
+ *   - add：为指定会话添加标签
+ *   - remove：移除指定标签
+ *   - list：列出所有带标签的会话，或指定会话的所有标签
+ */
+interface TagCommandOptions {
+  sessionId?: string;
+  tag?: string;
+  action?: "add" | "remove" | "list";
+}
+/**
+ * 处理 /tag 命令。
+ *
+ * 为会话添加、移除或列出标签。
+ * 默认操作为 list；add/remove 需要提供 --tag 参数。
+ */
+declare function handleTagCommand(opts: TagCommandOptions): Promise<{
+  output: string;
+}>;
+//#endregion
+//#region src/commands/copy.d.ts
+/**
+ * /copy — 将最后一条助手回复复制到剪贴板。
+ *
+ * 从会话中提取指定索引（从末尾倒数）的助手消息文本，
+ * 通过平台对应的剪贴板命令写入系统剪贴板。
+ *
+ * 支持平台：Windows（PowerShell）、macOS（pbcopy）、
+ * Linux（xclip 或 wl-copy）。
+ */
+interface CopyCommandOptions {
+  sessionId?: string;
+  /** 从末尾倒数第几条消息（0 = 最后一条，默认 0）。 */
+  index?: number;
+}
+/**
+ * 处理 /copy 命令。
+ *
+ * 将指定索引（从末尾倒数）的助手消息文本复制到系统剪贴板。
+ * 默认复制最后一条助手回复。
+ */
+declare function handleCopyCommand(opts: CopyCommandOptions): Promise<{
+  output: string;
+}>;
+//#endregion
+export { type AntTraceOptions, type AppContext, type AutoFixCommandArgs, type BootstrapConfig, CATALOG, type CheckResult, type CommandEntry, type CommandPolicy, type CommitCommandArgs, type ConfigCommandOptions, type CopyCommandOptions, type DebugLogger, type DebugToolCallOptions, type DiffCommandArgs, type DoctorReport, type ExportCommandOptions, type IssueCommandArgs, type LifecycleConfig, type LogLevel, type MemoryAlert, type MemoryAlertLevel, MemoryMonitor, type MemoryMonitorConfig, type MemorySnapshot, type PerfIssueOptions, type Phase1Result, type PluginCommandOptions, type PoolStatus, type PoolTask, type PrCommentsCommandArgs, type ReviewCommandArgs, type SessionCommandOptions, type ShareCommandOptions, type StartupResult, type TagCommandOptions, type TasksCommandOptions, type UpdateCheckConfig, type UpdateResult, WorkerPool, type WorkerPoolConfig, beginSync, bootstrap, checkForUpdates, clearUpdateCache, createDebugLogger, createProgram, endSync, enterFullscreen, exitFullscreen, findCommand, getLastUpdateResult, handleAntTraceCommand, handleAutoFixCommand, handleCommitCommand, handleConfigCommand, handleCopyCommand, handleDebugToolCall, handleDiffCommand, handleExportCommand, handleHeapdumpCommand, handleIssueCommand, handlePerfIssueCommand, handlePluginCommand, handlePrCommentsCommand, handleReviewCommand, handleSessionCommand, handleShareCommand, handleTagCommand, handleTasksCommand, installProcessLifecycle, launchTui, main, onCleanup, printReport, runChecks, runCli, runCrestodian, runDoctor, runPhase1, runPhase2, uninstallProcessLifecycle, withSync };
+//# sourceMappingURL=index.d.mts.map