@mevdragon/vidfarm-devcli 0.2.9 → 0.2.11

package/SKILL.developer.md

@@ -144,16 +144,18 @@ This boundary matters because job results are saved in SQLite, returned by REST
 If the user gives you a media file, a screenshot, a folder of source assets, or a link to an original viral post and says some variant of "turn this into a template", you should default to this workflow:
 
 1. inspect the source media and extract the repeatable format
-2. scaffold a new template with `vidfarm-devcli generate-template`
-3. stage the source notes and preview media inside the template
-4. run `analyze-viral-dna`
-5. run `analyze-visual-dna`
+2. start the native harness workflow with `vidfarm-devcli autocreate-template <input_path> <output_path>`
+3. review the generated run folder, manifest, and `agent_prompt.md`
+4. generate the preservation decision, production graph, and template plan
+5. run or consume `analyze-viral-dna` and `analyze-visual-dna`
 6. implement the template operations and jobs
 7. wire prompt logic, provider usage, storage writes, and local Remotion output
 8. expose the template through the standard REST routes
 9. validate the template locally with `validate-template` plus at least one real job run
 10. update the template-local `SKILL.md` so future agents can operate it
 
+Use `generate-template` directly only when the developer already knows the template architecture and wants a plain starter scaffold. Use `autocreate-template` when source media needs to be analyzed into a reusable format.
+
 Do not stop after scaffolding. The expected outcome is a runnable template, not just a folder.
 
 If the user gives revision feedback in natural language, treat that as a normal template-authoring input, not as a vague suggestion. Example revision prompts:
@@ -491,6 +493,63 @@ Keep the identifiers separate:
 - `about.title` is the user-facing display title and should not be prefixed with `Vidfarm Template` unless that phrase is genuinely part of the brand or concept
 - avoid redundant titles like `Vidfarm Template UGC Hooks V1` when `UGC Hooks V1` is the actual display name
 
