@ontrails/trails 1.0.0-beta.2 → 1.0.0-beta.22

package/src/__tests__/survey.test.ts

@@ -1,161 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-
-import { topo, trail, Result } from '@ontrails/core';
-import {
-  generateSurfaceMap,
-  hashSurfaceMap,
-  diffSurfaceMaps,
-} from '@ontrails/schema';
-import type { SurfaceMap } from '@ontrails/schema';
-import { z } from 'zod';
-
-import { generateBriefReport } from '../trails/survey.js';
-import type { BriefReport } from '../trails/survey.js';
-
-// ---------------------------------------------------------------------------
-// Test fixtures
-// ---------------------------------------------------------------------------
-
-const helloTrail = trail('hello', {
-  description: 'Say hello',
-  detours: {
-    NotFoundError: ['search'],
-  },
-  examples: [
-    {
-      expected: { message: 'Hello, world!' },
-      input: {},
-      name: 'Default greeting',
-    },
-  ],
-  implementation: (input) => {
-    const name = input.name ?? 'world';
-    return Result.ok({ message: `Hello, ${name}!` });
-  },
-  input: z.object({ name: z.string().optional() }),
-  output: z.object({ message: z.string() }),
-  readOnly: true,
-});
-
-const byeTrail = trail('bye', {
-  description: 'Say goodbye',
-  implementation: (input) => Result.ok({ message: `Goodbye, ${input.name}!` }),
-  input: z.object({ name: z.string() }),
-  output: z.object({ message: z.string() }),
-});
-
-const app = topo('test-app', { bye: byeTrail, hello: helloTrail });
-
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-
-describe('trails survey', () => {
-  test('generateSurfaceMap includes all trails', () => {
-    const surfaceMap = generateSurfaceMap(app);
-    expect(surfaceMap.entries.length).toBe(2);
-    const ids = surfaceMap.entries.map((e) => e.id);
-    expect(ids).toContain('hello');
-    expect(ids).toContain('bye');
-  });
-
-  test('surface map entries have expected fields', () => {
-    const surfaceMap = generateSurfaceMap(app);
-    const hello = surfaceMap.entries.find((e) => e.id === 'hello');
-    expect(hello).toBeDefined();
-    expect(hello?.kind).toBe('trail');
-    expect(hello?.readOnly).toBe(true);
-    expect(hello?.exampleCount).toBe(1);
-  });
-
-  test('JSON output is valid JSON', () => {
-    const surfaceMap = generateSurfaceMap(app);
-    const json = JSON.stringify(surfaceMap, null, 2);
-    const parsed = JSON.parse(json) as SurfaceMap;
-    expect(parsed.version).toBe('1.0');
-    expect(parsed.entries.length).toBe(2);
-  });
-
-  test('hashSurfaceMap produces stable hash', () => {
-    const surfaceMap = generateSurfaceMap(app);
-    const hash1 = hashSurfaceMap(surfaceMap);
-    const hash2 = hashSurfaceMap(surfaceMap);
-    expect(hash1).toBe(hash2);
-    // SHA-256 hex
-    expect(hash1.length).toBe(64);
-  });
-
-  test('diffSurfaceMaps detects added trails', () => {
-    const prev = generateSurfaceMap(topo('test', { hello: helloTrail }));
-    const curr = generateSurfaceMap(app);
-    const diff = diffSurfaceMaps(prev, curr);
-
-    expect(diff.info.length).toBeGreaterThan(0);
-    const addedBye = diff.info.find((e) => e.id === 'bye');
-    expect(addedBye).toBeDefined();
-    expect(addedBye?.change).toBe('added');
-  });
-
-  test('diffSurfaceMaps detects removed trails', () => {
-    const prev = generateSurfaceMap(app);
-    const curr = generateSurfaceMap(topo('test', { hello: helloTrail }));
-    const diff = diffSurfaceMaps(prev, curr);
-
-    expect(diff.hasBreaking).toBe(true);
-    const removedBye = diff.breaking.find((e) => e.id === 'bye');
-    expect(removedBye).toBeDefined();
-    expect(removedBye?.change).toBe('removed');
-  });
-
-  test('diffSurfaceMaps returns empty for identical maps', () => {
-    const map = generateSurfaceMap(app);
-    const diff = diffSurfaceMaps(map, map);
-    expect(diff.entries.length).toBe(0);
-    expect(diff.hasBreaking).toBe(false);
-  });
-});
-
-// ---------------------------------------------------------------------------
-// Brief mode (formerly scout)
-// ---------------------------------------------------------------------------
-
-describe('trails survey --brief', () => {
-  test('produces a valid capability report', () => {
-    const report = generateBriefReport(app);
-    expect(report.name).toBe('test-app');
-    expect(report.contractVersion).toBe('2026-03');
-  });
-
-  test('report includes correct trail count', () => {
-    const report = generateBriefReport(app);
-    expect(report.trails).toBe(2);
-    expect(report.hikes).toBe(0);
-    expect(report.events).toBe(0);
-  });
-
-  test('detects features in use', () => {
-    const report = generateBriefReport(app);
-    expect(report.features.outputSchemas).toBe(true);
-    expect(report.features.examples).toBe(true);
-    expect(report.features.detours).toBe(true);
-    expect(report.features.hikes).toBe(false);
-    expect(report.features.events).toBe(false);
-  });
-
-  test('JSON output is valid', () => {
-    const report = generateBriefReport(app);
-    const json = JSON.stringify(report, null, 2);
-    const parsed = JSON.parse(json) as BriefReport;
-    expect(parsed.name).toBe('test-app');
-    expect(parsed.trails).toBe(2);
-  });
-
-  test('empty app reports zero features', () => {
-    const emptyApp = topo('empty', {});
-    const report = generateBriefReport(emptyApp);
-    expect(report.trails).toBe(0);
-    expect(report.features.outputSchemas).toBe(false);
-    expect(report.features.examples).toBe(false);
-    expect(report.features.detours).toBe(false);
-  });
-});

