@tangle-network/browser-agent-driver 0.33.3 → 0.34.0

package/dist/design/audit/reference/corpus/store.d.ts

@@ -0,0 +1,26 @@
+/**
+ * File-backed corpus store — the ONLY module that touches the corpus directory.
+ * Implements the full `CorpusStore` (`CorpusReader` + `CorpusWriter`) as a
+ * JSON-record directory: one `<id>.json` exemplar per file plus a `screenshots/`
+ * sidecar. The audit hot path receives only the `CorpusReader` half (so it can
+ * never reach `upsert`/`saveScreenshot`); offline `corpus/build` holds the writer.
+ *
+ * Fail-closed by construction:
+ *  - a missing corpus dir loads as an EMPTY corpus, never an error or a fabricated
+ *    row, and `get` returns `null` on a miss;
+ *  - a record that fails `parseExemplar` (corrupt / hand-edited / foreign) is
+ *    skipped on load rather than poisoning the whole corpus — one bad row never
+ *    nukes retrieval, and nothing is ever invented to fill the gap;
+ *  - writes are atomic-ish (temp file + `rename`) and validate through the schema
+ *    BEFORE landing, so a malformed exemplar can never reach disk;
+ *  - ids are constrained to a filename-safe charset, so neither `get` nor a write
+ *    can escape the corpus dir via path traversal.
+ */
+import type { CorpusStore } from '../contracts.js';
+/**
+ * Build a file-backed `CorpusStore` rooted at `dir`. The returned object's
+ * `CorpusReader` half is what the engine consumes; the `CorpusWriter` half is for
+ * the offline authoring path only.
+ */
+export declare function createFileCorpusStore(dir: string): CorpusStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/design/audit/reference/corpus/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../../src/design/audit/reference/corpus/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,iBAAiB,CAAA;AAW5D;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAoE9D"}

package/dist/design/audit/reference/corpus/store.js

