@kaelio/ktx 0.2.0 → 0.4.0

package/dist/managed-local-embeddings.js

@@ -1,4 +1,4 @@
-import { MANAGED_SENTENCE_TRANSFORMERS_BASE_URL, MANAGED_SENTENCE_TRANSFORMERS_BASE_URL_ENV, } from '@ktx/context';
+import { MANAGED_SENTENCE_TRANSFORMERS_BASE_URL } from '@ktx/context';
 import { ensureManagedPythonCommandRuntime, } from './managed-python-command.js';
 import { startManagedPythonDaemon } from './managed-python-daemon.js';
 export function managedLocalEmbeddingProjectConfig(input) {
@@ -39,13 +39,10 @@ export async function ensureManagedLocalEmbeddingsDaemon(options) {
         force: false,
     });
     const verb = daemon.status === 'started' ? 'Started' : 'Using';
-    options.io.stderr.write(`${verb} KTX local embeddings daemon: ${daemon.baseUrl}\n`);
+    options.io.stderr.write(`${verb} KTX daemon: ${daemon.baseUrl}\n`);
     return {
         baseUrl: daemon.baseUrl,
         stdoutLog: daemon.state.stdoutLog,
         stderrLog: daemon.state.stderrLog,
-        env: {
-            [MANAGED_SENTENCE_TRANSFORMERS_BASE_URL_ENV]: daemon.baseUrl,
-        },
     };
 }

