@drantoniou/uploadcheck 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drantoniou/uploadcheck",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "The quality gate for AI-generated media. Check videos, podcasts, and clips before you publish — or `watch` a folder to auto-QC every render.",
   "homepage": "https://uploadcheck.app",
   "repository": {

package/request-builder.mjs

@@ -190,6 +190,10 @@ export function parseArgs(argv) {
       options.settleMs = requireValue(arg, args.shift());
     } else if (arg === "--poll-ms") {
       options.pollMs = requireValue(arg, args.shift());
+    } else if (arg === "--on-pass") {
+      options.onPass = requireValue(arg, args.shift());
+    } else if (arg === "--on-fail") {
+      options.onFail = requireValue(arg, args.shift());
     } else {
       throw new Error(`Unknown option: ${arg}`);
     }

package/watch.mjs

@@ -20,6 +20,7 @@
 import { readdirSync, statSync, existsSync, writeFileSync, readFileSync, watch as fsWatch } from "node:fs";
 import { join, extname, basename, dirname, resolve, relative } from "node:path";
 import { createHash } from "node:crypto";
+import { spawn } from "node:child_process";
 import { buildJobRequest, CONTENT_TYPES } from "./request-builder.mjs";
 import { submitJob, pollJobUntilDone, fetchReport, fetchMarkerCsv, sleep } from "./api-client.mjs";
 
@@ -84,6 +85,23 @@ function appendAggregateRow(dir, row) {
   } catch { /* best-effort */ }
 }
 
+// Run a user-supplied shell command after a verdict (--on-pass / --on-fail).
+// The file path is exposed to the command as $UPLOADCHECK_FILE (and the verdict as
+// $UPLOADCHECK_VERDICT), so `mv "$UPLOADCHECK_FILE" done/` style commands work.
+// Failures are logged, never fatal.
+function runHook(command, filePath, verdict) {
+  if (!command) return Promise.resolve();
+  return new Promise((resolve) => {
+    const child = spawn(command, {
+      shell: true,
+      stdio: "inherit",
+      env: { ...process.env, UPLOADCHECK_FILE: filePath, UPLOADCHECK_VERDICT: String(verdict || "") }
+    });
+    child.on("error", (e) => { console.error(`[watch] hook error: ${e.message}`); resolve(); });
+    child.on("exit", () => resolve());
+  });
+}
+
 async function processFile(filePath, { apiBaseUrl, apiKey, options, dir, ledger, nowIso }) {
   const name = basename(filePath);
   // Build the job exactly like `uploadcheck check` (inline vs signed-upload auto-switch).
@@ -119,8 +137,15 @@ async function processFile(filePath, { apiBaseUrl, apiKey, options, dir, ledger,
   ledger.done[sourceKey] = { file: name, jobId, verdict, status: finished.status, at: nowIso };
   saveLedger(dir, ledger);
 
-  const mark = finished.status !== "completed" ? "⚠️" : (String(verdict).toUpperCase().includes("BLOCK") ? "❌ BLOCK" : (String(verdict).toUpperCase().includes("WATCH") ? "⚠️ WATCH" : "✅"));
+  const verdictUpper = String(verdict).toUpperCase();
+  const passed = finished.status === "completed" && !verdictUpper.includes("BLOCK");
+  const mark = finished.status !== "completed" ? "⚠️" : (verdictUpper.includes("BLOCK") ? "❌ BLOCK" : (verdictUpper.includes("WATCH") ? "⚠️ WATCH" : "✅"));
   console.log(`[watch] ${name}: ${mark} (${flagCount} flag${flagCount === 1 ? "" : "s"}) → ${basename(reportPathFor(filePath))}`);
+
+  // Pipeline glue: run --on-pass when nothing blocks (a clean PASS or WATCH), or
+  // --on-fail on a BLOCK / failed job. WATCH counts as a pass — it ships with notes.
+  if (passed && options.onPass) await runHook(options.onPass, filePath, verdict);
+  else if (!passed && options.onFail) await runHook(options.onFail, filePath, verdict);
 }
 
 // Run a list of files through processFile with bounded concurrency.