reflection-check 0.0.1

package/dist/core/report-schema.d.ts

@@ -0,0 +1,262 @@
+import { z } from 'zod';
+import { ExitCode } from './exit-codes.js';
+import type { RunMode } from './config.js';
+export declare const CheckStatusSchema: z.ZodEnum<{
+    error: "error";
+    pass: "pass";
+    fail: "fail";
+    warn: "warn";
+    skipped: "skipped";
+}>;
+export declare const CheckSeveritySchema: z.ZodEnum<{
+    blocking: "blocking";
+    review: "review";
+    info: "info";
+}>;
+export declare const CheckSuiteSchema: z.ZodEnum<{
+    design: "design";
+    visual: "visual";
+    component: "component";
+    browser: "browser";
+    environment: "environment";
+}>;
+export declare const ReportStatusSchema: z.ZodEnum<{
+    error: "error";
+    pass: "pass";
+    fail: "fail";
+    "pass-with-review": "pass-with-review";
+}>;
+export declare const ArtifactTypeSchema: z.ZodEnum<{
+    report: "report";
+    screenshot: "screenshot";
+    image: "image";
+    "visual-diff": "visual-diff";
+    trace: "trace";
+    video: "video";
+    log: "log";
+    metadata: "metadata";
+}>;
+export declare const ArtifactRoleSchema: z.ZodEnum<{
+    trace: "trace";
+    expected: "expected";
+    evidence: "evidence";
+    actual: "actual";
+    diff: "diff";
+    debug: "debug";
+}>;
+export declare const ArtifactRefSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        report: "report";
+        screenshot: "screenshot";
+        image: "image";
+        "visual-diff": "visual-diff";
+        trace: "trace";
+        video: "video";
+        log: "log";
+        metadata: "metadata";
+    }>;
+    role: z.ZodOptional<z.ZodEnum<{
+        trace: "trace";
+        expected: "expected";
+        evidence: "evidence";
+        actual: "actual";
+        diff: "diff";
+        debug: "debug";
+    }>>;
+    path: z.ZodString;
+    bytes: z.ZodOptional<z.ZodNumber>;
+    sha256: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const CheckResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    suite: z.ZodEnum<{
+        design: "design";
+        visual: "visual";
+        component: "component";
+        browser: "browser";
+        environment: "environment";
+    }>;
+    target: z.ZodString;
+    status: z.ZodEnum<{
+        error: "error";
+        pass: "pass";
+        fail: "fail";
+        warn: "warn";
+        skipped: "skipped";
+    }>;
+    severity: z.ZodEnum<{
+        blocking: "blocking";
+        review: "review";
+        info: "info";
+    }>;
+    summary: z.ZodString;
+    details: z.ZodOptional<z.ZodString>;
+    artifacts: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            report: "report";
+            screenshot: "screenshot";
+            image: "image";
+            "visual-diff": "visual-diff";
+            trace: "trace";
+            video: "video";
+            log: "log";
+            metadata: "metadata";
+        }>;
+        role: z.ZodOptional<z.ZodEnum<{
+            trace: "trace";
+            expected: "expected";
+            evidence: "evidence";
+            actual: "actual";
+            diff: "diff";
+            debug: "debug";
+        }>>;
+        path: z.ZodString;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    suggestedNextStep: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const SuggestedNextStepSchema: z.ZodObject<{
+    kind: z.ZodString;
+    summary: z.ZodString;
+}, z.core.$strip>;
+export declare const ReportSummarySchema: z.ZodObject<{
+    passed: z.ZodNumber;
+    failed: z.ZodNumber;
+    warnings: z.ZodNumber;
+    skipped: z.ZodNumber;
+    blockingFailures: z.ZodNumber;
+    reviewItems: z.ZodNumber;
+}, z.core.$strip>;
+export declare const ReflectionReportSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    runId: z.ZodString;
+    project: z.ZodString;
+    startedAt: z.ZodString;
+    finishedAt: z.ZodString;
+    status: z.ZodEnum<{
+        error: "error";
+        pass: "pass";
+        fail: "fail";
+        "pass-with-review": "pass-with-review";
+    }>;
+    mode: z.ZodEnum<{
+        smoke: "smoke";
+        design: "design";
+        visual: "visual";
+        full: "full";
+    }>;
+    ci: z.ZodBoolean;
+    environment: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    summary: z.ZodObject<{
+        passed: z.ZodNumber;
+        failed: z.ZodNumber;
+        warnings: z.ZodNumber;
+        skipped: z.ZodNumber;
+        blockingFailures: z.ZodNumber;
+        reviewItems: z.ZodNumber;
+    }, z.core.$strip>;
+    checks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        suite: z.ZodEnum<{
+            design: "design";
+            visual: "visual";
+            component: "component";
+            browser: "browser";
+            environment: "environment";
+        }>;
+        target: z.ZodString;
+        status: z.ZodEnum<{
+            error: "error";
+            pass: "pass";
+            fail: "fail";
+            warn: "warn";
+            skipped: "skipped";
+        }>;
+        severity: z.ZodEnum<{
+            blocking: "blocking";
+            review: "review";
+            info: "info";
+        }>;
+        summary: z.ZodString;
+        details: z.ZodOptional<z.ZodString>;
+        artifacts: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                report: "report";
+                screenshot: "screenshot";
+                image: "image";
+                "visual-diff": "visual-diff";
+                trace: "trace";
+                video: "video";
+                log: "log";
+                metadata: "metadata";
+            }>;
+            role: z.ZodOptional<z.ZodEnum<{
+                trace: "trace";
+                expected: "expected";
+                evidence: "evidence";
+                actual: "actual";
+                diff: "diff";
+                debug: "debug";
+            }>>;
+            path: z.ZodString;
+            bytes: z.ZodOptional<z.ZodNumber>;
+            sha256: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        suggestedNextStep: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    artifacts: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            report: "report";
+            screenshot: "screenshot";
+            image: "image";
+            "visual-diff": "visual-diff";
+            trace: "trace";
+            video: "video";
+            log: "log";
+            metadata: "metadata";
+        }>;
+        role: z.ZodOptional<z.ZodEnum<{
+            trace: "trace";
+            expected: "expected";
+            evidence: "evidence";
+            actual: "actual";
+            diff: "diff";
+            debug: "debug";
+        }>>;
+        path: z.ZodString;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    suggestedNextSteps: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        summary: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CheckStatus = z.output<typeof CheckStatusSchema>;
+export type CheckSeverity = z.output<typeof CheckSeveritySchema>;
+export type CheckSuite = z.output<typeof CheckSuiteSchema>;
+export type ReportStatus = z.output<typeof ReportStatusSchema>;
+export type ArtifactRef = z.output<typeof ArtifactRefSchema>;
+export type CheckResult = z.output<typeof CheckResultSchema>;
+export type ReflectionReport = z.output<typeof ReflectionReportSchema>;
+export type ReportSummary = z.output<typeof ReportSummarySchema>;
+export type SuggestedNextStep = z.output<typeof SuggestedNextStepSchema>;
+export declare function summarizeChecks(checks: CheckResult[]): ReportSummary;
+export declare function deriveReportStatus(checks: CheckResult[]): ReportStatus;
+export declare function deriveExitCode(status: ReportStatus): ExitCode;
+export declare function validateReport(report: unknown): ReflectionReport;
+export declare function createReport(input: {
+    runId: string;
+    project: string;
+    startedAt: Date;
+    finishedAt: Date;
+    mode: RunMode;
+    ci: boolean;
+    environment?: Record<string, unknown>;
+    checks: CheckResult[];
+    artifacts?: ArtifactRef[];
+    suggestedNextSteps?: SuggestedNextStep[];
+}): ReflectionReport;

