@aiguru/google-web-operations 0.6.5 → 0.6.6

package/bin/gwo.js

@@ -27,6 +27,12 @@ if (major < 22 || (major === 22 && minor < 18)) {
 
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
 const cmd = process.argv[2];
+
+// Installed inside a project rather than globally? Say so once per run (stderr, never on the MCP channel).
+// Global installs live under <prefix>/lib/node_modules or <prefix>/npm/node_modules; a checkout has no node_modules above it.
+if (/[\\/]node_modules[\\/]/.test(root) && !/[\\/](lib|npm)[\\/]node_modules[\\/]/i.test(root) && cmd !== 'mcp') {
+  console.error('note: gwo is installed locally in a project. For a stable setup: npm i -g @aiguru/google-web-operations\n');
+}
 // A checkout runs the TypeScript sources; the packaged build ships JavaScript.
 const ext = existsSync(path.join(root, 'apps', 'cli', 'src', 'index.js')) ? 'index.js' : 'index.ts';
 // Dynamic imports need file URLs on Windows; a bare drive path is read as a URL scheme.

package/bin/postinstall.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * Runs after `npm install` of the package. Says one thing, only when it
+ * matters: this is a command-line tool and belongs in a global install.
+ * Never fails the install.
+ */
+try {
+  if (process.env.npm_config_global !== 'true') {
+    console.log([
+      '',
+      '  Google Web Operations was installed into this project, not globally.',
+      '  It is a command-line tool (gwo) and the hosts need a stable path to it:',
+      '',
+      '    npm i -g @aiguru/google-web-operations',
+      '    gwo install',
+      '',
+      '  (then remove the local copy: node_modules, package.json, package-lock.json if this folder was empty)',
+      '',
+    ].join('\n'));
+  }
+} catch { /* never break an install */ }

package/docs/GETTING-STARTED.he.md

@@ -6,7 +6,7 @@
 
 דרישות: Node 22.18 ומעלה.
 
-1. בטרמינל:
+1. בטרמינל, מכל תיקייה, עם `-g` (בלעדיו npm מתקין לתיקייה הנוכחית ו‑`gwo` לא יהיה זמין):
    ```
    npm i -g @aiguru/google-web-operations
    gwo install

package/docs/INSTALL.he.md

@@ -7,11 +7,15 @@
 
 ## 1. התקנה
 
+מכל תיקייה שהיא (לא צריך תיקיית פרויקט), עם `-g`:
+
 ```
 npm i -g @aiguru/google-web-operations
 gwo install
 ```
 
+ה‑`-g` חשוב: בלעדיו npm יוצר `package.json`, `package-lock.json` ו‑`node_modules` בתיקייה הנוכחית, ו‑`gwo` לא נכנס ל‑PATH. הכלי מזהה את זה: `gwo install` מסרב לרשום נתיב מתוך `node_modules` של פרויקט ואומר מה לעשות. אם זה קרה: למחוק את שלושת אלה ולהריץ שוב עם `-g`.
+
 `gwo install` רושם את שרת ה‑MCP, את הסקילים ואת הפקודות בקלוד ובקודקס, ויוצר את `~/.gwo`. רק להוסט אחד: `gwo install claude` או `gwo install codex`. לראות בלי לשנות: `gwo install --print`.
 
 חלופה בלי npm: להוריד את ה‑tgz מעמוד ה‑Releases בריפו ולהריץ `npm i -g ./aiguru-google-web-operations-<version>.tgz` (ה‑`./` חובה).

package/hosts/claude/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "google-web-operations",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "description": "Google Web Operations: agent-run SEO and GEO operations for client websites. One core, one MCP server, two hosts (Claude Code, Codex).",
   "author": {
     "name": "AI Guru"

package/hosts/codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "google-web-operations",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "description": "Google Web Operations: agent-run SEO and GEO operations for client websites. One core, one MCP server, two hosts (Claude Code, Codex).",
   "author": {
     "name": "AI Guru"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiguru/google-web-operations",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "description": "Google Web Operations: agent-run SEO and GEO operations for client websites. One core, one MCP server, two hosts (Claude Code, Codex).",
   "license": "UNLICENSED",
   "private": false,
@@ -15,6 +15,9 @@
   "bin": {
     "gwo": "bin/gwo.js"
   },
+  "scripts": {
+    "postinstall": "node bin/postinstall.js"
+  },
   "dependencies": {
     "@modelcontextprotocol/server": "^2.0.0",
     "jszip": "^3.10.2",

package/tools/build-package.js

@@ -37,6 +37,7 @@ const out = {
     name: pkg['name'], version: pkg['version'], description: pkg['description'], license: pkg['license'] ?? 'UNLICENSED', private: false,
     type: 'module', engines: pkg['engines'], repository: pkg['repository'],
     bin: { gwo: 'bin/gwo.js' },
+    scripts: { postinstall: 'node bin/postinstall.js' },
     dependencies: pkg['dependencies'],
 };
 writeFileSync(path.join(OUT, 'package.json'), JSON.stringify(out, null, 2) + '\n');

package/tools/install.js

@@ -17,6 +17,7 @@
  * Only gwo-* entries are ever written or removed; nothing else in those
  * directories or files is touched. Idempotent: run it again after an upgrade.
  */
+import { execSync } from 'node:child_process';
 import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync, copyFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import path from 'node:path';
@@ -119,6 +120,29 @@ function codex() {
 log(`Google Web Operations ${uninstall ? 'uninstall' : 'install'}${print ? ' (print only)' : ''}`);
 log(`package: ${ROOT}`);
 log(`node:    ${node}`);
+// A package under some project's node_modules is a fragile place to point the
+// hosts at: it disappears with the folder or the next npm install there.
+if (!uninstall && !IS_CHECKOUT && /[\\/]node_modules[\\/]/.test(ROOT) && !argv.includes('--allow-local')) {
+    let globalRoot = '';
+    try {
+        globalRoot = execSync('npm root -g', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+    }
+    catch { /* npm not on PATH */ }
+    const isGlobal = globalRoot && path.resolve(ROOT).toLowerCase().startsWith(path.resolve(globalRoot).toLowerCase());
+    if (!isGlobal) {
+        console.error([
+            '',
+            'This copy of the package is installed locally (inside a project\'s node_modules), so the hosts would be',
+            'pointed at a path that vanishes with the folder or the next npm install there. Install it globally instead:',
+            '',
+            '    npm i -g @aiguru/google-web-operations',
+            '    gwo install',
+            '',
+            'To register this local copy anyway (a deliberate, pinned setup): gwo install --allow-local',
+        ].join('\n'));
+        process.exit(2);
+    }
+}
 if (!uninstall)
     ensureHome();
 if (targets.includes('claude'))