arashi 1.30.0 → 1.32.0

package/README.md

@@ -8,6 +8,8 @@ Arashi is a Git worktree manager for meta-repositories.
 
 It keeps related repositories aligned while you work on a feature branch across a shared workspace.
 
+Arashi makes a polyrepo work like a monorepo during development, while every repository keeps its own history, CI, and pull requests.
+
 [Documentation](https://arashi.haphazard.dev)
 
 ## Installation
@@ -37,7 +39,9 @@ arashi --version
 ```
 
 By default, the installer places `arashi` in `~/.arashi/bin`, adds that path to your shell config, and in interactive installs offers to enable shell integration for `arashi switch --cd`.
-It also runs a quick `arashi --version` smoke test before declaring success.
+Supported installations provide both canonical `arashi` and the first-class `aw` shorthand (“Arashi Workspace”). Both run the same implementation; product names, configuration, environment variables, help, and documentation remain canonical `arashi`.
+
+The installer transaction verifies identical, non-empty `arashi --version` and `aw --version` output before declaring success.
 
 If curl installation fails, or if the smoke test reports a bad release artifact, use npm installation below or the manual release instructions in [`docs/INSTALLATION.md`](./docs/INSTALLATION.md).
 
@@ -49,7 +53,7 @@ PowerShell is the canonical Windows installer:
 powershell -c "irm https://arashi.haphazard.dev/install.ps1 | iex"
 ```
 
-It verifies and installs `arashi.bin.exe`, the extensionless `arashi` wrapper for Git Bash, `arashi.ps1`, and `arashi.bat` from the same release. The default directory is `%USERPROFILE%\.arashi\bin`; the installer adds it to the persistent user PATH. It does not create or modify `.bashrc` or another shell profile. Open a new Git Bash window before running `arashi --version` so it inherits the PATH change.
+It verifies and installs one `arashi.bin.exe` plus `arashi`/`aw` wrappers for Git Bash, `arashi.ps1`/`aw.ps1`, and `arashi.bat`/`aw.bat` from the same release. The default directory is `%USERPROFILE%\.arashi\bin`; the installer adds it to the persistent user PATH. It does not create or modify `.bashrc` or another shell profile. Open a new Git Bash window before running `arashi --version` or `aw --version` so it inherits the PATH change.
 
 ### Option 3: Install with npm
 
@@ -57,7 +61,7 @@ It verifies and installs `arashi.bin.exe`, the extensionless `arashi` wrapper fo
 npm install -g arashi
 ```
 
-The npm package is script-free: it does not require package-manager lifecycle scripts or `postinstall` approval. It installs the lightweight JavaScript entrypoint and wrapper files first, then downloads the matching platform binary on first use.
+The npm package is script-free: it does not require package-manager lifecycle scripts or `postinstall` approval. It maps both npm bins to the same lightweight JavaScript entrypoint, then downloads the matching platform binary on first use through either name.
 
 To preinstall the binary explicitly, run:
 
@@ -90,29 +94,34 @@ If you prefer not to use npm, download a platform binary from [GitHub Releases](
 macOS (Apple Silicon):
 
 ```bash
-curl -L https://github.com/corwinm/arashi/releases/latest/download/arashi-macos-arm64 -o arashi
-chmod +x arashi
-sudo mv arashi /usr/local/bin/arashi
+curl -L https://github.com/corwinm/arashi/releases/latest/download/arashi-macos-arm64 -o arashi.bin
+curl -L https://github.com/corwinm/arashi/releases/latest/download/arashi -o arashi
+curl -L https://github.com/corwinm/arashi/releases/latest/download/aw -o aw
+chmod +x arashi.bin arashi aw
+sudo install -m 0755 arashi.bin arashi aw /usr/local/bin/
 ```
 
 Linux (x64):
 
 ```bash
-curl -L https://github.com/corwinm/arashi/releases/latest/download/arashi-linux-x64 -o arashi
-chmod +x arashi
-sudo mv arashi /usr/local/bin/arashi
+curl -L https://github.com/corwinm/arashi/releases/latest/download/arashi-linux-x64 -o arashi.bin
+curl -L https://github.com/corwinm/arashi/releases/latest/download/arashi -o arashi
+curl -L https://github.com/corwinm/arashi/releases/latest/download/aw -o aw
+chmod +x arashi.bin arashi aw
+sudo install -m 0755 arashi.bin arashi aw /usr/local/bin/
 ```
 
 Windows (PowerShell and Git Bash):
 
 ```powershell
 # Download arashi-windows-x64.exe, arashi, arashi.ps1, arashi.bat,
+# aw, aw.ps1, aw.bat,
 # and arashi-checksums.txt from the same release.
-# Verify all four payload files against arashi-checksums.txt.
-# Rename arashi-windows-x64.exe to arashi.bin.exe and keep the four files together on PATH.
+# Verify all seven payload files against arashi-checksums.txt.
+# Rename arashi-windows-x64.exe to arashi.bin.exe and keep the seven files together on PATH.
 ```
 
-Windows manual installation requires `arashi-windows-x64.exe`, `arashi`, `arashi.ps1`, `arashi.bat`, and `arashi-checksums.txt` from the same release. Verify all four payload files, rename the executable to `arashi.bin.exe`, and keep the payload together on PATH.
+Windows manual installation requires `arashi-windows-x64.exe`, `arashi`, `arashi.ps1`, `arashi.bat`, `aw`, `aw.ps1`, `aw.bat`, and `arashi-checksums.txt` from the same release. Verify all seven payload files, rename the executable to `arashi.bin.exe`, and keep the payload together on PATH. Manual release installations do not create the direct installer's ownership ledger; deliberately move or remove the manual payload before later using the direct installer.
 
 You can also build from source for local development. Development is pinned to Node.js 24.18.0, which satisfies pnpm 11's Node.js 22.13 minimum, and pnpm 11.20.0; nvm users can select the repository's development runtime with `nvm use`.
 
@@ -214,7 +223,7 @@ For contributors working on Arashi itself, the project planning workflow in the
 
 ## Shell Integration
 
-Use shell integration for parent-shell directory switching and native tab completion. Bash, Zsh, and Fish are supported.
+Use shell integration for parent-shell directory switching and native tab completion. Bash, Zsh, and Fish are supported through both `arashi` and `aw`.
 
 The official curl installer can offer this automatically. If you skip it or use npm, install it for the active shell with:
 
@@ -240,7 +249,7 @@ command arashi shell init fish | source
 command arashi completion fish | source
 ```
 
-`arashi shell init <shell>` remains wrapper-only. `arashi completion <shell>` emits only deterministic sourceable shell code, including on npm first use when the platform binary must be installed.
+`arashi shell init <shell>` remains wrapper-only and defines both parent-shell functions, unless an unrelated `aw` alias or function already owns that shell name. `arashi completion <shell>` registers the same completion model for both executable names and emits only deterministic sourceable shell code, including on npm first use when the platform binary must be installed.
 
 Completion covers commands, aliases, options, finite choices, conflicts, and positional boundaries. In an Arashi workspace it also resolves configured repository and group selector segments, switch/remove worktrees and paths, and move source/target references. Dynamic lookup is local and read-only, silent on unavailable or broken metadata, and limited to a 200 ms whole-query budget; it performs no network requests, hooks, prompts, workspace mutations, or child operations. Static completion remains available outside a workspace.
 
@@ -252,18 +261,23 @@ For automated installs, set `ARASHI_SHELL_INTEGRATION=yes` to enable it without
 
 ## Hooks
 
-Arashi can run lifecycle hooks during `arashi create` and `arashi remove`. Configured create uses
-workspace `pre-create`/`post-create` plus repository-specific `pre-create.<repo>` and
-`post-create.<repo>` files. Configured remove evaluates repository, workspace, user-global targeted,
-and user-global shared scopes once per target repository. Standalone mode activates only targeted
-and shared user-global hooks.
+Arashi can run file-backed or configured inline lifecycle hooks during `arashi create` and
+`arashi remove`. Inline workspace values live only at root `hooks.scripts.<lifecycle>`; repository
+values live only at `repos.<name>.hooks.<lifecycle>`. Use inline config for short reviewable commands
+and native files for substantial scripts. One inline/file source may own a logical location; a
+same-location collision fails preflight instead of running both.
 
-POSIX uses executable `.sh` files. Windows uses one case-insensitive `.ps1`, `.cmd`, or `.bat`
-candidate per location and never runs `.sh` implicitly. Hook failures participate in create rollback
-or remove finalization, all hooks default to a 300000 ms timeout, and JSON results expose the ordered
-ledger at `data.hookOutcomes` on success or `error.details.hookOutcomes` on failure.
+Configured create uses workspace `pre-create`/`post-create` plus repository-specific create locations.
+Configured remove evaluates repository, workspace, user-global targeted, and user-global shared scopes
+once per target repository. `--no-hooks` is create-only; `--no-hook-input` applies to both commands.
+Standalone mode remains file-only and activates only targeted and shared user-global hooks.
 
-See [`docs/hooks.md`](./docs/hooks.md) for hook behavior, environment variables, and examples.
+Hook failures participate in create rollback or remove finalization. Inline and file sources share the
+configured timeout, input, JSON isolation, dry-run, and ordered outcome policies. Public records expose
+source kind/owner metadata but never disclose configured snippet text.
+
+See [`docs/configuration.md`](./docs/configuration.md#inline-lifecycle-hook-configuration) for values and
+[`docs/hooks.md`](./docs/hooks.md) for exact lookup, lifecycle, environment, and automation behavior.
 
 ## Workflow Shortcuts
 
@@ -326,6 +340,12 @@ alias arashi-delete='arashi remove -f'
 
 ## Configuration Schema
 
+### Configured worktree files
+
+Configured repositories can copy isolated files or create native symlinks for intentionally shared state when coordinated worktrees are created. See [Worktree file materialization](docs/configuration.md#worktree-file-materialization) for direct `copy`/`symlink` arrays, Git-primary sourcing, lifecycle order, safety rules, dry-run previews, and doctor diagnostics.
+
+## Configuration Schema
+
 Arashi publishes a JSON Schema for `.arashi/config.json` so editors can validate and autocomplete your config.
 
 - Stable URL: `https://unpkg.com/arashi/schema/config.schema.json`

package/bin/aw

@@ -0,0 +1,43 @@
+#!/bin/bash
+# arashi-managed-alias:aw:v1
+# Arashi Workspace executable alias. Delegates to the one adjacent Arashi native binary.
+
+SCRIPT_SOURCE="${BASH_SOURCE[0]}"
+while [ -L "$SCRIPT_SOURCE" ]; do
+  SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_SOURCE")" && pwd)"
+  SCRIPT_SOURCE="$(readlink "$SCRIPT_SOURCE")"
+  [[ "$SCRIPT_SOURCE" != /* ]] && SCRIPT_SOURCE="$SCRIPT_DIR/$SCRIPT_SOURCE"
+done
+SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_SOURCE")" && pwd)"
+BINARY="$SCRIPT_DIR/arashi.bin"
+
+if [ ! -f "$BINARY" ]; then
+  PLATFORM=$(uname -s | tr '[:upper:]' '[:lower:]')
+  ARCH=$(uname -m)
+  WINDOWS_SHELL="false"
+  case "${MSYSTEM:-}" in MINGW*|MSYS*) WINDOWS_SHELL="true" ;; esac
+  case "$PLATFORM" in mingw*|msys*|cygwin*) WINDOWS_SHELL="true" ;; esac
+  if [ "$WINDOWS_SHELL" = "true" ]; then
+    BINARY="$SCRIPT_DIR/arashi.bin.exe"
+  else
+    case "$PLATFORM-$ARCH" in
+      darwin-arm64) BINARY="$SCRIPT_DIR/arashi-macos-arm64" ;;
+      linux-x86_64) BINARY="$SCRIPT_DIR/arashi-linux-x64" ;;
+      *) echo "Error: Unsupported platform $PLATFORM-$ARCH" >&2; exit 1 ;;
+    esac
+  fi
+fi
+
+if [ ! -f "$BINARY" ]; then
+  echo "Error: arashi binary not found at $BINARY" >&2
+  exit 1
+fi
+
+command=""
+for arg in "$@"; do
+  case "$arg" in -*) continue ;; *) [ -n "$command" ] || command="$arg" ;; esac
+done
+if [ ! -t 1 ] && [ "$command" = "list" ]; then
+  exec "$BINARY" "$@" 0<&-
+fi
+exec "$BINARY" "$@"

package/bin/aw.bat

@@ -0,0 +1,11 @@
+@echo off
+REM arashi-managed-alias:aw:v1
+REM Arashi Workspace executable alias. Delegate to the adjacent native binary.
+set "SCRIPT_DIR=%~dp0"
+set "BINARY=%SCRIPT_DIR%arashi.bin.exe"
+if not exist "%BINARY%" set "BINARY=%SCRIPT_DIR%arashi-windows-x64.exe"
+if not exist "%BINARY%" (
+  echo Error: arashi binary not found at %BINARY% 1>&2
+  exit /b 1
+)
+"%BINARY%" %*

package/bin/aw.ps1

@@ -0,0 +1,9 @@
+# arashi-managed-alias:aw:v1
+# Arashi Workspace executable alias. Preserve stdin and delegate to the adjacent native binary.
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$Binary = Join-Path $ScriptDir "arashi.bin.exe"
+if (-not (Test-Path $Binary)) { $Binary = Join-Path $ScriptDir "arashi-windows-x64.exe" }
+if (-not (Test-Path $Binary)) { Write-Error "Error: arashi binary not found at $Binary"; exit 1 }
+& $Binary @args
+if ($LASTEXITCODE -ne $null) { exit $LASTEXITCODE }
+exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arashi",
-  "version": "1.30.0",
+  "version": "1.32.0",
   "description": "Git worktree manager for meta-repositories - The eye of the storm for your development workflow",
   "keywords": [
     "cli",
@@ -24,7 +24,8 @@
     "url": "git+https://github.com/corwinm/arashi.git"
   },
   "bin": {
-    "arashi": "./bin/arashi.js"
+    "arashi": "./bin/arashi.js",
+    "aw": "./bin/arashi.js"
   },
   "files": [
     "bin/arashi",
@@ -35,6 +36,9 @@
     "bin/update-options.js",
     "bin/arashi.bat",
     "bin/arashi.ps1",
+    "bin/aw",
+    "bin/aw.bat",
+    "bin/aw.ps1",
     "schema/config.schema.json",
     "README.md",
     "LICENSE"
@@ -66,14 +70,17 @@
     "schema:generate": "ts-json-schema-generator --tsconfig tsconfig.schema.json --path src/lib/config.ts --type Config --expose export --jsDoc extended --out schema/config.schema.json",
     "schema:publish": "pnpm run schema:generate && oxfmt --config .oxfmtrc.json --write schema/config.schema.json",
     "schema:check": "pnpm run schema:publish && git diff --exit-code -- schema/config.schema.json",
-    "contract:generate": "node scripts/contracts/cli-commands.ts",
-    "contract:check": "node scripts/contracts/cli-commands.ts --check",
+    "contract:generate": "node scripts/contracts/cli-commands.ts && node scripts/contracts/inline-lifecycle-hooks.ts && node scripts/contracts/executable-distribution.ts",
+    "contract:check": "node scripts/contracts/cli-commands.ts --check && node scripts/contracts/inline-lifecycle-hooks.ts --check && node scripts/contracts/executable-distribution.ts --check",
+    "executable-contract:generate": "node scripts/contracts/executable-distribution.ts",
+    "executable-contract:check": "node scripts/contracts/executable-distribution.ts --check",
     "completion:generate": "node scripts/completions.ts",
     "completion:check": "node scripts/completions.ts --check",
     "format": "oxfmt --config .oxfmtrc.json --write .",
     "format:check": "oxfmt --config .oxfmtrc.json --check .",
     "quality:changed": "node scripts/quality/changed-files-quality.ts",
-    "prepublishOnly": "pnpm run completion:check && pnpm run schema:publish",
+    "prepublishOnly": "pnpm run completion:check && pnpm run executable-contract:check && pnpm run schema:publish",
+    "release:verify-aw": "node scripts/release/verify-aw.ts",
     "prepare": "husky"
   },
   "devDependencies": {

package/schema/config.schema.json

@@ -33,6 +33,10 @@
           "additionalProperties": false,
           "description": "Optional workspace-level hooks settings",
           "properties": {
+            "scripts": {
+              "$ref": "#/definitions/InlineHookScripts",
+              "description": "Workspace inline lifecycle hooks"
+            },
             "timeout": {
               "description": "Lifecycle-hook timeout in milliseconds (default: 300000)",
               "maximum": 2147483647,
@@ -144,10 +148,77 @@
       },
       "type": "object"
     },
+    "InlineHookInterpreter": {
+      "enum": ["bash", "powershell", "cmd"],
+      "type": "string"
+    },
+    "InlineHookInterpreterMap": {
+      "additionalProperties": false,
+      "description": "Interpreter-specific alternatives for one inline lifecycle hook.",
+      "minProperties": 1,
+      "properties": {
+        "bash": {
+          "$ref": "#/definitions/InlineHookSnippet"
+        },
+        "cmd": {
+          "$ref": "#/definitions/InlineHookSnippet"
+        },
+        "powershell": {
+          "$ref": "#/definitions/InlineHookSnippet"
+        }
+      },
+      "type": "object"
+    },
+    "InlineHookScripts": {
+      "additionalProperties": false,
+      "description": "Closed set of supported inline lifecycle hooks.",
+      "properties": {
+        "post-create": {
+          "$ref": "#/definitions/InlineHookValue"
+        },
+        "post-remove": {
+          "$ref": "#/definitions/InlineHookValue"
+        },
+        "pre-create": {
+          "$ref": "#/definitions/InlineHookValue"
+        },
+        "pre-remove": {
+          "$ref": "#/definitions/InlineHookValue"
+        }
+      },
+      "type": "object"
+    },
+    "InlineHookSnippet": {
+      "description": "Non-empty inline hook snippet.",
+      "minLength": 1,
+      "pattern": "\\S",
+      "type": "string"
+    },
+    "InlineHookValue": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/InlineHookInterpreter"
+        },
+        {
+          "$ref": "#/definitions/InlineHookSnippet"
+        },
+        {
+          "$ref": "#/definitions/InlineHookInterpreterMap"
+        }
+      ],
+      "description": "Bash shorthand or interpreter-specific alternatives for one inline hook."
+    },
     "RepoConfig": {
       "additionalProperties": false,
       "description": "Configuration for a single repository",
       "properties": {
+        "copy": {
+          "description": "Repository-relative paths copied into new worktrees in declaration order",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
         "gitUrl": {
           "description": "Canonical git URL for cloning the repository",
           "type": "string"
@@ -159,9 +230,20 @@
           },
           "type": "array"
         },
+        "hooks": {
+          "$ref": "#/definitions/InlineHookScripts",
+          "description": "Optional repository-targeted inline lifecycle hooks"
+        },
         "path": {
           "description": "Path to the repository (relative or absolute)",
           "type": "string"
+        },
+        "symlink": {
+          "description": "Repository-relative paths symlinked into new worktrees in declaration order",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
         }
       },
       "required": ["path"],