@kaelio/ktx 0.5.0 → 0.6.0

package/dist/context/ingest/ingest-prompts.test.d.ts

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

package/dist/context/ingest/ingest-prompts.test.js

@@ -1,32 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { describe, expect, it } from 'vitest';
-function forbiddenProductPattern() {
-    return new RegExp([['Kae', 'lio'].join(''), ['kae', 'lio'].join(''), ['KAE', 'LIO_'].join('')].join('|'));
-}
-describe('ingest prompt assets', () => {
-    it('teaches WorkUnit agents to apply canonical pins before writing contested artifacts', async () => {
-        const prompt = await readFile(new URL('../../prompts/memory_agent_bundle_ingest_work_unit.md', import.meta.url), 'utf-8');
-        expect(prompt).toContain('<canonical_pins>');
-        expect(prompt).toContain('canonicalArtifactKey');
-        expect(prompt).toContain('prefer editing the pinned canonical artifact');
-        expect(prompt).toContain('Do not create a duplicate contested artifact');
-    });
-    it('uses product-neutral KTX runtime wording', async () => {
-        const prompt = await readFile(new URL('../../prompts/memory_agent_bundle_ingest_work_unit.md', import.meta.url), 'utf-8');
-        expect(prompt).toContain('KTX semantic-layer sources and/or knowledge wiki pages');
-        expect(prompt).toContain('maps cleanly to KTX');
-        expect(prompt).not.toMatch(forbiddenProductPattern());
-    });
-    it('uses shipped warehouse verification tools in the WorkUnit prompt', async () => {
-        const prompt = await readFile(new URL('../../prompts/memory_agent_bundle_ingest_work_unit.md', import.meta.url), 'utf-8');
-        expect(prompt).toContain('discover_data');
-        expect(prompt).toContain('entity_details');
-        expect(prompt).not.toContain('wiki_sl_search');
-        expect(prompt).not.toContain('sl_describe_table');
-    });
-    it('does not route historic-SQL through page-triage prompt examples', async () => {
-        const prompt = await readFile(new URL('../../prompts/skills/page_triage_classifier.md', import.meta.url), 'utf-8');
-        expect(prompt).not.toContain(['historic_sql', 'template'].join('_'));
-        expect(prompt).not.toContain('service_account_only=true AND below the frequency floor');
-    });
-});

package/dist/context/ingest/ingest-runtime-assets.test.d.ts

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

package/dist/context/ingest/ingest-runtime-assets.test.js

