@meistrari/tela-cli 0.5.0 → 0.6.0

package/README.md

@@ -26,6 +26,12 @@ Examples:
 - `tela` — Render the available repositories in a human-readable table
 - `tela --json` — Emit the available repositories as JSON
 
+## Version
+
+Examples:
+- `tela --version` — Print the current Tela CLI version
+- `tela -v` — Print the current Tela CLI version
+
 ## Commands
 
 ### `setup`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/tela-cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "bin": {
     "tela": "cli.ts"

package/src/commands/metadata.ts

@@ -188,6 +188,12 @@ export function renderReadmeMarkdown(): string {
         '- `tela` — Render the available repositories in a human-readable table',
         '- `tela --json` — Emit the available repositories as JSON',
         '',
+        '## Version',
+        '',
+        'Examples:',
+        '- `tela --version` — Print the current Tela CLI version',
+        '- `tela -v` — Print the current Tela CLI version',
+        '',
         '## Commands',
         '',
     ]

package/src/program.ts

@@ -108,6 +108,7 @@ import {
     stepList,
     table,
 } from './ui.ts'
+import { CLI_VERSION } from './version.ts'
 
 type PromptModule = FeedbackPromptModule
 
@@ -286,6 +287,7 @@ function renderRootHelp(program: Command): string {
             ['Flag', 'Description'],
             [
                 ['--verbose', 'Include raw evidence for failures where available'],
+                ['-v, --version', 'Show current Tela CLI version'],
                 ['-h, --help', 'Show command help'],
             ],
             renderOptions,
@@ -335,6 +337,27 @@ function installCustomHelp(program: Command): void {
     })
 }
 
+function installCommanderOutput(program: Command, deps: CliDeps): void {
+    program.configureOutput({
+        writeOut: (message) => {
+            if (deps.writeStdout) {
+                deps.writeStdout(message)
+                return
+            }
+
+            process.stdout.write(message)
+        },
+        writeErr: (message) => {
+            if (deps.writeStderr) {
+                deps.writeStderr(message)
+                return
+            }
+
+            process.stderr.write(message)
+        },
+    })
+}
+
 function emitBootstrap(runtime: CommandRuntime, title: string, summary: string): void {
     runtime.emit(bootstrapPane(title, summary, { decorate: runtime.decorate }))
 }
@@ -1968,8 +1991,10 @@ export function createProgram(deps: CliDeps = {}): Command {
         .name('tela')
         .description('Tela CLI workspace and auth helper')
         .showHelpAfterError()
+        .version(CLI_VERSION, '-v, --version', 'show current Tela CLI version')
         .option('--verbose', 'include raw evidence on failures')
 
+    installCommanderOutput(program, deps)
     installCustomHelp(program)
 
     addStandardReadOptions(program).action(async (commandOptions: GlobalCliOptions) => {

package/src/version.ts

@@ -0,0 +1,3 @@
+import packageJson from '../package.json' with { type: 'json' }
+
+export const CLI_VERSION = packageJson.version