arashi 1.38.0 → 1.40.0

package/README.md

@@ -97,6 +97,14 @@ You can then use `aw switch --cd <filter>` to change the current shell's directo
 Remove only the exact managed shell block with `aw shell uninstall --dry-run`, then
 `aw shell uninstall --yes`. This leaves executables, PATH, manifests, and project data untouched.
 
+Existing-checkout native T3 handoff: `aw switch --path /path/to/checkout --t3 "Task"`.
+Use `--prompt-file` for UTF-8 input and `--permission` for an explicit permission mode.
+It opens no UI; select the reported project/thread in your connected client. Same-intent
+retries reconcile saved IDs. After resolution, a deliberate `--t3-intent followup-1`
+starts another thread; never use a fresh intent to bypass uncertainty. Maintainers should
+preserve repository-local receipts and retained locks during recovery. Conversation state
+is not transferred.
+
 ## Uninstallation
 
 Inspect the conservative removal plan first, then consent explicitly:

package/bin/arashi.js

@@ -188,7 +188,7 @@ export function detectNpmGlobalRoot(options = {}) {
 
 async function runPackageUninstall(argv, options) {
   if (argv.length === 1 && (argv[0] === "--help" || argv[0] === "-h")) {
-    (options.log ?? console.log)(`Usage: arashi uninstall [options]
+    (options.log ?? console.log)(`Usage: aw uninstall [options]
 
 Conservatively remove a proven Arashi installation
 

package/bin/update.js

@@ -383,7 +383,7 @@ async function runNpmManagedUpdateCore(argv = [], options = {}) {
     return 0;
   } catch (error) {
     errorLog(`Package updated, but binary refresh failed: ${error instanceof Error ? error.message : String(error)}`);
-    errorLog("Run `arashi install` to retry the binary installation, or download a release manually.");
+    errorLog("Run `aw install` to retry the binary installation, or download a release manually.");
     return 1;
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arashi",
-  "version": "1.38.0",
+  "version": "1.40.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"
+    }
+  }
+}