guardrail-ship 1.0.0

package/dist/reality-mode/explorer/types.d.ts

@@ -0,0 +1,275 @@
+/**
+ * Reality Explorer Types
+ *
+ * Types for the comprehensive app exploration system that actually
+ * tests everything - buttons, forms, modals, auth flows, etc.
+ */
+export interface DiscoveredRoute {
+    path: string;
+    method: "GET" | "POST" | "PUT" | "DELETE";
+    source: "link" | "router" | "api-call" | "redirect";
+    requiresAuth: boolean;
+    visited: boolean;
+    status?: number;
+    error?: string;
+}
+export interface DiscoveredElement {
+    id: string;
+    selector: string;
+    type: "button" | "link" | "input" | "form" | "modal-trigger" | "dropdown" | "tab" | "accordion";
+    text: string;
+    page: string;
+    isDestructive: boolean;
+    tested: boolean;
+    result?: ElementTestResult;
+}
+export interface DiscoveredForm {
+    id: string;
+    selector: string;
+    page: string;
+    action?: string;
+    method: string;
+    fields: FormField[];
+    submitButton?: string;
+    tested: boolean;
+    result?: FormTestResult;
+}
+export interface FormField {
+    name: string;
+    type: string;
+    required: boolean;
+    selector: string;
+    placeholder?: string;
+    pattern?: string;
+}
+export interface DiscoveredAPI {
+    url: string;
+    method: string;
+    calledFrom: string;
+    status?: number;
+    responseTime?: number;
+    error?: string;
+}
+export interface AppSurface {
+    routes: DiscoveredRoute[];
+    elements: DiscoveredElement[];
+    forms: DiscoveredForm[];
+    apis: DiscoveredAPI[];
+    timestamp: string;
+}
+export interface ElementTestResult {
+    success: boolean;
+    action: "click" | "hover" | "focus";
+    beforeState: PageState;
+    afterState: PageState;
+    changes: StateChange[];
+    errors: CapturedError[];
+    networkCalls: NetworkCall[];
+    duration: number;
+    screenshot?: string;
+}
+export interface FormTestResult {
+    success: boolean;
+    fieldsFilledCount: number;
+    submitAttempted: boolean;
+    submitSucceeded: boolean;
+    validationErrors: string[];
+    networkCalls: NetworkCall[];
+    errors: CapturedError[];
+    duration: number;
+    screenshot?: string;
+}
+export interface PageState {
+    url: string;
+    title: string;
+    modalsOpen: number;
+    loadingIndicators: number;
+    errorMessages: string[];
+    domHash: string;
+}
+export interface StateChange {
+    type: "url" | "modal" | "dom" | "console" | "network";
+    description: string;
+    significance: "major" | "minor" | "none";
+}
+export interface CapturedError {
+    type: "console" | "network" | "uncaught" | "react-boundary";
+    message: string;
+    stack?: string;
+    url?: string;
+    timestamp: number;
+}
+export interface NetworkCall {
+    url: string;
+    method: string;
+    status: number;
+    duration: number;
+    requestBody?: string;
+    responsePreview?: string;
+    error?: string;
+}
+export interface CriticalFlow {
+    id: string;
+    name: string;
+    description: string;
+    steps: FlowStep[];
+    assertions: FlowAssertion[];
+    required: boolean;
+}
+export interface FlowStep {
+    action: "navigate" | "click" | "fill" | "wait" | "assert";
+    target?: string;
+    value?: string;
+    timeout?: number;
+}
+export interface FlowAssertion {
+    type: "url-contains" | "element-visible" | "element-hidden" | "cookie-exists" | "localstorage-has" | "network-success" | "no-errors";
+    value: string;
+    critical: boolean;
+}
+export interface FlowResult {
+    flow: CriticalFlow;
+    success: boolean;
+    stepsCompleted: number;
+    stepsTotal: number;
+    assertionsPassed: number;
+    assertionsTotal: number;
+    failedAt?: string;
+    errors: CapturedError[];
+    duration: number;
+    trace?: string;
+    video?: string;
+}
+export interface CoverageMetrics {
+    routes: {
+        discovered: number;
+        visited: number;
+        successful: number;
+        blocked: number;
+        percentage: number;
+    };
+    elements: {
+        discovered: number;
+        tested: number;
+        successful: number;
+        skippedDestructive: number;
+        percentage: number;
+    };
+    forms: {
+        discovered: number;
+        tested: number;
+        successful: number;
+        blockedByAuth: number;
+        percentage: number;
+    };
+    apis: {
+        discovered: number;
+        called: number;
+        successful: number;
+        failed: number;
+        percentage: number;
+    };
+    flows: {
+        total: number;
+        passed: number;
+        failed: number;
+        skipped: number;
+        percentage: number;
+    };
+}
+export interface RealityScore {
+    overall: number;
+    breakdown: {
+        coverage: number;
+        functionality: number;
+        stability: number;
+        ux: number;
+    };
+    grade: "A" | "B" | "C" | "D" | "F";
+    verdict: "ship-it" | "needs-work" | "broken";
+}
+export interface ExplorerConfig {
+    baseUrl: string;
+    maxPages: number;
+    maxActionsPerPage: number;
+    timeout: number;
+    headless: boolean;
+    auth?: {
+        loginUrl: string;
+        credentials: {
+            emailField: string;
+            passwordField: string;
+            email: string;
+            password: string;
+        };
+        successIndicator: string;
+    };
+    allowDestructive: boolean;
+    destructivePatterns: string[];
+    outputDir: string;
+    captureVideo: boolean;
+    captureTrace: boolean;
+    captureScreenshots: boolean;
+    flows?: CriticalFlow[];
+}
+export interface ExplorerReport {
+    summary: {
+        score: RealityScore;
+        coverage: CoverageMetrics;
+        duration: number;
+        timestamp: string;
+    };
+    surface: AppSurface;
+    results: {
+        routes: RouteResult[];
+        elements: ElementResult[];
+        forms: FormResult[];
+        flows: FlowResult[];
+    };
+    failures: {
+        critical: FailureReport[];
+        warnings: FailureReport[];
+    };
+    recommendations: Recommendation[];
+    artifacts: {
+        traces: string[];
+        videos: string[];
+        screenshots: string[];
+    };
+}
+export interface RouteResult {
+    route: DiscoveredRoute;
+    status: "success" | "error" | "blocked" | "skipped";
+    responseTime?: number;
+    errors: CapturedError[];
+}
+export interface ElementResult {
+    element: DiscoveredElement;
+    status: "success" | "error" | "no-change" | "skipped";
+    result?: ElementTestResult;
+}
+export interface FormResult {
+    form: DiscoveredForm;
+    status: "success" | "validation-error" | "submit-error" | "blocked" | "skipped";
+    result?: FormTestResult;
+}
+export interface FailureReport {
+    id: string;
+    type: "route" | "element" | "form" | "flow" | "api";
+    severity: "critical" | "warning";
+    title: string;
+    description: string;
+    location: string;
+    rootCause?: string;
+    reproduction: string[];
+    screenshot?: string;
+    trace?: string;
+}
+export interface Recommendation {
+    priority: "high" | "medium" | "low";
+    category: "functionality" | "auth" | "ux" | "performance" | "stability";
+    title: string;
+    description: string;
+    fix?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/reality-mode/explorer/types.d.ts.map

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

package/dist/reality-mode/explorer/types.js

@@ -0,0 +1,8 @@
+/**
+ * Reality Explorer Types
+ *
+ * Types for the comprehensive app exploration system that actually
+ * tests everything - buttons, forms, modals, auth flows, etc.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/reality-mode/explorer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/reality-mode/explorer/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/reality-mode/fake-success-detector.d.ts

@@ -0,0 +1,10 @@
+import { ReplayStep, FakeSuccessResult } from "./types";
+export declare class FakeSuccessDetector {
+    /**
+     * Analyze a replay to find "Fake Success" patterns
+     * i.e., User clicked "Save" -> UI showed success -> No backend write happened
+     */
+    detect(replay: ReplayStep[]): FakeSuccessResult[];
+    private getSubsequentSteps;
+}
+//# sourceMappingURL=fake-success-detector.d.ts.map