package/dist/core/report-schema.js

@@ -0,0 +1,112 @@
+import { z } from 'zod';
+import { ExitCode } from './exit-codes.js';
+export const CheckStatusSchema = z.enum(['pass', 'fail', 'warn', 'skipped', 'error']);
+export const CheckSeveritySchema = z.enum(['blocking', 'review', 'info']);
+export const CheckSuiteSchema = z.enum(['design', 'browser', 'visual', 'component', 'environment']);
+export const ReportStatusSchema = z.enum(['pass', 'fail', 'pass-with-review', 'error']);
+export const ArtifactTypeSchema = z.enum(['report', 'screenshot', 'image', 'visual-diff', 'trace', 'video', 'log', 'metadata']);
+export const ArtifactRoleSchema = z.enum(['evidence', 'expected', 'actual', 'diff', 'trace', 'debug']);
+export const ArtifactRefSchema = z.object({
+    type: ArtifactTypeSchema,
+    role: ArtifactRoleSchema.optional(),
+    path: z.string().min(1),
+    bytes: z.number().int().nonnegative().optional(),
+    sha256: z.string().regex(/^[a-f0-9]{64}$/).optional()
+});
+export const CheckResultSchema = z.object({
+    id: z.string().min(1),
+    suite: CheckSuiteSchema,
+    target: z.string().min(1),
+    status: CheckStatusSchema,
+    severity: CheckSeveritySchema,
+    summary: z.string().min(1),
+    details: z.string().optional(),
+    artifacts: z.array(ArtifactRefSchema),
+    metadata: z.record(z.string(), z.unknown()),
+    suggestedNextStep: z.string().optional()
+});
+export const SuggestedNextStepSchema = z.object({
+    kind: z.string().min(1),
+    summary: z.string().min(1)
+});
+export const ReportSummarySchema = z.object({
+    passed: z.number().int().nonnegative(),
+    failed: z.number().int().nonnegative(),
+    warnings: z.number().int().nonnegative(),
+    skipped: z.number().int().nonnegative(),
+    blockingFailures: z.number().int().nonnegative(),
+    reviewItems: z.number().int().nonnegative()
+});
+export const ReflectionReportSchema = z.object({
+    schemaVersion: z.literal(1),
+    runId: z.string().min(1),
+    project: z.string().min(1),
+    startedAt: z.string().datetime(),
+    finishedAt: z.string().datetime(),
+    status: ReportStatusSchema,
+    mode: z.enum(['smoke', 'design', 'visual', 'full']),
+    ci: z.boolean(),
+    environment: z.record(z.string(), z.unknown()),
+    summary: ReportSummarySchema,
+    checks: z.array(CheckResultSchema),
+    artifacts: z.array(ArtifactRefSchema),
+    suggestedNextSteps: z.array(SuggestedNextStepSchema)
+});
+export function summarizeChecks(checks) {
+    return {
+        passed: checks.filter((check) => check.status === 'pass').length,
+        failed: checks.filter((check) => check.status === 'fail').length,
+        warnings: checks.filter((check) => check.status === 'warn').length,
+        skipped: checks.filter((check) => check.status === 'skipped').length,
+        blockingFailures: checks.filter((check) => check.severity === 'blocking' && (check.status === 'fail' || check.status === 'error')).length,
+        reviewItems: checks.filter((check) => check.severity === 'review' && (check.status === 'warn' || check.status === 'fail')).length
+    };
+}
+export function deriveReportStatus(checks) {
+    if (checks.some((check) => check.status === 'error')) {
+        return 'error';
+    }
+    if (checks.some((check) => check.severity === 'blocking' && check.status === 'fail')) {
+        return 'fail';
+    }
+    if (checks.some((check) => check.severity === 'review' && (check.status === 'warn' || check.status === 'fail'))) {
+        return 'pass-with-review';
+    }
+    return 'pass';
+}
+export function deriveExitCode(status) {
+    if (status === 'fail') {
+        return ExitCode.BlockingFailure;
+    }
+    if (status === 'error') {
+        return ExitCode.ToolOrConfigError;
+    }
+    return ExitCode.Success;
+}
+export function validateReport(report) {
+    const parsed = ReflectionReportSchema.safeParse(report);
+    if (!parsed.success) {
+        const details = parsed.error.issues.map((issue) => `${issue.path.join('.') || 'report'}: ${issue.message}`).join('; ');
+        throw new Error(`Invalid Reflection report: ${details}`);
+    }
+    return parsed.data;
+}
+export function createReport(input) {
+    const status = deriveReportStatus(input.checks);
+    return validateReport({
+        schemaVersion: 1,
+        runId: input.runId,
+        project: input.project,
+        startedAt: input.startedAt.toISOString(),
+        finishedAt: input.finishedAt.toISOString(),
+        status,
+        mode: input.mode,
+        ci: input.ci,
+        environment: input.environment ?? {},
+        summary: summarizeChecks(input.checks),
+        checks: input.checks,
+        artifacts: input.artifacts ?? [],
+        suggestedNextSteps: input.suggestedNextSteps ?? []
+    });
+}
+//# sourceMappingURL=report-schema.js.map

