@doubledigit/cli 0.6.0 → 0.7.0

package/README.md

@@ -125,6 +125,14 @@ Remotion Hub `init` is handled locally by the CLI because it creates files on th
 
 By default, Remotion Hub `init` creates Remotion's Hello World starter so `remotion studio` opens with a visible composition. Pass `--skip-remotion-create` or `--hub-only` only when adding Remotion Hub files to an existing Remotion project.
 
+After init, install Remotion AI coding skills when you want editor or agent guidance for Remotion work:
+
+```bash
+npx skills add remotion-dev/skills
+```
+
+Pass `--skip-skills` to omit that next-step reminder from CLI output. `--non-interactive` is accepted for automation scripts; the command is already prompt-free.
+
 When no `--registry`, `--url`, or `--app-url` is passed, Remotion Hub init writes a registry URL from exported `DD_APP_URL`, `APP_URL`, `NEXT_PUBLIC_APP_URL`, or `BETTER_AUTH_URL`; then the release-configured hosted app URL; then `http://localhost:3111` for local development builds.
 
 For HTTP-backed actions, the command resolves the app URL from exported `DD_APP_URL`, `APP_URL`, or `BETTER_AUTH_URL`; then local env-file `DD_APP_URL`; then the release-configured hosted app URL. It prints JSON responses to stdout. It also reads `.env`, `.env.local`, `apps/main-app/.env`, and `apps/main-app/.env.local`; exported shell values take precedence.

package/dist/commands/actions.d.ts

@@ -4,6 +4,8 @@ export declare function getActionPositionals(args: string[]): {
     index: number;
 }[];
 export declare function isRemotionHubInitAction(args: string[]): boolean;
+export declare function isRemotionHubAddAction(args: string[]): boolean;
 export declare function buildRemotionHubInitCommandArgs(args: string[]): string[];
+export declare function buildRemotionHubAddCommandArgs(args: string[]): string[];
 export declare function actions(args: string[]): Promise<void>;
 //# sourceMappingURL=actions.d.ts.map

package/dist/commands/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/commands/actions.ts"],"names":[],"mappings":"AAkCA,wBAAgB,uBAAuB,WAKtC;AAgED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE;WACf,MAAM;WAAS,MAAM;IAuBxD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,WAGrD;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,YAI7D;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B3D"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/commands/actions.ts"],"names":[],"mappings":"AAmCA,wBAAgB,uBAAuB,WAKtC;AAkED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE;WACf,MAAM;WAAS,MAAM;IAuBxD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,WAGrD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,WAGpD;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,YAI7D;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,EAAE,YAI5D;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC3D"}

package/dist/commands/actions.js

