@ductape/cli 0.2.0

package/src/commands/profiles.ts

@@ -0,0 +1,23 @@
+import { loadGlobalConfig, saveGlobalConfig } from '../lib/config.js';
+import { printJson, success } from '../lib/output.js';
+
+export function runProfilesList(json: boolean): void {
+  const cfg = loadGlobalConfig();
+  printJson(
+    {
+      default_profile: cfg.default_profile,
+      profiles: cfg.profiles,
+    },
+    json,
+  );
+}
+
+export function runProfilesUse(name: string): void {
+  const cfg = loadGlobalConfig();
+  if (!cfg.profiles[name]) {
+    throw new Error(`Unknown profile "${name}"`);
+  }
+  cfg.default_profile = name;
+  saveGlobalConfig(cfg);
+  success(`Default profile set to "${name}" (${cfg.profiles[name].api_url})`);
+}

package/src/commands/resources.ts

@@ -0,0 +1,85 @@
+import {
+  buildCrudParams,
+  listResourceTypes,
+  proxyMethodForVerb,
+  resolveResourceType,
+  type CrudVerb,
+} from '../lib/resources.js';
+import { resolveResourceSchema } from '../lib/forms/index.js';
+import { isInteractive, promptTag } from '../lib/forms/prompt.js';
+import { toInteractiveOpts, type CommandInteractiveFlags } from '../lib/interactive-opts.js';
+import { bodyRequiredHint, resolveBody } from '../lib/read-body.js';
+import { requireSession, getSdkProxy } from '../lib/proxy/context.js';
+import { printJson } from '../lib/output.js';
+
+const CRUD_VERBS: CrudVerb[] = ['create', 'list', 'get', 'update', 'delete', 'connect'];
+
+export function runResourcesList(json: boolean): void {
+  printJson({ resource_types: listResourceTypes() }, json);
+}
+
+export async function runResourceCrud(
+  typeName: string,
+  verb: string,
+  opts: { tag?: string; file?: string; json?: boolean } & CommandInteractiveFlags,
+  extraArgs: string[],
+): Promise<void> {
+  const crud = verb.toLowerCase() as CrudVerb;
+  if (!CRUD_VERBS.includes(crud)) {
+    throw new Error(`Unknown verb "${verb}". Use: ${CRUD_VERBS.join(', ')}`);
+  }
+
+  const session = requireSession();
+  const module = resolveResourceType(typeName);
+
+  if (module === 'product' || module === 'app') {
+    if (crud === 'list') {
+      throw new Error(
+        `Use \`ductape ${module}s list\` — listing uses the workspace REST API (not sdk-proxy).`,
+      );
+    }
+    if (crud === 'delete') {
+      throw new Error(`Use \`ductape ${module}s delete --id <id>\`.`);
+    }
+  }
+
+  const method = proxyMethodForVerb(crud);
+  const interactive = toInteractiveOpts(opts);
+  let tag = opts.tag ?? extraArgs[0];
+  if (!tag && ['get', 'update', 'delete'].includes(crud) && isInteractive(interactive)) {
+    tag = await promptTag('Component tag');
+  }
+
+  const needsBody = crud === 'create' || crud === 'update' || crud === 'connect';
+  const schema = needsBody ? resolveResourceSchema(module, crud) : undefined;
+  const body = needsBody
+    ? await resolveBody({
+        ...interactive,
+        file: opts.file,
+        schema,
+        patch: crud === 'update',
+        requireBody: crud === 'create',
+      })
+    : undefined;
+
+  if (crud === 'create' && (!body || Object.keys(body).length === 0)) {
+    throw new Error(`create requires a body. ${bodyRequiredHint(`${module}:create`)}`);
+  }
+
+  let payload = body;
+  if (crud === 'connect' && tag) {
+    payload = {
+      ...(payload && typeof payload === 'object' ? (payload as Record<string, unknown>) : {}),
+      tag,
+    };
+  }
+
+  const params = buildCrudParams(module, method, session.project.product_tag, {
+    tag,
+    body: payload,
+  });
+
+  const proxy = getSdkProxy(session);
+  const result = await proxy.execute(module, method, params);
+  printJson(result, Boolean(opts.json));
+}

