@tenderprompt/cli 0.1.3 → 0.1.5

package/README.md

@@ -64,6 +64,10 @@ A push updates app source and can trigger preview work. Publishing remains
 an explicit lifecycle command so local agents do not accidentally publish
 production changes.
 
+`tender app git setup` configures the checkout to avoid thin/external-delta
+push packs when possible. The server also handles valid external-delta packs by
+indexing the accepted commit after upstream Git accepts the push.
+
 ## Useful Commands
 
 ```bash
@@ -84,7 +88,8 @@ tender app publish artifact_123 --dry-run --json
 - Local agents run in the user's environment, not in Tender.
 - Source moves through artifact Git.
 - Preview, build, and publish are explicit API lifecycle operations.
-- `write` lets a token edit and preview; `publish` must be explicitly granted.
+- `write` lets a token edit, preview, push source, and publish. `publish`
+  remains accepted as an explicit scope for descriptive or older token grants.
 - `tender app publish` requires `--dry-run` or `--confirm publish`.
 - Tokens are stored outside the project checkout and are not written into Git
   remote URLs.

package/dist/index.js

@@ -4,7 +4,7 @@ import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { validateTenderApp, } from "@tenderprompt/tender-app-validator";
+import { generateTenderAppEnvTypes, validateTenderApp, } from "@tenderprompt/tender-app-validator";
 import { collectTenderAppFiles } from "./local-files.js";
 class TenderCliUsageError extends Error {
     constructor(message) {
@@ -46,6 +46,12 @@ Commands:
                              Show publish job status by job id
   tender app publish watch <app-id>
                              Stream or print lifecycle events for a publish job
+  tender app analytics summary <app-id>
+                             Read artifact analytics totals and trend points
+  tender app analytics query <app-id> --spec <file|-> 
+                             Run a server-validated chart spec
+  tender app analytics suggestions <app-id>
+                             Generate useful starter chart suggestions
   tender app context fetch <app-id>
                              Fetch managed agent context into a checkout
   tender app context status <app-id>
@@ -55,6 +61,8 @@ Commands:
   tender app git setup <app-id>
                              Configure a checkout to push to the app remote
   tender app doctor          Validate a local Tender App checkout
+  tender app generate-env-types
+                             Regenerate src/env.d.ts from app.json and bindings
 
 Compatibility:
   tender artifacts ...       Legacy alias for Tender App commands
@@ -72,11 +80,15 @@ Examples:
   tender app preview status artifact_123 --commit $(git rev-parse HEAD) --json
   tender app preview watch artifact_123 --job job_123 --stream --json
   tender app publish artifact_123 --commit $(git rev-parse HEAD) --confirm publish --stream --json
+  tender app analytics summary artifact_123 --range 30d --json
+  tender app analytics query artifact_123 --spec chart.json --json
+  tender app analytics suggestions artifact_123 --range 30d --json
   tender app context fetch artifact_123 --dir ./widget --dry-run --json
   tender app context status artifact_123 --dir ./widget --json
   tender app context refresh artifact_123 --dir ./widget --dry-run --json
   tender app git setup artifact_123 --dir ./widget --json
   tender app doctor --dir ./widget
+  tender app generate-env-types --dir ./widget --json
   tender app doctor --dir ./widget --json`;
 }
 function authHelp() {
@@ -147,6 +159,16 @@ Commands:
                              Show publish job status by job id
   tender app publish watch <app-id>
                              Replay lifecycle events for a publish job id
+  tender app analytics summary <app-id>
+                             Read artifact analytics totals and trend points
+  tender app analytics query <app-id> --spec <file|->
+                             Run a server-validated chart spec
+  tender app analytics suggestions <app-id>
+                             Generate useful starter chart suggestions
+  tender app analytics dashboards <app-id>
+                             List or create saved dashboards
+  tender app analytics charts create <app-id>
+                             Create a saved chart from a chart spec
   tender app context fetch <app-id>
                              Fetch AGENTS.md, skills, and Tender App scaffold files
   tender app context status <app-id>
@@ -156,6 +178,8 @@ Commands:
   tender app git setup <app-id>
                              Configure the tender Git remote and credential helper
   tender app doctor          Validate local context, TypeScript scaffold, and Tender App rules
+  tender app generate-env-types
+                             Regenerate src/env.d.ts from app.json and bindings
   tender app git remote <app-id>
                              Show Tender-hosted Git remote metadata
 
@@ -172,11 +196,18 @@ Examples:
   tender app publish artifact_123 --dry-run --json
   tender app publish status artifact_123 --job job_123 --json
   tender app publish watch artifact_123 --job job_123 --stream --json
+  tender app analytics summary artifact_123 --range 30d --json
+  tender app analytics query artifact_123 --spec chart.json --json
+  tender app analytics suggestions artifact_123 --range 30d --json
+  tender app analytics dashboards artifact_123 --json
+  tender app analytics dashboards artifact_123 --create "Agent dashboard" --json
+  tender app analytics charts create artifact_123 --dashboard analytics_dashboard_123 --title "Signup funnel" --spec funnel.json --json
   tender app context fetch artifact_123 --dir ./widget --dry-run --json
   tender app context status artifact_123 --dir ./widget --json
   tender app context refresh artifact_123 --dir ./widget --dry-run --json
   tender app git setup artifact_123 --dir ./widget --json
   tender app doctor --dir ./widget
+  tender app generate-env-types --dir ./widget --json
   tender app doctor --json
   tender app git remote artifact_123 --ttl 7d --json`;
 }
@@ -186,6 +217,100 @@ function artifactsHelp() {
 Legacy alias:
   tender artifacts ... continues to work for existing automation. Prefer tender app ... for new workflows.`;
 }
