specforge-mcp 0.2.2 → 0.4.0

package/dist/tools/generate-tests/generators/grpc-test-generator.js

@@ -0,0 +1,283 @@
+// tools/generate-tests/generators/grpc-test-generator.ts — SPEC-058a Section D
+// Generates gRPC test scaffolds: proto contracts, unary, streaming, deadlines.
+const GRPC_SIGNALS = ['grpc', '@grpc/grpc-js', 'protobuf', 'buf', 'proto-loader', 'grpc-web'];
+/**
+ * Returns true when the project uses gRPC / Protocol Buffers.
+ */
+export function isGrpcProject(knowledge) {
+    const stackLower = knowledge.stack.map((s) => s.toLowerCase());
+    const hasStackSignal = GRPC_SIGNALS.some((sig) => stackLower.some((s) => s.includes(sig)));
+    const toolingValues = Object.values(knowledge.tooling).map((v) => v.toLowerCase());
+    const hasProtoFile = toolingValues.some((v) => v.includes('.proto') || v.includes('protobuf'));
+    return hasStackSignal || hasProtoFile;
+}
+/**
+ * Generate gRPC test definitions: proto contracts, unary, streaming, deadlines.
+ */
+export function generateGrpcTestDefs(title, testDir, _testExt) {
+    return [
+        {
+            name: `${title} — gRPC: proto contract validation`,
+            type: 'integration',
+            file: `${testDir}/grpc/`,
+            description: 'Verify the .proto definition compiles and all service methods are reachable',
+            priority: 'critical',
+            automatable: true,
+        },
+        {
+            name: `${title} — gRPC: unary call returns correct response`,
+            type: 'integration',
+            file: `${testDir}/grpc/`,
+            description: 'Execute a unary RPC and assert the response message matches the proto schema',
+            priority: 'high',
+            automatable: true,
+        },
+        {
+            name: `${title} — gRPC: server streaming yields all expected messages`,
+            type: 'integration',
+            file: `${testDir}/grpc/`,
+            description: 'Consume a server-streaming RPC and verify each streamed message',
+            priority: 'high',
+            automatable: true,
+        },
+        {
+            name: `${title} — gRPC: client streaming aggregates messages correctly`,
+            type: 'integration',
+            file: `${testDir}/grpc/`,
+            description: 'Send multiple messages via client-streaming RPC and verify aggregated response',
+            priority: 'medium',
+            automatable: true,
+        },
+        {
+            name: `${title} — gRPC: bidirectional streaming echoes messages in order`,
+            type: 'integration',
+            file: `${testDir}/grpc/`,
+            description: 'Open a bidirectional stream and verify messages are echoed in FIFO order',
+            priority: 'medium',
+            automatable: true,
+        },
+        {
+            name: `${title} — gRPC: deadline propagation cancels slow calls`,
+            type: 'integration',
+            file: `${testDir}/grpc/`,
+            description: 'Set a short deadline on a slow call and assert DEADLINE_EXCEEDED status code',
+            priority: 'high',
+            automatable: true,
+        },
+    ];
+}
+// ---------------------------------------------------------------------------
+// Content generators
+// ---------------------------------------------------------------------------
+function buildTsGrpcTest(title) {
+    return `// gRPC tests for: ${title}
+// Generated by SpecForge SDD MCP Server (SPEC-058a)
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+// import * as grpc from '@grpc/grpc-js';
+// import * as protoLoader from '@grpc/proto-loader';
+
+// const PROTO_PATH = './proto/service.proto';
+// const packageDefinition = protoLoader.loadSync(PROTO_PATH);
+// const proto = grpc.loadPackageDefinition(packageDefinition) as grpc.GrpcObject;
+
+describe('${title} — gRPC Tests', () => {
+  // let client: grpc.ServiceClient;
+
+  beforeAll(() => {
+    // const ServiceClient = proto['YourService'] as grpc.ServiceClientConstructor;
+    // client = new ServiceClient(
+    //   'localhost:50051',
+    //   grpc.credentials.createInsecure(),
+    // );
+  });
+
+  afterAll(() => {
+    // client.close();
+  });
+
+  describe('Proto contract', () => {
+    it('service definition loads without errors', () => {
+      // const packageDef = protoLoader.loadSync(PROTO_PATH);
+      // expect(packageDef).toBeDefined();
+      expect(true).toBe(true); // Replace with real proto load assertion
+    });
+  });
+
+  describe('Unary call', () => {
+    it('returns correct response message', async () => {
+      // const response = await new Promise((resolve, reject) =>
+      //   client.unaryMethod({ id: '1' }, (err, res) =>
+      //     err ? reject(err) : resolve(res),
+      //   ),
+      // );
+      // expect(response).toMatchObject({ id: '1' });
+      expect(true).toBe(true); // Replace with real unary assertion
+    });
+  });
+
+  describe('Server streaming', () => {
+    it('yields all expected messages', async () => {
+      // const messages: unknown[] = [];
+      // await new Promise<void>((resolve, reject) => {
+      //   const stream = client.serverStreamMethod({ count: 3 });
+      //   stream.on('data', (msg) => messages.push(msg));
+      //   stream.on('error', reject);
+      //   stream.on('end', resolve);
+      // });
+      // expect(messages).toHaveLength(3);
+      expect(true).toBe(true); // Replace with real server-stream assertion
+    });
+  });
+
+  describe('Deadline propagation', () => {
+    it('returns DEADLINE_EXCEEDED for slow calls', async () => {
+      // const deadline = new Date(Date.now() + 1); // 1ms deadline
+      // await expect(
+      //   new Promise((resolve, reject) =>
+      //     client.slowMethod({}, { deadline }, (err, res) =>
+      //       err ? reject(err) : resolve(res),
+      //     ),
+      //   ),
+      // ).rejects.toMatchObject({ code: grpc.status.DEADLINE_EXCEEDED });
+      expect(true).toBe(true); // Replace with real deadline assertion
+    });
+  });
+});
+`;
+}
+function buildGoGrpcTest(title) {
+    const pkg = title.toLowerCase().replace(/\s+/g, '_');
+    return `// gRPC tests for: ${title}
+// Generated by SpecForge SDD MCP Server (SPEC-058a)
+package ${pkg}_test
+
+import (
+\t"context"
+\t"testing"
+\t"time"
+
+\t"google.golang.org/grpc"
+\t"google.golang.org/grpc/codes"
+\t"google.golang.org/grpc/credentials/insecure"
+\t"google.golang.org/grpc/status"
+\t// pb "your/module/proto/gen"
+)
+
+func setupClient(t *testing.T) (*grpc.ClientConn, func()) {
+\tt.Helper()
+\tconn, err := grpc.NewClient(
+\t\t"localhost:50051",
+\t\tgrpc.WithTransportCredentials(insecure.NewCredentials()),
+\t)
+\tif err != nil {
+\t\tt.Fatalf("failed to connect: %v", err)
+\t}
+\treturn conn, func() { conn.Close() } //nolint:errcheck
+}
+
+func TestUnaryCall(t *testing.T) {
+\t// conn, teardown := setupClient(t)
+\t// defer teardown()
+\t// client := pb.NewYourServiceClient(conn)
+\t//
+\t// ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
+\t// defer cancel()
+\t//
+\t// resp, err := client.UnaryMethod(ctx, &pb.Request{Id: "1"})
+\t// if err != nil { t.Fatalf("unary call failed: %v", err) }
+\t// if resp.Id != "1" { t.Errorf("expected id=1, got %s", resp.Id) }
+\tt.Skip("TODO: implement unary call test")
+}
+
+func TestDeadlinePropagation(t *testing.T) {
+\t// conn, teardown := setupClient(t)
+\t// defer teardown()
+\t// client := pb.NewYourServiceClient(conn)
+\t//
+\tctx, cancel := context.WithTimeout(context.Background(), 1*time.Millisecond)
+\tdefer cancel()
+\t_ = ctx
+\t//
+\t// _, err := client.SlowMethod(ctx, &pb.Request{})
+\t// if status.Code(err) != codes.DeadlineExceeded {
+\t//     t.Errorf("expected DeadlineExceeded, got %v", status.Code(err))
+\t// }
+\t_ = codes.DeadlineExceeded
+\t_ = status.Code
+\tt.Skip("TODO: implement deadline propagation test")
+}
+`;
+}
+function buildPythonGrpcTest(title) {
+    const cls = title.replace(/\s+/g, '');
+    return `"""gRPC tests for: ${title}
+Generated by SpecForge SDD MCP Server (SPEC-058a).
+Uses grpcio + grpcio-testing patterns.
+"""
+import pytest
+# import grpc
+# from your.proto import service_pb2, service_pb2_grpc
+
+
+class Test${cls}Grpc:
+    """gRPC test suite for ${title}."""
+
+    def test_proto_contract_loads(self) -> None:
+        """Proto definition loads without import errors."""
+        # TODO: from your.proto import service_pb2_grpc
+        pass
+
+    def test_unary_call_returns_correct_response(self) -> None:
+        """Unary RPC returns the expected response message."""
+        # TODO: channel = grpc.insecure_channel("localhost:50051")
+        # stub = service_pb2_grpc.YourServiceStub(channel)
+        # response = stub.UnaryMethod(service_pb2.Request(id="1"))
+        # assert response.id == "1"
+        pass
+
+    def test_server_streaming_yields_all_messages(self) -> None:
+        """Server-streaming RPC yields all expected messages."""
+        # TODO: messages = list(stub.ServerStreamMethod(service_pb2.Request(count=3)))
+        # assert len(messages) == 3
+        pass
+
+    def test_deadline_exceeded_for_slow_call(self) -> None:
+        """Call with a short deadline raises StatusCode.DEADLINE_EXCEEDED."""
+        # TODO: with pytest.raises(grpc.RpcError) as exc_info:
+        #     stub.SlowMethod(request, timeout=0.001)
+        # assert exc_info.value.code() == grpc.StatusCode.DEADLINE_EXCEEDED
+        pass
+`;
+}
+/**
+ * Generate gRPC test file scaffolds for the target language.
+ */
+export function generateGrpcTestFiles(spec, testDir, framework, language, testExt, autoGenerate) {
+    let content;
+    let resolvedExt;
+    let resolvedFramework;
+    if (language === 'go') {
+        content = buildGoGrpcTest(spec.title);
+        resolvedExt = 'go';
+        resolvedFramework = 'go-test';
+    }
+    else if (language === 'python') {
+        content = buildPythonGrpcTest(spec.title);
+        resolvedExt = 'py';
+        resolvedFramework = 'pytest';
+    }
+    else {
+        content = buildTsGrpcTest(spec.title);
+        resolvedExt = testExt;
+        resolvedFramework = framework;
+    }
+    return [
+        {
+            path: `${testDir}/grpc/${spec.slug}.grpc.test.${resolvedExt}`,
+            framework: resolvedFramework,
+            content,
+            ready: autoGenerate,
+        },
+    ];
+}
+//# sourceMappingURL=grpc-test-generator.js.map

