@selesai/code 0.8.4 → 0.8.5

package/dist/extensions/pi-subagents/test/unit/timeout-defaults.test.ts

@@ -3,6 +3,7 @@ import { describe, it } from "node:test";
 import {
 	DEFAULT_ASYNC_TIMEOUT_MS,
 	DEFAULT_FOREGROUND_TIMEOUT_MS,
+	resolveConfigDefaultTimeoutMs,
 	resolveSingleAgentLaunchTimeout,
 } from "../../src/runs/foreground/subagent-executor.ts";
 
@@ -70,4 +71,68 @@ describe("single-agent launch timeout wiring", () => {
 			{ timeoutMs: 5_000 },
 		);
 	});
+
+	const NINETY_MIN = 90 * 60 * 1000;
+
+	it("applies the global config default in place of the foreground backstop", () => {
+		assert.deepEqual(resolveSingleAgentLaunchTimeout({}, false, NINETY_MIN), {
+			timeoutMs: NINETY_MIN,
+		});
+	});
+
+	it("applies the global config default to composite foreground runs (parallel/chain)", () => {
+		assert.deepEqual(
+			resolveSingleAgentLaunchTimeout({ agent: "worker", task: "x", tasks: [{ agent: "worker", task: "y" }] }, false, NINETY_MIN),
+			{ timeoutMs: NINETY_MIN },
+		);
+		assert.deepEqual(
+			resolveSingleAgentLaunchTimeout({ agent: "worker", task: "x", chain: [{ agent: "worker", task: "y" }] }, false, NINETY_MIN),
+			{ timeoutMs: NINETY_MIN },
+		);
+	});
+
+	it("applies the global config default in place of the single-agent async backstop", () => {
+		assert.deepEqual(resolveSingleAgentLaunchTimeout({}, true, NINETY_MIN), {
+			timeoutMs: NINETY_MIN,
+		});
+	});
+
+	it("lets an explicit call timeout win over the global config default", () => {
+		assert.deepEqual(resolveSingleAgentLaunchTimeout({ timeoutMs: 5_000 }, false, NINETY_MIN), {
+			timeoutMs: 5_000,
+		});
+	});
+
+	it("keeps composite async runs unbounded even with a global config default", () => {
+		assert.deepEqual(
+			resolveSingleAgentLaunchTimeout({ agent: "worker", task: "x", tasks: [{ agent: "worker", task: "y" }] }, true, NINETY_MIN),
+			{},
+		);
+	});
+});
+
+describe("resolveConfigDefaultTimeoutMs", () => {
+	it("returns a positive integer unchanged", () => {
+		assert.equal(resolveConfigDefaultTimeoutMs(90 * 60 * 1000), 90 * 60 * 1000);
+	});
+
+	it("treats unset config as no default", () => {
+		assert.equal(resolveConfigDefaultTimeoutMs(undefined), undefined);
+	});
+
+	it("ignores non-positive, non-integer, and non-numeric values", () => {
+		assert.equal(resolveConfigDefaultTimeoutMs(0), undefined);
+		assert.equal(resolveConfigDefaultTimeoutMs(-1), undefined);
+		assert.equal(resolveConfigDefaultTimeoutMs(1.5), undefined);
+		assert.equal(resolveConfigDefaultTimeoutMs("600000" as unknown), undefined);
+		assert.equal(resolveConfigDefaultTimeoutMs(Number.NaN), undefined);
+	});
+
+	it("accepts the maximum schedulable timer delay but ignores anything larger", () => {
+		// 2_147_483_647 is the largest delay a Node.js timer can honor; above it
+		// setTimeout overflows to ~1ms and the run would expire almost immediately.
+		assert.equal(resolveConfigDefaultTimeoutMs(2_147_483_647), 2_147_483_647);
+		assert.equal(resolveConfigDefaultTimeoutMs(2_147_483_648), undefined);
+		assert.equal(resolveConfigDefaultTimeoutMs(Number.MAX_SAFE_INTEGER), undefined);
+	});
 });

