gswd 1.0.0 → 1.1.0

package/dist/tests/specify-agents.test.js

@@ -0,0 +1,352 @@
+"use strict";
+/**
+ * Specify Agents module tests — Agent definitions, prompt building, orchestration, validation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert"));
+const specify_agents_js_1 = require("../lib/specify-agents.js");
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function makeContext(overrides) {
+    return {
+        decisionsContent: '## Frozen Decisions\n- Decision 1: Build a task manager',
+        imagineContent: '## Direction\nA simple task manager for solo founders',
+        journeys: [],
+        frs: [],
+        autoPolicy: 'balanced',
+        ...overrides,
+    };
+}
+function makeSpawnFn(responses) {
+    return async (prompt) => {
+        for (const [key, value] of Object.entries(responses)) {
+            if (prompt.includes(key)) {
+                return value;
+            }
+        }
+        return 'Default agent output';
+    };
+}
+function makeFailingSpawnFn(failAgent) {
+    return async (prompt) => {
+        if (prompt.includes(failAgent)) {
+            throw new Error(`Agent ${failAgent} failed`);
+        }
+        return 'Success output';
+    };
+}
+// ─── SPECIFY_AGENTS constant ────────────────────────────────────────────────
+(0, node_test_1.describe)('SPECIFY_AGENTS', () => {
+    (0, node_test_1.it)('has exactly 3 agents', () => {
+        assert.strictEqual(specify_agents_js_1.SPECIFY_AGENTS.length, 3);
+    });
+    (0, node_test_1.it)('names match GSWD_SPEC: journey-mapper, architecture-drafter, integrations-checker', () => {
+        const names = specify_agents_js_1.SPECIFY_AGENTS.map((a) => a.name);
+        assert.ok(names.includes('journey-mapper'));
+        assert.ok(names.includes('architecture-drafter'));
+        assert.ok(names.includes('integrations-checker'));
+    });
+    (0, node_test_1.it)('journey-mapper is sequential, others are parallel', () => {
+        const journeyMapper = specify_agents_js_1.SPECIFY_AGENTS.find((a) => a.name === 'journey-mapper');
+        assert.strictEqual(journeyMapper.phase, 'sequential');
+        const archDrafter = specify_agents_js_1.SPECIFY_AGENTS.find((a) => a.name === 'architecture-drafter');
+        assert.strictEqual(archDrafter.phase, 'parallel');
+        const intChecker = specify_agents_js_1.SPECIFY_AGENTS.find((a) => a.name === 'integrations-checker');
+        assert.strictEqual(intChecker.phase, 'parallel');
+    });
+    (0, node_test_1.it)('each has a definition path in agents/gswd/', () => {
+        for (const agent of specify_agents_js_1.SPECIFY_AGENTS) {
+            assert.ok(agent.definitionPath.startsWith('agents/gswd/'), `${agent.name} path wrong`);
+            assert.ok(agent.definitionPath.endsWith('.md'), `${agent.name} path not .md`);
+        }
+    });
+    (0, node_test_1.it)('each has at least one required heading', () => {
+        for (const agent of specify_agents_js_1.SPECIFY_AGENTS) {
+            assert.ok(agent.requiredHeadings.length > 0, `${agent.name} has no required headings`);
+        }
+    });
+});
+// ─── buildSpecifyAgentPrompt ────────────────────────────────────────────────
+(0, node_test_1.describe)('buildSpecifyAgentPrompt', () => {
+    (0, node_test_1.it)('journey-mapper prompt includes decisions content', () => {
+        const agent = specify_agents_js_1.SPECIFY_AGENTS.find((a) => a.name === 'journey-mapper');
+        const ctx = makeContext();
+        const prompt = (0, specify_agents_js_1.buildSpecifyAgentPrompt)(agent, ctx);
+        assert.ok(prompt.includes('Frozen Decisions'));
+    });
+    (0, node_test_1.it)('journey-mapper prompt includes imagine content', () => {
+        const agent = specify_agents_js_1.SPECIFY_AGENTS.find((a) => a.name === 'journey-mapper');
+        const ctx = makeContext({ imagineContent: 'A task manager for founders' });
+        const prompt = (0, specify_agents_js_1.buildSpecifyAgentPrompt)(agent, ctx);
+        assert.ok(prompt.includes('task manager for founders'));
+    });
+    (0, node_test_1.it)('architecture-drafter prompt includes FR list', () => {
+        const agent = specify_agents_js_1.SPECIFY_AGENTS.find((a) => a.name === 'architecture-drafter');
+        const ctx = makeContext({
+            frs: [
+                { id: 'FR-001', description: 'Create task', scope: 'v1', priority: 'P0', sourceJourneys: ['J-001'], sourceSteps: ['J-001 step 1'] },
+            ],
+        });
+        const prompt = (0, specify_agents_js_1.buildSpecifyAgentPrompt)(agent, ctx);
+        assert.ok(prompt.includes('FR-001'));
+        assert.ok(prompt.includes('Create task'));
+    });
+    (0, node_test_1.it)('integrations-checker prompt includes journey and FR context', () => {
+        const agent = specify_agents_js_1.SPECIFY_AGENTS.find((a) => a.name === 'integrations-checker');
+        const ctx = makeContext({
+            journeys: [
+                { id: 'J-001', name: 'Onboarding', type: 'onboarding', preconditions: ['User has account'], steps: [], success: 'Done', failureModes: [], acceptanceTests: [], linkedFRs: [], linkedNFRs: [] },
+            ],
+            frs: [
+                { id: 'FR-001', description: 'Sign up', scope: 'v1', priority: 'P0', sourceJourneys: ['J-001'], sourceSteps: ['J-001 step 1'] },
+            ],
+        });
+        const prompt = (0, specify_agents_js_1.buildSpecifyAgentPrompt)(agent, ctx);
+        assert.ok(prompt.includes('J-001'));
+        assert.ok(prompt.includes('FR-001'));
+    });
+    (0, node_test_1.it)('integrations-checker prompt includes auto policy', () => {
+        const agent = specify_agents_js_1.SPECIFY_AGENTS.find((a) => a.name === 'integrations-checker');
+        const ctx = makeContext({ autoPolicy: 'balanced' });
+        const prompt = (0, specify_agents_js_1.buildSpecifyAgentPrompt)(agent, ctx);
+        assert.ok(prompt.includes('balanced'));
+    });
+});
+// ─── orchestrateSpecifyAgents ───────────────────────────────────────────────
+(0, node_test_1.describe)('orchestrateSpecifyAgents', () => {
+    (0, node_test_1.it)('returns results for all agents', async () => {
+        const spawnFn = makeSpawnFn({
+            'journey-mapper': '### J-001: Onboarding',
+            'architecture-drafter': '### Components\n### Data Model',
+            'integrations-checker': '## Integrations',
+        });
+        const results = await (0, specify_agents_js_1.orchestrateSpecifyAgents)(specify_agents_js_1.SPECIFY_AGENTS, makeContext(), spawnFn);
+        assert.strictEqual(results.length, 3);
+    });
+    (0, node_test_1.it)('journey-mapper runs first (sequential phase)', async () => {
+        const order = [];
+        const spawnFn = async (prompt) => {
+            if (prompt.includes('journey-mapper')) {
+                order.push('journey-mapper');
+                // Small delay to ensure ordering visibility
+                await new Promise((r) => setTimeout(r, 10));
+            }
+            else if (prompt.includes('architecture-drafter')) {
+                order.push('architecture-drafter');
+            }
+            else if (prompt.includes('integrations-checker')) {
+                order.push('integrations-checker');
+            }
+            return 'output';
+        };
+        await (0, specify_agents_js_1.orchestrateSpecifyAgents)(specify_agents_js_1.SPECIFY_AGENTS, makeContext(), spawnFn);
+        // journey-mapper should be first
+        assert.strictEqual(order[0], 'journey-mapper');
+    });
+    (0, node_test_1.it)('parallel agents run after sequential agents complete', async () => {
+        const timestamps = {};
+        const spawnFn = async (prompt) => {
+            if (prompt.includes('journey-mapper')) {
+                timestamps['journey-mapper-start'] = Date.now();
+                await new Promise((r) => setTimeout(r, 50));
+                timestamps['journey-mapper-end'] = Date.now();
+            }
+            else if (prompt.includes('architecture-drafter')) {
+                timestamps['architecture-drafter-start'] = Date.now();
+            }
+            else if (prompt.includes('integrations-checker')) {
+                timestamps['integrations-checker-start'] = Date.now();
+            }
+            return 'output';
+        };
+        await (0, specify_agents_js_1.orchestrateSpecifyAgents)(specify_agents_js_1.SPECIFY_AGENTS, makeContext(), spawnFn);
+        // Parallel agents should start after journey-mapper ends
+        assert.ok(timestamps['architecture-drafter-start'] >= timestamps['journey-mapper-end']);
+        assert.ok(timestamps['integrations-checker-start'] >= timestamps['journey-mapper-end']);
+    });
+    (0, node_test_1.it)('failed journey-mapper still allows parallel agents to run', async () => {
+        const spawnFn = makeFailingSpawnFn('journey-mapper');
+        const results = await (0, specify_agents_js_1.orchestrateSpecifyAgents)(specify_agents_js_1.SPECIFY_AGENTS, makeContext(), spawnFn);
+        const jmResult = results.find((r) => r.agent === 'journey-mapper');
+        assert.strictEqual(jmResult.status, 'failed');
+        const adResult = results.find((r) => r.agent === 'architecture-drafter');
+        assert.strictEqual(adResult.status, 'complete');
+        const icResult = results.find((r) => r.agent === 'integrations-checker');
+        assert.strictEqual(icResult.status, 'complete');
+    });
+    (0, node_test_1.it)('all agent results collected regardless of individual failures', async () => {
+        const spawnFn = async (prompt) => {
+            if (prompt.includes('architecture-drafter')) {
+                throw new Error('Architecture agent crashed');
+            }
+            return 'output';
+        };
+        const results = await (0, specify_agents_js_1.orchestrateSpecifyAgents)(specify_agents_js_1.SPECIFY_AGENTS, makeContext(), spawnFn);
+        assert.strictEqual(results.length, 3);
+        const failedAgent = results.find((r) => r.agent === 'architecture-drafter');
+        assert.strictEqual(failedAgent.status, 'failed');
+        assert.ok(failedAgent.error?.includes('crashed'));
+    });
+    (0, node_test_1.it)('results include duration_ms', async () => {
+        const spawnFn = async () => 'output';
+        const results = await (0, specify_agents_js_1.orchestrateSpecifyAgents)(specify_agents_js_1.SPECIFY_AGENTS, makeContext(), spawnFn);
+        for (const result of results) {
+            assert.ok(typeof result.duration_ms === 'number');
+            assert.ok(result.duration_ms >= 0);
+        }
+    });
+});
+// ─── Integration validation ─────────────────────────────────────────────────
+(0, node_test_1.describe)('validateIntegration', () => {
+    (0, node_test_1.it)('valid integration passes', () => {
+        const integration = {
+            id: 'I-001',
+            name: 'SendGrid',
+            setupSteps: ['Create account', 'Get API key'],
+            authMethod: 'API key',
+            costQuota: 'Free tier: 100 emails/day',
+            fallback: 'Use SMTP directly',
+            status: 'approved',
+        };
+        const result = (0, specify_agents_js_1.validateIntegration)(integration);
+        assert.strictEqual(result.valid, true);
+        assert.strictEqual(result.errors.length, 0);
+    });
+    (0, node_test_1.it)('invalid I-XXX ID format fails', () => {
+        const integration = {
+            id: 'INVALID',
+            name: 'Test',
+            setupSteps: [],
+            authMethod: 'None',
+            costQuota: 'Free',
+            fallback: 'N/A',
+            status: 'approved',
+        };
+        const result = (0, specify_agents_js_1.validateIntegration)(integration);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some((e) => e.includes('Invalid integration ID')));
+    });
+    (0, node_test_1.it)('deferred integration without fallback fails', () => {
+        const integration = {
+            id: 'I-001',
+            name: 'Stripe',
+            setupSteps: ['Create account'],
+            authMethod: 'API key',
+            costQuota: '$25/month',
+            fallback: '',
+            status: 'deferred with fallback',
+        };
+        const result = (0, specify_agents_js_1.validateIntegration)(integration);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some((e) => e.includes('no fallback')));
+    });
+    (0, node_test_1.it)('Status field must be a valid value', () => {
+        const integration = {
+            id: 'I-001',
+            name: 'Test',
+            setupSteps: [],
+            authMethod: 'None',
+            costQuota: 'Free',
+            fallback: 'N/A',
+            status: 'maybe',
+        };
+        const result = (0, specify_agents_js_1.validateIntegration)(integration);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some((e) => e.includes('invalid status')));
+    });
+});
+// ─── Component validation ───────────────────────────────────────────────────
+(0, node_test_1.describe)('validateComponent', () => {
+    (0, node_test_1.it)('valid component passes', () => {
+        const component = {
+            id: 'C-001',
+            name: 'Auth Module',
+            responsibility: 'Handles user authentication and session management',
+            dependencies: [],
+            linkedFRs: ['FR-001', 'FR-002'],
+        };
+        const result = (0, specify_agents_js_1.validateComponent)(component);
+        assert.strictEqual(result.valid, true);
+        assert.strictEqual(result.errors.length, 0);
+    });
+    (0, node_test_1.it)('invalid C-XXX ID format fails', () => {
+        const component = {
+            id: 'COMP-1',
+            name: 'Test',
+            responsibility: 'Does stuff',
+            dependencies: [],
+            linkedFRs: [],
+        };
+        const result = (0, specify_agents_js_1.validateComponent)(component);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some((e) => e.includes('Invalid component ID')));
+    });
+    (0, node_test_1.it)('empty responsibility fails', () => {
+        const component = {
+            id: 'C-001',
+            name: 'Test',
+            responsibility: '',
+            dependencies: [],
+            linkedFRs: [],
+        };
+        const result = (0, specify_agents_js_1.validateComponent)(component);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some((e) => e.includes('empty responsibility')));
+    });
+    (0, node_test_1.it)('empty name fails', () => {
+        const component = {
+            id: 'C-001',
+            name: '',
+            responsibility: 'Does stuff',
+            dependencies: [],
+            linkedFRs: [],
+        };
+        const result = (0, specify_agents_js_1.validateComponent)(component);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some((e) => e.includes('empty name')));
+    });
+});
+// ─── VALID_INTEGRATION_STATUSES ─────────────────────────────────────────────
+(0, node_test_1.describe)('VALID_INTEGRATION_STATUSES', () => {
+    (0, node_test_1.it)('contains exactly 3 valid statuses', () => {
+        assert.strictEqual(specify_agents_js_1.VALID_INTEGRATION_STATUSES.length, 3);
+    });
+    (0, node_test_1.it)('includes approved, deferred with fallback, rejected', () => {
+        assert.ok(specify_agents_js_1.VALID_INTEGRATION_STATUSES.includes('approved'));
+        assert.ok(specify_agents_js_1.VALID_INTEGRATION_STATUSES.includes('deferred with fallback'));
+        assert.ok(specify_agents_js_1.VALID_INTEGRATION_STATUSES.includes('rejected'));
+    });
+});

package/dist/tests/specify-journeys.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Specify Journeys module tests — Journey types, scope/priority heuristics,
+ * FR extraction, bidirectional cross-linking, traceability, coverage validation
+ */
+export {};