@gramatr/mcp 0.7.21 → 0.8.1

package/dist/setup/examples/gramatr-opencode-plugin.js

@@ -0,0 +1,129 @@
+/**
+ * gramatr OpenCode Plugin Scaffold
+ *
+ * Maps OpenCode's plugin lifecycle events to gramatr hook logic.
+ * OpenCode uses a plugin-based architecture instead of hooks.json files.
+ *
+ * Install: Place this file in your OpenCode plugins directory or reference
+ * it in your opencode.json config.
+ *
+ * This is a scaffold with TODO comments — not a full implementation.
+ * Each event handler shows which gramatr hook logic to invoke.
+ */
+/**
+ * gramatr plugin for OpenCode.
+ *
+ * Event mapping:
+ *   session.created      -> gramatr session-start (restore session context + handoff)
+ *   tool.execute.before  -> gramatr agent-gate + input-validator (pre-tool checks)
+ *   tool.execute.after   -> gramatr tool-tracker (post-tool telemetry)
+ *   session.idle          -> gramatr stop (classification feedback on idle)
+ *   session.updated      -> gramatr session-end (persist session state)
+ */
+const gramatrPlugin = {
+    name: 'gramatr',
+    version: '0.1.0',
+    description: 'gramatr intelligence layer for OpenCode — session, routing, and tool lifecycle',
+    /**
+     * session.created — Initialize gramatr session context.
+     *
+     * Equivalent to the SessionStart hook in Claude Code / Codex / Gemini.
+     * Calls gramatr_session_start to restore session context and load handoff.
+     */
+    'session.created': async (ctx) => {
+        // TODO: Call gramatr session-start hook logic
+        // - Load or create a gramatr session for ctx.sessionId
+        // - Restore handoff state from previous sessions
+        // - Inject the v2 intelligence packet into the session context
+        //
+        // Example using the gramatr binary:
+        //   execSync(`~/.gramatr/bin/gramatr hook session-start --opencode`, {
+        //     env: { ...process.env, GRAMATR_SESSION_ID: ctx.sessionId },
+        //   });
+        void ctx;
+    },
+    /**
+     * tool.execute.before — Pre-tool validation gate.
+     *
+     * Equivalent to PreToolUse hooks (agent-gate, input-validator) in Claude Code.
+     * Validates tool inputs and enforces safety constraints before execution.
+     */
+    'tool.execute.before': async (ctx, tool) => {
+        // TODO: Call gramatr agent-gate logic
+        // - Check if the tool call is allowed by hard_gates
+        // - Validate tool inputs against schema constraints
+        //
+        // TODO: Call gramatr input-validator logic
+        // - Sanitize inputs (strip secrets, validate paths)
+        // - Enforce user isolation rules
+        //
+        // Example:
+        //   const result = execSync(
+        //     `~/.gramatr/bin/gramatr hook input-validator --opencode`,
+        //     { input: JSON.stringify({ tool_name: tool.name, tool_input: tool.input }) },
+        //   );
+        //   const validated = JSON.parse(result.toString());
+        //   if (validated.blocked) throw new Error(validated.reason);
+        void ctx;
+        return tool;
+    },
+    /**
+     * tool.execute.after — Post-tool telemetry tracking.
+     *
+     * Equivalent to PostToolUse (tool-tracker) in Claude Code.
+     * Records tool execution metadata for the intelligence flywheel.
+     */
+    'tool.execute.after': async (ctx, tool) => {
+        // TODO: Call gramatr tool-tracker logic
+        // - Record tool name, execution time, result summary
+        // - Feed execution data into the pattern learner
+        // - Update session state with tool usage
+        //
+        // Example:
+        //   execSync(`~/.gramatr/bin/gramatr hook tool-tracker --opencode`, {
+        //     input: JSON.stringify({
+        //       tool_name: tool.name,
+        //       tool_input: tool.input,
+        //       tool_output: tool.output,
+        //     }),
+        //   });
+        void ctx;
+        void tool;
+    },
+    /**
+     * session.idle — Submit classification feedback on idle.
+     *
+     * Equivalent to the Stop hook in Claude Code / Codex.
+     * Submits classification feedback to train the classifier flywheel.
+     */
+    'session.idle': async (ctx) => {
+        // TODO: Call gramatr stop hook logic
+        // - Submit gramatr_classification_feedback for the current session
+        // - Evaluate if effort, intent, and skills were classified correctly
+        //
+        // Example:
+        //   execSync(`~/.gramatr/bin/gramatr hook stop --opencode`, {
+        //     env: { ...process.env, GRAMATR_SESSION_ID: ctx.sessionId },
+        //   });
+        void ctx;
+    },
+    /**
+     * session.updated — Persist session state on update.
+     *
+     * Equivalent to SessionEnd hook in Claude Code.
+     * Saves session state and handoff for continuity across sessions.
+     */
+    'session.updated': async (ctx) => {
+        // TODO: Call gramatr session-end hook logic
+        // - Persist current session state
+        // - Save handoff summary for next session resumption
+        //
+        // Example:
+        //   execSync(`~/.gramatr/bin/gramatr hook session-end --opencode`, {
+        //     env: { ...process.env, GRAMATR_SESSION_ID: ctx.sessionId },
+        //   });
+        void ctx;
+    },
+};
+export default gramatrPlugin;
+//# sourceMappingURL=gramatr-opencode-plugin.js.map