package/src/commands/secrets.ts

@@ -0,0 +1,46 @@
+import { isInteractive, promptKey } from '../lib/forms/prompt.js';
+import { toInteractiveOpts, type CommandInteractiveFlags } from '../lib/interactive-opts.js';
+import { bodyRequiredHint, resolveBody } from '../lib/read-body.js';
+import { buildCrudParams, proxyMethodForVerb, type CrudVerb } from '../lib/resources.js';
+import { getSdkProxy, requireSession } from '../lib/proxy/context.js';
+import { printJson } from '../lib/output.js';
+
+const VERBS: CrudVerb[] = ['create', 'list', 'get', 'update', 'delete'];
+
+export async function runSecrets(
+  verb: string,
+  opts: { key?: string; file?: string; json?: boolean } & CommandInteractiveFlags,
+): Promise<void> {
+  const crud = verb.toLowerCase() as CrudVerb;
+  if (!VERBS.includes(crud)) {
+    throw new Error(`Unknown secrets verb "${verb}". Use: ${VERBS.join(', ')}`);
+  }
+
+  const session = requireSession();
+  const method = proxyMethodForVerb(crud);
+  const interactive = toInteractiveOpts(opts);
+  let key = opts.key;
+  if (!key && ['fetch', 'delete', 'update'].includes(method) && isInteractive(interactive)) {
+    key = await promptKey();
+  }
+  const body =
+    crud === 'create' || crud === 'update'
+      ? await resolveBody({
+          ...interactive,
+          file: opts.file,
+          schemaKey: `secrets:${crud}`,
+          patch: crud === 'update',
+          requireBody: crud === 'create',
+        })
+      : undefined;
+  if (crud === 'create' && (!body || Object.keys(body).length === 0)) {
+    throw new Error(`create requires a body. ${bodyRequiredHint('secrets:create')}`);
+  }
+  const params = buildCrudParams('secrets', method, session.project.product_tag, {
+    tag: key,
+    body,
+  });
+
+  const result = await getSdkProxy(session).execute('secrets', method, params);
+  printJson(result, Boolean(opts.json));
+}

package/src/commands/unlink.ts

@@ -0,0 +1,15 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { findProjectConfig, PROJECT_CONFIG_PATH } from '../lib/config.js';
+import { success } from '../lib/output.js';
+
+export function runUnlink(opts: { dir?: string }): void {
+  const dir = path.resolve(opts.dir ?? process.cwd());
+  const found = findProjectConfig(dir);
+  if (!found) {
+    throw new Error('No linked project in this directory');
+  }
+  const configPath = path.join(found.dir, PROJECT_CONFIG_PATH);
+  fs.unlinkSync(configPath);
+  success(`Removed ${configPath}`);
+}

package/src/commands/whoami.ts

@@ -0,0 +1,27 @@
+import { getActiveProfileName, getApiUrl, loadCredentials, loadGlobalConfig, findProjectConfig } from '../lib/config.js';
+import { getActiveWorkspace } from '../lib/workspaces.js';
+import { printJson } from '../lib/output.js';
+
+export function runWhoami(json: boolean): void {
+  const creds = loadCredentials();
+  const project = findProjectConfig();
+  const active = getActiveWorkspace();
+  const profile = project?.config
+    ? getActiveProfileName(project.config)
+    : loadGlobalConfig().default_profile;
+
+  printJson(
+    {
+      logged_in: Boolean(creds),
+      email: creds?.email,
+      user_id: creds?.user_id,
+      profile,
+      api_url: getApiUrl(profile),
+      active_workspace: active
+        ? { id: active.id, name: active.name }
+        : null,
+      project: project?.config ?? null,
+    },
+    json,
+  );
+}

package/src/commands/workspaces.ts

