@kaelio/ktx 0.5.0 → 0.7.0

package/dist/runtime-requirements.test.d.ts

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

package/dist/runtime-requirements.test.js

@@ -1,73 +0,0 @@
-import { buildDefaultKtxProjectConfig } from './context/project/config.js';
-import { describe, expect, it } from 'vitest';
-import { resolveProjectRuntimeRequirements, resolvePublicIngestRuntimeRequirements, } from './runtime-requirements.js';
-describe('runtime requirement detection', () => {
-    it('does not require runtime for agent/MCP setup alone', () => {
-        const config = buildDefaultKtxProjectConfig();
-        expect(resolveProjectRuntimeRequirements(config).features).toEqual([]);
-    });
-    it('requires core for Looker source ingest unless an external daemon is configured', () => {
-        const config = {
-            ...buildDefaultKtxProjectConfig(),
-            connections: {
-                looker: { driver: 'looker', base_url: 'https://looker.example.com', client_id: 'client-id' },
-            },
-        };
-        expect(resolveProjectRuntimeRequirements(config).features).toEqual(['core']);
-        expect(resolveProjectRuntimeRequirements(config, { env: { KTX_DAEMON_URL: 'http://127.0.0.1:8765' } }).features).toEqual([]);
-    });
-    it('requires core for query-history ingest unless SQL analysis is externally configured', () => {
-        const config = {
-            ...buildDefaultKtxProjectConfig(),
-            connections: {
-                warehouse: { driver: 'postgres', context: { queryHistory: { enabled: true } } },
-            },
-        };
-        expect(resolveProjectRuntimeRequirements(config).features).toEqual(['core']);
-        expect(resolveProjectRuntimeRequirements(config, { env: { KTX_SQL_ANALYSIS_URL: 'http://127.0.0.1:8765' } }).features).toEqual([]);
-    });
-    it('requires local-embeddings for managed sentence-transformers embeddings', () => {
-        const config = {
-            ...buildDefaultKtxProjectConfig(),
-            ingest: {
-                ...buildDefaultKtxProjectConfig().ingest,
-                embeddings: {
-                    backend: 'sentence-transformers',
-                    model: 'all-MiniLM-L6-v2',
-                    dimensions: 384,
-                    sentenceTransformers: {
-                        base_url: '',
-                    },
-                },
-            },
-        };
-        expect(resolveProjectRuntimeRequirements(config).features).toEqual(['local-embeddings']);
-    });
-    it('detects foreground ingest runtime needs from selected query-history targets', () => {
-        const config = {
-            ...buildDefaultKtxProjectConfig(),
-            ingest: {
-                ...buildDefaultKtxProjectConfig().ingest,
-                embeddings: {
-                    backend: 'sentence-transformers',
-                    model: 'all-MiniLM-L6-v2',
-                    dimensions: 384,
-                },
-            },
-        };
-        expect(resolvePublicIngestRuntimeRequirements({
-            projectDir: '/tmp/project',
-            warnings: [],
-            targets: [
-                {
-                    connectionId: 'warehouse',
-                    driver: 'postgres',
-                    operation: 'database-ingest',
-                    debugCommand: 'ktx ingest warehouse --debug',
-                    steps: ['database-schema', 'query-history'],
-                    queryHistory: { enabled: true },
-                },
-            ],
-        }, { config }).features).toEqual(['core', 'local-embeddings']);
-    });
-});

package/dist/runtime.test.d.ts

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

package/dist/runtime.test.js

