brainclaw 1.23.0 → 1.25.0

package/dist/cli/register-cloud.js

@@ -1,4 +1,4 @@
-import { runCloudStatus, runCloudConnect, runCloudAwait, runCloudDisconnect, } from '../commands/cloud.js';
+import { runCloudStatus, runCloudConnect, runCloudAwait, runCloudDisconnect, runCloudPull, runCloudPush, runCloudGrant, runCloudGrantWeb, runCloudRotate, runCloudAcceptSoloRisk, } from '../commands/cloud.js';
 /** Adresse du cloud. Fournie par `--url`, sans quoi la commande demande de la préciser. */
 const DEFAULT_URL_HINT = 'https://<votre-déploiement>.workers.dev';
 function fail(message) {
@@ -24,14 +24,125 @@ export function registerCloudCommands(program) {
         runCloudStatus({ json: options.json });
     });
     cloud
-        .command('connect <invite-code>')
-        .description("Rejoint un projet cloud : réclame l'invitation, prouve la possession de l'identité et atteste la clé de chiffrement de cet appareil")
-        .requiredOption('--url <url>', `Adresse du déploiement cloud (ex. ${DEFAULT_URL_HINT})`)
-        .requiredOption('--agent <id>', "Identifiant d'agent à enrôler (opaque, 4 à 64 caractères)")
+        .command('push')
+        .description('Projette les plans et la mémoire projet vers le cloud : scelle, met en file, puis envoie')
+        .option('--url <url>', `Adresse du déploiement cloud (ex. ${DEFAULT_URL_HINT})`)
+        .option('--dry-run', "N'écrit ni n'envoie rien : rapporte ce qui partirait")
+        .option('--api-key <key>', 'Clé porteuse exigée par l ingestion (ou BRAINCLAW_CLOUD_API_KEY)')
+        .option('--limit <n>', 'Borne le lot envoyé', (v) => Number.parseInt(v, 10))
         .option('--json', 'Sortie JSON')
