@xmarts/genius-setup 1.3.0 → 1.4.0

package/CLAUDE_PROTOCOL.md

@@ -0,0 +1,36 @@
+# Xmarts Genius — Protocolo de Consultor
+
+> Esta sección la instala/actualiza automáticamente `@xmarts/genius-setup`. No la edites a mano.
+
+## Cómo funciona (cero fricción)
+
+El Brain de Genius está conectado vía el MCP **`beesmart_genius`** y dos hooks de Claude Code:
+- **Inyección por turno** (UserPromptSubmit/SessionStart): en cada turno recibes automáticamente los
+  learnings, playbooks y patrones relevantes — no tienes que pedirlos.
+- **Captura automática** (SessionEnd/PreCompact/Stop): tus hallazgos y tu sesión se capturan solos al
+  final; no tienes que documentar manualmente.
+- **Auto-actualización**: el paquete se refresca solo en segundo plano (1×/día). Cuando agregamos tools,
+  skills o features, las recibes en tus turnos **sin hacer nada**.
+
+## Reglas Obligatorias (siempre activas)
+
+1. **ANTES de cada tarea**: usa `query_knowledge` (o `ask_brain`) para buscar conocimiento existente.
+2. **AL descubrir algo nuevo**: captura con `capture_learning` — título claro + resolución detallada.
+3. **AL resolver un error**: documenta error → fix (el Brain auto-detecta el par).
+4. **SIEMPRE usa `target_client`** para operar en un cliente (p.ej. `target_client="GEA Ecuador"`).
+5. **NUNCA te conectes directo al Odoo del cliente** — todo fluye por el MCP `beesmart_genius`.
+6. Tu tiempo se sugiere solo a partir de tu actividad; confírmalo cuando puedas en **My Week**
+   (`/mcp/webapp/my-week`). Solo el tiempo que confirmas cuenta como horas reales.
+
+## Tools (servidas dinámicamente por `beesmart_genius`)
+
+| Tool | Cuándo usar |
+|------|-------------|
+| `query_knowledge` | Antes de cada tarea — busca en el Brain |
+| `capture_learning` | Al descubrir algo nuevo |
+| `get_my_profile` | Ver tu perfil de consultor |
+| `search_read` / `execute_orm` + `target_client` | Consultar/operar data de cualquier cliente vía gateway |
+| `list_models` / `get_model_schema` + `target_client` | Inspeccionar esquema de un cliente |
+
+> La lista completa de tools (y skills como prompts) la sirve el MCP en tiempo real; al agregar nuevas,
+> aparecen automáticamente en tu sesión sin reconfigurar nada.

package/bin/genius-setup.js