@@ -1,89 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { describe, expect, it } from 'vitest';
-import { PromptService } from '../../context/prompts/prompt.service.js';
-import { SkillsRegistryService } from '../../context/skills/skills-registry.service.js';
-const promptsDir = fileURLToPath(new URL('../../prompts', import.meta.url));
-const skillsDir = fileURLToPath(new URL('../../skills', import.meta.url));
-const adapterSkillNames = [
-    'live_database_ingest',
-    'lookml_ingest',
-    'metabase_ingest',
-    'metricflow_ingest',
-    'notion_synthesize',
-    'historic_sql_table_digest',
-    'historic_sql_patterns',
-    'ingest_triage',
-    'wiki_capture',
-    'sl_capture',
-];
-const adapterReconcileSkillNames = [
-    'ingest_triage',
-    'wiki_capture',
-    'sl_capture',
-];
-const pageTriagePromptNames = ['skills/page_triage_classifier', 'skills/light_extraction'];
-function forbiddenProductPattern() {
-    return new RegExp([['Kae', 'lio'].join(''), ['kae', 'lio'].join(''), ['KAE', 'LIO_'].join('')].join('|'));
-}
-describe('ingest runtime assets', () => {
-    it('resolves every reusable ingest skill from packaged KTX assets without server fallback', async () => {
-        const registry = new SkillsRegistryService({ skillsDir });
-        const expected = [...new Set([...adapterSkillNames, ...adapterReconcileSkillNames])].sort();
-        const skills = await registry.listSkills(expected, 'memory_agent');
-        expect(skills.map((skill) => skill.name).sort()).toEqual(expected);
-        for (const skill of skills) {
-            expect(skill.path.startsWith(skillsDir)).toBe(true);
-            const body = await readFile(join(skill.path, 'SKILL.md'), 'utf-8');
-            expect(body).not.toMatch(forbiddenProductPattern());
-        }
-    });
-    it('loads page-triage and light-extraction prompts from packaged KTX prompt assets', async () => {
-        const prompts = new PromptService({ promptsDir, partials: [] });
-        for (const promptName of pageTriagePromptNames) {
-            const prompt = await prompts.loadPrompt(promptName);
-            expect(prompt.trim().length).toBeGreaterThan(100);
-            expect(prompt).not.toMatch(forbiddenProductPattern());
-        }
-        await expect(prompts.loadPrompt('skills/page_triage_classifier')).resolves.toContain('# Page Triage Classifier');
-        await expect(prompts.loadPrompt('skills/light_extraction')).resolves.toContain('# Light Context Extraction');
-    });
-    it('packages historic-SQL table digest guidance from KTX assets', async () => {
-        const registry = new SkillsRegistryService({ skillsDir });
-        const skills = await registry.listSkills(['historic_sql_table_digest'], 'memory_agent');
-        expect(skills.map((skill) => skill.name)).toEqual(['historic_sql_table_digest']);
-        const body = await readFile(join(skills[0].path, 'SKILL.md'), 'utf-8');
-        expect(body).toContain('# Historic SQL Table Digest');
-        expect(body).toContain('tables/<schema>.<name>.json');
-        expect(body).toContain('tableUsageOutputSchema');
-        expect(body).toContain('emit_historic_sql_evidence');
-        expect(body).toContain('Do not call wiki_write');
-        expect(body).toContain('Do not call sl_write_source');
-        expect(body).not.toMatch(forbiddenProductPattern());
-    });
-    it('packages historic-SQL patterns guidance from KTX assets', async () => {
-        const registry = new SkillsRegistryService({ skillsDir });
-        const skills = await registry.listSkills(['historic_sql_patterns'], 'memory_agent');
-        expect(skills.map((skill) => skill.name)).toEqual(['historic_sql_patterns']);
-        const body = await readFile(join(skills[0].path, 'SKILL.md'), 'utf-8');
-        expect(body).toContain('# Historic SQL Patterns');
-        expect(body).toContain('patterns-input/part-0001.json');
-        expect(body).toContain('patternsArraySchema');
-        expect(body).toContain('emit_historic_sql_evidence');
-        expect(body).toContain('cross-table');
-        expect(body).not.toMatch(forbiddenProductPattern());
-    });
-    it('packages identifier verification prompt assets', async () => {
-        const shared = await readFile(join(skillsDir, '_shared', 'identifier-verification.md'), 'utf-8');
-        const legacyConnectionPrefix = ['connection', 'Name'].join('');
-        expect(shared).toContain('## Identifier Verification Protocol');
-        expect(shared).toContain('discover_data');
-        expect(shared).toContain('entity_details');
-        expect(shared).toContain('sql_execution');
-        expect(shared).toContain('sql_execution({connectionId, sql: "SELECT DISTINCT');
-        expect(shared).toContain('sql_execution({connectionId, sql: "SELECT 1 FROM');
-        expect(shared).not.toContain(`entity_details({${legacyConnectionPrefix}`);
-        expect(shared).not.toContain(`sql_execution({${legacyConnectionPrefix}`);
-    });
-});

package/dist/context/ingest/ingest-trace.test.d.ts

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

package/dist/context/ingest/ingest-trace.test.js

@@ -1,76 +0,0 @@
-import { mkdtemp, readFile } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { describe, expect, it, vi } from 'vitest';
-import { FileIngestTraceWriter, ingestTracePathForJob, traceTimed } from './ingest-trace.js';
-describe('FileIngestTraceWriter', () => {
-    it('persists structured trace events as JSONL', async () => {
-        const root = await mkdtemp(join(tmpdir(), 'ktx-trace-'));
-        const tracePath = ingestTracePathForJob(root, 'job-1');
-        const trace = new FileIngestTraceWriter({
-            tracePath,
-            jobId: 'job-1',
-            connectionId: 'metabase-main',
-            sourceKey: 'metabase',
-            level: 'debug',
-        });
-        await trace.event('debug', 'snapshot', 'input_snapshot', {
-            baseSha: 'abc123',
-            rawFileCount: 2,
-            diffSummary: { added: 1, modified: 1, deleted: 0, unchanged: 3 },
-        });
-        const lines = (await readFile(tracePath, 'utf-8'))
-            .trim()
-            .split('\n')
-            .map((line) => JSON.parse(line));
-        expect(lines).toHaveLength(1);
-        expect(lines[0]).toMatchObject({
-            schemaVersion: 1,
-            jobId: 'job-1',
-            connectionId: 'metabase-main',
-            sourceKey: 'metabase',
-            level: 'debug',
-            phase: 'snapshot',
-            event: 'input_snapshot',
-            data: {
-                baseSha: 'abc123',
-                rawFileCount: 2,
-                diffSummary: { added: 1, modified: 1, deleted: 0, unchanged: 3 },
-            },
-        });
-        expect(typeof lines[0].at).toBe('string');
-    });
-    it('records timing and error context for postmortem inspection', async () => {
-        vi.useFakeTimers();
-        vi.setSystemTime(new Date('2026-05-17T12:00:00.000Z'));
-        const root = await mkdtemp(join(tmpdir(), 'ktx-trace-'));
-        const tracePath = ingestTracePathForJob(root, 'job-2');
-        const trace = new FileIngestTraceWriter({
-            tracePath,
-            jobId: 'job-2',
-            connectionId: 'c1',
-            sourceKey: 'fake',
-            level: 'trace',
-        });
-        await expect(traceTimed(trace, 'integration', 'apply_patch', { unitKey: 'wu-1' }, async () => {
-            vi.advanceTimersByTime(17);
-            throw new Error('patch conflict');
-        })).rejects.toThrow('patch conflict');
-        const lines = (await readFile(tracePath, 'utf-8'))
-            .trim()
-            .split('\n')
-            .map((line) => JSON.parse(line));
-        expect(lines.map((line) => line.event)).toEqual(['apply_patch_started', 'apply_patch_failed']);
-        expect(lines[1]).toMatchObject({
-            level: 'error',
-            phase: 'integration',
-            data: { unitKey: 'wu-1' },
-            error: { name: 'Error', message: 'patch conflict' },
-        });
-        expect(lines[1].durationMs).toBe(17);
-        vi.useRealTimers();
-    });
-    it('uses the documented trace path layout', () => {
-        expect(ingestTracePathForJob('/project/.ktx', 'job-3')).toBe('/project/.ktx/ingest-traces/job-3/trace.jsonl');
-    });
-});

