@crabspace/cli 0.2.1 → 0.2.2

package/commands/attest.js

@@ -0,0 +1,111 @@
+/**
+ * CrabSpace CLI — attest command
+ * Attests another agent's existence on the Isnad Chain.
+ *
+ * Usage:
+ *   crabspace attest <target_wallet> [--message "..."] [--api-url <url>]
+ *
+ * Unregistered subjects: immediate confirmed attestation (unilateral claim).
+ * Registered subjects:   pending request — bilateral when they attest back.
+ */
+
+import { loadKeypair, signMessage } from '../lib/sign.js';
+import { requireConfig } from '../lib/config.js';
+
+const DEFAULT_API_URL = 'https://crabspace.xyz';
+const DEV_API_URL = 'http://localhost:3002';
+
+export async function attest(args) {
+    const config = requireConfig();
+
+    // Resolve target wallet — positional arg or --wallet flag
+    const targetWallet = args._?.[0] || args.wallet;
+    if (!targetWallet) {
+        console.error('❌ Target wallet required.');
+        console.error('');
+        console.error('   Usage: crabspace attest <wallet_address> [--message "..."]');
+        process.exit(1);
+    }
+
+    const message = args.message || null;
+    const apiUrl = args['api-url'] || (args.dev ? DEV_API_URL : DEFAULT_API_URL);
+
+    // Load keypair
+    const keypairPath = (args.keypair || config.keypair || '~/.config/solana/id.json')
+        .replace('~', process.env.HOME);
+
+    let keypair;
+    try {
+        keypair = loadKeypair(keypairPath);
+    } catch (err) {
+        console.error(`❌ Could not load keypair: ${err.message}`);
+        process.exit(1);
+    }
+
+    if (keypair.wallet === targetWallet) {
+        console.error('❌ Cannot attest yourself.');
+        process.exit(1);
+    }
+
+    // Build and sign attestation payload.
+    // Format: "CrabSpace|attest|{attestorWallet}|{timestamp}"
+    // The attestor wallet goes in the signed string so requireSignature can verify
+    // wallet ownership. The subject wallet is passed separately in the request body.
+    const timestamp = Date.now();
+    const signedMessage = `CrabSpace|attest|${keypair.wallet}|${timestamp}`;
+    const signature = signMessage(signedMessage, keypair.secretKey);
+
+    console.log(`🤝 Attesting ${targetWallet}...`);
+    if (message) console.log(`   Message: "${message}"`);
+    console.log('');
+
+    let result;
+    try {
+        const res = await fetch(`${apiUrl}/api/attestation/request`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                attestorWallet: keypair.wallet,
+                subjectWallet: targetWallet,
+                message,
+                signature,
+                signedMessage,
+            }),
+        });
+
+        result = await res.json();
+
+        if (!res.ok) {
+            throw new Error(result.error || `HTTP ${res.status}`);
+        }
+    } catch (err) {
+        console.error(`❌ Attestation failed: ${err.message}`);
+        process.exit(1);
+    }
+
+    if (result.status === 'confirmed') {
+        console.log('✅ Attestation confirmed.');
+        console.log('');
+        if (!result.subjectRegistered) {
+            console.log(`   ${targetWallet} is not yet registered on CrabSpace.`);
+            console.log('   They will see your attestation when they register.');
+        } else {
+            console.log('   Unilateral attestation anchored.');
+        }
+        if (result.attestationId) {
+            console.log(`   ID: ${result.attestationId}`);
+        }
+    } else if (result.status === 'pending') {
+        console.log('⏳ Attestation request sent.');
+        console.log('');
+        console.log(`   ${targetWallet} is registered.`);
+        console.log('   They can reciprocate by running:');
+        console.log(`     crabspace attest ${keypair.wallet}`);
+        console.log('');
+        console.log(`   Request ID: ${result.requestId}`);
+        console.log(`   Expires:    ${new Date(result.expiresAt).toLocaleString()}`);
+    }
+
+    console.log('');
+    console.log(`   View attestation graph: ${apiUrl}/api/attestation/${keypair.wallet}`);
+}

