botanary 0.1.0 → 0.2.0

package/dist/src/commands/system.js

@@ -1,15 +1,26 @@
-import { runDiagnose, botanaryMcpHome } from 'botanary-mcp';
+import { runDiagnose, botanaryMcpHome, openBrowser } from 'botanary-mcp';
 import { renderTable } from '../render/table.js';
-import { glyphs } from '../render/colors.js';
+import { colors, glyphs } from '../render/colors.js';
+import { columns, section } from '../render/kv.js';
+import { group, DOCS_URL } from '../help/groups.js';
+import { CONFIG_KEYS, assertKnownKey, configPath, readConfig, validateEntry, writeConfig } from '../config-store.js';
+import { step } from '../progress.js';
+import { printResult } from '../render/print.js';
+/** Which resolved setting each config key feeds, so `config list` can show the value actually in force. */
+const KEY_TO_SETTING = {
+    chainId: 'chain',
+    accountId: 'account',
+    apiUrl: 'apiUrl',
+    output: 'json',
+    color: 'color',
+    confirm: 'yes',
+};
 export function registerSystemCommands(program, cliVersion) {
-    program
-        .command('diagnose')
-        .description('START HERE when anything is unclear or an action failed - one call answers what is blocking the next step')
-        .action(async () => {
+    const diagnoseAction = async () => {
         const ctx = program.opts().__ctx;
-        const report = await runDiagnose(ctx.runtime);
-        if (ctx.json) {
-            console.log(JSON.stringify(report));
+        const report = await step(ctx, 'Checking what is blocking the next step', () => runDiagnose(ctx.runtime));
+        if (ctx.json || ctx.raw) {
+            console.log(ctx.json ? JSON.stringify(report) : JSON.stringify(report, null, 2));
             return;
         }
         console.log(report.summary);
@@ -17,15 +28,24 @@ export function registerSystemCommands(program, cliVersion) {
             console.log(blocker.severity === 'blocking' ? glyphs.danger(blocker.detail) : glyphs.warning(blocker.detail));
             console.log(`  ${blocker.nextAction}`);
         }
-    });
-    program
+    };
+    group(program
+        .command('diagnose')
+        .description('Start here when anything is unclear or an action failed')
+        .action(diagnoseAction), 'System');
+    // Every CLI in this space calls it `doctor`, so that is what people type. Same action, not a wrapper
+    // that could drift.
+    group(program.command('doctor').description('The same readiness check as diagnose').action(diagnoseAction), 'System');
+    const config = group(program
         .command('config')
-        .description('Where identity/session live and which env vars are active - unauthenticated, safe')
+        .description('Where identity and session live, and this machine\'s CLI defaults')
         .action(() => {
         const ctx = program.opts().__ctx;
         const rows = [
             ['home', botanaryMcpHome()],
+            ['config file', configPath()],
             ['BOTANARY_API_URL', process.env.BOTANARY_API_URL ?? '(not set, defaults to https://api.app.botanary.xyz)'],
+            ['api url in use', ctx.settings.apiUrl ?? 'https://api.app.botanary.xyz'],
             ['cli-version', cliVersion],
         ];
         if (ctx.json) {
@@ -33,6 +53,83 @@ export function registerSystemCommands(program, cliVersion) {
             return;
         }
         console.log(renderTable(rows));
+    }), 'System');
+    config
+        .command('list')
+        .description('Every setting, its value, and where that value came from')
+        .action(async () => {
+        const ctx = program.opts().__ctx;
+        const file = await readConfig();
+        const settings = ctx.settings;
+        const rows = CONFIG_KEYS.map((key) => {
+            const settingName = KEY_TO_SETTING[key];
+            return [
+                key,
+                String(file[key] ?? '-'),
+                String(settings[settingName] ?? '-'),
+                // The whole point of this command: a stored value that overrides nothing looks identical to one
+                // silently retargeting every command, unless the source is shown.
+                ctx.settings.provenance[settingName] ?? 'default',
+            ];
+        });
+        if (ctx.json) {
+            console.log(JSON.stringify(rows.map(([k, stored, inForce, from]) => ({ key: k, stored, inForce, from }))));
+            return;
+        }
+        console.log([section('Config'), columns(['KEY', 'STORED', 'IN FORCE', 'FROM'], rows), colors.dim(`  ${configPath()}`)].join('\n'));
+    });
+    config
+        .command('get <key>')
+        .description('Print one stored config value')
+        .action(async (key) => {
+        const ctx = program.opts().__ctx;
+        const narrowed = assertKnownKey(key);
+        const file = await readConfig();
+        const value = file[narrowed];
+        console.log(ctx.json ? JSON.stringify({ key: narrowed, value: value ?? null }) : (value ?? '(unset)'));
+    });
+    config
+        .command('set <key> <value>')
+        .description('Store a default for one setting')
+        .action(async (key, value) => {
+        const ctx = program.opts().__ctx;
+        const entry = validateEntry(key, value);
+        const next = { ...(await readConfig()), [entry.key]: entry.value };
+        await writeConfig(next);
+        console.log(ctx.json ? JSON.stringify({ key: entry.key, value: entry.value }) : glyphs.success(`${entry.key} = ${entry.value}`));
     });
+    config
+        .command('unset <key>')
+        .description('Remove one stored default')
+        .action(async (key) => {
+        const ctx = program.opts().__ctx;
+        const narrowed = assertKnownKey(key);
+        const next = { ...(await readConfig()) };
+        delete next[narrowed];
+        await writeConfig(next);
+        console.log(ctx.json ? JSON.stringify({ key: narrowed, value: null }) : glyphs.success(`${narrowed} unset`));
+    });
+    group(program
+        .command('version')
+        .description('Print the installed botanary CLI version')
+        .action(() => {
+        const ctx = program.opts().__ctx;
+        printResult(ctx, { version: cliVersion }, () => cliVersion);
+    }), 'Utilities');
+    group(program
+        .command('docs [topic]')
+        .description('Open the Botanary documentation in your browser')
+        .action(async (topic) => {
+        const ctx = program.opts().__ctx;
+        // A topic becomes a docs path directly. No invented topic map: an unrecognised one lands on the
+        // docs site's own 404, which is a truthful answer rather than a guess at where it moved.
+        const url = topic ? `${DOCS_URL}/docs/${encodeURIComponent(topic)}` : DOCS_URL;
+        const opened = await openBrowser(url);
+        if (ctx.json) {
+            console.log(JSON.stringify({ url, opened }));
+            return;
+        }
+        console.log(opened ? glyphs.success(`Opened ${url}`) : glyphs.info(`Docs: ${url}`));
+    }), 'Utilities');
 }
 //# sourceMappingURL=system.js.map

package/dist/src/commands/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../src/commands/system.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAE,UAAkB;IACzE,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,2GAA2G,CAAC;SACxH,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,GAAG,GAAe,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YAC9G,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,mFAAmF,CAAC;SAChG,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,GAAG,GAAe,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QAC7C,MAAM,IAAI,GAAuB;YAC/B,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;YAC3B,CAAC,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,qDAAqD,CAAC;YAC3G,CAAC,aAAa,EAAE,UAAU,CAAC;SAC5B,CAAC;QACF,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../src/commands/system.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/utilities.js

@@ -0,0 +1,44 @@
+import { group } from '../help/groups.js';
+import { SHELLS, completionScript } from '../completion.js';
+import { promptDoc } from '../prompt-doc.js';
+import { step } from '../progress.js';
+import { glyphs } from '../render/colors.js';
+import { checkForUpdate, nagLine } from '../update-check.js';
+export function registerUtilityCommands(program, cliVersion) {
+    group(program
+        .command('completion <shell>')
+        .description(`Print a shell completion script (${SHELLS.join(', ')})`)
+        .action((shell) => {
+        // Written to stdout raw, with no glyphs or color: its destination is a shell profile.
+        process.stdout.write(completionScript(shell, program));
+    }), 'Utilities');
+    group(program
+        .command('prompt')
+        .description('Print the full operating manual for an automation driving this CLI')
+        .action(() => {
+        const ctx = program.opts().__ctx;
+        const doc = promptDoc(program, cliVersion);
+        if (ctx.json) {
+            console.log(JSON.stringify({ prompt: doc }));
+            return;
+        }
+        process.stdout.write(doc);
+    }), 'Utilities');
+    group(program
+        .command('update-check')
+        .description('Check whether a newer botanary is published')
+        .action(async () => {
+        const ctx = program.opts().__ctx;
+        const result = await step(ctx, 'Asking npm', () => checkForUpdate(cliVersion, { fetchImpl: fetch, now: () => Date.now(), force: true }));
+        if (ctx.json) {
+            console.log(JSON.stringify(result));
+            return;
+        }
+        if (result.latest === null) {
+            console.log(glyphs.info('Could not reach the npm registry. Nothing changed.'));
+            return;
+        }
+        console.log(result.newer ? glyphs.warning(nagLine(result.latest, cliVersion)) : glyphs.success(`Up to date (${cliVersion}).`));
+    }), 'Utilities');
+}
+//# sourceMappingURL=utilities.js.map

package/dist/src/commands/utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../../src/commands/utilities.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,UAAU,uBAAuB,CAAC,OAAgB,EAAE,UAAkB;IAC1E,KAAK,CACH,OAAO;SACJ,OAAO,CAAC,oBAAoB,CAAC;SAC7B,WAAW,CAAC,oCAAoC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;SACrE,MAAM,CAAC,CAAC,KAAa,EAAE,EAAE;QACxB,sFAAsF;QACtF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,EACJ,WAAW,CACZ,CAAC;IAEF,KAAK,CACH,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oEAAoE,CAAC;SACjF,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,GAAG,GAAe,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QAC7C,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3C,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC,EACJ,WAAW,CACZ,CAAC;IAEF,KAAK,CACH,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,GAAG,GAAe,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAChD,cAAc,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CACrF,CAAC;QACF,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC,CAAC;YAC/E,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,UAAU,IAAI,CAAC,CAAC,CAAC;IACjI,CAAC,CAAC,EACJ,WAAW,CACZ,CAAC;AACJ,CAAC"}