mirror of
https://github.com/Kaelio/ktx.git
synced 2026-06-07 07:55:13 +02:00
b759a4a286
* docs(specs): design research-agent MCP tools and ktx mcp daemon Adds the 2026-05-14 design spec for exposing four new MCP tools (discover_data, entity_details, dictionary_search, sql_execution), shipping a ktx-research skill, and introducing an HTTP-only ktx mcp daemon so external agents can use KTX as a research-capable context layer. * Refine research-agent MCP tools spec after adversarial review iteration 1 * Refine research-agent MCP tools spec after adversarial review iteration 2 * Refine research-agent MCP tools spec after adversarial review iteration 3 * Refine spec: drop connectionName compat carve-out and ground summary/snippet provenance per kind * feat(daemon): validate read-only SQL with sqlglot * feat(context): expose read-only SQL validation port * feat(context): register MCP sql execution tool * feat(context): execute MCP SQL through validated connector path * test(context): update SQL analysis port fixtures * docs: add research-agent MCP sql execution foundation plan * feat(context): add scan-backed entity details service * feat(context): register MCP entity details tool * feat(context): expose local MCP entity details * test(context): align entity details scan fixtures * docs: add research-agent MCP entity_details plan * feat(context): add dictionary search service * feat(context): register MCP dictionary search tool * feat(context): expose local MCP dictionary search * docs: add research-agent MCP dictionary_search plan * feat: add MCP discover data service * feat: expose discover data MCP tool * feat: wire local discover data MCP port * docs: add research-agent MCP discover_data plan * feat(cli): add mcp http security helpers * feat(cli): host mcp over streamable http * feat(cli): manage mcp daemon lifecycle * feat(cli): add ktx mcp commands * fix(cli): stabilize mcp daemon verification * docs: add research-agent MCP http daemon plan * feat(cli): install KTX research skill * feat(cli): configure MCP clients in setup agents * feat(cli): support Claude local MCP setup scope * docs: add research-agent MCP setup-agents plan * refactor(context): use connectionId in warehouse verification tools * docs(context): update ingest verification prompts for connectionId * docs: add research-agent MCP ingest contract convergence plan * chore: build runtime artifacts in conductor setup --------- Co-authored-by: Andrey Avtomonov <7889985+andreybavt@users.noreply.github.com>
53 lines
2.4 KiB
JavaScript
53 lines
2.4 KiB
JavaScript
import assert from 'node:assert/strict';
|
|
import { readFile } from 'node:fs/promises';
|
|
import { describe, it } from 'node:test';
|
|
|
|
async function readText(relativePath) {
|
|
return readFile(new URL(`../${relativePath}`, import.meta.url), 'utf8');
|
|
}
|
|
|
|
describe('Conductor workspace scripts', () => {
|
|
it('registers setup and run scripts in nonconcurrent mode', async () => {
|
|
const manifest = JSON.parse(await readText('conductor.json'));
|
|
|
|
assert.deepEqual(manifest.scripts, {
|
|
setup: 'bash scripts/conductor-setup.sh',
|
|
run: 'bash scripts/conductor-run.sh',
|
|
});
|
|
assert.equal(manifest.runScriptMode, 'nonconcurrent');
|
|
});
|
|
|
|
it('sets up exact uv, local files, Python packages, JS packages, and the built CLI', async () => {
|
|
const setupScript = await readText('scripts/conductor-setup.sh');
|
|
|
|
assert.match(setupScript, /read_required_uv_version\(\)/);
|
|
assert.match(setupScript, /\.context\/bin\/uv-\$required_version/);
|
|
assert.match(setupScript, /link_agent_overlays/);
|
|
assert.match(setupScript, /CONDUCTOR_ROOT_PATH/);
|
|
assert.match(setupScript, /uv sync --all-packages --all-groups/);
|
|
assert.match(setupScript, /pnpm install --frozen-lockfile --prefer-offline/);
|
|
assert.match(setupScript, /pnpm run native:rebuild/);
|
|
assert.match(setupScript, /pnpm run build/);
|
|
assert.match(setupScript, /pnpm run artifacts:build/);
|
|
assert.match(setupScript, /packages\/cli\/dist\/bin\.js status --no-input/);
|
|
assert.doesNotMatch(setupScript, /scripts\/conductor\//);
|
|
});
|
|
|
|
it('links private agent overlays from the Conductor root checkout', async () => {
|
|
const workspaceScript = await readText('scripts/conductor-setup.sh');
|
|
|
|
assert.match(workspaceScript, /link_shared_path "\$CONDUCTOR_ROOT_PATH\/\.agents" \.agents/);
|
|
assert.match(workspaceScript, /link_shared_path "\$CONDUCTOR_ROOT_PATH\/\.claude" \.claude/);
|
|
assert.doesNotMatch(workspaceScript, /KTX_AGENT_OVERLAYS_ROOT/);
|
|
assert.doesNotMatch(workspaceScript, /link_agent_skills_for_claude/);
|
|
});
|
|
|
|
it('runs the KTX daemon on the documented fixed local port', async () => {
|
|
const runScript = await readText('scripts/conductor-run.sh');
|
|
|
|
assert.match(runScript, /pnpm run build/);
|
|
assert.match(runScript, /source \.venv\/bin\/activate/);
|
|
assert.match(runScript, /uv run ktx-daemon serve-http --host 127\.0\.0\.1 --port 8765/);
|
|
assert.doesNotMatch(runScript, /\bnpx\b/);
|
|
});
|
|
});
|