+function analyticsHelp() {
+    return `Usage: tender app analytics <command> <app-id> [options]
+
+Start here for agents:
+  tender app analytics capabilities <app-id> --include-catalog --range 30d --json
+
+Commands:
+  tender app analytics summary <app-id>       Read totals and trend points
+  tender app analytics query <app-id>         Run one chart spec
+  tender app analytics capabilities <app-id>  Describe agent-safe analytics capabilities
+  tender app analytics suggestions <app-id>   Generate starter chart suggestions
+  tender app analytics dashboards <app-id>    List or create dashboards
+  tender app analytics export <kind> <app-id> Export catalog metadata or query rows
+  tender app analytics charts create <app-id> Create a saved chart
+
+Examples:
+  tender app analytics summary artifact_123 --range 30d --json
+  tender app analytics capabilities artifact_123 --include-catalog --json
+  tender app analytics query artifact_123 --spec chart.json --json
+  tender app analytics query artifact_123 --spec - --json < chart.json
+  tender app analytics export catalog artifact_123 --range 30d --json
+  tender app analytics export query artifact_123 --spec chart.json --format csv
+  tender app analytics suggestions artifact_123 --range 2026-04-01..2026-04-30 --json
+  tender app analytics dashboards artifact_123 --create "Agent dashboard" --json
+  tender app analytics charts create artifact_123 --dashboard analytics_dashboard_123 --title "Signup funnel" --spec funnel.json --json`;
+}
+function analyticsSummaryHelp() {
+    return `Usage: tender app analytics summary <app-id> [--range <7d|30d|90d|YYYY-MM-DD..YYYY-MM-DD>] [--base-url <url>] [--token <token>] [--profile <name>] [--json]
+
+Examples:
+  tender app analytics summary artifact_123 --range 30d --json
+  tender app analytics summary artifact_123 --range 2026-04-01..2026-04-30 --json`;
+}
+function analyticsQueryHelp() {
+    return `Usage: tender app analytics query <app-id> --spec <file|-> [--base-url <url>] [--token <token>] [--profile <name>] [--json]
+
+Examples:
+  tender app analytics query artifact_123 --spec chart.json --json
+  tender app analytics query artifact_123 --spec - --json < chart.json`;
+}
+function analyticsCapabilitiesHelp() {
+    return `Usage: tender app analytics capabilities <app-id> [--include-catalog] [--range <7d|30d|90d|YYYY-MM-DD..YYYY-MM-DD>] [--base-url <url>] [--token <token>] [--profile <name>] [--json]
+
+Use this as the self-documenting entrypoint for coding agents. With --include-catalog,
+the response includes observed events, paths, rough property types, current saved
+dashboards, supported chart spec shapes, retention limits, and safe next commands.
+
+Examples:
+  tender app analytics capabilities artifact_123 --json
+  tender app analytics capabilities artifact_123 --include-catalog --range 30d --json`;
+}
+function analyticsExportHelp() {
+    return `Usage: tender app analytics export <catalog|query> <app-id> [options]
+
+Examples:
+  tender app analytics export catalog artifact_123 --range 30d --json
+  tender app analytics export query artifact_123 --spec chart.json --format json
+  tender app analytics export query artifact_123 --spec chart.json --format csv`;
+}
+function analyticsExportCatalogHelp() {
+    return `Usage: tender app analytics export catalog <app-id> [--range <7d|30d|90d|YYYY-MM-DD..YYYY-MM-DD>] [--format json] [--base-url <url>] [--token <token>] [--profile <name>] [--json]
+
+Examples:
+  tender app analytics export catalog artifact_123 --range 30d --json`;
+}
+function analyticsExportQueryHelp() {
+    return `Usage: tender app analytics export query <app-id> --spec <file|-> [--format <json|csv>] [--base-url <url>] [--token <token>] [--profile <name>] [--json]
+
+Examples:
+  tender app analytics export query artifact_123 --spec chart.json --format json
+  tender app analytics export query artifact_123 --spec chart.json --format csv
+  tender app analytics export query artifact_123 --spec - --format csv < chart.json`;
+}
+function analyticsSuggestionsHelp() {
+    return `Usage: tender app analytics suggestions <app-id> [--range <7d|30d|90d|YYYY-MM-DD..YYYY-MM-DD>] [--base-url <url>] [--token <token>] [--profile <name>] [--json]
+
+Examples:
+  tender app analytics suggestions artifact_123 --range 30d --json`;
+}
+function analyticsDashboardsHelp() {
+    return `Usage: tender app analytics dashboards <app-id> [--create <name>] [--dry-run] [--base-url <url>] [--token <token>] [--profile <name>] [--json]
+
+Examples:
+  tender app analytics dashboards artifact_123 --json
+  tender app analytics dashboards artifact_123 --create "Agent dashboard" --dry-run --json
+  tender app analytics dashboards artifact_123 --create "Agent dashboard" --json`;
+}
+function analyticsChartsCreateHelp() {
+    return `Usage: tender app analytics charts create <app-id> --dashboard <dashboard-id> --title <title> --spec <file|-> [--dry-run] [--base-url <url>] [--token <token>] [--profile <name>] [--json]
+
+Examples:
+  tender app analytics charts create artifact_123 --dashboard analytics_dashboard_123 --title "Signup funnel" --spec funnel.json --dry-run --json
+  tender app analytics charts create artifact_123 --dashboard analytics_dashboard_123 --title "Signup funnel" --spec funnel.json --json`;
+}
 function artifactsListHelp() {
     return `Usage: tender app list [--base-url <url>] [--token <token>] [--profile <name>] [--json]
 
@@ -305,6 +430,17 @@ Examples:
   tender app doctor --dir ./widget
   tender app doctor --dir ./widget --json`;
 }
