@henryqw/pi-add-dir 2.1.2 → 2.1.4

package/README.md

@@ -32,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
 
@@ -46,12 +46,12 @@ 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.
 
 ## Limits and recovery
 
-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.
+Search supports basename and relative-path globs. It skips `.git` and `node_modules` and does not follow symbolic links. 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.2",
+  "version": "2.1.4",
   "description": "Add external directories to a Pi session with context, skills, and file search.",
   "keywords": [
     "pi-package",