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

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @ontrails/commander
 
+## 1.0.0-beta.43
+
+### Patch 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
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontrails/commander",
-  "version": "1.0.0-beta.42",
+  "version": "1.0.0-beta.43",
   "files": [
     "src/**/*.ts",
     "!src/**/__tests__/**",
@@ -22,8 +22,8 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@ontrails/cli": "^1.0.0-beta.42",
-    "@ontrails/core": "^1.0.0-beta.42",
+    "@ontrails/cli": "^1.0.0-beta.43",
+    "@ontrails/core": "^1.0.0-beta.43",
     "commander": "^14.0.3"
   },
   "peerDependencies": {

package/src/surface.ts

@@ -38,7 +38,7 @@ export interface CreateProgramOptions extends BaseSurfaceOptions {
   /**
    * App-authored overlay envelopes (conventionally the app module's
    * `trailsOverlays` export); the `surfaces` envelope's `cli` bindings
-   * project synonym and command-group routes onto the program.
+   * render synonym and command-group routes onto the program.
    */
   readonly overlays?: readonly OverlayEnvelopeLike[] | undefined;
   readonly presets?: CliFlag[][] | undefined;

package/src/to-commander.ts

@@ -4,12 +4,12 @@
 
 import {
   isTrailsError,
-  projectPublicSurfaceError,
+  renderPublicSurfaceError,
   redactErrorContext,
   redactErrorString,
   ValidationError,
 } from '@ontrails/core';
-import type { SurfaceErrorProjection } from '@ontrails/core';
+import type { SurfaceErrorRendering } from '@ontrails/core';
 import type { CliCommand, CliFlag } from '@ontrails/cli';
 import {
   applyCliFlagValueAliases,
@@ -511,7 +511,7 @@ const collectPermitScopeLines = (
 /**
  * Collect operator-facing detail lines for an execution error.
  *
- * The public surface projection intentionally drops structured context, but
+ * The public surface rendering intentionally drops structured context, but
  * the CLI is an operator surface: validation issues and permit scope
  * requirements are what the operator needs to act, so they are re-rendered
  * here (through the shared redactor) for non-internal Trails errors.
@@ -542,7 +542,7 @@ const collectErrorContext = (
 interface CliErrorEnvelope {
   readonly ok: false;
   readonly context?: Record<string, unknown> | undefined;
-  readonly error: SurfaceErrorProjection;
+  readonly error: SurfaceErrorRendering;
   readonly details?: readonly string[] | undefined;
 }
 
@@ -580,12 +580,12 @@ const handleError = (
   userSuppliedFlagKeys: ReadonlySet<string>
 ): void => {
   const err = error instanceof Error ? error : new Error(String(error));
-  const projection = projectPublicSurfaceError('cli', err);
+  const rendering = renderPublicSurfaceError('cli', err);
   const context = collectErrorContext(err);
   const details = collectErrorDetailLines(err);
   const mode = structuredErrorMode(flags, topoName, userSuppliedFlagKeys);
   if (mode === undefined) {
-    process.stderr.write(`Error: ${projection.message}\n`);
+    process.stderr.write(`Error: ${rendering.message}\n`);
     for (const line of details) {
       process.stderr.write(`  ${line}\n`);
     }
@@ -593,14 +593,14 @@ const handleError = (
     writeStructuredError(
       {
         ...(context === undefined ? {} : { context }),
-        error: projection,
+        error: rendering,
         ...(details.length === 0 ? {} : { details }),
         ok: false,
       },
       mode
     );
   }
-  process.exit(projection.code);
+  process.exit(rendering.code);
 };
 
 const collectDisallowedAncestorOptions = (