@openspecui/core 0.9.0

package/dist/index.d.mts

@@ -0,0 +1,1712 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { z } from "zod";
+import { EventEmitter } from "events";
+
+//#region src/schemas.d.ts
+
+/**
+ * File metadata for a change directory entry.
+ */
+declare const ChangeFileSchema: z.ZodObject<{
+  /** Path relative to the change root (e.g., "proposal.md" or "specs/auth/spec.md") */
+  path: z.ZodString;
+  /** Entry type */
+  type: z.ZodEnum<["file", "directory"]>;
+  /** Optional file content for text files */
+  content: z.ZodOptional<z.ZodString>;
+  /** Optional byte size for files */
+  size: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+  path: string;
+  type: "file" | "directory";
+  content?: string | undefined;
+  size?: number | undefined;
+}, {
+  path: string;
+  type: "file" | "directory";
+  content?: string | undefined;
+  size?: number | undefined;
+}>;
+type ChangeFile = z.infer<typeof ChangeFileSchema>;
+/**
+ * A requirement within a specification.
+ * Requirements should use RFC 2119 keywords (SHALL, MUST, etc.)
+ */
+declare const RequirementSchema: z.ZodObject<{
+  /** Unique identifier within the spec (e.g., "req-1") */
+  id: z.ZodString;
+  /** Requirement text, should contain SHALL/MUST keywords */
+  text: z.ZodString;
+  /** Test scenarios for this requirement */
+  scenarios: z.ZodArray<z.ZodObject<{
+    rawText: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    rawText: string;
+  }, {
+    rawText: string;
+  }>, "many">;
+}, "strip", z.ZodTypeAny, {
+  id: string;
+  text: string;
+  scenarios: {
+    rawText: string;
+  }[];
+}, {
+  id: string;
+  text: string;
+  scenarios: {
+    rawText: string;
+  }[];
+}>;
+type Requirement = z.infer<typeof RequirementSchema>;
+/**
+ * A specification document.
+ * Located at: openspec/specs/{id}/spec.md
+ */
+declare const SpecSchema: z.ZodObject<{
+  /** Directory name (e.g., "user-auth") */
+  id: z.ZodString;
+  /** Human-readable name from # heading */
+  name: z.ZodString;
+  /** Purpose/overview section content */
+  overview: z.ZodString;
+  /** List of requirements */
+  requirements: z.ZodArray<z.ZodObject<{
+    /** Unique identifier within the spec (e.g., "req-1") */
+    id: z.ZodString;
+    /** Requirement text, should contain SHALL/MUST keywords */
+    text: z.ZodString;
+    /** Test scenarios for this requirement */
+    scenarios: z.ZodArray<z.ZodObject<{
+      rawText: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      rawText: string;
+    }, {
+      rawText: string;
+    }>, "many">;
+  }, "strip", z.ZodTypeAny, {
+    id: string;
+    text: string;
+    scenarios: {
+      rawText: string;
+    }[];
+  }, {
+    id: string;
+    text: string;
+    scenarios: {
+      rawText: string;
+    }[];
+  }>, "many">;
+  /** Optional metadata */
+  metadata: z.ZodOptional<z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    format: z.ZodDefault<z.ZodLiteral<"openspec">>;
+    sourcePath: z.ZodOptional<z.ZodString>;
+  }, "strip", z.ZodTypeAny, {
+    version: string;
+    format: "openspec";
+    sourcePath?: string | undefined;
+  }, {
+    version?: string | undefined;
+    format?: "openspec" | undefined;
+    sourcePath?: string | undefined;
+  }>>;
+}, "strip", z.ZodTypeAny, {
+  id: string;
+  name: string;
+  overview: string;
+  requirements: {
+    id: string;
+    text: string;
+    scenarios: {
+      rawText: string;
+    }[];
+  }[];
+  metadata?: {
+    version: string;
+    format: "openspec";
+    sourcePath?: string | undefined;
+  } | undefined;
+}, {
+  id: string;
+  name: string;
+  overview: string;
+  requirements: {
+    id: string;
+    text: string;
+    scenarios: {
+      rawText: string;
+    }[];
+  }[];
+  metadata?: {
+    version?: string | undefined;
+    format?: "openspec" | undefined;
+    sourcePath?: string | undefined;
+  } | undefined;
+}>;
+type Spec = z.infer<typeof SpecSchema>;
+/**
+ * A delta describes changes to a spec within a change proposal.
+ * Deltas track which specs are affected and how.
+ */
+declare const DeltaOperationType: z.ZodEnum<["ADDED", "MODIFIED", "REMOVED", "RENAMED"]>;
+declare const DeltaSchema: z.ZodObject<{
+  /** Target spec ID */
+  spec: z.ZodString;
+  /** Type of change */
+  operation: z.ZodEnum<["ADDED", "MODIFIED", "REMOVED", "RENAMED"]>;
+  /** Human-readable description */
+  description: z.ZodString;
+  /** Single requirement change */
+  requirement: z.ZodOptional<z.ZodObject<{
+    /** Unique identifier within the spec (e.g., "req-1") */
+    id: z.ZodString;
+    /** Requirement text, should contain SHALL/MUST keywords */
+    text: z.ZodString;
+    /** Test scenarios for this requirement */
+    scenarios: z.ZodArray<z.ZodObject<{
+      rawText: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      rawText: string;
+    }, {
+      rawText: string;
+    }>, "many">;
+  }, "strip", z.ZodTypeAny, {
+    id: string;
+    text: string;
+    scenarios: {
+      rawText: string;
+    }[];
+  }, {
+    id: string;
+    text: string;
+    scenarios: {
+      rawText: string;
+    }[];
+  }>>;
+  /** Multiple requirement changes */
+  requirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    /** Unique identifier within the spec (e.g., "req-1") */
+    id: z.ZodString;
+    /** Requirement text, should contain SHALL/MUST keywords */
+    text: z.ZodString;
+    /** Test scenarios for this requirement */
+    scenarios: z.ZodArray<z.ZodObject<{
+      rawText: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      rawText: string;
+    }, {
+      rawText: string;
+    }>, "many">;
+  }, "strip", z.ZodTypeAny, {
+    id: string;
+    text: string;
+    scenarios: {
+      rawText: string;
+    }[];
+  }, {
+    id: string;
+    text: string;
+    scenarios: {
+      rawText: string;
+    }[];
+  }>, "many">>;
+  /** Rename details (for RENAMED operation) */
+  rename: z.ZodOptional<z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    from: string;
+    to: string;
+  }, {
+    from: string;
+    to: string;
+  }>>;
+}, "strip", z.ZodTypeAny, {
+  spec: string;
+  operation: "ADDED" | "MODIFIED" | "REMOVED" | "RENAMED";
+  description: string;
+  requirements?: {
+    id: string;
+    text: string;
+    scenarios: {
+      rawText: string;
+    }[];
+  }[] | undefined;
+  requirement?: {
+    id: string;
+    text: string;
+    scenarios: {
+      rawText: string;
+    }[];
+  } | undefined;
+  rename?: {
+    from: string;
+    to: string;
+  } | undefined;
+}, {
+  spec: string;
+  operation: "ADDED" | "MODIFIED" | "REMOVED" | "RENAMED";
+  description: string;
+  requirements?: {
+    id: string;
+    text: string;
+    scenarios: {
+      rawText: string;
+    }[];
+  }[] | undefined;
+  requirement?: {
+    id: string;
+    text: string;
+    scenarios: {
+      rawText: string;
+    }[];
+  } | undefined;
+  rename?: {
+    from: string;
+    to: string;
+  } | undefined;
+}>;
+type Delta = z.infer<typeof DeltaSchema>;
+type DeltaOperation = z.infer<typeof DeltaOperationType>;
+/**
+ * A task within a change proposal.
+ * Tasks are parsed from tasks.md using checkbox syntax: - [ ] or - [x]
+ */
+declare const TaskSchema: z.ZodObject<{
+  /** Unique identifier (e.g., "task-1") */
+  id: z.ZodString;
+  /** Task description text */
+  text: z.ZodString;
+  /** Whether the task is completed */
+  completed: z.ZodBoolean;
+  /** Optional section heading the task belongs to */
+  section: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+  id: string;
+  text: string;
+  completed: boolean;
+  section?: string | undefined;
+}, {
+  id: string;
+  text: string;
+  completed: boolean;
+  section?: string | undefined;
+}>;
+type Task = z.infer<typeof TaskSchema>;
+/**
+ * A delta spec file from changes/{id}/specs/{specId}/spec.md
+ * Contains the proposed changes to a spec
+ */
+declare const DeltaSpecSchema: z.ZodObject<{
+  /** Spec ID (directory name under changes/{id}/specs/) */
+  specId: z.ZodString;
+  /** Raw markdown content of the delta spec */
+  content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  specId: string;
+  content: string;
+}, {
+  specId: string;
+  content: string;
+}>;
+type DeltaSpec = z.infer<typeof DeltaSpecSchema>;
+/**
+ * A change proposal document.
+ * Located at: openspec/changes/{id}/proposal.md + tasks.md
+ *
+ * Change proposals describe why a change is needed, what will change,
+ * which specs are affected (deltas), and trackable tasks.
+ */
+declare const ChangeSchema: z.ZodObject<{
+  /** Directory name (e.g., "add-oauth") */
+  id: z.ZodString;
+  /** Human-readable name from # heading */
+  name: z.ZodString;
+  /** Why section - motivation for the change */
+  why: z.ZodString;
+  /** What Changes section - description of changes */
+  whatChanges: z.ZodString;
+  /** Affected specs and their changes */
+  deltas: z.ZodArray<z.ZodObject<{
+    /** Target spec ID */
+    spec: z.ZodString;
+    /** Type of change */
+    operation: z.ZodEnum<["ADDED", "MODIFIED", "REMOVED", "RENAMED"]>;
+    /** Human-readable description */
+    description: z.ZodString;
+    /** Single requirement change */
+    requirement: z.ZodOptional<z.ZodObject<{
+      /** Unique identifier within the spec (e.g., "req-1") */
+      id: z.ZodString;
+      /** Requirement text, should contain SHALL/MUST keywords */
+      text: z.ZodString;
+      /** Test scenarios for this requirement */
+      scenarios: z.ZodArray<z.ZodObject<{
+        rawText: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        rawText: string;
+      }, {
+        rawText: string;
+      }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+      id: string;
+      text: string;
+      scenarios: {
+        rawText: string;
+      }[];
+    }, {
+      id: string;
+      text: string;
+      scenarios: {
+        rawText: string;
+      }[];
+    }>>;
+    /** Multiple requirement changes */
+    requirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      /** Unique identifier within the spec (e.g., "req-1") */
+      id: z.ZodString;
+      /** Requirement text, should contain SHALL/MUST keywords */
+      text: z.ZodString;
+      /** Test scenarios for this requirement */
+      scenarios: z.ZodArray<z.ZodObject<{
+        rawText: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        rawText: string;
+      }, {
+        rawText: string;
+      }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+      id: string;
+      text: string;
+      scenarios: {
+        rawText: string;
+      }[];
+    }, {
+      id: string;
+      text: string;
+      scenarios: {
+        rawText: string;
+      }[];
+    }>, "many">>;
+    /** Rename details (for RENAMED operation) */
+    rename: z.ZodOptional<z.ZodObject<{
+      from: z.ZodString;
+      to: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      from: string;
+      to: string;
+    }, {
+      from: string;
+      to: string;
+    }>>;
+  }, "strip", z.ZodTypeAny, {
+    spec: string;
+    operation: "ADDED" | "MODIFIED" | "REMOVED" | "RENAMED";
+    description: string;
+    requirements?: {
+      id: string;
+      text: string;
+      scenarios: {
+        rawText: string;
+      }[];
+    }[] | undefined;
+    requirement?: {
+      id: string;
+      text: string;
+      scenarios: {
+        rawText: string;
+      }[];
+    } | undefined;
+    rename?: {
+      from: string;
+      to: string;
+    } | undefined;
+  }, {
+    spec: string;
+    operation: "ADDED" | "MODIFIED" | "REMOVED" | "RENAMED";
+    description: string;
+    requirements?: {
+      id: string;
+      text: string;
+      scenarios: {
+        rawText: string;
+      }[];
+    }[] | undefined;
+    requirement?: {
+      id: string;
+      text: string;
+      scenarios: {
+        rawText: string;
+      }[];
+    } | undefined;
+    rename?: {
+      from: string;
+      to: string;
+    } | undefined;
+  }>, "many">;
+  /** Trackable tasks from tasks.md */
+  tasks: z.ZodArray<z.ZodObject<{
+    /** Unique identifier (e.g., "task-1") */
+    id: z.ZodString;
+    /** Task description text */
+    text: z.ZodString;
+    /** Whether the task is completed */
+    completed: z.ZodBoolean;
+    /** Optional section heading the task belongs to */
+    section: z.ZodOptional<z.ZodString>;
+  }, "strip", z.ZodTypeAny, {
+    id: string;
+    text: string;
+    completed: boolean;
+    section?: string | undefined;
+  }, {
+    id: string;
+    text: string;
+    completed: boolean;
+    section?: string | undefined;
+  }>, "many">;
+  /** Task completion progress */
+  progress: z.ZodObject<{
+    total: z.ZodNumber;
+    completed: z.ZodNumber;
+  }, "strip", z.ZodTypeAny, {
+    completed: number;
+    total: number;
+  }, {
+    completed: number;
+    total: number;
+  }>;
+  /** Optional design.md content */
+  design: z.ZodOptional<z.ZodString>;
+  /** Delta specs from changes/{id}/specs/ directory */
+  deltaSpecs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    /** Spec ID (directory name under changes/{id}/specs/) */
+    specId: z.ZodString;
+    /** Raw markdown content of the delta spec */
+    content: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    specId: string;
+    content: string;
+  }, {
+    specId: string;
+    content: string;
+  }>, "many">>;
+  /** Optional metadata */
+  metadata: z.ZodOptional<z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    format: z.ZodDefault<z.ZodLiteral<"openspec-change">>;
+  }, "strip", z.ZodTypeAny, {
+    version: string;
+    format: "openspec-change";
+  }, {
+    version?: string | undefined;
+    format?: "openspec-change" | undefined;
+  }>>;
+}, "strip", z.ZodTypeAny, {
+  id: string;
+  name: string;
+  why: string;
+  whatChanges: string;
+  deltas: {
+    spec: string;
+    operation: "ADDED" | "MODIFIED" | "REMOVED" | "RENAMED";
+    description: string;
+    requirements?: {
+      id: string;
+      text: string;
+      scenarios: {
+        rawText: string;
+      }[];
+    }[] | undefined;
+    requirement?: {
+      id: string;
+      text: string;
+      scenarios: {
+        rawText: string;
+      }[];
+    } | undefined;
+    rename?: {
+      from: string;
+      to: string;
+    } | undefined;
+  }[];
+  tasks: {
+    id: string;
+    text: string;
+    completed: boolean;
+    section?: string | undefined;
+  }[];
+  progress: {
+    completed: number;
+    total: number;
+  };
+  metadata?: {
+    version: string;
+    format: "openspec-change";
+  } | undefined;
+  design?: string | undefined;
+  deltaSpecs?: {
+    specId: string;
+    content: string;
+  }[] | undefined;
+}, {
+  id: string;
+  name: string;
+  why: string;
+  whatChanges: string;
+  deltas: {
+    spec: string;
+    operation: "ADDED" | "MODIFIED" | "REMOVED" | "RENAMED";
+    description: string;
+    requirements?: {
+      id: string;
+      text: string;
+      scenarios: {
+        rawText: string;
+      }[];
+    }[] | undefined;
+    requirement?: {
+      id: string;
+      text: string;
+      scenarios: {
+        rawText: string;
+      }[];
+    } | undefined;
+    rename?: {
+      from: string;
+      to: string;
+    } | undefined;
+  }[];
+  tasks: {
+    id: string;
+    text: string;
+    completed: boolean;
+    section?: string | undefined;
+  }[];
+  progress: {
+    completed: number;
+    total: number;
+  };
+  metadata?: {
+    version?: string | undefined;
+    format?: "openspec-change" | undefined;
+  } | undefined;
+  design?: string | undefined;
+  deltaSpecs?: {
+    specId: string;
+    content: string;
+  }[] | undefined;
+}>;
+type Change = z.infer<typeof ChangeSchema>;
+//#endregion
+//#region src/validator.d.ts
+interface ValidationIssue {
+  severity: 'ERROR' | 'WARNING' | 'INFO';
+  message: string;
+  path?: string;
+  line?: number;
+}
+interface ValidationResult {
+  valid: boolean;
+  issues: ValidationIssue[];
+}
+/**
+ * Validator for OpenSpec documents
+ */
+declare class Validator {
+  /**
+   * Validate a spec document
+   */
+  validateSpec(spec: Spec): ValidationResult;
+  /**
+   * Validate a change proposal
+   */
+  validateChange(change: Change): ValidationResult;
+}
+//#endregion
+//#region src/adapter.d.ts
+/** Spec metadata with time info */
+interface SpecMeta {
+  id: string;
+  name: string;
+  createdAt: number;
+  updatedAt: number;
+}
+/** Change metadata with time info */
+interface ChangeMeta {
+  id: string;
+  name: string;
+  progress: {
+    total: number;
+    completed: number;
+  };
+  createdAt: number;
+  updatedAt: number;
+}
+/** Archived change metadata with time info */
+interface ArchiveMeta {
+  id: string;
+  name: string;
+  createdAt: number;
+  updatedAt: number;
+}
+/**
+ * OpenSpec filesystem adapter
+ * Handles reading, writing, and managing OpenSpec files
+ */
+declare class OpenSpecAdapter {
+  private projectDir;
+  private parser;
+  private validator;
+  constructor(projectDir: string);
+  private get openspecDir();
+  private get specsDir();
+  private get changesDir();
+  private get archiveDir();
+  isInitialized(): Promise<boolean>;
+  /** File time info derived from filesystem (reactive) */
+  private getFileTimeInfo;
+  listSpecs(): Promise<string[]>;
+  /**
+   * List specs with metadata (id, name, and time info)
+   * Only returns specs that have valid spec.md
+   * Sorted by updatedAt descending (most recent first)
+   */
+  listSpecsWithMeta(): Promise<SpecMeta[]>;
+  listChanges(): Promise<string[]>;
+  /**
+   * List changes with metadata (id, name, progress, and time info)
+   * Only returns changes that have valid proposal.md
+   * Sorted by updatedAt descending (most recent first)
+   */
+  listChangesWithMeta(): Promise<ChangeMeta[]>;
+  listArchivedChanges(): Promise<string[]>;
+  /**
+   * List archived changes with metadata and time info
+   * Only returns archives that have valid proposal.md
+   * Sorted by updatedAt descending (most recent first)
+   */
+  listArchivedChangesWithMeta(): Promise<ArchiveMeta[]>;
+  /**
+   * Read project.md content (reactive)
+   */
+  readProjectMd(): Promise<string | null>;
+  /**
+   * Read AGENTS.md content (reactive)
+   */
+  readAgentsMd(): Promise<string | null>;
+  /**
+   * Write project.md content
+   */
+  writeProjectMd(content: string): Promise<void>;
+  /**
+   * Write AGENTS.md content
+   */
+  writeAgentsMd(content: string): Promise<void>;
+  readSpec(specId: string): Promise<Spec | null>;
+  readSpecRaw(specId: string): Promise<string | null>;
+  readChange(changeId: string): Promise<Change | null>;
+  readChangeFiles(changeId: string): Promise<ChangeFile[]>;
+  readArchivedChangeFiles(changeId: string): Promise<ChangeFile[]>;
+  private readFilesUnderRoot;
+  private collectChangeFiles;
+  readChangeRaw(changeId: string): Promise<{
+    proposal: string;
+    tasks: string;
+    design?: string;
+    deltaSpecs: DeltaSpec[];
+  } | null>;
+  /** Read delta specs from a specs directory */
+  private readDeltaSpecs;
+  /**
+   * Read an archived change
+   */
+  readArchivedChange(changeId: string): Promise<Change | null>;
+  /**
+   * Read raw archived change files (reactive)
+   */
+  readArchivedChangeRaw(changeId: string): Promise<{
+    proposal: string;
+    tasks: string;
+    design?: string;
+    deltaSpecs: DeltaSpec[];
+  } | null>;
+  writeSpec(specId: string, content: string): Promise<void>;
+  writeChange(changeId: string, proposal: string, tasks?: string): Promise<void>;
+  archiveChange(changeId: string): Promise<boolean>;
+  init(): Promise<void>;
+  /**
+   * Toggle a task's completion status in tasks.md
+   * @param changeId - The change ID
+   * @param taskIndex - 1-based task index
+   * @param completed - New completion status
+   */
+  toggleTask(changeId: string, taskIndex: number, completed: boolean): Promise<boolean>;
+  validateSpec(specId: string): Promise<ValidationResult>;
+  validateChange(changeId: string): Promise<ValidationResult>;
+  getDashboardData(): Promise<{
+    specs: {
+      id: string;
+      name: string;
+      overview: string;
+      requirements: {
+        id: string;
+        text: string;
+        scenarios: {
+          rawText: string;
+        }[];
+      }[];
+      metadata?: {
+        version: string;
+        format: "openspec";
+        sourcePath?: string | undefined;
+      } | undefined;
+    }[];
+    changes: {
+      id: string;
+      name: string;
+      why: string;
+      whatChanges: string;
+      deltas: {
+        spec: string;
+        operation: "ADDED" | "MODIFIED" | "REMOVED" | "RENAMED";
+        description: string;
+        requirements?: {
+          id: string;
+          text: string;
+          scenarios: {
+            rawText: string;
+          }[];
+        }[] | undefined;
+        requirement?: {
+          id: string;
+          text: string;
+          scenarios: {
+            rawText: string;
+          }[];
+        } | undefined;
+        rename?: {
+          from: string;
+          to: string;
+        } | undefined;
+      }[];
+      tasks: {
+        id: string;
+        text: string;
+        completed: boolean;
+        section?: string | undefined;
+      }[];
+      progress: {
+        completed: number;
+        total: number;
+      };
+      metadata?: {
+        version: string;
+        format: "openspec-change";
+      } | undefined;
+      design?: string | undefined;
+      deltaSpecs?: {
+        specId: string;
+        content: string;
+      }[] | undefined;
+    }[];
+    archivedCount: number;
+    summary: {
+      specCount: number;
+      requirementCount: number;
+      activeChangeCount: number;
+      archivedChangeCount: number;
+      totalTasks: number;
+      completedTasks: number;
+      progressPercent: number;
+    };
+  }>;
+}
+//#endregion
+//#region src/parser.d.ts
+/**
+ * Markdown parser for OpenSpec documents
+ */
+declare class MarkdownParser {
+  /**
+   * Parse a spec markdown content into a Spec object
+   */
+  parseSpec(specId: string, content: string): Spec;
+  /**
+   * Parse a change proposal markdown content into a Change object
+   */
+  parseChange(changeId: string, proposalContent: string, tasksContent?: string, options?: {
+    design?: string;
+    deltaSpecs?: DeltaSpec[];
+  }): Change;
+  private parseDeltasFromWhatChanges;
+  private parseDeltasFromDeltaSpecs;
+  private parseDeltaSpecContent;
+  /**
+   * Parse tasks from a tasks.md content
+   */
+  parseTasks(content: string): Task[];
+  /**
+   * Serialize a spec back to markdown
+   */
+  serializeSpec(spec: Spec): string;
+}
+//#endregion
+//#region src/reactive-fs/reactive-state.d.ts
+interface IReactiveContext {
+  track(state: ReactiveState<unknown>): void;
+  notifyChange(): void;
+}
+/**
+ * 全局的 AsyncLocalStorage，用于在异步调用链中传递 ReactiveContext
+ * 这是实现依赖收集的核心机制
+ */
+declare const contextStorage: AsyncLocalStorage<IReactiveContext>;
+/** ReactiveState 配置选项 */
+interface ReactiveStateOptions<T> {
+  /** 自定义相等性比较函数 */
+  equals?: (a: T, b: T) => boolean;
+}
+/**
+ * 响应式状态类，类似 Signal.State
+ *
+ * 核心机制：
+ * - get() 时自动注册到当前 ReactiveContext 的依赖列表
+ * - set() 时如果值变化，通知所有依赖的 Context
+ */
+declare class ReactiveState<T> {
+  private currentValue;
+  private readonly equals;
+  /** 所有依赖此状态的 Context */
+  private readonly subscribers;
+  constructor(initialValue: T, options?: ReactiveStateOptions<T>);
+  /**
+   * 获取当前值
+   * 如果在 ReactiveContext 中调用，会自动注册依赖
+   */
+  get(): T;
+  /**
+   * 设置新值
+   * 如果值变化，通知所有订阅者
+   * @returns 是否发生了变化
+   */
+  set(newValue: T): boolean;
+  /**
+   * 取消订阅
+   * 当 Context 销毁时调用
+   */
+  unsubscribe(context: IReactiveContext): void;
+  /**
+   * 获取当前订阅者数量（用于调试）
+   */
+  get subscriberCount(): number;
+}
+//#endregion
+//#region src/reactive-fs/reactive-context.d.ts
+/**
+ * 响应式上下文，管理依赖收集和变更通知
+ *
+ * 核心机制：
+ * - 在 stream() 中执行任务时，通过 AsyncLocalStorage 传递 this
+ * - 任务中的所有 ReactiveState.get() 调用都会自动注册依赖
+ * - 当任何依赖变更时，重新执行任务并 yield 新结果
+ */
+declare class ReactiveContext {
+  /** 当前追踪的依赖 */
+  private dependencies;
+  /** 等待变更的 Promise */
+  private changePromise?;
+  /** 是否已销毁 */
+  private destroyed;
+  /**
+   * 追踪依赖
+   * 由 ReactiveState.get() 调用
+   */
+  track(state: ReactiveState<unknown>): void;
+  /**
+   * 通知变更
+   * 由 ReactiveState.set() 调用
+   */
+  notifyChange(): void;
+  /**
+   * 运行响应式任务流
+   * 每次依赖变更时重新执行任务并 yield 结果
+   *
+   * @param task 要执行的异步任务
+   * @param signal 用于取消的 AbortSignal
+   */
+  stream<T>(task: () => Promise<T>, signal?: AbortSignal): AsyncGenerator<T>;
+  /**
+   * 执行一次任务（非响应式）
+   * 用于初始数据获取
+   */
+  runOnce<T>(task: () => Promise<T>): Promise<T>;
+  /**
+   * 清理依赖
+   */
+  private clearDependencies;
+  /**
+   * 销毁上下文
+   * @param reason 可选的销毁原因，如果提供则 reject changePromise
+   */
+  private destroy;
+  /**
+   * 等待 AbortSignal
+   */
+  private waitForAbort;
+}
+//#endregion
+//#region src/reactive-fs/reactive-fs.d.ts
+/**
+ * 响应式读取文件内容
+ *
+ * 特性：
+ * - 自动注册文件监听
+ * - 文件变更时自动更新状态
+ * - 在 ReactiveContext 中调用时自动追踪依赖
+ * - 支持监听尚未创建的文件（通过 @parcel/watcher）
+ *
+ * @param filepath 文件路径
+ * @returns 文件内容，文件不存在时返回 null
+ */
+declare function reactiveReadFile(filepath: string): Promise<string | null>;
+/**
+ * 响应式读取目录内容
+ *
+ * 特性：
+ * - 自动注册目录监听
+ * - 目录变更时自动更新状态
+ * - 在 ReactiveContext 中调用时自动追踪依赖
+ * - 支持监听尚未创建的目录（通过 @parcel/watcher）
+ *
+ * @param dirpath 目录路径
+ * @param options 选项
+ * @returns 目录项名称数组
+ */
+declare function reactiveReadDir(dirpath: string, options?: {
+  /** 是否只返回目录 */
+  directoriesOnly?: boolean;
+  /** 是否只返回文件 */
+  filesOnly?: boolean;
+  /** 是否包含隐藏文件（以 . 开头） */
+  includeHidden?: boolean;
+  /** 排除的名称 */
+  exclude?: string[];
+}): Promise<string[]>;
+/**
+ * 响应式检查路径是否存在
+ *
+ * @param path 路径
+ * @returns 是否存在
+ */
+declare function reactiveExists(path: string): Promise<boolean>;
+/**
+ * 响应式获取文件/目录的 stat 信息
+ *
+ * @param path 路径
+ * @returns stat 信息，不存在时返回 null
+ */
+declare function reactiveStat(path: string): Promise<{
+  isDirectory: boolean;
+  isFile: boolean;
+  mtime: number;
+  birthtime: number;
+} | null>;
+/**
+ * 清除指定路径的缓存（用于测试）
+ */
+declare function clearCache(path?: string): void;
+/**
+ * 获取缓存大小（用于调试）
+ */
+declare function getCacheSize(): number;
+//#endregion
+//#region src/reactive-fs/watcher-pool.d.ts
+/**
+ * 初始化 watcher pool
+ *
+ * 必须在使用 acquireWatcher 之前调用。
+ * 通常由 server 在启动时调用。
+ *
+ * @param projectDir 项目根目录
+ */
+declare function initWatcherPool(projectDir: string): Promise<void>;
+/**
+ * 获取或创建文件/目录监听器
+ *
+ * 特性：
+ * - 使用 @parcel/watcher 监听项目根目录
+ * - 自动处理新创建的目录（解决 init 后无法监听的问题）
+ * - 同一路径共享订阅
+ * - 引用计数管理生命周期
+ * - 内置防抖机制
+ *
+ * @param path 要监听的路径
+ * @param onChange 变更回调
+ * @param options 监听选项
+ * @returns 释放函数，调用后取消订阅
+ */
+declare function acquireWatcher(path: string, onChange: () => void, options?: {
+  recursive?: boolean;
+  debounceMs?: number;
+  onError?: () => void;
+}): () => void;
+/**
+ * 获取当前活跃的监听器数量（用于调试）
+ */
+declare function getActiveWatcherCount(): number;
+/**
+ * 关闭所有监听器（用于测试清理）
+ */
+declare function closeAllWatchers(): Promise<void>;
+/**
+ * 检查 watcher pool 是否已初始化
+ */
+declare function isWatcherPoolInitialized(): boolean;
+/**
+ * 获取当前监听的项目目录
+ */
+declare function getWatchedProjectDir(): string | null;
+//#endregion
+//#region src/reactive-fs/project-watcher.d.ts
+/**
+ * 事件类型
+ */
+type WatchEventType = 'create' | 'update' | 'delete';
+/**
+ * 监听事件
+ */
+interface WatchEvent {
+  type: WatchEventType;
+  path: string;
+}
+/**
+ * 路径订阅回调
+ */
+type PathCallback = (events: WatchEvent[]) => void;
+/**
+ * 项目监听器
+ *
+ * 使用 @parcel/watcher 监听项目根目录，
+ * 然后通过路径前缀匹配分发事件给订阅者。
+ *
+ * 特性：
+ * - 单个 watcher 监听整个项目
+ * - 自动处理新创建的目录
+ * - 内置防抖机制
+ * - 高性能原生实现
+ */
+declare class ProjectWatcher {
+  private projectDir;
+  private subscription;
+  private pathSubscriptions;
+  private pendingEvents;
+  private debounceTimer;
+  private debounceMs;
+  private ignore;
+  private initialized;
+  private initPromise;
+  private healthCheckTimer;
+  private lastEventTime;
+  private healthCheckPending;
+  private enableHealthCheck;
+  private reinitializeTimer;
+  private reinitializePending;
+  constructor(projectDir: string, options?: {
+    debounceMs?: number;
+    ignore?: string[];
+    /** 是否启用健康检查（默认 true） */
+    enableHealthCheck?: boolean;
+  });
+  /**
+   * 初始化 watcher
+   * 懒加载，首次订阅时自动调用
+   */
+  init(): Promise<void>;
+  private doInit;
+  /**
+   * 处理 watcher 错误
+   * 对于 FSEvents dropped 错误，触发延迟重建
+   */
+  private handleWatcherError;
+  /**
+   * 延迟重建 watcher（防抖，避免频繁重建）
+   */
+  private scheduleReinitialize;
+  /**
+   * 处理原始事件
+   */
+  private handleEvents;
+  /**
+   * 分发事件给订阅者
+   */
+  private flushEvents;
+  /**
+   * 检查事件是否匹配订阅
+   */
+  private matchPath;
+  /**
+   * 同步订阅路径变更（watcher 必须已初始化）
+   *
+   * 这是同步版本，用于在 watcher 已初始化后快速注册订阅。
+   * 如果 watcher 未初始化，抛出错误。
+   *
+   * @param path 要监听的路径
+   * @param callback 变更回调
+   * @param options 订阅选项
+   * @returns 取消订阅函数
+   */
+  subscribeSync(path: string, callback: PathCallback, options?: {
+    watchChildren?: boolean;
+  }): () => void;
+  /**
+   * 订阅路径变更（异步版本，自动初始化）
+   *
+   * @param path 要监听的路径
+   * @param callback 变更回调
+   * @param options 订阅选项
+   * @returns 取消订阅函数
+   */
+  subscribe(path: string, callback: PathCallback, options?: {
+    watchChildren?: boolean;
+  }): Promise<() => void>;
+  /**
+   * 获取当前订阅数量（用于调试）
+   */
+  get subscriptionCount(): number;
+  /**
+   * 检查是否已初始化
+   */
+  get isInitialized(): boolean;
+  /**
+   * 启动健康检查定时器
+   */
+  private startHealthCheck;
+  /**
+   * 停止健康检查定时器
+   */
+  private stopHealthCheck;
+  /**
+   * 执行健康检查
+   *
+   * 工作流程：
+   * 1. 如果最近有事件，无需检查
+   * 2. 如果上次探测还在等待中，说明 watcher 可能失效，尝试重建
+   * 3. 否则，创建临时文件触发事件，等待下次检查验证
+   */
+  private performHealthCheck;
+  /**
+   * 发送探测：通过 utimesSync 修改项目目录的时间戳来触发 watcher 事件
+   */
+  private sendProbe;
+  /**
+   * 重新初始化 watcher
+   */
+  private reinitialize;
+  /**
+   * 等待项目目录被创建
+   */
+  private waitForProjectDir;
+  /**
+   * 关闭 watcher
+   */
+  close(): Promise<void>;
+}
+/**
+ * 获取或创建项目监听器
+ */
+declare function getProjectWatcher(projectDir: string, options?: ConstructorParameters<typeof ProjectWatcher>[1]): ProjectWatcher;
+/**
+ * 关闭所有 ProjectWatcher（用于测试清理）
+ */
+declare function closeAllProjectWatchers(): Promise<void>;
+//#endregion
+//#region src/watcher.d.ts
+/**
+ * File change event types
+ */
+type FileChangeType = 'spec' | 'change' | 'archive' | 'project';
+/**
+ * File change event payload
+ */
+interface FileChangeEvent {
+  type: FileChangeType;
+  action: 'create' | 'update' | 'delete';
+  id?: string;
+  path: string;
+  timestamp: number;
+}
+/**
+ * OpenSpec file watcher
+ * Watches the openspec/ directory for changes and emits events
+ */
+declare class OpenSpecWatcher extends EventEmitter {
+  private projectDir;
+  private watchers;
+  private debounceTimers;
+  private debounceMs;
+  constructor(projectDir: string, options?: {
+    debounceMs?: number;
+  });
+  private get openspecDir();
+  private get specsDir();
+  private get changesDir();
+  private get archiveDir();
+  /**
+   * Start watching for file changes
+   */
+  start(): void;
+  /**
+   * Stop watching for file changes
+   */
+  stop(): void;
+  /**
+   * Watch a directory recursively
+   */
+  private watchDir;
+  /**
+   * Emit event with debouncing to avoid duplicate events
+   */
+  private emitDebounced;
+}
+/**
+ * Create a file change observable for use with tRPC subscriptions
+ */
+declare function createFileChangeObservable(watcher: OpenSpecWatcher): {
+  subscribe: (observer: {
+    next: (event: FileChangeEvent) => void;
+    error?: (error: Error) => void;
+    complete?: () => void;
+  }) => {
+    unsubscribe: () => void;
+  };
+};
+//#endregion
+//#region src/config.d.ts
+/**
+ * 解析 CLI 命令字符串为数组
+ *
+ * 支持两种格式：
+ * 1. JSON 数组：以 `[` 开头，如 `["npx", "@fission-ai/openspec"]`
+ * 2. 简单字符串：用空格分割，如 `npx @fission-ai/openspec`
+ *
+ * 注意：简单字符串解析不支持带引号的参数，如需复杂命令请使用 JSON 数组格式
+ */
+declare function parseCliCommand(command: string): string[];
+/** CLI 嗅探结果 */
+interface CliSniffResult {
+  /** 是否存在全局 openspec 命令 */
+  hasGlobal: boolean;
+  /** 全局命令的版本（仅当 hasGlobal 为 true 时有值） */
+  version?: string;
+  /** npm registry 上的最新版本 */
+  latestVersion?: string;
+  /** 是否有可用更新 */
+  hasUpdate?: boolean;
+  /** 错误信息（如果检测失败） */
+  error?: string;
+}
+/**
+ * 嗅探全局 openspec 命令（无缓存）
+ *
+ * 使用 `openspec --version` 检测是否有全局命令可用。
+ * 同时检查 npm registry 上的最新版本。
+ * 每次调用都会重新检测，不使用缓存。
+ */
+declare function sniffGlobalCli(): Promise<CliSniffResult>;
+/**
+ * 获取默认 CLI 命令（异步，带检测）
+ *
+ * @returns CLI 命令数组，如 `['openspec']` 或 `['npx', '@fission-ai/openspec']`
+ */
+declare function getDefaultCliCommand(): Promise<readonly string[]>;
+/**
+ * 获取默认 CLI 命令的字符串形式（用于 UI 显示）
+ */
+declare function getDefaultCliCommandString(): Promise<string>;
+/**
+ * OpenSpecUI 配置 Schema
+ *
+ * 存储在 openspec/.openspecui.json 中，利用文件监听实现响应式更新
+ */
+declare const OpenSpecUIConfigSchema: z.ZodObject<{
+  /** CLI 命令配置 */
+  cli: z.ZodDefault<z.ZodObject<{
+    /** CLI 命令前缀 */
+    command: z.ZodOptional<z.ZodString>;
+  }, "strip", z.ZodTypeAny, {
+    command?: string | undefined;
+  }, {
+    command?: string | undefined;
+  }>>;
+  /** UI 配置 */
+  ui: z.ZodDefault<z.ZodObject<{
+    /** 主题 */
+    theme: z.ZodDefault<z.ZodEnum<["light", "dark", "system"]>>;
+  }, "strip", z.ZodTypeAny, {
+    theme: "light" | "dark" | "system";
+  }, {
+    theme?: "light" | "dark" | "system" | undefined;
+  }>>;
+}, "strip", z.ZodTypeAny, {
+  cli: {
+    command?: string | undefined;
+  };
+  ui: {
+    theme: "light" | "dark" | "system";
+  };
+}, {
+  cli?: {
+    command?: string | undefined;
+  } | undefined;
+  ui?: {
+    theme?: "light" | "dark" | "system" | undefined;
+  } | undefined;
+}>;
+type OpenSpecUIConfig = z.infer<typeof OpenSpecUIConfigSchema>;
+/** 默认配置（静态，用于测试和类型） */
+declare const DEFAULT_CONFIG: OpenSpecUIConfig;
+/**
+ * 配置管理器
+ *
+ * 负责读写 openspec/.openspecui.json 配置文件。
+ * 读取操作使用 reactiveReadFile，支持响应式更新。
+ */
+declare class ConfigManager {
+  private configPath;
+  constructor(projectDir: string);
+  /**
+   * 读取配置（响应式）
+   *
+   * 如果配置文件不存在，返回默认配置。
+   * 如果配置文件格式错误，返回默认配置并打印警告。
+   */
+  readConfig(): Promise<OpenSpecUIConfig>;
+  /**
+   * 写入配置
+   *
+   * 会触发文件监听，自动更新订阅者。
+   */
+  writeConfig(config: Partial<OpenSpecUIConfig>): Promise<void>;
+  /**
+   * 获取 CLI 命令（数组形式）
+   *
+   * 优先级：配置文件 > 全局 openspec 命令 > npx fallback
+   *
+   * @returns CLI 命令数组，如 `['openspec']` 或 `['npx', '@fission-ai/openspec']`
+   */
+  getCliCommand(): Promise<readonly string[]>;
+  /**
+   * 获取 CLI 命令的字符串形式（用于 UI 显示）
+   */
+  getCliCommandString(): Promise<string>;
+  /**
+   * 设置 CLI 命令
+   */
+  setCliCommand(command: string): Promise<void>;
+}
+//#endregion
+//#region src/cli-executor.d.ts
+/** CLI 执行结果 */
+interface CliResult {
+  success: boolean;
+  stdout: string;
+  stderr: string;
+  exitCode: number | null;
+}
+/** CLI 流式输出事件 */
+interface CliStreamEvent {
+  type: 'command' | 'stdout' | 'stderr' | 'exit';
+  data?: string;
+  exitCode?: number | null;
+}
+/**
+ * CLI 执行器
+ *
+ * 负责调用外部 openspec CLI 命令。
+ * 命令前缀从 ConfigManager 获取，支持：
+ * - ['npx', '@fission-ai/openspec'] (默认)
+ * - ['openspec'] (全局安装)
+ * - 自定义数组或字符串
+ *
+ * 注意：所有命令都使用 shell: false 执行，避免 shell 注入风险
+ */
+declare class CliExecutor {
+  private configManager;
+  private projectDir;
+  constructor(configManager: ConfigManager, projectDir: string);
+  /**
+   * 创建干净的环境变量，移除 pnpm 特有的配置
+   * 避免 pnpm 环境变量污染 npx/npm 执行
+   */
+  private getCleanEnv;
+  /**
+   * 构建完整命令数组
+   *
+   * @param args CLI 参数，如 ['init'] 或 ['archive', 'change-id']
+   * @returns [command, ...commandArgs, ...args]
+   */
+  private buildCommandArray;
+  /**
+   * 执行 CLI 命令
+   *
+   * @param args CLI 参数，如 ['init'] 或 ['archive', 'change-id']
+   * @returns 执行结果
+   */
+  execute(args: string[]): Promise<CliResult>;
+  /**
+   * 执行 openspec init（非交互式）
+   *
+   * @param tools 工具列表，如 ['claude', 'cursor'] 或 'all' 或 'none'
+   */
+  init(tools?: string[] | 'all' | 'none'): Promise<CliResult>;
+  /**
+   * 执行 openspec archive <changeId>（非交互式）
+   *
+   * @param changeId 要归档的 change ID
+   * @param options 选项
+   */
+  archive(changeId: string, options?: {
+    skipSpecs?: boolean;
+    noValidate?: boolean;
+  }): Promise<CliResult>;
+  /**
+   * 执行 openspec validate [type] [id]
+   */
+  validate(type?: 'spec' | 'change', id?: string): Promise<CliResult>;
+  /**
+   * 流式执行 openspec validate
+   */
+  validateStream(type: 'spec' | 'change' | undefined, id: string | undefined, onEvent: (event: CliStreamEvent) => void): Promise<() => void>;
+  /**
+   * 检查 CLI 是否可用
+   * @param timeout 超时时间（毫秒），默认 10 秒
+   */
+  checkAvailability(timeout?: number): Promise<{
+    available: boolean;
+    version?: string;
+    error?: string;
+  }>;
+  /**
+   * 流式执行 CLI 命令
+   *
+   * @param args CLI 参数
+   * @param onEvent 事件回调
+   * @returns 取消函数
+   */
+  executeStream(args: string[], onEvent: (event: CliStreamEvent) => void): Promise<() => void>;
+  /**
+   * 流式执行 openspec init
+   */
+  initStream(tools: string[] | 'all' | 'none', onEvent: (event: CliStreamEvent) => void): Promise<() => void>;
+  /**
+   * 流式执行 openspec archive
+   */
+  archiveStream(changeId: string, options: {
+    skipSpecs?: boolean;
+    noValidate?: boolean;
+  }, onEvent: (event: CliStreamEvent) => void): Promise<() => void>;
+  /**
+   * 流式执行任意命令（数组形式）
+   *
+   * 用于执行不需要 openspec CLI 前缀的命令，如 npm install。
+   * 使用 shell: false 避免 shell 注入风险。
+   *
+   * @param command 命令数组，如 ['npm', 'install', '-g', '@fission-ai/openspec']
+   * @param onEvent 事件回调
+   * @returns 取消函数
+   */
+  executeCommandStream(command: readonly string[], onEvent: (event: CliStreamEvent) => void): () => void;
+}
+//#endregion
+//#region src/tool-config.d.ts
+/**
+ * 工具配置检测模块
+ *
+ * 完全对齐 @fission-ai/openspec 的官方实现
+ * 用于检测项目中已配置的 AI 工具
+ *
+ * 重要：使用响应式文件系统实现，监听配置目录，
+ * 当配置文件变化时会自动触发更新。
+ *
+ * @see references/openspec/src/core/config.ts (AI_TOOLS)
+ * @see references/openspec/src/core/configurators/slash/
+ * @see references/openspec/src/core/init.ts (isToolConfigured)
+ */
+/**
+ * 检测路径范围
+ * - project: 相对于项目根目录
+ * - global: 绝对路径（如 Codex 的 ~/.codex/prompts/）
+ * - none: 无检测路径（如 Universal AGENTS.md 通过项目 AGENTS.md 检测）
+ */
+type DetectionScope = 'project' | 'global' | 'none';
+/**
+ * AI 工具选项（与官方 OpenSpec CLI 完全一致）
+ * @see references/openspec/src/core/config.ts
+ */
+interface AIToolOption {
+  /** 显示名称 */
+  name: string;
+  /** 工具 ID（用于 CLI 参数） */
+  value: string;
+  /** 是否可用（available: false 的工具不会出现在主列表中） */
+  available: boolean;
+  /** 成功消息中使用的标签 */
+  successLabel?: string;
+}
+/**
+ * 工具检测配置
+ */
+interface ToolDetectionConfig {
+  /** 检测路径范围 */
+  scope: DetectionScope;
+  /**
+   * 检测路径
+   * - scope='project': 相对于项目根目录的路径
+   * - scope='global': 返回绝对路径的函数
+   * - scope='none': undefined
+   */
+  detectionPath?: string | (() => string);
+}
+/**
+ * 完整的工具配置（元信息 + 检测配置）
+ */
+interface ToolConfig extends AIToolOption, ToolDetectionConfig {}
+/**
+ * 所有支持的 AI 工具配置
+ *
+ * 完全对齐官方 OpenSpec CLI 的 AI_TOOLS
+ * 按字母顺序排序（与官方一致）
+ *
+ * @see references/openspec/src/core/config.ts
+ * @see references/openspec/src/core/configurators/slash/registry.ts
+ */
+declare const AI_TOOLS: ToolConfig[];
+/**
+ * 获取所有可用的工具（available: true）
+ */
+declare function getAvailableTools(): ToolConfig[];
+/**
+ * 获取所有可用的工具 ID 列表（available: true）
+ */
+declare function getAvailableToolIds(): string[];
+/**
+ * 获取所有工具（包括 available: false 的）
+ */
+declare function getAllTools(): ToolConfig[];
+/**
+ * 获取所有工具 ID 列表（包括 available: false 的）
+ */
+declare function getAllToolIds(): string[];
+/**
+ * 根据工具 ID 获取工具配置
+ */
+declare function getToolById(toolId: string): ToolConfig | undefined;
+/**
+ * 检测项目中已配置的工具（响应式）
+ *
+ * 监听两类目录：
+ * 1. 项目级配置目录（如 .claude, .cursor 等）
+ * 2. 全局配置目录（如 ~/.codex/prompts/）
+ *
+ * @param projectDir 项目根目录
+ * @returns 已配置的工具 ID 列表
+ */
+declare function getConfiguredTools(projectDir: string): Promise<string[]>;
+/**
+ * 检查特定工具是否已配置
+ *
+ * @param projectDir 项目根目录
+ * @param toolId 工具 ID
+ * @returns 是否已配置
+ */
+declare function isToolConfigured(projectDir: string, toolId: string): Promise<boolean>;
+//#endregion
+//#region src/export-types.d.ts
+/**
+ * Types for static export / SSG
+ */
+/**
+ * Complete snapshot of an OpenSpec project for static export
+ */
+interface ExportSnapshot {
+  /** Snapshot metadata */
+  meta: {
+    timestamp: string;
+    version: string;
+    projectDir: string;
+  };
+  /** Dashboard summary data */
+  dashboard: {
+    specsCount: number;
+    changesCount: number;
+    archivesCount: number;
+  };
+  /** All specs with parsed content */
+  specs: Array<{
+    id: string;
+    name: string;
+    content: string;
+    overview: string;
+    requirements: Array<{
+      id: string;
+      text: string;
+      scenarios: Array<{
+        rawText: string;
+      }>;
+    }>;
+    createdAt: number;
+    updatedAt: number;
+  }>;
+  /** All active changes with parsed content */
+  changes: Array<{
+    id: string;
+    name: string;
+    proposal: string;
+    tasks?: string;
+    design?: string;
+    why: string;
+    whatChanges: string;
+    parsedTasks: Array<{
+      id: string;
+      text: string;
+      completed: boolean;
+      section?: string;
+    }>;
+    deltas: Array<{
+      capability: string;
+      content: string;
+    }>;
+    progress: {
+      total: number;
+      completed: number;
+    };
+    createdAt: number;
+    updatedAt: number;
+  }>;
+  /** All archived changes */
+  archives: Array<{
+    id: string;
+    name: string;
+    proposal: string;
+    tasks?: string;
+    design?: string;
+    why: string;
+    whatChanges: string;
+    parsedTasks: Array<{
+      id: string;
+      text: string;
+      completed: boolean;
+      section?: string;
+    }>;
+    createdAt: number;
+    updatedAt: number;
+  }>;
+  /** Project.md content */
+  projectMd?: string;
+  /** AGENTS.md content */
+  agentsMd?: string;
+}
+//#endregion
+export { type AIToolOption, AI_TOOLS, type ArchiveMeta, type Change, type ChangeFile, ChangeFileSchema, type ChangeMeta, ChangeSchema, CliExecutor, type CliResult, type CliSniffResult, type CliStreamEvent, ConfigManager, DEFAULT_CONFIG, type Delta, type DeltaOperation, DeltaOperationType, DeltaSchema, type DeltaSpec, DeltaSpecSchema, type ExportSnapshot, type FileChangeEvent, type FileChangeType, MarkdownParser, OpenSpecAdapter, type OpenSpecUIConfig, OpenSpecUIConfigSchema, OpenSpecWatcher, type PathCallback, ProjectWatcher, ReactiveContext, ReactiveState, type ReactiveStateOptions, type Requirement, RequirementSchema, type Spec, type SpecMeta, SpecSchema, type Task, TaskSchema, type ToolConfig, type ToolDetectionConfig, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, acquireWatcher, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getProjectWatcher, getToolById, getWatchedProjectDir, initWatcherPool, isToolConfigured, isWatcherPoolInitialized, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, sniffGlobalCli };