@swarmvaultai/engine 0.1.7 → 0.1.9

package/dist/index.js

@@ -1059,7 +1059,7 @@ import fs10 from "fs/promises";
 import path14 from "path";
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 
 // src/schema.ts
 import fs4 from "fs/promises";
@@ -1172,7 +1172,7 @@ function buildSchemaPrompt(schema, instruction) {
 import fs9 from "fs/promises";
 import path13 from "path";
 import matter7 from "gray-matter";
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 
 // src/analysis.ts
 import path6 from "path";
@@ -1407,29 +1407,46 @@ function conflictConfidence(claimA, claimB) {
 import fs5 from "fs/promises";
 import path9 from "path";
 import matter2 from "gray-matter";
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
+
+// src/findings.ts
+import { z as z2 } from "zod";
+function normalizeFindingSeverity(value) {
+  if (typeof value !== "string") {
+    return "info";
+  }
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "error" || normalized === "critical" || normalized === "fatal" || normalized === "high" || normalized === "severe") {
+    return "error";
+  }
+  if (normalized === "warning" || normalized === "warn" || normalized === "medium" || normalized === "moderate" || normalized === "caution") {
+    return "warning";
+  }
+  return "info";
+}
+var findingSeveritySchema = z2.any().transform((value) => normalizeFindingSeverity(value));
 
 // src/orchestration.ts
-import path7 from "path";
 import { spawn } from "child_process";
-import { z as z2 } from "zod";
-var orchestrationRoleResultSchema = z2.object({
-  summary: z2.string().optional(),
-  findings: z2.array(
-    z2.object({
-      severity: z2.enum(["error", "warning", "info"]).default("info"),
-      message: z2.string().min(1),
-      relatedPageIds: z2.array(z2.string()).optional(),
-      relatedSourceIds: z2.array(z2.string()).optional(),
-      suggestedQuery: z2.string().optional()
+import path7 from "path";
+import { z as z3 } from "zod";
+var orchestrationRoleResultSchema = z3.object({
+  summary: z3.string().optional(),
+  findings: z3.array(
+    z3.object({
+      severity: findingSeveritySchema,
+      message: z3.string().min(1),
+      relatedPageIds: z3.array(z3.string()).optional(),
+      relatedSourceIds: z3.array(z3.string()).optional(),
+      suggestedQuery: z3.string().optional()
     })
   ).default([]),
-  questions: z2.array(z2.string().min(1)).default([]),
-  proposals: z2.array(
-    z2.object({
-      path: z2.string().min(1),
-      content: z2.string().min(1),
-      reason: z2.string().min(1)
+  questions: z3.array(z3.string().min(1)).default([]),
+  proposals: z3.array(
+    z3.object({
+      path: z3.string().min(1),
+      content: z3.string().min(1),
+      reason: z3.string().min(1)
     })
   ).default([])
 });
@@ -1600,7 +1617,7 @@ function summarizeRoleQuestions(results) {
 // src/web-search/registry.ts
 import path8 from "path";
 import { pathToFileURL } from "url";
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 
 // src/web-search/http-json.ts
 function deepGet(value, pathValue) {
@@ -1682,10 +1699,10 @@ var HttpJsonWebSearchAdapter = class {
 };
 
 // src/web-search/registry.ts
-var customWebSearchModuleSchema = z3.object({
-  createAdapter: z3.function({
-    input: [z3.string(), z3.custom(), z3.string()],
-    output: z3.promise(z3.custom())
+var customWebSearchModuleSchema = z4.object({
+  createAdapter: z4.function({
+    input: [z4.string(), z4.custom(), z4.string()],
+    output: z4.promise(z4.custom())
   })
 });
 async function createWebSearchAdapter(id, config, rootDir) {
@@ -1720,15 +1737,15 @@ async function getWebSearchAdapterForTask(rootDir, task) {
 }
 
 // src/deep-lint.ts
-var deepLintResponseSchema = z4.object({
-  findings: z4.array(
-    z4.object({
-      severity: z4.enum(["error", "warning", "info"]).default("info"),
-      code: z4.enum(["coverage_gap", "contradiction_candidate", "missing_citation", "candidate_page", "follow_up_question"]),
-      message: z4.string().min(1),
-      relatedSourceIds: z4.array(z4.string()).default([]),
-      relatedPageIds: z4.array(z4.string()).default([]),
-      suggestedQuery: z4.string().optional()
+var deepLintResponseSchema = z5.object({
+  findings: z5.array(
+    z5.object({
+      severity: findingSeveritySchema,
+      code: z5.enum(["coverage_gap", "contradiction_candidate", "missing_citation", "candidate_page", "follow_up_question"]),
+      message: z5.string().min(1),
+      relatedSourceIds: z5.array(z5.string()).default([]),
+      relatedPageIds: z5.array(z5.string()).default([]),
+      suggestedQuery: z5.string().optional()
     })
   ).max(20)
 });
@@ -1982,199 +1999,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 +2628,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 +2760,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,77 +2804,271 @@ 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;
-}
-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;
-  }, []);
+// src/output-artifacts.ts
+import { z as z6 } from "zod";
+function escapeXml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 }
-function normalizeTimestamp(value, fallback) {
-  if (typeof value !== "string") {
-    return fallback;
-  }
-  const parsed = Date.parse(value);
-  return Number.isNaN(parsed) ? fallback : new Date(parsed).toISOString();
+function clampNumber(value, min, max) {
+  return Math.min(max, Math.max(min, value));
 }
-async function loadExistingManagedPageState(absolutePath, defaults = {}) {
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  const createdFallback = defaults.createdAt ?? now;
-  const updatedFallback = defaults.updatedAt ?? createdFallback;
+var chartSpecSchema = z6.object({
+  kind: z6.enum(["bar", "line"]).default("bar"),
+  title: z6.string().min(1),
+  subtitle: z6.string().optional(),
+  xLabel: z6.string().optional(),
+  yLabel: z6.string().optional(),
+  seriesLabel: z6.string().optional(),
+  data: z6.array(
+    z6.object({
+      label: z6.string().min(1),
+      value: z6.number().finite()
+    })
+  ).min(2).max(12),
+  notes: z6.array(z6.string().min(1)).max(5).optional()
+});
+var sceneSpecSchema = z6.object({
+  title: z6.string().min(1),
+  alt: z6.string().min(1),
+  background: z6.string().optional(),
+  width: z6.number().int().positive().max(2400).optional(),
+  height: z6.number().int().positive().max(2400).optional(),
+  elements: z6.array(
+    z6.object({
+      kind: z6.enum(["shape", "label"]),
+      shape: z6.enum(["rect", "circle", "line"]).optional(),
+      x: z6.number().finite(),
+      y: z6.number().finite(),
+      width: z6.number().finite().optional(),
+      height: z6.number().finite().optional(),
+      radius: z6.number().finite().optional(),
+      text: z6.string().optional(),
+      fontSize: z6.number().finite().optional(),
+      fill: z6.string().optional(),
+      stroke: z6.string().optional(),
+      strokeWidth: z6.number().finite().optional(),
+      opacity: z6.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;
+  }, []);
+}
+function normalizeTimestamp(value, fallback) {
+  if (typeof value !== "string") {
+    return fallback;
+  }
+  const parsed = Date.parse(value);
+  return Number.isNaN(parsed) ? fallback : new Date(parsed).toISOString();
+}
+async function loadExistingManagedPageState(absolutePath, defaults = {}) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const createdFallback = defaults.createdAt ?? now;
+  const updatedFallback = defaults.updatedAt ?? createdFallback;
   if (!await fileExists(absolutePath)) {
     return {
       status: defaults.status ?? "active",
@@ -5091,7 +5103,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 +5144,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 +5193,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 ?? [],
@@ -5308,8 +5333,8 @@ async function generateFollowUpQuestions(rootDir, question, answer) {
 Current answer:
 ${answer}`
     },
-    z6.object({
-      questions: z6.array(z6.string().min(1)).max(5)
+    z7.object({
+      questions: z7.array(z7.string().min(1)).max(5)
     })
   );
   return uniqueBy(response.questions, (item) => item).filter((item) => item !== question);
@@ -6144,9 +6169,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 +6531,7 @@ async function bootstrapDemo(rootDir, input) {
 }
 
 // src/mcp.ts
-var SERVER_VERSION = "0.1.7";
+var SERVER_VERSION = "0.1.9";
 async function createMcpServer(rootDir) {
   const server = new McpServer({
     name: "swarmvault",
@@ -6530,8 +6553,8 @@ async function createMcpServer(rootDir) {
     {
       description: "Search compiled wiki pages using the local full-text index.",
       inputSchema: {
-        query: z7.string().min(1).describe("Search query"),
-        limit: z7.number().int().min(1).max(25).optional().describe("Maximum number of results")
+        query: z8.string().min(1).describe("Search query"),
+        limit: z8.number().int().min(1).max(25).optional().describe("Maximum number of results")
       }
     },
     async ({ query, limit }) => {
@@ -6544,7 +6567,7 @@ async function createMcpServer(rootDir) {
     {
       description: "Read a generated wiki page by its path relative to wiki/.",
       inputSchema: {
-        path: z7.string().min(1).describe("Path relative to wiki/, for example sources/example.md")
+        path: z8.string().min(1).describe("Path relative to wiki/, for example sources/example.md")
       }
     },
     async ({ path: relativePath }) => {
@@ -6560,7 +6583,7 @@ async function createMcpServer(rootDir) {
     {
       description: "List source manifests in the current workspace.",
       inputSchema: {
-        limit: z7.number().int().min(1).max(100).optional().describe("Maximum number of manifests to return")
+        limit: z8.number().int().min(1).max(100).optional().describe("Maximum number of manifests to return")
       }
     },
     async ({ limit }) => {
@@ -6573,9 +6596,9 @@ async function createMcpServer(rootDir) {
     {
       description: "Ask a question against the compiled vault and optionally save the answer.",
       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")
+        question: z8.string().min(1).describe("Question to ask the vault"),
+        save: z8.boolean().optional().describe("Persist the answer to wiki/outputs"),
+        format: z8.enum(["markdown", "report", "slides", "chart", "image"]).optional().describe("Output format")
       }
     },
     async ({ question, save, format }) => {
@@ -6592,7 +6615,7 @@ async function createMcpServer(rootDir) {
     {
       description: "Ingest a local file path or URL into the SwarmVault workspace.",
       inputSchema: {
-        input: z7.string().min(1).describe("Local path or URL to ingest")
+        input: z8.string().min(1).describe("Local path or URL to ingest")
       }
     },
     async ({ input }) => {
@@ -6605,7 +6628,7 @@ async function createMcpServer(rootDir) {
     {
       description: "Compile source manifests into wiki pages, graph data, and search index.",
       inputSchema: {
-        approve: z7.boolean().optional().describe("Stage a review bundle without applying active page changes")
+        approve: z8.boolean().optional().describe("Stage a review bundle without applying active page changes")
       }
     },
     async ({ approve }) => {
@@ -6803,283 +6826,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`);
+function scheduleStatePath(schedulesDir, jobId) {
+  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 +6936,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 +7088,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";