@doubledigit/cli 0.2.0 → 0.3.0

package/README.md

@@ -0,0 +1,128 @@
+# @doubledigit/cli
+
+CLI for Double Digit local setup, project bootstrapping, extension management, and database workflows.
+
+Double Digit is a pluggable Next.js/Payload developer control plane. The CLI is the supported command surface for creating a new Double Digit project and managing an existing local workspace.
+
+## Usage
+
+Run the published package directly:
+
+```bash
+npx @doubledigit/cli init my-project
+pnpm dlx @doubledigit/cli init my-project
+```
+
+Inside a Double Digit project, use the repo-local shortcut:
+
+```bash
+pnpm dev
+pnpm dd doctor
+pnpm onboard
+pnpm onboard -- --no-run
+pnpm dd actions remotion-hub
+```
+
+If installed globally, the binary is available as `dd`:
+
+```bash
+dd dev
+dd doctor
+dd onboard
+dd onboard --no-run
+dd actions remotion-hub
+```
+
+## Requirements
+
+- Node.js 20 or newer
+- pnpm 9 or newer
+
+Enable pnpm through Corepack when needed:
+
+```bash
+corepack enable
+```
+
+## Core Commands
+
+```bash
+dd init <project-name>      # scaffold a new Double Digit project
+dd doctor                   # check local prerequisites and project health
+dd onboard                  # prepare env, dependencies, DB, migrations, types, and start
+dd onboard --no-run         # setup only
+dd run                      # lower-level runtime bootstrap/start command
+dd dev                      # start DB + app without migrations or seed data
+dd db status                # inspect migration state
+dd db migrate               # run migrations
+dd db create <target> <name> # create a migration for shared or micro-app schema
+dd actions <app> [action]   # discover and invoke micro-app actions
+dd add <source>             # install an extension
+dd sync                     # regenerate workspace registries
+dd list                     # list discovered micro-apps
+dd enable <name>            # enable a micro-app
+dd disable <name>           # disable a micro-app
+dd remove <name>            # remove a micro-app package and wiring
+dd info <name>              # show detailed extension metadata
+dd outdated                 # compare marketplace installs against cached catalogs
+dd reconcile                # detect registry, lock file, and package drift
+dd marketplace <subcommand> # manage marketplace registrations
+dd browse                   # browse marketplace extensions
+```
+
+`add` is also available as `install`, and `remove` is also available as `uninstall`.
+
+## New Project Bootstrap
+
+```bash
+npx @doubledigit/cli init my-project --yes
+cd my-project
+pnpm onboard
+```
+
+Useful `init` options:
+
+- `--yes` skips prompts and uses defaults.
+- `--run` bootstraps and starts the app after scaffolding.
+- `--skip-install` skips dependency installation.
+- `--no-git` removes the cloned `.git` directory from the generated project.
+
+## Existing Project Setup
+
+Use `onboard` for first-time setup and startup:
+
+```bash
+pnpm onboard
+```
+
+Pass `--no-run` when you want setup-only work:
+
+```bash
+pnpm onboard -- --no-run
+```
+
+Leave `DATABASE_URL` empty in `apps/main-app/.env` to use the default CLI-managed embedded PostgreSQL flow. Provide `DATABASE_URL` through the environment or `.env` when using your own PostgreSQL instance.
+
+Use `dd dev` when you want the app and database ready without running migrations or seed data. It defaults to port `3000` and accepts `--port`, for example:
+
+```bash
+dd dev --port 3000
+```
+
+## Action Invocations
+
+Use `dd actions` to discover or call enabled micro-app actions through the running app:
+
+```bash
+dd actions remotion-hub
+dd actions remotion-hub search-components --query "animated chart" --limit 5
+```
+
+The command resolves the app URL from `DD_APP_URL`, `APP_URL`, or `BETTER_AUTH_URL` and prints JSON responses to stdout.
+
+## Links
+
+- Repository: https://github.com/crystalphantom/double-digit
+- Issues: https://github.com/crystalphantom/double-digit/issues
+- Getting started: https://github.com/crystalphantom/double-digit/blob/main/docs/getting-started.md
+- Architecture: https://github.com/crystalphantom/double-digit/blob/main/docs/architecture.md

