@kaelio/ktx 0.2.0 → 0.3.0

package/assets/python/manifest.json

@@ -2,10 +2,10 @@
   "schemaVersion": 1,
   "distributionName": "kaelio-ktx",
   "normalizedName": "kaelio_ktx",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "wheel": {
-    "file": "kaelio_ktx-0.2.0-py3-none-any.whl",
-    "sha256": "5ede628d4d72b2a7eb515fb538473be5a5d82eb430ae98daca8ac90596a7a6e3",
-    "bytes": 80524
+    "file": "kaelio_ktx-0.3.0-py3-none-any.whl",
+    "sha256": "83a67a550f0a52fa09d5792583996b7d9fe1632e5614d487763bd246d945fc8a",
+    "bytes": 80521
   }
 }

package/dist/admin-reindex.js

@@ -1,11 +1,10 @@
-import { createLocalKtxEmbeddingProviderFromConfig, KtxIngestEmbeddingPortAdapter, MANAGED_SENTENCE_TRANSFORMERS_BASE_URL, } from '@ktx/context';
+import { createLocalKtxEmbeddingProviderFromConfig, KtxIngestEmbeddingPortAdapter, } from '@ktx/context';
 import { reindexLocalIndexes } from '@ktx/context/index-sync';
-import { loadKtxProject } from '@ktx/context/project';
 import { Option } from '@commander-js/extra-typings';
 import { cancel, intro, log, note, outro } from '@clack/prompts';
+import { loadKtxCliProject } from './cli-project.js';
 import { resolveOutputMode } from './io/mode.js';
 import { green, red, SYMBOLS } from './io/symbols.js';
-import { ensureManagedLocalEmbeddingsDaemon } from './managed-local-embeddings.js';
 export function registerAdminReindexCommand(admin, context) {
     admin
         .command('reindex')
@@ -25,22 +24,11 @@ export function registerAdminReindexCommand(admin, context) {
         }, context.io));
     });
 }
-async function resolveReindexEmbeddingService(project, args, io) {
+function resolveReindexEmbeddingService(project) {
     const config = project.config.ingest.embeddings;
     if (config.backend === 'none') {
         return null;
     }
-    if (config.backend === 'sentence-transformers' &&
-        config.sentenceTransformers?.base_url === MANAGED_SENTENCE_TRANSFORMERS_BASE_URL) {
-        const daemon = await ensureManagedLocalEmbeddingsDaemon({
-            cliVersion: args.cliVersion,
-            projectDir: project.projectDir,
-            installPolicy: 'never',
-            io,
-        });
-        const provider = createLocalKtxEmbeddingProviderFromConfig(config, { env: { ...process.env, ...daemon.env } });
-        return provider ? new KtxIngestEmbeddingPortAdapter(provider) : null;
-    }
     const provider = createLocalKtxEmbeddingProviderFromConfig(config);
     return provider ? new KtxIngestEmbeddingPortAdapter(provider) : null;
 }
@@ -143,8 +131,13 @@ function renderReindexPretty(summary, io) {
 }
 async function runKtxAdminReindex(args, io = process) {
     try {
-        const project = await loadKtxProject({ projectDir: args.projectDir });
-        const embeddingService = await resolveReindexEmbeddingService(project, args, io);
+        const project = await loadKtxCliProject({
+            projectDir: args.projectDir,
+            cliVersion: args.cliVersion,
+            installPolicy: 'never',
+            io,
+        });
+        const embeddingService = resolveReindexEmbeddingService(project);
         const summary = await reindexLocalIndexes(project, { force: args.force, embeddingService });
         const mode = resolveOutputMode({ explicit: args.output, json: args.json, io });
         if (!summary.embeddingsAvailable && mode === 'plain') {

package/dist/admin-reindex.test.js

@@ -110,7 +110,7 @@ describe('admin reindex Commander routing', () => {
             force: true,
             json: true,
             output: 'plain',
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
         }, io.io);
     });
 });

