Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
fix(visual-check): record redirected sidecar paths without path-helper writes
tt-a1i746716b80005
diff --git a/archify.zip b/archify.zipindex 76b7ab46..7f9154ab 100644Binary files a/archify.zip and b/archify.zip differdiff --git a/archify/bin/visual-check.mjs b/archify/bin/visual-check.mjsindex 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.mdindex 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 JSONreceipt beside the artifact by default — pass `--out-dir <dir>` to write all ofthem into a separate directory instead (created if missing) when a projectkeeps 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 andbyte count, identifies `evidenceKind: "automated-browser"`, records READ plusStill runtime state, and always reports `visualReview: "pending"`; automatedbrowser evidence cannot claim perceptual review.diff --git a/archify/test/visual-check.test.mjs b/archify/test/visual-check.test.mjsindex 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 thassert.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);