@iamu-dev/iamu 0.3.0-beta.6 → 0.4.0-beta.1

package/dist/ui/html-report.d.ts

@@ -0,0 +1,119 @@
+import { type CheckOutcome, type RunChecks } from "@iamu-dev/local-store";
+export interface HtmlReportHighlight {
+    targetBox: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        viewportWidth?: number;
+        viewportHeight?: number;
+        viewport_width?: number;
+        viewport_height?: number;
+    };
+    label?: string;
+    severity?: string | null;
+    type?: string;
+}
+export interface HtmlReportStep {
+    stepNumber: number;
+    action: string;
+    screenTitle?: string | null;
+    personaReasoning?: string | null;
+    url?: string | null;
+    screenshotUrl?: string | null;
+    targetBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        viewportWidth?: number;
+        viewportHeight?: number;
+        viewport_width?: number;
+        viewport_height?: number;
+    } | null;
+    highlights?: HtmlReportHighlight[];
+}
+export interface HtmlReportFinding {
+    id: string;
+    title: string;
+    type: string;
+    severity?: string | null;
+    uiFact?: string | null;
+    consequence?: string | null;
+    recommendation?: string | null;
+    /** "/request · step 8" */
+    where?: string | null;
+    isNew?: boolean;
+    persists?: boolean;
+}
+export interface HtmlReportVerdict {
+    question: string;
+    rating: string;
+    reasoning?: string;
+}
+export interface HtmlReportSinceItem {
+    title: string;
+    note?: string;
+    step_ids?: string[];
+    fixed_before?: boolean;
+    severity_before?: string;
+    severity_now?: string;
+}
+export interface HtmlReportVerification {
+    resolved: HtmlReportSinceItem[];
+    persists: HtmlReportSinceItem[];
+    notObserved?: HtmlReportSinceItem[];
+    newFindings: Array<{
+        type?: string;
+    }>;
+}
+export interface HtmlReportData {
+    scenarioName: string;
+    scenarioNarrative?: string | null;
+    persona?: {
+        name: string;
+        role?: string | null;
+        context?: string | null;
+    } | null;
+    walkthroughId: string;
+    runNumber?: number | string | null;
+    startedAt?: string | null | Date;
+    completedAt?: string | null | Date;
+    targetUrl?: string | null;
+    steps: HtmlReportStep[];
+    findings: HtmlReportFinding[];
+    verdicts?: HtmlReportVerdict[];
+    /** The run's answer to "would they come back", with one label for all tests. */
+    overall?: {
+        question: string;
+        label: string;
+        answer: string | null;
+        reasoning: string | null;
+    } | null;
+    verification?: HtmlReportVerification | null;
+    whatWorked?: string[];
+    openQuestions?: string[];
+    /** The walker's doubts about the test setup. */
+    setupNotes?: string[];
+    /** What a re-run was sent to check, with this run's outcome for each fix. */
+    checks?: {
+        fixes: Array<RunChecks["fixes"][number] & {
+            outcome: CheckOutcome;
+        }>;
+        directions: string[];
+    } | null;
+}
+export declare function generateHtmlReport(data: HtmlReportData): string;
+/**
+ * Builds HtmlReportData by reading a completed run directory and resolving
+ * persona/scenario files and local screenshots into base64 data URIs.
+ */
+export declare function buildReportDataFromRun(projectRoot: string, runId: string): Promise<HtmlReportData>;
+/**
+ * Creates and writes a self-contained local HTML report for a walkthrough run.
+ * Defaults to writing to `iamu/.runs/<runId>/report.html`.
+ */
+export declare function createLocalHtmlReport(projectRoot: string, runId: string, destination?: string): Promise<{
+    filePath: string;
+    html: string;
+}>;

package/dist/ui/report-view.d.ts