package/dist/commands/actions.d.ts

@@ -0,0 +1,2 @@
+export declare function actions(args: string[]): Promise<void>;
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/commands/actions.ts"],"names":[],"mappings":"AAyDA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAa3D"}

package/dist/commands/actions.js

@@ -0,0 +1,59 @@
+import { readConfig, isEntryEnabled } from '../config.js';
+import { DEFAULT_APP_URL } from '../lib/onboarding.js';
+import { buildActionRequest, fetchActionRequest, parseActionsArgs, } from '../lib/actions-client.js';
+import { resolveWorkspacePaths } from '../paths.js';
+import { scanWorkspace } from '../scanner.js';
+const HELP = `
+dd actions — Discover and invoke micro-app actions
+
+Usage:
+  dd actions <micro-app>
+  dd actions <micro-app> <action> [options]
+
+Options:
+  --url, --app-url <url>      App URL (default: DD_APP_URL, APP_URL, or ${DEFAULT_APP_URL})
+  --json <json>               JSON request body to send to the action
+  --query <text>              Set input.query
+  --limit <number>            Set input.limit
+  --namespace <namespace>     Set input namespace/filter
+  --slug <slug>               Set input.slug
+  --id-or-slug <value>        Set input.idOrSlug
+  --kind <kind>               Set input kind/filter
+  --preview-type <type>       Set input previewType/filter
+  --tag, --tags <tags>        Add one tag or comma-separated tags to filters.tags
+
+Examples:
+  dd actions remotion-hub
+  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"}'
+`;
+function resolveAppUrl(parsedUrl) {
+    return parsedUrl
+        ?? process.env.DD_APP_URL
+        ?? process.env.APP_URL
+        ?? process.env.BETTER_AUTH_URL
+        ?? DEFAULT_APP_URL;
+}
+function validateMicroApp(microApp) {
+    const paths = resolveWorkspacePaths();
+    const app = scanWorkspace(paths).microApps.find((candidate) => candidate.key === microApp);
+    if (!app) {
+        throw new Error(`Unknown micro-app: ${microApp}`);
+    }
+    const config = readConfig(paths.configPath);
+    if (!isEntryEnabled(config.apps?.[microApp])) {
+        throw new Error(`Micro-app is disabled: ${microApp}`);
+    }
+}
+export async function actions(args) {
+    const parsed = parseActionsArgs(args);
+    if (parsed.help || !parsed.microApp) {
+        console.log(HELP);
+        return;
+    }
+    validateMicroApp(parsed.microApp);
+    const request = buildActionRequest(parsed, resolveAppUrl(parsed.appUrl));
+    const result = await fetchActionRequest(request);
+    console.log(JSON.stringify(result, null, 2));
+}

package/dist/commands/db.js