package/dist/cli-program.test.js

@@ -10,8 +10,6 @@ function stubPackageInfo() {
     return {
         name: '@ktx/cli',
         version: '0.0.0-test',
-        packageVersion: '0.0.0-private',
-        runtimeVersion: '0.0.0-test',
         contextPackageName: '@ktx/context',
     };
 }

package/dist/cli-project.d.ts

@@ -0,0 +1,18 @@
+import { loadKtxProject, type KtxLocalProject } from '@ktx/context/project';
+import type { KtxProjectConfig } from '@ktx/context/project';
+import type { KtxCliIo } from './cli-runtime.js';
+import { ensureManagedLocalEmbeddingsDaemon, type ManagedLocalEmbeddingsDaemon } from './managed-local-embeddings.js';
+import type { KtxManagedPythonInstallPolicy } from './managed-python-command.js';
+export interface LoadKtxCliProjectOptions {
+    projectDir: string;
+    cliVersion: string;
+    installPolicy: KtxManagedPythonInstallPolicy;
+    io: KtxCliIo;
+}
+export interface LoadKtxCliProjectDeps {
+    loadProject?: typeof loadKtxProject;
+    ensureLocalEmbeddings?: (options: Parameters<typeof ensureManagedLocalEmbeddingsDaemon>[0]) => Promise<ManagedLocalEmbeddingsDaemon>;
+}
+export declare function loadKtxCliProject(options: LoadKtxCliProjectOptions, deps?: LoadKtxCliProjectDeps): Promise<KtxLocalProject>;
+export declare function projectNeedsManagedLocalEmbeddings(config: KtxProjectConfig): boolean;
+export declare function substituteManagedLocalEmbeddingsUrl(config: KtxProjectConfig, baseUrl: string): KtxProjectConfig;

package/dist/cli-project.js

@@ -0,0 +1,52 @@
+import { MANAGED_SENTENCE_TRANSFORMERS_BASE_URL } from '@ktx/context';
+import { loadKtxProject } from '@ktx/context/project';
+import { ensureManagedLocalEmbeddingsDaemon, } from './managed-local-embeddings.js';
+export async function loadKtxCliProject(options, deps = {}) {
+    const loadProject = deps.loadProject ?? loadKtxProject;
+    const ensureLocalEmbeddings = deps.ensureLocalEmbeddings ?? ensureManagedLocalEmbeddingsDaemon;
+    const project = await loadProject({ projectDir: options.projectDir });
+    if (!projectNeedsManagedLocalEmbeddings(project.config)) {
+        return project;
+    }
+    const daemon = await ensureLocalEmbeddings({
+        cliVersion: options.cliVersion,
+        projectDir: options.projectDir,
+        installPolicy: options.installPolicy,
+        io: options.io,
+    });
+    return {
+        ...project,
+        config: substituteManagedLocalEmbeddingsUrl(project.config, daemon.baseUrl),
+    };
+}
+export function projectNeedsManagedLocalEmbeddings(config) {
+    return (embeddingUsesManagedSentinel(config.ingest.embeddings) ||
+        embeddingUsesManagedSentinel(config.scan.enrichment.embeddings));
+}
+export function substituteManagedLocalEmbeddingsUrl(config, baseUrl) {
+    const ingestEmbeddings = rewriteManagedEmbeddingConfig(config.ingest.embeddings, baseUrl);
+    const scanEnrichmentEmbeddings = rewriteManagedEmbeddingConfig(config.scan.enrichment.embeddings, baseUrl);
+    return {
+        ...config,
+        ingest: { ...config.ingest, embeddings: ingestEmbeddings },
+        scan: {
+            ...config.scan,
+            enrichment: { ...config.scan.enrichment, embeddings: scanEnrichmentEmbeddings },
+        },
+    };
+}
+function embeddingUsesManagedSentinel(embedding) {
+    return embedding?.sentenceTransformers?.base_url === MANAGED_SENTENCE_TRANSFORMERS_BASE_URL;
+}
+function rewriteManagedEmbeddingConfig(embedding, baseUrl) {
+    if (!embedding || !embeddingUsesManagedSentinel(embedding)) {
+        return embedding;
+    }
+    return {
+        ...embedding,
+        sentenceTransformers: {
+            ...embedding.sentenceTransformers,
+            base_url: baseUrl,
+        },
+    };
+}