package/dist/extensions/pi-subagents/test/unit/worktree.test.ts

@@ -125,6 +125,67 @@ describe("worktree", () => {
 		}
 	});
 
+	it("rejects worktree base directories inside Selesai extensions", () => {
+		const repoDir = createRepo("selesai-worktree-extension-dir-");
+		const tempHome = fs.mkdtempSync(path.join(os.tmpdir(), "selesai-worktree-home-"));
+		const previousAgentDir = process.env.SELESAI_CODING_AGENT_DIR;
+		const previousHome = process.env.HOME;
+		const previousUserProfile = process.env.USERPROFILE;
+		const extensionsDir = path.join(tempHome, ".selesai", "agent", "extensions");
+		try {
+			process.env.HOME = tempHome;
+			process.env.USERPROFILE = tempHome;
+			delete process.env.SELESAI_CODING_AGENT_DIR;
+			assert.throws(
+				() => createWorktrees(repoDir, "extension-dir", 1, { baseDir: extensionsDir }),
+				/worktree base directory cannot be inside Pi extensions directory/i,
+			);
+			assert.throws(
+				() => createWorktrees(repoDir, "extension-subdir", 1, { baseDir: path.join(extensionsDir, "checkout") }),
+				/worktree base directory cannot be inside Pi extensions directory/i,
+			);
+		} finally {
+			if (previousAgentDir === undefined) delete process.env.SELESAI_CODING_AGENT_DIR;
+			else process.env.SELESAI_CODING_AGENT_DIR = previousAgentDir;
+			if (previousHome === undefined) delete process.env.HOME;
+			else process.env.HOME = previousHome;
+			if (previousUserProfile === undefined) delete process.env.USERPROFILE;
+			else process.env.USERPROFILE = previousUserProfile;
+			cleanupRepo(repoDir);
+			fs.rmSync(tempHome, { recursive: true, force: true });
+		}
+	});
+
+	it("rejects symlinked worktree base directories inside Selesai extensions", () => {
+		const repoDir = createRepo("selesai-worktree-extension-symlink-");
+		const tempHome = fs.mkdtempSync(path.join(os.tmpdir(), "selesai-worktree-home-"));
+		const previousAgentDir = process.env.SELESAI_CODING_AGENT_DIR;
+		const previousHome = process.env.HOME;
+		const previousUserProfile = process.env.USERPROFILE;
+		const extensionsDir = path.join(tempHome, ".selesai", "agent", "extensions");
+		const aliasDir = path.join(tempHome, "extension-alias");
+		try {
+			process.env.HOME = tempHome;
+			process.env.USERPROFILE = tempHome;
+			delete process.env.SELESAI_CODING_AGENT_DIR;
+			fs.mkdirSync(extensionsDir, { recursive: true });
+			fs.symlinkSync(extensionsDir, aliasDir, process.platform === "win32" ? "junction" : "dir");
+			assert.throws(
+				() => createWorktrees(repoDir, "extension-symlink", 1, { baseDir: path.join(aliasDir, "checkout") }),
+				/worktree base directory cannot be inside Pi extensions directory/i,
+			);
+		} finally {
+			if (previousAgentDir === undefined) delete process.env.SELESAI_CODING_AGENT_DIR;
+			else process.env.SELESAI_CODING_AGENT_DIR = previousAgentDir;
+			if (previousHome === undefined) delete process.env.HOME;
+			else process.env.HOME = previousHome;
+			if (previousUserProfile === undefined) delete process.env.USERPROFILE;
+			else process.env.USERPROFILE = previousUserProfile;
+			cleanupRepo(repoDir);
+			fs.rmSync(tempHome, { recursive: true, force: true });
+		}
+	});
+
 	it("uses SELESAI_SUBAGENTS_WORKTREE_DIR when no base directory is configured", () => {
 		const repoDir = createRepo("pi-worktree-env-base-dir-");
 		const previous = process.env.SELESAI_SUBAGENTS_WORKTREE_DIR;

package/dist/modes/interactive/interactive-mode.d.ts

@@ -398,6 +398,7 @@ export declare class InteractiveMode {
     private notifyAuthDialog;
     private loginProvider;
     private showLoginDialog;
+    private handleSettingsFactoryReset;
     private handleReloadCommand;
     private handleExportCommand;
     private getPathCommandArgument;

package/dist/modes/interactive/interactive-mode.js

@@ -9,7 +9,7 @@ import * as TuiLayouts from "@earendil-works/pi-tui";
 import { CombinedAutocompleteProvider, Container, fuzzyFilter, Markdown, matchesKey, ProcessTerminal, Spacer, setKeybindings, Text, TruncatedText, TuiAltScreen, TuiMainScreen, visibleWidth, } from "@earendil-works/pi-tui";
 import chalk from "chalk";
 import { spawn, spawnSync } from "child_process";
-import { APP_NAME, APP_TITLE, CONFIG_DIR_NAME, getAgentDir, getAuthPath, getDebugLogPath, getDocsPath, getShareViewerUrl, getUpdateInstruction, PACKAGE_NAME, VERSION, } from "../../config.js";
+import { APP_NAME, APP_TITLE, CONFIG_DIR_NAME, getAgentDir, getAuthPath, getBundledDefaultsDir, getDebugLogPath, getDocsPath, getShareViewerUrl, getUpdateInstruction, PACKAGE_NAME, VERSION, } from "../../config.js";
 import { parseSkillBlocks } from "../../core/agent-session.js";
 import { SessionImportFileNotFoundError } from "../../core/agent-session-runtime.js";
 import { CACHE_TTL_MS, collectCacheMisses, computeCacheWaste, detectCacheMiss, } from "../../core/cache-stats.js";
@@ -2319,6 +2319,11 @@ export class InteractiveMode {
                 this.editor.setText("");
                 return;
             }
+            if (text === "/settings-factory-reset") {
+                this.editor.setText("");
+                await this.handleSettingsFactoryReset();
+                return;
+            }
             if (text === "/scoped-models") {
                 this.editor.setText("");
                 await this.showModelsSelector();
@@ -4649,6 +4654,48 @@ export class InteractiveMode {
     // =========================================================================
     // Command handlers
     // =========================================================================
+    async handleSettingsFactoryReset() {
+        if (this.session.isStreaming) {
+            this.showWarning("Wait for the current response to finish before resetting settings.");
+            return;
+        }
+        if (this.session.isCompacting) {
+            this.showWarning("Wait for compaction to finish before resetting settings.");
+            return;
+        }
+        const settingsPath = path.join(getAgentDir(), "settings.json");
+        const confirmed = await this.showExtensionConfirm("Factory reset settings", `This replaces ${settingsPath} with the bundled factory defaults.\n\n`
+            + "Your credentials (auth.json), sessions, extensions, skills, and themes are NOT touched.\n"
+            + "A backup is saved next to the file before resetting.\n\n"
+            + "Continue?");
+        if (!confirmed) {
+            this.showStatus("Settings factory reset cancelled.");
+            return;
+        }
+        const bundledDefaultsDir = getBundledDefaultsDir();
+        const bundledPath = path.join(bundledDefaultsDir, "settings.json");
+        if (!fs.existsSync(bundledPath)) {
+            this.showError(`Bundled defaults not found at ${bundledPath}`);
+            return;
+        }
+        try {
+            if (fs.existsSync(settingsPath)) {
+                fs.copyFileSync(settingsPath, `${settingsPath}.bak`);
+            }
+            fs.copyFileSync(bundledPath, settingsPath);
+            try {
+                fs.chmodSync(settingsPath, 0o600);
+            }
+            catch {
+                // chmod is best-effort (no-op on platforms that don't support it).
+            }
+            await this.session.reload();
+            this.showStatus(`Settings reset to factory defaults (backup: ${settingsPath}.bak)`);
+        }
+        catch (error) {
+            this.showError(`Settings factory reset failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
     async handleReloadCommand() {
         if (this.session.isStreaming) {
             this.showWarning("Wait for the current response to finish before reloading.");

package/docs/quickstart.md

@@ -1,42 +1,26 @@
 # Quickstart
 
-This page gets you from install to a useful first pi session.
+This page gets you from install to a useful first Selesai session.
 
 ## Install
 
-Pi is distributed as an npm package:
+Selesai is distributed as an npm package:
 
 ```bash
-npm install -g --ignore-scripts @earendil-works/pi-coding-agent
+npm install -g @selesai/code
 ```
 
-`--ignore-scripts` disables dependency lifecycle scripts during install. Pi does not require install scripts for normal npm installs.
-
-### Uninstall
-
-Use the package manager that installed pi. The curl installer uses npm globally, so curl and npm installs are removed with npm:
+Then start Selesai in the project directory you want it to work on:
 
 ```bash
-# curl installer or npm install -g
-npm uninstall -g @earendil-works/pi-coding-agent
-
-# pnpm
-pnpm remove -g @earendil-works/pi-coding-agent
-
-# Yarn
-yarn global remove @earendil-works/pi-coding-agent
-
-# Bun
-bun uninstall -g @earendil-works/pi-coding-agent
+cd /path/to/project
+selesai
 ```
 
-Uninstalling pi leaves settings, credentials, sessions, and installed pi packages in `~/.pi/agent/`.
-
-Then start pi in the project directory you want it to work on:
+To install directly from the public repository (builds the latest `main` from source):
 
 ```bash
-cd /path/to/project
-pi
+npm install -g github:SelesaiInTech/selesai-code
 ```
 
 ## Authenticate
@@ -45,7 +29,7 @@ Pi can use subscription providers through `/login`, or API-key providers through
 
 ### Option 1: subscription login
 
-Start pi and run:
+Start Selesai and run:
 
 ```text
 /login
@@ -55,26 +39,26 @@ Then select a provider. Built-in subscription logins include Claude Pro/Max, Cha
 
 ### Option 2: API key
 
-Set an API key before launching pi:
+Set an API key before launching Selesai:
 
 ```bash
 export ANTHROPIC_API_KEY=sk-ant-...
-pi
+selesai
 ```
 
-You can also run `/login` and select an API-key provider to store the key in `~/.pi/agent/auth.json`.
+You can also run `/login` and select an API-key provider to store the key in `~/.selesai/agent/auth.json`.
 
 See [Providers](providers.md) for all supported providers, environment variables, and cloud-provider setup.
 
 ## First session
 
-Once pi starts, type a request and press Enter:
+Once Selesai starts, type a request and press Enter:
 
 ```text
 Summarize this repository and tell me how to run its checks.
 ```
 
-By default, pi gives the model four tools:
+By default, Selesai gives the model four tools:
 
 - `read` - read files
 - `write` - create or overwrite files
@@ -83,7 +67,7 @@ By default, pi gives the model four tools:
 
 Additional built-in read-only tools (`grep`, `find`, `ls`) are available through tool options. Pi runs in your current working directory and can modify files there. Use git or another checkpointing workflow if you want easy rollback.
 
-## Give pi project instructions
+## Give Selesai project instructions
 
 Pi loads context files at startup. Add an `AGENTS.md` file to tell it how to work in a project:
 
@@ -97,10 +81,10 @@ Pi loads context files at startup. Add an `AGENTS.md` file to tell it how to wor
 
 Pi loads:
 
-- `~/.pi/agent/AGENTS.md` for global instructions
+- `~/.selesai/agent/AGENTS.md` for global instructions
 - `AGENTS.md` or `CLAUDE.md` from parent directories and the current directory
 
-Restart pi, or run `/reload`, after changing context files.
+Restart Selesai, or run `/reload`, after changing context files.
 
 ## Common things to try
 
@@ -109,8 +93,8 @@ Restart pi, or run `/reload`, after changing context files.
 Type `@` in the editor to fuzzy-search files, or pass files on the command line:
 
 ```bash
-pi @README.md "Summarize this"
-pi @src/app.ts @src/app.test.ts "Review these together"
+selesai @README.md "Summarize this"
+selesai @src/app.ts @src/app.test.ts "Review these together"
 ```
 
 Images can be pasted with Ctrl+V (Alt+V on Windows) or dragged into supported terminals.
@@ -134,22 +118,22 @@ Use `/model` or Ctrl+L to choose a model. Use Shift+Tab to cycle thinking level.
 Sessions are saved automatically:
 
 ```bash
-pi -c                  # Continue most recent session
-pi -r                  # Browse previous sessions
-pi --name "my task"    # Set session display name at startup
-pi --session <path|id> # Open a specific session
+selesai -c                  # Continue most recent session
+selesai -r                  # Browse previous sessions
+selesai --name "my task"    # Set session display name at startup
+selesai --session <path|id> # Open a specific session
 ```
 
-Inside pi, use `/resume`, `/new`, `/tree`, `/fork`, and `/clone` to manage sessions.
+Inside Selesai, use `/resume`, `/new`, `/tree`, `/fork`, and `/clone` to manage sessions.
 
 ### Non-interactive mode
 
 For one-shot prompts:
 
 ```bash
-pi -p "Summarize this codebase"
-cat README.md | pi -p "Summarize this text"
-pi -p @screenshot.png "What's in this image?"
+selesai -p "Summarize this codebase"
+cat README.md | selesai -p "Summarize this text"
+selesai -p @screenshot.png "What's in this image?"
 ```
 
 Use `--mode json` for JSON event output or `--mode rpc` for process integration.

package/docs/settings.md

@@ -322,3 +322,7 @@ Project settings (`.selesai/settings.json`) override global settings. Nested obj
   "compaction": { "enabled": true, "reserveTokens": 8192 }
 }
 ```
+
+## Factory Reset
+
+Run `/settings-factory-reset` inside a session to restore the global settings file (`~/.selesai/agent/settings.json`) to the bundled factory defaults. The command warns before replacing the file, saves a backup as `settings.json.bak` next to it, and leaves credentials (`auth.json`), sessions, extensions, skills, and themes untouched. Settings take effect immediately after the reset (equivalent to `/reload`).

package/docs/usage.md

@@ -43,6 +43,7 @@ Type `/` in the editor to open command completion. Extensions can register custo
 | `/model` | Switch models |
 | `/scoped-models` | Enable/disable models for Ctrl+P cycling |
 | `/settings` | Thinking level, theme, message delivery, transport |
+| `/settings-factory-reset` | Reset settings to factory defaults (with confirmation) |
 | `/resume` | Pick from previous sessions |
 | `/new` | Start a new session |
 | `/name <name>` | Set session display name |

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@selesai/code",
-	"version": "0.8.4",
+	"version": "0.8.5",
 	"description": "Maintained, extension-first Pi coding agent with built-in workflows, subagents, web research, questions, skills, and an enhanced terminal UI.",
 	"type": "module",
 	"repository": {
@@ -50,6 +50,7 @@
 	],
 	"scripts": {
 		"clean": "shx rm -rf dist",
+		"prepare": "npm run build",
 		"build": "npm run clean && tsgo -p tsconfig.build.json && shx chmod +x dist/cli.js dist/rpc-entry.js && npm run copy-assets",
 		"copy-assets": "shx mkdir -p dist/modes/interactive/theme && shx cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && shx mkdir -p dist/modes/interactive/assets && shx cp src/modes/interactive/assets/*.png dist/modes/interactive/assets/ && shx mkdir -p dist/core/export-html/vendor && shx cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && shx cp src/core/export-html/vendor/*.js dist/core/export-html/vendor/ && shx mkdir -p dist/defaults && shx cp src/defaults/* dist/defaults/ && shx mkdir -p dist/extensions && node scripts/copy-extensions.mjs && shx mkdir -p dist/themes && shx cp -r src/themes/. dist/themes/ && shx mkdir -p dist/skills && shx cp -r src/skills/. dist/skills/"
 	},