@stritti/vitepress-plugin-openspec 0.3.1

package/dist/index.d.cts

@@ -0,0 +1,160 @@
+import { Plugin } from 'vite';
+
+/**
+ * Configuration options for the vitepress-plugin-openspec plugin.
+ */
+interface OpenSpecPluginOptions {
+    /**
+     * Path to the openspec/ directory of the project.
+     * @default './openspec'
+     */
+    specDir?: string;
+    /**
+     * Output directory (relative to VitePress `srcDir`) where the generated
+     * Markdown pages will be written.
+     * @default 'openspec'
+     */
+    outDir?: string;
+    /**
+     * VitePress source directory — the directory containing your `.md` files
+     * (i.e. the `docs/` folder). Required when calling `generateOpenSpecPages()`
+     * at config evaluation time so it knows where to write the generated files.
+     *
+     * @default process.cwd()
+     * @example path.resolve(__dirname, '..')  // from docs/.vitepress/config.ts
+     */
+    srcDir?: string;
+}
+/**
+ * A canonical capability specification from openspec/specs/<name>/spec.md
+ */
+interface CapabilitySpec {
+    /** Folder name (kebab-case capability identifier) */
+    name: string;
+    /** Optional display title from spec.md frontmatter. Overrides humanized name. */
+    title?: string;
+    /** Absolute path to the spec.md file */
+    specPath: string;
+    /** Raw Markdown content of the spec */
+    content: string;
+}
+/**
+ * A single artifact (file) belonging to a Change.
+ */
+type ChangeArtifact = 'proposal' | 'design' | 'tasks';
+/**
+ * An OpenSpec change (active or archived).
+ */
+interface Change {
+    /** Change directory name (e.g. "my-feature" or for archived: "my-feature" extracted from "2026-03-10-my-feature") */
+    name: string;
+    /** Optional display title from .openspec.yaml. Overrides humanized name. */
+    title?: string;
+    /** Absolute path to the change directory */
+    dir: string;
+    /** Which artifact files are present */
+    artifacts: ChangeArtifact[];
+    /** Creation date from .openspec.yaml, if available */
+    createdDate?: string;
+    /** For archived changes: the archive date (YYYY-MM-DD) parsed from directory name */
+    archivedDate?: string;
+    /**
+     * For archived changes: the original archive folder name (e.g. "2026-01-15-my-feature" or
+     * "legacy-feature" for non-standard names). Used to build correct archive URLs.
+     */
+    archiveFolderName?: string;
+}
+/**
+ * The full parsed structure of an openspec/ directory.
+ */
+interface OpenSpecFolder {
+    /** Absolute path to the openspec/ root */
+    dir: string;
+    /** Canonical capability specs from openspec/specs/ */
+    specs: CapabilitySpec[];
+    /** Active changes from openspec/changes/ (excluding archive/) */
+    changes: Change[];
+    /** Archived changes from openspec/changes/archive/ */
+    archivedChanges: Change[];
+}
+/**
+ * A nav item compatible with VitePress `DefaultTheme.NavItem`.
+ */
+interface NavItem {
+    text: string;
+    link: string;
+}
+/**
+ * A sidebar item compatible with VitePress `DefaultTheme.SidebarItem`.
+ */
+interface SidebarItem {
+    text: string;
+    link?: string;
+    collapsed?: boolean;
+    items?: SidebarItem[];
+}
+
+/**
+ * Synchronously generates all VitePress Markdown pages from the openspec/
+ * directory and writes them to disk.
+ *
+ * Call this at the top of your `docs/.vitepress/config.ts` **before**
+ * `defineConfig()` so the files exist when VitePress scans the source
+ * directory for routes.
+ *
+ * @example
+ * ```typescript
+ * // docs/.vitepress/config.ts
+ * import { defineConfig } from 'vitepress'
+ * import path from 'node:path'
+ * import { fileURLToPath } from 'node:url'
+ * import openspec, { generateOpenSpecPages } from 'vitepress-plugin-openspec'
+ *
+ * const __dirname = path.dirname(fileURLToPath(import.meta.url))
+ * const specDir = path.resolve(__dirname, '../../openspec')
+ *
+ * // Generate pages before VitePress scans srcDir for routes
+ * generateOpenSpecPages({ specDir, outDir: 'openspec', srcDir: path.resolve(__dirname, '..') })
+ *
+ * export default defineConfig({ ... })
+ * ```
+ */
+declare function generateOpenSpecPages(userOptions?: OpenSpecPluginOptions): void;
+/**
+ * VitePress plugin that reads an openspec/ directory and generates structured
+ * Markdown documentation pages inside the VitePress source directory.
+ *
+ * For the pages to be available on the first build (including CI), also call
+ * `generateOpenSpecPages()` at the top of your `config.ts` before `defineConfig`.
+ *
+ * @example
+ * ```typescript
+ * // .vitepress/config.ts
+ * import { defineConfig } from 'vitepress'
+ * import openspec, { generateOpenSpecPages } from 'vitepress-plugin-openspec'
+ *
+ * generateOpenSpecPages({ specDir, outDir: 'openspec', srcDir: path.resolve(__dirname, '..') })
+ *
+ * export default defineConfig({
+ *   vite: { plugins: [openspec({ specDir: './openspec', outDir: 'project-docs' })] },
+ * })
+ * ```
+ */
+declare function openspec(userOptions?: OpenSpecPluginOptions): Plugin;
+
+/**
+ * Returns a VitePress sidebar configuration for the OpenSpec documentation.
+ * Includes groups for Specifications, active Changes, and archived Changes.
+ */
+declare function generateOpenSpecSidebar(specDir: string, options?: {
+    outDir?: string;
+}): SidebarItem[];
+/**
+ * Returns a VitePress nav entry for the OpenSpec documentation section.
+ */
+declare function openspecNav(specDir: string, options?: {
+    outDir?: string;
+    text?: string;
+}): NavItem;
+
+export { type CapabilitySpec, type Change, type ChangeArtifact, type NavItem, type OpenSpecFolder, type OpenSpecPluginOptions, type SidebarItem, openspec as default, generateOpenSpecPages, generateOpenSpecSidebar, openspec, openspecNav };

