mirror of
https://github.com/Kaelio/ktx.git
synced 2026-06-07 07:55:13 +02:00
* feat: add telemetry phase 1
* feat: add node telemetry event catalog
* feat: add telemetry event helpers
* feat: emit setup and connection telemetry
* feat: emit connection and stack telemetry
* feat: emit ingest and scan telemetry
* feat: emit query telemetry
* feat: emit sampled mcp telemetry
* docs: expand telemetry event catalog
* feat: add telemetry schema sync artifact
* feat: pass telemetry project id to semantic daemon
* feat: add daemon telemetry foundation
* feat: emit semantic daemon telemetry
* feat: emit daemon lifecycle telemetry
* docs: document full telemetry event catalog
* feat(telemetry): dim first-run notice
* feat(telemetry): show first-run notice before command output
* feat(telemetry): wire ktx PostHog project for live ingestion
* docs(telemetry): drop posthog project name and host from storage section
* docs(telemetry): trim to general overview and disclaimer
* docs(agents): add short telemetry guidelines
* feat(telemetry): enable posthog geoip enrichment
* docs(telemetry): drop ip-geoip note from public overview
* refactor(telemetry): drop no-op groupIdentify, rely on capture groups field
* fix(telemetry): respect CI kill switch in python daemon identity
* fix(sql): route table-count analysis to existing analyze-batch endpoint
* fix(telemetry): emit install_first_run from notice path and derive flagsPresent from commander
* fix(telemetry): read package info via getKtxCliPackageInfo to satisfy boundary check
* fix(telemetry): make python identity env={} bypass os.environ and unset CI in tests
* fix(telemetry): unset CI kill switch in cli-program-telemetry tests
85 lines
2.6 KiB
TypeScript
85 lines
2.6 KiB
TypeScript
import { Command, type CommandUnknownOpts } from '@commander-js/extra-typings';
|
|
import { describe, expect, it } from 'vitest';
|
|
import { buildKtxProgram, collectCommandFlagsPresent } from './cli-program.js';
|
|
import type { KtxCliIo, KtxCliPackageInfo } from './cli-runtime.js';
|
|
|
|
function stubIo(): KtxCliIo {
|
|
return {
|
|
stdout: { isTTY: false, columns: 80, write: () => {} },
|
|
stderr: { write: () => {} },
|
|
};
|
|
}
|
|
|
|
function stubPackageInfo(): KtxCliPackageInfo {
|
|
return {
|
|
name: '@kaelio/ktx',
|
|
version: '0.0.0-test',
|
|
};
|
|
}
|
|
|
|
describe('buildKtxProgram', () => {
|
|
it('returns a Command named "ktx" with all registered top-level subcommands', () => {
|
|
const program: Command = buildKtxProgram({
|
|
io: stubIo(),
|
|
deps: {},
|
|
packageInfo: stubPackageInfo(),
|
|
runInit: async () => 0,
|
|
});
|
|
|
|
expect(program.name()).toBe('ktx');
|
|
const topLevel = program.commands.map((command) => command.name()).sort();
|
|
for (const expected of ['setup', 'connection', 'ingest', 'sl', 'admin']) {
|
|
expect(topLevel).toContain(expected);
|
|
}
|
|
});
|
|
|
|
it('does not parse argv or invoke action handlers', () => {
|
|
let wrote = '';
|
|
const io: KtxCliIo = {
|
|
stdout: {
|
|
isTTY: false,
|
|
columns: 80,
|
|
write: (chunk) => {
|
|
wrote += chunk;
|
|
},
|
|
},
|
|
stderr: {
|
|
write: (chunk) => {
|
|
wrote += chunk;
|
|
},
|
|
},
|
|
};
|
|
|
|
buildKtxProgram({ io, deps: {}, packageInfo: stubPackageInfo(), runInit: async () => 0 });
|
|
|
|
expect(wrote).toBe('');
|
|
});
|
|
});
|
|
|
|
describe('collectCommandFlagsPresent', () => {
|
|
it('records only CLI-sourced flags and ignores positional content that looks like a flag', async () => {
|
|
let captured: Record<string, boolean> | undefined;
|
|
const program = new Command()
|
|
.name('ktx')
|
|
.option('--project-dir <dir>', 'project directory')
|
|
.option('--json', 'json output', false);
|
|
program
|
|
.command('sql')
|
|
.argument('<sql...>')
|
|
.requiredOption('-c, --connection <id>', 'connection id')
|
|
.option('--max-rows <n>', 'cap rows')
|
|
.action(function () {
|
|
captured = collectCommandFlagsPresent(this as unknown as CommandUnknownOpts);
|
|
});
|
|
|
|
await program.parseAsync(
|
|
['--project-dir', '/tmp/p', 'sql', '-c', 'warehouse', '--', '--customer_table', 'SELECT', '1'],
|
|
{ from: 'user' },
|
|
);
|
|
|
|
expect(captured).toEqual({ projectDir: true, connection: true });
|
|
expect(captured).not.toHaveProperty('customer_table');
|
|
expect(captured).not.toHaveProperty('json');
|
|
expect(captured).not.toHaveProperty('maxRows');
|
|
});
|
|
});
|