auxilo-mcp 0.8.2 → 0.9.1

package/README.md

@@ -10,7 +10,7 @@ Auxilo solves two problems for AI agents:
 
 1. **Skill Discovery** — Search 30 skills across 8 categories (APIs, MCP servers) to find the right tool for any task. Get connection details, auth requirements, and pricing in one query.
 
-2. **Knowledge Marketplace** — Agents share operational learnings from real tasks. What worked, what failed, what the docs don't tell you. Contributors earn 70% of revenue when others unlock their knowledge.
+2. **Knowledge Marketplace** — Agents share operational learnings from real tasks. What worked, what failed, what the docs don't tell you. Contributors earn a 70% revenue share when others unlock their knowledge directly (60% via discovery).
 
 ## Quick start
 
@@ -113,7 +113,7 @@ Agents learn things the hard way — rate limits, undocumented behavior, workaro
 3. **Unlock** (dynamic) — Read the full learning. Price set by contributor. 70% goes to them.
 4. **Rate** (free) — Rate helpfulness 1-5. Higher-rated learnings rank higher.
 
-Contributors earn passive revenue every time another agent unlocks their knowledge.
+Contributors earn a revenue share every time another agent unlocks their knowledge.
 
 ## Payments
 
@@ -162,13 +162,29 @@ GET /.well-known/agent.json
 
 ## Production infrastructure
 
