mira-harness 0.2.6 → 0.2.7

package/dist/cli.js

@@ -434,6 +434,9 @@ function clearTitle() {
 // src/commands/report.ts
 import { readFileSync as readFileSync2, writeFileSync } from "node:fs";
 import { resolve as resolve3 } from "node:path";
+function isRunRecord(x) {
+  return typeof x === "object" && x !== null && Array.isArray(x.messages) && typeof x.sent === "string";
+}
 function loadRunRecords(inFile, category) {
   const path = inFile ? resolve3(process.cwd(), inFile) : RUNS_FILE;
   const raw = readFileSync2(path, "utf8");
@@ -444,7 +447,9 @@ function loadRunRecords(inFile, category) {
     if (!t)
       continue;
     try {
-      records.push(JSON.parse(t));
+      const rec = JSON.parse(t);
+      if (isRunRecord(rec))
+        records.push(rec);
     } catch {}
   }
   return category ? records.filter((r) => r.category === category) : records;
@@ -867,7 +872,14 @@ function req(name) {
   return v;
 }
 var tgEnv = {
-  apiId: () => Number(req("TG_API_ID")),
+  apiId: () => {
+    const raw = req("TG_API_ID");
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n <= 0) {
+      throw new Error(`TG_API_ID must be a positive integer (got "${raw}") — see .env.example`);
+    }
+    return n;
+  },
   apiHash: () => req("TG_API_HASH"),
   session: () => process.env.TG_SESSION ?? "",
   miraPeer: process.env.MIRA_PEER ?? "mira",
@@ -1325,14 +1337,14 @@ async function send(rawMessage, opts = {}) {
   let verdict;
   try {
     const result = await withProgress(`@${peer}`, () => sendAndCollect(client, peer, message, collect), opts.quiet);
+    if (opts.expect)
+      verdict = evaluate(opts.expect, result);
     if (!opts.noLog)
-      await appendRun(result);
+      await appendRun(result, verdict ? { assert: verdict } : {});
     if (!opts.quiet) {
       note(result.timedOut ? c.yellow("no reply (timed out)") : c.green(`${result.messages.length} message(s) · first reply ${((result.firstReplyMs ?? 0) / 1000).toFixed(1)}s`));
     }
     console.log(JSON.stringify(result, null, 2));
-    if (opts.expect)
-      verdict = evaluate(opts.expect, result);
   } finally {
     await client.disconnect();
   }
@@ -1634,10 +1646,19 @@ if (process.argv.length <= 2) {
   banner(version);
   console.log(`  Drive @mira from your terminal — QA, learn, and assert on its behavior.
 `);
-  console.log(`  Commands  ${c.cyan("login · doctor · send · loop · catalog · watch")}`);
-  console.log(`            ${c.cyan("report · stats · diff · assert · schema")}
-`);
-  console.log(`  Run ${c.bold("mira-harness --help")} for options + examples, or ${c.bold("mira-harness <command> --help")}.`);
+  console.log(`  ${c.bold("Commands")}`);
+  const cmds = program.commands.filter((cmd) => cmd.name() !== "help");
+  const pad = Math.max(...cmds.map((cmd) => cmd.name().length));
+  for (const cmd of cmds) {
+    console.log(`    ${c.cyan(cmd.name().padEnd(pad))}  ${c.dim(cmd.description())}`);
+  }
+  console.log(`
+  ${c.bold("Quick start")}`);
+  for (const ex of ["login", "doctor", 'send "What can you do?"', "loop --category core"]) {
+    console.log(c.dim(`    $ mira-harness ${ex}`));
+  }
+  console.log(`
+  Run ${c.bold("mira-harness --help")} for all options + examples, or ${c.bold("mira-harness <command> --help")}.`);
   process.exit(0);
 }
 program.parseAsync(process.argv).then(() => process.exit(0)).catch((e) => {

package/dist/commands/report.d.ts

@@ -7,9 +7,9 @@ export type RunRecord = ProbeResult & {
     assert?: Verdict;
 };
 /**
- * Read the JSONL run log into records (malformed lines skipped). Throws ENOENT when
- * the file is absent — callers decide how to surface that. Shared by `report` and
- * `stats` so the two stay in lockstep on the log format.
+ * Read the JSONL run log into records (malformed/wrong-shape lines skipped). Throws
+ * ENOENT when the file is absent — callers decide how to surface that. Shared by
+ * `report` and `stats` so the two stay in lockstep on the log format.
  */
 export declare function loadRunRecords(inFile?: string, category?: string): RunRecord[];
 export declare function buildReport(records: RunRecord[]): string;

package/dist/env.d.ts

@@ -7,6 +7,8 @@
  */
 import "dotenv/config";
 export declare const tgEnv: {
+    /** Telegram api_id — a positive integer. Reject non-numeric/zero up front so
+     *  `doctor` flags a bad value instead of passing NaN into GramJS (cryptic later). */
     apiId: () => number;
     apiHash: () => string;
     /** Empty until `mira-harness login` mints it; required by send/loop. */

package/dist/index.js

@@ -414,7 +414,14 @@ function req(name) {
   return v;
 }
 var tgEnv = {
-  apiId: () => Number(req("TG_API_ID")),
+  apiId: () => {
+    const raw = req("TG_API_ID");
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n <= 0) {
+      throw new Error(`TG_API_ID must be a positive integer (got "${raw}") — see .env.example`);
+    }
+    return n;
+  },
   apiHash: () => req("TG_API_HASH"),
   session: () => process.env.TG_SESSION ?? "",
   miraPeer: process.env.MIRA_PEER ?? "mira",
@@ -596,6 +603,9 @@ async function appendRun(result, meta = {}) {
 }
 
 // src/commands/report.ts
+function isRunRecord(x) {
+  return typeof x === "object" && x !== null && Array.isArray(x.messages) && typeof x.sent === "string";
+}
 function loadRunRecords(inFile, category) {
   const path = inFile ? resolve3(process.cwd(), inFile) : RUNS_FILE;
   const raw = readFileSync2(path, "utf8");
@@ -606,7 +616,9 @@ function loadRunRecords(inFile, category) {
     if (!t)
       continue;
     try {
-      records.push(JSON.parse(t));
+      const rec = JSON.parse(t);
+      if (isRunRecord(rec))
+        records.push(rec);
     } catch {}
   }
   return category ? records.filter((r) => r.category === category) : records;

package/dist/mcp.js

@@ -424,7 +424,14 @@ function req(name) {
   return v;
 }
 var tgEnv = {
-  apiId: () => Number(req("TG_API_ID")),
+  apiId: () => {
+    const raw = req("TG_API_ID");
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n <= 0) {
+      throw new Error(`TG_API_ID must be a positive integer (got "${raw}") — see .env.example`);
+    }
+    return n;
+  },
   apiHash: () => req("TG_API_HASH"),
   session: () => process.env.TG_SESSION ?? "",
   miraPeer: process.env.MIRA_PEER ?? "mira",
@@ -607,6 +614,9 @@ async function appendRun(result, meta = {}) {
 }
 
 // src/commands/report.ts
+function isRunRecord(x) {
+  return typeof x === "object" && x !== null && Array.isArray(x.messages) && typeof x.sent === "string";
+}
 function loadRunRecords(inFile, category) {
   const path = inFile ? resolve3(process.cwd(), inFile) : RUNS_FILE;
   const raw = readFileSync2(path, "utf8");
@@ -617,7 +627,9 @@ function loadRunRecords(inFile, category) {
     if (!t)
       continue;
     try {
-      records.push(JSON.parse(t));
+      const rec = JSON.parse(t);
+      if (isRunRecord(rec))
+        records.push(rec);
     } catch {}
   }
   return category ? records.filter((r) => r.category === category) : records;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mira-harness",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "A CLI + MCP dev-tool for communicating with the @mira Telegram bot — capture its full reply (buttons/links/media) and run a self-driving experiment catalog.",
   "type": "module",
   "bin": {