package/dist/reality-mode/fake-success-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-success-detector.d.ts","sourceRoot":"","sources":["../../src/reality-mode/fake-success-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAExD,qBAAa,mBAAmB;IAC9B;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,iBAAiB,EAAE;IA6DjD,OAAO,CAAC,kBAAkB;CAoB3B"}

package/dist/reality-mode/fake-success-detector.js

@@ -0,0 +1,76 @@
+export class FakeSuccessDetector {
+    /**
+     * Analyze a replay to find "Fake Success" patterns
+     * i.e., User clicked "Save" -> UI showed success -> No backend write happened
+     */
+    detect(replay) {
+        const results = [];
+        const saveActionPatterns = [
+            /save/i,
+            /update/i,
+            /create/i,
+            /submit/i,
+            /confirm/i,
+            /send/i,
+            /pay/i,
+        ];
+        // Iterate through replay to find "Write" actions
+        for (let i = 0; i < replay.length; i++) {
+            const step = replay[i];
+            if (!step || step.type !== "action" || !step.data?.selector)
+                continue;
+            const selector = step.data.selector;
+            const isWriteAction = saveActionPatterns.some((p) => p.test(selector));
+            if (isWriteAction) {
+                // Look ahead for network activity (next 5 seconds or until next action)
+                const subsequentSteps = this.getSubsequentSteps(replay, i, 5000);
+                const writeRequests = subsequentSteps.filter((s) => s.type === "request" &&
+                    ["POST", "PUT", "PATCH", "DELETE"].includes(s.data.method));
+                if (writeRequests.length === 0) {
+                    // No write request found!
+                    // But maybe it's a client-side only app?
+                    // Or maybe the request happened but we missed it?
+                    // Or maybe it's "Fake Success".
+                    results.push({
+                        isFake: true,
+                        score: 0,
+                        evidence: [
+                            `Clicked "${selector}" but no POST/PUT/PATCH/DELETE request followed.`,
+                        ],
+                        actionStep: step,
+                    });
+                }
+                else {
+                    // Write request found. Check if it looked real.
+                    // (TrafficClassifier handles the quality of the request/response)
+                    results.push({
+                        isFake: false,
+                        score: 100,
+                        evidence: [
+                            `Clicked "${selector}" triggered ${writeRequests.length} write request(s).`,
+                        ],
+                        actionStep: step,
+                    });
+                }
+            }
+        }
+        return results;
+    }
+    getSubsequentSteps(replay, startIndex, timeWindow) {
+        const steps = [];
+        const startStep = replay[startIndex];
+        if (!startStep)
+            return steps;
+        const startTime = startStep.timestamp;
+        for (let i = startIndex + 1; i < replay.length; i++) {
+            const step = replay[i];
+            if (!step)
+                break;
+            if (step.timestamp - startStep.timestamp > timeWindow)
+                break;
+            steps.push(step);
+        }
+        return steps;
+    }
+}
+//# sourceMappingURL=fake-success-detector.js.map

