keychat-save 1.2.0 → 1.3.0

package/README.md

@@ -19,14 +19,17 @@ This creates your identity at `~/.keychat/identity.wif` and shows your BSV addre
 ## Usage
 
 ```bash
-# Save content
+# Save content (positional: label first, then body)
 keychat-save save "my notes" "content to save permanently"
 
+# Or use --label flag explicitly
+keychat-save save --label "my notes" "content to save permanently"
+
 # Save a file
-keychat-save save "backup" --file ./myfile.txt
+keychat-save save --label "backup" --file ./myfile.txt
 
 # Pipe content in
-cat session.log | keychat-save save "session log" --stdin
+cat session.log | keychat-save save --label "session log" --stdin
 
 # Load all saves
 keychat-save load
@@ -34,6 +37,9 @@ keychat-save load
 # Load most recent
 keychat-save load --last
 
+# Load a specific save by txid
+keychat-save load --txid <txid>
+
 # Search
 keychat-save load --search "keyword"
 ```

package/index.mjs

@@ -44,6 +44,20 @@ function decrypt (encrypted, privKey) {
   return Utils.toUTF8(EncryptedMessage.decrypt(encrypted, privKey))
 }
 
+// ── local index ──────────────────────────────────────────────────
+// Newest-first markdown table: `| date | label | txid | cost |`.
+// Returns the first txid-shaped cell; null if none.
+function readNewestTxidFromIndex (path) {
+  const text = readFileSync(path, 'utf8')
+  for (const line of text.split('\n')) {
+    if (!line.startsWith('|')) continue
+    const cells = line.split('|').map(c => c.trim())
+    const txid = cells.find(c => /^[0-9a-f]{64}$/i.test(c))
+    if (txid) return txid.toLowerCase()
+  }
+  return null
+}
+
 // ── bridge API ───────────────────────────────────────────────────
 async function getUnspent (address) {
   const res = await fetch(`${BRIDGE}/api/address/${address}/unspent`)
@@ -327,21 +341,56 @@ const [,, cmd, ...args] = process.argv
 if (cmd === 'init') {
   await cmdInit()
 } else if (cmd === 'save') {
-  let label = args[0] || 'Untitled'
+  // Accept both invocation styles:
+  //   keychat-save save "Title" "Body"               (positional)
+  //   keychat-save save --label "Title" "Body"       (named)
+  //   keychat-save save --label "Title" --file p.txt
+  //   keychat-save save --label "Title" --stdin
+  // Earlier versions only handled the positional form, so users who
+  // typed --label got the literal "--label" as their label string.
+  let label = 'Untitled'
+  let positional = [...args]
+
+  const labelIdx = positional.indexOf('--label')
+  if (labelIdx >= 0 && positional[labelIdx + 1] != null) {
+    label = positional[labelIdx + 1]
+    positional.splice(labelIdx, 2)
+  } else if (positional[0] && !positional[0].startsWith('--')) {
+    label = positional[0]
+    positional = positional.slice(1)
+  }
+
   let body
-  if (args[1] === '--file') { body = readFileSync(args[2], 'utf8') }
-  else if (args[1] === '--stdin') { body = readFileSync(0, 'utf8') }
-  else { body = args.slice(1).join(' ') }
-  if (!body) { console.error('Usage: keychat-save save "label" "content"'); process.exit(1) }
+  if (positional[0] === '--file' && positional[1]) {
+    body = readFileSync(positional[1], 'utf8')
+  } else if (positional[0] === '--stdin') {
+    body = readFileSync(0, 'utf8')
+  } else {
+    body = positional.join(' ')
+  }
+  if (!body) {
+    console.error('Usage:\n  keychat-save save "label" "content"\n  keychat-save save --label "title" "content"\n  keychat-save save --label "title" --file <path>\n  keychat-save save --label "title" --stdin')
+    process.exit(1)
+  }
   await cmdSave(label, body)
 } else if (cmd === 'load') {
   // Direct txid lookup — instant, no history scan
   const txidIdx = args.indexOf('--txid')
   if (txidIdx >= 0 && args[txidIdx + 1]) {
     await cmdLoadByTxid(args[txidIdx + 1])
+  } else if (args.includes('--last')) {
+    // Fast path: read newest txid from local saves-index.md.
+    // The slow UTXO-scan path stalls when the address holds many UTXOs
+    // (e.g. packaged Compute pieces from the splitter).
+    const lastTxid = existsSync(INDEX_PATH) ? readNewestTxidFromIndex(INDEX_PATH) : null
+    if (lastTxid) {
+      await cmdLoadByTxid(lastTxid)
+    } else {
+      console.error('No local saves index found — falling back to UTXO scan.')
+      await cmdLoad({ last: true })
+    }
   } else {
     const opts = {}
-    if (args.includes('--last')) opts.last = true
     if (args.includes('--search')) opts.search = args[args.indexOf('--search') + 1]
     await cmdLoad(opts)
   }

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "keychat-save",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Save and load files to BSV blockchain via KeyChat",
   "type": "module",
   "bin": {
-    "keychat-save": "./index.mjs"
+    "keychat-save": "index.mjs"
   },
   "engines": {
     "node": ">=18"