mirror of
https://github.com/Kaelio/ktx.git
synced 2026-06-07 07:55:13 +02:00
d320d54ab2
* feat(completion): complete known argument values
* fix(completion): hide Commander-hidden subcommands from completions
Replace the `__`-prefix name heuristic with Commander's `_hidden` flag so
internal subcommands registered with { hidden: true } (e.g. `mcp serve-internal`)
are excluded from completions, mirroring `ktx --help`.
* test: cover wiki and sl read command routing
* test: cover raw wiki and sl reads
* feat: add wiki read command
* feat: add sl read command
* feat: complete read command entity names
* docs: document wiki and sl read commands
* test: include read commands in command tree
* feat(sl): read and validate unique sources by name
* feat(sl): make read and validate connection id optional
* fix(completion): dedupe semantic source names
* docs(sl): document connection-optional read and validate
* fix(sl): require connection id for query command
* docs(sl): clarify query connection requirement
* fix(completion): don't resolve option values as subcommands
resolveCommand skipped flag tokens but not the value consumed by a
value-taking option in the `--flag value` form, so a connection id like
`query` was matched as the `sl query` subcommand and yielded no `sl`
completions. Track value-taking options and skip their consumed value
before matching subcommands.
* test(telemetry): assert first-run notice via TELEMETRY_NOTICE constant
CI (which tests this branch merged with main) failed because #243 changed
the first-run notice wording in identity.ts (dropped "anonymous") but left
this test grepping for the old literal 'ktx collects anonymous usage data',
so indexOf returned -1. Assert against the exported TELEMETRY_NOTICE
constant instead so the test tracks the source of truth and cannot drift
when the notice text changes again.
51 lines
2.4 KiB
TypeScript
51 lines
2.4 KiB
TypeScript
import { describe, expect, it } from 'vitest';
|
|
import { renderKtxCommandTree } from '../src/print-command-tree.js';
|
|
|
|
describe('renderKtxCommandTree', () => {
|
|
it('renders an indented tree rooted at "ktx" with known top-level commands', () => {
|
|
const output = renderKtxCommandTree();
|
|
|
|
const lines = output.split('\n');
|
|
expect(lines[0]).toMatch(/^ktx( |$)/);
|
|
|
|
const topLevel = lines
|
|
.filter((line) => /^ {2}[├└]── \S/.test(line))
|
|
.map((line) => line.replace(/^ {2}[├└]── /, '').trim().split(' ')[0]);
|
|
|
|
for (const expected of ['setup', 'connection', 'ingest', 'sl', 'mcp', 'admin', 'completion']) {
|
|
expect(topLevel).toContain(expected);
|
|
}
|
|
|
|
// The internal completion helper is hidden and must not appear in the tree.
|
|
expect(topLevel).not.toContain('__complete');
|
|
expect(output).not.toContain('__complete');
|
|
|
|
expect(output).toContain('│ └── test [connectionId]');
|
|
expect(output).toContain('│ ├── status Show KTX MCP daemon status');
|
|
expect(output).not.toContain('│ ├── add');
|
|
expect(output).not.toContain('│ ├── remove');
|
|
expect(output).not.toContain('│ ├── map');
|
|
expect(output).not.toContain('│ ├── mapping');
|
|
expect(output).not.toContain('│ ├── metabase');
|
|
expect(output).not.toContain('│ ├── notion');
|
|
expect(output).not.toContain('scan <connectionId>');
|
|
expect(output).not.toContain('│ ├── replay');
|
|
expect(output).not.toContain('│ └── replay');
|
|
// Match `run` as a whole command name, not the `run` prefix of `runtime`.
|
|
expect(output).not.toMatch(/[├└]── run(\s|$)/m);
|
|
expect(output).not.toContain('│ ├── watch');
|
|
expect(output).not.toContain('│ └── watch');
|
|
expect(output).toContain('│ └── read <key> Read a wiki page file by key');
|
|
expect(output).toContain(
|
|
'│ ├── read <sourceName> Read a semantic-layer source YAML file',
|
|
);
|
|
expect(output).not.toContain('│ ├── write');
|
|
expect(output).not.toContain('│ └── write');
|
|
});
|
|
|
|
it('ends with a single trailing newline', () => {
|
|
const output = renderKtxCommandTree();
|
|
expect(output.endsWith('\n')).toBe(true);
|
|
expect(output.endsWith('\n\n')).toBe(false);
|
|
});
|
|
});
|