@wasao/kagemusha 0.1.1 → 0.3.4

package/dist/index.js

@@ -1,13 +1,23 @@
 #!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 import chalk from "chalk";
 import { Command } from "commander";
+import { addCommand } from "./commands/add.js";
 import { captureCommand } from "./commands/capture.js";
+import { discoverCommand } from "./commands/discover.js";
 import { editCommand } from "./commands/edit.js";
 import { initCommand } from "./commands/init.js";
-import { runCommand } from "./commands/run.js";
+import { listCommand } from "./commands/list.js";
+import { loginCommand } from "./commands/login.js";
 import { validateCommand } from "./commands/validate.js";
+// Read version from package.json at runtime so release-please only needs to
+// update one file (= package.json) on every bump. dist/index.js sits next
+// to dist/, so package.json is two levels up (= ../package.json).
+const pkgPath = fileURLToPath(new URL("../package.json", import.meta.url));
+const VERSION = JSON.parse(readFileSync(pkgPath, "utf-8")).version;
 const BANNER = `
-  ${chalk.bold("kagemusha")} ${chalk.gray("v0.1.0")}
+  ${chalk.bold("kagemusha")} ${chalk.gray(`v${VERSION}`)}
   ${chalk.dim("The shadow warrior for your documentation.")}
 
   ${chalk.white("Auto-update help center screenshots")}
@@ -16,7 +26,7 @@ const BANNER = `
 const program = new Command();
 program
     .name("kagemusha")