+### 3a. Use the native auto-create harness for media-to-template work
+
+When the developer says "autocreate a template based on media in `<input_path>` and output template to `<output_path>`", use:
+
+```bash
+npx @mevdragon/vidfarm-devcli autocreate-template <input_path> <output_path>
+```
+
+Alias:
+
+```bash
+npx @mevdragon/vidfarm-devcli autocreate <input_path> <output_path>
+```
+
+The command accepts either positional paths or explicit flags:
+
+```bash
+npx @mevdragon/vidfarm-devcli autocreate-template \
+  --input-path ./drafts/my_format \
+  --output-path ./templates/vidfarm_template_my_format \
+  --link-to-original "https://www.tiktok.com/@example/video/1234567890"
+```
+
+What this does:
+
+- creates `auto-create-templates/runs/<run_id>/`
+- stages source notes and preview media under `source/`
+- creates the standard analyzer artifact folders: `frames`, `audio`, `transcripts`, `ocr`, `motion`, `dna`, `extraction`, and `plan`
+- snapshots the current reusable harness files into `runs/<run_id>/harness/` for traceability
+- runs basic `ffprobe`/`ffmpeg` extraction when source video and local tools are available
+- scaffolds the output template with the same starter logic as `generate-template`
+- writes `manifest.json` and `agent_prompt.md` as the agent handoff
+
+Useful options:
+
+- `--run-id <id>`: choose the run folder name
+- `--slug-id <slug>`: override the slug derived from the output folder
+- `--template-id <uuid>`: pin the template UUID
+- `--skip-dna-analysis`: scaffold without calling Gemini DNA analysis
+- `--skip-media-probes`: skip local `ffprobe`/`ffmpeg` artifact generation
+- `--skip-scaffold`: create only the run artifacts and handoff prompt
+- `--harness-dir <path>`: use a local harness checkout other than `auto-create-templates/`
+- `--force`: replace an existing output template folder
+
+After running `autocreate-template`, continue the harness workflow instead of stopping at scaffold:
+
+1. inspect `auto-create-templates/runs/<run_id>/agent_prompt.md`
+2. create `dna/preservation_decision.json`
+3. create `extraction/production_graph.json` matching `production-graph.schema.json`
+4. create `plan/template_plan.json` matching `template-plan.schema.json`
+5. implement `src/template.ts`, metadata, prompts, operations, jobs, and template-local `SKILL.md`
+6. run `validate-template` and at least one real local job
+
+The reusable harness lives in `auto-create-templates/AUTO_CREATE_TEMPLATES.md`. It is intentionally included in the devcli package as editable source material. Future improvements to the harness should be made there; each auto-create run stores a snapshot of the harness files used for that run so older runs remain explainable.
+
+### 3b. Generate a plain starter template
+
 Example:
 
 ```bash
@@ -852,6 +911,23 @@ Required fields checklist:
 
 For TikTok-native captions, use the platform caption standard exposed by `vidfarm-devcli session` under `starter_style_options`.
 
+Check the currently installed CLI values with:
+
+```bash
+npx @mevdragon/vidfarm-devcli session
+```
+
+The current standard version is `2026-05-30`. The CLI response includes `caption_standard_version`, `fonts`, `text_background_colors`, `presets`, `package_dependencies`, the source standard file, and the starter template style file.
+
+Text background rendering rule:
+
+- any selected text background color must render as an inline highlight chip that hugs the text only
+- apply visible per-line padding around the glyph bounds; the background should feel intentional, not cramped
+- use slightly curved corners like TikTok's native text highlight shape
+- do not render full-width bars, paragraph washes, large caption panels, or loose boxes behind text
+- for multi-line captions, each line should get its own tight chip or a chip shape that follows the actual text block closely
+- support chip strength levels where practical: `subtle` for light editor-style chips, `standard` for normal TikTok color chips, and `strong` for high-contrast emphatic captions
+
 Canonical font IDs:
 
 - `tiktok_sans_semibold`: default native TikTok caption font, backed by `@fontsource/tiktok-sans` or the bundled `TikTokSans-SemiBold.ttf` starter asset
@@ -866,6 +942,21 @@ Legacy aliases remain accepted for older starters:
 - `montserrat` -> `montserrat_semibold`
 - `source_code_pro` -> `source_code_pro_bold`
 
+Font package dependencies exposed by the CLI:
+
+- `@fontsource/tiktok-sans`
+- `@fontsource/montserrat`
+- `@fontsource/source-code-pro`
+- `@fontsource/libre-baskerville`
+
+Bundled starter assets may also be available for template-local rendering:
+
+- `TikTokSans-SemiBold.ttf`
+- `Montserrat[wght].ttf`
+- `SourceCodePro[wght].ttf`
+- `Yesteryear-Regular.ttf`
+- `Abel-Regular.ttf`
+
 Canonical text background color IDs:
 
 - `black`: `#000000`
@@ -884,6 +975,12 @@ Canonical text background color IDs:
 - `light_gray`: `#92979E`
 - `dark_gray`: `#333333`
 
+Canonical style presets:
+
+- `tiktok_native_white`: TikTok Sans SemiBold, white fill, no color chip, native black shadow
+- `tiktok_native_chip`: TikTok Sans SemiBold, white fill, red default inline highlight chip, `standard` chip strength, native black shadow
+- `tiktok_editor_gray`: TikTok Sans SemiBold, dark fill, light gray default inline highlight chip, `subtle` chip strength, no shadow
+
 Templates that expose caption styling should use these IDs in `configSchema`, operation payloads, manifests, and docs instead of inventing local names or hardcoding unrelated font stacks. If a template intentionally uses a format-specific typography system, document the exception in the template-local `SKILL.md`.
 
 The caption standard is a default, not a hard lock. Templates may support `captionFont: "custom"` or template-specific text rendering when the user explicitly needs typography outside the standard. In that case, keep the standard options available, document the custom fields, and prefer bundled or template-local font assets over system fonts or remote Google Fonts URLs.

package/dist/src/cli.js

@@ -7,7 +7,7 @@ import path from "node:path";
 import { parseArgs } from "node:util";
 import { promisify } from "node:util";
 import dotenv from "dotenv";
