@hypequery/cli 1.21.2 → 1.23.0

package/README.md

@@ -39,6 +39,7 @@ npx hypequery init \
 | `hypequery generate:datasets` | Dataset definitions scaffolded from tables |
 | `hypequery generate:manifest` | A browser-safe route manifest for React hooks |
 | `hypequery pull` / `diff` | Live source inspection and comparison |
+| `hypequery deployment:status` | Live release and Cloud-provided connection URLs |
 
 Non-interactive ClickHouse commands read `CLICKHOUSE_URL`, `CLICKHOUSE_DATABASE`, `CLICKHOUSE_USERNAME`, and `CLICKHOUSE_PASSWORD`.
 

package/dist/bin/cli.js

@@ -1,6 +1,12 @@
 #!/usr/bin/env node
 import { program } from '../cli.js';
-import { envFiles } from '../utils/env-files.js';
+import { loadEnvFiles } from '../utils/load-env-files.js';
+import { CommandExit, finishAndExit, installCommandExitFinalizer } from '../utils/command-exit.js';
+import { CommandLifecycle } from '../utils/telemetry/lifecycle.js';
+import { telemetryErrorCode } from '../utils/telemetry/error-code.js';
+import { cleanupLoadedApiArtifacts } from '../utils/load-api.js';
+import { withCommandTelemetry } from '../utils/telemetry/command-context.js';
+import { settleTelemetrySettings } from '../utils/telemetry/config-store.js';
 async function loadEnv() {
     try {
         const dotenvx = await import('@dotenvx/dotenvx');
@@ -14,19 +20,78 @@ async function loadEnv() {
     catch {
         // Optional dependency, ignore if missing
     }
-    try {
-        const { config } = await import('dotenv');
-        for (const path of envFiles(process.env.NODE_ENV)) {
-            // Missing files are a no-op.
-            config({ path });
-        }
-    }
-    catch {
-        // dotenv is optional; continue if not available
-    }
+    await loadEnvFiles(process.cwd());
 }
 async function main() {
     await loadEnv();
-    program.parse(process.argv);
+    const args = process.argv.slice(2);
+    const requested = args.find(arg => !arg.startsWith('-'));
+    const lifecycle = new CommandLifecycle(args, {
+        telemetry: args.includes('--no-telemetry') ? false : undefined,
+    });
+    let selected;
+    let finishing;
+    const finish = (exit) => {
+        finishing ??= (async () => {
+            // finish() never rejects; the guard keeps cleanup independent of telemetry.
+            await lifecycle.finish(exit, selected?.name() === 'help' ? selected.args[0] : undefined).catch(() => undefined);
+            // Signals end in process.exit(), which skips finally blocks: let any
+            // settings write release its lock first (bounded).
+            await settleTelemetrySettings();
+            await cleanupLoadedApiArtifacts();
+        })();
+        return finishing;
+    };
+    installCommandExitFinalizer(finish);
+    const crash = (error) => lifecycle.crash(error);
+    process.on('uncaughtExceptionMonitor', crash);
+    program.exitOverride();
+    for (const command of program.commands)
+        command.exitOverride();
+    program.hook('preAction', async (_root, command) => {
+        selected = command;
+        await lifecycle.begin(command.name(), command.opts().database);
+    });
+    const observeSignal = (signal) => {
+        lifecycle.markInterrupted();
+        // dev and mcp own asynchronous server teardown once their handlers exist.
+        // During startup, or for short commands, the executable owns shutdown.
+        if ((lifecycle.command === 'dev' || lifecycle.command === 'mcp') && process.listenerCount(signal) > 1)
+            return;
+        void finishAndExit(lifecycle.command === 'dev' || lifecycle.command === 'mcp' ? 0 : signal === 'SIGINT' ? 130 : 143, 'interrupted');
+    };
+    process.on('SIGINT', () => observeSignal('SIGINT'));
+    process.on('SIGTERM', () => observeSignal('SIGTERM'));
+    try {
+        await withCommandTelemetry(lifecycle, () => program.parseAsync(process.argv));
+        if (lifecycle.command === 'dev')
+            return; // Its shutdown handler finalizes after teardown.
+        await finish(new CommandExit(Number(process.exitCode ?? 0), process.exitCode ? 'failure' : 'success', process.exitCode ? 'unknown' : undefined));
+    }
+    catch (error) {
+        const commander = error;
+        if (commander.code === 'commander.helpDisplayed' || commander.code === 'commander.help') {
+            const topic = selected?.name() === 'help' ? selected.args[0] : selected?.name()
+                ?? program.commands.find(command => requested === command.name())?.name();
+            await lifecycle.begin('help');
+            const code = commander.exitCode ?? 0;
+            await lifecycle.finish(new CommandExit(code, code ? 'failure' : 'success', code ? 'validation_failed' : undefined), topic)
+                .catch(() => undefined);
+            process.exitCode = code;
+            await settleTelemetrySettings();
+            await cleanupLoadedApiArtifacts();
+            return;
+        }
+        if (commander.code === 'commander.version') {
+            await lifecycle.begin('version');
+            await finish(new CommandExit(0, 'success'));
+            return;
+        }
+        if (!selected)
+            await lifecycle.begin(['unknown_command', 'unknown_option'].includes(telemetryErrorCode(error)) ? 'unknown' : requested ?? 'unknown');
+        const exit = error instanceof CommandExit ? error
+            : new CommandExit(commander.exitCode ?? 1, 'failure', telemetryErrorCode(error));
+        await finishAndExit(exit.exitCode, exit.outcome, exit.errorCode);
+    }
 }
 main();

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiCpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAa9B,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAKpE;AAqQD,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyCpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAE9B,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAKpE;AA8RD,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli.js

@@ -1,5 +1,3 @@
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
 import { Command } from 'commander';
 import { initCommand } from './commands/init.js';
 import { mcpCommand } from './commands/mcp.js';
@@ -9,19 +7,15 @@ import { generateDatasetsCommand } from './commands/generate-datasets.js';
 import { generateManifestCommand } from './commands/generate-manifest.js';
 import { buildDeploymentCommand, prepareDeploymentReleaseCommand, validateDeploymentCommand, } from './commands/deployment.js';
 import { deployCommand, submitDeploymentCommand, } from './commands/deploy.js';
+import { deploymentStatusCommand, } from './commands/deployment-status.js';
 import { loginCommand, logoutCommand, } from './commands/login.js';
 import { diffCommand, pullCommand, } from './commands/live-source.js';
 import { isPromptCancelled } from './utils/prompts.js';
+import { telemetryCommand } from './commands/telemetry.js';
+import { getCliVersion } from './utils/cli-version.js';
+import { CommandExit } from './utils/command-exit.js';
+import { telemetryErrorCode } from './utils/telemetry/error-code.js';
 const program = new Command();
-function getCliVersion() {
-    try {
-        const pkg = JSON.parse(readFileSync(fileURLToPath(new URL('../package.json', import.meta.url)), 'utf8'));
-        return pkg.version ?? '0.0.0';
-    }
-    catch {
-        return '0.0.0';
-    }
-}
 export function normalizeInitOptions(options) {
     return {
         ...options,
@@ -31,7 +25,14 @@ export function normalizeInitOptions(options) {
 program
     .name('hypequery')
     .description('Type-safe analytics layer for ClickHouse')
-    .version(getCliVersion());
+    .version(getCliVersion())
+    .option('--no-telemetry', 'Disable anonymous usage telemetry for this invocation');
+program
+    .command('telemetry [action]')
+    .description('Show or change anonymous usage telemetry settings (status|enable|disable)')
+    .action(runCommand(async (action) => {
+    await telemetryCommand(action, { telemetry: program.opts().telemetry });
+}));
 program
     .command('login')
     .description('Authorize this machine with Hypequery Cloud')
@@ -71,14 +72,16 @@ function runCommand(action) {
             await action(...args);
         }
         catch (error) {
+            if (error instanceof CommandExit)
+                throw error;
             // Ctrl+C at a prompt is a deliberate abort, not a failure: report it as
             // the interrupt it is instead of dumping an error and exiting 1.
             if (isPromptCancelled(error)) {
                 console.log('\nCancelled.');
-                process.exit(130);
+                throw new CommandExit(130, 'cancelled', 'prompt_cancelled');
             }
             console.error(error instanceof Error ? error.message : error);
-            process.exit(1);
+            throw new CommandExit(1, 'failure', telemetryErrorCode(error));
         }
     };
 }
@@ -133,6 +136,7 @@ program
     .option('--path <path>', 'Analytics directory (loads <path>/api.ts or <path>/queries.ts)')
     .option('--tenant <id>', 'Trusted tenant applied to every tenant-scoped dataset')
     .option('--self-test', 'Check the entrypoint and exit without speaking MCP')
+    .option('--url <url>', 'With --self-test: check a hosted MCP endpoint (key from HYPEQUERY_API_KEY)')
     .action(runCommand(async (file, options) => {
     await mcpCommand(file, options);
 }));
@@ -198,6 +202,16 @@ program
     .action(runCommand(async (bundle, options) => {
     await submitDeploymentCommand(bundle, options);
 }));
+program
+    .command('deployment:status')
+    .description('Show the live release and hosted connection details for a Cloud target')
+    .option('--project <project>', 'Target project identifier (advanced override)')
+    .option('--environment <environment>', 'Target environment identifier (advanced override)')
+    .option('--endpoint <url>', 'HTTPS submission endpoint; requires HYPEQUERY_API_TOKEN')
+    .option('--mcp-config', 'Also print MCP client configuration for the hosted endpoint')
+    .action(runCommand(async (options) => {
+    await deploymentStatusCommand(options);
+}));
 program
     .command('deploy <source>')
     .description('Build, prepare, and deploy a dataset-only Cloud publication')
@@ -208,6 +222,7 @@ program
     .option('--no-source', 'Exclude project source files from the deployment bundle')
     .option('--endpoint <url>', 'HTTPS submission endpoint; requires HYPEQUERY_API_TOKEN')
     .option('--replace-restored', 'Intentionally replace a restored live release')
+    .option('--mcp-config', 'Also print MCP client configuration for the hosted endpoint')
     .action(runCommand(async (source, options) => {
     await deployCommand(source, options);
 }));
@@ -223,7 +238,7 @@ program
         }
         else {
             console.error(`Unknown command: ${command}`);
-            process.exit(1);
+            throw new CommandExit(1, 'failure', 'unknown_command');
         }
     }
     else {
@@ -234,6 +249,9 @@ program
 program.on('--help', () => {
     console.log('');
     console.log('Examples:');
+    console.log('  hypequery telemetry status');
+    console.log('  hypequery telemetry disable');
+    console.log('  hypequery --no-telemetry init');
     console.log('  hypequery login');
     console.log('  hypequery logout');
     console.log('  hypequery init');

package/dist/commands/deploy.d.ts

@@ -1,11 +1,14 @@
 import { createHttpDeploymentUploadTransport, type DeploymentSubmissionResponse } from '../utils/deployment-upload.js';
 import { type StoredCloudCredential } from '../utils/cloud-credential-store.js';
 import { fetchLiveDeployment } from '../utils/live-deployment.js';
+import { fetchHostedEndpoints } from '../utils/hosted-endpoints.js';
 import { buildDeploymentCommand, prepareDeploymentReleaseCommand } from './deployment.js';
 export interface SubmitDeploymentOptions {
     release?: string;
     endpoint?: string;
     replaceRestored?: boolean;
+    /** Also print MCP client configuration for the hosted endpoint. */
+    mcpConfig?: boolean;
 }
 export interface DeployOptions {
     endpoint?: string;
@@ -15,12 +18,14 @@ export interface DeployOptions {
     bundleOutput?: string;
     releaseOutput?: string;
     source?: boolean;
+    mcpConfig?: boolean;
 }
 export interface SubmitDeploymentDependencies {
     readonly env?: Readonly<Record<string, string | undefined>>;
     readonly createTransport?: typeof createHttpDeploymentUploadTransport;
     readonly loadCredential?: () => Promise<StoredCloudCredential | null>;
     readonly fetchLive?: typeof fetchLiveDeployment;
+    readonly fetchEndpoints?: typeof fetchHostedEndpoints;
 }
 export interface DeployDependencies extends SubmitDeploymentDependencies {
     readonly buildDeployment?: typeof buildDeploymentCommand;

package/dist/commands/deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AASA,OAAO,EACL,mCAAmC,EAEnC,KAAK,4BAA4B,EAElC,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,KAAK,qBAAqB,EAC3B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAChC,MAAM,iBAAiB,CAAC;AAMzB,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,mCAAmC,CAAC;IACtE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,mBAAmB,CAAC;CACjD;AAED,MAAM,WAAW,kBAAmB,SAAQ,4BAA4B;IACtE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,sBAAsB,CAAC;IACzD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,+BAA+B,CAAC;IAC3E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,uBAAuB,CAAC;CAC5D;AA4DD,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,GAAE,uBAA4B,EACrC,YAAY,GAAE,4BAAiC,GAC9C,OAAO,CAAC,4BAA4B,CAAC,CA0EvC;AAsBD,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,GAAE,aAAkB,EAC3B,YAAY,GAAE,kBAAuB,GACpC,OAAO,CAAC,4BAA4B,CAAC,CAuCvC"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AASA,OAAO,EACL,mCAAmC,EAEnC,KAAK,4BAA4B,EAElC,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,KAAK,qBAAqB,EAC3B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EACL,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAChC,MAAM,iBAAiB,CAAC;AAMzB,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,mCAAmC,CAAC;IACtE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,mBAAmB,CAAC;IAChD,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,oBAAoB,CAAC;CACvD;AAED,MAAM,WAAW,kBAAmB,SAAQ,4BAA4B;IACtE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,sBAAsB,CAAC;IACzD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,+BAA+B,CAAC;IAC3E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,uBAAuB,CAAC;CAC5D;AA4DD,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,GAAE,uBAA4B,EACrC,YAAY,GAAE,4BAAiC,GAC9C,OAAO,CAAC,4BAA4B,CAAC,CAiFvC;AAsBD,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,GAAE,aAAkB,EAC3B,YAAY,GAAE,kBAAuB,GACpC,OAAO,CAAC,4BAA4B,CAAC,CAwCvC"}

package/dist/commands/deploy.js

@@ -6,6 +6,8 @@ import { createHttpDeploymentUploadTransport, DeploymentUploadError, } from '../
 import { logger } from '../utils/logger.js';
 import { resolveDeploymentCredential } from '../utils/cloud-deployment-access.js';
 import { fetchLiveDeployment } from '../utils/live-deployment.js';
+import { fetchHostedEndpoints, } from '../utils/hosted-endpoints.js';
+import { printHostedEndpoints } from '../utils/hosted-endpoints-output.js';
 import { buildDeploymentCommand, prepareDeploymentReleaseCommand, } from './deployment.js';
 const MAX_RELEASE_FILE_BYTES = 16 * 1024;
 const DEFAULT_BUNDLE_PATH = 'analytics/hypequery-deployment';
@@ -120,6 +122,13 @@ export async function submitDeploymentCommand(bundlePath, options = {}, dependen
         : 'Deployment release already exists');
     logger.info(`Release identity: ${result.releaseIdentity}`);
     logger.info(`Bundle identity: ${result.bundleIdentity}`);
+    const endpoints = await (dependencies.fetchEndpoints ?? fetchHostedEndpoints)({
+        endpoint: deploymentEndpoint,
+        token,
+        target: release.release.target,
+    });
+    if (endpoints)
+        printHostedEndpoints(endpoints, options.mcpConfig === true);
     return result;
 }
 /**
@@ -172,5 +181,6 @@ export async function deployCommand(sourcePath, options = {}, dependencies = {})
         release: releasePath,
         endpoint: options.endpoint,
         replaceRestored: options.replaceRestored,
+        mcpConfig: options.mcpConfig,
     }, dependencies);
 }

package/dist/commands/deployment-status.d.ts

@@ -0,0 +1,16 @@
+import { type CloudDeploymentAccessDependencies } from '../utils/cloud-deployment-access.js';
+import { fetchHostedEndpoints } from '../utils/hosted-endpoints.js';
+import { fetchLiveDeployment } from '../utils/live-deployment.js';
+export interface DeploymentStatusOptions {
+    readonly endpoint?: string;
+    readonly project?: string;
+    readonly environment?: string;
+    readonly mcpConfig?: boolean;
+}
+export interface DeploymentStatusDependencies extends CloudDeploymentAccessDependencies {
+    readonly fetchLive?: typeof fetchLiveDeployment;
+    readonly fetchEndpoints?: typeof fetchHostedEndpoints;
+}
+/** Read the current target and its hosted connection details without deploying. */
+export declare function deploymentStatusCommand(options?: DeploymentStatusOptions, dependencies?: DeploymentStatusDependencies): Promise<void>;
+//# sourceMappingURL=deployment-status.d.ts.map

package/dist/commands/deployment-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-status.d.ts","sourceRoot":"","sources":["../../src/commands/deployment-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iCAAiC,EACvC,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGlE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,4BAA6B,SAAQ,iCAAiC;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,mBAAmB,CAAC;IAChD,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,oBAAoB,CAAC;CACvD;AAED,mFAAmF;AACnF,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,uBAA4B,EACrC,YAAY,GAAE,4BAAiC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/commands/deployment-status.js

@@ -0,0 +1,36 @@
+import { resolveDeploymentCredential, } from '../utils/cloud-deployment-access.js';
+import { deploymentTargetFromOptions } from '../utils/deployment-target.js';
+import { fetchHostedEndpoints } from '../utils/hosted-endpoints.js';
+import { printHostedEndpoints } from '../utils/hosted-endpoints-output.js';
+import { fetchLiveDeployment } from '../utils/live-deployment.js';
+import { logger } from '../utils/logger.js';
+/** Read the current target and its hosted connection details without deploying. */
+export async function deploymentStatusCommand(options = {}, dependencies = {}) {
+    const access = await resolveDeploymentCredential(options.endpoint, dependencies);
+    const target = deploymentTargetFromOptions(options, access.storedCredential);
+    const live = await (dependencies.fetchLive ?? fetchLiveDeployment)({
+        endpoint: access.endpoint,
+        token: access.token,
+        target,
+        resource: 'state',
+    });
+    logger.info(`Target: ${target.project} / ${target.environment}`);
+    if (live?.active) {
+        logger.success(`Live release: ${live.active.releaseIdentity}`);
+        logger.info(`Activated: ${live.active.activatedAt}`);
+        if (live.active.restored)
+            logger.info('This release was restored from history.');
+    }
+    else {
+        logger.info('No live release yet.');
+    }
+    const endpoints = await (dependencies.fetchEndpoints ?? fetchHostedEndpoints)({
+        endpoint: access.endpoint,
+        token: access.token,
+        target,
+    });
+    if (endpoints)
+        printHostedEndpoints(endpoints, options.mcpConfig === true);
+    else
+        logger.warn('Cloud did not return hosted endpoint details.');
+}

package/dist/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,iBAiOvE"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAkCA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,iBA2OvE"}

package/dist/commands/dev.js

@@ -1,3 +1,7 @@
+import { exitWith, finishAndExit } from '../utils/command-exit.js';
+import { telemetryErrorCode } from '../utils/telemetry/error-code.js';
+import { DevSession } from '../utils/telemetry/dev-session.js';
+import { setCommandTelemetryError } from '../utils/telemetry/command-context.js';
 import { watch } from 'node:fs';
 import path from 'node:path';
 import ora from 'ora';
@@ -27,6 +31,7 @@ function displayQueriesFileNotFoundError(commandName) {
     logger.newline();
 }
 export async function devCommand(file, options = {}) {
+    const telemetry = new DevSession();
     // Step 1: Find queries file
     const queriesFile = file
         ? await findQueriesFile(file)
@@ -35,10 +40,11 @@ export async function devCommand(file, options = {}) {
             : await findQueriesFile();
     if (!queriesFile) {
         displayQueriesFileNotFoundError('dev');
-        process.exit(1);
+        exitWith(1, 'failure', 'entrypoint_not_found');
     }
     logger.info(`Found: ${path.relative(process.cwd(), queriesFile)}`);
     logger.newline();
+    telemetry.start(queriesFile, file, options);
     let currentServer = null;
     let lifecycleOperation = Promise.resolve();
     let shutdownRequested = false;
@@ -61,9 +67,11 @@ export async function devCommand(file, options = {}) {
         // Loading spinners for slow operations
         const compileSpinner = ora('Compiling queries...').start();
         const dbSpinner = ora('Connecting to ClickHouse...').start();
+        let loading = true;
         try {
             // Load the API module
             const api = await loadApiModule(queriesFile);
+            loading = false;
             compileSpinner.succeed('Compiled queries');
             // Get table count for display
             let tableCount = 0;
@@ -125,8 +133,10 @@ export async function devCommand(file, options = {}) {
                     logger.indent(`Visit: ${baseUrl}`);
                 }
             }
+            return true;
         }
         catch (error) {
+            const code = loading ? telemetry.loadFailed(error) : telemetryErrorCode(error);
             // If server startup or later setup fails, tear down any resources
             // acquired by this attempt before retrying or exiting.
             try {
@@ -158,21 +168,31 @@ export async function devCommand(file, options = {}) {
             }
             logger.newline();
             if (!shouldWatch) {
-                process.exit(1);
+                setCommandTelemetryError(code);
+                exitWith(1, 'failure', code);
             }
+            return false;
         }
     };
     const restartServer = () => queueLifecycleOperation(async () => {
         if (shutdownRequested)
             return;
+        telemetry.reload();
         if (currentServer) {
             logger.newline();
             logger.reload('File changed, restarting...');
             logger.newline();
-            await stopCurrentRuntime();
+            try {
+                await stopCurrentRuntime();
+            }
+            catch (error) {
+                telemetry.reloadFailed();
+                throw error;
+            }
         }
         if (!shutdownRequested) {
-            await startServer();
+            if (!await startServer())
+                telemetry.reloadFailed();
         }
     });
     const shutdown = () => {
@@ -183,7 +203,7 @@ export async function devCommand(file, options = {}) {
         logger.info('Shutting down dev server...');
         return queueLifecycleOperation(async () => {
             await stopCurrentRuntime();
-            process.exit(0);
+            await finishAndExit(0, 'interrupted');
         });
     };
     // Start initial server

package/dist/commands/generate-datasets.d.ts

@@ -1,9 +1,3 @@
-/**
- * Generate Datasets Command
- *
- * Auto-generates dataset definitions from ClickHouse schema.
- * Reduces quickstart friction by scaffolding the semantic layer.
- */
 export interface GenerateDatasetsOptions {
     output?: string;
     path?: string;

package/dist/commands/generate-datasets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-datasets.d.ts","sourceRoot":"","sources":["../../src/commands/generate-datasets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA2BD,wBAAsB,uBAAuB,CAAC,OAAO,GAAE,uBAA4B,iBAqKlF"}
+{"version":3,"file":"generate-datasets.d.ts","sourceRoot":"","sources":["../../src/commands/generate-datasets.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA2BD,wBAAsB,uBAAuB,CAAC,OAAO,GAAE,uBAA4B,iBA+KlF"}

package/dist/commands/generate-datasets.js

@@ -1,3 +1,5 @@
+import { exitWith } from '../utils/command-exit.js';
+import { telemetryErrorCode } from '../utils/telemetry/error-code.js';
 /**
  * Generate Datasets Command
  *
@@ -13,6 +15,9 @@ import { redactConnectionUrl } from '../utils/redact-connection-url.js';
 import { logDatasetGenerationWarnings } from '../utils/dataset-generation-warnings.js';
 import { formatGeneratedFileDiff } from '../utils/generated-file-diff.js';
 import { readGeneratedFile, writeGeneratedFileAtomically } from '../utils/generated-file.js';
+import { updateCommandTelemetry, setCommandTelemetryError } from '../utils/telemetry/command-context.js';
+import { countBucket } from '../utils/telemetry/buckets.js';
+import { warningBuckets } from '../utils/telemetry/generation-metrics.js';
 /**
  * Turns the written path into something pasteable into an import statement:
  * strips the `.ts` extension and makes it explicitly relative.
@@ -35,6 +40,8 @@ function parseTableList(value) {
     return parsed && parsed.length > 0 ? parsed : undefined;
 }
 export async function generateDatasetsCommand(options = {}) {
+    updateCommandTelemetry('generate:datasets', { mode: options.check ? 'check' : options.diff ? 'diff' : 'write', force: !!options.force,
+        tenant_column_used: !!options.tenantColumn, tables_filter_used: !!options.tables, exclude_filter_used: !!options.excludeTables });
     // Determine output path
     let outputPath;
     if (options.output) {
@@ -52,6 +59,7 @@ export async function generateDatasetsCommand(options = {}) {
     const excludedTables = parseTableList(options.excludeTables);
     if (options.force && (options.check || options.diff)) {
         logger.error('--force cannot be combined with --check or --diff.');
+        setCommandTelemetryError('validation_failed');
         process.exitCode = 1;
         return;
     }
@@ -80,9 +88,16 @@ export async function generateDatasetsCommand(options = {}) {
         const generatedCount = generatedTables.length || tableCount;
         datasetSpinner.succeed(`Generated dataset definitions for ${generatedCount} ${generatedCount === 1 ? 'table' : 'tables'}`);
         logDatasetGenerationWarnings(generated?.warnings);
+        updateCommandTelemetry('generate:datasets', { datasets_generated_bucket: countBucket(generated.tables.length), warning_counts: warningBuckets(generated.warnings) });
         const relativeOutput = path.relative(process.cwd(), outputPath);
         const currentContents = await readGeneratedFile(outputPath);
         const contentsMatch = currentContents === generated.contents;
+        if (options.check) {
+            const result = contentsMatch ? 'up_to_date' : currentContents === undefined ? 'missing' : 'out_of_date';
+            updateCommandTelemetry('generate:datasets', { check_result: result });
+            if (!contentsMatch)
+                setCommandTelemetryError(currentContents === undefined ? 'output_missing' : 'output_out_of_date');
+        }
         if (contentsMatch) {
             logger.success(options.check || options.diff
                 ? `Dataset definitions are up to date: ${relativeOutput}`
@@ -92,6 +107,7 @@ export async function generateDatasetsCommand(options = {}) {
             }
         }
         else if (options.diff) {
+            setCommandTelemetryError('output_out_of_date');
             logger.raw(formatGeneratedFileDiff(currentContents ?? '', generated.contents, relativeOutput));
             logger.error(`Generated dataset definitions differ: ${relativeOutput}`);
             process.exitCode = 1;
@@ -173,6 +189,6 @@ export async function generateDatasetsCommand(options = {}) {
             logger.error(String(error));
         }
         logger.newline();
-        process.exit(1);
+        exitWith(1, 'failure', telemetryErrorCode(error));
     }
 }

package/dist/commands/generate-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-manifest.d.ts","sourceRoot":"","sources":["../../src/commands/generate-manifest.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,GAAE,uBAA4B,iBAyBtC"}
+{"version":3,"file":"generate-manifest.d.ts","sourceRoot":"","sources":["../../src/commands/generate-manifest.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,GAAE,uBAA4B,iBA2BtC"}

package/dist/commands/generate-manifest.js

@@ -2,7 +2,10 @@ import { mkdir, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { loadApiModule } from '../utils/load-api.js';
 import { logger } from '../utils/logger.js';
+import { updateCommandTelemetry } from '../utils/telemetry/command-context.js';
+import { manifestMetrics } from '../utils/telemetry/generation-metrics.js';
 export async function generateManifestCommand(apiPath, options = {}) {
+    updateCommandTelemetry('generate:manifest', { custom_output: options.output !== undefined });
     if (!apiPath) {
         throw new Error('Missing API module path.\n\n' +
             'Usage: hypequery generate:manifest analytics/api.ts --output analytics/hypequery-manifest.json');
@@ -15,6 +18,7 @@ export async function generateManifestCommand(apiPath, options = {}) {
             `Export the value returned by createAPI() or initServe(...).serve(...).`);
     }
     const manifest = api.manifest();
+    updateCommandTelemetry('generate:manifest', manifestMetrics(api, manifest));
     await mkdir(path.dirname(outputPath), { recursive: true });
     await writeFile(outputPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
     logger.success(`Manifest written to ${outputPath}`);

package/dist/commands/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAK/F,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,eAAe,CAAC,OAAO,GAAE,eAAoB,iBA6JlE"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAQ/F,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,eAAe,CAAC,OAAO,GAAE,eAAoB,iBAqKlE"}

package/dist/commands/generate.js

@@ -1,3 +1,5 @@
+import { exitWith } from '../utils/command-exit.js';
+import { telemetryErrorCode } from '../utils/telemetry/error-code.js';
 import path from 'node:path';
 import ora from 'ora';
 import { logger } from '../utils/logger.js';
@@ -6,7 +8,13 @@ import { detectDatabase, getTableCount } from '../utils/detect-database.js';
 import { ensureChdbInstalled } from '../utils/chdb-client.js';
 import { getTypeGenerator } from '../generators/index.js';
 import { redactConnectionUrl } from '../utils/redact-connection-url.js';
+import { updateCommandTelemetry } from '../utils/telemetry/command-context.js';
+import { countBucket } from '../utils/telemetry/buckets.js';
+import { TypeGenerationMetrics } from '../utils/telemetry/generation-metrics.js';
 export async function generateCommand(options = {}) {
+    const command = options.commandName === 'hypequery generate:types' ? 'generate:types' : 'generate';
+    const metrics = new TypeGenerationMetrics();
+    updateCommandTelemetry(command, { custom_output: !!(options.output || options.path), tables_filter_used: !!options.tables, chdb_path_given: !!options.chdbPath });
     // Determine output path
     let outputPath;
     if (options.output) {
@@ -35,6 +43,7 @@ export async function generateCommand(options = {}) {
     const requestedDbType = options.database;
     const dbType = requestedDbType ?? (await detectDatabase());
     const chdbPath = dbType === 'chdb' ? options.chdbPath : undefined;
+    updateCommandTelemetry(command, { database: dbType === 'clickhouse' || dbType === 'chdb' || dbType === 'bigquery' ? dbType : 'unknown', chdb_path_given: !!chdbPath });
     if (dbType === 'chdb' && !requestedDbType) {
         throw new Error('chDB generation must be explicit. Re-run with --database chdb and add --chdb-path <dir> for persistent storage.');
     }
@@ -68,10 +77,13 @@ export async function generateCommand(options = {}) {
             outputPath,
             includeTables: parsedTables,
             chdbPath,
+            onColumn: () => metrics.column(),
+            onUnsupportedType: type => metrics.fallback(type),
         });
         // The generator returns what it actually wrote after applying filters.
         // Requested names may contain duplicates or tables that do not exist.
         const generatedCount = generatedTables.length;
+        updateCommandTelemetry(command, { ...metrics.snapshot(), table_count_bucket: countBucket(generatedCount) });
         typeSpinner.succeed(`Generated types for ${generatedCount} ${generatedCount === 1 ? 'table' : 'tables'}`);
         logger.success(`Updated ${path.relative(process.cwd(), outputPath)}`);
         logger.newline();
@@ -79,6 +91,7 @@ export async function generateCommand(options = {}) {
         logger.newline();
     }
     catch (error) {
+        updateCommandTelemetry(command, metrics.snapshot());
         activeSpinner.fail(failureMessage);
         logger.newline();
         if (error instanceof Error) {
@@ -140,6 +153,6 @@ export async function generateCommand(options = {}) {
             logger.error(String(error));
         }
         logger.newline();
-        process.exit(1);
+        exitWith(1, 'failure', telemetryErrorCode(error));
     }
 }

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAcL,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAe7B,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAYzF,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAqKD,wBAAsB,WAAW,CAAC,OAAO,GAAE,WAAgB,iBAsb1D"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAUA,OAAO,EAcL,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAc7B,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAYzF,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AA6GD,wBAAsB,WAAW,CAAC,OAAO,GAAE,WAAgB,iBAY1D"}