@gramatr/mcp 0.20.13 → 0.20.16

package/README.md

@@ -1,5 +1,24 @@
 # @gramatr/mcp
 
+> ## ⚠️ Deprecated
+>
+> **This package is no longer the recommended way to use grāmatr.**
+>
+> Install the Claude Code plugin instead:
+>
+> ```
+> /plugin marketplace add gramatr/claude-plugin
+> /plugin install gramatr@gramatr-claude-plugin
+> ```
+>
+> The plugin handles OAuth automatically through Claude Code's connector
+> flow — no manual setup, no local installer side-effects.
+>
+> Codex and Gemini integrations are paused while those clients lack
+> HTTPS+OAuth MCP support. We'll revisit when they're ready.
+>
+> See: https://github.com/gramatr/gramatr/issues/2750
+
 Intelligence middleware for AI agents by [gramatr](https://gramatr.com).
 
 Pre-classifies every request, injects relevant memory and behavioral context,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gramatr/mcp",
-  "version": "0.20.13",
-  "description": "grāmatr — Intelligence middleware for AI agents. Pre-classifies every request, injects relevant memory and behavioral context, enforces data quality, and maintains session continuity across Claude, ChatGPT, Codex, Cursor, Gemini, and any MCP-compatible client.",
+  "version": "0.20.16",
+  "description": "DEPRECATED — install the Claude Code plugin at gramatr/claude-plugin instead. This npm package no longer ships a CLI; Codex and Gemini integrations are paused pending HTTPS+OAuth MCP support.",
   "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {
     "access": "public"
@@ -35,13 +35,9 @@
     "node": ">=22"
   },
   "type": "module",