package/dist/core/report-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-schema.js","sourceRoot":"","sources":["../../src/core/report-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;AACpG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC;AACxF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;AAChI,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAEvG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,gBAAgB;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,mBAAmB;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3C,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACvC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAChD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CAC5C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,kBAAkB;IAC1B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACnD,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACf,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC9C,OAAO,EAAE,mBAAmB;IAC5B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACrC,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;CACrD,CAAC,CAAC;AAYH,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;QAChE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;QAChE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;QAClE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;QACpE,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAC7B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,CAClG,CAAC,MAAM;QACR,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM;KAClI,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,EAAE,CAAC;QACrD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,UAAU,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,EAAE,CAAC;QACrF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC;QAChH,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAC,eAAe,CAAC;IAClC,CAAC;IAED,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,OAAO,QAAQ,CAAC,iBAAiB,CAAC;IACpC,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvH,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAW5B;IACC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,cAAc,CAAC;QACpB,aAAa,EAAE,CAAC;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE;QACxC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE;QAC1C,MAAM;QACN,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;QACpC,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC;QACtC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE;QAChC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,IAAI,EAAE;KACnD,CAAC,CAAC;AACL,CAAC"}

package/dist/core/report-writer.d.ts

@@ -0,0 +1,4 @@
+import type { ArtifactStore } from './artifact-store.js';
+import type { ArtifactRef, ReflectionReport } from './report-schema.js';
+export declare function writeReports(store: ArtifactStore, report: ReflectionReport): Promise<ArtifactRef[]>;
+export declare function renderMarkdownReport(report: ReflectionReport): string;

