looply-cli 0.5.12 → 0.5.13

package/dist/visual-proof-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-proof-cmd.d.ts","sourceRoot":"","sources":["../src/visual-proof-cmd.ts"],"names":[],"mappings":"AAMA,OAAO,EAAsC,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKvF;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAqBjG;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,EAAE,CAazD;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAa7C;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CA0D3H"}

package/dist/visual-proof-cmd.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseVisualProofArgs = parseVisualProofArgs;
+exports.describeOutcome = describeOutcome;
+exports.carryOf = carryOf;
+exports.visualProofCommand = visualProofCommand;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const config_1 = require("./config");
+const git_driver_1 = require("./git-driver");
+const run_base_1 = require("./run-base");
+const untrusted_gate_1 = require("./untrusted-gate");
+const visual_proof_1 = require("./visual-proof");
+const visual_proof_config_1 = require("./visual-proof-config");
+const workspace_1 = require("./workspace");
+const yaml_1 = require("yaml");
+function parseVisualProofArgs(argv) {
+    const out = { base: null, head: 'HEAD', goalId: null, text: '', json: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = () => {
+            const v = argv[i + 1];
+            if (v === undefined || v.startsWith('--'))
+                return null;
+            i++;
+            return v;
+        };
+        if (a === '--json')
+            out.json = true;
+        else if (a === '--base' || a === '--head' || a === '--goal' || a === '--text') {
+            const v = next();
+            if (v === null)
+                return { error: `${a} needs a value` };
+            if (a === '--base')
+                out.base = v;
+            else if (a === '--head')
+                out.head = v;
+            else if (a === '--goal')
+                out.goalId = v;
+            else
+                out.text = v;
+        }
+        else
+            return { error: `unknown argument ${a}` };
+    }
+    return out;
+}
+function describeOutcome(o) {
+    if (o.kind === 'not-ui')
+        return [`no screenshots: ${o.because}`];
+    if (o.kind === 'failed')
+        return [`screenshots failed: ${o.because}`];
+    const m = o.manifest;
+    const ok = m.shots.filter((s) => s.ok).length;
+    return [
+        `screenshots: ${ok} of ${m.shots.length} taken, ${m.sheets.length} before/after sheet(s)`,
+        `  before ${m.baseSha.slice(0, 12)} → after ${m.headSha.slice(0, 12)}`,
+        `  folder ${o.dir}`,
+        ...m.apps.flatMap((a) => [`  ${a.name}: ${a.routes.map((r) => r.name || r.path || 'home').join(', ')}`, ...a.why.map((w) => `    · ${w}`)]),
+        ...m.sheets.map((s) => `  sheet ${(0, node_path_1.join)(o.dir, s.file)}`),
+        ...m.notes.map((n) => `  note: ${n}`),
+    ];
+}
+/** `run.carry_into_checkouts`, or what the gates imply when the file does not say. */
+function carryOf(cwd) {
+    const file = (0, node_path_1.join)(cwd, '.looply', 'config.yaml');
+    if (!(0, node_fs_1.existsSync)(file))
+        return ['node_modules'];
+    const text = (0, node_fs_1.readFileSync)(file, 'utf8');
+    try {
+        const cfg = (0, config_1.parseConfig)(text);
+        const carry = cfg.run.carryIntoCheckouts ?? [];
+        if (carry.length > 0)
+            return [...carry];
+    }
+    catch {
+        /* fall through to what the gates imply */
+    }
+    const raw = (0, yaml_1.parse)(text);
+    return (0, config_1.defaultCarry)(raw?.gates);
+}
+async function visualProofCommand(argv, cwd, out) {
+    const args = parseVisualProofArgs(argv);
+    if ('error' in args) {
+        out(`looply visual-proof: ${args.error}`);
+        return 64;
+    }
+    let config;
+    try {
+        config = (0, visual_proof_config_1.readVisualProofConfig)(cwd);
+    }
+    catch (e) {
+        out(e instanceof visual_proof_config_1.VisualProofConfigError ? e.message : `config: ${e.message}`);
+        return 1;
+    }
+    if (!config.enabled) {
+        out('visual_proof is not configured in .looply/config.yaml (see `visual-proof-config.ts` for the section)');
+        return 1;
+    }
+    const exec = (0, git_driver_1.nodeGitExec)(cwd);
+    let base = args.base;
+    if (base === null) {
+        let configured;
+        try {
+            configured = (0, config_1.parseConfig)((0, node_fs_1.readFileSync)((0, node_path_1.join)(cwd, '.looply', 'config.yaml'), 'utf8')).run.baseBranch;
+        }
+        catch {
+            configured = undefined;
+        }
+        base = (await (0, run_base_1.resolveBaseBranch)(new git_driver_1.GitDriver(exec), configured))?.ref ?? null;
+        if (base === null) {
+            out('looply visual-proof: the base branch could not be found; pass --base');
+            return 1;
+        }
+    }
+    const deps = {
+        git: exec,
+        buildRunner: (tree) => (0, untrusted_gate_1.makeUntrustedGateRunner)(tree),
+        now: () => Date.now(),
+        log: (line) => {
+            if (!args.json)
+                out(line);
+        },
+    };
+    const outcome = await (0, visual_proof_1.captureVisualProof)({
+        checkout: cwd,
+        projectDir: cwd,
+        projectName: cwd.split(/[\\/]/).pop() ?? 'project',
+        goalId: args.goalId,
+        goalText: args.text,
+        base,
+        head: args.head,
+        config,
+        carry: carryOf(cwd),
+        storeBase: (0, workspace_1.workspacesBase)(),
+    }, deps);
+    if (args.json)
+        out(JSON.stringify(outcome.kind === 'captured' ? { kind: outcome.kind, dir: outcome.dir, manifest: outcome.manifest } : outcome, null, 2));
+    else
+        for (const line of describeOutcome(outcome))
+            out(line);
+    return outcome.kind === 'failed' ? 1 : 0;
+}
+//# sourceMappingURL=visual-proof-cmd.js.map

