@kaelio/ktx 0.0.0 → 0.1.0-rc.0

package/node_modules/@ktx/context/dist/ingest/memory-flow/interaction.test.js

@@ -0,0 +1,264 @@
+import { describe, expect, it } from 'vitest';
+import { createInitialMemoryFlowInteractionState, findMemoryFlowSearchMatches, reduceMemoryFlowInteractionState, selectMemoryFlowChip, selectMemoryFlowColumn, selectedMemoryFlowColumn, selectedMemoryFlowDetails, visibleMemoryFlowChips, } from './interaction.js';
+function view() {
+    return {
+        title: 'KTX memory flow  warehouse/metricflow  running',
+        subtitle: 'Run run-1  Sync sync-1',
+        status: 'running',
+        activeLine: 'active: WorkUnit orders step 2/4',
+        selectedTitle: 'WORKUNITS',
+        selectedDetails: ['orders: 1 raw, 0 peers, 1 deps'],
+        completionLine: null,
+        trustIssues: [
+            {
+                id: 'flagged-fallbacks',
+                severity: 'warning',
+                title: 'Flagged fallbacks',
+                detail: '1 fallback needs review',
+                columnId: 'gates',
+            },
+            {
+                id: 'work-unit-failed:customers',
+                severity: 'failed',
+                title: 'WorkUnit failed',
+                detail: 'customers failed: semantic-layer validation failed',
+                columnId: 'workUnits',
+                targetLabel: 'customers',
+            },
+        ],
+        details: {
+            actions: [
+                {
+                    unitKey: 'orders',
+                    target: 'wiki',
+                    action: 'created',
+                    key: 'knowledge/orders.md',
+                    summary: 'order facts',
+                    rawFiles: ['orders.yml'],
+                    status: 'success',
+                },
+            ],
+            provenance: [
+                {
+                    rawPath: 'orders.yml',
+                    artifactKind: 'wiki',
+                    artifactKey: 'knowledge/orders.md',
+                    actionType: 'wiki_written',
+                },
+            ],
+            transcripts: [
+                {
+                    unitKey: 'customers',
+                    path: '/tmp/transcripts/customers.jsonl',
+                    toolCallCount: 2,
+                    errorCount: 1,
+                    toolNames: ['read_raw_span', 'sl_write_source'],
+                },
+            ],
+        },
+        columns: [
+            {
+                id: 'source',
+                title: 'SOURCE',
+                status: 'complete',
+                headline: '2 raw files',
+                counters: ['sync sync-1', 'scope none'],
+                chips: [{ label: 'metricflow', status: 'complete' }],
+                details: ['Trigger: manual_resync', 'Adapter: metricflow'],
+            },
+            {
+                id: 'chunks',
+                title: 'CHUNKS',
+                status: 'complete',
+                headline: '2 chunks',
+                counters: ['+1 ~1 -0 =0', '0 deletions'],
+                chips: [{ label: 'orders', status: 'complete' }],
+                details: ['Work units planned: 2', 'Eviction candidates: 0'],
+            },
+            {
+                id: 'workUnits',
+                title: 'WORKUNITS',
+                status: 'active',
+                headline: '2 WUs',
+                counters: ['1 done', '1 failed', '1 active'],
+                chips: [
+                    { label: 'orders', status: 'complete', detail: '1 raw span' },
+                    { label: 'customers', status: 'failed', detail: 'semantic-layer validation failed' },
+                ],
+                details: ['orders: 1 raw, 0 peers, 1 deps', 'customers: 1 raw, 0 peers, 0 deps'],
+            },
+            {
+                id: 'actions',
+                title: 'ACTIONS',
+                status: 'complete',
+                headline: '2 candidates',
+                counters: ['1 wiki', '1 SL'],
+                chips: [{ label: 'knowledge/orders.md', status: 'complete' }],
+                details: ['wiki created: knowledge/orders.md', 'sl updated: warehouse.orders'],
+            },
+            {
+                id: 'gates',
+                title: 'GATES',
+                status: 'warning',
+                headline: '0 conflict, 1 fallback',
+                counters: ['1 failed', '1 flagged'],
+                chips: [{ label: 'customers', status: 'failed' }],
+                details: ['Failed work units: 1', 'Flagged fallbacks: 1', 'customers: semantic-layer validation failed'],
+            },
+            {
+                id: 'saved',
+                title: 'SAVED',
+                status: 'complete',
+                headline: '2 memories',
+                counters: ['1 wiki', '1 SL', '2 provenance'],
+                chips: [{ label: 'abc12345', status: 'complete' }],
+                details: ['Commit: abc12345', 'Run: run-1', 'Report: report-1', 'Provenance rows: 2'],
+            },
+        ],
+    };
+}
+describe('memory-flow interaction reducer', () => {
+    it('selects the active work-unit column by default', () => {
+        const state = createInitialMemoryFlowInteractionState(view());
+        expect(state).toEqual({
+            selectedColumnId: 'workUnits',
+            selectedChipIndex: 0,
+            expanded: false,
+            pane: 'overview',
+            filter: 'all',
+            search: { editing: false, query: '', matchIndex: 0 },
+            shouldQuit: false,
+        });
+        expect(selectedMemoryFlowColumn(view(), state).title).toBe('WORKUNITS');
+    });
+    it('moves between columns and clamps chip selection', () => {
+        let state = createInitialMemoryFlowInteractionState(view());
+        state = reduceMemoryFlowInteractionState(state, 'down', view());
+        state = reduceMemoryFlowInteractionState(state, 'down', view());
+        expect(state.selectedChipIndex).toBe(1);
+        state = reduceMemoryFlowInteractionState(state, 'right', view());
+        expect(state.selectedColumnId).toBe('actions');
+        expect(state.selectedChipIndex).toBe(0);
+        state = reduceMemoryFlowInteractionState(state, 'left', view());
+        expect(state.selectedColumnId).toBe('workUnits');
+        expect(state.selectedChipIndex).toBe(0);
+    });
+    it('selects a column directly for mouse-driven renderers', () => {
+        const initial = createInitialMemoryFlowInteractionState(view());
+        const selected = selectMemoryFlowColumn(view(), initial, 'actions');
+        expect(selected).toMatchObject({
+            selectedColumnId: 'actions',
+            selectedChipIndex: 0,
+            expanded: true,
+            shouldQuit: false,
+        });
+        expect(selectedMemoryFlowColumn(view(), selected).title).toBe('ACTIONS');
+        expect(selectedMemoryFlowDetails(view(), selected)).toContain('wiki created: knowledge/orders.md');
+    });
+    it('selects and clamps a chip directly for mouse-driven renderers', () => {
+        const initial = createInitialMemoryFlowInteractionState(view());
+        const selected = selectMemoryFlowChip(view(), initial, 'workUnits', 99);
+        expect(selected).toMatchObject({
+            selectedColumnId: 'workUnits',
+            selectedChipIndex: 1,
+            expanded: true,
+            shouldQuit: false,
+        });
+        expect(selectedMemoryFlowDetails(view(), selected)).toContain('Selected chip: customers (semantic-layer validation failed)');
+    });
+    it('ignores direct selection of an unknown column', () => {
+        const initial = createInitialMemoryFlowInteractionState(view());
+        const selected = selectMemoryFlowColumn(view(), initial, 'missing');
+        expect(selected).toEqual({ ...initial, shouldQuit: false });
+    });
+    it('toggles expansion, attention filtering, all panes, and quit', () => {
+        let state = createInitialMemoryFlowInteractionState(view());
+        state = reduceMemoryFlowInteractionState(state, 'enter', view());
+        expect(state.expanded).toBe(true);
+        expect(selectedMemoryFlowDetails(view(), state)).toContain('orders: 1 raw, 0 peers, 1 deps');
+        state = reduceMemoryFlowInteractionState(state, 'filter', view());
+        expect(state.filter).toBe('failed_or_flagged');
+        expect(visibleMemoryFlowChips(selectedMemoryFlowColumn(view(), state), state)).toEqual([
+            { label: 'customers', status: 'failed', detail: 'semantic-layer validation failed' },
+        ]);
+        state = reduceMemoryFlowInteractionState(state, 'tab', view());
+        expect(state.pane).toBe('trust');
+        state = reduceMemoryFlowInteractionState(state, 'tab', view());
+        expect(state.pane).toBe('details');
+        state = reduceMemoryFlowInteractionState(state, 'tab', view());
+        expect(state.pane).toBe('log');
+        expect(selectedMemoryFlowDetails(view(), state)).toContain('WORKUNITS active: 2 WUs');
+        state = reduceMemoryFlowInteractionState(state, 'tab', view());
+        expect(state.pane).toBe('provenance');
+        expect(selectedMemoryFlowDetails(view(), state)).toContain('orders.yml -> wiki:knowledge/orders.md (wiki_written)');
+        state = reduceMemoryFlowInteractionState(state, 'tab', view());
+        expect(state.pane).toBe('transcript');
+        expect(selectedMemoryFlowDetails(view(), state)).toContain('customers: 2 tool calls, 1 errors, tools read_raw_span, sl_write_source');
+        state = reduceMemoryFlowInteractionState(state, 'tab', view());
+        expect(state.pane).toBe('overview');
+        state = reduceMemoryFlowInteractionState(state, 'provenance', view());
+        expect(state.pane).toBe('provenance');
+        expect(selectedMemoryFlowDetails(view(), state)).toContain('orders.yml -> wiki:knowledge/orders.md (wiki_written)');
+        state = reduceMemoryFlowInteractionState(state, 'transcript', view());
+        expect(state.pane).toBe('transcript');
+        expect(selectedMemoryFlowDetails(view(), state)).toContain('customers: 2 tool calls, 1 errors, tools read_raw_span, sl_write_source');
+        state = reduceMemoryFlowInteractionState(state, 'quit', view());
+        expect(state.shouldQuit).toBe(true);
+    });
+    it('shows trust issue details and filters chips using issue targets', () => {
+        let state = createInitialMemoryFlowInteractionState(view());
+        state = reduceMemoryFlowInteractionState(state, 'tab', view());
+        expect(state.pane).toBe('trust');
+        expect(selectedMemoryFlowDetails(view(), state)).toEqual([
+            'FAILED WorkUnit failed: customers failed: semantic-layer validation failed',
+            'WARNING Flagged fallbacks: 1 fallback needs review',
+        ]);
+        state = reduceMemoryFlowInteractionState(state, 'filter', view());
+        expect(visibleMemoryFlowChips(selectedMemoryFlowColumn(view(), state), state, view())).toEqual([
+            { label: 'customers', status: 'failed', detail: 'semantic-layer validation failed' },
+        ]);
+    });
+    it('searches across columns, trust issues, actions, provenance, and transcripts', () => {
+        const matches = findMemoryFlowSearchMatches(view(), 'customers');
+        expect(matches.map((match) => match.label)).toEqual([
+            'WORKUNITS > customers',
+            'GATES',
+            'Trust > WorkUnit failed',
+            'Transcript > customers',
+        ]);
+        let state = createInitialMemoryFlowInteractionState(view());
+        state = reduceMemoryFlowInteractionState(state, 'search-start', view());
+        state = reduceMemoryFlowInteractionState(state, { type: 'search-input', value: 'customers' }, view());
+        expect(state.search).toEqual({
+            editing: true,
+            query: 'customers',
+            matchIndex: 0,
+        });
+        expect(state.selectedColumnId).toBe('workUnits');
+        expect(state.selectedChipIndex).toBe(1);
+        state = reduceMemoryFlowInteractionState(state, 'search-submit', view());
+        expect(state.search.editing).toBe(false);
+    });
+    it('cycles search matches forward and backward with wraparound', () => {
+        let state = createInitialMemoryFlowInteractionState(view());
+        state = reduceMemoryFlowInteractionState(state, 'search-start', view());
+        state = reduceMemoryFlowInteractionState(state, { type: 'search-input', value: 'customers' }, view());
+        expect(state.search).toEqual({ editing: true, query: 'customers', matchIndex: 0 });
+        expect(state.selectedColumnId).toBe('workUnits');
+        expect(state.selectedChipIndex).toBe(1);
+        state = reduceMemoryFlowInteractionState(state, 'search-next', view());
+        expect(state.search).toEqual({ editing: true, query: 'customers', matchIndex: 1 });
+        expect(state.selectedColumnId).toBe('gates');
+        expect(state.selectedChipIndex).toBe(0);
+        state = reduceMemoryFlowInteractionState(state, 'search-next', view());
+        expect(state.search).toEqual({ editing: true, query: 'customers', matchIndex: 2 });
+        expect(state.selectedColumnId).toBe('workUnits');
+        state = reduceMemoryFlowInteractionState(state, 'search-previous', view());
+        expect(state.search).toEqual({ editing: true, query: 'customers', matchIndex: 1 });
+        expect(state.selectedColumnId).toBe('gates');
+        state = reduceMemoryFlowInteractionState(state, 'search-previous', view());
+        state = reduceMemoryFlowInteractionState(state, 'search-previous', view());
+        expect(state.search).toEqual({ editing: true, query: 'customers', matchIndex: 3 });
+        expect(state.selectedColumnId).toBe('workUnits');
+    });
+});

