@swarmvaultai/engine 0.1.7 → 0.1.8

package/dist/index.d.ts

@@ -688,6 +688,10 @@ declare function createProvider(id: string, config: ProviderConfig, rootDir: str
 declare function getProviderForTask(rootDir: string, task: keyof Awaited<ReturnType<typeof loadVaultConfig>>["config"]["tasks"]): Promise<ProviderAdapter>;
 declare function assertProviderCapability(provider: ProviderAdapter, capability: ProviderCapability): void;
 
+declare function listSchedules(rootDir: string): Promise<ScheduleStateRecord[]>;
+declare function runSchedule(rootDir: string, jobId: string): Promise<ScheduledRunResult>;
+declare function serveSchedules(rootDir: string, pollMs?: number): Promise<ScheduleController>;
+
 interface VaultSchema {
     path: string;
     content: string;
@@ -747,10 +751,6 @@ declare function startGraphServer(rootDir: string, port?: number): Promise<{
 }>;
 declare function exportGraphHtml(rootDir: string, outputPath: string): Promise<string>;
 
-declare function listSchedules(rootDir: string): Promise<ScheduleStateRecord[]>;
-declare function runSchedule(rootDir: string, jobId: string): Promise<ScheduledRunResult>;
-declare function serveSchedules(rootDir: string, pollMs?: number): Promise<ScheduleController>;
-
 declare function watchVault(rootDir: string, options?: WatchOptions): Promise<WatchController>;
 
 declare function createWebSearchAdapter(id: string, config: WebSearchProviderConfig, rootDir: string): Promise<WebSearchAdapter>;

package/dist/index.js

@@ -1410,8 +1410,8 @@ import matter2 from "gray-matter";
 import { z as z4 } from "zod";
 
 // src/orchestration.ts
-import path7 from "path";
 import { spawn } from "child_process";
+import path7 from "path";
 import { z as z2 } from "zod";
 var orchestrationRoleResultSchema = z2.object({
   summary: z2.string().optional(),
@@ -1982,199 +1982,6 @@ async function runDeepLint(rootDir, structuralFindings, options = {}) {
   );
 }
 
-// src/output-artifacts.ts
-import { z as z5 } from "zod";
-function escapeXml(value) {
-  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-}
-function clampNumber(value, min, max) {
-  return Math.min(max, Math.max(min, value));
-}
-var chartSpecSchema = z5.object({
-  kind: z5.enum(["bar", "line"]).default("bar"),
-  title: z5.string().min(1),
-  subtitle: z5.string().optional(),
-  xLabel: z5.string().optional(),
-  yLabel: z5.string().optional(),
-  seriesLabel: z5.string().optional(),
-  data: z5.array(
-    z5.object({
-      label: z5.string().min(1),
-      value: z5.number().finite()
-    })
-  ).min(2).max(12),
-  notes: z5.array(z5.string().min(1)).max(5).optional()
-});
-var sceneSpecSchema = z5.object({
-  title: z5.string().min(1),
-  alt: z5.string().min(1),
-  background: z5.string().optional(),
-  width: z5.number().int().positive().max(2400).optional(),
-  height: z5.number().int().positive().max(2400).optional(),
-  elements: z5.array(
-    z5.object({
-      kind: z5.enum(["shape", "label"]),
-      shape: z5.enum(["rect", "circle", "line"]).optional(),
-      x: z5.number().finite(),
-      y: z5.number().finite(),
-      width: z5.number().finite().optional(),
-      height: z5.number().finite().optional(),
-      radius: z5.number().finite().optional(),
-      text: z5.string().optional(),
-      fontSize: z5.number().finite().optional(),
-      fill: z5.string().optional(),
-      stroke: z5.string().optional(),
-      strokeWidth: z5.number().finite().optional(),
-      opacity: z5.number().finite().optional()
-    })
-  ).min(1).max(32)
-});
-function renderChartSvg(spec) {
-  const width = 1200;
-  const height = 720;
-  const margin = { top: 110, right: 80, bottom: 110, left: 110 };
-  const chartWidth = width - margin.left - margin.right;
-  const chartHeight = height - margin.top - margin.bottom;
-  const values = spec.data.map((item) => item.value);
-  const maxValue = Math.max(...values, 1);
-  const minValue = Math.min(...values, 0);
-  const domainMin = Math.min(0, minValue);
-  const domainMax = maxValue <= domainMin ? domainMin + 1 : maxValue;
-  const ticks = 5;
-  const tickValues = Array.from({ length: ticks + 1 }, (_, index) => domainMin + (domainMax - domainMin) * index / ticks);
-  const projectY = (value) => margin.top + chartHeight - (value - domainMin) / (domainMax - domainMin || 1) * chartHeight;
-  const zeroY = projectY(0);
-  const step = chartWidth / Math.max(1, spec.data.length);
-  const barWidth = Math.min(84, step * 0.6);
-  const points = spec.data.map((item, index) => {
-    const centerX = margin.left + step * index + step / 2;
-    const y = projectY(item.value);
-    return { ...item, centerX, y };
-  });
-  const gridLines = tickValues.map((value) => {
-    const y = projectY(value);
-    return [
-      `<line x1="${margin.left}" y1="${y}" x2="${width - margin.right}" y2="${y}" stroke="#dbe4ec" stroke-width="1" />`,
-      `<text x="${margin.left - 16}" y="${y + 4}" text-anchor="end" font-size="14" fill="#475569">${escapeXml(value.toFixed(0))}</text>`
-    ].join("");
-  }).join("");
-  const bars = spec.kind === "bar" ? points.map((point) => {
-    const top = Math.min(point.y, zeroY);
-    const barHeight = Math.max(8, Math.abs(zeroY - point.y));
-    return [
-      `<rect x="${point.centerX - barWidth / 2}" y="${top}" width="${barWidth}" height="${barHeight}" rx="12" fill="#0ea5e9" opacity="0.92" />`,
-      `<text x="${point.centerX}" y="${top - 10}" text-anchor="middle" font-size="13" fill="#0f172a">${escapeXml(
-        point.value.toFixed(0)
-      )}</text>`
-    ].join("");
-  }).join("") : "";
-  const linePath = spec.kind === "line" ? points.map((point, index) => `${index === 0 ? "M" : "L"} ${point.centerX} ${point.y}`).join(" ") : "";
-  const lineMarks = spec.kind === "line" ? [
-    `<path d="${linePath}" fill="none" stroke="#0ea5e9" stroke-width="5" stroke-linecap="round" stroke-linejoin="round" />`,
-    ...points.map(
-      (point) => `<circle cx="${point.centerX}" cy="${point.y}" r="8" fill="#f8fafc" stroke="#0ea5e9" stroke-width="4" />
-               <text x="${point.centerX}" y="${point.y - 18}" text-anchor="middle" font-size="13" fill="#0f172a">${escapeXml(
-        point.value.toFixed(0)
-      )}</text>`
-    )
-  ].join("") : "";
-  const labels = points.map(
-    (point) => `<text x="${point.centerX}" y="${height - margin.bottom + 28}" text-anchor="middle" font-size="14" fill="#334155">${escapeXml(
-      point.label
-    )}</text>`
-  ).join("");
-  const notes = (spec.notes ?? []).map((note, index) => `<text x="${margin.left}" y="${height - 26 - index * 18}" font-size="13" fill="#475569">${escapeXml(note)}</text>`).join("");
-  const svg = [
-    `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeXml(spec.title)}">`,
-    '<rect width="100%" height="100%" fill="#f8fafc" />',
-    `<text x="${margin.left}" y="56" font-size="34" font-weight="700" fill="#0f172a">${escapeXml(spec.title)}</text>`,
-    spec.subtitle ? `<text x="${margin.left}" y="86" font-size="18" fill="#475569">${escapeXml(spec.subtitle)}</text>` : "",
-    gridLines,
-    `<line x1="${margin.left}" y1="${zeroY}" x2="${width - margin.right}" y2="${zeroY}" stroke="#0f172a" stroke-width="2" />`,
-    `<line x1="${margin.left}" y1="${margin.top}" x2="${margin.left}" y2="${height - margin.bottom}" stroke="#0f172a" stroke-width="2" />`,
-    bars,
-    lineMarks,
-    labels,
-    spec.xLabel ? `<text x="${margin.left + chartWidth / 2}" y="${height - 46}" text-anchor="middle" font-size="15" fill="#475569">${escapeXml(spec.xLabel)}</text>` : "",
-    spec.yLabel ? `<text x="34" y="${margin.top + chartHeight / 2}" text-anchor="middle" font-size="15" fill="#475569" transform="rotate(-90 34 ${margin.top + chartHeight / 2})">${escapeXml(spec.yLabel)}</text>` : "",
-    spec.seriesLabel ? `<text x="${width - margin.right}" y="56" text-anchor="end" font-size="15" fill="#475569">${escapeXml(spec.seriesLabel)}</text>` : "",
-    notes,
-    "</svg>"
-  ].filter(Boolean).join("");
-  return { svg, width, height };
-}
-function renderSceneSvg(spec) {
-  const width = clampNumber(spec.width ?? 1200, 480, 1600);
-  const height = clampNumber(spec.height ?? 720, 320, 1200);
-  const elements = spec.elements.map((element) => {
-    const opacity = element.opacity === void 0 ? 1 : clampNumber(element.opacity, 0, 1);
-    if (element.kind === "label") {
-      return `<text x="${element.x}" y="${element.y}" font-size="${clampNumber(element.fontSize ?? 28, 10, 72)}" fill="${escapeXml(
-        element.fill ?? "#0f172a"
-      )}" opacity="${opacity}" font-family="'Avenir Next', 'Segoe UI', sans-serif">${escapeXml(element.text ?? "")}</text>`;
-    }
-    switch (element.shape) {
-      case "circle":
-        return `<circle cx="${element.x}" cy="${element.y}" r="${Math.max(6, element.radius ?? 40)}" fill="${escapeXml(
-          element.fill ?? "#dbeafe"
-        )}" stroke="${escapeXml(element.stroke ?? "#0ea5e9")}" stroke-width="${Math.max(1, element.strokeWidth ?? 2)}" opacity="${opacity}" />`;
-      case "line":
-        return `<line x1="${element.x}" y1="${element.y}" x2="${element.x + (element.width ?? 120)}" y2="${element.y + (element.height ?? 0)}" stroke="${escapeXml(element.stroke ?? "#475569")}" stroke-width="${Math.max(1, element.strokeWidth ?? 3)}" opacity="${opacity}" />`;
-      case "rect":
-      default:
-        return `<rect x="${element.x}" y="${element.y}" width="${Math.max(8, element.width ?? 160)}" height="${Math.max(
-          8,
-          element.height ?? 120
-        )}" rx="22" fill="${escapeXml(element.fill ?? "#e2e8f0")}" stroke="${escapeXml(element.stroke ?? "#94a3b8")}" stroke-width="${Math.max(
-          1,
-          element.strokeWidth ?? 2
-        )}" opacity="${opacity}" />`;
-    }
-  }).join("");
-  const svg = [
-    `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeXml(
-      spec.alt
-    )}">`,
-    `<rect width="100%" height="100%" fill="${escapeXml(spec.background ?? "#f8fafc")}" />`,
-    `<text x="48" y="64" font-size="34" font-weight="700" fill="#0f172a">${escapeXml(spec.title)}</text>`,
-    elements,
-    `</svg>`
-  ].join("");
-  return { svg, width, height };
-}
-function renderRasterPosterSvg(input) {
-  const width = clampNumber(input.width ?? 1200, 480, 1600);
-  const height = clampNumber(input.height ?? 720, 320, 1200);
-  const inset = 42;
-  const svg = [
-    `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeXml(
-      input.alt
-    )}">`,
-    '<rect width="100%" height="100%" fill="#f8fafc" />',
-    `<text x="${inset}" y="56" font-size="34" font-weight="700" fill="#0f172a">${escapeXml(input.title)}</text>`,
-    `<image href="${escapeXml(input.rasterFileName)}" x="${inset}" y="92" width="${width - inset * 2}" height="${height - 148}" preserveAspectRatio="xMidYMid meet" />`,
-    `</svg>`
-  ].join("");
-  return { svg, width, height };
-}
-function buildOutputAssetManifest(input) {
-  return `${JSON.stringify(
-    {
-      slug: input.slug,
-      format: input.format,
-      question: input.question,
-      title: input.title,
-      answer: input.answer,
-      citations: input.citations,
-      assets: input.assets,
-      spec: input.spec
-    },
-    null,
-    2
-  )}
-`;
-}
-
 // src/markdown.ts
 import matter3 from "gray-matter";
 function uniqueStrings(values) {
@@ -2804,10 +2611,7 @@ function buildOutputPage(input) {
       ] : input.outputFormat === "chart" || input.outputFormat === "image" ? [
         `# ${input.title ?? input.question}`,
         "",
-        ...primaryOutputAsset(outputAssets) ? [
-          `![${input.title ?? input.question}](${assetMarkdownPath(primaryOutputAsset(outputAssets)?.path ?? "")})`,
-          ""
-        ] : [],
+        ...primaryOutputAsset(outputAssets) ? [`![${input.title ?? input.question}](${assetMarkdownPath(primaryOutputAsset(outputAssets)?.path ?? "")})`, ""] : [],
         input.answer,
         "",
         ...outputAssetSection(outputAssets),
@@ -2939,10 +2743,7 @@ function buildExploreHubPage(input) {
       ] : input.outputFormat === "chart" || input.outputFormat === "image" ? [
         `# ${title}`,
         "",
-        ...primaryOutputAsset(outputAssets) ? [
-          `![${title}](${assetMarkdownPath(primaryOutputAsset(outputAssets)?.path ?? "")})`,
-          ""
-        ] : [],
+        ...primaryOutputAsset(outputAssets) ? [`![${title}](${assetMarkdownPath(primaryOutputAsset(outputAssets)?.path ?? "")})`, ""] : [],
         "## Root Question",
         "",
         input.question,
@@ -2986,63 +2787,257 @@ function buildExploreHubPage(input) {
   };
 }
 
-// src/outputs.ts
-import fs7 from "fs/promises";
-import path11 from "path";
-import matter5 from "gray-matter";
-
-// src/pages.ts
-import fs6 from "fs/promises";
-import path10 from "path";
-import matter4 from "gray-matter";
-function normalizeStringArray(value) {
-  return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
-}
-function normalizeProjectIds(value) {
-  return normalizeStringArray(value);
-}
-function normalizeSourceHashes(value) {
-  if (!value || typeof value !== "object") {
-    return {};
-  }
-  return Object.fromEntries(
-    Object.entries(value).filter((entry) => typeof entry[0] === "string" && typeof entry[1] === "string")
-  );
-}
-function normalizePageStatus(value, fallback = "active") {
-  return value === "draft" || value === "candidate" || value === "active" || value === "archived" ? value : fallback;
-}
-function normalizePageManager(value, fallback = "system") {
-  return value === "human" || value === "system" ? value : fallback;
+// src/output-artifacts.ts
+import { z as z5 } from "zod";
+function escapeXml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 }
-function normalizeOutputFormat(value, fallback = "markdown") {
-  return value === "report" || value === "slides" || value === "chart" || value === "image" ? value : fallback;
+function clampNumber(value, min, max) {
+  return Math.min(max, Math.max(min, value));
 }
-function normalizeOutputAssets(value) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  return value.reduce((assets, item) => {
-    if (!item || typeof item !== "object") {
-      return assets;
-    }
-    const candidate = item;
-    const id = typeof candidate.id === "string" ? candidate.id : "";
-    const role = candidate.role;
-    const assetPath = typeof candidate.path === "string" ? candidate.path : "";
-    const mimeType = typeof candidate.mimeType === "string" ? candidate.mimeType : "";
-    if (!id || !assetPath || !mimeType || role !== "primary" && role !== "preview" && role !== "manifest" && role !== "poster") {
-      return assets;
-    }
-    assets.push({
-      id,
-      role,
-      path: assetPath,
-      mimeType,
-      width: typeof candidate.width === "number" ? candidate.width : void 0,
-      height: typeof candidate.height === "number" ? candidate.height : void 0,
-      dataPath: typeof candidate.dataPath === "string" ? candidate.dataPath : void 0
-    });
+var chartSpecSchema = z5.object({
+  kind: z5.enum(["bar", "line"]).default("bar"),
+  title: z5.string().min(1),
+  subtitle: z5.string().optional(),
+  xLabel: z5.string().optional(),
+  yLabel: z5.string().optional(),
+  seriesLabel: z5.string().optional(),
+  data: z5.array(
+    z5.object({
+      label: z5.string().min(1),
+      value: z5.number().finite()
+    })
+  ).min(2).max(12),
+  notes: z5.array(z5.string().min(1)).max(5).optional()
+});
+var sceneSpecSchema = z5.object({
+  title: z5.string().min(1),
+  alt: z5.string().min(1),
+  background: z5.string().optional(),
+  width: z5.number().int().positive().max(2400).optional(),
+  height: z5.number().int().positive().max(2400).optional(),
+  elements: z5.array(
+    z5.object({
+      kind: z5.enum(["shape", "label"]),
+      shape: z5.enum(["rect", "circle", "line"]).optional(),
+      x: z5.number().finite(),
+      y: z5.number().finite(),
+      width: z5.number().finite().optional(),
+      height: z5.number().finite().optional(),
+      radius: z5.number().finite().optional(),
+      text: z5.string().optional(),
+      fontSize: z5.number().finite().optional(),
+      fill: z5.string().optional(),
+      stroke: z5.string().optional(),
+      strokeWidth: z5.number().finite().optional(),
+      opacity: z5.number().finite().optional()
+    })
+  ).min(1).max(32)
+});
+function renderChartSvg(spec) {
+  const width = 1200;
+  const height = 720;
+  const margin = { top: 110, right: 80, bottom: 110, left: 110 };
+  const chartWidth = width - margin.left - margin.right;
+  const chartHeight = height - margin.top - margin.bottom;
+  const values = spec.data.map((item) => item.value);
+  const maxValue = Math.max(...values, 1);
+  const minValue = Math.min(...values, 0);
+  const domainMin = Math.min(0, minValue);
+  const domainMax = maxValue <= domainMin ? domainMin + 1 : maxValue;
+  const ticks = 5;
+  const tickValues = Array.from({ length: ticks + 1 }, (_, index) => domainMin + (domainMax - domainMin) * index / ticks);
+  const projectY = (value) => margin.top + chartHeight - (value - domainMin) / (domainMax - domainMin || 1) * chartHeight;
+  const zeroY = projectY(0);
+  const step = chartWidth / Math.max(1, spec.data.length);
+  const barWidth = Math.min(84, step * 0.6);
+  const points = spec.data.map((item, index) => {
+    const centerX = margin.left + step * index + step / 2;
+    const y = projectY(item.value);
+    return { ...item, centerX, y };
+  });
+  const gridLines = tickValues.map((value) => {
+    const y = projectY(value);
+    return [
+      `<line x1="${margin.left}" y1="${y}" x2="${width - margin.right}" y2="${y}" stroke="#dbe4ec" stroke-width="1" />`,
+      `<text x="${margin.left - 16}" y="${y + 4}" text-anchor="end" font-size="14" fill="#475569">${escapeXml(value.toFixed(0))}</text>`
+    ].join("");
+  }).join("");
+  const bars = spec.kind === "bar" ? points.map((point) => {
+    const top = Math.min(point.y, zeroY);
+    const barHeight = Math.max(8, Math.abs(zeroY - point.y));
+    return [
+      `<rect x="${point.centerX - barWidth / 2}" y="${top}" width="${barWidth}" height="${barHeight}" rx="12" fill="#0ea5e9" opacity="0.92" />`,
+      `<text x="${point.centerX}" y="${top - 10}" text-anchor="middle" font-size="13" fill="#0f172a">${escapeXml(
+        point.value.toFixed(0)
+      )}</text>`
+    ].join("");
+  }).join("") : "";
+  const linePath = spec.kind === "line" ? points.map((point, index) => `${index === 0 ? "M" : "L"} ${point.centerX} ${point.y}`).join(" ") : "";
+  const lineMarks = spec.kind === "line" ? [
+    `<path d="${linePath}" fill="none" stroke="#0ea5e9" stroke-width="5" stroke-linecap="round" stroke-linejoin="round" />`,
+    ...points.map(
+      (point) => `<circle cx="${point.centerX}" cy="${point.y}" r="8" fill="#f8fafc" stroke="#0ea5e9" stroke-width="4" />
+               <text x="${point.centerX}" y="${point.y - 18}" text-anchor="middle" font-size="13" fill="#0f172a">${escapeXml(
+        point.value.toFixed(0)
+      )}</text>`
+    )
+  ].join("") : "";
+  const labels = points.map(
+    (point) => `<text x="${point.centerX}" y="${height - margin.bottom + 28}" text-anchor="middle" font-size="14" fill="#334155">${escapeXml(
+      point.label
+    )}</text>`
+  ).join("");
+  const notes = (spec.notes ?? []).map(
+    (note, index) => `<text x="${margin.left}" y="${height - 26 - index * 18}" font-size="13" fill="#475569">${escapeXml(note)}</text>`
+  ).join("");
+  const svg = [
+    `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeXml(spec.title)}">`,
+    '<rect width="100%" height="100%" fill="#f8fafc" />',
+    `<text x="${margin.left}" y="56" font-size="34" font-weight="700" fill="#0f172a">${escapeXml(spec.title)}</text>`,
+    spec.subtitle ? `<text x="${margin.left}" y="86" font-size="18" fill="#475569">${escapeXml(spec.subtitle)}</text>` : "",
+    gridLines,
+    `<line x1="${margin.left}" y1="${zeroY}" x2="${width - margin.right}" y2="${zeroY}" stroke="#0f172a" stroke-width="2" />`,
+    `<line x1="${margin.left}" y1="${margin.top}" x2="${margin.left}" y2="${height - margin.bottom}" stroke="#0f172a" stroke-width="2" />`,
+    bars,
+    lineMarks,
+    labels,
+    spec.xLabel ? `<text x="${margin.left + chartWidth / 2}" y="${height - 46}" text-anchor="middle" font-size="15" fill="#475569">${escapeXml(spec.xLabel)}</text>` : "",
+    spec.yLabel ? `<text x="34" y="${margin.top + chartHeight / 2}" text-anchor="middle" font-size="15" fill="#475569" transform="rotate(-90 34 ${margin.top + chartHeight / 2})">${escapeXml(spec.yLabel)}</text>` : "",
+    spec.seriesLabel ? `<text x="${width - margin.right}" y="56" text-anchor="end" font-size="15" fill="#475569">${escapeXml(spec.seriesLabel)}</text>` : "",
+    notes,
+    "</svg>"
+  ].filter(Boolean).join("");
+  return { svg, width, height };
+}
+function renderSceneSvg(spec) {
+  const width = clampNumber(spec.width ?? 1200, 480, 1600);
+  const height = clampNumber(spec.height ?? 720, 320, 1200);
+  const elements = spec.elements.map((element) => {
+    const opacity = element.opacity === void 0 ? 1 : clampNumber(element.opacity, 0, 1);
+    if (element.kind === "label") {
+      return `<text x="${element.x}" y="${element.y}" font-size="${clampNumber(element.fontSize ?? 28, 10, 72)}" fill="${escapeXml(
+        element.fill ?? "#0f172a"
+      )}" opacity="${opacity}" font-family="'Avenir Next', 'Segoe UI', sans-serif">${escapeXml(element.text ?? "")}</text>`;
+    }
+    switch (element.shape) {
+      case "circle":
+        return `<circle cx="${element.x}" cy="${element.y}" r="${Math.max(6, element.radius ?? 40)}" fill="${escapeXml(
+          element.fill ?? "#dbeafe"
+        )}" stroke="${escapeXml(element.stroke ?? "#0ea5e9")}" stroke-width="${Math.max(1, element.strokeWidth ?? 2)}" opacity="${opacity}" />`;
+      case "line":
+        return `<line x1="${element.x}" y1="${element.y}" x2="${element.x + (element.width ?? 120)}" y2="${element.y + (element.height ?? 0)}" stroke="${escapeXml(element.stroke ?? "#475569")}" stroke-width="${Math.max(1, element.strokeWidth ?? 3)}" opacity="${opacity}" />`;
+      default:
+        return `<rect x="${element.x}" y="${element.y}" width="${Math.max(8, element.width ?? 160)}" height="${Math.max(
+          8,
+          element.height ?? 120
+        )}" rx="22" fill="${escapeXml(element.fill ?? "#e2e8f0")}" stroke="${escapeXml(element.stroke ?? "#94a3b8")}" stroke-width="${Math.max(
+          1,
+          element.strokeWidth ?? 2
+        )}" opacity="${opacity}" />`;
+    }
+  }).join("");
+  const svg = [
+    `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeXml(
+      spec.alt
+    )}">`,
+    `<rect width="100%" height="100%" fill="${escapeXml(spec.background ?? "#f8fafc")}" />`,
+    `<text x="48" y="64" font-size="34" font-weight="700" fill="#0f172a">${escapeXml(spec.title)}</text>`,
+    elements,
+    `</svg>`
+  ].join("");
+  return { svg, width, height };
+}
+function renderRasterPosterSvg(input) {
+  const width = clampNumber(input.width ?? 1200, 480, 1600);
+  const height = clampNumber(input.height ?? 720, 320, 1200);
+  const inset = 42;
+  const svg = [
+    `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeXml(
+      input.alt
+    )}">`,
+    '<rect width="100%" height="100%" fill="#f8fafc" />',
+    `<text x="${inset}" y="56" font-size="34" font-weight="700" fill="#0f172a">${escapeXml(input.title)}</text>`,
+    `<image href="${escapeXml(input.rasterFileName)}" x="${inset}" y="92" width="${width - inset * 2}" height="${height - 148}" preserveAspectRatio="xMidYMid meet" />`,
+    `</svg>`
+  ].join("");
+  return { svg, width, height };
+}
+function buildOutputAssetManifest(input) {
+  return `${JSON.stringify(
+    {
+      slug: input.slug,
+      format: input.format,
+      question: input.question,
+      title: input.title,
+      answer: input.answer,
+      citations: input.citations,
+      assets: input.assets,
+      spec: input.spec
+    },
+    null,
+    2
+  )}
+`;
+}
+
+// src/outputs.ts
+import fs7 from "fs/promises";
+import path11 from "path";
+import matter5 from "gray-matter";
+
+// src/pages.ts
+import fs6 from "fs/promises";
+import path10 from "path";
+import matter4 from "gray-matter";
+function normalizeStringArray(value) {
+  return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function normalizeProjectIds(value) {
+  return normalizeStringArray(value);
+}
+function normalizeSourceHashes(value) {
+  if (!value || typeof value !== "object") {
+    return {};
+  }
+  return Object.fromEntries(
+    Object.entries(value).filter((entry) => typeof entry[0] === "string" && typeof entry[1] === "string")
+  );
+}
+function normalizePageStatus(value, fallback = "active") {
+  return value === "draft" || value === "candidate" || value === "active" || value === "archived" ? value : fallback;
+}
+function normalizePageManager(value, fallback = "system") {
+  return value === "human" || value === "system" ? value : fallback;
+}
+function normalizeOutputFormat(value, fallback = "markdown") {
+  return value === "report" || value === "slides" || value === "chart" || value === "image" ? value : fallback;
+}
+function normalizeOutputAssets(value) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.reduce((assets, item) => {
+    if (!item || typeof item !== "object") {
+      return assets;
+    }
+    const candidate = item;
+    const id = typeof candidate.id === "string" ? candidate.id : "";
+    const role = candidate.role;
+    const assetPath = typeof candidate.path === "string" ? candidate.path : "";
+    const mimeType = typeof candidate.mimeType === "string" ? candidate.mimeType : "";
+    if (!id || !assetPath || !mimeType || role !== "primary" && role !== "preview" && role !== "manifest" && role !== "poster") {
+      return assets;
+    }
+    assets.push({
+      id,
+      role,
+      path: assetPath,
+      mimeType,
+      width: typeof candidate.width === "number" ? candidate.width : void 0,
+      height: typeof candidate.height === "number" ? candidate.height : void 0,
+      dataPath: typeof candidate.dataPath === "string" ? candidate.dataPath : void 0
+    });
     return assets;
   }, []);
 }
@@ -5091,7 +5086,13 @@ async function prepareOutputPageSave(rootDir, input) {
     }
   });
   const absolutePath = path13.join(paths.wikiDir, output.page.path);
-  return { page: output.page, savedPath: absolutePath, outputAssets: output.page.outputAssets ?? [], content: output.content, assetFiles: input.assetFiles ?? [] };
+  return {
+    page: output.page,
+    savedPath: absolutePath,
+    outputAssets: output.page.outputAssets ?? [],
+    content: output.content,
+    assetFiles: input.assetFiles ?? []
+  };
 }
 async function persistOutputPage(rootDir, input) {
   const { paths } = await loadVaultConfig(rootDir);
@@ -5126,7 +5127,13 @@ async function prepareExploreHubSave(rootDir, input) {
     }
   });
   const absolutePath = path13.join(paths.wikiDir, hub.page.path);
-  return { page: hub.page, savedPath: absolutePath, outputAssets: hub.page.outputAssets ?? [], content: hub.content, assetFiles: input.assetFiles ?? [] };
+  return {
+    page: hub.page,
+    savedPath: absolutePath,
+    outputAssets: hub.page.outputAssets ?? [],
+    content: hub.content,
+    assetFiles: input.assetFiles ?? []
+  };
 }
 async function persistExploreHub(rootDir, input) {
   const { paths } = await loadVaultConfig(rootDir);
@@ -5169,9 +5176,10 @@ async function stageOutputApprovalBundle(rootDir, stagedPages) {
       await fs9.writeFile(targetPath, file.content, "utf8");
     }
   }
-  const nextPages = sortGraphPages(
-    [...(previousGraph?.pages ?? []).filter((page) => !stagedPages.some((item) => item.page.id === page.id || item.page.path === page.path)), ...stagedPages.map((item) => item.page)]
-  );
+  const nextPages = sortGraphPages([
+    ...(previousGraph?.pages ?? []).filter((page) => !stagedPages.some((item) => item.page.id === page.id || item.page.path === page.path)),
+    ...stagedPages.map((item) => item.page)
+  ]);
   const graph = {
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     nodes: previousGraph?.nodes ?? [],
@@ -6144,9 +6152,7 @@ async function exploreVault(rootDir, options) {
         `Citations: ${query.citations.join(", ") || "none"}`
       ].join("\n")
     });
-    const orchestrationNotes = roleResults.flatMap(
-      (result) => result.findings.map((finding) => `- [${result.role}] ${finding.message}`)
-    );
+    const orchestrationNotes = roleResults.flatMap((result) => result.findings.map((finding) => `- [${result.role}] ${finding.message}`));
     const enrichedAnswer = orchestrationNotes.length ? `${query.answer}
 
 ## Agent Review
@@ -6508,7 +6514,7 @@ async function bootstrapDemo(rootDir, input) {
 }
 
 // src/mcp.ts
-var SERVER_VERSION = "0.1.7";
+var SERVER_VERSION = "0.1.8";
 async function createMcpServer(rootDir) {
   const server = new McpServer({
     name: "swarmvault",
@@ -6575,7 +6581,7 @@ async function createMcpServer(rootDir) {
       inputSchema: {
         question: z7.string().min(1).describe("Question to ask the vault"),
         save: z7.boolean().optional().describe("Persist the answer to wiki/outputs"),
-        format: z7.enum(["markdown", "report", "slides"]).optional().describe("Output format")
+        format: z7.enum(["markdown", "report", "slides", "chart", "image"]).optional().describe("Output format")
       }
     },
     async ({ question, save, format }) => {
@@ -6803,283 +6809,14 @@ function asTextResource(uri, text) {
   };
 }
 
-// src/viewer.ts
-import { execFile } from "child_process";
+// src/schedule.ts
 import fs11 from "fs/promises";
-import http from "http";
 import path15 from "path";
-import { promisify } from "util";
-import matter8 from "gray-matter";
-import mime2 from "mime-types";
-var execFileAsync = promisify(execFile);
-async function readViewerPage(rootDir, relativePath) {
-  const { paths } = await loadVaultConfig(rootDir);
-  const absolutePath = path15.resolve(paths.wikiDir, relativePath);
-  if (!absolutePath.startsWith(paths.wikiDir) || !await fileExists(absolutePath)) {
-    return null;
-  }
-  const raw = await fs11.readFile(absolutePath, "utf8");
-  const parsed = matter8(raw);
-  return {
-    path: relativePath,
-    title: typeof parsed.data.title === "string" ? parsed.data.title : path15.basename(relativePath, path15.extname(relativePath)),
-    frontmatter: parsed.data,
-    content: parsed.content,
-    assets: normalizeOutputAssets(parsed.data.output_assets)
-  };
-}
-async function readViewerAsset(rootDir, relativePath) {
-  const { paths } = await loadVaultConfig(rootDir);
-  const absolutePath = path15.resolve(paths.wikiDir, relativePath);
-  if (!absolutePath.startsWith(paths.wikiDir) || !await fileExists(absolutePath)) {
-    return null;
-  }
-  return {
-    buffer: await fs11.readFile(absolutePath),
-    mimeType: mime2.lookup(absolutePath) || "application/octet-stream"
-  };
-}
-async function assetDataUrl(rootDir, relativePath) {
-  const asset = await readViewerAsset(rootDir, relativePath);
-  if (!asset) {
-    return void 0;
-  }
-  return `data:${asset.mimeType};base64,${asset.buffer.toString("base64")}`;
-}
-async function readJsonBody(request) {
-  const chunks = [];
-  for await (const chunk of request) {
-    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-  }
-  const raw = Buffer.concat(chunks).toString("utf8").trim();
-  if (!raw) {
-    return {};
-  }
-  return JSON.parse(raw);
-}
-async function ensureViewerDist(viewerDistDir) {
-  const indexPath = path15.join(viewerDistDir, "index.html");
-  if (await fileExists(indexPath)) {
-    return;
-  }
-  const viewerProjectDir = path15.dirname(viewerDistDir);
-  if (await fileExists(path15.join(viewerProjectDir, "package.json"))) {
-    await execFileAsync("pnpm", ["build"], { cwd: viewerProjectDir });
-  }
-}
-async function startGraphServer(rootDir, port) {
-  const { config, paths } = await loadVaultConfig(rootDir);
-  const effectivePort = port ?? config.viewer.port;
-  await ensureViewerDist(paths.viewerDistDir);
-  const server = http.createServer(async (request, response) => {
-    const url = new URL(request.url ?? "/", `http://${request.headers.host ?? `localhost:${effectivePort}`}`);
-    if (url.pathname === "/api/graph") {
-      if (!await fileExists(paths.graphPath)) {
-        response.writeHead(404, { "content-type": "application/json" });
-        response.end(JSON.stringify({ error: "Graph artifact not found. Run `swarmvault compile` first." }));
-        return;
-      }
-      response.writeHead(200, { "content-type": "application/json" });
-      response.end(await fs11.readFile(paths.graphPath, "utf8"));
-      return;
-    }
-    if (url.pathname === "/api/search") {
-      if (!await fileExists(paths.searchDbPath)) {
-        response.writeHead(404, { "content-type": "application/json" });
-        response.end(JSON.stringify({ error: "Search index not found. Run `swarmvault compile` first." }));
-        return;
-      }
-      const query = url.searchParams.get("q") ?? "";
-      const limit = Number.parseInt(url.searchParams.get("limit") ?? "10", 10);
-      const kind = url.searchParams.get("kind") ?? "all";
-      const status = url.searchParams.get("status") ?? "all";
-      const project = url.searchParams.get("project") ?? "all";
-      const results = searchPages(paths.searchDbPath, query, {
-        limit: Number.isFinite(limit) ? limit : 10,
-        kind,
-        status,
-        project
-      });
-      response.writeHead(200, { "content-type": "application/json" });
-      response.end(JSON.stringify(results));
-      return;
-    }
-    if (url.pathname === "/api/page") {
-      const relativePath2 = url.searchParams.get("path") ?? "";
-      const page = await readViewerPage(rootDir, relativePath2);
-      if (!page) {
-        response.writeHead(404, { "content-type": "application/json" });
-        response.end(JSON.stringify({ error: `Page not found: ${relativePath2}` }));
-        return;
-      }
-      response.writeHead(200, { "content-type": "application/json" });
-      response.end(JSON.stringify(page));
-      return;
-    }
-    if (url.pathname === "/api/asset") {
-      const relativePath2 = url.searchParams.get("path") ?? "";
-      const asset = await readViewerAsset(rootDir, relativePath2);
-      if (!asset) {
-        response.writeHead(404, { "content-type": "application/json" });
-        response.end(JSON.stringify({ error: `Asset not found: ${relativePath2}` }));
-        return;
-      }
-      response.writeHead(200, { "content-type": asset.mimeType });
-      response.end(asset.buffer);
-      return;
-    }
-    if (url.pathname === "/api/reviews" && request.method === "GET") {
-      response.writeHead(200, { "content-type": "application/json" });
-      response.end(JSON.stringify(await listApprovals(rootDir)));
-      return;
-    }
-    if (url.pathname === "/api/review" && request.method === "GET") {
-      const approvalId = url.searchParams.get("id") ?? "";
-      if (!approvalId) {
-        response.writeHead(400, { "content-type": "application/json" });
-        response.end(JSON.stringify({ error: "Missing approval id." }));
-        return;
-      }
-      response.writeHead(200, { "content-type": "application/json" });
-      response.end(JSON.stringify(await readApproval(rootDir, approvalId)));
-      return;
-    }
-    if (url.pathname === "/api/review" && request.method === "POST") {
-      const body = await readJsonBody(request);
-      const approvalId = typeof body.approvalId === "string" ? body.approvalId : "";
-      const targets = Array.isArray(body.targets) ? body.targets.filter((item) => typeof item === "string") : [];
-      const action = url.searchParams.get("action") ?? "";
-      if (!approvalId || action !== "accept" && action !== "reject") {
-        response.writeHead(400, { "content-type": "application/json" });
-        response.end(JSON.stringify({ error: "Missing approval id or invalid review action." }));
-        return;
-      }
-      const result = action === "accept" ? await acceptApproval(rootDir, approvalId, targets) : await rejectApproval(rootDir, approvalId, targets);
-      response.writeHead(200, { "content-type": "application/json" });
-      response.end(JSON.stringify(result));
-      return;
-    }
-    if (url.pathname === "/api/candidates" && request.method === "GET") {
-      response.writeHead(200, { "content-type": "application/json" });
-      response.end(JSON.stringify(await listCandidates(rootDir)));
-      return;
-    }
-    if (url.pathname === "/api/candidate" && request.method === "POST") {
-      const body = await readJsonBody(request);
-      const target2 = typeof body.target === "string" ? body.target : "";
-      const action = url.searchParams.get("action") ?? "";
-      if (!target2 || action !== "promote" && action !== "archive") {
-        response.writeHead(400, { "content-type": "application/json" });
-        response.end(JSON.stringify({ error: "Missing candidate target or invalid candidate action." }));
-        return;
-      }
-      const result = action === "promote" ? await promoteCandidate(rootDir, target2) : await archiveCandidate(rootDir, target2);
-      response.writeHead(200, { "content-type": "application/json" });
-      response.end(JSON.stringify(result));
-      return;
-    }
-    const relativePath = url.pathname === "/" ? "index.html" : url.pathname.slice(1);
-    const target = path15.join(paths.viewerDistDir, relativePath);
-    const fallback = path15.join(paths.viewerDistDir, "index.html");
-    const filePath = await fileExists(target) ? target : fallback;
-    if (!await fileExists(filePath)) {
-      response.writeHead(503, { "content-type": "text/plain" });
-      response.end("Viewer build not found. Run `pnpm build` first.");
-      return;
-    }
-    response.writeHead(200, { "content-type": mime2.lookup(filePath) || "text/plain" });
-    response.end(await fs11.readFile(filePath));
-  });
-  await new Promise((resolve) => {
-    server.listen(effectivePort, resolve);
-  });
-  return {
-    port: effectivePort,
-    close: async () => {
-      await new Promise((resolve, reject) => {
-        server.close((error) => {
-          if (error) {
-            reject(error);
-            return;
-          }
-          resolve();
-        });
-      });
-    }
-  };
-}
-async function exportGraphHtml(rootDir, outputPath) {
-  const { paths } = await loadVaultConfig(rootDir);
-  const graph = await readJsonFile(paths.graphPath);
-  if (!graph) {
-    throw new Error("Graph artifact not found. Run `swarmvault compile` first.");
-  }
-  await ensureViewerDist(paths.viewerDistDir);
-  const indexPath = path15.join(paths.viewerDistDir, "index.html");
-  if (!await fileExists(indexPath)) {
-    throw new Error("Viewer build not found. Run `pnpm build` first.");
-  }
-  const pages = await Promise.all(
-    graph.pages.map(async (page) => {
-      const loaded = await readViewerPage(rootDir, page.path);
-      return loaded ? {
-        pageId: page.id,
-        path: loaded.path,
-        title: loaded.title,
-        kind: page.kind,
-        status: page.status,
-        projectIds: page.projectIds,
-        content: loaded.content,
-        assets: await Promise.all(
-          loaded.assets.map(async (asset) => ({
-            ...asset,
-            dataUrl: await assetDataUrl(rootDir, asset.path)
-          }))
-        )
-      } : null;
-    })
-  );
-  const rawHtml = await fs11.readFile(indexPath, "utf8");
-  const scriptMatch = rawHtml.match(/<script type="module" crossorigin src="([^"]+)"><\/script>/);
-  const styleMatch = rawHtml.match(/<link rel="stylesheet" crossorigin href="([^"]+)">/);
-  const scriptPath = scriptMatch?.[1] ? path15.join(paths.viewerDistDir, scriptMatch[1].replace(/^\//, "")) : null;
-  const stylePath = styleMatch?.[1] ? path15.join(paths.viewerDistDir, styleMatch[1].replace(/^\//, "")) : null;
-  if (!scriptPath || !await fileExists(scriptPath)) {
-    throw new Error("Viewer script bundle not found. Run `pnpm build` first.");
-  }
-  const script = await fs11.readFile(scriptPath, "utf8");
-  const style = stylePath && await fileExists(stylePath) ? await fs11.readFile(stylePath, "utf8") : "";
-  const embeddedData = JSON.stringify({ graph, pages: pages.filter(Boolean) }, null, 2).replace(/</g, "\\u003c");
-  const html = [
-    "<!doctype html>",
-    '<html lang="en">',
-    "  <head>",
-    '    <meta charset="UTF-8" />',
-    '    <meta name="viewport" content="width=device-width, initial-scale=1.0" />',
-    "    <title>SwarmVault Graph Export</title>",
-    style ? `    <style>${style}</style>` : "",
-    "  </head>",
-    "  <body>",
-    '    <div id="root"></div>',
-    `    <script>window.__SWARMVAULT_EMBEDDED_DATA__ = ${embeddedData};</script>`,
-    `    <script type="module">${script}</script>`,
-    "  </body>",
-    "</html>",
-    ""
-  ].filter(Boolean).join("\n");
-  await fs11.mkdir(path15.dirname(outputPath), { recursive: true });
-  await fs11.writeFile(outputPath, html, "utf8");
-  return path15.resolve(outputPath);
-}
-
-// src/schedule.ts
-import fs12 from "fs/promises";
-import path16 from "path";
 function scheduleStatePath(schedulesDir, jobId) {
-  return path16.join(schedulesDir, `${encodeURIComponent(jobId)}.json`);
+  return path15.join(schedulesDir, `${encodeURIComponent(jobId)}.json`);
 }
 function scheduleLockPath(schedulesDir, jobId) {
-  return path16.join(schedulesDir, `${encodeURIComponent(jobId)}.lock`);
+  return path15.join(schedulesDir, `${encodeURIComponent(jobId)}.lock`);
 }
 function parseEveryDuration(value) {
   const match = value.trim().match(/^(\d+)(m|h|d)$/i);
@@ -7182,13 +6919,13 @@ async function acquireJobLease(rootDir, jobId) {
   const { paths } = await loadVaultConfig(rootDir);
   const leasePath = scheduleLockPath(paths.schedulesDir, jobId);
   await ensureDir(paths.schedulesDir);
-  const handle = await fs12.open(leasePath, "wx");
+  const handle = await fs11.open(leasePath, "wx");
   await handle.writeFile(`${process.pid}
 ${(/* @__PURE__ */ new Date()).toISOString()}
 `);
   await handle.close();
   return async () => {
-    await fs12.rm(leasePath, { force: true });
+    await fs11.rm(leasePath, { force: true });
   };
 }
 async function listSchedules(rootDir) {
@@ -7334,6 +7071,275 @@ async function serveSchedules(rootDir, pollMs = 3e4) {
   };
 }
 
+// src/viewer.ts
+import { execFile } from "child_process";
+import fs12 from "fs/promises";
+import http from "http";
+import path16 from "path";
+import { promisify } from "util";
+import matter8 from "gray-matter";
+import mime2 from "mime-types";
+var execFileAsync = promisify(execFile);
+async function readViewerPage(rootDir, relativePath) {
+  const { paths } = await loadVaultConfig(rootDir);
+  const absolutePath = path16.resolve(paths.wikiDir, relativePath);
+  if (!absolutePath.startsWith(paths.wikiDir) || !await fileExists(absolutePath)) {
+    return null;
+  }
+  const raw = await fs12.readFile(absolutePath, "utf8");
+  const parsed = matter8(raw);
+  return {
+    path: relativePath,
+    title: typeof parsed.data.title === "string" ? parsed.data.title : path16.basename(relativePath, path16.extname(relativePath)),
+    frontmatter: parsed.data,
+    content: parsed.content,
+    assets: normalizeOutputAssets(parsed.data.output_assets)
+  };
+}
+async function readViewerAsset(rootDir, relativePath) {
+  const { paths } = await loadVaultConfig(rootDir);
+  const absolutePath = path16.resolve(paths.wikiDir, relativePath);
+  if (!absolutePath.startsWith(paths.wikiDir) || !await fileExists(absolutePath)) {
+    return null;
+  }
+  return {
+    buffer: await fs12.readFile(absolutePath),
+    mimeType: mime2.lookup(absolutePath) || "application/octet-stream"
+  };
+}
+async function assetDataUrl(rootDir, relativePath) {
+  const asset = await readViewerAsset(rootDir, relativePath);
+  if (!asset) {
+    return void 0;
+  }
+  return `data:${asset.mimeType};base64,${asset.buffer.toString("base64")}`;
+}
+async function readJsonBody(request) {
+  const chunks = [];
+  for await (const chunk of request) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  const raw = Buffer.concat(chunks).toString("utf8").trim();
+  if (!raw) {
+    return {};
+  }
+  return JSON.parse(raw);
+}
+async function ensureViewerDist(viewerDistDir) {
+  const indexPath = path16.join(viewerDistDir, "index.html");
+  if (await fileExists(indexPath)) {
+    return;
+  }
+  const viewerProjectDir = path16.dirname(viewerDistDir);
+  if (await fileExists(path16.join(viewerProjectDir, "package.json"))) {
+    await execFileAsync("pnpm", ["build"], { cwd: viewerProjectDir });
+  }
+}
+async function startGraphServer(rootDir, port) {
+  const { config, paths } = await loadVaultConfig(rootDir);
+  const effectivePort = port ?? config.viewer.port;
+  await ensureViewerDist(paths.viewerDistDir);
+  const server = http.createServer(async (request, response) => {
+    const url = new URL(request.url ?? "/", `http://${request.headers.host ?? `localhost:${effectivePort}`}`);
+    if (url.pathname === "/api/graph") {
+      if (!await fileExists(paths.graphPath)) {
+        response.writeHead(404, { "content-type": "application/json" });
+        response.end(JSON.stringify({ error: "Graph artifact not found. Run `swarmvault compile` first." }));
+        return;
+      }
+      response.writeHead(200, { "content-type": "application/json" });
+      response.end(await fs12.readFile(paths.graphPath, "utf8"));
+      return;
+    }
+    if (url.pathname === "/api/search") {
+      if (!await fileExists(paths.searchDbPath)) {
+        response.writeHead(404, { "content-type": "application/json" });
+        response.end(JSON.stringify({ error: "Search index not found. Run `swarmvault compile` first." }));
+        return;
+      }
+      const query = url.searchParams.get("q") ?? "";
+      const limit = Number.parseInt(url.searchParams.get("limit") ?? "10", 10);
+      const kind = url.searchParams.get("kind") ?? "all";
+      const status = url.searchParams.get("status") ?? "all";
+      const project = url.searchParams.get("project") ?? "all";
+      const results = searchPages(paths.searchDbPath, query, {
+        limit: Number.isFinite(limit) ? limit : 10,
+        kind,
+        status,
+        project
+      });
+      response.writeHead(200, { "content-type": "application/json" });
+      response.end(JSON.stringify(results));
+      return;
+    }
+    if (url.pathname === "/api/page") {
+      const relativePath2 = url.searchParams.get("path") ?? "";
+      const page = await readViewerPage(rootDir, relativePath2);
+      if (!page) {
+        response.writeHead(404, { "content-type": "application/json" });
+        response.end(JSON.stringify({ error: `Page not found: ${relativePath2}` }));
+        return;
+      }
+      response.writeHead(200, { "content-type": "application/json" });
+      response.end(JSON.stringify(page));
+      return;
+    }
+    if (url.pathname === "/api/asset") {
+      const relativePath2 = url.searchParams.get("path") ?? "";
+      const asset = await readViewerAsset(rootDir, relativePath2);
+      if (!asset) {
+        response.writeHead(404, { "content-type": "application/json" });
+        response.end(JSON.stringify({ error: `Asset not found: ${relativePath2}` }));
+        return;
+      }
+      response.writeHead(200, { "content-type": asset.mimeType });
+      response.end(asset.buffer);
+      return;
+    }
+    if (url.pathname === "/api/reviews" && request.method === "GET") {
+      response.writeHead(200, { "content-type": "application/json" });
+      response.end(JSON.stringify(await listApprovals(rootDir)));
+      return;
+    }
+    if (url.pathname === "/api/review" && request.method === "GET") {
+      const approvalId = url.searchParams.get("id") ?? "";
+      if (!approvalId) {
+        response.writeHead(400, { "content-type": "application/json" });
+        response.end(JSON.stringify({ error: "Missing approval id." }));
+        return;
+      }
+      response.writeHead(200, { "content-type": "application/json" });
+      response.end(JSON.stringify(await readApproval(rootDir, approvalId)));
+      return;
+    }
+    if (url.pathname === "/api/review" && request.method === "POST") {
+      const body = await readJsonBody(request);
+      const approvalId = typeof body.approvalId === "string" ? body.approvalId : "";
+      const targets = Array.isArray(body.targets) ? body.targets.filter((item) => typeof item === "string") : [];
+      const action = url.searchParams.get("action") ?? "";
+      if (!approvalId || action !== "accept" && action !== "reject") {
+        response.writeHead(400, { "content-type": "application/json" });
+        response.end(JSON.stringify({ error: "Missing approval id or invalid review action." }));
+        return;
+      }
+      const result = action === "accept" ? await acceptApproval(rootDir, approvalId, targets) : await rejectApproval(rootDir, approvalId, targets);
+      response.writeHead(200, { "content-type": "application/json" });
+      response.end(JSON.stringify(result));
+      return;
+    }
+    if (url.pathname === "/api/candidates" && request.method === "GET") {
+      response.writeHead(200, { "content-type": "application/json" });
+      response.end(JSON.stringify(await listCandidates(rootDir)));
+      return;
+    }
+    if (url.pathname === "/api/candidate" && request.method === "POST") {
+      const body = await readJsonBody(request);
+      const target2 = typeof body.target === "string" ? body.target : "";
+      const action = url.searchParams.get("action") ?? "";
+      if (!target2 || action !== "promote" && action !== "archive") {
+        response.writeHead(400, { "content-type": "application/json" });
+        response.end(JSON.stringify({ error: "Missing candidate target or invalid candidate action." }));
+        return;
+      }
+      const result = action === "promote" ? await promoteCandidate(rootDir, target2) : await archiveCandidate(rootDir, target2);
+      response.writeHead(200, { "content-type": "application/json" });
+      response.end(JSON.stringify(result));
+      return;
+    }
+    const relativePath = url.pathname === "/" ? "index.html" : url.pathname.slice(1);
+    const target = path16.join(paths.viewerDistDir, relativePath);
+    const fallback = path16.join(paths.viewerDistDir, "index.html");
+    const filePath = await fileExists(target) ? target : fallback;
+    if (!await fileExists(filePath)) {
+      response.writeHead(503, { "content-type": "text/plain" });
+      response.end("Viewer build not found. Run `pnpm build` first.");
+      return;
+    }
+    response.writeHead(200, { "content-type": mime2.lookup(filePath) || "text/plain" });
+    response.end(await fs12.readFile(filePath));
+  });
+  await new Promise((resolve) => {
+    server.listen(effectivePort, resolve);
+  });
+  return {
+    port: effectivePort,
+    close: async () => {
+      await new Promise((resolve, reject) => {
+        server.close((error) => {
+          if (error) {
+            reject(error);
+            return;
+          }
+          resolve();
+        });
+      });
+    }
+  };
+}
+async function exportGraphHtml(rootDir, outputPath) {
+  const { paths } = await loadVaultConfig(rootDir);
+  const graph = await readJsonFile(paths.graphPath);
+  if (!graph) {
+    throw new Error("Graph artifact not found. Run `swarmvault compile` first.");
+  }
+  await ensureViewerDist(paths.viewerDistDir);
+  const indexPath = path16.join(paths.viewerDistDir, "index.html");
+  if (!await fileExists(indexPath)) {
+    throw new Error("Viewer build not found. Run `pnpm build` first.");
+  }
+  const pages = await Promise.all(
+    graph.pages.map(async (page) => {
+      const loaded = await readViewerPage(rootDir, page.path);
+      return loaded ? {
+        pageId: page.id,
+        path: loaded.path,
+        title: loaded.title,
+        kind: page.kind,
+        status: page.status,
+        projectIds: page.projectIds,
+        content: loaded.content,
+        assets: await Promise.all(
+          loaded.assets.map(async (asset) => ({
+            ...asset,
+            dataUrl: await assetDataUrl(rootDir, asset.path)
+          }))
+        )
+      } : null;
+    })
+  );
+  const rawHtml = await fs12.readFile(indexPath, "utf8");
+  const scriptMatch = rawHtml.match(/<script type="module" crossorigin src="([^"]+)"><\/script>/);
+  const styleMatch = rawHtml.match(/<link rel="stylesheet" crossorigin href="([^"]+)">/);
+  const scriptPath = scriptMatch?.[1] ? path16.join(paths.viewerDistDir, scriptMatch[1].replace(/^\//, "")) : null;
+  const stylePath = styleMatch?.[1] ? path16.join(paths.viewerDistDir, styleMatch[1].replace(/^\//, "")) : null;
+  if (!scriptPath || !await fileExists(scriptPath)) {
+    throw new Error("Viewer script bundle not found. Run `pnpm build` first.");
+  }
+  const script = await fs12.readFile(scriptPath, "utf8");
+  const style = stylePath && await fileExists(stylePath) ? await fs12.readFile(stylePath, "utf8") : "";
+  const embeddedData = JSON.stringify({ graph, pages: pages.filter(Boolean) }, null, 2).replace(/</g, "\\u003c");
+  const html = [
+    "<!doctype html>",
+    '<html lang="en">',
+    "  <head>",
+    '    <meta charset="UTF-8" />',
+    '    <meta name="viewport" content="width=device-width, initial-scale=1.0" />',
+    "    <title>SwarmVault Graph Export</title>",
+    style ? `    <style>${style}</style>` : "",
+    "  </head>",
+    "  <body>",
+    '    <div id="root"></div>',
+    `    <script>window.__SWARMVAULT_EMBEDDED_DATA__ = ${embeddedData};</script>`,
+    `    <script type="module">${script}</script>`,
+    "  </body>",
+    "</html>",
+    ""
+  ].filter(Boolean).join("\n");
+  await fs12.mkdir(path16.dirname(outputPath), { recursive: true });
+  await fs12.writeFile(outputPath, html, "utf8");
+  return path16.resolve(outputPath);
+}
+
 // src/watch.ts
 import path17 from "path";
 import process2 from "process";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/engine",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Core engine for SwarmVault: ingest, compile, query, lint, and provider abstractions.",
   "type": "module",
   "main": "dist/index.js",