@substrate-ai/core 0.19.54

package/dist/__tests__/output-quality.test.js

@@ -0,0 +1,166 @@
+/**
+ * Unit tests for packages/core/src/dispatch/output-quality.ts
+ *
+ * Tests the estimateOutputQuality function which analyzes raw agent stdout
+ * for quality signals before YAML extraction and schema validation.
+ */
+import { describe, it, expect } from 'vitest';
+import { estimateOutputQuality } from '../dispatch/output-quality.js';
+describe('estimateOutputQuality', () => {
+    // -------------------------------------------------------------------------
+    // Empty / null input
+    // -------------------------------------------------------------------------
+    describe('empty input', () => {
+        it('returns score 0 for empty string', () => {
+            const result = estimateOutputQuality('');
+            expect(result.qualityScore).toBe(0);
+            expect(result.outputLength).toBe(0);
+        });
+        it('returns score 0 for whitespace-only string', () => {
+            const result = estimateOutputQuality('   \n\n  ');
+            expect(result.qualityScore).toBe(0);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // Hedging detection
+    // -------------------------------------------------------------------------
+    describe('hedging detection', () => {
+        it('detects "I couldn\'t" hedging', () => {
+            const result = estimateOutputQuality("I couldn't figure out how to implement the TLA+ spec.");
+            expect(result.hedgingCount).toBeGreaterThanOrEqual(1);
+            expect(result.hedgingPhrases.length).toBeGreaterThanOrEqual(1);
+        });
+        it('detects "I was unable to" hedging', () => {
+            const result = estimateOutputQuality('I was unable to resolve the import error.');
+            expect(result.hedgingCount).toBeGreaterThanOrEqual(1);
+        });
+        it('detects TODO markers as hedging', () => {
+            const result = estimateOutputQuality('TODO: implement the circuit breaker logic');
+            expect(result.hedgingCount).toBeGreaterThanOrEqual(1);
+        });
+        it('multiple hedging phrases reduce score', () => {
+            const output = "I couldn't run the tests. I was unable to find the config. I skipped the integration tests.";
+            const result = estimateOutputQuality(output);
+            expect(result.hedgingCount).toBeGreaterThanOrEqual(2);
+            expect(result.qualityScore).toBeLessThan(30);
+        });
+        it('reports no hedging for clean output', () => {
+            const output = 'Implemented the payment idempotency spec.\n\n```yaml\nresult: success\n```';
+            const result = estimateOutputQuality(output);
+            expect(result.hedgingCount).toBe(0);
+            expect(result.hedgingPhrases).toEqual([]);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // Test execution / results detection
+    // -------------------------------------------------------------------------
+    describe('test detection', () => {
+        it('detects test execution mentions', () => {
+            const result = estimateOutputQuality('Running the tests with npm test...');
+            expect(result.mentionsTestExecution).toBe(true);
+        });
+        it('detects vitest execution', () => {
+            const result = estimateOutputQuality('npx vitest run src/foo.test.ts');
+            expect(result.mentionsTestExecution).toBe(true);
+        });
+        it('detects test pass', () => {
+            const result = estimateOutputQuality('All tests passed. 42 passing.');
+            expect(result.mentionsTestPass).toBe(true);
+        });
+        it('detects test failure', () => {
+            const result = estimateOutputQuality('3 tests failed in foo.test.ts');
+            expect(result.mentionsTestFailure).toBe(true);
+        });
+        it('test pass boosts score', () => {
+            const withPass = estimateOutputQuality('Tests passed.\n\n```yaml\nresult: success\n```');
+            const without = estimateOutputQuality('Done.\n\n```yaml\nresult: success\n```');
+            expect(withPass.qualityScore).toBeGreaterThan(without.qualityScore);
+        });
+        it('test failure reduces score', () => {
+            const withFail = estimateOutputQuality('Tests failed.\n\n```yaml\nresult: success\n```');
+            const without = estimateOutputQuality('Done.\n\n```yaml\nresult: success\n```');
+            expect(withFail.qualityScore).toBeLessThan(without.qualityScore);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // YAML block detection
+    // -------------------------------------------------------------------------
+    describe('YAML block detection', () => {
+        it('boosts score significantly when YAML block is present', () => {
+            const withYaml = estimateOutputQuality('Done.\n\n```yaml\nresult: success\nac_met:\n  - AC1\n```');
+            const without = estimateOutputQuality('Done. I implemented everything successfully.');
+            expect(withYaml.qualityScore).toBeGreaterThan(without.qualityScore + 10);
+        });
+        it('detects unfenced YAML starting with result:', () => {
+            // Short output triggers length penalty (-20), but YAML detection (+20) offsets it
+            const result = estimateOutputQuality('Some output...\nresult: success\nac_met:\n  - AC1');
+            // Base 30 + YAML +20 - short -20 = 30
+            expect(result.qualityScore).toBeGreaterThanOrEqual(25);
+        });
+        it('penalizes long output without YAML block', () => {
+            const longNoYaml = estimateOutputQuality('x'.repeat(2000));
+            expect(longNoYaml.qualityScore).toBeLessThan(30);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // File modification detection
+    // -------------------------------------------------------------------------
+    describe('file modification detection', () => {
+        it('counts file modification mentions', () => {
+            const output = 'Created file src/specs/payment.tla\nModified file package.json\nUpdated src/index.ts';
+            const result = estimateOutputQuality(output);
+            expect(result.fileModificationMentions).toBeGreaterThanOrEqual(2);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // Error detection
+    // -------------------------------------------------------------------------
+    describe('error detection', () => {
+        it('detects TypeError mentions', () => {
+            const result = estimateOutputQuality('TypeError: Cannot read property of undefined');
+            expect(result.mentionsErrors).toBe(true);
+        });
+        it('detects compilation errors', () => {
+            const result = estimateOutputQuality('compilation failed: missing semicolon at line 42');
+            expect(result.mentionsErrors).toBe(true);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // Score calibration
+    // -------------------------------------------------------------------------
+    describe('score calibration', () => {
+        it('ideal output (YAML + tests pass + file mods) scores high', () => {
+            const output = [
+                'Implemented the spec. Created file specs/tla/Payment.tla.',
+                'Running the tests... All tests passed.',
+                '```yaml',
+                'result: success',
+                'ac_met:',
+                '  - AC1',
+                '  - AC2',
+                'files_modified:',
+                '  - specs/tla/Payment.tla',
+                'tests: pass',
+                '```',
+            ].join('\n');
+            const result = estimateOutputQuality(output);
+            expect(result.qualityScore).toBeGreaterThanOrEqual(70);
+        });
+        it('bad output (hedging + no YAML + errors) scores low', () => {
+            const output = "I couldn't implement the spec. TypeError: module not found. I was unable to run the tests.";
+            const result = estimateOutputQuality(output);
+            expect(result.qualityScore).toBeLessThanOrEqual(20);
+        });
+        it('score is clamped to 0-100 range', () => {
+            // Extremely bad output
+            const bad = estimateOutputQuality("I couldn't. I was unable. I skipped. TODO: everything.");
+            expect(bad.qualityScore).toBeGreaterThanOrEqual(0);
+            expect(bad.qualityScore).toBeLessThanOrEqual(100);
+        });
+        it('short output is penalized', () => {
+            const short = estimateOutputQuality('ok');
+            expect(short.qualityScore).toBeLessThan(20);
+        });
+    });
+});
+//# sourceMappingURL=output-quality.test.js.map

package/dist/__tests__/output-quality.test.js.map

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

package/dist/__tests__/schema-suffix.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Unit tests for schema-aware YAML suffix generation.
+ *
+ * Tests extractSchemaFields and buildYamlOutputSuffix which introspect Zod
+ * schemas to produce field-specific YAML output format instructions for
+ * non-Claude agent backends.
+ */
+export {};
+//# sourceMappingURL=schema-suffix.test.d.ts.map

package/dist/__tests__/schema-suffix.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-suffix.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schema-suffix.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/schema-suffix.test.js

@@ -0,0 +1,126 @@
+/**
+ * Unit tests for schema-aware YAML suffix generation.
+ *
+ * Tests extractSchemaFields and buildYamlOutputSuffix which introspect Zod
+ * schemas to produce field-specific YAML output format instructions for
+ * non-Claude agent backends.
+ */
+import { describe, it, expect } from 'vitest';
+import { z } from 'zod';
+import { extractSchemaFields, buildYamlOutputSuffix } from '../dispatch/dispatcher-impl.js';
+describe('extractSchemaFields', () => {
+    it('extracts field names from a simple Zod object', () => {
+        const schema = z.object({
+            result: z.string(),
+            count: z.number(),
+        });
+        const fields = extractSchemaFields(schema);
+        expect(fields).toContain('result: <string>');
+        expect(fields).toContain('count: <number>');
+    });
+    it('handles enum fields with values', () => {
+        const schema = z.object({
+            result: z.enum(['success', 'failed']),
+        });
+        const fields = extractSchemaFields(schema);
+        expect(fields).toContain('result: success | failed');
+    });
+    it('handles array fields', () => {
+        const schema = z.object({
+            files_modified: z.array(z.string()),
+        });
+        const fields = extractSchemaFields(schema);
+        expect(fields).toContain('files_modified: <list>');
+    });
+    it('handles optional fields', () => {
+        const schema = z.object({
+            notes: z.string().optional(),
+        });
+        const fields = extractSchemaFields(schema);
+        expect(fields).toContain('notes: <string>');
+    });
+    it('handles default fields', () => {
+        const schema = z.object({
+            ac_met: z.array(z.string()).default([]),
+        });
+        const fields = extractSchemaFields(schema);
+        expect(fields).toContain('ac_met: <list>');
+    });
+    it('handles preprocess/transform (ZodEffects) on object', () => {
+        const schema = z.object({
+            result: z.preprocess((val) => val, z.string()),
+            verdict: z.enum(['SHIP_IT', 'NEEDS_MINOR_FIXES']),
+        }).transform((data) => ({ ...data, extra: true }));
+        const fields = extractSchemaFields(schema);
+        expect(fields).toContain('result: <string>');
+        expect(fields).toContain('verdict: SHIP_IT | NEEDS_MINOR_FIXES');
+    });
+    it('handles boolean fields', () => {
+        const schema = z.object({
+            enabled: z.boolean(),
+        });
+        const fields = extractSchemaFields(schema);
+        expect(fields).toContain('enabled: <boolean>');
+    });
+    it('handles nested object fields', () => {
+        const schema = z.object({
+            metadata: z.object({ key: z.string() }),
+        });
+        const fields = extractSchemaFields(schema);
+        expect(fields).toContain('metadata: <object>');
+    });
+    it('returns empty array for non-object schema', () => {
+        expect(extractSchemaFields(z.string())).toEqual([]);
+        expect(extractSchemaFields(null)).toEqual([]);
+        expect(extractSchemaFields(undefined)).toEqual([]);
+    });
+    it('works with DevStoryResultSchema-like schema', () => {
+        const schema = z.object({
+            result: z.enum(['success', 'failed']),
+            ac_met: z.array(z.string()).default([]),
+            ac_failures: z.array(z.string()).default([]),
+            files_modified: z.array(z.string()).default([]),
+            tests: z.enum(['pass', 'fail']),
+            notes: z.string().optional(),
+        });
+        const fields = extractSchemaFields(schema);
+        expect(fields).toHaveLength(6);
+        expect(fields).toContain('result: success | failed');
+        expect(fields).toContain('ac_met: <list>');
+        expect(fields).toContain('tests: pass | fail');
+        expect(fields).toContain('notes: <string>');
+    });
+});
+describe('buildYamlOutputSuffix', () => {
+    it('includes actual field names when schema is provided', () => {
+        const schema = z.object({
+            result: z.enum(['success', 'failed']),
+            files_modified: z.array(z.string()),
+        });
+        const suffix = buildYamlOutputSuffix(schema);
+        expect(suffix).toContain('result: success | failed');
+        expect(suffix).toContain('files_modified: <list>');
+        expect(suffix).toContain('```yaml');
+        expect(suffix).toContain('IMPORTANT');
+    });
+    it('falls back to generic format when no schema provided', () => {
+        const suffix = buildYamlOutputSuffix(undefined);
+        expect(suffix).toContain('result: success');
+        expect(suffix).toContain('additional fields');
+    });
+    it('falls back to generic format when schema is null', () => {
+        const suffix = buildYamlOutputSuffix(null);
+        expect(suffix).toContain('result: success');
+    });
+    it('includes YAML fence markers', () => {
+        const suffix = buildYamlOutputSuffix(z.object({ result: z.string() }));
+        expect(suffix).toContain('```yaml');
+        expect(suffix).toContain('```');
+    });
+    it('instructs agent to emit YAML as last output', () => {
+        const suffix = buildYamlOutputSuffix();
+        expect(suffix).toContain('MUST be the last thing');
+        expect(suffix).toContain('Do not add any text after');
+    });
+});
+//# sourceMappingURL=schema-suffix.test.js.map

package/dist/__tests__/schema-suffix.test.js.map

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

package/dist/__tests__/yaml-parser.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Unit tests for packages/core/src/dispatch/yaml-parser.ts
+ *
+ * Tests the two primary exports:
+ * - extractYamlBlock(): extraction of YAML from agent output
+ * - parseYamlResult(): parsing and optional Zod schema validation
+ *
+ * Covers:
+ * - Fenced YAML extraction (```yaml...```)
+ * - Multiple fenced blocks (takes the last one)
+ * - Unfenced YAML extraction via anchor keys
+ * - Empty/null input handling
+ * - YAML parse errors
+ * - Schema validation success/failure
+ * - Invalid escape sanitization (\$ -> $)
+ */
+export {};
+//# sourceMappingURL=yaml-parser.test.d.ts.map

package/dist/__tests__/yaml-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-parser.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/yaml-parser.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}