package/dist/reality-mode/fake-success-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-success-detector.js","sourceRoot":"","sources":["../../src/reality-mode/fake-success-detector.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,mBAAmB;IAC9B;;;OAGG;IACH,MAAM,CAAC,MAAoB;QACzB,MAAM,OAAO,GAAwB,EAAE,CAAC;QACxC,MAAM,kBAAkB,GAAG;YACzB,OAAO;YACP,SAAS;YACT,SAAS;YACT,SAAS;YACT,UAAU;YACV,OAAO;YACP,MAAM;SACP,CAAC;QAEF,iDAAiD;QACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACvB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ;gBAAE,SAAS;YAEtE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YACpC,MAAM,aAAa,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAEvE,IAAI,aAAa,EAAE,CAAC;gBAClB,wEAAwE;gBACxE,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;gBACjE,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,SAAS;oBACpB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAC7D,CAAC;gBAEF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC/B,0BAA0B;oBAC1B,yCAAyC;oBACzC,kDAAkD;oBAClD,gCAAgC;oBAEhC,OAAO,CAAC,IAAI,CAAC;wBACX,MAAM,EAAE,IAAI;wBACZ,KAAK,EAAE,CAAC;wBACR,QAAQ,EAAE;4BACR,YAAY,QAAQ,kDAAkD;yBACvE;wBACD,UAAU,EAAE,IAAI;qBACjB,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,gDAAgD;oBAChD,kEAAkE;oBAClE,OAAO,CAAC,IAAI,CAAC;wBACX,MAAM,EAAE,KAAK;wBACb,KAAK,EAAE,GAAG;wBACV,QAAQ,EAAE;4BACR,YAAY,QAAQ,eAAe,aAAa,CAAC,MAAM,oBAAoB;yBAC5E;wBACD,UAAU,EAAE,IAAI;qBACjB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,kBAAkB,CACxB,MAAoB,EACpB,UAAkB,EAClB,UAAkB;QAElB,MAAM,KAAK,GAAiB,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QAE7B,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;QAEtC,KAAK,IAAI,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACvB,IAAI,CAAC,IAAI;gBAAE,MAAM;YACjB,IAAI,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,GAAG,UAAU;gBAAE,MAAM;YAC7D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/reality-mode/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Reality Mode - Runtime Fake Detection
+ *
+ * "Stop shipping pretend features. Guardrail runs your app and catches the lies."
+ *
+ * A literal "flight recorder" for fake apps.
+ */
+export { RealityScanner, realityScanner, DEFAULT_FAKE_PATTERNS, } from "./reality-scanner";
+export * from "./types";
+export { ReportGenerator } from "./report-generator";
+export { TrafficClassifier } from "./traffic-classifier";
+export { FakeSuccessDetector } from "./fake-success-detector";
+export { AuthEnforcer } from "./auth-enforcer";
+//# sourceMappingURL=index.d.ts.map