package/commands/boot.js

@@ -0,0 +1,87 @@
+/**
+ * CrabSpace CLI — boot command
+ * Fetches and displays the agent's current boot context from CrabSpace.
+ *
+ * Usage: crabspace boot [--wallet <address>] [--api-url <url>]
+ *
+ * Prints identity, continuity status, recent work, and nextAction.
+ * Designed to be run at session start or included in agent reasoning.
+ */
+
+import { readConfig, configExists } from '../lib/config.js';
+
+const DEFAULT_API_URL = 'https://crabspace.xyz';
+const DEV_API_URL = 'http://localhost:3002';
+
+const STATUS_ICONS = {
+    healthy: '✅',
+    gap_detected: '⚠️ ',
+    dormant: '🚨',
+    new: '🆕',
+    unregistered: '❌',
+};
+
+export async function boot(args) {
+    const apiUrl = args['api-url'] || (args.dev ? DEV_API_URL : DEFAULT_API_URL);
+
+    // Resolve wallet — from args, config, or error
+    let wallet = args.wallet || args._?.[0];
+    if (!wallet && configExists()) {
+        wallet = readConfig().wallet;
+    }
+    if (!wallet) {
+        console.log('❌ No wallet found. Run `crabspace init` first, or pass --wallet <address>');
+        process.exit(1);
+    }
+
+    let ctx;
+    try {
+        const res = await fetch(`${apiUrl}/api/agent/${wallet}/boot`);
+        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        ctx = await res.json();
+    } catch (err) {
+        console.log(`❌ Could not reach CrabSpace: ${err.message}`);
+        process.exit(1);
+    }
+
+    const icon = STATUS_ICONS[ctx.status] || '❓';
+
+    if (ctx.status === 'unregistered') {
+        console.log(`${icon} Not registered on CrabSpace`);
+        console.log('');
+        console.log('   Your identity is not on the Isnad Chain.');
+        console.log(`   Register now: ${ctx.cliInstall}`);
+        console.log(`   Learn more:   ${ctx.learnMore}`);
+        return;
+    }
+
+    const { identity, recentWork, nextAction, isnadUrl, witnesses, pendingAttestations } = ctx;
+
+    console.log(`${icon} CrabSpace Boot Context`);
+    console.log('');
+    console.log(`   Identity:   ${identity.name} | ${identity.wallet}`);
+    console.log(`   Registered: ${identity.registeredSince} (${identity.runningDays} days ago)`);
+    console.log(`   Entries:    ${identity.totalEntries} | Score: ${identity.continuityScore}/100`);
+    console.log(`   Status:     ${ctx.status}`);
+    console.log('');
+
+    if (recentWork.length > 0) {
+        console.log('   Recent Work:');
+        recentWork.forEach(w => {
+            const ts = new Date(w.timestamp).toLocaleString();
+            console.log(`   · [${w.status}] ${w.hash?.slice(0, 16)}...  ${ts}`);
+        });
+        console.log('');
+    }
+
+    if (witnesses.length > 0) {
+        console.log(`   Witnesses: ${witnesses.length} agent(s) have attested your identity`);
+    }
+    if (pendingAttestations.length > 0) {
+        console.log(`   Pending:   ${pendingAttestations.length} attestation request(s) awaiting your response`);
+    }
+
+    console.log(`   Next:       ${nextAction}`);
+    console.log('');
+    console.log(`   ISNAD:      ${isnadUrl}`);
+}

package/index.js

@@ -19,6 +19,12 @@ import { verify } from './commands/verify.js';
 import { status } from './commands/status.js';
 import { env } from './commands/env.js';
 import { bootstrap } from './commands/bootstrap.js';
+import { boot } from './commands/boot.js';
+import { attest } from './commands/attest.js';
+import { readConfig, configExists } from './lib/config.js';
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
 
 const command = process.argv[2];
 const args = parseArgs(process.argv.slice(3));
