@learncard/cli 3.4.17 → 3.5.1

package/src/index.tsx

@@ -19,6 +19,8 @@ import { getLerRsPlugin } from '@learncard/ler-rs-plugin';
 import { getRenderMethodPlugin } from '@learncard/render-method-plugin';
 
 import { generateRandomSeed } from './random';
+import { runSend } from './send';
+import { out } from './out';
 import {
     createLearnCardBundle,
     exportLearnCardBundle as writeLearnCardBundle,
@@ -300,7 +302,7 @@ const startReadlineRepl = async (colorize?: (input: string) => string): Promise<
             );
         } catch (error) {
             process.stdout.write(
-                `${error instanceof Error ? error.stack ?? error.message : String(error)}\n`
+                `${error instanceof Error ? (error.stack ?? error.message) : String(error)}\n`
             );
         }
 
@@ -327,162 +329,486 @@ const startCliRepl = async (colorize: (input: string) => string): Promise<void>
 };
 
 program
-    .version(packageJson.version)
-    .argument('[seed]')
-    .action(async (_seed: string = generateRandomSeed()) => {
-        console.clear();
-
-        const envSeed = process.env.LEARNCARD_CLI_SEED ?? process.env.SEED;
-        const seedInput = envSeed ?? _seed;
-        const seed = seedInput.padStart(64, '0');
-
-        console.log(
-            gradient(['cyan', 'green'])(figlet.textSync('Learn Card', 'Big Money-ne' as any))
-        );
-        console.log('Welcome to the Learn Card CLI!\n');
-
-        console.log(`Your seed is ${seed}\n`);
-
-        if (envSeed) {
-            console.log('Using seed from LEARNCARD_CLI_SEED / SEED.\n');
+    .command('send <email>')
+    .description(
+        'Send a "Quickstart Complete" badge to an email address. Creates .env and send.mjs in the current folder.'
+    )
+    .option('-y, --yes', 'accept defaults without prompting')
+    .option('--name <displayName>', 'display name for your issuer profile')
+    .option('--badge <name>', 'name of the badge to send (default: "Quickstart Complete")')
+    .option('--description <text>', 'badge description')
+    .option(
+        '--profile-id <id>',
+        'public handle for your profile (default: derived from the display name)'
+    )
+    .option('--network <url>', 'network tRPC URL (default: production)')
+    .option('--template', 'send using a reusable template and hosted signing authority')
+    .option('--template-uri <uri>', 'send from a specific template (implies --template)')
+    .option('--webhook-url <url>', 'receive ISSUANCE_DELIVERED / ISSUANCE_CLAIMED at this URL')
+    .option('--suppress-delivery', 'skip the claim email; you deliver inbox.claimUrl yourself')
+    .option(
+        '--guardian-email <email>',
+        "require a guardian's approval before the recipient can claim"
+    )
+    .option('--json', 'print a single JSON result on stdout')
+    .action(
+        async (
+            email: string,
+            opts: {
+                yes?: boolean;
+                name?: string;
+                badge?: string;
+                description?: string;
+                profileId?: string;
+                network?: string;
+                template?: boolean;
+                json?: boolean;
+            }
+        ) => {
+            out.json = !!opts.json;
+            out.result = {};
+            const didkit = fs.readFile(
+                require.resolve('@learncard/didkit-plugin/dist/didkit/didkit_wasm_bg.wasm')
+            );
+            try {
+                await runSend(email, { ...opts, didkit });
+                if (out.json) {
+                    process.stdout.write(
+                        JSON.stringify({ ok: true, command: 'send', ...out.result }) + '\n'
+                    );
+                }
+                process.exit(0);
+            } catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                const firstLine = message.split('\n')[0]!;
+                if (out.json) {
+                    process.stdout.write(
+                        JSON.stringify({ ok: false, command: 'send', error: firstLine }) + '\n'
+                    );
+                    process.exit(1);
+                }
+                console.error(`\n${firstLine}`);
+                // Input mistakes explain themselves; keep the docs link for network/auth failures.
+                if (!/is not an email address/.test(firstLine))
+                    console.error(
+                        'Troubleshooting: https://docs.learncard.com/start-here/your-first-integration#if-something-goes-wrong'
+                    );
+                process.exit(1);
+            }
         }
-
-        console.log('Creating wallet...');
-
-        cliGlobals.seed = seed;
-        cliGlobals.generateRandomSeed = generateRandomSeed;
-        cliGlobals.emptyLearnCard = emptyLearnCard;
-        cliGlobals.learnCardFromSeed = learnCardFromSeed;
-        cliGlobals.initLearnCard = initLearnCard;
-
-        const didkit = fs.readFile(
-            require.resolve('@learncard/didkit-plugin/dist/didkit/didkit_wasm_bg.wasm')
-        );
-
-        const _learnCard = await initLearnCard({
-            seed,
-            network: true,
-            allowRemoteContexts: true,
-            didkit,
-        });
-
-        const lcaApiLc = await _learnCard.addPlugin(
-            await getLCAPlugin(_learnCard, 'https://api.learncard.app/trpc')
-        );
-
-        cliGlobals.learnCard = await lcaApiLc.addPlugin(getLerRsPlugin(lcaApiLc));
-        // Add LinkedClaims plugin so endorse/verify/store/getEndorsements are available in the CLI
-        cliGlobals.learnCard = await cliGlobals.learnCard.addPlugin(
-            getLinkedClaimsPlugin(cliGlobals.learnCard)
+    );
+
+const commandOptions = (command: ReturnType<typeof program.command>) =>
+    command
+        .option('-y, --yes', 'accept defaults without prompting')
+        .option('--profile-id <id>', 'public handle for your issuer profile')
+        .option('--network <url>', 'network tRPC URL or staging (default: production)')
+        .option('--json', 'print a single JSON result on stdout');
+
+/**
+ * Shared runner for every subcommand except `send` (which has its own didkit/error
+ * formatting). Sets up `out` for this run and, in `--json` mode, prints exactly one
+ * envelope on stdout instead of the human-mode stderr message. Pass `wrap: false` for
+ * commands (only `verify` today) that already print their own `--json` output.
+ */
+const runCommand = async (
+    command: string,
+    options: { json?: boolean },
+    action: (didkit: Promise<Buffer>) => Promise<void>,
+    wrap: boolean = true
+) => {
+    out.json = !!options.json;
+    out.result = {};
+    try {
+        await action(
+            fs.readFile(require.resolve('@learncard/didkit-plugin/dist/didkit/didkit_wasm_bg.wasm'))
         );
+        if (out.json && wrap) {
+            process.stdout.write(JSON.stringify({ ok: true, command, ...out.result }) + '\n');
+        }
+        process.exit(process.exitCode || 0);
+    } catch (error) {
+        const message =
+            error instanceof Error
+                ? error.message.split('\n')[0]!
+                : 'Command failed. Please try again.';
+        if (out.json && wrap) {
+            process.stdout.write(JSON.stringify({ ok: false, command, error: message }) + '\n');
+            process.exit(1);
+        }
+        console.error(message);
+        process.exit(1);
+    }
+};
 
-        // Add OpenBadge v2 wrapper plugin for backwards-compatible OBv2 -> VC wrapping
-        cliGlobals.learnCard = await cliGlobals.learnCard.addPlugin(
-            openBadgeV2Plugin(cliGlobals.learnCard)
-        );
+commandOptions(
+    program.command('consent-contract').description("Connect a user's LearnCard to your platform.")
+)
+    .option('--name <name>', 'contract name (default: issuer display name)')
+    .option(
+        '--redirect-url <url>',
+        'callback URL (default: http://localhost:3000/consent-callback)'
+    )
+    .option('--description <text>', 'what users see when asked to consent')
+    .option(
+        '--needs-guardian-consent',
+        'GameFlow: minors need a guardian to approve the connection'
+    )
+    .action(options =>
+        runCommand('consent-contract', options, async didkit => {
+            const { runConsentContract } = await import('./consent-contract');
+            await runConsentContract({ ...options, didkit });
+        })
+    );
+
+commandOptions(program.command('embed').description('Put a Claim button on your site.'))
+    .option('--name <name>', 'integration name (default: issuer display name)')
+    .option(
+        '--domains <origins>',
+        'comma-separated origins (default: http://localhost:3000,http://localhost:5173)'
+    )
+    .option('--rotate-key', 'rotate the integration publishable key')
+    .action(options =>
+        runCommand('embed', options, async didkit => {
+            const { runEmbed } = await import('./embed');
+            await runEmbed({ ...options, didkit });
+        })
+    );
+
+commandOptions(
+    program
+        .command('setup-signing')
+        .description('Set up LearnCard to sign credentials for your project.')
+)
+    .option('--name <name>', 'signing authority name (default: default-issuer)')
+    .option('--endpoint <url>', 'register your own VC-API signing service instead (with --did)')
+    .option('--did <did>', 'DID of your own signing service (with --endpoint)')
+    .action(options =>
+        runCommand('setup-signing', options, async didkit => {
+            const { runSetupSigning } = await import('./setup-signing');
+            await runSetupSigning({ ...options, didkit });
+        })
+    );
+
+commandOptions(
+    program.command('token').description('Create a scoped API token and reusable send.sh.')
+)
+    .option('--name <name>', 'auth grant name (default: cli-<date>)')
+    .option('--scope <scope>', 'space-separated permissions (default: boosts:write)')
+    .option('--revoke <grantId>', 'revoke an existing auth grant')
+    .option('--expires <days>', 'token lifetime in days (default: no expiry)')
+    .option('--list', 'list your auth grants')
+    .action(options =>
+        runCommand('token', options, async didkit => {
+            const { runToken } = await import('./token');
+            await runToken({ ...options, didkit });
+        })
+    );
 
-        // Add Render Method plugin for attaching W3C renderMethod to VCs
-        cliGlobals.learnCard = await cliGlobals.learnCard.addPlugin(
-            getRenderMethodPlugin(cliGlobals.learnCard)
-        );
+program
+    .command('verify <file>')
+    .description('Verify a credential or presentation JSON file; use - for stdin.')
+    .option('--json', 'print the raw verification result')
+    .action((file, options) =>
+        runCommand(
+            'verify',
+            options,
+            async didkit => {
+                const { runVerify } = await import('./verify');
+                await runVerify(file, { ...options, didkit });
+            },
+            false
+        )
+    );
+
+commandOptions(
+    program
+        .command('revoke <credentialUri>')
+        .description('Revoke or suspend an issued credential on the network.')
+)
+    .option('--suspend', 'suspend instead of permanently revoking')
+    .option('--template-uri <uri>', 'template URI if it cannot be read from the credential')
+    .option(
+        '--recipient <profileId>',
+        'recipient profile ID if it cannot be read from the credential'
+    )
+    .action((uri, options) =>
+        runCommand('revoke', options, async didkit => {
+            const { runRevoke } = await import('./revoke');
+            await runRevoke(uri, { ...options, didkit });
+        })
+    );
+
+commandOptions(
+    program
+        .command('status [activityId]')
+        .description('What happened to a credential you sent: created, delivered, claimed.')
+)
+    .option('--limit <n>', 'how many recent sends to list (default: 20)')
+    .option(
+        '--event <type>',
+        'only list sends whose latest event is this: created|delivered|claimed|expired|failed'
+    )
+    .action((activityId, options) =>
+        runCommand('status', options, async didkit => {
+            const { runStatus } = await import('./status');
+            await runStatus(activityId, { ...options, didkit });
+        })
+    );
 
-        cliGlobals.types = types;
-        cliGlobals.getTestCache = getTestCache;
+program
+    .command('open [target]')
+    .description(
+        'Open the LearnCard app signed in as this project. Targets: portal (default), wallet, template, contract, integration.'
+    )
+    .option('-y, --yes', 'accept defaults without prompting')
+    .option('--network <url>', 'network tRPC URL or staging (default: production)')
+    .option('--app-url <url>', 'LearnCard app URL for self-hosted or local networks')
+    .option('--url-fragment', 'pass the seed in the URL fragment instead of the clipboard')
+    .option('--no-browser', 'print the URL without opening a browser')
+    .option('--json', 'print a single JSON result on stdout')
+    .action((target, options) =>
+        runCommand('open', options, async () => {
+            const { runOpen, OPEN_TARGETS } = await import('./open');
+            if (target && !(target in OPEN_TARGETS))
+                throw new Error(
+                    `Unknown target "${target}". Use one of: ${Object.keys(OPEN_TARGETS).join(', ')}.`
+                );
+            await runOpen(target, options);
+        })
+    );
+
+commandOptions(
+    program.command('webhook [email]').description('Know when your credential was claimed.')
+)
+    .option('--to <email>', 'recipient email')
+    .option('--url <publicUrl>', 'public HTTPS webhook URL')
+    .option('--port <n>', 'receiver port (default: 8787)')
+    .option('--name <name>', 'display name for your issuer profile')
+    .option(
+        '--timeout <seconds>',
+        'in --json mode, seconds to wait for webhook events (default: 60)'
+    )
+    .option('--wait-for-claim', 'in --json mode, also wait for ISSUANCE_CLAIMED before exiting')
+    .action((email, options) =>
+        runCommand('webhook', options, async didkit => {
+            const { runWebhook } = await import('./webhook');
+            await runWebhook(email, { ...options, didkit });
+        })
+    );
+
+const JOURNEY = [
+    'send',
+    'status',
+    'setup-signing',
+    'token',
+    'webhook',
+    'consent-contract',
+    'embed',
+    'verify',
+    'revoke',
+    'open',
+    'init',
+    'repl',
+];
 
-        cliGlobals.copy = copyFunction;
-        cliGlobals.getLearnCardBundlePassword = getLearnCardBundlePassword;
-        cliGlobals.exportLearnCardBundle = createExportLearnCardBundleHelper(
-            writeLearnCardBundle,
-            cliGlobals.learnCard
-        );
+program
+    .name('learncard')
+    .description(
+        'Issue, track, and verify credentials from the terminal. Every command shares the .env in the current folder.'
+    )
+    .showSuggestionAfterError()
+    .configureHelp({
+        sortSubcommands: false,
+        visibleCommands: cmd =>
+            [...cmd.commands].sort((a, b) => JOURNEY.indexOf(a.name()) - JOURNEY.indexOf(b.name())),
+    })
+    .addHelpText(
+        'before',
+        '\nStart here:  npx @learncard/cli send you@example.com\nThen:        npx @learncard/cli status\n'
+    )
+    .addHelpText(
+        'after',
+        '\nEvery command: -y skips prompts, --json prints one machine-readable result, --network staging|<url> picks the network.\n' +
+            'Environment:\n' +
+            '  LC_YES=1  Same as passing -y to every command.\n' +
+            '  LCA_API_URL, NETWORK_URL  Override service URLs for self-hosted networks.\n'
+    );
+
+const runRepl = async (_seed: string = generateRandomSeed()) => {
+    console.clear();
+
+    const envSeed = process.env.LEARNCARD_CLI_SEED ?? process.env.SEED;
+    const seedInput = envSeed ?? _seed;
+    const seed = seedInput.padStart(64, '0');
+
+    console.log(
+        gradient(['cyan', 'green'])(figlet.textSync('Learn Card', { font: 'Big Money-ne' }))
+    );
+    console.log('Welcome to the Learn Card CLI!\n');
+
+    console.log(`Your seed is ${seed}\n`);
+
+    if (envSeed) {
+        console.log('Using seed from LEARNCARD_CLI_SEED / SEED.\n');
+    }
 
-        cliGlobals.restoreLearnCardFromBundle = createRestoreLearnCardFromBundleHelper(
-            restoreBundle,
-            {
-                network: true,
-                allowRemoteContexts: true,
-                didkit,
-            }
-        );
-        cliGlobals.importLearnCardBundle = importLearnCardBundle;
-        cliGlobals.createLearnCardBundle = createLearnCardBundle;
-        cliGlobals.readLearnCardBundle = readLearnCardBundle;
-
-        // delete 'Creating wallet...' message
-        process.stdout.moveCursor?.(0, -1);
-        process.stdout.clearLine?.(1);
-
-        console.log('Wallet created!\n');
-
-        console.log('┌───────────────────────────────────────────────────────────────┐');
-        console.log('│                        Variables Available                    │');
-        console.log('├────────────────────────────┬──────────────────────────────────┤');
-        console.log('│      Variable              │             Description          │');
-        console.log('├────────────────────────────┼──────────────────────────────────┤');
-        console.log(`│                  ${g.learnCard} │ Learn Card Wallet                │`);
-        console.log(`│              ${g.initLearnCard} │ Wallet Instantiation Function    │`);
-        console.log(`│                       ${g.seed} │ Seed used to generate wallet     │`);
-        console.log(`│         ${g.generateRandomSeed} │ Generates a random seed          │`);
-        console.log(`│                      ${g.types} │ Helpful zod validators           │`);
-        console.log(`│                       ${g.copy} │ Copy text to clipboard           │`);
-        console.log(`│ ${g.getLearnCardBundlePassword} │ Prompt for bundle password      │`);
-        console.log(`│      ${g.exportLearnCardBundle} │ Export wallet continuity ZIP     │`);
-        console.log(`│      ${g.importLearnCardBundle} │ Import continuity ZIP            │`);
-        console.log(`│ ${g.restoreLearnCardFromBundle} │ Restore original wallet from ZIP │`);
-        console.log('└────────────────────────────┴──────────────────────────────────┘');
-
-        console.log('');
-
-        console.log(
-            'For help/documentation regarding your wallet, please read the documentation at\n'
-        );
+    console.log('Creating wallet...');
 
-        console.log('https://docs.learncard.com/sdks/learncard-core/construction\n');
+    cliGlobals.seed = seed;
+    cliGlobals.generateRandomSeed = generateRandomSeed;
+    cliGlobals.emptyLearnCard = emptyLearnCard;
+    cliGlobals.learnCardFromSeed = learnCardFromSeed;
+    cliGlobals.initLearnCard = initLearnCard;
 
-        console.log("To get a feel for what's possible, try some of the following commands\n");
+    const didkit = fs.readFile(
+        require.resolve('@learncard/didkit-plugin/dist/didkit/didkit_wasm_bg.wasm')
+    );
 
-        console.log(
-            '┌─────────────────────────┬───────────────────────────────────────────────────────────────────────────────────┐'
-        );
-        console.log(
-            '│        Description      │                       Command                                                     │'
-        );
-        console.log(
-            '├─────────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤'
-        );
-        console.log(
-            `│           View your did │ ${g.learnCard}.id.did();                                                               │`
-        );
-        console.log(
-            `│ Generate an unsigned VC │ ${g.learnCard}.invoke.getTestVc();                                                     │`
-        );
-        console.log(
-            `│       Issue a signed VC │ await ${g.learnCard}.invoke.issueCredential(uvc);                                      │`
-        );
-        console.log(
-            `│      Verify a signed VC │ await ${g.learnCard}.invoke.verifyCredential(vc);                                      │`
-        );
-        console.log(
-            `│       Issue a signed VP │ await ${g.learnCard}.invoke.issuePresentation(vc);                                     │`
-        );
-        console.log(
-            `│      Verify a signed VP │ await ${g.learnCard}.invoke.verifyPresentation(vp);                                    │`
-        );
-        console.log(
-            `│  Prompt bundle password │ const password = await ${g.getLearnCardBundlePassword}();                         │`
-        );
-        console.log(
-            `│       Export wallet ZIP │ await ${g.exportLearnCardBundle}(${g.learnCard}, { out: './export.zip', password }); │`
-        );
-        console.log(
-            `│ Restore original wallet │ await ${g.restoreLearnCardFromBundle}('./export.zip', { password });                │`
-        );
-        console.log(
-            '└─────────────────────────┴───────────────────────────────────────────────────────────────────────────────────┘'
-        );
+    const _learnCard = await initLearnCard({
+        seed,
+        network: true,
+        allowRemoteContexts: true,
+        didkit,
+    });
 
-        console.log('');
+    const lcaApiLc = await _learnCard.addPlugin(
+        await getLCAPlugin(_learnCard, 'https://api.learncard.app/trpc')
+    );
+
+    cliGlobals.learnCard = await lcaApiLc.addPlugin(getLerRsPlugin(lcaApiLc));
+    // Add LinkedClaims plugin so endorse/verify/store/getEndorsements are available in the CLI
+    cliGlobals.learnCard = await cliGlobals.learnCard.addPlugin(
+        getLinkedClaimsPlugin(cliGlobals.learnCard)
+    );
+
+    // Add OpenBadge v2 wrapper plugin for backwards-compatible OBv2 -> VC wrapping
+    cliGlobals.learnCard = await cliGlobals.learnCard.addPlugin(
+        openBadgeV2Plugin(cliGlobals.learnCard)
+    );
+
+    // Add Render Method plugin for attaching W3C renderMethod to VCs
+    cliGlobals.learnCard = await cliGlobals.learnCard.addPlugin(
+        getRenderMethodPlugin(cliGlobals.learnCard)
+    );
+
+    cliGlobals.types = types;
+    cliGlobals.getTestCache = getTestCache;
+
+    cliGlobals.copy = copyFunction;
+    cliGlobals.getLearnCardBundlePassword = getLearnCardBundlePassword;
+    cliGlobals.exportLearnCardBundle = createExportLearnCardBundleHelper(
+        writeLearnCardBundle,
+        cliGlobals.learnCard
+    );
+
+    cliGlobals.restoreLearnCardFromBundle = createRestoreLearnCardFromBundleHelper(restoreBundle, {
+        network: true,
+        allowRemoteContexts: true,
+        didkit,
+    });
+    cliGlobals.importLearnCardBundle = importLearnCardBundle;
+    cliGlobals.createLearnCardBundle = createLearnCardBundle;
+    cliGlobals.readLearnCardBundle = readLearnCardBundle;
+
+    // delete 'Creating wallet...' message
+    process.stdout.moveCursor?.(0, -1);
+    process.stdout.clearLine?.(1);
+
+    console.log('Wallet created!\n');
+
+    console.log('┌───────────────────────────────────────────────────────────────┐');
+    console.log('│                        Variables Available                    │');
+    console.log('├────────────────────────────┬──────────────────────────────────┤');
+    console.log('│      Variable              │             Description          │');
+    console.log('├────────────────────────────┼──────────────────────────────────┤');
+    console.log(`│                  ${g.learnCard} │ Learn Card Wallet                │`);
+    console.log(`│              ${g.initLearnCard} │ Wallet Instantiation Function    │`);
+    console.log(`│                       ${g.seed} │ Seed used to generate wallet     │`);
+    console.log(`│         ${g.generateRandomSeed} │ Generates a random seed          │`);
+    console.log(`│                      ${g.types} │ Helpful zod validators           │`);
+    console.log(`│                       ${g.copy} │ Copy text to clipboard           │`);
+    console.log(`│ ${g.getLearnCardBundlePassword} │ Prompt for bundle password      │`);
+    console.log(`│      ${g.exportLearnCardBundle} │ Export wallet continuity ZIP     │`);
+    console.log(`│      ${g.importLearnCardBundle} │ Import continuity ZIP            │`);
+    console.log(`│ ${g.restoreLearnCardFromBundle} │ Restore original wallet from ZIP │`);
+    console.log('└────────────────────────────┴──────────────────────────────────┘');
+
+    console.log('');
+
+    console.log('For help/documentation regarding your wallet, please read the documentation at\n');
+
+    console.log('https://docs.learncard.com/sdks/learncard-core/construction\n');
+
+    console.log("To get a feel for what's possible, try some of the following commands\n");
+
+    console.log(
+        '┌─────────────────────────┬───────────────────────────────────────────────────────────────────────────────────┐'
+    );
+    console.log(
+        '│        Description      │                       Command                                                     │'
+    );
+    console.log(
+        '├─────────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤'
+    );
+    console.log(
+        `│           View your did │ ${g.learnCard}.id.did();                                                               │`
+    );
+    console.log(
+        `│ Generate an unsigned VC │ ${g.learnCard}.invoke.getTestVc();                                                     │`
+    );
+    console.log(
+        `│       Issue a signed VC │ await ${g.learnCard}.invoke.issueCredential(uvc);                                      │`
+    );
+    console.log(
+        `│      Verify a signed VC │ await ${g.learnCard}.invoke.verifyCredential(vc);                                      │`
+    );
+    console.log(
+        `│       Issue a signed VP │ await ${g.learnCard}.invoke.issuePresentation(vc);                                     │`
+    );
+    console.log(
+        `│      Verify a signed VP │ await ${g.learnCard}.invoke.verifyPresentation(vp);                                    │`
+    );
+    console.log(
+        `│  Prompt bundle password │ const password = await ${g.getLearnCardBundlePassword}();                         │`
+    );
+    console.log(
+        `│       Export wallet ZIP │ await ${g.exportLearnCardBundle}(${g.learnCard}, { out: './export.zip', password }); │`
+    );
+    console.log(
+        `│ Restore original wallet │ await ${g.restoreLearnCardFromBundle}('./export.zip', { password });                │`
+    );
+    console.log(
+        '└─────────────────────────┴───────────────────────────────────────────────────────────────────────────────────┘'
+    );
+
+    console.log('');
+
+    await startCliRepl(colorizeReplInput);
+};
 
-        await startCliRepl(colorizeReplInput);
+commandOptions(
+    program
+        .command('init')
+        .description("Create this folder's issuer identity and profile without sending anything.")
+        .option('--name <displayName>', 'display name for your issuer profile')
+).action(options =>
+    runCommand('init', options, async didkit => {
+        const { runInit } = await import('./init');
+        await runInit({ ...options, didkit });
     })
-    .parse(process.argv);
+);
+
+program
+    .command('repl [seed]')
+    .description('Interactive JavaScript console with a LearnCard preloaded (advanced).')
+    .action(runRepl);
+
+program.version(packageJson.version);
+
+// Bare `learncard` with a TTY opens the console, as it always has; anything else is a command.
+if (process.argv.length <= 2 && process.stdin.isTTY) {
+    runRepl();
+} else {
+    program.parse(process.argv);
+}