@kaelio/ktx 0.4.1 → 0.6.0

package/dist/telemetry/schema-writer.d.ts

@@ -0,0 +1,15 @@
+export interface TelemetrySchemaArtifact {
+    $schema: 'https://json-schema.org/draft/2020-12/schema';
+    title: 'ktx telemetry events';
+    type: 'object';
+    additionalProperties: false;
+    'x-ktx-common-fields': string[];
+    'x-ktx-catalog': Array<{
+        name: string;
+        description: string;
+        fields: readonly string[];
+    }>;
+    $defs: Record<string, unknown>;
+}
+/** @internal */
+export declare function buildTelemetrySchemaArtifact(): TelemetrySchemaArtifact;

package/dist/telemetry/schema-writer.js

@@ -0,0 +1,45 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { z } from 'zod';
+import { telemetryEventCatalog, telemetryEventSchemas } from './events.js';
+const commonFields = ['cliVersion', 'nodeVersion', 'osPlatform', 'osRelease', 'arch', 'runtime', 'isCi'];
+/** @internal */
+export function buildTelemetrySchemaArtifact() {
+    return {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        title: 'ktx telemetry events',
+        type: 'object',
+        additionalProperties: false,
+        'x-ktx-common-fields': [...commonFields],
+        'x-ktx-catalog': telemetryEventCatalog.map((event) => ({
+            name: event.name,
+            description: event.description,
+            fields: event.fields,
+        })),
+        $defs: Object.fromEntries(Object.entries(telemetryEventSchemas).map(([name, schema]) => [
+            name,
+            z.toJSONSchema(schema, { target: 'draft-2020-12' }),
+        ])),
+    };
+}
+async function writeTelemetrySchemaArtifact(path) {
+    const target = resolve(path);
+    await mkdir(dirname(target), { recursive: true });
+    await writeFile(target, `${JSON.stringify(buildTelemetrySchemaArtifact(), null, 2)}\n`, 'utf-8');
+}
+async function main(argv) {
+    const targets = argv.slice(2);
+    if (targets.length === 0) {
+        throw new Error('Usage: node dist/telemetry/schema-writer.js <target> [target...]');
+    }
+    for (const target of targets) {
+        await writeTelemetrySchemaArtifact(target);
+    }
+}
+if (import.meta.url === pathToFileURL(fileURLToPath(import.meta.url)).href && process.argv[1]) {
+    const invoked = pathToFileURL(resolve(process.argv[1])).href;
+    if (import.meta.url === invoked) {
+        await main(process.argv);
+    }
+}

package/dist/telemetry/scrubber.d.ts

@@ -0,0 +1 @@
+export declare function scrubErrorClass(error: unknown): string | undefined;

package/dist/telemetry/scrubber.js

@@ -0,0 +1,22 @@
+const MAX_ERROR_CLASS_LENGTH = 80;
+const ERROR_CLASS_PATTERN = /^[A-Z][A-Za-z0-9_]*$/;
+const PRIVATE_STRING_MARKERS = ['/', '\\', '@', '://'];
+export function scrubErrorClass(error) {
+    if (typeof error !== 'object' || error === null) {
+        return undefined;
+    }
+    const constructorName = error.constructor?.name;
+    if (typeof constructorName !== 'string') {
+        return undefined;
+    }
+    if (constructorName.length > MAX_ERROR_CLASS_LENGTH) {
+        return undefined;
+    }
+    if (PRIVATE_STRING_MARKERS.some((marker) => constructorName.includes(marker))) {
+        return undefined;
+    }
+    if (!ERROR_CLASS_PATTERN.test(constructorName)) {
+        return undefined;
+    }
+    return constructorName;
+}

package/dist/text-ingest.d.ts

