# GhostCrab Beta Test

Merci de tester cette build avant publication npm.

Guide complet (3 voies : zip, npm, Git + `.env` + IDE) : **`INSTALL.md`** dans ce dossier.

## Contenu du zip

Vous trouverez notamment :

- `mindflight-ghostcrab-personal-mcp-{{VERSION}}.tgz` — paquet principal (CLI, MCP, dépendances JS)
- cinq tarballs plateforme Linux/macOS (`linux-x64`, `linux-arm64`, `darwin-x64`, `darwin-arm64`) et **deux Windows** (`win32-x64` Intel/AMD, `win32-arm64` ARM)
- `pack-manifest.json`
- `install-beta.mjs` — installation automatique du bon binaire
- `install-beta.ps1` — wrapper PowerShell (appelle `install-beta.mjs`)
- `lib/spawn-npm.mjs` — helper npm Windows (inclus pour `install-beta.mjs`)
- `smoke-ide-install.mjs` — vérifie l’installation système + les dry-runs Cursor/Codex/Claude sans écrire vos configs
- `INSTALL.md` — guide d’installation FR/EN
- `Makefile` + `README_MAKE.md` — option « tout en `make` » (install, authorize, `.env`, smoke)
- `SHA256SUMS.txt`

Le **paquet principal** ne contient pas le binaire Zig : il faut aussi le tarball **plateforme** (ou laisser `install-beta.mjs` / `make` le faire).

## Prérequis

- Node.js 20+
- npm
- accès Internet pour l’arbre de dépendances JS du paquet principal
- `make` optionnel (macOS/Linux ; sous Windows : WSL ou Git Bash) si vous utilisez le `Makefile`

## Installation (au choix)

**Option A — une commande Node**

```bash
node install-beta.mjs
```

**Option A bis — PowerShell (Windows)**

```powershell
.\install-beta.ps1
```

**Option B — Makefile** (dans le dossier dézippé, à côté des `.tgz`)

```bash
make
```

Puis : `make mcp` pour afficher le snippet Cursor. Détails : `README_MAKE.md`.

**Option C — smoke installation + IDE sans écrire vos configs**

```bash
node smoke-ide-install.mjs
```

Ce test installe les tarballs dans un répertoire temporaire, vérifie `gcp --help`
et `gcp authorize`, puis lance `gcp brain setup cursor|codex|claude|generic --dry-run`.

## Fichier `.env` (embeddings / clés API)

Pas obligatoire pour démarrer (BM25 seul par défaut). Après installation :

```bash
cp node_modules/@mindflight/ghostcrab-personal-mcp/.env.example .env
```

Éditez `.env` si vous activez les embeddings ou des APIs externes. Avec le **Makefile**, la cible `make env` crée `.env` s’il manque.

## IDE (Cursor, Codex, Claude Code)

```bash
npx gcp brain setup cursor
npx gcp brain setup codex
npx gcp brain setup claude
npx gcp brain setup generic
```

Préflight sans écriture :

```bash
npx gcp brain setup cursor --dry-run --force
npx gcp brain setup codex --dry-run
npx gcp brain setup claude --dry-run
npx gcp brain setup generic --dry-run
```

Dans ce zip, suivez la section **IDE** de **`INSTALL.md`**. Sur le dépôt source : `README_CURSOR_MCP.md`, `README_CODEX_MCP.md`, `README_CLAUDE_CODE_MCP.md`.

## Vérification minimale

```bash
npx gcp --help
npx gcp authorize
```

## Vérification MCP

Exemple (adapter si votre client exige le chemin absolu vers `gcp.mjs`) :

```json
{
  "mcpServers": {
    "ghostcrab": {
      "command": "npx",
      "args": ["gcp", "brain", "up"]
    }
  }
}
```

Chemin explicite :

```bash
node ./node_modules/@mindflight/ghostcrab-personal-mcp/bin/gcp.mjs brain up
```

## Ce qu’on veut savoir

1. OS et architecture  
2. `node install-beta.mjs` ou `make` sans erreur  
3. `node smoke-ide-install.mjs` sans erreur  
4. `gcp --help`  
5. `gcp authorize`  
6. `gcp brain setup cursor|codex|claude|generic --dry-run`  
7. `gcp brain up` / outils MCP visibles  
8. tout comportement inattendu  

## En cas d’échec

Merci d’indiquer : commande exacte, sortie complète, OS/arch.