package/dist/cli-project.test.js

@@ -0,0 +1,149 @@
+import { describe, expect, it, vi } from 'vitest';
+import { MANAGED_SENTENCE_TRANSFORMERS_BASE_URL } from '@ktx/context';
+import { buildDefaultKtxProjectConfig } from '@ktx/context/project';
+import { loadKtxCliProject, projectNeedsManagedLocalEmbeddings, substituteManagedLocalEmbeddingsUrl, } from './cli-project.js';
+const RESOLVED_BASE_URL = 'http://127.0.0.1:51234';
+function makeIo() {
+    let stderr = '';
+    return {
+        io: {
+            stdout: { write: (_chunk) => { } },
+            stderr: {
+                write: (chunk) => {
+                    stderr += chunk;
+                },
+            },
+        },
+        stderr: () => stderr,
+    };
+}
+function projectWithConfig(config) {
+    return {
+        projectDir: '/work/proj',
+        configPath: '/work/proj/ktx.yaml',
+        config,
+        coreConfig: {},
+        git: {},
+        fileStore: {},
+    };
+}
+function withManagedIngestEmbedding(config) {
+    return {
+        ...config,
+        ingest: {
+            ...config.ingest,
+            embeddings: {
+                backend: 'sentence-transformers',
+                model: 'all-MiniLM-L6-v2',
+                dimensions: 384,
+                sentenceTransformers: { base_url: MANAGED_SENTENCE_TRANSFORMERS_BASE_URL, pathPrefix: '' },
+            },
+        },
+    };
+}
+function withManagedScanEnrichmentEmbedding(config) {
+    return {
+        ...config,
+        scan: {
+            ...config.scan,
+            enrichment: {
+                ...config.scan.enrichment,
+                embeddings: {
+                    backend: 'sentence-transformers',
+                    model: 'all-MiniLM-L6-v2',
+                    dimensions: 384,
+                    sentenceTransformers: { base_url: MANAGED_SENTENCE_TRANSFORMERS_BASE_URL, pathPrefix: '' },
+                },
+            },
+        },
+    };
+}
+const fakeDaemon = {
+    baseUrl: RESOLVED_BASE_URL,
+    stdoutLog: '/work/proj/.ktx/runtime/daemon.stdout.log',
+    stderrLog: '/work/proj/.ktx/runtime/daemon.stderr.log',
+};
+describe('projectNeedsManagedLocalEmbeddings', () => {
+    it('returns false when neither ingest nor scan embeddings reference the managed sentinel', () => {
+        expect(projectNeedsManagedLocalEmbeddings(buildDefaultKtxProjectConfig())).toBe(false);
+    });
+    it('returns true when ingest.embeddings uses the managed sentinel', () => {
+        expect(projectNeedsManagedLocalEmbeddings(withManagedIngestEmbedding(buildDefaultKtxProjectConfig()))).toBe(true);
+    });
+    it('returns true when scan.enrichment.embeddings uses the managed sentinel', () => {
+        expect(projectNeedsManagedLocalEmbeddings(withManagedScanEnrichmentEmbedding(buildDefaultKtxProjectConfig()))).toBe(true);
+    });
+});
+describe('substituteManagedLocalEmbeddingsUrl', () => {
+    it('rewrites the managed sentinel in both ingest.embeddings and scan.enrichment.embeddings', () => {
+        const config = withManagedScanEnrichmentEmbedding(withManagedIngestEmbedding(buildDefaultKtxProjectConfig()));
+        const resolved = substituteManagedLocalEmbeddingsUrl(config, RESOLVED_BASE_URL);
+        expect(resolved.ingest.embeddings.sentenceTransformers?.base_url).toBe(RESOLVED_BASE_URL);
+        expect(resolved.scan.enrichment.embeddings?.sentenceTransformers?.base_url).toBe(RESOLVED_BASE_URL);
+    });
+    it('returns the input unchanged when no sentinel is present', () => {
+        const config = buildDefaultKtxProjectConfig();
+        const resolved = substituteManagedLocalEmbeddingsUrl(config, RESOLVED_BASE_URL);
+        expect(resolved.ingest.embeddings).toEqual(config.ingest.embeddings);
+        expect(resolved.scan.enrichment.embeddings).toEqual(config.scan.enrichment.embeddings);
+    });
+    it('does not touch non-sentinel sentence-transformers URLs', () => {
+        const config = {
+            ...buildDefaultKtxProjectConfig(),
+            ingest: {
+                ...buildDefaultKtxProjectConfig().ingest,
+                embeddings: {
+                    backend: 'sentence-transformers',
+                    model: 'all-MiniLM-L6-v2',
+                    dimensions: 384,
+                    sentenceTransformers: { base_url: 'http://localhost:9999', pathPrefix: '' },
+                },
+            },
+        };
+        const resolved = substituteManagedLocalEmbeddingsUrl(config, RESOLVED_BASE_URL);
+        expect(resolved.ingest.embeddings.sentenceTransformers?.base_url).toBe('http://localhost:9999');
+    });
+});
+describe('loadKtxCliProject', () => {
+    it('returns the project unchanged and does not start the daemon when no sentinel is present', async () => {
+        const io = makeIo();
+        const project = projectWithConfig(buildDefaultKtxProjectConfig());
+        const loadProject = vi.fn(async () => project);
+        const ensureLocalEmbeddings = vi.fn(async () => fakeDaemon);
+        const result = await loadKtxCliProject({ projectDir: '/work/proj', cliVersion: '0.2.0', installPolicy: 'never', io: io.io }, { loadProject, ensureLocalEmbeddings });
+        expect(result).toBe(project);
+        expect(ensureLocalEmbeddings).not.toHaveBeenCalled();
+    });
+    it('starts the daemon and substitutes the resolved URL when ingest.embeddings uses the sentinel', async () => {
+        const io = makeIo();
+        const project = projectWithConfig(withManagedIngestEmbedding(buildDefaultKtxProjectConfig()));
+        const loadProject = vi.fn(async () => project);
+        const ensureLocalEmbeddings = vi.fn(async () => fakeDaemon);
+        const result = await loadKtxCliProject({ projectDir: '/work/proj', cliVersion: '0.2.0', installPolicy: 'never', io: io.io }, { loadProject, ensureLocalEmbeddings });
+        expect(ensureLocalEmbeddings).toHaveBeenCalledWith({
+            cliVersion: '0.2.0',
+            projectDir: '/work/proj',
+            installPolicy: 'never',
+            io: io.io,
+        });
+        expect(result.config.ingest.embeddings.sentenceTransformers?.base_url).toBe(RESOLVED_BASE_URL);
+    });
+    it('does not mutate process.env', async () => {
+        const io = makeIo();
+        const before = process.env.KTX_MANAGED_SENTENCE_TRANSFORMERS_BASE_URL;
+        delete process.env.KTX_MANAGED_SENTENCE_TRANSFORMERS_BASE_URL;
+        try {
+            const project = projectWithConfig(withManagedIngestEmbedding(buildDefaultKtxProjectConfig()));
+            await loadKtxCliProject({ projectDir: '/work/proj', cliVersion: '0.2.0', installPolicy: 'never', io: io.io }, { loadProject: vi.fn(async () => project), ensureLocalEmbeddings: vi.fn(async () => fakeDaemon) });
+            expect(process.env.KTX_MANAGED_SENTENCE_TRANSFORMERS_BASE_URL).toBeUndefined();
+        }
+        finally {
+            if (before === undefined) {
+                delete process.env.KTX_MANAGED_SENTENCE_TRANSFORMERS_BASE_URL;
+            }
+            else {
+                process.env.KTX_MANAGED_SENTENCE_TRANSFORMERS_BASE_URL = before;
+            }
+        }
+    });
+});

