@jsayubi/ccgram 1.1.1 → 1.2.1

package/.env.example

@@ -16,4 +16,7 @@ TELEGRAM_CHAT_ID=
 # Suppress Telegram notifications when actively at terminal (seconds, default: 300)
 # ACTIVE_THRESHOLD_SECONDS=300
 
+# Injection backend: tmux (default), ghostty, or pty
+# INJECTION_MODE=ghostty
+
 # For advanced options (email relay, LINE, webhooks), see .env.full-example

package/README.md

@@ -18,20 +18,23 @@ CCGram is a self-hosted Telegram bot that bridges Claude Code to your phone. Whe
 ```
 Claude Code  →  ccgram hooks  →  Telegram bot  →  📱 your phone
      ↑                                ↓
-     └──── tmux or PTY injection ─────┘
+     └─ updatedInput / tmux / Ghostty / PTY ─┘
 ```
 
 ## Features
 
-- **Permission approvals** — Allow, Deny, or Always allow with a single tap
-- **Question answering** — Select from Claude's options via inline buttons (single and multi-select)
-- **Smart notifications** — Task completions, session start/end, and subagent activity — silent when you're at your terminal, instant when you're away
+- **Universal terminal support** — Works with tmux, Ghostty, bare zsh, screen — anything. Question answers flow back to Claude Code directly via the `updatedInput` hook output, no keystroke injection needed.
+- **Permission approvals** — Allow, Deny, Always, or Defer with a single tap
+- **Question answering** — Single-select, multi-select, and free-text questions answered via Telegram buttons
+- **Rich `/status`** — Model, version, git branch, session ID, context window % (auto-detects 1M mode), rate limit + reset time, last activity, last assistant message — all from Claude Code's transcript
+- **MCP elicitation forwarding** — Schema-aware MCP server input requests routed to Telegram, one prompt per form field
+- **Smart notifications** — Task completions, errors, compaction, session lifecycle, subagent activity — silent at your terminal, instant when you're away
 - **Remote command routing** — Send any command to any Claude session from Telegram
-- **Session management** — List, switch between, and interrupt active sessions
-- **Resume conversations** — `/resume` reads your full Claude Code session history with conversation snippets — pick up any past conversation in one tap
+- **Session management** — List, switch, interrupt; resume past conversations with `/resume`
 - **Project launcher** — Start Claude in any project directory with `/new myproject`
+- **Deep links** — `/link <prompt>` generates `claude-cli://open?q=...` URLs
 - **Smart routing** — Prefix matching, default workspace, reply-to routing
-- **Typing indicator** — See when the bot is waiting for Claude to respond
+- **Ghostty support** — Auto-detected on macOS via `TERM_PROGRAM=ghostty`; full keystroke injection via AppleScript
 - **tmux optional** — Falls back to a headless PTY session (`node-pty`) when tmux is unavailable
 - **One-command setup** — Interactive wizard installs hooks, generates service file, starts bot
 
