@ontrails/trails 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # trails
 
+## 0.2.1
+
+### Patch Changes
+
+- [`d785a07`](https://github.com/outfitter-dev/trails/commit/d785a07b458899a7da14999e9b7856b8a7446e66): Align current installation examples with the 0.2.1 scaffold correction and keep Homebrew version checks explicit while preserving the 0.2.0 repair guidance.
+- [`d785a07`](https://github.com/outfitter-dev/trails/commit/d785a07b458899a7da14999e9b7856b8a7446e66): Keep automatic release eligibility when canonical version generation updates the root Bun lockfile and bundled skill framework metadata, while retaining the existing release provenance checks and rejecting other plugin files.
+- [`fdef61f`](https://github.com/outfitter-dev/trails/commit/fdef61feeef9b2250d537640db147cb9a9e484bd): Update package installation guidance to reflect the verified npm and Homebrew 0.2.0 release, with the published CLI scaffold repair linked from its README.
+- [`fdef61f`](https://github.com/outfitter-dev/trails/commit/fdef61feeef9b2250d537640db147cb9a9e484bd): Generate an explicit `@types/node` development dependency in fresh standalone and workspace apps so Node built-in imports resolve in cold installs.
+- [`ef3c802`](https://github.com/outfitter-dev/trails/commit/ef3c802f7e5b6ca92b32b11d76c26517ef388b13): Exclude unrelated `.worktrees` checkouts from lock round-trip copies while preserving tracked inputs and explicitly selected lock fixtures.
+
 ## 0.2.0
 
 ### Patch Changes

package/README.md

@@ -2,17 +2,19 @@
 
 Command-line tools for working with Trails projects.
 
-Use the canonical [Homebrew installation guide](../../docs/getting-started.md#installation) for installation, updates, and removal. Stable `0.2.0` installation requires the release assets and tap update; that handoff is pending. The formula requires Bun at runtime.
+Use the canonical [Homebrew installation guide](../../docs/getting-started.md#installation) for installation, updates, and removal. The CLI requires Bun at runtime; use `trails --version` to check the installed release.
 
 Use the CLI to scaffold a Trails app, add surfaces, inspect the current topo, run warden checks, manage draft state, and keep local Trails project state tidy.
 
-These commands target stable `0.2.0`. Run them after that version is published to npm.
+These installation examples target Trails `0.2.1` on the normal npm release line.
 
 ```bash
-bunx @ontrails/trails@0.2.0 create my-app --permit '{"id":"local-dev","scopes":["project:write"]}'
-bunx @ontrails/trails@0.2.0 create my-app --workspace --permit '{"id":"local-dev","scopes":["project:write"]}'
+bunx @ontrails/trails@0.2.1 create my-app --permit '{"id":"local-dev","scopes":["project:write"]}'
+bunx @ontrails/trails@0.2.1 create my-app --workspace --permit '{"id":"local-dev","scopes":["project:write"]}'
 ```
 
+Apps generated by the published `0.2.0` CLI need an explicit Node types dependency before typechecking. Follow the [0.2.0 scaffold repair](../../docs/getting-started.md#repair-apps-generated-by-020).
+
 Common workflows:
 
 - `trails create` starts a standalone app by default; `--workspace` creates a configured workspace with that app under `apps/<name>`. Generated surfaces live under `bin/`, app source stays side-effect-free, and `--dry-run` returns the complete write plan without touching disk. Workspace creation rejects targets nested beneath an existing configured workspace while allowing a child workspace beneath an ancestor standalone Config. On a rerun, a preserved app entry also rejects when its runtime-selected topo ID can be statically proven to conflict with `workspace.apps`; dynamic, indirect, and post-construction mutation forms remain preserved and are validated by runtime commands such as `trails compile`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontrails/trails",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/outfitter-dev/trails.git",
@@ -33,25 +33,25 @@
   "dependencies": {
     "@clack/prompts": "^1.1.0",
     "@manypkg/get-packages": "1.1.3",
-    "@ontrails/adapter-kit": "^0.2.0",
-    "@ontrails/cli": "^0.2.0",
-    "@ontrails/commander": "^0.2.0",
-    "@ontrails/config": "^0.2.0",
-    "@ontrails/core": "^0.2.0",
-    "@ontrails/http": "^0.2.0",
-    "@ontrails/mcp": "^0.2.0",
-    "@ontrails/observability": "^0.2.0",
-    "@ontrails/permits": "^0.2.0",
-    "@ontrails/regrade": "^0.2.0",
-    "@ontrails/source": "^0.2.0",
-    "@ontrails/topography": "^0.2.0",
-    "@ontrails/warden": "^0.2.0",
+    "@ontrails/adapter-kit": "^0.2.1",
+    "@ontrails/cli": "^0.2.1",
+    "@ontrails/commander": "^0.2.1",
+    "@ontrails/config": "^0.2.1",
+    "@ontrails/core": "^0.2.1",
+    "@ontrails/http": "^0.2.1",
+    "@ontrails/mcp": "^0.2.1",
+    "@ontrails/observability": "^0.2.1",
+    "@ontrails/permits": "^0.2.1",
+    "@ontrails/regrade": "^0.2.1",
+    "@ontrails/source": "^0.2.1",
+    "@ontrails/topography": "^0.2.1",
+    "@ontrails/warden": "^0.2.1",
     "commander": "^14.0.3",
     "typescript": "5.9.3",
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@ontrails/cloudflare": "^0.2.0",
-    "@ontrails/testing": "^0.2.0"
+    "@ontrails/cloudflare": "^0.2.1",
+    "@ontrails/testing": "^0.2.1"
   }
 }

package/src/release/lock-roundtrip-workspace.ts

@@ -39,6 +39,7 @@ const isDisposablePath = (segments: readonly string[]): boolean =>
       part === '.tmp-tests' ||
       part === '.trails-tmp' ||
       part === '.turbo' ||
+      part === '.worktrees' ||
       (part === 'worktrees' && segments[index - 1] === '.claude') ||
       (part === 'notes' && segments[index - 1] === '.agents')
   );

package/src/release/policy.ts

@@ -728,6 +728,14 @@ const evaluateGeneratedReleaseDiff = (
   let hasPackageVersionFile = false;
 
   for (const file of changedFiles) {
+    if (
+      (file.path === 'bun.lock' ||
+        file.path === 'plugin/skills/trails/SKILL.md') &&
+      file.status === 'M'
+    ) {
+      continue;
+    }
+
     if (file.path === '.changeset/pre.json' && file.status === 'M') {
       continue;
     }

package/src/scaffold-version-sync.ts

@@ -95,6 +95,12 @@ const loadScaffoldVersions = async (
       'devDependencies',
       rootPackageJsonPath
     ),
+    nodeTypes: requireValue(
+      devDeps['@types/node'],
+      '@types/node',
+      'devDependencies',
+      rootPackageJsonPath
+    ),
     oxfmt: requireValue(
       devDeps['oxfmt'],
       'oxfmt',

package/src/scaffold-versions.generated.ts

@@ -4,6 +4,7 @@ export const scaffoldDependencyVersions = {
   bunTypes: '^1.3.11',
   commander: '^14.0.3',
   lefthook: '^2.1.1',
+  nodeTypes: '^25.5.0',
   oxfmt: '0.47.0',
   oxlint: '1.62.0',
   typescript: '^5.9.3',

package/src/trails/create-scaffold.ts

@@ -92,6 +92,7 @@ const generateAppPackageJson = (name: string): string => {
       Object.entries({
         '@ontrails/trails': ontrailsPackageRange,
         '@types/bun': scaffoldDependencyVersions.bunTypes,
+        '@types/node': scaffoldDependencyVersions.nodeTypes,
         oxfmt: scaffoldDependencyVersions.oxfmt,
         oxlint: scaffoldDependencyVersions.oxlint,
         typescript: scaffoldDependencyVersions.typescript,