package/dist/cli-runtime.d.ts

@@ -11,8 +11,6 @@ import type { KtxTextIngestArgs } from './text-ingest.js';
 export interface KtxCliPackageInfo {
     name: string;
     version: string;
-    packageVersion: string;
-    runtimeVersion: string;
     contextPackageName: '@ktx/context';
 }
 export interface KtxCliIo {

package/dist/cli-runtime.js

@@ -1,6 +1,6 @@
 import { createRequire } from 'node:module';
 import { profileMark, profileSpan } from './startup-profile.js';
-import { resolveKtxRuntimeVersion } from './release-version.js';
+import { assertCliVersion } from './release-version.js';
 profileMark('module:cli-runtime');
 const requirePackageJson = createRequire(import.meta.url);
 export function getKtxCliPackageInfo() {
@@ -15,15 +15,9 @@ export function packageInfoFromJson(packageJson) {
         typeof packageJson.version !== 'string') {
         throw new Error('Invalid KTX CLI package metadata');
     }
-    const runtimeVersion = resolveKtxRuntimeVersion({
-        packageName: packageJson.name,
-        packageVersion: packageJson.version,
-    });
     return {
         name: packageJson.name,
-        version: runtimeVersion,
-        packageVersion: packageJson.version,
-        runtimeVersion,
+        version: assertCliVersion(packageJson.version, `${packageJson.name}/package.json`),
         contextPackageName: '@ktx/context',
     };
 }

package/dist/commands/runtime-commands.js

@@ -30,7 +30,7 @@ export function registerRuntimeCommands(program, context) {
     });
     runtime
         .command('start')
