@wirecat/cli-core 0.361.0 → 0.363.0

package/dist/store/sqlite/meeting-findings.js

@@ -1,12 +1,9 @@
 import { CliError } from "@wirecat/cli-base";
 import { findingHash, MEETING_FINDINGS_KIND, meetingCueFingerprint, meetingFindingFingerprint, parseMeetingReference, validateMeetingFindings, } from "../../meetings/index.js";
-import { factOperationsOver } from "./facts.js";
-import { authorActor, linkEvidence } from "./memories.js";
-import { requiredThing } from "./notes.js";
+import { findingsCoreOver } from "./findings-core.js";
+import { authorActor } from "./memories.js";
 import { proposalOperationsOver } from "./proposed-actions.js";
-import { taskRowOf } from "./things.js";
 import { write } from "./transaction.js";
-import { workTaskOperationsOver } from "./work-tasks.js";
 const stale = () => {
     throw new CliError("validation_error", "meeting findings changed since they were read; stage a new batch", {
         reason: "meeting-findings.stale",
@@ -18,8 +15,6 @@ const invalid = (message) => {
 export const meetingFindingsStoreOver = (context) => {
     const { database } = context;
     const proposals = proposalOperationsOver(context);
-    const facts = factOperationsOver(context);
-    const tasks = workTaskOperationsOver(context);
     const accountId = (key) => {
         if (!key ||
             typeof key.provider !== "string" ||
@@ -68,109 +63,56 @@ export const meetingFindingsStoreOver = (context) => {
             receipt: proposal.result,
         };
     };
+    const core = findingsCoreOver(context, MEETING_FINDINGS_KIND);
     const snapshot = (account, input) => {
         let readBytes = 0;
-        const seen = new Map();
-        for (const finding of input.findings) {
-            const project = requiredThing(database, finding.project, "the project");
-            if (project.type !== "project")
-                return invalid("a finding needs an owner project");
-            const projectRow = database
-                .prepare("SELECT id,key,name,description,type,scope,updated_at FROM projects WHERE id=? AND account_id IS NULL AND deleted_at IS NULL")
-                .get(project.id);
-            if (!projectRow)
-                throw new CliError("not_found", "the owner project is unavailable");
-            seen.set(finding.project, projectRow);
-            if (finding.kind === "task" && finding.assignee) {
-                const person = requiredThing(database, finding.assignee, "the assignee");
-                if (person.type !== "person")
-                    return invalid("the assignee must be a stored person");
-                const personRow = database.prepare("SELECT id,name,updated_at FROM persons WHERE id=?").get(person.id);
-                if (!personRow)
-                    throw new CliError("not_found", "the assignee is unavailable");
-                seen.set(finding.assignee, personRow);
-            }
-            for (const evidence of finding.evidence) {
-                const parsed = parseMeetingReference(evidence.reference);
-                if (parsed.accountId !== account)
-                    throw new CliError("not_found", "the cited cue belongs to another account");
-                const membership = database
-                    .prepare("SELECT id,updated_at,confirmed,source FROM links WHERE from_type='meeting' AND from_id=? AND to_type='project' AND to_id=? AND kind='member-of' AND anchor IS NULL AND confirmed=1")
-                    .get(parsed.meetingId, project.id);
-                if (!membership)
-                    return invalid("each cited meeting needs confirmed membership in the finding's project");
-                seen.set(`${finding.project}/${parsed.meetingId}`, membership);
-                if (seen.has(evidence.reference)) {
-                    if (seen.get(evidence.reference) !== evidence.fingerprint)
-                        return stale();
-                    continue;
-                }
-                const query = "FROM meeting_transcript_rows r JOIN meeting_transcripts t ON t.id=r.meeting_transcript_id JOIN meetings m ON m.id=t.meeting_id WHERE m.id=? AND m.account_id=? AND m.deleted_at IS NULL AND t.id=? AND t.deleted_at IS NULL AND t.superseded_at IS NULL AND r.position=?";
-                const params = [parsed.meetingId, account, parsed.transcriptId, parsed.cuePosition];
-                const budget = database
-                    .prepare(`SELECT length(CAST(r.text AS BLOB))+coalesce(length(CAST(r.speaker_name AS BLOB)),0)+coalesce(length(CAST(t.content_hash AS BLOB)),0) AS bytes ${query}`)
-                    .get(...params);
-                if (!budget)
-                    return stale();
-                readBytes += Number(budget.bytes);
-                if (!Number.isSafeInteger(readBytes) || readBytes > 65536)
-                    return invalid("finding evidence exceeds the 65536-byte stored text budget");
-                const row = database
-                    .prepare(`SELECT t.content_hash,r.start_ms,r.end_ms,r.speaker_participant_id,r.speaker_name,r.text ${query}`)
-                    .get(...params);
-                if (!row)
+        return core.snapshot(input, (evidence, finding, projectId, seen) => {
+            const parsed = parseMeetingReference(evidence.reference);
+            if (parsed.accountId !== account)
+                throw new CliError("not_found", "the cited cue belongs to another account");
+            const membership = database
+                .prepare("SELECT id,updated_at,confirmed,source FROM links WHERE from_type='meeting' AND from_id=? AND to_type='project' AND to_id=? AND kind='member-of' AND anchor IS NULL AND confirmed=1")
+                .get(parsed.meetingId, projectId);
+            if (!membership)
+                return invalid("each cited meeting needs confirmed membership in the finding's project");
+            seen.set(`${finding.project}/${parsed.meetingId}`, membership);
+            if (seen.has(evidence.reference)) {
+                if (seen.get(evidence.reference) !== evidence.fingerprint)
                     return stale();
-                const fingerprint = meetingCueFingerprint({
-                    reference: evidence.reference,
-                    transcriptId: parsed.transcriptId,
-                    contentHash: row.content_hash == null ? null : String(row.content_hash),
-                    position: parsed.cuePosition,
-                    startMs: Number(row.start_ms),
-                    endMs: Number(row.end_ms),
-                    speakerParticipantId: row.speaker_participant_id == null ? null : Number(row.speaker_participant_id),
-                    speakerName: row.speaker_name == null ? null : String(row.speaker_name),
-                    text: String(row.text),
-                });
-                if (fingerprint !== evidence.fingerprint)
-                    return stale();
-                seen.set(evidence.reference, fingerprint);
+                return;
             }
-        }
-        return findingHash([...seen].sort(([a], [b]) => a.localeCompare(b)));
-    };
-    const previous = (account, fingerprint) => {
-        const row = database
-            .prepare("SELECT substr(j.value,1,4096) AS item FROM proposed_actions p,json_each(p.result,'$.items') j WHERE p.account_id=? AND p.kind=? AND p.status='approved' AND json_extract(j.value,'$.fingerprint')=? ORDER BY p.id LIMIT 1")
-            .get(account, MEETING_FINDINGS_KIND, fingerprint);
-        return row ? JSON.parse(String(row.item)) : undefined;
-    };
-    const create = (finding, agent) => {
-        const evidence = finding.evidence.map((item) => item.reference);
-        if (finding.kind === "fact") {
-            const fact = facts.add({
-                type: finding.type,
-                statement: finding.statement,
-                project: finding.project,
-                evidence,
-                by: agent,
+            const query = "FROM meeting_transcript_rows r JOIN meeting_transcripts t ON t.id=r.meeting_transcript_id JOIN meetings m ON m.id=t.meeting_id WHERE m.id=? AND m.account_id=? AND m.deleted_at IS NULL AND t.id=? AND t.deleted_at IS NULL AND t.superseded_at IS NULL AND r.position=?";
+            const params = [parsed.meetingId, account, parsed.transcriptId, parsed.cuePosition];
+            const budget = database
+                .prepare(`SELECT length(CAST(r.text AS BLOB))+coalesce(length(CAST(r.speaker_name AS BLOB)),0)+coalesce(length(CAST(t.content_hash AS BLOB)),0) AS bytes ${query}`)
+                .get(...params);
+            if (!budget)
+                return stale();
+            readBytes += Number(budget.bytes);
+            if (!Number.isSafeInteger(readBytes) || readBytes > 65536)
+                return invalid("finding evidence exceeds the 65536-byte stored text budget");
+            const row = database
+                .prepare(`SELECT t.content_hash,r.start_ms,r.end_ms,r.speaker_participant_id,r.speaker_name,r.text ${query}`)
+                .get(...params);
+            if (!row)
+                return stale();
+            const fingerprint = meetingCueFingerprint({
+                reference: evidence.reference,
+                transcriptId: parsed.transcriptId,
+                contentHash: row.content_hash == null ? null : String(row.content_hash),
+                position: parsed.cuePosition,
+                startMs: Number(row.start_ms),
+                endMs: Number(row.end_ms),
+                speakerParticipantId: row.speaker_participant_id == null ? null : Number(row.speaker_participant_id),
+                speakerName: row.speaker_name == null ? null : String(row.speaker_name),
+                text: String(row.text),
             });
-            return facts.accept(fact.ref).ref;
-        }
-        const task = tasks.create({
-            project: finding.project,
-            title: finding.title,
-            type: finding.type,
-            description: `${finding.commitment}: ${finding.reason}`,
-            ...(finding.dueAt ? { dueAt: new Date(finding.dueAt) } : {}),
-        }, agent);
-        const id = taskRowOf(database, task.id);
-        if (id === undefined)
-            throw new CliError("configuration_error", "created finding task is unavailable");
-        linkEvidence(context, { type: finding.type, id }, evidence, "agent");
-        if (finding.assignee)
-            tasks.assign(task.id, { to: finding.assignee, role: "assignee" }, agent);
-        return task.ref;
+            if (fingerprint !== evidence.fingerprint)
+                return stale();
+            seen.set(evidence.reference, fingerprint);
+        });
     };
+    const previous = core.previous;
     return {
         stage: async (key, raw, agent) => {
             const input = validateMeetingFindings(raw);
@@ -248,23 +190,7 @@ export const meetingFindingsStoreOver = (context) => {
                 bot: proposal.proposedBy.name,
                 ...(input.agentModel === null ? {} : { model: input.agentModel }),
             };
-            const items = batch.input.findings.map((finding) => {
-                const fingerprint = meetingFindingFingerprint(finding);
-                const prior = previous(account, fingerprint);
-                if (prior) {
-                    if (accepted.includes(finding.id) && prior.status === "rejected")
-                        return invalid("this unchanged finding was already rejected; changed evidence needs a new candidate");
-                    return { ...prior, id: finding.id, reused: true };
-                }
-                const status = accepted.includes(finding.id) ? "accepted" : "rejected";
-                return {
-                    id: finding.id,
-                    fingerprint,
-                    status,
-                    reference: status === "accepted" ? create(finding, agent) : null,
-                    reused: false,
-                };
-            });
+            const items = core.outcomes(account, batch.input, accepted, agent);
             return view(proposals.approve(id, {
                 previewFingerprint: batch.fingerprint,
                 accepted,

package/dist/store/sqlite/proposed-actions.d.ts

@@ -63,8 +63,11 @@ export interface ProposedActionsStore {
     failed(id: string, error: string): Promise<ProposedAction>;
     judge(id: string, verdict: ProposedAction["verdict"]): Promise<ProposedAction>;
 }
-type ProposalOperations = {
+type ProposalOperations = Omit<{
     [K in keyof ProposedActionsStore]: ProposedActionsStore[K] extends (...args: infer A) => Promise<infer R> ? (...args: A) => R : never;
+}, "approve"> & {
+    /** `by` records an agent deciding for the owner; the public store always records the owner. */
+    approve(id: string, result?: unknown, by?: Author): ProposedAction;
 };
 export declare const proposalOperationsOver: (context: StoreContext) => ProposalOperations;
 export declare const proposedActionsStoreOver: (context: StoreContext) => ProposedActionsStore;

package/dist/store/sqlite/proposed-actions.js

@@ -1,5 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { MEETING_FINDINGS_KIND } from "../../meetings/index.js";
+import { EVIDENCE_FINDINGS_KIND } from "../evidence-findings.js";
 import { authorActor } from "./memories.js";
 import { requiredThing } from "./notes.js";
 import { referenceOfThing, storedThing } from "./things.js";
@@ -60,8 +61,8 @@ export const proposalOperationsOver = (context) => {
             .run(to, now(), ...values, Number(id));
         return actionOf(rowOf(id));
     });
-    const decide = (id, to, result) => {
-        const { actor } = authorActor(context, "owner");
+    const decide = (id, to, result, by = "owner") => {
+        const { actor } = authorActor(context, by);
         return move(id, ["proposed"], to, ", decided_by_type = ?, decided_by_id = ?, decided_at = ?, result = ?", [
             actor.type,
             actor.id,
@@ -109,7 +110,7 @@ export const proposalOperationsOver = (context) => {
                 .all(status ?? null, status ?? null, Math.min(Math.max(limit, 1), 500))
                 .map(actionOf);
         },
-        approve: (id, result) => decide(id, "approved", result),
+        approve: (id, result, by) => decide(id, "approved", result, by),
         reject: (id) => decide(id, "rejected"),
         executed: (id, result) => move(id, ["approved"], "executed", ", executed_at = ?, result = ?", [
             now(),
@@ -133,15 +134,22 @@ export const proposalOperationsOver = (context) => {
 export const proposedActionsStoreOver = (context) => {
     const operations = proposalOperationsOver(context);
     const generic = (id) => {
-        if (operations.get(id).kind === MEETING_FINDINGS_KIND)
+        const kind = operations.get(id).kind;
+        if (kind === MEETING_FINDINGS_KIND)
             throw new CliError("validation_error", "review meeting findings through the dedicated findings command", {
                 reason: "meeting-findings.dedicated-review",
             });
+        if (kind === EVIDENCE_FINDINGS_KIND)
+            throw new CliError("validation_error", "review evidence findings through the dedicated findings command", {
+                reason: "evidence-findings.dedicated-review",
+            });
     };
     return {
         propose: async (input) => {
             if (input.kind === MEETING_FINDINGS_KIND)
                 throw new CliError("validation_error", "stage meeting findings through the dedicated findings command");
+            if (input.kind === EVIDENCE_FINDINGS_KIND)
+                throw new CliError("validation_error", "stage evidence findings through the dedicated findings command");
             return operations.propose(input);
         },
         get: async (id) => operations.get(id),

package/dist/store/store.d.ts

@@ -1,10 +1,11 @@
-import type { ContextEvidenceReader, ContextIndex } from "../context/evidence.js";
+import type { ContextEvidenceReader, ContextIndex, ContextRecordReader } from "../context/evidence.js";
 import { type AccountStore } from "./account-store.js";
 import { type AccountsStore } from "./accounts.js";
 import { type AttachmentsStore } from "./attachments.js";
 import { type ChatsStore } from "./chats.js";
 import { type ConversationsStore } from "./conversations.js";
 import { type CountersStore } from "./counters.js";
+import type { EvidenceFindingsStore } from "./evidence-findings.js";
 import type { MeetingFindingsStore } from "./meeting-findings.js";
 import { type MentionsStore } from "./mentions.js";
 import { type MessagesStore } from "./messages.js";
@@ -35,6 +36,7 @@ import { type VectorsStore } from "./vectors.js";
 export interface MessageStore {
     readonly contextEvidence?: ContextEvidenceReader;
     readonly contextIndex?: ContextIndex;
+    readonly contextRecords?: ContextRecordReader;
     /** Accounts, account groups and which account each app profile is. */
     readonly accounts: AccountsStore;
     /** One account's chats: the list, what left, what is complete, their metadata. */
@@ -77,6 +79,8 @@ export interface MessageStore {
     readonly catalog: CatalogStore;
     /** Choices that hold until replaced, each with its evidence. */
     readonly meetingFindings: MeetingFindingsStore;
+    /** Cited facts and follow-ups about one project from stored messages, mail and documents, for review. */
+    readonly evidenceFindings: EvidenceFindingsStore;
     readonly facts: FactsStore;
     /** What agents concluded: summaries, digests, facts, preferences, each with evidence and a scope. */
     readonly memories: MemoriesStore;

package/dist/store/store.js

@@ -16,8 +16,9 @@ import { agentActionsStoreOver } from "./sqlite/agent-actions.js";
 import * as attachmentTexts from "./sqlite/attachment-texts.js";
 import { botUpdateStoreOver } from "./sqlite/bot-updates.js";
 import { catalogStoreOver } from "./sqlite/catalog.js";
-import { contextEvidenceOver, contextIndexOver } from "./sqlite/context-evidence.js";
+import { contextEvidenceOver, contextIndexOver, contextRecordsOver } from "./sqlite/context-evidence.js";
 import { mailStoreOver } from "./sqlite/emails.js";
+import { evidenceFindingsStoreOver } from "./sqlite/evidence-findings.js";
 import { factsStoreOver } from "./sqlite/facts.js";
 import { involvementStoreOver } from "./sqlite/involvements.js";
 import { knowledgeStoreOver } from "./sqlite/knowledge.js";
@@ -82,6 +83,7 @@ const storeOver = (context) => {
     };
     const contextEvidence = once(() => contextEvidenceOver(context));
     const contextIndex = once(() => contextIndexOver(context, stemmerFor));
+    const contextRecords = once(() => contextRecordsOver(context));
     const searches = once(() => searchesStoreOver(context));
     const queries = once(() => queriesStoreOver(context, stemmerFor));
     const searchIndex = once(() => searchIndexStoreOver(context));
@@ -93,6 +95,7 @@ const storeOver = (context) => {
     const notes = once(() => ({ ...notesStoreOver(context), ...noteSearchOver(context) }));
     const catalog = once(() => catalogStoreOver(context));
     const meetingFindings = once(() => meetingFindingsStoreOver(context));
+    const evidenceFindings = once(() => evidenceFindingsStoreOver(context));
     const facts = once(() => factsStoreOver(context));
     const memories = once(() => memoriesStoreOver(context));
     const proposedActions = once(() => proposedActionsStoreOver(context));
@@ -105,6 +108,9 @@ const storeOver = (context) => {
         get contextIndex() {
             return contextIndex();
         },
+        get contextRecords() {
+            return contextRecords();
+        },
         meetingVectors: meetingVectorsOver(context),
         get accounts() {
             return areas.accounts().whole;
@@ -175,6 +181,9 @@ const storeOver = (context) => {
         get meetingFindings() {
             return meetingFindings();
         },
+        get evidenceFindings() {
+            return evidenceFindings();
+        },
         get facts() {
             return facts();
         },

package/dist/terminal/login-qr.d.ts

@@ -1,30 +1,34 @@
-import { CliError } from "@wirecat/cli-base";
 /** Whether a person can scan a code drawn here and answer what the login asks next. */
 export declare const atTerminal: (input: NodeJS.ReadableStream & {
     isTTY?: boolean;
 }) => boolean;
-/** The one refusal of a QR login that nobody could scan. */
-export declare const qrNeedsTerminal: (command: string) => CliError;
+/** What an agent reads off the plain-text code: the same words a person reads under the drawn one. */
+export declare const PASTE_QR: string;
 export interface LoginQrOptions {
-    /** `--qr-file`: the PNG to write instead of drawing the code. */
-    qrFile?: string;
     /** Where the code and the narrow-terminal hint go; `--quiet` must not hide either. */
     diagnostic: (text: string) => void;
-    /** Where the file's location is said. */
+    /** Where where-to-scan and the agent's instruction go. */
     note: (text: string) => void;
     /** How far the code sits right, to line up under a setup step. */
     indent?: number;
     /** Read on every code, so a widened terminal draws the next one. Unknown draws the code. */
     columns?: () => number | undefined;
+    /**
+     * Whether a person reads the diagnostic stream in a terminal. Off one, the code is plain text for an agent to
+     * paste into the chat (`plainQr`). Defaults to whether stderr is a terminal.
+     */
+    terminal?: boolean;
+    /**
+     * Machine output (`--json`, `--jsonl`, or no terminal): each code is also one JSON line on the diagnostic stream,
+     * `{"event":"qr","qr":{"text","expires_at","scan"}}`. stdout keeps only the answer, which comes after the scan.
+     */
+    json?: boolean;
 }
 export interface LoginQr {
-    readonly path: string | undefined;
     /**
      * `scan` says where to scan; it follows the code, and is not said when the terminal is too narrow to draw one.
      * Never throws for a code that does not fit: the messengers call it from inside their own event loops.
      */
-    show: (link: string, scan?: string) => void;
-    /** The image logs the account in while it is valid; call this in `finally`. */
-    close: () => void;
+    show: (link: string, scan?: string, expiresAt?: Date) => void;
 }
-export declare const loginQr: ({ qrFile, diagnostic, note, indent: pad, columns, }: LoginQrOptions) => LoginQr;
+export declare const loginQr: ({ diagnostic, note, indent: pad, columns, terminal, json, }: LoginQrOptions) => LoginQr;

package/dist/terminal/login-qr.js

@@ -1,48 +1,36 @@
-import { rmSync } from "node:fs";
-import { resolve } from "node:path";
-import { CliError, indent, writeSecurely } from "@wirecat/cli-base";
+import { indent } from "@wirecat/cli-base";
 import { inputPolicy } from "../cli/input-policy.js";
-import { qrPng, terminalQr } from "./qr.js";
+import { plainQr, terminalQr } from "./qr.js";
 const MARGIN = 2;
 /** Whether a person can scan a code drawn here and answer what the login asks next. */
 export const atTerminal = (input) => input.isTTY === true && !inputPolicy(input).noInput;
-/** The one refusal of a QR login that nobody could scan. */
-export const qrNeedsTerminal = (command) => new CliError("validation_error", `${command} shows a QR code to scan — run it in a terminal, or pass --qr-file <png>`, {
-    param: "--qr-file",
-    reason: "input.required",
-});
-export const loginQr = ({ qrFile, diagnostic, note, indent: pad = 0, columns = () => process.stderr.columns, }) => {
-    const path = qrFile === undefined ? undefined : resolve(qrFile);
-    // Only what this login wrote is removed: a refused or never-reached write leaves the owner's file alone.
-    let written = false;
-    return {
-        path,
-        show: (link, scan) => {
-            if (path) {
-                writeSecurely(path, qrPng(link), 0o600);
-                written = true;
-                note(`the QR code is in ${path} — it is replaced when the code renews`);
-                if (scan)
-                    note(scan);
-                return;
-            }
-            const drawn = terminalQr(link);
-            const need = drawn.width + pad + MARGIN;
-            const width = columns();
-            if (width !== undefined && need > width) {
-                diagnostic(`the terminal is ${width} columns wide and the QR code needs ${need} — widen it, ` +
-                    "or run again with --qr-file <png>");
-                return;
-            }
-            diagnostic(`\n${indent(drawn.text, pad + MARGIN)}`);
+/** What an agent reads off the plain-text code: the same words a person reads under the drawn one. */
+export const PASTE_QR = "agents: paste the QR code above into the chat as a code block, exactly as printed; " +
+    "when a new one is printed, paste it and say the old one expired";
+export const loginQr = ({ diagnostic, note, indent: pad = 0, columns = () => process.stderr.columns, terminal = process.stderr.isTTY === true, json = false, }) => ({
+    show: (link, scan, expiresAt) => {
+        if (!terminal) {
+            const text = plainQr(link);
+            diagnostic(`\n${text}\n`);
+            if (json)
+                diagnostic(JSON.stringify({
+                    event: "qr",
+                    qr: { text, expires_at: expiresAt?.toISOString() ?? null, scan: scan ?? null },
+                }));
+            note(PASTE_QR);
             if (scan)
                 note(scan);
-        },
-        close: () => {
-            if (!path || !written)
-                return;
-            written = false;
-            rmSync(path, { force: true });
-        },
-    };
-};
+            return;
+        }
+        const drawn = terminalQr(link);
+        const need = drawn.width + pad + MARGIN;
+        const width = columns();
+        if (width !== undefined && need > width) {
+            diagnostic(`the terminal is ${width} columns wide and the QR code needs ${need} — widen it`);
+            return;
+        }
+        diagnostic(`\n${indent(drawn.text, pad + MARGIN)}`);
+        if (scan)
+            note(scan);
+    },
+});

package/dist/terminal/qr.d.ts

@@ -1,8 +1,3 @@
-/**
- * The same code as a PNG, `scale` pixels a module, for a person or an agent to pass on as an image.
- * 8-bit greyscale, one filter-free row per pixel line: the smallest PNG any decoder reads.
- */
-export declare const qrPng: (link: string, scale?: number) => Uint8Array;
 /**
  * A QR code as text, two modules per character cell with half blocks, so it fits a terminal
  * without being twice as tall as it is wide. `width` is in columns, for deciding whether it fits.
@@ -11,3 +6,10 @@ export declare const terminalQr: (link: string) => {
     text: string;
     width: number;
 };
+/**
+ * The same code as plain text, for an agent to paste into a chat where no colour survives. Without colours a glyph
+ * takes the foreground colour, so the light modules and the quiet zone are the glyphs: on a dark background the code
+ * reads dark on light, and every line starts and ends with a glyph, so nothing trims it. Half blocks keep a long
+ * WhatsApp code under 80 columns; full blocks would need about 140 and wrap.
+ */
+export declare const plainQr: (link: string) => string;

package/dist/terminal/qr.js

@@ -1,4 +1,3 @@
-import { deflateSync } from "node:zlib";
 import qrcode from "qrcode-generator";
 const QUIET_ZONE = 4;
 // Dark modules on a light ground whatever the terminal's theme: a phone camera reads an inverted
@@ -18,52 +17,6 @@ const modules = (link) => {
     };
     return { size, dark };
 };
-/**
- * The same code as a PNG, `scale` pixels a module, for a person or an agent to pass on as an image.
- * 8-bit greyscale, one filter-free row per pixel line: the smallest PNG any decoder reads.
- */
-export const qrPng = (link, scale = 8) => {
-    const { size, dark } = modules(link);
-    const side = size * scale;
-    const pixels = Buffer.alloc((side + 1) * side, 0xff);
-    for (let y = 0; y < side; y++) {
-        pixels[y * (side + 1)] = 0;
-        for (let x = 0; x < side; x++) {
-            if (dark(Math.floor(y / scale), Math.floor(x / scale)))
-                pixels[y * (side + 1) + 1 + x] = 0;
-        }
-    }
-    const header = Buffer.alloc(13);
-    header.writeUInt32BE(side, 0);
-    header.writeUInt32BE(side, 4);
-    header.set([8, 0, 0, 0, 0], 8);
-    return Buffer.concat([
-        Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]),
-        chunk("IHDR", header),
-        chunk("IDAT", deflateSync(pixels)),
-        chunk("IEND", Buffer.alloc(0)),
-    ]);
-};
-const chunk = (type, data) => {
-    const body = Buffer.concat([Buffer.from(type, "ascii"), data]);
-    const out = Buffer.alloc(body.length + 8);
-    out.writeUInt32BE(data.length, 0);
-    body.copy(out, 4);
-    out.writeUInt32BE(crc32(body), body.length + 4);
-    return out;
-};
-const CRC_TABLE = Array.from({ length: 256 }, (_, n) => {
-    let c = n;
-    for (let k = 0; k < 8; k++)
-        c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
-    return c >>> 0;
-});
-const crc32 = (bytes) => {
-    let c = 0xffffffff;
-    for (const byte of bytes)
-        c = CRC_TABLE[(c ^ byte) & 0xff] ^ (c >>> 8);
-    return (c ^ 0xffffffff) >>> 0;
-};
 /**
  * A QR code as text, two modules per character cell with half blocks, so it fits a terminal
  * without being twice as tall as it is wide. `width` is in columns, for deciding whether it fits.
@@ -82,3 +35,24 @@ export const terminalQr = (link) => {
     }
     return { text: lines.join("\n"), width: size };
 };
+/**
+ * The same code as plain text, for an agent to paste into a chat where no colour survives. Without colours a glyph
+ * takes the foreground colour, so the light modules and the quiet zone are the glyphs: on a dark background the code
+ * reads dark on light, and every line starts and ends with a glyph, so nothing trims it. Half blocks keep a long
+ * WhatsApp code under 80 columns; full blocks would need about 140 and wrap.
+ */
+export const plainQr = (link) => {
+    const { size, dark } = modules(link);
+    const light = (row, col) => row < size && !dark(row, col);
+    const lines = [];
+    for (let row = 0; row < size; row += 2) {
+        let line = "";
+        for (let col = 0; col < size; col++) {
+            const top = light(row, col);
+            const bottom = light(row + 1, col);
+            line += top && bottom ? "█" : top ? "▀" : bottom ? "▄" : " ";
+        }
+        lines.push(line);
+    }
+    return lines.join("\n");
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.361.0",
+  "version": "0.363.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",

package/parity.json

@@ -810,10 +810,6 @@
       "value": "<url>",
       "meaning": "the tunnel's https address the browser apps use"
     },
-    "--qr-file": {
-      "value": "<png>",
-      "meaning": "write the QR code to this PNG instead of drawing it, for an agent to pass on"
-    },
     "--question": {
       "meaning": "match only questions"
     },
@@ -4053,7 +4049,6 @@
           "in": ["tg"],
           "reason": "Telegram asks each client for its own app from my.telegram.org; MAX has no such step; WhatsApp has no application registration"
         },
-        "--qr-file": "all",
         "--sms": {
           "in": ["tg"],
           "reason": "asks Telegram to resend its login code by SMS; MAX has no such choice; WhatsApp links a device by QR or pairing code, never by an SMS code"
@@ -4068,8 +4063,7 @@
           "in": ["tg"],
           "reason": "Telegram requires an application from my.telegram.org; MAX has no application registration step; WhatsApp has no application registration"
         },
-        "--method": "all",
-        "--qr-file": "all"
+        "--method": "all"
       }
     },
     "skill": {