specforge-mcp 0.11.0 → 0.12.0

package/dist/tools/generate-tests/generators/database/ts-scaffold.js

@@ -0,0 +1,118 @@
+// tools/generate-tests/generators/database/ts-scaffold.ts
+// Builds TypeScript/Vitest database test scaffold content.
+export function buildTsDatabaseTest(title, db, orm, cache, search) {
+    const cacheSection = cache
+        ? `
+  describe('Caching (${cache})', () => {
+    it('returns cached value on cache hit', async () => {
+      // await cache.set('user:1', { name: 'Test' }, { ttl: 60 });
+      // const result = await cache.get('user:1');
+      // expect(result).toMatchObject({ name: 'Test' });
+      expect(true).toBe(true);
+    });
+
+    it('returns null on cache miss', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('expires entry after TTL', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('invalidates cache on data update', async () => {
+      expect(true).toBe(true);
+    });
+  });
+`
+        : '';
+    const searchSection = search
+        ? `
+  describe('Full-text search (${search})', () => {
+    it('indexes document and makes it searchable', async () => {
+      // await searchClient.index('products').addDocuments([{ id: 1, name: 'Widget' }]);
+      // const results = await searchClient.index('products').search('Widget');
+      // expect(results.hits).toHaveLength(1);
+      expect(true).toBe(true);
+    });
+
+    it('returns relevant results ranked by score', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('supports fuzzy matching for typos', async () => {
+      expect(true).toBe(true);
+    });
+  });
+`
+        : '';
+    const ormSection = orm
+        ? `
+  describe('Transactions and locking', () => {
+    it('commits transaction on success', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('rolls back transaction on error', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('detects optimistic locking conflict', async () => {
+      // Concurrent update with stale version → should throw
+      expect(true).toBe(true);
+    });
+  });
+`
+        : '';
+    return `// Database & Data Layer tests for: ${title}
+// Generated by SpecForge SDD MCP Server (SPEC-058b)
+import { describe, it, expect } from 'vitest';
+
+describe('${title} — Database Tests (${db})', () => {
+  describe('Migrations', () => {
+    it('schema migration up applies cleanly', async () => {
+      // await migrate.up();
+      // const tables = await db.query("SELECT name FROM sqlite_master WHERE type='table'");
+      // expect(tables).toContainEqual({ name: 'users' });
+      expect(true).toBe(true); // Replace with real migration assertion
+    });
+
+    it('schema migration down reverts cleanly', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('data integrity preserved after migration', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('rollback does not lose existing data', async () => {
+      expect(true).toBe(true);
+    });
+  });
+
+  describe('Repository / DAO — CRUD', () => {
+    it('creates a record and returns its id', async () => {
+      // const user = await repo.create({ name: 'Test', email: 'test@example.com' });
+      // expect(user.id).toBeDefined();
+      expect(true).toBe(true);
+    });
+
+    it('reads a record by id', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('updates a record', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('deletes a record', async () => {
+      expect(true).toBe(true);
+    });
+
+    it('returns null for non-existent record', async () => {
+      expect(true).toBe(true);
+    });
+  });
+${ormSection}${cacheSection}${searchSection}});
+`;
+}
+//# sourceMappingURL=ts-scaffold.js.map