package/dist/core/report-writer.js

@@ -0,0 +1,77 @@
+export async function writeReports(store, report) {
+    await store.ensureRunDir();
+    const reportJson = await store.writeJson('report.json', report);
+    const reportMd = await store.writeText('report.md', renderMarkdownReport(report));
+    await store.updateLatestPointer();
+    return [
+        { ...reportJson, type: 'report', role: 'evidence' },
+        { ...reportMd, type: 'report', role: 'evidence' }
+    ];
+}
+export function renderMarkdownReport(report) {
+    const lines = [];
+    lines.push('# Reflection Report');
+    lines.push('');
+    lines.push(`Project: ${report.project}`);
+    lines.push(`Run: ${report.runId}`);
+    lines.push(`Mode: ${report.mode}`);
+    lines.push(`Status: ${report.status}`);
+    lines.push('');
+    lines.push('## Summary');
+    lines.push('');
+    lines.push(`- Passed: ${report.summary.passed}`);
+    lines.push(`- Failed: ${report.summary.failed}`);
+    lines.push(`- Warnings: ${report.summary.warnings}`);
+    lines.push(`- Skipped: ${report.summary.skipped}`);
+    lines.push(`- Blocking failures: ${report.summary.blockingFailures}`);
+    lines.push(`- Review items: ${report.summary.reviewItems}`);
+    const blocking = report.checks.filter(isBlockingFailure);
+    if (blocking.length > 0) {
+        lines.push('');
+        lines.push('## Blocking failures');
+        lines.push('');
+        for (const check of blocking) {
+            lines.push(renderCheckLine(check));
+        }
+    }
+    const review = report.checks.filter(isReviewItem);
+    if (review.length > 0) {
+        lines.push('');
+        lines.push('## Review items');
+        lines.push('');
+        for (const check of review) {
+            lines.push(renderCheckLine(check));
+        }
+    }
+    lines.push('');
+    lines.push('## Checks');
+    lines.push('');
+    for (const check of report.checks) {
+        lines.push(renderCheckLine(check));
+        if (check.artifacts.length > 0) {
+            for (const artifact of check.artifacts) {
+                lines.push(`  - ${artifact.role ?? artifact.type}: ${artifact.path}`);
+            }
+        }
+    }
+    if (report.suggestedNextSteps.length > 0) {
+        lines.push('');
+        lines.push('## Suggested next steps');
+        lines.push('');
+        for (const step of report.suggestedNextSteps) {
+            lines.push(`- ${step.summary}`);
+        }
+    }
+    lines.push('');
+    return `${lines.join('\n')}\n`;
+}
+function isBlockingFailure(check) {
+    return check.severity === 'blocking' && (check.status === 'fail' || check.status === 'error');
+}
+function isReviewItem(check) {
+    return check.severity === 'review' && (check.status === 'warn' || check.status === 'fail');
+}
+function renderCheckLine(check) {
+    return `- ${check.status.toUpperCase()} ${check.id}: ${check.summary}`;
+}
+//# sourceMappingURL=report-writer.js.map

package/dist/core/report-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-writer.js","sourceRoot":"","sources":["../../src/core/report-writer.ts"],"names":[],"mappings":"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"}

package/dist/core/server-manager.d.ts

@@ -0,0 +1,23 @@
+export type ServerConfig = {
+    command: string;
+    readyUrl: string;
+    reuseExisting?: boolean;
+    timeoutMs?: number;
+};
+export type StartManagedServerOptions = {
+    cwd?: string;
+    logPath?: string;
+};
+export type ManagedServer = {
+    readyUrl: string;
+    reused: boolean;
+    started: boolean;
+    pid: number | undefined;
+    stop: () => Promise<void>;
+};
+export type WaitForUrlOptions = {
+    timeoutMs?: number;
+    intervalMs?: number;
+};
+export declare function startManagedServer(config: ServerConfig, options?: StartManagedServerOptions): Promise<ManagedServer>;
+export declare function waitForUrl(url: string, options?: WaitForUrlOptions): Promise<void>;

