arashi 1.6.0 → 1.8.0

package/README.md

@@ -94,11 +94,12 @@ Arashi currently provides these commands:
 
 - `arashi init`
 - `arashi add <git-url>`
+- `arashi clone [--all]`
 - `arashi create <branch>`
 - `arashi list`
 - `arashi status`
 - `arashi remove <branch|path>`
-- `arashi switch [filter] [--repos|--all] [--sesh]`
+- `arashi switch [filter] [--repos|--all] [--sesh] [--no-default-launch]`
 - `arashi pull`
 - `arashi sync`
 - `arashi setup [--only <repo>] [--verbose]`
@@ -110,23 +111,36 @@ arashi init
 arashi add git@github.com:your-org/frontend.git
 arashi add git@github.com:your-org/backend.git
 arashi create feature-auth-refresh
+arashi create feature-auth-refresh --launch
+arashi create feature-auth-refresh --no-launch
 arashi status
 arashi switch feature-auth-refresh          # parent repo worktrees
 arashi switch --repos feature-auth-refresh  # child repo worktrees in current workspace
 arashi switch --all feature-auth-refresh    # all repos
 arashi switch --repos docs                  # repo-name matching in child repos
+arashi switch --no-default-launch           # bypass configured launch mode defaults once
 ```
 
 ## Hooks
 
-Arashi can run lifecycle hooks during `arashi create` to automate setup steps.
+Arashi can run lifecycle hooks during `arashi create` and `arashi remove`.
 
 - Global hooks in `.arashi/hooks/`:
   - `pre-create.sh`
   - `post-create.sh`
+  - `pre-remove.sh`
+  - `post-remove.sh`
 - Repository-specific hooks:
   - `pre-create.<repo>.sh`
   - `post-create.<repo>.sh`
+- Scoped remove hooks:
+  - repository scope: `repos/<repo>/.arashi/hooks/pre-remove.sh` and `post-remove.sh`
+  - global shared: `~/.arashi/hooks/pre-remove.sh` and `post-remove.sh`
+  - global targeted: `~/.arashi/hooks/<repo>/pre-remove.sh` and `post-remove.sh`
+
+For `arashi remove`, hook execution order is: repository scope -> workspace-root scope -> global targeted scope -> global shared scope.
+
+`pre-remove.sh` is useful for teardown before deletion (for example, stopping tmux sessions), and `post-remove.sh` can run final cleanup after remove operations complete.
 
 See [`docs/hooks.md`](./docs/hooks.md) for hook behavior, environment variables, and examples.
 
@@ -185,6 +199,36 @@ If you prefer the term `delete`, create a shell alias:
 alias arashi-delete='arashi remove -f'
 ```
 
+## 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`
+- Version-pinned URL: `https://unpkg.com/arashi@1.7.0/schema/config.schema.json`
+
+Example config header:
+
+```json
+{
+  "$schema": "https://unpkg.com/arashi/schema/config.schema.json",
+  "version": "1.0.0",
+  "reposDir": "./repos",
+  "defaults": {
+    "create": {
+      "switch": true,
+      "launch": true,
+      "launchMode": "sesh"
+    },
+    "switch": {
+      "launchMode": "sesh"
+    }
+  },
+  "repos": {}
+}
+```
+
+Defaults precedence for create/switch behavior: explicit CLI flag > opt-out flag > config default > built-in default.
+
 ## skills.sh Integration
 
 Arashi also ships a dedicated `skills.sh` integration package for guided installation, workflow examples, and troubleshooting.
@@ -197,6 +241,8 @@ Arashi also ships a dedicated `skills.sh` integration package for guided install
 ## Documentation
 
 - Installation details: [`docs/INSTALLATION.md`](./docs/INSTALLATION.md)
