@ontrails/testing 1.0.0-beta.42 → 1.0.0-beta.43

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @ontrails/testing
 
+## 1.0.0-beta.43
+
+### Minor Changes
+
+- [`88a6a62`](https://github.com/outfitter-dev/trails/commit/88a6a62a9e9e230ca6d368fa78dc3ece6c816204): Complete the v1 classification-first cutover from projection/project vocabulary
+  to derive/derived for contract-owned fact production and render/rendered for
+  surface presentation. Public type, helper, rule, relation, and report names move
+  without compatibility aliases; ordinary repository/project nouns remain
+  explicit preserves or structured review inventory.
+
+### Patch Changes
+
+- [`113aed6`](https://github.com/outfitter-dev/trails/commit/113aed62d20041e35b0cf9d6c1b1a18df4b88f57): Rename the dependency-light observability owner from `@ontrails/observe` to
+  `@ontrails/observability` as a pre-v1 hard cut. Update dependent packages,
+  documentation, package discovery, and the governed Regrade route; no
+  compatibility package or old import route is retained.
+
 ## 1.0.0-beta.42
 
 ## 1.0.0-beta.41

package/README.md

@@ -91,7 +91,7 @@ Calls to unregistered trail IDs return `Result.err` with a descriptive message,
 
 ## Surface Harnesses
 
-Surface harnesses live on explicit subpaths so projects that only import contract helpers from `@ontrails/testing` do not need CLI, MCP, or HTTP peers. Install the peer package for the subpath you use:
+Surface harnesses live on explicit subpaths so renders that only import contract helpers from `@ontrails/testing` do not need CLI, MCP, or HTTP peers. Install the peer package for the subpath you use:
 
 - `@ontrails/testing/cli` requires `@ontrails/cli`
 - `@ontrails/testing/mcp` requires `@ontrails/mcp`
@@ -120,7 +120,7 @@ const response = await http.get('/entity/show', { name: 'Alpha' });
 expect(response.status).toBe(200);
 ```
 
-Use `testAllEstablished()` from `@ontrails/testing/established` when an established app should run the root contract suite and validate CLI, MCP, and HTTP projections in one call.
+Use `testAllEstablished()` from `@ontrails/testing/established` when an established app should run the root contract suite and validate CLI, MCP, and HTTP renderings in one call.
 
 ## Surface Parity
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontrails/testing",
-  "version": "1.0.0-beta.42",
+  "version": "1.0.0-beta.43",
   "files": [
     "src/**/*.ts",
     "!src/**/__tests__/**",
@@ -27,15 +27,15 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "devDependencies": {
-    "@ontrails/drizzle": "^1.0.0-beta.42",
-    "@ontrails/store": "^1.0.0-beta.42"
+    "@ontrails/drizzle": "^1.0.0-beta.43",
+    "@ontrails/store": "^1.0.0-beta.43"
   },
   "peerDependencies": {
-    "@ontrails/cli": "^1.0.0-beta.42",
-    "@ontrails/core": "^1.0.0-beta.42",
-    "@ontrails/http": "^1.0.0-beta.42",
-    "@ontrails/mcp": "^1.0.0-beta.42",
-    "@ontrails/observe": "^1.0.0-beta.42",
+    "@ontrails/cli": "^1.0.0-beta.43",
+    "@ontrails/core": "^1.0.0-beta.43",
+    "@ontrails/http": "^1.0.0-beta.43",
+    "@ontrails/mcp": "^1.0.0-beta.43",
+    "@ontrails/observability": "^1.0.0-beta.43",
     "zod": "^4.3.5"
   },
   "peerDependenciesMeta": {

package/src/all-established.ts

@@ -1,5 +1,5 @@
 /**
- * testAllEstablished - contract suite plus shipped surface projection checks.
+ * testAllEstablished - contract suite plus shipped surface rendering checks.
  *
  * This helper intentionally lives behind a surface subpath so root
  * `@ontrails/testing` imports do not pull CLI, MCP, or HTTP peers into
@@ -125,21 +125,21 @@ const registerEstablishedSurfaceSuite = (
     | undefined
 ): void => {
   describe('surfaces', () => {
-    test('CLI projection validates established topo', () => {
+    test('CLI rendering validates established topo', () => {
       const options = normalizeEstablishedOptions(resolveInput());
       expect(() =>
         createCliHarness(toCliHarnessOptions(topo, options))
       ).not.toThrow();
     });
 
-    test('MCP projection validates established topo', () => {
+    test('MCP rendering validates established topo', () => {
       const options = normalizeEstablishedOptions(resolveInput());
       expect(() =>
         createMcpHarness(toMcpHarnessOptions(topo, options))
       ).not.toThrow();
     });
 
-    test('HTTP projection validates established topo', () => {
+    test('HTTP rendering validates established topo', () => {
       const options = normalizeEstablishedOptions(resolveInput());
       expect(() =>
         createHttpHarness(toHttpHarnessOptions(topo, options))

package/src/effective-examples.ts

@@ -216,7 +216,7 @@ const buildDerivedInput = (
 };
 
 /**
- * Project the merged candidate input down to keys the trail's input schema
+ * Derive the merged candidate input down to keys the trail's input schema
  * knows about.
  *
  * `buildDerivedInput` emits synthesized prefixed aliases (e.g. `userEmail`)
@@ -227,7 +227,7 @@ const buildDerivedInput = (
  * before validation. Non-object inputs pass through unchanged — they are
  * validated as-is and can decide for themselves.
  */
-const projectInputForSchema = (
+const deriveInputForSchema = (
   inputSchema: Trail<unknown, unknown, unknown>['input'],
   candidate: Record<string, unknown>
 ): Record<string, unknown> => {
@@ -236,13 +236,13 @@ const projectInputForSchema = (
   }
 
   const known = Object.keys(inputSchema.shape);
-  const projected: Record<string, unknown> = {};
+  const derived: Record<string, unknown> = {};
   for (const key of known) {
     if (Object.hasOwn(candidate, key)) {
-      projected[key] = candidate[key];
+      derived[key] = candidate[key];
     }
   }
-  return projected;
+  return derived;
 };
 
 /**
@@ -344,7 +344,7 @@ export const deriveTrailExamples = (
 
   return fixtureSets.flatMap((fixtures, index) => {
     const merged = buildDerivedInput(fixtures);
-    const input = projectInputForSchema(trail.input, merged);
+    const input = deriveInputForSchema(trail.input, merged);
     const validated = trail.input.safeParse(input);
     if (!validated.success) {
       return [];

package/src/harness-cli.ts

@@ -8,7 +8,7 @@
 import { deriveCliCommands } from '@ontrails/cli';
 import type { CliCommand, DeriveCliCommandsOptions } from '@ontrails/cli';
 import type { Topo, TrailContext } from '@ontrails/core';
-import { projectPublicSurfaceError } from '@ontrails/core';
+import { renderPublicSurfaceError } from '@ontrails/core';
 
 import { mergeTestContext } from './context.js';
 
@@ -235,15 +235,15 @@ const buildErrorResult = (
 ): CliHarnessResult => {
   streams.restore();
   const actualError = error instanceof Error ? error : new Error(String(error));
-  const projection = projectPublicSurfaceError('cli', actualError);
+  const rendering = renderPublicSurfaceError('cli', actualError);
   return {
     error: {
-      category: projection.category,
-      code: projection.name,
-      message: projection.message,
+      category: rendering.category,
+      code: rendering.name,
+      message: rendering.message,
     },
     exitCode: 1,
-    stderr: streams.getStderr() || projection.message,
+    stderr: streams.getStderr() || rendering.message,
     stdout: streams.getStdout(),
   };
 };
@@ -260,15 +260,15 @@ const executeCommand = async (
   streams.restore();
 
   if (result.isErr()) {
-    const projection = projectPublicSurfaceError('cli', result.error);
+    const rendering = renderPublicSurfaceError('cli', result.error);
     return {
       error: {
-        category: projection.category,
-        code: projection.name,
-        message: projection.message,
+        category: rendering.category,
+        code: rendering.name,
+        message: rendering.message,
       },
       exitCode: 1,
-      stderr: streams.getStderr() || projection.message,
+      stderr: streams.getStderr() || rendering.message,
       stdout: streams.getStdout(),
     };
   }

package/src/harness-http.ts

@@ -13,7 +13,7 @@ import type {
   HttpRouteDefinition,
 } from '@ontrails/http';
 import type { Topo, TrailContext, TrailContextInit } from '@ontrails/core';
-import { NotFoundError, projectPublicSurfaceError } from '@ontrails/core';
+import { NotFoundError, renderPublicSurfaceError } from '@ontrails/core';
 
 import { mergeTestContext } from './context.js';
 
@@ -40,7 +40,7 @@ export interface HttpHarnessRequestOptions extends Omit<
   readonly query?: Record<string, unknown> | undefined;
 }
 
-/** A test harness for HTTP route projections. */
+/** A test harness for HTTP route renderings. */
 export interface HttpHarness {
   /** Execute a raw HTTP-style harness request. */
   request(request: HttpHarnessRequest): Promise<HttpHarnessResult>;
@@ -126,19 +126,19 @@ const findRoute = (
   routes.find((route) => route.method === method && route.path === path);
 
 const mapError = (error: Error): HttpHarnessResult => {
-  const projection = projectPublicSurfaceError('http', error);
+  const rendering = renderPublicSurfaceError('http', error);
   const body = {
     error: {
-      category: projection.category,
-      code: projection.name,
-      message: projection.message,
+      category: rendering.category,
+      code: rendering.name,
+      message: rendering.message,
     },
   };
   return {
     body,
     error: body.error,
     ok: false,
-    status: projection.code,
+    status: rendering.code,
   };
 };
 

package/src/logger.ts

@@ -2,7 +2,7 @@
  * Test logger that captures log records for assertion.
  */
 
-import type { LogLevel, LogRecord } from '@ontrails/observe';
+import type { LogLevel, LogRecord } from '@ontrails/observability';
 
 import type { TestLogger } from './types.js';
 

package/src/types.ts

@@ -3,7 +3,7 @@
  */
 
 import type { AnyTrail, Logger, TraceFn } from '@ontrails/core';
-import type { LogLevel, LogRecord } from '@ontrails/observe';
+import type { LogLevel, LogRecord } from '@ontrails/observability';
 
 // ---------------------------------------------------------------------------
 // Test Scenario (for testTrail)