@gotillit/tllt 0.3.0

package/tllt.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+import {Command} from 'commander';
+
+import doConfigure from './configure.js';
+import doImport from './import.js';
+import doDiff from './diff.js';
+import doDeploy from './deploy.js';
+import doSchema from './schema.js';
+import {listProfiles} from './lib/config.js';
+import {setJsonMode, run, result, info} from './lib/output.js';
+
+const program = new Command();
+
+program
+  .name('tllt')
+  .description(
+    [
+      'TilliT CLI — manage TilliT configuration for the Digital Operations and Scheduler APIs.',
+      '',
+      'First run (bootstrap a connection):',
+      '  npx @gotillit/tllt configure',
+      '',
+      'A connection is identified by environment + tenant, so you can keep several',
+      '(e.g. client1 on prod and client2 on stage) and select one with --profile.',
+      '',
+      'Agents: read AGENTS.md and docs/ to learn the tool; pass --json for machine output.',
+    ].join('\n')
+  )
+  .version('0.3.0')
+  .option('-p, --profile <name>', 'connection profile to use (default: the configured default)')
+  .option('--json', 'emit machine-readable JSON on stdout (agent-friendly)');
+
+// Apply global flags before any subcommand action runs.
+program.hook('preAction', (thisCommand, actionCommand) => {
+  const globals = thisCommand.opts();
+  setJsonMode(globals.json);
+  // Make --profile available to subcommands that don't declare it themselves.
+  const merged = actionCommand.opts();
+  if (globals.profile && !merged.profile) actionCommand.setOptionValue('profile', globals.profile);
+});
+
+program
+  .command('configure')
+  .alias('init')
+  .description('Bootstrap (or update) a connection — interactive, or fully flag-driven')
+  .option('-t, --tenant <tenant>', 'tenant name')
+  .option('-e, --environment <env>', 'environment: prod | stage | sandbox | dev | enterprise')
+  .option('--enterprise <name>', 'enterprise name (when --environment enterprise), e.g. acme')
+  .option('--tier <tier>', 'enterprise tier: prod | stage | dev (default stage)')
+  .option('-a, --auth <method>', 'auth method: basic | apikey')
+  .option('-u, --username <username>', 'basic auth username')
+  .option('-w, --password <password>', 'basic auth password')
+  .option('--api-key <key>', 'apikey auth: Cognito app client id')
+  .option('--api-secret <secret>', 'apikey auth: Cognito app client secret')
+  .option('--token-url <url>', 'apikey auth: Cognito OAuth2 token endpoint')
+  .option('--scopes <list>', 'apikey auth: comma-separated OAuth scopes')
+  .option('--base-url <url>', 'override the derived base URL')
+  .option('--default', 'make this the default connection')
+  .action(run((opts) => doConfigure(opts)));
+
+program
+  .command('profiles')
+  .alias('connections')
+  .description('List configured connections')
+  .action(
+    run(() => {
+      const profiles = listProfiles();
+      for (const p of profiles) {
+        info(`${p.isDefault ? '*' : ' '} ${p.name}  [${p.method}]  ${p.baseUrl}`);
+      }
+      if (profiles.length === 0) info('No connections yet. Run `tllt configure`.');
+      result(null, {ok: true, profiles});
+    })
+  );
+
+program
+  .command('schema')
+  .description('Describe an entity data model (fields, types, required, enums, references)')
+  .argument('[entity]', 'entity name, e.g. Asset (omit to list all entities)')
+  .option('--api <api>', 'force the API: do | scheduler')
+  .action(run((entity, opts) => doSchema({...opts, entity})));
+
+program
+  .command('import')
+  .description('Snapshot the current configuration of a connection into local files')
+  .option('--api <api>', 'limit to a single API: do | scheduler')
+  .option('-d, --dir <path>', 'output directory (default: current directory)')
+  .action(run((opts) => doImport(opts)));
+
+program
+  .command('diff')
+  .description('Compare two snapshots and show the changeset (from → to)')
+  .requiredOption('-f, --from <profile>', 'source snapshot (desired state)')
+  .requiredOption('-t, --to <profile>', 'target snapshot (to be changed)')
+  .option('-o, --out <file>', 'write the changeset JSON to a file')
+  .option('-d, --dir <path>', 'snapshots directory (default: current directory)')
+  .action(run((opts) => doDiff(opts)));
+
+program
+  .command('deploy')
+  .description('Apply the difference between two snapshots to the live target')
+  .option('-f, --from <profile>', 'source snapshot (desired state)')
+  .requiredOption('-t, --to <profile>', 'target connection to change')
+  .option('--changeset <file>', 'apply a saved changeset instead of computing one')
+  .option('--api <api>', 'limit to a single API: do | scheduler')
+  .option('--dry-run', 'show what would change without applying')
+  .option('--prune', 'also delete target records missing from the source (destructive)')
+  .option('-y, --yes', 'skip the confirmation prompt')
+  .option('-d, --dir <path>', 'snapshots directory (default: current directory)')
+  .action(run((opts) => doDeploy(opts)));
+
+program.parseAsync();