@@ -5,6 +5,7 @@ import { buildActionRequest, fetchActionRequest, isLocalAppUrl, parseActionsArgs
 import { DEFAULT_APP_URL, readEnvFile } from '../lib/onboarding.js';
 import { resolveWorkspacePaths } from '../paths.js';
 import { scanWorkspace } from '../scanner.js';
+import { runRemotionHubAddCommand } from './remotion-hub-add.js';
 import { runRemotionHubInitCommand } from './remotion-hub-init.js';
 const actionValueOptions = new Set([
     '--app-url',
@@ -49,7 +50,9 @@ Options:
 
 Examples:
   dd actions remotion-hub
-  dd actions remotion-hub init my-video --registry https://double-digit.example
+  dd actions remotion-hub init my-video --non-interactive
+  dd actions remotion-hub init my-video --skip-skills
+  dd actions remotion-hub add terminal-scene --dir my-video
   dd actions remotion-hub search-components --query "animated chart" --limit 5
   dd actions remotion-hub get-component --namespace doubledigit --slug motion-strip
   dd actions remotion-hub get-registry-payload --json '{"namespace":"doubledigit","slug":"motion-strip"}'
@@ -115,16 +118,29 @@ export function isRemotionHubInitAction(args) {
     const positionals = getActionPositionals(args);
     return positionals[0]?.value === 'remotion-hub' && positionals[1]?.value === 'init';
 }
+export function isRemotionHubAddAction(args) {
+    const positionals = getActionPositionals(args);
+    return positionals[0]?.value === 'remotion-hub' && positionals[1]?.value === 'add';
+}
 export function buildRemotionHubInitCommandArgs(args) {
     const positionals = getActionPositionals(args);
     const dropIndexes = new Set([positionals[0]?.index, positionals[1]?.index]);
     return args.filter((_, index) => !dropIndexes.has(index));
 }
+export function buildRemotionHubAddCommandArgs(args) {
+    const positionals = getActionPositionals(args);
+    const dropIndexes = new Set([positionals[0]?.index, positionals[1]?.index]);
+    return args.filter((_, index) => !dropIndexes.has(index));
+}
 export async function actions(args) {
     if (isRemotionHubInitAction(args)) {
         runRemotionHubInitCommand(buildRemotionHubInitCommandArgs(args));
         return;
     }
+    if (isRemotionHubAddAction(args)) {
+        await runRemotionHubAddCommand(buildRemotionHubAddCommandArgs(args));
+        return;
+    }
     const parsed = parseActionsArgs(args);
     if (parsed.help || !parsed.microApp) {
         console.log(buildHelp());

package/dist/commands/remotion-hub-add.d.ts

@@ -0,0 +1,4 @@
+import { type RunRemotionHubAddResult } from '../lib/remotion-hub-init.js';
+export declare function buildRemotionHubAddHelp(): string;
+export declare function runRemotionHubAddCommand(args: string[]): Promise<RunRemotionHubAddResult | undefined>;
+//# sourceMappingURL=remotion-hub-add.d.ts.map

package/dist/commands/remotion-hub-add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remotion-hub-add.d.ts","sourceRoot":"","sources":["../../src/commands/remotion-hub-add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AA8E9F,wBAAgB,uBAAuB,WAsBtC;AAkBD,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CA2B9C"}

package/dist/commands/remotion-hub-add.js

@@ -0,0 +1,125 @@
+import { runRemotionHubAdd } from '../lib/remotion-hub-init.js';
+const valueFlags = new Set([
+    'app-url',
+    'dir',
+    'namespace',
+    'registry',
+    'url',
+]);
+function parseArgs(args) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (arg === '-h') {
+            flags.h = true;
+            continue;
+        }
+        if (!arg.startsWith('--')) {
+            positional.push(arg);
+            continue;
+        }
+        const [rawKey, inlineValue] = arg.slice(2).split(/=(.*)/s, 2);
+        if (!rawKey)
+            continue;
+        if (inlineValue !== undefined) {
+            flags[rawKey] = inlineValue;
+            continue;
+        }
+        if (valueFlags.has(rawKey)) {
+            const next = args[i + 1];
+            if (!next || next.startsWith('--')) {
+                throw new Error(`--${rawKey} requires a value`);
+            }
+            flags[rawKey] = next;
+            i++;
+            continue;
+        }
+        if (rawKey === 'force'
+            || rawKey === 'help'
+            || rawKey === 'json'
+            || rawKey === 'no-install'
+            || rawKey === 'skip-install') {
+            flags[rawKey] = true;
+            continue;
+        }
+        throw new Error(`Unknown option for Remotion Hub add: --${rawKey}`);
+    }
+    return { positional, flags };
+}
+function stringFlag(flags, ...names) {
+    for (const name of names) {
+        const value = flags[name];
+        if (typeof value === 'string' && value.trim())
+            return value.trim();
+    }
+    return undefined;
+}
+function booleanFlag(flags, ...names) {
+    return names.some((name) => flags[name] === true);
+}
+export function buildRemotionHubAddHelp() {
+    return `
+dd actions remotion-hub add - Install a registry component into a local Remotion Hub project
+
+Usage:
+  dd actions remotion-hub add <item> [options]
+
+Options:
+  --dir <path>             Project directory
+  --registry <url>         Double Digit app URL or /api/remotion-hub/r endpoint
+  --url, --app-url <url>   Alias for --registry
+  --namespace <name>       Registry namespace when item is not namespace/slug
+  --force                  Overwrite existing generated files
+  --skip-install           Do not install npm dependencies
+  --no-install             Alias for --skip-install
+  --json                   Print machine-readable JSON
+
+Examples:
+  dd actions remotion-hub add terminal-scene
+  dd actions remotion-hub add doubledigit/terminal-scene --dir ./my-video
+  dd actions remotion-hub add terminal-scene --registry https://double-digit.example --skip-install
+`;
+}
+function printAdd(result) {
+    console.log(`Added ${result.name} (${result.type})`);
+    for (const file of result.written) {
+        console.log(`  ${file}`);
+    }
+    if (result.installedDependencies.length > 0) {
+        console.log('');
+        console.log(`Installed dependencies: ${result.installedDependencies.join(', ')}`);
+    }
+    if (result.snippet) {
+        console.log('');
+        console.log('Import and composition snippet:');
+        console.log(result.snippet);
+    }
+}
+export async function runRemotionHubAddCommand(args) {
+    const parsed = parseArgs(args);
+    const json = booleanFlag(parsed.flags, 'json');
+    if (booleanFlag(parsed.flags, 'help', 'h')) {
+        console.log(buildRemotionHubAddHelp());
+        return undefined;
+    }
+    if (parsed.positional.length !== 1) {
+        throw new Error('Usage: dd actions remotion-hub add <item> [options]');
+    }
+    const result = await runRemotionHubAdd({
+        item: parsed.positional[0] ?? '',
+        projectDir: stringFlag(parsed.flags, 'dir'),
+        registry: stringFlag(parsed.flags, 'registry', 'url', 'app-url'),
+        namespace: stringFlag(parsed.flags, 'namespace'),
+        force: booleanFlag(parsed.flags, 'force'),
+        skipInstall: booleanFlag(parsed.flags, 'skip-install', 'no-install'),
+        quiet: json,
+    });
+    if (json)
+        console.log(JSON.stringify(result, null, 2));
+    else
+        printAdd(result);
+    return result;
+}

package/dist/commands/remotion-hub-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remotion-hub-init.d.ts","sourceRoot":"","sources":["../../src/commands/remotion-hub-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AA8EhG,wBAAgB,wBAAwB,WAwBvC;AAcD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,wBAAwB,GAAG,SAAS,CA0B9F"}
+{"version":3,"file":"remotion-hub-init.d.ts","sourceRoot":"","sources":["../../src/commands/remotion-hub-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAgFhG,wBAAgB,wBAAwB,WA4BvC;AAmBD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,wBAAwB,GAAG,SAAS,CA2B9F"}

package/dist/commands/remotion-hub-init.js

@@ -41,6 +41,8 @@ function parseArgs(args) {
             || rawKey === 'help'
             || rawKey === 'hub-only'
             || rawKey === 'json'
+            || rawKey === 'non-interactive'
+            || rawKey === 'skip-skills'
             || rawKey === 'skip-remotion-create') {
             flags[rawKey] = true;
             continue;
@@ -76,12 +78,16 @@ Options:
   --namespace <name>       Registry namespace (default: doubledigit)
   --skip-remotion-create   Only add Remotion Hub files; do not run create-video
   --hub-only               Alias for --skip-remotion-create
+  --skip-skills            Do not print the Remotion AI coding skills next step
+  --non-interactive        Compatibility flag; init is already prompt-free
   --force                  Overwrite existing generated files
   --json                   Print machine-readable JSON
 
 Examples:
   dd actions remotion-hub init
   dd actions remotion-hub init my-video
+  dd actions remotion-hub init my-video --non-interactive
+  dd actions remotion-hub init my-video --skip-skills
   dd actions remotion-hub init my-video --registry https://double-digit.example
 `;
 }
@@ -95,6 +101,11 @@ function printInit(result) {
     }
     console.log('');
     console.log(`Registry: ${result.config.registry}`);
+    if (!result.skills.skipped) {
+        console.log('');
+        console.log('Install Remotion AI coding skills:');
+        console.log(`  ${result.skills.display}`);
+    }
 }
 export function runRemotionHubInitCommand(args) {
     const parsed = parseArgs(args);
@@ -112,6 +123,7 @@ export function runRemotionHubInitCommand(args) {
         namespace: stringFlag(parsed.flags, 'namespace'),
         force: booleanFlag(parsed.flags, 'force'),
         skipRemotionCreate: booleanFlag(parsed.flags, 'skip-remotion-create', 'hub-only'),
+        skipSkills: booleanFlag(parsed.flags, 'skip-skills'),
         quiet: json,
     });
     if (json)

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  * without importing the full extension-management dependency graph first.
  */
 declare const command: string, args: string[];
-declare const HELP = "\n@doubledigit/cli \u2014 Manage extensions and local setup\n\nCommands:\n  doctor                 Check local prerequisites and project health\n  onboard                Prepare local development and start the app\n  run                    Start the local app with automatic DB bootstrap\n  dev                    Start DB + app without migrations or seed data\n  db <subcommand>        Database helpers (status, migrate, create)\n  actions <app> [action] Discover and invoke micro-app actions\n  create <name>          Scaffold a new micro-app from the template\n  init <project-name>    Scaffold a new Double Digit project\n  add|install <source>   Install an extension from GitHub or a marketplace\n  sync                   Regenerate micro-apps.ts from dd-apps.config.json\n  enable <name>          Enable a micro-app (updates config + runs sync)\n  disable <name>         Disable a micro-app (updates config + runs sync)\n  uninstall|remove <name> Completely remove a micro-app\n  list                   List all discovered micro-apps with enabled/disabled status\n  info <name>            Show detailed info about an installed extension\n  outdated               Check for outdated marketplace extensions\n  reconcile              Detect drift between lock file, marketplace, and local files\n  marketplace <sub>      Manage marketplace registrations (add/list/update/remove)\n  browse [marketplace]   Browse available extensions in registered marketplaces\n\nOptions:\n  --help, -h             Show this help message\n\nExamples:\n  dd doctor\n  dd onboard --yes\n  dd onboard                    # setup + start the dev server\n  dd onboard --no-run           # setup only\n  dd init my-project           # scaffold and bootstrap a fresh project\n  dd init my-project --run      # scaffold + bootstrap + start\n  dd init my-project --skip-install --no-git\n  dd run\n  dd dev\n  dd db status\n  dd actions remotion-hub init my-video --registry https://double-digit.example\n  dd actions remotion-hub search-components --query \"animated chart\"\n  dd create invoice-tracker\n  dd add gh:owner/repo/extensions/micro-apps/habit-tracker\n  dd add habit-tracker@community\n  dd info habit-tracker\n  dd reconcile\n  dd marketplace add digitaldouble/dd-marketplace\n  dd browse community\n  DD_APPS=tasks,agent-v2 dd sync\n";
+declare const HELP = "\n@doubledigit/cli \u2014 Manage extensions and local setup\n\nCommands:\n  doctor                 Check local prerequisites and project health\n  onboard                Prepare local development and start the app\n  run                    Start the local app with automatic DB bootstrap\n  dev                    Start DB + app without migrations or seed data\n  db <subcommand>        Database helpers (status, migrate, create)\n  actions <app> [action] Discover and invoke micro-app actions\n  create <name>          Scaffold a new micro-app from the template\n  init <project-name>    Scaffold a new Double Digit project\n  add|install <source>   Install an extension from GitHub or a marketplace\n  sync                   Regenerate micro-apps.ts from dd-apps.config.json\n  enable <name>          Enable a micro-app (updates config + runs sync)\n  disable <name>         Disable a micro-app (updates config + runs sync)\n  uninstall|remove <name> Completely remove a micro-app\n  list                   List all discovered micro-apps with enabled/disabled status\n  info <name>            Show detailed info about an installed extension\n  outdated               Check for outdated marketplace extensions\n  reconcile              Detect drift between lock file, marketplace, and local files\n  marketplace <sub>      Manage marketplace registrations (add/list/update/remove)\n  browse [marketplace]   Browse available extensions in registered marketplaces\n\nOptions:\n  --help, -h             Show this help message\n\nExamples:\n  dd doctor\n  dd onboard --yes\n  dd onboard                    # setup + start the dev server\n  dd onboard --no-run           # setup only\n  dd init my-project           # scaffold and bootstrap a fresh project\n  dd init my-project --run      # scaffold + bootstrap + start\n  dd init my-project --skip-install --no-git\n  dd run\n  dd dev\n  dd db status\n  dd actions remotion-hub init my-video --non-interactive\n  dd actions remotion-hub init my-video --skip-skills\n  dd actions remotion-hub search-components --query \"animated chart\"\n  dd create invoice-tracker\n  dd add gh:owner/repo/extensions/micro-apps/habit-tracker\n  dd add habit-tracker@community\n  dd info habit-tracker\n  dd reconcile\n  dd marketplace add digitaldouble/dd-marketplace\n  dd browse community\n  DD_APPS=tasks,agent-v2 dd sync\n";
 declare function requireArg(value: string | undefined, usage: string): string;
 declare function runAddCommand(rawArgs: string[]): Promise<void>;
 declare function main(): Promise<void>;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,QAAA,MAAW,OAAO,UAAK,IAAI,UAAgB,CAAC;AAE5C,QAAA,MAAM,IAAI,0xEAgDT,CAAC;AAEF,iBAAS,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED,iBAAe,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB7D;AAED,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAsInC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,QAAA,MAAW,OAAO,UAAK,IAAI,UAAgB,CAAC;AAE5C,QAAA,MAAM,IAAI,2zEAiDT,CAAC;AAEF,iBAAS,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED,iBAAe,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB7D;AAED,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAsInC"}

package/dist/index.js

@@ -45,7 +45,8 @@ Examples:
   dd run
   dd dev
   dd db status
-  dd actions remotion-hub init my-video --registry https://double-digit.example
+  dd actions remotion-hub init my-video --non-interactive
+  dd actions remotion-hub init my-video --skip-skills
   dd actions remotion-hub search-components --query "animated chart"
   dd create invoice-tracker
   dd add gh:owner/repo/extensions/micro-apps/habit-tracker

package/dist/lib/remotion-hub-init.d.ts

@@ -1,4 +1,9 @@
 import { spawnSync } from 'node:child_process';
+type RemotionSkillsCommand = {
+    command: 'npx';
+    args: ['skills', 'add', 'remotion-dev/skills'];
+    display: 'npx skills add remotion-dev/skills';
+};
 export interface RemotionHubConfig {
     $schema: string;
     registry: string;
@@ -40,6 +45,7 @@ export interface RunRemotionHubInitOptions {
     namespace?: string;
     force?: boolean;
     skipRemotionCreate?: boolean;
+    skipSkills?: boolean;
     quiet?: boolean;
     spawnImpl?: typeof spawnSync;
 }
@@ -54,6 +60,31 @@ export interface RunRemotionHubInitResult {
         command: string;
         args: string[];
     };
+    skills: RemotionSkillsCommand & {
+        skipped: boolean;
+    };
+}
+export interface RunRemotionHubAddOptions {
+    item: string;
+    projectDir?: string;
+    namespace?: string;
+    registry?: string;
+    skipInstall?: boolean;
+    force?: boolean;
+    quiet?: boolean;
+    fetchImpl?: typeof fetch;
+    spawnImpl?: typeof spawnSync;
+}
+export interface RunRemotionHubAddResult {
+    name: string;
+    namespace: string;
+    slug: string;
+    type: string;
+    resolved: string;
+    written: string[];
+    dependencies: string[];
+    installedDependencies: string[];
+    snippet: string;
 }
 export interface ResolveRemotionHubRegistryOptions {
     registry?: string;
@@ -62,5 +93,12 @@ export interface ResolveRemotionHubRegistryOptions {
     localDefaultRegistry?: string;
 }
 export declare function resolveRemotionHubRegistry({ registry, env, generatedDefaultRegistry, localDefaultRegistry, }?: ResolveRemotionHubRegistryOptions): string;
+export declare function buildRemotionSkillsCommand(): {
+    args: RemotionSkillsCommand["args"];
+    command: "npx";
+    display: "npx skills add remotion-dev/skills";
+};
 export declare function runRemotionHubInit(options?: RunRemotionHubInitOptions): RunRemotionHubInitResult;
+export declare function runRemotionHubAdd(options: RunRemotionHubAddOptions): Promise<RunRemotionHubAddResult>;
+export {};
 //# sourceMappingURL=remotion-hub-init.d.ts.map

package/dist/lib/remotion-hub-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remotion-hub-init.d.ts","sourceRoot":"","sources":["../../src/lib/remotion-hub-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAyB,MAAM,oBAAoB,CAAC;AAkBtE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IAChD,OAAO,EAAE;QACP,QAAQ,EAAE,YAAY,GAAG,YAAY,CAAC;KACvC,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,cAAc,EAAE;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;CACH;AAsFD,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,0BAA0B,CAAC,EACzC,QAAQ,EACR,GAAiB,EACjB,wBAA4D,EAC5D,oBAAuC,GACxC,GAAE,iCAAsC,UAQxC;AAuJD,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,wBAAwB,CA+CpG"}
+{"version":3,"file":"remotion-hub-init.d.ts","sourceRoot":"","sources":["../../src/lib/remotion-hub-init.ts"],"names":[],"mappings":"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"}

package/dist/lib/remotion-hub-init.js

@@ -7,6 +7,11 @@ const CONFIG_FILE = 'remotion-hub.json';
 const LOCK_FILE = 'remotion-hub.lock.json';
 const DEFAULT_REGISTRY = 'http://localhost:3111';
 const DEFAULT_NAMESPACE = 'doubledigit';
+const REMOTION_SKILLS_COMMAND = {
+    command: 'npx',
+    args: ['skills', 'add', 'remotion-dev/skills'],
+    display: 'npx skills add remotion-dev/skills',
+};
 function toJson(value) {
     return `${JSON.stringify(value, null, 2)}\n`;
 }
@@ -174,6 +179,12 @@ function buildRemotionCreateCommand(projectDir) {
         args: ['create-video@latest', '--yes', '--hello-world', projectDir],
     };
 }
+export function buildRemotionSkillsCommand() {
+    return {
+        ...REMOTION_SKILLS_COMMAND,
+        args: [...REMOTION_SKILLS_COMMAND.args],
+    };
+}
 function assertRemotionCreateSucceeded(result, command, args) {
     if (result.error) {
         throw new Error(`Remotion project creation failed: ${result.error.message}`);
@@ -211,6 +222,152 @@ function loadConfig(projectDir) {
     }
     return JSON.parse(readFileSync(configPath, 'utf8'));
 }
+function normalizeRegistryBase(value) {
+    const trimmed = value.trim().replace(/\/+$/, '');
+    if (/^https?:\/\//i.test(trimmed))
+        return trimmed;
+    if (/^(localhost|127(?:\.\d{1,3}){3}|\[::1\])(?::|\/|$)/i.test(trimmed)) {
+        return `http://${trimmed}`;
+    }
+    return `https://${trimmed}`;
+}
+function parseItemRef(item, namespace) {
+    const trimmed = item.trim();
+    if (!trimmed)
+        throw new Error('Item name is required');
+    const parts = trimmed.split('/').filter(Boolean);
+    if (parts.length === 2) {
+        return { namespace: parts[0] ?? DEFAULT_NAMESPACE, slug: parts[1] ?? '' };
+    }
+    return { namespace: namespace || DEFAULT_NAMESPACE, slug: trimmed };
+}
+function registryPayloadUrl(config, namespace, slug, registryOverride) {
+    const base = normalizeRegistryBase(registryOverride || config.registry || DEFAULT_REGISTRY);
+    const encodedNamespace = encodeURIComponent(namespace);
+    const encodedSlug = encodeURIComponent(slug);
+    if (base.endsWith('/api/remotion-hub/r')) {
+        return `${base}/${encodedNamespace}/${encodedSlug}`;
+    }
+    return `${base}/api/remotion-hub/r/${encodedNamespace}/${encodedSlug}`;
+}
+function asStringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((item) => typeof item === 'string' && item.trim().length > 0);
+}
+function readRegistryPayload(value) {
+    const name = typeof value.name === 'string' && value.name.trim() ? value.name.trim() : '';
+    const type = typeof value.type === 'string' && value.type.trim() ? value.type.trim() : 'registry:component';
+    const version = typeof value.version === 'string' && value.version.trim() ? value.version.trim() : null;
+    const files = Array.isArray(value.files) ? value.files : [];
+    if (!name)
+        throw new Error('Registry payload is missing name');
+    if (files.length === 0)
+        throw new Error('Registry payload is missing files');
+    return {
+        name,
+        type,
+        version,
+        files,
+        dependencies: asStringArray(value.dependencies),
+    };
+}
+async function fetchRegistryPayload(url, fetchImpl) {
+    const response = await fetchImpl(url);
+    const text = await response.text();
+    const parsed = text ? JSON.parse(text) : {};
+    if (!response.ok) {
+        const error = parsed && typeof parsed === 'object' && 'error' in parsed
+            ? String(parsed.error)
+            : `Request failed with HTTP ${response.status}`;
+        throw new Error(error);
+    }
+    return readRegistryPayload(parsed);
+}
+function targetForRegistryFile(config, file) {
+    const explicitTarget = typeof file.target === 'string' ? file.target.trim() : '';
+    if (explicitTarget)
+        return explicitTarget;
+    const sourcePath = ensureRelativePath(typeof file.path === 'string' ? file.path : '', 'file.path');
+    const mappings = [
+        ['components/', config.paths.components],
+        ['scenes/', config.paths.scenes],
+        ['overlays/', config.paths.overlays],
+        ['transitions/', config.paths.transitions],
+        ['assets/', config.paths.assets],
+    ];
+    for (const [prefix, targetRoot] of mappings) {
+        if (sourcePath.startsWith(prefix)) {
+            return path.posix.join(targetRoot.replace(/\/+$/, ''), sourcePath.slice(prefix.length));
+        }
+    }
+    return path.posix.join('src/remotion-hub', sourcePath);
+}
+function packageJsonDependencies(projectDir) {
+    const packageJsonPath = path.join(projectDir, 'package.json');
+    if (!existsSync(packageJsonPath))
+        return new Set();
+    const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+    return new Set([
+        ...Object.keys(pkg.dependencies ?? {}),
+        ...Object.keys(pkg.devDependencies ?? {}),
+        ...Object.keys(pkg.peerDependencies ?? {}),
+    ]);
+}
+function dependencyName(specifier) {
+    if (specifier.startsWith('@')) {
+        const [scope, name] = specifier.split('/');
+        return scope && name ? `${scope}/${name}` : specifier;
+    }
+    return specifier.split('@')[0] || specifier;
+}
+function installDependencies(projectDir, packageManager, dependencies, spawnImpl, quiet = false) {
+    if (dependencies.length === 0)
+        return [];
+    const installed = packageJsonDependencies(projectDir);
+    const missing = dependencies.filter((dependency) => !installed.has(dependencyName(dependency)));
+    if (missing.length === 0)
+        return [];
+    const command = packageManager;
+    const args = packageManager === 'npm'
+        ? ['install', ...missing]
+        : ['add', ...missing];
+    const result = spawnImpl(command, args, {
+        cwd: projectDir,
+        stdio: quiet ? 'pipe' : 'inherit',
+    });
+    if (result.status !== 0) {
+        throw new Error(`Dependency install failed: ${command} ${args.join(' ')}`);
+    }
+    return missing;
+}
+function exportNameFromSource(source, fallback) {
+    const match = source.match(/export\s+(?:function|const|class)\s+([A-Z][A-Za-z0-9_]*)/);
+    if (match?.[1])
+        return match[1];
+    return fallback
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean)
+        .map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`)
+        .join('') || 'RemotionHubComponent';
+}
+function importPath(fromFile, toFile) {
+    const withoutExtension = toFile.replace(/\.[cm]?[tj]sx?$/, '');
+    let relative = normalizeSlashes(path.relative(path.dirname(fromFile), withoutExtension));
+    if (!relative.startsWith('.'))
+        relative = `./${relative}`;
+    return relative;
+}
+function buildSnippet(config, projectDir, name, primaryFile, source) {
+    const rootFile = resolveInsideProject(projectDir, config.remotion.root, 'remotion.root');
+    const exportName = exportNameFromSource(source, name);
+    const importFrom = importPath(rootFile, primaryFile);
+    return [
+        `import { ${exportName} } from '${importFrom}';`,
+        '',
+        `<Composition id="${name}" component={${exportName}} durationInFrames={180} fps={30} width={1920} height={1080} />`,
+    ].join('\n');
+}
 export function runRemotionHubInit(options = {}) {
     const projectDir = resolveProjectDir(options.projectDir);
     const configPath = path.join(projectDir, CONFIG_FILE);
@@ -250,5 +407,82 @@ export function runRemotionHubInit(options = {}) {
         created,
         config,
         remotionCreate,
+        skills: {
+            ...buildRemotionSkillsCommand(),
+            skipped: options.skipSkills === true,
+        },
+    };
+}
+export async function runRemotionHubAdd(options) {
+    const projectDir = resolveProjectDir(options.projectDir);
+    const config = loadConfig(projectDir);
+    const itemRef = parseItemRef(options.item, options.namespace || config.namespace);
+    const resolved = registryPayloadUrl(config, itemRef.namespace, itemRef.slug, options.registry);
+    const payload = await fetchRegistryPayload(resolved, options.fetchImpl ?? fetch);
+    const lockPath = path.join(projectDir, LOCK_FILE);
+    const lock = readJsonFile(lockPath, defaultLock());
+    const written = [];
+    const filesToWrite = [];
+    const seenTargets = new Set();
+    let primaryFile = '';
+    let primarySource = '';
+    for (const file of payload.files) {
+        const content = typeof file.content === 'string' ? file.content : '';
+        if (!content)
+            throw new Error(`Registry file for ${payload.name} is missing content`);
+        const relativeTarget = targetForRegistryFile(config, file);
+        const destination = resolveInsideProject(projectDir, relativeTarget, 'file.target');
+        const relativePath = normalizeSlashes(path.relative(projectDir, destination));
+        if (seenTargets.has(relativePath)) {
+            throw new Error(`Registry payload contains duplicate target: ${relativePath}`);
+        }
+        if (existsSync(destination) && !options.force) {
+            throw new Error(`Refusing to overwrite existing file: ${relativePath}`);
+        }
+        seenTargets.add(relativePath);
+        filesToWrite.push({ destination, relativePath, content });
+    }
+    const installedDependencies = options.skipInstall
+        ? []
+        : installDependencies(projectDir, config.packageManager, payload.dependencies, options.spawnImpl ?? spawnSync, options.quiet);
+    for (const file of filesToWrite) {
+        mkdirSync(path.dirname(file.destination), { recursive: true });
+        writeFileSync(file.destination, file.content, 'utf8');
+        written.push(file.relativePath);
+        if (!primaryFile && /\.[cm]?[tj]sx?$/.test(file.destination)) {
+            primaryFile = file.destination;
+            primarySource = file.content;
+        }
+    }
+    for (const destination of filesToWrite.map((file) => file.destination)) {
+        if (!existsSync(destination)) {
+            throw new Error(`Failed to write file: ${normalizeSlashes(path.relative(projectDir, destination))}`);
+        }
+    }
+    lock.installed[payload.name] = {
+        version: payload.version,
+        type: payload.type,
+        namespace: itemRef.namespace,
+        slug: itemRef.slug,
+        resolved,
+        files: written,
+        dependencies: payload.dependencies,
+        installedAt: new Date().toISOString(),
+    };
+    writeJsonFile(lockPath, lock);
+    writeRegistryFile(projectDir, config, lock);
+    const snippet = primaryFile
+        ? buildSnippet(config, projectDir, payload.name, primaryFile, primarySource)
+        : '';
+    return {
+        name: payload.name,
+        namespace: itemRef.namespace,
+        slug: itemRef.slug,
+        type: payload.type,
+        resolved,
+        written,
+        dependencies: payload.dependencies,
+        installedDependencies,
+        snippet,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doubledigit/cli",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "private": false,
   "description": "CLI for Double Digit local setup and extension management.",
   "license": "MIT",