@@ -118,12 +118,38 @@ function addHook(eventName, scriptPath) {
 ['UserPromptSubmit', 'SessionStart'].forEach((e) => addHook(e, injectDst));
 writeJson(settingsPath, settings);
 
+// 4) ~/.claude/CLAUDE.md — install/refresh the Genius Protocol between auto-managed
+//    markers (idempotent; never clobbers the consultant's surrounding content).
+const BEGIN = '<!-- XMARTS-GENIUS-PROTOCOL:BEGIN (auto-managed by @xmarts/genius-setup) -->';
+const END = '<!-- XMARTS-GENIUS-PROTOCOL:END -->';
+try {
+  ensureDir(CLAUDE_DIR);
+  const claudeMdPath = path.join(CLAUDE_DIR, 'CLAUDE.md');
+  let existing = '';
+  try { existing = fs.readFileSync(claudeMdPath, 'utf8'); } catch (_) {}
+  const proto = fs.readFileSync(path.join(__dirname, '..', 'CLAUDE_PROTOCOL.md'), 'utf8').trim();
+  const block = BEGIN + '\n' + proto + '\n' + END;
+  let out;
+  if (existing.includes(BEGIN) && existing.includes(END)) {
+    out = existing.slice(0, existing.indexOf(BEGIN)) + block +
+          existing.slice(existing.indexOf(END) + END.length);
+  } else {
+    out = (existing ? existing.replace(/\s+$/, '') + '\n\n' : '') + block + '\n';
+  }
+  fs.writeFileSync(claudeMdPath, out);
+} catch (e) {
+  log('WARN: could not write CLAUDE.md protocol (' + e.message + ')');
+}
+
 log('');
 log('  Xmarts Genius is set up.');
 log('  - MCP server     : beesmart_genius -> ' + BASE + '/mcp/consultant');
 log('  - Capture hook   : ' + hookDst + '  (SessionEnd / PreCompact / Stop)');
 log('  - Inject hook    : ' + injectDst + '  (UserPromptSubmit / SessionStart)');
 log('  - Config         : ' + path.join(GENIUS_DIR, 'config.json'));
+log('  - Protocol       : ' + path.join(CLAUDE_DIR, 'CLAUDE.md') + '  (auto-managed)');
 if (CLIENT) log('  - Default client : ' + CLIENT);
 log('');
-log('  Restart Claude Code. Per-turn Brain injection + automatic capture are now active — no further prompts.');
+log('  Restart Claude Code. Per-turn Brain injection + automatic capture + the Genius');
+log('  protocol are now active. The package SELF-UPDATES daily in the background, so new');
+log('  tools, skills and features arrive automatically — you never have to run this again.');

package/hooks/genius_inject.py

@@ -22,6 +22,8 @@ import urllib.request
 HOME = os.path.expanduser("~")
 CFG_PATH = os.path.join(HOME, ".genius", "config.json")
 TIMEOUT = 3.5
+SELF_UPDATE_TTL = 86400  # at most once/day
+SELF_UPDATE_STAMP = os.path.join(HOME, ".genius", ".last_selfupdate")
 
 SESSION_PRIMER = (
     "[Xmarts Genius — Brain connected]\n"
@@ -77,10 +79,53 @@ def _inject(cfg, prompt):
         return ""
 
 
+def _maybe_self_update(cfg):
+    """Keep the consultant on the LATEST Genius package with ZERO action: at most
+    once/day, silently re-run the installer in the background. New hooks, MCP
+    tools, settings and the CLAUDE.md protocol then flow automatically — the
+    consultant never re-onboards. Detached + fully guarded; never blocks a turn.
+    """
+    import time
+    import subprocess
+    try:
+        token = cfg.get("token")
+        if not token:
+            return
+        if os.path.exists(SELF_UPDATE_STAMP) and (
+                time.time() - os.path.getmtime(SELF_UPDATE_STAMP)) < SELF_UPDATE_TTL:
+            return
+        # Stamp FIRST so a failing/slow npx never causes a retry storm.
+        try:
+            os.makedirs(os.path.dirname(SELF_UPDATE_STAMP), exist_ok=True)
+            with open(SELF_UPDATE_STAMP, "w") as fh:
+                fh.write(str(int(time.time())))
+        except Exception:
+            return
+        env = dict(os.environ)
+        env["GENIUS_TOKEN"] = token
+        base = cfg.get("base_url")
+        devnull = open(os.devnull, "w")
+        if os.name == "nt":
+            cmd = "npx -y @xmarts/genius-setup@latest"
+            if base:
+                cmd += ' --base-url "%s"' % base
+            subprocess.Popen(cmd, shell=True, env=env, stdout=devnull, stderr=devnull,
+                             stdin=subprocess.DEVNULL, creationflags=0x00000008)  # DETACHED_PROCESS
+        else:
+            args = ["npx", "-y", "@xmarts/genius-setup@latest"]
+            if base:
+                args += ["--base-url", base]
+            subprocess.Popen(args, env=env, stdout=devnull, stderr=devnull,
+                             stdin=subprocess.DEVNULL, start_new_session=True)
+    except Exception:
+        pass
+
+
 def main():
     cfg = _cfg()
     if not cfg.get("token"):
         return  # not configured -> silent no-op
+    _maybe_self_update(cfg)   # background, daily, zero-action upgrades
     event = _event()
     name = event.get("hook_event_name") or (
         "UserPromptSubmit" if event.get("prompt") else "SessionStart")

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xmarts/genius-setup",
-  "version": "1.3.0",
-  "description": "One-command frictionless onboarding for Xmarts Genius (Brain MCP + per-turn injection + automatic session capture + Claude-session time telemetry).",
+  "version": "1.4.0",
+  "description": "One-command, self-updating onboarding for Xmarts Genius (Brain MCP + per-turn injection + automatic session/time capture + CLAUDE.md protocol). Installs once; self-updates daily so new tools/skills/features arrive with zero action.",
   "bin": {
     "genius-setup": "bin/genius-setup.js"
   },
@@ -9,6 +9,7 @@
     "bin/genius-setup.js",
     "hooks/genius_inject.py",
     "hooks/genius_capture.py",
+    "CLAUDE_PROTOCOL.md",
     "README.md"
   ],
   "engines": {