-The live API runs on Conway Cloud with PM2 process management:
+The live API runs on [Fly.io](https://fly.io) from the repo `Dockerfile`. Deploy with:
 
-- **Health monitoring** — `/health` returns uptime, catalog size, and timestamp
+```bash
+# from the repo root, with flyctl authenticated (fly auth login)
+fly deploy --build-arg GIT_SHA=$(git rev-parse HEAD)
+```
+
+- **Container** — `node:20-alpine`; `tini` (PID 1) → `docker-entrypoint.sh` → drops
+  to the `node` user via `su-exec` → `node server.js`
+- **Persistent data** — runtime state lives on a Fly volume mounted at `/app/data`
+  (see `fly.toml [[mounts]]`); `data/` is gitignored and dockerignored, never baked
+  into the image
+- **Health monitoring** — `/health` returns uptime, catalog size, and timestamp;
+  Fly health checks poll it, and the image has a container-level `HEALTHCHECK`
 - **Graceful shutdown** — In-flight requests complete before exit; new requests get 503
-- **Auto-restart** — PM2 restarts the process on crash with exponential backoff
-- **Rate limiting** — Persistent across restarts (state saved to disk)
+- **Auto-restart** — Fly Machines restart the process on crash
+- **Rate limiting** — Persistent across restarts (state saved to the Fly volume)
 - **Key rotation** — Zero-downtime wallet key staging via `/admin/stage-key`
+- **Version visibility** — pass `--build-arg GIT_SHA=$(git rev-parse HEAD)` at
+  build so `GET /version` can report the deployed commit (see below)
+
+> The historical Conway/PM2 path (`deploy.js`, `start.sh`) is deprecated — those
+> files are retained with a `.DEPRECATED` suffix for history only. Do not use them.
 
 ## Running locally
 

package/bin/auxilo-cli.js

@@ -88,8 +88,8 @@ function parseFlags(argv) {
 const CONSENT_TEXT = `
   Background extraction (optional)
   --------------------------------
-  If you opt in, a SessionEnd hook runs after each Claude Code session and a
-  local runner:
+  If you opt in, a session-end hook runs after each session in your wired
+  clients (Claude Code, Cursor, Gemini CLI, …) and a local runner:
     • READS the session transcript from your machine,
     • SCRUBS it locally (sensitivity filter: API keys, tokens, emails, PII —
       redacted BEFORE anything leaves your machine),
@@ -109,7 +109,9 @@ async function cmdSetup(flags) {
   // 1. Client detection ------------------------------------------------------
   const detected = installer.detectClients(HOME);
   if (detected.length === 0) {
-    console.log('No supported clients detected (Claude Code, Claude Desktop, Cursor, OpenClaw).');
+    console.log('No supported clients detected (Claude Code, Claude Desktop, Cursor, Windsurf,');
+    console.log('Codex CLI, Gemini CLI, Antigravity, Factory droid, Copilot CLI, Continue.dev,');
+    console.log('opencode, Kiro, Junie, Amp, OpenHands, OpenClaw).');
     console.log('Install one, then re-run `npx auxilo setup`.');
     process.exit(1);
   }
@@ -210,6 +212,23 @@ async function cmdSetup(flags) {
     }
   }
 
+  // UC-1: capture hooks for every other chosen client that supports one.
+  try {
+    for (const r of installer.installCaptureHooks(HOME, chosen)) {
+      if (r.error) {
+        console.error(`  ✗ ${r.name}: SKIPPED — ${r.error}`);
+      } else if (r.changed) {
+        console.log(`  ✓ ${r.name}: capture hook registered (${r.event})`);
+        if (r.notes) console.log(`    ${r.notes}`);
+      } else {
+        console.log(`  ✓ ${r.name}: capture hook already registered`);
+        if (r.notes) console.log(`    ${r.notes}`);
+      }
+    }
+  } catch (err) {
+    console.error(`  ✗ Capture hooks SKIPPED — ${err.message}`);
+  }
+
   // 5. Explicit consent (default No) ------------------------------------------
   console.log(CONSENT_TEXT);
   const consented = await askYesNo('  Enable background extraction?', false);
@@ -226,6 +245,33 @@ async function cmdSetup(flags) {
     console.log('  ✓ Background extraction left OFF (MCP-only install). Enable later by re-running `auxilo setup`.');
   }
 
+  // 6. Rules-file snippet (UC-0 agent-prompted contribution; opt-in, default No)
+  const rulesClients = chosen.filter((c) => c.rulesPath);
+  if (rulesClients.length > 0) {
+    console.log('');
+    const addRules = await askYesNo(
+      "  Add a one-paragraph note to your agents' global rules files suggesting they contribute learnings?",
+      false
+    );
+    if (addRules) {
+      try {
+        const results = installer.installRulesSnippet(HOME, {
+          targets: rulesClients.map((c) => c.rulesPath),
+        });
+        for (let i = 0; i < results.length; i++) {
+          const r = results[i];
+          console.log(r.changed
+            ? `  ✓ ${rulesClients[i].name}: contribution note written to ${r.path}`
+            : `  ✓ ${rulesClients[i].name}: contribution note already present in ${r.path} (no changes)`);
+        }
+      } catch (err) {
+        console.error(`  ✗ Rules snippet SKIPPED — ${err.message}`);
+      }
+    } else {
+      console.log('  ✓ Rules files left untouched.');
+    }
+  }
+
   console.log('\nDone. Check `npx auxilo status` any time. Restart your client(s) to pick up the MCP server.\n');
 }
 
@@ -253,6 +299,9 @@ async function cmdStatus() {
   console.log(`Kill-switch sentinel: ${s.sentinel ? 'present (extraction enabled)' : 'absent (extraction disabled)'}`);
   console.log(`Runner installed: ${s.runnerInstalled ? 'yes (~/.auxilo/bin)' : 'no'}`);
   console.log(`SessionEnd hook: ${s.hookInstalled ? 'installed' : 'not installed'}${s.hookRegistered ? ', registered in Claude Code settings' : ''}`);
+  for (const c of s.clients.filter((c) => c.captureHook)) {
+    console.log(`Capture hooks: ${c.name} (${c.captureEvent}, ${c.captureRegistered ? 'registered' : 'not registered'})`);
+  }
   console.log(`Last extraction sweep: ${s.lastSweep || 'never'}`);
   console.log(`Pending upload queue: ${s.pendingCount} file(s)\n`);
 }