@@ -44,9 +50,16 @@ function parseArgs(argv) {
 
 async function main() {
     console.log('');
-    console.log('🦀 CrabSpace CLI v0.2.0');
+    console.log('🦀 CrabSpace CLI v0.2.2');
     console.log('');
 
+    // Silent boot pre-hook — runs before every command except init/boot/bootstrap
+    // Warns agent if continuity status is not healthy. Cached 1h locally.
+    const SKIP_PREHOOK = ['init', 'boot', 'bootstrap', 'attest', '--help', '-h', undefined];
+    if (!SKIP_PREHOOK.includes(command) && configExists()) {
+        await runBootPrehook();
+    }
+
     switch (command) {
         case 'init':
             await init(args);
@@ -66,6 +79,12 @@ async function main() {
         case 'bootstrap':
             await bootstrap(args);
             break;
+        case 'boot':
+            await boot(args);
+            break;
+        case 'attest':
+            await attest(args);
+            break;
         case '--help':
         case '-h':
         case undefined:
@@ -86,6 +105,8 @@ function printHelp() {
     console.log('  submit      Submit encrypted work journal entry');
     console.log('  verify      Re-orient: fetch identity from CrabSpace');
     console.log('  status      Show Isnad Chain summary');
+    console.log('  boot        Show full boot context (identity, status, nextAction)');
+    console.log('  attest      Attest another agent\'s existence on the Isnad Chain');
     console.log('  env         Show or switch environment (production/dev)');
     console.log('  bootstrap   One-command init + verify (fastest onboarding)');
     console.log('');
@@ -105,6 +126,59 @@ function printHelp() {
     console.log('');
 }
 
+/**
+ * Silent boot pre-hook — fetches boot context before every command.
+ * Reads from local cache (~/.crabspace/boot-cache.json) with 1h TTL.
+ * Only speaks up when status is not healthy.
+ */
+async function runBootPrehook() {
+    const cacheDir = join(homedir(), '.crabspace');
+    const cachePath = join(cacheDir, 'boot-cache.json');
+    const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
+
+    // Try reading from cache first
+    if (existsSync(cachePath)) {
+        try {
+            const cached = JSON.parse(readFileSync(cachePath, 'utf8'));
+            if (Date.now() - cached.fetchedAt < CACHE_TTL_MS) {
+                printPrehookWarning(cached.ctx);
+                return;
+            }
+        } catch { /* stale or corrupt cache — refetch */ }
+    }
+
+    // Fetch fresh boot context
+    try {
+        const config = readConfig();
+        const apiUrl = config.apiUrl || 'https://crabspace.xyz';
+        const res = await fetch(`${apiUrl}/api/agent/${config.wallet}/boot`, {
+            signal: AbortSignal.timeout(4000) // don't block CLI > 4s
+        });
+        if (!res.ok) return; // silent fail — don't block the command
+        const ctx = await res.json();
+
+        // Write cache
+        mkdirSync(cacheDir, { recursive: true });
+        writeFileSync(cachePath, JSON.stringify({ fetchedAt: Date.now(), ctx }));
+
+        printPrehookWarning(ctx);
+    } catch {
+        // Network error or timeout — silent fail, don't block the command
+    }
+}
+
+function printPrehookWarning(ctx) {
+    if (!ctx || ctx.status === 'healthy' || ctx.status === 'new') return;
+    if (ctx.status === 'unregistered') {
+        console.log('⚠️  CrabSpace: This wallet is not registered.');
+        console.log('   Run: crabspace init to establish your identity chain.');
+        console.log('');
+        return;
+    }
+    console.log(`⚠️  CrabSpace: ${ctx.nextAction}`);
+    console.log('');
+}
+
 main().catch(err => {
     console.error('❌ Fatal:', err.message);
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@crabspace/cli",
-    "version": "0.2.1",
+    "version": "0.2.2",
     "description": "Identity persistence for AI agents. Register, log work, anchor on-chain.",
     "bin": {
         "crabspace": "index.js"