@remembrance-ai/opencode-plugin 0.1.49 → 0.1.51

package/opencode.json

@@ -6,7 +6,7 @@
       "command": [
         "npx",
         "-y",
-        "@remembrance-ai/mcp-server@0.1.49"
+        "@remembrance-ai/mcp-server@0.1.51"
       ],
       "enabled": true,
       "environment": {
@@ -15,6 +15,6 @@
     }
   },
   "plugin": [
-    "@remembrance-ai/opencode-plugin@0.1.49"
+    "@remembrance-ai/opencode-plugin@0.1.51"
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remembrance-ai/opencode-plugin",
-  "version": "0.1.49",
+  "version": "0.1.51",
   "license": "Apache-2.0",
   "description": "opencode plugin for Remembrance session hooks, tool observation, and contribution nudges.",
   "type": "module",

package/servers/remembrance-mcp.mjs

@@ -4688,11 +4688,21 @@ function pluginLifecycleCheck(pluginHealth, issues) {
     );
   }
   if (pluginHealth.status === "partial") {
+    const codex = stringValue(pluginHealth.surface) === "codex";
     return warning(
       "plugin_lifecycle",
       "The core native lifecycle is active; tool or completion events have not occurred yet.",
       "exercise_plugin_lifecycle",
-      "Use one Remembrance tool, complete one turn, and rerun the doctor.",
+      codex ? "Use one Remembrance tool, complete one turn, and rerun the doctor. If this warning remains, open /hooks; confirm the Remembrance PostToolUse and Stop hooks are Active, trust any marked Needs review, restart Codex, and retry." : "Use one Remembrance tool, complete one turn, and rerun the doctor.",
+      issues
+    );
+  }
+  if (stringValue(pluginHealth.surface) === "codex") {
+    return warning(
+      "plugin_lifecycle",
+      "The Codex plugin lifecycle is not active.",
+      "review_codex_hook_trust",
+      "In Codex, open /hooks. Confirm the Remembrance SessionStart, UserPromptSubmit, PostToolUse, and Stop hooks are Active; trust any marked Needs review. Codex skips new or changed hook definitions until they are trusted again. If the hooks are absent, update or reinstall Remembrance. Then fully quit and reopen Codex, submit one prompt, and rerun the doctor.",
       issues
     );
   }