@@ -0,0 +1,98 @@
+import {
+  applyActiveWorkspace,
+  fetchWorkspaces,
+  getActiveWorkspace,
+  printWorkspaceTable,
+  promptWorkspaceSelection,
+  selectAndApplyWorkspace,
+  workspaceId,
+  workspaceLabel,
+} from '../lib/workspaces.js';
+import { printJson, success } from '../lib/output.js';
+
+export async function runWorkspacesList(opts: {
+  profile?: string;
+  json?: boolean;
+  refresh?: boolean;
+}): Promise<void> {
+  const workspaces = await fetchWorkspaces(opts.profile);
+  const active = getActiveWorkspace();
+
+  if (opts.json) {
+    printJson(
+      {
+        active_workspace_id: active?.id ?? null,
+        active_workspace_name: active?.name ?? null,
+        workspaces,
+      },
+      true,
+    );
+    return;
+  }
+
+  if (active) {
+    console.log(`Active workspace: ${active.name ?? active.id}`);
+    console.log(`  ${active.id}\n`);
+  }
+  printWorkspaceTable(workspaces, active?.id);
+}
+
+export function runWorkspacesCurrent(json: boolean): void {
+  const active = getActiveWorkspace();
+  if (!active) {
+    if (json) {
+      printJson({ active: null }, true);
+      return;
+    }
+    console.log('No active workspace. Run: ductape login or ductape workspaces use');
+    return;
+  }
+  if (json) {
+    printJson({ active_workspace_id: active.id, active_workspace_name: active.name }, true);
+    return;
+  }
+  console.log(`Active workspace: ${active.name ?? active.id}`);
+  console.log(`  ${active.id}`);
+}
+
+export async function runWorkspacesUse(
+  selector: string | undefined,
+  opts: { profile?: string; dir?: string; json?: boolean },
+): Promise<void> {
+  const workspaces = await fetchWorkspaces(opts.profile);
+
+  let chosen;
+  if (!selector) {
+    chosen = await promptWorkspaceSelection(workspaces, {
+      message: 'Switch workspace:',
+    });
+    await applyActiveWorkspace(chosen, { syncProject: true, dir: opts.dir });
+  } else {
+    chosen = await selectAndApplyWorkspace({
+      profile: opts.profile,
+      selector,
+      skipPrompt: true,
+      syncProject: true,
+      dir: opts.dir,
+    });
+  }
+
+  const id = workspaceId(chosen);
+  const name = workspaceLabel(chosen);
+  if (opts.json) {
+    printJson({ active_workspace_id: id, active_workspace_name: name }, true);
+    return;
+  }
+  success(`Switched to workspace: ${name} (${id})`);
+}
+
+/** Refresh workspace list from API and update login cache */
+export async function runWorkspacesRefresh(opts: { profile?: string; json?: boolean }): Promise<void> {
+  const workspaces = await fetchWorkspaces(opts.profile);
+  if (opts.json) {
+    printJson({ workspaces, count: workspaces.length }, true);
+    return;
+  }
+  success(`Refreshed ${workspaces.length} workspace(s) from API`);
+  await runWorkspacesList({ profile: opts.profile, json: false });
+}

package/src/index.ts

