@zigai/pi-mention-project 0.2.0 → 0.2.2

package/README.md

@@ -4,7 +4,7 @@
 [![npm downloads](https://img.shields.io/npm/dm/@zigai/pi-mention-project.svg)](https://www.npmjs.com/package/@zigai/pi-mention-project)
 [![license](https://img.shields.io/npm/l/@zigai/pi-mention-project.svg)](../../LICENSE)
 
-This Pi extension adds fuzzy project directory mentions that default to `#`.
+Type `#` to fuzzy-search your project folder. The completion inserts `#project-name`; the model receives the project's absolute path.
 
 ## Install
 
@@ -12,65 +12,31 @@ This Pi extension adds fuzzy project directory mentions that default to `#`.
 pi install npm:@zigai/pi-mention-project
 ```
 
-## Features
+## Config
 
-- Adds fuzzy autocomplete for project folders with `#` mentions.
-- Searches only the direct child folders inside configured project roots.
-- Defaults to Git repository folders and ignores dot-prefixed folders.
-- Expands project mentions before the model sees the prompt so the model gets each project's absolute path.
-
-## Usage
-
-Configure one or more project roots, then type `#` in the prompt editor and start typing a folder name.
-
-If `~/Projects` contains `pi-tweaks`, selecting `#pi-tweaks` adds that project mention. Before the model sees the prompt, the extension prepends project metadata with the absolute project path and removes the `#` sigil from the visible sentence.
-
-## Configuration
-
-Configuration lives in Pi settings: globally in `~/.pi/agent/settings.json`, or per trusted project in `.pi/settings.json`.
-
-Project roots default to an empty list. Set `mentionProjectRoots` to the directories whose direct child folders should be mentionable:
-
-```json
-{
-  "mentionProjectRoots": ["~/Projects", "~/Work"]
-}
-```
-
-Only immediate child directories are listed. For example, `~/Projects/app` is mentionable, but `~/Projects/app/packages/api` is not.
-
-By default, a child folder is listed only when it has a `.git` directory or worktree `.git` file, and folders whose names start with `.` are hidden. To include non-Git folders, set `mentionProjectGitReposOnly` to `false`:
+Add roots in `~/.pi/agent/settings.json` or `.pi/settings.json`:
 
 ```json
 {
-  "mentionProjectGitReposOnly": false
+  "mentionProjectRoots": ["~/Projects"]
 }
 ```
 
-To include dot-prefixed folders, set `mentionProjectIncludeDotFolders` to `true`:
+By default it lists only direct child folders that:
 
-```json
-{
-  "mentionProjectIncludeDotFolders": true
-}
-```
+- are Git repos (`.git` directory or worktree file)
+- do not start with `.`
 
-For one-off runs, the same filters can be relaxed with CLI flags:
-
-```sh
-pi --mention-project-include-non-git --mention-project-include-dot-folders
-```
-
-The mention character defaults to `#`. To change it, set `mentionProjectTrigger` to a single non-whitespace character:
+Optional settings:
 
 ```json
 {
-  "mentionProjectTrigger": "@"
+  "mentionProjectTrigger": "#",
+  "mentionProjectGitReposOnly": true,
+  "mentionProjectIncludeDotFolders": false
 }
 ```
 
-Folder names should be unique across configured roots. If the same folder name exists in multiple roots, the first configured root wins.
-
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zigai/pi-mention-project",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Pi package that adds fuzzy project directory mentions.",
   "keywords": [
     "mention",

package/src/expand-mentions.ts

@@ -7,31 +7,6 @@ import {
 } from "./mention-syntax.ts";
 import type { ProjectDirectory } from "./types.ts";
 
-function escapeXmlText(value: string): string {
-    return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-}
-
-function escapeXmlAttribute(value: string): string {
-    return escapeXmlText(value).replace(/"/g, "&quot;");
-}
-
-function formatProjectBlock(project: ProjectDirectory): string {
-    const name = escapeXmlAttribute(project.name);
-    const projectPath = escapeXmlAttribute(project.path);
-    const root = escapeXmlAttribute(project.root);
-    return `<project name="${name}" path="${projectPath}" root="${root}">\nDirectory: ${escapeXmlText(project.path)}\n</project>`;
-}
-
-function formatCombinedProjectBlock(projects: ProjectDirectory[]): string {
-    if (projects.length === 1) {
-        const project = projects[0];
-        if (project !== undefined) return formatProjectBlock(project);
-    }
-
-    const content = projects.map((project) => formatProjectBlock(project)).join("\n\n");
-    return `<projects>\n${content}\n</projects>`;
-}
-
 function projectMap(projects: ProjectDirectory[]): Map<string, ProjectDirectory> {
     const byName = new Map<string, ProjectDirectory>();
     for (const project of projects) {
@@ -41,69 +16,36 @@ function projectMap(projects: ProjectDirectory[]): Map<string, ProjectDirectory>
     return byName;
 }
 
-function mentionedProjectNames(
-    text: string,
-    projects: ProjectDirectory[],
-    trigger: string,
-): Set<string> {
-    const names = new Set<string>();
-    const knownNames = projectNameSet(projects);
-
-    for (const match of text.matchAll(projectMentionPattern(trigger))) {
-        const parsed = parseProjectMentionName(match[2], match[3], knownNames);
-        if (parsed !== undefined) {
-            names.add(parsed.name);
-        }
-    }
-
-    return names;
-}
-
-function removeProjectMentionSigils(
-    text: string,
-    projects: ProjectDirectory[],
-    trigger: string,
-): string {
-    const knownNames = projectNameSet(projects);
-    return text
-        .replace(
-            projectMentionPattern(trigger),
-            (
-                match: string,
-                leading: string,
-                quotedName: string | undefined,
-                unquotedName: string | undefined,
-            ) => {
-                const parsed = parseProjectMentionName(quotedName, unquotedName, knownNames);
-                if (parsed === undefined) return match;
-                return `${leading}${parsed.name}${parsed.suffix}`;
-            },
-        )
-        .trim();
-}
-
 export function expandProjectMentions(
     text: string,
     projects: ProjectDirectory[],
     trigger: string,
 ): string {
     const byName = projectMap(projects);
-    const names = mentionedProjectNames(text, projects, trigger);
-    if (names.size === 0) return text;
-
-    const loaded: ProjectDirectory[] = [];
-    for (const name of names) {
-        const project = byName.get(name);
-        if (project !== undefined) {
-            loaded.push(project);
-        }
-    }
-    if (loaded.length === 0) return text;
+    const knownNames = projectNameSet(projects);
+    let changed = false;
 
-    const projectBlock = formatCombinedProjectBlock(loaded);
-    const userMessage = removeProjectMentionSigils(text, projects, trigger);
-    if (userMessage.length === 0) return projectBlock;
-    return `${projectBlock}\n\n${userMessage}`;
+    const expanded = text.replace(
+        projectMentionPattern(trigger),
+        (
+            match: string,
+            leading: string,
+            quotedName: string | undefined,
+            unquotedName: string | undefined,
+        ) => {
+            const parsed = parseProjectMentionName(quotedName, unquotedName, knownNames);
+            if (parsed === undefined) return match;
+
+            const project = byName.get(parsed.name);
+            if (project === undefined) return match;
+
+            changed = true;
+            return `${leading}${project.path}${parsed.suffix}`;
+        },
+    );
+
+    if (!changed) return text;
+    return expanded;
 }
 
 type ContextMessage = ContextEvent["messages"][number];