@tenderprompt/cli 0.1.14 → 0.1.15

package/README.md

@@ -16,6 +16,7 @@ npm install -g @tenderprompt/cli
 Then run:
 
 ```bash
+tender --version
 tender capabilities --json
 ```
 
@@ -25,6 +26,8 @@ Use the CLI to work with Tender Apps from a local checkout or coding-agent
 session:
 
 - sign in with a bounded device token and optional artifact scope
+- print the installed CLI package version with `tender --version`, `tender -v`,
+  or `tender version --json`
 - list, create, and rename apps
 - bootstrap a local app checkout with Tender project context
 - configure the Tender artifact Git remote and credential helper
@@ -48,6 +51,7 @@ interactive prompts unless the command is explicitly an auth flow.
 ## Typical Flow
 
 ```bash
+tender --version
 tender capabilities --json
 
 tender auth login --device --profile edit-preview --artifact artifact_123 --ttl 7d
@@ -120,6 +124,7 @@ indexing the accepted commit after upstream Git accepts the push.
 ## Useful Commands
 
 ```bash
+tender --version
 tender capabilities --json
 tender app list --json
 tender app create --name "Exit Intent Widget" --json

package/bin/tender.js

@@ -1,14 +1,6 @@
 #!/usr/bin/env node
 
-import { runTenderCli } from "../dist/index.js";
-
-function shouldReadEntrypointStdin(args) {
-	return (
-		args[0] === "artifacts" &&
-		args[1] === "git" &&
-		args[2] === "credential"
-	);
-}
+import { runTenderCli, shouldReadEntrypointStdin } from "../dist/index.js";
 
 async function readEntrypointStdin() {
 	if (process.stdin.isTTY) {

package/dist/index.d.ts

@@ -19,4 +19,5 @@ type TenderCommandResult = {
     stderr: string;
 };
 export declare function runTenderCli(args: string[], io?: TenderCliIo, runtime?: TenderCliRuntime): Promise<number>;
+export declare function shouldReadEntrypointStdin(args: string[]): boolean;
 export {};

package/dist/index.js

@@ -55,12 +55,14 @@ class TenderCliDbApiError extends Error {
     reasonCode;
     scope;
     example;
-    constructor(message, reasonCode, scope, example) {
+    nextAction;
+    constructor(message, reasonCode, scope, example, nextAction = null) {
         super(message);
         this.name = "TenderCliDbApiError";
         this.reasonCode = reasonCode;
         this.scope = scope;
         this.example = example;
+        this.nextAction = nextAction;
     }
 }
 const DEFAULT_PROFILE_NAME = "default";
@@ -73,6 +75,8 @@ function rootHelp() {
     return `Usage: tender <command> [options]
 
 Commands:
+  tender --version
+                             Show the installed Tender CLI version
   tender capabilities --json
                              Describe the CLI command surface for coding agents
   tender auth login --device
@@ -126,6 +130,7 @@ Commands:
                              Regenerate src/env.d.ts from app.json and bindings
 
 Examples:
+  tender --version
   tender capabilities --json
   tender auth login --device --profile edit-preview --artifact artifact_123 --ttl 7d
   tender auth status --json
@@ -315,6 +320,17 @@ copying long command lists into skill prompts.
 Examples:
   tender capabilities --json`;
 }
+function versionHelp() {
+    return `Usage: tender --version
+       tender -v
+       tender version [--json]
+
+Prints the installed Tender CLI package version.
+
+Examples:
+  tender --version
+  tender version --json`;
+}
 function analyticsHelp() {
     return `Usage: tender app analytics <command> <app-id> [options]
 
@@ -858,6 +874,7 @@ function tenderCliCapabilities() {
         discovery: {
             primary: "npm exec --yes @tenderprompt/cli@latest -- capabilities --json",
             layeredHelp: [
+                "tender --version",
                 "tender --help",
                 "tender auth --help",
                 "tender app --help",
@@ -960,6 +977,18 @@ function tenderCliCapabilities() {
             },
         ],
         commands: [
+            {
+                command: "tender --version",
+                purpose: "Print the installed Tender CLI package version.",
+                requiresAuth: false,
+                writes: false,
+            },
+            {
+                command: "tender version --json",
+                purpose: "Print the installed Tender CLI package version in a stable JSON shape.",
+                requiresAuth: false,
+                writes: false,
+            },
             {
                 command: "tender capabilities --json",
                 purpose: "Discover this CLI surface in a machine-readable shape.",
@@ -1091,6 +1120,19 @@ function runCapabilities(command, io) {
     }
     return 0;
 }
+function runVersion(command, io) {
+    if (command.json) {
+        io.stdout(JSON.stringify({
+            ok: true,
+            name: CLI_PACKAGE_NAME,
+            version: CLI_PACKAGE_VERSION,
+        }, null, 2));
+    }
+    else {
+        io.stdout(CLI_PACKAGE_VERSION);
+    }
+    return 0;
+}
 function normalizeBaseUrl(value) {
     return (value ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
 }
@@ -2595,6 +2637,20 @@ function parseCapabilitiesArgs(args) {
     }
     return { command: "capabilities", json };
 }
+function parseVersionArgs(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        return { command: "help", topic: "version" };
+    }
+    let json = false;
+    for (const arg of args) {
+        if (arg === "--json") {
+            json = true;
+            continue;
+        }
+        throw new TenderCliUsageError(`Unknown version option: ${arg}`);
+    }
+    return { command: "version", json };
+}
 function parseBindingId(value) {
     if (!value || value.startsWith("-")) {
         throw new TenderCliUsageError("--id requires a binding id.");
@@ -3746,6 +3802,12 @@ function parseTenderArgs(args) {
     if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
         return { command: "help", topic: "root" };
     }
+    if (args[0] === "--version" || args[0] === "-v") {
+        return parseVersionArgs(args.slice(1));
+    }
+    if (args[0] === "version") {
+        return parseVersionArgs(args.slice(1));
+    }
     if (args[0] === "capabilities") {
         return parseCapabilitiesArgs(args.slice(1));
     }
@@ -4345,6 +4407,9 @@ async function requestDbApi(input) {
         const message = (typeof payload?.message === "string" && payload.message) ||
             (typeof payload?.reasonCode === "string" && payload.reasonCode) ||
             `App database request failed with HTTP ${response.status}.`;
+        const nextAction = typeof payload?.nextAction === "string" && payload.nextAction
+            ? payload.nextAction
+            : null;
         const example = dbCorrectedExample(input.artifactId, input.dbPath);
         throw new TenderCliDbApiError([
             message,
@@ -4354,7 +4419,10 @@ async function requestDbApi(input) {
         ].join("\n"), reasonCode, {
             artifactId: input.artifactId,
             surface: `db/${input.dbPath}`,
-        }, example);
+            ...(input.scopeEnvironment ?? input.environment
+                ? { environment: input.scopeEnvironment ?? input.environment }
+                : {}),
+        }, example, nextAction);
     }
     return payload;
 }
@@ -6770,6 +6838,7 @@ async function runDbQuery(command, io, runtime) {
         baseUrl: credentials.baseUrl,
         token: credentials.token,
         fetcher: runtime.fetcher ?? fetch,
+        scopeEnvironment: command.environment,
         body,
     });
     const rows = Array.isArray(payload.rows) ? payload.rows : [];
@@ -7270,15 +7339,20 @@ function exampleForError(error, args, command) {
     const artifactId = artifactIdForError(args, command) ?? "artifact_123";
     return dbPath ? dbCorrectedExample(artifactId, dbPath) : null;
 }
+function nextActionForError(error) {
+    return error instanceof TenderCliDbApiError ? error.nextAction : null;
+}
 function cliErrorPayload(error, args, command) {
     const scope = scopeForError(error, args, command);
     const example = exampleForError(error, args, command);
+    const nextAction = nextActionForError(error);
     return {
         ok: false,
         command: commandNameForError(args, command),
         reasonCode: cliErrorCode(error),
         message: cliErrorMessage(error),
         ...(scope ? { scope } : {}),
+        ...(nextAction ? { nextAction } : {}),
         ...(example ? { example } : {}),
     };
 }
@@ -7293,6 +7367,9 @@ export async function runTenderCli(args, io = {
             if (command.topic === "capabilities") {
                 io.stdout(capabilitiesHelp());
             }
+            else if (command.topic === "version") {
+                io.stdout(versionHelp());
+            }
             else if (command.topic === "auth login") {
                 io.stdout(authLoginHelp());
             }
@@ -7439,6 +7516,9 @@ export async function runTenderCli(args, io = {
         if (command.command === "capabilities") {
             return runCapabilities(command, io);
         }
+        if (command.command === "version") {
+            return runVersion(command, io);
+        }
         if (command.command === "auth login") {
             return await runAuthLogin(command, io, runtime);
         }
@@ -7575,7 +7655,7 @@ const currentFile = fileURLToPath(import.meta.url);
 function hasFlagValue(args, flag, value) {
     return args.some((arg, index) => (arg === flag && args[index + 1] === value) || arg === `${flag}=${value}`);
 }
-function shouldReadEntrypointStdin(args) {
+export function shouldReadEntrypointStdin(args) {
     return (args[0] === "app" &&
         ((args[1] === "git" && args[2] === "credential") ||
             (args[1] === "analytics" && hasFlagValue(args, "--spec", "-")) ||

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tenderprompt/cli",
-	"version": "0.1.14",
+	"version": "0.1.15",
 	"type": "module",
 	"bin": {
 		"tender": "bin/tender.js"