@@ -8,7 +8,7 @@ async function dbStatus(args) {
     const databaseMode = databasePreference.mode;
     const databaseUrl = databasePreference.databaseUrl;
     if (!databaseUrl) {
-        console.error('Error: no database configuration is available. Run `pnpm dd onboard` first.');
+        console.error('Error: no database configuration is available. Run `pnpm onboard` first.');
         process.exit(1);
     }
     const info = parseDatabaseUrl(databaseUrl);

package/dist/commands/dev.d.ts

@@ -0,0 +1,2 @@
+export declare function dev(args?: string[]): Promise<void>;
+//# sourceMappingURL=dev.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AA+BA,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC5D"}

package/dist/commands/dev.js

@@ -0,0 +1,44 @@
+import { resolveWorkspacePaths } from '../paths.js';
+import { applyRuntimeDatabaseUrl, databaseRuntimeToEnvOptions, ensureDatabaseReady, ensureLocalEnv, startDevServer, } from '../lib/onboarding.js';
+function applyDevArgs(args) {
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index];
+        if (arg === '--port' || arg === '-p') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('-')) {
+                throw new Error(`${arg} requires a port value.`);
+            }
+            process.env.APP_PORT = value;
+            index++;
+            continue;
+        }
+        if (arg.startsWith('--port=')) {
+            process.env.APP_PORT = arg.slice('--port='.length);
+            continue;
+        }
+        throw new Error(`Unsupported pnpm dev argument: ${arg}`);
+    }
+}
+export async function dev(args = []) {
+    applyDevArgs(args);
+    process.env.APP_PORT ??= '3000';
+    const paths = resolveWorkspacePaths();
+    const envSetup = ensureLocalEnv(paths);
+    const runtime = await ensureDatabaseReady(paths, {
+        yes: true,
+        allowDockerFallback: true,
+    });
+    const runtimeEnv = applyRuntimeDatabaseUrl(ensureLocalEnv(paths, databaseRuntimeToEnvOptions(runtime)).env, runtime);
+    console.log(`✔ ${runtime.mode === 'embedded' ? 'Embedded' : runtime.mode === 'docker' ? 'Docker' : 'External'} PostgreSQL is ready`);
+    if (runtime.mode === 'embedded' && runtime.embeddedPort) {
+        console.log(`  Port: ${runtime.embeddedPort}`);
+    }
+    if (runtime.mode === 'docker' && runtime.dockerPort) {
+        console.log(`  Docker host port: ${runtime.dockerPort}`);
+    }
+    if (envSetup.updatedKeys.length > 0) {
+        console.log(`  Updated ${envSetup.envPath.replace(`${paths.root}/`, '')}: ${envSetup.updatedKeys.join(', ')}`);
+    }
+    console.log('Starting development server without running migrations or seed data...\n');
+    await startDevServer(paths, runtimeEnv);
+}

package/dist/commands/doctor.js