package/dist/setup/examples/gramatr-opencode-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gramatr-opencode-plugin.js","sourceRoot":"","sources":["../../../src/setup/examples/gramatr-opencode-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA6BH;;;;;;;;;GASG;AACH,MAAM,aAAa,GAAmB;IACpC,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,gFAAgF;IAE7F;;;;;OAKG;IACH,iBAAiB,EAAE,KAAK,EAAE,GAA0B,EAAiB,EAAE;QACrE,8CAA8C;QAC9C,uDAAuD;QACvD,iDAAiD;QACjD,+DAA+D;QAC/D,EAAE;QACF,oCAAoC;QACpC,uEAAuE;QACvE,kEAAkE;QAClE,QAAQ;QACR,KAAK,GAAG,CAAC;IACX,CAAC;IAED;;;;;OAKG;IACH,qBAAqB,EAAE,KAAK,EAC1B,GAA0B,EAC1B,IAAsB,EACK,EAAE;QAC7B,sCAAsC;QACtC,oDAAoD;QACpD,oDAAoD;QACpD,EAAE;QACF,2CAA2C;QAC3C,oDAAoD;QACpD,iCAAiC;QACjC,EAAE;QACF,WAAW;QACX,6BAA6B;QAC7B,gEAAgE;QAChE,mFAAmF;QACnF,OAAO;QACP,qDAAqD;QACrD,8DAA8D;QAC9D,KAAK,GAAG,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,oBAAoB,EAAE,KAAK,EAAE,GAA0B,EAAE,IAAsB,EAAiB,EAAE;QAChG,wCAAwC;QACxC,qDAAqD;QACrD,iDAAiD;QACjD,yCAAyC;QACzC,EAAE;QACF,WAAW;QACX,sEAAsE;QACtE,8BAA8B;QAC9B,8BAA8B;QAC9B,gCAAgC;QAChC,kCAAkC;QAClC,UAAU;QACV,QAAQ;QACR,KAAK,GAAG,CAAC;QACT,KAAK,IAAI,CAAC;IACZ,CAAC;IAED;;;;;OAKG;IACH,cAAc,EAAE,KAAK,EAAE,GAA0B,EAAiB,EAAE;QAClE,qCAAqC;QACrC,mEAAmE;QACnE,qEAAqE;QACrE,EAAE;QACF,WAAW;QACX,8DAA8D;QAC9D,kEAAkE;QAClE,QAAQ;QACR,KAAK,GAAG,CAAC;IACX,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,EAAE,KAAK,EAAE,GAA0B,EAAiB,EAAE;QACrE,4CAA4C;QAC5C,kCAAkC;QAClC,qDAAqD;QACrD,EAAE;QACF,WAAW;QACX,qEAAqE;QACrE,kEAAkE;QAClE,QAAQ;QACR,KAAK,GAAG,CAAC;IACX,CAAC;CACF,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/setup/generated/platform-hooks.d.ts