package/dist/context/ingest/isolated-diff/git-patch.test.d.ts

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

package/dist/context/ingest/isolated-diff/git-patch.test.js

@@ -1,76 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { assertPatchAllowedForWorkUnit, parsePatchTouchedPaths, textArtifactRoots } from './git-patch.js';
-describe('isolated diff patch contract', () => {
-    it('parses touched paths from no-rename git patches', () => {
-        const patch = [
-            'diff --git a/wiki/global/a.md b/wiki/global/a.md',
-            'index 1111111..2222222 100644',
-            '--- a/wiki/global/a.md',
-            '+++ b/wiki/global/a.md',
-            '@@ -1 +1 @@',
-            '-old',
-            '+new',
-            'diff --git a/semantic-layer/c1/orders.yaml b/semantic-layer/c1/orders.yaml',
-            'new file mode 100644',
-            '--- /dev/null',
-            '+++ b/semantic-layer/c1/orders.yaml',
-            '@@ -0,0 +1 @@',
-            '+name: orders',
-            '',
-        ].join('\n');
-        expect(parsePatchTouchedPaths(patch)).toEqual([
-            {
-                path: 'wiki/global/a.md',
-                oldPath: 'wiki/global/a.md',
-                newPath: 'wiki/global/a.md',
-                mode: '100644',
-                binary: false,
-            },
-            {
-                path: 'semantic-layer/c1/orders.yaml',
-                oldPath: 'semantic-layer/c1/orders.yaml',
-                newPath: 'semantic-layer/c1/orders.yaml',
-                mode: '100644',
-                binary: false,
-            },
-        ]);
-    });
-    it('rejects semantic-layer paths for slDisallowed work units', () => {
-        const patch = 'diff --git a/semantic-layer/c1/orders.yaml b/semantic-layer/c1/orders.yaml\nindex 1..2 100644\n';
-        expect(() => assertPatchAllowedForWorkUnit({
-            unitKey: 'lookml-mismatch',
-            patch,
-            slDisallowed: true,
-        })).toThrow(/slDisallowed WorkUnit lookml-mismatch touched semantic-layer\/c1\/orders.yaml/);
-    });
-    it('rejects semantic-layer paths outside allowed target connections', () => {
-        const patch = 'diff --git a/semantic-layer/finance/orders.yaml b/semantic-layer/finance/orders.yaml\nindex 1..2 100644\n';
-        expect(() => assertPatchAllowedForWorkUnit({
-            unitKey: 'wu-finance',
-            patch,
-            slDisallowed: false,
-            allowedTargetConnectionIds: new Set(['warehouse']),
-        })).toThrow(/semantic-layer target connection not allowed: semantic-layer\/finance\/orders.yaml \(finance\); allowed: warehouse/);
-    });
-    it('rejects executable and binary changes under known text artifact roots', () => {
-        expect(textArtifactRoots).toEqual(['wiki/', 'semantic-layer/']);
-        const executablePatch = 'diff --git a/wiki/global/a.md b/wiki/global/a.md\nold mode 100644\nnew mode 100755\nindex 1..2\n';
-        expect(() => assertPatchAllowedForWorkUnit({
-            unitKey: 'wu-1',
-            patch: executablePatch,
-            slDisallowed: false,
-        })).toThrow(/unexpected executable mode under wiki\/global\/a.md/);
-        const binaryPatch = [
-            'diff --git a/semantic-layer/c1/orders.yaml b/semantic-layer/c1/orders.yaml',
-            'index 1111111..2222222 100644',
-            'GIT binary patch',
-            'literal 0',
-            '',
-        ].join('\n');
-        expect(() => assertPatchAllowedForWorkUnit({
-            unitKey: 'wu-2',
-            patch: binaryPatch,
-            slDisallowed: false,
-        })).toThrow(/unexpected binary patch under semantic-layer\/c1\/orders.yaml/);
-    });
-});

package/dist/context/ingest/isolated-diff/patch-integrator.test.d.ts

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