@@ -1,381 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { runKtxRuntime } from './runtime.js';
-function makeIo() {
-    let stdout = '';
-    let stderr = '';
-    return {
-        io: {
-            stdout: {
-                write: (chunk) => {
-                    stdout += chunk;
-                },
-            },
-            stderr: {
-                write: (chunk) => {
-                    stderr += chunk;
-                },
-            },
-        },
-        stdout: () => stdout,
-        stderr: () => stderr,
-    };
-}
-describe('runKtxRuntime', () => {
-    it('installs the requested runtime feature and prints the manifest path', async () => {
-        const io = makeIo();
-        const deps = {
-            installRuntime: vi.fn(async () => ({
-                status: 'installed',
-                layout: {
-                    cliVersion: '0.2.0',
-                    runtimeRoot: '/runtime',
-                    versionDir: '/runtime/0.2.0',
-                    venvDir: '/runtime/0.2.0/.venv',
-                    manifestPath: '/runtime/0.2.0/manifest.json',
-                    installLogPath: '/runtime/0.2.0/install.log',
-                    assetDir: '/assets/python',
-                    assetManifestPath: '/assets/python/manifest.json',
-                    pythonPath: '/runtime/0.2.0/.venv/bin/python',
-                    daemonPath: '/runtime/0.2.0/.venv/bin/ktx-daemon',
-                },
-                asset: {
-                    wheelPath: '/assets/python/kaelio_ktx-0.1.0-py3-none-any.whl',
-                    requiresPython: { specifier: '>=3.13', minimumVersion: '3.13' },
-                    manifest: {
-                        schemaVersion: 1,
-                        distributionName: 'kaelio-ktx',
-                        normalizedName: 'kaelio_ktx',
-                        version: '0.1.0',
-                        wheel: {
-                            file: 'kaelio_ktx-0.1.0-py3-none-any.whl',
-                            sha256: 'a'.repeat(64),
-                            bytes: 10,
-                        },
-                    },
-                },
-                manifest: {
-                    schemaVersion: 1,
-                    cliVersion: '0.2.0',
-                    installedAt: '2026-05-11T00:00:00.000Z',
-                    asset: {
-                        schemaVersion: 1,
-                        distributionName: 'kaelio-ktx',
-                        normalizedName: 'kaelio_ktx',
-                        version: '0.1.0',
-                        wheel: {
-                            file: 'kaelio_ktx-0.1.0-py3-none-any.whl',
-                            sha256: 'a'.repeat(64),
-                            bytes: 10,
-                        },
-                    },
-                    features: ['core', 'local-embeddings'],
-                    python: {
-                        executable: '/runtime/0.2.0/.venv/bin/python',
-                        daemonExecutable: '/runtime/0.2.0/.venv/bin/ktx-daemon',
-                    },
-                    installLog: '/runtime/0.2.0/install.log',
-                },
-            })),
-        };
-        await expect(runKtxRuntime({ command: 'install', cliVersion: '0.2.0', feature: 'local-embeddings', force: true }, io.io, deps)).resolves.toBe(0);
-        expect(deps.installRuntime).toHaveBeenCalledWith({
-            cliVersion: '0.2.0',
-            features: ['local-embeddings'],
-            force: true,
-        });
-        expect(io.stdout()).toContain('Installed KTX Python runtime');
-        expect(io.stdout()).toContain('features: core, local-embeddings');
-        expect(io.stdout()).toContain('manifest: /runtime/0.2.0/manifest.json');
-        expect(io.stderr()).toBe('');
-    });
-    it('starts the KTX daemon and prints the base URL', async () => {
-        const io = makeIo();
-        const deps = {
-            startDaemon: vi.fn(async () => ({
-                status: 'started',
-                baseUrl: 'http://127.0.0.1:61234',
-                layout: {
-                    cliVersion: '0.2.0',
-                    runtimeRoot: '/runtime',
-                    versionDir: '/runtime/0.2.0',
-                    venvDir: '/runtime/0.2.0/.venv',
-                    manifestPath: '/runtime/0.2.0/manifest.json',
-                    installLogPath: '/runtime/0.2.0/install.log',
-                    assetDir: '/assets/python',
-                    assetManifestPath: '/assets/python/manifest.json',
-                    pythonPath: '/runtime/0.2.0/.venv/bin/python',
-                    daemonPath: '/runtime/0.2.0/.venv/bin/ktx-daemon',
-                    projectDir: '/work/proj',
-                    daemonStateDir: '/work/proj/.ktx/runtime',
-                    daemonStatePath: '/work/proj/.ktx/runtime/daemon.json',
-                    daemonStdoutPath: '/work/proj/.ktx/runtime/daemon.stdout.log',
-                    daemonStderrPath: '/work/proj/.ktx/runtime/daemon.stderr.log',
-                },
-                state: {
-                    schemaVersion: 1,
-                    pid: 4242,
-                    host: '127.0.0.1',
-                    port: 61234,
-                    version: '0.2.0',
-                    features: ['core', 'local-embeddings'],
-                    startedAt: '2026-05-11T00:00:00.000Z',
-                    stdoutLog: '/work/proj/.ktx/runtime/daemon.stdout.log',
-                    stderrLog: '/work/proj/.ktx/runtime/daemon.stderr.log',
-                },
-            })),
-        };
-        await expect(runKtxRuntime({ command: 'start', cliVersion: '0.2.0', projectDir: '/work/proj', feature: 'local-embeddings', force: true }, io.io, deps)).resolves.toBe(0);
-        expect(deps.startDaemon).toHaveBeenCalledWith({
-            cliVersion: '0.2.0',
-            projectDir: '/work/proj',
-            features: ['local-embeddings'],
-            force: true,
-        });
-        expect(io.stdout()).toContain('Started KTX daemon');
-        expect(io.stdout()).toContain('url: http://127.0.0.1:61234');
-        expect(io.stdout()).toContain('pid: 4242');
-        expect(io.stdout()).toContain('features: core, local-embeddings');
-        expect(io.stdout()).toContain('stderr: /work/proj/.ktx/runtime/daemon.stderr.log');
-    });
-    it('stops the KTX daemon', async () => {
-        const io = makeIo();
-        const deps = {
-            stopDaemon: vi.fn(async () => ({
-                status: 'stopped',
-                layout: {
-                    cliVersion: '0.2.0',
-                    runtimeRoot: '/runtime',
-                    versionDir: '/runtime/0.2.0',
-                    venvDir: '/runtime/0.2.0/.venv',
-                    manifestPath: '/runtime/0.2.0/manifest.json',
-                    installLogPath: '/runtime/0.2.0/install.log',
-                    assetDir: '/assets/python',
-                    assetManifestPath: '/assets/python/manifest.json',
-                    pythonPath: '/runtime/0.2.0/.venv/bin/python',
-                    daemonPath: '/runtime/0.2.0/.venv/bin/ktx-daemon',
-                    projectDir: '/work/proj',
-                    daemonStateDir: '/work/proj/.ktx/runtime',
-                    daemonStatePath: '/work/proj/.ktx/runtime/daemon.json',
-                    daemonStdoutPath: '/work/proj/.ktx/runtime/daemon.stdout.log',
-                    daemonStderrPath: '/work/proj/.ktx/runtime/daemon.stderr.log',
-                },
-                state: {
-                    schemaVersion: 1,
-                    pid: 4242,
-                    host: '127.0.0.1',
-                    port: 61234,
-                    version: '0.2.0',
-                    features: ['core'],
-                    startedAt: '2026-05-11T00:00:00.000Z',
-                    stdoutLog: '/work/proj/.ktx/runtime/daemon.stdout.log',
-                    stderrLog: '/work/proj/.ktx/runtime/daemon.stderr.log',
-                },
-            })),
-        };
-        await expect(runKtxRuntime({ command: 'stop', cliVersion: '0.2.0', projectDir: '/work/proj', all: false }, io.io, deps)).resolves.toBe(0);
-        expect(deps.stopDaemon).toHaveBeenCalledWith({ cliVersion: '0.2.0', projectDir: '/work/proj' });
-        expect(io.stdout()).toContain('Stopped KTX daemon');
-        expect(io.stdout()).toContain('pid: 4242');
-    });
-    it('stops all discovered KTX daemons and reports the summary', async () => {
-        const io = makeIo();
-        const deps = {
-            stopAllDaemons: vi.fn(async () => ({
-                stopped: [
-                    { pid: 4242, source: 'state', url: 'http://127.0.0.1:61234', statePaths: ['/work/proj/.ktx/runtime/daemon.json'] },
-                    { pid: 5252, source: 'process', url: 'http://127.0.0.1:8765', statePaths: [] },
-                ],
-                stale: [],
-                failed: [],
-                scanErrors: [],
-            })),
-        };
-        await expect(runKtxRuntime({ command: 'stop', cliVersion: '0.2.0', projectDir: '/work/proj', all: true }, io.io, deps)).resolves.toBe(0);
-        expect(deps.stopAllDaemons).toHaveBeenCalledWith({ cliVersion: '0.2.0', projectDir: '/work/proj' });
-        expect(io.stdout()).toContain('Stopped 2 KTX daemons');
-        expect(io.stdout()).toContain('pid: 4242 source: state url: http://127.0.0.1:61234');
-        expect(io.stdout()).toContain('pid: 5252 source: process url: http://127.0.0.1:8765');
-    });
-    it('returns failure when stop all cannot stop every daemon', async () => {
-        const io = makeIo();
-        const deps = {
-            stopAllDaemons: vi.fn(async () => ({
-                stopped: [],
-                stale: [],
-                failed: [
-                    {
-                        pid: 4242,
-                        source: 'state',
-                        url: 'http://127.0.0.1:61234',
-                        statePaths: ['/work/proj/.ktx/runtime/daemon.json'],
-                        detail: 'Process still running after SIGKILL',
-                    },
-                ],
-                scanErrors: ['ps failed'],
-            })),
-        };
-        await expect(runKtxRuntime({ command: 'stop', cliVersion: '0.2.0', projectDir: '/work/proj', all: true }, io.io, deps)).resolves.toBe(1);
-        expect(io.stderr()).toContain('Stopped 0 KTX daemons; failed 1');
-        expect(io.stderr()).toContain('pid: 4242 source: state url: http://127.0.0.1:61234');
-        expect(io.stderr()).toContain('process scan: ps failed');
-    });
-    it('prints runtime status and doctor checks as JSON with doctor-style exit status', async () => {
-        const io = makeIo();
-        const deps = {
-            readStatus: vi.fn(async () => ({
-                kind: 'missing',
-                detail: 'No runtime manifest at /runtime/0.2.0/manifest.json',
-                layout: {
-                    cliVersion: '0.2.0',
-                    runtimeRoot: '/runtime',
-                    versionDir: '/runtime/0.2.0',
-                    venvDir: '/runtime/0.2.0/.venv',
-                    manifestPath: '/runtime/0.2.0/manifest.json',
-                    installLogPath: '/runtime/0.2.0/install.log',
-                    assetDir: '/assets/python',
-                    assetManifestPath: '/assets/python/manifest.json',
-                    pythonPath: '/runtime/0.2.0/.venv/bin/python',
-                    daemonPath: '/runtime/0.2.0/.venv/bin/ktx-daemon',
-                },
-            })),
-            doctorRuntime: vi.fn(async () => [
-                { id: 'uv', label: 'uv', status: 'pass', detail: 'uv 0.9.5' },
-                { id: 'asset', label: 'Bundled Python wheel', status: 'pass', detail: '/assets/python/runtime.whl' },
-                {
-                    id: 'runtime',
-                    label: 'Managed Python runtime',
-                    status: 'fail',
-                    detail: 'No runtime manifest at /runtime/0.2.0/manifest.json',
-                    fix: 'Run: ktx admin runtime install --yes',
-                },
-            ]),
-        };
-        await expect(runKtxRuntime({ command: 'status', cliVersion: '0.2.0', json: true }, io.io, deps)).resolves.toBe(1);
-        expect(JSON.parse(io.stdout())).toMatchObject({
-            kind: 'missing',
-            detail: 'No runtime manifest at /runtime/0.2.0/manifest.json',
-            layout: { runtimeRoot: '/runtime' },
-            checks: [
-                { id: 'uv', status: 'pass' },
-                { id: 'asset', status: 'pass' },
-                { id: 'runtime', status: 'fail' },
-            ],
-        });
-        expect(deps.readStatus).toHaveBeenCalledWith({ cliVersion: '0.2.0' });
-        expect(deps.doctorRuntime).toHaveBeenCalledWith({ cliVersion: '0.2.0' });
-    });
-    it('prints runtime status and doctor checks in plain output', async () => {
-        const io = makeIo();
-        const deps = {
-            readStatus: vi.fn(async () => ({
-                kind: 'ready',
-                detail: 'Runtime ready at /runtime/0.2.0',
-                layout: {
-                    cliVersion: '0.2.0',
-                    runtimeRoot: '/runtime',
-                    versionDir: '/runtime/0.2.0',
-                    venvDir: '/runtime/0.2.0/.venv',
-                    manifestPath: '/runtime/0.2.0/manifest.json',
-                    installLogPath: '/runtime/0.2.0/install.log',
-                    assetDir: '/assets/python',
-                    assetManifestPath: '/assets/python/manifest.json',
-                    pythonPath: '/runtime/0.2.0/.venv/bin/python',
-                    daemonPath: '/runtime/0.2.0/.venv/bin/ktx-daemon',
-                },
-                manifest: {
-                    schemaVersion: 1,
-                    cliVersion: '0.2.0',
-                    installedAt: '2026-05-11T00:00:00.000Z',
-                    asset: {
-                        schemaVersion: 1,
-                        distributionName: 'kaelio-ktx',
-                        normalizedName: 'kaelio_ktx',
-                        version: '0.1.0',
-                        wheel: {
-                            file: 'kaelio_ktx-0.1.0-py3-none-any.whl',
-                            sha256: 'a'.repeat(64),
-                            bytes: 10,
-                        },
-                    },
-                    features: ['core'],
-                    python: {
-                        executable: '/runtime/0.2.0/.venv/bin/python',
-                        daemonExecutable: '/runtime/0.2.0/.venv/bin/ktx-daemon',
-                    },
-                    installLog: '/runtime/0.2.0/install.log',
-                },
-            })),
-            doctorRuntime: vi.fn(async () => [
-                { id: 'uv', label: 'uv', status: 'pass', detail: 'uv 0.9.5' },
-                { id: 'asset', label: 'Bundled Python wheel', status: 'pass', detail: '/assets/python/runtime.whl' },
-                { id: 'runtime', label: 'Managed Python runtime', status: 'pass', detail: 'Runtime ready at /runtime/0.2.0' },
-            ]),
-        };
-        await expect(runKtxRuntime({ command: 'status', cliVersion: '0.2.0', json: false }, io.io, deps)).resolves.toBe(0);
-        expect(io.stdout()).toContain('KTX Python runtime');
-        expect(io.stdout()).toContain('status: ready');
-        expect(io.stdout()).toContain('KTX Python runtime checks');
-        expect(io.stdout()).toContain('PASS uv: uv 0.9.5');
-        expect(io.stdout()).toContain('PASS Managed Python runtime: Runtime ready at /runtime/0.2.0');
-        expect(io.stderr()).toBe('');
-    });
-    it('returns success when the installed runtime is ready but source assets are missing', async () => {
-        const io = makeIo();
-        const deps = {
-            readStatus: vi.fn(async () => ({
-                kind: 'ready',
-                detail: 'Runtime ready at /runtime/0.2.0',
-                layout: {
-                    cliVersion: '0.2.0',
-                    runtimeRoot: '/runtime',
-                    versionDir: '/runtime/0.2.0',
-                    venvDir: '/runtime/0.2.0/.venv',
-                    manifestPath: '/runtime/0.2.0/manifest.json',
-                    installLogPath: '/runtime/0.2.0/install.log',
-                    assetDir: '/assets/python',
-                    assetManifestPath: '/assets/python/manifest.json',
-                    pythonPath: '/runtime/0.2.0/.venv/bin/python',
-                    daemonPath: '/runtime/0.2.0/.venv/bin/ktx-daemon',
-                },
-                manifest: {
-                    schemaVersion: 1,
-                    cliVersion: '0.2.0',
-                    installedAt: '2026-05-11T00:00:00.000Z',
-                    asset: {
-                        schemaVersion: 1,
-                        distributionName: 'kaelio-ktx',
-                        normalizedName: 'kaelio_ktx',
-                        version: '0.1.0',
-                        wheel: {
-                            file: 'kaelio_ktx-0.1.0-py3-none-any.whl',
-                            sha256: 'a'.repeat(64),
-                            bytes: 10,
-                        },
-                    },
-                    features: ['core'],
-                    python: {
-                        executable: '/runtime/0.2.0/.venv/bin/python',
-                        daemonExecutable: '/runtime/0.2.0/.venv/bin/ktx-daemon',
-                    },
-                    installLog: '/runtime/0.2.0/install.log',
-                },
-            })),
-            doctorRuntime: vi.fn(async () => [
-                { id: 'uv', label: 'uv', status: 'pass', detail: 'uv 0.9.5' },
-                {
-                    id: 'asset',
-                    label: 'Bundled Python wheel',
-                    status: 'fail',
-                    detail: 'Missing bundled Python runtime manifest: /assets/python/manifest.json',
-                    fix: 'Run: pnpm run artifacts:check',
-                },
-                { id: 'runtime', label: 'Managed Python runtime', status: 'pass', detail: 'Runtime ready at /runtime/0.2.0' },
-            ]),
-        };
-        await expect(runKtxRuntime({ command: 'status', cliVersion: '0.2.0', json: false }, io.io, deps)).resolves.toBe(0);
-        expect(io.stdout()).toContain('status: ready');
-        expect(io.stdout()).toContain('FAIL Bundled Python wheel: Missing bundled Python runtime manifest');
-        expect(io.stdout()).toContain('PASS Managed Python runtime: Runtime ready at /runtime/0.2.0');
-        expect(io.stderr()).toBe('');
-    });
-});

package/dist/scan.test.d.ts

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