@kaelio/ktx 0.4.1 → 0.6.0

package/node_modules/@ktx/context/dist/ingest/report-snapshot.test.js

@@ -1,329 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { parseIngestReportSnapshot } from './report-snapshot.js';
-function validReportSnapshot() {
-    return {
-        id: 'report-1',
-        runId: 'run-1',
-        jobId: 'job-1',
-        connectionId: 'warehouse',
-        sourceKey: 'metabase',
-        createdAt: '2026-04-30T12:00:00.000Z',
-        body: {
-            syncId: 'sync-1',
-            diffSummary: { added: 2, modified: 1, deleted: 0, unchanged: 4 },
-            commitSha: 'abc12345',
-            workUnits: [
-                {
-                    unitKey: 'cards',
-                    rawFiles: ['cards/1.json', 'cards/2.json'],
-                    status: 'success',
-                    actions: [
-                        { target: 'wiki', type: 'created', key: 'wiki/global/revenue.md', detail: 'Revenue overview' },
-                        { target: 'sl', type: 'updated', key: 'warehouse.orders', detail: 'Added order amount measure' },
-                    ],
-                    touchedSlSources: [{ connectionId: 'warehouse', sourceName: 'orders' }],
-                },
-            ],
-            failedWorkUnits: [],
-            reconciliationSkipped: false,
-            conflictsResolved: [],
-            evictionsApplied: [],
-            unmappedFallbacks: [],
-            evictionInputs: [],
-            unresolvedCards: [],
-            supersededBy: null,
-            overrideOf: null,
-            provenanceRows: [
-                {
-                    rawPath: 'cards/1.json',
-                    artifactKind: 'wiki',
-                    artifactKey: 'wiki/global/revenue.md',
-                    actionType: 'wiki_written',
-                },
-            ],
-            toolTranscripts: [
-                {
-                    unitKey: 'cards',
-                    path: 'tool-transcripts/cards.jsonl',
-                    toolCallCount: 3,
-                    errorCount: 0,
-                    toolNames: ['wiki_capture'],
-                },
-            ],
-            reconciliationActions: [],
-            evictionDecisions: [],
-            context: {
-                documentsIndexed: 2,
-                chunksIndexed: 2,
-                documentsDeleted: 0,
-                embeddingFailures: 0,
-                candidatesCreated: 1,
-                candidatesPromoted: 1,
-                candidatesRejected: 0,
-                knowledgeCreates: 1,
-                knowledgeUpdates: 0,
-                capped: false,
-                warnings: [],
-            },
-        },
-    };
-}
-describe('parseIngestReportSnapshot', () => {
-    it('parses a bundle ingest report snapshot and preserves report detail arrays', () => {
-        const snapshot = parseIngestReportSnapshot(validReportSnapshot());
-        expect(snapshot).toMatchObject({
-            id: 'report-1',
-            runId: 'run-1',
-            jobId: 'job-1',
-            connectionId: 'warehouse',
-            sourceKey: 'metabase',
-            body: {
-                syncId: 'sync-1',
-                commitSha: 'abc12345',
-                failedWorkUnits: [],
-            },
-        });
-        expect(snapshot.body.workUnits[0]?.actions).toEqual([
-            {
-                target: 'wiki',
-                type: 'created',
-                key: 'wiki/global/revenue.md',
-                detail: 'Revenue overview',
-                targetConnectionId: null,
-            },
-            {
-                target: 'sl',
-                type: 'updated',
-                key: 'warehouse.orders',
-                detail: 'Added order amount measure',
-                targetConnectionId: null,
-            },
-        ]);
-        expect(snapshot.body.provenanceRows).toHaveLength(1);
-        expect(snapshot.body.toolTranscripts).toHaveLength(1);
-    });
-    it('parses target-aware actions and touched source objects', () => {
-        const report = validReportSnapshot();
-        report.body.workUnits[0] = {
-            ...report.body.workUnits[0],
-            actions: [
-                {
-                    target: 'sl',
-                    type: 'created',
-                    key: 'looker__b2b__sales_pipeline',
-                    detail: 'Created source',
-                    targetConnectionId: 'warehouse-1',
-                },
-            ],
-            touchedSlSources: [{ connectionId: 'warehouse-1', sourceName: 'looker__b2b__sales_pipeline' }],
-        };
-        const snapshot = parseIngestReportSnapshot(report);
-        expect(snapshot.body.workUnits[0]?.actions).toEqual([
-            {
-                target: 'sl',
-                type: 'created',
-                key: 'looker__b2b__sales_pipeline',
-                detail: 'Created source',
-                targetConnectionId: 'warehouse-1',
-            },
-        ]);
-        expect(snapshot.body.workUnits[0]?.touchedSlSources).toEqual([
-            { connectionId: 'warehouse-1', sourceName: 'looker__b2b__sales_pipeline' },
-        ]);
-    });
-    it('parses captured memory-flow snapshots in report bodies', () => {
-        const report = validReportSnapshot();
-        report.body = {
-            ...report.body,
-            memoryFlow: {
-                metadata: {
-                    schemaVersion: 1,
-                    mode: 'full',
-                    origin: 'captured',
-                    timing: 'captured',
-                    capturedAt: '2026-05-01T10:00:03.000Z',
-                    sourceReportId: null,
-                    sourceReportPath: null,
-                    fallbackReason: null,
-                },
-                runId: 'run-1',
-                connectionId: 'warehouse',
-                adapter: 'lookml',
-                status: 'running',
-                sourceDir: null,
-                syncId: 'sync-2',
-                errors: [],
-                plannedWorkUnits: [],
-                details: { actions: [], provenance: [], transcripts: [] },
-                events: [
-                    {
-                        type: 'source_acquired',
-                        adapter: 'lookml',
-                        trigger: 'manual_resync',
-                        fileCount: 2,
-                        emittedAt: '2026-05-01T10:00:00.000Z',
-                    },
-                ],
-            },
-        };
-        expect(parseIngestReportSnapshot(report).body.memoryFlow?.events).toEqual([
-            {
-                type: 'source_acquired',
-                adapter: 'lookml',
-                trigger: 'manual_resync',
-                fileCount: 2,
-                emittedAt: '2026-05-01T10:00:00.000Z',
-            },
-        ]);
-    });
-    it('applies defaults for optional report fields emitted by older reports', () => {
-        const report = validReportSnapshot();
-        delete report.body.conflictsResolved;
-        delete report.body.evictionsApplied;
-        delete report.body.unmappedFallbacks;
-        delete report.body.supersededBy;
-        delete report.body.overrideOf;
-        delete report.body.provenanceRows;
-        delete report.body.toolTranscripts;
-        const snapshot = parseIngestReportSnapshot(report);
-        expect(snapshot.body.conflictsResolved).toEqual([]);
-        expect(snapshot.body.evictionsApplied).toEqual([]);
-        expect(snapshot.body.unmappedFallbacks).toEqual([]);
-        expect(snapshot.body.supersededBy).toBeNull();
-        expect(snapshot.body.overrideOf).toBeNull();
-        expect(snapshot.body.provenanceRows).toEqual([]);
-        expect(snapshot.body.toolTranscripts).toEqual([]);
-    });
-    it('parses failed ingest reports with trace and failure details', () => {
-        const snapshot = parseIngestReportSnapshot({
-            id: 'report-failed',
-            runId: 'run-failed',
-            jobId: 'job-failed',
-            connectionId: 'warehouse',
-            sourceKey: 'metabase',
-            createdAt: '2026-05-17T12:00:00.000Z',
-            body: {
-                status: 'failed',
-                syncId: 'sync-failed',
-                diffSummary: { added: 1, modified: 0, deleted: 0, unchanged: 0 },
-                commitSha: null,
-                tracePath: '/project/.ktx/ingest-traces/job-failed/trace.jsonl',
-                failure: {
-                    phase: 'final_gates',
-                    message: 'final artifact gates failed',
-                },
-                workUnits: [],
-                failedWorkUnits: [],
-                reconciliationSkipped: true,
-                conflictsResolved: [],
-                evictionsApplied: [],
-                unmappedFallbacks: [],
-                evictionInputs: [],
-                unresolvedCards: [],
-                supersededBy: null,
-                overrideOf: null,
-                provenanceRows: [],
-                toolTranscripts: [],
-            },
-        });
-        expect(snapshot.body.status).toBe('failed');
-        expect(snapshot.body.failure).toEqual({
-            phase: 'final_gates',
-            message: 'final artifact gates failed',
-        });
-        expect(snapshot.body.tracePath).toContain('trace.jsonl');
-    });
-    it('rejects malformed report snapshots with a concise message', () => {
-        const report = validReportSnapshot();
-        report.body.workUnits[0] = {
-            ...report.body.workUnits[0],
-            actions: [{ target: 'database', type: 'created', key: 'bad', detail: 'bad target' }],
-        };
-        expect(() => parseIngestReportSnapshot(report)).toThrow('Invalid ingest report snapshot');
-    });
-    it('parses isolated-diff textual resolver counters', () => {
-        const snapshot = parseIngestReportSnapshot({
-            id: 'report-1',
-            runId: 'run-1',
-            jobId: 'job-1',
-            connectionId: 'warehouse',
-            sourceKey: 'metabase',
-            createdAt: '2026-05-18T00:00:00.000Z',
-            body: {
-                status: 'completed',
-                syncId: 'sync-1',
-                diffSummary: { added: 0, modified: 1, deleted: 0, unchanged: 0 },
-                commitSha: 'abc123',
-                isolatedDiff: {
-                    enabled: true,
-                    acceptedPatches: 2,
-                    textualConflicts: 1,
-                    semanticConflicts: 0,
-                    resolverAttempts: 1,
-                    resolverRepairs: 1,
-                    resolverFailures: 0,
-                },
-                workUnits: [],
-                failedWorkUnits: [],
-                reconciliationSkipped: true,
-                conflictsResolved: [],
-                evictionsApplied: [],
-                unmappedFallbacks: [],
-                artifactResolutions: [],
-                evictionInputs: [],
-                unresolvedCards: [],
-                supersededBy: null,
-                overrideOf: null,
-                provenanceRows: [],
-                toolTranscripts: [],
-            },
-        });
-        expect(snapshot.body.isolatedDiff).toMatchObject({
-            resolverAttempts: 1,
-            resolverRepairs: 1,
-            resolverFailures: 0,
-        });
-    });
-    it('parses isolated-diff gate repair counters', () => {
-        const snapshot = parseIngestReportSnapshot({
-            id: 'report-1',
-            runId: 'run-1',
-            jobId: 'job-1',
-            connectionId: 'warehouse',
-            sourceKey: 'metabase',
-            createdAt: '2026-05-18T00:00:00.000Z',
-            body: {
-                status: 'completed',
-                syncId: 'sync-1',
-                diffSummary: { added: 1, modified: 0, deleted: 0, unchanged: 0 },
-                commitSha: 'abc123',
-                isolatedDiff: {
-                    enabled: true,
-                    acceptedPatches: 1,
-                    textualConflicts: 0,
-                    semanticConflicts: 1,
-                    gateRepairAttempts: 1,
-                    gateRepairs: 1,
-                    gateRepairFailures: 0,
-                },
-                workUnits: [],
-                failedWorkUnits: [],
-                reconciliationSkipped: true,
-                conflictsResolved: [],
-                evictionsApplied: [],
-                unmappedFallbacks: [],
-                evictionInputs: [],
-                unresolvedCards: [],
-                supersededBy: null,
-                overrideOf: null,
-                provenanceRows: [],
-                toolTranscripts: [],
-            },
-        });
-        expect(snapshot.body.isolatedDiff).toMatchObject({
-            gateRepairAttempts: 1,
-            gateRepairs: 1,
-            gateRepairFailures: 0,
-        });
-    });
-});

