@mevdragon/vidfarm-devcli 0.4.0 → 0.4.1

package/dist/src/cli.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 import { createWriteStream, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
 import { parseArgs } from "node:util";
 import { spawnSync } from "node:child_process";
 import { Readable } from "node:stream";
@@ -11,6 +13,12 @@ import { pipeline } from "node:stream/promises";
 // starts a local dev-serve, and prints the editor URL to open in the browser.
 const DEFAULT_HOST = "https://vidfarm.cc";
 const DEFAULT_PORT = 4321;
+// Agent skill files the `update-skill` command can install from the live host
+// (`GET /skill/<name>`), falling back to the copy bundled in this npm package.
+const SKILL_TARGETS = {
+    "vidfarm-director": { route: "/skill/vidfarm-director", bundled: "SKILL.director.md" },
+    "vidfarm-platform": { route: "/skill/vidfarm-platform", bundled: "SKILL.platform.md" }
+};
 // Every command below is a thin wrapper over ONE Vidfarm REST call (the `→`
 // line documents the exact route). The devcli adds nothing the raw API can't
 // do — it just resolves your fork, sets the `vidfarm-api-key` header, prints
@@ -66,6 +74,13 @@ Account:
   provider-keys             List saved AI provider keys                  → GET  /api/v1/user/me/provider-keys
   add-provider-key <provider> <secret>   Save an AI provider key         → POST /api/v1/user/me/provider-keys
 
+Agent skill (install the latest director skill so your AI agent can act):
+  update-skill              Fetch latest SKILL.director.md → .claude/skills  → GET /skill/vidfarm-director
+    --global                Install into ~/.claude/skills (default: ./.claude/skills)
+    --dir <path>            Install into a custom skills root
+    --platform              Also install SKILL.platform.md (vidfarm-platform)
+    --print                 Print the skill to stdout instead of writing a file
+
 Files (multi-step flows the devcli handles for you):
   upload <file>             Upload a local file, print its durable URL   → POST /api/v1/user/me/temporary-files/upload
   download <url> [dest]     Stream any Vidfarm/media URL to disk
@@ -188,6 +203,10 @@ async function main() {
         case "whoami":
             await runWhoamiCommand(rest);
             return;
+        case "update-skill":
+        case "skill":
+            await runUpdateSkillCommand(rest);
+            return;
         case "provider-keys":
             await runProviderKeysCommand(rest);
             return;
@@ -1297,4 +1316,89 @@ async function runDownloadCommand(argv) {
         console.log(`${GREEN}Downloaded ${formatBytes(bytes)} → ${dest}${RESET}`);
     }
 }
+// ── Agent skill ───────────────────────────────────────────────────────────────
+// Install the latest director skill onto disk as a Claude Code / agent skill so
+// the user's AI agent can read SKILL.director.md and act. We pull the freshest
+// copy from the live host (`GET /skill/<name>`) and fall back to the copy that
+// shipped inside this npm package when offline. Written as `<skill>/SKILL.md`.
+// Walk up from this module's directory to find a bundled skill file. Handles
+// both the published layout (dist/src/cli.js → package root) and running from
+// source (src/cli.ts → repo root).
+function locateBundledSkill(filename) {
+    let dir = path.dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 6; i += 1) {
+        const candidate = path.join(dir, filename);
+        if (existsSync(candidate))
+            return candidate;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+async function fetchSkillContents(host, target) {
+    try {
+        const res = await fetch(new URL(target.route, host));
+        if (res.ok) {
+            const contents = await res.text();
+            if (contents.trim())
+                return { contents, source: "remote" };
+        }
+    }
+    catch {
+        // fall through to the bundled copy below
+    }
+    const bundledPath = locateBundledSkill(target.bundled);
+    if (bundledPath) {
+        return { contents: readFileSync(bundledPath, "utf8"), source: "bundled" };
+    }
+    throw new Error(`Could not fetch ${target.bundled} from ${host} and no bundled copy was found.`);
+}
+async function runUpdateSkillCommand(argv) {
+    const parsed = parseArgs({
+        args: argv,
+        allowPositionals: false,
+        options: {
+            ...commonOptions(),
+            global: { type: "boolean", default: false },
+            dir: { type: "string" },
+            platform: { type: "boolean", default: false },
+            print: { type: "boolean", default: false }
+        }
+    });
+    const ctx = commonContext(parsed.values);
+    const skillNames = ["vidfarm-director", ...(parsed.values.platform ? ["vidfarm-platform"] : [])];
+    if (parsed.values.print) {
+        for (const name of skillNames) {
+            const { contents } = await fetchSkillContents(ctx.host, SKILL_TARGETS[name]);
+            process.stdout.write(contents.endsWith("\n") ? contents : `${contents}\n`);
+        }
+        return;
+    }
+    const skillsRoot = parsed.values.dir
+        ? path.resolve(process.cwd(), String(parsed.values.dir))
+        : parsed.values.global
+            ? path.join(homedir(), ".claude", "skills")
+            : path.resolve(process.cwd(), ".claude", "skills");
+    const written = [];
+    for (const name of skillNames) {
+        const { contents, source } = await fetchSkillContents(ctx.host, SKILL_TARGETS[name]);
+        const destDir = path.join(skillsRoot, name);
+        mkdirSync(destDir, { recursive: true });
+        const destPath = path.join(destDir, "SKILL.md");
+        writeFileSync(destPath, contents, "utf8");
+        written.push({ skill: name, path: destPath, source, bytes: Buffer.byteLength(contents, "utf8") });
+    }
+    if (ctx.json) {
+        printJson({ ok: true, skillsRoot, installed: written });
+        return;
+    }
+    for (const entry of written) {
+        const tag = entry.source === "bundled" ? " (offline — bundled copy)" : "";
+        console.log(`${GREEN}Installed ${entry.skill} skill${tag} → ${entry.path}${RESET}`);
+    }
+    console.log("");
+    console.log(`  ${BOLD}Your AI agent can now use the "vidfarm-director" skill.${RESET}`);
+}
 //# sourceMappingURL=cli.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mevdragon/vidfarm-devcli",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Local bridge for the Vidfarm Trackpad Editor. Point it at a template id, edit composition.html on disk (Claude Code, Codex, etc.), preview live in the browser at https://vidfarm.cc/editor/.",
   "type": "module",
   "bin": {