@vaishnavitron/anton-qa-review 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { hashContent, emptyManifest, loadManifest, saveManifest, diffAgainstManifest, hasPendingReview, approveFlows, formatReviewDiffs, } from "./manifest.js";
+export type { ReviewEntry, ReviewManifest, FlowArtifact, ReviewDiff, } from "./manifest.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACZ,UAAU,GACX,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { hashContent, emptyManifest, loadManifest, saveManifest, diffAgainstManifest, hasPendingReview, approveFlows, formatReviewDiffs, } from "./manifest.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,GAClB,MAAM,eAAe,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,35 @@
+export interface ReviewEntry {
+    contractId: string;
+    platform: string;
+    relativePath: string;
+    contentHash: string;
+    approvedAt: string;
+    approvedBy?: string;
+}
+export interface ReviewManifest {
+    version: 1;
+    entries: ReviewEntry[];
+}
+export declare function hashContent(content: string): string;
+export declare function emptyManifest(): ReviewManifest;
+export declare function loadManifest(manifestPath: string): Promise<ReviewManifest>;
+export declare function saveManifest(manifestPath: string, manifest: ReviewManifest): Promise<void>;
+export interface FlowArtifact {
+    contractId: string;
+    platform: string;
+    relativePath: string;
+    content: string;
+}
+export interface ReviewDiff {
+    relativePath: string;
+    contractId: string;
+    platform: string;
+    status: "new" | "changed" | "removed" | "approved";
+    currentHash?: string;
+    approvedHash?: string;
+}
+export declare function diffAgainstManifest(flows: FlowArtifact[], manifest: ReviewManifest): ReviewDiff[];
+export declare function hasPendingReview(diffs: ReviewDiff[]): boolean;
+export declare function approveFlows(manifest: ReviewManifest, flows: FlowArtifact[], approvedBy?: string): ReviewManifest;
+export declare function formatReviewDiffs(diffs: ReviewDiff[]): string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,aAAa,IAAI,cAAc,CAE9C;AAED,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAOhF;AAED,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EAAE,EACrB,QAAQ,EAAE,cAAc,GACvB,UAAU,EAAE,CA6Cd;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAO7D;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,YAAY,EAAE,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,cAAc,CA8BhB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAc7D"}

package/dist/manifest.js

