arashi 1.37.0 → 1.39.0

package/README.md

@@ -36,7 +36,7 @@ Verify the installation:
 aw --version
 ```
 
-`aw` is the preferred command name. `arashi` remains available for existing scripts and workflows. See the [installation guide](./docs/INSTALLATION.md) for version pinning, manual installation, and troubleshooting, or the [`update` command guide](https://arashi.haphazard.dev/commands/update/) for upgrades.
+`aw` is the preferred command name. `arashi` remains available for existing scripts and workflows. See the [installation guide](https://arashi.haphazard.dev/getting-started/) for version pinning, manual installation, and troubleshooting, or the [`update` command guide](https://arashi.haphazard.dev/commands/update/) for upgrades.
 
 ## Quick start
 
@@ -84,14 +84,6 @@ For a single repository without persisted Arashi configuration, use `aw init --z
 
 Run `aw --help`, `aw <command> --help`, or use the [complete command reference](https://arashi.haphazard.dev/commands/) for options and examples.
 
-### Finishing a coordinated workspace
-
-`aw finish <branch-or-parent-path> --dry-run` inventories the registered parent and configured children, refreshes named base/upstream refs into disposable private Git storage, and previews the exact cleanup scope and remove hooks. It does not run hooks, ask for completion/discard/removal consent, or write managed worktrees, refs, config, or index; network metadata refresh is permitted. A blocked or unknown preview still exits successfully **as a preview**, not as cleanup authorization. In main, a human TTY can omit the target to select one parent; selection is not consent. JSON/non-TTY requires an explicit target.
-
-Current `repos.<key>.baseBranch` overrides workspace `baseBranch` (`meta.baseBranch` overrides it for the parent). This is **current policy**, not a record of the create-time base or invocation-only overrides. With no configured base, preview leaves integration unknown; interactive execution can supply a repository-specific remote and full `refs/heads/...` target without saving it. Exact inspected HEAD ancestry of a freshly fetched named base can prove integration, but a negative ancestry result cannot prove non-integration after squash, rebase, or cherry-pick. GitHub PR correlation is attempted when ancestry is unproven and head/base remotes identify the same GitHub repository, including during dry-run: finish runs `gh auth status` and up to three paginated `gh api` requests. A match is only a correlation, not immutable historical merge-time HEAD proof; squash/rebase and other unproven completion still require explicit per-repository manual judgment in a human TTY. `--force` never supplies that judgment.
-
-Run `aw finish <target>` to review unknown completion, then separately consent to discarding dirty, untracked, or ignored local data and absent/ahead-upstream state and to removal. `--force` covers the latter two consents only; `--keep-branches` retains local branches. `--json` / `-j` emits one schema-versioned report and never prompts. Finish rechecks identity, policy, fresh evidence, and exact remove actions after consent and after successful pre-remove hooks before mutation. Hooks may already have side effects if that gate aborts; once removal starts, partial failures retain the existing remove ledger and require manual inspection/retry. External Git/filesystem actors can still race after the final gate: finish does **not** make deletion atomic or serialize other Arashi commands. It does not merge, push, delete remote branches, or detect later reverts.
-
 ## Shell integration
 
 Install shell integration for parent-shell directory switching and completion in Bash, Zsh, or Fish:
@@ -133,7 +125,6 @@ files, and the containing install directory.
 - [Hooks](https://arashi.haphazard.dev/workflows/hooks/)
 - [Editor and terminal integrations](https://arashi.haphazard.dev/workflows/)
 - [Agents and automation](https://arashi.haphazard.dev/workflows/agents-and-specs/#automation-and-json)
-- [Local configuration reference](./docs/configuration.md)
 
 ## Contributing
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arashi",
-  "version": "1.37.0",
+  "version": "1.39.0",
   "description": "Git worktree manager for meta-repositories - The eye of the storm for your development workflow",
   "keywords": [
     "cli",
@@ -40,6 +40,7 @@
     "bin/aw.bat",
     "bin/aw.ps1",
     "schema/config.schema.json",
+    "schema/user-config.schema.json",
     "scripts/uninstall.sh",
     "scripts/uninstall.ps1",
     "README.md",
@@ -73,9 +74,9 @@
     "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": "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",
+    "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 && ts-json-schema-generator --tsconfig tsconfig.schema.json --path src/lib/user-config.ts --type UserConfig --expose export --jsDoc extended --out schema/user-config.schema.json",
+    "schema:publish": "pnpm run schema:generate && oxfmt --config .oxfmtrc.json --write schema/config.schema.json schema/user-config.schema.json",
+    "schema:check": "pnpm run schema:publish && git diff --exit-code -- schema/config.schema.json schema/user-config.schema.json",
     "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",

package/schema/config.schema.json

@@ -13,6 +13,9 @@
         },
         "switch": {
           "$ref": "#/definitions/SwitchCommandDefaults"
+        },
+        "t3": {
+          "$ref": "#/definitions/T3Settings"
         }
       },
       "type": "object"
@@ -290,6 +293,43 @@
       "enum": ["auto", "cd", "launch", "sesh", "herdr"],
       "type": "string"
     },
+    "T3Settings": {
+      "additionalProperties": false,
+      "description": "Personal handoff choices; credentials and transport addresses never belong here.",
+      "properties": {
+        "baseDir": {
+          "description": "Official T3 data directory (absolute path).",
+          "minLength": 1,
+          "pattern": "^(?=(?:/|[A-Za-z]:[\\\\/]|\\\\\\\\))(?=[\\s\\S]*\\S)[^\\u0000-\\u001F]+$(?![\\s\\S])",
+          "type": "string"
+        },
+        "cli": {
+          "description": "Installed official t3 executable (command name or absolute path).",
+          "minLength": 1,
+          "pattern": "^(?=(?:/|[A-Za-z]:[\\\\/]|\\\\\\\\|[^/\\\\]+$))(?=[\\s\\S]*\\S)[^\\u0000-\\u001F]+$(?![\\s\\S])",
+          "type": "string"
+        },
+        "effort": {
+          "description": "Supported reasoning effort.",
+          "minLength": 1,
+          "pattern": "^(?=[\\s\\S]*\\S)[^\\u0000-\\u001F]+$(?![\\s\\S])",
+          "type": "string"
+        },
+        "model": {
+          "description": "Supported model slug or alias.",
+          "minLength": 1,
+          "pattern": "^(?=[\\s\\S]*\\S)[^\\u0000-\\u001F]+$(?![\\s\\S])",
+          "type": "string"
+        },
+        "provider": {
+          "description": "Configured provider instance id, or an unambiguous driver name.",
+          "minLength": 1,
+          "pattern": "^(?=[\\s\\S]*\\S)[^\\u0000-\\u001F]+$(?![\\s\\S])",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "WorktreeNamingBranchSlashes": {
       "enum": ["preserve", "flatten"],
       "type": "string"

package/schema/user-config.schema.json

@@ -0,0 +1,193 @@
+{
+  "$ref": "#/definitions/UserConfig",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "definitions": {
+    "CommandDefaultsConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "create": {
+          "$ref": "#/definitions/CreateCommandDefaults"
+        },
+        "editors": {
+          "$ref": "#/definitions/EditorDefaultsConfig"
+        },
+        "switch": {
+          "$ref": "#/definitions/SwitchCommandDefaults"
+        },
+        "t3": {
+          "$ref": "#/definitions/T3Settings"
+        }
+      },
+      "type": "object"
+    },
+    "ConfigVersion": {
+      "const": "1.0.0",
+      "type": "string"
+    },
+    "CreateCommandDefaults": {
+      "additionalProperties": false,
+      "properties": {
+        "launch": {
+          "$ref": "#/definitions/CreateLaunchMode",
+          "description": "Post-create launch choice; omitted preserves built-in no-launch behavior"
+        },
+        "switch": {
+          "description": "Default to switching to the new worktree after create",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "CreateLaunchMode": {
+      "enum": ["none", "auto", "sesh", "herdr"],
+      "type": "string"
+    },
+    "EditorCommandDefaults": {
+      "additionalProperties": false,
+      "properties": {
+        "create": {
+          "$ref": "#/definitions/EditorCreateCommandDefaults",
+          "description": "Editor-scoped create defaults"
+        }
+      },
+      "type": "object"
+    },
+    "EditorCreateCommandDefaults": {
+      "additionalProperties": false,
+      "properties": {
+        "launch": {
+          "$ref": "#/definitions/CreateLaunchMode",
+          "description": "Post-create launch choice; omitted preserves built-in no-launch behavior"
+        },
+        "switch": {
+          "description": "Default to switching to the new worktree after create",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "EditorDefaultsConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "cursor": {
+          "$ref": "#/definitions/EditorCommandDefaults"
+        },
+        "kiro": {
+          "$ref": "#/definitions/EditorCommandDefaults"
+        },
+        "vscode": {
+          "$ref": "#/definitions/EditorCommandDefaults"
+        }
+      },
+      "type": "object"
+    },
+    "SwitchCommandDefaults": {
+      "additionalProperties": false,
+      "properties": {
+        "mode": {
+          "$ref": "#/definitions/SwitchMode",
+          "description": "Preferred switch behavior and launcher when running switch"
+        }
+      },
+      "type": "object"
+    },
+    "SwitchMode": {
+      "enum": ["auto", "cd", "launch", "sesh", "herdr"],
+      "type": "string"
+    },
+    "T3Settings": {
+      "additionalProperties": false,
+      "description": "Personal handoff choices; credentials and transport addresses never belong here.",
+      "properties": {
+        "baseDir": {
+          "description": "Official T3 data directory (absolute path).",
+          "minLength": 1,
+          "pattern": "^(?=(?:/|[A-Za-z]:[\\\\/]|\\\\\\\\))(?=[\\s\\S]*\\S)[^\\u0000-\\u001F]+$(?![\\s\\S])",
+          "type": "string"
+        },
+        "cli": {
+          "description": "Installed official t3 executable (command name or absolute path).",
+          "minLength": 1,
+          "pattern": "^(?=(?:/|[A-Za-z]:[\\\\/]|\\\\\\\\|[^/\\\\]+$))(?=[\\s\\S]*\\S)[^\\u0000-\\u001F]+$(?![\\s\\S])",
+          "type": "string"
+        },
+        "effort": {
+          "description": "Supported reasoning effort.",
+          "minLength": 1,
+          "pattern": "^(?=[\\s\\S]*\\S)[^\\u0000-\\u001F]+$(?![\\s\\S])",
+          "type": "string"
+        },
+        "model": {
+          "description": "Supported model slug or alias.",
+          "minLength": 1,
+          "pattern": "^(?=[\\s\\S]*\\S)[^\\u0000-\\u001F]+$(?![\\s\\S])",
+          "type": "string"
+        },
+        "provider": {
+          "description": "Configured provider instance id, or an unambiguous driver name.",
+          "minLength": 1,
+          "pattern": "^(?=[\\s\\S]*\\S)[^\\u0000-\\u001F]+$(?![\\s\\S])",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "UserConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "$schema": {
+          "description": "JSON Schema URL for editor validation/autocomplete",
+          "type": "string"
+        },
+        "defaults": {
+          "$ref": "#/definitions/CommandDefaultsConfig",
+          "description": "Personal command and editor defaults"
+        },
+        "version": {
+          "$ref": "#/definitions/ConfigVersion",
+          "description": "User configuration schema version"
+        },
+        "worktreeNaming": {
+          "$ref": "#/definitions/WorktreeNamingConfig",
+          "description": "Personal fallback worktree naming policy"
+        },
+        "worktreesDir": {
+          "description": "Personal fallback worktree directory; absolute paths are repository-qualified",
+          "type": "string"
+        }
+      },
+      "required": ["version"],
+      "type": "object"
+    },
+    "WorktreeNamingBranchSlashes": {
+      "enum": ["preserve", "flatten"],
+      "type": "string"
+    },
+    "WorktreeNamingConfig": {
+      "additionalProperties": false,
+      "description": "Filesystem naming policy for configured create destinations.",
+      "properties": {
+        "branchSlashes": {
+          "$ref": "#/definitions/WorktreeNamingBranchSlashes",
+          "description": "Preserve branch slash hierarchy or flatten slashes to hyphens"
+        },
+        "maxPathLength": {
+          "description": "Maximum UTF-16 code units for each absolute newly planned configured-worktree destination",
+          "maximum": 2147483647,
+          "minimum": 1,
+          "multipleOf": 1,
+          "type": "number"
+        },
+        "style": {
+          "$ref": "#/definitions/WorktreeNamingStyle",
+          "description": "Repository-shape-aware default, branch-only, or repository-prefixed naming"
+        }
+      },
+      "type": "object"
+    },
+    "WorktreeNamingStyle": {
+      "enum": ["default", "branch", "repo-branch"],
+      "type": "string"
+    }
+  }
+}