@officexapp/vidfarm-devcli 0.21.54 → 0.21.56

package/dist/src/cli.js

@@ -925,9 +925,18 @@ Local media engines & toolchain (all local, free, no account — no cloud key ne
                             "create me a harness" / "update the harness for
                             this format" / "give me the harness for this
                             template_id" all land here
-    harness list [--json]             Bundled starting points: short-form,
-                                      hooks, ugc-testimonial, explainer,
-                                      product-demo, product-explainer
+    harness list [--json]             Two shelves. BASES to copy and edit:
+                                      short-form, hooks, ugc-testimonial,
+                                      explainer, product-demo,
+                                      product-explainer. FORMAT harnesses —
+                                      complete contracts, read by name, same
+                                      shelf as vidfarm.cc/experimental:
+                                      meme-recaption, wall-text-pov-ugc,
+                                      ugc-reaction-greenscreen,
+                                      sticker-slideshow-tips,
+                                      animated-sticker-story,
+                                      google-news-to-video,
+                                      unique-product-explainers
     harness show <name|path>          Print one [--dna <strand>] to print just
                                       one strand (viral_dna, visual_dna, …)
     harness init <name> [--out <p>]   Copy one next to your work, then EDIT it
@@ -960,6 +969,20 @@ Local media engines & toolchain (all local, free, no account — no cloud key ne
     --kill-orphans           Reap orphaned local serve/preview servers
                             (running from a deleted package path) so their
                             squatted ports are reclaimed
+  --version (-v)            This devcli's version + the installed skill's   (local)
+  update-check              IS THIS INSTALL CURRENT? The skill and the      (npm registry + vidfarm.cc)
+                            devcli are ONE semver and must move together —
+                            updating one alone is the usual cause of "that
+                            command doesn't exist". Agents: run the --if-stale
+                            form at the top of a session; it is a no-op unless
+                            the last check is over 24h old, and --quiet prints
+                            NOTHING when you are already current.
+    --if-stale [--hours 24]  Only actually check if the last one is older
+    --quiet                  One line, silent when current
+    --skip / --unskip        Record "not now" for this version / undo it
+    --json                   {devcli, skill, update_available, offline, …}
+                            Offline is reported as offline, never as outdated.
+                            Breaking-change notes: https://vidfarm.cc/update.md
   skills <list|add <names…>|update>   Install/refresh agent skills into   → GET /skill-pack/* (or the
                             <root>/.agents/skills/<name> + a relative      copies bundled in this repo)
                             .claude/skills symlink; skills-lock.json is
@@ -1159,10 +1182,35 @@ Marketplace (paid, cloud-only — the bazaar never renders locally):
     (alias: dir · save-url|from-url|import-url — CLI twin of the "Save to Files" picker)
   gigs <sub>                Your vending machines, BOTH sides (client + gigworker)
     machines · tasks · add-task · proofs · approve · reject · ring-bell      (client, paid)
-    work · feed · join-feed · join · claim · submit · mine                   (gigworker, free — bring DOLLARPLATOON_API_KEY)
-    e.g. vidfarm gigs add-task --task "60s explainer for acme.com" --price 0.50 --upload-link <share url>
+    earn · feed · check · join · work · claim · submit · proof · earnings    (gigworker, free — bring DOLLARPLATOON_API_KEY)
+      upload · mine · join-feed
+    "HELP ME EARN ON VIDFARM" IS ONE COMMAND: vidfarm gigs earn. It joins the
+    feed, reads who is asking for videos right now, checks every one of those
+    machines for MONEY, and ranks them best-payer-first with the join command.
+    'gigs check <gig|join-url>' is the funds check on its own — run it BEFORE you
+    spend an hour, because approval does not create money. 'gigs submit
+    --clean-master <file>' seals the unwatermarked cut in the proof's private
+    note, which the buyer cannot open until a rollup has actually paid you.
+    e.g. vidfarm gigs earn
+         vidfarm gigs add-task --task "60s explainer for acme.com" --price 0.50 --upload-link <share url>
          vidfarm gigs proofs --status pending   ·   vidfarm gigs approve PRF_01H…
-    (see: vidfarm gigs help)
+    (see: vidfarm gigs help · the loop: vidfarm.cc/agentic-clipper.md)
+  clipper-run <sub>         HOW the clipper loop runs, and WHERE each task is up to
+    mode · init · start · shortlist · pick · plan · raws · cut · gate · submitted
+    approve · changes · drop        (the gigworker's answers)
+    next · status · review          (where am I / what is waiting on the human)
+    Four run modes, differing only in which stages STOP for the gigworker:
+      full-interactive   shortlist · plan · raws · cut   (best quality on a weak model)
+      quick-interactive  shortlist · cut                 (approve ONE template, then watch the cut)
+      auto-batch         cut                             (build everything, submit nothing until reviewed)
+      auto-submit        nothing                         (unattended; opt-in, in the gigworker's own words)
+    The stage lives in files under ./CLIPPER, not in the context — that is what
+    lets a weak model run a long task without forgetting where it was. 'gate'
+    exits non-zero while a human gate is open, so a loop written as
+    'clipper-run gate <task> && gigs submit …' cannot send an unreviewed cut.
+    e.g. vidfarm clipper-run mode quick-interactive
+         vidfarm clipper-run next
+    (see: vidfarm clipper-run help)
   shared <sub> <link>       USE a link someone shared with you — NO account, NO API key
     info · ls --tree · search · grab · note · mkdir · put · get
     grab is the one to reach for: it finds footage by MEANING and downloads it in one step.
@@ -1302,6 +1350,19 @@ async function main() {
         process.stdout.write(HELP);
         return;
     }
+    // `vidfarm --version` is the first line of the update runbook and of every
+    // "what are you running?" support exchange, and it used to error out with
+    // "Unknown option before command". Handled before dispatch so no subcommand
+    // can shadow it.
+    if (argv[0] === "--version" || argv[0] === "-v" || argv[0] === "version") {
+        const { installedDevcliVersion, installedSkillPath, readSkillVersion } = await import("./devcli/update-check.js");
+        const skillPath = installedSkillPath();
+        const skillVersion = skillPath ? readSkillVersion(readFileSync(skillPath, "utf8")) : null;
+        console.log(installedDevcliVersion() ?? "unknown");
+        console.log(`skill ${skillVersion ?? "not installed"}${skillPath ? ` (${skillPath})` : ""}`);
+        console.log("check for updates: vidfarm update-check");
+        return;
+    }
     const command = argv[0];
     // Opt-out crash telemetry (also covers the long-lived `serve` runtime, whose
     // in-process job/render captures share this client). Guarded + no-op by default.
@@ -1621,6 +1682,16 @@ async function main() {
             await runGigsCommand(rest);
             return;
         }
+        // The RUN MODE of an agentic clipper loop — how much of the gigworker's
+        // attention each task costs — plus the per-task stage that survives a
+        // context reset. Local files only; no key, no network.
+        case "clipper-run":
+        case "clipper-mode":
+        case "run-mode": {
+            const { runClipperRunCommand } = await import("./devcli/clipper-run.js");
+            await runClipperRunCommand(rest);
+            return;
+        }
         case "get-file":
             await runGetFileCommand(rest);
             return;
@@ -1761,6 +1832,13 @@ async function main() {
         case "hf":
             await runHyperframesPassthroughCommand(rest);
             return;
+        case "update-check":
+        case "check-update":
+        case "outdated": {
+            const { runUpdateCheckCommand } = await import("./devcli/update-check.js");
+            await runUpdateCheckCommand(rest);
+            return;
+        }
         default:
             if (!command.startsWith("-")) {
                 // Positional template id → default to booting the local editor.
@@ -12344,13 +12422,28 @@ async function runHarnessCommand(argv) {
     });
     const json = Boolean(parsed.values.json);
     if (!sub || sub === "list") {
-        const builtins = listBuiltinHarnesses();
-        if (json)
-            return printJson({ harnesses: builtins.map(({ name, path: file, video_type }) => ({ name, path: file, video_type })) });
-        console.log(`${DIM}Built-in harnesses — copy one next to your work, then edit it:${RESET}`);
-        for (const entry of builtins) {
+        const all = listBuiltinHarnesses();
+        if (json) {
+            return printJson({
+                harnesses: all.map(({ name, path: file, video_type, origin, url }) => ({ name, path: file, video_type, origin, url })),
+                index_url: "https://vidfarm.cc/experimental"
+            });
+        }
+        const bases = all.filter((entry) => entry.origin === "builtin");
+        const experimental = all.filter((entry) => entry.origin === "experimental");
+        console.log(`${DIM}Base harnesses — copy one next to your work, then edit it:${RESET}`);
+        for (const entry of bases) {
             console.log(`  ${GREEN}${entry.name}${RESET} ${DIM}${entry.video_type ?? ""}${RESET}`);
         }
+        if (experimental.length) {
+            // The same shelf as https://vidfarm.cc/experimental, shipped in the package
+            // so an agent reads a full format contract by name without a fetch.
+            console.log(`\n${DIM}Format harnesses — complete contracts for ONE format. Read one before you build it:${RESET}`);
+            for (const entry of experimental) {
+                console.log(`  ${GREEN}${entry.name}${RESET} ${DIM}${(entry.video_type ?? "").slice(0, 120)}${RESET}`);
+            }
+            console.log(`${DIM}vidfarm harness show <name>              (also live at https://vidfarm.cc/experimental)${RESET}`);
+        }
         console.log(`\n${DIM}vidfarm harness init <name> --out ./work/${HARNESS_FILENAME}${RESET}`);
         console.log(`${DIM}vidfarm harness derive <forkId>          (a decomposed template → a harness)${RESET}`);
         console.log(`${DIM}vidfarm qa ./work --harness <name|path>  (repeatable — harnesses stack)${RESET}`);