@@ -0,0 +1,381 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import { runLogin } from './commands/login.js';
+import { runLogout } from './commands/logout.js';
+import { runWhoami } from './commands/whoami.js';
+import { runProfilesList, runProfilesUse } from './commands/profiles.js';
+import { runLink } from './commands/link.js';
+import { runUnlink } from './commands/unlink.js';
+import { runInit } from './commands/init.js';
+import { runInstall } from './commands/install.js';
+import { runStart, runStop, runStatus } from './commands/platform.js';
+import { runResourceCrud, runResourcesList } from './commands/resources.js';
+import { runCloud } from './commands/cloud.js';
+import { runDb, runDbContext } from './commands/db.js';
+import { runGraph } from './commands/graph.js';
+import { runSecrets } from './commands/secrets.js';
+import {
+  runWorkspacesCurrent,
+  runWorkspacesList,
+  runWorkspacesRefresh,
+  runWorkspacesUse,
+} from './commands/workspaces.js';
+import { runGeneratePayload, runGenerateSnippet } from './commands/generate.js';
+import { runCompletion } from './commands/completion.js';
+import { runProducts, runProductApps } from './commands/products.js';
+import { runApps } from './commands/apps.js';
+import { runAppsImport } from './commands/apps-import.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(
+  readFileSync(path.join(__dirname, '../package.json'), 'utf8'),
+) as { version: string };
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function wrap(fn: (...args: any[]) => void | Promise<void>) {
+  return (...args: any[]) => {
+    Promise.resolve(fn(...args)).catch((err: unknown) => {
+      console.error(err instanceof Error ? err.message : err);
+      process.exit(1);
+    });
+  };
+}
+
+const program = new Command();
+program
+  .name('ductape')
+  .description(
+    'Ductape CLI — local platform, auth, project linking, and resource CRUD via Workbench-compatible encrypted proxy',
+  )
+  .version(pkg.version);
+
+program
+  .command('login')
+  .description('Log in (email/password, OAuth token, or browser OAuth)')
+  .option('-e, --email <email>')
+  .option('-p, --password <password>')
+  .option('--token <token>', 'OAuth callback token from browser redirect URL')
+  .option('--browser [provider]', 'Open browser for Google OAuth (google|github)')
+  .option('--profile <name>', 'API profile', 'cloud')
+  .option('-w, --workspace <id>', 'Workspace index, name, or id (skips interactive picker)')
+  .option('--skip-workspace-select', 'Keep prior active workspace or default without prompting')
+  .action(
+    wrap((opts) =>
+      runLogin({
+        email: opts.email,
+        password: opts.password,
+        profile: opts.profile,
+        token: opts.token,
+        browser: opts.browser === true ? 'google' : opts.browser,
+        workspace: opts.workspace,
+        skipWorkspaceSelect: Boolean(opts.skipWorkspaceSelect),
+      }),
+    ),
+  );
+
+program.command('logout').description('Clear local credentials').action(wrap(runLogout));
+
+program
+  .command('whoami')
+  .description('Show login and linked project')
+  .option('--json', 'JSON output')
+  .action(wrap((opts) => runWhoami(Boolean(opts.json))));
+
+program
+  .command('install')
+  .description('Check Docker/Node prerequisites and prepare platform .env')
+  .action(wrap(runInstall));
+
+const profiles = program.command('profiles').description('Manage API profiles (cloud / local)');
+
+profiles
+  .command('list')
+  .option('--json', 'JSON output')
+  .action(wrap((opts) => runProfilesList(Boolean(opts.json))));
+
+profiles.command('use <name>').action(wrap((name: string) => runProfilesUse(name)));
+
+const workspaces = program
+  .command('workspaces')
+  .description('List and switch active workspace (workspace_id is stored globally at login)');
+
+workspaces
+  .command('list')
+  .description('List workspaces (marks active)')
+  .option('--profile <name>')
+  .option('--json', 'JSON output')
+  .action(wrap((opts) => runWorkspacesList({ profile: opts.profile, json: opts.json })));
+
+workspaces
+  .command('current')
+  .description('Show active workspace')
+  .option('--json', 'JSON output')
+  .action(wrap((opts) => runWorkspacesCurrent(Boolean(opts.json))));
+
+workspaces
+  .command('use [selector]')
+  .description('Switch active workspace (interactive picker). Updates linked .ductape/config.json if present')
+  .option('--profile <name>')
+  .option('-C, --dir <path>', 'Project directory to sync', process.cwd())
+  .option('--json', 'JSON output')
+  .action(wrap((selector: string | undefined, opts) => runWorkspacesUse(selector, opts)));
+
+workspaces
+  .command('switch [selector]')
+  .description('Alias for workspaces use')
+  .option('--profile <name>')
+  .option('-C, --dir <path>', 'Project directory to sync', process.cwd())
+  .option('--json', 'JSON output')
+  .action(wrap((selector: string | undefined, opts) => runWorkspacesUse(selector, opts)));
+
+workspaces
+  .command('refresh')
+  .description('Refresh workspace list from API')
+  .option('--profile <name>')
+  .option('--json', 'JSON output')
+  .action(wrap((opts) => runWorkspacesRefresh(opts)));
+
+program
+  .command('link')
+  .option('-w, --workspace <id>')
+  .option('--product <tag>')
+  .option('--env <slug>')
+  .option('--profile <name>')
+  .option('-C, --dir <path>', 'Project directory', process.cwd())
+  .action(
+    wrap((opts) =>
+      runLink({
+        workspace: opts.workspace,
+        product: opts.product,
+        env: opts.env,
+        profile: opts.profile,
+        dir: opts.dir,
+      }),
+    ),
+  );
+
+program
+  .command('unlink')
+  .option('-C, --dir <path>', 'Project directory', process.cwd())
+  .action(wrap((opts) => runUnlink({ dir: opts.dir })));
+
+program
+  .command('init')
+  .option('--link', 'Run link after init')
+  .option('-w, --workspace <id>')
+  .option('--product <tag>')
+  .option('--env <slug>')
+  .option('--language <lang>', 'typescript|python|go|dotnet')
+  .action(
+    wrap((opts) =>
+      runInit({
+        link: Boolean(opts.link),
+        workspace: opts.workspace,
+        product: opts.product,
+        env: opts.env,
+        language: opts.language,
+      }),
+    ),
+  );
+
+program
+  .command('start')
+  .description('Start platform via docker compose')
+  .option('--backend-only', 'Backend without workbench UI')
+  .option('--remote', 'Workbench UI only, built against cloud API (no local Nest/Mongo/Kafka)')
+  .option('--build', 'Build images before start')
+  .action(
+    wrap((opts) =>
+      runStart({
+        backendOnly: Boolean(opts.backendOnly),
+        remote: Boolean(opts.remote),
+        build: Boolean(opts.build),
+      }),
+    ),
+  );
+
+program.command('stop').action(wrap(runStop));
+
+program.command('status').option('--json', 'JSON output').action(wrap((opts) => runStatus(Boolean(opts.json))));
+
+const products = program
+  .command('products')
+  .description('Workspace products CRUD (REST + sdk-proxy update)');
+
+products
+  .command('<verb>')
+  .description('list | get | create | update | delete')
+  .option('--profile <name>')
+  .option('--status <status>', 'Filter for list: all, active, draft, …', 'all')
+  .option('--id <id>', 'Product _id (get, delete)')
+  .option('-t, --tag <tag>', 'Product tag (get, update)')
+  .option('-f, --file <path>', 'JSON body (create, update)')
+  .option('-i, --interactive', 'Prompt for fields (default in TTY when -f omitted)')
+  .option('--no-interactive', 'Require -f JSON for create/update')
+  .option('--json', 'JSON output')
+  .action(
+    wrap((verb: string, opts) => runProducts(verb, opts, [])),
+  );
+
+const productApps = products.command('apps').description('Apps connected to a product');
+
+productApps
+  .command('list')
+  .option('--profile <name>')
+  .option('--product <id>', 'Product _id')
+  .option('--json', 'JSON output')
+  .action(wrap((opts) => runProductApps('list', opts, [])));
+
+const apps = program.command('apps').description('Workspace integration apps CRUD (REST)');
+
+apps
+  .command('<verb>')
+  .description('list | get | create | update | delete')
+  .option('--profile <name>')
+  .option('--status <status>', 'Filter for list', 'all')
+  .option('--id <id>', 'App _id')
+  .option('-t, --tag <tag>', 'App tag (get; update with --proxy)')
+  .option('--proxy', 'Update via sdk-proxy (use with --tag)')
+  .option('-f, --file <path>', 'JSON body')
+  .option('-i, --interactive', 'Prompt for fields (default in TTY when -f omitted)')
+  .option('--no-interactive', 'Require -f JSON for create/update')
+  .option('--json', 'JSON output')
+  .action(wrap((verb: string, opts) => runApps(verb, opts, [])));
+
+apps
+  .command('import <file>')
+  .description('Import Postman v2.1 or OpenAPI 3.0 into a new or existing app')
+  .requiredOption(
+    '-t, --type <format>',
+    'postman | openapi (Postman Collection v2.1 or OpenAPI 3.0)',
+  )
+  .option('--profile <name>')
+  .option('--app-id <id>', 'Update existing app by _id')
+  .option('--app-tag <tag>', 'Update existing app by tag')
+  .option('--update', 'Replace/update if app already exists')
+  .option('--version <tag>', 'App version tag', '0.0.1')
+  .option('--json', 'JSON output')
+  .action(
+    wrap((file: string, opts) =>
+      runAppsImport(file, {
+        profile: opts.profile,
+        type: opts.type,
+        appId: opts.appId,
+        appTag: opts.appTag,
+        update: Boolean(opts.update),
+        version: opts.version,
+        json: opts.json,
+      }),
+    ),
+  );
+
+const resources = program.command('resources').description('Component CRUD (sdk-proxy)');
+
+resources.command('types').option('--json', 'JSON output').action(wrap((opts) => runResourcesList(Boolean(opts.json))));
+
+resources
+  .command('<type> <verb>')
+  .option('-t, --tag <tag>')
+  .option('-f, --file <path>', 'JSON body (or use interactive prompts)')
+  .option('-i, --interactive', 'Prompt for fields (default in TTY when -f omitted)')
+  .option('--no-interactive', 'Require -f JSON for create/update/connect')
+  .option('--json', 'JSON output')
+  .action(
+    wrap((type: string, verb: string, opts) => runResourceCrud(type, verb, opts, [])),
+  );
+
+const cloud = program.command('cloud').description('Cloud connections & resources');
+
+cloud
+  .command('connections <verb> [id]')
+  .option('-f, --file <path>')
+  .option('--json', 'JSON output')
+  .action(
+    wrap((verb: string, id: string | undefined, opts) =>
+      runCloud('connections', verb, { id, file: opts.file, json: opts.json }, []),
+    ),
+  );
+
+cloud
+  .command('resources <verb>')
+  .option('-f, --file <path>')
+  .option('--json', 'JSON output')
+  .action(wrap((verb: string, opts) => runCloud('resources', verb, { file: opts.file, json: opts.json }, [])));
+
+const db = program.command('db').description('Database runtime (db-proxy)');
+
+db.command('context').option('--json', 'JSON output').action(wrap((opts) => runDbContext(Boolean(opts.json))));
+
+db
+  .command('<verb>')
+  .option('-f, --file <path>')
+  .option('--json', 'JSON output')
+  .action(wrap((verb: string, opts) => runDb(verb, { file: opts.file, json: opts.json })));
+
+const graph = program.command('graph').description('Graph runtime (graph-proxy)');
+
+graph
+  .command('<verb>')
+  .option('-f, --file <path>')
+  .option('--json', 'JSON output')
+  .action(wrap((verb: string, opts) => runGraph(verb, { file: opts.file, json: opts.json })));
+
+program
+  .command('secrets <verb>')
+  .description('Workspace secrets CRUD')
+  .option('-k, --key <key>')
+  .option('-f, --file <path>')
+  .option('-i, --interactive', 'Prompt for fields (default in TTY when -f omitted)')
+  .option('--no-interactive', 'Require -f JSON for create/update')
+  .option('--json', 'JSON output')
+  .action(
+    wrap((verb: string, opts) =>
+      runSecrets(verb, opts),
+    ),
+  );
+
+const generate = program.command('generate').description('Payload templates & code snippets');
+
+generate
+  .command('payload <family> <method>')
+  .option('-f, --file <path>', 'targets JSON')
+  .option('--json', 'JSON output')
+  .action(
+    wrap((family: string, method: string, opts) =>
+      runGeneratePayload({ family, method, file: opts.file, json: opts.json }),
+    ),
+  );
+
+generate
+  .command('snippet <family> <method>')
+  .requiredOption('-l, --language <lang>', 'typescript|python|go|dotnet')
+  .option('-f, --file <path>')
+  .option('-o, --out <path>', 'Write snippet to file')
+  .option('--json', 'JSON output')
+  .action(
+    wrap((family: string, method: string, opts) =>
+      runGenerateSnippet({
+        family,
+        method,
+        language: opts.language,
+        file: opts.file,
+        json: opts.json,
+        out: opts.out,
+      }),
+    ),
+  );
+
+program
+  .command('completion <shell>')
+  .description('Print shell completions (bash|zsh)')
+  .action(wrap((shell: string) => {
+    if (shell !== 'bash' && shell !== 'zsh' && shell !== 'fish') {
+      throw new Error('Shell must be bash, zsh, or fish');
+    }
+    runCompletion(shell);
+  }));
+
+program.parse();