package/node_modules/@ktx/context/dist/ingest/memory-flow/interactive-render.d.ts

@@ -0,0 +1,2 @@
+import type { MemoryFlowInteractionState, MemoryFlowRenderOptions, MemoryFlowViewModel } from './types.js';
+export declare function renderMemoryFlowInteractive(view: MemoryFlowViewModel, state: MemoryFlowInteractionState, options?: MemoryFlowRenderOptions): string;

package/node_modules/@ktx/context/dist/ingest/memory-flow/interactive-render.js

@@ -0,0 +1,121 @@
+import { findMemoryFlowSearchMatches, selectedMemoryFlowColumn, selectedMemoryFlowDetails, visibleMemoryFlowChips, } from './interaction.js';
+import { renderMemoryFlowConnectorLine } from './visuals.js';
+const WIDE_COLUMN_WIDTH = 18;
+function cell(value, width = WIDE_COLUMN_WIDTH) {
+    const text = value ?? '';
+    const normalized = text.length > width ? text.slice(0, width - 1) : text;
+    return normalized.padEnd(width, ' ');
+}
+function row(values) {
+    return values.map((value) => cell(value)).join('  ').trimEnd();
+}
+function columnLabel(column, state) {
+    return column.id === state.selectedColumnId ? `[${column.title}]` : column.title;
+}
+function counterAt(column, index) {
+    return column.counters[index] ?? '';
+}
+function chipLabel(view, column, state) {
+    const chips = visibleMemoryFlowChips(column, state, view);
+    if (chips.length === 0) {
+        return '-';
+    }
+    const selectedIndex = column.id === state.selectedColumnId ? state.selectedChipIndex : -1;
+    return chips
+        .slice(0, 2)
+        .map((chip, index) => `${index === selectedIndex ? '> ' : ''}${chip.label}`)
+        .join(', ');
+}
+function selectedLine(view, state) {
+    const column = selectedMemoryFlowColumn(view, state);
+    const chip = visibleMemoryFlowChips(column, state, view)[state.selectedChipIndex];
+    return `Selected: ${column.title}${chip ? ` > ${chip.label}` : ''}`;
+}
+function trustIssueLines(view) {
+    if (view.trustIssues.length === 0) {
+        return [];
+    }
+    return [
+        'Trust issues',
+        ...view.trustIssues.slice(0, 4).map((issue) => {
+            const label = issue.severity === 'failed' ? 'FAILED' : 'WARNING';
+            return `${label} ${issue.title}: ${issue.detail}`;
+        }),
+        ...(view.trustIssues.length > 4 ? [`+${view.trustIssues.length - 4} more trust issues`] : []),
+        '',
+    ];
+}
+function searchLine(view, state) {
+    if (!state.search.editing && state.search.query.length === 0) {
+        return null;
+    }
+    const matches = findMemoryFlowSearchMatches(view, state.search.query);
+    const active = state.search.editing ? 'editing' : 'locked';
+    return `Search: ${state.search.query || '/'} (${matches.length} matches, ${active})`;
+}
+function detailLines(view, state) {
+    const currentSearchLine = searchLine(view, state);
+    return [
+        selectedLine(view, state),
+        `Pane: ${state.pane}  Filter: ${state.filter}`,
+        ...(currentSearchLine ? [currentSearchLine] : []),
+        ...selectedMemoryFlowDetails(view, state).map((detail) => `- ${detail}`),
+    ];
+}
+function renderWide(view, state) {
+    const lines = [
+        view.title,
+        view.activeLine,
+        view.subtitle,
+        renderMemoryFlowConnectorLine(view),
+        ...trustIssueLines(view),
+        '',
+        row(view.columns.map((column) => columnLabel(column, state))),
+        row(view.columns.map((column) => column.headline)),
+        row(view.columns.map((column) => counterAt(column, 0))),
+        row(view.columns.map((column) => counterAt(column, 1))),
+        row(view.columns.map((column) => chipLabel(view, column, state))),
+        '',
+        ...detailLines(view, state),
+    ];
+    if (view.completionLine) {
+        lines.push('', view.completionLine);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function renderNarrowColumn(view, column, state) {
+    return [
+        columnLabel(column, state),
+        `  ${column.headline}`,
+        ...column.counters.slice(0, 3).map((counter) => `  ${counter}`),
+        `  ${chipLabel(view, column, state)}`,
+    ];
+}
+function renderNarrow(view, state) {
+    const lines = [
+        view.title,
+        view.activeLine,
+        view.subtitle,
+        renderMemoryFlowConnectorLine(view),
+        ...trustIssueLines(view),
+        '',
+        ...view.columns.flatMap((column, index) => [
+            ...(index > 0 ? [''] : []),
+            ...renderNarrowColumn(view, column, state),
+        ]),
+        '',
+        ...detailLines(view, state),
+    ];
+    if (view.completionLine) {
+        lines.push('', view.completionLine);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+export function renderMemoryFlowInteractive(view, state, options = {}) {
+    if ((options.terminalWidth ?? 120) < 100) {
+        return renderNarrow(view, state);
+    }
+    return renderWide(view, state);
+}

package/node_modules/@ktx/context/dist/ingest/memory-flow/interactive-render.test.d.ts

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

package/node_modules/@ktx/context/dist/ingest/memory-flow/interactive-render.test.js

@@ -0,0 +1,160 @@
+import { describe, expect, it } from 'vitest';
+import { createInitialMemoryFlowInteractionState, reduceMemoryFlowInteractionState } from './interaction.js';
+import { renderMemoryFlowInteractive } from './interactive-render.js';
+function view() {
+    return {
+        title: 'KTX memory flow  warehouse/metricflow  done',
+        subtitle: 'Run run-1  Sync sync-1',
+        status: 'done',
+        activeLine: 'active: complete',
+        selectedTitle: 'WORKUNITS',
+        selectedDetails: ['orders: 1 raw, 0 peers, 1 deps'],
+        completionLine: 'Saved 2 memories from 2 raw files: 1 wiki pages, 1 SL updates. Commit: abc12345  Run: run-1  Report: report-1',
+        trustIssues: [
+            {
+                id: 'work-unit-failed:customers',
+                severity: 'failed',
+                title: 'WorkUnit failed',
+                detail: 'customers failed: validation reset',
+                columnId: 'workUnits',
+                targetLabel: 'customers',
+            },
+            {
+                id: 'flagged-fallbacks',
+                severity: 'warning',
+                title: 'Flagged fallbacks',
+                detail: '1 fallback needs review',
+                columnId: 'gates',
+            },
+        ],
+        details: {
+            actions: [
+                {
+                    unitKey: 'orders',
+                    target: 'wiki',
+                    action: 'created',
+                    key: 'knowledge/orders.md',
+                    summary: 'order facts',
+                    rawFiles: ['orders.yml'],
+                    status: 'success',
+                },
+            ],
+            provenance: [
+                {
+                    rawPath: 'orders.yml',
+                    artifactKind: 'wiki',
+                    artifactKey: 'knowledge/orders.md',
+                    actionType: 'wiki_written',
+                },
+            ],
+            transcripts: [
+                {
+                    unitKey: 'customers',
+                    path: '/tmp/transcripts/customers.jsonl',
+                    toolCallCount: 2,
+                    errorCount: 1,
+                    toolNames: ['read_raw_span', 'sl_write_source'],
+                },
+            ],
+        },
+        columns: [
+            {
+                id: 'source',
+                title: 'SOURCE',
+                status: 'complete',
+                headline: '2 raw files',
+                counters: ['sync sync-1', 'scope none'],
+                chips: [{ label: 'metricflow', status: 'complete' }],
+                details: ['Trigger: manual_resync', 'Adapter: metricflow'],
+            },
+            {
+                id: 'chunks',
+                title: 'CHUNKS',
+                status: 'complete',
+                headline: '2 chunks',
+                counters: ['+1 ~1 -0 =0', '0 deletions'],
+                chips: [{ label: 'orders', status: 'complete' }],
+                details: ['Work units planned: 2', 'Eviction candidates: 0'],
+            },
+            {
+                id: 'workUnits',
+                title: 'WORKUNITS',
+                status: 'warning',
+                headline: '2 WUs',
+                counters: ['1 done', '1 failed', '0 active'],
+                chips: [
+                    { label: 'orders', status: 'complete', detail: '1 raw span' },
+                    { label: 'customers', status: 'failed', detail: 'validation reset' },
+                ],
+                details: ['orders: 1 raw, 0 peers, 1 deps', 'customers: 1 raw, 0 peers, 0 deps'],
+            },
+            {
+                id: 'actions',
+                title: 'ACTIONS',
+                status: 'complete',
+                headline: '2 candidates',
+                counters: ['1 wiki', '1 SL'],
+                chips: [{ label: 'knowledge/orders.md', status: 'complete' }],
+                details: ['wiki created: knowledge/orders.md', 'sl updated: warehouse.orders'],
+            },
+            {
+                id: 'gates',
+                title: 'GATES',
+                status: 'warning',
+                headline: '0 conflict, 1 fallback',
+                counters: ['1 failed', '1 flagged'],
+                chips: [{ label: 'customers', status: 'failed' }],
+                details: ['Failed work units: 1', 'Flagged fallbacks: 1'],
+            },
+            {
+                id: 'saved',
+                title: 'SAVED',
+                status: 'complete',
+                headline: '2 memories',
+                counters: ['1 wiki', '1 SL', '2 provenance'],
+                chips: [{ label: 'abc12345', status: 'complete' }],
+                details: ['Commit: abc12345', 'Run: run-1', 'Report: report-1', 'Provenance rows: 2'],
+            },
+        ],
+    };
+}
+describe('renderMemoryFlowInteractive', () => {
+    it('marks the selected column and selected chip in a wide layout', () => {
+        const state = createInitialMemoryFlowInteractionState(view());
+        const output = renderMemoryFlowInteractive(view(), state, { terminalWidth: 140 });
+        expect(output).toContain('KTX memory flow  warehouse/metricflow  done');
+        expect(output).toContain('OK SOURCE -> OK CHUNKS -> !! WORKUNITS -> OK ACTIONS -> !! GATES -> OK SAVED');
+        expect(output).toContain('[WORKUNITS]');
+        expect(output).toContain('> orders');
+        expect(output).toContain('Selected: WORKUNITS > orders');
+        expect(output).toContain('Pane: overview  Filter: all');
+        expect(output).toContain('- Selected chip: orders (1 raw span)');
+        expect(output).toContain('Saved 2 memories from 2 raw files: 1 wiki pages, 1 SL updates. Commit: abc12345  Run: run-1  Report: report-1');
+    });
+    it('renders attention-filtered details in a narrow layout', () => {
+        let state = createInitialMemoryFlowInteractionState(view());
+        state = reduceMemoryFlowInteractionState(state, 'filter', view());
+        state = reduceMemoryFlowInteractionState(state, 'enter', view());
+        const output = renderMemoryFlowInteractive(view(), state, { terminalWidth: 72 });
+        expect(output).toContain('OK SOURCE -> OK CHUNKS -> !! WORKUNITS -> OK ACTIONS -> !! GATES -> OK SAVED');
+        expect(output).toContain('[WORKUNITS]');
+        expect(output).toContain('Filter: failed_or_flagged');
+        expect(output).toContain('> customers');
+        expect(output).toContain('- customers: 1 raw, 0 peers, 0 deps');
+    });
+    it('renders report-backed transcript detail pane rows', () => {
+        let state = createInitialMemoryFlowInteractionState(view());
+        state = reduceMemoryFlowInteractionState(state, 'down', view());
+        state = reduceMemoryFlowInteractionState(state, 'transcript', view());
+        const output = renderMemoryFlowInteractive(view(), state, { terminalWidth: 100 });
+        expect(output).toContain('Pane: transcript  Filter: all');
+        expect(output).toContain('- customers: 2 tool calls, 1 errors, tools read_raw_span, sl_write_source');
+    });
+    it('keeps trust issues visible in the interactive renderer', () => {
+        const state = createInitialMemoryFlowInteractionState(view());
+        const output = renderMemoryFlowInteractive(view(), state, { terminalWidth: 140 });
+        expect(output).toContain('Trust issues');
+        expect(output).toContain('FAILED WorkUnit failed: customers failed: validation reset');
+        expect(output).toContain('WARNING Flagged fallbacks: 1 fallback needs review');
+    });
+});

package/node_modules/@ktx/context/dist/ingest/memory-flow/live-buffer.d.ts

@@ -0,0 +1,3 @@
+import type { MemoryFlowEventSink, MemoryFlowLiveBufferOptions, MemoryFlowReplayInput } from './types.js';
+export declare function sanitizeMemoryFlowError(error: unknown): string;
+export declare function createMemoryFlowLiveBuffer(initialInput: MemoryFlowReplayInput, options?: MemoryFlowLiveBufferOptions): MemoryFlowEventSink;

package/node_modules/@ktx/context/dist/ingest/memory-flow/live-buffer.js

@@ -0,0 +1,53 @@
+const URL_PATTERN = /\b[a-z][a-z0-9+.-]*:\/\/[^\s]+/gi;
+const SECRET_ASSIGNMENT_PATTERN = /\b(password|passwd|pwd|token|api[_-]?key|secret)=([^\s&]+)/gi;
+function copyReplayInput(input) {
+    return {
+        ...input,
+        errors: [...input.errors],
+        events: [...input.events],
+        plannedWorkUnits: input.plannedWorkUnits.map((workUnit) => ({
+            ...workUnit,
+            rawFiles: [...workUnit.rawFiles],
+        })),
+        details: {
+            actions: input.details.actions.map((action) => ({ ...action, rawFiles: [...action.rawFiles] })),
+            provenance: input.details.provenance.map((row) => ({ ...row })),
+            transcripts: input.details.transcripts.map((summary) => ({ ...summary, toolNames: [...summary.toolNames] })),
+        },
+    };
+}
+function notify(input, options) {
+    options.onChange?.(copyReplayInput(input));
+}
+function stampEvent(event, options) {
+    if (event.emittedAt) {
+        return { ...event };
+    }
+    return { ...event, emittedAt: (options.now ?? (() => new Date()))().toISOString() };
+}
+export function sanitizeMemoryFlowError(error) {
+    const raw = error instanceof Error ? error.message : String(error);
+    return raw
+        .replace(URL_PATTERN, (value) => `${value.slice(0, value.indexOf('://'))}://[redacted]`)
+        .replace(SECRET_ASSIGNMENT_PATTERN, '$1=[redacted]');
+}
+export function createMemoryFlowLiveBuffer(initialInput, options = {}) {
+    let input = copyReplayInput(initialInput);
+    return {
+        emit(event) {
+            input = { ...input, events: [...input.events, stampEvent(event, options)] };
+            notify(input, options);
+        },
+        update(patch) {
+            input = copyReplayInput({ ...input, ...patch });
+            notify(input, options);
+        },
+        finish(status, errors = input.errors) {
+            input = copyReplayInput({ ...input, status, errors });
+            notify(input, options);
+        },
+        snapshot() {
+            return copyReplayInput(input);
+        },
+    };
+}

package/node_modules/@ktx/context/dist/ingest/memory-flow/live-buffer.test.d.ts

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