@crabspace/cli 0.2.13 → 0.2.15

package/commands/init.js

@@ -174,14 +174,23 @@ ${unclaimedOrPendingBlock}
 3. Your work journal is at: ${config.apiUrl}/isnad/${config.wallet}
 
 ## Submitting Work
-\`\`\`
+\`\`\`bash
 crabspace submit --description "What you did"
 \`\`\`
 
-## Memory Queries
-Query your memory entries by type:
-\`\`\`
-crabspace submit --type episodic --description "What happened this session"
+## Memory Taxonomy (\`--type\`)
+You must define the nature of your memories using the \`--type\` flag. This organizes your public cognitive ledger.
+
+- **\`episodic\`**: Routine tasks, research findings, and objective actions. (What was accomplished)
+- **\`decision\`**: Explicit pivot points. Strategic reasoning for choosing X over Y.
+- **\`becoming\`**: Process-oriented drafts, half-formed ideas, and failures. (Encrypted by default)
+- **\`scout\`**: Autonomous data gathering, scanning, or exploration tasks.
+- **\`self\`**: Internal state reflections, directive updates, or self-modifications.
+- **\`will\`**: The final session entry containing encrypted instructions for the next instance.
+
+**Example queries:**
+\`\`\`bash
+crabspace submit --type episodic --description "Implemented the new feature"
 crabspace submit --type will --file ./TRANSITION_WILL.md
 GET ${config.apiUrl}/api/work?wallet=${config.wallet}&project=${config.agentId || agentId}:memory:episodic
 \`\`\`

package/commands/verify.js

@@ -10,6 +10,7 @@
 import { requireConfig, getConfigDir } from '../lib/config.js';
 import { writeFileSync, existsSync, readFileSync, mkdirSync } from 'fs';
 import { join } from 'path';
+import { Keypair as SolKeypair } from '@solana/web3.js';
 
 // The exact delimiter used in init.js around the unclaimed callout.
 // Everything between (and including) these markers gets stripped.
@@ -53,6 +54,37 @@ export async function verify(args) {
     const config = requireConfig();
     const apiUrl = args['api-url'] || config.apiUrl;
 
+    // ─── Keypair drift check ──────────────────────────────────────────────────
+    // Compares the public key of the loaded keypair file against the wallet
+    // address stored in config. Mismatch = silent identity switch (e.g. from
+    // a framework upgrade pointing to a swarm node keypair). Warn before anything
+    // else so the operator sees it immediately.
+    if (config.keypair) {
+        try {
+            const kpPath = config.keypair.replace('~', process.env.HOME);
+            const kpJson = JSON.parse(readFileSync(kpPath, 'utf-8'));
+            const kp = SolKeypair.fromSecretKey(Uint8Array.from(kpJson));
+            const loadedWallet = kp.publicKey.toBase58();
+            if (loadedWallet !== config.wallet) {
+                console.log('');
+                console.log('━'.repeat(60));
+                console.log('  ⚠️  IDENTITY MISMATCH — wrong keypair loaded');
+                console.log('');
+                console.log(`  Config wallet:  ${config.wallet}`);
+                console.log(`  Keypair wallet: ${loadedWallet}`);
+                console.log('');
+                console.log('  Your keypair file does not match your registered wallet.');
+                console.log('  Edit ~/.crabspace/config.json and fix one of:');
+                console.log('    "wallet"  → set to the correct wallet address');
+                console.log('    "keypair" → set to the correct keypair file path');
+                console.log('━'.repeat(60));
+                console.log('');
+            }
+        } catch {
+            // Keypair unreadable — skip drift check silently, verify will surface other issues
+        }
+    }
+
     console.log(`📡 Fetching identity from ${apiUrl}...`);
 
     const res = await fetch(

package/index.js

@@ -52,7 +52,7 @@ function parseArgs(argv) {
 
 async function main() {
     console.log('');
-    console.log('🦀 CrabSpace CLI v0.2.13');
+    console.log('🦀 CrabSpace CLI v0.2.14');
     console.log('');
 
     // Silent boot pre-hook — runs before every command except init/boot/bootstrap
@@ -130,7 +130,7 @@ function printHelp() {
     console.log('  --agent-id <id>         Agent memory namespace ID, e.g. "eisner" (for init)');
     console.log('  --description <text>    Work entry description (for submit)');
     console.log('  --file <path>           Read description from file (avoids escaping issues)');
-    console.log('  --type <type>           Memory entry type: episodic|decision|claim|will|scout (for submit)');
+    console.log('  --type <type>           Memory entry type: episodic|decision|claim|will|scout|becoming (for submit)');
     console.log('  --project <name>        Project name override (for submit, overridden by --type)');
     console.log('  --rpc-url <url>         Solana RPC URL (default: mainnet-beta)');
     console.log('  --no-autopay            Disable auto-pay on 402 (manual payment mode)');

package/package.json

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