mirror of
https://github.com/Kaelio/ktx.git
synced 2026-06-10 08:05:14 +02:00
2c9a58bb56
Bare invocations now do the obvious thing instead of erroring out, and mode-as-subcommand patterns collapse into flags on the parent. No new top-level commands. - `ktx ingest` (bare) ingests every configured connection. The `text` subcommand is gone; capture inline notes with `ktx ingest --text "..."` and files with `ktx ingest --file path` (use `-` for stdin). `--text`/`--file` reject a positional connection id; pass `--connection-id` to tag captured notes. - `ktx connection` (bare) lists; `ktx connection test` (bare) tests every configured connection. - `ktx wiki` and `ktx sl` flatten `list`/`search`: bare lists, with a `[query...]` positional searches (multi-word joined with spaces). `sl validate` and `sl query` stay as distinct verbs and now read `--connection-id` from the parent. - `ktx mcp` (bare) prints daemon status. Adds a shared `resolveConnectionSelection` helper consumed by ingest and connection test. Updates README, docs-site cli-reference and guides, next-steps strings, agent SKILL templates, and all affected tests. Per-package type-check, unit tests (605), smoke tests, and dead-code checks all pass.
92 lines
3.2 KiB
TypeScript
92 lines
3.2 KiB
TypeScript
import { describe, expect, it } from 'vitest';
|
|
import {
|
|
KTX_CONTEXT_BUILD_COMMANDS,
|
|
KTX_NEXT_STEP_COMMANDS,
|
|
formatNextStepLines,
|
|
formatSetupNextStepLines,
|
|
} from './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('Build KTX context next.');
|
|
expect(rendered).toContain('Run ingest to build database schema context before context-source ingest.');
|
|
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('Build KTX context next.');
|
|
});
|
|
});
|