@treeseed/sdk 0.13.0-rc.2 → 0.13.0-rc.21

package/dist/scenes/support/training/training-transcript.js

@@ -1,206 +0,0 @@
-import { stepOffset } from "./training-captions.js";
-const BUILT_IN_GLOSSARY = {
-  reconciliation: "Exact-state comparison and repair from declared Treeseed desired state to observed live state.",
-  operation: "A tracked Treeseed platform task with lifecycle status, events, and durable evidence.",
-  checkpoint: "A durable scene marker that records completed workflow progress and possible resume position.",
-  segment: "A bounded section of a long scene used for evidence organization and future partial rendering.",
-  "managed dev": "The worktree-scoped local Treeseed development runtime supervised by SDK managed-dev services.",
-  seed: "A deterministic Treeseed data/configuration input planned or applied through canonical SDK seed services.",
-  auth: "A resolved non-interactive Treeseed market profile and session context.",
-  provider: "A host, service, or external platform managed only through canonical Treeseed reconciliation paths.",
-  Remotion: "The Phase 6 adapter-hosted renderer used to turn scene evidence into video outputs.",
-  Playwright: "The browser automation engine used by scene runs to collect executable acceptance evidence."
-};
-function text(value) {
-  return (value ?? "").replace(/\s+/gu, " ").trim();
-}
-function chapterForStep(run, stepId) {
-  return (run.chapters ?? []).find((chapter) => chapter.stepIds.includes(stepId)) ?? null;
-}
-function actionSummary(actionKind) {
-  if (actionKind === "goto") return "navigates the browser to the expected screen";
-  if (actionKind === "click") return "performs the requested user click";
-  if (actionKind === "clickVisibleSequence") return "uses the visible controls for the active responsive layout";
-  if (actionKind === "fill") return "fills a browser field";
-  if (actionKind === "keyboard") return "sends a keyboard command";
-  if (actionKind === "browserHistory") return "moves through browser history";
-  if (actionKind === "waitForOperation") return "waits for a Treeseed platform operation to reach an accepted state";
-  if (actionKind === "pause") return "pauses the demo workflow at an intentional control point";
-  if (actionKind === "mailpitConfirmLatest") return "opens the latest local Mailpit confirmation link in the browser";
-  return `runs ${actionKind}`;
-}
-function buildSceneTranscriptEntries(input) {
-  const entries = [{
-    id: "scene",
-    timestampMs: 0,
-    type: "scene",
-    title: input.scene.title,
-    text: text(input.scene.description) || `Scene ${input.scene.id} completed with status ${input.run.workflowStatus}.`
-  }];
-  if (input.scene.audience.length > 0) {
-    entries.push({
-      id: "scene-audience",
-      timestampMs: 0,
-      type: "scene",
-      title: "Audience",
-      text: input.scene.audience.join(", ")
-    });
-  }
-  for (const chapter of input.run.chapters ?? []) {
-    const firstStep = chapter.stepIds[0];
-    entries.push({
-      id: `chapter-${chapter.id}`,
-      timestampMs: firstStep ? stepOffset({ stepId: firstStep, timeline: input.timeline }) : 0,
-      type: "chapter",
-      title: chapter.title,
-      text: `Chapter ${chapter.title} covers ${chapter.stepIds.length} scene step${chapter.stepIds.length === 1 ? "" : "s"}.`,
-      chapterId: chapter.id
-    });
-  }
-  input.run.steps.forEach((step, index) => {
-    const chapter = chapterForStep(input.run, step.id);
-    entries.push({
-      id: `step-${step.id}`,
-      timestampMs: stepOffset({ stepId: step.id, timeline: input.timeline, fallbackMs: index * 4e3 }),
-      type: "step",
-      title: step.title,
-      text: `This step ${actionSummary(step.actionKind)} and records ${step.assertionResults.length} assertion result${step.assertionResults.length === 1 ? "" : "s"}.`,
-      stepId: step.id,
-      chapterId: chapter?.id ?? null
-    });
-  });
-  for (const overlay of input.scene.overlays ?? []) {
-    if (!overlay.text) continue;
-    const chapter = chapterForStep(input.run, overlay.at);
-    entries.push({
-      id: `overlay-${overlay.id}`,
-      timestampMs: stepOffset({ stepId: overlay.at, timeline: input.timeline }),
-      type: "overlay",
-      title: overlay.id,
-      text: overlay.text,
-      stepId: overlay.at,
-      chapterId: chapter?.id ?? null
-    });
-  }
-  for (const diagram of input.scene.diagrams ?? []) {
-    const chapter = chapterForStep(input.run, diagram.at);
-    const title = typeof diagram.props?.title === "string" ? diagram.props.title : diagram.id;
-    entries.push({
-      id: `diagram-${diagram.id}`,
-      timestampMs: stepOffset({ stepId: diagram.at, timeline: input.timeline }),
-      type: "diagram",
-      title,
-      text: `${diagram.component} renders as ${diagram.placement} evidence for step ${diagram.at}.`,
-      stepId: diagram.at,
-      chapterId: chapter?.id ?? null
-    });
-  }
-  const failedStep = input.run.failedStep ? input.run.steps.find((step) => step.id === input.run.failedStep) : null;
-  if (failedStep?.error && input.scene.training.narration.includeDiagnostics) {
-    const chapter = chapterForStep(input.run, failedStep.id);
-    entries.push({
-      id: `diagnostic-${failedStep.id}`,
-      timestampMs: stepOffset({ stepId: failedStep.id, timeline: input.timeline }),
-      type: "diagnostic",
-      title: failedStep.error.code,
-      text: failedStep.error.message,
-      stepId: failedStep.id,
-      chapterId: chapter?.id ?? null
-    });
-  }
-  return entries.sort((a, b) => a.timestampMs - b.timestampMs || a.id.localeCompare(b.id));
-}
-function scriptFor(entry, style) {
-  if (style === "concise") return `${entry.title}: ${entry.text}`;
-  if (style === "operator") return `Operator note. ${entry.title}. ${entry.text}`;
-  if (entry.type === "step") return `${entry.title}. This proves the workflow can ${entry.text.replace(/^This step /u, "")}`;
-  if (entry.type === "diagnostic") return `Review ${entry.title}. The recorded diagnostic is: ${entry.text}`;
-  return `${entry.title}. ${entry.text}`;
-}
-function buildSceneNarrationEntries(input) {
-  return input.transcript.map((entry, index) => ({
-    id: `narration-${entry.id}`,
-    order: index + 1,
-    ...entry.chapterId ? { chapterId: entry.chapterId } : {},
-    ...entry.stepId ? { stepId: entry.stepId } : {},
-    title: entry.title,
-    script: scriptFor(entry, input.style),
-    source: entry.type
-  }));
-}
-function buildSceneGlossary(input) {
-  const explicit = /* @__PURE__ */ new Map();
-  for (const term of input.scene.training.glossary.terms) explicit.set(term.term.toLowerCase(), term);
-  const haystack = input.transcript.map((entry) => `${entry.title} ${entry.text}`).join(" ").toLowerCase();
-  const terms = /* @__PURE__ */ new Map();
-  for (const [term, definition] of Object.entries(BUILT_IN_GLOSSARY)) {
-    if (haystack.includes(term.toLowerCase())) terms.set(term.toLowerCase(), { term, definition, tags: ["built-in"] });
-  }
-  for (const term of input.scene.diagrams.map((diagram) => diagram.component)) {
-    terms.set(term.toLowerCase(), { term, definition: "A typed Treeseed scene diagram component rendered from validated manifest props.", tags: ["diagram"] });
-  }
-  for (const [key, term] of explicit) terms.set(key, term);
-  return [...terms.values()].sort((a, b) => a.term.localeCompare(b.term));
-}
-function buildSceneChapterClips(input) {
-  const chapters = input.run.chapters.length > 0 ? input.run.chapters : [{ id: "default", title: input.scene.title, stepIds: input.run.steps.map((step) => step.id), segmentIds: input.run.segments.map((segment) => segment.id) }];
-  return chapters.map((chapter) => {
-    const starts = chapter.stepIds.map((stepId) => stepOffset({ stepId, timeline: input.timeline }));
-    const ends = chapter.stepIds.map((stepId) => stepOffset({ stepId, timeline: input.timeline, prefer: "end", fallbackMs: stepOffset({ stepId, timeline: input.timeline }) + 4e3 }));
-    const startOffsetMs = Math.min(...starts, 0);
-    const endOffsetMs = Math.max(...ends, startOffsetMs + 4e3);
-    const safeName = `${input.scene.id}-${chapter.id}`.toLowerCase().replace(/[^a-z0-9._-]+/gu, "-");
-    return {
-      id: `${chapter.id}-clip`,
-      chapterId: chapter.id,
-      title: chapter.title,
-      startOffsetMs,
-      endOffsetMs,
-      durationMs: Math.max(0, endOffsetMs - startOffsetMs),
-      stepIds: chapter.stepIds,
-      segmentIds: chapter.segmentIds,
-      suggestedOutputName: `${safeName}.mp4`
-    };
-  });
-}
-function formatSceneTranscriptMarkdown(entries) {
-  const scene = entries.find((entry) => entry.type === "scene");
-  const lines = [`# ${scene?.title ?? "Treeseed Scene Transcript"}`, ""];
-  for (const entry of entries) {
-    if (entry.id === "scene") {
-      lines.push(entry.text, "");
-    } else if (entry.type === "chapter") {
-      lines.push(`## Chapter: ${entry.title}`, "", entry.text, "");
-    } else {
-      const label = entry.type.charAt(0).toUpperCase() + entry.type.slice(1);
-      lines.push(`### ${label}: ${entry.title}`, "", entry.text, "");
-    }
-  }
-  return `${lines.join("\n").trimEnd()}
-`;
-}
-function formatSceneNarrationMarkdown(entries) {
-  const lines = ["# Treeseed Scene Narration Script", ""];
-  for (const entry of entries) {
-    lines.push(`## ${entry.order}. ${entry.title}`, "", entry.script, "");
-  }
-  return `${lines.join("\n").trimEnd()}
-`;
-}
-function formatSceneGlossaryMarkdown(terms) {
-  const lines = ["# Treeseed Scene Glossary", ""];
-  for (const term of terms) {
-    lines.push(`## ${term.term}`, "", term.definition ?? "No definition provided.", "");
-  }
-  return `${lines.join("\n").trimEnd()}
-`;
-}
-export {
-  buildSceneChapterClips,
-  buildSceneGlossary,
-  buildSceneNarrationEntries,
-  buildSceneTranscriptEntries,
-  formatSceneGlossaryMarkdown,
-  formatSceneNarrationMarkdown,
-  formatSceneTranscriptMarkdown
-};

