@kaelio/ktx 0.5.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaelio/ktx",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Standalone ktx context layer for data agents",
   "type": "module",
   "engines": {
@@ -90,12 +90,12 @@
     "build": "tsc -p tsconfig.json && node dist/telemetry/schema-writer.js src/telemetry/events.schema.json ../../python/ktx-daemon/src/ktx_daemon/telemetry/events.schema.json && node scripts/copy-runtime-assets.mjs && node ../../scripts/prepare-cli-bin.mjs",
     "clean": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\"",
     "docs:commands": "pnpm run build && node dist/print-command-tree.js",
-    "smoke": "vitest run src/standalone-smoke.test.ts src/example-smoke.test.ts --testTimeout 30000",
-    "test": "vitest run --exclude src/standalone-smoke.test.ts --exclude src/example-smoke.test.ts --exclude src/setup-databases.test.ts --exclude src/scan.test.ts --exclude src/commands/connection-metabase-setup.test.ts --exclude src/setup-models.test.ts --exclude src/setup-sources.test.ts --exclude src/setup.test.ts --exclude src/connection.test.ts --exclude src/setup-embeddings.test.ts --exclude src/ingest.test.ts --exclude src/commands/connection-mapping.test.ts --exclude src/ingest-viz.test.ts --exclude src/demo.test.ts --exclude src/setup-project.test.ts --exclude src/sl.test.ts --exclude src/local-scan-connectors.test.ts --exclude src/commands/connection-notion.test.ts --exclude src/context/scan/local-scan.test.ts --exclude src/context/mcp/local-project-ports.test.ts --exclude src/context/ingest/local-stage-ingest.test.ts --exclude src/context/sl/pglite-sl-search-prototype.test.ts --exclude src/context/core/git.service.test.ts --exclude src/context/ingest/local-adapters.test.ts --exclude src/context/ingest/local-bundle-ingest.test.ts --exclude src/context/ingest/local-metabase-ingest.test.ts --exclude src/context/sl/local-sl.test.ts --exclude src/context/search/pglite-owner-process.test.ts --exclude src/context/scan/local-enrichment-artifacts.test.ts --exclude src/context/search/pglite-spike.test.ts --exclude src/context/wiki/local-knowledge.test.ts --exclude src/context/sl/local-query.test.ts --exclude src/context/scan/relationship-review-decisions.test.ts --exclude src/context/scan/relationship-profiling.test.ts",
-    "test:slow": "vitest run src/setup-databases.test.ts src/scan.test.ts src/commands/connection-metabase-setup.test.ts src/setup-models.test.ts src/setup-sources.test.ts src/setup.test.ts src/connection.test.ts src/setup-embeddings.test.ts src/ingest.test.ts src/commands/connection-mapping.test.ts src/ingest-viz.test.ts src/demo.test.ts src/setup-project.test.ts src/sl.test.ts src/local-scan-connectors.test.ts src/commands/connection-notion.test.ts src/context/scan/local-scan.test.ts src/context/mcp/local-project-ports.test.ts src/context/ingest/local-stage-ingest.test.ts src/context/sl/pglite-sl-search-prototype.test.ts src/context/core/git.service.test.ts src/context/ingest/local-adapters.test.ts src/context/ingest/local-bundle-ingest.test.ts src/context/ingest/local-metabase-ingest.test.ts src/context/sl/local-sl.test.ts src/context/search/pglite-owner-process.test.ts src/context/scan/local-enrichment-artifacts.test.ts src/context/search/pglite-spike.test.ts src/context/wiki/local-knowledge.test.ts src/context/sl/local-query.test.ts src/context/scan/relationship-review-decisions.test.ts src/context/scan/relationship-profiling.test.ts --testTimeout 30000",
-    "type-check": "tsc -p tsconfig.json --noEmit",
+    "smoke": "vitest run test/standalone-smoke.test.ts test/example-smoke.test.ts --testTimeout 30000",
+    "test": "vitest run --exclude test/standalone-smoke.test.ts --exclude test/example-smoke.test.ts --exclude test/setup-databases.test.ts --exclude test/scan.test.ts --exclude test/commands/connection-metabase-setup.test.ts --exclude test/setup-models.test.ts --exclude test/setup-sources.test.ts --exclude test/setup.test.ts --exclude test/connection.test.ts --exclude test/setup-embeddings.test.ts --exclude test/ingest.test.ts --exclude test/commands/connection-mapping.test.ts --exclude test/ingest-viz.test.ts --exclude test/demo.test.ts --exclude test/setup-project.test.ts --exclude test/sl.test.ts --exclude test/local-scan-connectors.test.ts --exclude test/commands/connection-notion.test.ts --exclude test/context/scan/local-scan.test.ts --exclude test/context/mcp/local-project-ports.test.ts --exclude test/context/ingest/local-stage-ingest.test.ts --exclude test/context/sl/pglite-sl-search-prototype.test.ts --exclude test/context/core/git.service.test.ts --exclude test/context/ingest/local-adapters.test.ts --exclude test/context/ingest/local-bundle-ingest.test.ts --exclude test/context/ingest/local-metabase-ingest.test.ts --exclude test/context/sl/local-sl.test.ts --exclude test/context/search/pglite-owner-process.test.ts --exclude test/context/scan/local-enrichment-artifacts.test.ts --exclude test/context/search/pglite-spike.test.ts --exclude test/context/wiki/local-knowledge.test.ts --exclude test/context/sl/local-query.test.ts --exclude test/context/scan/relationship-review-decisions.test.ts --exclude test/context/scan/relationship-profiling.test.ts",
+    "test:slow": "vitest run test/setup-databases.test.ts test/scan.test.ts test/commands/connection-metabase-setup.test.ts test/setup-models.test.ts test/setup-sources.test.ts test/setup.test.ts test/connection.test.ts test/setup-embeddings.test.ts test/ingest.test.ts test/commands/connection-mapping.test.ts test/ingest-viz.test.ts test/demo.test.ts test/setup-project.test.ts test/sl.test.ts test/local-scan-connectors.test.ts test/commands/connection-notion.test.ts test/context/scan/local-scan.test.ts test/context/mcp/local-project-ports.test.ts test/context/ingest/local-stage-ingest.test.ts test/context/sl/pglite-sl-search-prototype.test.ts test/context/core/git.service.test.ts test/context/ingest/local-adapters.test.ts test/context/ingest/local-bundle-ingest.test.ts test/context/ingest/local-metabase-ingest.test.ts test/context/sl/local-sl.test.ts test/context/search/pglite-owner-process.test.ts test/context/scan/local-enrichment-artifacts.test.ts test/context/search/pglite-spike.test.ts test/context/wiki/local-knowledge.test.ts test/context/sl/local-query.test.ts test/context/scan/relationship-review-decisions.test.ts test/context/scan/relationship-profiling.test.ts --testTimeout 30000",
+    "type-check": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit",
     "relationships:benchmarks": "pnpm --silent run build && node ../../scripts/relationship-benchmark-report.mjs",
-    "relationships:benchmarks:test": "KTX_RUN_RELATIONSHIP_BENCHMARKS=1 vitest run src/context/scan/relationship-benchmarks.test.ts",
+    "relationships:benchmarks:test": "KTX_RUN_RELATIONSHIP_BENCHMARKS=1 vitest run test/context/scan/relationship-benchmarks.test.ts",
     "search:pglite-spike": "node ../../scripts/pglite-hybrid-search-spike.mjs",
     "search:pglite-owner-prototype": "node ../../scripts/pglite-owner-process-prototype.mjs",
     "search:pglite-sl-prototype": "node ../../scripts/pglite-sl-search-prototype.mjs"

package/dist/admin-reindex.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/admin-reindex.test.js

@@ -1,119 +0,0 @@
-import { createRequire } from 'node:module';
-import { describe, expect, it, vi } from 'vitest';
-import { renderReindexJson, renderReindexPlain, reindexHasErrors } from './admin-reindex.js';
-import { runKtxCli } from './index.js';
-const cliVersion = createRequire(import.meta.url)('@kaelio/ktx/package.json')
-    .version;
-function makeIo(options = {}) {
-    let stdout = '';
-    let stderr = '';
-    return {
-        io: {
-            stdout: {
-                isTTY: options.stdoutIsTTY,
-                write: (chunk) => {
-                    stdout += chunk;
-                },
-            },
-            stderr: {
-                write: (chunk) => {
-                    stderr += chunk;
-                },
-            },
-        },
-        stdout: () => stdout,
-        stderr: () => stderr,
-    };
-}
-function summary(overrides = {}) {
-    return {
-        scopes: [
-            {
-                kind: 'wiki',
-                label: 'global',
-                scope: 'global',
-                scopeId: null,
-                scanned: 42,
-                updated: 3,
-                deleted: 1,
-                embeddingsRecomputed: 3,
-                embeddingsFailed: 0,
-                durationMs: 412,
-            },
-            {
-                kind: 'sl',
-                label: 'warehouse',
-                connectionId: 'warehouse',
-                scanned: 18,
-                updated: 2,
-                deleted: 0,
-                embeddingsRecomputed: 2,
-                embeddingsFailed: 0,
-                durationMs: 287,
-            },
-        ],
-        totals: { scanned: 60, updated: 5, deleted: 1, embeddingsRecomputed: 5, embeddingsFailed: 0 },
-        dbPath: '.ktx/db.sqlite',
-        force: false,
-        embeddingsAvailable: true,
-        durationMs: 1234,
-        ...overrides,
-    };
-}
-describe('admin reindex renderers', () => {
-    it('renders plain scope lines to stderr and summary to stdout', () => {
-        const io = makeIo();
-        renderReindexPlain(summary(), io.io);
-        expect(io.stderr()).toContain('wiki/global\tscanned=42\tupdated=3\tdeleted=1\tembeddings=3\tduration_ms=412\n');
-        expect(io.stderr()).toContain('sl/warehouse\tscanned=18\tupdated=2\tdeleted=0\tembeddings=2\tduration_ms=287\n');
-        expect(io.stdout()).toBe('reindex\tscopes=2\tscanned=60\tupdated=5\tdeleted=1\tembeddings=5\tduration_ms=1234\n');
-    });
-    it('renders rebuilt labels in plain force mode', () => {
-        const io = makeIo();
-        renderReindexPlain(summary({ force: true }), io.io);
-        expect(io.stderr()).toContain('rebuilt=3');
-        expect(io.stdout()).toContain('rebuilt=5');
-        expect(io.stdout()).not.toContain('updated=5');
-    });
-    it('renders json envelope to stdout only', () => {
-        const io = makeIo();
-        renderReindexJson(summary(), io.io);
-        expect(JSON.parse(io.stdout())).toMatchObject({
-            kind: 'reindex',
-            data: { totals: { scanned: 60, updated: 5 } },
-            meta: { command: 'admin reindex' },
-        });
-        expect(io.stderr()).toBe('');
-    });
-    it('detects per-scope errors', () => {
-        expect(reindexHasErrors(summary({
-            scopes: [{ ...summary().scopes[0], error: 'provider failed' }],
-        }))).toBe(true);
-    });
-});
-describe('admin reindex Commander routing', () => {
-    it('routes flags to the injectable reindex runner', async () => {
-        const { mkdir, mkdtemp, rm, writeFile } = await import('node:fs/promises');
-        const { tmpdir } = await import('node:os');
-        const { join } = await import('node:path');
-        const tempDir = await mkdtemp(join(tmpdir(), 'ktx-admin-reindex-cli-'));
-        const projectDir = join(tempDir, 'project');
-        const io = makeIo();
-        const adminReindex = vi.fn(async () => 0);
-        try {
-            await mkdir(projectDir, { recursive: true });
-            await writeFile(join(projectDir, 'ktx.yaml'), '{}\n', 'utf-8');
-            await expect(runKtxCli(['--project-dir', projectDir, 'admin', 'reindex', '--force', '--json', '--output', 'plain'], io.io, { adminReindex })).resolves.toBe(0);
-        }
-        finally {
-            await rm(tempDir, { recursive: true, force: true });
-        }
-        expect(adminReindex).toHaveBeenCalledWith({
-            projectDir,
-            force: true,
-            json: true,
-            output: 'plain',
-            cliVersion,
-        }, io.io);
-    });
-});

package/dist/admin.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/admin.test.js

@@ -1,201 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { runKtxCli } from './index.js';
-function makeIo() {
-    let stdout = '';
-    let stderr = '';
-    return {
-        io: {
-            stdout: {
-                write: (chunk) => {
-                    stdout += chunk;
-                },
-            },
-            stderr: {
-                write: (chunk) => {
-                    stderr += chunk;
-                },
-            },
-        },
-        stdout: () => stdout,
-        stderr: () => stderr,
-    };
-}
-describe('admin Commander tree', () => {
-    it('prints visible admin help with supported low-level command groups', async () => {
-        const testIo = makeIo();
-        await expect(runKtxCli(['admin', '--help'], testIo.io)).resolves.toBe(0);
-        expect(testIo.stdout()).toContain('Usage: ktx admin [options] [command]');
-        for (const command of ['init', 'runtime', 'reindex']) {
-            expect(testIo.stdout()).toContain(command);
-        }
-        for (const removed of [
-            'doctor',
-            'scan',
-            'ingest',
-            'mapping',
-            'knowledge',
-            'model',
-            'replay',
-            'report',
-            'status',
-            'artifacts',
-            'config',
-            'tools',
-            'daemon',
-        ]) {
-            expect(testIo.stdout()).not.toContain(`${removed} `);
-        }
-        expect(testIo.stderr()).toBe('');
-    });
-    it('lists admin in root command rows', async () => {
-        const testIo = makeIo();
-        await expect(runKtxCli(['--help'], testIo.io)).resolves.toBe(0);
-        expect(testIo.stdout()).not.toContain('Advanced:');
-        expect(testIo.stdout()).toContain('admin');
-        expect(testIo.stdout()).toMatch(/Low-level project initialization,\s+runtime,\s+and index management/);
-        expect(testIo.stderr()).toBe('');
-    });
-    it('does not keep a dev alias', async () => {
-        const testIo = makeIo();
-        await expect(runKtxCli(['dev', '--help'], testIo.io)).resolves.toBe(1);
-        expect(testIo.stderr()).toContain("unknown command 'dev'");
-    });
-    it('keeps project scaffolding under admin init', async () => {
-        const { mkdtemp, readFile, rm } = await import('node:fs/promises');
-        const { tmpdir } = await import('node:os');
-        const { join } = await import('node:path');
-        const tempDir = await mkdtemp(join(tmpdir(), 'ktx-admin-init-'));
-        const projectDir = join(tempDir, 'warehouse');
-        const testIo = makeIo();
-        try {
-            await expect(runKtxCli(['admin', 'init', projectDir], testIo.io)).resolves.toBe(0);
-            expect(testIo.stdout()).toContain(`Initialized KTX project at ${projectDir}`);
-            await expect(readFile(join(projectDir, 'ktx.yaml'), 'utf-8')).resolves.not.toContain('project:');
-            expect(testIo.stderr()).toBe('');
-        }
-        finally {
-            await rm(tempDir, { recursive: true, force: true });
-        }
-    });
-    it('uses global project-dir for admin init when the positional directory is omitted', async () => {
-        const { mkdtemp, rm } = await import('node:fs/promises');
-        const { tmpdir } = await import('node:os');
-        const { join } = await import('node:path');
-        const tempDir = await mkdtemp(join(tmpdir(), 'ktx-admin-init-global-'));
-        const projectDir = join(tempDir, 'global-init');
-        const testIo = makeIo();
-        try {
-            await expect(runKtxCli(['--project-dir', projectDir, 'admin', 'init'], testIo.io)).resolves.toBe(0);
-            expect(testIo.stdout()).toContain(`Initialized KTX project at ${projectDir}`);
-            expect(testIo.stderr()).toBe('');
-        }
-        finally {
-            await rm(tempDir, { recursive: true, force: true });
-        }
-    });
-    it('prints config schema without requiring a KTX project directory', async () => {
-        const { mkdtemp, rm } = await import('node:fs/promises');
-        const { tmpdir } = await import('node:os');
-        const { join } = await import('node:path');
-        const tempDir = await mkdtemp(join(tmpdir(), 'ktx-admin-schema-'));
-        const missingProjectDir = join(tempDir, 'missing-project');
-        const originalProjectDir = process.env.KTX_PROJECT_DIR;
-        const testIo = makeIo();
-        try {
-            process.env.KTX_PROJECT_DIR = missingProjectDir;
-            await expect(runKtxCli(['admin', 'schema'], testIo.io)).resolves.toBe(0);
-            expect(JSON.parse(testIo.stdout())).toMatchObject({
-                title: 'ktx.yaml',
-                type: 'object',
-            });
-            expect(testIo.stderr()).toBe('');
-        }
-        finally {
-            if (originalProjectDir === undefined) {
-                delete process.env.KTX_PROJECT_DIR;
-            }
-            else {
-                process.env.KTX_PROJECT_DIR = originalProjectDir;
-            }
-            await rm(tempDir, { recursive: true, force: true });
-        }
-    });
-    it('rejects removed admin command groups', async () => {
-        for (const argv of [
-            ['admin', 'doctor', 'setup'],
-            ['admin', 'runtime', 'doctor'],
-            ['admin', 'runtime', 'prune', '--dry-run'],
-            ['admin', 'scan', 'warehouse'],
-            ['admin', 'ingest', 'run'],
-            ['admin', 'mapping', 'list'],
-            ['admin', 'completion', 'zsh'],
-            ['admin', '__complete', '--shell', 'zsh', '--position', '2', '--', 'ktx', ''],
-            ['admin', 'knowledge', 'list'],
-            ['admin', 'model', 'list'],
-            ['admin', 'artifacts'],
-        ]) {
-            const testIo = makeIo();
-            await expect(runKtxCli(argv, testIo.io)).resolves.toBe(1);
-            expect(testIo.stderr()).toMatch(/unknown command|error:/);
-        }
-    });
-    it.each([
-        {
-            argv: ['admin', 'runtime', '--help'],
-            expected: ['Usage: ktx admin runtime', 'install', 'start', 'stop', 'status'],
-        },
-    ])('prints generated nested help for $argv', async ({ argv, expected }) => {
-        const io = makeIo();
-        const doctor = vi.fn(async () => 0);
-        await expect(runKtxCli(argv, io.io, { doctor })).resolves.toBe(0);
-        for (const text of expected) {
-            expect(io.stdout()).toContain(text);
-        }
-        if (argv.join(' ') === 'admin runtime --help') {
-            expect(io.stdout()).not.toContain('prune');
-            expect(io.stdout()).not.toContain('doctor');
-        }
-        expect(io.stderr()).toBe('');
-        expect(doctor).not.toHaveBeenCalled();
-    });
-    it('rejects old adapter-backed ingest flags through public option parsing and keeps run out of ingest help', async () => {
-        const helpIo = makeIo();
-        const runIo = makeIo();
-        const publicIngest = vi.fn(async () => 0);
-        await expect(runKtxCli(['ingest', '--help'], helpIo.io, { publicIngest })).resolves.toBe(0);
-        await expect(runKtxCli(['ingest', 'run', '--connection-id', 'warehouse', '--adapter', 'metabase', '--project-dir', '/tmp/project'], runIo.io, { publicIngest })).resolves.toBe(1);
-        expect(helpIo.stdout()).not.toMatch(/^  run\s/m);
-        expect(runIo.stderr()).toMatch(/unknown option '--connection-id'|error:/);
-        expect(publicIngest).not.toHaveBeenCalled();
-    });
-    it.each([
-        { argv: ['scan'] },
-        { argv: ['scan', '--help'] },
-        { argv: ['scan', 'warehouse'] },
-        { argv: ['scan', 'warehouse', '--project-dir', '/tmp/project', '--dry-run'] },
-        { argv: ['scan', 'warehouse', '--project-dir', '/tmp/project', '--mode', 'relationships'] },
-    ])('rejects removed top-level scan command $argv', async ({ argv }) => {
-        const io = makeIo();
-        const publicIngest = vi.fn(async () => 0);
-        await expect(runKtxCli(argv, io.io, { publicIngest })).resolves.toBe(1);
-        expect(publicIngest).not.toHaveBeenCalled();
-        expect(io.stderr()).toMatch(/unknown command|error:/);
-    });
-    it('rejects old adapter-backed top-level ingest flags without low-level ingest registration', async () => {
-        const io = makeIo();
-        const publicIngest = vi.fn(async () => 0);
-        await expect(runKtxCli([
-            'ingest',
-            'run',
-            '--connection-id',
-            'warehouse',
-            '--adapter',
-            'metabase',
-            '--project-dir',
-            '/tmp/project',
-            '--json',
-        ], io.io, { publicIngest })).resolves.toBe(1);
-        expect(publicIngest).not.toHaveBeenCalled();
-        expect(io.stderr()).toMatch(/unknown option '--connection-id'|error:/);
-    });
-});

package/dist/cli-program-telemetry.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/cli-program-telemetry.test.js

@@ -1,89 +0,0 @@
-import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { runCommanderKtxCli } from './cli-program.js';
-function makeIo(stdoutIsTTY = true) {
-    let stdout = '';
-    let stderr = '';
-    return {
-        io: {
-            stdout: {
-                isTTY: stdoutIsTTY,
-                write: (chunk) => {
-                    stdout += chunk;
-                },
-            },
-            stderr: {
-                write: (chunk) => {
-                    stderr += chunk;
-                },
-            },
-        },
-        stdout: () => stdout,
-        stderr: () => stderr,
-    };
-}
-const info = { name: '@kaelio/ktx', version: '0.4.1' };
-describe('runCommanderKtxCli telemetry', () => {
-    let tempDir;
-    const originalEnv = process.env;
-    beforeEach(async () => {
-        tempDir = await mkdtemp(join(tmpdir(), 'ktx-cli-telemetry-'));
-        await writeFile(join(tempDir, 'ktx.yaml'), '{}\n', 'utf-8');
-        vi.stubEnv('KTX_TELEMETRY_DEBUG', '1');
-        vi.stubEnv('HOME', tempDir);
-        vi.stubEnv('CI', '');
-        vi.stubEnv('KTX_TELEMETRY_DISABLED', '');
-        vi.stubEnv('DO_NOT_TRACK', '');
-    });
-    afterEach(async () => {
-        vi.unstubAllEnvs();
-        process.env = originalEnv;
-        await rm(tempDir, { recursive: true, force: true });
-    });
-    it('emits debug command telemetry for registered actions', async () => {
-        const io = makeIo(true);
-        await expect(runCommanderKtxCli(['--project-dir', tempDir, 'status', '--help'], io.io, {}, info, { runInit: async () => 0 })).resolves.toBe(0);
-        expect(io.stderr()).not.toContain('[telemetry]');
-        const statusIo = makeIo(true);
-        const deps = { doctor: async () => 0 };
-        await expect(runCommanderKtxCli(['--project-dir', tempDir, 'status', '--json'], statusIo.io, deps, info, { runInit: async () => 0 })).resolves.toBe(0);
-        expect(statusIo.stderr()).toContain('[telemetry]');
-        expect(statusIo.stderr()).toContain('"event":"install_first_run"');
-        expect(statusIo.stderr()).toContain('"event":"command"');
-        expect(statusIo.stderr()).toContain('"commandPath":["ktx","status"]');
-        expect(statusIo.stderr()).toContain('"event":"project_stack_snapshot"');
-        expect(statusIo.stderr()).toContain('"connectionCount"');
-        expect(statusIo.stderr()).not.toContain(tempDir);
-        const noticeIndex = statusIo.stderr().indexOf('ktx collects anonymous usage data');
-        const firstTelemetryIndex = statusIo.stderr().indexOf('[telemetry]');
-        expect(noticeIndex).toBeGreaterThanOrEqual(0);
-        expect(firstTelemetryIndex).toBeGreaterThan(noticeIndex);
-    });
-    it('emits aborted telemetry when project validation aborts after preAction starts', async () => {
-        const missingProjectDir = join(tempDir, 'missing');
-        await mkdir(missingProjectDir, { recursive: true });
-        const io = makeIo(true);
-        await expect(runCommanderKtxCli(['--project-dir', missingProjectDir, 'connection'], io.io, {}, info, { runInit: async () => 0 })).resolves.toBe(1);
-        expect(io.stderr()).toContain('[telemetry]');
-        expect(io.stderr()).toContain('"outcome":"aborted"');
-        expect(io.stderr()).toContain('"hasProject":false');
-        expect(io.stderr()).toContain('"projectGroupAttached":false');
-        expect(io.stderr()).not.toContain(missingProjectDir);
-    });
-    it('does not import or emit telemetry for help, version, bare non-TTY, or unknown top-level command', async () => {
-        const helpIo = makeIo(true);
-        await expect(runCommanderKtxCli(['--help'], helpIo.io, {}, info, { runInit: async () => 0 })).resolves.toBe(0);
-        expect(helpIo.stderr()).not.toContain('[telemetry]');
-        const versionIo = makeIo(true);
-        await expect(runCommanderKtxCli(['--version'], versionIo.io, {}, info, { runInit: async () => 0 })).resolves.toBe(0);
-        expect(versionIo.stderr()).not.toContain('[telemetry]');
-        const bareIo = makeIo(false);
-        await expect(runCommanderKtxCli([], bareIo.io, {}, info, { runInit: async () => 0 })).resolves.toBe(0);
-        expect(bareIo.stderr()).not.toContain('[telemetry]');
-        const unknownIo = makeIo(true);
-        await expect(runCommanderKtxCli(['unknown'], unknownIo.io, {}, info, { runInit: async () => 0 })).resolves.toBe(1);
-        expect(unknownIo.stderr()).not.toContain('[telemetry]');
-    });
-});

package/dist/cli-program.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/cli-program.test.js

@@ -1,71 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { describe, expect, it } from 'vitest';
-import { buildKtxProgram, collectCommandFlagsPresent } from './cli-program.js';
-function stubIo() {
-    return {
-        stdout: { isTTY: false, columns: 80, write: () => { } },
-        stderr: { write: () => { } },
-    };
-}
-function stubPackageInfo() {
-    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 = 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 = {
-            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;
-        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);
-        });
-        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');
-    });
-});