-        .description('Start the KTX-managed Python HTTP daemon')
+        .description('Start the KTX daemon')
         .addOption(createRuntimeFeatureOption())
         .option('--force', 'Restart even when a matching daemon is already running', false)
         .action(async (options, command) => {
@@ -44,7 +44,7 @@ export function registerRuntimeCommands(program, context) {
     });
     runtime
         .command('stop')
-        .description('Stop the KTX-managed Python HTTP daemon')
+        .description('Stop the KTX daemon')
         .option('--all', 'Stop all KTX daemon processes recorded or discoverable on this machine', false)
         .action(async (options, command) => {
         await runRuntimeArgs(context, {

package/dist/context-build-view.js

@@ -532,7 +532,7 @@ function failedStepDetail(result) {
     return result.steps.find((step) => step.status === 'failed')?.detail ?? null;
 }
 const INTERNAL_FAILURE_LINE_RE = /^(Report|Run|Job|Status|Adapter|Connection|Sync|Mode|Dry run|Diff|Tasks|Work units|Failed tasks|Saved memory|Provenance rows):\s*/;
-const ACTIONABLE_FAILURE_LINE_RE = /^(Missing bundled Python runtime manifest|KTX Python runtime is required|KTX managed daemon|Error:|Failed\b|Could not\b|Cannot\b)/;
+const ACTIONABLE_FAILURE_LINE_RE = /^(Missing bundled Python runtime manifest|KTX Python runtime is required|KTX daemon HTTP|Error:|Failed\b|Could not\b|Cannot\b)/;
 function trimErrorPrefix(line) {
     return line.replace(/^Error:\s*/, '');
 }

package/dist/index.test.js

@@ -31,9 +31,7 @@ describe('getKtxCliPackageInfo', () => {
     it('identifies the CLI package and its context dependency', () => {
         expect(getKtxCliPackageInfo()).toEqual({
             name: '@ktx/cli',
-            version: '0.1.0-rc.1',
-            packageVersion: '0.0.0-private',
-            runtimeVersion: '0.1.0-rc.1',
+            version: '0.0.0-private',
             contextPackageName: '@ktx/context',
         });
     });
@@ -51,8 +49,6 @@ describe('getKtxCliPackageInfo', () => {
         })).toEqual({
             name: '@kaelio/ktx',
             version: '0.1.0',
-            packageVersion: '0.1.0',
-            runtimeVersion: '0.1.0',
             contextPackageName: '@ktx/context',
         });
     });
@@ -90,7 +86,7 @@ describe('runKtxCli', () => {
     it('prints version information', async () => {
         const testIo = makeIo();
         await expect(runKtxCli(['--version'], testIo.io)).resolves.toBe(0);
-        expect(testIo.stdout()).toBe('@ktx/cli 0.1.0-rc.1\n');
+        expect(testIo.stdout()).toBe('@ktx/cli 0.0.0-private\n');
         expect(testIo.stderr()).toBe('');
     });
     it('prints the public command surface in root help', async () => {
@@ -192,7 +188,7 @@ describe('runKtxCli', () => {
         await expect(runKtxCli(['--project-dir', tempDir, 'sl', '--query', 'revenue'], unknownIo.io, { sl })).resolves.toBe(1);
         expect(unknownIo.stderr()).toContain("unknown option '--query'");
     });
-    it('routes runtime management commands with the release runtime version', async () => {
+    it('routes runtime management commands with the CLI package version', async () => {
         const runtime = vi.fn(async () => 0);
         const installIo = makeIo();
         const startIo = makeIo();
@@ -210,32 +206,32 @@ describe('runKtxCli', () => {
         await expect(runKtxCli(['admin', 'runtime', 'prune', '--dry-run'], pruneIo.io, { runtime })).resolves.toBe(1);
         expect(runtime).toHaveBeenNthCalledWith(1, {
             command: 'install',
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             feature: 'local-embeddings',
             force: true,
         }, installIo.io);
         expect(runtime).toHaveBeenNthCalledWith(2, {
             command: 'start',
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             projectDir: expect.any(String),
             feature: 'local-embeddings',
             force: true,
         }, startIo.io);
         expect(runtime).toHaveBeenNthCalledWith(3, {
             command: 'stop',
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             projectDir: expect.any(String),
             all: false,
         }, stopIo.io);
         expect(runtime).toHaveBeenNthCalledWith(4, {
             command: 'stop',
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             projectDir: expect.any(String),
             all: true,
         }, stopAllIo.io);
         expect(runtime).toHaveBeenNthCalledWith(5, {
             command: 'status',
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             json: true,
         }, statusIo.io);
         expect(runtime).toHaveBeenCalledTimes(5);
@@ -282,7 +278,7 @@ describe('runKtxCli', () => {
         expect(sl).toHaveBeenLastCalledWith(expect.objectContaining({
             command: 'query',
             projectDir: tempDir,
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             runtimeInstallPolicy: 'prompt',
             query: expect.objectContaining({ measures: ['orders.order_count'], dimensions: [] }),
         }), promptIo.io);
@@ -291,13 +287,13 @@ describe('runKtxCli', () => {
             sl,
         })).resolves.toBe(0);
         expect(sl).toHaveBeenLastCalledWith(expect.objectContaining({
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             runtimeInstallPolicy: 'auto',
         }), autoIo.io);
         const noInputIo = makeIo();
         await expect(runKtxCli(['--project-dir', tempDir, 'sl', 'query', '--measure', 'orders.order_count', '--no-input'], noInputIo.io, { sl })).resolves.toBe(0);
         expect(sl).toHaveBeenLastCalledWith(expect.objectContaining({
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             runtimeInstallPolicy: 'never',
         }), noInputIo.io);
     });
@@ -407,7 +403,7 @@ describe('runKtxCli', () => {
                 skipAgents: false,
                 inputMode: 'auto',
                 yes: false,
-                cliVersion: '0.1.0-rc.1',
+                cliVersion: '0.0.0-private',
                 skipLlm: false,
                 skipEmbeddings: false,
                 databaseSchemas: [],
@@ -516,7 +512,7 @@ describe('runKtxCli', () => {
             inputMode: 'disabled',
             depth: 'fast',
             queryHistory: 'default',
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             runtimeInstallPolicy: 'never',
         }, testIo.io);
         expect(testIo.stderr()).toBe(`Project: ${tempDir}\n`);
@@ -535,7 +531,7 @@ describe('runKtxCli', () => {
             inputMode: 'auto',
             depth: 'deep',
             queryHistory: 'default',
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             runtimeInstallPolicy: 'prompt',
         }, testIo.io);
         expect(testIo.stderr()).toBe('');
@@ -584,7 +580,7 @@ describe('runKtxCli', () => {
             json: false,
             inputMode: 'disabled',
             queryHistory: 'default',
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             runtimeInstallPolicy: 'never',
         }, testIo.io);
     });
@@ -802,7 +798,7 @@ describe('runKtxCli', () => {
             command: 'run',
             projectDir: tempDir,
             inputMode: 'disabled',
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             anthropicApiKeyEnv: 'ANTHROPIC_API_KEY', // pragma: allowlist secret
             llmModel: 'claude-sonnet-4-6',
             skipLlm: false,
@@ -829,7 +825,7 @@ describe('runKtxCli', () => {
             command: 'run',
             projectDir: tempDir,
             inputMode: 'disabled',
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             llmBackend: 'vertex',
             vertexProject: 'local-gcp-project',
             vertexLocation: 'us-east5',
@@ -854,7 +850,7 @@ describe('runKtxCli', () => {
             command: 'run',
             projectDir: tempDir,
             inputMode: 'disabled',
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             llmBackend: 'claude-code',
             llmModel: 'opus',
             skipLlm: false,
@@ -929,7 +925,7 @@ describe('runKtxCli', () => {
             projectDir: '/tmp/project',
             inputMode: 'disabled',
             yes: true,
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             skipLlm: true,
             skipEmbeddings: true,
             databaseDrivers: ['postgres'],
@@ -1147,7 +1143,7 @@ describe('runKtxCli', () => {
             queryFile: '/tmp/query.json',
             execute: false,
             format: 'json',
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             runtimeInstallPolicy: 'auto',
         }, autoIo.io);
         expect(sl).toHaveBeenNthCalledWith(2, {
@@ -1157,7 +1153,7 @@ describe('runKtxCli', () => {
             queryFile: '/tmp/query.json',
             execute: false,
             format: 'json',
-            cliVersion: '0.1.0-rc.1',
+            cliVersion: '0.0.0-private',
             runtimeInstallPolicy: 'never',
         }, neverIo.io);
         expect(conflictIo.stderr()).toContain('Choose only one runtime install mode: --yes or --no-input');

package/dist/ingest.js

@@ -1,5 +1,5 @@
 import { buildMemoryFlowViewModel, createMemoryFlowLiveBuffer, formatMemoryFlowFinalSummary, getLatestLocalIngestStatus, getLocalIngestStatus, ingestReportToMemoryFlowReplay, renderMemoryFlowReplay, runLocalIngest, runLocalMetabaseIngest, savedMemoryCountsForReport, sanitizeMemoryFlowError, } from '@ktx/context/ingest';
-import { loadKtxProject } from '@ktx/context/project';
+import { loadKtxCliProject } from './cli-project.js';
 import { createKtxCliIngestQueryExecutor } from './ingest-query-executor.js';
 import { readIngestReportSnapshotFile } from './ingest-report-file.js';
 import { createCliOperationalLogger } from './io/logger.js';
@@ -470,7 +470,14 @@ async function writeReportRecord(report, outputMode, io, options = {}) {
 }
 export async function runKtxIngest(args, io = process, deps = {}) {
     try {
-        const project = await loadKtxProject({ projectDir: args.projectDir });
+        const cliVersion = args.command === 'run' ? args.cliVersion : undefined;
+        const runtimeInstallPolicy = args.command === 'run' ? args.runtimeInstallPolicy : undefined;
+        const project = await loadKtxCliProject({
+            projectDir: args.projectDir,
+            cliVersion: cliVersion ?? '0.0.0-private',
+            installPolicy: runtimeInstallPolicy ?? 'never',
+            io,
+        });
         const env = deps.env ?? process.env;
         if (args.command === 'run') {
             const ingestProject = args.allowImplicitAdapter && !project.config.ingest.adapters.includes(args.adapter)

package/dist/ingest.test.js

@@ -807,9 +807,16 @@ describe('runKtxIngest', () => {
                     sourceKey: 'historic-sql',
                     body: {
                         workUnits: [],
-                        postProcessor: {
+                        finalization: {
                             sourceKey: 'historic-sql',
                             status: 'success',
+                            commitSha: 'finalization-sha',
+                            touchedPaths: ['semantic-layer/warehouse/_schema/public.yaml', 'wiki/global/historic-sql-orders.md'],
+                            declaredTouchedSources: [{ connectionId: 'warehouse', sourceName: 'orders' }],
+                            derivedTouchedSources: [{ connectionId: 'warehouse', sourceName: 'orders' }],
+                            declaredChangedWikiPageKeys: ['historic-sql-orders'],
+                            derivedChangedWikiPageKeys: ['historic-sql-orders'],
+                            mismatches: [],
                             result: {
                                 tableUsageMerged: 56,
                                 staleTablesMarked: 1,
@@ -819,7 +826,24 @@ describe('runKtxIngest', () => {
                             },
                             errors: [],
                             warnings: [],
-                            touchedSources: [],
+                            actions: [
+                                ...Array.from({ length: 57 }, (_, index) => ({
+                                    target: 'sl',
+                                    type: 'updated',
+                                    key: `orders-${index}`,
+                                    detail: 'Merged usage',
+                                    targetConnectionId: 'warehouse',
+                                    rawPaths: ['tables/public/orders.json'],
+                                })),
+                                ...Array.from({ length: 35 }, (_, index) => ({
+                                    target: 'wiki',
+                                    type: 'updated',
+                                    key: `historic-sql-orders-${index}`,
+                                    detail: 'Projected pattern',
+                                    rawPaths: ['patterns/orders.json'],
+                                })),
+                            ],
+                            provenanceExclusions: [],
                         },
                     },
                 }),
@@ -1048,7 +1072,7 @@ describe('runKtxIngest', () => {
             }),
         }));
     });
-    it('passes managed daemon options to adapters and pull-config options when no explicit daemon URL is set', async () => {
+    it('passes KTX daemon options to adapters and pull-config options when no explicit daemon URL is set', async () => {
         const projectDir = join(tempDir, 'managed-daemon-ingest-project');
         await initKtxProject({ projectDir });
         await writeWarehouseConfig(projectDir);

package/dist/managed-local-embeddings.d.ts

@@ -1,4 +1,3 @@
-import { MANAGED_SENTENCE_TRANSFORMERS_BASE_URL_ENV } from '@ktx/context';
 import type { KtxProjectEmbeddingConfig } from '@ktx/context/project';
 import type { KtxEmbeddingConfig } from '@ktx/llm';
 import type { KtxCliIo } from './cli-runtime.js';
@@ -8,7 +7,6 @@ export interface ManagedLocalEmbeddingsDaemon {
     baseUrl: string;
     stdoutLog: string;
     stderrLog: string;
-    env: Record<typeof MANAGED_SENTENCE_TRANSFORMERS_BASE_URL_ENV, string>;
 }
 export interface ManagedLocalEmbeddingsOptions {
     cliVersion: string;