package/dist/core/server-manager.js

@@ -0,0 +1,64 @@
+import { spawnManagedProcess } from '../utils/process.js';
+export async function startManagedServer(config, options = {}) {
+    const timeoutMs = config.timeoutMs ?? 60_000;
+    if (config.reuseExisting ?? true) {
+        const existingReachable = await isUrlReachable(config.readyUrl);
+        if (existingReachable) {
+            return {
+                readyUrl: config.readyUrl,
+                reused: true,
+                started: false,
+                pid: undefined,
+                stop: async () => undefined
+            };
+        }
+    }
+    const process = await spawnManagedProcess(config.command, options);
+    try {
+        await waitForUrl(config.readyUrl, { timeoutMs });
+    }
+    catch (error) {
+        await process.stop();
+        const logHint = options.logPath ? ` Logs: ${options.logPath}` : '';
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Reflection server did not become ready at ${config.readyUrl}: ${message}.${logHint}`);
+    }
+    return {
+        readyUrl: config.readyUrl,
+        reused: false,
+        started: true,
+        pid: process.pid,
+        stop: process.stop
+    };
+}
+export async function waitForUrl(url, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 60_000;
+    const intervalMs = options.intervalMs ?? 250;
+    const deadline = Date.now() + timeoutMs;
+    let lastError;
+    while (Date.now() <= deadline) {
+        if (await isUrlReachable(url).catch((error) => {
+            lastError = error;
+            return false;
+        })) {
+            return;
+        }
+        await sleep(intervalMs);
+    }
+    const reason = lastError instanceof Error ? ` Last error: ${lastError.message}` : '';
+    throw new Error(`URL not reachable before timeout: ${url}.${reason}`);
+}
+async function isUrlReachable(url) {
+    try {
+        const response = await fetch(url, { cache: 'no-store' });
+        await response.body?.cancel();
+        return response.status >= 200 && response.status < 500;
+    }
+    catch {
+        return false;
+    }
+}
+async function sleep(ms) {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=server-manager.js.map

package/dist/core/server-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-manager.js","sourceRoot":"","sources":["../../src/core/server-manager.ts"],"names":[],"mappings":"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"}

package/dist/core/target-ir.d.ts

@@ -0,0 +1,64 @@
+import type { ReflectionConfig, RunMode } from './config.js';
+export type TargetSource = 'reflection-config' | 'adapter';
+export type TargetFamily = 'browser-route' | 'route-visual' | 'component-visual' | 'design-command';
+export type TargetIR = {
+    project: string;
+    targets: ReflectionTarget[];
+};
+export type ReflectionTarget = BrowserRouteTarget | RouteVisualTarget | ComponentVisualTarget | DesignCommandTarget;
+type TargetBase = {
+    id: string;
+    family: TargetFamily;
+    source: TargetSource;
+    runModes: RunMode[];
+    blocking: boolean;
+};
+export type BrowserRouteTarget = TargetBase & {
+    family: 'browser-route';
+    route: {
+        path: string;
+        name?: string | undefined;
+        viewports: string[];
+        expects: unknown[];
+    };
+    browser: {
+        baseUrl: string;
+        maskSelectors: string[];
+    };
+};
+export type RouteVisualTarget = TargetBase & {
+    family: 'route-visual';
+    route: {
+        path: string;
+    };
+    visual: {
+        viewport: string;
+        baseline: string;
+        baselineRoot?: string | undefined;
+        threshold?: unknown;
+    };
+};
+export type ComponentVisualTarget = TargetBase & {
+    family: 'component-visual';
+    story: {
+        storyId: string;
+        statePolicy: 'story-controlled' | 'browser-forced-with-stabilization';
+        stateNote?: string | undefined;
+        browserState?: unknown;
+    };
+    visual: {
+        viewport: string;
+        baseline: string;
+        baselineRoot?: string | undefined;
+        threshold?: unknown;
+    };
+};
+export type DesignCommandTarget = TargetBase & {
+    family: 'design-command';
+    command: {
+        command: string;
+        cwd?: string | undefined;
+    };
+};
+export declare function compileReflectionTargets(config: ReflectionConfig): TargetIR;
+export {};