@@ -0,0 +1,104 @@
+/**
+ * File-backed corpus store — the ONLY module that touches the corpus directory.
+ * Implements the full `CorpusStore` (`CorpusReader` + `CorpusWriter`) as a
+ * JSON-record directory: one `<id>.json` exemplar per file plus a `screenshots/`
+ * sidecar. The audit hot path receives only the `CorpusReader` half (so it can
+ * never reach `upsert`/`saveScreenshot`); offline `corpus/build` holds the writer.
+ *
+ * Fail-closed by construction:
+ *  - a missing corpus dir loads as an EMPTY corpus, never an error or a fabricated
+ *    row, and `get` returns `null` on a miss;
+ *  - a record that fails `parseExemplar` (corrupt / hand-edited / foreign) is
+ *    skipped on load rather than poisoning the whole corpus — one bad row never
+ *    nukes retrieval, and nothing is ever invented to fill the gap;
+ *  - writes are atomic-ish (temp file + `rename`) and validate through the schema
+ *    BEFORE landing, so a malformed exemplar can never reach disk;
+ *  - ids are constrained to a filename-safe charset, so neither `get` nor a write
+ *    can escape the corpus dir via path traversal.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { parseExemplar, serializeExemplar } from './schema.js';
+const RECORD_EXT = '.json';
+const SCREENSHOT_DIR = 'screenshots';
+// Exemplar ids are slugs (`[a-z0-9-]`); this guard keeps `get`/write inside the
+// corpus dir even when handed a hostile id, blocking `..`/separator traversal.
+const SAFE_ID = /^[A-Za-z0-9_-]+$/;
+const isSafeId = (id) => SAFE_ID.test(id);
+/**
+ * Build a file-backed `CorpusStore` rooted at `dir`. The returned object's
+ * `CorpusReader` half is what the engine consumes; the `CorpusWriter` half is for
+ * the offline authoring path only.
+ */
+export function createFileCorpusStore(dir) {
+    const recordPath = (id) => path.join(dir, `${id}${RECORD_EXT}`);
+    async function readRecord(file) {
+        let text;
+        try {
+            text = await fs.readFile(file, 'utf8');
+        }
+        catch {
+            return null;
+        }
+        try {
+            return parseExemplar(JSON.parse(text));
+        }
+        catch {
+            // Corrupt / foreign record — skip it rather than fail the whole load.
+            return null;
+        }
+    }
+    return {
+        async load() {
+            let entries;
+            try {
+                entries = await fs.readdir(dir);
+            }
+            catch {
+                return [];
+            }
+            const out = [];
+            // Sort by filename for a deterministic load order across machines.
+            for (const name of entries.filter((n) => n.endsWith(RECORD_EXT)).sort()) {
+                const exemplar = await readRecord(path.join(dir, name));
+                if (exemplar)
+                    out.push(exemplar);
+            }
+            return out;
+        },
+        async get(id) {
+            if (!isSafeId(id))
+                return null;
+            return readRecord(recordPath(id));
+        },
+        resolveScreenshot(exemplar) {
+            const p = exemplar.screenshotPath;
+            if (!p)
+                return '';
+            return path.isAbsolute(p) ? p : path.resolve(dir, p);
+        },
+        async upsert(exemplar) {
+            // Validate + normalise at the IO boundary: malformed exemplars never land.
+            const valid = parseExemplar(exemplar);
+            if (!isSafeId(valid.id))
+                throw new Error(`corpus upsert: unsafe exemplar id '${valid.id}'`);
+            await fs.mkdir(dir, { recursive: true });
+            const final = recordPath(valid.id);
+            const tmp = `${final}.tmp-${process.pid}-${Date.now()}`;
+            await fs.writeFile(tmp, serializeExemplar(valid), 'utf8');
+            await fs.rename(tmp, final);
+        },
+        async saveScreenshot(id, png) {
+            if (!isSafeId(id))
+                throw new Error(`corpus saveScreenshot: unsafe exemplar id '${id}'`);
+            const rel = path.join(SCREENSHOT_DIR, `${id}.png`);
+            const abs = path.join(dir, rel);
+            await fs.mkdir(path.dirname(abs), { recursive: true });
+            await fs.writeFile(abs, png);
+            // Return the corpus-relative path so it stores portably in the exemplar
+            // record; `resolveScreenshot` turns it back into an absolute path.
+            return rel;
+        },
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/design/audit/reference/corpus/store.js.map

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

package/dist/design/audit/reference/dna/delta.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Structural delta between two `DesignDNA`s — PURE, at DNA altitude only.
+ *
+ * `dnaDelta(current, target)` describes the transformation FROM the audited page
+ * (`current`) TO a reference/winner (`target`): what the target adds, drops or
+ * reshapes relative to the page. It diffs ONLY normalised `DesignDNA` fields
+ * (colour roles, type scale, spacing rhythm, component economy) — it never diffs
+ * raw `DesignTokens` (a different altitude owned by `compare.ts`). The result
+ * grounds judge feedback and mints DNA-gap findings.
+ *
+ * No IO, no LLM; identical inputs always yield a deeply-equal delta.
+ */
+import type { DesignDNA, DnaDelta } from '../contracts.js';
+/**
+ * Compute the DNA-altitude delta from `current` (audited page) to `target`
+ * (reference/winner). Component deltas are signed `target − current`: a NEGATIVE
+ * value means the current page uses MORE of that pattern than the reference
+ * (a consolidation opportunity); positive means fewer.
+ */
+export declare function dnaDelta(current: DesignDNA, target: DesignDNA): DnaDelta;
+//# sourceMappingURL=delta.d.ts.map

package/dist/design/audit/reference/dna/delta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta.d.ts","sourceRoot":"","sources":["../../../../../src/design/audit/reference/dna/delta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAa,MAAM,iBAAiB,CAAA;AAkFrE;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,QAAQ,CAmBxE"}

package/dist/design/audit/reference/dna/delta.js

@@ -0,0 +1,126 @@
+/**
+ * Structural delta between two `DesignDNA`s — PURE, at DNA altitude only.
+ *
+ * `dnaDelta(current, target)` describes the transformation FROM the audited page
+ * (`current`) TO a reference/winner (`target`): what the target adds, drops or
+ * reshapes relative to the page. It diffs ONLY normalised `DesignDNA` fields
+ * (colour roles, type scale, spacing rhythm, component economy) — it never diffs
+ * raw `DesignTokens` (a different altitude owned by `compare.ts`). The result
+ * grounds judge feedback and mints DNA-gap findings.
+ *
+ * No IO, no LLM; identical inputs always yield a deeply-equal delta.
+ */
+const round2 = (n) => Math.round(n * 100) / 100;
+const COLOR_ROLE_ORDER = ['primary', 'secondary', 'accent', 'neutral', 'background', 'border'];
+/** A colour role is "present" when it carries at least one hex. */
+function presentRoles(dna) {
+    const set = new Set();
+    for (const role of COLOR_ROLE_ORDER) {
+        if (dna.color.roles[role].length > 0)
+            set.add(role);
+    }
+    return set;
+}
+/** Whether two role hex sets differ, order-independent. */
+function hexSetChanged(a, b) {
+    if (a.length !== b.length)
+        return true;
+    const sb = new Set(b);
+    return a.some((hex) => !sb.has(hex));
+}
+function diffColor(current, target) {
+    const cur = presentRoles(current);
+    const tgt = presentRoles(target);
+    const added = [];
+    const removed = [];
+    const changed = [];
+    for (const role of COLOR_ROLE_ORDER) {
+        const inCur = cur.has(role);
+        const inTgt = tgt.has(role);
+        if (inTgt && !inCur)
+            added.push(role);
+        else if (inCur && !inTgt)
+            removed.push(role);
+        else if (inCur && inTgt && hexSetChanged(current.color.roles[role], target.color.roles[role]))
+            changed.push(role);
+    }
+    return { added, removed, changed };
+}
+function diffType(current, target) {
+    const curSizes = new Set(current.type.steps.map((s) => s.fontSizePx));
+    const tgtSizes = new Set(target.type.steps.map((s) => s.fontSizePx));
+    let stepsAdded = 0;
+    let stepsRemoved = 0;
+    for (const size of tgtSizes)
+        if (!curSizes.has(size))
+            stepsAdded++;
+    for (const size of curSizes)
+        if (!tgtSizes.has(size))
+            stepsRemoved++;
+    let ratioDelta;
+    if (current.type.ratio !== undefined && target.type.ratio !== undefined) {
+        const d = round2(target.type.ratio - current.type.ratio);
+        ratioDelta = Math.abs(d) < 0.005 ? undefined : d;
+    }
+    return { stepsAdded, stepsRemoved, ratioDelta };
+}
+function buildSummary(delta) {
+    const parts = [];
+    if (delta.color.added.length)
+        parts.push(`+${delta.color.added.length} colour role(s) (${delta.color.added.join(', ')})`);
+    if (delta.color.removed.length)
+        parts.push(`−${delta.color.removed.length} colour role(s) (${delta.color.removed.join(', ')})`);
+    if (delta.color.changed.length)
+        parts.push(`recoloured ${delta.color.changed.join(', ')}`);
+    const stepBits = [];
+    if (delta.type.stepsAdded)
+        stepBits.push(`+${delta.type.stepsAdded}`);
+    if (delta.type.stepsRemoved)
+        stepBits.push(`−${delta.type.stepsRemoved}`);
+    if (stepBits.length)
+        parts.push(`type scale ${stepBits.join('/')} step(s)`);
+    if (delta.type.ratioDelta !== undefined) {
+        parts.push(`scale ratio ${delta.type.ratioDelta > 0 ? '+' : ''}${delta.type.ratioDelta}`);
+    }
+    if (delta.spacing.baseUnitFrom !== delta.spacing.baseUnitTo) {
+        parts.push(`grid ${delta.spacing.baseUnitFrom ?? 'none'}→${delta.spacing.baseUnitTo ?? 'none'}px`);
+    }
+    if (delta.spacing.densityChanged)
+        parts.push('spacing density shift');
+    const comp = delta.components;
+    const compBits = [];
+    for (const [kind, n] of Object.entries(comp)) {
+        if (n !== 0)
+            compBits.push(`${kind} ${n > 0 ? '+' : ''}${n}`);
+    }
+    if (compBits.length)
+        parts.push(`components ${compBits.join(', ')}`);
+    return parts.length ? parts.join('; ') : 'no structural difference';
+}
+/**
+ * Compute the DNA-altitude delta from `current` (audited page) to `target`
+ * (reference/winner). Component deltas are signed `target − current`: a NEGATIVE
+ * value means the current page uses MORE of that pattern than the reference
+ * (a consolidation opportunity); positive means fewer.
+ */
+export function dnaDelta(current, target) {
+    const delta = {
+        color: diffColor(current, target),
+        type: diffType(current, target),
+        spacing: {
+            baseUnitFrom: current.spacing.baseUnit,
+            baseUnitTo: target.spacing.baseUnit,
+            densityChanged: current.spacing.density !== target.spacing.density,
+        },
+        components: {
+            buttons: target.components.buttons - current.components.buttons,
+            inputs: target.components.inputs - current.components.inputs,
+            cards: target.components.cards - current.components.cards,
+            nav: target.components.nav - current.components.nav,
+        },
+        summary: '',
+    };
+    delta.summary = buildSummary(delta);
+    return delta;
+}
+//# sourceMappingURL=delta.js.map

package/dist/design/audit/reference/dna/delta.js.map

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

package/dist/design/audit/reference/dna/derive.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Design-DNA derivation — the PURE core of the reference engine's FOUNDATION.
+ *
+ * `toDesignDNA` folds an already-extracted `DesignTokens` record (+ optional
+ * deterministic `MeasurementBundle`) into the normalised, browser-free
+ * `DesignDNA` identity. It performs NO IO, NO LLM, NO browser work and is fully
+ * deterministic, so it unit-tests on static token fixtures alone.
+ *
+ * Altitude discipline (per ARCHITECTURE.md §0): this is a LOSSY normalisation of
+ * tokens. It CARRIES THROUGH the already-computed `ColorToken.cluster` and
+ * `ViewportTokens.gridBaseUnit` rather than re-clustering colours or re-detecting
+ * a grid — those decisions belong to the token extractor, not here.
+ */
+import type { DesignTokens, MeasurementBundle, DesignDNA, RawScrollCapture } from '../contracts.js';
+/**
+ * Fold a `DesignTokens` record (+ optional measurements + optional live
+ * `RawScrollCapture`) into a `DesignDNA`. Pure and deterministic: identical
+ * inputs always yield an identical DNA. `scroll` is attached as `motion.scroll`
+ * only when supplied — the browser layer captures it; this fold never observes a
+ * page.
+ */
+export declare function toDesignDNA(tokens: DesignTokens, measurements?: MeasurementBundle, scroll?: RawScrollCapture): DesignDNA;
+/**
+ * A budget-bounded, prompt-ready summary of a `DesignDNA`. Deterministic and
+ * IO-free; truncates to `maxChars` so an injected reference can never blow the
+ * generation/judge token budget.
+ */
+export declare function summarizeDNA(dna: DesignDNA, opts?: {
+    maxChars?: number;
+}): string;
+//# sourceMappingURL=derive.d.ts.map

package/dist/design/audit/reference/dna/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../../../../src/design/audit/reference/dna/derive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,iBAAiB,EACjB,SAAS,EAOT,gBAAgB,EACjB,MAAM,iBAAiB,CAAA;AA+NxB;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,YAAY,CAAC,EAAE,iBAAiB,EAChC,MAAM,CAAC,EAAE,gBAAgB,GACxB,SAAS,CAyFX;AAiBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAyBrF"}