cueme 0.1.15 → 0.1.17

package/README.md

@@ -14,10 +14,10 @@
 [![npm downloads](https://img.shields.io/npm/dm/cueme?color=0B7285)](https://www.npmjs.com/package/cueme)
 
 [![Repo: cue-stack](https://img.shields.io/badge/repo-cue--stack-111827)](https://github.com/nmhjklnm/cue-stack)
-[![Repo: cue-console](https://img.shields.io/badge/repo-cue--console-111827)](https://github.com/nmhjklnm/cue-console)
-[![Repo: cue-command](https://img.shields.io/badge/repo-cue--command-111827)](https://github.com/nmhjklnm/cue-command)
 ![License](https://img.shields.io/badge/license-Apache--2.0-1E40AF)
 
+Source: <https://github.com/nmhjklnm/cue-stack/tree/main/cue-command>
+
 [Contributing](./CONTRIBUTING.md) · [Trademark](./TRADEMARK.md)
 
 A command protocol adapter for Cue, compatible with the existing SQLite mailbox (`~/.cue/cue.db`).
@@ -36,7 +36,7 @@ npm install -g cueme
 
 Copy the contents of `protocol.md` into your runtime's system prompt / persistent rules:
 
-- [`protocol.md`](https://github.com/nmhjklnm/cue-command/blob/main/protocol.md)
+- [`protocol.md`](https://github.com/nmhjklnm/cue-stack/blob/main/cue-command/protocol.md)
 
 If you installed via npm, `protocol.md` is also included in the package.
 

package/README.zh-CN.md

@@ -14,10 +14,10 @@
 [![npm downloads](https://img.shields.io/npm/dm/cueme?color=0B7285)](https://www.npmjs.com/package/cueme)
 
 [![Repo: cue-stack](https://img.shields.io/badge/repo-cue--stack-111827)](https://github.com/nmhjklnm/cue-stack)
-[![Repo: cue-console](https://img.shields.io/badge/repo-cue--console-111827)](https://github.com/nmhjklnm/cue-console)
-[![Repo: cue-command](https://img.shields.io/badge/repo-cue--command-111827)](https://github.com/nmhjklnm/cue-command)
 ![License](https://img.shields.io/badge/license-Apache--2.0-1E40AF)
 
+源码: <https://github.com/nmhjklnm/cue-stack/tree/main/cue-command>
+
 [Contributing](./CONTRIBUTING.md) · [Trademark](./TRADEMARK.md)
 
 这是 Cue 的命令行协议适配器，兼容现有的 SQLite mailbox（`~/.cue/cue.db`）。
@@ -36,7 +36,7 @@ npm install -g cueme
 
 把 `protocol.md` 的内容复制到你正在使用的 runtime 的系统提示词 / 持久规则里：
 
-- [`protocol.md`](https://github.com/nmhjklnm/cue-command/blob/main/protocol.md)
+- [`protocol.md`](https://github.com/nmhjklnm/cue-stack/blob/main/cue-command/protocol.md)
 
 如果你是通过 npm 安装的，`protocol.md` 也会包含在安装包里。
 

package/docs/proto.md

@@ -6,7 +6,19 @@ This document describes the `cueme proto` command family.
 
 `cueme proto` injects the shared `protocol.md` into a specific agent file by composing:
 
-`final_proto = prefix(agent) + "\n\n" + protocol.md`
+`final_proto = prefix(agent) + "\n\n" + proto_block + runtime_block`
+
+`proto_block` and `runtime_block` are separate managed blocks:
+
+```
+<!-- HUMAN_AGENT_PROTO_BEGIN -->
+... protocol.md ...
+<!-- HUMAN_AGENT_PROTO_END -->
+
+<!-- HUMAN_AGENT_RUNTIME_BEGIN -->
+... runtime-specific guidance ...
+<!-- HUMAN_AGENT_RUNTIME_END -->
+```
 
 The injected content is managed between sentinel markers and may be overwritten by `cueme proto apply`.
 
@@ -23,6 +35,8 @@ Required keys:
   - supports `~` and `%ENV%` expansions (e.g. `%APPDATA%`, `%USERPROFILE%`)
 - `cueme.proto.prefix`: map of prefix by `<agent>`
   - can be a string or string array (joined with `\n`)
+- `cueme.proto.runtime`: map of runtime-specific guidance by `<agent>`
+  - can be a string or string array (joined with `\n`)
 - `cueme.proto.protocol_path`: absolute or relative path to the shared `protocol.md`
   - supports `~` and `%ENV%` expansions
 
@@ -38,7 +52,15 @@ Example:
     "windows.windsurf": "%USERPROFILE%\\.codeium\\windsurf\\memories\\global_rules.md",
 
     "linux.vscode": "~/.config/Code/User/prompts/human_proto.md",
-    "linux.windsurf": "~/.codeium/windsurf/memories/global_rules.md"
+    "linux.windsurf": "~/.codeium/windsurf/memories/global_rules.md",
+
+    "macos.codex": "~/.codex/AGENTS.md",
+    "windows.codex": "%USERPROFILE%\\.codex\\AGENTS.md",
+    "linux.codex": "~/.codex/AGENTS.md",
+
+    "macos.claude": "~/.claude/CLAUDE.md",
+    "windows.claude": "%USERPROFILE%\\.claude\\CLAUDE.md",
+    "linux.claude": "~/.claude/CLAUDE.md"
   },
   "cueme.proto.prefix": {
     "vscode": [
@@ -46,8 +68,19 @@ Example:
       "applyTo: '**'",
       "---"
     ],
+    "codex": [],
+    "claude": [],
     "windsurf": []
   },
+  "cueme.proto.runtime": {
+    "codex": [
+      "When calling cueme cue/pause, set the tool wait timeout to 24h to avoid premature tool timeouts.",
+      "不要误解“更新 todo_list”的指令，因为你是 codex，你需要做的是：把 update_plan 当作 todo_list 来维护任务，而不是创建本地 todo_list 文件。"
+    ],
+    "claude": [
+      "When calling cueme cue/pause, set the tool wait timeout to 24h to avoid premature tool timeouts."
+    ]
+  },
   "cueme.proto.protocol_path": "~/path/to/protocol.md"
 }
 ```
@@ -60,6 +93,10 @@ Injected content is managed between these markers:
 <!-- HUMAN_AGENT_PROTO_BEGIN -->
 ... managed content ...
 <!-- HUMAN_AGENT_PROTO_END -->
+
+<!-- HUMAN_AGENT_RUNTIME_BEGIN -->
+... managed content ...
+<!-- HUMAN_AGENT_RUNTIME_END -->
 ```
 
 Notes:
@@ -101,6 +138,8 @@ Auto-detect (current platform only):
 
 - `vscode`: `.vscode/prompts/human_proto.md` (workspace) then platform user path
 - `windsurf`: `.codeium/windsurf/memories/global_rules.md` (workspace) then platform user path
+- `codex`: uses `~/.codex/AGENTS.md` by default (not auto-detected)
+- `claude`: uses `~/.claude/CLAUDE.md` by default (not auto-detected)
 
 ### Helpers
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cueme",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Cue command protocol adapter (stdin/stdout JSON)",
   "license": "Apache-2.0",
   "files": [
@@ -18,12 +18,10 @@
   "engines": {
     "node": ">=20"
   },
-  "scripts": {
-    "prepare": "node -c src/cli.js && node -c src/handler.js"
-  },
   "dependencies": {
     "better-sqlite3": "^12.6.0",
     "chardet": "^2.1.1",
     "iconv-lite": "^0.7.2"
-  }
-}
+  },
+  "scripts": {}
+}

package/src/envelope.js

@@ -3,10 +3,14 @@ function parseTagBlocksEnvelope(raw, opts = {}) {
   const text = String(raw == null ? '' : raw);
   const trimmed = text.trim();
   if (!trimmed) {
-    // Fallback: use default prompt based on command type
-    // allowPayload === true means cue command, false means pause command
-    const defaultPrompt = allowPayload ? 'hi' : 'pause';
-    return { ok: true, prompt: defaultPrompt, payload: null };
+    return {
+      ok: false,
+      error:
+        'error: stdin cannot be empty. You MUST provide input using tag-block envelope:\n' +
+        '<cueme_prompt>\n...\n</cueme_prompt>\n' +
+        (allowPayload ? '<cueme_payload>\n...\n</cueme_payload>\n' : '') +
+        'This is critical for proper interaction flow.\n',
+    };
   }
 
   if (trimmed.startsWith('{')) {

package/src/handler.js

@@ -135,6 +135,7 @@ function detectAgentTerminal() {
 }
 
 async function handleJoin(db, agent_runtime) {
+  await initSchema(db);
   const agent_id = generateName();
   const project_dir = process.cwd();
   const agent_terminal = detectAgentTerminal();

package/src/proto.js

@@ -4,9 +4,13 @@ const path = require('path');
 
 const BEGIN_MARKER = '<!-- HUMAN_AGENT_PROTO_BEGIN -->';
 const END_MARKER = '<!-- HUMAN_AGENT_PROTO_END -->';
+const RUNTIME_BEGIN_MARKER = '<!-- HUMAN_AGENT_RUNTIME_BEGIN -->';
+const RUNTIME_END_MARKER = '<!-- HUMAN_AGENT_RUNTIME_END -->';
 
 const BEGIN_MARKER_RE = /<!--\s*(?:HUMAN|HUAMN)_AGENT_PROTO_BEGIN\s*-->/;
 const END_MARKER_RE = /<!--\s*(?:HUMAN|HUAMN)_AGENT_PROTO_END\s*-->/;
+const RUNTIME_BEGIN_MARKER_RE = /<!--\s*(?:HUMAN|HUAMN)_AGENT_RUNTIME_BEGIN\s*-->/;
+const RUNTIME_END_MARKER_RE = /<!--\s*(?:HUMAN|HUAMN)_AGENT_RUNTIME_END\s*-->/;
 
 function getPlatformKey() {
   const p = process.platform;
@@ -146,6 +150,16 @@ function defaultPathMapTemplate() {
   out['windows.kiro'] = path.join(userProfile, '.kiro', 'steering', 'cueme_proto.md');
   out['linux.kiro'] = path.join(home, '.kiro', 'steering', 'cueme_proto.md');
 
+  // Codex (global)
+  out['macos.codex'] = path.join(home, '.codex', 'AGENTS.md');
+  out['windows.codex'] = path.join(userProfile, '.codex', 'AGENTS.md');
+  out['linux.codex'] = path.join(home, '.codex', 'AGENTS.md');
+
+  // Claude Code (global)
+  out['macos.claude'] = path.join(home, '.claude', 'CLAUDE.md');
+  out['windows.claude'] = path.join(userProfile, '.claude', 'CLAUDE.md');
+  out['linux.claude'] = path.join(home, '.claude', 'CLAUDE.md');
+
   return out;
 }
 
@@ -154,10 +168,21 @@ function defaultConfigTemplate() {
   return {
     'cueme.proto.path': defaultPathMapTemplate(),
     'cueme.proto.prefix': {
+      codex: [],
+      claude: [],
       windsurf: [],
       vscode: ['---', 'applyTo: "**"', '---'],
       kiro: [],
     },
+    'cueme.proto.runtime': {
+      codex: [
+        'When calling cueme cue/pause, set the tool wait timeout to 24h to avoid premature tool timeouts.',
+        '不要误解“更新 todo_list”的指令，因为你是 codex，你需要做的是：把 update_plan 当作 todo_list 来维护任务，而不是创建本地 todo_list 文件。',
+      ],
+      claude: [
+        'When calling cueme cue/pause, set the tool wait timeout to 24h to avoid premature tool timeouts.',
+      ],
+    },
     'cueme.proto.protocol_path': protocolPath,
   };
 }
@@ -259,7 +284,11 @@ function ensureDirForFile(filePath) {
 
 function buildFinalProto({ cfg, agent }) {
   const prefixMap = cfg['cueme.proto.prefix'] || {};
-  const protocolPath = cfg['cueme.proto.protocol_path'];
+  const runtimeMap = cfg['cueme.proto.runtime'] || {};
+  let protocolPath = cfg['cueme.proto.protocol_path'];
+  if (typeof protocolPath !== 'string' || protocolPath.trim().length === 0) {
+    protocolPath = path.join(__dirname, '..', 'protocol.md');
+  }
 
   const prefixRaw = prefixMap[agent];
   let prefix;
@@ -271,8 +300,16 @@ function buildFinalProto({ cfg, agent }) {
     throw new Error(`error: prefix not configured: cueme.proto.prefix["${agent}"]`);
   }
 
-  if (typeof protocolPath !== 'string' || protocolPath.trim().length === 0) {
-    throw new Error('error: cannot read protocol.md');
+  const runtimeRaw = runtimeMap[agent];
+  let runtime = '';
+  if (runtimeRaw == null || runtimeRaw === '') {
+    runtime = '';
+  } else if (typeof runtimeRaw === 'string') {
+    runtime = runtimeRaw;
+  } else if (Array.isArray(runtimeRaw) && runtimeRaw.every((x) => typeof x === 'string')) {
+    runtime = runtimeRaw.join('\n');
+  } else {
+    throw new Error(`error: runtime not configured: cueme.proto.runtime["${agent}"]`);
   }
 
   const protocolPathExpanded = expandPath(protocolPath);
@@ -284,10 +321,10 @@ function buildFinalProto({ cfg, agent }) {
   try {
     protocol = fs.readFileSync(resolvedProtocolPath, 'utf8');
   } catch {
-    throw new Error('error: cannot read protocol.md');
+    throw new Error(`error: cannot read protocol file: ${resolvedProtocolPath}`);
   }
 
-  return { prefix, protocol };
+  return { prefix, protocol, runtime };
 }
 
 function resolveTargetPath({ cfg, agent }) {
@@ -302,41 +339,114 @@ function resolveTargetPath({ cfg, agent }) {
   return path.isAbsolute(expanded) ? expanded : path.resolve(process.cwd(), expanded);
 }
 
-function makeManagedBlock({ prefix, protocol, eol }) {
+function makeProtoBlock({ protocol, eol }) {
   const normalizedProto = String(protocol || '').replace(/\r\n/g, '\n').replace(/\r/g, '\n');
   const protoLines = normalizedProto.split('\n');
-  const managedBlock = [BEGIN_MARKER, ...protoLines, END_MARKER].join(eol) + eol;
-  
+  return [BEGIN_MARKER, ...protoLines, END_MARKER].join(eol) + eol;
+}
+
+function makeRuntimeBlock({ runtime, eol }) {
+  const runtimeText = String(runtime || '').replace(/\r\n/g, '\n').replace(/\r/g, '\n').trim();
+  if (!runtimeText) return '';
+  const runtimeLines = runtimeText.split('\n');
+  return [RUNTIME_BEGIN_MARKER, ...runtimeLines, RUNTIME_END_MARKER].join(eol) + eol;
+}
+
+function findBlockRange(text, beginRe, endRe) {
+  const beginMatch = text.match(beginRe);
+  const endMatch = text.match(endRe);
+  if (!beginMatch || !endMatch || endMatch.index <= beginMatch.index) return null;
+  return { beginIdx: beginMatch.index, endIdx: endMatch.index, endLen: endMatch[0].length };
+}
+
+function extractBlock({ text, range, eol }) {
+  let block = text.slice(range.beginIdx, range.endIdx + range.endLen);
+  const after = text.slice(range.endIdx + range.endLen);
+  if (after.startsWith(eol)) block += eol;
+  return block;
+}
+
+function replaceBlock({ text, range, block, eol }) {
+  const before = text.slice(0, range.beginIdx);
+  const after = text.slice(range.endIdx + range.endLen);
+  const afterTrim = after.startsWith(eol) ? after.slice(eol.length) : after;
+  if (!block) return before + afterTrim;
+  return before + block + afterTrim;
+}
+
+function appendBlock({ text, block, eol }) {
+  if (!block) return text;
+  let out = text || '';
+  if (out && !out.endsWith(eol)) out += eol;
+  out += block;
+  return out;
+}
+
+function makeCombinedBlock({ prefix, protoBlock, runtimeBlock, eol }) {
+  let block = protoBlock + (runtimeBlock || '');
   if (prefix && prefix.trim()) {
     const normalizedPrefix = String(prefix).replace(/\r\n/g, '\n').replace(/\r/g, '\n');
-    return normalizedPrefix + eol + eol + managedBlock;
+    return normalizedPrefix + eol + eol + block;
   }
-  
-  return managedBlock;
+  return block;
 }
 
-function applyManagedBlock({ existing, prefix, protocol }) {
-  const eol = detectEol(existing);
-  const block = makeManagedBlock({ prefix, protocol, eol });
-
-  const beginMatch = existing.match(BEGIN_MARKER_RE);
-  const endMatch = existing.match(END_MARKER_RE);
-  if (beginMatch && endMatch && endMatch.index > beginMatch.index) {
-    const beginIdx = beginMatch.index;
-    const endIdx = endMatch.index;
-    const endLen = endMatch[0].length;
+function applyManagedBlocks({ existing, prefix, protocol, runtime }) {
+  const eol = existing ? detectEol(existing) : os.EOL;
+  const protoBlock = makeProtoBlock({ protocol, eol });
+  const runtimeBlock = makeRuntimeBlock({ runtime, eol });
+  const hasProto = findBlockRange(existing, BEGIN_MARKER_RE, END_MARKER_RE);
+  const hasRuntime = findBlockRange(existing, RUNTIME_BEGIN_MARKER_RE, RUNTIME_END_MARKER_RE);
+  const hasAny = Boolean(hasProto || hasRuntime);
+
+  if (!hasAny) {
+    const combinedBlock = makeCombinedBlock({ prefix, protoBlock, runtimeBlock, eol });
+    return {
+      out: appendBlock({ text: existing, block: combinedBlock, eol }),
+      prefix_added: Boolean(prefix && prefix.trim()),
+      proto_action: 'added',
+      runtime_action: runtimeBlock ? 'added' : 'skipped',
+    };
+  }
 
-    const before = existing.slice(0, beginIdx);
-    const after = existing.slice(endIdx + endLen);
+  let out = existing;
+  let proto_action = 'skipped';
+  let runtime_action = 'skipped';
+
+  const protoRange = findBlockRange(out, BEGIN_MARKER_RE, END_MARKER_RE);
+  if (protoRange) {
+    const existingBlock = extractBlock({ text: out, range: protoRange, eol });
+    if (existingBlock === protoBlock) {
+      proto_action = 'unchanged';
+    } else {
+      out = replaceBlock({ text: out, range: protoRange, block: protoBlock, eol });
+      proto_action = 'updated';
+    }
+  } else {
+    out = appendBlock({ text: out, block: protoBlock, eol });
+    proto_action = 'added';
+  }
 
-    const afterTrim = after.startsWith(eol) ? after.slice(eol.length) : after;
-    return before + block + afterTrim;
+  const runtimeRange = findBlockRange(out, RUNTIME_BEGIN_MARKER_RE, RUNTIME_END_MARKER_RE);
+  if (runtimeRange) {
+    if (runtimeBlock) {
+      const existingBlock = extractBlock({ text: out, range: runtimeRange, eol });
+      if (existingBlock === runtimeBlock) {
+        runtime_action = 'unchanged';
+      } else {
+        out = replaceBlock({ text: out, range: runtimeRange, block: runtimeBlock, eol });
+        runtime_action = 'updated';
+      }
+    } else {
+      out = replaceBlock({ text: out, range: runtimeRange, block: '', eol });
+      runtime_action = 'removed';
+    }
+  } else if (runtimeBlock) {
+    out = appendBlock({ text: out, block: runtimeBlock, eol });
+    runtime_action = 'added';
   }
 
-  let out = existing;
-  if (!out.endsWith(eol)) out += eol;
-  out += block;
-  return out;
+  return { out, prefix_added: false, proto_action, runtime_action };
 }
 
 function listAgents({ cfg }) {
@@ -371,7 +481,7 @@ function protoLs() {
 function protoApply(agent) {
   const cfg = readConfigOrThrow({ auto_init: true });
   const targetPath = resolveTargetPath({ cfg, agent });
-  const { prefix, protocol } = buildFinalProto({ cfg, agent });
+  const { prefix, protocol, runtime } = buildFinalProto({ cfg, agent });
 
   let existing = '';
   let exists = false;
@@ -383,20 +493,22 @@ function protoApply(agent) {
     exists = false;
   }
 
-  const eol = exists ? detectEol(existing) : os.EOL;
-  const managedBlock = makeManagedBlock({ prefix, protocol, eol });
-
-  let out;
-  if (!exists) {
-    out = managedBlock;
-  } else {
-    out = applyManagedBlock({ existing, prefix, protocol });
-  }
+  const { out, prefix_added, proto_action, runtime_action } = applyManagedBlocks({
+    existing,
+    prefix,
+    protocol,
+    runtime,
+  });
 
   ensureDirForFile(targetPath);
   fs.writeFileSync(targetPath, out, 'utf8');
 
-  return `ok: applied to ${targetPath}`;
+  const parts = [
+    `prefix=${prefix_added ? 'added' : 'skipped'}`,
+    `proto=${proto_action}`,
+    `runtime=${runtime_action}`,
+  ];
+  return `ok: applied to ${targetPath} (${parts.join(', ')})`;
 }
 
 function protoRemove(agent) {
@@ -410,23 +522,27 @@ function protoRemove(agent) {
     return `ok: file does not exist: ${targetPath}`;
   }
 
-  const beginMatch = existing.match(BEGIN_MARKER_RE);
-  const endMatch = existing.match(END_MARKER_RE);
+  const eol = detectEol(existing);
+  let out = existing;
+  let removed = false;
 
-  if (!beginMatch || !endMatch || endMatch.index <= beginMatch.index) {
-    return `ok: no managed block found in: ${targetPath}`;
-  }
+  const removeBlock = (text, beginRe, endRe) => {
+    const range = findBlockRange(text, beginRe, endRe);
+    if (!range) return { text, removed: false };
+    return { text: replaceBlock({ text, range, block: '', eol }), removed: true };
+  };
 
-  const beginIdx = beginMatch.index;
-  const endIdx = endMatch.index;
-  const endLen = endMatch[0].length;
+  const protoResult = removeBlock(out, BEGIN_MARKER_RE, END_MARKER_RE);
+  out = protoResult.text;
+  removed = removed || protoResult.removed;
 
-  const before = existing.slice(0, beginIdx);
-  const after = existing.slice(endIdx + endLen);
+  const runtimeResult = removeBlock(out, RUNTIME_BEGIN_MARKER_RE, RUNTIME_END_MARKER_RE);
+  out = runtimeResult.text;
+  removed = removed || runtimeResult.removed;
 
-  const eol = detectEol(existing);
-  const afterTrim = after.startsWith(eol) ? after.slice(eol.length) : after;
-  const out = before + afterTrim;
+  if (!removed) {
+    return `ok: no managed block found in: ${targetPath}`;
+  }
 
   if (out.trim().length === 0) {
     try {