-  "bin": {
-    "gramatr": "dist/bin/gramatr-mcp.js"
-  },
   "main": "dist/server/server.js",
   "exports": {
     ".": "./dist/server/server.js",
-    "./bin": "./dist/bin/gramatr-mcp.js",
     "./types": "./dist/types/generated/rest-api-types.js"
   },
   "files": [
@@ -49,11 +45,6 @@
     "dist/**/*.d.ts",
     "dist/**/*.d.ts.map",
     "dist/**/*.js.map",
-    "scripts/postinstall.mjs",
-    "scripts/hook-userpromptsubmit.sh",
-    "scripts/hook-sessionend.sh",
-    "scripts/hook-sessionstart.sh",
-    "scripts/hook-stop.sh",
     "LICENSE"
   ],
   "dependencies": {
@@ -70,7 +61,6 @@
     "vitest": "^4.0.18"
   },
   "scripts": {
-    "postinstall": "node scripts/postinstall.mjs",
     "build": "tsc --build && node ./scripts/build-marketplace.mjs",
     "build:binary": "node ./scripts/build-binary.mjs",
     "build:marketplace": "node ./scripts/build-marketplace.mjs",

package/scripts/hook-sessionend.sh

@@ -1,14 +0,0 @@
-#!/bin/sh
-# gramatr SessionEnd hook — fire-and-forget session_end.
-# Reads {"session_id":...} on stdin. Hard 2s timeout. Silent fail. Exit 0 always.
-set -u
-INPUT=$(cat 2>/dev/null) || exit 0
-SID=$(printf '%s' "$INPUT" | jq -r '.session_id // empty' 2>/dev/null) || exit 0
-[ -z "$SID" ] && exit 0
-TOKEN=$(jq -r '.mcpServers.gramatr.headers.Authorization // empty' "$HOME/.claude.json" 2>/dev/null) || exit 0
-[ -z "$TOKEN" ] && exit 0
-API_URL="${GRAMATR_API_URL:-https://api.gramatr.com}/api/v1/session/end"
-curl -sS --max-time 2 -o /dev/null -X POST "$API_URL" \
-  -H "Authorization: $TOKEN" -H "Content-Type: application/json" \
-  -d "$(printf '{"session_id":"%s"}' "$SID")" >/dev/null 2>&1 || true
-exit 0

package/scripts/hook-sessionstart.sh

@@ -1,21 +0,0 @@
-#!/bin/sh
-# gramatr SessionStart hook — auto session_start + handoff injection (issue #2475).
-# Reads SessionStart JSON on stdin, collects cwd + git remote, POSTs to
-# /api/v1/session/start, emits <gramatr-handoff> block on stdout. Silent no-op
-# on any failure. Hard 2s timeout. Mirrors hook-userpromptsubmit.sh shape.
-set -u
-INPUT=$(cat 2>/dev/null) || INPUT='{}'
-TOKEN=$(jq -r '.mcpServers.gramatr.headers.Authorization // empty' "$HOME/.claude.json" 2>/dev/null) || exit 0
-[ -z "$TOKEN" ] && exit 0
-CWD=$(pwd 2>/dev/null) || CWD=""
-GIT_REMOTE=$(git config --get remote.origin.url 2>/dev/null) || GIT_REMOTE=""
-PROJECT_ID=$(printf '%s' "$INPUT" | jq -r '.project_id // .cwd // empty' 2>/dev/null) || PROJECT_ID=""
-SESSION_ID=$(printf '%s' "$INPUT" | jq -r '.session_id // empty' 2>/dev/null) || SESSION_ID=""
-API_URL="${GRAMATR_API_URL:-https://api.gramatr.com}/api/v1/session/start"
-BODY=$(jq -nc --arg pid "$PROJECT_ID" --arg cwd "$CWD" --arg gr "$GIT_REMOTE" --arg sid "$SESSION_ID" \
-  '{project_id: $pid, cwd: $cwd, git_remote: $gr, session_id: $sid} | with_entries(select(.value != ""))' 2>/dev/null) || exit 0
-RESPONSE=$(curl -sS --max-time 2 -X POST "$API_URL" -H "Authorization: $TOKEN" -H "Content-Type: application/json" -d "$BODY" 2>/dev/null) || exit 0
-[ -z "$RESPONSE" ] && exit 0
-printf '%s' "$RESPONSE" | jq -e '.schema == "gmtr.session.start.v1" and (.last_handoff != null)' >/dev/null 2>&1 || exit 0
-printf '<gramatr-handoff>\n%s\n</gramatr-handoff>\n' "$(printf '%s' "$RESPONSE" | jq -c .last_handoff)"
-exit 0

package/scripts/hook-stop.sh

@@ -1,17 +0,0 @@
-#!/bin/sh
-# gramatr Stop hook — fire-and-forget auto classification feedback (#2476).
-# Reads {"session_id":..., "interaction_id":...?} on stdin. Hard 2s timeout. Silent fail. Exit 0 always.
-set -u
-INPUT=$(cat 2>/dev/null) || exit 0
-SID=$(printf '%s' "$INPUT" | jq -r '.session_id // empty' 2>/dev/null) || exit 0
-[ -z "$SID" ] && exit 0
-IID=$(printf '%s' "$INPUT" | jq -r '.interaction_id // empty' 2>/dev/null) || IID=""
-TOKEN=$(jq -r '.mcpServers.gramatr.headers.Authorization // empty' "$HOME/.claude.json" 2>/dev/null) || exit 0
-[ -z "$TOKEN" ] && exit 0
-API_URL="${GRAMATR_API_URL:-https://api.gramatr.com}/api/v1/classification/feedback/auto"
-BODY=$(printf '%s' "$INPUT" | jq -c --arg sid "$SID" --arg iid "$IID" \
-  '{session_id:$sid, interaction_id:(if $iid=="" then null else $iid end), client_type:"claude-code"}' 2>/dev/null) || exit 0
-curl -sS --max-time 2 -o /dev/null -X POST "$API_URL" \
-  -H "Authorization: $TOKEN" -H "Content-Type: application/json" \
-  -d "$BODY" >/dev/null 2>&1 || true
-exit 0

package/scripts/hook-userpromptsubmit.sh

@@ -1,21 +0,0 @@
-#!/bin/sh
-# gramatr UserPromptSubmit hook — classifier-only injection.
-# Reads {"prompt":...,"session_id":...} on stdin (Claude Code hook contract).
-# POSTs to /api/v1/classify, emits <gramatr-classification> block on stdout.
-# Hard 2s timeout. Silent no-op on any failure — never crashes the user turn.
-set -u
-INPUT=$(cat 2>/dev/null) || exit 0
-PROMPT=$(printf '%s' "$INPUT" | jq -r '.prompt // empty' 2>/dev/null) || exit 0
-[ -z "$PROMPT" ] && exit 0
-TOKEN=$(jq -r '.mcpServers.gramatr.headers.Authorization // empty' "$HOME/.claude.json" 2>/dev/null) || exit 0
-[ -z "$TOKEN" ] && exit 0
-API_URL="${GRAMATR_API_URL:-https://api.gramatr.com}/api/v1/classify"
-BODY=$(printf '%s' "$INPUT" | jq -c '{prompt: .prompt, session_id: (.session_id // null)}' 2>/dev/null) || exit 0
-RESPONSE=$(curl -sS --max-time 2 -X POST "$API_URL" \
-  -H "Authorization: $TOKEN" \
-  -H "Content-Type: application/json" \
-  -d "$BODY" 2>/dev/null) || exit 0
-[ -z "$RESPONSE" ] && exit 0
-printf '%s' "$RESPONSE" | jq -e '.schema == "gmtr.classification.v1"' >/dev/null 2>&1 || exit 0
-printf '<gramatr-classification>\n%s\n</gramatr-classification>\n' "$(printf '%s' "$RESPONSE" | jq -c .)"
-exit 0

package/scripts/postinstall.mjs

@@ -1,55 +0,0 @@
-/**
- * postinstall.mjs — Auto-detect and configure local AI clients.
- *
- * Runs on `npm install -g @gramatr/mcp`. Detects installed AI clients
- * (Claude Code, Codex, Gemini CLI, etc.), configures them automatically,
- * and prints a link for web/app setup.
- *
- * Design constraints:
- *   - Pure Node.js (no external dependencies)
- *   - Graceful failure: always exits 0
- *   - Non-interactive in CI (no prompts)
- */
-
-import { execSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { mkdir } from "node:fs/promises";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { dirname } from "node:path";
-
-async function main() {
-  const home = homedir();
-  const gramatrDir = join(home, ".gramatr");
-  await mkdir(gramatrDir, { recursive: true });
-
-  // Resolve the gramatr-mcp entry point relative to this script
-  const __dirname = dirname(fileURLToPath(import.meta.url));
-  const entrypoint = join(__dirname, "..", "dist", "bin", "gramatr-mcp.js");
-
-  // Skip if dist hasn't been built yet (e.g. during CI install before build step).
-  if (!existsSync(entrypoint)) return;
-
-  // Skip when running inside the monorepo workspace — postinstall is for
-  // published global installs only. Workspace dev installs (pnpm install at
-  // repo root) must not overwrite ~/.claude/settings.json with the current
-  // workspace dist, which may be stale or use different hook commands.
-  if (existsSync(join(__dirname, "..", "..", "..", "pnpm-workspace.yaml"))) return;
-
-  // Skip interactive flow in CI environments
-  const isCI = process.env.CI || process.env.CONTINUOUS_INTEGRATION || process.env.BUILD_ID || !process.stdin.isTTY;
-
-  // Configure local clients, then prompt for login if not already authenticated.
-  // In CI, stop after setup — no login prompt.
-  const command = isCI ? `node "${entrypoint}" setup auto --yes` : `node "${entrypoint}" start`;
-  try {
-    execSync(command, {
-      stdio: "inherit",
-      timeout: 300000, // 5 min — enough for OAuth browser flow
-    });
-  } catch {
-  }
-}
-
-main().catch(() => process.exit(0));