promptscout 1.3.2 → 1.5.0

package/README.md

@@ -4,11 +4,14 @@ A CLI tool that enriches your coding agent prompts with codebase context using a
 
 **Designed as a Claude Code plugin.** It hooks into your prompt submission flow and adds codebase context before Claude sees it.
 
+<img width="1715" height="1230" alt="CleanShot 2026-02-13 at 02 49 39" src="https://github.com/user-attachments/assets/d37eba7d-8697-4a2a-b231-b4217b90692e" />
+
+
 ## Motivation
 
 When you ask a coding agent like Claude Code, Cursor, or Copilot to work on your codebase, the agent spends time and tokens discovering which files matter. It greps, reads, explores, all on your dime.
 
-promptscout does that discovery locally, for free. A small local LLM reads your prompt, searches your codebase with `grep` and `git`, and appends the results to your original prompt. The paid agent gets a prompt that already contains the relevant file paths, code snippets, and commit history. It can skip straight to the actual work.
+promptscout does that discovery locally, for free. A small local LLM reads your prompt, searches your codebase with `ripgrep` and `git`, and appends the results to your original prompt. The paid agent gets a prompt that already contains the relevant file paths, code snippets, and commit history. It can skip straight to the actual work.
 
 Your original prompt is never modified. promptscout only appends context.
 
@@ -17,16 +20,22 @@ Your original prompt is never modified. promptscout only appends context.
 ```mermaid
 flowchart LR
     A["Raw Prompt"] --> B["Local LLM<br/>(Qwen 3 4B)"]
-    B -->|"tool calls"| C["Execute Tools"]
-    C --> D["grep / git"]
-    D --> E["Original Prompt<br/>+ Discovered Context"]
+    B -->|"tool calls"| C["ripgrep / git"]
+    C --> D["Original Prompt<br/>+ Discovered Context"]
+
+    subgraph B_ctx[" "]
+        direction TB
+        T["Project Tree<br/>(git ls-files)"]
+    end
+    T -.->|"context"| B
 ```
 
 1. You run `promptscout "check the auth module, there might be a token refresh bug"`
-2. The local LLM reads your prompt and picks which tools to call (e.g. `file_finder("auth")`, `section_finder("refresh")`, `git_history("token")`)
-3. Each tool runs against your codebase using `grep` and `git`
-4. The output is your original prompt unchanged, followed by the discovered context
-5. The result is copied to your clipboard, ready to paste into your coding agent
+2. The local LLM sees your prompt along with the project file tree (`git ls-files`) and decides which search tools to call
+3. The LLM outputs tool calls directly as JSON (e.g. `file_finder("auth")`, `section_finder("token")`, `git_history("refresh")`)
+4. Each tool runs against your codebase using `ripgrep` and `git`
+5. The output is your original prompt unchanged, followed by the discovered context
+6. The result is copied to your clipboard, ready to paste into your coding agent
 
 ## Installation
 
@@ -34,6 +43,8 @@ flowchart LR
 
 - Node.js >= 20
 - C++ compiler (Xcode Command Line Tools on macOS, `build-essential` on Linux)
