trellis 3.1.13 → 3.1.19

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 3.1.14
+
+- CLI `trellis --version` now reports the real package version from `package.json` (was hardcoded `0.1.0`).
+- CLI `-p` / cwd resolution walks up to the nearest `.trellis` repo root (monorepo subfolders work without passing the root path).
+- Clearer "not a repository" errors: show looked-from path, cwd, and `-p` hint.
+- `issue create` accepts `--description` as an alias for `--desc`.
+- `bin/trellis.mjs` launcher finds Homebrew Bun when Node's `PATH` is minimal (`npx trellis` / agent shells).
+
 ## 3.1.2
 
 - Fixed `trellis/cms` collection reads for inferred collections whose normalized key differs from the stored entity type casing, such as `blogpost` reading `BlogPost` entities.

package/LICENSE

@@ -1,3 +1,5 @@
+SPDX-License-Identifier: AGPL-3.0-or-later
+
 Trellis — Copyright (c) 2025-2026 Trent Brew <tbrew@turtle.tech>
 
 This program is free software: you can redistribute it and/or modify

package/README.md

@@ -15,7 +15,7 @@
 
 Most agent frameworks focus on the _reasoning engine_ (the LLM) but treat _state_ as an afterthought. Trellis reverses this. It is the **System of Record for Decisions**, providing agents with a persistent, queryable, and auditable memory that compounds over time.
 
-**[Read the story →](./THE-STORY.md)**
+**[Read the story →](./docs/THE-STORY.md)**
 
 - **Durable Memory**: Every thought, tool call, and file change is an immutable operation in a causal graph
 - **Explainability by Default**: Decision traces don't just store _what_ happened, but _why_
@@ -37,8 +37,8 @@ trellis init
 echo "# My Project" > README.md
 
 # 4. Add structured entities
-trellis issue create --title "Bootstrap Visualization"
-trellis milestone "Initial Release"
+trellis issue create -t "Bootstrap Visualization"
+trellis milestone create -m "Initial Release"
 
 # 5. Create coding session with trellis harness
 trellis code
@@ -118,14 +118,17 @@ Ops are written to `.trellis/ops.json` and **never rewritten or deleted**.
 
 ## Documentation
 
-- **[Local documentation](./docs/README.md)** — Canonical docs for the active codebase
+- **[Documentation hub](./docs/README.md)** — Canonical docs index for Trellis
+- **[The Story](./docs/THE-STORY.md)** — Why Trellis exists
 - **[Vision](./docs/VISION.md)** — Local-first agentic OS framing
 - **[Architecture](./docs/ARCHITECTURE.md)** — Current package layout and target runtime shape
-- **[Roadmap](./ROADMAP.md)** — Active Trellis issue and milestone sequence
+- **[Five Pillars](./docs/PILLARS.md)** — Core architectural principles
+- **[Design spec](./docs/DESIGN.md)** — Full architecture specification
+- **[Roadmap](./docs/ROADMAP.md)** — Active Trellis issue and milestone sequence
+- **[Agents guide](./docs/AGENTS.md)** — Building agents on Trellis
 - **[Full documentation](https://trellis.computer)** — Published docs site
-- **[CLI reference](./README-ARCHIVED.md#cli-overview)** — Command details (archived)
-- **[API modules](./README-ARCHIVED.md#module--subpath-guide)** — Subpath imports (archived)
-- **[DESIGN.md](./DESIGN.md)** — Architecture specification
+- **[CLI reference](./docs/README-ARCHIVED.md#cli-overview)** — Command details (archived)
+- **[API modules](./docs/README-ARCHIVED.md#module--subpath-guide)** — Subpath imports (archived)
 
 ---
 
@@ -162,4 +165,4 @@ bun run build
 
 ---
 
-_For comprehensive documentation including detailed CLI commands, API examples, and subsystem guides, see [README-ARCHIVED.md](./README-ARCHIVED.md)._
+_For comprehensive documentation including detailed CLI commands, API examples, and subsystem guides, see [docs/README-ARCHIVED.md](./docs/README-ARCHIVED.md)._

package/bin/trellis.mjs

@@ -17,7 +17,10 @@ const isWindows = process.platform === 'win32';
 if (process.versions?.bun) {
   await import('../dist/cli/index.js');
 } else {
-  const bun = findOnPath('bun') ?? findUserBun();
+  const bun =
+    findOnPath('bun') ??
+    findUserBun() ??
+    (existsSync('/opt/homebrew/bin/bun') ? '/opt/homebrew/bin/bun' : null);
   if (!bun) {
     process.stderr.write(
       [
@@ -38,8 +41,13 @@ if (process.versions?.bun) {
   const here = fileURLToPath(import.meta.url);
   const result = spawnSync(bun, [here, ...process.argv.slice(2)], {
     stdio: 'inherit',
+    env: process.env,
   });
-  process.exit(result.status ?? 1);
+  const code = result.status ?? 1;
+  if (code !== 0 && result.error) {
+    process.stderr.write(`${result.error.message}\n`);
+  }
+  process.exit(code);
 }
 
 function findOnPath(cmd) {

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG;AAwCH,MAAM,MAAM,OAAO,GACf,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,GACR,MAAM,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AACjE,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,KAAK,GACL,QAAQ,GACR,MAAM,GACN,MAAM,GACN,UAAU,GACV,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,SAAS,GACT,WAAW,GACX,OAAO,GACP,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG;AAyCH,MAAM,MAAM,OAAO,GACf,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,GACR,MAAM,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AACjE,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,KAAK,GACL,QAAQ,GACR,MAAM,GACN,MAAM,GACN,UAAU,GACV,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,SAAS,GACT,WAAW,GACX,OAAO,GACP,MAAM,CAAC"}