mirror of
https://github.com/Kaelio/ktx.git
synced 2026-06-13 08:15:14 +02:00
00cdf2de90
Align the tree with AGENTS.md/CLAUDE.md conventions: - Rewrite user-facing strings, docs, and tests to lowercase `ktx` (no bare uppercase `KTX` tokens remain outside literal identifiers). - Drop the legacy `historicSql` migration path and its now-unused helpers, per the no-backward-compat rule. - Remove `as unknown as` / `any` casts: narrow `BaseTool` generics to `z.ZodObject`, add a typed `createLookerClient`, and delete the dead `getParametersSchema`/`toAnthropicFormat` pre-AI-SDK helpers. - Use `InvalidArgumentError` for Commander parse failures. - Finish the adapter→connector prose conversion in the `ktx.yaml` docs while keeping the literal `adapters` config key.
91 lines
3.1 KiB
TypeScript
91 lines
3.1 KiB
TypeScript
import { describe, expect, it } from 'vitest';
|
|
import {
|
|
KTX_CONTEXT_BUILD_COMMANDS,
|
|
KTX_NEXT_STEP_COMMANDS,
|
|
formatNextStepLines,
|
|
formatSetupNextStepLines,
|
|
} from '../src/next-steps.js';
|
|
|
|
describe('ktx demo next steps', () => {
|
|
it('uses supported context-build commands before agent usage', () => {
|
|
expect(KTX_CONTEXT_BUILD_COMMANDS).toEqual([
|
|
{
|
|
command: 'ktx ingest',
|
|
description: 'Build or refresh agent-ready context from all configured connections',
|
|
},
|
|
{
|
|
command: 'ktx status',
|
|
description: 'Check setup and context readiness',
|
|
},
|
|
]);
|
|
});
|
|
|
|
it('uses supported final public commands', () => {
|
|
expect(KTX_NEXT_STEP_COMMANDS).toEqual([
|
|
{
|
|
command: 'ktx status --json',
|
|
description: 'Verify project setup and context readiness',
|
|
},
|
|
{
|
|
command: 'ktx sl',
|
|
description: 'Inspect generated semantic-layer sources',
|
|
},
|
|
{
|
|
command: 'ktx wiki',
|
|
description: 'Inspect generated wiki pages',
|
|
},
|
|
]);
|
|
});
|
|
|
|
it('uses only the direct CLI route for agent verification', () => {
|
|
const commands = KTX_NEXT_STEP_COMMANDS.map((step) => step.command);
|
|
|
|
expect(commands).not.toContain('ktx agent context --json');
|
|
expect(commands).toContain('ktx status --json');
|
|
expect(commands).not.toContain('ktx serve --mcp stdio --user-id local');
|
|
});
|
|
|
|
it('explains what the next-step commands are for', () => {
|
|
const rendered = formatNextStepLines().join('\n');
|
|
|
|
expect(rendered).toContain('ktx context is ready for agents.');
|
|
expect(rendered).toContain('ktx project directory');
|
|
expect(rendered).toContain('ask a data question');
|
|
expect(rendered).toContain('Verify with:');
|
|
expect(rendered).not.toContain('this directory');
|
|
expect(rendered).not.toContain('Preferred route');
|
|
expect(rendered).not.toContain('Optional MCP:');
|
|
});
|
|
|
|
it('keeps setup next steps focused on building context when the build is not ready', () => {
|
|
const rendered = formatSetupNextStepLines({
|
|
setupReady: true,
|
|
hasContextTargets: true,
|
|
contextReady: false,
|
|
agentIntegrationReady: true,
|
|
}).join('\n');
|
|
|
|
expect(rendered).toContain('Setup is complete. The only step left is to build context for your agents.');
|
|
expect(rendered).toContain('ktx ingest');
|
|
expect(rendered).not.toContain('resume');
|
|
expect(rendered).not.toContain('scan');
|
|
expect(rendered).toContain('ktx status');
|
|
expect(rendered).not.toContain('ktx agent context --json');
|
|
expect(rendered).not.toContain('ktx serve --mcp');
|
|
});
|
|
|
|
it('shows agent commands only after setup and context build are ready', () => {
|
|
const rendered = formatSetupNextStepLines({
|
|
setupReady: true,
|
|
hasContextTargets: true,
|
|
contextReady: true,
|
|
agentIntegrationReady: true,
|
|
}).join('\n');
|
|
|
|
expect(rendered).toContain('ktx context is ready for agents.');
|
|
expect(rendered).toContain('ktx status --json');
|
|
expect(rendered).not.toContain('ktx agent');
|
|
expect(rendered).not.toContain('ktx serve --mcp stdio --user-id local');
|
|
expect(rendered).not.toContain('Setup is complete.');
|
|
});
|
|
});
|