package/dist/tools/generate-tests/generators/grpc-test-generator.js.map

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

package/dist/tools/generate-tests/generators/microservices-test-generator.d.ts

@@ -0,0 +1,10 @@
+import type { TestDefinition, TestFile, ProjectKnowledge } from '../../../types/index.js';
+export declare function detectBroker(knowledge: ProjectKnowledge): string | null;
+export declare function detectServiceMesh(knowledge: ProjectKnowledge): string | null;
+export declare function isMicroservicesTestProject(knowledge: ProjectKnowledge): boolean;
+export declare function generateMicroservicesTestDefs(title: string, testDir: string, _testExt: string, knowledge: ProjectKnowledge): TestDefinition[];
+export declare function generateMicroservicesTestFiles(spec: {
+    title: string;
+    slug: string;
+}, testDir: string, framework: string, language: string, testExt: string, autoGenerate: boolean, knowledge: ProjectKnowledge): TestFile[];
+//# sourceMappingURL=microservices-test-generator.d.ts.map

package/dist/tools/generate-tests/generators/microservices-test-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"microservices-test-generator.d.ts","sourceRoot":"","sources":["../../../../src/tools/generate-tests/generators/microservices-test-generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAa1F,wBAAgB,YAAY,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAQvE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAQ5E;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAe/E;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,gBAAgB,GAC1B,cAAc,EAAE,CA+DlB;AA2OD,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACrC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,OAAO,EACrB,SAAS,EAAE,gBAAgB,GAC1B,QAAQ,EAAE,CAkBZ"}