package/dist/reality-mode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reality-mode/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EACd,cAAc,EACd,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/reality-mode/index.js

@@ -0,0 +1,14 @@
+/**
+ * Reality Mode - Runtime Fake Detection
+ *
+ * "Stop shipping pretend features. Guardrail runs your app and catches the lies."
+ *
+ * A literal "flight recorder" for fake apps.
+ */
+export { RealityScanner, realityScanner, DEFAULT_FAKE_PATTERNS, } from "./reality-scanner";
+export * from "./types";
+export { ReportGenerator } from "./report-generator";
+export { TrafficClassifier } from "./traffic-classifier";
+export { FakeSuccessDetector } from "./fake-success-detector";
+export { AuthEnforcer } from "./auth-enforcer";
+//# sourceMappingURL=index.js.map

package/dist/reality-mode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reality-mode/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EACd,cAAc,EACd,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/reality-mode/reality-scanner.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Reality Mode - Runtime Fake Detection
+ *
+ * "Stop shipping pretend features. Guardrail runs your app and catches the lies."
+ *
+ * This module spins up the app, intercepts network calls, clicks through the UI,
+ * and detects:
+ * - Calls to localhost, jsonplaceholder, staging domains, ngrok
+ * - Routes returning demo/placeholder responses
+ * - Silent fallback success patterns
+ * - Mock billing and fake invoice IDs
+ *
+ * The killer feature: a "flight recorder" replay showing exactly what happened.
+ */
+import { FakePattern, ReplayStep, RealityModeResult, RealityModeConfig } from "./types";
+export declare const FAKE_DOMAIN_PATTERNS: RegExp[];
+export declare const FAKE_RESPONSE_PATTERNS: {
+    pattern: RegExp;
+    name: string;
+}[];
+export declare const SILENT_FALLBACK_PATTERNS: {
+    pattern: RegExp;
+    name: string;
+}[];
+export declare const DEFAULT_FAKE_PATTERNS: FakePattern[];
+export declare class RealityScanner {
+    private config;
+    private trafficClassifier;
+    private fakeSuccessDetector;
+    private authEnforcer;
+    constructor(config?: Partial<RealityModeConfig>);
+    /**
+     * Generate Playwright test code for Reality Mode scanning
+     */
+    generatePlaywrightTest(config: {
+        baseUrl: string;
+        clickPaths: string[][];
+        outputDir: string;
+    }): string;
+    /**
+     * Post-process the replay to apply advanced detection logic
+     */
+    processReplay(replay: ReplayStep[], authViolations?: any[]): RealityModeResult;
+    generateReport(result: RealityModeResult): string;
+    generateDefaultClickPaths(): string[][];
+}
+export declare const realityScanner: RealityScanner;
+//# sourceMappingURL=reality-scanner.d.ts.map

package/dist/reality-mode/reality-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reality-scanner.d.ts","sourceRoot":"","sources":["../../src/reality-mode/reality-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,EACL,WAAW,EAKX,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EAGlB,MAAM,SAAS,CAAC;AAGjB,eAAO,MAAM,oBAAoB,UAgBhC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;GAmBlC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;GAUpC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,WAAW,EA8E9C,CAAC;AAEF,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,YAAY,CAAe;gBAEvB,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAgBnD;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE;QAC7B,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,MAAM;IAwMV;;OAEG;IACH,aAAa,CACX,MAAM,EAAE,UAAU,EAAE,EACpB,cAAc,GAAE,GAAG,EAAO,GACzB,iBAAiB;IAgJpB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;IAKjD,yBAAyB,IAAI,MAAM,EAAE,EAAE;CAwBxC;AAED,eAAO,MAAM,cAAc,gBAAuB,CAAC"}