reflection-check 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Niklas Westman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# Reflection
+
+Reflection is a CLI for evidence-backed rendered UI validation.
+
+It answers three practical questions for frontend changes:
+
+```text
+Does the UI still work?
+Does it still match the design system contract?
+Did anything visible change unexpectedly?
+```
+
+Current status: Reflection now has the core local validation loop: config → browser route check → screenshot/visual evidence → report → review → explicit baseline update.
+
+## Documentation
+
+- [`docs/getting-started.md`](docs/getting-started.md) — add Reflection to a new repo and run the local loop.
+- [`docs/configuration.md`](docs/configuration.md) — supported config shape, run modes, browser/design/component contracts.
+- [`docs/browser-contract.md`](docs/browser-contract.md) — rendered route expectations and screenshot evidence.
+- [`docs/visual-contract.md`](docs/visual-contract.md) — route/component baselines, review-only diffs, and baseline update policy.
+- [`docs/artifacts-and-gc.md`](docs/artifacts-and-gc.md) — report bundle layout, artifact roots, and safe garbage collection.
+- [`docs/agent-workflows.md`](docs/agent-workflows.md) — agent completion loop and baseline-update rules.
+- [`docs/validation-process.md`](docs/validation-process.md) — canonical operating guide for agents and CI.
+- [`docs/ci.md`](docs/ci.md) — CI defaults and exit codes.
+- [`docs/target-ir-and-adapters.md`](docs/target-ir-and-adapters.md) — internal target inventory and adapter seam.
+
+## Command surface
+
+```bash
+reflection run
+reflection review
+reflection update
+reflection doctor
+```
+
+## Install
+
+```bash
+pnpm add -D reflection-check
+```
+
+Use the package root helper in `reflection.config.ts`:
+
+```ts
+import { defineReflection } from 'reflection-check';
+```
+
+## Local development
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm test
+pnpm build
+```

package/dist/adapters/route-manifest.d.ts

@@ -0,0 +1,3 @@
+import type { TargetIR } from '../core/target-ir.js';
+export declare function loadRouteManifestTargets(manifestPath: string): Promise<TargetIR>;
+export declare function parseRouteManifestTargets(input: unknown): TargetIR;

package/dist/adapters/route-manifest.js

@@ -0,0 +1,98 @@
+import { readFile } from 'node:fs/promises';
+import { z } from 'zod';
+const RouteManifestExpectationSchema = z.union([
+    z.object({ urlIncludes: z.string() }).strict(),
+    z.object({ urlEquals: z.string() }).strict(),
+    z.object({ role: z.string(), name: z.string().optional() }).strict(),
+    z.object({ label: z.string() }).strict(),
+    z.object({ text: z.string() }).strict(),
+    z.object({ noText: z.string() }).strict(),
+    z.object({ selector: z.string() }).strict(),
+    z.object({ elementVisible: z.string() }).strict(),
+    z.object({ elementNotVisible: z.string() }).strict(),
+    z.object({ noHorizontalOverflow: z.literal(true) }).strict(),
+    z.object({ noConsoleErrors: z.literal(true) }).strict(),
+    z.object({ screenshot: z.string() }).strict()
+]);
+const RouteManifestRouteSchema = z
+    .object({
+    id: z.string().min(1),
+    name: z.string().min(1).optional(),
+    path: z.string().min(1),
+    viewports: z.array(z.string().min(1)).default(['desktop']),
+    expects: z.array(RouteManifestExpectationSchema).default([]),
+    blocking: z.boolean().optional()
+})
+    .strict();
+const RouteManifestSchema = z
+    .object({
+    project: z.string().min(1),
+    baseUrl: z.string().url(),
+    maskSelectors: z.array(z.string().min(1)).default([]),
+    routes: z.array(RouteManifestRouteSchema).default([])
+})
+    .strict()
+    .superRefine((manifest, context) => {
+    const seen = new Set();
+    for (const [index, route] of manifest.routes.entries()) {
+        if (seen.has(route.id)) {
+            context.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['routes', index, 'id'],
+                message: `duplicate route id "${route.id}"`
+            });
+        }
+        seen.add(route.id);
+    }
+});
+export async function loadRouteManifestTargets(manifestPath) {
+    let raw;
+    try {
+        raw = await readFile(manifestPath, 'utf8');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Route manifest not found: ${manifestPath}: ${message}`);
+    }
+    try {
+        return parseRouteManifestTargets(JSON.parse(raw));
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new Error(`Invalid route manifest JSON: ${manifestPath}: ${error.message}`);
+        }
+        throw error;
+    }
+}
+export function parseRouteManifestTargets(input) {
+    const manifest = parseRouteManifest(input);
+    return {
+        project: manifest.project,
+        targets: manifest.routes.map((route) => ({
+            id: route.id,
+            family: 'browser-route',
+            source: 'adapter',
+            runModes: ['smoke', 'full'],
+            blocking: route.blocking ?? true,
+            route: {
+                path: route.path,
+                ...(route.name !== undefined ? { name: route.name } : {}),
+                viewports: route.viewports,
+                expects: route.expects
+            },
+            browser: {
+                baseUrl: manifest.baseUrl,
+                maskSelectors: manifest.maskSelectors
+            }
+        }))
+    };
+}
+function parseRouteManifest(input) {
+    const parsed = RouteManifestSchema.safeParse(input);
+    if (!parsed.success) {
+        const details = parsed.error.issues.map((issue) => `${issue.path.join('.') || 'manifest'}: ${issue.message}`).join('; ');
+        throw new Error(`Invalid route manifest: ${details}`);
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=route-manifest.js.map

package/dist/adapters/route-manifest.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+export declare function createCli(): Command;

package/dist/cli.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import { realpathSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { Command, CommanderError } from 'commander';
+import { doctorCommand } from './commands/doctor.js';
+import { gcCommand } from './commands/gc.js';
+import { reviewCommand } from './commands/review.js';
+import { runCommand } from './commands/run.js';
+import { updateCommand } from './commands/update.js';
+import { ExitCode } from './core/exit-codes.js';
+export function createCli() {
+    const program = new Command();
+    program
+        .name('reflection')
+        .description('Evidence-backed rendered UI validation.')
+        .version('0.0.1')
+        .configureOutput({
+        outputError: (message, write) => write(message)
+    });
+    program
+        .command('run')
+        .description('Check the UI contract for this project.')
+        .option('--config <path>', 'Path to reflection.config.ts')
+        .option('--mode <mode>', 'Run mode: smoke, design, visual, full', 'smoke')
+        .option('--ci', 'Run with CI defaults')
+        .option('--report-dir <path>', 'Artifact/report root directory')
+        .option('--workers [count]', 'Worker count for browser/visual checks')
+        .action(async (options) => {
+        await runCommand(options);
+    });
+    program
+        .command('review')
+        .description('Show what passed, failed, changed visually, and where the evidence is.')
+        .option('--latest', 'Review the latest run')
+        .option('--run <runId>', 'Review a specific run id')
+        .option('--json', 'Emit a stable JSON summary')
+        .option('--report-dir <path>', 'Artifact/report root directory')
+        .action(async (options) => {
+        await reviewCommand(options);
+    });
+    program
+        .command('update')
+        .description('Accept intentional visual changes by updating targeted baselines.')
+        .option('--config <path>', 'Path to reflection.config.ts')
+        .option('--report-dir <path>', 'Artifact/report root directory')
+        .option('--from-run <runId>', 'Run id to promote from, or latest', 'latest')
+        .option('--route <routeId>', 'Update visual baselines for a specific route id')
+        .option('--case <caseId>', 'Update a specific visual baseline case id')
+        .option('--all', 'Update all visual baselines from the selected run')
+        .option('--dry-run', 'Show planned baseline updates without writing')
+        .option('--ci', 'Refuse updates under CI mode')
+        .action(async (options) => {
+        await updateCommand(options);
+    });
+    program
+        .command('gc')
+        .description('Clean up old Reflection run artifacts without touching baselines.')
+        .option('--report-dir <path>', 'Artifact/report root directory')
+        .option('--dry-run', 'List eligible run directories without deleting them')
+        .option('--delete', 'Delete eligible run directories')
+        .action(async (options) => {
+        await gcCommand(options);
+    });
+    program
+        .command('doctor')
+        .description('Check whether Reflection can run correctly in this project.')
+        .option('--config <path>', 'Path to reflection.config.ts')
+        .action(async (options) => {
+        await doctorCommand(options);
+    });
+    return program;
+}
+async function main() {
+    const program = createCli();
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (error) {
+        if (error instanceof CommanderError) {
+            if (error.message) {
+                console.error(error.message);
+            }
+            process.exit(error.exitCode);
+        }
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(ExitCode.ToolOrConfigError);
+    }
+}
+const executedPath = process.argv[1] ? realpathSync(fileURLToPath(import.meta.url)) === realpathSync(process.argv[1]) : false;
+if (executedPath) {
+    void main();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,4 @@
+export type DoctorCommandOptions = {
+    config?: string;
+};
+export declare function doctorCommand(_options?: DoctorCommandOptions): Promise<void>;

package/dist/commands/doctor.js

@@ -0,0 +1,5 @@
+export async function doctorCommand(_options = {}) {
+    console.log('Reflection doctor');
+    console.log('Phase 1.1 setup check placeholder: config/schema validation is available; runtime checks come next.');
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAiC,EAAE;IACrE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,qGAAqG,CAAC,CAAC;AACrH,CAAC"}

package/dist/commands/gc.d.ts

@@ -0,0 +1,8 @@
+import { type GcPlan } from '../core/gc.js';
+export type GcCommandOptions = {
+    reportDir?: string;
+    dryRun?: boolean;
+    delete?: boolean;
+};
+export declare function gcCommand(options?: GcCommandOptions): Promise<void>;
+export declare function renderGcSummary(plan: GcPlan): string;

package/dist/commands/gc.js

@@ -0,0 +1,45 @@
+import { CommanderError } from 'commander';
+import { collectGarbage } from '../core/gc.js';
+import { ExitCode } from '../core/exit-codes.js';
+export async function gcCommand(options = {}) {
+    try {
+        if (options.dryRun === true && options.delete === true) {
+            throw new CommanderError(ExitCode.InvalidUsage, 'reflection.gc', 'Use either --dry-run or --delete, not both.');
+        }
+        const plan = await collectGarbage({ ...(options.reportDir !== undefined ? { reportDir: options.reportDir } : {}), dryRun: options.delete !== true });
+        console.log(renderGcSummary(plan));
+    }
+    catch (error) {
+        if (error instanceof CommanderError) {
+            throw error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new CommanderError(ExitCode.ToolOrConfigError, 'reflection.gc', message);
+    }
+}
+export function renderGcSummary(plan) {
+    const lines = ['Reflection GC', '', `Dry run: ${plan.dryRun ? 'yes' : 'no'}`, `Runs directory: ${plan.runsDir}`, ''];
+    if (plan.eligible.length === 0) {
+        lines.push(plan.dryRun ? 'No eligible run directories would be deleted.' : 'No eligible run directories were deleted.');
+    }
+    else {
+        lines.push(plan.dryRun ? 'Would delete:' : 'Eligible:');
+        for (const run of plan.eligible) {
+            lines.push(`- ${run.runId}: ${run.path}`);
+        }
+    }
+    if (plan.deleted.length > 0) {
+        lines.push('', 'Deleted:');
+        for (const run of plan.deleted) {
+            lines.push(`- ${run.runId}: ${run.path}`);
+        }
+    }
+    if (plan.skipped.length > 0) {
+        lines.push('', 'Skipped:');
+        for (const run of plan.skipped) {
+            lines.push(`- ${run.runId}: ${run.reason}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=gc.js.map

package/dist/commands/gc.js.map

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

package/dist/commands/review.d.ts

@@ -0,0 +1,7 @@
+export type ReviewCommandOptions = {
+    reportDir?: string;
+    latest?: boolean;
+    run?: string;
+    json?: boolean;
+};
+export declare function reviewCommand(options?: ReviewCommandOptions): Promise<void>;

package/dist/commands/review.js

@@ -0,0 +1,149 @@
+import { readFile, realpath } from 'node:fs/promises';
+import { dirname, isAbsolute, relative, resolve } from 'node:path';
+import { CommanderError } from 'commander';
+import { ExitCode } from '../core/exit-codes.js';
+import { validateReport } from '../core/report-schema.js';
+export async function reviewCommand(options = {}) {
+    try {
+        if (options.latest === true && options.run !== undefined) {
+            throw new Error('Use either --latest or --run, not both.');
+        }
+        const rootDir = resolve(options.reportDir ?? '.reflection');
+        const runsDir = resolve(rootDir, 'runs');
+        const runId = options.run ?? (await readLatestRunId(rootDir));
+        assertSafeRunId(runId);
+        const runDir = resolve(runsDir, runId);
+        ensureInside(runsDir, runDir);
+        await ensureRealPathInside(runsDir, runDir);
+        const reportPath = resolve(runDir, 'report.json');
+        ensureInside(runDir, reportPath);
+        await ensureRealPathInside(runDir, reportPath);
+        const report = validateReport(JSON.parse(await readFile(reportPath, 'utf8')));
+        if (report.runId !== runId) {
+            throw new Error(`Report run id mismatch: expected ${runId}, found ${report.runId}`);
+        }
+        const summary = createReviewSummary(report, reportPath, dirname(reportPath));
+        if (options.json === true) {
+            console.log(JSON.stringify(summary, null, 2));
+            return;
+        }
+        console.log(renderReview(summary));
+    }
+    catch (error) {
+        if (error instanceof CommanderError) {
+            throw error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new CommanderError(ExitCode.ToolOrConfigError, 'reflection.review', message);
+    }
+}
+async function readLatestRunId(rootDir) {
+    const runsDir = resolve(rootDir, 'runs');
+    const latestPath = resolve(runsDir, 'latest');
+    ensureInside(runsDir, latestPath);
+    await ensureRealPathInside(runsDir, latestPath);
+    const value = (await readFile(latestPath, 'utf8')).trim();
+    if (value.length === 0) {
+        throw new Error(`Latest Reflection run pointer is empty: ${latestPath}`);
+    }
+    return value;
+}
+function createReviewSummary(report, reportPath, runDir) {
+    const blockingFailures = report.checks.filter(isBlockingFailure).map(toReviewCheck);
+    const reviewItems = report.checks.filter(isReviewItem).map(toReviewCheck);
+    return {
+        runId: report.runId,
+        project: report.project,
+        status: report.status,
+        reportPath,
+        blockingFailures,
+        reviewItems,
+        artifactPaths: collectArtifactPaths(report, runDir),
+        suggestedNextSteps: report.suggestedNextSteps.map((step) => step.summary)
+    };
+}
+function renderReview(summary) {
+    const lines = [];
+    lines.push('Reflection review');
+    lines.push('');
+    lines.push(`Project: ${summary.project}`);
+    lines.push(`Run: ${summary.runId}`);
+    lines.push(`Status: ${summary.status}`);
+    lines.push(`Report: ${summary.reportPath}`);
+    if (summary.blockingFailures.length > 0) {
+        lines.push('');
+        lines.push('Blocking:');
+        for (const item of summary.blockingFailures) {
+            lines.push(`- ${item.id} — ${item.summary}`);
+        }
+    }
+    if (summary.reviewItems.length > 0) {
+        lines.push('');
+        lines.push('Review:');
+        for (const item of summary.reviewItems) {
+            lines.push(`- ${item.id} — ${item.summary}`);
+        }
+    }
+    if (summary.artifactPaths.length > 0) {
+        lines.push('');
+        lines.push('Artifacts:');
+        for (const artifactPath of summary.artifactPaths) {
+            lines.push(`- ${artifactPath}`);
+        }
+    }
+    if (summary.suggestedNextSteps.length > 0) {
+        lines.push('');
+        lines.push('Next:');
+        for (const step of summary.suggestedNextSteps) {
+            lines.push(`- ${step}`);
+        }
+    }
+    return lines.join('\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 toReviewCheck(check) {
+    return {
+        id: check.id,
+        summary: check.summary,
+        target: check.target,
+        status: check.status
+    };
+}
+function collectArtifactPaths(report, runDir) {
+    const paths = new Set();
+    const addArtifact = (artifact) => {
+        assertSafeArtifactPath(artifact.path, runDir);
+        paths.add(artifact.path);
+    };
+    report.artifacts.forEach(addArtifact);
+    report.checks.flatMap((check) => check.artifacts).forEach(addArtifact);
+    return [...paths];
+}
+function assertSafeArtifactPath(artifactPath, runDir) {
+    if (isAbsolute(artifactPath)) {
+        throw new Error(`Invalid absolute artifact path in report: ${artifactPath}`);
+    }
+    const resolvedArtifactPath = resolve(runDir, artifactPath);
+    ensureInside(runDir, resolvedArtifactPath, `Refusing to emit artifact path outside Reflection run directory: ${artifactPath}`);
+}
+function assertSafeRunId(runId) {
+    if (!/^[A-Za-z0-9._:-]+$/.test(runId) || isAbsolute(runId) || runId.split(/[\\/]/).includes('..')) {
+        throw new Error(`Invalid Reflection run id: ${runId}`);
+    }
+}
+async function ensureRealPathInside(parent, child) {
+    const [realParent, realChild] = await Promise.all([realpath(parent), realpath(child)]);
+    ensureInside(realParent, realChild, `Refusing to read report outside Reflection runs directory: ${child}`);
+}
+function ensureInside(parent, child, message) {
+    const relation = relative(parent, child);
+    if (relation.startsWith('..') || isAbsolute(relation)) {
+        throw new Error(message ?? `Refusing to read report outside Reflection runs directory: ${child}`);
+    }
+}
+//# sourceMappingURL=review.js.map

package/dist/commands/review.js.map

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

package/dist/commands/run.d.ts

@@ -0,0 +1,10 @@
+import { type RunMode } from '../core/config.js';
+export type RunCommandOptions = {
+    config?: string;
+    mode: string;
+    ci?: boolean;
+    reportDir?: string;
+    workers?: string | number | boolean;
+};
+export declare function parseRunMode(value: string): RunMode;
+export declare function runCommand(options: RunCommandOptions): Promise<void>;