@signalridge/pi-worktree 1.4.0 → 1.4.2

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # Changelog
 
+## 1.4.2
+### Patch Changes
+
+- e939fa0: Fix Pi 0.85.1 tool-approval argument forwarding, ambient-auth and credential-specific model routing, and cross-platform workspace session validation.
+
+## 1.4.1
+### Patch Changes
+
+- d9219d4: Correct shipped documentation that contradicted the code or the manifest.
+  
+  - `pi-subagents`: the summary line still advertised protocol-v3 spawning while
+    the feature list and the managed-spawn section described v4.
+  - `pi-worktree`: the workspace-switching section named `/tree`; the registered
+    command is `/worktree`.
+  - `pi-workflows`: removed an orphaned sentence fragment left behind by an edit
+    to the saved-workflow paragraph.
+  - `pi-plan-mode`, `pi-goal`, `pi-usage-extension`: the stated Pi floor
+    (`0.80.6`, `0.42.4+`) contradicted the declared `^0.84.0` peer range, which
+    resolves to `0.84.x`. `pi-usage-extension` also carried a "Last updated"
+    stamp from a version that predates the workspace baseline.
+  - `pi-welcome`: the example card was a real session capture. It is now a
+    generic sample, and Install moved above the configuration sections instead of
+    sitting below them.
+- 1f586f8: Expand Pi peer support to `^0.84.0 || ^0.85.0`, retaining 0.84 compatibility while admitting 0.85 releases. The previous zero-major caret range excluded Pi 0.85.1. Update existing Pi development dependency pins to 0.85.1.
+- d9219d4: Converge every README on one house style: plain sentence-case headings, no
+  decorative emoji.
+  
+  Ten packages carried an emoji heading scheme inherited from their upstream
+  forks while the other nineteen used plain headings, so the same monorepo
+  rendered as two unrelated projects on npmjs.com. Headings are now emoji-free
+  and titles are sentence case.
+  
+  Also removes the `Keywords` section from those ten. It duplicated each
+  package's `package.json` `keywords` field, which is what npm actually indexes,
+  and no plain-style README carried one. `Installation` is now `Install`
+  everywhere.
+  
+  Headings that were Title Case are sentence case too, so one convention now
+  covers the whole monorepo. Existing in-page anchor links are unaffected:
+  GitHub lowercases heading slugs already.
+  
+  Documentation only — no runtime change.
+- Updated dependencies [1f586f8]
+- Updated dependencies [1f586f8]
+- Updated dependencies [1f586f8]
+- Updated dependencies [1f586f8]
+  - @signalridge/pi-ui@1.3.1
+
 ## 1.4.0
 ### Minor Changes
 

package/README.md

