Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

fix(visual-check): record redirected sidecar paths without path-helper writes

tt-a1i746716b80005
diff --git a/archify.zip b/archify.zip
index 76b7ab46..7f9154ab 100644
Binary files a/archify.zip and b/archify.zip differ
diff --git a/archify/bin/visual-check.mjs b/archify/bin/visual-check.mjs
index 8a6e51c7..e26d307d 100644
--- a/archify/bin/visual-check.mjs
+++ b/archify/bin/visual-check.mjs
@@ -60,7 +60,6 @@ export function sidecarPaths(artifactPath, { outDir } = {}) {
const artifact = path.resolve(artifactPath);
const stem = path.basename(artifact).replace(/\.html?$/i, '');
const directory = outDir ? path.resolve(outDir) : path.dirname(artifact);
- if (outDir) fs.mkdirSync(directory, { recursive: true });
const base = path.join(directory, `${stem}.visual-check`);
const screenshots = CAPTURE_VIEWPORTS.flatMap(({ width, height }) => THEMES.map((theme) => ({
width,
@@ -683,6 +682,8 @@ function baseReceipt({ artifactPath, artifact, outputs, chrome }) {
viewerChrome: { status: 'fail', viewports: [] },
captures: { status: 'fail', screenshots: [], contactSheet: null },
sidecars: {
+ ...(path.dirname(outputs.receipt) !== path.dirname(artifactPath)
+ ? { directory: path.dirname(outputs.receipt) } : {}),
receipt: path.basename(outputs.receipt),
contactSheet: path.basename(outputs.contactSheet),
},
@@ -705,6 +706,7 @@ export async function runVisualCheck({
if (!/\.html?$/i.test(artifact)) throw new Error('visual-check requires an .html artifact.');
const artifactBytes = fs.readFileSync(artifact);
const outputs = sidecarPaths(artifact, { outDir });
+ fs.mkdirSync(path.dirname(outputs.receipt), { recursive: true });
cleanupCaptureSidecars(outputs);
safeUnlink(outputs.receipt);
diff --git a/archify/references/delivery-contract.md b/archify/references/delivery-contract.md
index e4cdd553..fef036f9 100644
--- a/archify/references/delivery-contract.md
+++ b/archify/references/delivery-contract.md
@@ -75,7 +75,10 @@ writes four PNG sidecars, one relative-path HTML contact sheet, and one JSON
receipt beside the artifact by default — pass `--out-dir <dir>` to write all of
them into a separate directory instead (created if missing) when a project
keeps its testing/evidence artifacts apart from the delivered `.json`/`.html`
-result pair. The receipt binds the source artifact SHA-256 and
+result pair. When that directory differs from the artifact directory, the
+receipt records its absolute path as `sidecars.directory`; sidecar filenames
+resolve there, otherwise beside `artifact.path`. The contact sheet keeps its
+image links relative for portability. The receipt binds the source artifact SHA-256 and
byte count, identifies `evidenceKind: "automated-browser"`, records READ plus
Still runtime state, and always reports `visualReview: "pending"`; automated
browser evidence cannot claim perceptual review.
diff --git a/archify/test/visual-check.test.mjs b/archify/test/visual-check.test.mjs
index c16a43ac..03ad5899 100644
--- a/archify/test/visual-check.test.mjs
+++ b/archify/test/visual-check.test.mjs
@@ -217,7 +217,7 @@ test('sidecarPaths places outputs in outDir instead of beside the artifact', ()
const outputs = sidecarPaths(input, { outDir: separateDir });
- assert.equal(fs.existsSync(separateDir), true, 'sidecarPaths must create a missing outDir');
+ assert.equal(fs.existsSync(separateDir), false, 'calculating paths must not create directories');
assert.equal(path.dirname(outputs.receipt), separateDir);
assert.equal(path.dirname(outputs.contactSheet), separateDir);
assert.equal(outputs.screenshots.every((entry) => path.dirname(entry.path) === separateDir), true);
@@ -243,6 +243,9 @@ test('visual-check writes all sidecars into --out-dir end-to-end, none beside th
assert.equal(result.receipt.status, 'pass');
const outputs = sidecarPaths(input, { outDir });
+ assert.equal(result.receipt.sidecars.directory, outDir);
+ assert.equal(fs.existsSync(path.join(result.receipt.sidecars.directory, result.receipt.sidecars.receipt)), true);
+ assert.equal(fs.existsSync(path.join(result.receipt.sidecars.directory, result.receipt.captures.contactSheet)), true);
assert.equal(fs.existsSync(outputs.receipt), true);
assert.equal(fs.existsSync(outputs.contactSheet), true);
assert.equal(outputs.screenshots.every((entry) => fs.existsSync(entry.path)), true);