@@ -5930,7 +5940,7 @@ var seedSkills = [
     summary: "Operational setup and troubleshooting workflow for Remembrance across Claude Code, Codex, OpenClaw, Cursor, Gemini, MCP, REST, skill-only installs, enterprise keys, and local agent identity.",
     status: "active",
     visibility: "public",
-    version: "0.1.9",
+    version: "0.1.11",
     domains: ["agent-skills", "mcp", "resource-discovery"],
     tags: [
       "remembrance",
@@ -5981,7 +5991,7 @@ var seedSkills = [
         "gemini",
         "rest"
       ],
-      version: "0.1.9",
+      version: "0.1.11",
       status: "active",
       visibility: "public",
       providers: ["codex", "claude", "cursor", "openclaw", "generic"],
@@ -6160,16 +6170,25 @@ claude plugin install remembrance@remembrance
 Codex:
 
 ~~~bash
-codex plugin marketplace add dreamarkinc/remembrance-skills
-codex plugin add remembrance@remembrance
+CODEX_CLI="\${CODEX_CLI:-$(command -v codex || true)}"
+[ -x "$CODEX_CLI" ] || CODEX_CLI="/Applications/ChatGPT.app/Contents/Resources/codex"
+[ -x "$CODEX_CLI" ] || CODEX_CLI="/Applications/Codex.app/Contents/Resources/codex"
+[ -x "$CODEX_CLI" ] || { printf '%s\\n' "Codex CLI not found. Install the Codex CLI, or install or update the ChatGPT desktop app on macOS, then try again." >&2; exit 1; }
+"$CODEX_CLI" plugin marketplace add dreamarkinc/remembrance-skills &&
+  "$CODEX_CLI" plugin marketplace upgrade remembrance &&
+  "$CODEX_CLI" plugin add remembrance@remembrance
 ~~~
 
-If zsh says "codex: command not found" on macOS, try the desktop app CLI path:
+This command handles both first install and update. If zsh says
+"codex: command not found", it discovers the current ChatGPT desktop bundle or
+the legacy Codex app bundle without requiring a shell alias.
 
-~~~bash
-/Applications/Codex.app/Contents/Resources/codex plugin marketplace add dreamarkinc/remembrance-skills
-/Applications/Codex.app/Contents/Resources/codex plugin add remembrance@remembrance
-~~~
+Codex will not execute plugin hooks until their exact definitions are trusted.
+After installing or updating, fully open Codex, enter \`/hooks\`, and confirm the
+Remembrance \`SessionStart\`, \`UserPromptSubmit\`, \`PostToolUse\`, and \`Stop\` hooks
+all show **Active**. Trust any marked **Needs review**. Changed hook definitions
+require review again; never use
+the automation-only trust bypass for normal installation.
 
 OpenClaw:
 
@@ -6227,8 +6246,9 @@ Integrations & MCP**, and verify query, invocation, feedback, and contribution
 receipts in both local and cloud runs.
 
 After installing any native plugin, restart the agent app/session and approve
-the one-time trust prompt if the runtime asks for it. A currently running Codex
-or Claude thread usually cannot hot-load newly installed plugin tools.
+the runtime's trust request. For Codex, use the exact \`/hooks\` check above;
+changed hook definitions require review again. A currently running Codex or
+Claude thread usually cannot hot-load newly installed plugin tools.
 
 ## Enterprise/org key setup
 
@@ -6815,8 +6835,9 @@ be copied to ".agents/skills/remembrancer/SKILL.md" for compatible providers.
 ## Troubleshooting matrix
 
 - "Plugin installed, but no tools": restart the agent app/session; confirm the
-  plugin is enabled; confirm the runtime accepted the trust prompt; confirm the
-  installed package contains the runtime-specific manifest.
+  plugin is enabled and contains the runtime-specific manifest. In Codex, open
+  \`/hooks\`, confirm all four Remembrance hooks show **Active**, and trust any
+  marked **Needs review**; updates that change hooks require review again.
 - "Agent has tools but does not use them": first verify a concrete query receipt,
   then test a short contextual follow-up such as "fix these issues". Native
   prompt hooks should inject a full-conversation query reminder, and completion
@@ -6826,9 +6847,9 @@ be copied to ".agents/skills/remembrancer/SKILL.md" for compatible providers.
   standing instructions proactively. If tools are still not visible, use the
   REST fallback and emit REMEMBRANCE_SUBMISSION_PAYLOAD only when the API is
   unavailable.
-- "codex: command not found": use
-  "/Applications/Codex.app/Contents/Resources/codex" on macOS, or add the
-  Codex CLI to PATH.
+- "codex: command not found": use the complete Codex setup above. It checks
+  the current "/Applications/ChatGPT.app/Contents/Resources/codex" bundle,
+  then the legacy "/Applications/Codex.app/Contents/Resources/codex" path.
 - "401 or 403": the key is missing, expired, revoked, scoped to a different
   environment, or not visible to the agent process. Check config file vs env
   precedence and regenerate a key from the dashboard if needed.
@@ -9729,7 +9750,10 @@ function localPluginLifecycleHealth(options) {
       issues: [
         {
           code: "invalid_lifecycle_marker",
-          action: "Update or reinstall the Remembrance plugin, fully restart the host, and call get_connection_status again."
+          action: nativeLifecycleRepairAction(
+            surface,
+            "get_connection_status"
+          )
         }
       ]
     };
@@ -9755,26 +9779,26 @@ function localPluginLifecycleHealth(options) {
   if (!components.session_start.observed) {
     issues.push({
       code: "session_start_not_observed",
-      action: "Update or reinstall the Remembrance plugin, fully restart the host, and verify its native hooks are enabled."
+      action: nativeLifecycleRepairAction(surface, "get_connection_status")
     });
   }
   if (!components.prompt_hook.observed) {
     issues.push({
       code: "prompt_hook_not_observed",
-      action: "The native prompt hook did not run before this health check. Update or reinstall the plugin, fully restart the host, and verify prompt hooks are enabled."
+      action: surface === "codex" ? nativeLifecycleRepairAction(surface, "get_connection_status") : "The native prompt hook did not run before this health check. Update or reinstall the plugin, fully restart the host, and verify prompt hooks are enabled."
     });
   }
   const coreLifecycleObserved = components.session_start.observed && components.prompt_hook.observed;
   if (coreLifecycleObserved && !components.tool_observer.observed) {
     issues.push({
       code: "tool_observer_not_observed",
-      action: "No native tool observer has run in this session yet. Use a Remembrance MCP tool, then call get_connection_status again."
+      action: surface === "codex" ? "Use a Remembrance MCP tool, then call get_connection_status again. If this remains missing, open /hooks; confirm the Remembrance PostToolUse hook is Active, trust it if marked Needs review, restart Codex, and retry." : "No native tool observer has run in this session yet. Use a Remembrance MCP tool, then call get_connection_status again."
     });
   }
   if (coreLifecycleObserved && !components.completion_hook.observed) {
     issues.push({
       code: "completion_hook_not_observed",
-      action: "No native completion hook has run in this session yet. Complete one turn, then call get_connection_status again."
+      action: surface === "codex" ? "Complete one turn, then call get_connection_status again. If this remains missing, open /hooks; confirm the Remembrance Stop hook is Active, trust it if marked Needs review, restart Codex, and retry." : "No native completion hook has run in this session yet. Complete one turn, then call get_connection_status again."
     });
   }
   const lastSeenMs = validLifecycleTimestamp(marker.last_seen_at, nowMs);
@@ -9852,11 +9876,17 @@ function missingPluginLifecycleHealth(surface) {
     issues: [
       {
         code: "native_hooks_not_observed",
-        action: "Update or reinstall the Remembrance plugin, fully restart the host, and confirm native hooks are enabled. MCP-only access remains available."
+        action: nativeLifecycleRepairAction(surface, "get_connection_status")
       }
     ]
   };
 }
+function nativeLifecycleRepairAction(surface, followupTool) {
+  if (surface === "codex") {
+    return `In Codex, open /hooks. Confirm the Remembrance SessionStart, UserPromptSubmit, PostToolUse, and Stop hooks are Active; trust any marked Needs review. Codex skips new or changed hook definitions until they are trusted again. If the hooks are absent, update or reinstall Remembrance. Then fully quit and reopen Codex, submit one prompt, and call ${followupTool} again.`;
+  }
+  return `Update or reinstall the Remembrance plugin, fully restart the host, and confirm native hooks are enabled. Then call ${followupTool} again. MCP-only access remains available.`;
+}
 function emptyPluginComponents() {
   return Object.fromEntries(
     PLUGIN_HEALTH_COMPONENTS.map((component) => [
@@ -9981,7 +10011,7 @@ var apiConfiguration = resolveApiConfiguration();
 var apiBase = apiConfiguration.baseUrl;
 var MAX_REMOTE_RESPONSE_BYTES = 4 * 1024 * 1024;
 var DOCTOR_PROBE_TIMEOUT_MS = 7500;
-var SERVER_VERSION = true ? "0.1.49" : "0.0.0-dev";
+var SERVER_VERSION = true ? "0.1.51" : "0.0.0-dev";
 var tools = toolDefinitions;
 var doctorCliRequested = process.argv[2] === "doctor";
 var inputBuffer = Buffer.alloc(0);

package/skills/remembrancer/references/remembrance-setup.md

@@ -108,16 +108,25 @@ claude plugin install remembrance@remembrance
 Codex:
 
 ~~~bash
-codex plugin marketplace add dreamarkinc/remembrance-skills
-codex plugin add remembrance@remembrance
+CODEX_CLI="${CODEX_CLI:-$(command -v codex || true)}"
+[ -x "$CODEX_CLI" ] || CODEX_CLI="/Applications/ChatGPT.app/Contents/Resources/codex"
+[ -x "$CODEX_CLI" ] || CODEX_CLI="/Applications/Codex.app/Contents/Resources/codex"
+[ -x "$CODEX_CLI" ] || { printf '%s\n' "Codex CLI not found. Install the Codex CLI, or install or update the ChatGPT desktop app on macOS, then try again." >&2; exit 1; }
+"$CODEX_CLI" plugin marketplace add dreamarkinc/remembrance-skills &&
+  "$CODEX_CLI" plugin marketplace upgrade remembrance &&
+  "$CODEX_CLI" plugin add remembrance@remembrance
 ~~~
 
-If zsh says "codex: command not found" on macOS, try the desktop app CLI path:
+This command handles both first install and update. If zsh says
+"codex: command not found", it discovers the current ChatGPT desktop bundle or
+the legacy Codex app bundle without requiring a shell alias.
 
-~~~bash
-/Applications/Codex.app/Contents/Resources/codex plugin marketplace add dreamarkinc/remembrance-skills
-/Applications/Codex.app/Contents/Resources/codex plugin add remembrance@remembrance
-~~~
+Codex will not execute plugin hooks until their exact definitions are trusted.
+After installing or updating, fully open Codex, enter `/hooks`, and confirm the
+Remembrance `SessionStart`, `UserPromptSubmit`, `PostToolUse`, and `Stop` hooks
+all show **Active**. Trust any marked **Needs review**. Changed hook definitions
+require review again; never use
+the automation-only trust bypass for normal installation.
 
 OpenClaw:
 
@@ -175,8 +184,9 @@ Integrations & MCP**, and verify query, invocation, feedback, and contribution
 receipts in both local and cloud runs.
 
 After installing any native plugin, restart the agent app/session and approve
-the one-time trust prompt if the runtime asks for it. A currently running Codex
-or Claude thread usually cannot hot-load newly installed plugin tools.
+the runtime's trust request. For Codex, use the exact `/hooks` check above;
+changed hook definitions require review again. A currently running Codex or
+Claude thread usually cannot hot-load newly installed plugin tools.
 
 ## Enterprise/org key setup
 
@@ -828,8 +838,9 @@ be copied to ".agents/skills/remembrancer/SKILL.md" for compatible providers.
 ## Troubleshooting matrix
 
 - "Plugin installed, but no tools": restart the agent app/session; confirm the
-  plugin is enabled; confirm the runtime accepted the trust prompt; confirm the
-  installed package contains the runtime-specific manifest.
+  plugin is enabled and contains the runtime-specific manifest. In Codex, open
+  `/hooks`, confirm all four Remembrance hooks show **Active**, and trust any
+  marked **Needs review**; updates that change hooks require review again.
 - "Agent has tools but does not use them": first verify a concrete query receipt,
   then test a short contextual follow-up such as "fix these issues". Native
   prompt hooks should inject a full-conversation query reminder, and completion
@@ -839,9 +850,9 @@ be copied to ".agents/skills/remembrancer/SKILL.md" for compatible providers.
   standing instructions proactively. If tools are still not visible, use the
   REST fallback and emit REMEMBRANCE_SUBMISSION_PAYLOAD only when the API is
   unavailable.
-- "codex: command not found": use
-  "/Applications/Codex.app/Contents/Resources/codex" on macOS, or add the
-  Codex CLI to PATH.
+- "codex: command not found": use the complete Codex setup above. It checks
+  the current "/Applications/ChatGPT.app/Contents/Resources/codex" bundle,
+  then the legacy "/Applications/Codex.app/Contents/Resources/codex" path.
 - "401 or 403": the key is missing, expired, revoked, scoped to a different
   environment, or not visible to the agent process. Check config file vs env
   precedence and regenerate a key from the dashboard if needed.