package/dist/scenes/support/training/training.d.ts

@@ -1,10 +0,0 @@
-import type { SceneManifest, SceneRunReport, SceneTimelineEvent, SceneTrainingOutputOptions, SceneTrainingOutputReport, SceneTrainingOutputs } from '../../types.js';
-import { formatSceneCaptionsSrt, formatSceneCaptionsVtt } from './training-captions.js';
-import { formatSceneNarrationMarkdown, formatSceneTranscriptMarkdown } from './training-transcript.js';
-export declare function buildSceneTrainingOutputs(input: {
-    scene: SceneManifest;
-    run: SceneRunReport;
-    timeline: SceneTimelineEvent[];
-}): SceneTrainingOutputs;
-export declare function generateSceneTrainingOutputs(input: SceneTrainingOutputOptions): SceneTrainingOutputReport;
-export { formatSceneCaptionsSrt, formatSceneCaptionsVtt, formatSceneNarrationMarkdown, formatSceneTranscriptMarkdown };

package/dist/scenes/support/training/training.js

@@ -1,134 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-import { validateScene } from "../execution/planner.js";
-import { sceneErrorDiagnostic } from "../reporting/diagnostics.js";
-import { resolveSceneRunRoot } from "../reporting/inspect.js";
-import { defaultSceneTrainingConfig } from "../validation/schema.js";
-import { buildSceneCaptionCues, formatSceneCaptionsSrt, formatSceneCaptionsVtt } from "./training-captions.js";
-import { appendSceneTrainingOutputPaths, writeSceneTrainingOutputs } from "./training-report.js";
-import {
-  buildSceneChapterClips,
-  buildSceneGlossary,
-  buildSceneNarrationEntries,
-  buildSceneTranscriptEntries,
-  formatSceneNarrationMarkdown,
-  formatSceneTranscriptMarkdown
-} from "./training-transcript.js";
-function readJson(path) {
-  return JSON.parse(readFileSync(path, "utf8"));
-}
-function nowIso() {
-  return (/* @__PURE__ */ new Date()).toISOString();
-}
-function normalizeScene(scene) {
-  return {
-    ...scene,
-    training: scene.training ?? defaultSceneTrainingConfig()
-  };
-}
-function applyFormatFilter(scene, formats) {
-  if (!formats || formats.length === 0) return scene;
-  const requested = new Set(formats);
-  return {
-    ...scene,
-    training: {
-      ...scene.training,
-      captions: {
-        ...scene.training.captions,
-        formats: scene.training.captions.formats.filter((format) => requested.has(format))
-      },
-      transcript: {
-        ...scene.training.transcript,
-        formats: scene.training.transcript.formats.filter((format) => requested.has(format))
-      }
-    }
-  };
-}
-function buildSceneTrainingOutputs(input) {
-  const scene = normalizeScene(input.scene);
-  const transcript = scene.training.transcript.enabled || scene.training.narration.enabled || scene.training.glossary.enabled ? buildSceneTranscriptEntries({ scene, run: input.run, timeline: input.timeline }) : [];
-  const captions = scene.training.captions.enabled ? buildSceneCaptionCues({ scene, run: input.run, timeline: input.timeline }) : [];
-  const narration = scene.training.narration.enabled ? buildSceneNarrationEntries({ scene, run: input.run, transcript, style: scene.training.narration.style }) : [];
-  const glossary = scene.training.glossary.enabled ? buildSceneGlossary({ scene, transcript }) : [];
-  const chapterClips = scene.training.chapterClips.enabled ? buildSceneChapterClips({ scene, run: input.run, timeline: input.timeline }) : [];
-  return {
-    schemaVersion: "treeseed.scene.training-output/v1",
-    sceneId: scene.id,
-    runId: input.run.runId,
-    generatedAt: nowIso(),
-    captions,
-    transcript,
-    narration,
-    glossary,
-    chapterClips
-  };
-}
-function failedReport(input) {
-  const blockers = input.blockers ?? input.diagnostics.filter((diagnostic) => diagnostic.severity === "error");
-  return {
-    ok: false,
-    phase: 8,
-    sceneId: null,
-    sourceRunId: null,
-    scenePath: input.scenePath,
-    runRoot: input.runRoot,
-    trainingRoot: input.runRoot ? join(input.runRoot, "training") : null,
-    outputs: null,
-    paths: null,
-    diagnostics: input.diagnostics,
-    warnings: input.warnings ?? input.diagnostics.filter((diagnostic) => diagnostic.severity === "warning"),
-    blockers
-  };
-}
-function generateSceneTrainingOutputs(input) {
-  const resolved = resolveSceneRunRoot(input.projectRoot, input.from);
-  if (!resolved.runRoot) return failedReport({ scenePath: input.scene, runRoot: null, diagnostics: resolved.diagnostics });
-  const scenePath = join(resolved.runRoot, "scene.normalized.json");
-  const runPath = join(resolved.runRoot, "run.json");
-  const timelinePath = join(resolved.runRoot, "timeline.json");
-  const blockers = [];
-  if (!existsSync(scenePath)) blockers.push(sceneErrorDiagnostic("scene.training_missing_scene", `Normalized scene artifact not found: ${scenePath}.`, "scene"));
-  if (!existsSync(runPath)) blockers.push(sceneErrorDiagnostic("scene.training_missing_run", `Run report artifact not found: ${runPath}.`, "from"));
-  if (!existsSync(timelinePath)) blockers.push(sceneErrorDiagnostic("scene.training_missing_timeline", `Timeline artifact not found: ${timelinePath}.`, "from"));
-  if (blockers.length > 0) return failedReport({ scenePath: input.scene, runRoot: resolved.runRoot, diagnostics: [...resolved.diagnostics, ...blockers], blockers });
-  const sourceScene = normalizeScene(readJson(scenePath));
-  const run = readJson(runPath);
-  const timeline = readJson(timelinePath);
-  const validation = validateScene({ projectRoot: input.projectRoot, scene: input.scene });
-  if (!validation.ok) return failedReport({ scenePath: validation.scenePath, runRoot: resolved.runRoot, diagnostics: validation.diagnostics });
-  if (validation.scene?.id !== sourceScene.id) {
-    const diagnostic = sceneErrorDiagnostic("scene.training_scene_mismatch", `Scene manifest "${validation.scene?.id ?? "(unknown)"}" does not match source run scene "${sourceScene.id}".`, "scene");
-    return failedReport({ scenePath: validation.scenePath, runRoot: resolved.runRoot, diagnostics: [diagnostic], blockers: [diagnostic] });
-  }
-  const scene = applyFormatFilter(sourceScene, input.formats);
-  try {
-    const outputs = buildSceneTrainingOutputs({ scene, run, timeline });
-    const paths = writeSceneTrainingOutputs({ runRoot: resolved.runRoot, scene, outputs });
-    const updateWarnings = appendSceneTrainingOutputPaths({ runPath, paths });
-    return {
-      ok: true,
-      phase: 8,
-      sceneId: sourceScene.id,
-      sourceRunId: run.runId,
-      scenePath: validation.scenePath,
-      runRoot: resolved.runRoot,
-      trainingRoot: paths.trainingRoot,
-      outputs,
-      paths,
-      diagnostics: updateWarnings,
-      warnings: updateWarnings,
-      blockers: []
-    };
-  } catch (error) {
-    const diagnostic = sceneErrorDiagnostic("scene.training_write_failed", `Training outputs could not be written. ${error instanceof Error ? error.message : String(error ?? "")}`.trim(), "training");
-    return failedReport({ scenePath: validation.scenePath, runRoot: resolved.runRoot, diagnostics: [diagnostic], blockers: [diagnostic] });
-  }
-}
-export {
-  buildSceneTrainingOutputs,
-  formatSceneCaptionsSrt,
-  formatSceneCaptionsVtt,
-  formatSceneNarrationMarkdown,
-  formatSceneTranscriptMarkdown,
-  generateSceneTrainingOutputs
-};