package/dist/managed-local-embeddings.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it, vi } from 'vitest';
-import { MANAGED_SENTENCE_TRANSFORMERS_BASE_URL, MANAGED_SENTENCE_TRANSFORMERS_BASE_URL_ENV, } from '@ktx/context';
+import { MANAGED_SENTENCE_TRANSFORMERS_BASE_URL } from '@ktx/context';
 import { ensureManagedLocalEmbeddingsDaemon, managedLocalEmbeddingHealthConfig, managedLocalEmbeddingProjectConfig, } from './managed-local-embeddings.js';
 function makeIo() {
     let stdout = '';
@@ -101,7 +101,7 @@ describe('managedLocalEmbeddingProjectConfig', () => {
     });
 });
 describe('managedLocalEmbeddingHealthConfig', () => {
-    it('uses the active managed daemon URL for the immediate health check', () => {
+    it('uses the active KTX daemon URL for the immediate health check', () => {
         expect(managedLocalEmbeddingHealthConfig({
             baseUrl: 'http://127.0.0.1:61234',
             model: 'all-MiniLM-L6-v2',
@@ -115,7 +115,7 @@ describe('managedLocalEmbeddingHealthConfig', () => {
     });
 });
 describe('ensureManagedLocalEmbeddingsDaemon', () => {
-    it('ensures the local-embeddings feature and starts the managed daemon', async () => {
+    it('ensures the local-embeddings feature and starts the KTX daemon', async () => {
         const io = makeIo();
         const ensureRuntime = vi.fn(async () => runtime());
         const startDaemon = vi.fn(async () => daemonResult('started'));
@@ -130,9 +130,6 @@ describe('ensureManagedLocalEmbeddingsDaemon', () => {
             baseUrl: 'http://127.0.0.1:61234',
             stdoutLog: '/work/proj/.ktx/runtime/daemon.stdout.log',
             stderrLog: '/work/proj/.ktx/runtime/daemon.stderr.log',
-            env: {
-                [MANAGED_SENTENCE_TRANSFORMERS_BASE_URL_ENV]: 'http://127.0.0.1:61234',
-            },
         });
         expect(ensureRuntime).toHaveBeenCalledWith({
             cliVersion: '0.2.0',
@@ -146,7 +143,7 @@ describe('ensureManagedLocalEmbeddingsDaemon', () => {
             features: ['local-embeddings'],
             force: false,
         });
-        expect(io.stderr()).toContain('Started KTX local embeddings daemon: http://127.0.0.1:61234');
+        expect(io.stderr()).toContain('Started KTX daemon: http://127.0.0.1:61234');
     });
     it('reuses an already running daemon without reporting a new start', async () => {
         const io = makeIo();
@@ -158,6 +155,6 @@ describe('ensureManagedLocalEmbeddingsDaemon', () => {
             ensureRuntime: vi.fn(async () => runtime()),
             startDaemon: vi.fn(async () => daemonResult('reused')),
         });
-        expect(io.stderr()).toContain('Using KTX local embeddings daemon: http://127.0.0.1:61234');
+        expect(io.stderr()).toContain('Using KTX daemon: http://127.0.0.1:61234');
     });
 });

package/dist/managed-python-daemon.js

@@ -173,7 +173,7 @@ async function waitForHealth(input) {
         return;
     }
     lastDetail = finalHealth.detail;
-    throw new Error(`KTX Python daemon failed to start: ${lastDetail}. stderr: ${input.state.stderrLog}`);
+    throw new Error(`KTX daemon failed to start: ${lastDetail}. stderr: ${input.state.stderrLog}`);
 }
 async function removeState(layout) {
     await rm(layout.daemonStatePath, { force: true });
@@ -491,7 +491,7 @@ export async function startManagedPythonDaemon(options) {
         });
         child.unref();
         if (!child.pid) {
-            throw new Error(`KTX Python daemon did not report a pid. stderr: ${layout.daemonStderrPath}`);
+            throw new Error(`KTX daemon did not report a pid. stderr: ${layout.daemonStderrPath}`);
         }
         const state = {
             schemaVersion: 1,

package/dist/managed-python-daemon.test.js

@@ -100,7 +100,7 @@ function daemonOptionsBase(root) {
         runtimeRoot: join(root, 'runtime'),
     };
 }
-describe('managed Python daemon lifecycle', () => {
+describe('KTX daemon lifecycle', () => {
     let tempDir;
     beforeEach(async () => {
         tempDir = await mkdtemp(join(tmpdir(), 'ktx-managed-daemon-'));

package/dist/managed-python-http.js

@@ -11,7 +11,7 @@ function normalizedBaseUrl(baseUrl) {
 function parseJsonObject(raw, path) {
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
-        throw new Error(`KTX managed daemon HTTP ${path} returned non-object JSON`);
+        throw new Error(`KTX daemon HTTP ${path} returned non-object JSON`);
     }
     return parsed;
 }
@@ -34,7 +34,7 @@ export async function postManagedDaemonJson(baseUrl, path, payload) {
                 const text = Buffer.concat(chunks).toString('utf8');
                 const statusCode = response.statusCode ?? 0;
                 if (statusCode < 200 || statusCode >= 300) {
-                    reject(new Error(`KTX managed daemon HTTP ${path} failed with ${statusCode}: ${text}`));
+                    reject(new Error(`KTX daemon HTTP ${path} failed with ${statusCode}: ${text}`));
                     return;
                 }
                 try {
@@ -70,7 +70,7 @@ export function createManagedPythonDaemonBaseUrlResolver(options) {
             force: false,
         });
         const verb = daemon.status === 'started' ? 'Started' : 'Using existing';
-        options.io.stderr.write(`${verb} KTX Python daemon: ${daemon.baseUrl}\n`);
+        options.io.stderr.write(`${verb} KTX daemon: ${daemon.baseUrl}\n`);
         cachedBaseUrl = daemon.baseUrl;
         return cachedBaseUrl;
     };

package/dist/managed-python-http.test.js

@@ -47,7 +47,7 @@ describe('createManagedPythonDaemonBaseUrlResolver', () => {
             features: ['core'],
             force: false,
         });
-        expect(testIo.stderr()).toContain('Started KTX Python daemon: http://127.0.0.1:61234');
+        expect(testIo.stderr()).toContain('Started KTX daemon: http://127.0.0.1:61234');
     });
     it('reports daemon reuse without reinstalling after the first resolved URL', async () => {
         const testIo = io();
@@ -73,7 +73,7 @@ describe('createManagedPythonDaemonBaseUrlResolver', () => {
         await expect(resolveBaseUrl()).resolves.toBe('http://127.0.0.1:61234');
         expect(ensureRuntime).toHaveBeenCalledTimes(1);
         expect(startDaemon).toHaveBeenCalledTimes(1);
-        expect(testIo.stderr()).toContain('Using existing KTX Python daemon: http://127.0.0.1:61234');
+        expect(testIo.stderr()).toContain('Using existing KTX daemon: http://127.0.0.1:61234');
     });
 });
 describe('createManagedDaemonHttpJsonRunner', () => {
@@ -87,8 +87,8 @@ describe('createManagedDaemonHttpJsonRunner', () => {
         expect(postJson).toHaveBeenCalledWith('http://127.0.0.1:61234', '/sql/parse-table-identifier', { items: [] });
     });
 });
-describe('managed daemon ingest ports', () => {
-    it('creates a Looker table parser backed by the managed daemon runner', async () => {
+describe('KTX daemon ingest ports', () => {
+    it('creates a Looker table parser backed by the KTX daemon runner', async () => {
         const requestJson = vi.fn(async () => ({
             results: {
                 'model.explore': {
@@ -114,7 +114,7 @@ describe('managed daemon ingest ports', () => {
             items: [{ key: 'model.explore', sql_table_name: 'public.orders', dialect: 'postgres' }],
         });
     });
-    it('creates a SQL analysis port backed by the managed daemon runner', async () => {
+    it('creates a SQL analysis port backed by the KTX daemon runner', async () => {
         const requestJson = vi.fn(async () => ({
             fingerprint: 'select-orders',
             normalized_sql: 'SELECT * FROM public.orders WHERE id = ?',
@@ -134,7 +134,7 @@ describe('managed daemon ingest ports', () => {
             dialect: 'postgres',
         });
     });
-    it('routes SQL batch analysis through the managed daemon runner', async () => {
+    it('routes SQL batch analysis through the KTX daemon runner', async () => {
         const requestJson = vi.fn(async () => ({
             results: {
                 orders: {

package/dist/print-command-tree.js

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

package/dist/public-ingest.d.ts

@@ -1,4 +1,4 @@
-import { type KtxLocalProject, loadKtxProject } from '@ktx/context/project';
+import { type KtxLocalProject } from '@ktx/context/project';
 import type { KtxProgressPort } from '@ktx/context/scan';
 import type { KtxCliIo } from './index.js';
 import type { KtxIngestArgs, KtxIngestDeps, KtxIngestProgressUpdate } from './ingest.js';
@@ -68,7 +68,9 @@ export interface KtxPublicIngestTargetResult {
 export type KtxPublicIngestProject = Pick<KtxLocalProject, 'projectDir' | 'config'>;
 type KtxPublicIngestPhaseKey = 'database-schema' | 'query-history' | 'source-ingest';
 export interface KtxPublicIngestDeps {
-    loadProject?: (options: Parameters<typeof loadKtxProject>[0]) => Promise<KtxPublicIngestProject>;
+    loadProject?: (options: {
+        projectDir: string;
+    }) => Promise<KtxPublicIngestProject>;
     runScan?: (args: KtxScanArgs, io: KtxCliIo, deps?: KtxScanDeps) => Promise<number>;
     runIngest?: (args: KtxIngestArgs, io: KtxCliIo, deps?: KtxIngestDeps) => Promise<number>;
     runContextBuild?: (project: KtxPublicIngestProject, args: KtxPublicContextBuildArgs, io: KtxCliIo) => Promise<{

package/dist/public-ingest.js

@@ -1,4 +1,4 @@
-import { loadKtxProject } from '@ktx/context/project';
+import { loadKtxCliProject } from './cli-project.js';
 import { databaseContextDepth, deepReadinessGaps, isDatabaseDriver, normalizeConnectionDriver, } from './ingest-depth.js';
 import { ensureManagedPythonCommandRuntime, } from './managed-python-command.js';
 import { publicIngestOutputLine } from './public-ingest-copy.js';
@@ -391,7 +391,7 @@ function createCapturedPublicIngestIo() {
     };
 }
 const INTERNAL_STATUS_LINE_RE = /^(Report|Run|Job|Status|Adapter|Connection|Sync|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)/;
 const RUNTIME_BACKED_RETRY_LINE_RE = /^Then retry the runtime-backed KTX command\.?$/;
 function trimErrorPrefix(line) {
     return line.replace(/^Error:\s*/, '');
@@ -536,7 +536,13 @@ export async function executePublicIngestTarget(target, args, io, deps) {
     return markTargetResult(target, args, exitCode === 0 ? 'done' : 'failed', 'source-ingest', capturedIngestIo ? capturedFailureMessage(capturedIngestIo.capturedOutput()) : undefined);
 }
 export async function runKtxPublicIngest(args, io, deps = {}) {
-    const loadProject = deps.loadProject ?? loadKtxProject;
+    const loadProject = deps.loadProject ??
+        ((options) => loadKtxCliProject({
+            projectDir: options.projectDir,
+            cliVersion: args.cliVersion ?? '0.0.0-private',
+            installPolicy: args.runtimeInstallPolicy ?? 'never',
+            io,
+        }));
     const project = await loadProject({ projectDir: args.projectDir });
     if (shouldUseForegroundContextBuildView(args, io)) {
         const plan = buildPublicIngestPlan(project, args);

package/dist/release-version.d.ts

@@ -1,5 +1 @@
-export declare function resolveKtxRuntimeVersion(input: {
-    packageName: string;
-    packageVersion: string;
-    startDir?: string;
-}): string;
+export declare function assertCliVersion(value: unknown, source: string): string;

package/dist/release-version.js

@@ -1,44 +1,7 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { dirname, join, parse } from 'node:path';
-import { fileURLToPath } from 'node:url';
 const semverPattern = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
-function isPlainObject(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function assertReleaseVersion(value, source) {
+export function assertCliVersion(value, source) {
     if (typeof value !== 'string' || !semverPattern.test(value)) {
-        throw new Error(`Invalid KTX release version in ${source}`);
+        throw new Error(`Invalid KTX CLI version in ${source}`);
     }
     return value;
 }
-function findReleasePolicyPath(startDir) {
-    let current = startDir;
-    const root = parse(current).root;
-    while (true) {
-        const candidate = join(current, 'release-policy.json');
-        if (existsSync(candidate)) {
-            return candidate;
-        }
-        if (current === root) {
-            return undefined;
-        }
-        current = dirname(current);
-    }
-}
-function readSourceReleaseVersion(startDir = dirname(fileURLToPath(import.meta.url))) {
-    const policyPath = findReleasePolicyPath(startDir);
-    if (!policyPath) {
-        return undefined;
-    }
-    const policy = JSON.parse(readFileSync(policyPath, 'utf8'));
-    if (!isPlainObject(policy)) {
-        throw new Error(`Invalid KTX release policy: ${policyPath}`);
-    }
-    return assertReleaseVersion(policy.publicNpmPackageVersion, policyPath);
-}
-export function resolveKtxRuntimeVersion(input) {
-    if (input.packageName === '@kaelio/ktx') {
-        return assertReleaseVersion(input.packageVersion, `${input.packageName}/package.json`);
-    }
-    return readSourceReleaseVersion(input.startDir) ?? input.packageVersion;
-}

package/dist/runtime-requirements.js

@@ -45,7 +45,7 @@ export function resolveProjectRuntimeRequirements(config, options = {}) {
         requirements.push({
             feature: 'core',
             reason: 'database-introspection',
-            detail: 'Database introspection fallback uses the Python daemon.',
+            detail: 'Database introspection fallback uses the KTX daemon.',
         });
     }
     for (const [connectionId, connection] of Object.entries(config.connections)) {

package/dist/runtime.js

@@ -15,7 +15,7 @@ function writeInstallResult(io, result) {
 }
 function writeDaemonStart(io, result) {
     const verb = result.status === 'reused' ? 'Using existing' : 'Started';
-    io.stdout.write(`${verb} KTX Python daemon\n`);
+    io.stdout.write(`${verb} KTX daemon\n`);
     io.stdout.write(`url: ${result.baseUrl}\n`);
     io.stdout.write(`pid: ${result.state.pid}\n`);
     io.stdout.write(`version: ${result.state.version}\n`);
@@ -26,10 +26,10 @@ function writeDaemonStart(io, result) {
 }
 function writeDaemonStop(io, result) {
     if (result.status === 'already-stopped') {
-        io.stdout.write('KTX Python daemon already stopped\n');
+        io.stdout.write('KTX daemon already stopped\n');
         return;
     }
-    io.stdout.write('Stopped KTX Python daemon\n');
+    io.stdout.write('Stopped KTX daemon\n');
     io.stdout.write(`pid: ${result.state?.pid ?? 'unknown'}\n`);
     io.stdout.write(`state: ${result.layout.daemonStatePath}\n`);
 }
@@ -42,11 +42,11 @@ function writeDaemonStopAll(io, result) {
         result.stale.length === 0 &&
         result.failed.length === 0 &&
         result.scanErrors.length === 0) {
-        io.stdout.write('No KTX Python daemons found\n');
+        io.stdout.write('No KTX daemons found\n');
         return 0;
     }
     if (failed === 0) {
-        io.stdout.write(`Stopped ${result.stopped.length} KTX Python daemons\n`);
+        io.stdout.write(`Stopped ${result.stopped.length} KTX daemons\n`);
         if (result.stale.length > 0) {
             io.stdout.write(`Cleaned ${result.stale.length} stale daemon states\n`);
         }
@@ -58,7 +58,7 @@ function writeDaemonStopAll(io, result) {
         }
         return 0;
     }
-    io.stderr.write(`Stopped ${result.stopped.length} KTX Python daemons; failed ${result.failed.length}${result.stale.length > 0 ? `; cleaned stale ${result.stale.length}` : ''}\n`);
+    io.stderr.write(`Stopped ${result.stopped.length} KTX daemons; failed ${result.failed.length}${result.stale.length > 0 ? `; cleaned stale ${result.stale.length}` : ''}\n`);
     for (const entry of result.failed) {
         io.stderr.write(`pid: ${entry.pid} source: ${entry.source}${entry.url ? ` url: ${entry.url}` : ''}${entry.health ? ` health: ${entry.health}` : ''} detail: ${entry.detail}\n`);
     }

package/dist/runtime.test.js

@@ -88,7 +88,7 @@ describe('runKtxRuntime', () => {
         expect(io.stdout()).toContain('manifest: /runtime/0.2.0/manifest.json');
         expect(io.stderr()).toBe('');
     });
-    it('starts the managed Python daemon and prints the base URL', async () => {
+    it('starts the KTX daemon and prints the base URL', async () => {
         const io = makeIo();
         const deps = {
             startDaemon: vi.fn(async () => ({
@@ -131,13 +131,13 @@ describe('runKtxRuntime', () => {
             features: ['local-embeddings'],
             force: true,
         });
-        expect(io.stdout()).toContain('Started KTX Python daemon');
+        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 managed Python daemon', async () => {
+    it('stops the KTX daemon', async () => {
         const io = makeIo();
         const deps = {
             stopDaemon: vi.fn(async () => ({
@@ -174,10 +174,10 @@ describe('runKtxRuntime', () => {
         };
         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 Python daemon');
+        expect(io.stdout()).toContain('Stopped KTX daemon');
         expect(io.stdout()).toContain('pid: 4242');
     });
-    it('stops all discovered Python daemons and reports the summary', async () => {
+    it('stops all discovered KTX daemons and reports the summary', async () => {
         const io = makeIo();
         const deps = {
             stopAllDaemons: vi.fn(async () => ({
@@ -192,7 +192,7 @@ describe('runKtxRuntime', () => {
         };
         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 Python daemons');
+        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');
     });
@@ -215,7 +215,7 @@ describe('runKtxRuntime', () => {
             })),
         };
         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 Python daemons; failed 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');
     });

package/dist/scan.js

@@ -1,5 +1,5 @@
-import { loadKtxProject } from '@ktx/context/project';
 import { runLocalScan, } from '@ktx/context/scan';
+import { loadKtxCliProject } from './cli-project.js';
 import { createKtxCliLocalIngestAdapters } from './local-adapters.js';
 import { createKtxCliScanConnector } from './local-scan-connectors.js';
 import { profileMark } from './startup-profile.js';
@@ -237,7 +237,12 @@ export function createCliScanProgress(io, state = { progress: 0, hasPendingTrans
 }
 export async function runKtxScan(args, io = process, deps = {}) {
     try {
-        const project = await loadKtxProject({ projectDir: args.projectDir });
+        const project = await loadKtxCliProject({
+            projectDir: args.projectDir,
+            cliVersion: args.cliVersion ?? '0.0.0-private',
+            installPolicy: args.runtimeInstallPolicy ?? 'never',
+            io,
+        });
         const managedDaemon = managedDaemonOptionsForScanRun(args, deps.runtimeIo ?? io);
         const connector = args.mode !== 'structural' || args.detectRelationships
             ? await createKtxCliScanConnector(project, args.connectionId)

package/dist/scan.test.js

@@ -294,7 +294,7 @@ describe('runKtxScan', () => {
         expect(io.stdout()).not.toContain('+1');
         expect(io.stdout()).not.toContain('/~');
     });
-    it('passes managed daemon options to local ingest adapters when no explicit daemon URL is set', async () => {
+    it('passes KTX daemon options to local ingest adapters when no explicit daemon URL is set', async () => {
         await initKtxProject({ projectDir: tempDir });
         const createLocalIngestAdapters = vi.fn(() => []);
         const runLocalScan = vi.fn(async (_input) => ({

package/dist/setup-embeddings.js

@@ -214,7 +214,7 @@ function localEmbeddingSetupMessage(message, stderrTail = []) {
         'The first run may download Python packages and the all-MiniLM-L6-v2 model.',
     ];
     if (stderrTail.length > 0) {
-        lines.push('Recent local embeddings daemon stderr:', ...stderrTail);
+        lines.push('Recent KTX daemon stderr:', ...stderrTail);
     }
     return lines.join('\n');
 }

package/dist/setup-embeddings.test.js

@@ -275,7 +275,7 @@ describe('setup embeddings step', () => {
             healthCheck: vi.fn(async () => ({ ok: false, message: 'HTTP 500' })),
         });
         expect(result.status).toBe('failed');
-        expect(io.stderr()).toContain('Recent local embeddings daemon stderr:');
+        expect(io.stderr()).toContain('Recent KTX daemon stderr:');
         expect(io.stderr()).toContain('daemon traceback line 6');
         expect(io.stderr()).toContain('daemon traceback line 45');
         expect(io.stderr()).not.toContain('daemon traceback line 5');
@@ -296,7 +296,7 @@ describe('setup embeddings step', () => {
             healthCheck: vi.fn(async () => ({ ok: false, message: 'HTTP 500' })),
         });
         expect(result.status).toBe('failed');
-        expect(io.stderr()).not.toContain('Recent local embeddings daemon stderr:');
+        expect(io.stderr()).not.toContain('Recent KTX daemon stderr:');
     });
     it('uses fixed OpenAI defaults and only asks for credentials when OpenAI is selected', async () => {
         const io = makeIo();

package/dist/setup-runtime.test.js

@@ -73,7 +73,7 @@ describe('runKtxSetupRuntimeStep', () => {
         expect((await readKtxSetupState(tempDir)).completed_steps).not.toContain('runtime');
         expect(io.stderr()).toContain('ktx admin runtime install --yes');
     });
-    it('starts the managed local embeddings daemon for configured sentence-transformers embeddings', async () => {
+    it('starts the KTX daemon for configured sentence-transformers embeddings', async () => {
         const io = makeIo();
         const ensureLocalEmbeddings = vi.fn(async () => ({
             baseUrl: 'http://127.0.0.1:61234',

package/node_modules/@ktx/context/dist/core/git.service.d.ts

@@ -101,6 +101,7 @@ export declare class GitService {
         status: 'A' | 'M' | 'D';
         path: string;
     }>>;
+    changedPaths(): Promise<string[]>;
     /**
      * List all paths under the working tree that match `pathSpec`, scoped to HEAD.
      * Used for the reconciler's first-ever run when there's no watermark to diff from.

package/node_modules/@ktx/context/dist/core/git.service.js

@@ -424,6 +424,18 @@ export class GitService {
         }
         return out;
     }
+    async changedPaths() {
+        const raw = await this.git.raw(['status', '--porcelain=v1', '-z']);
+        const fields = raw.split('\0').filter(Boolean);
+        const paths = [];
+        for (const field of fields) {
+            const path = field.slice(3);
+            if (path.length > 0) {
+                paths.push(path);
+            }
+        }
+        return [...new Set(paths)].sort();
+    }
     /**
      * List all paths under the working tree that match `pathSpec`, scoped to HEAD.
      * Used for the reconciler's first-ever run when there's no watermark to diff from.

package/node_modules/@ktx/context/dist/ingest/adapters/historic-sql/historic-sql.adapter.d.ts

@@ -1,4 +1,4 @@
-import type { ChunkResult, DiffSet, FetchContext, ScopeDescriptor, SourceAdapter } from '../../types.js';
+import type { ChunkResult, DeterministicFinalizationContext, DiffSet, FetchContext, FinalizationResult, ScopeDescriptor, SourceAdapter } from '../../types.js';
 import { type HistoricSqlSourceAdapterDeps } from './types.js';
 export declare class HistoricSqlSourceAdapter implements SourceAdapter {
     private readonly deps;
@@ -11,4 +11,5 @@ export declare class HistoricSqlSourceAdapter implements SourceAdapter {
     fetch(pullConfig: unknown, stagedDir: string, ctx: FetchContext): Promise<void>;
     chunk(stagedDir: string, diffSet?: DiffSet): Promise<ChunkResult>;
     describeScope(stagedDir: string): Promise<ScopeDescriptor>;
+    finalize(ctx: DeterministicFinalizationContext): Promise<FinalizationResult>;
 }

package/node_modules/@ktx/context/dist/ingest/adapters/historic-sql/historic-sql.adapter.js

@@ -1,5 +1,6 @@
 import { chunkHistoricSqlUnifiedStagedDir, describeHistoricSqlUnifiedScope } from './chunk-unified.js';
 import { detectHistoricSqlStagedDir } from './detect.js';
+import { projectHistoricSqlEvidence } from './projection.js';
 import { stageHistoricSqlAggregatedSnapshot } from './stage-unified.js';
 export class HistoricSqlSourceAdapter {
     deps;
@@ -30,4 +31,21 @@ export class HistoricSqlSourceAdapter {
     describeScope(stagedDir) {
         return describeHistoricSqlUnifiedScope(stagedDir);
     }
+    async finalize(ctx) {
+        const projection = await projectHistoricSqlEvidence({
+            workdir: ctx.workdir,
+            connectionId: ctx.connectionId,
+            syncId: ctx.syncId,
+            runId: ctx.runId,
+            overrideReplay: ctx.overrideReplay,
+        });
+        return {
+            result: projection,
+            warnings: projection.warnings,
+            errors: [],
+            touchedSources: projection.touchedSources,
+            changedWikiPageKeys: projection.changedWikiPageKeys,
+            actions: projection.actions,
+        };
+    }
 }

package/node_modules/@ktx/context/dist/ingest/adapters/historic-sql/local-ingest-acceptance.test.js

@@ -194,12 +194,12 @@ describe('historic-SQL local ingest retrieval acceptance', () => {
         expect(result.result.failedWorkUnits).toEqual([]);
         expect(result.result.workUnitCount).toBe(3);
         expect(agentRunner.runLoop).toHaveBeenCalledTimes(3);
-        const postProcessor = result.report.body.postProcessor;
-        expect(postProcessor).toBeDefined();
-        if (!postProcessor) {
-            throw new Error('Expected historic-SQL post-processor result');
+        const finalization = result.report.body.finalization;
+        expect(finalization).toBeDefined();
+        if (!finalization) {
+            throw new Error('Expected historic-SQL finalization result');
         }
-        expect(postProcessor).toMatchObject({
+        expect(finalization).toMatchObject({
             sourceKey: 'historic-sql',
             status: 'success',
             result: {
@@ -207,7 +207,7 @@ describe('historic-SQL local ingest retrieval acceptance', () => {
                 patternPagesWritten: 1,
             },
         });
-        expect(postProcessor.touchedSources).toEqual(expect.arrayContaining([
+        expect(finalization.declaredTouchedSources).toEqual(expect.arrayContaining([
             { connectionId: 'warehouse', sourceName: 'customers' },
             { connectionId: 'warehouse', sourceName: 'orders' },
         ]));

package/node_modules/@ktx/context/dist/ingest/adapters/historic-sql/projection.d.ts

@@ -1,8 +1,11 @@
+import type { MemoryAction } from '../../../memory/index.js';
+import type { FinalizationOverrideReplay } from '../../types.js';
 export interface HistoricSqlProjectionInput {
     workdir: string;
     connectionId: string;
     syncId: string;
     runId: string;
+    overrideReplay?: FinalizationOverrideReplay;
 }
 export interface HistoricSqlProjectionResult {
     tableUsageMerged: number;
@@ -14,6 +17,8 @@ export interface HistoricSqlProjectionResult {
         connectionId: string;
         sourceName: string;
     }>;
+    changedWikiPageKeys: string[];
+    actions: MemoryAction[];
     warnings: string[];
 }
 export declare function projectHistoricSqlEvidence(input: HistoricSqlProjectionInput): Promise<HistoricSqlProjectionResult>;