-import { CAPTION_STANDARD_VERSION, STARTER_TEMPLATE_FONT_OPTIONS, STARTER_TEMPLATE_TEXT_BACKGROUND_COLOR_OPTIONS, TIKTOK_CAPTION_STYLE_PRESETS } from "./lib/template-style-options.js";
+import { CAPTION_STANDARD_VERSION, STARTER_TEMPLATE_FONT_OPTIONS, STARTER_TEMPLATE_TEXT_BACKGROUND_COLOR_OPTIONS, TIKTOK_CAPTION_STYLE_PRESETS, TIKTOK_TEXT_BACKGROUND_RENDERING } from "./lib/template-style-options.js";
 import { analyzeTemplateDna, hasTemplatePreviewMedia, stageTemplateDnaInputs, syncTemplateDnaModule } from "./lib/template-dna.js";
 import { assertTemplateFolderNameHasPrefix, defaultSkillPathForTemplateModule, deriveTemplateRootDirFromModulePath } from "./lib/template-paths.js";
 const execFileAsync = promisify(execFile);
@@ -857,6 +857,7 @@ async function runSessionCommand(argv) {
             caption_standard_version: CAPTION_STANDARD_VERSION,
             fonts: STARTER_TEMPLATE_FONT_OPTIONS,
             text_background_colors: STARTER_TEMPLATE_TEXT_BACKGROUND_COLOR_OPTIONS,
+            text_background_rendering: TIKTOK_TEXT_BACKGROUND_RENDERING,
             presets: TIKTOK_CAPTION_STYLE_PRESETS,
             package_dependencies: [
                 "@fontsource/tiktok-sans",

package/dist/src/lib/template-style-options.js

@@ -99,6 +99,38 @@ export const TIKTOK_TEXT_BACKGROUND_COLOR_OPTIONS = [
     { id: "dark_gray", label: "Dark Gray", hex: "#333333" }
 ];
 export const STARTER_TEMPLATE_TEXT_BACKGROUND_COLOR_OPTIONS = TIKTOK_TEXT_BACKGROUND_COLOR_OPTIONS;
+export const TIKTOK_TEXT_BACKGROUND_RENDERING = {
+    mode: "inline_highlight_chip",
+    rule: "Text background colors must render as inline highlight chips that hug the text only.",
+    padding: "Use visible per-line padding around glyph bounds; do not render full-width bars, paragraph washes, or loose caption boxes.",
+    shape: "Use slightly curved corners, similar to native TikTok text highlight chips.",
+    strengths: {
+        none: {
+            paddingX: 0,
+            paddingY: 0,
+            radius: 0,
+            opacity: 0
+        },
+        subtle: {
+            paddingX: 14,
+            paddingY: 8,
+            radius: 9,
+            opacity: 0.72
+        },
+        standard: {
+            paddingX: 20,
+            paddingY: 12,
+            radius: 12,
+            opacity: 0.86
+        },
+        strong: {
+            paddingX: 26,
+            paddingY: 14,
+            radius: 14,
+            opacity: 0.94
+        }
+    }
+};
 export const TIKTOK_CAPTION_STYLE_PRESETS = [
     {
         id: "tiktok_native_white",
@@ -114,6 +146,8 @@ export const TIKTOK_CAPTION_STYLE_PRESETS = [
         fontId: "tiktok_sans_semibold",
         fill: "#ffffff",
         defaultBackgroundColorId: "red",
+        backgroundRendering: "inline_highlight_chip",
+        chipStrength: "standard",
         shadow: "native_black_shadow"
     },
     {
@@ -122,6 +156,8 @@ export const TIKTOK_CAPTION_STYLE_PRESETS = [
         fontId: "tiktok_sans_semibold",
         fill: "#111111",
         defaultBackgroundColorId: "light_gray",
+        backgroundRendering: "inline_highlight_chip",
+        chipStrength: "subtle",
         shadow: "none"
     }
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mevdragon/vidfarm-devcli",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "Developer CLI for running the Vidfarm local template platform.",
   "type": "module",
   "bin": {