@openspecui/core 3.5.2 → 3.6.0

package/dist/openspec-projection-DTuKPTgf.d.mts

@@ -0,0 +1,1142 @@
+import { d as MarkdownReadingPlugin, l as MarkdownReadingDocument } from "./markdown-reading-D36W693c.mjs";
+import { n as OpenSpecAnnotation, t as AnnotatedOpenSpecDocument } from "./openspec-annotations-CJmYcfAu.mjs";
+import { z } from "zod";
+
+//#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";
+  size?: number | undefined;
+  content?: string | undefined;
+}, {
+  path: string;
+  type: "file" | "directory";
+  size?: number | undefined;
+  content?: string | undefined;
+}>;
+type ChangeFile = z.infer<typeof ChangeFileSchema>;
+declare const ScenarioStepKeywordSchema: z.ZodEnum<["GIVEN", "WHEN", "THEN", "AND", "BUT"]>;
+declare const ScenarioStepSchema: z.ZodObject<{
+  /** Scenario step keyword from the list item prefix */
+  keyword: z.ZodEnum<["GIVEN", "WHEN", "THEN", "AND", "BUT"]>;
+  /** Markdown content after the keyword */
+  contentMarkdown: z.ZodString;
+  /** Original markdown list item line */
+  rawText: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+  contentMarkdown: string;
+  rawText: string;
+}, {
+  keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+  contentMarkdown: string;
+  rawText: string;
+}>;
+type ScenarioStep = z.infer<typeof ScenarioStepSchema>;
+/**
+ * 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 heading text from `### Requirement:` */
+  title: z.ZodString;
+  /** Markdown body between the requirement heading and the first scenario/next requirement */
+  bodyMarkdown: z.ZodString;
+  /** Full requirement text used for validation and search facts */
+  text: z.ZodString;
+  /** Test scenarios for this requirement */
+  scenarios: z.ZodArray<z.ZodObject<{
+    /** Scenario heading text from `#### Scenario:` */
+    title: z.ZodString;
+    /** Markdown body between this scenario heading and the next scenario/requirement */
+    bodyMarkdown: z.ZodString;
+    /** Full scenario Markdown facts, including the scenario title */
+    rawText: z.ZodString;
+    /** Parsed scenario step facts for reading enhancements */
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      /** Scenario step keyword from the list item prefix */
+      keyword: z.ZodEnum<["GIVEN", "WHEN", "THEN", "AND", "BUT"]>;
+      /** Markdown content after the keyword */
+      contentMarkdown: z.ZodString;
+      /** Original markdown list item line */
+      rawText: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+      contentMarkdown: string;
+      rawText: string;
+    }, {
+      keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+      contentMarkdown: string;
+      rawText: string;
+    }>, "many">>;
+  }, "strip", z.ZodTypeAny, {
+    title: string;
+    rawText: string;
+    bodyMarkdown: string;
+    steps?: {
+      keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+      contentMarkdown: string;
+      rawText: string;
+    }[] | undefined;
+  }, {
+    title: string;
+    rawText: string;
+    bodyMarkdown: string;
+    steps?: {
+      keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+      contentMarkdown: string;
+      rawText: string;
+    }[] | undefined;
+  }>, "many">;
+}, "strip", z.ZodTypeAny, {
+  title: string;
+  id: string;
+  text: string;
+  bodyMarkdown: string;
+  scenarios: {
+    title: string;
+    rawText: string;
+    bodyMarkdown: string;
+    steps?: {
+      keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+      contentMarkdown: string;
+      rawText: string;
+    }[] | undefined;
+  }[];
+}, {
+  title: string;
+  id: string;
+  text: string;
+  bodyMarkdown: string;
+  scenarios: {
+    title: string;
+    rawText: string;
+    bodyMarkdown: string;
+    steps?: {
+      keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+      contentMarkdown: string;
+      rawText: string;
+    }[] | undefined;
+  }[];
+}>;
+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 heading text from `### Requirement:` */
+    title: z.ZodString;
+    /** Markdown body between the requirement heading and the first scenario/next requirement */
+    bodyMarkdown: z.ZodString;
+    /** Full requirement text used for validation and search facts */
+    text: z.ZodString;
+    /** Test scenarios for this requirement */
+    scenarios: z.ZodArray<z.ZodObject<{
+      /** Scenario heading text from `#### Scenario:` */
+      title: z.ZodString;
+      /** Markdown body between this scenario heading and the next scenario/requirement */
+      bodyMarkdown: z.ZodString;
+      /** Full scenario Markdown facts, including the scenario title */
+      rawText: z.ZodString;
+      /** Parsed scenario step facts for reading enhancements */
+      steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Scenario step keyword from the list item prefix */
+        keyword: z.ZodEnum<["GIVEN", "WHEN", "THEN", "AND", "BUT"]>;
+        /** Markdown content after the keyword */
+        contentMarkdown: z.ZodString;
+        /** Original markdown list item line */
+        rawText: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }, {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }, {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }>, "many">;
+  }, "strip", z.ZodTypeAny, {
+    title: string;
+    id: string;
+    text: string;
+    bodyMarkdown: string;
+    scenarios: {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }[];
+  }, {
+    title: string;
+    id: string;
+    text: string;
+    bodyMarkdown: string;
+    scenarios: {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }[];
+  }>, "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: {
+    title: string;
+    id: string;
+    text: string;
+    bodyMarkdown: string;
+    scenarios: {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }[];
+  }[];
+  metadata?: {
+    version: string;
+    format: "openspec";
+    sourcePath?: string | undefined;
+  } | undefined;
+}, {
+  id: string;
+  name: string;
+  overview: string;
+  requirements: {
+    title: string;
+    id: string;
+    text: string;
+    bodyMarkdown: string;
+    scenarios: {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }[];
+  }[];
+  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 heading text from `### Requirement:` */
+    title: z.ZodString;
+    /** Markdown body between the requirement heading and the first scenario/next requirement */
+    bodyMarkdown: z.ZodString;
+    /** Full requirement text used for validation and search facts */
+    text: z.ZodString;
+    /** Test scenarios for this requirement */
+    scenarios: z.ZodArray<z.ZodObject<{
+      /** Scenario heading text from `#### Scenario:` */
+      title: z.ZodString;
+      /** Markdown body between this scenario heading and the next scenario/requirement */
+      bodyMarkdown: z.ZodString;
+      /** Full scenario Markdown facts, including the scenario title */
+      rawText: z.ZodString;
+      /** Parsed scenario step facts for reading enhancements */
+      steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Scenario step keyword from the list item prefix */
+        keyword: z.ZodEnum<["GIVEN", "WHEN", "THEN", "AND", "BUT"]>;
+        /** Markdown content after the keyword */
+        contentMarkdown: z.ZodString;
+        /** Original markdown list item line */
+        rawText: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }, {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }, {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }>, "many">;
+  }, "strip", z.ZodTypeAny, {
+    title: string;
+    id: string;
+    text: string;
+    bodyMarkdown: string;
+    scenarios: {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }[];
+  }, {
+    title: string;
+    id: string;
+    text: string;
+    bodyMarkdown: string;
+    scenarios: {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }[];
+  }>>;
+  /** Multiple requirement changes */
+  requirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    /** Unique identifier within the spec (e.g., "req-1") */
+    id: z.ZodString;
+    /** Requirement heading text from `### Requirement:` */
+    title: z.ZodString;
+    /** Markdown body between the requirement heading and the first scenario/next requirement */
+    bodyMarkdown: z.ZodString;
+    /** Full requirement text used for validation and search facts */
+    text: z.ZodString;
+    /** Test scenarios for this requirement */
+    scenarios: z.ZodArray<z.ZodObject<{
+      /** Scenario heading text from `#### Scenario:` */
+      title: z.ZodString;
+      /** Markdown body between this scenario heading and the next scenario/requirement */
+      bodyMarkdown: z.ZodString;
+      /** Full scenario Markdown facts, including the scenario title */
+      rawText: z.ZodString;
+      /** Parsed scenario step facts for reading enhancements */
+      steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Scenario step keyword from the list item prefix */
+        keyword: z.ZodEnum<["GIVEN", "WHEN", "THEN", "AND", "BUT"]>;
+        /** Markdown content after the keyword */
+        contentMarkdown: z.ZodString;
+        /** Original markdown list item line */
+        rawText: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }, {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }, {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }>, "many">;
+  }, "strip", z.ZodTypeAny, {
+    title: string;
+    id: string;
+    text: string;
+    bodyMarkdown: string;
+    scenarios: {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }[];
+  }, {
+    title: string;
+    id: string;
+    text: string;
+    bodyMarkdown: string;
+    scenarios: {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }[];
+  }>, "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, {
+  description: string;
+  spec: string;
+  operation: "ADDED" | "MODIFIED" | "REMOVED" | "RENAMED";
+  requirements?: {
+    title: string;
+    id: string;
+    text: string;
+    bodyMarkdown: string;
+    scenarios: {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }[];
+  }[] | undefined;
+  requirement?: {
+    title: string;
+    id: string;
+    text: string;
+    bodyMarkdown: string;
+    scenarios: {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }[];
+  } | undefined;
+  rename?: {
+    from: string;
+    to: string;
+  } | undefined;
+}, {
+  description: string;
+  spec: string;
+  operation: "ADDED" | "MODIFIED" | "REMOVED" | "RENAMED";
+  requirements?: {
+    title: string;
+    id: string;
+    text: string;
+    bodyMarkdown: string;
+    scenarios: {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }[];
+  }[] | undefined;
+  requirement?: {
+    title: string;
+    id: string;
+    text: string;
+    bodyMarkdown: string;
+    scenarios: {
+      title: string;
+      rawText: string;
+      bodyMarkdown: string;
+      steps?: {
+        keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+        contentMarkdown: string;
+        rawText: string;
+      }[] | undefined;
+    }[];
+  } | 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, {
+  content: string;
+  specId: string;
+}, {
+  content: string;
+  specId: 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 heading text from `### Requirement:` */
+      title: z.ZodString;
+      /** Markdown body between the requirement heading and the first scenario/next requirement */
+      bodyMarkdown: z.ZodString;
+      /** Full requirement text used for validation and search facts */
+      text: z.ZodString;
+      /** Test scenarios for this requirement */
+      scenarios: z.ZodArray<z.ZodObject<{
+        /** Scenario heading text from `#### Scenario:` */
+        title: z.ZodString;
+        /** Markdown body between this scenario heading and the next scenario/requirement */
+        bodyMarkdown: z.ZodString;
+        /** Full scenario Markdown facts, including the scenario title */
+        rawText: z.ZodString;
+        /** Parsed scenario step facts for reading enhancements */
+        steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          /** Scenario step keyword from the list item prefix */
+          keyword: z.ZodEnum<["GIVEN", "WHEN", "THEN", "AND", "BUT"]>;
+          /** Markdown content after the keyword */
+          contentMarkdown: z.ZodString;
+          /** Original markdown list item line */
+          rawText: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }, {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }>, "many">>;
+      }, "strip", z.ZodTypeAny, {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }, {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+      title: string;
+      id: string;
+      text: string;
+      bodyMarkdown: string;
+      scenarios: {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }[];
+    }, {
+      title: string;
+      id: string;
+      text: string;
+      bodyMarkdown: string;
+      scenarios: {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }[];
+    }>>;
+    /** Multiple requirement changes */
+    requirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      /** Unique identifier within the spec (e.g., "req-1") */
+      id: z.ZodString;
+      /** Requirement heading text from `### Requirement:` */
+      title: z.ZodString;
+      /** Markdown body between the requirement heading and the first scenario/next requirement */
+      bodyMarkdown: z.ZodString;
+      /** Full requirement text used for validation and search facts */
+      text: z.ZodString;
+      /** Test scenarios for this requirement */
+      scenarios: z.ZodArray<z.ZodObject<{
+        /** Scenario heading text from `#### Scenario:` */
+        title: z.ZodString;
+        /** Markdown body between this scenario heading and the next scenario/requirement */
+        bodyMarkdown: z.ZodString;
+        /** Full scenario Markdown facts, including the scenario title */
+        rawText: z.ZodString;
+        /** Parsed scenario step facts for reading enhancements */
+        steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          /** Scenario step keyword from the list item prefix */
+          keyword: z.ZodEnum<["GIVEN", "WHEN", "THEN", "AND", "BUT"]>;
+          /** Markdown content after the keyword */
+          contentMarkdown: z.ZodString;
+          /** Original markdown list item line */
+          rawText: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }, {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }>, "many">>;
+      }, "strip", z.ZodTypeAny, {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }, {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+      title: string;
+      id: string;
+      text: string;
+      bodyMarkdown: string;
+      scenarios: {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }[];
+    }, {
+      title: string;
+      id: string;
+      text: string;
+      bodyMarkdown: string;
+      scenarios: {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }[];
+    }>, "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, {
+    description: string;
+    spec: string;
+    operation: "ADDED" | "MODIFIED" | "REMOVED" | "RENAMED";
+    requirements?: {
+      title: string;
+      id: string;
+      text: string;
+      bodyMarkdown: string;
+      scenarios: {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }[];
+    }[] | undefined;
+    requirement?: {
+      title: string;
+      id: string;
+      text: string;
+      bodyMarkdown: string;
+      scenarios: {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }[];
+    } | undefined;
+    rename?: {
+      from: string;
+      to: string;
+    } | undefined;
+  }, {
+    description: string;
+    spec: string;
+    operation: "ADDED" | "MODIFIED" | "REMOVED" | "RENAMED";
+    requirements?: {
+      title: string;
+      id: string;
+      text: string;
+      bodyMarkdown: string;
+      scenarios: {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }[];
+    }[] | undefined;
+    requirement?: {
+      title: string;
+      id: string;
+      text: string;
+      bodyMarkdown: string;
+      scenarios: {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }[];
+    } | 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, {
+    content: string;
+    specId: string;
+  }, {
+    content: string;
+    specId: 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: {
+    description: string;
+    spec: string;
+    operation: "ADDED" | "MODIFIED" | "REMOVED" | "RENAMED";
+    requirements?: {
+      title: string;
+      id: string;
+      text: string;
+      bodyMarkdown: string;
+      scenarios: {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }[];
+    }[] | undefined;
+    requirement?: {
+      title: string;
+      id: string;
+      text: string;
+      bodyMarkdown: string;
+      scenarios: {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }[];
+    } | 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?: {
+    content: string;
+    specId: string;
+  }[] | undefined;
+}, {
+  id: string;
+  name: string;
+  why: string;
+  whatChanges: string;
+  deltas: {
+    description: string;
+    spec: string;
+    operation: "ADDED" | "MODIFIED" | "REMOVED" | "RENAMED";
+    requirements?: {
+      title: string;
+      id: string;
+      text: string;
+      bodyMarkdown: string;
+      scenarios: {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }[];
+    }[] | undefined;
+    requirement?: {
+      title: string;
+      id: string;
+      text: string;
+      bodyMarkdown: string;
+      scenarios: {
+        title: string;
+        rawText: string;
+        bodyMarkdown: string;
+        steps?: {
+          keyword: "GIVEN" | "WHEN" | "THEN" | "AND" | "BUT";
+          contentMarkdown: string;
+          rawText: string;
+        }[] | undefined;
+      }[];
+    } | 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?: {
+    content: string;
+    specId: string;
+  }[] | undefined;
+}>;
+type Change = z.infer<typeof ChangeSchema>;
+//#endregion
+//#region src/openspec-projection.d.ts
+declare const OPEN_SPEC_SPEC_PROJECTION_ID = "openspec.projection.spec.v2";
+declare const OPEN_SPEC_READING_SECTIONS_PROJECTION_ID = "openspec.projection.reading-sections.v2";
+type SpecSectionKind = 'overview' | 'requirements' | 'other';
+interface OpenSpecProjectionOptions {
+  specId: string;
+}
+interface OpenSpecHeadingSection {
+  id: string;
+  title: string;
+  kind: SpecSectionKind;
+  factId: string;
+  start: number;
+  end: number;
+}
+interface OpenSpecRequirementBlock {
+  id: string;
+  title: string;
+  factId: string;
+  start: number;
+  end: number;
+  scenarios: OpenSpecScenarioBlock[];
+}
+interface OpenSpecScenarioBlock {
+  title: string;
+  factId: string;
+  start: number;
+  end: number;
+}
+interface OpenSpecReadingSectionsProjection {
+  sections: OpenSpecHeadingSection[];
+  requirements: OpenSpecRequirementBlock[];
+}
+interface ProjectedOpenSpecDocument extends MarkdownReadingDocument {
+  annotations: OpenSpecAnnotation[];
+  projections: MarkdownReadingDocument['projections'] & {
+    [OPEN_SPEC_SPEC_PROJECTION_ID]?: Spec;
+    [OPEN_SPEC_READING_SECTIONS_PROJECTION_ID]?: OpenSpecReadingSectionsProjection;
+  };
+}
+declare function createOpenSpecReadingPlugin(options: OpenSpecProjectionOptions): MarkdownReadingPlugin;
+declare function parseOpenSpecMarkdownToSpec(specId: string, content: string): Spec;
+declare function projectOpenSpecMarkdown(sourceMarkdown: string, options: OpenSpecProjectionOptions, plugins?: readonly MarkdownReadingPlugin[]): ProjectedOpenSpecDocument;
+declare function projectAnnotatedOpenSpecToSpec(specId: string, document: AnnotatedOpenSpecDocument): Spec;
+declare function getOpenSpecReadingSections(document: Pick<MarkdownReadingDocument, 'facts' | 'annotations' | 'sourceMarkdown'>): OpenSpecReadingSectionsProjection;
+declare function getOpenSpecProjectionAnnotation(annotations: readonly OpenSpecAnnotation[], factId: string, kind: OpenSpecAnnotation['kind']): OpenSpecAnnotation | undefined;
+//#endregion
+export { Spec as A, DeltaSpec as C, ScenarioStep as D, RequirementSchema as E, Task as M, TaskSchema as N, ScenarioStepKeywordSchema as O, DeltaSchema as S, Requirement as T, ChangeFileSchema as _, OpenSpecReadingSectionsProjection as a, DeltaOperation as b, ProjectedOpenSpecDocument as c, getOpenSpecReadingSections as d, parseOpenSpecMarkdownToSpec as f, ChangeFile as g, Change as h, OpenSpecProjectionOptions as i, SpecSchema as j, ScenarioStepSchema as k, createOpenSpecReadingPlugin as l, projectOpenSpecMarkdown as m, OPEN_SPEC_SPEC_PROJECTION_ID as n, OpenSpecRequirementBlock as o, projectAnnotatedOpenSpecToSpec as p, OpenSpecHeadingSection as r, OpenSpecScenarioBlock as s, OPEN_SPEC_READING_SECTIONS_PROJECTION_ID as t, getOpenSpecProjectionAnnotation as u, ChangeSchema as v, DeltaSpecSchema as w, DeltaOperationType as x, Delta as y };