howtofixcli 0.7.6 → 0.7.8

package/dist/args.js

@@ -149,6 +149,8 @@ usage:
   howtofix -p "explain this repo"
   howtofix preset new|check|pack     author a preset
   howtofix doctor|models|sessions    inspect the installation
+  howtofix sessions --search <text> find a session by what was said in it
+  howtofix sessions --export <n>    print session n from the list as markdown
 
 options:
   -p, --print          run one prompt and print the answer

package/dist/brand.js

@@ -1,5 +1,5 @@
 export const APP_TITLE = "HowToFix";
-export const APP_VERSION = "0.7.6";
+export const APP_VERSION = "0.7.8";
 export const SYSTEM_APPEND = [
     // House style: RFC 2119 keywords in caps, one claim per line, the
     // highest-stakes rules at

package/dist/cli-checkin.js

@@ -96,21 +96,25 @@ export async function claimCliCheckin(token, options) {
     const timeoutMs = options?.timeoutMs ?? 15_000;
     const trimmed = token.trim();
     if (!trimmed)
-        return { ok: false, alreadyClaimed: false, quotaAwarded: 0, message: "no token given" };
+        return { ok: false, alreadyClaimed: false, blocked: false, quotaAwarded: 0, message: "no token given" };
     try {
         const { status, body } = await callCheckin(trimmed, "POST", baseUrl, fetchImpl, timeoutMs);
         if (body.success === true) {
             const data = (body.data ?? {});
-            return { ok: true, alreadyClaimed: false, quotaAwarded: Number(data.quota_awarded ?? 0) || 0, message: "" };
+            return { ok: true, alreadyClaimed: false, blocked: false, quotaAwarded: Number(data.quota_awarded ?? 0) || 0, message: "" };
         }
         const message = typeof body.message === "string" ? body.message : `the gateway answered ${status}`;
+        // A device that already claimed for another account is a block, not the
+        // everyday "today is spent" state: the upstream is closed until staff clear
+        // it, so this must not be swallowed as a normal second start.
+        const blocked = /device already claimed|account blocked|appeal/i.test(message);
         // The server's own sentence for "today is spent" — recognised so a normal
         // second start never reads as an error.
-        const alreadyClaimed = /签到|check-?in|already|今日/.test(message) && !/not enabled/i.test(message);
-        return { ok: false, alreadyClaimed, quotaAwarded: 0, message };
+        const alreadyClaimed = !blocked && /签到|check-?in|already|今日/.test(message) && !/not enabled/i.test(message);
+        return { ok: false, alreadyClaimed, blocked, quotaAwarded: 0, message };
     }
     catch (cause) {
         const aborted = cause instanceof Error && cause.name === "AbortError";
-        return { ok: false, alreadyClaimed: false, quotaAwarded: 0, message: aborted ? "the gateway did not answer the check-in in time" : "could not reach the gateway" };
+        return { ok: false, alreadyClaimed: false, blocked: false, quotaAwarded: 0, message: aborted ? "the gateway did not answer the check-in in time" : "could not reach the gateway" };
     }
 }

package/dist/commands.js

@@ -168,6 +168,26 @@ export function listSessionFiles(limit = 15, root = AGENT_DIR) {
     return rows.sort((a, b) => b.modified - a.modified).slice(0, limit);
 }
 export function runSessions(argv) {
+    const searchIndex = argv.indexOf("--search");
+    if (searchIndex >= 0) {
+        const query = argv[searchIndex + 1]?.trim();
+        if (!query) {
+            console.error(`${APP_TITLE}: sessions: --search needs a word or phrase`);
+            return 2;
+        }
+        const hits = searchSessions(query);
+        if (hits.length === 0) {
+            console.log(`  no session mentions "${query}"`);
+            return 0;
+        }
+        for (const hit of hits) {
+            const when = new Date(hit.row.modified).toISOString().replace("T", " ").slice(0, 16);
+            console.log(`  ${when}  ${hit.row.project}  (${hit.matches} hit${hit.matches === 1 ? "" : "s"})`);
+            console.log(`                     ${hit.row.file}`);
+            console.log(`                     ${hit.snippet}`);
+        }
+        return 0;
+    }
     const limitIndex = argv.indexOf("--limit");
     const limit = limitIndex >= 0 ? Number(argv[limitIndex + 1]) || 15 : 15;
     const rows = listSessionFiles(limit);
@@ -175,14 +195,101 @@ export function runSessions(argv) {
         console.log(`  no saved sessions under ${join(AGENT_DIR, "sessions")}`);
         return 0;
     }
-    for (const row of rows) {
+    const exportIndex = argv.indexOf("--export");
+    if (exportIndex >= 0) {
+        const which = Number(argv[exportIndex + 1]);
+        if (!Number.isInteger(which) || which < 1 || which > rows.length) {
+            console.error(`${APP_TITLE}: sessions: --export needs a number from the list (1-${rows.length})`);
+            return 2;
+        }
+        const row = rows[which - 1];
+        try {
+            console.log(exportSessionMarkdown(row.file));
+        }
+        catch (error) {
+            reportError(APP_TITLE, "sessions", error);
+            return 1;
+        }
+        return 0;
+    }
+    rows.forEach((row, index) => {
         const when = new Date(row.modified).toISOString().replace("T", " ").slice(0, 16);
         const kb = Math.round(row.bytes / 1024);
-        console.log(`  ${when}  ${String(kb).padStart(6)}k  ${row.project}`);
+        console.log(`  ${String(index + 1).padStart(2)}  ${when}  ${String(kb).padStart(6)}k  ${row.project}`);
         console.log(`                     ${row.file}`);
-    }
+    });
     return 0;
 }
+/** Text of one JSONL line, whether its content is a string or content blocks. */
+function lineText(line) {
+    try {
+        const entry = JSON.parse(line);
+        const content = entry.message?.content;
+        if (typeof content === "string")
+            return content.replace(/\s+/g, " ").trim();
+        if (Array.isArray(content)) {
+            return content
+                .map((block) => (block && typeof block === "object" && "text" in block ? String(block.text) : ""))
+                .join(" ")
+                .replace(/\s+/g, " ")
+                .trim();
+        }
+    }
+    catch {
+        // A line that does not parse is still searchable as raw text.
+    }
+    return line.replace(/\s+/g, " ").trim();
+}
+/** Sessions whose text mentions `query`, with the first matching line as evidence. */
+export function searchSessions(query, limit = 10, root = AGENT_DIR) {
+    const needle = query.toLowerCase();
+    const hits = [];
+    for (const row of listSessionFiles(500, root)) {
+        let text;
+        try {
+            text = readFileSync(row.file, "utf8");
+        }
+        catch {
+            continue;
+        }
+        let matches = 0;
+        let snippet = "";
+        for (const line of text.split("\n")) {
+            if (!line.toLowerCase().includes(needle))
+                continue;
+            matches++;
+            if (!snippet)
+                snippet = lineText(line).slice(0, 160);
+        }
+        if (matches > 0)
+            hits.push({ row, matches, snippet });
+        if (hits.length >= limit)
+            break;
+    }
+    return hits;
+}
+/** A session as markdown, for pasting into an issue or a chat. */
+export function exportSessionMarkdown(file) {
+    const out = [`# Session ${file.split(/[\\/]/).pop() ?? file}`, ""];
+    for (const line of readFileSync(file, "utf8").split("\n")) {
+        if (!line.trim())
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (entry.type !== "message")
+            continue;
+        const text = lineText(line);
+        if (!text)
+            continue;
+        out.push(`## ${entry.message?.role ?? "unknown"}`, "", text, "");
+    }
+    return out.join("\n").trimEnd();
+}
 /** True when the file exists and is a directory — used by doctor's callers. */
 export function stateDirExists() {
     try {

package/dist/ui.js

@@ -2255,6 +2255,12 @@ export async function runWorkbench(options) {
                     note("check-in", `daily check-in claimed: +${formatQuotaUsd(claim.quotaAwarded)} credited to your howtofix.id account`);
                     refresh();
                 }
+                else if (claim.blocked) {
+                    // The account lost the upstream for device abuse. Say it once, with
+                    // the way to appeal, instead of failing silently until the first
+                    // model call returns a 403.
+                    note("check-in", claim.message);
+                }
                 return true;
             }
             catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "howtofixcli",
-  "version": "0.7.6",
+  "version": "0.7.8",
   "description": "HowToFix coding agent. Workbench TUI, sessions, background agents.",
   "type": "module",
   "bin": {
@@ -44,10 +44,10 @@
     "node": ">=22.19"
   },
   "dependencies": {
-    "@netrodev/hxf-agent-core": "^1.0.19",
-    "@netrodev/hxf-ai": "^1.0.19",
-    "@netrodev/hxf-coding-agent": "^1.0.19",
-    "@netrodev/hxf-tui": "^1.0.19",
+    "@netrodev/hxf-agent-core": "^1.0.22",
+    "@netrodev/hxf-ai": "^1.0.22",
+    "@netrodev/hxf-coding-agent": "^1.0.22",
+    "@netrodev/hxf-tui": "^1.0.22",
     "typebox": "1.3.27",
     "typescript": "7.0.2",
     "undici": "^8.10.2"