package/dist/index.d.ts

@@ -0,0 +1,160 @@
+import { Plugin } from 'vite';
+
+/**
+ * Configuration options for the vitepress-plugin-openspec plugin.
+ */
+interface OpenSpecPluginOptions {
+    /**
+     * Path to the openspec/ directory of the project.
+     * @default './openspec'
+     */
+    specDir?: string;
+    /**
+     * Output directory (relative to VitePress `srcDir`) where the generated
+     * Markdown pages will be written.
+     * @default 'openspec'
+     */
+    outDir?: string;
+    /**
+     * VitePress source directory — the directory containing your `.md` files
+     * (i.e. the `docs/` folder). Required when calling `generateOpenSpecPages()`
+     * at config evaluation time so it knows where to write the generated files.
+     *
+     * @default process.cwd()
+     * @example path.resolve(__dirname, '..')  // from docs/.vitepress/config.ts
+     */
+    srcDir?: string;
+}
+/**
+ * A canonical capability specification from openspec/specs/<name>/spec.md
+ */
+interface CapabilitySpec {
+    /** Folder name (kebab-case capability identifier) */
+    name: string;
+    /** Optional display title from spec.md frontmatter. Overrides humanized name. */
+    title?: string;
+    /** Absolute path to the spec.md file */
+    specPath: string;
+    /** Raw Markdown content of the spec */
+    content: string;
+}
+/**
+ * A single artifact (file) belonging to a Change.
+ */
+type ChangeArtifact = 'proposal' | 'design' | 'tasks';
+/**
+ * An OpenSpec change (active or archived).
+ */
+interface Change {
+    /** Change directory name (e.g. "my-feature" or for archived: "my-feature" extracted from "2026-03-10-my-feature") */
+    name: string;
+    /** Optional display title from .openspec.yaml. Overrides humanized name. */
+    title?: string;
+    /** Absolute path to the change directory */
+    dir: string;
+    /** Which artifact files are present */
+    artifacts: ChangeArtifact[];
+    /** Creation date from .openspec.yaml, if available */
+    createdDate?: string;
+    /** For archived changes: the archive date (YYYY-MM-DD) parsed from directory name */
+    archivedDate?: string;
+    /**
+     * For archived changes: the original archive folder name (e.g. "2026-01-15-my-feature" or
+     * "legacy-feature" for non-standard names). Used to build correct archive URLs.
+     */
+    archiveFolderName?: string;
+}
+/**
+ * The full parsed structure of an openspec/ directory.
+ */
+interface OpenSpecFolder {
+    /** Absolute path to the openspec/ root */
+    dir: string;
+    /** Canonical capability specs from openspec/specs/ */
+    specs: CapabilitySpec[];
+    /** Active changes from openspec/changes/ (excluding archive/) */
+    changes: Change[];
+    /** Archived changes from openspec/changes/archive/ */
+    archivedChanges: Change[];
+}
+/**
+ * A nav item compatible with VitePress `DefaultTheme.NavItem`.
+ */
+interface NavItem {
+    text: string;
+    link: string;
+}
+/**
+ * A sidebar item compatible with VitePress `DefaultTheme.SidebarItem`.
+ */
+interface SidebarItem {
+    text: string;
+    link?: string;
+    collapsed?: boolean;
+    items?: SidebarItem[];
+}
+
+/**
+ * Synchronously generates all VitePress Markdown pages from the openspec/
+ * directory and writes them to disk.
+ *
+ * Call this at the top of your `docs/.vitepress/config.ts` **before**
+ * `defineConfig()` so the files exist when VitePress scans the source
+ * directory for routes.
+ *
+ * @example
+ * ```typescript
+ * // docs/.vitepress/config.ts
+ * import { defineConfig } from 'vitepress'
+ * import path from 'node:path'
+ * import { fileURLToPath } from 'node:url'
+ * import openspec, { generateOpenSpecPages } from 'vitepress-plugin-openspec'
+ *
+ * const __dirname = path.dirname(fileURLToPath(import.meta.url))
+ * const specDir = path.resolve(__dirname, '../../openspec')
+ *
+ * // Generate pages before VitePress scans srcDir for routes
+ * generateOpenSpecPages({ specDir, outDir: 'openspec', srcDir: path.resolve(__dirname, '..') })
+ *
+ * export default defineConfig({ ... })
+ * ```
+ */
+declare function generateOpenSpecPages(userOptions?: OpenSpecPluginOptions): void;
+/**
+ * VitePress plugin that reads an openspec/ directory and generates structured
+ * Markdown documentation pages inside the VitePress source directory.
+ *
+ * For the pages to be available on the first build (including CI), also call
+ * `generateOpenSpecPages()` at the top of your `config.ts` before `defineConfig`.
+ *
+ * @example
+ * ```typescript
+ * // .vitepress/config.ts
+ * import { defineConfig } from 'vitepress'
+ * import openspec, { generateOpenSpecPages } from 'vitepress-plugin-openspec'
+ *
+ * generateOpenSpecPages({ specDir, outDir: 'openspec', srcDir: path.resolve(__dirname, '..') })
+ *
+ * export default defineConfig({
+ *   vite: { plugins: [openspec({ specDir: './openspec', outDir: 'project-docs' })] },
+ * })
+ * ```
+ */
+declare function openspec(userOptions?: OpenSpecPluginOptions): Plugin;
+
+/**
+ * Returns a VitePress sidebar configuration for the OpenSpec documentation.
+ * Includes groups for Specifications, active Changes, and archived Changes.
+ */
+declare function generateOpenSpecSidebar(specDir: string, options?: {
+    outDir?: string;
+}): SidebarItem[];
+/**
+ * Returns a VitePress nav entry for the OpenSpec documentation section.
+ */
+declare function openspecNav(specDir: string, options?: {
+    outDir?: string;
+    text?: string;
+}): NavItem;
+
+export { type CapabilitySpec, type Change, type ChangeArtifact, type NavItem, type OpenSpecFolder, type OpenSpecPluginOptions, type SidebarItem, openspec as default, generateOpenSpecPages, generateOpenSpecSidebar, openspec, openspecNav };