+function generateEnvTypesHelp() {
+    return `Usage: tender app generate-env-types [--dir <path>] [--json]
+
+Options:
+  --dir <path>    Local Tender App checkout to update. Defaults to current directory.
+  --json          Emit stable JSON for coding agents.
+
+Examples:
+  tender app generate-env-types --dir ./widget
+  tender app generate-env-types --dir ./widget --json`;
+}
 function gitRemoteHelp() {
     return `Usage: tender app git remote <app-id> [--base-url <url>] [--token <token>] [--profile <name>] [--ttl <7d|14d|30d>] [--json]
 
@@ -1882,6 +2018,343 @@ function parseAuthStatusArgs(args) {
         json,
     };
 }
+function parseGenerateEnvTypesArgs(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        return { command: "help", topic: "artifacts generate-env-types" };
+    }
+    let dir = ".";
+    let json = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--json") {
+            json = true;
+            continue;
+        }
+        if (arg === "--dir") {
+            const value = args[index + 1];
+            if (!value) {
+                throw new TenderCliUsageError("--dir requires a path.");
+            }
+            dir = value;
+            index += 1;
+            continue;
+        }
+        throw new TenderCliUsageError(`Unknown generate-env-types option: ${arg}`);
+    }
+    return {
+        command: "artifacts generate-env-types",
+        dir,
+        json,
+    };
+}
+function parseAnalyticsRange(value) {
+    if (!value || value.startsWith("-")) {
+        throw new TenderCliUsageError("--range requires 7d, 30d, 90d, or YYYY-MM-DD..YYYY-MM-DD.");
+    }
+    if (value === "7d" || value === "30d" || value === "90d") {
+        return value;
+    }
+    if (/^\d{4}-\d{2}-\d{2}\.\.\d{4}-\d{2}-\d{2}$/.test(value)) {
+        return value;
+    }
+    throw new TenderCliUsageError("--range must be 7d, 30d, 90d, or YYYY-MM-DD..YYYY-MM-DD.");
+}
+function parseSpecPath(value) {
+    if (!value || (value !== "-" && value.startsWith("-"))) {
+        throw new TenderCliUsageError("--spec requires a JSON file path or - for stdin.");
+    }
+    return value;
+}
+function parseRequiredFlagValue(value, flag) {
+    if (!value || value.startsWith("-")) {
+        throw new TenderCliUsageError(`${flag} requires a value.`);
+    }
+    return value;
+}
+function parseAnalyticsCommonArgs(args, startIndex) {
+    let baseUrl = null;
+    let flagToken = null;
+    let profileName = null;
+    let json = false;
+    const remaining = [];
+    for (let index = startIndex; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--json") {
+            json = true;
+            continue;
+        }
+        if (arg === "--base-url") {
+            baseUrl = parseBaseUrlFlag(args, index);
+            index += 1;
+            continue;
+        }
+        if (arg === "--token") {
+            flagToken = parseTokenFlag(args, index);
+            index += 1;
+            continue;
+        }
+        if (arg === "--profile") {
+            profileName = parseProfileName(args[index + 1], "--profile");
+            index += 1;
+            continue;
+        }
+        remaining.push(arg);
+    }
+    return { baseUrl, flagToken, profileName, json, remaining };
+}
+function parseAnalyticsSummaryArgs(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        return { command: "help", topic: "artifacts analytics summary" };
+    }
+    const artifactId = args[0];
+    if (!artifactId || artifactId.startsWith("-")) {
+        throw new TenderCliUsageError("app id is required. Example: tender app analytics summary <app-id> --range 30d --json");
+    }
+    const parsed = parseAnalyticsCommonArgs(args, 1);
+    let range = "7d";
+    for (let index = 0; index < parsed.remaining.length; index += 1) {
+        const arg = parsed.remaining[index];
+        if (arg === "--range") {
+            range = parseAnalyticsRange(parsed.remaining[index + 1]);
+            index += 1;
+            continue;
+        }
+        throw new TenderCliUsageError(`Unknown analytics summary option: ${arg}`);
+    }
+    return { command: "artifacts analytics summary", artifactId, range, ...parsed };
+}
+function parseAnalyticsQueryArgs(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        return { command: "help", topic: "artifacts analytics query" };
+    }
+    const artifactId = args[0];
+    if (!artifactId || artifactId.startsWith("-")) {
+        throw new TenderCliUsageError("app id is required. Example: tender app analytics query <app-id> --spec chart.json --json");
+    }
+    const parsed = parseAnalyticsCommonArgs(args, 1);
+    let specPath = null;
+    for (let index = 0; index < parsed.remaining.length; index += 1) {
+        const arg = parsed.remaining[index];
+        if (arg === "--spec") {
+            specPath = parseSpecPath(parsed.remaining[index + 1]);
+            index += 1;
+            continue;
+        }
+        throw new TenderCliUsageError(`Unknown analytics query option: ${arg}`);
+    }
+    if (!specPath) {
+        throw new TenderCliUsageError("--spec is required. Example: tender app analytics query artifact_123 --spec chart.json --json");
+    }
+    return { command: "artifacts analytics query", artifactId, specPath, ...parsed };
+}
+function parseAnalyticsCapabilitiesArgs(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        return { command: "help", topic: "artifacts analytics capabilities" };
+    }
+    const artifactId = args[0];
+    if (!artifactId || artifactId.startsWith("-")) {
+        throw new TenderCliUsageError("app id is required. Example: tender app analytics capabilities <app-id> --include-catalog --json");
+    }
+    const parsed = parseAnalyticsCommonArgs(args, 1);
+    let range = "7d";
+    let includeCatalog = false;
+    for (let index = 0; index < parsed.remaining.length; index += 1) {
+        const arg = parsed.remaining[index];
+        if (arg === "--include-catalog") {
+            includeCatalog = true;
+            continue;
+        }
+        if (arg === "--range") {
+            range = parseAnalyticsRange(parsed.remaining[index + 1]);
+            index += 1;
+            continue;
+        }
+        throw new TenderCliUsageError(`Unknown analytics capabilities option: ${arg}`);
+    }
+    return {
+        command: "artifacts analytics capabilities",
+        artifactId,
+        includeCatalog,
+        range,
+        ...parsed,
+    };
+}
+function parseAnalyticsSuggestionsArgs(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        return { command: "help", topic: "artifacts analytics suggestions" };
+    }
+    const artifactId = args[0];
+    if (!artifactId || artifactId.startsWith("-")) {
+        throw new TenderCliUsageError("app id is required. Example: tender app analytics suggestions <app-id> --range 30d --json");
+    }
+    const parsed = parseAnalyticsCommonArgs(args, 1);
+    let range = "7d";
+    for (let index = 0; index < parsed.remaining.length; index += 1) {
+        const arg = parsed.remaining[index];
+        if (arg === "--range") {
+            range = parseAnalyticsRange(parsed.remaining[index + 1]);
+            index += 1;
+            continue;
+        }
+        throw new TenderCliUsageError(`Unknown analytics suggestions option: ${arg}`);
+    }
+    return { command: "artifacts analytics suggestions", artifactId, range, ...parsed };
+}
+function parseAnalyticsDashboardsArgs(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        return { command: "help", topic: "artifacts analytics dashboards" };
+    }
+    const artifactId = args[0];
+    if (!artifactId || artifactId.startsWith("-")) {
+        throw new TenderCliUsageError("app id is required. Example: tender app analytics dashboards <app-id> --json");
+    }
+    const parsed = parseAnalyticsCommonArgs(args, 1);
+    let name = null;
+    let dryRun = false;
+    for (let index = 0; index < parsed.remaining.length; index += 1) {
+        const arg = parsed.remaining[index];
+        if (arg === "--create") {
+            name = parseRequiredFlagValue(parsed.remaining[index + 1], "--create");
+            index += 1;
+            continue;
+        }
+        if (arg === "--dry-run") {
+            dryRun = true;
+            continue;
+        }
+        throw new TenderCliUsageError(`Unknown analytics dashboards option: ${arg}`);
+    }
+    if (dryRun && !name) {
+        throw new TenderCliUsageError("--dry-run is only valid with --create. Example: tender app analytics dashboards artifact_123 --create \"Agent dashboard\" --dry-run --json");
+    }
+    return { command: "artifacts analytics dashboards", artifactId, name, dryRun, ...parsed };
+}
+function parseAnalyticsExportCatalogArgs(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        return { command: "help", topic: "artifacts analytics export catalog" };
+    }
+    const artifactId = args[0];
+    if (!artifactId || artifactId.startsWith("-")) {
+        throw new TenderCliUsageError("app id is required. Example: tender app analytics export catalog <app-id> --range 30d --json");
+    }
+    const parsed = parseAnalyticsCommonArgs(args, 1);
+    let range = "7d";
+    let format = "json";
+    for (let index = 0; index < parsed.remaining.length; index += 1) {
+        const arg = parsed.remaining[index];
+        if (arg === "--range") {
+            range = parseAnalyticsRange(parsed.remaining[index + 1]);
+            index += 1;
+            continue;
+        }
+        if (arg === "--format") {
+            const value = parseRequiredFlagValue(parsed.remaining[index + 1], "--format");
+            if (value !== "json") {
+                throw new TenderCliUsageError("--format for export catalog must be json.");
+            }
+            format = value;
+            index += 1;
+            continue;
+        }
+        throw new TenderCliUsageError(`Unknown analytics export catalog option: ${arg}`);
+    }
+    return {
+        command: "artifacts analytics export catalog",
+        artifactId,
+        format,
+        range,
+        ...parsed,
+    };
+}
+function parseAnalyticsExportQueryArgs(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        return { command: "help", topic: "artifacts analytics export query" };
+    }
+    const artifactId = args[0];
+    if (!artifactId || artifactId.startsWith("-")) {
+        throw new TenderCliUsageError("app id is required. Example: tender app analytics export query <app-id> --spec chart.json --format csv");
+    }
+    const parsed = parseAnalyticsCommonArgs(args, 1);
+    let specPath = null;
+    let format = "json";
+    for (let index = 0; index < parsed.remaining.length; index += 1) {
+        const arg = parsed.remaining[index];
+        if (arg === "--spec") {
+            specPath = parseSpecPath(parsed.remaining[index + 1]);
+            index += 1;
+            continue;
+        }
+        if (arg === "--format") {
+            const value = parseRequiredFlagValue(parsed.remaining[index + 1], "--format");
+            if (value !== "json" && value !== "csv") {
+                throw new TenderCliUsageError("--format must be json or csv.");
+            }
+            format = value;
+            index += 1;
+            continue;
+        }
+        throw new TenderCliUsageError(`Unknown analytics export query option: ${arg}`);
+    }
+    if (!specPath) {
+        throw new TenderCliUsageError("--spec is required. Example: tender app analytics export query artifact_123 --spec chart.json --format csv");
+    }
+    return {
+        command: "artifacts analytics export query",
+        artifactId,
+        specPath,
+        format,
+        ...parsed,
+    };
+}
+function parseAnalyticsChartsCreateArgs(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        return { command: "help", topic: "artifacts analytics charts create" };
+    }
+    const artifactId = args[0];
+    if (!artifactId || artifactId.startsWith("-")) {
+        throw new TenderCliUsageError("app id is required. Example: tender app analytics charts create <app-id> --dashboard <dashboard-id> --title <title> --spec chart.json --json");
+    }
+    const parsed = parseAnalyticsCommonArgs(args, 1);
+    let dashboardId = null;
+    let title = null;
+    let specPath = null;
+    let dryRun = false;
+    for (let index = 0; index < parsed.remaining.length; index += 1) {
+        const arg = parsed.remaining[index];
+        if (arg === "--dashboard") {
+            dashboardId = parseRequiredFlagValue(parsed.remaining[index + 1], "--dashboard");
+            index += 1;
+            continue;
+        }
+        if (arg === "--title") {
+            title = parseRequiredFlagValue(parsed.remaining[index + 1], "--title");
+            index += 1;
+            continue;
+        }
+        if (arg === "--spec") {
+            specPath = parseSpecPath(parsed.remaining[index + 1]);
+            index += 1;
+            continue;
+        }
+        if (arg === "--dry-run") {
+            dryRun = true;
+            continue;
+        }
+        throw new TenderCliUsageError(`Unknown analytics charts create option: ${arg}`);
+    }
+    if (!dashboardId || !title || !specPath) {
+        throw new TenderCliUsageError("--dashboard, --title, and --spec are required. Example: tender app analytics charts create artifact_123 --dashboard analytics_dashboard_123 --title \"Signup funnel\" --spec chart.json --json");
+    }
+    return {
+        command: "artifacts analytics charts create",
+        artifactId,
+        dashboardId,
+        title,
+        specPath,
+        dryRun,
+        ...parsed,
+    };
+}
 function parseTenderArgs(args) {
     if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
         return { command: "help", topic: "root" };
@@ -1933,6 +2406,49 @@ function parseTenderArgs(args) {
         if (resourceArgs[1] === "context" && resourceArgs[2] === "refresh") {
             return parseContextRefreshArgs(resourceArgs.slice(3));
         }
+        if (resourceArgs[1] === "analytics" &&
+            (resourceArgs[2] === undefined ||
+                resourceArgs[2] === "--help" ||
+                resourceArgs[2] === "-h")) {
+            return { command: "help", topic: "artifacts analytics" };
+        }
+        if (resourceArgs[1] === "analytics" && resourceArgs[2] === "summary") {
+            return parseAnalyticsSummaryArgs(resourceArgs.slice(3));
+        }
+        if (resourceArgs[1] === "analytics" && resourceArgs[2] === "query") {
+            return parseAnalyticsQueryArgs(resourceArgs.slice(3));
+        }
+        if (resourceArgs[1] === "analytics" && resourceArgs[2] === "capabilities") {
+            return parseAnalyticsCapabilitiesArgs(resourceArgs.slice(3));
+        }
+        if (resourceArgs[1] === "analytics" && resourceArgs[2] === "suggestions") {
+            return parseAnalyticsSuggestionsArgs(resourceArgs.slice(3));
+        }
+        if (resourceArgs[1] === "analytics" && resourceArgs[2] === "dashboards") {
+            return parseAnalyticsDashboardsArgs(resourceArgs.slice(3));
+        }
+        if (resourceArgs[1] === "analytics" &&
+            resourceArgs[2] === "export" &&
+            (resourceArgs[3] === undefined ||
+                resourceArgs[3] === "--help" ||
+                resourceArgs[3] === "-h")) {
+            return { command: "help", topic: "artifacts analytics export" };
+        }
+        if (resourceArgs[1] === "analytics" &&
+            resourceArgs[2] === "export" &&
+            resourceArgs[3] === "catalog") {
+            return parseAnalyticsExportCatalogArgs(resourceArgs.slice(4));
+        }
+        if (resourceArgs[1] === "analytics" &&
+            resourceArgs[2] === "export" &&
+            resourceArgs[3] === "query") {
+            return parseAnalyticsExportQueryArgs(resourceArgs.slice(4));
+        }
+        if (resourceArgs[1] === "analytics" &&
+            resourceArgs[2] === "charts" &&
+            resourceArgs[3] === "create") {
+            return parseAnalyticsChartsCreateArgs(resourceArgs.slice(4));
+        }
         if (resourceArgs[1] === "context" &&
             (resourceArgs[2] === undefined ||
                 resourceArgs[2] === "--help" ||
@@ -1948,6 +2464,9 @@ function parseTenderArgs(args) {
         if (resourceArgs[1] === "git" && resourceArgs[2] === "credential") {
             return parseGitCredentialArgs(resourceArgs.slice(3));
         }
+        if (resourceArgs[1] === "generate-env-types") {
+            return parseGenerateEnvTypesArgs(resourceArgs.slice(2));
+        }
         if (resourceArgs[1] === "validate") {
             return parseValidateArgs(resourceArgs.slice(2));
         }
@@ -2077,6 +2596,69 @@ async function runDoctor(command, io) {
     }
     return result.ok ? 0 : 1;
 }
+function formatEnvTypesGenerationFailure(result) {
+    if (result.ok || result.diagnostics.length === 0) {
+        return "Could not generate src/env.d.ts.";
+    }
+    return formatDoctorHuman({
+        ok: false,
+        diagnostics: result.diagnostics,
+    });
+}
+async function runGenerateEnvTypes(command, io) {
+    const root = path.resolve(command.dir);
+    const files = await collectTenderAppFiles({ root, current: root });
+    const result = generateTenderAppEnvTypes({
+        files,
+        mode: "local",
+    });
+    if (!result.ok) {
+        if (command.json) {
+            io.stdout(JSON.stringify({
+                ok: false,
+                command: command.command,
+                dir: root,
+                path: result.path,
+                diagnostics: result.diagnostics,
+            }, null, 2));
+        }
+        else {
+            io.stdout(formatEnvTypesGenerationFailure(result));
+        }
+        return 1;
+    }
+    const absolutePath = path.join(root, result.path);
+    const previous = await readFile(absolutePath, "utf8").catch((error) => {
+        if (error &&
+            typeof error === "object" &&
+            error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    });
+    const changed = previous !== result.content;
+    await mkdir(path.dirname(absolutePath), { recursive: true });
+    await writeFile(absolutePath, result.content);
+    if (command.json) {
+        io.stdout(JSON.stringify({
+            ok: true,
+            command: command.command,
+            dir: root,
+            path: result.path,
+            absolutePath,
+            changed,
+            bytes: Buffer.byteLength(result.content),
+            diagnostics: result.diagnostics,
+        }, null, 2));
+    }
+    else {
+        io.stdout([
+            `generated: ${path.join(command.dir, result.path)}`,
+            `changed: ${changed ? "yes" : "no"}`,
+        ].join("\n"));
+    }
+    return 0;
+}
 async function parseJsonResponse(response) {
     return (await response.json().catch(() => null));
 }
@@ -2114,6 +2696,119 @@ function parseSseLifecycleBlock(block) {
         return { raw: dataLines.join("\n") };
     }
 }
+function appendAnalyticsRange(params, range) {
+    if (range === "7d" || range === "30d" || range === "90d") {
+        params.set("rangePreset", range);
+        return;
+    }
+    const [startDate, endDate] = range.split("..");
+    if (startDate && endDate) {
+        params.set("startDate", startDate);
+        params.set("endDate", endDate);
+    }
+}
+async function readAnalyticsSpec(input) {
+    const raw = input.specPath === "-"
+        ? input.stdin
+        : await readFile(path.resolve(input.specPath), "utf8");
+    if (!raw) {
+        throw new TenderCliUsageError("--spec - requires JSON on stdin.");
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new TenderCliUsageError("--spec must contain valid JSON.");
+    }
+}
+async function requestAnalyticsApi(input) {
+    const params = new URLSearchParams();
+    if (input.range) {
+        appendAnalyticsRange(params, input.range);
+    }
+    if (input.includeCatalog) {
+        params.set("includeCatalog", "1");
+    }
+    const suffix = input.analyticsPath ? `/${input.analyticsPath}` : "";
+    const query = params.size > 0 ? `?${params.toString()}` : "";
+    const response = await input.fetcher(`${input.baseUrl}/api/v1/artifacts/${encodeURIComponent(input.artifactId)}/analytics${suffix}${query}`, {
+        method: input.method,
+        headers: {
+            authorization: `Bearer ${input.token}`,
+            accept: "application/json",
+            ...(input.body === undefined ? {} : { "content-type": "application/json" }),
+        },
+        body: input.body === undefined ? undefined : JSON.stringify(input.body),
+    });
+    const payload = await parseJsonResponse(response);
+    if (!response.ok || !payload?.ok) {
+        const reasonCode = (typeof payload?.reasonCode === "string" && payload.reasonCode) ||
+            `http_${response.status}`;
+        const message = (typeof payload?.message === "string" && payload.message) ||
+            (typeof payload?.reasonCode === "string" && payload.reasonCode) ||
+            `Analytics request failed with HTTP ${response.status}.`;
+        throw new Error([
+            message,
+            `Scope: artifact ${input.artifactId}, analytics/${input.analyticsPath || "summary"}.`,
+            `Reason: ${reasonCode}.`,
+            `Example: ${analyticsCorrectedExample(input.artifactId, input.analyticsPath)}.`,
+        ].join("\n"));
+    }
+    return payload;
+}
+function analyticsCorrectedExample(artifactId, analyticsPath) {
+    if (analyticsPath === "capabilities") {
+        return `tender app analytics capabilities ${artifactId} --include-catalog --range 30d --json`;
+    }
+    if (analyticsPath === "query") {
+        return `tender app analytics query ${artifactId} --spec chart.json --json`;
+    }
+    if (analyticsPath === "suggestions") {
+        return `tender app analytics suggestions ${artifactId} --range 30d --json`;
+    }
+    if (analyticsPath === "dashboards") {
+        return `tender app analytics dashboards ${artifactId} --json`;
+    }
+    if (analyticsPath === "charts") {
+        return `tender app analytics charts create ${artifactId} --dashboard analytics_dashboard_123 --title "Signup funnel" --spec chart.json --json`;
+    }
+    return `tender app analytics summary ${artifactId} --range 30d --json`;
+}
+function printAnalyticsPayload(command, io, payload, fallbackLines) {
+    if (command.json) {
+        io.stdout(JSON.stringify(payload, null, 2));
+    }
+    else {
+        io.stdout(fallbackLines.join("\n"));
+    }
+}
+function csvCell(value) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    const json = JSON.stringify(value);
+    const text = typeof value === "string" ? value : typeof json === "string" ? json : String(value);
+    if (/[",\n\r]/.test(text)) {
+        return `"${text.replaceAll("\"", "\"\"")}"`;
+    }
+    return text;
+}
+function rowsToCsv(rows) {
+    const records = rows.filter((row) => Boolean(row) && typeof row === "object" && !Array.isArray(row));
+    const headers = Array.from(records.reduce((set, row) => {
+        for (const key of Object.keys(row)) {
+            set.add(key);
+        }
+        return set;
+    }, new Set()));
+    if (headers.length === 0) {
+        return "";
+    }
+    return [
+        headers.map(csvCell).join(","),
+        ...records.map((row) => headers.map((header) => csvCell(row[header])).join(",")),
+    ].join("\n");
+}
 function findSseBlockSeparator(buffer) {
     const unixIndex = buffer.indexOf("\n\n");
     const windowsIndex = buffer.indexOf("\r\n\r\n");
@@ -2943,6 +3638,8 @@ function createGitSetupCommandPlan(input) {
             input.credentialHelper,
         ],
         ["git", "config", "--local", "credential.useHttpPath", "true"],
+        ["git", "config", "--local", "pack.window", "0"],
+        ["git", "config", "--local", "pack.depth", "0"],
     ];
 }
 async function applyGitSetup(input) {
@@ -2998,6 +3695,16 @@ async function applyGitSetup(input) {
         cwd: input.root,
         args: ["config", "--local", "credential.useHttpPath", "true"],
     });