package/dist/tools/generate-tests/generators/microservices-test-generator.js

@@ -0,0 +1,341 @@
+// tools/generate-tests/generators/microservices-test-generator.ts — SPEC-058b Section E
+// Generates microservices & distributed systems test scaffolds:
+// contract testing, circuit breaker, retry, health checks, broker, service mesh.
+const BROKER_SIGNALS = ['kafka', 'rabbitmq', 'sqs', 'nats', 'redis-streams', 'pulsar', 'amqp'];
+const MESH_SIGNALS = [
+    'istio',
+    'envoy',
+    'linkerd',
+    'kong',
+    'traefik',
+    'nginx-ingress',
+    'api-gateway',
+];
+export function detectBroker(knowledge) {
+    const stackLower = knowledge.stack.map((s) => s.toLowerCase());
+    for (const sig of BROKER_SIGNALS) {
+        if (stackLower.some((s) => s.includes(sig))) {
+            return sig;
+        }
+    }
+    return null;
+}
+export function detectServiceMesh(knowledge) {
+    const stackLower = knowledge.stack.map((s) => s.toLowerCase());
+    for (const sig of MESH_SIGNALS) {
+        if (stackLower.some((s) => s.includes(sig))) {
+            return sig;
+        }
+    }
+    return null;
+}
+export function isMicroservicesTestProject(knowledge) {
+    if (knowledge.architecture.primary === 'microservices') {
+        return true;
+    }
+    if (knowledge.architecture.secondary.some((s) => s === 'microservices')) {
+        return true;
+    }
+    if (detectBroker(knowledge) !== null) {
+        return true;
+    }
+    if (detectServiceMesh(knowledge) !== null) {
+        return true;
+    }
+    const backends = knowledge.apps.filter((a) => a.type === 'backend' || a.type === 'worker');
+    return backends.length > 1;
+}
+export function generateMicroservicesTestDefs(title, testDir, _testExt, knowledge) {
+    const defs = [
+        {
+            name: `${title} — contract testing: inter-service Pact verification`,
+            type: 'integration',
+            file: `${testDir}/microservices/`,
+            description: 'Consumer-driven contract tests verify API compatibility between services',
+            priority: 'critical',
+            automatable: true,
+        },
+        {
+            name: `${title} — circuit breaker: open/half-open/closed state transitions`,
+            type: 'integration',
+            file: `${testDir}/microservices/`,
+            description: 'Verify circuit breaker opens on failures, transitions to half-open, and closes on recovery',
+            priority: 'high',
+            automatable: true,
+        },
+        {
+            name: `${title} — retry with backoff: exponential backoff and idempotency`,
+            type: 'integration',
+            file: `${testDir}/microservices/`,
+            description: 'Verify retry logic uses exponential backoff with jitter and respects idempotency keys',
+            priority: 'high',
+            automatable: true,
+        },
+        {
+            name: `${title} — health checks: liveness and readiness probes`,
+            type: 'integration',
+            file: `${testDir}/microservices/`,
+            description: 'Verify /healthz, /readyz, and startup probes return correct status codes',
+            priority: 'critical',
+            automatable: true,
+        },
+    ];
+    if (detectBroker(knowledge) !== null) {
+        defs.push({
+            name: `${title} — message broker: delivery guarantee and DLQ handling`,
+            type: 'integration',
+            file: `${testDir}/microservices/`,
+            description: 'Verify message delivery, ordering, dead letter queue handling, and consumer group rebalancing',
+            priority: 'high',
+            automatable: true,
+        });
+    }
+    if (detectServiceMesh(knowledge) !== null) {
+        defs.push({
+            name: `${title} — service mesh: routing rules and mTLS verification`,
+            type: 'integration',
+            file: `${testDir}/microservices/`,
+            description: 'Verify routing rules, mTLS certificate verification, and traffic splitting configuration',
+            priority: 'medium',
+            automatable: true,
+        });
+    }
+    return defs;
+}
+// ---------------------------------------------------------------------------
+// Scaffold builders
+// ---------------------------------------------------------------------------
+function buildTsMicroservicesTest(title, broker, mesh) {
+    const brokerSection = broker
+        ? `
+  describe('Message broker (${broker})', () => {
+    it('guarantees message delivery to consumer', async () => {
+      // const producer = createProducer({ broker: '${broker}' });
+      // await producer.send({ topic: 'orders', value: { id: 1 } });
+      // const received = await consumer.waitForMessage('orders', 5000);
+      // expect(received.value).toMatchObject({ id: 1 });
+      expect(true).toBe(true); // Replace with real broker assertion
+    });
+
+    it('routes failed messages to dead letter queue', async () => {
+      // Simulate processing failure → verify message lands in DLQ
+      expect(true).toBe(true);
+    });
+
+    it('preserves message ordering within partition', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('handles consumer group rebalancing gracefully', async () => {
+      expect(true).toBe(true);
+    });
+  });
+`
+        : '';
+    const meshSection = mesh
+        ? `
+  describe('Service mesh (${mesh})', () => {
+    it('routes traffic according to configured rules', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('verifies mTLS certificates between services', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('splits traffic correctly between versions', async () => {
+      expect(true).toBe(true);
+    });
+  });
+`
+        : '';
+    return `// Microservices & Distributed Systems tests for: ${title}
+// Generated by SpecForge SDD MCP Server (SPEC-058b)
+import { describe, it, expect } from 'vitest';
+
+describe('${title} — Microservices Tests', () => {
+  describe('Contract testing (Pact)', () => {
+    it('consumer contract matches provider API', async () => {
+      // const interaction = new PactInteraction()
+      //   .uponReceiving('a request for user')
+      //   .withRequest({ method: 'GET', path: '/api/users/1' })
+      //   .willRespondWith({ status: 200, body: { id: 1, name: 'Test' } });
+      // await provider.verify(interaction);
+      expect(true).toBe(true); // Replace with real Pact assertion
+    });
+  });
+
+  describe('Circuit breaker', () => {
+    it('opens after consecutive failures', async () => {
+      // Simulate 5 failures → verify circuit is open
+      expect(true).toBe(true);
+    });
+
+    it('transitions from open to half-open after timeout', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('closes after successful request in half-open state', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('returns fallback response when circuit is open', async () => {
+      expect(true).toBe(true);
+    });
+  });
+
+  describe('Retry with backoff', () => {
+    it('retries with exponential backoff on transient failure', async () => {
+      // Verify delays: 100ms, 200ms, 400ms (exponential)
+      expect(true).toBe(true);
+    });
+
+    it('respects max retry limit', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('applies jitter to avoid thundering herd', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('uses idempotency key to prevent duplicate processing', async () => {
+      expect(true).toBe(true);
+    });
+  });
+
+  describe('Health check endpoints', () => {
+    it('GET /healthz returns 200 when service is alive', async () => {
+      // const res = await request(app).get('/healthz');
+      // expect(res.status).toBe(200);
+      expect(true).toBe(true);
+    });
+
+    it('GET /readyz returns 200 when dependencies are ready', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('GET /readyz returns 503 when a dependency is down', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('startup probe succeeds within timeout', async () => {
+      expect(true).toBe(true);
+    });
+  });
+${brokerSection}${meshSection}});
+`;
+}
+function buildPythonMicroservicesTest(title, broker, mesh) {
+    const cls = title.replace(/[^a-zA-Z0-9]/g, '');
+    const brokerSection = broker
+        ? `
+    def test_message_delivery_guarantee(self) -> None:
+        """Messages are delivered to consumers with at-least-once guarantee."""
+        # TODO: producer.send('orders', {'id': 1})
+        # msg = consumer.poll(timeout=5.0)
+        # assert msg.value == {'id': 1}
+        pass
+
+    def test_dead_letter_queue_routing(self) -> None:
+        """Failed messages are routed to the dead letter queue."""
+        pass
+
+    def test_message_ordering_within_partition(self) -> None:
+        """Messages within same partition maintain ordering."""
+        pass
+
+    def test_consumer_group_rebalancing(self) -> None:
+        """Consumer group rebalancing does not lose messages."""
+        pass
+`
+        : '';
+    const meshSection = mesh
+        ? `
+    def test_routing_rules(self) -> None:
+        """Traffic is routed according to configured rules."""
+        pass
+
+    def test_mtls_verification(self) -> None:
+        """mTLS certificates are verified between services."""
+        pass
+
+    def test_traffic_splitting(self) -> None:
+        """Traffic is split correctly between service versions."""
+        pass
+`
+        : '';
+    return `"""Microservices & Distributed Systems tests for: ${title}
+Generated by SpecForge SDD MCP Server (SPEC-058b).
+"""
+import pytest
+
+
+class Test${cls}Microservices:
+    """Microservices test suite for ${title}."""
+
+    def test_consumer_contract_matches_provider(self) -> None:
+        """Consumer-driven contract matches the provider API."""
+        # TODO: pact = Pact('consumer', 'provider')
+        # pact.given('user exists').upon_receiving('get user')
+        #   .with_request('GET', '/api/users/1')
+        #   .will_respond_with(200, body={'id': 1})
+        pass
+
+    def test_circuit_breaker_opens_on_failures(self) -> None:
+        """Circuit breaker opens after consecutive failures."""
+        pass
+
+    def test_circuit_breaker_half_open_transition(self) -> None:
+        """Circuit transitions from open to half-open after timeout."""
+        pass
+
+    def test_circuit_breaker_closes_on_recovery(self) -> None:
+        """Circuit closes after successful request in half-open state."""
+        pass
+
+    def test_retry_exponential_backoff(self) -> None:
+        """Retries use exponential backoff with jitter."""
+        pass
+
+    def test_retry_respects_max_limit(self) -> None:
+        """Retry stops after max attempts."""
+        pass
+
+    def test_idempotency_key_prevents_duplicates(self) -> None:
+        """Idempotency key prevents duplicate processing on retry."""
+        pass
+
+    def test_healthz_returns_200(self) -> None:
+        """GET /healthz returns 200 when service is alive."""
+        # TODO: response = client.get('/healthz')
+        # assert response.status_code == 200
+        pass
+
+    def test_readyz_returns_200_when_ready(self) -> None:
+        """GET /readyz returns 200 when all dependencies are ready."""
+        pass
+
+    def test_readyz_returns_503_when_dependency_down(self) -> None:
+        """GET /readyz returns 503 when a dependency is unavailable."""
+        pass
+${brokerSection}${meshSection}`;
+}
+export function generateMicroservicesTestFiles(spec, testDir, framework, language, testExt, autoGenerate, knowledge) {
+    const broker = detectBroker(knowledge);
+    const mesh = detectServiceMesh(knowledge);
+    const isPython = language === 'python';
+    const ext = isPython ? 'py' : testExt;
+    const fw = isPython ? 'pytest' : framework;
+    const content = isPython
+        ? buildPythonMicroservicesTest(spec.title, broker, mesh)
+        : buildTsMicroservicesTest(spec.title, broker, mesh);
+    return [
+        {
+            path: `${testDir}/microservices/${spec.slug}.microservices.test.${ext}`,
+            framework: fw,
+            content,
+            ready: autoGenerate,
+        },
+    ];
+}
+//# sourceMappingURL=microservices-test-generator.js.map