package/dist/tools/generate-tests/generators/database/ts-scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-scaffold.js","sourceRoot":"","sources":["../../../../../src/tools/generate-tests/generators/database/ts-scaffold.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,2DAA2D;AAE3D,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,EAAU,EACV,GAAY,EACZ,KAAoB,EACpB,MAAqB;IAErB,MAAM,YAAY,GAAG,KAAK;QACxB,CAAC,CAAC;uBACiB,KAAK;;;;;;;;;;;;;;;;;;;;CAoB3B;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,aAAa,GAAG,MAAM;QAC1B,CAAC,CAAC;gCAC0B,MAAM;;;;;;;;;;;;;;;;CAgBrC;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,UAAU,GAAG,GAAG;QACpB,CAAC,CAAC;;;;;;;;;;;;;;;CAeL;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,uCAAuC,KAAK;;;;YAIzC,KAAK,sBAAsB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CvC,UAAU,GAAG,YAAY,GAAG,aAAa;CAC1C,CAAC;AACF,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { 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;
+//# sourceMappingURL=detectors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detectors.d.ts","sourceRoot":"","sources":["../../../../../src/tools/generate-tests/generators/microservices/detectors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAanE,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"}

package/dist/tools/generate-tests/generators/microservices/detectors.js

@@ -0,0 +1,47 @@
+// tools/generate-tests/generators/microservices/detectors.ts — SPEC-058b Section E
+// Broker and service mesh detection signals and predicates for microservices test generation.
+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;
+}
+//# sourceMappingURL=detectors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detectors.js","sourceRoot":"","sources":["../../../../../src/tools/generate-tests/generators/microservices/detectors.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,8FAA8F;AAI9F,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC/F,MAAM,YAAY,GAAG;IACnB,OAAO;IACP,OAAO;IACP,SAAS;IACT,MAAM;IACN,SAAS;IACT,eAAe;IACf,aAAa;CACd,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,SAA2B;IACtD,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/D,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC5C,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAA2B;IAC3D,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/D,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC5C,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,SAA2B;IACpE,IAAI,SAAS,CAAC,YAAY,CAAC,OAAO,KAAK,eAAe,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,eAAe,CAAC,EAAE,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,YAAY,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,iBAAiB,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC3F,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AAC7B,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tools/generate-tests/generators/microservices/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAK7E,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAE/D,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/index.js

@@ -0,0 +1,26 @@
+// tools/generate-tests/generators/microservices/index.ts — SPEC-058b Section E
+// Public API for the microservices test generator. Re-exports all public symbols.
+import { detectBroker, detectServiceMesh } from './detectors.js';
+import { buildTsMicroservicesTest } from './ts-scaffold.js';
+import { buildPythonMicroservicesTest } from './python-scaffold.js';
+export { detectBroker, detectServiceMesh, isMicroservicesTestProject } from './detectors.js';
+export { generateMicroservicesTestDefs } from './test-defs.js';
+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=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/tools/generate-tests/generators/microservices/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kFAAkF;AAGlF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,UAAU,8BAA8B,CAC5C,IAAqC,EACrC,OAAe,EACf,SAAiB,EACjB,QAAgB,EAChB,OAAe,EACf,YAAqB,EACrB,SAA2B;IAE3B,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,QAAQ,KAAK,QAAQ,CAAC;IACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;IACtC,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3C,MAAM,OAAO,GAAG,QAAQ;QACtB,CAAC,CAAC,4BAA4B,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC;QACxD,CAAC,CAAC,wBAAwB,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAEvD,OAAO;QACL;YACE,IAAI,EAAE,GAAG,OAAO,kBAAkB,IAAI,CAAC,IAAI,uBAAuB,GAAG,EAAE;YACvE,SAAS,EAAE,EAAE;YACb,OAAO;YACP,KAAK,EAAE,YAAY;SACpB;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/generate-tests/generators/microservices/python-scaffold.d.ts

@@ -0,0 +1,2 @@
+export declare function buildPythonMicroservicesTest(title: string, broker: string | null, mesh: string | null): string;
+//# sourceMappingURL=python-scaffold.d.ts.map

package/dist/tools/generate-tests/generators/microservices/python-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-scaffold.d.ts","sourceRoot":"","sources":["../../../../../src/tools/generate-tests/generators/microservices/python-scaffold.ts"],"names":[],"mappings":"AAGA,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,MAAM,CAgGR"}

package/dist/tools/generate-tests/generators/microservices/python-scaffold.js