package/node_modules/@ktx/context/dist/ingest/reports.d.ts

@@ -1,120 +0,0 @@
-import type { MemoryAction } from '../memory/index.js';
-import type { TouchedSlSource } from '../tools/index.js';
-import type { MemoryFlowReplayInput } from './memory-flow/types.js';
-import type { IngestProvenanceInsert } from './ports.js';
-import type { ArtifactResolutionRecord, ConflictResolvedRecord, EvictionAppliedRecord, StageIndex, UnmappedFallbackRecord } from './stages/stage-index.types.js';
-import type { WikiSlRefRepair } from './wiki-sl-ref-repair.js';
-import type { IngestDiffSummary, SourceFetchReport, UnresolvedCardInfo } from './types.js';
-export interface IngestReportWorkUnit {
-    unitKey: string;
-    rawFiles: string[];
-    status: 'success' | 'failed';
-    reason?: string;
-    actions: MemoryAction[];
-    touchedSlSources: TouchedSlSource[];
-    slDisallowed?: boolean;
-    slDisallowedReason?: 'lookml_connection_mismatch';
-}
-export interface IngestReportProvenanceDetail {
-    rawPath: string;
-    artifactKind: 'sl' | 'wiki' | null;
-    artifactKey: string | null;
-    targetConnectionId?: string | null;
-    actionType: IngestProvenanceInsert['actionType'];
-}
-export interface IngestReportToolTranscriptSummary {
-    unitKey: string;
-    path: string;
-    toolCallCount: number;
-    errorCount: number;
-    toolNames: string[];
-}
-export interface IngestReportFinalizationMismatch {
-    artifactKind: 'sl' | 'wiki';
-    key: string;
-    direction: 'missing_from_adapter_declaration' | 'extra_in_adapter_declaration';
-}
-export interface IngestReportFinalizationProvenanceExclusion {
-    action: MemoryAction;
-    reason: 'missing_raw_paths' | 'raw_path_not_defensible';
-    invalidRawPaths?: string[];
-}
-export interface IngestReportFinalizationOutcome {
-    sourceKey: string;
-    status: 'success' | 'failed' | 'skipped';
-    commitSha: string | null;
-    touchedPaths: string[];
-    declaredTouchedSources: TouchedSlSource[];
-    derivedTouchedSources: TouchedSlSource[];
-    declaredChangedWikiPageKeys: string[];
-    derivedChangedWikiPageKeys: string[];
-    mismatches: IngestReportFinalizationMismatch[];
-    result?: unknown;
-    errors: string[];
-    warnings: string[];
-    actions: MemoryAction[];
-    provenanceExclusions: IngestReportFinalizationProvenanceExclusion[];
-}
-export interface IngestReportFailure {
-    phase: string;
-    message: string;
-    details?: Record<string, unknown>;
-}
-export interface IngestReportBody {
-    status?: 'completed' | 'failed';
-    syncId: string;
-    diffSummary: IngestDiffSummary;
-    fetch?: SourceFetchReport;
-    commitSha: string | null;
-    tracePath?: string;
-    failure?: IngestReportFailure;
-    isolatedDiff?: {
-        enabled: boolean;
-        integrationWorktreePath?: string;
-        ingestionBaseSha?: string;
-        projectionSha?: string | null;
-        acceptedPatches: number;
-        textualConflicts: number;
-        semanticConflicts: number;
-        resolverAttempts?: number;
-        resolverRepairs?: number;
-        resolverFailures?: number;
-        gateRepairAttempts?: number;
-        gateRepairs?: number;
-        gateRepairFailures?: number;
-    };
-    workUnits: IngestReportWorkUnit[];
-    failedWorkUnits: string[];
-    reconciliationSkipped: boolean;
-    reconciliationActions?: MemoryAction[];
-    conflictsResolved: ConflictResolvedRecord[];
-    evictionsApplied: EvictionAppliedRecord[];
-    unmappedFallbacks: UnmappedFallbackRecord[];
-    artifactResolutions?: ArtifactResolutionRecord[];
-    evictionInputs: string[];
-    unresolvedCards: UnresolvedCardInfo[];
-    supersededBy: string | null;
-    overrideOf: string | null;
-    provenanceRows: IngestReportProvenanceDetail[];
-    toolTranscripts: IngestReportToolTranscriptSummary[];
-    finalization?: IngestReportFinalizationOutcome;
-    wikiSlRefRepairs?: WikiSlRefRepair[];
-    wikiSlRefRepairWarnings?: string[];
-    memoryFlow?: MemoryFlowReplayInput;
-}
-export interface IngestReportSnapshot {
-    id: string;
-    runId: string;
-    jobId: string;
-    connectionId: string;
-    sourceKey: string;
-    body: IngestReportBody;
-    createdAt: string;
-}
-export interface IngestSavedMemoryCounts {
-    wikiCount: number;
-    slCount: number;
-}
-export declare function finalizationSavedMemoryCounts(finalization: IngestReportFinalizationOutcome | undefined): IngestSavedMemoryCounts;
-export declare function savedMemoryCountsForReport(report: IngestReportSnapshot): IngestSavedMemoryCounts;
-export declare function buildStageIndexFromReportBody(jobId: string, connectionId: string, body: IngestReportBody): StageIndex;