@@ -0,0 +1,104 @@
+import { createHash } from "node:crypto";
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+export function hashContent(content) {
+    return createHash("sha256").update(content, "utf8").digest("hex");
+}
+export function emptyManifest() {
+    return { version: 1, entries: [] };
+}
+export async function loadManifest(manifestPath) {
+    try {
+        const raw = await readFile(manifestPath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return emptyManifest();
+    }
+}
+export async function saveManifest(manifestPath, manifest) {
+    await mkdir(path.dirname(manifestPath), { recursive: true });
+    await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+}
+export function diffAgainstManifest(flows, manifest) {
+    const approvedByPath = new Map(manifest.entries.map((entry) => [entry.relativePath, entry]));
+    const currentPaths = new Set(flows.map((flow) => flow.relativePath));
+    const diffs = [];
+    for (const flow of flows) {
+        const currentHash = hashContent(flow.content);
+        const approved = approvedByPath.get(flow.relativePath);
+        if (!approved) {
+            diffs.push({
+                relativePath: flow.relativePath,
+                contractId: flow.contractId,
+                platform: flow.platform,
+                status: "new",
+                currentHash,
+            });
+            continue;
+        }
+        diffs.push({
+            relativePath: flow.relativePath,
+            contractId: flow.contractId,
+            platform: flow.platform,
+            status: approved.contentHash === currentHash ? "approved" : "changed",
+            currentHash,
+            approvedHash: approved.contentHash,
+        });
+    }
+    for (const entry of manifest.entries) {
+        if (!currentPaths.has(entry.relativePath)) {
+            diffs.push({
+                relativePath: entry.relativePath,
+                contractId: entry.contractId,
+                platform: entry.platform,
+                status: "removed",
+                approvedHash: entry.contentHash,
+            });
+        }
+    }
+    return diffs.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+}
+export function hasPendingReview(diffs) {
+    return diffs.some((diff) => diff.status === "new" ||
+        diff.status === "changed" ||
+        diff.status === "removed");
+}
+export function approveFlows(manifest, flows, approvedBy) {
+    const now = new Date().toISOString();
+    const nextEntries = new Map(manifest.entries.map((entry) => [entry.relativePath, entry]));
+    for (const flow of flows) {
+        nextEntries.set(flow.relativePath, {
+            contractId: flow.contractId,
+            platform: flow.platform,
+            relativePath: flow.relativePath,
+            contentHash: hashContent(flow.content),
+            approvedAt: now,
+            approvedBy,
+        });
+    }
+    const flowPaths = new Set(flows.map((flow) => flow.relativePath));
+    for (const key of [...nextEntries.keys()]) {
+        if (!flowPaths.has(key)) {
+            nextEntries.delete(key);
+        }
+    }
+    return {
+        version: 1,
+        entries: [...nextEntries.values()].sort((a, b) => a.relativePath.localeCompare(b.relativePath)),
+    };
+}
+export function formatReviewDiffs(diffs) {
+    if (diffs.length === 0) {
+        return "No generated flows to review.";
+    }
+    return diffs
+        .map((diff) => {
+        const hashInfo = diff.currentHash !== undefined
+            ? ` hash=${diff.currentHash.slice(0, 12)}`
+            : "";
+        return `- [${diff.status}] ${diff.relativePath}${hashInfo}`;
+    })
+        .join("\n");
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,IAAI,MAAM,WAAW,CAAC;AAgB7B,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,YAAoB;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,aAAa,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,YAAoB,EACpB,QAAwB;IAExB,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAClF,CAAC;AAkBD,MAAM,UAAU,mBAAmB,CACjC,KAAqB,EACrB,QAAwB;IAExB,MAAM,cAAc,GAAG,IAAI,GAAG,CAC5B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAC7D,CAAC;IACF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IACrE,MAAM,KAAK,GAAiB,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEvD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC;gBACT,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,KAAK;gBACb,WAAW;aACZ,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,KAAK,CAAC,IAAI,CAAC;YACT,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,QAAQ,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;YACrE,WAAW;YACX,YAAY,EAAE,QAAQ,CAAC,WAAW;SACnC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC;gBACT,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,MAAM,EAAE,SAAS;gBACjB,YAAY,EAAE,KAAK,CAAC,WAAW;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,OAAO,KAAK,CAAC,IAAI,CACf,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,MAAM,KAAK,KAAK;QACrB,IAAI,CAAC,MAAM,KAAK,SAAS;QACzB,IAAI,CAAC,MAAM,KAAK,SAAS,CAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,QAAwB,EACxB,KAAqB,EACrB,UAAmB;IAEnB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAC7D,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE;YACjC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;YACtC,UAAU,EAAE,GAAG;YACf,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAClE,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC/C,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAC7C;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,+BAA+B,CAAC;IACzC,CAAC;IAED,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,QAAQ,GACZ,IAAI,CAAC,WAAW,KAAK,SAAS;YAC5B,CAAC,CAAC,SAAS,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;YAC1C,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,MAAM,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,YAAY,GAAG,QAAQ,EAAE,CAAC;IAC9D,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@vaishnavitron/anton-qa-review",
+  "version": "0.1.0",
+  "description": "Review manifest and approval gate for generated Maestro flows",
+  "author": "Vaishnav Chidambar",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/urbint/anton-qa-agent.git",
+    "directory": "packages/review"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@vaishnavitron/anton-qa-contract": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.15.30",
+    "typescript": "5.8.3",
+    "vitest": "3.2.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}