@@ -0,0 +1,98 @@
+// tools/generate-tests/generators/microservices/python-scaffold.ts — SPEC-058b Section E
+// Builds Python/pytest scaffold content for microservices tests.
+export 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}`;
+}
+//# sourceMappingURL=python-scaffold.js.map

package/dist/tools/generate-tests/generators/microservices/python-scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-scaffold.js","sourceRoot":"","sources":["../../../../../src/tools/generate-tests/generators/microservices/python-scaffold.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,iEAAiE;AAEjE,MAAM,UAAU,4BAA4B,CAC1C,KAAa,EACb,MAAqB,EACrB,IAAmB;IAEnB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,MAAM;QAC1B,CAAC,CAAC;;;;;;;;;;;;;;;;;;;CAmBL;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,WAAW,GAAG,IAAI;QACtB,CAAC,CAAC;;;;;;;;;;;;CAYL;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,qDAAqD,KAAK;;;;;;YAMvD,GAAG;sCACuB,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+CzC,aAAa,GAAG,WAAW,EAAE,CAAC;AAChC,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { TestDefinition, ProjectKnowledge } from '../../../../types/index.js';
+export declare function generateMicroservicesTestDefs(title: string, testDir: string, _testExt: string, knowledge: ProjectKnowledge): TestDefinition[];
+//# sourceMappingURL=test-defs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-defs.d.ts","sourceRoot":"","sources":["../../../../../src/tools/generate-tests/generators/microservices/test-defs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnF,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,gBAAgB,GAC1B,cAAc,EAAE,CA+DlB"}

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

@@ -0,0 +1,61 @@
+// tools/generate-tests/generators/microservices/test-defs.ts — SPEC-058b Section E
+// Generates TestDefinition array for microservices test scenarios.
+import { detectBroker, detectServiceMesh } from './detectors.js';
+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;
+}
+//# sourceMappingURL=test-defs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-defs.js","sourceRoot":"","sources":["../../../../../src/tools/generate-tests/generators/microservices/test-defs.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,mEAAmE;AAGnE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEjE,MAAM,UAAU,6BAA6B,CAC3C,KAAa,EACb,OAAe,EACf,QAAgB,EAChB,SAA2B;IAE3B,MAAM,IAAI,GAAqB;QAC7B;YACE,IAAI,EAAE,GAAG,KAAK,sDAAsD;YACpE,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,GAAG,OAAO,iBAAiB;YACjC,WAAW,EAAE,0EAA0E;YACvF,QAAQ,EAAE,UAAU;YACpB,WAAW,EAAE,IAAI;SAClB;QACD;YACE,IAAI,EAAE,GAAG,KAAK,6DAA6D;YAC3E,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,GAAG,OAAO,iBAAiB;YACjC,WAAW,EACT,4FAA4F;YAC9F,QAAQ,EAAE,MAAM;YAChB,WAAW,EAAE,IAAI;SAClB;QACD;YACE,IAAI,EAAE,GAAG,KAAK,4DAA4D;YAC1E,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,GAAG,OAAO,iBAAiB;YACjC,WAAW,EACT,uFAAuF;YACzF,QAAQ,EAAE,MAAM;YAChB,WAAW,EAAE,IAAI;SAClB;QACD;YACE,IAAI,EAAE,GAAG,KAAK,iDAAiD;YAC/D,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,GAAG,OAAO,iBAAiB;YACjC,WAAW,EAAE,0EAA0E;YACvF,QAAQ,EAAE,UAAU;YACpB,WAAW,EAAE,IAAI;SAClB;KACF,CAAC;IAEF,IAAI,YAAY,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,GAAG,KAAK,wDAAwD;YACtE,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,GAAG,OAAO,iBAAiB;YACjC,WAAW,EACT,+FAA+F;YACjG,QAAQ,EAAE,MAAM;YAChB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,iBAAiB,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,GAAG,KAAK,sDAAsD;YACpE,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,GAAG,OAAO,iBAAiB;YACjC,WAAW,EACT,0FAA0F;YAC5F,QAAQ,EAAE,QAAQ;YAClB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare function buildTsMicroservicesTest(title: string, broker: string | null, mesh: string | null): string;
+//# sourceMappingURL=ts-scaffold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ts-scaffold.d.ts","sourceRoot":"","sources":["../../../../../src/tools/generate-tests/generators/microservices/ts-scaffold.ts"],"names":[],"mappings":"AAGA,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,MAAM,CAyHR"}

package/dist/tools/generate-tests/generators/microservices/ts-scaffold.js

@@ -0,0 +1,123 @@
+// tools/generate-tests/generators/microservices/ts-scaffold.ts — SPEC-058b Section E
+// Builds TypeScript/vitest scaffold content for microservices tests.
+export 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}});
+`;
+}
+//# sourceMappingURL=ts-scaffold.js.map