@@ -1,4 +1,4 @@
-# 🌳 pi-worktree — Safe Git Worktree Management for Pi
+# pi-worktree — safe Git worktree management for Pi
 
 [![npm](https://img.shields.io/npm/v/@signalridge/pi-worktree)](https://www.npmjs.com/package/@signalridge/pi-worktree) [![Pi extension](https://img.shields.io/badge/Pi-extension-blue)](https://pi.dev) [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
 
@@ -8,7 +8,7 @@ Pi cannot change its parent process working directory with `cd`. This extension
 
 This package is the full interactive worktree manager. It is publishable and stable, and opt-in: install it only if your project allows git worktrees. Some repositories forbid them outright — a worktree placed inside the source tree can be picked up by tooling that scans the tree, so check your repository's own guidance before enabling it.
 
-## ✨ Features
+## Features
 
 - Shows compact main, linked, current, detached, locked, and prunable state in worktree selectors.
 - Creates a new branch worktree or attaches an existing unoccupied local branch.
@@ -23,7 +23,7 @@ This package is the full interactive worktree manager. It is publishable and sta
 - Always previews stale metadata before pruning it and revalidates the preview after confirmation.
 - Runs Git through argv-based subprocess calls, without interpolating user input into shell commands.
 
-## 📦 Install
+## Install
 
 ```bash
 pi install npm:@signalridge/pi-worktree
@@ -42,7 +42,7 @@ just try worktree
 # or: pi -e ./packages/pi-worktree
 ```
 
-## 💬 Usage
+## Usage
 
 Run the command without arguments:
 
@@ -65,7 +65,7 @@ RPC dialogs; print and JSON modes reject the command observably. Operation-speci
 inputs, worktree identity selectors, preflight previews, and destructive confirmations remain
 extension-owned because they carry Git safety and commit-aware revalidation.
 
-## 🌿 Add defaults
+## Add defaults
 
 For a new branch, the current symbolic branch is the default start point. If Pi is running from detached HEAD, the command requires an explicit commit-ish. Git must resolve the start point to exactly one commit.
 
@@ -84,7 +84,7 @@ Leave the path input blank to accept the suggestion. A custom absolute path is u
 
 The MVP does not expose `--force`, `-B`, `--detach`, `--orphan`, or lock options.
 
-## ⚙️ Worktree root settings
+## Worktree root settings
 
 The machine-local user settings file is:
 
@@ -106,12 +106,12 @@ A missing `worktreeRoot` uses `~/.worktrees`; the settings file is created only
 
 Malformed or invalid settings are warned about but never overwritten, including an invalid edit made while a settings action is open. An initial failure uses `~/.worktrees`; a later failure retains the last valid effective root. Interactive configuration remains blocked until the invalid file is fixed manually. Failed publication leaves the prior file and effective runtime root unchanged, and the save queue remains usable after rejection.
 
-## 🔀 Pi workspace switching
+## Pi workspace switching
 
 Switching uses Pi's public `SessionManager` and `ctx.switchSession()` APIs:
 
 1. The command waits for Pi to become fully idle so the current assistant/tool results are persisted.
-2. A linear persisted session is forked into the target worktree. If `/tree` currently points at an older branch, the documented session entries for that active branch are written to the target instead, so switching cannot jump to a newer serialized leaf.
+2. A linear persisted session is forked into the target worktree. If `/worktree` currently points at an older branch, the documented session entries for that active branch are written to the target instead, so switching cannot jump to a newer serialized leaf.
 3. Pi tears down the old cwd-bound runtime and creates the target runtime.
 4. The extension reports success only through the fresh replacement-session context.
 
@@ -119,7 +119,7 @@ If the current session is completely empty, the extension creates a valid empty
 
 A successfully created Git worktree is never rolled back merely because Pi session switching fails. Re-run `/worktree` and choose **Switch worktree** after resolving the reported Pi/session issue.
 
-## 🛡️ Safety boundaries
+## Safety boundaries
 
 - The main worktree and current worktree cannot be removed.
 - Locked or stale worktrees cannot be removed through this extension.
@@ -144,7 +144,7 @@ Use Git directly when you intentionally need force removal, branch deletion, cus
 - Project trust and cwd-bound extension/resource loading during a switch remain owned by Pi.
 - The extension registers no LLM tool, background watcher, project settings, or statusline item.
 
-## 📁 Package layout
+## Package layout
 
 ```text
 packages/pi-worktree/
@@ -168,10 +168,6 @@ packages/pi-worktree/
 └── tsconfig.json
 ```
 
-## 🏷️ Keywords
-
-`pi-package`, `pi-extension`, `git`, `worktree`, `workspace`, `session`
-
-## 📄 License
+## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signalridge/pi-worktree",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Pi extension for safe interactive Git worktree management and workspace switching.",
   "type": "module",
   "license": "MIT",
@@ -35,12 +35,12 @@
     "lint": "biome check ."
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "^0.84.0"
+    "@earendil-works/pi-coding-agent": "^0.84.0 || ^0.85.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.5.7",
-    "@earendil-works/pi-coding-agent": "0.84.1",
-    "@earendil-works/pi-tui": "0.84.1",
+    "@earendil-works/pi-coding-agent": "0.85.1",
+    "@earendil-works/pi-tui": "0.85.1",
     "@types/node": "26.1.2",
     "@types/proper-lockfile": "^4.1.4",
     "typescript": "7.0.2",
@@ -60,7 +60,7 @@
   },
   "dependencies": {
     "@narumitw/pi-tui-kit": "^0.54.0",
-    "@signalridge/pi-ui": "^1.3.0",
+    "@signalridge/pi-ui": "^1.3.1",
     "proper-lockfile": "^4.1.2"
   }
 }

package/src/session.ts

@@ -1,4 +1,5 @@
 import { existsSync, writeFileSync } from "node:fs";
+import { resolve as normalizeTargetPath } from "node:path";
 import type { ExtensionCommandContext, SessionEntry } from "@earendil-works/pi-coding-agent";
 import { SessionManager } from "@earendil-works/pi-coding-agent";
 import { stripTerminalControls } from "./git.js";
@@ -67,6 +68,14 @@ export function createTargetSession(ctx: ExtensionCommandContext, targetPath: st
   return writeTargetSession(targetPath, [], undefined, null);
 }
 
+export function sessionCwdMatches(
+  actual: string,
+  expected: string,
+  resolvePath: (path: string) => string = normalizeTargetPath,
+): boolean {
+  return resolvePath(actual) === resolvePath(expected);
+}
+
 function writeTargetSession(
   targetPath: string,
   entries: readonly SessionEntry[],
@@ -84,7 +93,7 @@ function writeTargetSession(
     mode: 0o600,
   });
   const verified = SessionManager.open(targetFile);
-  if (verified.getCwd() !== targetPath || verified.getLeafId() !== expectedLeaf) {
+  if (!sessionCwdMatches(verified.getCwd(), targetPath) || verified.getLeafId() !== expectedLeaf) {
     throw new Error("Pi could not verify the target session cwd and active branch.");
   }
   return targetFile;