review-workspace 1.2.0 → 1.3.0

package/dist/bundle/round.js

@@ -0,0 +1,71 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join, relative } from 'node:path';
+/**
+ * A stable cross-round identity for one MR: repo slug + number, e.g.
+ * "founda/application/xds-viewer-ui!367".
+ */
+export function mrKeyFor(comparison) {
+    if (!comparison.repository || !comparison.number) {
+        throw new Error('comparison.repository and comparison.number are required to compute an mrKey');
+    }
+    return `${comparison.repository}!${comparison.number}`;
+}
+function readReviewDocument(bundlePath) {
+    return JSON.parse(readFileSync(join(bundlePath, 'review.json'), 'utf-8'));
+}
+/**
+ * Reads a bundle directory name shaped like `<name>-r{N}` and splits it into
+ * the chain's base name and that bundle's round number. A name with no
+ * `-r{N}` suffix is round 1.
+ */
+function parseBundleDirName(dirName) {
+    const match = dirName.match(/^(.+)-r(\d+)$/);
+    if (!match)
+        return { baseName: dirName, round: 1 };
+    return { baseName: match[1], round: Number(match[2]) };
+}
+/** The sibling bundle path a new round for `bundlePath` would scaffold into. */
+export function nextRoundBundlePath(bundlePath) {
+    const { baseName, round } = parseBundleDirName(basename(bundlePath));
+    return join(dirname(bundlePath), `${baseName}-r${round + 1}`);
+}
+/**
+ * Detects, purely from what's on disk plus a supplied live head, whether a
+ * bundle's recorded Comparison has fallen behind its MR — the "new round"
+ * case alongside New/Existing/Improve bundle determination.
+ */
+export function checkRound(bundlePath, liveHead) {
+    const { comparison } = readReviewDocument(bundlePath);
+    return { needsNewRound: comparison.head !== liveHead, recordedHead: comparison.head, liveHead };
+}
+/**
+ * Scaffolds a new sibling round bundle for an MR whose live head has moved
+ * past what `bundlePath` recorded. Never mutates `bundlePath` (ADR 0002) —
+ * only creates the new `<name>-r{N}` directory alongside it, with its own
+ * Comparison, Unified Patch, and a `chain.json` linking it back.
+ */
+export function scaffoldNextRound(bundlePath, liveHead, options) {
+    const document = readReviewDocument(bundlePath);
+    if (document.comparison.head === liveHead) {
+        throw new Error(`Live head ${liveHead} matches the bundle's recorded head; no new round is needed`);
+    }
+    const { round: currentRound } = parseBundleDirName(basename(bundlePath));
+    const newBundlePath = nextRoundBundlePath(bundlePath);
+    if (existsSync(newBundlePath)) {
+        throw new Error(`Round bundle already exists at ${newBundlePath}`);
+    }
+    const chain = {
+        mrKey: mrKeyFor(document.comparison),
+        round: currentRound + 1,
+        previousBundle: relative(newBundlePath, bundlePath),
+        previousHead: document.comparison.head,
+    };
+    mkdirSync(newBundlePath, { recursive: true });
+    writeFileSync(join(newBundlePath, 'changes.diff'), options.patch);
+    writeFileSync(join(newBundlePath, 'review.json'), JSON.stringify({
+        schemaVersion: document.schemaVersion,
+        comparison: { ...document.comparison, head: liveHead },
+    }, null, 2));
+    writeFileSync(join(newBundlePath, 'chain.json'), JSON.stringify(chain, null, 2));
+    return { bundlePath: newBundlePath, chain };
+}

package/dist/cli.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
+import { readFileSync } from 'node:fs';
 import { validateBundle } from "./bundle/validate-bundle.js";
 import { publishBundle } from "./bundle/publish.js";
+import { checkRound, scaffoldNextRound } from "./bundle/round.js";
 import { startReviewServer } from "./server/create-server.js";
 const [, , command, bundlePath, ...rest] = process.argv;
 function fail(message) {
@@ -12,7 +14,7 @@ function flagValue(name) {
     return index === -1 ? undefined : rest[index + 1];
 }
 if (!command || !bundlePath) {
-    fail('Usage: review-workspace <open|publish|serve> <bundlePath> [--port N]');
+    fail('Usage: review-workspace <open|publish|serve|round> <bundlePath> [--port N] [--live-head SHA --patch FILE]');
 }
 if (command === 'open') {
     const result = validateBundle(bundlePath);
@@ -31,6 +33,22 @@ else if (command === 'publish') {
     }
     console.log('Published.');
 }
+else if (command === 'round') {
+    const liveHead = flagValue('--live-head');
+    const patchPath = flagValue('--patch');
+    if (!liveHead || !patchPath) {
+        fail('Usage: review-workspace round <bundlePath> --live-head <sha> --patch <patchFile>');
+    }
+    const { needsNewRound } = checkRound(bundlePath, liveHead);
+    if (!needsNewRound) {
+        console.log(JSON.stringify({ needsNewRound: false }));
+    }
+    else {
+        const patch = readFileSync(patchPath, 'utf-8');
+        const result = scaffoldNextRound(bundlePath, liveHead, { patch });
+        console.log(JSON.stringify({ needsNewRound: true, ...result }));
+    }
+}
 else if (command === 'serve') {
     const port = Number(flagValue('--port') ?? 4317);
     const handle = await startReviewServer(bundlePath, { port });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "review-workspace",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "A local, offline decision surface for reviewing a code Comparison — evidence-linked map of intent, behavior, risk, and observable effects.",
   "license": "MIT",
   "author": "Salih Sayer",