@kirrosh/zond 0.8.0 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirrosh/zond",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "API testing platform — define tests in YAML, run from CLI or WebUI, generate from OpenAPI specs",
   "license": "MIT",
   "module": "index.ts",
@@ -26,11 +26,13 @@
   "scripts": {
     "zond": "bun run src/cli/index.ts",
     "test": "bun run test:unit && bun run test:mocked",
-    "test:unit": "bun test tests/db/ tests/parser/ tests/runner/ tests/generator/ tests/core/ tests/cli/args.test.ts tests/cli/chat.test.ts tests/cli/ci-init.test.ts tests/cli/commands.test.ts tests/cli/doctor.test.ts tests/cli/init.test.ts tests/cli/runs.test.ts tests/cli/safe-run.test.ts tests/cli/update.test.ts tests/integration/ tests/web/ tests/mcp/tools.test.ts tests/mcp/save-test-suite.test.ts tests/agent/agent-loop.test.ts tests/agent/context-manager.test.ts tests/agent/system-prompt.test.ts tests/reporter/",
+    "test:unit": "bun test tests/db/ tests/parser/ tests/runner/ tests/generator/ tests/core/ tests/cli/args.test.ts tests/cli/chat.test.ts tests/cli/ci-init.test.ts tests/cli/commands.test.ts tests/cli/doctor.test.ts tests/cli/init.test.ts tests/cli/runs.test.ts tests/cli/safe-run.test.ts tests/cli/update.test.ts tests/integration/ tests/web/ tests/mcp/tools.test.ts tests/mcp/save-test-suite.test.ts tests/agent/agent-loop.test.ts tests/agent/context-manager.test.ts tests/agent/system-prompt.test.ts tests/reporter/ tests/version-sync.test.ts",
     "test:mocked": "bun run scripts/run-mocked-tests.ts",
     "test:ai": "bun test tests/ai/",
     "check": "tsc --noEmit --project tsconfig.json",
-    "build": "bun build --compile src/cli/index.ts --outfile zond"
+    "build": "bun build --compile src/cli/index.ts --outfile zond",
+    "version:sync": "bun run scripts/sync-version.ts",
+    "postversion": "bun run scripts/sync-version.ts && git add .claude-plugin/plugin.json .claude-plugin/marketplace.json"
   },
   "devDependencies": {
     "@types/bun": "latest"

package/src/core/diagnostics/failure-hints.ts

@@ -44,6 +44,16 @@ export function envCategory(hint: string | undefined): string | null {
   return null;
 }
 
+export function schemaHint(
+  failureType: string,
+  responseStatus: number | null | undefined,
+): string | null {
+  if (failureType === "assertion_failed" || responseStatus === 400 || responseStatus === 422) {
+    return "Use describe_endpoint(specPath, method, path) to verify expected request/response schema";
+  }
+  return null;
+}
+
 export function computeSharedEnvIssue(
   failures: Array<{ hint?: string }>,
   envFilePath?: string,

package/src/core/generator/guide-builder.ts

@@ -67,11 +67,30 @@ export interface GuideOptions {
   securitySchemes: SecuritySchemeInfo[];
   endpointCount: number;
   coverageHeader?: string;
+  compact?: boolean;
 }
 
 export function buildGenerationGuide(opts: GuideOptions): string {
   const hasAuth = opts.securitySchemes.length > 0;
 
+  if (opts.compact) {
+    const securitySummary = hasAuth
+      ? `Security: ${opts.securitySchemes.map(s => `${s.name} (${s.type}${s.scheme ? `/${s.scheme}` : ""})`).join(", ")}`
+      : "Security: none";
+
+    return `# Test Generation Guide for ${opts.title}
+${opts.coverageHeader ? `\n${opts.coverageHeader}\n` : ""}
+## API Specification (${opts.endpointCount} endpoints)
+${opts.baseUrl ? `Base URL: ${opts.baseUrl}` : "Base URL: use {{base_url}} environment variable"}
+${securitySummary}
+
+${opts.apiContext}
+
+---
+
+> **Note:** Refer to the full YAML format reference, generation algorithm, tag conventions, and practical tips from the initial \`generate_and_save\` call (without \`tag\`). Only the API endpoints above are unique to this chunk.`;
+  }
+
   return `# Test Generation Guide for ${opts.title}
 ${opts.coverageHeader ? `\n${opts.coverageHeader}\n` : ""}
 ## API Specification (${opts.endpointCount} endpoints)

package/src/mcp/tools/generate-and-save.ts

@@ -106,6 +106,7 @@ export function registerGenerateAndSaveTool(server: McpServer) {
         securitySchemes,
         endpointCount: endpoints.length,
         coverageHeader,
+        compact: !!tag,
       });
 
       const saveInstructions = `

package/src/mcp/tools/query-db.ts

@@ -4,7 +4,7 @@ import { getDb } from "../../db/schema.ts";
 import { listCollections, listRuns, getRunById, getResultsByRunId, getCollectionById } from "../../db/queries.ts";
 import { join } from "node:path";
 import { TOOL_DESCRIPTIONS } from "../descriptions.js";
-import { statusHint, classifyFailure, envHint, envCategory } from "../../core/diagnostics/failure-hints.ts";
+import { statusHint, classifyFailure, envHint, envCategory, schemaHint } from "../../core/diagnostics/failure-hints.ts";
 
 function parseBodySafe(raw: string | null | undefined): unknown {
   if (!raw) return undefined;
@@ -124,6 +124,7 @@ export function registerQueryDbTool(server: McpServer, dbPath?: string) {
               // env issues take priority over generic status hints
               const hint = envHint(r.request_url, r.error_message, envFilePath) ?? statusHint(r.response_status);
               const failure_type = classifyFailure(r.status, r.response_status);
+              const sHint = schemaHint(failure_type, r.response_status);
               return {
                 suite_name: r.suite_name,
                 test_name: r.test_name,
@@ -134,6 +135,7 @@ export function registerQueryDbTool(server: McpServer, dbPath?: string) {
                 request_url: r.request_url,
                 response_status: r.response_status,
                 ...(hint ? { hint } : {}),
+                ...(sHint ? { schema_hint: sHint } : {}),
                 response_body: parseBodySafe(r.response_body),
                 response_headers: r.response_headers
                   ? JSON.parse(r.response_headers)

package/src/mcp/tools/run-tests.ts

@@ -48,6 +48,12 @@ export function registerRunTestsTool(server: McpServer, dbPath?: string) {
     const hints: string[] = [];
     if (failedSteps.length > 0) {
       hints.push("Use query_db(action: 'diagnose_failure', runId: " + runId + ") for detailed failure analysis");
+      const hasAssertionFailures = failedSteps.some(s => s.assertions.length > 0);
+      if (hasAssertionFailures) {
+        hints.push(
+          "Some tests have assertion failures — use describe_endpoint(specPath, method, path) to verify expected schemas"
+        );
+      }
     }
     hints.push("Use manage_server(action: 'start') to launch the Web UI and view results visually in a browser at http://localhost:8080");
     hints.push("Ask the user if they want to set up CI/CD to run these tests automatically on push. If yes, use ci_init to generate a workflow and help them push to GitHub/GitLab.");