quilltap 4.10.0-dev.100 → 4.10.0-dev.105

package/README.md

@@ -193,7 +193,7 @@ quilltap db --mount-points --tables                 # Target the mount index DB
 
 The database is opened **read-only by default**. Add `--write` to make changes: it opens the database read-write, **claims the instance lock** (`<dataDir>/quilltap.lock`) for the duration, and releases it on exit. It **refuses — with no override — if a running server or another instance holds the lock**, so stop the server first. `--repl` is read-only unless combined with `--write`. Attempting a write without `--write` fails with a hint to re-run with the flag. What "held" means, and how to tell a live lock from a stale one, is [below](#locking).
 
-Compressed text columns (`chat_messages.content`, `llm_logs.request` / `response` and friends) are stored as BLOBs. Wrap them in `qt_text()` to read the text: `SELECT qt_text(content) …`.
+Compressed text columns (`chat_messages.content`, `llm_logs.request` / `response` and friends) are stored as BLOBs. A raw query's output decodes them for display, so `SELECT content …` prints text. Inside SQL — `WHERE`, `LIKE`, `substr`, `json_extract` — wrap the column in `qt_text()` to work on the text: `SELECT json_extract(qt_text(response), '$.error') …`.
 
 In the REPL, `.cols <table>` and `.find <text>` mirror the subcommand helpers.
 

package/bin/quilltap.js

@@ -14,6 +14,7 @@ const {
   openEncryptedDb,
 } = require('../lib/db-helpers');
 const { resolveInstance } = require('../lib/instances');
+const { decodeCompressedTextInRows } = require('../lib/text-codec');
 const { resolveModuleDir, ensureNativeModules, ensureDatabaseNativeModule } = require('../lib/native-modules');
 
 const PACKAGE_DIR = path.resolve(__dirname, '..');
@@ -1042,6 +1043,8 @@ async function dbCommand(args) {
       const stmt = db.prepare(sql);
       if (stmt.reader) {
         const rows = stmt.all();
+        // Compressed text columns arrive as Buffers; print them as text (bug 173).
+        decodeCompressedTextInRows(rows);
         if (asJson) {
           console.log(JSON.stringify(rows, null, 2));
         } else if (rows.length === 0) {
@@ -1110,6 +1113,7 @@ async function dbCommand(args) {
             const stmt = db.prepare(trimmed);
             if (stmt.reader) {
               const rows = stmt.all();
+              decodeCompressedTextInRows(rows);
               if (rows.length === 0) console.log('(no results)');
               else console.table(rows);
             } else {

package/lib/text-codec.js

@@ -58,4 +58,33 @@ function registerTextCodecFunction(db) {
   db.function('qt_text', { deterministic: true }, (value) => decodeText(value));
 }
 
-module.exports = { decodeText, isCompressedTextBlob, registerTextCodecFunction };
+/**
+ * Decode every compressed-text value in a set of result rows, in place, for
+ * printing. Raw SQL (`quilltap db "SELECT content …"`, `--repl`) hands BLOBs to
+ * `JSON.stringify` / `console.table` as Buffers, which print as
+ * `{"type":"Buffer","data":[…]}` and read as data loss (bug 173). Only values
+ * carrying the `0x51 0x01 0x01` header are touched — embedding BLOBs and other
+ * binary columns pass through unchanged, as does anything already text
+ * (including an explicit `qt_text()`). Returns the number of values decoded.
+ */
+function decodeCompressedTextInRows(rows) {
+  let decoded = 0;
+  if (!Array.isArray(rows)) return decoded;
+  for (const row of rows) {
+    if (!row || typeof row !== 'object') continue;
+    for (const key of Object.keys(row)) {
+      if (isCompressedTextBlob(row[key])) {
+        row[key] = decodeText(row[key]);
+        decoded++;
+      }
+    }
+  }
+  return decoded;
+}
+
+module.exports = {
+  decodeText,
+  decodeCompressedTextInRows,
+  isCompressedTextBlob,
+  registerTextCodecFunction,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quilltap",
-  "version": "4.10.0-dev.100",
+  "version": "4.10.0-dev.105",
   "description": "Self-hosted AI workspace for writers, worldbuilders, and roleplayers. Run with npx quilltap.",
   "author": {
     "name": "Charles Sebold",