package/node_modules/@ktx/context/dist/ingest/reports.js

@@ -1,37 +0,0 @@
-export function finalizationSavedMemoryCounts(finalization) {
-    const actions = finalization?.actions ?? [];
-    return {
-        wikiCount: actions.filter((action) => action.target === 'wiki').length,
-        slCount: actions.filter((action) => action.target === 'sl').length,
-    };
-}
-export function savedMemoryCountsForReport(report) {
-    const workUnitActions = report.body.workUnits.flatMap((workUnit) => workUnit.actions);
-    const reconciliationActions = report.body.reconciliationActions ?? [];
-    const finalizationActions = report.body.finalization?.actions ?? [];
-    const actions = [...workUnitActions, ...reconciliationActions, ...finalizationActions];
-    return {
-        wikiCount: actions.filter((action) => action.target === 'wiki').length,
-        slCount: actions.filter((action) => action.target === 'sl').length,
-    };
-}
-export function buildStageIndexFromReportBody(jobId, connectionId, body) {
-    return {
-        jobId,
-        connectionId,
-        workUnits: body.workUnits.map((wu) => ({
-            unitKey: wu.unitKey,
-            rawFiles: wu.rawFiles,
-            status: wu.status,
-            reason: wu.reason,
-            actions: wu.actions,
-            touchedSlSources: wu.touchedSlSources,
-            slDisallowed: wu.slDisallowed,
-            slDisallowedReason: wu.slDisallowedReason,
-        })),
-        conflictsResolved: [],
-        evictionsApplied: [],
-        unmappedFallbacks: [],
-        artifactResolutions: body.artifactResolutions ?? [],
-    };
-}

