@ontrails/cloudflare 1.0.0-beta.41 → 1.0.0-beta.43

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ontrails/cloudflare
 
+## 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.
+
+## 1.0.0-beta.42
+
 ## 1.0.0-beta.41
 
 ## 1.0.0-beta.40

package/README.md

@@ -14,7 +14,7 @@ Adapter composition doctrine applies throughout: subpaths take primitive-authore
 
 ## `/workers` — the Worker materializer
 
-`createWorkersHandler(graph, options)` produces the Worker export for Cloudflare runtime entrypoints. Its `fetch(request, env, ctx)` member delegates to the shared HTTP fetch kernel from `@ontrails/http` — the same kernel behind the Bun and Hono surfaces, so routes, validation, error projection, and webhook handling behave identically. Its `queue(batch, env, ctx)` member dispatches first-class core `queue()` activation sources through the `/queues` materializer.
+`createWorkersHandler(graph, options)` produces the Worker export for Cloudflare runtime entrypoints. Its `fetch(request, env, ctx)` member delegates to the shared HTTP fetch kernel from `@ontrails/http` — the same kernel behind the Bun and Hono surfaces, so routes, validation, error rendering, and webhook handling behave identically. Its `queue(batch, env, ctx)` member dispatches first-class core `queue()` activation sources through the `/queues` materializer.
 
 ```ts
 // src/worker.ts
@@ -182,7 +182,7 @@ binding = "ASSETS"
 bucket_name = "my-assets"
 ```
 
-The resource surface follows the R2 Worker binding structurally. A real R2 bucket binding passes through unchanged, including Cloudflare's conditional operation behavior where `get()` can return metadata without a body and `put()` can return `null` when a precondition fails. `r2ObjectToBlobRef(object)` is the small bridge from a fetched R2 object body to core's `BlobRef` binary-output contract; the HTTP and MCP surfaces already know how to project `blobRefSchema`.
+The resource surface follows the R2 Worker binding structurally. A real R2 bucket binding passes through unchanged, including Cloudflare's conditional operation behavior where `get()` can return metadata without a body and `put()` can return `null` when a precondition fails. `r2ObjectToBlobRef(object)` is the small bridge from a fetched R2 object body to core's `BlobRef` binary-output contract; the HTTP and MCP surfaces already know how to render `blobRefSchema`.
 
 Capability boundaries are explicit:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontrails/cloudflare",
-  "version": "1.0.0-beta.41",
+  "version": "1.0.0-beta.43",
   "files": [
     "src/**/*.ts",
     "!src/**/__tests__/**",
@@ -27,16 +27,16 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@ontrails/core": "^1.0.0-beta.41"
+    "@ontrails/core": "^1.0.0-beta.43"
   },
   "devDependencies": {
-    "@ontrails/adapter-kit": "^1.0.0-beta.41",
-    "@ontrails/testing": "^1.0.0-beta.41",
+    "@ontrails/adapter-kit": "^1.0.0-beta.43",
+    "@ontrails/testing": "^1.0.0-beta.43",
     "miniflare": "^4.20250617.4"
   },
   "peerDependencies": {
-    "@ontrails/http": "^1.0.0-beta.41",
-    "@ontrails/store": "^1.0.0-beta.41",
+    "@ontrails/http": "^1.0.0-beta.43",
+    "@ontrails/store": "^1.0.0-beta.43",
     "zod": "^4.3.5"
   },
   "trails": {

package/src/facts.ts

@@ -1,7 +1,7 @@
 /**
  * Cloudflare lock facts.
  *
- * The adapter's `trails.lock` overlay overlay: `derive` projects the
+ * The adapter's `trails.lock` overlay overlay: `derive` derives the
  * topo's env-bound resources (resources with a registered
  * {@link EnvBindingSpec | env binding}, such as every `cloudflareKv`
  * definition) into `overlays.cloudflare`, listing the wrangler binding name

package/src/queues/index.ts

@@ -18,7 +18,7 @@ import {
   getTraceSink,
   isTrailsError,
   matchesTrailPattern,
-  projectActivationSourceDeclaration,
+  deriveActivationSourceFacts,
   resource,
   run,
   traceContextFromRecord,
@@ -402,7 +402,7 @@ const collectQueueConsumers = (
 
 const queueInputContractSignature = (source: QueueSource): string =>
   JSON.stringify(
-    projectActivationSourceDeclaration(source)['parseOutputSchema'] ?? null
+    deriveActivationSourceFacts(source)['parseOutputSchema'] ?? null
   );
 
 const assertQueueSourceCompatibility = (

package/src/r2/index.ts

@@ -4,7 +4,7 @@
  * `cloudflareR2` authors an ordinary resource definition for an R2 bucket
  * binding. Trails can store and fetch object bytes through the standard
  * resource accessor, then return `BlobRef` values when HTTP/MCP surfaces should
- * project the fetched object as binary output.
+ * render the fetched object as binary output.
  */
 
 import {

package/src/workers/index.ts

@@ -13,8 +13,8 @@
  */
 
 import {
-  projectErrorDiagnostics,
-  projectPublicSurfaceError,
+  renderErrorDiagnostics,
+  renderPublicSurfaceError,
 } from '@ontrails/core';
 import type {
   BaseSurfaceOptions,
@@ -104,7 +104,7 @@ export interface CloudflareWorker {
 
 /**
  * Map a materialization failure (route derivation, env bridge resolution) to
- * a projected HTTP error response. Route execution errors never reach this
+ * a rendered HTTP error response. Route execution errors never reach this
  * path — the fetch kernel maps those itself.
  */
 const mapCaughtError = (error: unknown): Response => {
@@ -113,18 +113,18 @@ const mapCaughtError = (error: unknown): Response => {
   // diagnostics to the Worker log while the response stays redacted.
   console.error(
     '[ontrails:cloudflare/workers] Failed to materialize request handler',
-    projectErrorDiagnostics(err)
+    renderErrorDiagnostics(err)
   );
-  const projection = projectPublicSurfaceError('http', err);
+  const rendering = renderPublicSurfaceError('http', err);
   return Response.json(
     {
       error: {
-        category: projection.category,
-        code: projection.name,
-        message: projection.message,
+        category: rendering.category,
+        code: rendering.name,
+        message: rendering.message,
       },
     },
-    { status: projection.code }
+    { status: rendering.code }
   );
 };
 
@@ -135,7 +135,7 @@ const mapCaughtQueueError = (
   const err = error instanceof Error ? error : new Error(String(error));
   console.error(
     '[ontrails:cloudflare/workers] Failed to materialize queue handler',
-    projectErrorDiagnostics(err)
+    renderErrorDiagnostics(err)
   );
   batch.retryAll();
 };