@mevdragon/vidfarm-devcli 0.2.0 → 0.2.2

package/dist/src/account-pages.js

@@ -220,6 +220,40 @@ function shell(input) {
         color: var(--muted);
         background: rgba(255,255,255,0.7);
       }
+      .status-row {
+        display: flex;
+        flex-wrap: wrap;
+        gap: 10px;
+        align-items: center;
+      }
+      .status-pill {
+        display: inline-flex;
+        align-items: center;
+        gap: 8px;
+        padding: 8px 12px;
+        border: 1px solid var(--line);
+        background: rgba(255,255,255,0.78);
+        color: var(--ink);
+        letter-spacing: 0.08em;
+        text-transform: uppercase;
+        font-size: 12px;
+      }
+      .status-pill::before {
+        content: "";
+        width: 9px;
+        height: 9px;
+        border-radius: 999px;
+        background: #7a6d61;
+      }
+      .status-pill.is-active::before {
+        background: var(--accent);
+        box-shadow: 0 0 0 4px rgba(159, 61, 36, 0.12);
+      }
+      .developer-panel {
+        background:
+          linear-gradient(135deg, rgba(159, 61, 36, 0.11), rgba(255,255,255,0.68)),
+          rgba(255,255,255,0.62);
+      }
       .key-list, .attachment-list {
         display: grid;
         gap: 12px;
@@ -402,6 +436,21 @@ export function renderSettingsPage(input) {
                   data-copy-content='${escapeAttribute(input.developerSkill)}'
                   data-copy-label="Developer SKILL.md"
                 >Developer SKILL.md</button>
+  ` : "";
+    const developerPanel = input.isDeveloper ? `
+          <section class="settings-panel developer-panel">
+            <div class="card-head">
+              <div>
+                <div class="pill">Developer Access</div>
+                <h2>Template developer tools are enabled</h2>
+              </div>
+              <div class="status-pill is-active">Developer</div>
+            </div>
+            <p class="helper">This account can submit template sources and use the developer workflow. The <code>Developer SKILL.md</code> prompt is available here for fast copy into your agent tooling.</p>
+            <div class="toolbar">
+              ${developerSkillButton}
+            </div>
+          </section>
   ` : "";
     return shell({
         title: "Settings",
@@ -423,7 +472,10 @@ export function renderSettingsPage(input) {
                 <div class="pill">Profile</div>
                 <h2>Workspace identity</h2>
               </div>
-              <div class="tiny">${input.isPaidPlan ? "Paid plan" : "Inactive plan"}</div>
+              <div class="status-row">
+                <div class="status-pill ${input.isPaidPlan ? "is-active" : ""}">${input.isPaidPlan ? "Paid plan" : "Inactive plan"}</div>
+                <div class="status-pill ${input.isDeveloper ? "is-active" : ""}">${input.isDeveloper ? "Developer" : "Standard"}</div>
+              </div>
             </div>
             <form method="post" action="/settings/profile">
               <label for="settings-email">Email</label>
@@ -440,10 +492,11 @@ export function renderSettingsPage(input) {
               </div>
             </form>
           </section>
+          ${developerPanel}
           <section class="settings-panel">
             <div class="pill">Vidfarm API</div>
-            <h2>Your control-plane key</h2>
-            <p class="helper">Use this key with the <code>vidfarm-user-id</code> header pair when calling the API directly.</p>
+            <h2>Your Vidfarm API key</h2>
+            <p class="helper">Use this key with the <code>vidfarm-user-id</code> header pair when calling the Vidfarm API directly.</p>
             <label for="vidfarm-api-key">Current API key</label>
             <div class="secret-wrap">
               <input id="vidfarm-api-key" type="password" value="${escapeHtml(input.vidfarmApiKey)}" readonly />
@@ -457,7 +510,6 @@ export function renderSettingsPage(input) {
                 data-copy-content='${escapeAttribute(input.directorSkill)}'
                 data-copy-label="Director SKILL.md"
               >Director SKILL.md</button>
-              ${developerSkillButton}
             </div>
           </section>
           <section class="settings-panel">
@@ -506,7 +558,7 @@ export function renderSettingsPage(input) {
           <section class="settings-panel">
             <div class="pill">Attachments</div>
             <h2>Shared files</h2>
-            <p class="helper">Uploads are stored under your <code>user/*</code> storage path and can be opened via public read URLs.</p>
+            <p class="helper">Uploads are stored under your <code>user/&lt;user_id&gt;/*</code> namespace and can be opened via public read URLs.</p>
             <form method="post" action="/settings/attachments" enctype="multipart/form-data">
               <label for="settings-files">Images, video, audio, PDF, Markdown, or text</label>
               <input id="settings-files" type="file" name="files" multiple accept="image/*,video/*,audio/*,.pdf,.md,.txt,text/markdown,text/plain,application/pdf" />

package/dist/src/app.js

@@ -70,6 +70,17 @@ const listJobsQuerySchema = z.object({
 function getLoginMode(value) {
     return value === "password" ? "password" : "otp";
 }
+function readRootSkillFile(...filenames) {
+    for (const filename of filenames) {
+        try {
+            return readFileSync(path.resolve(filename), "utf8");
+        }
+        catch {
+            continue;
+        }
+    }
+    return "";
+}
 const allowedAttachmentExtensions = new Set([
     ".png", ".jpg", ".jpeg", ".gif", ".webp", ".svg",
     ".mp4", ".mov", ".webm", ".m4v",
@@ -361,23 +372,9 @@ app.get("/settings", (c) => {
     if (!customer) {
         return redirect(c, "/login");
     }
-    const directorSkill = (() => {
-        try {
-            return readFileSync(path.resolve("SKILL.user.md"), "utf8");
-        }
-        catch {
-            return "";
-        }
-    })();
+    const directorSkill = readRootSkillFile("SKILL.director.md", "SKILL.user.md");
     const developerSkill = customer.isDeveloper
-        ? (() => {
-            try {
-                return readFileSync(path.resolve("SKILL.developer.md"), "utf8");
-            }
-            catch {
-                return null;
-            }
-        })()
+        ? readRootSkillFile("SKILL.developer.md") || null
         : null;
     return c.html(renderSettingsPage({
         notice: c.req.query("notice") ?? null,
@@ -476,7 +473,7 @@ app.post("/settings/attachments", async (c) => {
             const arrayBuffer = await file.arrayBuffer();
             const buffer = Buffer.from(arrayBuffer);
             const attachmentId = createId("att");
-            const storageKey = `user/${customer.id}/attachments/${attachmentId}/${fileName}`;
+            const storageKey = storage.userAttachmentKey(customer.id, attachmentId, fileName);
             const stored = await storage.putBuffer(storageKey, buffer, contentType, { publicRead: true });
             database.createUserAttachment({
                 id: attachmentId,
@@ -610,14 +607,17 @@ function buildAbsoluteUrl(c, pathname) {
 }
 function resolveTemplateAboutStorageKey(templateId, entry) {
     const normalizedEntry = entry.replace(/^\/+/, "");
+    const templateAboutPrefix = storage.templateAboutKey(templateId, "");
     if (!/^https?:\/\//i.test(entry)) {
-        const templateAboutPrefix = `templates/${templateId}/about/`;
+        if (normalizedEntry.startsWith("templates/")) {
+            return normalizedEntry;
+        }
         if (normalizedEntry.startsWith(templateAboutPrefix)) {
             return normalizedEntry;
         }
         return normalizedEntry.startsWith("about/")
-            ? `templates/${templateId}/${normalizedEntry}`
-            : `templates/${templateId}/about/${normalizedEntry}`;
+            ? joinStoragePath("templates", templateId, normalizedEntry)
+            : storage.templateAboutKey(templateId, normalizedEntry);
     }
     try {
         const url = new URL(entry);
@@ -657,7 +657,7 @@ async function serveTemplateAboutAsset(c, templateId, assetPath) {
     if (!normalizedAssetPath) {
         return c.json({ error: "Template about asset path is required" }, 400);
     }
-    const key = `templates/${template.id}/about/${normalizedAssetPath}`;
+    const key = storage.templateAboutKey(template.id, normalizedAssetPath);
     const readUrl = await storage.getReadUrl(key);
     if (config.STORAGE_DRIVER === "s3" && readUrl) {
         return c.redirect(readUrl, 302);
@@ -742,7 +742,10 @@ function resolveTemplateAboutMediaUrl(c, templateId, entry) {
         return entry;
     }
     const normalizedEntry = entry.replace(/^\/+/, "");
-    const templateAboutPrefix = `templates/${templateId}/about/`;
+    if (normalizedEntry.startsWith("templates/")) {
+        return buildAbsoluteUrl(c, `/template-media?key=${encodeURIComponent(normalizedEntry)}`);
+    }
+    const templateAboutPrefix = storage.templateAboutKey(templateId, "");
     const aboutPath = normalizedEntry.startsWith(templateAboutPrefix)
         ? `about/${normalizedEntry.slice(templateAboutPrefix.length)}`
         : normalizedEntry.startsWith("about/")
@@ -750,6 +753,13 @@ function resolveTemplateAboutMediaUrl(c, templateId, entry) {
             : `about/${normalizedEntry}`;
     return buildAbsoluteUrl(c, `${TEMPLATES_PREFIX}/${templateId}/${aboutPath}`);
 }
+function joinStoragePath(...parts) {
+    return parts
+        .flatMap((part) => part.split("/"))
+        .map((part) => part.trim())
+        .filter(Boolean)
+        .join("/");
+}
 app.get(TEMPLATES_PREFIX, (c) => c.json({
     templates: templateRegistry.list().map((template) => ({
         ...serializeTemplate(c, template),

package/dist/src/config.js

@@ -26,7 +26,7 @@ const schema = z.object({
     AWS_SECRET_ACCESS_KEY: z.string().optional(),
     PUBLIC_BASE_URL: z.string().optional(),
     RESEND_API_KEY: z.string().optional(),
-    RESEND_FROM_EMAIL: z.string().default("noreply@example.com"),
+    RESEND_FROM_EMAIL: z.string().default("vidfarm@fwd.zoomgtm.com"),
     OPENAI_API_KEY: z.string().optional(),
     OPENROUTER_API_KEY: z.string().optional(),
     GEMINI_API_KEY: z.string().optional(),

package/dist/src/context.js

@@ -3,7 +3,7 @@ import { database } from "./db.js";
 import { createId } from "./lib/ids.js";
 export function createTemplateJobContext(input) {
     const templateConfig = database.getTemplateConfig(input.customer.id, input.template.id);
-    const prefix = `templates/${input.template.id}/users/${input.customer.id}/jobs/${input.job.id}`;
+    const prefix = input.storage.templateJobPrefix(input.template.id, input.customer.id, input.job.id);
     return {
         env: config.isProduction ? "production" : "development",
         customer: input.customer,

package/dist/src/services/storage.js

@@ -14,6 +14,21 @@ export class StorageService {
     constructor() {
         mkdirSync(this.localRoot, { recursive: true });
     }
+    userAttachmentKey(customerId, attachmentId, fileName) {
+        return joinStorageKey("user", customerId, "attachments", attachmentId, fileName);
+    }
+    developerAttachmentKey(customerId, attachmentId, fileName) {
+        return joinStorageKey("developer", customerId, "attachments", attachmentId, fileName);
+    }
+    templateJobPrefix(templateId, customerId, jobId) {
+        return joinStorageKey("templates", templateId, "users", customerId, "jobs", jobId);
+    }
+    templateJobKey(templateId, customerId, jobId, key) {
+        return joinStorageKey(this.templateJobPrefix(templateId, customerId, jobId), key);
+    }
+    templateAboutKey(templateId, assetPath) {
+        return joinStorageKey("templates", templateId, "about", assetPath);
+    }
     async putJson(key, value, options) {
         const body = JSON.stringify(value, null, 2);
         return this.putBuffer(key, Buffer.from(body, "utf8"), "application/json", options);
@@ -86,6 +101,13 @@ export class StorageService {
         return this.getPublicUrl(key);
     }
 }
+function joinStorageKey(...parts) {
+    return parts
+        .flatMap((part) => part.split("/"))
+        .map((part) => part.trim())
+        .filter(Boolean)
+        .join("/");
+}
 function inferContentType(filePath) {
     switch (path.extname(filePath).toLowerCase()) {
         case ".json":

package/dist/templates/template_0000/src/template.js

@@ -11,7 +11,7 @@ const TEMPLATE_ID = "4c7a7e1a-7f35-4f30-9f86-9c8a63c7f2db";
 const TEMPLATE_SLUG_ID = "template_0000";
 const COMPOSITION_ID = "template-0000";
 const TEMPLATE_PREVIEW_MEDIA = [
-    "https://vidfarmprodstack-vidfarmbucket335ee12f-0vsvtd5earqy.s3.us-east-1.amazonaws.com/templates/template-0000/about/preview-01.jpg",
+    "templates/template-0000/about/preview-01.jpg",
 ];
 const FRAME = { width: 1080, height: 1920 };
 const TIKTOK_SAFE_AREA = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mevdragon/vidfarm-devcli",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Developer CLI for running the Vidfarm local template platform.",
   "type": "module",
   "bin": {
@@ -8,12 +8,12 @@
     "vidfarm-devcli": "dist/src/cli.js"
   },
   "files": [
-    "dist",
+    "dist/src",
+    "dist/templates/template_0000",
     "templates/template_0000",
     "README.md",
     "SKILL.developer.md",
-    "PLATFORM_SPEC.md",
-    "AWS_REMOTION_HANDOFF.md",
+    "GETTING_STARTED.developers.md",
     ".env.example"
   ],
   "publishConfig": {

package/templates/template_0000/README.md

@@ -2,12 +2,11 @@
 
 Standalone GitHub-distributable package for the Vidfarm `template_0000` starter template.
 
-This package exists for two operational reasons:
+This package exists to give third-party developers a concrete example of the Vidfarm template contract.
 
-- keep the template code in its own private GitHub repo for manual admin review/import
-- preserve the exact checked-in config and build shape the release admin will later promote to shared Remotion AWS and the production Docker image
+Developers should treat this repo as an authoring and review unit.
 
-Developers should treat this repo as an authoring and review unit, not as an authorized deployment unit.
+When a template is ready, it is handed off for Vidfarm admin review and approval before it becomes available on the hosted platform.
 
 Every new template should keep its source-format research checked in:
 
@@ -15,33 +14,21 @@ Every new template should keep its source-format research checked in:
 - `research/preview/` for the screenshots or source video the DNA analyzers inspect
 - `src/template-dna.ts` for the generated viral and visual DNA that feed the published template metadata
 
-The production release flow is:
-
-1. developer pushes template code to GitHub
-2. admin reviews the repo and selects a commit from `production`
-3. admin publishes the approved Remotion site bundle to shared AWS
-4. admin imports and activates the approved commit in Vidfarm
-5. admin rebuilds and redeploys the production Docker image
-
-Template authors do not publish directly to shared Remotion Lambda and do not directly promote templates into production Docker.
-
 Production integration settings are checked into `template.config.json`. AI agents and developers should treat that file as the source of truth for:
 
 - project identity
 - `template_id` as the self-issued UUIDv4 platform identifier
 - `slug_id` as the human-readable stable slug
-- GitHub repo target
-- production source branch
-- Remotion region/function/bucket/site/composition settings
-- release control expectations for admin promotion
+- the template module path
+- the local Remotion composition settings used by the starter template
 
 ## Included
 
 - `SKILL.md` for customer AI-agent usage
 - `src/template.ts` for the Vidfarm platform contract
-- `src/remotion/*` for local and cloud video rendering
+- `src/remotion/*` for local video rendering
 - `src/lib/images.ts` for non-cropping portrait normalization
-- `composition.json` sample props for cloud render smoke tests
+- `composition.json` sample props for local render tests
 
 ## Template behavior
 
@@ -87,35 +74,3 @@ vidfarm analyze-visual-dna --template-dir .
 ```
 
 If you scaffold a template with `vidfarm generate-template` and provide `--source-preview-dir`, the CLI will run both analyzers automatically unless `--skip-dna-analysis` is set.
-
-## Shared Remotion AWS
-
-Expected shared infra:
-
-- region: stored in `template.config.json`
-- function: stored in `template.config.json`
-- bucket: stored in `template.config.json`
-
-The only runtime secrets expected from the execution environment are AWS credentials. The production Remotion topology is intentionally checked into `template.config.json`, not spread across `.env` values.
-
-These shared-AWS operations are release-admin tasks. Template developers should not run them against the shared production AWS account.
-
-Release admin create-site:
-
-```bash
-npm run admin:create-site
-```
-
-Release admin cloud render smoke test:
-
-```bash
-npm run admin:render:cloud
-```
-
-Release admin cloud render from a real stage-1 manifest:
-
-```bash
-npm run admin:render:cloud -- --manifest /abs/path/to/template-0000.json
-```
-
-Use the manifest mode when you want the cloud render verification to include the actual composited slide frames with text overlays, not just the static sample props.

package/templates/template_0000/SKILL.md

@@ -5,8 +5,8 @@ Use this template when the customer wants a fast vertical slideshow for TikTok-s
 Operational rule:
 
 - template developers author and test this template locally
-- only the release admin publishes the approved Remotion site bundle to shared AWS
-- only the release admin promotes the approved template into production Docker
+- the hosted platform later runs the approved template behind the standard Vidfarm API wrapper
+- a Vidfarm admin reviews and approves the template before it is made available in production
 
 Inputs:
 
@@ -51,7 +51,7 @@ Allowed text background colors:
 - `light_gray`
 - `dark_gray`
 
-REST API routes for this template:
+Typical routes for this template:
 
 - `GET /templates/template_0000`
 - `GET /templates/template_0000/skill`

package/templates/template_0000/package.json

@@ -2,19 +2,16 @@
   "name": "vidfarm_template_0000",
   "version": "1.0.0",
   "private": true,
-  "description": "Standalone Vidfarm template_0000 project for authoring, admin review, and controlled production promotion.",
+  "description": "Standalone Vidfarm template_0000 starter project for local template authoring.",
   "type": "module",
   "scripts": {
     "check": "tsc -p tsconfig.json --noEmit",
     "build": "tsc -p tsconfig.json",
-    "studio": "remotion studio src/remotion/index.tsx",
-    "admin:create-site": "node ./scripts/create-site.mjs",
-    "admin:render:cloud": "node ./scripts/render-cloud.mjs"
+    "studio": "remotion studio src/remotion/index.tsx"
   },
   "dependencies": {
     "@remotion/bundler": "4.0.355",
     "@remotion/cli": "4.0.355",
-    "@remotion/lambda": "4.0.355",
     "@remotion/renderer": "4.0.355",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
@@ -22,6 +19,7 @@
     "sharp": "^0.34.2"
   },
   "devDependencies": {
+    "@mevdragon/vidfarm-devcli": "^0.2.2",
     "@types/node": "^24.0.1",
     "@types/react": "^18.3.23",
     "@types/react-dom": "^18.3.7",