package/dist/index.js

@@ -0,0 +1,387 @@
+import fs from 'fs';
+import path2 from 'path';
+import pc from 'picocolors';
+import yaml from 'js-yaml';
+
+// src/plugin.ts
+function readOpenSpecYaml(dir) {
+  const yamlPath = path2.join(dir, ".openspec.yaml");
+  if (!fs.existsSync(yamlPath)) return {};
+  try {
+    return yaml.load(fs.readFileSync(yamlPath, "utf-8")) ?? {};
+  } catch {
+    return {};
+  }
+}
+var ACRONYM_DICT = {
+  api: "API",
+  rest: "REST",
+  graphql: "GraphQL",
+  grpc: "gRPC",
+  openapi: "OpenAPI",
+  oauth: "OAuth",
+  oauth2: "OAuth2",
+  http: "HTTP",
+  https: "HTTPS",
+  url: "URL",
+  uri: "URI",
+  sdk: "SDK",
+  ui: "UI",
+  ux: "UX",
+  id: "ID",
+  db: "DB",
+  sql: "SQL",
+  css: "CSS",
+  html: "HTML",
+  json: "JSON",
+  yaml: "YAML",
+  xml: "XML",
+  jwt: "JWT",
+  ci: "CI",
+  cd: "CD"
+};
+function humanizeLabel(name) {
+  if (!name) return "";
+  return name.split("-").map((word) => {
+    if (/^v\d+$/.test(word)) return word;
+    return ACRONYM_DICT[word] ?? word.charAt(0).toUpperCase() + word.slice(1);
+  }).join(" ");
+}
+function parseFrontmatterTitle(content) {
+  const match = content.match(/^---\s*\n(?:.*\n)*?title:\s*['"]?([^\n'"]+)['"]?\s*\n/);
+  return match?.[1]?.trim() || void 0;
+}
+function formatDate(val) {
+  if (!val) return void 0;
+  if (val instanceof Date) return val.toISOString().slice(0, 10);
+  return String(val);
+}
+function readArtifacts(dir) {
+  const artifacts = [];
+  for (const name of ["proposal", "design", "tasks"]) {
+    if (fs.existsSync(path2.join(dir, `${name}.md`))) artifacts.push(name);
+  }
+  return artifacts;
+}
+function readOpenSpecFolder(dir) {
+  const resolved = path2.resolve(dir);
+  if (!fs.existsSync(resolved)) {
+    throw new Error(`[vitepress-plugin-openspec] openspec directory not found: ${resolved}`);
+  }
+  const specs = [];
+  const specsDir = path2.join(resolved, "specs");
+  if (fs.existsSync(specsDir)) {
+    for (const entry of fs.readdirSync(specsDir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      const specPath = path2.join(specsDir, entry.name, "spec.md");
+      if (!fs.existsSync(specPath)) continue;
+      const content = fs.readFileSync(specPath, "utf-8");
+      specs.push({
+        name: entry.name,
+        title: parseFrontmatterTitle(content),
+        specPath,
+        content
+      });
+    }
+  }
+  const changes = [];
+  const changesDir = path2.join(resolved, "changes");
+  if (fs.existsSync(changesDir)) {
+    for (const entry of fs.readdirSync(changesDir, { withFileTypes: true })) {
+      if (!entry.isDirectory() || entry.name === "archive") continue;
+      const changeDir = path2.join(changesDir, entry.name);
+      if (!fs.existsSync(path2.join(changeDir, ".openspec.yaml"))) continue;
+      const meta = readOpenSpecYaml(changeDir);
+      changes.push({
+        name: entry.name,
+        title: meta.title ? String(meta.title) : void 0,
+        dir: changeDir,
+        artifacts: readArtifacts(changeDir),
+        createdDate: formatDate(meta.created)
+      });
+    }
+  }
+  const archivedChanges = [];
+  const archiveDir = path2.join(changesDir, "archive");
+  if (fs.existsSync(archiveDir)) {
+    for (const entry of fs.readdirSync(archiveDir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      const changeDir = path2.join(archiveDir, entry.name);
+      const match = entry.name.match(/^(\d{4}-\d{2}-\d{2})-(.+)$/);
+      const archivedDate = match?.[1];
+      const name = match?.[2] ?? entry.name;
+      const meta = readOpenSpecYaml(changeDir);
+      archivedChanges.push({
+        name,
+        title: meta.title ? String(meta.title) : void 0,
+        dir: changeDir,
+        artifacts: readArtifacts(changeDir),
+        createdDate: formatDate(meta.created),
+        archivedDate,
+        archiveFolderName: entry.name
+      });
+    }
+  }
+  return { dir: resolved, specs, changes, archivedChanges };
+}
+function extractSpecDescription(content) {
+  const reqMatch = content.match(/^### Requirement:[^\n]*\n+([\s\S]*?)(?=\n#{1,4} |\n*$)/m);
+  if (!reqMatch) return void 0;
+  const para = reqMatch[1].trim();
+  if (!para) return void 0;
+  const sentenceMatch = para.match(/^([^.?!]+[.?!])/);
+  if (!sentenceMatch) return void 0;
+  let sentence = sentenceMatch[1].trim();
+  if (sentence.length > 160) {
+    const cut = sentence.lastIndexOf(" ", 160);
+    sentence = (cut > 0 ? sentence.slice(0, cut) : sentence.slice(0, 160)) + "\u2026";
+  }
+  return sentence.replace(/"/g, '\\"');
+}
+function stripDeltaMarkers(content) {
+  const stripped = content.split("\n").filter((line) => !/^## (ADDED|MODIFIED|REMOVED) Requirements\s*$/.test(line)).join("\n");
+  return stripped.replace(/\n{3,}/g, "\n\n");
+}
+function transformScenarios(content) {
+  const lines = content.split("\n");
+  const result = [];
+  let inScenario = false;
+  for (const line of lines) {
+    const scenarioMatch = line.match(/^#### Scenario: (.+)$/);
+    const isHeading = /^#{1,6} /.test(line);
+    if (scenarioMatch) {
+      if (inScenario) result.push(":::");
+      result.push(`:::details ${scenarioMatch[1]}`);
+      inScenario = true;
+    } else if (isHeading && inScenario) {
+      result.push(":::");
+      result.push("");
+      result.push(line);
+      inScenario = false;
+    } else {
+      result.push(line);
+    }
+  }
+  if (inScenario) result.push(":::");
+  return result.join("\n");
+}
+function generateSpecPage(spec) {
+  const description = extractSpecDescription(spec.content);
+  const transformed = transformScenarios(stripDeltaMarkers(spec.content));
+  const lines = [];
+  if (description) {
+    lines.push("---");
+    lines.push(`description: "${description}"`);
+    lines.push("---");
+    lines.push("");
+  }
+  lines.push(`# ${spec.title ?? humanizeLabel(spec.name)}`);
+  lines.push("");
+  lines.push(transformed.trimEnd());
+  lines.push("");
+  return lines.join("\n");
+}
+function generateSpecsIndexPage(specs, outDir) {
+  const lines = [];
+  lines.push("# Specifications");
+  lines.push("");
+  lines.push("Canonical capability specifications for this project.");
+  lines.push("");
+  if (specs.length === 0) {
+    lines.push("*No specifications defined yet.*");
+  } else {
+    for (const spec of specs) {
+      lines.push(`- [${spec.title ?? humanizeLabel(spec.name)}](/${outDir}/specs/${spec.name}/)`);
+    }
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function generateChangeIndexPage(change, outDir) {
+  const lines = [];
+  lines.push(`# ${change.title ?? humanizeLabel(change.name)}`);
+  lines.push("");
+  if (change.createdDate) {
+    lines.push(`**Created:** ${change.createdDate}`);
+    lines.push("");
+  }
+  if (change.archivedDate) {
+    lines.push(`**Archived:** ${change.archivedDate}`);
+    lines.push("");
+  }
+  lines.push("## Artifacts");
+  lines.push("");
+  const prefix = change.archiveFolderName ? `/${outDir}/changes/archive/${change.archiveFolderName}` : `/${outDir}/changes/${change.name}`;
+  for (const artifact of change.artifacts) {
+    const label = artifact.charAt(0).toUpperCase() + artifact.slice(1);
+    lines.push(`- [${label}](${prefix}/${artifact})`);
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function generateChangesIndexPage(folder, outDir) {
+  const lines = [];
+  lines.push("# Changes");
+  lines.push("");
+  if (folder.changes.length === 0) {
+    lines.push("*No active changes.*");
+  } else {
+    lines.push("## Active");
+    lines.push("");
+    for (const change of folder.changes) {
+      const date = change.createdDate ? ` *(${change.createdDate})*` : "";
+      lines.push(`- [${change.title ?? humanizeLabel(change.name)}](/${outDir}/changes/${change.name}/)${date}`);
+    }
+  }
+  if (folder.archivedChanges.length > 0) {
+    lines.push("");
+    lines.push("## Archiv");
+    lines.push("");
+    for (const change of folder.archivedChanges) {
+      const date = change.archivedDate ? ` *(archiviert: ${change.archivedDate})*` : "";
+      lines.push(
+        `- [${change.title ?? humanizeLabel(change.name)}](/${outDir}/changes/archive/${change.archiveFolderName}/)${date}`
+      );
+    }
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function changeItems(change, outDir, isArchived = false) {
+  const prefix = isArchived ? `/${outDir}/changes/archive/${change.archiveFolderName}` : `/${outDir}/changes/${change.name}`;
+  return change.artifacts.map((a) => ({
+    text: a.charAt(0).toUpperCase() + a.slice(1),
+    link: `${prefix}/${a}`
+  }));
+}
+function generateOpenSpecSidebar(specDir, options = {}) {
+  const outDir = options.outDir ?? "openspec";
+  const folder = readOpenSpecFolder(specDir);
+  const groups = [];
+  groups.push({
+    text: "Specifications",
+    collapsed: false,
+    items: [
+      { text: "Overview", link: `/${outDir}/specs/` },
+      ...folder.specs.map((s) => ({ text: s.title ?? humanizeLabel(s.name), link: `/${outDir}/specs/${s.name}/` }))
+    ]
+  });
+  groups.push({
+    text: "Changes",
+    collapsed: false,
+    items: [
+      { text: "Overview", link: `/${outDir}/changes/` },
+      ...folder.changes.map((c) => ({
+        text: c.title ?? humanizeLabel(c.name),
+        collapsed: true,
+        items: changeItems(c, outDir)
+      }))
+    ]
+  });
+  if (folder.archivedChanges.length > 0) {
+    groups.push({
+      text: "Archiv",
+      collapsed: true,
+      items: folder.archivedChanges.map((c) => ({
+        text: c.title ?? humanizeLabel(c.name),
+        collapsed: true,
+        items: changeItems(c, outDir, true)
+      }))
+    });
+  }
+  return groups;
+}
+function openspecNav(specDir, options = {}) {
+  const outDir = options.outDir ?? "openspec";
+  if (!fs.existsSync(path2.resolve(specDir))) {
+    throw new Error(
+      `[vitepress-plugin-openspec] openspec directory not found: ${path2.resolve(specDir)}`
+    );
+  }
+  return {
+    text: options.text ?? "Docs",
+    link: `/${outDir}/`
+  };
+}
+
+// src/plugin.ts
+var PLUGIN_NAME = "vitepress-plugin-openspec";
+function writeFile(filePath, content) {
+  fs.mkdirSync(path2.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, content, "utf-8");
+}
+function copyFile(src, dest) {
+  fs.mkdirSync(path2.dirname(dest), { recursive: true });
+  fs.copyFileSync(src, dest);
+}
+function generateOpenSpecPages(userOptions = {}) {
+  const specDir = userOptions.specDir ?? "./openspec";
+  const outDir = userOptions.outDir ?? "openspec";
+  const srcDir = userOptions.srcDir ?? process.cwd();
+  const absoluteOutDir = path2.resolve(srcDir, outDir);
+  try {
+    const folder = readOpenSpecFolder(specDir);
+    for (const spec of folder.specs) {
+      const dest = path2.join(absoluteOutDir, "specs", spec.name, "index.md");
+      writeFile(dest, generateSpecPage(spec));
+    }
+    writeFile(
+      path2.join(absoluteOutDir, "specs", "index.md"),
+      generateSpecsIndexPage(folder.specs, outDir)
+    );
+    for (const change of folder.changes) {
+      writeChangePage(change, absoluteOutDir, outDir, false);
+    }
+    for (const change of folder.archivedChanges) {
+      writeChangePage(change, absoluteOutDir, outDir, true);
+    }
+    writeFile(
+      path2.join(absoluteOutDir, "changes", "index.md"),
+      generateChangesIndexPage(folder, outDir)
+    );
+    const rootIndex = [
+      "# Project Documentation",
+      "",
+      "This section is generated from the project's [OpenSpec](https://openspec.dev/) folder.",
+      "OpenSpec is a lightweight, file-based workflow for spec-driven development \u2014",
+      "it structures your project's capability specifications and change proposals as plain Markdown files.",
+      "",
+      `- [Specifications](/${outDir}/specs/) \u2014 canonical capability specs`,
+      `- [Changes](/${outDir}/changes/) \u2014 active and archived change proposals`,
+      ""
+    ].join("\n");
+    writeFile(path2.join(absoluteOutDir, "index.md"), rootIndex);
+    console.log(
+      `${pc.bold(pc.cyan(`[${PLUGIN_NAME}]`))} Generated docs from ${pc.cyan(specDir)}: ${pc.green(String(folder.specs.length))} spec(s), ${pc.green(String(folder.changes.length))} change(s), ${pc.green(String(folder.archivedChanges.length))} archived`
+    );
+  } catch (err) {
+    console.error(
+      `${pc.bold(pc.red(`[${PLUGIN_NAME}]`))} Failed to process openspec directory "${specDir}": ${String(err)}`
+    );
+  }
+}
+function openspec(userOptions = {}) {
+  return {
+    name: PLUGIN_NAME,
+    enforce: "pre",
+    configResolved(resolvedConfig) {
+      const vpConfig = resolvedConfig.vitepress;
+      const srcDir = userOptions.srcDir ?? vpConfig?.srcDir ?? resolvedConfig.root ?? process.cwd();
+      generateOpenSpecPages({ ...userOptions, srcDir });
+    }
+  };
+}
+function writeChangePage(change, absoluteOutDir, outDir, isArchived) {
+  const subPath = isArchived ? path2.join("changes", "archive", `${change.archivedDate}-${change.name}`) : path2.join("changes", change.name);
+  const changeOutDir = path2.join(absoluteOutDir, subPath);
+  writeFile(path2.join(changeOutDir, "index.md"), generateChangeIndexPage(change, outDir));
+  for (const artifact of change.artifacts) {
+    const srcFile = path2.join(change.dir, `${artifact}.md`);
+    const destFile = path2.join(changeOutDir, `${artifact}.md`);
+    copyFile(srcFile, destFile);
+  }
+}
+
+export { openspec as default, generateOpenSpecPages, generateOpenSpecSidebar, openspec, openspecNav };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map