-        .action(async (inviteCode, options) => {
+        .action(async (options) => {
+        try {
+            await runCloudPush({ ...options, apiKey: options.apiKey });
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err));
+        }
+    });
+    cloud
+        .command('pull')
+        .description('Tire le delta cloud, vérifie chaque enveloppe, puis matérialise les objets acceptés')
+        .option('--url <url>', `Adresse du déploiement cloud (ex. ${DEFAULT_URL_HINT})`)
+        .option('--api-key <key>', 'Clé porteuse exigée par l ingestion (ou BRAINCLAW_CLOUD_API_KEY)')
+        .option('--limit <n>', 'Borne le delta reçu', (v) => Number.parseInt(v, 10))
+        .option('--json', 'Sortie JSON')
+        .action(async (options) => {
+        try {
+            await runCloudPull({ ...options, apiKey: options.apiKey });
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err));
+        }
+    });
+    cloud
+        .command('grant <agentId>')
+        .description("Remet des clés d'epoch à un appareil approuvé — seul un détenteur actif le peut")
+        .option('--url <url>', `Adresse du déploiement cloud (ex. ${DEFAULT_URL_HINT})`)
+        // Le défaut est `current` (dec#163 §1) : un membre invité voit à partir de son
+        // arrivée. `all` est réservé à un autre appareil DE LA MÊME personne — c'est un choix
+        // explicite, jamais un effet de bord.
+        .option('--horizon <all|current>', "Étendue remise : 'all' (vos propres appareils) ou 'current' (invité)", 'current')
+        .option('--epoch <n...>', 'Epochs précis à remettre (outrepasse --horizon)', (v, acc) => {
+        acc.push(Number.parseInt(v, 10));
+        return acc;
+    }, [])
+        .option('--json', 'Sortie JSON')
+        .action(async (agentId, options) => {
+        try {
+            await runCloudGrant({
+                to: agentId,
+                url: options.url,
+                horizon: options.horizon,
+                epochs: options.epoch?.length ? options.epoch : undefined,
+                json: options.json,
+            });
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err));
+        }
+    });
+    cloud
+        .command('grant-web <fingerprint>')
+        .description("Remet des clés d'epoch à une session NAVIGATEUR — recopiez l'empreinte affichée par le navigateur")
+        .option('--url <url>', `Adresse du déploiement cloud (ex. ${DEFAULT_URL_HINT})`)
+        .option('--horizon <all|current>', "Étendue remise : 'all' ou 'current'", 'current')
+        .option('--epoch <n...>', 'Epochs précis à remettre (outrepasse --horizon)', (v, acc) => {
+        acc.push(Number.parseInt(v, 10));
+        return acc;
+    }, [])
+        .option('--api-key <key>', "Clé porteuse exigée par l'ingestion (ou BRAINCLAW_CLOUD_API_KEY)")
+        .option('--json', 'Sortie JSON')
+        .action(async (fingerprint, options) => {
+        try {
+            await runCloudGrantWeb({
+                fingerprint,
+                url: options.url,
+                horizon: options.horizon,
+                epochs: options.epoch?.length ? options.epoch : undefined,
+                apiKey: options.apiKey,
+                json: options.json,
+            });
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err));
+        }
+    });
+    cloud
+        .command('rotate')
+        .description("Crée l'epoch suivant et y bascule les écritures — ferme la lecture FUTURE à un révoqué")
+        // `--force` existe mais n'est PAS le premier réflexe : le refus de quorum nomme
+        // d'abord `accept-solo-risk`, qui laisse une trace datée. Forcer n'en laisse aucune.
+        .option('--force', 'Passer outre le quorum de récupération SANS consigner de consentement')
+        .option('--json', 'Sortie JSON')
+        .action(async (options) => {
+        try {
+            await runCloudRotate(options);
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err));
+        }
+    });
+    cloud
+        .command('accept-solo-risk')
+        .description('Consigne votre acceptation du risque solo (perte de cette machine = perte du passé)')
+        .option('--json', 'Sortie JSON')
+        .action(async (options) => {
+        try {
+            await runCloudAcceptSoloRisk(options);
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err));
+        }
+    });
+    cloud
+        .command('connect <url|code>')
+        .description("Rejoint un projet cloud depuis l'URL d'activation ou un code ; attend ensuite l'approbation humaine")
+        .option('--url <url>', `Origine du déploiement si vous fournissez un code nu (ex. ${DEFAULT_URL_HINT})`)
+        .requiredOption('--agent <id>', "Identifiant d'agent à enrôler (4 à 64 caractères : a-z, A-Z, 0-9, _ ou -)")
+        .option('--json', 'Sortie JSON')
+        .action(async (activation, options) => {
         await runCloudConnect({
-            inviteCode,
+            inviteCode: activation,
             url: options.url,
             agentId: options.agent,
             json: options.json,
@@ -39,11 +150,8 @@ export function registerCloudCommands(program) {
     });
     cloud
         .command('await')
-        .description("Constate l'approbation humaine et active l'appairage local")
-        // Commande DISTINCTE de connect : l'approbation dépend d'un humain dont le délai
-        // n'est pas borné. Bloquer indéfiniment sur un tiers ferait un mauvais citoyen dans
-        // un script, et une interruption doit rester reprenable.
-        .requiredOption('--url <url>', 'Adresse du déploiement cloud')
+        .description("Reprend l'attente d'approbation humaine après une interruption (maximum 15 min)")
+        .option('--url <url>', 'Adresse du déploiement cloud (utilise celle mémorisée après appairage)')
         .action(async (options) => {
         await runCloudAwait({ url: options.url })
             .catch((err) => fail(`Erreur : ${err instanceof Error ? err.message : String(err)}`));
@@ -51,7 +159,7 @@ export function registerCloudCommands(program) {
     cloud
         .command('disconnect')
         .description("Retire l'autorisation locale et demande la révocation distante")
-        .requiredOption('--url <url>', 'Adresse du déploiement cloud')
+        .option('--url <url>', 'Adresse du déploiement cloud (utilise celle mémorisée après appairage)')
         // Effacer le trousseau rend DÉFINITIVEMENT illisible tout ce qui a été scellé sous
         // ces epochs. Ce n'est donc pas le défaut : on le demande explicitement.
         .option('--forget-keys', "Efface aussi les clés d'epoch de ce projet (le passé scellé devient illisible ici)")

package/dist/cli/register-code-map.js

@@ -3,12 +3,19 @@ export function registerCodeMapCommands(program) {
     // --- code-map ---
     program
         .command('code-map <subcommand> [args...]')
-        .description('Query the per-project Code Map (status, refresh, find, brief)')
+        .description('Query the per-project Code Map (status, refresh, find, brief, impact, export, outline)')
         .option('--json', 'Output as JSON')
         .option('--all', 'For refresh: enumerate all supported files (full refresh)')
         .option('--changed', 'For refresh: only changed files (default)')
         .option('--cascade', 'For refresh/status in a multi-project workspace: cascade across every nested project (each gets its own store; the root store is scoped to files no child owns)')
-        .option('--limit <n>', 'Max results for find/brief', (v) => parseInt(v, 10))
+        .option('--limit <n>', 'Max results for find/brief/impact/outline', (v) => parseInt(v, 10))
+        .option('--depth <n>', 'For impact/export: maximum graph depth (export is hard-capped at 4)', (v) => parseInt(v, 10))
+        .option('--direction <direction>', 'For export: outgoing, incoming, or both')
+        .option('--format <format>', 'For export: json (default) or mermaid')
+        .option('--max-nodes <n>', 'For export: maximum nodes (hard-capped at 100)', (v) => parseInt(v, 10))
+        .option('--max-edges <n>', 'For export: maximum edges (hard-capped at 200)', (v) => parseInt(v, 10))
+        .option('--min-confidence <n>', 'For export: persisted confidence floor (minimum 0.5)', (v) => parseFloat(v))
+        .option('--target-kind <kind>', 'For export: symbol or file (auto-detected by default)')
         .action((subcommand, args, options) => {
         void runCodeMap(subcommand, args, options).catch((err) => {
             console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);