package/dist/visual-proof-cmd.js.map

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

package/dist/visual-proof-config.d.ts

@@ -0,0 +1,151 @@
+/**
+ * `visual_proof:` IN `.looply/config.yaml` — HOW LOOPLY SHOWS A UI CHANGE.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * A ticket that changes what a screen looks like was judged by its unit tests
+ * alone (TAB-B-61, the cramped sidebar). This section tells Looply how to build
+ * the app, serve it, sign in with the project's OWN test data and which screens
+ * to capture, so a finished UI change carries before/after screenshots.
+ *
+ *     visual_proof:
+ *       enabled: true
+ *       max_routes: 4                 # screens per goal (default 4)
+ *       max_mb: 2048                  # all screenshots kept on this machine (default 2048)
+ *       apps:
+ *         - name: admin
+ *           when: ["admin/**"]        # changed files that make this app's proof run
+ *           build: "cd admin && node node_modules/vite/bin/vite.js build"   # in the sandbox, offline
+ *           static: admin/dist        # Looply serves this folder itself
+ *           mount: /admin/            # the URL path the app expects (Vite `base`)
+ *           storage: { tabsy.activeCompanyId: cmp_demo }        # set before every page
+ *           dark: { storage: { tabsy.theme: dark } }            # else prefers-color-scheme
+ *           rtl:  { storage: { tabsy.lang: ar } }               # absent: no RTL capture
+ *           login:
+ *             storage:
+ *               tabsy.access: { from: admin/src/test/fixtures.ts, match: "access: '([^']+)'" }
+ *           api:
+ *             fallback: { status: 200, json: [] }
+ *             routes:
+ *               - { path: /api/v1/companies/selectable, file: admin/src/test/companies.json }
+ *           router: admin/src/App.tsx # to infer screens from changed pages
+ *           routes:
+ *             - { path: dashboard, name: Dashboard }
+ *
+ * 🔴 NO PROJECT CODE RUNS OUTSIDE THE SANDBOX. `build` runs where every gate runs
+ * (the AppContainer, no network). Looply serves the built files with its own
+ * static server; the app's code then runs only inside the browser, and every
+ * request that is not to that server is answered from `api` or refused — the
+ * page is offline by construction. A dev-server command (`vite dev`, `next
+ * start`) is NOT supported: a contained process cannot be reached on loopback.
+ *
+ * 🔴 SIGN-IN USES THE PROJECT'S OWN TEST DATA, NEVER A REAL ACCOUNT. Every value
+ * under `login` is READ from a file in the repository whose path says it is a
+ * seed, fixture, mock or test file; a literal written here is refused, so a real
+ * password can never be typed into this file and work.
+ */
+export declare class VisualProofConfigError extends Error {
+    readonly key: string;
+    constructor(key: string, message: string);
+}
+/** A value read from a file in the repository: the whole file, a JSON key, or a regex's first group. */
+export interface FixtureRef {
+    readonly from: string;
+    /** Dotted path into a JSON file (`users.0.password`). */
+    readonly key?: string;
+    /** A regular expression whose FIRST capture group is the value. */
+    readonly match?: string;
+}
+export type StorageValue = string | FixtureRef;
+export interface ApiRoute {
+    /** A URL path on the served origin; a trailing `*` matches any rest. */
+    readonly path: string;
+    readonly method?: string;
+    readonly status: number;
+    /** A JSON body given inline. */
+    readonly json?: unknown;
+    /** A JSON body read from a file in the repository. */
+    readonly file?: string;
+}
+export interface FormLogin {
+    /** Path on the served origin, under the mount (`/admin/login`). */
+    readonly path: string;
+    /** CSS selector → the value to type there. */
+    readonly fields: Readonly<Record<string, FixtureRef>>;
+    readonly submit: string;
+    /** A selector that is on screen once signed in. */
+    readonly waitFor?: string;
+}
+export interface VariantSetup {
+    readonly storage: Readonly<Record<string, string>>;
+}
+export interface ProofRoute {
+    /** Relative to the mount: `dashboard`, `orders/123`. Empty is the app's root. */
+    readonly path: string;
+    readonly name: string;
+    /** Changed files that make this route relevant. Empty: always a candidate. */
+    readonly when: readonly string[];
+}
+export interface ProofApp {
+    readonly name: string;
+    readonly when: readonly string[];
+    readonly build: string | null;
+    /** Folders carried into the throwaway checkout this app is built in; null: inferred from `build`. */
+    readonly carry: readonly string[] | null;
+    readonly timeoutS: number;
+    readonly static: string;
+    readonly mount: string;
+    readonly spa: boolean;
+    readonly storage: Readonly<Record<string, string>>;
+    readonly light: VariantSetup | null;
+    readonly dark: VariantSetup | null;
+    readonly rtl: VariantSetup | null;
+    readonly login: {
+        readonly storage: Readonly<Record<string, FixtureRef>>;
+        readonly form: FormLogin | null;
+    };
+    readonly api: {
+        readonly routes: readonly ApiRoute[];
+        readonly fallback: {
+            status: number;
+            json?: unknown;
+        };
+    };
+    readonly router: string | null;
+    readonly routes: readonly ProofRoute[];
+    readonly waitFor: string | null;
+}
+export interface Viewport {
+    readonly name: string;
+    readonly width: number;
+    readonly height: number;
+}
+export interface VisualProofConfig {
+    readonly enabled: boolean;
+    readonly maxRoutes: number;
+    readonly maxMb: number;
+    readonly viewports: readonly Viewport[];
+    readonly themes: readonly ('light' | 'dark')[];
+    readonly apps: readonly ProofApp[];
+}
+export declare const DEFAULT_VIEWPORTS: readonly Viewport[];
+export declare const DEFAULT_MAX_ROUTES = 4;
+export declare const DEFAULT_MAX_MB = 2048;
+export declare const DISABLED: VisualProofConfig;
+/** A repository-relative path that stays inside the repository. */
+export declare function repoPath(p: string, path: string): string;
+/**
+ * 🔴 A SIGN-IN VALUE IS A POINTER INTO A TEST FILE, NEVER THE VALUE ITSELF.
+ */
+export declare function fixtureRef(raw: unknown, path: string): FixtureRef;
+/** The `visual_proof:` section as written, or DISABLED when absent. Throws on anything malformed. */
+export declare function parseVisualProof(raw: unknown): VisualProofConfig;
+/** Read `visual_proof:` from the project's `.looply/config.yaml`; DISABLED when the file or section is absent. */
+export declare function readVisualProofConfig(projectDir: string): VisualProofConfig;
+/**
+ * Resolve a fixture pointer to its value, reading the file from the first root that has it
+ * (the checkout, then the project's main folder — a machine checkout may not carry it).
+ */
+export declare function readFixture(ref: FixtureRef, roots: readonly string[]): string;
+/** A JSON body file from the repository (checkout first, then the project folder). */
+export declare function readJsonFile(path: string, roots: readonly string[]): unknown;
+//# sourceMappingURL=visual-proof-config.d.ts.map

package/dist/visual-proof-config.d.ts.map

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