package/dist/tools/generate-tests/generators/microservices/ts-scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-scaffold.js","sourceRoot":"","sources":["../../../../../src/tools/generate-tests/generators/microservices/ts-scaffold.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,qEAAqE;AAErE,MAAM,UAAU,wBAAwB,CACtC,KAAa,EACb,MAAqB,EACrB,IAAmB;IAEnB,MAAM,aAAa,GAAG,MAAM;QAC1B,CAAC,CAAC;8BACwB,MAAM;;sDAEkB,MAAM;;;;;;;;;;;;;;;;;;;;CAoB3D;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,WAAW,GAAG,IAAI;QACtB,CAAC,CAAC;4BACsB,IAAI;;;;;;;;;;;;;CAa/B;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,qDAAqD,KAAK;;;;YAIvD,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqEf,aAAa,GAAG,WAAW;CAC5B,CAAC;AACF,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { ProjectKnowledge } from '../../../../types/index.js';
+export declare const AUTH_SIGNALS: string[];
+export declare const UPLOAD_SIGNALS: string[];
+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;
+//# sourceMappingURL=detectors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detectors.d.ts","sourceRoot":"","sources":["../../../../../src/tools/generate-tests/generators/security/detectors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,eAAO,MAAM,YAAY,UAcxB,CAAC;AAEF,eAAO,MAAM,cAAc,UAS1B,CAAC;AAEF,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"}

package/dist/tools/generate-tests/generators/security/detectors.js

@@ -0,0 +1,61 @@
+// security/detectors.ts — SPEC-058b Section G
+// Signal constants and detector functions for auth, file upload, and API presence.
+export const AUTH_SIGNALS = [
+    'jwt',
+    'oauth',
+    'passport',
+    'keycloak',
+    'auth0',
+    'clerk',
+    'supabase',
+    'session',
+    'cookie-session',
+    'express-session',
+    'next-auth',
+    'lucia',
+    'better-auth',
+];
+export const UPLOAD_SIGNALS = [
+    'multer',
+    'formidable',
+    'busboy',
+    'sharp',
+    'jimp',
+    'imagemagick',
+    'file-upload',
+    'multipart',
+];
+export function detectAuth(knowledge) {
+    const stackLower = knowledge.stack.map((s) => s.toLowerCase());
+    for (const sig of AUTH_SIGNALS) {
+        if (stackLower.some((s) => s.includes(sig))) {
+            return sig;
+        }
+    }
+    return null;
+}
+export function detectFileUpload(knowledge) {
+    const stackLower = knowledge.stack.map((s) => s.toLowerCase());
+    for (const sig of UPLOAD_SIGNALS) {
+        if (stackLower.some((s) => s.includes(sig))) {
+            return sig;
+        }
+    }
+    return null;
+}
+export function hasPublicApi(knowledge) {
+    if (knowledge.apiContracts.length > 0) {
+        return true;
+    }
+    return knowledge.apps.some((a) => a.type === 'backend');
+}
+export function isSecurityTestProject(knowledge) {
+    if (detectAuth(knowledge) !== null) {
+        return true;
+    }
+    if (hasPublicApi(knowledge)) {
+        return true;
+    }
+    return knowledge.apps.some((a) => a.type === 'backend' || a.type === 'frontend');
+}
+//# sourceMappingURL=detectors.js.map

package/dist/tools/generate-tests/generators/security/detectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectors.js","sourceRoot":"","sources":["../../../../../src/tools/generate-tests/generators/security/detectors.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,mFAAmF;AAInF,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK;IACL,OAAO;IACP,UAAU;IACV,UAAU;IACV,OAAO;IACP,OAAO;IACP,UAAU;IACV,SAAS;IACT,gBAAgB;IAChB,iBAAiB;IACjB,WAAW;IACX,OAAO;IACP,aAAa;CACd,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,OAAO;IACP,MAAM;IACN,aAAa;IACb,aAAa;IACb,WAAW;CACZ,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,SAA2B;IACpD,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/D,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC5C,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAA2B;IAC1D,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/D,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC5C,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAA2B;IACtD,IAAI,SAAS,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,SAA2B;IAC/D,IAAI,UAAU,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;AACnF,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tools/generate-tests/generators/security/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAK7E,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,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"}