@zeph-to/hook-sdk 1.0.0 → 1.1.0

package/dist/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AA0IA,eAAO,MAAM,aAAa,GAAU,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAgH1F,CAAC"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAyNA,eAAO,MAAM,aAAa,GAAU,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAmH1F,CAAC"}

package/dist/installer.js

@@ -7,6 +7,7 @@ const path_1 = require("path");
 const readline_1 = require("readline");
 const zeph_hook_js_1 = require("./zeph-hook.js");
 const config_js_1 = require("./config.js");
+const templates_js_1 = require("./templates.js");
 const HOME = process.env.HOME ?? '~';
 // ── Helpers ──────────────────────────────────────────────────────
 const ok = (msg) => console.log(`    + ${msg}`);
@@ -29,12 +30,28 @@ const hasCommand = (cmd) => {
         return false;
     }
 };
+const writeFile = (filePath, content) => {
+    (0, fs_1.mkdirSync)((0, path_1.dirname)(filePath), { recursive: true });
+    (0, fs_1.writeFileSync)(filePath, content + '\n');
+};
+const mergeJsonFile = (filePath, patch) => {
+    let data = {};
+    try {
+        data = JSON.parse((0, fs_1.readFileSync)(filePath, 'utf-8'));
+    }
+    catch { /* new file */ }
+    const merged = { ...data, ...patch };
+    writeFile(filePath, JSON.stringify(merged, null, 2));
+};
 // ── Agent Detection ──────────────────────────────────────────────
 const detectAgents = () => [
     { name: 'Claude Code', id: 'claude', detected: hasCommand('claude') },
     { name: 'Cursor', id: 'cursor', detected: (0, fs_1.existsSync)((0, path_1.join)(HOME, '.cursor')) },
     { name: 'Windsurf', id: 'windsurf', detected: (0, fs_1.existsSync)((0, path_1.join)(HOME, '.codeium')) },
     { name: 'Gemini CLI', id: 'gemini', detected: hasCommand('gemini') },
+    { name: 'Codex CLI', id: 'codex', detected: hasCommand('codex') },
+    { name: 'Copilot CLI', id: 'copilot', detected: (0, fs_1.existsSync)((0, path_1.join)(HOME, '.copilot')) },
+    { name: 'Cline', id: 'cline', detected: (0, fs_1.existsSync)((0, path_1.join)(HOME, '.cline')) },
 ];
 // ── Per-Agent Installers ─────────────────────────────────────────
 const injectMcpJson = (filePath) => {
@@ -54,33 +71,54 @@ const injectMcpJson = (filePath) => {
 };
 const installClaude = () => {
     try {
-        (0, child_process_1.execSync)('claude plugin marketplace add zeph-to/plugin', { stdio: 'pipe' });
+        (0, child_process_1.execSync)('claude plugin marketplace add zeph-to/agent-plugin', { stdio: 'pipe' });
         (0, child_process_1.execSync)('claude plugin install zeph@zeph', { stdio: 'pipe' });
         ok('Plugin installed');
     }
     catch {
         fail('Plugin install failed. Manual:');
-        console.log('      claude plugin marketplace add zeph-to/plugin');
+        console.log('      claude plugin marketplace add zeph-to/agent-plugin');
         console.log('      claude plugin install zeph@zeph');
     }
 };
 const installCursor = () => {
     try {
         injectMcpJson((0, path_1.join)(HOME, '.cursor', 'mcp.json'));
-        ok('MCP server added to ~/.cursor/mcp.json');
+        ok('MCP server added');
     }
     catch {
         fail('MCP injection failed. Manual: add zeph to ~/.cursor/mcp.json');
     }
+    try {
+        writeFile((0, path_1.join)(HOME, '.cursor', 'hooks.json'), templates_js_1.CURSOR_HOOKS);
+        ok('Stop hook added');
+    }
+    catch {
+        fail('Hook install failed');
+    }
+    try {
+        writeFile((0, path_1.join)(HOME, '.cursor', 'rules', 'zeph.mdc'), templates_js_1.CURSOR_RULE);
+        ok('Rule file added');
+    }
+    catch {
+        fail('Rule install failed');
+    }
 };
 const installWindsurf = () => {
     try {
         injectMcpJson((0, path_1.join)(HOME, '.codeium', 'windsurf', 'mcp_config.json'));
-        ok('MCP server added to ~/.codeium/windsurf/mcp_config.json');
+        ok('MCP server added');
     }
     catch {
         fail('MCP injection failed. Manual: add zeph to windsurf mcp_config.json');
     }
+    try {
+        writeFile((0, path_1.join)(HOME, '.codeium', 'windsurf', 'hooks.json'), templates_js_1.WINDSURF_HOOKS);
+        ok('Response hook added');
+    }
+    catch {
+        fail('Hook install failed');
+    }
 };
 const installGemini = () => {
     try {
@@ -90,12 +128,49 @@ const installGemini = () => {
     catch {
         fail('MCP add failed. Manual: gemini mcp add zeph -- npx -y @zeph-to/mcp-server');
     }
+    try {
+        mergeJsonFile((0, path_1.join)(HOME, '.gemini', 'settings.json'), templates_js_1.GEMINI_HOOKS);
+        ok('AfterAgent hook added');
+    }
+    catch {
+        fail('Hook install failed');
+    }
+};
+const installCodex = () => {
+    try {
+        writeFile((0, path_1.join)(HOME, '.codex', 'hooks.json'), templates_js_1.CODEX_HOOKS);
+        ok('Stop hook added');
+    }
+    catch {
+        fail('Hook install failed. Manual: add zeph to ~/.codex/hooks.json');
+    }
+};
+const installCopilot = () => {
+    try {
+        writeFile((0, path_1.join)(HOME, '.copilot', 'hooks', 'zeph.json'), templates_js_1.COPILOT_HOOKS);
+        ok('Session end hook added');
+    }
+    catch {
+        fail('Hook install failed. Manual: add zeph to ~/.copilot/hooks/');
+    }
+};
+const installCline = () => {
+    try {
+        writeFile((0, path_1.join)(HOME, '.cline', 'rules', 'zeph.md'), templates_js_1.CLINE_RULE);
+        ok('Rule file added');
+    }
+    catch {
+        fail('Rule install failed. Manual: add zeph to ~/.cline/rules/');
+    }
 };
 const AGENT_INSTALLERS = {
     claude: installClaude,
     cursor: installCursor,
     windsurf: installWindsurf,
     gemini: installGemini,
+    codex: installCodex,
+    copilot: installCopilot,
+    cline: installCline,
 };
 // ── Test Connection ──────────────────────────────────────────────
 const testConnection = async (apiKey, baseUrl) => {
@@ -175,9 +250,12 @@ const handleInstall = async (args) => {
         for (const agent of detected) {
             const labels = {
                 claude: 'Install Claude Code plugin',
-                cursor: 'Add MCP server to ~/.cursor/mcp.json',
-                windsurf: 'Add MCP server to windsurf mcp_config.json',
-                gemini: 'Add MCP server to Gemini CLI',
+                cursor: 'Setup Cursor (MCP + hooks + rules)',
+                windsurf: 'Setup Windsurf (MCP + hooks)',
+                gemini: 'Setup Gemini CLI (MCP + hooks)',
+                codex: 'Setup Codex CLI (hooks)',
+                copilot: 'Setup Copilot CLI (hooks)',
+                cline: 'Setup Cline (rules)',
             };
             console.log(`    ${step}. ${labels[agent.id] ?? `Install for ${agent.name}`}`);
             step++;

package/dist/templates.d.ts

@@ -0,0 +1,23 @@
+export declare const CURSOR_HOOKS: string;
+export declare const CURSOR_RULE = "---\ndescription: \"Zeph notification rules\"\nalwaysApply: true\n---\n\nWhen you complete a coding task, call the zeph_notify MCP tool with a brief summary.\nUse zeph_prompt for user decisions (2-4 options). Use zeph_input for free-form text.\nDo not notify for trivial operations (file reads, simple searches).\n";
+export declare const WINDSURF_HOOKS: string;
+export declare const WINDSURF_RULE = "When you complete a coding task, call the zeph_notify MCP tool with a brief summary.\nUse zeph_prompt for user decisions (2-4 options). Use zeph_input for free-form text.\nDo not notify for trivial operations (file reads, simple searches).\n";
+export declare const GEMINI_HOOKS: {
+    hooks: {
+        AfterAgent: {
+            matcher: string;
+            hooks: {
+                name: string;
+                type: string;
+                command: string;
+            }[];
+        }[];
+    };
+    hooksConfig: {
+        enabled: boolean;
+    };
+};
+export declare const CODEX_HOOKS: string;
+export declare const COPILOT_HOOKS: string;
+export declare const CLINE_RULE = "When you complete a coding task, call the zeph_notify MCP tool with a brief summary.\nUse zeph_prompt for user decisions (2-4 options). Use zeph_input for free-form text.\nDo not notify for trivial operations (file reads, simple searches).\n";
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,YAAY,QAOd,CAAC;AAEZ,eAAO,MAAM,WAAW,+TAQvB,CAAC;AAIF,eAAO,MAAM,cAAc,QAOhB,CAAC;AAEZ,eAAO,MAAM,aAAa,sPAGzB,CAAC;AAIF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAYxB,CAAC;AAIF,eAAO,MAAM,WAAW,QAQb,CAAC;AAIZ,eAAO,MAAM,aAAa,QASf,CAAC;AAIZ,eAAO,MAAM,UAAU,sPAGtB,CAAC"}

package/dist/templates.js

@@ -0,0 +1,76 @@
+"use strict";
+// ── Hook & Rule templates for each agent ─────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLINE_RULE = exports.COPILOT_HOOKS = exports.CODEX_HOOKS = exports.GEMINI_HOOKS = exports.WINDSURF_RULE = exports.WINDSURF_HOOKS = exports.CURSOR_RULE = exports.CURSOR_HOOKS = void 0;
+const NOTIFY_CMD = 'npx @zeph-to/hook-sdk notify --title "Task done" 2>/dev/null || true';
+// ── Cursor ───────────────────────────────────────────────────────
+exports.CURSOR_HOOKS = JSON.stringify({
+    version: 1,
+    hooks: {
+        stop: [{
+                command: NOTIFY_CMD,
+            }],
+    },
+}, null, 2);
+exports.CURSOR_RULE = `---
+description: "Zeph notification rules"
+alwaysApply: true
+---
+
+When you complete a coding task, call the zeph_notify MCP tool with a brief summary.
+Use zeph_prompt for user decisions (2-4 options). Use zeph_input for free-form text.
+Do not notify for trivial operations (file reads, simple searches).
+`;
+// ── Windsurf ─────────────────────────────────────────────────────
+exports.WINDSURF_HOOKS = JSON.stringify({
+    hooks: {
+        post_cascade_response: [{
+                command: NOTIFY_CMD,
+                show_output: false,
+            }],
+    },
+}, null, 2);
+exports.WINDSURF_RULE = `When you complete a coding task, call the zeph_notify MCP tool with a brief summary.
+Use zeph_prompt for user decisions (2-4 options). Use zeph_input for free-form text.
+Do not notify for trivial operations (file reads, simple searches).
+`;
+// ── Gemini ───────────────────────────────────────────────────────
+exports.GEMINI_HOOKS = {
+    hooks: {
+        AfterAgent: [{
+                matcher: '*',
+                hooks: [{
+                        name: 'zeph-notify',
+                        type: 'command',
+                        command: NOTIFY_CMD,
+                    }],
+            }],
+    },
+    hooksConfig: { enabled: true },
+};
+// ── Codex ────────────────────────────────────────────────────────
+exports.CODEX_HOOKS = JSON.stringify({
+    version: 1,
+    hooks: {
+        Stop: [{
+                type: 'command',
+                bash: NOTIFY_CMD,
+            }],
+    },
+}, null, 2);
+// ── Copilot ──────────────────────────────────────────────────────
+exports.COPILOT_HOOKS = JSON.stringify({
+    version: 1,
+    hooks: {
+        sessionEnd: [{
+                type: 'command',
+                bash: NOTIFY_CMD,
+                timeoutSec: 10,
+            }],
+    },
+}, null, 2);
+// ── Cline ────────────────────────────────────────────────────────
+exports.CLINE_RULE = `When you complete a coding task, call the zeph_notify MCP tool with a brief summary.
+Use zeph_prompt for user decisions (2-4 options). Use zeph_input for free-form text.
+Do not notify for trivial operations (file reads, simple searches).
+`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeph-to/hook-sdk",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Zeph push notification SDK + CLI — zero dependencies",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",