@@ -40,7 +43,10 @@ Claude Code  →  ccgram hooks  →  Telegram bot  →  📱 your phone
 - [Node.js](https://nodejs.org) 18+
 - A Telegram bot token (from [@BotFather](https://t.me/BotFather))
 - Your Telegram chat ID (from [@userinfobot](https://t.me/userinfobot))
-- [tmux](https://github.com/tmux/tmux/wiki) _(optional — falls back to headless PTY via `node-pty` when absent)_
+- A terminal — any of:
+  - [tmux](https://github.com/tmux/tmux/wiki) (recommended; cross-platform)
+  - [Ghostty](https://ghostty.org) (auto-detected on macOS via `TERM_PROGRAM`)
+  - bare zsh / screen / anything else (PTY fallback via `node-pty`)
 
 ## Quick Start
 
@@ -58,20 +64,28 @@ Then open Telegram and message your bot — Claude Code will now notify you remo
 
 ## How It Works
 
-CCGram integrates with [Claude Code hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) — shell scripts that Claude Code calls at key moments. Each hook script sends a Telegram message and, when you respond, injects keystrokes back into the tmux session running Claude.
+CCGram integrates with [Claude Code hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) — shell scripts that Claude Code calls at key moments. Hooks send Telegram messages and, depending on the event, return your response to Claude Code directly via stdout (`updatedInput` for questions, `decision` for permissions) or inject keystrokes into the active session (tmux, Ghostty, or PTY).
 
 ### Hooks installed
 
 | Hook | Event | What it does |
 |------|-------|-------------|
-| `permission-hook.js` | `PermissionRequest` | Sends a permission dialog with Allow / Deny / Always buttons. Blocks Claude until you respond. |
-| `question-notify.js` | `PreToolUse` (AskUserQuestion) | Sends Claude's question with selectable options. Your tap injects the selection via tmux/PTY. |
+| `permission-hook.js` | `PermissionRequest` | Sends a permission dialog with Allow / Deny / Always / Defer buttons. Blocks Claude until you respond. |
+| `question-notify.js` | `PreToolUse` (AskUserQuestion) | Sends Claude's question with selectable options. Returns answer directly via `updatedInput` — works with any terminal. |
 | `enhanced-hook-notify.js completed` | `Stop` | Notifies you when Claude finishes a task, including the last response text. |
 | `enhanced-hook-notify.js waiting` | `Notification` | Notifies you when Claude is waiting for input. |
 | `user-prompt-hook.js` | `UserPromptSubmit` | Tracks terminal activity so notifications are suppressed when you're actively working. |
 | `enhanced-hook-notify.js session-start` | `SessionStart` | Notifies you when a new Claude session starts. |
-| `enhanced-hook-notify.js session-end` | `SessionEnd` | Notifies you when a Claude session ends, with the final response. |
+| `enhanced-hook-notify.js session-end` | `SessionEnd` | Notifies you when a Claude session ends. |
 | `enhanced-hook-notify.js subagent-done` | `SubagentStop` | Notifies you when a subagent task completes. |
+| `permission-denied-notify.js` | `PermissionDenied` | Notifies when auto mode blocks a tool. Retry button lets you override. |
+| `enhanced-hook-notify.js stop-failure` | `StopFailure` | Notifies you on API errors (rate limits, network issues). |
+| `enhanced-hook-notify.js post-compact` | `PostCompact` | Notifies when context compaction completes, with token savings. |
+| `pre-compact-notify.js` | `PreCompact` | Warns before compaction starts. Block button lets you preserve context. |
+| `elicitation-notify.js` | `Elicitation` | Forwards MCP server input requests to Telegram. Reply with your answer. |
+| `enhanced-hook-notify.js task-created` | `TaskCreated` | Notifies when Claude creates a new task. |
+| `enhanced-hook-notify.js cwd-changed` | `CwdChanged` | Notifies when Claude changes working directory. |
+| `enhanced-hook-notify.js instructions-loaded` | `InstructionsLoaded` | Notifies when CLAUDE.md or rules are loaded. |
 
 > **Smart suppression** — all notifications (including permissions) are automatically silenced when you've sent a message to Claude within the last 5 minutes. The moment you step away, Telegram takes over. Telegram-injected commands always get their response back to Telegram regardless.
 
@@ -91,11 +105,11 @@ Claude requests permission
 
 ```
 Claude asks a question (AskUserQuestion)
-  → Claude shows question UI in terminal
   → question-notify sends options to Telegram
   → you tap an option
-  → bot injects arrow keys + Enter via tmux or PTY
-  → Claude's question UI captures the keystrokes
+  → bot writes response file with your selection
+  → hook returns answer via updatedInput to Claude
+  → Claude receives answer directly (works with any terminal!)
 ```
 
 ## Bot Commands
@@ -114,9 +128,12 @@ Claude asks a question (AskUserQuestion)
 | Command | Description |
 |---------|-------------|
 | `/<workspace> <command>` | Send a command to a specific Claude session |
-| `/status [workspace]` | Show the last 20 lines of tmux pane output |
+| `/status [workspace]` | Rich status: model, version, branch, session ID, context %, rate limit, last activity, last message (and recent pane output for tmux/PTY) |
 | `/stop [workspace]` | Send Ctrl+C to interrupt the running prompt |
 | `/compact [workspace]` | Run `/compact` and wait for it to complete |
+| `/effort [workspace] low\|medium\|high` | Set Claude's thinking effort level |
+| `/model [workspace] <model>` | Switch Claude model (sonnet, opus, haiku) |
+| `/link <prompt>` | Generate a deep link to open Claude Code with your prompt |
 
 ### Project launcher
 
@@ -252,7 +269,7 @@ node dist/workspace-telegram-bot.js
 ```bash
 npm run build          # Compile TypeScript → dist/
 npm run build:watch    # Watch mode
-npm test               # Run 84 tests (vitest)
+npm test               # Run 120 tests (vitest)
 ```
 
 **Note:** Claude Code hooks run from `~/.ccgram/dist/`, not the repo's `dist/`. After changing hook scripts during development, sync them:
@@ -268,34 +285,42 @@ End users don't need this — `ccgram init` handles it automatically.
 ```
 src/
 ├── utils/
-│   ├── active-check.ts        # Detect terminal activity; suppress notifications when present
-│   ├── pty-session-manager.ts # Headless PTY backend via node-pty (tmux fallback)
-│   ├── callback-parser.ts     # Parse Telegram callback_data strings
-│   ├── http-request.ts        # Lightweight HTTPS wrapper (no axios)
-│   ├── optional-require.ts    # Graceful optional dependency loading
-│   └── paths.ts               # PROJECT_ROOT + CCGRAM_HOME constants
-├── types/                     # TypeScript interfaces
-└── data/                      # Runtime data (session map, history)
-
-workspace-telegram-bot.ts      # Main bot (long-polling, routing, callbacks)
-workspace-router.ts            # Session map, prefix matching, default workspace
-prompt-bridge.ts               # File-based IPC via /tmp/claude-prompts/
-permission-hook.ts             # Blocking permission approval hook
-question-notify.ts             # Non-blocking question notification hook
-enhanced-hook-notify.ts        # Status notification hook (Stop, Notification, SessionStart, SessionEnd, SubagentStop)
-user-prompt-hook.ts            # UserPromptSubmit hook — writes terminal activity timestamp
-setup.ts                       # Interactive setup wizard
-cli.ts                         # ccgram CLI entry point
+│   ├── active-check.ts            # Detect terminal activity; suppress notifications when present
+│   ├── pty-session-manager.ts     # Headless PTY backend via node-pty (tmux fallback)
+│   ├── ghostty-session-manager.ts # Ghostty AppleScript backend (macOS, auto-detected)
+│   ├── transcript-reader.ts       # Read Claude Code session JSONL for /status (model, context %, last message)
+│   ├── deep-link.ts               # Generate claude-cli://open?q=... URLs for /link
+│   ├── callback-parser.ts         # Parse Telegram callback_data strings
+│   ├── http-request.ts            # Lightweight HTTPS wrapper (no axios)
+│   ├── optional-require.ts        # Graceful optional dependency loading
+│   └── paths.ts                   # PROJECT_ROOT + CCGRAM_HOME constants
+├── types/                         # TypeScript interfaces
+└── data/                          # Runtime data (session map, history)
+
+workspace-telegram-bot.ts          # Main bot (long-polling, routing, callbacks, /status, /link, /effort, /model)
+workspace-router.ts                # Session map, prefix matching, default workspace, rate limit storage
+prompt-bridge.ts                   # File-based IPC via /tmp/claude-prompts/
+permission-hook.ts                 # Blocking permission approval hook
+permission-denied-notify.ts        # PermissionDenied hook with retry button
+question-notify.ts                 # Blocking AskUserQuestion hook (returns updatedInput to Claude Code)
+enhanced-hook-notify.ts            # Status notifications (Stop, Notification, SessionStart/End, SubagentStop, StopFailure, PostCompact, TaskCreated, CwdChanged, InstructionsLoaded)
+pre-compact-notify.ts              # PreCompact hook with block button
+elicitation-notify.ts              # MCP elicitation hook (schema-aware, per-field)
+user-prompt-hook.ts                # UserPromptSubmit hook — writes terminal activity timestamp
+setup.ts                           # Interactive setup wizard
+cli.ts                             # ccgram CLI entry point
 ```
 
 ### Tests
 
 ```
 test/
-├── prompt-bridge.test.js     # 15 tests — IPC write/read/update/clean/expiry
-├── workspace-router.test.js  # 38 tests — session map, prefix matching, defaults, reply-to, session history
-├── callback-parser.test.js   # 23 tests — all callback_data formats (perm, opt, new, rp, rs, rc)
-└── active-check.test.js      #  8 tests — terminal activity detection, thresholds
+├── prompt-bridge.test.js          # 15 tests — IPC write/read/update/clean/expiry
+├── workspace-router.test.js       # 43 tests — session map, prefix matching, defaults, reply-to, history, rate limits
+├── callback-parser.test.js        # 27 tests — all callback_data formats (perm, opt, new, rp, rs, rc, perm-denied, pre-compact)
+├── active-check.test.js           #  8 tests — terminal activity detection, thresholds
+├── deep-link.test.js              # 11 tests — claude-cli:// URL generation, encoding, character limits
+└── ghostty-session-manager.test.js # 16 tests — Ghostty AppleScript session management (mocked)
 ```
 
 Tests use isolated temp directories and run with `npm test` (vitest, no configuration needed).
@@ -325,18 +350,24 @@ Yes. Each Claude session maps to a named tmux or PTY session. Use `/sessions` to
 Yes. `/resume` reads from Claude Code's own session storage, so it sees every conversation — not just ones started through the bot. If the session is still running in your terminal, you'll get a warning before resuming to prevent conflicts.
 
 **Do I need tmux?**
-No. When tmux is not detected, CCGram automatically falls back to headless PTY sessions powered by [`node-pty`](https://github.com/microsoft/node-pty). No configuration required — it activates on its own.
-
-To use PTY mode:
-1. Install the optional dependency: `npm install node-pty` inside `~/.ccgram/`
-2. PTY activates automatically when `tmux` is not running, or force it explicitly:
-   ```bash
-   # in ~/.ccgram/.env
-   INJECTION_MODE=pty
-   ```
-3. Restart the bot: `launchctl kickstart -k gui/$(id -u)/com.ccgram` (macOS) or `sudo systemctl restart ccgram` (Linux)
-
-Full remote control — permission approvals, question answering, `/new`, `/stop` — works identically in both modes.
+No. CCGram supports three injection backends and picks the right one automatically:
+- **tmux** (default when running) — cross-platform, recommended
+- **Ghostty** — auto-detected on macOS via `TERM_PROGRAM=ghostty`; uses AppleScript for keystroke injection and tab focus
+- **PTY** (`node-pty`) — headless fallback when neither tmux nor Ghostty is available
+
+For question answering specifically (the `AskUserQuestion` hook), CCGram returns answers to Claude Code directly via the `updatedInput` hook output — so it works on **any** terminal, including bare zsh, screen, or anything else, without keystroke injection at all.
+
+To force a specific backend:
+```bash
+# in ~/.ccgram/.env
+INJECTION_MODE=pty   # or tmux
+```
+
+Then restart the bot: `launchctl kickstart -k gui/$(id -u)/com.ccgram` (macOS) or `sudo systemctl restart ccgram` (Linux).
+
+To use PTY mode, install the optional dependency: `npm install node-pty` inside `~/.ccgram/`.
+
+Full remote control — permission approvals, question answering, `/new`, `/stop` — works identically in all modes.
 
 **Is my bot token stored securely?**
 The token is stored in `~/.ccgram/.env`, readable only by your user. It's never logged or transmitted beyond Telegram's API.

package/dist/elicitation-notify.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * Elicitation Notify — Called by Claude Code's Elicitation hook.
+ *
+ * BLOCKING mode: Forwards MCP server input requests to Telegram, polls for
+ * user responses (one per form field), then outputs the answer via stdout.
+ *
+ * Stdin JSON: { mcp_server_name, requested_schema, cwd, session_id, ... }
+ *   requested_schema: JSON Schema object with `properties` describing form fields
+ *
+ * Stdout: {
+ *   hookSpecificOutput: {
+ *     hookEventName: "Elicitation",
+ *     action: "accept" | "decline" | "cancel",
+ *     content: { <fieldName>: <value> }   // required when action === "accept"
+ *   }
+ * }
+ */
+export {};
+//# sourceMappingURL=elicitation-notify.d.ts.map

package/dist/elicitation-notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation-notify.d.ts","sourceRoot":"","sources":["../elicitation-notify.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/elicitation-notify.js

@@ -0,0 +1,241 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Elicitation Notify — Called by Claude Code's Elicitation hook.
+ *
+ * BLOCKING mode: Forwards MCP server input requests to Telegram, polls for
+ * user responses (one per form field), then outputs the answer via stdout.
+ *
+ * Stdin JSON: { mcp_server_name, requested_schema, cwd, session_id, ... }
+ *   requested_schema: JSON Schema object with `properties` describing form fields
+ *
+ * Stdout: {
+ *   hookSpecificOutput: {
+ *     hookEventName: "Elicitation",
+ *     action: "accept" | "decline" | "cancel",
+ *     content: { <fieldName>: <value> }   // required when action === "accept"
+ *   }
+ * }
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const paths_1 = require("./src/utils/paths");
+require('dotenv').config({ path: path_1.default.join(paths_1.PROJECT_ROOT, '.env'), quiet: true });
+const fs_1 = __importDefault(require("fs"));
+const https_1 = __importDefault(require("https"));
+const workspace_router_1 = require("./workspace-router");
+const prompt_bridge_1 = require("./prompt-bridge");
+const active_check_1 = require("./src/utils/active-check");
+const BOT_TOKEN = process.env.TELEGRAM_BOT_TOKEN;
+const CHAT_ID = process.env.TELEGRAM_CHAT_ID;
+// Polling configuration
+const POLL_INTERVAL_MS = 500;
+const POLL_TIMEOUT_MS = 120000; // 2 minutes for user input
+// ── Main ────────────────────────────────────────────────────────
+async function main() {
+    const raw = await readStdin();
+    // Skip Telegram notification if user is at terminal AND this wasn't Telegram-injected
+    const typingActivePath = path_1.default.join(paths_1.PROJECT_ROOT, 'src/data', 'typing-active');
+    const isTelegramInjected = fs_1.default.existsSync(typingActivePath);
+    if (!isTelegramInjected && (0, active_check_1.isUserActiveAtTerminal)()) {
+        return;
+    }
+    let payload;
+    try {
+        payload = JSON.parse(raw);
+    }
+    catch {
+        return;
+    }
+    // Payload uses `mcp_server_name` (newer) — fall back to `mcp_server` for safety
+    const mcpServer = payload.mcp_server_name || payload.mcp_server || 'Unknown MCP';
+    const schema = payload.requested_schema || {};
+    const properties = schema.properties || {};
+    const fieldNames = Object.keys(properties);
+    const cwd = payload.cwd || process.cwd();
+    const workspace = (0, workspace_router_1.extractWorkspaceName)(cwd);
+    // If the schema has no fields, decline — we can't build a meaningful response.
+    if (fieldNames.length === 0) {
+        emitDecline();
+        return;
+    }
+    // Prompt the user one field at a time. Any field that doesn't get an answer
+    // (timeout) cancels the whole elicitation.
+    const content = {};
+    for (let i = 0; i < fieldNames.length; i++) {
+        const fieldName = fieldNames[i];
+        const prop = properties[fieldName];
+        const promptId = (0, prompt_bridge_1.generatePromptId)();
+        let messageText = `\u{1F50C} *MCP Input Required* — ${escapeMarkdown(workspace)}\n\n`;
+        messageText += `*Server:* \`${escapeMarkdown(mcpServer)}\`\n`;
+        if (fieldNames.length > 1) {
+            messageText += `*Field ${i + 1} of ${fieldNames.length}:* \`${escapeMarkdown(fieldName)}\`\n\n`;
+        }
+        else {
+            messageText += `*Field:* \`${escapeMarkdown(fieldName)}\`\n\n`;
+        }
+        if (prop.description) {
+            messageText += `${escapeMarkdown(prop.description)}\n\n`;
+        }
+        if (prop.enum && prop.enum.length > 0) {
+            messageText += `_Allowed values:_ ${prop.enum.map(v => `\`${escapeMarkdown(v)}\``).join(', ')}\n\n`;
+        }
+        messageText += `_Reply to this message with your answer_`;
+        (0, prompt_bridge_1.writePending)(promptId, {
+            type: 'elicitation',
+            workspace,
+            mcpServer,
+            fieldName,
+        });
+        try {
+            const result = await sendTelegram(messageText);
+            if (result && result.message_id) {
+                (0, workspace_router_1.trackNotificationMessage)(result.message_id, workspace, 'elicitation');
+            }
+        }
+        catch (err) {
+            process.stderr.write(`[elicitation-notify] Telegram send failed: ${err.message}\n`);
+            (0, prompt_bridge_1.cleanPrompt)(promptId);
+            emitCancel();
+            return;
+        }
+        const response = await pollForResponse(promptId);
+        (0, prompt_bridge_1.cleanPrompt)(promptId);
+        if (!response || typeof response.textAnswer !== 'string') {
+            // Timeout or missing answer — cancel the whole elicitation
+            emitCancel();
+            return;
+        }
+        content[fieldName] = response.textAnswer;
+    }
+    const output = {
+        hookSpecificOutput: {
+            hookEventName: 'Elicitation',
+            action: 'accept',
+            content,
+        },
+    };
+    process.stdout.write(JSON.stringify(output) + '\n');
+}
+function emitDecline() {
+    const output = {
+        hookSpecificOutput: {
+            hookEventName: 'Elicitation',
+            action: 'decline',
+        },
+    };
+    process.stdout.write(JSON.stringify(output) + '\n');
+}
+function emitCancel() {
+    const output = {
+        hookSpecificOutput: {
+            hookEventName: 'Elicitation',
+            action: 'cancel',
+        },
+    };
+    process.stdout.write(JSON.stringify(output) + '\n');
+}
+// ── Polling ─────────────────────────────────────────────────────
+function pollForResponse(promptId) {
+    return new Promise((resolve) => {
+        const responseFile = path_1.default.join(prompt_bridge_1.PROMPTS_DIR, `response-${promptId}.json`);
+        const startTime = Date.now();
+        const interval = setInterval(() => {
+            if (Date.now() - startTime > POLL_TIMEOUT_MS) {
+                clearInterval(interval);
+                process.stderr.write(`[elicitation-notify] Timed out waiting for response\n`);
+                resolve(null);
+                return;
+            }
+            try {
+                if (fs_1.default.existsSync(responseFile)) {
+                    const raw = fs_1.default.readFileSync(responseFile, 'utf8');
+                    const data = JSON.parse(raw);
+                    clearInterval(interval);
+                    resolve(data);
+                }
+            }
+            catch {
+                // File not ready yet or parse error — keep polling
+            }
+        }, POLL_INTERVAL_MS);
+    });
+}
+// ── Telegram ────────────────────────────────────────────────────
+function sendTelegram(text) {
+    return new Promise((resolve, reject) => {
+        const body = JSON.stringify({
+            chat_id: CHAT_ID,
+            text,
+            parse_mode: 'Markdown',
+        });
+        const options = {
+            hostname: 'api.telegram.org',
+            path: `/bot${BOT_TOKEN}/sendMessage`,
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(body),
+            },
+            timeout: 5000,
+        };
+        const req = https_1.default.request(options, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => {
+                if (res.statusCode >= 200 && res.statusCode < 300) {
+                    try {
+                        const parsed = JSON.parse(data);
+                        resolve(parsed.result || null);
+                    }
+                    catch {
+                        resolve(null);
+                    }
+                }
+                else {
+                    reject(new Error(`Telegram API ${res.statusCode}: ${data}`));
+                }
+            });
+        });
+        req.on('error', reject);
+        req.on('timeout', () => {
+            req.destroy();
+            reject(new Error('Telegram request timed out'));
+        });
+        req.write(body);
+        req.end();
+    });
+}
+// ── Helpers ──────────────────────────────────────────────────────
+function readStdin() {
+    return new Promise((resolve) => {
+        let data = '';
+        let resolved = false;
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => { data += chunk; });
+        process.stdin.on('end', () => {
+            if (!resolved) {
+                resolved = true;
+                resolve(data);
+            }
+        });
+        setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                process.stdin.destroy();
+                resolve(data || '{}');
+            }
+        }, 500);
+    });
+}
+function escapeMarkdown(text) {
+    return text.replace(/([_*`\[])/g, '\\$1');
+}
+// ── Run ─────────────────────────────────────────────────────────
+main().catch((err) => {
+    process.stderr.write(`[elicitation-notify] Fatal: ${err.message}\n`);
+});
+//# sourceMappingURL=elicitation-notify.js.map

package/dist/elicitation-notify.js.map

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

package/dist/enhanced-hook-notify.d.ts

@@ -3,7 +3,9 @@
  * Enhanced Hook Notifier — called by Claude Code hooks.
  *
  * Handles: Stop (completed), Notification (waiting), SessionStart,
- *          SessionEnd, SubagentStop (subagent-done).
+ *          SessionEnd, SubagentStop (subagent-done), StopFailure (stop-failure),
+ *          PostCompact (post-compact), TaskCreated (task-created),
+ *          CwdChanged (cwd-changed), InstructionsLoaded (instructions-loaded).
  *
  * Usage (in ~/.claude/settings.json hooks):
  *   node /path/to/ccgram/dist/enhanced-hook-notify.js completed
@@ -11,6 +13,11 @@
  *   node /path/to/ccgram/dist/enhanced-hook-notify.js session-start
  *   node /path/to/ccgram/dist/enhanced-hook-notify.js session-end
  *   node /path/to/ccgram/dist/enhanced-hook-notify.js subagent-done
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js stop-failure
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js post-compact
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js task-created
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js cwd-changed
+ *   node /path/to/ccgram/dist/enhanced-hook-notify.js instructions-loaded
  */
 export {};
 //# sourceMappingURL=enhanced-hook-notify.d.ts.map

package/dist/enhanced-hook-notify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enhanced-hook-notify.d.ts","sourceRoot":"","sources":["../enhanced-hook-notify.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG"}
+{"version":3,"file":"enhanced-hook-notify.d.ts","sourceRoot":"","sources":["../enhanced-hook-notify.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;GAmBG"}