+- [ripgrep](https://github.com/BurntSushi/ripgrep) (`rg`) for fast codebase search
+- `git` (for project tree generation and commit history search)
 - ~3GB disk space for the model
 
 ### Install
@@ -94,13 +105,13 @@ If `promptscout` is not installed or fails for any reason, the plugin falls back
 promptscout uses `Qwen 3 4B` (`Q4_K_M` quantization) running locally via [node-llama-cpp](https://github.com/withcatai/node-llama-cpp). The model uses GPU acceleration automatically when available (Metal on macOS, CUDA on Linux).
 
 - Size: ~2.5GB (`GGUF Q4_K_M`)
-- Context: 4096 tokens
+- Context: 8192 tokens
 - Latency: ~2s per prompt (Metal, Apple Silicon)
-- Purpose: Decides which search tools to call based on your prompt. Does not rewrite your text.
+- Purpose: Decides which search tools to call based on your prompt and the project file tree. Does not rewrite your text.
 
 ## Tools
 
-promptscout has 5 built-in tools that the LLM can invoke:
+promptscout has 5 built-in search tools. The LLM picks which ones to call and with what keywords:
 
 | Tool | What it does |
 |---|---|
@@ -110,7 +121,7 @@ promptscout has 5 built-in tools that the LLM can invoke:
 | `import_tracer` | Finds import/require/include statements referencing a module. |
 | `git_history` | Finds recent commits that added or removed code matching a keyword. |
 
-All `grep`-based tools respect `.gitignore` and skip binary files.
+All search tools use `ripgrep`, which respects `.gitignore` and skips binary files automatically.
 
 ## Usage
 
@@ -170,6 +181,70 @@ promptscout history show 42
 promptscout history clear
 ```
 
+## Templates
+
+promptscout supports per-directory prompt templates. A template wraps your enriched prompt with custom instructions using the `<@prompt>` placeholder.
+
+### Example template
+
+```
+You are an expert developer working on a React Native project.
+Always prefer functional components and hooks.
+
+<@prompt>
+
+Follow the project's ESLint rules and use TypeScript strictly.
+```
+
+When you run `promptscout "fix the navigation bug"`, the output becomes:
+
+```
+You are an expert developer working on a React Native project.
+Always prefer functional components and hooks.
+
+fix the navigation bug
+
+Context from codebase:
+<file_finder query="navigation">
+...
+</file_finder>
+
+Follow the project's ESLint rules and use TypeScript strictly.
+```
+
+### Managing templates
+
+```bash
+# Create or edit a template for the current directory (opens $EDITOR)
+promptscout template edit
+
+# Create or edit a template for a specific directory
+promptscout template edit -d /path/to/project
+
+# View the template for a directory
+promptscout template show -d /path/to/project
+
+# Delete a template
+promptscout template delete -d /path/to/project
+
+# List all templates
+promptscout template list
+```
+
+Templates are stored in the promptscout database (`~/.promptscout/promptscout.db`), not in your project files.
+
+### Directory resolution
+
+Templates use nearest-ancestor matching. If you set a template for `/projects/monorepo`, it also applies when running from `/projects/monorepo/packages/api` or any subdirectory, unless that subdirectory has its own template.
+
+### Claude Code plugin
+
+When the Claude Code plugin detects a template was used, it shows an indicator in the status message:
+
+```
+promptscout: (template used) enriched context (+5 files) (+3 sections)
+```
+
 ## Examples
 
 ### Swift project (macOS audio capture tool)
@@ -188,26 +263,35 @@ Context from codebase:
 <file_finder query="audio">
 Sources/Core/AudioCaptureSession.swift
 Sources/Core/AudioTapManager.swift
-entitlements.plist
+Sources/Info.plist
+Sources/main.swift
+Sources/CLI/ArgumentParser.swift
+Sources/CLI/ExitCodes.swift
 README.md
-Sources/Core/InputDeviceQuery.swift
+entitlements.plist
 Sources/IO/RingBuffer.swift
-Sources/IO/WAVWriter.swift
-Sources/CLI/ExitCodes.swift
+Package.swift
 </file_finder>
 
-<git_history query="audio">
-d41aece Initial commit: audiograb - macOS system audio capture CLI
-  Package.swift
-  README.md
-  Sources/CLI/ArgumentParser.swift
-  Sources/Core/AudioCaptureSession.swift
-  Sources/Core/AudioTapManager.swift
-  Sources/IO/RingBuffer.swift
-  Sources/main.swift
-d800ac1 Add microphone recording support via --source mic flag
-  Sources/Info.plist
-</git_history>
+<definition_finder query="format">
+Sources/main.swift:49:              let tapFormat = tapManager.tapFormat else {
+Sources/main.swift:53:        let outputSampleRate = UInt32(tapFormat.mSampleRate)
+Sources/main.swift:55:        let sourceChannels = Int(tapFormat.mChannelsPerFrame)
+Sources/Core/InputDeviceQuery.swift:41:    var formatAddress = AudioObjectPropertyAddress(
+Sources/Core/InputDeviceQuery.swift:46:    var format = AudioStreamBasicDescription()
+Sources/Core/AudioTapManager.swift:23:        case .formatQueryFailed(let status):
+Sources/Core/AudioTapManager.swift:34:    private(set) var tapFormat: AudioStreamBasicDescription?
+Sources/Core/AudioTapManager.swift:103:    private func queryTapFormat(tapID: AudioObjectID) throws -> AudioStreamBasicDescription {
+Sources/Core/AudioTapManager.swift:110:        var format = AudioStreamBasicDescription()
+Sources/Core/AudioTapManager.swift:112:        let status = AudioObjectGetPropertyData(tapID, &address, 0, nil, &size, &format)
+</definition_finder>
+
+<import_tracer query="audio">
+Sources/IO/RingBuffer.swift:39:    /// Write bytes into the ring buffer. Called from the real-time audio thread.
+README.md:13:Download the latest build from the releases page.
+README.md:77:Record from the default microphone instead of system audio.
+README.md:149:The included entitlements.plist declares com.apple.security.device.audio-input.
+</import_tracer>
 ```
 
 ### TypeScript project (task management CLI)
@@ -223,25 +307,48 @@ I want to add task filtering by status and tags. check how tasks are stored and
 Context from codebase:
 
 <file_finder query="task">
+src/services/task.ts
+src/commands/task.ts
+src/commands/subtask.ts
 tests/commands/subtask.test.ts
 tests/commands/task.test.ts
-src/commands/task.ts
-src/services/task.ts
-tests/integration/workflows.test.ts
-tests/commands/comment.test.ts
-tests/commands/history.test.ts
+package.json
+src/services/epic.ts
+README.md
+CLAUDE.md
+src/services/history.ts
 </file_finder>
 
-<definition_finder query="Task">
-tests/integration/workflows.test.ts:10:interface Task {
+<section_finder query="status">
+src/services/task.ts:9:  TaskStatus,
+src/services/task.ts:73:  status?: TaskStatus;
+src/services/task.ts:81:  if (options?.status) {
+src/services/task.ts:82:    conditions.push(eq(tasks.status, options.status));
+src/services/list.ts:56:  if (options?.statuses && options.statuses.length > 0) {
+src/services/list.ts:57:    const placeholders = options.statuses.map(() => "?").join(", ");
+src/services/list.ts:58:    conditions.push(`status IN (${placeholders})`);
+</section_finder>
+
+<section_finder query="tag">
+src/services/task.ts:56:    tags: input.tags ?? null,
+src/services/task.ts:140:  if (input.tags !== undefined) updates.tags = input.tags;
+src/commands/task.ts:29:  .option("--tags <tags>", "Comma-separated tags")
+src/commands/task.ts:91:  .option("--tags <tags>", "New tags (comma-separated)")
+</section_finder>
+
+<definition_finder query="task">
+src/services/task.ts:16:export function createTask(input: CreateTaskInput): Task {
+src/services/task.ts:66:export function getTask(id: string): Task | undefined {
 src/services/task.ts:72:export function listTasks(options?: {
+src/services/task.ts:116:export function updateTask(id: string, input: UpdateTaskInput): Task {
 </definition_finder>
 
-<section_finder query="listTasks">
-src/commands/task.ts:5:  listTasks,
-src/commands/task.ts:58:      const tasks = listTasks({
-src/services/task.ts:72:export function listTasks(options?: {
-</section_finder>
+<import_tracer query="task">
+src/services/task.ts:3:import { tasks, projects, epics } from "../db/schema";
+src/services/comment.ts:3:import { comments, tasks } from "../db/schema";
+src/services/dependency.ts:3:import { dependencies, tasks } from "../db/schema";
+src/commands/task.ts:8:} from "../services/task";
+</import_tracer>
 ```
 
 ### React/TypeScript project (terminal ebook downloader)
@@ -258,35 +365,38 @@ and find the related components
 Context from codebase:
 
 <file_finder query="search">
-src/tui/layouts/search/search-input/SearchWarning.tsx
 src/tui/layouts/search/search-input/SearchInput.tsx
+src/tui/layouts/search/search-input/SearchWarning.tsx
 src/tui/layouts/search/index.tsx
 src/tui/layouts/search/search-input/index.tsx
-README.md
-package.json
+src/options.ts
+src/labels.ts
+src/constants.ts
+src/utils.ts
+src/settings.ts
 CLAUDE.md
-src/tui/index.tsx
 </file_finder>
 
-<section_finder query="search">
-src/tui/components/ResultListInfo.tsx:6:  const searchValue = useBoundStore((state) => state.searchValue);
-CLAUDE.md:30:- `libgen-downloader -s "query"` - Direct search with TUI
-CLAUDE.md:43:  - `Adapter.ts` - Abstract base for different search sources
-CLAUDE.md:54:- `app.ts` - UI state, layouts, loading indicators, search state
-CLAUDE.md:58:- `cache.ts` - Search result caching mechanism
-</section_finder>
+<definition_finder query="search">
+src/api/data/document.ts:3:export async function getDocument(searchURL: string): Promise<Document> {
+src/constants.ts:1:export const SEARCH_MIN_CHAR = 3;
+src/settings.ts:11:export const SEARCH_PAGE_SIZE = 25;
+src/tui/store/events.ts:31:    const searchURL = get().mirrorAdapter?.getSearchURL(query, pageNumber, SEARCH_PAGE_SIZE);
+src/tui/store/events.ts:68:    const entries = await store.search(store.searchValue, store.currentPage);
+src/tui/layouts/search/index.tsx:8:const Search: React.FC = () => {
+</definition_finder>
 ```
 
-### Feedback detection
+### No-context detection
 
-When the prompt is feedback or an observation (not asking to change code), promptscout returns it unchanged with no context appended:
+When the prompt has no technical keywords (pure acknowledgment), promptscout returns it unchanged:
 
 ```
-$ promptscout "that didn't solve the issue, it is still rotated 90 degrees clockwise"
+$ promptscout "thanks, that works perfectly"
 ```
 
 ```
-that didn't solve the issue, it is still rotated 90 degrees clockwise
+thanks, that works perfectly
 ```
 
 ## License

package/dist/commands/templates.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import type { TemplateService } from "../core/template-service.js";
+export declare function registerTemplateCommand(program: Command, templateService: TemplateService): void;

package/dist/commands/templates.js

@@ -0,0 +1,62 @@
+export function registerTemplateCommand(program, templateService) {
+    const tmpl = program
+        .command("template")
+        .description("Manage per-directory prompt templates");
+    // promptscout template edit [-d <dir>]
+    tmpl
+        .command("edit")
+        .option("-d, --dir <dir>", "Target directory", process.cwd())
+        .action((opts) => {
+        const dir = opts.dir;
+        const saved = templateService.edit(dir);
+        if (saved) {
+            console.log(`Template saved for ${dir}`);
+        }
+        else {
+            console.log("Template not saved (empty content).");
+        }
+    });
+    // promptscout template show [-d <dir>]
+    tmpl
+        .command("show")
+        .option("-d, --dir <dir>", "Target directory", process.cwd())
+        .action((opts) => {
+        const dir = opts.dir;
+        const content = templateService.get(dir);
+        if (content) {
+            console.log(content);
+        }
+        else {
+            console.log(`No template found for ${dir}`);
+        }
+    });
+    // promptscout template delete [-d <dir>]
+    tmpl
+        .command("delete")
+        .option("-d, --dir <dir>", "Target directory", process.cwd())
+        .action((opts) => {
+        const dir = opts.dir;
+        const deleted = templateService.delete(dir);
+        if (deleted) {
+            console.log(`Template deleted for ${dir}`);
+        }
+        else {
+            console.log(`No template found for ${dir}`);
+        }
+    });
+    // promptscout template list
+    tmpl
+        .command("list")
+        .action(() => {
+        const entries = templateService.list();
+        if (entries.length === 0) {
+            console.log("No templates defined.");
+            return;
+        }
+        for (const entry of entries) {
+            const preview = entry.content.split("\n")[0]?.slice(0, 60) ?? "";
+            console.log(`  ${entry.directory}  ${preview}...`);
+        }
+    });
+}
+//# sourceMappingURL=templates.js.map

package/dist/commands/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/commands/templates.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,uBAAuB,CACrC,OAAgB,EAChB,eAAgC;IAEhC,MAAM,IAAI,GAAG,OAAO;SACjB,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,uCAAuC,CAAC,CAAC;IAExD,uCAAuC;IACvC,IAAI;SACD,OAAO,CAAC,MAAM,CAAC;SACf,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SAC5D,MAAM,CAAC,CAAC,IAA6B,EAAE,EAAE;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAa,CAAC;QAC/B,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,uCAAuC;IACvC,IAAI;SACD,OAAO,CAAC,MAAM,CAAC;SACf,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SAC5D,MAAM,CAAC,CAAC,IAA6B,EAAE,EAAE;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAa,CAAC;QAC/B,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,yCAAyC;IACzC,IAAI;SACD,OAAO,CAAC,QAAQ,CAAC;SACjB,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SAC5D,MAAM,CAAC,CAAC,IAA6B,EAAE,EAAE;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAa,CAAC;QAC/B,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,4BAA4B;IAC5B,IAAI;SACD,OAAO,CAAC,MAAM,CAAC;SACf,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,SAAS,KAAK,OAAO,KAAK,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/constants.d.ts

@@ -4,7 +4,7 @@ export declare const MODEL_DIR: string;
 export declare const MODEL_FILE_NAME = "Qwen3-4B-Q4_K_M.gguf";
 export declare const MODEL_HF_URI: string;
 export declare const MODEL_DOWNLOAD_URI = "hf:Qwen/Qwen3-4B-GGUF:Q4_K_M";
-export declare const LLM_CONTEXT_SIZE = 4096;
+export declare const LLM_CONTEXT_SIZE = 8192;
 export declare const MODEL_HF_URI_KEY = "model_hf_uri";
 export declare const MODEL_CONTEXT_SIZE_KEY = "model_context_size";
 export declare const GPU_LAYERS: "auto";

package/dist/constants.js

@@ -7,8 +7,7 @@ export const MODEL_DIR = join(DATA_DIR, "models");
 export const MODEL_FILE_NAME = "Qwen3-4B-Q4_K_M.gguf";
 export const MODEL_HF_URI = join(MODEL_DIR, MODEL_FILE_NAME);
 export const MODEL_DOWNLOAD_URI = "hf:Qwen/Qwen3-4B-GGUF:Q4_K_M";
-// 3.5K
-export const LLM_CONTEXT_SIZE = 4096;
+export const LLM_CONTEXT_SIZE = 8192;
 export const MODEL_HF_URI_KEY = "model_hf_uri";
 export const MODEL_CONTEXT_SIZE_KEY = "model_context_size";
 // "auto" lets node-llama-cpp offload as many layers as fit in GPU/Metal memory

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;AAEvB,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;AACtD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AAEjE,OAAO;AACP,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAC/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,+EAA+E;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAG,MAAe,CAAC;AAE1C,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;AAEvB,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;AACtD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AAEjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAC/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,+EAA+E;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAG,MAAe,CAAC;AAE1C,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC"}

package/dist/core/orchestrator.d.ts

@@ -1,10 +1,12 @@
 import type { ProcessOptions } from "../types.js";
 import type { HistoryRepo } from "../storage/history-repo.js";
 import type { Rewriter } from "./rewriter.js";
+import type { TemplateService } from "./template-service.js";
 export declare class Orchestrator {
     private historyRepo;
     private rewriter;
-    constructor(historyRepo: HistoryRepo, rewriter: Rewriter);
+    private templateService;
+    constructor(historyRepo: HistoryRepo, rewriter: Rewriter, templateService: TemplateService);
     processPrompt(options: ProcessOptions): Promise<{
         improved: string;
     }>;

package/dist/core/orchestrator.js

@@ -4,21 +4,25 @@ import ora from "ora";
 export class Orchestrator {
     historyRepo;
     rewriter;
-    constructor(historyRepo, rewriter) {
+    templateService;
+    constructor(historyRepo, rewriter, templateService) {
         this.historyRepo = historyRepo;
         this.rewriter = rewriter;
+        this.templateService = templateService;
     }
     async processPrompt(options) {
         const { rawPrompt, dryRun, outputFile, jsonOutput, noClipboard, projectDir, } = options;
+        const searchDir = projectDir ?? process.cwd();
+        const template = this.templateService.resolve(searchDir);
         const spinner = jsonOutput ? null : ora().start();
         const onStatus = spinner
             ? (message) => { spinner.text = message; }
             : undefined;
-        const improved = await this.rewriter.rewrite(rawPrompt, projectDir, onStatus);
+        const { text: improved, templateUsed } = await this.rewriter.rewrite(rawPrompt, projectDir, onStatus, template);
         spinner?.stop();
         console.log("");
         if (jsonOutput) {
-            console.log(JSON.stringify({ improved }));
+            console.log(JSON.stringify({ improved, templateUsed }));
         }
         else {
             console.log(improved);

package/dist/core/orchestrator.js.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/core/orchestrator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB,MAAM,OAAO,YAAY;IAEb;IACA;IAFV,YACU,WAAwB,EACxB,QAAkB;QADlB,gBAAW,GAAX,WAAW,CAAa;QACxB,aAAQ,GAAR,QAAQ,CAAU;IACzB,CAAC;IAEJ,KAAK,CAAC,aAAa,CAAC,OAAuB;QAGzC,MAAM,EACJ,SAAS,EACT,MAAM,EACN,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,GACX,GAAG,OAAO,CAAC;QAEZ,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,OAAO;YACtB,CAAC,CAAC,CAAC,OAAe,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;YAClD,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QAE9E,OAAO,EAAE,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,EAAE,QAAQ,EAAE,CAAC;QACtB,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC/C,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACtB,SAAS,EAAE,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE;YACtC,SAAS,EAAE,SAAS;YACpB,eAAe,EAAE,QAAQ;YACzB,YAAY,EAAE,QAAQ;YACtB,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;SACxC,CAAC,CAAC;QAEH,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtB,CAAC;CACF"}
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/core/orchestrator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB,MAAM,OAAO,YAAY;IAEb;IACA;IACA;IAHV,YACU,WAAwB,EACxB,QAAkB,EAClB,eAAgC;QAFhC,gBAAW,GAAX,WAAW,CAAa;QACxB,aAAQ,GAAR,QAAQ,CAAU;QAClB,oBAAe,GAAf,eAAe,CAAiB;IACvC,CAAC;IAEJ,KAAK,CAAC,aAAa,CAAC,OAAuB;QAGzC,MAAM,EACJ,SAAS,EACT,MAAM,EACN,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,GACX,GAAG,OAAO,CAAC;QAEZ,MAAM,SAAS,GAAG,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEzD,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,OAAO;YACtB,CAAC,CAAC,CAAC,OAAe,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;YAClD,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEhH,OAAO,EAAE,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,EAAE,QAAQ,EAAE,CAAC;QACtB,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC/C,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACtB,SAAS,EAAE,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE;YACtC,SAAS,EAAE,SAAS;YACpB,eAAe,EAAE,QAAQ;YACzB,YAAY,EAAE,QAAQ;YACtB,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;SACxC,CAAC,CAAC;QAEH,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/core/rewriter.d.ts

@@ -3,5 +3,8 @@ export declare class Rewriter {
     private configRepo;
     constructor(configRepo: ConfigRepo);
     getModelUri(): string;
-    rewrite(rawPrompt: string, projectDir?: string, onStatus?: (message: string) => void): Promise<string>;
+    rewrite(rawPrompt: string, projectDir?: string, onStatus?: (message: string) => void, template?: string): Promise<{
+        text: string;
+        templateUsed: boolean;
+    }>;
 }

package/dist/core/rewriter.js

@@ -1,8 +1,8 @@
 import { generate } from "../llm/inference.js";
 import { buildToolCallingPrompt, parseToolCalls, } from "../llm/prompts/tool-calling.js";
-import { TOOL_DEFINITIONS, executeToolCall, loadIgnoreFilter, } from "../tools/index.js";
+import { executeToolCall, buildProjectTree, } from "../tools/index.js";
 const TOOL_CALLING_PARAMS = {
-    temperature: 0.6,
+    temperature: 0.3,
     topP: 0.8,
     topK: 20,
     minP: 0.0,
@@ -19,7 +19,7 @@ function isEmptyResult(result) {
     return NO_RESULT_PREFIXES.some((prefix) => result.startsWith(prefix));
 }
 function formatToolResult(call, result) {
-    const param = call.arguments.url ?? call.arguments.query;
+    const param = call.arguments.query;
     return `<${call.name} query="${param}">\n${result}\n</${call.name}>`;
 }
 export class Rewriter {
@@ -30,32 +30,42 @@ export class Rewriter {
     getModelUri() {
         return this.configRepo.getModelHfUri();
     }
-    async rewrite(rawPrompt, projectDir, onStatus) {
+    async rewrite(rawPrompt, projectDir, onStatus, template) {
         const hfUri = this.configRepo.getModelHfUri();
         const contextSize = this.configRepo.getModelContextSize();
         const searchDir = projectDir ?? process.cwd();
         onStatus?.("Evaluating");
-        const systemPrompt = buildToolCallingPrompt(TOOL_DEFINITIONS);
+        const tree = buildProjectTree(searchDir);
+        const systemPrompt = buildToolCallingPrompt(tree);
         const raw = await generate(systemPrompt, rawPrompt, hfUri, contextSize, TOOL_CALLING_PARAMS);
         const calls = parseToolCalls(raw);
-        if (calls.length === 0)
-            return rawPrompt;
-        const ig = loadIgnoreFilter(searchDir);
+        if (calls.length === 0) {
+            if (template)
+                return { text: template.replace("<@prompt>", rawPrompt), templateUsed: true };
+            return { text: rawPrompt, templateUsed: false };
+        }
         onStatus?.(`Running ${calls.length} tool calls`);
         const settled = await Promise.all(calls.map(async (call) => {
-            const result = await executeToolCall(call, searchDir, ig);
+            const result = await executeToolCall(call, searchDir);
             if (!result || isEmptyResult(result))
                 return null;
             return formatToolResult(call, result);
         }));
         const results = settled.filter((r) => r !== null);
-        if (results.length === 0)
-            return rawPrompt;
+        if (results.length === 0) {
+            if (template)
+                return { text: template.replace("<@prompt>", rawPrompt), templateUsed: true };
+            return { text: rawPrompt, templateUsed: false };
+        }
         const outputs = [];
         outputs.push(rawPrompt);
         outputs.push("Context from codebase:");
         outputs.push(results.join("\n\n"));
-        return outputs.join("\n\n");
+        const assembled = outputs.join("\n\n");
+        if (template) {
+            return { text: template.replace("<@prompt>", assembled), templateUsed: true };
+        }
+        return { text: assembled, templateUsed: false };
     }
 }
 //# sourceMappingURL=rewriter.js.map

package/dist/core/rewriter.js.map

@@ -1 +1 @@
-{"version":3,"file":"rewriter.js","sourceRoot":"","sources":["../../src/core/rewriter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rewriter.js","sourceRoot":"","sources":["../../src/core/rewriter.ts"],"names":[],"mappings":"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"}

package/dist/core/template-service.d.ts

@@ -0,0 +1,14 @@
+import type { TemplateRepo } from "../storage/template-repo.js";
+export declare class TemplateService {
+    private templateRepo;
+    constructor(templateRepo: TemplateRepo);
+    edit(directory: string): boolean;
+    delete(directory: string): boolean;
+    get(directory: string): string | undefined;
+    list(): {
+        directory: string;
+        content: string;
+    }[];
+    resolve(directory: string): string | undefined;
+    apply(template: string, content: string): string;
+}

package/dist/core/template-service.js

@@ -0,0 +1,57 @@
+import { resolve, dirname, join } from "node:path";
+import { writeFileSync, readFileSync, unlinkSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { execFileSync } from "node:child_process";
+const PLACEHOLDER = "<@prompt>";
+export class TemplateService {
+    templateRepo;
+    constructor(templateRepo) {
+        this.templateRepo = templateRepo;
+    }
+    edit(directory) {
+        const absDir = resolve(directory);
+        const existing = this.templateRepo.get(absDir);
+        const editor = process.env.EDITOR || process.env.VISUAL || "vi";
+        const tmpFile = join(tmpdir(), `promptscout-template-${Date.now()}.txt`);
+        writeFileSync(tmpFile, existing?.content ?? `\n${PLACEHOLDER}\n\n`, "utf-8");
+        try {
+            execFileSync(editor, [tmpFile], { stdio: "inherit" });
+        }
+        catch {
+            unlinkSync(tmpFile);
+            return false;
+        }
+        const content = readFileSync(tmpFile, "utf-8");
+        unlinkSync(tmpFile);
+        if (!content.trim())
+            return false;
+        this.templateRepo.upsert(absDir, content);
+        return true;
+    }
+    delete(directory) {
+        return this.templateRepo.delete(resolve(directory));
+    }
+    get(directory) {
+        return this.templateRepo.get(resolve(directory))?.content;
+    }
+    list() {
+        return this.templateRepo.list();
+    }
+    resolve(directory) {
+        let current = resolve(directory);
+        const root = resolve("/");
+        while (true) {
+            const entry = this.templateRepo.get(current);
+            if (entry)
+                return entry.content;
+            if (current === root)
+                break;
+            current = dirname(current);
+        }
+        return undefined;
+    }
+    apply(template, content) {
+        return template.replace(PLACEHOLDER, content);
+    }
+}
+//# sourceMappingURL=template-service.js.map