feat(path-instructions): enable hot-reload for instructions

Instead of loading at startup, instruction files now load on each relevant tool execution.

This enables hot-reloading, making changes to instruction files effective immediately.

Injection is now also triggered by 'read' operations, providing context earlier.

Author: klocus

README.md

@@ -59,17 +59,12 @@ The plugin will handle the rest, notifying you via the tool output whenever path
 
 ### Injection
 
-When the AI performs an `edit` or `write` operation on a file, the plugin:
+When the AI performs an `edit`, `read` or `write` operation on a file, the plugin:
 
 1. Finds all `*.instructions.md` files whose `applyTo` patterns match the target file path.
 2. Injects them **once per session** — subsequent operations on matching files won't repeat the injection.
 3. Appends the instructions to the tool output with a visible metadata header, so the AI can see which instructions were applied and follow them.
 
-### Loading
-
-- The plugin scans `.github/instructions/` and `.opencode/instructions/` recursively at startup.
-- Changes to instruction files are picked up on restart.
-
 ### Frontmatter notes
 
 - `applyTo` accepts a comma-separated list of glob patterns. Values may be quoted with single or double quotes or left unquoted.

src/path-instructions.ts

@@ -14,9 +14,9 @@
  *   Your instructions here...
  */
 
+import type { Plugin } from '@opencode-ai/plugin'
 import * as fs from 'node:fs'
 import * as path from 'node:path'
-import type { Plugin } from '@opencode-ai/plugin'
 
 interface InstructionFile {
   /** Glob patterns that determine when this instruction applies */
@@ -30,7 +30,7 @@ interface InstructionFile {
 }
 
 /** File tools that operate on file paths */
-const FILE_TOOLS = new Set(['edit', 'write'])
+const FILE_TOOLS = new Set(['edit', 'read', 'write'])
 
 /** Marker format used to track injected instructions in message history */
 const MARKER_PREFIX = 'path-instruction'
@@ -221,7 +221,6 @@ export const PathInstructionsPlugin: Plugin = async (ctx) => {
   }
 
   const projectDir = directory
-  const instructions = loadAllInstructionFiles(projectDir)
 
   // -------------------------------------------------------------------------
   // Instance-level state (scoped to this plugin invocation)
@@ -243,18 +242,6 @@ export const PathInstructionsPlugin: Plugin = async (ctx) => {
   const toast = (message: string, variant: 'info' | 'success' | 'warning' | 'error' = 'info', duration = 5000) =>
     client.tui.showToast({ body: { title: '📋 Path Instructions', message, variant, duration } })
 
-  if (instructions.length === 0) {
-    log('No path-specific instruction files found in .github/instructions or .opencode/instructions')
-    toast('No instruction files found', 'warning', 3000)
-  } else {
-    const names = instructions.map(i => i.name).join(', ')
-    log(`Loaded ${instructions.length} path instruction file(s):`)
-    for (const instr of instructions) {
-      log(`  ${getRelativePath(projectDir, instr.filePath)} → applyTo: ${instr.applyTo.join(', ')}`)
-    }
-    toast(`Loaded ${instructions.length} instruction(s): ${names}`, 'success', 4000)
-  }
-
   return {
     'tool.execute.before': async (input, output) => {
       if (!FILE_TOOLS.has(input.tool)) return
@@ -269,8 +256,9 @@ export const PathInstructionsPlugin: Plugin = async (ctx) => {
         sessionInjected.set(sessionId, new Set())
       }
       const injected = sessionInjected.get(sessionId)!
+      const currentInstructions = loadAllInstructionFiles(projectDir)
 
-      const matching = instructions.filter(
+      const matching = currentInstructions.filter(
         instr =>
           !injected.has(instr.filePath) &&
           instr.applyTo.some(pattern => matchesGlob(pattern, relativePath)),
@@ -320,7 +308,8 @@ export const PathInstructionsPlugin: Plugin = async (ctx) => {
       const injected = sessionInjected.get(sessionId)
       if (!injected || injected.size === 0) return
 
-      const activeInstructions = instructions.filter(instr => injected.has(instr.filePath))
+      const currentInstructions = loadAllInstructionFiles(projectDir)
+      const activeInstructions = currentInstructions.filter(instr => injected.has(instr.filePath))
       if (activeInstructions.length === 0) return
 
       const blocks = activeInstructions