package/dist/scenes/support/validation/schema.d.ts

@@ -1,5 +0,0 @@
-export * from '../../schema/filesystem-safe-scene-id.js';
-export * from '../../schema/parse-action.js';
-export * from '../../schema/parse-diagrams.js';
-export * from '../../schema/parse-visual-audit.js';
-export * from '../../schema/parse-workflow.js';

package/dist/scenes/support/validation/schema.js

@@ -1,5 +0,0 @@
-export * from "../../schema/filesystem-safe-scene-id.js";
-export * from "../../schema/parse-action.js";
-export * from "../../schema/parse-diagrams.js";
-export * from "../../schema/parse-visual-audit.js";
-export * from "../../schema/parse-workflow.js";

package/dist/scenes/support/validation/selectors.d.ts

@@ -1,3 +0,0 @@
-import type { SceneLocator, ScenePage, SceneSelector } from '../../types.js';
-export declare function describeSceneSelector(selector: SceneSelector): string;
-export declare function resolveSceneLocator(page: ScenePage, selector: SceneSelector): SceneLocator;

package/dist/scenes/support/validation/selectors.js

@@ -1,21 +0,0 @@
-function escapeAttribute(value) {
-  return value.replace(/\\/gu, "\\\\").replace(/"/gu, '\\"');
-}
-function describeSceneSelector(selector) {
-  if ("scene" in selector) return `data-scene=${selector.scene}`;
-  if ("testId" in selector) return `data-testid=${selector.testId}`;
-  if ("role" in selector) return selector.name ? `role=${selector.role} name=${selector.name}` : `role=${selector.role}`;
-  if ("text" in selector) return `text=${selector.text}`;
-  return `css=${selector.css}`;
-}
-function resolveSceneLocator(page, selector) {
-  if ("scene" in selector) return page.locator(`[data-scene="${escapeAttribute(selector.scene)}"]`);
-  if ("testId" in selector) return page.getByTestId(selector.testId);
-  if ("role" in selector) return page.getByRole(selector.role, selector.name ? { name: selector.name } : void 0);
-  if ("text" in selector) return page.getByText(selector.text);
-  return page.locator(selector.css);
-}
-export {
-  describeSceneSelector,
-  resolveSceneLocator
-};

package/dist/scenes/support/visual-audit/visual-audit-contact-sheets.d.ts

@@ -1,6 +0,0 @@
-import type { SceneVisualAuditManifest, SceneVisualAuditPaths, SceneVisualAuditReview } from '../../types.js';
-export declare function writeSceneVisualAuditContactSheets(input: {
-    manifest: SceneVisualAuditManifest;
-    review: SceneVisualAuditReview;
-    paths: SceneVisualAuditPaths;
-}): void;

package/dist/scenes/support/visual-audit/visual-audit-contact-sheets.js

@@ -1,119 +0,0 @@
-import { mkdirSync, writeFileSync } from "node:fs";
-import { relative } from "node:path";
-function esc(value) {
-  return String(value ?? "").replace(/&/gu, "&amp;").replace(/</gu, "&lt;").replace(/>/gu, "&gt;").replace(/"/gu, "&quot;");
-}
-function slug(value) {
-  return value === "/" ? "root" : value.replace(/^\/+|\/+$/gu, "").replace(/[^a-z0-9]+/giu, "-").toLowerCase() || "root";
-}
-function rel(from, path) {
-  return path ? relative(from, path) : "";
-}
-function styles() {
-  return `<style>
-body{margin:0;background:#0f172a;color:#e2e8f0;font:14px/1.45 ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif}
-a{color:#38bdf8}
-header{position:sticky;top:0;background:#111827f2;border-bottom:1px solid #334155;padding:16px 22px;z-index:2}
-h1{margin:0 0 8px;font-size:22px} h2{margin:28px 22px 12px;font-size:18px}
-.meta{color:#cbd5e1}.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(280px,1fr));gap:16px;padding:0 22px 24px}
-.card{background:#1e293b;border:1px solid #334155;border-radius:8px;overflow:hidden;box-shadow:0 12px 30px #0004}
-.shot{display:block;background:#020617;aspect-ratio:16/10;overflow:hidden}.shot img{width:100%;height:100%;object-fit:contain;display:block}
-.body{padding:12px}.path{font-weight:700;color:#f8fafc}.sub{color:#cbd5e1;font-size:12px;margin-top:4px}.badges{display:flex;gap:6px;flex-wrap:wrap;margin-top:8px}
-.badge{font-size:11px;border-radius:999px;padding:3px 8px;background:#334155;color:#e2e8f0}.blocking,.high{background:#7f1d1d;color:#fecaca}.medium{background:#78350f;color:#fde68a}.low{background:#164e63;color:#bae6fd}.info{background:#365314;color:#d9f99d}
-.finding{font-size:12px;margin-top:8px;color:#f8fafc}.empty{padding:22px;color:#cbd5e1}
-.action{font-size:12px;margin-top:8px;color:#cbd5e1}.rank{background:#0f766e;color:#ccfbf1}.owner{background:#312e81;color:#ddd6fe}
-nav{display:flex;gap:10px;flex-wrap:wrap;margin-top:8px}
-nav a{border:1px solid #334155;border-radius:999px;padding:4px 10px;text-decoration:none;color:#e2e8f0}
-</style>`;
-}
-function renderPage(input) {
-  const reviewRoot = input.paths.reviewRoot;
-  const findingsByCapture = /* @__PURE__ */ new Map();
-  for (const finding of input.findings) {
-    const list = findingsByCapture.get(finding.captureId) ?? [];
-    list.push(finding);
-    findingsByCapture.set(finding.captureId, list);
-  }
-  const nav = [
-    `<a href="index.html">All</a>`,
-    `<a href="flagged.html">Flagged</a>`,
-    ...input.allRoots.map((root) => `<a href="${slug(root)}.html">${esc(root)}</a>`)
-  ].join("");
-  const cards = input.captures.map((capture) => {
-    const list = findingsByCapture.get(capture.id) ?? [];
-    const image = capture.screenshotPath ? rel(reviewRoot, capture.screenshotPath) : "";
-    const badges = list.slice(0, 5).map((finding) => `<span class="badge ${esc(finding.severity)}">${esc(finding.severity)} ${esc(finding.code.replace(/^visual\./u, ""))}</span>`).join("");
-    const findingText = list[0] ? `<div class="finding">${esc(list[0].message)}</div>` : "";
-    return `<article class="card">
-${image ? `<a class="shot" href="${esc(image)}"><img src="${esc(image)}" alt="${esc(capture.path)} ${esc(capture.role)} ${esc(capture.device)}"></a>` : '<div class="shot empty">No screenshot</div>'}
-<div class="body">
-<div class="path">${esc(capture.path)}</div>
-<div class="sub">${esc(capture.role)} / ${esc(capture.device)} / ${esc(capture.status)} / ${esc(capture.finalUrl ?? capture.url)}</div>
-${badges ? `<div class="badges">${badges}</div>` : ""}
-${findingText}
-</div>
-</article>`;
-  }).join("\n");
-  return `<!doctype html>
-<html lang="en">
-<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${esc(input.title)}</title>${styles()}</head>
-<body>
-<header>
-<h1>${esc(input.title)}</h1>
-<div class="meta">Scene ${esc(input.manifest.sceneId)} / audit ${esc(input.manifest.auditId)} / captures ${input.captures.length} / findings ${input.findings.length}</div>
-<nav>${nav}</nav>
-</header>
-${cards ? `<main class="grid">${cards}</main>` : '<main class="empty">No captures in this sheet.</main>'}
-</body>
-</html>
-`;
-}
-function renderRootCausePage(input) {
-  const reviewRoot = input.paths.reviewRoot;
-  const nav = `<a href="index.html">All</a><a href="flagged.html">Flagged</a><a href="root-causes.html">Root causes</a>`;
-  const cards = input.rootCauses.map((entry) => {
-    const image = entry.exampleScreenshotPath ? rel(reviewRoot, entry.exampleScreenshotPath) : "";
-    return `<article class="card" id="${esc(entry.id)}">
-${image ? `<a class="shot" href="${esc(image)}"><img src="${esc(image)}" alt="${esc(entry.title)}"></a>` : '<div class="shot empty">No screenshot</div>'}
-<div class="body">
-<div class="path">#${esc(entry.priorityRank)} ${esc(entry.title)}</div>
-<div class="sub">${esc(entry.suspectedOwner)} / ${esc(entry.severity)} / score ${esc(entry.priorityScore)} / count ${esc(entry.count)}</div>
-<div class="badges"><span class="badge rank">rank ${esc(entry.priorityRank)}</span><span class="badge owner">${esc(entry.suspectedOwner)}</span><span class="badge ${esc(entry.severity)}">${esc(entry.severity)}</span></div>
-<div class="finding">${esc(entry.paths.slice(0, 8).join(", "))}</div>
-<div class="action">${esc(entry.recommendedAction)}</div>
-</div>
-</article>`;
-  }).join("\n");
-  return `<!doctype html>
-<html lang="en">
-<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Visual Audit Root Causes</title>${styles()}</head>
-<body>
-<header>
-<h1>Visual Audit Root Causes</h1>
-<div class="meta">Scene ${esc(input.manifest.sceneId)} / audit ${esc(input.manifest.auditId)} / root causes ${input.rootCauses.length}</div>
-<nav>${nav}</nav>
-</header>
-${cards ? `<main class="grid">${cards}</main>` : '<main class="empty">No root causes.</main>'}
-</body>
-</html>
-`;
-}
-function writeSceneVisualAuditContactSheets(input) {
-  if (!input.paths.reviewRoot) return;
-  const root = `${input.paths.reviewRoot}/contact-sheets`;
-  mkdirSync(root, { recursive: true });
-  const roots = [...new Set(input.manifest.routes.map((route) => route.pathRoot))].sort();
-  const write = (name, title, captures, findings = input.review.findings) => {
-    writeFileSync(`${root}/${name}.html`, renderPage({ title, manifest: input.manifest, paths: input.paths, captures, findings, allRoots: roots }), "utf8");
-  };
-  write("index", "Visual Audit Contact Sheets", input.manifest.captures);
-  const flaggedIds = new Set(input.review.findings.map((finding) => finding.captureId));
-  write("flagged", "Flagged Visual Audit Captures", input.manifest.captures.filter((capture) => flaggedIds.has(capture.id)));
-  writeFileSync(`${root}/root-causes.html`, renderRootCausePage({ manifest: input.manifest, paths: input.paths, rootCauses: input.review.rootCauses }), "utf8");
-  for (const pathRoot of roots) {
-    write(slug(pathRoot), `Visual Audit ${pathRoot}`, input.manifest.captures.filter((capture) => capture.pathRoot === pathRoot));
-  }
-}
-export {
-  writeSceneVisualAuditContactSheets
-};

package/dist/scenes/support/visual-audit/visual-audit-report.d.ts

@@ -1,11 +0,0 @@
-import type { SceneVisualAuditManifest, SceneVisualAuditPaths, SceneVisualAuditReview } from '../../types.js';
-export declare function formatSceneVisualAuditMarkdown(input: {
-    manifest: SceneVisualAuditManifest;
-    paths: SceneVisualAuditPaths;
-    review?: SceneVisualAuditReview | null;
-}): string;
-export declare function writeSceneVisualAuditReport(input: {
-    manifest: SceneVisualAuditManifest;
-    paths: SceneVisualAuditPaths;
-    review?: SceneVisualAuditReview | null;
-}): void;

package/dist/scenes/support/visual-audit/visual-audit-report.js

@@ -1,85 +0,0 @@
-import { mkdirSync, writeFileSync } from "node:fs";
-import { relative } from "node:path";
-function md(value) {
-  return String(value ?? "").replace(/\|/gu, "\\|").replace(/\n/gu, " ");
-}
-function rel(root, path) {
-  return path ? relative(root, path) : "";
-}
-function firstDiagnostic(capture) {
-  return capture.diagnostics[0] ?? null;
-}
-function formatSceneVisualAuditMarkdown(input) {
-  const { manifest, paths } = input;
-  const failed = manifest.captures.filter((capture) => capture.status === "failed");
-  const skipped = manifest.captures.filter((capture) => capture.status === "skipped");
-  const captured = manifest.captures.filter((capture) => capture.status === "captured");
-  const roots = [...new Set(manifest.routes.map((route) => route.pathRoot))].sort();
-  const lines = [
-    "# TreeSeed Scene Visual Audit",
-    "",
-    `Scene: ${manifest.sceneId ?? "(unknown)"}`,
-    `Audit: ${manifest.auditId}`,
-    `Base URL: ${manifest.baseUrl ?? "(unresolved)"}`,
-    `Generated: ${manifest.generatedAt}`,
-    "",
-    "## Summary",
-    "",
-    `- Roles: ${manifest.roles.join(", ") || "(none)"}`,
-    `- Devices: ${manifest.devices.join(", ") || "(none)"}`,
-    `- Routes: ${manifest.routes.length}`,
-    `- Captures: ${captured.length}`,
-    `- Failed: ${failed.length}`,
-    `- Skipped: ${skipped.length}`,
-    `- Review findings: ${input.review?.summary.findingCount ?? 0}`,
-    `- Root causes: ${input.review?.summary.rootCauseCount ?? 0}`,
-    `- Incidents: ${input.review?.summary.incidentCount ?? 0}`,
-    `- Raw client errors: ${input.review?.summary.clientErrorCount ?? 0}`,
-    ""
-  ];
-  if (input.review && paths.reviewRoot) {
-    lines.push("## Review", "");
-    lines.push(`- Agent brief: [review/agent-brief.md](${md(rel(paths.auditRoot, paths.reviewAgentBriefPath))})`);
-    lines.push(`- Issue index: [review/issue-index.json](${md(rel(paths.auditRoot, `${paths.reviewRoot}/issue-index.json`))})`);
-    lines.push(`- Top priority: [review/query/top-priority.json](${md(rel(paths.auditRoot, `${paths.reviewRoot}/query/top-priority.json`))})`);
-    lines.push(`- Root causes: [review/root-causes.json](${md(rel(paths.auditRoot, `${paths.reviewRoot}/root-causes.json`))})`);
-    lines.push(`- Incidents: [review/incidents.json](${md(rel(paths.auditRoot, `${paths.reviewRoot}/incidents.json`))})`);
-    lines.push(`- Findings JSON: [review/findings.json](${md(rel(paths.auditRoot, paths.reviewFindingsPath))})`);
-    lines.push(`- Contact sheets: [review/contact-sheets/index.html](${md(rel(paths.auditRoot, `${paths.reviewRoot}/contact-sheets/index.html`))})`);
-    lines.push(`- Flagged contact sheet: [review/contact-sheets/flagged.html](${md(rel(paths.auditRoot, `${paths.reviewRoot}/contact-sheets/flagged.html`))})`);
-    lines.push(`- Root-cause contact sheet: [review/contact-sheets/root-causes.html](${md(rel(paths.auditRoot, `${paths.reviewRoot}/contact-sheets/root-causes.html`))})`);
-    lines.push("");
-  }
-  lines.push("## By Path Root", "");
-  for (const root of roots) {
-    lines.push(`### ${root}`, "");
-    lines.push("| Role | Device | Path | Status | Screenshot |");
-    lines.push("| --- | --- | --- | --- | --- |");
-    const captures = manifest.captures.filter((capture) => capture.pathRoot === root).sort((a, b) => `${a.role}:${a.device}:${a.path}`.localeCompare(`${b.role}:${b.device}:${b.path}`));
-    for (const capture of captures) {
-      const screenshot = capture.screenshotPath ? `[view](${md(rel(paths.auditRoot, capture.screenshotPath))})` : "";
-      lines.push(`| ${md(capture.role)} | ${md(capture.device)} | ${md(capture.path)} | ${md(capture.status)} | ${screenshot} |`);
-    }
-    lines.push("");
-  }
-  lines.push("## Failures", "");
-  lines.push("| Role | Device | Path | Code | Message |");
-  lines.push("| --- | --- | --- | --- | --- |");
-  for (const capture of [...failed, ...skipped]) {
-    const diagnostic = firstDiagnostic(capture);
-    lines.push(`| ${md(capture.role)} | ${md(capture.device)} | ${md(capture.path)} | ${md(diagnostic?.code ?? capture.status)} | ${md(diagnostic?.message ?? capture.status)} |`);
-  }
-  lines.push("");
-  return `${lines.join("\n")}
-`;
-}
-function writeSceneVisualAuditReport(input) {
-  mkdirSync(input.paths.auditRoot, { recursive: true });
-  writeFileSync(input.paths.manifestPath, `${JSON.stringify(input.manifest, null, 2)}
-`, "utf8");
-  writeFileSync(input.paths.reportPath, formatSceneVisualAuditMarkdown(input), "utf8");
-}
-export {
-  formatSceneVisualAuditMarkdown,
-  writeSceneVisualAuditReport
-};

package/dist/scenes/support/visual-audit/visual-audit-review.d.ts

@@ -1,4 +0,0 @@
-export * from '../../visual-audit-review/enrich-client-errors.js';
-export * from '../../visual-audit-review/format-owner-brief.js';
-export * from '../../visual-audit-review/incident-title.js';
-export * from '../../visual-audit-review/severities.js';

package/dist/scenes/support/visual-audit/visual-audit-review.js

@@ -1,4 +0,0 @@
-export * from "../../visual-audit-review/enrich-client-errors.js";
-export * from "../../visual-audit-review/format-owner-brief.js";
-export * from "../../visual-audit-review/incident-title.js";
-export * from "../../visual-audit-review/severities.js";

package/dist/scenes/support/visual-audit/visual-audit-routes.d.ts

@@ -1,13 +0,0 @@
-import type { SceneDiagnostic, SceneManifest, SceneVisualAuditRoute } from '../../types.js';
-export declare function discoverSceneVisualAuditRoutes(input: {
-    projectRoot: string;
-    scene: SceneManifest;
-    pathRoots?: string[];
-    pathGlobs?: string[];
-    excludePathGlobs?: string[];
-}): {
-    routes: SceneVisualAuditRoute[];
-    diagnostics: SceneDiagnostic[];
-};
-export declare function SceneVisualAuditPathRoot(path: string): string;
-export declare function SceneVisualAuditRouteFilename(path: string): string;