@@ -1,5 +1,6 @@
-import { type MemoryAgentInput, type MemoryIngestStatus } from '@ktx/context/memory';
-import { type KtxLocalProject } from '@ktx/context/project';
+import type { MemoryAgentInput } from './context/memory/types.js';
+import type { MemoryIngestStatus } from './context/memory/memory-runs.js';
+import { type KtxLocalProject } from './context/project/project.js';
 import type { KtxCliIo } from './cli-runtime.js';
 export interface KtxTextIngestArgs {
     projectDir: string;
@@ -10,6 +11,7 @@ export interface KtxTextIngestArgs {
     json: boolean;
     failFast: boolean;
 }
+/** @internal */
 export interface TextMemoryIngestPort {
     ingest(input: MemoryAgentInput): Promise<{
         runId: string;

package/dist/text-ingest.js

@@ -1,7 +1,7 @@
 import { readFile as fsReadFile } from 'node:fs/promises';
 import { basename, resolve } from 'node:path';
-import { createLocalProjectMemoryIngest } from '@ktx/context/memory';
-import { loadKtxProject } from '@ktx/context/project';
+import { createLocalProjectMemoryIngest } from './context/memory/local-memory.js';
+import { loadKtxProject } from './context/project/project.js';
 import { createRepainter, initViewState, renderContextBuildView } from './context-build-view.js';
 import { formatDuration } from './demo-metrics.js';
 const INLINE_TEXT_LABEL_MAX_LENGTH = 50;

package/dist/tree-picker-state.d.ts

@@ -22,9 +22,9 @@ export interface PickerState {
     checked: Set<string>;
     cursorId: string;
     search: {
-        editing: boolean;
         query: string;
     };
+    isNavigating: boolean;
     pendingConfirm: PendingConfirmKind | null;
     preLoadWarnings: string[];
     transientHint: {
@@ -34,21 +34,24 @@ export interface PickerState {
     requireConfirmOnSave: boolean;
     skipEmptyAction: SkipEmptyAction;
 }
-export type PickerCommand = 'cursor-up' | 'cursor-down' | 'cursor-left' | 'cursor-right' | 'expand' | 'collapse' | 'expand-all' | 'collapse-all' | 'toggle-check' | 'select-all-visible' | 'toggle-select-all-visible' | 'select-none' | 'clear-transient-hint' | 'search-start' | 'search-cancel' | 'search-submit' | 'search-backspace' | {
+export type PickerCommand = 'cursor-up' | 'cursor-down' | 'cursor-left' | 'cursor-right' | 'expand' | 'collapse' | 'expand-all' | 'collapse-all' | 'toggle-check' | 'select-all-visible' | 'toggle-select-all-visible' | 'select-none' | 'clear-transient-hint' | 'search-clear' | 'search-backspace' | {
     type: 'search-input';
     value: string;
 } | 'save-request' | 'save-confirm' | 'save-cancel' | 'quit';
 type PickerEffect = null | 'save' | 'quit-without-save';
+/** @internal */
 export declare function clearExpiredTransientHint(state: PickerState, now?: number): PickerState;
 export declare function buildPickerTree(inputs: TreePickerNodeInput[]): TreePickerNode[];
 export declare function isAncestorChecked(nodeId: string, checked: Set<string>, byId: Map<string, TreePickerNode>): boolean;
 export declare function hasPartialChildren(nodeId: string, checked: Set<string>, byId: Map<string, TreePickerNode>): boolean;
+/** @internal */
 export declare function canToggle(nodeId: string, state: PickerState): {
     ok: true;
 } | {
     ok: false;
     reason: string;
 };
+/** @internal */
 export declare function toggleChecked(state: PickerState, nodeId: string, now?: number): PickerState;
 export declare function flattenSelection(checked: Set<string>, byId: Map<string, TreePickerNode>): string[];
 export declare function filterTree(state: PickerState): {
@@ -56,8 +59,11 @@ export declare function filterTree(state: PickerState): {
     autoExpand: Set<string>;
 };
 export declare function visibleNodeIds(state: PickerState): string[];
+/** @internal */
 export declare function selectAllVisible(state: PickerState): PickerState;
+/** @internal */
 export declare function selectNone(state: PickerState): PickerState;
+/** @internal */
 export declare function moveCursor(state: PickerState, dir: 'up' | 'down' | 'left' | 'right'): PickerState;
 export declare function buildInitialState(args: {
     tree: TreePickerNode[];

package/dist/tree-picker-state.js

@@ -18,6 +18,7 @@ function cloneState(state, patch) {
 function transientHint(text, now) {
     return { text, expiresAt: now + TRANSIENT_HINT_DURATION_MS };
 }
+/** @internal */
 export function clearExpiredTransientHint(state, now = Date.now()) {
     if (!state.transientHint || state.transientHint.expiresAt > now) {
         return state;
@@ -150,6 +151,7 @@ function checkedAncestor(nodeId, state) {
     }
     return null;
 }
+/** @internal */
 export function canToggle(nodeId, state) {
     if (!state.byId.has(nodeId)) {
         return { ok: false, reason: 'Node not found' };
@@ -160,6 +162,7 @@ export function canToggle(nodeId, state) {
     }
     return { ok: true };
 }
+/** @internal */
 export function toggleChecked(state, nodeId, now = Date.now()) {
     const toggle = canToggle(nodeId, state);
     if (!toggle.ok) {
@@ -228,6 +231,7 @@ export function visibleNodeIds(state) {
     }
     return result;
 }
+/** @internal */
 export function selectAllVisible(state) {
     const candidates = state.search.query.trim().length > 0 ? matchingIds(state) : new Set(visibleNodeIds(state));
     const checked = new Set(state.checked);
@@ -248,6 +252,7 @@ export function selectAllVisible(state) {
         transientHint: null,
     });
 }
+/** @internal */
 export function selectNone(state) {
     return cloneState(state, { checked: new Set(), transientHint: null });
 }
@@ -270,6 +275,7 @@ function setExpanded(state, nodeId, value) {
     }
     return cloneState(state, { expanded });
 }
+/** @internal */
 export function moveCursor(state, dir) {
     const node = state.byId.get(state.cursorId);
     if (!node) {
@@ -332,7 +338,8 @@ export function buildInitialState(args) {
         expanded,
         checked: minimalChecked,
         cursorId: args.tree[0]?.id ?? '',
-        search: { editing: false, query: '' },
+        search: { query: '' },
+        isNavigating: false,
         pendingConfirm: null,
         preLoadWarnings,
         transientHint: null,
@@ -340,6 +347,13 @@ export function buildInitialState(args) {
         skipEmptyAction: args.skipEmptyAction ?? 'quit',
     };
 }
+function refocusVisibleCursor(state) {
+    const ids = visibleNodeIds(state);
+    if (ids.length === 0 || ids.includes(state.cursorId)) {
+        return state;
+    }
+    return cloneState(state, { cursorId: ids[0] });
+}
 export function reducer(state, cmd, now = Date.now()) {
     if (state.pendingConfirm) {
         if (cmd === 'save-confirm') {
@@ -356,13 +370,13 @@ export function reducer(state, cmd, now = Date.now()) {
     }
     switch (cmd) {
         case 'cursor-up':
-            return { next: moveCursor(state, 'up'), effect: null };
+            return { next: cloneState(moveCursor(state, 'up'), { isNavigating: true }), effect: null };
         case 'cursor-down':
-            return { next: moveCursor(state, 'down'), effect: null };
+            return { next: cloneState(moveCursor(state, 'down'), { isNavigating: true }), effect: null };
         case 'cursor-left':
-            return { next: moveCursor(state, 'left'), effect: null };
+            return { next: cloneState(moveCursor(state, 'left'), { isNavigating: true }), effect: null };
         case 'cursor-right':
-            return { next: moveCursor(state, 'right'), effect: null };
+            return { next: cloneState(moveCursor(state, 'right'), { isNavigating: true }), effect: null };
         case 'expand':
             return { next: setExpanded(state, state.cursorId, 'toggle'), effect: null };
         case 'collapse':
@@ -386,15 +400,17 @@ export function reducer(state, cmd, now = Date.now()) {
             return { next: selectNone(state), effect: null };
         case 'clear-transient-hint':
             return { next: clearExpiredTransientHint(state, now), effect: null };
-        case 'search-start':
-            return { next: cloneState(state, { search: { ...state.search, editing: true } }), effect: null };
-        case 'search-cancel':
-            return { next: cloneState(state, { search: { editing: false, query: '' } }), effect: null };
-        case 'search-submit':
-            return { next: cloneState(state, { search: { ...state.search, editing: false } }), effect: null };
+        case 'search-clear':
+            return {
+                next: cloneState(state, { search: { query: '' }, isNavigating: false }),
+                effect: null,
+            };
         case 'search-backspace':
             return {
-                next: cloneState(state, { search: { ...state.search, query: state.search.query.slice(0, -1) } }),
+                next: refocusVisibleCursor(cloneState(state, {
+                    search: { query: state.search.query.slice(0, -1) },
+                    isNavigating: false,
+                })),
                 effect: null,
             };
         case 'save-request':
@@ -411,6 +427,12 @@ export function reducer(state, cmd, now = Date.now()) {
         case 'quit':
             return { next: state, effect: 'quit-without-save' };
         default:
-            return { next: cloneState(state, { search: { ...state.search, query: state.search.query + cmd.value } }), effect: null };
+            return {
+                next: refocusVisibleCursor(cloneState(state, {
+                    search: { query: state.search.query + cmd.value },
+                    isNavigating: false,
+                })),
+                effect: null,
+            };
     }
 }

package/dist/tree-picker-tui.d.ts

@@ -20,6 +20,8 @@ interface InkKey {
     return?: boolean;
     escape?: boolean;
     ctrl?: boolean;
+    tab?: boolean;
+    shift?: boolean;
     backspace?: boolean;
     delete?: boolean;
 }
@@ -47,11 +49,13 @@ interface TreePickerAppProps extends TreePickerRenderInput {
     env?: NodeJS.ProcessEnv;
     onExit(result: TreePickerResult): void;
 }
+/** @internal */
 export interface TreePickerInkInstance {
     rerender(tree: ReactNode): void;
     unmount(): void;
     waitUntilExit(): Promise<void>;
 }
+/** @internal */
 export interface TreePickerInkRenderOptions {
     stdin?: TreePickerTuiIo['stdin'];
     stdout: TreePickerTuiIo['stdout'];
@@ -61,14 +65,20 @@ export interface TreePickerInkRenderOptions {
     maxFps: number;
     alternateScreen: boolean;
 }
+/** @internal */
 export declare function resolveTreePickerWidth(columns: number | undefined): number;
+/** @internal */
 export declare function sanitizeTreePickerTuiError(error: unknown): string;
+/** @internal */
 export declare function windowOffset(count: number, selected: number, visible: number): number;
+/** @internal */
 export declare function windowItems<T>(items: T[], selected: number, visible: number): {
     items: T[];
     offset: number;
 };
-export declare function treePickerCommandForInkInput(input: string, key: InkKey, search: PickerState['search'], pendingConfirm: PickerState['pendingConfirm']): PickerCommand | null;
+/** @internal */
+export declare function treePickerCommandForInkInput(input: string, key: InkKey, state: Pick<PickerState, 'search' | 'isNavigating' | 'pendingConfirm'>): PickerCommand | null;
+/** @internal */
 export declare function TreePickerApp(props: TreePickerAppProps): ReactNode;
 export interface RenderTreePickerOptions {
     renderInk?: (tree: ReactNode, options: TreePickerInkRenderOptions) => TreePickerInkInstance;

package/dist/tree-picker-tui.js

@@ -17,11 +17,12 @@ const NO_COLOR_THEME = {
     selected: 'white',
     warning: 'white',
 };
-const DEFAULT_TREE_PICKER_HELP_TEXT = 'Right Arrow to expand, Up/Down to move, Space to select or unselect, Slash to filter, Enter to confirm, Escape to go back, or Ctrl+C to exit.';
+const DEFAULT_TREE_PICKER_HELP_TEXT = 'Up/Down to move, Right/Left to expand or collapse, Tab to select, Type to search, Enter to confirm, Escape to clear search or go back, Ctrl+C to exit.';
 const DEFAULT_SKIP_EMPTY_MESSAGE = 'Nothing selected. Skip this step? Press Enter to skip or Escape to go back.';
 function resolveTheme(env = process.env) {
     return env.NO_COLOR || env.TERM === 'dumb' ? NO_COLOR_THEME : COLOR_THEME;
 }
+/** @internal */
 export function resolveTreePickerWidth(columns) {
     const resolvedColumns = columns ?? 100;
     return Math.max(60, Math.min(120, resolvedColumns - 4));
@@ -37,17 +38,20 @@ function rowMatchesSearch(state, nodeId) {
     }
     return node.title.toLocaleLowerCase().includes(query) || node.path.toLocaleLowerCase().includes(query);
 }
+/** @internal */
 export function sanitizeTreePickerTuiError(error) {
     const message = error instanceof Error ? error.message : String(error);
     return message
         .replace(/[a-z][a-z0-9+.-]*:\/\/[^\s]+/gi, '[redacted-url]')
         .replace(/\b(api[_-]?key|password|token|secret)=\S+/gi, '[redacted]');
 }
+/** @internal */
 export function windowOffset(count, selected, visible) {
     if (count <= visible)
         return 0;
     return Math.max(0, Math.min(count - visible, selected - Math.floor(visible / 2)));
 }
+/** @internal */
 export function windowItems(items, selected, visible) {
     const offset = windowOffset(items.length, selected, visible);
     return { items: items.slice(offset, offset + visible), offset };
@@ -59,8 +63,9 @@ function truncateText(value, width) {
         return value.slice(0, width);
     return `${value.slice(0, width - 3)}...`;
 }
-export function treePickerCommandForInkInput(input, key, search, pendingConfirm) {
-    if (pendingConfirm) {
+/** @internal */
+export function treePickerCommandForInkInput(input, key, state) {
+    if (state.pendingConfirm) {
         if (input === 'y' || key.return)
             return 'save-confirm';
         if (input === 'n' || key.escape)
@@ -69,23 +74,14 @@ export function treePickerCommandForInkInput(input, key, search, pendingConfirm)
             return 'quit';
         return null;
     }
-    if (search.editing) {
-        if (key.escape)
-            return 'search-cancel';
-        if (key.return)
-            return 'search-submit';
-        if (key.backspace || key.delete)
-            return 'search-backspace';
-        if (key.downArrow)
-            return 'cursor-down';
-        if (key.upArrow)
-            return 'cursor-up';
-        if (input.length === 1 && input >= ' ' && input !== '')
-            return { type: 'search-input', value: input };
-        return null;
-    }
     if (key.ctrl === true && input === 'c')
         return 'quit';
+    if (key.ctrl === true && input === 'a')
+        return 'toggle-select-all-visible';
+    if (key.ctrl === true && input === 'n')
+        return 'select-none';
+    if (key.return)
+        return 'save-request';
     if (key.upArrow)
         return 'cursor-up';
     if (key.downArrow)
@@ -94,18 +90,16 @@ export function treePickerCommandForInkInput(input, key, search, pendingConfirm)
         return 'cursor-left';
     if (key.rightArrow)
         return 'cursor-right';
-    if (key.return)
-        return 'save-request';
-    if (input === ' ')
+    if (key.tab)
         return 'toggle-check';
-    if (input === '/')
-        return 'search-start';
-    if (input === 'a')
-        return 'toggle-select-all-visible';
-    if (input === 'n')
-        return 'select-none';
+    if (input === ' ' && state.isNavigating)
+        return 'toggle-check';
+    if (key.backspace || key.delete)
+        return 'search-backspace';
     if (key.escape)
-        return 'quit';
+        return state.search.query.length > 0 ? 'search-clear' : 'quit';
+    if (input.length === 1 && input >= ' ' && input !== '')
+        return { type: 'search-input', value: input };
     return null;
 }
 function PickerRow(props) {
@@ -127,6 +121,7 @@ function PickerRow(props) {
     const title = truncateText(node.title, Math.max(10, props.width - prefixWidth));
     return (_jsxs(Text, { children: [_jsxs(Text, { color: glyphColor, children: [indent, glyph] }), _jsxs(Text, { color: titleColor, strikethrough: node.archived, bold: focused, children: [' ', _jsx(Text, { inverse: inverse, children: title })] }), childAffordance.length > 0 ? _jsx(Text, { color: props.theme.muted, children: childAffordance }) : null] }));
 }
+/** @internal */
 export function TreePickerApp(props) {
     const app = useApp();
     const [state, setState] = useState(props.initialState);
@@ -134,14 +129,13 @@ export function TreePickerApp(props) {
     const theme = useMemo(() => resolveTheme(props.env), [props.env]);
     const visibleIds = visibleNodeIds(state);
     const selectedIndex = Math.max(0, visibleIds.indexOf(state.cursorId));
-    const reservedRows = state.pendingConfirm === 'save-confirm' ? 10 : 9;
+    const reservedRows = state.pendingConfirm === 'save-confirm' ? 11 : 10;
     const visibleRows = Math.max(5, Math.min(12, (props.terminalRows ?? 24) - reservedRows));
     const rows = windowItems(visibleIds, selectedIndex, visibleRows);
     const hiddenAbove = rows.offset;
     const hiddenBelow = Math.max(0, visibleIds.length - rows.offset - rows.items.length);
     const searchMatchCount = filterTree(state).visibleIds.size;
     const width = resolveTreePickerWidth(props.terminalWidth);
-    const showSearch = state.search.editing || state.search.query.trim().length > 0;
     const helpText = props.chrome.helpText ?? DEFAULT_TREE_PICKER_HELP_TEXT;
     const skipEmptyMessage = props.chrome.skipEmptyMessage ?? DEFAULT_SKIP_EMPTY_MESSAGE;
     stateRef.current = state;
@@ -166,7 +160,7 @@ export function TreePickerApp(props) {
         return () => clearTimeout(timeout);
     }, [state.transientHint?.expiresAt]);
     useInput((input, key) => {
-        const command = treePickerCommandForInkInput(input, key, stateRef.current.search, stateRef.current.pendingConfirm);
+        const command = treePickerCommandForInkInput(input, key, stateRef.current);
         if (!command) {
             return;
         }
@@ -183,7 +177,7 @@ export function TreePickerApp(props) {
             app.exit();
         }
     });
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { color: theme.active, children: "\u25C6" }), _jsxs(Text, { bold: true, children: [" ", props.chrome.title] })] }), _jsxs(Box, { flexDirection: "column", borderStyle: "single", borderTop: false, borderRight: false, borderBottom: false, borderColor: theme.active, paddingLeft: 1, children: [_jsx(Text, { color: theme.muted, children: helpText }), _jsx(Text, { children: " " }), (props.chrome.subtitleLines ?? []).map((line, idx) => (_jsx(Text, { color: theme.muted, children: line }, `subtitle-${idx}`))), (props.chrome.warningLines ?? []).map((line, idx) => (_jsx(Text, { color: theme.warning, children: line }, `chromewarn-${idx}`))), state.preLoadWarnings.map((warning) => (_jsx(Text, { color: theme.warning, children: warning }, warning))), showSearch ? (_jsxs(Text, { children: [_jsx(Text, { color: theme.muted, children: "/ " }), _jsxs(Text, { children: [state.search.query, state.search.editing ? '█' : ''] }), _jsxs(Text, { color: theme.muted, children: ["  (", searchMatchCount, " matches)"] })] })) : null, _jsx(Text, { children: " " }), hiddenAbove > 0 ? _jsxs(Text, { color: theme.muted, children: ["\u2191 ", hiddenAbove, " more"] }) : null, rows.items.map((nodeId) => (_jsx(PickerRow, { state: state, nodeId: nodeId, width: width, theme: theme }, nodeId))), hiddenBelow > 0 ? _jsxs(Text, { color: theme.muted, children: ["\u2193 ", hiddenBelow, " more"] }) : null, state.pendingConfirm === 'save-confirm' ? (_jsx(Text, { color: theme.warning, children: props.chrome.confirmSaveMessage
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { color: theme.active, children: "\u25C6" }), _jsxs(Text, { bold: true, children: [" ", props.chrome.title] })] }), _jsxs(Box, { flexDirection: "column", borderStyle: "single", borderTop: false, borderRight: false, borderBottom: false, borderColor: theme.active, paddingLeft: 1, children: [_jsx(Text, { color: theme.muted, children: helpText }), _jsx(Text, { children: " " }), (props.chrome.subtitleLines ?? []).map((line, idx) => (_jsx(Text, { color: theme.muted, children: line }, `subtitle-${idx}`))), (props.chrome.warningLines ?? []).map((line, idx) => (_jsx(Text, { color: theme.warning, children: line }, `chromewarn-${idx}`))), state.preLoadWarnings.map((warning) => (_jsx(Text, { color: theme.warning, children: warning }, warning))), _jsxs(Text, { children: [_jsx(Text, { color: theme.muted, children: "Search: " }), state.isNavigating ? (_jsx(Text, { color: theme.muted, children: state.search.query || '(type to filter)' })) : (_jsxs(Text, { children: [state.search.query, _jsx(Text, { inverse: true, children: " " })] })), _jsxs(Text, { color: theme.muted, children: ["  (", searchMatchCount, " match", searchMatchCount === 1 ? '' : 'es', ")"] })] }), _jsx(Text, { children: " " }), hiddenAbove > 0 ? _jsxs(Text, { color: theme.muted, children: ["\u2191 ", hiddenAbove, " more"] }) : null, rows.items.map((nodeId) => (_jsx(PickerRow, { state: state, nodeId: nodeId, width: width, theme: theme }, nodeId))), hiddenBelow > 0 ? _jsxs(Text, { color: theme.muted, children: ["\u2193 ", hiddenBelow, " more"] }) : null, state.pendingConfirm === 'save-confirm' ? (_jsx(Text, { color: theme.warning, children: props.chrome.confirmSaveMessage
                             ? props.chrome.confirmSaveMessage(state)
                             : 'Confirm save? Press Enter to confirm or Escape to go back.' })) : null, state.pendingConfirm === 'skip-empty' ? _jsx(Text, { color: theme.warning, children: skipEmptyMessage }) : null, state.transientHint ? _jsx(Text, { color: theme.warning, children: state.transientHint.text }) : null] }), _jsx(Text, { color: theme.active, children: "\u2514" })] }));
 }

package/dist/viz-fallback.d.ts

@@ -24,5 +24,6 @@ type KtxVizFallbackDecision = {
 export declare function resolveVizFallback(io: KtxVizFallbackIo, env?: NodeJS.ProcessEnv, options?: KtxVizFallbackOptions): KtxVizFallbackDecision;
 export declare function rendererUnavailableVizFallback(): KtxVizFallbackDecision;
 export declare function warnVizFallbackOnce(io: KtxVizFallbackIo, decision: KtxVizFallbackDecision): void;
+/** @internal */
 export declare function resetVizFallbackWarningsForTest(): void;
 export {};

package/dist/viz-fallback.js

@@ -46,6 +46,7 @@ export function warnVizFallbackOnce(io, decision) {
     warnedFallbackReasons.add(decision.reason);
     io.stderr.write(`Visualization requested but ${decision.message}; printing plain output.\n`);
 }
+/** @internal */
 export function resetVizFallbackWarningsForTest() {
     warnedFallbackReasons.clear();
 }

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@kaelio/ktx",
-  "version": "0.4.1",
-  "description": "Standalone KTX context layer for database agents",
-  "private": false,
+  "version": "0.6.0",
+  "description": "Standalone ktx context layer for data agents",
   "type": "module",
   "engines": {
     "node": ">=22.0.0"
@@ -24,6 +23,10 @@
     "dist",
     "assets"
   ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "dependencies": {
     "@ai-sdk/anthropic": "3.0.77",
     "@ai-sdk/devtools": "0.0.17",
@@ -51,30 +54,50 @@
     "openai": "^6.37.0",
     "p-limit": "^7.3.0",
     "pg": "^8.20.0",
+    "posthog-node": "^5.0.0",
     "react": "^19.2.6",
     "simple-git": "3.36.0",
     "snowflake-sdk": "^2.4.1",
     "yaml": "^2.9.0",
     "zod": "^4.4.3"
   },
-  "bundledDependencies": [
-    "@ktx/llm",
-    "@ktx/context",
-    "@ktx/connector-bigquery",
-    "@ktx/connector-clickhouse",
-    "@ktx/connector-mysql",
-    "@ktx/connector-postgres",
-    "@ktx/connector-snowflake",
-    "@ktx/connector-sqlite",
-    "@ktx/connector-sqlserver"
-  ],
+  "devDependencies": {
+    "@electric-sql/pglite": "^0.4.5",
+    "@electric-sql/pglite-socket": "^0.1.5",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/mssql": "^12.3.0",
+    "@types/node": "^25.7.0",
+    "@types/pg": "^8.20.0",
+    "@types/react": "^19.2.14",
+    "@vitest/coverage-v8": "^4.1.6",
+    "ajv": "8.20.0",
+    "ink-testing-library": "^4.0.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  },
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Kaelio/ktx"
+    "url": "https://github.com/Kaelio/ktx",
+    "directory": "packages/cli"
   },
   "bugs": {
     "url": "https://github.com/Kaelio/ktx/issues"
   },
-  "homepage": "https://github.com/Kaelio/ktx#readme"
+  "homepage": "https://github.com/Kaelio/ktx#readme",
+  "scripts": {
+    "assets:demo": "node scripts/build-demo-assets.mjs",
+    "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 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 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"
+  }
 }