@juxtapose/core 0.2.0 → 0.5.0

package/dist/agent/handoff.d.ts

@@ -1,4 +1,4 @@
-import type { ChangedRegion, DiffStatus, Viewport } from '../types.js';
+import type { Cause, ChangedRegion, DiffStatus, StructuralVerdict, Viewport } from '../types.js';
 export interface HandoffPayload {
     storyId: string;
     storyTitle: string;
@@ -11,6 +11,10 @@ export interface HandoffPayload {
     componentPath: string;
     /** Absolute path to the machine-readable sidecar for this diff. */
     diffDataPath?: string;
+    /** Tier-0 verdict from the run, when the capture had structure. */
+    structural?: StructuralVerdict;
+    /** `jux diff <baseline.webp> <current.webp> --crops`, when both files exist. */
+    cropsCommand?: string;
     images: {
         baseline?: string;
         current?: string;
@@ -28,3 +32,6 @@ export declare function buildHandoffPrompt(p: HandoffPayload): string;
  * Both are given.
  */
 export declare function describeRegion(r: ChangedRegion, viewport: Viewport): string;
+/** The one wording of a cause, shared by the handoff and the CLI's review
+ *  list (which skips `unknown`). One or two sentences, no heading. */
+export declare function describeCause(c: Cause): string;

package/dist/agent/handoff.js

@@ -7,6 +7,7 @@
 //
 // Pure function. No I/O, no clipboard — string in, string out, so it is
 // trivially testable and callable from both the CLI and a server.
+import { describeDeltas } from '../diff/structural/summary.js';
 export function buildHandoffPrompt(p) {
     const lines = [];
     lines.push(`# Visual change: ${p.storyTitle}`);
@@ -24,7 +25,45 @@ export function buildHandoffPrompt(p) {
     if (p.diffDataPath) {
         lines.push(`Read \`${p.diffDataPath}\` for the full machine-readable diff.`, '');
     }
-    lines.push('## What changed');
+    const v = p.structural;
+    // Missing data is not a verdict: with no snapshot on one side and nothing
+    // to list, a structure section would be empty and misleading.
+    const missing = v && v.deltas.length === 0
+        ? v.flags.includes('no-baseline-structure')
+            ? 'baseline'
+            : v.flags.includes('no-current-structure')
+                ? 'current'
+                : undefined
+        : undefined;
+    if (v?.cause)
+        lines.push('## Why', '', describeCause(v.cause), '');
+    if (v && missing) {
+        lines.push(missing === 'baseline'
+            ? 'No structure snapshot for the baseline (approved before juxtapose recorded structure). Re-approve after this change to get structural diffs next time.'
+            : 'No structure snapshot for the current capture (structure capture failed or was unavailable). Re-run the capture to get structural diffs.', '');
+    }
+    else if (v) {
+        lines.push('## What changed (structure)');
+        lines.push('');
+        lines.push(v.summary);
+        lines.push('');
+        if (v.deltas.length > 0) {
+            lines.push(...describeDeltas(v.deltas, v.deltaCount));
+            if (v.deltaCount > v.deltas.length) {
+                lines.push(`  …and ${v.deltaCount - v.deltas.length} more (see the diff data file)`);
+            }
+            lines.push('');
+            lines.push('Check these deltas against the change you intended. If they are all intended,', `the change is expected: approve it (\`jux approve --story ${p.storyId}\`). If any`, 'delta is one you did not intend, fix that before approving.');
+        }
+        if (v.flags.length > 0) {
+            lines.push('', `Flags: ${v.flags.join(', ')}`);
+        }
+        if (v.explained !== 'full') {
+            lines.push('', 'Part of the pixel change has no matching DOM or style delta (canvas, images, or', 'rendering). Look at the diff image for those regions.');
+        }
+        lines.push('');
+    }
+    lines.push(v && !missing ? '## Pixels' : '## What changed');
     lines.push('');
     lines.push('```json');
     lines.push(JSON.stringify({
@@ -49,13 +88,15 @@ export function buildHandoffPrompt(p) {
     }
     lines.push('## Assessment');
     lines.push('');
-    lines.push(magnitudeHint(p.mismatchPercent));
+    lines.push(magnitudeHint(p.mismatchPercent, p.structural?.deltaCount ?? 0));
     lines.push('');
     lines.push(...actions(p, { approveVerb: 'accept the new rendering' }));
-    if (p.images.baseline || p.images.current || p.images.diff) {
-        lines.push('');
-        lines.push('## Images (inspect only if the data above is insufficient)');
-        lines.push('');
+    if (p.cropsCommand || p.images.baseline || p.images.current || p.images.diff) {
+        lines.push('', '## If still unsure', '');
+        if (p.cropsCommand) {
+            lines.push(`Side-by-side crops of each changed region, unexplained first — run \`${p.cropsCommand}\` and open the files it lists.`, '');
+        }
+        lines.push('Full images, last resort:');
         if (p.images.baseline)
             lines.push(`- baseline: \`${p.images.baseline}\``);
         if (p.images.current)
@@ -71,6 +112,12 @@ export function buildHandoffPrompt(p) {
 const MAX_REGIONS = 12;
 function actions(p, opts) {
     const out = ['## What to do', ''];
+    // A partial trace names the changed files it could see; the one that
+    // changed the pixels may be one it could not. Pointing the agent at the
+    // listed file sent it to the story's label edit for a bundled token change.
+    if (p.structural?.cause?.partial) {
+        out.push('The files under "Why" changed and are imported, but are not necessarily the cause: other imports could not be traced. Check every file changed since the base, not only those.', '');
+    }
     if (p.componentPath) {
         out.push(`1. Inspect the component: \`${p.componentPath}\``, `2. Check recent history: \`git log -p -- ${p.componentPath}\``, '3. Decide: intentional change, or regression?');
     }
@@ -99,14 +146,35 @@ export function describeRegion(r, viewport) {
     const horizontal = cx < viewport.width / 3 ? 'left' : cx > (viewport.width * 2) / 3 ? 'right' : 'center';
     return `(${r.x}, ${r.y}) ${r.width}×${r.height}px — ${vertical}-${horizontal}, ${round(areaPct)}% of viewport`;
 }
+/** The one wording of a cause, shared by the handoff and the CLI's review
+ *  list (which skips `unknown`). One or two sentences, no heading. */
+export function describeCause(c) {
+    const away = (d) => d === 0 ? 'the story file itself' : `${d} import${d === 1 ? '' : 's'} away`;
+    switch (c.kind) {
+        case 'in-closure':
+            return `Changed files this story imports, nearest first: ${c.files
+                .map((f) => `\`${f.path}\` (${away(f.distance)})`)
+                .join(', ')}${c.partial ? '; other imports could not be traced' : ''}.`;
+        case 'config':
+            return `A change that reaches every story: ${c.files.map((f) => `\`${f.path}\``).join(', ')}. Expect other stories to fail the same way; the run's \`groups\` lists which.`;
+        case 'none-in-closure':
+            return "No changed file appears in this story's traced imports. The cause is likely outside your diff: a dependency, an asset, the environment, or render drift.";
+        case 'unknown':
+            return "Cause unknown: this build doesn't expose every changed file's place in the story's imports, so nothing can be inferred from it.";
+    }
+}
 /**
  * Calibrate the agent's suspicion to the size of the change.
  *
  * Without this, agents treat a 0.02% antialiasing shift and a 40% layout
  * collapse as equally alarming.
  */
-function magnitudeHint(pct) {
+function magnitudeHint(pct, deltaCount) {
     if (pct < 0.1) {
+        // A sub-threshold colour change marks no pixels at all; calling it
+        // antialiasing noise beside a real delta argued with the section above.
+        if (deltaCount > 0)
+            return `Pixels are below tolerance, but structure records ${deltaCount} delta(s); judge those, not the pixel count.`;
         return 'Under 0.1% — consistent with sub-pixel antialiasing noise. Usually safe to approve, but confirm the changed regions are not on meaningful content.';
     }
     if (pct < 1) {

package/dist/agent/handoff.js.map

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

package/dist/analysis/affected.d.ts

@@ -1,4 +1,11 @@
 import type { StoryManifest } from '../types.js';
+interface ViteManifestEntry {
+    file: string;
+    src?: string;
+    imports?: string[];
+    dynamicImports?: string[];
+}
+export type ViteManifest = Record<string, ViteManifestEntry>;
 export interface AffectedOptions {
     projectRoot: string;
     /** Directories whose contents invalidate everything, from the platform
@@ -16,4 +23,55 @@ export interface AffectedResult {
      *  mysterious. */
     reason: 'no-baseline' | 'config-changed' | 'dependency-changed' | 'graph-walk' | 'no-match-fallback' | 'git-unavailable' | 'no-changes';
 }
+/** A root lockfile: dependencies changed, so every story may render
+ *  differently. A nested package.json (a fixture) is not one. */
+export declare function isLockfileChange(file: string): boolean;
+/** A root `tsconfig*.json`: compiler options reach every module, and the
+ *  manifest never names it, so without this a tsconfig edit beside a
+ *  component edit narrowed the run to that component's stories. */
+export declare function isTsconfigChange(file: string): boolean;
+/** Anything under a platform config dir (`.storybook`, `.ladle`) reaches
+ *  every story. */
+export declare function isConfigChange(file: string, configDirs: string[]): boolean;
 export declare function resolveAffected(stories: StoryManifest[], sinceCommit: string | null, opts: AffectedOptions): Promise<AffectedResult>;
+/**
+ * Which stories a set of source files could affect, without consulting git.
+ *
+ * This is the watch-mode entry point, and it inverts the fail-safe that
+ * `resolveAffected` uses. There, an uncertain answer escalates to capturing
+ * everything, because a missed story ships a regression. Here the trigger is a
+ * developer typing: escalating would recapture the whole suite on every
+ * keystroke-pause, which is not a safety net, it is a hang. An uncertain answer
+ * narrows to the files we know changed, and the CI run remains the backstop
+ * that cannot be fooled.
+ *
+ * The bundler graph is best-effort. Storybook's dev server has no build
+ * manifest, so when `buildDir` is absent or unbuilt we fall back to matching
+ * stories by their own component path — edit `Button.tsx` and every Button
+ * story recaptures. That misses a `Card` that imports `Button`; a build lying
+ * around upgrades the answer for free.
+ */
+export declare function resolveAffectedFromPaths(stories: StoryManifest[], changedFiles: string[], opts: {
+    projectRoot: string;
+    buildDir?: string;
+}): Promise<StoryManifest[]>;
+/** Vite's `imports[]` holds chunk keys, not source paths; this is the map
+ *  both graph directions resolve an edge through. A chunk with no `src` (a
+ *  bundled component chunk in a Storybook build) has no entry. */
+export declare function keyToSrc(manifest: ViteManifest): Map<string, string>;
+export declare function loadViteManifest(buildDir: string): Promise<ViteManifest | null>;
+/** The files changed since `sinceCommit`, as git prints them: relative to
+ *  the repository top level, forward slashes. The working tree counts (an
+ *  agent asks before it commits), and so do untracked files that are not
+ *  ignored. Null when git cannot say. NUL-separated with no trimming, so a
+ *  name with a space, a newline or a non-ASCII character is read exactly;
+ *  without `-z` git quotes such names and the quoted form matches nothing. */
+export declare function gitChangedFiles(sinceCommit: string, cwd: string): string[] | null;
+/** Whether `ref` names a commit, for checking `--since` before a run leans
+ *  on it. A leading dash is refused: git would read it as an option. */
+export declare function gitIsCommit(ref: string, cwd: string): boolean;
+/** The repository root, which git's paths are relative to. Null outside a
+ *  repository or without git. */
+export declare function gitTopLevel(cwd: string): string | null;
+export declare function toPosixRelative(root: string, abs: string): string;
+export {};

package/dist/analysis/affected.js

@@ -19,6 +19,23 @@ const LOCKFILES = new Set([
     'pnpm-lock.yaml',
     'bun.lockb',
 ]);
+/** A root lockfile: dependencies changed, so every story may render
+ *  differently. A nested package.json (a fixture) is not one. */
+export function isLockfileChange(file) {
+    const base = file.split('/').pop() ?? file;
+    return LOCKFILES.has(base) && !file.includes('/');
+}
+/** A root `tsconfig*.json`: compiler options reach every module, and the
+ *  manifest never names it, so without this a tsconfig edit beside a
+ *  component edit narrowed the run to that component's stories. */
+export function isTsconfigChange(file) {
+    return !file.includes('/') && /^tsconfig(\..+)?\.json$/.test(file);
+}
+/** Anything under a platform config dir (`.storybook`, `.ladle`) reaches
+ *  every story. */
+export function isConfigChange(file, configDirs) {
+    return configDirs.some((dir) => file === dir || file.startsWith(dir + '/'));
+}
 export async function resolveAffected(stories, sinceCommit, opts) {
     // No point of comparison — everything is affected.
     if (sinceCommit === null && !opts.changedFiles) {
@@ -30,13 +47,12 @@ export async function resolveAffected(stories, sinceCommit, opts) {
     if (changed.length === 0)
         return { stories: [], reason: 'no-changes' };
     for (const file of changed) {
-        const base = file.split('/').pop() ?? file;
-        if (LOCKFILES.has(base) && !file.includes('/')) {
+        if (isLockfileChange(file))
             return { stories, reason: 'dependency-changed' };
-        }
-        if (opts.configDirs.some((dir) => file === dir || file.startsWith(dir + '/'))) {
+        if (isTsconfigChange(file))
+            return { stories, reason: 'config-changed' };
+        if (isConfigChange(file, opts.configDirs))
             return { stories, reason: 'config-changed' };
-        }
     }
     const manifest = opts.buildDir ? await loadViteManifest(opts.buildDir) : null;
     if (!manifest) {
@@ -56,6 +72,54 @@ export async function resolveAffected(stories, sinceCommit, opts) {
         return { stories, reason: 'no-match-fallback' };
     return { stories: matched, reason: 'graph-walk' };
 }
+/**
+ * Which stories a set of source files could affect, without consulting git.
+ *
+ * This is the watch-mode entry point, and it inverts the fail-safe that
+ * `resolveAffected` uses. There, an uncertain answer escalates to capturing
+ * everything, because a missed story ships a regression. Here the trigger is a
+ * developer typing: escalating would recapture the whole suite on every
+ * keystroke-pause, which is not a safety net, it is a hang. An uncertain answer
+ * narrows to the files we know changed, and the CI run remains the backstop
+ * that cannot be fooled.
+ *
+ * The bundler graph is best-effort. Storybook's dev server has no build
+ * manifest, so when `buildDir` is absent or unbuilt we fall back to matching
+ * stories by their own component path — edit `Button.tsx` and every Button
+ * story recaptures. That misses a `Card` that imports `Button`; a build lying
+ * around upgrades the answer for free.
+ */
+export async function resolveAffectedFromPaths(stories, changedFiles, opts) {
+    if (changedFiles.length === 0)
+        return [];
+    const changed = changedFiles.map((f) => toPosixRelative(opts.projectRoot, path.resolve(opts.projectRoot, f)));
+    if (opts.buildDir) {
+        const manifest = await loadViteManifest(opts.buildDir);
+        if (manifest) {
+            const affected = walkDependents(buildReverseGraph(manifest), changed);
+            const matched = stories.filter((s) => affected.has(toPosixRelative(opts.projectRoot, s.componentPath)));
+            // An empty result means the graph does not know these files, not that
+            // nothing depends on them — fall through rather than reporting none.
+            if (matched.length > 0)
+                return matched;
+        }
+    }
+    return stories.filter((s) => {
+        const rel = toPosixRelative(opts.projectRoot, s.componentPath);
+        return changed.some((c) => rel === c || rel.endsWith('/' + c) || c.endsWith('/' + rel));
+    });
+}
+/** Vite's `imports[]` holds chunk keys, not source paths; this is the map
+ *  both graph directions resolve an edge through. A chunk with no `src` (a
+ *  bundled component chunk in a Storybook build) has no entry. */
+export function keyToSrc(manifest) {
+    const map = new Map();
+    for (const [key, entry] of Object.entries(manifest)) {
+        if (entry.src)
+            map.set(key, entry.src);
+    }
+    return map;
+}
 /**
  * Build `imported → importers` from Vite's manifest.
  *
@@ -63,18 +127,14 @@ export async function resolveAffected(stories, sinceCommit, opts) {
  * means mapping key → src first.
  */
 function buildReverseGraph(manifest) {
-    const keyToSrc = new Map();
-    for (const [key, entry] of Object.entries(manifest)) {
-        if (entry.src)
-            keyToSrc.set(key, entry.src);
-    }
+    const srcOf = keyToSrc(manifest);
     const reverse = new Map();
     for (const entry of Object.values(manifest)) {
         const importer = entry.src;
         if (!importer)
             continue;
         for (const key of [...(entry.imports ?? []), ...(entry.dynamicImports ?? [])]) {
-            const imported = keyToSrc.get(key) ?? key;
+            const imported = srcOf.get(key) ?? key;
             let set = reverse.get(imported);
             if (!set)
                 reverse.set(imported, (set = new Set()));
@@ -100,7 +160,7 @@ function walkDependents(reverse, seeds) {
     }
     return seen;
 }
-async function loadViteManifest(buildDir) {
+export async function loadViteManifest(buildDir) {
     for (const rel of ['.vite/manifest.json', 'manifest.json']) {
         try {
             return JSON.parse(await readFile(path.join(buildDir, rel), 'utf8'));
@@ -111,22 +171,74 @@ async function loadViteManifest(buildDir) {
     }
     return null;
 }
-function gitChangedFiles(sinceCommit, cwd) {
+/** The files changed since `sinceCommit`, as git prints them: relative to
+ *  the repository top level, forward slashes. The working tree counts (an
+ *  agent asks before it commits), and so do untracked files that are not
+ *  ignored. Null when git cannot say. NUL-separated with no trimming, so a
+ *  name with a space, a newline or a non-ASCII character is read exactly;
+ *  without `-z` git quotes such names and the quoted form matches nothing. */
+export function gitChangedFiles(sinceCommit, cwd) {
+    // A leading dash would be read as an option (`--output=<file>` writes one).
+    if (sinceCommit.startsWith('-'))
+        return null;
+    try {
+        // --no-renames: with rename detection (a user setting, `diff.renames`)
+        // git lists only the new name, and a story whose file was moved away
+        // lost its change. Both sides are listed instead.
+        const tracked = git(['diff', '--name-only', '--no-renames', '-z', sinceCommit, '--'], cwd);
+        // `:/` and `--full-name`: the whole repository, top-level-relative, even
+        // when cwd is a subdirectory, matching `git diff`'s paths.
+        const untracked = git(['ls-files', '--others', '--exclude-standard', '-z', '--full-name', '--', ':/'], cwd);
+        return [...new Set([...tracked.split('\0'), ...untracked.split('\0')])].filter((f) => f.length > 0);
+    }
+    catch {
+        return null;
+    }
+}
+/** Whether `ref` names a commit, for checking `--since` before a run leans
+ *  on it. A leading dash is refused: git would read it as an option. */
+export function gitIsCommit(ref, cwd) {
+    if (ref.startsWith('-'))
+        return false;
     try {
-        const out = execFileSync('git', ['diff', '--name-only', `${sinceCommit}..HEAD`], {
-            cwd,
-            encoding: 'utf8',
-        });
-        return out
-            .split('\n')
-            .map((s) => s.trim())
-            .filter(Boolean);
+        git(['rev-parse', '--verify', '--quiet', `${ref}^{commit}`], cwd);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** The repository root, which git's paths are relative to. Null outside a
+ *  repository or without git. */
+export function gitTopLevel(cwd) {
+    try {
+        // Only the line end: a directory name may itself end in a space.
+        return git(['rev-parse', '--show-toplevel'], cwd).replace(/\n$/, '');
     }
     catch {
         return null;
     }
 }
-function toPosixRelative(root, abs) {
+const GIT_TIMEOUT_MS = 10_000;
+const GIT_MAX_BUFFER = 64 * 1024 * 1024;
+/** Every git call goes through here. Git's stderr is dropped: outside a
+ *  repository it printed "fatal: not a git repository" and `git diff`'s full
+ *  usage text to the user's terminal, for a failure the caller already
+ *  handles. The timeout bounds a git that hangs (a lock, a network
+ *  filesystem); a timeout is a failure like any other. */
+function git(args, cwd) {
+    return execFileSync('git', ['-c', 'core.quotePath=false', ...args], {
+        cwd,
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'ignore'],
+        timeout: GIT_TIMEOUT_MS,
+        // The 1 MiB default holds about 15,000 changed paths of 70 bytes; a
+        // vendored tree or a repo-wide rename passes that, and an overflow throws. Past this
+        // larger cap the caller's catch still degrades (unknown, or a full run).
+        maxBuffer: GIT_MAX_BUFFER,
+    });
+}
+export function toPosixRelative(root, abs) {
     return path.relative(root, abs).split(path.sep).join('/');
 }
 //# sourceMappingURL=affected.js.map

package/dist/analysis/affected.js.map

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

package/dist/analysis/cause.d.ts

@@ -0,0 +1,32 @@
+import type { Cause } from '../types.js';
+import { type ViteManifest } from './affected.js';
+export interface CauseIndex {
+    /** The cause for one story's component path. Never throws, never reads
+     *  anything before the first call. */
+    causeFor(componentPath: string): Promise<Cause>;
+}
+/** One changed file, in both forms the rules need. */
+export interface ChangedFile {
+    /** Posix, relative to the project root: what a manifest `src` holds. */
+    path: string;
+    /** As git prints it, relative to the repository top level. In a monorepo
+     *  only this form shows that `../../pnpm-lock.yaml` is the root lockfile. */
+    repoPath: string;
+}
+export interface CauseSources {
+    projectRoot: string;
+    configDirs: string[];
+    /** Null when git could not say. */
+    changedFiles: ChangedFile[] | null;
+    manifest: ViteManifest | null;
+}
+/** The index from already-loaded inputs. Pure. */
+export declare function buildCauseIndex(src: CauseSources): CauseIndex;
+/** The index for `jux run --since`. Lazy and memoized, so the manifest and
+ *  git are read once, and only if some story fails. */
+export declare function prepareCause(opts: {
+    projectRoot: string;
+    buildDir?: string;
+    sinceCommit: string;
+    configDirs: string[];
+}): CauseIndex;