+    await runGitCommand({
+        runtime: input.runtime,
+        cwd: input.root,
+        args: ["config", "--local", "pack.window", "0"],
+    });
+    await runGitCommand({
+        runtime: input.runtime,
+        cwd: input.root,
+        args: ["config", "--local", "pack.depth", "0"],
+    });
 }
 async function maybeCheckoutInitialArtifactSource(input) {
     const localHead = await runGitCommand({
@@ -4038,6 +4745,226 @@ async function runGitRemote(command, io, runtime) {
     }
     return 0;
 }
+async function resolveAnalyticsCredentials(command, runtime) {
+    return await resolveApiCredentials({
+        baseUrl: command.baseUrl,
+        flagToken: command.flagToken,
+        profileName: command.profileName,
+        env: runtime.env ?? process.env,
+    });
+}
+async function runAnalyticsSummary(command, io, runtime) {
+    const credentials = await resolveAnalyticsCredentials(command, runtime);
+    const payload = await requestAnalyticsApi({
+        artifactId: command.artifactId,
+        analyticsPath: "",
+        method: "GET",
+        baseUrl: credentials.baseUrl,
+        token: credentials.token,
+        fetcher: runtime.fetcher ?? fetch,
+        range: command.range,
+    });
+    const points = Array.isArray(payload.points) ? payload.points : [];
+    printAnalyticsPayload(command, io, payload, [
+        `app_id: ${command.artifactId}`,
+        `source: ${String(payload.source ?? "unknown")}`,
+        `points: ${points.length}`,
+    ]);
+    return 0;
+}
+async function runAnalyticsQuery(command, io, runtime) {
+    const credentials = await resolveAnalyticsCredentials(command, runtime);
+    const spec = await readAnalyticsSpec({
+        specPath: command.specPath,
+        stdin: runtime.stdin,
+    });
+    const payload = await requestAnalyticsApi({
+        artifactId: command.artifactId,
+        analyticsPath: "query",
+        method: "POST",
+        baseUrl: credentials.baseUrl,
+        token: credentials.token,
+        fetcher: runtime.fetcher ?? fetch,
+        body: { spec },
+    });
+    const rows = Array.isArray(payload.rows) ? payload.rows : [];
+    printAnalyticsPayload(command, io, payload, [
+        `app_id: ${command.artifactId}`,
+        `source: ${String(payload.source ?? "unknown")}`,
+        `rows: ${rows.length}`,
+    ]);
+    return 0;
+}
+async function runAnalyticsCapabilities(command, io, runtime) {
+    const credentials = await resolveAnalyticsCredentials(command, runtime);
+    const payload = await requestAnalyticsApi({
+        artifactId: command.artifactId,
+        analyticsPath: "capabilities",
+        method: "GET",
+        baseUrl: credentials.baseUrl,
+        token: credentials.token,
+        fetcher: runtime.fetcher ?? fetch,
+        range: command.range,
+        includeCatalog: command.includeCatalog,
+    });
+    const commands = Array.isArray(payload.commands) ? payload.commands : [];
+    const catalog = payload.catalog && typeof payload.catalog === "object"
+        ? payload.catalog
+        : null;
+    const observedEvents = Array.isArray(catalog?.observedEvents)
+        ? catalog.observedEvents
+        : [];
+    printAnalyticsPayload(command, io, payload, [
+        `app_id: ${command.artifactId}`,
+        `commands: ${commands.length}`,
+        `catalog_events: ${observedEvents.length}`,
+    ]);
+    return 0;
+}
+async function runAnalyticsSuggestions(command, io, runtime) {
+    const credentials = await resolveAnalyticsCredentials(command, runtime);
+    const payload = await requestAnalyticsApi({
+        artifactId: command.artifactId,
+        analyticsPath: "suggestions",
+        method: "POST",
+        baseUrl: credentials.baseUrl,
+        token: credentials.token,
+        fetcher: runtime.fetcher ?? fetch,
+        range: command.range,
+        body: {},
+    });
+    const suggestions = Array.isArray(payload.suggestions) ? payload.suggestions : [];
+    printAnalyticsPayload(command, io, payload, [
+        `app_id: ${command.artifactId}`,
+        `suggestions: ${suggestions.length}`,
+    ]);
+    return 0;
+}
+async function runAnalyticsDashboards(command, io, runtime) {
+    if (command.name && command.dryRun) {
+        const payload = {
+            ok: true,
+            dryRun: true,
+            artifactId: command.artifactId,
+            request: {
+                name: command.name,
+            },
+        };
+        printAnalyticsPayload(command, io, payload, [
+            `app_id: ${command.artifactId}`,
+            `name: ${command.name}`,
+            "dry_run: true",
+        ]);
+        return 0;
+    }
+    const credentials = await resolveAnalyticsCredentials(command, runtime);
+    const payload = await requestAnalyticsApi({
+        artifactId: command.artifactId,
+        analyticsPath: "dashboards",
+        method: command.name ? "POST" : "GET",
+        baseUrl: credentials.baseUrl,
+        token: credentials.token,
+        fetcher: runtime.fetcher ?? fetch,
+        body: command.name ? { name: command.name } : undefined,
+    });
+    const dashboards = Array.isArray(payload.dashboards) ? payload.dashboards : [];
+    printAnalyticsPayload(command, io, payload, [
+        `app_id: ${command.artifactId}`,
+        command.name
+            ? `dashboard_id: ${String(payload.dashboard?.id ?? "")}`
+            : `dashboards: ${dashboards.length}`,
+    ]);
+    return 0;
+}
+async function runAnalyticsExportCatalog(command, io, runtime) {
+    const credentials = await resolveAnalyticsCredentials(command, runtime);
+    const payload = await requestAnalyticsApi({
+        artifactId: command.artifactId,
+        analyticsPath: "capabilities",
+        method: "GET",
+        baseUrl: credentials.baseUrl,
+        token: credentials.token,
+        fetcher: runtime.fetcher ?? fetch,
+        range: command.range,
+        includeCatalog: true,
+    });
+    const catalog = payload.catalog && typeof payload.catalog === "object"
+        ? payload.catalog
+        : null;
+    const exportPayload = {
+        ok: true,
+        artifactId: command.artifactId,
+        format: command.format,
+        catalog,
+    };
+    io.stdout(JSON.stringify(exportPayload, null, 2));
+    return 0;
+}
+async function runAnalyticsExportQuery(command, io, runtime) {
+    const credentials = await resolveAnalyticsCredentials(command, runtime);
+    const spec = await readAnalyticsSpec({
+        specPath: command.specPath,
+        stdin: runtime.stdin,
+    });
+    const payload = await requestAnalyticsApi({
+        artifactId: command.artifactId,
+        analyticsPath: "query",
+        method: "POST",
+        baseUrl: credentials.baseUrl,
+        token: credentials.token,
+        fetcher: runtime.fetcher ?? fetch,
+        body: { spec },
+    });
+    const rows = Array.isArray(payload.rows) ? payload.rows : [];
+    if (command.format === "csv") {
+        io.stdout(rowsToCsv(rows));
+        return 0;
+    }
+    io.stdout(JSON.stringify(payload, null, 2));
+    return 0;
+}
+async function runAnalyticsChartsCreate(command, io, runtime) {
+    const spec = await readAnalyticsSpec({
+        specPath: command.specPath,
+        stdin: runtime.stdin,
+    });
+    const body = {
+        dashboardId: command.dashboardId,
+        title: command.title,
+        spec,
+        layout: {},
+    };
+    if (command.dryRun) {
+        const payload = {
+            ok: true,
+            dryRun: true,
+            artifactId: command.artifactId,
+            request: body,
+        };
+        printAnalyticsPayload(command, io, payload, [
+            `app_id: ${command.artifactId}`,
+            `dashboard_id: ${command.dashboardId}`,
+            `title: ${command.title}`,
+            "dry_run: true",
+        ]);
+        return 0;
+    }
+    const credentials = await resolveAnalyticsCredentials(command, runtime);
+    const payload = await requestAnalyticsApi({
+        artifactId: command.artifactId,
+        analyticsPath: "charts",
+        method: "POST",
+        baseUrl: credentials.baseUrl,
+        token: credentials.token,
+        fetcher: runtime.fetcher ?? fetch,
+        body,
+    });
+    printAnalyticsPayload(command, io, payload, [
+        `app_id: ${command.artifactId}`,
+        `chart_id: ${String(payload.chart?.id ?? "")}`,
+    ]);
+    return 0;
+}
 export async function runTenderCli(args, io = {
     stdout: (message) => console.log(message),
     stderr: (message) => console.error(message),
@@ -4066,6 +4993,9 @@ export async function runTenderCli(args, io = {
             else if (command.topic === "artifacts doctor") {
                 io.stdout(doctorHelp());
             }
+            else if (command.topic === "artifacts generate-env-types") {
+                io.stdout(generateEnvTypesHelp());
+            }
             else if (command.topic === "artifacts list") {
                 io.stdout(artifactsListHelp());
             }
@@ -4111,6 +5041,36 @@ export async function runTenderCli(args, io = {
             else if (command.topic === "artifacts publish watch") {
                 io.stdout(publishWatchHelp());
             }
+            else if (command.topic === "artifacts analytics") {
+                io.stdout(analyticsHelp());
+            }
+            else if (command.topic === "artifacts analytics summary") {
+                io.stdout(analyticsSummaryHelp());
+            }
+            else if (command.topic === "artifacts analytics query") {
+                io.stdout(analyticsQueryHelp());
+            }
+            else if (command.topic === "artifacts analytics capabilities") {
+                io.stdout(analyticsCapabilitiesHelp());
+            }
+            else if (command.topic === "artifacts analytics suggestions") {
+                io.stdout(analyticsSuggestionsHelp());
+            }
+            else if (command.topic === "artifacts analytics dashboards") {
+                io.stdout(analyticsDashboardsHelp());
+            }
+            else if (command.topic === "artifacts analytics export") {
+                io.stdout(analyticsExportHelp());
+            }
+            else if (command.topic === "artifacts analytics export catalog") {
+                io.stdout(analyticsExportCatalogHelp());
+            }
+            else if (command.topic === "artifacts analytics export query") {
+                io.stdout(analyticsExportQueryHelp());
+            }
+            else if (command.topic === "artifacts analytics charts create") {
+                io.stdout(analyticsChartsCreateHelp());
+            }
             else if (command.topic === "artifacts") {
                 io.stdout(artifactsHelp());
             }
@@ -4137,6 +5097,9 @@ export async function runTenderCli(args, io = {
         if (command.command === "artifacts init") {
             return await runArtifactsInit(command, io, runtime);
         }
+        if (command.command === "artifacts generate-env-types") {
+            return await runGenerateEnvTypes(command, io);
+        }
         if (command.command === "artifacts context fetch") {
             return await runContextFetch(command, io, runtime);
         }
@@ -4176,6 +5139,30 @@ export async function runTenderCli(args, io = {
         if (command.command === "artifacts publish watch") {
             return await runPublishWatch(command, io, runtime);
         }
+        if (command.command === "artifacts analytics summary") {
+            return await runAnalyticsSummary(command, io, runtime);
+        }
+        if (command.command === "artifacts analytics query") {
+            return await runAnalyticsQuery(command, io, runtime);
+        }
+        if (command.command === "artifacts analytics capabilities") {
+            return await runAnalyticsCapabilities(command, io, runtime);
+        }
+        if (command.command === "artifacts analytics suggestions") {
+            return await runAnalyticsSuggestions(command, io, runtime);
+        }
+        if (command.command === "artifacts analytics dashboards") {
+            return await runAnalyticsDashboards(command, io, runtime);
+        }
+        if (command.command === "artifacts analytics export catalog") {
+            return await runAnalyticsExportCatalog(command, io, runtime);
+        }
+        if (command.command === "artifacts analytics export query") {
+            return await runAnalyticsExportQuery(command, io, runtime);
+        }
+        if (command.command === "artifacts analytics charts create") {
+            return await runAnalyticsChartsCreate(command, io, runtime);
+        }
         if (command.command === "artifacts git remote") {
             return await runGitRemote(command, io, runtime);
         }
@@ -4190,8 +5177,8 @@ export async function runTenderCli(args, io = {
 const currentFile = fileURLToPath(import.meta.url);
 function shouldReadEntrypointStdin(args) {
     return ((args[0] === "artifacts" || args[0] === "app") &&
-        args[1] === "git" &&
-        args[2] === "credential");
+        ((args[1] === "git" && args[2] === "credential") ||
+            (args[1] === "analytics" && args.includes("--spec") && args.includes("-"))));
 }
 async function readEntrypointStdin() {
     if (process.stdin.isTTY) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tenderprompt/cli",
-	"version": "0.1.3",
+	"version": "0.1.5",
 	"type": "module",
 	"bin": {
 		"tender": "./bin/tender.js"
@@ -23,7 +23,7 @@
 		"prepack": "yarn build"
 	},
 	"dependencies": {
-		"@tenderprompt/tender-app-validator": "0.1.2"
+		"@tenderprompt/tender-app-validator": "0.1.3"
 	},
 	"engines": {
 		"node": ">=20"