package/src/__tests__/warden.test.ts

@@ -1,74 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-import { mkdirSync, rmSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-
-import { formatWardenReport, runWarden } from '@ontrails/warden';
-
-const makeTempDir = (): string => {
-  const dir = join(
-    tmpdir(),
-    `trails-warden-test-${Date.now()}-${Math.random().toString(36).slice(2)}`
-  );
-  mkdirSync(dir, { recursive: true });
-  return dir;
-};
-
-describe('trails warden', () => {
-  test('runs lint + drift checks and produces a report', async () => {
-    const dir = makeTempDir();
-    try {
-      writeFileSync(
-        join(dir, 'good.ts'),
-        `trail("hello", {
-  implementation: async (input, ctx) => {
-    return Result.ok({ message: "hi" });
-  }
-})`
-      );
-
-      const report = await runWarden({ rootDir: dir });
-      expect(report.diagnostics).toBeDefined();
-      expect(typeof report.errorCount).toBe('number');
-      expect(typeof report.warnCount).toBe('number');
-      expect(typeof report.passed).toBe('boolean');
-    } finally {
-      rmSync(dir, { force: true, recursive: true });
-    }
-  });
-
-  test('lintOnly skips drift detection', async () => {
-    const dir = makeTempDir();
-    try {
-      writeFileSync(join(dir, 'empty.ts'), 'export {}');
-      const report = await runWarden({ lintOnly: true, rootDir: dir });
-      expect(report.drift).toBeNull();
-    } finally {
-      rmSync(dir, { force: true, recursive: true });
-    }
-  });
-
-  test('driftOnly skips lint rules', async () => {
-    const dir = makeTempDir();
-    try {
-      writeFileSync(
-        join(dir, 'bad.ts'),
-        `trail("x", {
-  implementation: async () => { throw new Error("boom"); }
-})`
-      );
-      const report = await runWarden({ driftOnly: true, rootDir: dir });
-      expect(report.diagnostics.length).toBe(0);
-      expect(report.drift).not.toBeNull();
-    } finally {
-      rmSync(dir, { force: true, recursive: true });
-    }
-  });
-
-  test('formatWardenReport produces human-readable output', async () => {
-    const report = await runWarden({ rootDir: '/dev/null' });
-    const output = formatWardenReport(report);
-    expect(output).toContain('Warden Report');
-    expect(typeof output).toBe('string');
-  });
-});

package/tsconfig.json

@@ -1,9 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "."
-  },
-  "include": ["src", "bin"],
-  "exclude": ["**/__tests__/**", "**/*.test.ts", "dist"]
-}