@tph/team-prompt-history 2.0.2 → 2.0.4

package/opencode/tph-prompt-history.js

@@ -0,0 +1,77 @@
+/**
+ * OpenCode plugin — Team Prompt History Manager
+ *
+ * Verified mechanism: plugin hook `chat.message` (Hooks in @opencode-ai/plugin).
+ * Reads user text from `output.parts` (type === "text") and captures via the
+ * local prompt-history CLI with --platform opencode.
+ *
+ * Gap: some OpenCode builds have delivered empty `parts` to this hook
+ * (see anomalyco/opencode#22831). When parts are empty we skip capture rather
+ * than invent content — use `prompt-history capture --platform opencode` as a
+ * manual/CLI fallback.
+ *
+ * Install: prompt-history install-hooks --platform opencode
+ * (copies into ~/.config/opencode/plugins/)
+ */
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+
+/** @type {string | null} */
+const PACKAGE_ROOT = __TPH_PACKAGE_ROOT__;
+
+function resolveCli() {
+  if (PACKAGE_ROOT) {
+    const cli = path.join(PACKAGE_ROOT, "dist", "cli.js");
+    if (fs.existsSync(cli)) return { cmd: process.execPath || "node", args: [cli] };
+  }
+  return { cmd: "prompt-history", args: [] };
+}
+
+function extractText(parts) {
+  if (!Array.isArray(parts)) return "";
+  return parts
+    .filter((p) => p && p.type === "text" && typeof p.text === "string")
+    .map((p) => p.text)
+    .join("\n")
+    .trim();
+}
+
+function captureAsync(prompt, messageId) {
+  const { cmd, args } = resolveCli();
+  const fullArgs = [...args, "capture", "--platform", "opencode", "--json"];
+  const child = spawn(cmd, fullArgs, {
+    stdio: ["pipe", "ignore", "ignore"],
+    detached: true,
+    env: { ...process.env, TPH_PROMPT_PLATFORM: "opencode" },
+  });
+  const payload = JSON.stringify({
+    prompt,
+    prompt_id: messageId || undefined,
+    hook_event_name: "chat.message",
+  });
+  child.stdin.write(payload);
+  child.stdin.end();
+  child.unref();
+}
+
+export const PromptHistoryPlugin = async () => {
+  return {
+    "chat.message": async (input, output) => {
+      try {
+        const prompt = extractText(output && output.parts);
+        if (!prompt) return;
+        const messageID =
+          (input && input.messageID) ||
+          (output && output.message && output.message.id) ||
+          undefined;
+        captureAsync(prompt, messageID);
+      } catch {
+        /* never block OpenCode */
+      }
+    },
+  };
+};
+
+export default PromptHistoryPlugin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tph/team-prompt-history",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "Cursor plugin — local capture, push-on-capture, and team collection client",
   "license": "MIT",
   "type": "commonjs",
@@ -14,8 +14,10 @@
     "hooks",
     "commands",
     "skills",
-    "scripts/capture-prompt.js",
+    "scripts",
+    "opencode",
     "examples",
+    "docs",
     "README.md"
   ],
   "engines": {
@@ -28,7 +30,7 @@
     "team"
   ],
   "dependencies": {
-    "@tph/shared": "2.0.2"
+    "@tph/shared": "2.0.4"
   },
   "bundledDependencies": [
     "@tph/shared"
@@ -36,7 +38,8 @@
   "scripts": {
     "start": "node dist/cli.js",
     "cli": "node dist/cli.js",
-    "install-plugin": "node dist/cli.js install-plugin"
+    "install-plugin": "node dist/cli.js install-plugin",
+    "install-hooks": "node dist/cli.js install-hooks"
   },
   "publishConfig": {
     "access": "public",

package/scripts/capture-claude.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Claude Code UserPromptSubmit shim.
+ * Verified API: https://code.claude.com/docs/en/hooks
+ */
+const path = require("node:path");
+process.env.TPH_PROMPT_PLATFORM = "claude";
+require(path.join(__dirname, "..", "dist", "platform-hook-entry.js"));

package/scripts/capture-codex.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Codex UserPromptSubmit shim.
+ * Verified API: https://developers.openai.com/codex/hooks
+ */
+const path = require("node:path");
+process.env.TPH_PROMPT_PLATFORM = "codex";
+require(path.join(__dirname, "..", "dist", "platform-hook-entry.js"));

package/skills/prompt-history/SKILL.md

@@ -7,15 +7,16 @@ description: Manage Team Prompt History — local capture, push-on-capture, enro
 
 ## Default behavior (push-on-capture)
 
-1. Cursor **`beforeSubmitPrompt`** appends the prompt to the local `.txt` first.
+1. A verified product hook (Cursor `beforeSubmitPrompt`, Claude/Codex `UserPromptSubmit`, OpenCode `chat.message`) appends to the local `.txt` with `promptPlatform` set.
 2. If the device is enrolled and sync is enabled, the same prompt is **queued and pushed** to the team server in the background (non-blocking).
 3. If the server is down, the local file and durable queue keep the prompt; the background service retries with backoff.
 4. Admin **Collections** remain as a **fallback/backfill** (upload remaining local history + verified backup/rotate).
 
 ## Local
 
-- Capture uses Cursor **`beforeSubmitPrompt`** (observe-only).
+- Cursor: **`beforeSubmitPrompt`**. Claude Code / Codex / OpenCode: `prompt-history install-hooks`.
 - Never loses prompts: local append always wins over network.
+- Never invent platform tags without a real hook — see `docs/PROMPT-PLATFORMS.md`.
 
 ## Team