@@ -0,0 +1,116 @@
+export type VerdictLabel = "YES" | "PARTIAL" | "NO" | "PENDING" | "BLOCKED";
+export interface RunFindingRow {
+    id: string;
+    /** Finding file slug, for `iamu triage <slug>`; null when the file is gone. */
+    slug: string | null;
+    severity: string | null;
+    type: string;
+    title: string;
+    where: string | null;
+    /** The advisor's recommendation, when the run was advised. */
+    recommendation: string | null;
+    persists: boolean;
+    isNew: boolean;
+}
+export type SinceOutcome = "resolved" | "persists" | "not_seen" | "uncertain";
+export interface RunView {
+    persona: string;
+    situation: string;
+    completedAt: string | null;
+    steps: number;
+    targetUrl: string | null;
+    /** Cloud link, or a note that the run is not synced; null when not linked. */
+    cloud: string | null;
+    verdict: {
+        label: VerdictLabel;
+        question: string | null;
+        answer: string | null;
+    };
+    tests: Array<{
+        question: string;
+        label: VerdictLabel;
+    }>;
+    since: {
+        baselineAt: string | null;
+        resolved: number;
+        persists: number;
+        added: number;
+        notSeen: number;
+        /** Each earlier finding this run re-checked, by title. */
+        items: Array<{
+            title: string;
+            outcome: SinceOutcome;
+            /** Why the matcher judged it so. */
+            note: string | null;
+            /** Marked addressed before this run: persisting means the fix did not hold. */
+            fixedBefore: boolean;
+            /** Persists only: "less severe, major → minor" or "worse, …", else "". */
+            shift: string;
+        }>;
+    } | null;
+    findings: RunFindingRow[];
+    strengths: string[];
+    directions: Array<{
+        title: string;
+        size: string;
+        absorbs: number;
+        verify: number;
+    }>;
+    observations: Array<{
+        kind: string;
+        title: string;
+    }>;
+    /** The fixes this run re-checked: how many, confirmed fixed, and came back. */
+    checks: {
+        fixes: number;
+        fixed: number;
+        cameBack: number;
+        directions: string[];
+    } | null;
+    /** The walker's doubts about the test setup. */
+    setupNotes: string[];
+}
+export interface OverviewRun {
+    completedAt: string | null;
+    label: VerdictLabel;
+    problems: number;
+    /** Problems by severity: critical, major, minor (minor includes observations). */
+    bySeverity: {
+        critical: number;
+        major: number;
+        minor: number;
+    };
+    resolved: number;
+    persists: number;
+    added: number;
+}
+export interface OverviewScenario {
+    persona: string;
+    situation: string;
+    slug: string;
+    runs: OverviewRun[];
+    latestAnswer: string | null;
+}
+export interface OverviewView {
+    project: string;
+    scenarios: OverviewScenario[];
+    openProblems: number;
+    directions: Array<{
+        title: string;
+        status: string;
+        size: string;
+        absorbs: number;
+    }>;
+}
+export declare function verdictColor(label: VerdictLabel): (s: string) => string;
+/** "9 Oct 07:54" in local time; the raw value when it does not parse. */
+export declare function shortDate(iso: string | null): string;
+/** Word-wrap plain text to `width`, each line prefixed with `indent`. */
+export declare function wrap(text: string, width: number, indent: string): string[];
+export declare function firstSentence(text: string): string;
+/** Opening sentences of a text, enough to say something (≥ 60 chars). */
+export declare function lead(text: string): string;
+/** The latest run of one scenario, outcome first. */
+export declare function renderRunView(v: RunView, width?: number): string[];
+/** Every scenario and how its runs went, newest scenario first. */
+export declare function renderOverview(v: OverviewView, width?: number): string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamu-dev/iamu",
-  "version": "0.3.0-beta.6",
+  "version": "0.4.0-beta.1",
   "type": "module",
   "description": "Test your product as realistic personas — scenario-driven development CLI",
   "license": "UNLICENSED",
@@ -58,9 +58,9 @@
     "tsup": "^8.5.1",
     "typescript": "^5.8.0",
     "vitest": "^4.1.11",
+    "@iamu-dev/local-store": "0.1.0",
     "@iamu-dev/protocol": "0.1.0",
-    "@iamu/tsconfig": "0.1.0",
-    "@iamu-dev/local-store": "0.1.0"
+    "@iamu/tsconfig": "0.1.0"
   },
   "scripts": {
     "build": "tsup && tsc -b --force tsconfig.build.json --emitDeclarationOnly && node scripts/copy-assets.mjs",