@@ -62,19 +62,19 @@ export async function doctor() {
             ? embeddedSupport.supported
                 ? dbReachable
                     ? 'Embedded PostgreSQL is reachable.'
-                    : 'Embedded PostgreSQL is not running yet. `pnpm dev` or `dd run` will start it automatically.'
+                    : 'Embedded PostgreSQL is not running yet. `pnpm onboard` will start it automatically.'
                 : embeddedSupport.reason || 'Embedded PostgreSQL is not supported on this host.'
             : dbReachable
                 ? 'PostgreSQL is reachable from DATABASE_URL.'
                 : dockerAvailable()
-                    ? 'Database is not reachable yet. Run `pnpm dd onboard` or start Docker/Postgres manually.'
+                    ? 'Database is not reachable yet. Run `pnpm onboard` or start Docker/Postgres manually.'
                     : 'Database is not reachable. Start PostgreSQL or update DATABASE_URL.',
     });
     if (databaseMode === 'embedded' && embeddedSupport.supported && !dbReachable) {
         checks.push({
             label: 'Migration status',
             ok: true,
-            detail: 'Skipped until embedded PostgreSQL starts. `pnpm dev` or `dd run` will start it automatically.',
+            detail: 'Skipped until embedded PostgreSQL starts. `pnpm onboard` will start it automatically.',
         });
     }
     else {
@@ -113,8 +113,8 @@ export async function doctor() {
     const failed = checks.filter((check) => !check.ok);
     if (failed.length > 0) {
         console.log('\nDoctor found issues. Recommended next steps:\n');
-        console.log('  pnpm dd onboard       # fix setup issues');
-        console.log('  pnpm dev              # then start the app\n');
+        console.log('  pnpm onboard          # fix setup issues and start the app');
+        console.log('  pnpm onboard -- --no-run  # setup only\n');
         process.exitCode = 1;
         return;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AA0JA,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+ExD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAyJA,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+ExD"}

package/dist/commands/init.js

@@ -96,8 +96,7 @@ function printInitNextSteps(projectName, skipInstall) {
     console.log(`cd ${projectName}`);
     if (skipInstall) {
         console.log('pnpm install');
-        console.log('pnpm dd onboard');
-        console.log('pnpm dd run');
+        console.log('pnpm onboard');
         return;
     }
     printNextSteps();

package/dist/commands/onboard.d.ts

@@ -1,2 +1,9 @@
+interface OnboardOptions {
+    yes: boolean;
+    run: boolean;
+    help: boolean;
+}
+export declare function parseOnboardArgs(args: string[], env?: NodeJS.ProcessEnv): OnboardOptions;
 export declare function onboard(args: string[]): Promise<void>;
+export {};
 //# sourceMappingURL=onboard.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../src/commands/onboard.ts"],"names":[],"mappings":"AA6CA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmD3D"}
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../src/commands/onboard.ts"],"names":[],"mappings":"AAaA,UAAU,cAAc;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAmBD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,cAAc,CA4BhB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD3D"}

package/dist/commands/onboard.js

@@ -1,29 +1,51 @@
 import { resolveWorkspacePaths } from '../paths.js';
 import { applyRuntimeDatabaseUrl, captureCommand, databaseRuntimeToEnvOptions, ensureDatabaseReady, ensureLocalEnv, localDependenciesInstalled, printNextSteps, runChecked, startDevServer, } from '../lib/onboarding.js';
-function parseOnboardArgs(args) {
+const ONBOARD_HELP = `Usage: dd onboard [--yes] [--no-run]
+
+Prepare the local development environment and start the app.
+
+Options:
+  --yes, -y      Skip interactive prompts and use defaults.
+  --no-run       Run setup only and exit without starting Next.js.
+  --no-start     Alias for --no-run.
+  --setup-only   Alias for --no-run.
+  --start        Compatibility alias; running is now the default.
+  --help, -h     Show this help message.
+
+Examples:
+  dd onboard
+  dd onboard --no-run
+  APP_PORT=3111 dd onboard`;
+export function parseOnboardArgs(args, env = process.env) {
     let yes = false;
-    let start = false;
+    let run = true;
+    let help = false;
     for (const arg of args) {
+        if (arg === '--help' || arg === '-h') {
+            help = true;
+        }
         if (arg === '--yes' || arg === '-y') {
             yes = true;
         }
         if (arg === '--start') {
-            start = true;
+            run = true;
         }
-        // Keep --no-start and --setup-only as compatibility aliases (no-ops now
-        // that the default is already no-start).
-        if (arg === '--no-start' || arg === '--setup-only') {
-            start = false;
+        if (arg === '--no-run' || arg === '--no-start' || arg === '--setup-only') {
+            run = false;
         }
     }
-    if (process.env.CI === 'true') {
-        start = false;
+    if (env.CI === 'true') {
+        run = false;
     }
-    return { yes, start };
+    return { yes, run, help };
 }
 export async function onboard(args) {
-    const paths = resolveWorkspacePaths();
     const options = parseOnboardArgs(args);
+    if (options.help) {
+        console.log(ONBOARD_HELP);
+        return;
+    }
+    const paths = resolveWorkspacePaths();
     console.log('\n🚀 Double Digit onboarding\n');
     const envSetup = ensureLocalEnv(paths);
     console.log(`✔ ${envSetup.created ? 'Created' : 'Found'} ${envSetup.envPath.replace(`${paths.root}/`, '')}`);
@@ -54,7 +76,7 @@ export async function onboard(args) {
         console.log('\nMigration status:');
         console.log(migrationStatus.output.trim());
     }
-    if (options.start) {
+    if (options.run) {
         console.log('\nStarting development server...\n');
         await startDevServer(paths, runtimeEnv);
         return;

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 a local development environment (setup only)\n  run                    Start the local app with automatic DB bootstrap\n  db <subcommand>        Database helpers (status, migrate, create)\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 --start            # setup + start the dev server\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 db status\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 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,y8DA0CT,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,CAyHnC"}
+{"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,ysEA+CT,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

@@ -12,9 +12,11 @@ const HELP = `
 
 Commands:
   doctor                 Check local prerequisites and project health
-  onboard                Prepare a local development environment (setup only)
+  onboard                Prepare local development and start the app
   run                    Start the local app with automatic DB bootstrap
+  dev                    Start DB + app without migrations or seed data
   db <subcommand>        Database helpers (status, migrate, create)
+  actions <app> [action] Discover and invoke micro-app actions
   create <name>          Scaffold a new micro-app from the template
   init <project-name>    Scaffold a new Double Digit project
   add|install <source>   Install an extension from GitHub or a marketplace
@@ -35,12 +37,15 @@ Options:
 Examples:
   dd doctor
   dd onboard --yes
-  dd onboard --start            # setup + start the dev server
+  dd onboard                    # setup + start the dev server
+  dd onboard --no-run           # setup only
   dd init my-project           # scaffold and bootstrap a fresh project
   dd init my-project --run      # scaffold + bootstrap + start
   dd init my-project --skip-install --no-git
   dd run
+  dd dev
   dd db status
+  dd actions remotion-hub search-components --query "animated chart"
   dd create invoice-tracker
   dd add gh:owner/repo/extensions/micro-apps/habit-tracker
   dd add habit-tracker@community
@@ -98,11 +103,22 @@ async function main() {
             await run();
             break;
         }
+        case 'dev': {
+            const { dev } = await import('./commands/dev.js');
+            await dev(args);
+            break;
+        }
         case 'db': {
             const { db } = await import('./commands/db.js');
             await db(args);
             break;
         }
+        case 'actions':
+        case 'action': {
+            const { actions } = await import('./commands/actions.js');
+            await actions(args);
+            break;
+        }
         case 'create': {
             const name = requireArg(args[0], 'dd create <name>');
             const { create } = await import('./commands/create.js');

package/dist/lib/actions-client.d.ts

@@ -0,0 +1,16 @@
+export interface ParsedActionsArgs {
+    microApp?: string;
+    actionName?: string;
+    appUrl?: string;
+    input: Record<string, unknown>;
+    help: boolean;
+}
+export interface ActionRequest {
+    url: string;
+    init: RequestInit;
+}
+export declare function parseActionsArgs(args: string[]): ParsedActionsArgs;
+export declare function normalizeAppUrl(appUrl: string): string;
+export declare function buildActionRequest(parsed: Pick<ParsedActionsArgs, 'microApp' | 'actionName' | 'input'>, appUrl: string): ActionRequest;
+export declare function fetchActionRequest(request: ActionRequest): Promise<unknown>;
+//# sourceMappingURL=actions-client.d.ts.map

package/dist/lib/actions-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-client.d.ts","sourceRoot":"","sources":["../../src/lib/actions-client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC;CACnB;AA2DD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAsDlE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,UAE7C;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAoBtI;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAajF"}

package/dist/lib/actions-client.js

@@ -0,0 +1,150 @@
+function requireValue(args, index, flag) {
+    const value = args[index + 1];
+    if (!value || value.startsWith('--')) {
+        throw new Error(`${flag} requires a value`);
+    }
+    return value;
+}
+function parseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        throw new Error('--json must be valid JSON');
+    }
+}
+function asFilters(input) {
+    const filters = input.filters;
+    if (filters && typeof filters === 'object' && !Array.isArray(filters)) {
+        return filters;
+    }
+    const next = {};
+    input.filters = next;
+    return next;
+}
+function setInputValue(input, key, value) {
+    if (key === 'limit') {
+        const numeric = Number(value);
+        if (!Number.isFinite(numeric) || numeric <= 0) {
+            throw new Error('--limit must be a positive number');
+        }
+        input.limit = numeric;
+        return;
+    }
+    if (key === 'namespace' || key === 'kind' || key === 'previewType') {
+        input[key] = value;
+        asFilters(input)[key] = value;
+        return;
+    }
+    input[key] = value;
+}
+function addTag(input, value) {
+    const tags = value
+        .split(',')
+        .map((tag) => tag.trim())
+        .filter(Boolean);
+    if (tags.length === 0)
+        return;
+    const filters = asFilters(input);
+    const existing = Array.isArray(filters.tags) ? filters.tags : [];
+    filters.tags = [...existing, ...tags];
+}
+export function parseActionsArgs(args) {
+    const input = {};
+    const positional = [];
+    let appUrl;
+    let help = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            help = true;
+        }
+        else if (arg === '--url' || arg === '--app-url') {
+            appUrl = requireValue(args, i, arg);
+            i++;
+        }
+        else if (arg === '--json') {
+            Object.assign(input, parseJson(requireValue(args, i, arg)));
+            i++;
+        }
+        else if (arg === '--query') {
+            setInputValue(input, 'query', requireValue(args, i, arg));
+            i++;
+        }
+        else if (arg === '--limit') {
+            setInputValue(input, 'limit', requireValue(args, i, arg));
+            i++;
+        }
+        else if (arg === '--namespace') {
+            setInputValue(input, 'namespace', requireValue(args, i, arg));
+            i++;
+        }
+        else if (arg === '--slug') {
+            setInputValue(input, 'slug', requireValue(args, i, arg));
+            i++;
+        }
+        else if (arg === '--id-or-slug') {
+            setInputValue(input, 'idOrSlug', requireValue(args, i, arg));
+            i++;
+        }
+        else if (arg === '--kind') {
+            setInputValue(input, 'kind', requireValue(args, i, arg));
+            i++;
+        }
+        else if (arg === '--preview-type') {
+            setInputValue(input, 'previewType', requireValue(args, i, arg));
+            i++;
+        }
+        else if (arg === '--tag' || arg === '--tags') {
+            addTag(input, requireValue(args, i, arg));
+            i++;
+        }
+        else if (arg.startsWith('--')) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return {
+        microApp: positional[0],
+        actionName: positional[1],
+        appUrl,
+        input,
+        help,
+    };
+}
+export function normalizeAppUrl(appUrl) {
+    return appUrl.trim().replace(/\/+$/, '');
+}
+export function buildActionRequest(parsed, appUrl) {
+    if (!parsed.microApp) {
+        throw new Error('missing micro-app name');
+    }
+    const base = normalizeAppUrl(appUrl);
+    const actionPath = parsed.actionName
+        ? `/${encodeURIComponent(parsed.actionName)}`
+        : '';
+    return {
+        url: `${base}/api/${encodeURIComponent(parsed.microApp)}/actions${actionPath}`,
+        init: parsed.actionName
+            ? {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(parsed.input),
+            }
+            : { method: 'GET' },
+    };
+}
+export async function fetchActionRequest(request) {
+    const response = await fetch(request.url, request.init);
+    const text = await response.text();
+    const payload = text ? JSON.parse(text) : null;
+    if (!response.ok) {
+        const error = payload && typeof payload === 'object' && 'error' in payload
+            ? String(payload.error)
+            : `Request failed with HTTP ${response.status}`;
+        throw new Error(error);
+    }
+    return payload;
+}

package/dist/lib/onboarding.js

@@ -493,9 +493,9 @@ export async function startDevServer(paths, envOverrides = {}) {
 }
 export function printNextSteps() {
     console.log("\n✅ Setup complete! Next steps:\n");
-    console.log("  pnpm dev              # start the development server");
-    console.log(`  open ${DEFAULT_APP_URL}`);
-    console.log(`  open ${buildAppUrl(DEFAULT_APP_PORT)}/admin`);
+    console.log("  pnpm dev              # start DB + app without migrations (default port 3000)");
+    console.log("  pnpm onboard          # setup + start through the DD CLI (default port 3111)");
+    console.log("  open http://localhost:3000");
     console.log("");
 }
 function createEmbeddedPostgresLogBuffer(limit = EMBEDDED_LOG_BUFFER_LIMIT) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doubledigit/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "private": false,
   "description": "CLI for Double Digit local setup and extension management.",
   "license": "MIT",
@@ -25,7 +25,8 @@
     "dd": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "exports": {
     ".": {