package/dist/tools/generate-tests/generators/microservices-test-generator.js.map

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

package/dist/tools/generate-tests/generators/security-test-generator.d.ts

@@ -0,0 +1,11 @@
+import type { TestDefinition, TestFile, ProjectKnowledge } from '../../../types/index.js';
+export declare function detectAuth(knowledge: ProjectKnowledge): string | null;
+export declare function detectFileUpload(knowledge: ProjectKnowledge): string | null;
+export declare function hasPublicApi(knowledge: ProjectKnowledge): boolean;
+export declare function isSecurityTestProject(knowledge: ProjectKnowledge): boolean;
+export declare function generateSecurityTestDefs(title: string, testDir: string, _testExt: string, knowledge: ProjectKnowledge): TestDefinition[];
+export declare function generateSecurityTestFiles(spec: {
+    title: string;
+    slug: string;
+}, testDir: string, framework: string, language: string, testExt: string, autoGenerate: boolean, knowledge: ProjectKnowledge): TestFile[];
+//# sourceMappingURL=security-test-generator.d.ts.map

package/dist/tools/generate-tests/generators/security-test-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-test-generator.d.ts","sourceRoot":"","sources":["../../../../src/tools/generate-tests/generators/security-test-generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AA4B1F,wBAAgB,UAAU,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAQrE;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAQ3E;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAKjE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAQ1E;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,gBAAgB,GAC1B,cAAc,EAAE,CAiDlB;AAwND,wBAAgB,yBAAyB,CACvC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACrC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,OAAO,EACrB,SAAS,EAAE,gBAAgB,GAC1B,QAAQ,EAAE,CAmBZ"}