+- Configuration details: [`docs/configuration.md`](./docs/configuration.md)
+- Clone command details: [`docs/commands/clone.md`](./docs/commands/clone.md)
 - Hook behavior: [`docs/hooks.md`](./docs/hooks.md)
 - Setup command details: [`docs/commands/setup.md`](./docs/commands/setup.md)
 - Switch command details: [`docs/commands/switch.md`](./docs/commands/switch.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arashi",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "Git worktree manager for meta-repositories - The eye of the storm for your development workflow",
   "keywords": [
     "cli",
@@ -32,6 +32,7 @@
     "bin/arashi.bat",
     "bin/arashi.ps1",
     "scripts/postinstall.js",
+    "schema/config.schema.json",
     "README.md",
     "LICENSE"
   ],
@@ -57,10 +58,14 @@
     "lint": "oxlint -D no-explicit-any .",
     "lint:fix": "oxlint --fix -D no-explicit-any .",
     "lint:ci": "oxlint --format github -D no-explicit-any .",
+    "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": "bun run schema:generate && oxfmt --config .oxfmtrc.json --write schema/config.schema.json",
+    "schema:check": "bun run schema:publish && git diff --exit-code -- schema/config.schema.json",
     "format": "oxfmt --config .oxfmtrc.json --write .",
     "format:check": "oxfmt --config .oxfmtrc.json --check .",
     "quality:changed": "bun run scripts/quality/changed-files-quality.ts",
     "postinstall": "node scripts/postinstall.js",
+    "prepublishOnly": "bun run schema:publish",
     "prepare": "husky"
   },
   "devDependencies": {
@@ -80,6 +85,7 @@
     "oxfmt": "0.28.0",
     "oxlint": "1.43.0",
     "semantic-release": "^24.2.0",
+    "ts-json-schema-generator": "2.4.0",
     "typescript": "^5.9.3"
   },
   "lint-staged": {

package/schema/config.schema.json

@@ -0,0 +1,127 @@
+{
+  "$ref": "#/definitions/Config",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "definitions": {
+    "CommandDefaultsConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "create": {
+          "$ref": "#/definitions/CreateCommandDefaults"
+        },
+        "switch": {
+          "$ref": "#/definitions/SwitchCommandDefaults"
+        }
+      },
+      "type": "object"
+    },
+    "Config": {
+      "additionalProperties": false,
+      "description": "Root configuration object for Arashi",
+      "properties": {
+        "$schema": {
+          "description": "JSON Schema URL for editor validation/autocomplete",
+          "type": "string"
+        },
+        "defaults": {
+          "$ref": "#/definitions/CommandDefaultsConfig",
+          "description": "Optional command-scoped defaults for create and switch"
+        },
+        "hooks": {
+          "additionalProperties": false,
+          "description": "Optional workspace-level hooks settings",
+          "properties": {
+            "timeout": {
+              "description": "Timeout in milliseconds for long-running operations",
+              "type": "number"
+            }
+          },
+          "type": "object"
+        },
+        "repos": {
+          "additionalProperties": {
+            "$ref": "#/definitions/RepoConfig"
+          },
+          "description": "Map of repository names to their configurations",
+          "type": "object"
+        },
+        "reposDir": {
+          "description": "Directory where repositories are located",
+          "type": "string"
+        },
+        "sync": {
+          "additionalProperties": false,
+          "description": "Optional sync command settings",
+          "properties": {
+            "timeoutSeconds": {
+              "description": "Sync timeout in seconds",
+              "type": "number"
+            }
+          },
+          "type": "object"
+        },
+        "version": {
+          "$ref": "#/definitions/ConfigVersion",
+          "description": "Configuration schema version for migrations"
+        },
+        "worktreesDir": {
+          "description": "Base directory where worktrees are created (workspace-relative)",
+          "type": "string"
+        }
+      },
+      "required": ["version", "reposDir", "repos"],
+      "type": "object"
+    },
+    "ConfigVersion": {
+      "const": "1.0.0",
+      "type": "string"
+    },
+    "CreateCommandDefaults": {
+      "additionalProperties": false,
+      "properties": {
+        "launch": {
+          "description": "Default to launching a terminal/editor context after create",
+          "type": "boolean"
+        },
+        "launchMode": {
+          "$ref": "#/definitions/LaunchMode",
+          "description": "Preferred launch mode for create-triggered launch"
+        },
+        "switch": {
+          "description": "Default to switching to the new worktree after create",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "LaunchMode": {
+      "enum": ["auto", "sesh"],
+      "type": "string"
+    },
+    "RepoConfig": {
+      "additionalProperties": false,
+      "description": "Configuration for a single repository",
+      "properties": {
+        "gitUrl": {
+          "description": "Canonical git URL for cloning the repository",
+          "type": "string"
+        },
+        "path": {
+          "description": "Path to the repository (relative or absolute)",
+          "type": "string"
+        }
+      },
+      "required": ["path"],
+      "type": "object"
+    },
+    "SwitchCommandDefaults": {
+      "additionalProperties": false,
+      "properties": {
+        "launchMode": {
+          "$ref": "#/definitions/LaunchMode",
+          "description": "Preferred launch mode when running switch"
+        }
+      },
+      "type": "object"
+    }
+  }
+}