@henryqw/pi-add-dir 2.1.1 → 2.1.3

package/README.md

@@ -2,7 +2,7 @@
 
 Give the current Pi session context, skills, and searchable files from directories outside the workspace. Reuse those resources in place without copying or linking their directories.
 
-![Pi using added external directories by name](./example.png)
+![Pi using added external directories by name](https://raw.githubusercontent.com/HenryQW/pi-harness/main/extensions/pi-add-dir/example.png)
 
 ## Install
 
@@ -12,17 +12,19 @@ pi install npm:@henryqw/pi-add-dir
 
 ## Use
 
-Run `/dir-add`, enter a directory, then run `/dir-ls`. Pi lists the directory and exposes its supported resources.
+Run `/dir-add`, enter a directory, then run `/dir-ls` to confirm it was added. Pi lists the directory and exposes its supported resources.
+
+Use slash commands from the Pi prompt as a human; Pi agents use the tools.
 
 | Surface | Type | Purpose |
 | --- | --- | --- |
-| `/dir-add [path]` | command | Add to the current session; no path opens input. Supports `~`. |
-| `/dir-add --project [path]` | command | Persist for the current Git repository and all its linked worktrees. |
-| `/dir-add --global [path]` | command | Persist for every Pi workspace for this user. |
+| `/dir-add [path]` | command | Add to this session by default; pass `--project` or `--global` before the path to persist for this Git repository's linked worktrees or every workspace. Omit the path to enter it when prompted; supports `~`. |
 | `/dir-ls` | command | List directories with their scope; select one to remove from that scope. |
 | `/dir-reload` | command | Reload external directory resources. |
-| `add_directory` | tool | Add a directory. |
-| `search_external_files` | tool | Glob-search added directories. |
+| `add_directory(path)` | tool | Add a directory to this session and return its context and instructions. |
+| `search_external_files(pattern, maxResults?)` | tool | Glob-search added directories; returns up to 50 results by default, configurable to 1,000. |
+| `@` file autocomplete | ui | Find files in added directories and insert their absolute paths. |
+| External directory widget | ui | Show added directories and point to `/dir-ls` for management. |
 
 Added directories give Pi these resources:
 
@@ -30,7 +32,7 @@ Added directories give Pi these resources:
 - Skills that Pi loads from `.pi/skills`, `.agents/skills`, and `.claude/skills`.
 - Files in the editor's `@` autocomplete, with absolute paths.
 
-`/dir-add` reloads when it finds skills. `add_directory` reports when a reload is needed and always remains session-local.
+`/dir-add` reloads only when the discovered external skill paths change, not merely because the directory contains skills. `add_directory` stays session-local; when its result asks for `/reload`, run it to update external skills.
 
 ## Config
 
@@ -44,7 +46,7 @@ A missing file uses the default. Invalid config stops loading and is not overwri
 
 ## State and storage
 
-Session directories live in the current session branch. Project directories use the repository's repeatable local Git config key `pi-add-dir.directory`. Local Git config is shared by linked worktrees, cannot be injected by cloning a repository, and remains machine-local. `/dir-add --project` therefore requires a Git repository.
+Session directories live in the current session branch. New session additions reject directories inside or containing the current working directory, or overlapping another active added directory. Restored session entries are not rechecked for overlap when the working directory changes. Project directories use the repository's repeatable local Git config key `pi-add-dir.directory`. Local Git config is shared by linked worktrees, cannot be injected by cloning a repository, and remains machine-local. `/dir-add --project` therefore requires a Git repository.
 
 Persistent scopes are explicit because added directories can inject `AGENTS.md`, `CLAUDE.md`, and skills.
 
@@ -52,4 +54,4 @@ Persistent scopes are explicit because added directories can inject `AGENTS.md`,
 
 Search supports basename and relative-path globs. It skips `.git` and `node_modules`. It uses Node filesystem traversal and returns at most 1,000 results per call.
 
-Missing directories and directories that overlap the current workspace remain configured but are skipped with a warning. Fix or remove them through `/dir-ls`.
+Missing or overlapping **project and global** directories remain configured but are skipped with a warning. Restore a missing directory at its original path or resolve the overlap, then run `/dir-reload` to rescan. To change or discard a configured path, use `/dir-ls` to **remove** it from its scope, then `/dir-add` with the corrected path if needed; `/dir-ls` cannot repair paths in place.

package/extensions/add-dir-config.ts

@@ -19,7 +19,6 @@ function parseConfig(value: unknown): AddDirConfig {
 			(directory) =>
 				typeof directory !== "string" ||
 				!isAbsolute(directory) ||
-				directory.length === 0 ||
 				/\p{C}/u.test(directory),
 		)
 	) {

package/extensions/add-dir.ts

@@ -107,7 +107,7 @@ function parseAddArgs(args: string | undefined): ParsedAddArgs {
 function validateStoredPaths(paths: string[], source: DirSource): void {
 	if (
 		paths.some(
-			(path) => typeof path !== "string" || !isAbsolute(path) || path.length === 0 || /\p{C}/u.test(path),
+			(path) => typeof path !== "string" || !isAbsolute(path) || /\p{C}/u.test(path),
 		)
 	) {
 		throw new Error(`Invalid ${source} pi-add-dir configuration: expected absolute paths.`);
@@ -642,8 +642,8 @@ export default function addDirExtension(pi: ExtensionAPI, options: ExtensionOpti
 			}
 			if (context.skills.size > 0) {
 				response.push(`\nDiscovered skills: ${[...context.skills].join(", ")}`);
-				response.push("Run /reload to register skills as /skill:name commands.");
 			}
+			if (result.resourcesChanged) response.push("Run /reload to update external skills.");
 			response.push(`\nYou can now access files at: ${absolutePath}`);
 
 			return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@henryqw/pi-add-dir",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "description": "Add external directories to a Pi session with context, skills, and file search.",
   "keywords": [
     "pi-package",