package/dist/command-tree.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/command-tree.test.js

@@ -1,126 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { describe, expect, it } from 'vitest';
-import { formatCommandTree, walkCommandTree } from './command-tree.js';
-describe('walkCommandTree', () => {
-    it('captures name, description, aliases, and nested children', () => {
-        const root = new Command('root').description('the root');
-        const child = new Command('child').description('a child').alias('c').alias('ch');
-        const grandchild = new Command('grand').description('a grandchild');
-        child.addCommand(grandchild);
-        root.addCommand(child);
-        const tree = walkCommandTree(root);
-        expect(tree).toEqual({
-            name: 'root',
-            description: 'the root',
-            aliases: [],
-            arguments: [],
-            children: [
-                {
-                    name: 'child',
-                    description: 'a child',
-                    aliases: ['c', 'ch'],
-                    arguments: [],
-                    children: [{ name: 'grand', description: 'a grandchild', aliases: [], arguments: [], children: [] }],
-                },
-            ],
-        });
-    });
-    it('returns an empty children array when there are no subcommands', () => {
-        const leaf = new Command('leaf').description('alone');
-        expect(walkCommandTree(leaf)).toEqual({
-            name: 'leaf',
-            description: 'alone',
-            aliases: [],
-            arguments: [],
-            children: [],
-        });
-    });
-    it('uses an empty string when description is unset', () => {
-        const command = new Command('bare');
-        expect(walkCommandTree(command).description).toBe('');
-    });
-    it('captures required, optional, and variadic arguments', () => {
-        const command = new Command('scan')
-            .argument('<connectionId>', 'KTX connection id')
-            .argument('[schemas...]', 'Schemas');
-        expect(walkCommandTree(command).arguments).toEqual(['<connectionId>', '[schemas...]']);
-    });
-    it('walks registered commands without applying hidden-command policy', () => {
-        const root = new Command('ktx');
-        root.command('scan', { hidden: true }).description('Run a standalone connection scan');
-        const ingest = root.command('ingest').description('Build or inspect KTX context');
-        ingest.command('run', { hidden: true }).description('Run local ingest by adapter');
-        ingest.command('watch', { hidden: true }).description('Open a stored visual report');
-        ingest.command('status').description('Print status');
-        root.command('status').description('Check readiness');
-        const tree = walkCommandTree(root);
-        expect(tree.children.map((child) => child.name)).toEqual(['scan', 'ingest', 'status']);
-        expect(tree.children[0]).toMatchObject({
-            name: 'scan',
-            description: 'Run a standalone connection scan',
-            children: [],
-        });
-        expect(tree.children[1]).toMatchObject({
-            name: 'ingest',
-            children: [
-                { name: 'run', description: 'Run local ingest by adapter', aliases: [], arguments: [], children: [] },
-                { name: 'watch', description: 'Open a stored visual report', aliases: [], arguments: [], children: [] },
-                { name: 'status', description: 'Print status', aliases: [], arguments: [], children: [] },
-            ],
-        });
-    });
-});
-describe('formatCommandTree', () => {
-    it('renders a single node with no children', () => {
-        const node = { name: 'solo', description: 'just me', aliases: [], arguments: [], children: [] };
-        expect(formatCommandTree(node)).toMatch(/^solo\s+just me\n$/);
-    });
-    it('renders aliases in parentheses before the description', () => {
-        const node = { name: 'cmd', description: 'does things', aliases: ['c', 'co'], arguments: [], children: [] };
-        expect(formatCommandTree(node)).toMatch(/^cmd \(c, co\)\s+does things\n$/);
-    });
-    it('renders command arguments after the command name', () => {
-        const node = {
-            name: 'test',
-            description: 'Test a configured connection',
-            aliases: [],
-            arguments: ['<connectionId>'],
-            children: [],
-        };
-        expect(formatCommandTree(node)).toMatch(/^test <connectionId>\s+Test a configured connection\n$/);
-    });
-    it('omits the dash when description is empty', () => {
-        const node = { name: 'bare', description: '', aliases: [], arguments: [], children: [] };
-        expect(formatCommandTree(node)).toBe('bare\n');
-    });
-    it('renders tree connectors and preserves sibling registration order', () => {
-        const tree = {
-            name: 'root',
-            description: 'top',
-            aliases: [],
-            arguments: [],
-            children: [
-                {
-                    name: 'beta',
-                    description: 'b',
-                    aliases: [],
-                    arguments: [],
-                    children: [{ name: 'leaf', description: 'l', aliases: [], arguments: [], children: [] }],
-                },
-                {
-                    name: 'alpha',
-                    description: 'a',
-                    aliases: ['al'],
-                    arguments: ['<id>'],
-                    children: [{ name: 'inner', description: 'i', aliases: [], arguments: [], children: [] }],
-                },
-            ],
-        };
-        const lines = formatCommandTree(tree).trimEnd().split('\n');
-        expect(lines[0]).toMatch(/^root\s+top$/);
-        expect(lines[1]).toMatch(/^  ├── beta\s+b$/);
-        expect(lines[2]).toMatch(/^  │   └── leaf\s+l$/);
-        expect(lines[3]).toMatch(/^  └── alpha <id> \(al\)\s+a$/);
-        expect(lines[4]).toMatch(/^      └── inner\s+i$/);
-    });
-});