package/node_modules/@ktx/context/dist/ingest/semantic-layer-target-policy.d.ts

@@ -1,11 +0,0 @@
-export interface SemanticLayerTargetPolicyInput {
-    paths: readonly string[];
-    allowedConnectionIds: ReadonlySet<string>;
-}
-export interface SemanticLayerTargetPolicyViolation {
-    path: string;
-    connectionId: string;
-}
-export declare function semanticLayerConnectionIdFromPath(path: string): string | null;
-export declare function findDisallowedSemanticLayerTargetPaths(input: SemanticLayerTargetPolicyInput): SemanticLayerTargetPolicyViolation[];
-export declare function assertSemanticLayerTargetPathsAllowed(input: SemanticLayerTargetPolicyInput): void;

package/node_modules/@ktx/context/dist/ingest/semantic-layer-target-policy.js

@@ -1,26 +0,0 @@
-export function semanticLayerConnectionIdFromPath(path) {
-    const normalized = path.replace(/^[ab]\//, '');
-    const match = /^semantic-layer\/([^/]+)\//.exec(normalized);
-    return match?.[1] ?? null;
-}
-export function findDisallowedSemanticLayerTargetPaths(input) {
-    return input.paths
-        .map((path) => ({ path, connectionId: semanticLayerConnectionIdFromPath(path) }))
-        .filter((entry) => {
-        return entry.connectionId !== null && !input.allowedConnectionIds.has(entry.connectionId);
-    })
-        .sort((left, right) => {
-        const byConnection = left.connectionId.localeCompare(right.connectionId);
-        return byConnection === 0 ? left.path.localeCompare(right.path) : byConnection;
-    });
-}
-export function assertSemanticLayerTargetPathsAllowed(input) {
-    const violations = findDisallowedSemanticLayerTargetPaths(input);
-    if (violations.length === 0) {
-        return;
-    }
-    const allowed = [...input.allowedConnectionIds].sort();
-    throw new Error(`semantic-layer target connection not allowed: ${violations
-        .map((violation) => `${violation.path} (${violation.connectionId})`)
-        .join(', ')}; allowed: ${allowed.length > 0 ? allowed.join(', ') : '(none)'}`);
-}

package/node_modules/@ktx/context/dist/ingest/semantic-layer-target-policy.test.d.ts

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

package/node_modules/@ktx/context/dist/ingest/semantic-layer-target-policy.test.js

@@ -1,25 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { assertSemanticLayerTargetPathsAllowed, findDisallowedSemanticLayerTargetPaths, semanticLayerConnectionIdFromPath, } from './semantic-layer-target-policy.js';
-describe('semantic-layer target policy', () => {
-    it('extracts connection ids from semantic-layer paths', () => {
-        expect(semanticLayerConnectionIdFromPath('semantic-layer/warehouse/orders.yaml')).toBe('warehouse');
-        expect(semanticLayerConnectionIdFromPath('a/semantic-layer/finance/orders.yaml')).toBe('finance');
-        expect(semanticLayerConnectionIdFromPath('wiki/global/orders.md')).toBeNull();
-    });
-    it('finds semantic-layer paths outside the allowed target connections', () => {
-        expect(findDisallowedSemanticLayerTargetPaths({
-            paths: [
-                'semantic-layer/warehouse/orders.yaml',
-                'semantic-layer/finance/orders.yaml',
-                'wiki/global/orders.md',
-            ],
-            allowedConnectionIds: new Set(['warehouse']),
-        })).toEqual([{ path: 'semantic-layer/finance/orders.yaml', connectionId: 'finance' }]);
-    });
-    it('throws a deterministic error for unauthorized semantic-layer targets', () => {
-        expect(() => assertSemanticLayerTargetPathsAllowed({
-            paths: ['semantic-layer/finance/orders.yaml', 'semantic-layer/marketing/accounts.yaml'],
-            allowedConnectionIds: new Set(['warehouse']),
-        })).toThrow(/semantic-layer target connection not allowed: semantic-layer\/finance\/orders\.yaml \(finance\), semantic-layer\/marketing\/accounts\.yaml \(marketing\); allowed: warehouse/);
-    });
-});

package/node_modules/@ktx/context/dist/ingest/source-adapter-registry.test.d.ts

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

package/node_modules/@ktx/context/dist/ingest/source-adapter-registry.test.js

@@ -1,35 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { SourceAdapterRegistry } from './source-adapter-registry.js';
-const makeAdapter = (source) => ({
-    source,
-    skillNames: [],
-    detect() {
-        return Promise.resolve(true);
-    },
-    chunk() {
-        return Promise.resolve({ workUnits: [] });
-    },
-});
-describe('SourceAdapterRegistry', () => {
-    it('returns a registered adapter by sourceKey', () => {
-        const registry = new SourceAdapterRegistry();
-        const fake = makeAdapter('fake');
-        registry.register(fake);
-        expect(registry.get('fake')).toBe(fake);
-    });
-    it('throws for an unknown sourceKey', () => {
-        const registry = new SourceAdapterRegistry();
-        expect(() => registry.get('missing')).toThrow(/no source adapter registered for 'missing'/);
-    });
-    it('throws when a sourceKey is registered twice', () => {
-        const registry = new SourceAdapterRegistry();
-        registry.register(makeAdapter('fake'));
-        expect(() => registry.register(makeAdapter('fake'))).toThrow(/already registered/);
-    });
-    it('has returns true only after registration', () => {
-        const registry = new SourceAdapterRegistry();
-        expect(registry.has('fake')).toBe(false);
-        registry.register(makeAdapter('fake'));
-        expect(registry.has('fake')).toBe(true);
-    });
-});

package/node_modules/@ktx/context/dist/ingest/sqlite-bundle-ingest-store.test.d.ts

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