portable-agent-layer 0.35.0 → 0.37.0

package/src/targets/codex/uninstall.ts

@@ -0,0 +1,70 @@
+/**
+ * PAL — Codex uninstaller
+ * Removes only PAL-owned hooks from ~/.codex/hooks.json. Preserves user hooks.
+ * Removes PAL skill symlinks.
+ */
+
+import { copyFileSync, existsSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { assets, palPkg, platform } from "../../hooks/lib/paths";
+import {
+  loadCodexHooksTemplate,
+  log,
+  readJson,
+  removeSkills,
+  unmergeCodexHooks,
+  writeJson,
+} from "../lib";
+
+/**
+ * Remove `hooks = true` from config.toml.
+ * Also removes a now-empty [features] section header.
+ */
+function disableCodexHooks(configPath: string): void {
+  if (!existsSync(configPath)) return;
+  let content = readFileSync(configPath, "utf-8");
+  if (!/^\s*hooks\s*=\s*true/m.test(content)) return;
+
+  // Remove the hooks line
+  content = content.replace(/^[ \t]*hooks\s*=\s*true[ \t]*\n?/m, "");
+
+  // Remove [features] header if it's now empty (nothing between it and next section / EOF)
+  content = content.replace(/\[features\]\n(?=\[|$)/m, "");
+
+  writeFileSync(configPath, content, "utf-8");
+  log.success("Removed hooks from ~/.codex/config.toml");
+}
+
+const PKG_ROOT = palPkg().replaceAll("\\", "/");
+const CODEX_DIR = platform.codexDir();
+const HOOKS_FILE = resolve(CODEX_DIR, "hooks.json");
+
+// --- Remove PAL hooks from hooks.json ---
+if (existsSync(HOOKS_FILE)) {
+  copyFileSync(HOOKS_FILE, `${HOOKS_FILE}.bak.${Date.now()}`);
+  log.info("Backed up hooks.json");
+
+  const template = loadCodexHooksTemplate(assets.codexHooksTemplate(), PKG_ROOT);
+  const existing = readJson<Record<string, unknown>>(HOOKS_FILE, {});
+  const cleaned = unmergeCodexHooks(existing, template);
+
+  writeJson(HOOKS_FILE, cleaned);
+  log.success("Removed PAL hooks from ~/.codex/hooks.json");
+} else {
+  log.info("No hooks.json found, nothing to do");
+}
+
+// --- Remove PAL skill symlinks ---
+const codexSkillsDir = resolve(CODEX_DIR, "skills");
+const removed = removeSkills(codexSkillsDir);
+if (removed.length > 0) {
+  log.success(`Removed ${removed.length} skill(s): ${removed.join(", ")}`);
+} else {
+  log.info("No PAL skills found");
+}
+
+// --- Disable hooks in config.toml ---
+const CONFIG_FILE = resolve(CODEX_DIR, "config.toml");
+disableCodexHooks(CONFIG_FILE);
+
+log.success("Codex uninstall complete");

package/src/targets/copilot/install.ts

@@ -1,11 +1,13 @@
 /**
  * PAL — Copilot target installer
  * Writes hooks to ~/.copilot/hooks/pal-hooks.json.
- * Copies skills and agents. Symlinks copilot-instructions.md to AGENTS.md.
+ * Copies skills and agents. Writes ~/.copilot/instructions/pal-*.instructions.md.
+ * Enables ~/.copilot/instructions in VS Code chat.instructionsFilesLocations.
  */
 
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { mkdirSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
+import { writeContextDigests } from "../../hooks/handlers/context-digests";
 import { regenerateIfNeeded } from "../../hooks/lib/claude-md";
 import { assets, palPkg, platform } from "../../hooks/lib/paths";
 import {
@@ -16,7 +18,10 @@ import {
   generateSkillIndex,
   loadCopilotHooksTemplate,
   log,
+  readJson,
   scaffoldPalSettings,
+  vscodeSettingsFile,
+  writeJson,
 } from "../lib";
 
 const PKG_ROOT = palPkg().replaceAll("\\", "/");
@@ -50,16 +55,42 @@ log.success(`Installed ${palDocsCount} PAL docs to ~/.pal/docs/`);
 // --- Scaffold PAL settings ---
 scaffoldPalSettings();
 
-// --- Generate AGENTS.md + copilot-instructions.md symlink ---
-// ensureSymlinks() inside regenerateIfNeeded() handles the symlink once ~/.copilot/ exists
+// --- Generate AGENTS.md ---
 regenerateIfNeeded();
-const instructionsPath = resolve(COPILOT_DIR, "copilot-instructions.md");
+log.success("Generated AGENTS.md");
+
+// --- Write ~/.copilot/instructions/pal-*.instructions.md ---
+mkdirSync(resolve(COPILOT_DIR, "instructions"), { recursive: true });
+writeContextDigests();
 log.success(
-  existsSync(instructionsPath)
-    ? "copilot-instructions.md symlink present"
-    : "Generated AGENTS.md (copilot-instructions.md symlink will be created on next session)"
+  "Written ~/.copilot/instructions/pal-self-model + pal-wisdom + pal-opinions.instructions.md"
 );
 
+// --- Enable ~/.copilot/instructions in VS Code settings ---
+const vsSettingsPath = vscodeSettingsFile();
+const manualHint =
+  'Add manually: { "chat.instructionsFilesLocations": { "~/.copilot/instructions": true } }';
+if (vsSettingsPath) {
+  try {
+    const settings = readJson<Record<string, unknown>>(vsSettingsPath, {});
+    const existing =
+      typeof settings["chat.instructionsFilesLocations"] === "object" &&
+      settings["chat.instructionsFilesLocations"] !== null
+        ? (settings["chat.instructionsFilesLocations"] as Record<string, unknown>)
+        : {};
+    settings["chat.instructionsFilesLocations"] = {
+      ...existing,
+      "~/.copilot/instructions": true,
+    };
+    writeJson(vsSettingsPath, settings);
+    log.success("Enabled ~/.copilot/instructions in VS Code settings");
+  } catch {
+    log.warn(`Could not update VS Code settings — ${manualHint}`);
+  }
+} else {
+  log.warn(`Could not detect VS Code settings path — ${manualHint}`);
+}
+
 log.success("Copilot installation complete");
 console.log("");
 log.info(`Skills: ${countSkills()}`);

package/src/targets/copilot/uninstall.ts

@@ -1,12 +1,22 @@
 /**
  * PAL — Copilot uninstaller
- * Removes pal-hooks.json, skill symlinks, agents, and copilot-instructions.md symlink.
+ * Removes pal-hooks.json, skill symlinks, agents, instruction files,
+ * and the VS Code chat.instructionsFilesLocations entry.
  */
 
 import { copyFileSync, existsSync, lstatSync, readlinkSync, unlinkSync } from "node:fs";
 import { resolve } from "node:path";
 import { platform } from "../../hooks/lib/paths";
-import { log, removeAgentsFromCopilot, removePalDocs, removeSkills } from "../lib";
+import { copilotFilename, getSemiStaticSources } from "../../hooks/lib/semi-static";
+import {
+  log,
+  readJson,
+  removeAgentsFromCopilot,
+  removePalDocs,
+  removeSkills,
+  vscodeSettingsFile,
+  writeJson,
+} from "../lib";
 
 const COPILOT_DIR = platform.copilotDir();
 const HOOKS_FILE = resolve(COPILOT_DIR, "hooks", "pal-hooks.json");
@@ -35,26 +45,57 @@ if (removedAgents.length > 0) {
   log.success(`Removed ${removedAgents.length} agent(s): ${removedAgents.join(", ")}`);
 }
 
-// --- Remove copilot-instructions.md symlink (only if it points to AGENTS.md) ---
-const instructionsPath = resolve(COPILOT_DIR, "copilot-instructions.md");
-if (existsSync(instructionsPath)) {
+// --- Remove PAL docs ---
+removePalDocs();
+
+// --- Remove ~/.copilot/instructions/pal-*.instructions.md ---
+for (const src of getSemiStaticSources()) {
+  try {
+    unlinkSync(resolve(COPILOT_DIR, "instructions", copilotFilename(src)));
+  } catch {
+    /* gone */
+  }
+}
+// pal-session.instructions.md is written by LoadContext (not a semi-static source)
+try {
+  unlinkSync(resolve(COPILOT_DIR, "instructions", "pal-session.instructions.md"));
+} catch {
+  /* gone */
+}
+log.success("Removed ~/.copilot/instructions/pal-*.instructions.md");
+
+// --- Backward compat: remove old copilot-instructions.md symlink if present ---
+const legacyPath = resolve(COPILOT_DIR, "copilot-instructions.md");
+if (existsSync(legacyPath)) {
   try {
-    const stat = lstatSync(instructionsPath);
-    if (stat.isSymbolicLink()) {
-      const target = readlinkSync(instructionsPath);
-      if (target.includes("AGENTS.md")) {
-        unlinkSync(instructionsPath);
-        log.success("Removed copilot-instructions.md symlink");
-      } else {
-        log.info("copilot-instructions.md is not a PAL symlink — leaving it");
-      }
+    if (
+      lstatSync(legacyPath).isSymbolicLink() &&
+      readlinkSync(legacyPath).includes("AGENTS.md")
+    ) {
+      unlinkSync(legacyPath);
+      log.success("Removed legacy copilot-instructions.md symlink");
     }
   } catch {
-    // ignore
+    /* ignore */
   }
 }
 
-// --- Remove PAL docs ---
-removePalDocs();
+// --- Remove ~/.copilot/instructions entry from VS Code settings ---
+const vsSettingsPath = vscodeSettingsFile();
+if (vsSettingsPath && existsSync(vsSettingsPath)) {
+  const settings = readJson<Record<string, unknown>>(vsSettingsPath, {});
+  const locs = settings["chat.instructionsFilesLocations"];
+  if (typeof locs === "object" && locs !== null) {
+    const obj = locs as Record<string, unknown>;
+    delete obj["~/.copilot/instructions"];
+    if (Object.keys(obj).length === 0) {
+      delete settings["chat.instructionsFilesLocations"];
+    } else {
+      settings["chat.instructionsFilesLocations"] = obj;
+    }
+    writeJson(vsSettingsPath, settings);
+    log.success("Removed ~/.copilot/instructions from VS Code settings");
+  }
+}
 
 log.success("Copilot uninstall complete");

package/src/targets/cursor/install.ts

@@ -6,6 +6,7 @@
 
 import { copyFileSync, existsSync, mkdirSync } from "node:fs";
 import { resolve } from "node:path";
+import { writeContextDigests } from "../../hooks/handlers/context-digests";
 import { regenerateIfNeeded } from "../../hooks/lib/claude-md";
 import { assets, palPkg, platform } from "../../hooks/lib/paths";
 import {
@@ -64,6 +65,13 @@ scaffoldPalSettings();
 regenerateIfNeeded();
 log.success("Generated AGENTS.md");
 
+// --- Write ~/.cursor/rules/pal-*.mdc ---
+mkdirSync(resolve(CURSOR_DIR, "rules"), { recursive: true });
+writeContextDigests();
+log.success(
+  "Written ~/.cursor/rules/pal-self-model.mdc + pal-wisdom.mdc + pal-opinions.mdc"
+);
+
 log.success("Cursor installation complete");
 console.log("");
 log.info(`Skills: ${countSkills()}`);

package/src/targets/cursor/uninstall.ts

@@ -4,9 +4,10 @@
  * Removes PAL skill symlinks.
  */
 
-import { copyFileSync, existsSync } from "node:fs";
+import { copyFileSync, existsSync, unlinkSync } from "node:fs";
 import { resolve } from "node:path";
 import { assets, palPkg, platform } from "../../hooks/lib/paths";
+import { cursorFilename, getSemiStaticSources } from "../../hooks/lib/semi-static";
 import {
   loadCursorHooksTemplate,
   log,
@@ -56,4 +57,20 @@ if (removedAgents.length > 0) {
 // --- Remove PAL system docs ---
 removePalDocs();
 
+// --- Remove ~/.cursor/rules/pal-*.mdc ---
+for (const src of getSemiStaticSources()) {
+  try {
+    unlinkSync(resolve(CURSOR_DIR, "rules", cursorFilename(src)));
+  } catch {
+    /* gone */
+  }
+}
+// Backward compat: remove legacy merged file if present
+try {
+  unlinkSync(resolve(CURSOR_DIR, "rules", "pal-context.mdc"));
+} catch {
+  /* gone */
+}
+log.success("Removed ~/.cursor/rules/pal-*.mdc");
+
 log.success("Cursor uninstall complete");

package/src/targets/lib.ts

@@ -14,6 +14,7 @@ import {
   unlinkSync,
   writeFileSync,
 } from "node:fs";
+import { homedir } from "node:os";
 import { resolve } from "node:path";
 import { assets, palHome, platform } from "../hooks/lib/paths";
 
@@ -41,6 +42,31 @@ export function writeJson(path: string, data: unknown): void {
   writeFileSync(path, `${JSON.stringify(data, null, 2)}\n`, "utf-8");
 }
 
+/** Resolve the VS Code user settings.json path cross-platform. Returns null on unknown platforms. */
+export function vscodeSettingsFile(): string | null {
+  const h = homedir();
+  if (process.platform === "darwin") {
+    return resolve(h, "Library", "Application Support", "Code", "User", "settings.json");
+  }
+  if (process.platform === "linux") {
+    return resolve(
+      process.env.XDG_CONFIG_HOME ?? resolve(h, ".config"),
+      "Code",
+      "User",
+      "settings.json"
+    );
+  }
+  if (process.platform === "win32") {
+    return resolve(
+      process.env.APPDATA ?? resolve(h, "AppData", "Roaming"),
+      "Code",
+      "User",
+      "settings.json"
+    );
+  }
+  return null;
+}
+
 // --- Settings template merge/unmerge ---
 
 type HookEntry = { matcher?: string; hooks?: Array<{ type: string; command: string }> };
@@ -55,7 +81,11 @@ type Settings = Record<string, unknown> & {
 export function loadSettingsTemplate(templatePath: string, pkgRoot: string): Settings {
   const raw = readFileSync(templatePath, "utf-8");
   const resolved = raw.replaceAll("{{PKG_ROOT}}", pkgRoot);
-  return JSON.parse(resolved) as Settings;
+  try {
+    return JSON.parse(resolved) as Settings;
+  } catch (e) {
+    throw new Error(`Failed to parse settings template at ${templatePath}: ${e}`);
+  }
 }
 
 /**
@@ -69,7 +99,7 @@ export function mergeSettings(existing: Settings, template: Settings): Settings
 
   // Merge hooks (deduplicate by command)
   if (template.hooks) {
-    if (!result.hooks) result.hooks = {};
+    result.hooks ??= {};
     for (const [event, entries] of Object.entries(template.hooks)) {
       const current = result.hooks[event] ?? [];
       for (const entry of entries) {
@@ -84,8 +114,8 @@ export function mergeSettings(existing: Settings, template: Settings): Settings
 
   // Merge permissions.allow (deduplicate)
   if (template.permissions?.allow) {
-    if (!result.permissions) result.permissions = {};
-    if (!result.permissions.allow) result.permissions.allow = [];
+    result.permissions ??= {};
+    result.permissions.allow ??= [];
     for (const perm of template.permissions.allow) {
       if (!result.permissions.allow.includes(perm)) {
         result.permissions.allow.push(perm);
@@ -158,7 +188,11 @@ export function loadCursorHooksTemplate(
 ): CursorHooks {
   const raw = readFileSync(templatePath, "utf-8");
   const resolved = raw.replaceAll("{{PKG_ROOT}}", pkgRoot);
-  return JSON.parse(resolved) as CursorHooks;
+  try {
+    return JSON.parse(resolved) as CursorHooks;
+  } catch (e) {
+    throw new Error(`Failed to parse Cursor hooks template at ${templatePath}: ${e}`);
+  }
 }
 
 /**
@@ -172,7 +206,7 @@ export function mergeCursorHooks(
   const result: CursorHooks = { ...existing, version: existing.version ?? 1 };
 
   if (template.hooks) {
-    if (!result.hooks) result.hooks = {};
+    result.hooks ??= {};
     for (const [event, entries] of Object.entries(template.hooks)) {
       const current = result.hooks[event] ?? [];
       for (const entry of entries) {
@@ -215,6 +249,103 @@ export function unmergeCursorHooks(
   return result;
 }
 
+// --- Codex hooks (nested group format, distinct from Cursor's flat format) ---
+
+type CodexHookCommand = { type: string; command: string; timeout?: number };
+type CodexHookGroup = { matcher?: string; hooks: CodexHookCommand[] };
+type CodexHooks = { hooks?: Record<string, CodexHookGroup[]> };
+
+/** Strip leading env-var assignments so "PAL_AGENT=x bun run ..." → "bun run ..." */
+function canonicalCmd(cmd: string): string {
+  return cmd.replace(/^(?:\w+=\S+\s+)+/, "");
+}
+
+export function loadCodexHooksTemplate(
+  templatePath: string,
+  pkgRoot: string
+): CodexHooks {
+  const raw = readFileSync(templatePath, "utf-8");
+  const resolved = raw.replaceAll("{{PKG_ROOT}}", pkgRoot);
+  try {
+    return JSON.parse(resolved) as CodexHooks;
+  } catch (e) {
+    throw new Error(`Failed to parse Codex hooks template at ${templatePath}: ${e}`);
+  }
+}
+
+/** Merge PAL hooks into an existing Codex hooks.json. Deduplicates by canonical command path. */
+export function mergeCodexHooks(existing: CodexHooks, template: CodexHooks): CodexHooks {
+  const result: CodexHooks = { ...existing };
+  if (!template.hooks) return result;
+  result.hooks ??= {};
+
+  // Collect canonical paths of PAL template commands so we can evict stale variants
+  const palCanonical = new Set(
+    Object.values(template.hooks).flatMap((groups) =>
+      groups.flatMap((g) => g.hooks.map((h) => canonicalCmd(h.command)))
+    )
+  );
+
+  // Strip any existing entries (nested or flat) whose canonical path matches a PAL command
+  for (const event of Object.keys(result.hooks)) {
+    result.hooks[event] = (result.hooks[event] ?? [])
+      .map((g) => {
+        const flat = g as unknown as CodexHookCommand;
+        if (!g.hooks && flat.command && palCanonical.has(canonicalCmd(flat.command))) {
+          return null;
+        }
+        const filtered = (g.hooks ?? []).filter(
+          (h) => !palCanonical.has(canonicalCmd(h.command))
+        );
+        return filtered.length > 0 ? { ...g, hooks: filtered } : null;
+      })
+      .filter((g): g is CodexHookGroup => g !== null);
+    if (result.hooks[event].length === 0) delete result.hooks[event];
+  }
+
+  // Add fresh template entries
+  for (const [event, groups] of Object.entries(template.hooks)) {
+    const current = result.hooks[event] ?? [];
+    for (const group of groups) current.push(group);
+    result.hooks[event] = current;
+  }
+  return result;
+}
+
+/** Remove PAL hooks from an existing Codex hooks.json. Preserves user hooks. */
+export function unmergeCodexHooks(
+  existing: CodexHooks,
+  template: CodexHooks
+): CodexHooks {
+  const result: CodexHooks = { ...existing };
+  if (!template.hooks || !result.hooks) return result;
+
+  // Match by canonical path so prefix variants (PAL_AGENT=codex, etc.) are all removed
+  const palCanonical = new Set(
+    Object.values(template.hooks).flatMap((groups) =>
+      groups.flatMap((g) => g.hooks.map((h) => canonicalCmd(h.command)))
+    )
+  );
+
+  for (const event of Object.keys(result.hooks)) {
+    result.hooks[event] = (result.hooks[event] ?? [])
+      .map((g) => {
+        const flat = g as unknown as CodexHookCommand;
+        if (!g.hooks && flat.command && palCanonical.has(canonicalCmd(flat.command))) {
+          return null;
+        }
+        const filtered = (g.hooks ?? []).filter(
+          (h) => !palCanonical.has(canonicalCmd(h.command))
+        );
+        return filtered.length > 0 ? { ...g, hooks: filtered } : null;
+      })
+      .filter((g): g is CodexHookGroup => g !== null);
+    if (result.hooks[event].length === 0) delete result.hooks[event];
+  }
+  if (Object.keys(result.hooks).length === 0) delete result.hooks;
+  return result;
+}
+
 // --- TELOS scaffolding ---
 
 /** Copy template files into telos/ without overwriting existing ones */
@@ -249,6 +380,21 @@ export function scaffoldPalSettings(): void {
     copyFileSync(src, dst);
     log.info("Created pal-settings.json from template");
   }
+
+  // Strip deprecated loadAtStartup.files entries from existing installs.
+  // mergeSettings only adds, never removes — deprecated entries persist indefinitely otherwise.
+  try {
+    const raw = JSON.parse(readFileSync(dst, "utf-8"));
+    const files: string[] = raw?.loadAtStartup?.files ?? [];
+    const cleaned = files.filter((f: string) => !f.endsWith("PROJECTS.md"));
+    if (cleaned.length !== files.length) {
+      raw.loadAtStartup.files = cleaned;
+      writeFileSync(dst, `${JSON.stringify(raw, null, 2)}\n`, "utf-8");
+      log.info("Removed deprecated PROJECTS.md from loadAtStartup.files");
+    }
+  } catch {
+    /* non-fatal — malformed settings left as-is */
+  }
 }
 
 // --- PAL docs (modular context routing files) ---
@@ -466,14 +612,14 @@ function extractAgentForPlatform(content: string, platform: AgentPlatform): stri
   for (const line of frontmatter.split("\n")) {
     if (!line.trim()) continue;
 
-    const platformMatch = line.match(/^(claude|opencode|cursor):\s*$/);
+    const platformMatch = new RegExp(/^(claude|opencode|cursor):\s*$/).exec(line);
     if (platformMatch) {
       currentPlatform = platformMatch[1] as AgentPlatform;
       continue;
     }
 
     if (currentPlatform) {
-      if (line.match(/^ {2}/)) {
+      if (new RegExp(/^ {2}/).exec(line)) {
         platformLines[currentPlatform].push(line.slice(2)); // un-indent one level
         continue;
       }
@@ -554,9 +700,15 @@ export function removeAgentsFromCopilot(copilotAgentsDir: string): string[] {
 
 /** Load and resolve the Copilot hooks template, substituting PKG_ROOT */
 export function loadCopilotHooksTemplate(templatePath: string, pkgRoot: string): unknown {
-  return JSON.parse(
-    readFileSync(templatePath, "utf-8").replaceAll("{{PKG_ROOT}}", pkgRoot)
+  const resolved = readFileSync(templatePath, "utf-8").replaceAll(
+    "{{PKG_ROOT}}",
+    pkgRoot
   );
+  try {
+    return JSON.parse(resolved);
+  } catch (e) {
+    throw new Error(`Failed to parse Copilot hooks template at ${templatePath}: ${e}`);
+  }
 }
 
 // --- Skill Index ---
@@ -578,7 +730,7 @@ function extractTriggers(description: string): string[] {
   // Extract "Use when ..." phrases and key terms
   const triggers = new Set<string>();
 
-  const useWhen = description.match(/Use when\s+(.+?)(?:\.|$)/i);
+  const useWhen = new RegExp(/Use when\s+(.+?)(?:\.|$)/i).exec(description);
   if (useWhen) {
     const words = useWhen[1]
       .toLowerCase()
@@ -621,12 +773,12 @@ export function generateSkillIndex(): number {
 
     try {
       const content = readFileSync(skillMd, "utf-8");
-      const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+      const fmMatch = new RegExp(/^---\n([\s\S]*?)\n---/).exec(content);
       if (!fmMatch) continue;
 
       const fm = fmMatch[1];
-      const nameMatch = fm.match(/^name:\s*(.+)$/m);
-      const descMatch = fm.match(/^description:\s*"?(.+?)"?\s*$/m);
+      const nameMatch = new RegExp(/^name:\s*(.+)$/m).exec(fm);
+      const descMatch = new RegExp(/^description:\s*"?(.+?)"?\s*$/m).exec(fm);
       if (!nameMatch) continue;
 
       const skillName = nameMatch[1].trim();

package/src/targets/opencode/install.ts

@@ -3,10 +3,18 @@
  * Deploys plugin, installs skills, generates AGENTS.md.
  */
 
-import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  statSync,
+  unlinkSync,
+  writeFileSync,
+} from "node:fs";
 import { resolve } from "node:path";
 import { regenerateIfNeeded } from "../../hooks/lib/claude-md";
 import { palPkg, platform } from "../../hooks/lib/paths";
+import { getSemiStaticSources } from "../../hooks/lib/semi-static";
 import {
   copyAgentsForOpencode,
   copyPalDocs,
@@ -70,6 +78,26 @@ log.success(`Installed ${palDocsCount} PAL docs to ~/.pal/docs/`);
 regenerateIfNeeded();
 log.success("Generated ~/.config/opencode/AGENTS.md");
 
+// --- 7. Add semi-static digest files to instructions[] in config.json ---
+const configPath = resolve(OC_GLOBAL_DIR, "config.json");
+const staticFiles = getSemiStaticSources().map((s) => s.path);
+let ocConfig: Record<string, unknown> = {};
+if (existsSync(configPath) && statSync(configPath).size > 0) {
+  try {
+    ocConfig = JSON.parse(readFileSync(configPath, "utf-8"));
+  } catch {
+    /* start fresh */
+  }
+}
+const existingInstructions = Array.isArray(ocConfig.instructions)
+  ? (ocConfig.instructions as string[])
+  : [];
+ocConfig.instructions = [...new Set([...existingInstructions, ...staticFiles])];
+writeFileSync(configPath, `${JSON.stringify(ocConfig, null, 2)}\n`, "utf-8");
+log.success(
+  `Updated config.json: ${(ocConfig.instructions as string[]).length} instructions`
+);
+
 log.success("opencode installation complete");
 console.log("");
 log.info(`Plugin: ${pluginDst}`);

package/src/targets/opencode/plugin.ts

@@ -34,6 +34,9 @@ const PALPlugin: Plugin = async ({ directory, client }: PluginInput) => {
   const { captureRating } = await lib<typeof import("../../hooks/handlers/rating")>(
     "../handlers/rating.ts"
   );
+  const { getRetrievalReminder } = await lib<
+    typeof import("../../hooks/handlers/inject-retrieval")
+  >("../handlers/inject-retrieval.ts");
 
   function partsToText(parts: Array<Record<string, unknown>>): string {
     return parts
@@ -74,7 +77,7 @@ const PALPlugin: Plugin = async ({ directory, client }: PluginInput) => {
   return {
     // --- Per-message: Inject dynamic system reminder ---
     "experimental.chat.system.transform": async (_input, output) => {
-      const reminder = buildSystemReminder();
+      const reminder = buildSystemReminder({ agent: "opencode" });
       if (reminder) output.system.push(reminder);
     },
 
@@ -120,17 +123,25 @@ const PALPlugin: Plugin = async ({ directory, client }: PluginInput) => {
 
     // --- Capture ratings + session naming from user messages (shared handlers) ---
     "chat.message": async (input, output) => {
-      const text =
-        output.parts
-          ?.filter((p) => p.type === "text")
-          .map((p) => p.text || "")
-          .join(" ") ?? "";
-
-      if (text.trim()) {
-        await Promise.allSettled([
-          captureRating(text, input.sessionID),
-          captureSessionName(text, input.sessionID),
-        ]);
+      const text = partsToText(output.parts ?? []);
+      if (!text.trim()) return;
+
+      const [, , retrievalResult] = await Promise.allSettled([
+        captureRating(text, input.sessionID),
+        captureSessionName(text, input.sessionID),
+        getRetrievalReminder(text),
+      ]);
+
+      if (retrievalResult.status === "fulfilled" && retrievalResult.value) {
+        const injected = {
+          id: `pal-retrieval-${Date.now()}`,
+          sessionID: input.sessionID,
+          messageID: input.messageID ?? `pal-msg-${Date.now()}`,
+          type: "text" as const,
+          text: retrievalResult.value,
+          synthetic: true,
+        };
+        output.parts = [injected, ...(output.parts ?? [])];
       }
     },