-    .version("0.1.0")
+    .version(VERSION)
     .addHelpText("beforeAll", BANNER)
     .configureHelp({
     sortSubcommands: false,
@@ -26,16 +36,30 @@ program
     .description("Set up config, screenshot definitions, and GitHub Actions workflow")
     .action(initCommand);
 program
-    .command("run")
-    .description("Run full pipeline: capture → upload to S3")
-    .option("--ids <ids>", "Comma-separated screenshot definition IDs")
-    .action(runCommand);
+    .command("login")
+    .description("Log in to your app (opens browser, saves session)")
+    .option("--headed", "Run scripted login in a visible browser (debug; ignored in interactive mode)")
+    .action(loginCommand);
+program
+    .command("add <path>")
+    .description("Add a screenshot definition (defaults to fullPage; use 'edit' to change capture range)")
+    .option("--id <id>", "Custom definition ID (auto-suffixed if exists)")
+    .action(addCommand);
+program
+    .command("discover")
+    .description("Auto-discover pages by crawling your app")
+    .action(discoverCommand);
+program
+    .command("list")
+    .description("List current screenshot definitions")
+    .action(listCommand);
 program
     .command("capture")
-    .description("Capture screenshots only")
+    .description("Capture screenshots, diff against canonical, and publish only what changed (use --dry-run to preview)")
     .option("--ids <ids>", "Comma-separated screenshot definition IDs")
-    .option("--all", "Capture all definitions")
-    .option("--open", "Open screenshots in browser after capture")
+    .option("--dry-run", "Preview only — capture and diff but do not update canonical (S3 push skipped)")
+    .option("--threshold <ratio>", "Diff ratio (0-1) above which to flag as changed; overrides config")
+    .option("--open", "Open changed/new results in the system default viewer (Preview / xdg-open / start)")
     .action(captureCommand);
 program
     .command("edit")
@@ -47,12 +71,6 @@ program
     .description("Validate config and definition files")
     .action(validateCommand);
 // Phase 2 commands
-program
-    .command("compare")
-    .description(`Compare screenshots with baselines (VRT) ${chalk.yellow("[coming soon]")}`)
-    .action(() => {
-    console.log(chalk.yellow("\n🚧 compare is coming in Phase 2.\n"));
-});
 program
     .command("publish")
     .description("Publish screenshots to Intercom / external services " +

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,MAAM,GAAG;IACX,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC/C,KAAK,CAAC,GAAG,CAAC,4CAA4C,CAAC;;IAEvD,KAAK,CAAC,KAAK,CAAC,qCAAqC,CAAC;IAClD,KAAK,CAAC,KAAK,CAAC,yBAAyB,CAAC;CACzC,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACL,IAAI,CAAC,WAAW,CAAC;KACjB,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC;KAChC,aAAa,CAAC;IACd,eAAe,EAAE,KAAK;CACtB,CAAC,CAAC;AAEJ,OAAO;KACL,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CACX,oEAAoE,CACpE;KACA,MAAM,CAAC,WAAW,CAAC,CAAC;AAEtB,OAAO;KACL,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,aAAa,EAAE,2CAA2C,CAAC;KAClE,MAAM,CAAC,UAAU,CAAC,CAAC;AAErB,OAAO;KACL,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,aAAa,EAAE,2CAA2C,CAAC;KAClE,MAAM,CAAC,OAAO,EAAE,yBAAyB,CAAC;KAC1C,MAAM,CAAC,QAAQ,EAAE,2CAA2C,CAAC;KAC7D,MAAM,CAAC,cAAc,CAAC,CAAC;AAEzB,OAAO;KACL,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gDAAgD,CAAC;KAC7D,MAAM,CAAC,WAAW,EAAE,kCAAkC,CAAC;KACvD,MAAM,CAAC,WAAW,CAAC,CAAC;AAEtB,OAAO;KACL,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,sCAAsC,CAAC;KACnD,MAAM,CAAC,eAAe,CAAC,CAAC;AAE1B,mBAAmB;AACnB,OAAO;KACL,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CACX,4CAA4C,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAC3E;KACA,MAAM,CAAC,GAAG,EAAE;IACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sCAAsC,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC,CAAC;AAEJ,OAAO;KACL,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CACX,sDAAsD;IACrD,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,CAC9B;KACA,MAAM,CAAC,GAAG,EAAE;IACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sCAAsC,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC,CAAC;AAEJ,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/annotate.d.ts

@@ -1,3 +1,3 @@
-import type { CaptureResult, ScreenshotDefinition } from "../types.js";
-export declare function annotateScreenshots(definitions: ScreenshotDefinition[], results: CaptureResult[], _projectRoot: string): Promise<CaptureResult[]>;
+import type { CaptureSpec, Decoration } from "../types.js";
+export declare const drawAnnotations: (input: Buffer | string, outputPath: string, decorations: Decoration[], capture: CaptureSpec, dpr: number) => Promise<void>;
 //# sourceMappingURL=annotate.d.ts.map

package/dist/lib/annotate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotate.d.ts","sourceRoot":"","sources":["../../src/lib/annotate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,aAAa,EAEb,oBAAoB,EACpB,MAAM,aAAa,CAAC;AAErB,wBAAsB,mBAAmB,CACxC,WAAW,EAAE,oBAAoB,EAAE,EACnC,OAAO,EAAE,aAAa,EAAE,EACxB,YAAY,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,EAAE,CAAC,CAoB1B"}
+{"version":3,"file":"annotate.d.ts","sourceRoot":"","sources":["../../src/lib/annotate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAe3D,eAAO,MAAM,eAAe,GAC3B,OAAO,MAAM,GAAG,MAAM,EACtB,YAAY,MAAM,EAClB,aAAa,UAAU,EAAE,EACzB,SAAS,WAAW,EACpB,KAAK,MAAM,KACT,OAAO,CAAC,IAAI,CAsCd,CAAC"}

package/dist/lib/annotate.js

@@ -1,24 +1,16 @@
-import fs from "node:fs";
 import sharp from "sharp";
-export async function annotateScreenshots(definitions, results, _projectRoot) {
-    const annotatedResults = [];
-    for (const result of results) {
-        const def = definitions.find((d) => d.id === result.id);
-        if (!def?.decorations?.length) {
-            // No decorations — copy raw as annotated
-            const annotatedPath = result.rawPath.replace(".raw.png", ".png");
-            fs.copyFileSync(result.rawPath, annotatedPath);
-            annotatedResults.push({ ...result, annotatedPath });
-            continue;
-        }
-        const annotatedPath = result.rawPath.replace(".raw.png", ".png");
-        await drawAnnotations(result.rawPath, annotatedPath, def.decorations);
-        annotatedResults.push({ ...result, annotatedPath });
+// Decorations are saved in page-relative device-pixel coords. When the
+// captured image is a crop, we subtract the crop's top-left so the SVG overlay
+// lines up with what's actually in the PNG.
+const captureOffset = (capture, dpr) => {
+    if (capture.mode === "crop") {
+        return { x: capture.crop.start.x * dpr, y: capture.crop.start.y * dpr };
     }
-    return annotatedResults;
-}
-async function drawAnnotations(inputPath, outputPath, decorations) {
-    const image = sharp(inputPath);
+    return { x: 0, y: 0 };
+};
+export const drawAnnotations = async (input, outputPath, decorations, capture, dpr) => {
+    const offset = captureOffset(capture, dpr);
+    const image = sharp(input);
     const metadata = await image.metadata();
     const width = metadata.width ?? 1280;
     const height = metadata.height ?? 720;
@@ -26,13 +18,13 @@ async function drawAnnotations(inputPath, outputPath, decorations) {
     for (const dec of decorations) {
         switch (dec.type) {
             case "rect":
-                svgParts.push(renderRect(dec));
+                svgParts.push(renderRect(dec, offset));
                 break;
             case "arrow":
-                svgParts.push(renderArrow(dec));
+                svgParts.push(renderArrow(dec, offset));
                 break;
             case "label":
-                svgParts.push(renderLabel(dec));
+                svgParts.push(renderLabel(dec, offset));
                 break;
         }
     }
@@ -50,53 +42,53 @@ async function drawAnnotations(inputPath, outputPath, decorations) {
     await image
         .composite([{ input: Buffer.from(svgOverlay), top: 0, left: 0 }])
         .toFile(outputPath);
-}
-function renderRect(dec) {
+};
+const renderRect = (dec, offset) => {
     const color = dec.style?.color ?? "#FF0000";
     const strokeWidth = dec.style?.strokeWidth ?? 2;
     const borderRadius = dec.style?.borderRadius ?? 0;
     if ("selector" in dec.target) {
-        // Selector-based rects need runtime resolution — use placeholder
-        // In real usage, the bounding box is resolved during capture
+        // Selector-based rects need runtime resolution — use placeholder.
+        // In real usage, the bounding box is resolved during capture.
         return `<!-- rect: selector "${dec.target.selector}" needs runtime resolution -->`;
     }
     const { x, y, width, height } = dec.target;
-    return `<rect x="${x}" y="${y}" width="${width}" height="${height}"
+    return `<rect x="${x - offset.x}" y="${y - offset.y}" width="${width}" height="${height}"
     rx="${borderRadius}" ry="${borderRadius}"
     fill="none" stroke="${color}" stroke-width="${strokeWidth}" />`;
-}
-function renderArrow(dec) {
+};
+const renderArrow = (dec, offset) => {
     const color = dec.style?.color ?? "#FF0000";
     const strokeWidth = dec.style?.strokeWidth ?? 2;
     const from = "x" in dec.from ? dec.from : { x: 0, y: 0 };
     const to = "x" in dec.to ? dec.to : { x: 100, y: 100 };
-    return `<line x1="${from.x}" y1="${from.y}" x2="${to.x}" y2="${to.y}"
+    return `<line x1="${from.x - offset.x}" y1="${from.y - offset.y}" x2="${to.x - offset.x}" y2="${to.y - offset.y}"
     stroke="${color}" stroke-width="${strokeWidth}"
     marker-end="url(#arrowhead)" />`;
-}
-function renderLabel(dec) {
+};
+const renderLabel = (dec, offset) => {
     const fontSize = dec.style?.fontSize ?? 14;
     const color = dec.style?.color ?? "#FF0000";
     const bg = dec.style?.background ?? "#FFFFFF";
     const pos = "x" in dec.position ? dec.position : { x: 0, y: 0 };
+    const px = pos.x - offset.x;
+    const py = pos.y - offset.y;
     const paddingX = 6;
     const paddingY = 4;
     const textWidth = dec.text.length * fontSize * 0.6;
     const textHeight = fontSize;
     return `
-    <rect x="${pos.x - paddingX}" y="${pos.y - textHeight - paddingY}"
+    <rect x="${px - paddingX}" y="${py - textHeight - paddingY}"
       width="${textWidth + paddingX * 2}" height="${textHeight + paddingY * 2}"
       rx="4" ry="4" fill="${bg}" />
-    <text x="${pos.x}" y="${pos.y}" font-size="${fontSize}"
+    <text x="${px}" y="${py}" font-size="${fontSize}"
       fill="${color}" font-family="sans-serif">${escapeXml(dec.text)}</text>
   `;
-}
-function escapeXml(str) {
-    return str
-        .replace(/&/g, "&amp;")
-        .replace(/</g, "&lt;")
-        .replace(/>/g, "&gt;")
-        .replace(/"/g, "&quot;")
-        .replace(/'/g, "&apos;");
-}
+};
+const escapeXml = (str) => str
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&apos;");
 //# sourceMappingURL=annotate.js.map

package/dist/lib/annotate.js.map

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

package/dist/lib/auth.d.ts

@@ -0,0 +1,18 @@
+import type { KagemushaConfig } from "../types.js";
+export declare const resolveLoginScriptPath: (config: KagemushaConfig, projectRoot: string) => string | null;
+export declare const getAuthStatePath: (projectRoot: string) => string;
+export declare const hasAuthState: (projectRoot: string) => boolean;
+export declare const getAuthMetaPath: (projectRoot: string) => string;
+export declare const authContextOptions: (projectRoot: string | undefined) => {
+    storageState?: string;
+};
+export declare const defaultContextOptions: (config: KagemushaConfig, projectRoot: string | undefined) => {
+    storageState?: string;
+    baseURL: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    deviceScaleFactor: number;
+};
+//# sourceMappingURL=auth.d.ts.map

package/dist/lib/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAYnD,eAAO,MAAM,sBAAsB,GAClC,QAAQ,eAAe,EACvB,aAAa,MAAM,KACjB,MAAM,GAAG,IAWX,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,KAAG,MACA,CAAC;AAExD,eAAO,MAAM,YAAY,GAAI,aAAa,MAAM,KAAG,OACN,CAAC;AAE9C,eAAO,MAAM,eAAe,GAAI,aAAa,MAAM,KAAG,MACA,CAAC;AAIvD,eAAO,MAAM,kBAAkB,GAC9B,aAAa,MAAM,GAAG,SAAS,KAC7B;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAGpB,CAAC;AAKP,eAAO,MAAM,qBAAqB,GACjC,QAAQ,eAAe,EACvB,aAAa,MAAM,GAAG,SAAS;mBAVZ,MAAM;;;;;;;CAmBzB,CAAC"}

package/dist/lib/auth.js

@@ -0,0 +1,45 @@
+import fs from "node:fs";
+import path from "node:path";
+const AUTH_STATE_FILE = "auth-state.json";
+const AUTH_META_FILE = "auth-meta.json";
+const KAGEMUSHA_DIR = ".kagemusha";
+// .mjs is preferred (no ambiguity with package.json's "type" field). .js is
+// accepted for projects that already declare "type": "module".
+const DEFAULT_LOGIN_SCRIPTS = ["login.mjs", "login.js"];
+// Resolves the path to the user-provided login script. Returns null if
+// neither `auth.scriptPath` nor any default candidate exists.
+// Both `login` and `capture` go through this so behavior stays in sync.
+export const resolveLoginScriptPath = (config, projectRoot) => {
+    const configured = config.auth?.scriptPath;
+    if (configured) {
+        const p = path.resolve(projectRoot, configured);
+        return fs.existsSync(p) ? p : null;
+    }
+    for (const name of DEFAULT_LOGIN_SCRIPTS) {
+        const p = path.join(projectRoot, KAGEMUSHA_DIR, name);
+        if (fs.existsSync(p))
+            return p;
+    }
+    return null;
+};
+export const getAuthStatePath = (projectRoot) => path.join(projectRoot, KAGEMUSHA_DIR, AUTH_STATE_FILE);
+export const hasAuthState = (projectRoot) => fs.existsSync(getAuthStatePath(projectRoot));
+export const getAuthMetaPath = (projectRoot) => path.join(projectRoot, KAGEMUSHA_DIR, AUTH_META_FILE);
+// Spread into Playwright's browser.newContext() options to enable auth reuse
+// when a saved storageState exists. No-op when missing.
+export const authContextOptions = (projectRoot) => projectRoot && hasAuthState(projectRoot)
+    ? { storageState: getAuthStatePath(projectRoot) }
+    : {};
+// Standard browser.newContext() options used by login / edit / capture so all
+// sessions render at identical viewport + DPR (avoids annotation drift between
+// editor view and captured image).
+export const defaultContextOptions = (config, projectRoot) => {
+    const vp = config.screenshot.defaultViewport;
+    return {
+        baseURL: config.app.baseUrl,
+        viewport: { width: vp.width, height: vp.height },
+        deviceScaleFactor: vp.deviceScaleFactor ?? 2,
+        ...authContextOptions(projectRoot),
+    };
+};
+//# sourceMappingURL=auth.js.map

package/dist/lib/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAC1C,MAAM,cAAc,GAAG,gBAAgB,CAAC;AACxC,MAAM,aAAa,GAAG,YAAY,CAAC;AACnC,4EAA4E;AAC5E,+DAA+D;AAC/D,MAAM,qBAAqB,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAExD,uEAAuE;AACvE,8DAA8D;AAC9D,wEAAwE;AACxE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACrC,MAAuB,EACvB,WAAmB,EACH,EAAE;IAClB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC;IAC3C,IAAI,UAAU,EAAE,CAAC;QAChB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAChD,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpC,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,qBAAqB,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;QACtD,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAU,EAAE,CAC/D,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,WAAmB,EAAW,EAAE,CAC5D,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,WAAmB,EAAU,EAAE,CAC9D,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;AAEvD,6EAA6E;AAC7E,wDAAwD;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CACjC,WAA+B,EACH,EAAE,CAC9B,WAAW,IAAI,YAAY,CAAC,WAAW,CAAC;IACvC,CAAC,CAAC,EAAE,YAAY,EAAE,gBAAgB,CAAC,WAAW,CAAC,EAAE;IACjD,CAAC,CAAC,EAAE,CAAC;AAEP,8EAA8E;AAC9E,+EAA+E;AAC/E,mCAAmC;AACnC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACpC,MAAuB,EACvB,WAA+B,EAC9B,EAAE;IACH,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC;IAC7C,OAAO;QACN,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO;QAC3B,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE;QAChD,iBAAiB,EAAE,EAAE,CAAC,iBAAiB,IAAI,CAAC;QAC5C,GAAG,kBAAkB,CAAC,WAAW,CAAC;KAClC,CAAC;AACH,CAAC,CAAC"}

package/dist/lib/aws-error.d.ts

@@ -0,0 +1,7 @@
+/**
+ * If `e` is a recognizable AWS error, print a friendly hint and return true.
+ * The caller is responsible for setting `process.exitCode` and returning.
+ * If the error isn't recognized, returns false — the caller should rethrow.
+ */
+export declare const handleAwsError: (e: unknown) => boolean;
+//# sourceMappingURL=aws-error.d.ts.map

package/dist/lib/aws-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-error.d.ts","sourceRoot":"","sources":["../../src/lib/aws-error.ts"],"names":[],"mappings":"AA0CA;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,GAAG,OAAO,KAAG,OA2C3C,CAAC"}

package/dist/lib/aws-error.js

@@ -0,0 +1,74 @@
+import chalk from "chalk";
+const errorName = (e) => typeof e === "object" && e !== null
+    ? (e.name ?? "")
+    : "";
+const errorCode = (e) => typeof e === "object" && e !== null
+    ? (e.Code ?? "")
+    : "";
+const errorMessage = (e) => typeof e === "object" && e !== null
+    ? (e.message ?? "")
+    : "";
+const matchesAuthError = (e) => {
+    const name = errorName(e);
+    const code = errorCode(e);
+    const message = errorMessage(e);
+    if (name === "CredentialsProviderError")
+        return true;
+    if (name === "ExpiredToken" || name === "ExpiredTokenException")
+        return true;
+    if (code === "ExpiredToken" || code === "ExpiredTokenException")
+        return true;
+    if (/token (is )?expired/i.test(message))
+        return true;
+    if (/credentials.*expired/i.test(message))
+        return true;
+    return false;
+};
+const matchesAccessDeniedError = (e) => {
+    const name = errorName(e);
+    const code = errorCode(e);
+    return name === "AccessDenied" || code === "AccessDenied";
+};
+const matchesNoSuchBucket = (e) => {
+    const name = errorName(e);
+    const code = errorCode(e);
+    return name === "NoSuchBucket" || code === "NoSuchBucket";
+};
+const profileLabel = () => process.env.AWS_PROFILE ?? "(default)";
+/**
+ * If `e` is a recognizable AWS error, print a friendly hint and return true.
+ * The caller is responsible for setting `process.exitCode` and returning.
+ * If the error isn't recognized, returns false — the caller should rethrow.
+ */
+export const handleAwsError = (e) => {
+    if (matchesAuthError(e)) {
+        const profile = profileLabel();
+        console.error("");
+        console.error(chalk.red(`✗ AWS authentication failed: ${errorMessage(e)}`));
+        console.error(chalk.yellow("\nHint:"));
+        console.error(chalk.gray(`  - Run: aws sso login --profile ${profile}`));
+        console.error(chalk.gray(`  - Or refresh credentials for the active profile (AWS_PROFILE=${profile})`));
+        console.error("");
+        return true;
+    }
+    if (matchesAccessDeniedError(e)) {
+        const profile = profileLabel();
+        console.error("");
+        console.error(chalk.red(`✗ AWS access denied: ${errorMessage(e)}`));
+        console.error(chalk.yellow("\nHint:"));
+        console.error(chalk.gray(`  - Active profile: AWS_PROFILE=${profile}`));
+        console.error(chalk.gray(`  - Verify the IAM principal has s3:GetObject / s3:PutObject on the target bucket`));
+        console.error("");
+        return true;
+    }
+    if (matchesNoSuchBucket(e)) {
+        console.error("");
+        console.error(chalk.red(`✗ S3 bucket not found: ${errorMessage(e)}`));
+        console.error(chalk.yellow("\nHint:"));
+        console.error(chalk.gray("  - Check publish.cdnBucket in kagemusha.config.yaml"));
+        console.error("");
+        return true;
+    }
+    return false;
+};
+//# sourceMappingURL=aws-error.js.map

package/dist/lib/aws-error.js.map

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

package/dist/lib/canonical.d.ts

@@ -0,0 +1,54 @@
+import type { KagemushaConfig } from "../types.js";
+export declare const getOutputDir: (config: KagemushaConfig, projectRoot: string) => string;
+export declare const getCanonicalPath: (config: KagemushaConfig, projectRoot: string, id: string) => string;
+export type FetchResult = "ok" | "not-found";
+/**
+ * URLs returned by `push()` so callers can include them in summary.json
+ * for downstream notification consumers (Slack, PR comments, etc.).
+ *
+ * - `after`: the new `latest.png` we just uploaded
+ * - `before`: the previous `latest.png`, copied to `previous.png` before
+ *   being overwritten. Undefined when no prior version existed (= first push)
+ */
+export interface PushUrls {
+    after: string;
+    before?: string;
+}
+/**
+ * S3-backed canonical store.
+ * Local mode has no remote — outputDir itself is the source of truth.
+ */
+export declare class S3Canonical {
+    private readonly bucket;
+    private readonly cdnBaseUrl?;
+    private readonly client;
+    constructor(bucket: string, cdnBaseUrl?: string | undefined);
+    private latestKey;
+    private previousKey;
+    private historyKey;
+    private urlFor;
+    /** Download canonical for `id` to `localPath`. Returns "not-found" if absent. */
+    fetch(id: string, localPath: string): Promise<FetchResult>;
+    /**
+     * Upload `localPath` as the canonical for `id`.
+     *
+     * Side effects on S3 for a single push:
+     *   1. Copy existing latest.png → previous.png (no-op if missing)
+     *   2. Upload localPath → latest.png
+     *   3. Upload localPath → history/<timestamp>.png
+     *
+     * Step 1 must complete first (otherwise the soon-to-be-overwritten latest
+     * would be replaced before the snapshot is taken). Steps 2-3 target
+     * different keys and run in parallel.
+     *
+     * Returns URLs (`before` / `after`) so callers can surface them in
+     * `reports/summary.json` (= public API). Consumers compare before vs after
+     * visually; kagemusha intentionally does not publish a pre-generated diff
+     * image (= pixelmatch's red overlay is alarming and adds little vs the
+     * raw pair).
+     */
+    push(id: string, localPath: string): Promise<PushUrls>;
+    label(): string;
+}
+export declare const createS3Canonical: (config: KagemushaConfig) => S3Canonical | null;
+//# sourceMappingURL=canonical.d.ts.map

package/dist/lib/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../src/lib/canonical.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD,eAAO,MAAM,YAAY,GACxB,QAAQ,eAAe,EACvB,aAAa,MAAM,KACjB,MAKF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC5B,QAAQ,eAAe,EACvB,aAAa,MAAM,EACnB,IAAI,MAAM,KACR,MAAmE,CAAC;AAEvE,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,WAAW,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD;;;GAGG;AAEH,qBAAa,WAAW;IAItB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAJ7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;gBAGhB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,YAAA;IAMrC,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,MAAM;IAKd,iFAAiF;IAC3E,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAgBhE;;;;;;;;;;;;;;;;;OAiBG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAuD5D,KAAK,IAAI,MAAM;CAGf;AASD,eAAO,MAAM,iBAAiB,GAC7B,QAAQ,eAAe,KACrB,WAAW,GAAG,IAOhB,CAAC"}