common-qa-mcp 0.1.1 → 0.3.0

package/dist/tools/testdata.tools.js

@@ -0,0 +1,161 @@
+import { z } from 'zod';
+import { ok, err } from '../mcpResult.js';
+function describeError(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+export function registerTestdataTools(server, deps) {
+    server.registerTool('tc_get_testdata', {
+        title: 'Read the current testdata template for a test case',
+        description: 'Fetch the default iteration (template row) for TC `tcId` — the parameter list plus the ' +
+            'CURRENT seed values. Call this FIRST when you plan to generate testdata: use the seeds + ' +
+            'the test case\'s steps (from tc_get) to reason about what realistic values look like for ' +
+            'THIS flow, then pass those values to tc_generate_testdata. Example: for a SauceDemo login ' +
+            'flow, seeds tell you the valid usernames and the constant password/product/prices.',
+        inputSchema: {
+            tcId: z.string().describe('Test case id (or business key like TC_123).'),
+            environmentType: z.string().optional()
+                .describe('Env key; defaults to the first configured env for the project (falls back to "general").'),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ tcId, environmentType }) => {
+        const adapter = deps.getAdapter?.();
+        if (!adapter)
+            return err('Not connected to a product. Use qa_connect first.');
+        if (!adapter.getDefaultIteration) {
+            return err('This provider does not expose a testdata store.');
+        }
+        try {
+            const tpl = await adapter.getDefaultIteration({
+                tcId,
+                ...(environmentType !== undefined ? { environmentType } : {}),
+            });
+            if (!tpl.parameters?.length) {
+                return ok(`Test case "${tcId}" has no parameterized fields in env "${tpl.environmentType}" — nothing to generate.`, { tcId, parameters: [] });
+            }
+            const text = `Testdata template for ${tcId} · env ${tpl.environmentType} · version ${tpl.versionId}\n` +
+                `${tpl.parameters.length} parameter(s):\n` +
+                tpl.parameters.map((p) => `- ${p.name} = "${p.seed}"`).join('\n');
+            return ok(text, {
+                tcId,
+                versionId: tpl.versionId,
+                environmentType: tpl.environmentType,
+                parameters: tpl.parameters,
+            });
+        }
+        catch (e) {
+            return err(`Could not read testdata for "${tcId}": ${describeError(e)}`);
+        }
+    });
+    server.registerTool('tc_generate_testdata', {
+        title: 'Save generated testdata rows to a test case',
+        description: 'Persist up to 20 testdata rows for TC `tcId`. Two ways to feed values:\n' +
+            '  1) Model-generated — pass `rows: [{paramName: value}, ...]`. Call tc_get_testdata first ' +
+            'for the parameter names + seeds, tc_get for step context, then produce rows that fit the flow.\n' +
+            '  2) Formula-driven — pass `formulas: {paramName: {name, args?}}` (names from tc_list_formulas). ' +
+            'The adapter evaluates each formula per row via /tm/customFormula and stamps both the value ' +
+            'and the source `=NAME(...)` expression. Use `count` to say how many rows, or provide `rows` ' +
+            'for constant columns; mixing is fine (formulas win over row values for the same param).\n' +
+            'Rows are appended as new iterations; they do not become the default. Hard cap: 20 rows.',
+        inputSchema: {
+            tcId: z.string().describe('Test case id (or business key like TC_123).'),
+            rows: z.array(z.record(z.string(), z.string())).max(20).optional()
+                .describe('Rows keyed by param name (from tc_get_testdata). 1..20 rows. Omit when using formulas + count.'),
+            count: z.number().int().min(1).max(20).optional()
+                .describe('How many rows to generate when using formulas without explicit rows. Ignored if rows is set.'),
+            formulas: z.record(z.string(), z.object({
+                name: z.string().describe('RAW formula name from tc_list_formulas — the identifier only, no parens, no arg list. Correct: "FIRST_NAME". Wrong: "FIRST_NAME()", "FIRST_NAME(country,sex)".'),
+                args: z.record(z.string(), z.string()).optional()
+                    .describe('Named args. Keys MUST match Formula.parameters[].keyName exactly, no trailing colons or extra whitespace. Correct: {"country name": "United States"}. Wrong: {"country name:": "..."}.'),
+            })).optional()
+                .describe('Per-column formula assignments applied to every row. Outer keys are param names from tc_get_testdata. Wins over rows[i] for the same key.'),
+            environmentType: z.string().optional()
+                .describe('Env key; defaults to whatever tc_get_testdata resolved.'),
+        },
+        annotations: { readOnlyHint: false },
+    }, async ({ tcId, rows, count, formulas, environmentType }) => {
+        const adapter = deps.getAdapter?.();
+        if (!adapter)
+            return err('Not connected to a product. Use qa_connect first.');
+        if (!adapter.getDefaultIteration || !adapter.saveGeneratedIterations) {
+            return err('This provider does not expose a testdata store.');
+        }
+        const hasFormulas = formulas != null && Object.keys(formulas).length > 0;
+        // Reconcile rows vs count. Explicit rows always win; otherwise formulas + count seeds N empty
+        // rows that the adapter fills column-by-column via evaluateFormula.
+        let baseRows;
+        if (rows && rows.length > 0) {
+            baseRows = rows;
+        }
+        else if (hasFormulas && count && count > 0) {
+            baseRows = Array.from({ length: count }, () => ({}));
+        }
+        else {
+            return err('Provide either `rows` (1..20) or `formulas` together with `count` (1..20).');
+        }
+        if (baseRows.length > 20)
+            return err('Max 20 rows per call.');
+        // Resolve version + env by re-reading the template. Server-side env resolution honors project
+        // config; passing rows without this echo would risk saving into the wrong env.
+        let tpl;
+        try {
+            tpl = await adapter.getDefaultIteration({
+                tcId,
+                ...(environmentType !== undefined ? { environmentType } : {}),
+            });
+        }
+        catch (e) {
+            return err(`Could not fetch the default iteration for "${tcId}": ${describeError(e)}`);
+        }
+        if (!tpl.parameters?.length) {
+            return err(`Test case "${tcId}" has no parameterized fields — nothing to save.`);
+        }
+        const known = new Set(tpl.parameters.map((p) => p.name));
+        const unknown = new Set();
+        for (const r of baseRows)
+            for (const k of Object.keys(r))
+                if (!known.has(k))
+                    unknown.add(k);
+        if (hasFormulas)
+            for (const k of Object.keys(formulas))
+                if (!known.has(k))
+                    unknown.add(k);
+        let result;
+        try {
+            result = await adapter.saveGeneratedIterations({
+                tcId,
+                versionId: tpl.versionId,
+                environmentType: tpl.environmentType,
+                rows: baseRows,
+                parameters: tpl.parameters, // reuse the just-fetched template; adapter skips its own re-fetch
+                ...(hasFormulas ? { formulas: formulas } : {}),
+            });
+        }
+        catch (e) {
+            return err(`Save failed: ${describeError(e)}`);
+        }
+        const paramNames = tpl.parameters.map((p) => p.name);
+        const preview = baseRows.slice(0, 3);
+        const formulaNote = hasFormulas
+            ? `\nFormula columns: ${Object.keys(formulas).join(', ')} (evaluated per row).`
+            : '';
+        const warn = unknown.size
+            ? `\n(Ignored unknown param name(s): ${[...unknown].join(', ')} — not in the template.)`
+            : '';
+        const link = result.datasetUrl ? `\n${result.datasetUrl}` : '';
+        const text = `Saved ${result.inserted} testdata row(s) for ${tcId} · env ${tpl.environmentType}.${link}${formulaNote}${warn}\n\n` +
+            `Preview (first ${preview.length}, formula values shown as their param name):\n` +
+            preview
+                .map((r, i) => `${i + 1}. ${paramNames.map((n) => `${n}=${r[n] ?? (hasFormulas && (n in formulas) ? `<${formulas[n].name}()>` : '')}`).join(' | ')}`)
+                .join('\n');
+        return ok(text, {
+            tcId,
+            generated: result.inserted,
+            params: paramNames,
+            preview,
+            ...(hasFormulas ? { formulasUsed: Object.keys(formulas) } : {}),
+            ...(result.datasetUrl ? { datasetUrl: result.datasetUrl } : {}),
+            ...(result.iterationIds ? { iterationIds: result.iterationIds } : {}),
+        });
+    });
+}
+//# sourceMappingURL=testdata.tools.js.map

package/dist/tools/testdata.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testdata.tools.js","sourceRoot":"","sources":["../../src/tools/testdata.tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "common-qa-mcp",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "type": "module",
   "description": "Common QA MCP — one product-neutral MCP that routes test-case lifecycle requests to Walnut or SimplifyQA for any AI client. Launch over stdio via npx; install the Walnut QA agent with `init-agents`.",
   "bin": {