greprag 5.13.0 → 5.15.0

package/dist/session-id.js

@@ -44,6 +44,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.truncateSessionId = truncateSessionId;
+exports.sessionIdFromEnv = sessionIdFromEnv;
 exports.readIdentityAlias = readIdentityAlias;
 exports.buildSessionIdContext = buildSessionIdContext;
 exports.handleSessionIdHook = handleSessionIdHook;
@@ -65,6 +66,25 @@ function truncateSessionId(sessionId) {
     const candidate = hex.slice(0, 8);
     return /^[0-9a-f]{8}$/.test(candidate) ? candidate : null;
 }
+/** Resolve the running session's id from the environment, truncated to 8-hex.
+ *
+ *  Claude Code sets `CLAUDE_CODE_SESSION_ID` on every subprocess it spawns —
+ *  the Bash tool, hook processes, AND plugin monitors all inherit it (verified
+ *  against the 2.1.x binary: the child-env builder sets it unconditionally and
+ *  it is also written to the global process env). So any greprag command run
+ *  inside a session self-discovers its own id with no flag and no transcript
+ *  spelunking. `CLAUDE_SESSION_ID` / `GREPRAG_SESSION_ID` are kept as
+ *  back-compat / test-injection fallbacks. Returns null when none is set or
+ *  the value can't be truncated to a valid 8-hex id.
+ *
+ *  Note: the env var is `CLAUDE_CODE_SESSION_ID` (with `CODE`); the legacy
+ *  `CLAUDE_SESSION_ID` name was never actually set by Claude Code. */
+function sessionIdFromEnv() {
+    return truncateSessionId(process.env.CLAUDE_CODE_SESSION_ID
+        || process.env.CLAUDE_SESSION_ID
+        || process.env.GREPRAG_SESSION_ID
+        || null);
+}
 /** Read the cached identity handle. Returns the alias part (before `@`) so
  *  it can be substituted in `<handle>@greprag.com/<id>` templates without
  *  doubling the domain. Returns null on any read/parse error — caller
@@ -92,52 +112,38 @@ function readIdentityAlias() {
 /** Build the `additionalContext` body. Kept as a named export so tests
  *  can assert on shape without going through stdin/stdout.
  *
- *  Two-segment grammar per adr/address-grammar.md. Examples are grounded
- *  in *this* session's id so the agent copy/pastes rather than composes.
- *
- *  When `armWatcher` is true, the message LEADS with
- *  `STOP IMMEDIATELY AND READ THIS. RUN THIS NOW:` followed by the
- *  literal Monitor command for THIS session. The earlier
- *  `ARM YOUR INBOX WATCHER NOW.` lead was skipped in practice — agents
- *  treated it as informational rather than as a precondition. STOP +
- *  RUN combines two imperatives models react to strongly (stop reading
- *  past, do this thing now), and `RUN THIS NOW:` sits immediately
- *  before the actual command so the action is structurally adjacent to
- *  its trigger phrase. The agent can infer the command's role from
- *  reading it (`greprag inbox watch` + the reply-to line on the next
- *  sentence ties messages to the same address) — no need to label.
+ *  Emits awareness only: the agent's own 8-hex session id plus the
+ *  two-segment reply-to address (grammar per adr/address-grammar.md),
+ *  grounded in *this* session's id so the agent copy/pastes rather than
+ *  composes. `alias` substitutes the literal `<handle>` placeholder in the
+ *  reply-address line; defaults to null (leave placeholder) for callers
+ *  without an identity cache.
  *
- *  `alias` substitutes the literal `<handle>` placeholder in the
- *  reply-address line. Defaults to null (leave placeholder) so callers
- *  that don't have an identity cache get the same shape as before. */
-function buildSessionIdContext(short, armWatcher = false, alias = null) {
+ *  Arming the inbox watcher is NO LONGER done here. The old SessionStart
+ *  arm-directive (`STOP IMMEDIATELY ... RUN THIS NOW: Monitor ...`) depended
+ *  on the agent choosing to make a Monitor tool call and was skipped in
+ *  practice. It is replaced by the `greprag-inbox` plugin monitor, which
+ *  Claude Code auto-starts at session start with no agent cooperation —
+ *  see adr/session-id-awareness.md. */
+function buildSessionIdContext(short, alias = null) {
     const handle = alias || '<handle>';
-    const ref = (`Your greprag session id: ${short}. `
+    return (`Your greprag session id: ${short}. `
         + `Reply to you: ${handle}@greprag.com/${short} `
         + `(target = 8-hex/UUID session id, or project name).`);
-    if (!armWatcher)
-        return ref;
-    return (`STOP IMMEDIATELY AND READ THIS. RUN THIS NOW: `
-        + `Monitor (persistent:true): `
-        + `\`while true; do greprag inbox watch --session ${short} --json; `
-        + `echo "[restart]" >&2; sleep 1; done\`. `
-        + ref);
 }
 /** Handle `greprag-hook session-id`. Reads the Claude Code hook payload
  *  from `input.session_id`, emits a JSON response with hookSpecificOutput.
  *  additionalContext to stdout. Silent on missing session_id (other hook
  *  entries in the chain still fire).
  *
- *  `opts.armWatcher` (default false) toggles the "arm Monitor watcher"
- *  directive in the emitted text. Caller (hook.ts main) reads greprag
- *  config and passes true only when the API key + hook-enabled flag are
- *  both set — no point telling an unconfigured project to arm a watcher
- *  that would just loop on auth errors.
+ *  Emits session-id awareness only. Arming the inbox watcher moved to the
+ *  `greprag-inbox` plugin monitor (see buildSessionIdContext +
+ *  adr/session-id-awareness.md).
  *
  *  Reads the identity alias from `~/.greprag/identity.json` here so the
  *  emitted reply-address line carries the operator's real handle instead
  *  of the literal `<handle>` placeholder. */
-function handleSessionIdHook(input, opts = {}) {
+function handleSessionIdHook(input) {
     const short = truncateSessionId(input.session_id);
     if (!short)
         return;
@@ -145,7 +151,7 @@ function handleSessionIdHook(input, opts = {}) {
     const payload = {
         hookSpecificOutput: {
             hookEventName: 'SessionStart',
-            additionalContext: buildSessionIdContext(short, opts.armWatcher === true, alias),
+            additionalContext: buildSessionIdContext(short, alias),
         },
     };
     process.stdout.write(JSON.stringify(payload) + '\n');

package/dist/session-id.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-id.js","sourceRoot":"","sources":["../src/session-id.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-id.js","sourceRoot":"","sources":["../src/session-id.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "greprag",
-  "version": "5.13.0",
+  "version": "5.15.0",
   "description": "GrepRAG — agent memory for Claude Code. 2-command setup.",
   "main": "dist/index.js",
   "bin": {
@@ -15,6 +15,7 @@
   "files": [
     "dist",
     "skill",
+    "plugin",
     "scripts"
   ],
   "devDependencies": {

package/plugin/.claude-plugin/marketplace.json

@@ -0,0 +1,13 @@
+{
+  "name": "greprag",
+  "owner": { "name": "GrepRAG", "email": "travis@greprag.com" },
+  "metadata": { "description": "GrepRAG bundled plugins." },
+  "plugins": [
+    {
+      "name": "greprag-inbox",
+      "description": "Auto-arms the GrepRAG inbox watcher (session-scoped) at session start so cross-session messages arrive mid-task without the agent invoking anything.",
+      "source": "./plugins/greprag-inbox",
+      "category": "productivity"
+    }
+  ]
+}

package/plugin/plugins/greprag-inbox/.claude-plugin/plugin.json

@@ -0,0 +1,7 @@
+{
+  "name": "greprag-inbox",
+  "version": "0.1.0",
+  "description": "Auto-arms the GrepRAG inbox watcher (session-scoped) at session start.",
+  "author": { "name": "GrepRAG", "email": "travis@greprag.com" },
+  "homepage": "https://greprag.com"
+}

package/plugin/plugins/greprag-inbox/monitors/monitors.json

@@ -0,0 +1,8 @@
+[
+  {
+    "name": "greprag-inbox-watch",
+    "when": "always",
+    "description": "GrepRAG inbox (session-scoped live tail)",
+    "command": "while true; do greprag inbox watch --session-from-env --json; echo '[greprag inbox watch] watcher exited, restarting in 1s' >&2; sleep 1; done"
+  }
+]

package/skill/commander/SKILL.md

@@ -124,9 +124,9 @@ If `references.discord.emergency_route` is non-null, this session was auto-linke
 
 Example first reply:
 
-> Picked this up in `<project-name>` / session `<session-8hex>` (no handoff was active, so I'm the most-recent armed watcher). Auto-pin is 10 min — slides while you keep replying. Want to redirect? `/commander handoff` from another session, or just say "redirect to <project>".
+> Picked this up in `<project-name>` / session `<session-8hex>` (no handoff was active, so I'm the most-recently-active armed session). Auto-pin is 10 min; it extends to 30 once you reply again. Want to redirect? `/commander handoff` from another session, or just say "redirect to <project>".
 
-The auto-pin TTL is short (10 min) and slides forward 30 min with each subsequent DM, so a real conversation keeps flowing here. If the operator goes quiet for the TTL window, the pin expires and the next DM re-runs the router (possibly landing in a different session if the topology has changed).
+How the bot chose this session: among all armed session-scoped watchers under your tenant, it picks the **most-recently-active** one — ranked by `max(last turn end, arm time)` — so a session that just finished a turn (idle, waiting) outranks one grinding a long task or gone dark. The auto-pin starts at a **genuine 10-min leash**, so one stray DM into the wrong session self-heals fast if you go quiet; your *next* DM (pin now live) extends it to ≥30 min so a real back-and-forth keeps flowing here. If the picked session turns out to be dead — or nothing is armed at all — the bot replies that your message is filed and will be delivered the moment a session reconnects (it never vanishes), and clears the dead auto-pin so the next DM re-runs the router.
 
 For long agent turns where you're drafting >10s, refresh the typing indicator between work steps:
 

package/skill/content-advisor/SKILL.md

@@ -3,7 +3,7 @@ name: content-advisor
 version: 0.1.0
 description: |
   Cross-venture content strategist for a multi-venture portfolio. Reads
-  GrepRAG Odyssey (episodic project memory — ship-events, dailies, weeklies) across every
+  GrepRAG memory (episodic project memory; marketed as Odyssey — ship-events, dailies, weeklies) across every
   paired project, cross-checks recent writing activity (OpenWriter drafts,
   newsletter sends, X posts, blog commits), and produces a ranked list of
   the next content pieces to ship — each one ready to hand off to a