@@ -0,0 +1,64 @@
+/**
+ * AUTO-GENERATED — do not edit manually.
+ * Source: contracts/platforms/*.yaml
+ * Generator: contracts/generator/generate.ts
+ * Generated: 2026-04-15T04:10:43.912Z
+ */
+export interface PlatformHookEntry {
+    hook: string;
+    matcher?: string;
+    name?: string;
+    statusMessage?: string;
+    timeout?: number;
+    description?: string;
+}
+export interface PlatformMcpServer {
+    command: string;
+    timeout?: number;
+    env?: Record<string, string>;
+}
+export interface PlatformConfig {
+    name: string;
+    display_name: string;
+    description: string;
+    client_flag: string;
+    config_file: string;
+    hooks: Record<string, PlatformHookEntry[]>;
+    mcp_server: PlatformMcpServer;
+    instruction_blocks: string[];
+}
+/** ChatGPT Approved Add-on — ChatGPT official plugin/add-on — sandbox environment, OAuth auth, OpenAPI manifest */
+export declare const CHATGPT_ADDON_HOOKS: PlatformConfig;
+/** ChatGPT Desktop — ChatGPT Desktop app integration via MCP server config (hookless) */
+export declare const CHATGPT_DESKTOP_HOOKS: PlatformConfig;
+/** ChatGPT Custom GPT — ChatGPT Custom GPT instructions — ~8000 char budget, MCP pre-wired at GPT level, shareable link */
+export declare const CHATGPT_GPT_HOOKS: PlatformConfig;
+/** ChatGPT Project — ChatGPT Project instructions — 5000 char budget, MCP connected at project level */
+export declare const CHATGPT_PROJECT_HOOKS: PlatformConfig;
+/** ChatGPT Web — ChatGPT Web (chat.openai.com) integration via MCP — hookless, paste into personal prompt or custom GPT */
+export declare const CHATGPT_WEB_HOOKS: PlatformConfig;
+/** Claude Add-on — Claude.ai official MCP add-on — Anthropic partner program, sandbox environment */
+export declare const CLAUDE_ADDON_HOOKS: PlatformConfig;
+/** Claude Code — Claude Code CLI integration with full hook lifecycle */
+export declare const CLAUDE_CODE_HOOKS: PlatformConfig;
+/** Claude Desktop — Claude Desktop app integration via MCP server config (hookless) */
+export declare const CLAUDE_DESKTOP_HOOKS: PlatformConfig;
+/** Claude Project — Claude.ai Project instructions — larger budget than personal, MCP connected at project level */
+export declare const CLAUDE_PROJECT_HOOKS: PlatformConfig;
+/** Claude Web — Claude Web (claude.ai) integration via MCP — hookless, paste instructions into personal prompt */
+export declare const CLAUDE_WEB_HOOKS: PlatformConfig;
+/** Codex — OpenAI Codex CLI integration with session and prompt hooks */
+export declare const CODEX_HOOKS: PlatformConfig;
+/** Cursor — Cursor IDE integration via MCP server config (hookless, uses route_request) */
+export declare const CURSOR_HOOKS: PlatformConfig;
+/** Gemini CLI — Gemini CLI integration via extension manifest and hooks */
+export declare const GEMINI_CLI_HOOKS: PlatformConfig;
+/** OpenCode — OpenCode plugin-based integration (no hooks file, uses plugin architecture) */
+export declare const OPENCODE_HOOKS: PlatformConfig;
+/** VS Code — VS Code integration with Copilot/Continue via MCP server config (hookless) */
+export declare const VSCODE_HOOKS: PlatformConfig;
+/** Windsurf — Windsurf IDE integration via MCP server config (hookless) */
+export declare const WINDSURF_HOOKS: PlatformConfig;
+/** All platform configs keyed by platform name */
+export declare const PLATFORM_HOOKS: Record<string, PlatformConfig>;
+//# sourceMappingURL=platform-hooks.d.ts.map

package/dist/setup/generated/platform-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-hooks.d.ts","sourceRoot":"","sources":["../../../src/setup/generated/platform-hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC3C,UAAU,EAAE,iBAAiB,CAAC;IAC9B,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,mHAAmH;AACnH,eAAO,MAAM,mBAAmB,EAAE,cAwBxB,CAAC;AAEX,yFAAyF;AACzF,eAAO,MAAM,qBAAqB,EAAE,cAsB1B,CAAC;AAEX,2HAA2H;AAC3H,eAAO,MAAM,iBAAiB,EAAE,cAuBtB,CAAC;AAEX,wGAAwG;AACxG,eAAO,MAAM,qBAAqB,EAAE,cAsB1B,CAAC;AAEX,2HAA2H;AAC3H,eAAO,MAAM,iBAAiB,EAAE,cAkBtB,CAAC;AAEX,qGAAqG;AACrG,eAAO,MAAM,kBAAkB,EAAE,cAwBvB,CAAC;AAEX,yEAAyE;AACzE,eAAO,MAAM,iBAAiB,EAAE,cA4FtB,CAAC;AAEX,uFAAuF;AACvF,eAAO,MAAM,oBAAoB,EAAE,cAsBzB,CAAC;AAEX,oHAAoH;AACpH,eAAO,MAAM,oBAAoB,EAAE,cAuBzB,CAAC;AAEX,kHAAkH;AAClH,eAAO,MAAM,gBAAgB,EAAE,cAsBrB,CAAC;AAEX,yEAAyE;AACzE,eAAO,MAAM,WAAW,EAAE,cA2ChB,CAAC;AAEX,2FAA2F;AAC3F,eAAO,MAAM,YAAY,EAAE,cAsBjB,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,EAAE,cA8CrB,CAAC;AAEX,6FAA6F;AAC7F,eAAO,MAAM,cAAc,EAAE,cAqBnB,CAAC;AAEX,2FAA2F;AAC3F,eAAO,MAAM,YAAY,EAAE,cAsBjB,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,cAAc,EAAE,cAsBnB,CAAC;AAEX,kDAAkD;AAClD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAiBhD,CAAC"}