@illuminis/comprism 0.1.6 → 0.1.8

package/out/agent/render.d.ts

@@ -113,6 +113,30 @@ export interface ReceiptCard {
     details?: string | null;
     badge: string | null;
     warning: string | null;
+    /** Where the saving came from, worded by the server for every client. */
+    savings?: ReceiptSavings | null;
+    /** The decision engine's itemized cost, named by the server (web manual 11.4). */
+    engine?: {
+        label: string;
+        name: string;
+        value: string;
+        line: string;
+    } | null;
+}
+/** The receipt's savings table: headings, one row per cost factor, the total. */
+export interface ReceiptSavings {
+    columns: string[];
+    rows: Array<{
+        key: string;
+        label: string;
+        user: string;
+        chosen: string;
+        saving: string;
+    }>;
+    total: {
+        label: string;
+        value: string;
+    };
 }
 /**
  * The receipt under a finished job.

package/out/agent/render.js

@@ -238,8 +238,10 @@ function ending(line, detail) {
 }
 /** How the job ended, in the words a person reads. */
 function outcome(o, detail) {
+    // A clean finish prints no word: the answer above says what was done.
+    if (o === "finished")
+        return detail ? `\n${(0, exports.dim)(detail)}\n` : "";
     const word = {
-        finished: (0, exports.green)("Done"),
         cancelled: (0, exports.yellow)("Stopped"),
         step_limit: (0, exports.yellow)("Stopped after too many steps"),
         spend_limit: (0, exports.yellow)("Stopped at the spending limit"),
@@ -276,6 +278,33 @@ function savedFile(name, fullPath, bytes) {
     return `${(0, exports.green)("  saved  ")}${link(name, href)}${(0, exports.dim)(`  ${bytes} bytes`)}\n`
         + `${(0, exports.gray)(`         ${fullPath}`)}\n`;
 }
+/**
+ * The savings table as aligned columns: names left, money right, the saving
+ * column bright and the rest quiet. Every word and figure is the server's.
+ * Too narrow for the headings, it keeps the rows and drops the heading line
+ * rather than cutting a word.
+ */
+function savingsRows(savings, room) {
+    if (!savings || !savings.rows.length)
+        return [];
+    const body = savings.rows.map((r) => [r.label, r.user, r.chosen, r.saving]);
+    const [c0 = "", c1 = "", c2 = "", c3 = ""] = savings.columns;
+    const heading = [c0, c1, c2, c3];
+    const fit = (rows) => [0, 1, 2, 3].map((i) => " ".repeat(Math.max(...rows.map((r) => r[i].length))));
+    let w = fit([...body, heading]).map((x) => x.length);
+    const head = w.reduce((a, b) => a + b, 0) + 6 <= room;
+    if (!head)
+        w = fit(body).map((x) => x.length);
+    const [w0 = 0, w1 = 0, w2 = 0, w3 = 0] = w;
+    const left = (r) => `${r[0].padEnd(w0)}  ${r[1].padStart(w1)}  ${r[2].padStart(w2)}`;
+    const out = [""];
+    if (head)
+        out.push((0, exports.dim)(`${left(heading)}  ${heading[3].padStart(w3)}`));
+    for (const r of body)
+        out.push(`${(0, exports.dim)(left(r))}  ${(0, exports.bold)(r[3].padStart(w3))}`);
+    out.push((0, exports.bold)(`${savings.total.label.padEnd(w0 + w1 + w2 + 4)}  ${savings.total.value.padStart(w3)}`));
+    return out;
+}
 /** The card's two lines, as the approved look draws them. */
 function cardRows(card) {
     const rows = [];
@@ -285,6 +314,8 @@ function cardRows(card) {
         rows.push(head);
     if (card.amount)
         rows.push(card.saved ? (0, exports.bold)((0, exports.green)(card.amount)) : (0, exports.dim)(card.amount));
+    if (card.engine)
+        rows.push((0, exports.dim)(card.engine.line));
     if (card.warning)
         rows.push((0, exports.dim)(card.warning));
     return rows;
@@ -306,7 +337,8 @@ function cardRows(card) {
  * formatting, which belongs to the client, and it is the only part that does.
  */
 function receipt(text, models = [], testsPassed, card) {
-    const lines = card ? cardRows(card).map((r) => `  ${r}`) : [];
+    const lines = card
+        ? [...cardRows(card), ...savingsRows(card.savings, width() - 4)].map((r) => `  ${r}`) : [];
     for (const line of card ? [] : String(text || "").split("\n")) {
         if (!line.trim())
             continue;
@@ -370,7 +402,7 @@ function wrap(text, room) {
 function boxed(text, models, testsPassed, card) {
     // Room for the border, the padding and the `receipt` label on the first line.
     const inner = width() - 16;
-    const rows = card ? cardRows(card) : [];
+    const rows = card ? [...cardRows(card), ...savingsRows(card.savings, inner)] : [];
     const links = [];
     for (const raw of String(text || "").split("\n")) {
         if (card) {

package/out/agent/session.js

@@ -1010,6 +1010,11 @@ class TerminalSession {
             }
             case "action_finished":
                 this.flushScreen();
+                // A step that failed is the agent's to read and retry, not the
+                // person's: it is not printed, outside the full view (6.9) that a
+                // person turns on to see everything (owner, 7 October 2026).
+                if (frame.ok === false && !this.full)
+                    break;
                 this.out(ui.action(String(frame.name ?? ""), this.targetOf(frame), frame.ok !== false, frame.latency_ms) + "\n");
                 // The change itself, as it is made, unless it was just shown for
                 // approval (manual 5.6 to 5.8). A change that changed nothing has
@@ -1030,6 +1035,10 @@ class TerminalSession {
                 }
                 break;
             case "action_refused":
+                // The same: the agent is told why and carries on. Only the full view
+                // shows it.
+                if (!this.full)
+                    break;
                 this.out(ui.red(`  refused  ${String(frame.name ?? "")}`)
                     + ui.dim(`  ${String(frame.reason ?? "")}\n`));
                 break;

package/out/commands/decisionEngine.d.ts

@@ -0,0 +1 @@
+export declare function cmdDecisionEngine(args: string[]): Promise<number>;

package/out/commands/decisionEngine.js

@@ -0,0 +1,66 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmdDecisionEngine = cmdDecisionEngine;
+/**
+ * `comprism decision-engine [none | <engine>]` (web manual 11.4): whether your
+ * work uses the decision engine your company has turned on. With no argument it
+ * shows your pick; with one it changes it. The service keeps the pick and words
+ * every line, so this matches the drop-down in Work and in VS Code.
+ */
+const gateway_1 = require("../lib/gateway");
+const ui = __importStar(require("../lib/ui"));
+const out = (s = "") => process.stdout.write(s + "\n");
+async function cmdDecisionEngine(args) {
+    const choice = args[0];
+    const reply = await (0, gateway_1.ask)({
+        intent: "decision_engine", prompt: "",
+        op: choice ? "set" : "show",
+        ...(choice ? { payload: { engine: choice === "none" ? null : choice } } : {}),
+    });
+    if (!reply.ok || reply.served === false) {
+        out(ui.fail(reply.served === false
+            ? "Your organization is running an older build that does not answer this yet."
+            : `Your organization could not be reached: ${reply.message || "no answer"}`));
+        return 1;
+    }
+    out();
+    if (reply.message)
+        out(ui.fail(reply.message));
+    for (const line of reply.lines ?? [])
+        out(line);
+    out();
+    return reply.message ? 1 : 0;
+}

package/out/lib/gateway.d.ts

@@ -62,7 +62,7 @@ export interface SpendReport {
 export interface GatewayReply {
     /** Local transport metadata, not an authentication decision. */
     httpStatus?: number;
-    intent: 'decide' | 'answer' | 'catalog' | 'store_key' | 'session' | 'job_start' | 'resolve_workspace' | 'sign_in' | 'sign_out' | 'attach' | 'transcribe' | 'graph' | 'spend' | 'project' | 'commands' | 'transcript' | 'context' | 'compact' | 'sessions' | 'permissions' | 'jobs' | 'agents' | 'integrations' | 'skills' | 'plugins' | 'schema' | 'usage' | 'instructions' | 'config' | 'memory' | 'worktrees' | 'privacy' | 'hooks' | 'queue' | 'review' | 'release' | 'command';
+    intent: 'decide' | 'answer' | 'catalog' | 'store_key' | 'session' | 'job_start' | 'resolve_workspace' | 'sign_in' | 'sign_out' | 'attach' | 'transcribe' | 'graph' | 'spend' | 'project' | 'commands' | 'transcript' | 'context' | 'compact' | 'sessions' | 'permissions' | 'jobs' | 'agents' | 'integrations' | 'skills' | 'plugins' | 'schema' | 'usage' | 'instructions' | 'config' | 'memory' | 'worktrees' | 'privacy' | 'hooks' | 'queue' | 'review' | 'release' | 'decision_engine' | 'command';
     client: string;
     decision: Decision;
     answer: string | null;
@@ -342,7 +342,7 @@ export interface SessionOut {
     can_write: boolean;
 }
 export interface Ask {
-    intent: 'decide' | 'answer' | 'catalog' | 'store_key' | 'session' | 'job_start' | 'resolve_workspace' | 'sign_in' | 'sign_out' | 'attach' | 'transcribe' | 'graph' | 'spend' | 'project' | 'commands' | 'transcript' | 'context' | 'compact' | 'sessions' | 'permissions' | 'jobs' | 'agents' | 'integrations' | 'skills' | 'plugins' | 'schema' | 'usage' | 'instructions' | 'config' | 'memory' | 'worktrees' | 'privacy' | 'hooks' | 'queue' | 'review' | 'release' | 'command';
+    intent: 'decide' | 'answer' | 'catalog' | 'store_key' | 'session' | 'job_start' | 'resolve_workspace' | 'sign_in' | 'sign_out' | 'attach' | 'transcribe' | 'graph' | 'spend' | 'project' | 'commands' | 'transcript' | 'context' | 'compact' | 'sessions' | 'permissions' | 'jobs' | 'agents' | 'integrations' | 'skills' | 'plugins' | 'schema' | 'usage' | 'instructions' | 'config' | 'memory' | 'worktrees' | 'privacy' | 'hooks' | 'queue' | 'review' | 'release' | 'decision_engine' | 'command';
     prompt: string;
     callingModel?: string;
     contextTokens?: number;

package/out/lib/voice.d.ts

@@ -1,39 +1,5 @@
-/** One recording tool, as this file needs to drive it. */
-interface Recorder {
-    /** What to tell somebody who wants to know what is listening. */
-    name: string;
-    command: string;
-    args: (out: string) => string[];
-}
-/** The first recording tool this machine has, or null. */
-export declare function recorder(): Recorder | null;
-/**
- * What to tell somebody who has no recording tool, or null when they do.
- *
- * One sentence and one command. Not a list of three options with trade-offs:
- * somebody who just wanted to say a sentence out loud is not shopping for audio
- * software.
- */
-export declare function missing(): string | null;
-/** A recording in progress. */
-export interface Recording {
-    /** Where the audio is being written. */
-    file: string;
-    /** What is doing the listening, for the line on screen. */
-    by: string;
-    /** Stop, wait for the file to be finished properly, and hand it back. */
-    stop: () => Promise<{
-        file: string;
-        bytes: number;
-    }>;
-}
-/**
- * Start listening.
- *
- * Throws when there is nothing to listen with, which the caller should have
- * headed off with `missing` so the person gets a sentence rather than an error.
- */
-export declare function start(): Recording;
+export { discard, missing, recorder, start } from '../machine/voice/record';
+export type { Recorder, Recording } from '../machine/voice/record';
 /** Live dictation in progress, on the Mac's own recogniser. */
 export interface LiveDictation {
     /** The loudness now, 0 to 1. */
@@ -70,8 +36,6 @@ export declare function level(file: string): number;
  * actually there. Returns null until there is at least half a second to send.
  */
 export declare function soFar(file: string): string | null;
-/** Delete the recording and the folder holding it. Always, and immediately. */
-export declare function discard(file: string): void;
 /**
  * The words in a recording, according to our server.
  *
@@ -83,4 +47,3 @@ export declare function transcribe(baseUrl: string, credential: string, file: st
     text: string;
     provider: string;
 }>;
-export {};

package/out/lib/voice.js

@@ -33,13 +33,10 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.recorder = recorder;
-exports.missing = missing;
-exports.start = start;
+exports.start = exports.recorder = exports.missing = exports.discard = void 0;
 exports.listenLive = listenLive;
 exports.level = level;
 exports.soFar = soFar;
-exports.discard = discard;
 exports.transcribe = transcribe;
 /**
  * Saying a request instead of typing it.
@@ -73,144 +70,13 @@ exports.transcribe = transcribe;
  */
 const node_child_process_1 = require("node:child_process");
 const fs = __importStar(require("node:fs"));
-const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
 const gateway_1 = require("./gateway");
-/** Is this on the PATH at all. */
-function present(command) {
-    try {
-        return (0, node_child_process_1.spawnSync)('which', [command], { stdio: 'ignore' }).status === 0;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Sixteen kilohertz, one channel, everywhere.
- *
- * What every speech model wants and nothing more. Recording in studio quality
- * would make a file several times the size, take longer to upload, and be
- * downsampled by the vendor on arrival anyway.
- */
-const RATE = '16000';
-const RECORDERS = [
-    // sox first. It is the one built for this, it needs no device name, and it
-    // stops cleanly.
-    { name: 'sox', command: 'rec', args: (out) => ['-q', '-c', '1', '-r', RATE, out] },
-    {
-        name: 'ffmpeg',
-        command: 'ffmpeg',
-        args: (out) => [
-            '-loglevel', 'quiet', '-nostdin',
-            ...(process.platform === 'darwin'
-                ? ['-f', 'avfoundation', '-i', ':default']
-                : ['-f', 'alsa', '-i', 'default']),
-            // Written as it is heard, not held until the end, so the meter and the
-            // words so far have something to read while the person is speaking.
-            '-ac', '1', '-ar', RATE, '-flush_packets', '1', '-y', out,
-        ],
-    },
-    // Linux's own, present on most desktop installs.
-    { name: 'arecord', command: 'arecord', args: (out) => ['-q', '-f', 'S16_LE', '-c', '1', '-r', RATE, out] },
-];
-/** The first recording tool this machine has, or null. */
-function recorder() {
-    return RECORDERS.find((r) => present(r.command)) ?? null;
-}
-/**
- * What to tell somebody who has no recording tool, or null when they do.
- *
- * One sentence and one command. Not a list of three options with trade-offs:
- * somebody who just wanted to say a sentence out loud is not shopping for audio
- * software.
- */
-function missing() {
-    if (recorder())
-        return null;
-    return process.platform === 'darwin'
-        ? 'Speaking needs a recording tool, and macOS does not come with one. '
-            + 'Install it once with:  brew install sox'
-        : 'Speaking needs a recording tool. Install it once with:  '
-            + 'sudo apt install sox   (or your system\'s package manager)';
-}
-/**
- * Start listening.
- *
- * Throws when there is nothing to listen with, which the caller should have
- * headed off with `missing` so the person gets a sentence rather than an error.
- */
-function start() {
-    const tool = recorder();
-    if (!tool)
-        throw new Error(missing() ?? 'No recording tool.');
-    const file = path.join(fs.mkdtempSync(path.join(os.tmpdir(), 'comprism-voice-')), 'said.wav');
-    const child = (0, node_child_process_1.spawn)(tool.command, tool.args(file), {
-        stdio: ['ignore', 'ignore', 'ignore'],
-    });
-    let stopped = null;
-    // The recorder never outlives the session. Closing the window or ending the
-    // process while it listens would otherwise leave a microphone recording to a
-    // file nobody knows about, the worst thing this tool could do.
-    const abandon = () => {
-        try {
-            child.kill('SIGKILL');
-        }
-        catch { /* already gone */ }
-        discard(file);
-    };
-    const onSignal = (signal) => {
-        abandon();
-        release();
-        process.kill(process.pid, signal);
-    };
-    const release = () => {
-        process.off('exit', abandon);
-        process.off('SIGHUP', onSignal);
-        process.off('SIGTERM', onSignal);
-    };
-    process.once('exit', abandon);
-    process.once('SIGHUP', onSignal);
-    process.once('SIGTERM', onSignal);
-    child.once('close', release);
-    const stop = () => {
-        if (stopped)
-            return stopped;
-        stopped = new Promise((resolve) => {
-            const done = () => {
-                let bytes = 0;
-                try {
-                    bytes = fs.statSync(file).size;
-                }
-                catch {
-                    bytes = 0;
-                }
-                resolve({ file, bytes });
-            };
-            // Interrupt, not kill. Every one of these tools finishes writing the WAV
-            // header on an interrupt and none of them does on a kill, and a header
-            // that was never finished reads as silence to whoever transcribes it.
-            child.once('close', done);
-            try {
-                child.kill('SIGINT');
-            }
-            catch {
-                done();
-            }
-            // A tool that has not closed in two seconds is not going to. Taking the
-            // file as it stands beats leaving somebody at a prompt that has stopped
-            // answering them.
-            setTimeout(() => {
-                try {
-                    child.kill('SIGKILL');
-                }
-                catch { /* already gone */ }
-                done();
-            }, 2000).unref();
-        });
-        return stopped;
-    };
-    return { file, by: tool.name, stop };
-}
+var record_1 = require("../machine/voice/record");
+Object.defineProperty(exports, "discard", { enumerable: true, get: function () { return record_1.discard; } });
+Object.defineProperty(exports, "missing", { enumerable: true, get: function () { return record_1.missing; } });
+Object.defineProperty(exports, "recorder", { enumerable: true, get: function () { return record_1.recorder; } });
+Object.defineProperty(exports, "start", { enumerable: true, get: function () { return record_1.start; } });
 /** The helper built beside this file on a Mac, when there is one. */
 function helper() {
     if (process.platform !== 'darwin')
@@ -341,13 +207,6 @@ function soFar(file) {
         return null;
     }
 }
-/** Delete the recording and the folder holding it. Always, and immediately. */
-function discard(file) {
-    try {
-        fs.rmSync(path.dirname(file), { recursive: true, force: true });
-    }
-    catch { /* a temp file we could not remove is not worth a word to anybody */ }
-}
 /**
  * The words in a recording, according to our server.
  *

package/out/machine/voice/record.d.ts

@@ -0,0 +1,38 @@
+/** One recording tool, as this file needs to drive it. */
+export interface Recorder {
+    /** What to tell somebody who wants to know what is listening. */
+    name: string;
+    command: string;
+    args: (out: string) => string[];
+}
+/** The first recording tool this machine has, or null. */
+export declare function recorder(): Recorder | null;
+/**
+ * What to tell somebody who has no recording tool, or null when they do.
+ *
+ * One sentence and one command. Not a list of three options with trade-offs:
+ * somebody who just wanted to say a sentence out loud is not shopping for audio
+ * software.
+ */
+export declare function missing(): string | null;
+/** A recording in progress. */
+export interface Recording {
+    /** Where the audio is being written. */
+    file: string;
+    /** What is doing the listening, for the line on screen. */
+    by: string;
+    /** Stop, wait for the file to be finished properly, and hand it back. */
+    stop: () => Promise<{
+        file: string;
+        bytes: number;
+    }>;
+}
+/**
+ * Start listening.
+ *
+ * Throws when there is nothing to listen with, which the caller should have
+ * headed off with `missing` so the person gets a sentence rather than an error.
+ */
+export declare function start(): Recording;
+/** Delete the recording and the folder holding it. Always, and immediately. */
+export declare function discard(file: string): void;

package/out/machine/voice/record.js

@@ -0,0 +1,208 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recorder = recorder;
+exports.missing = missing;
+exports.start = start;
+exports.discard = discard;
+/**
+ * Recording what a person says, on their own computer, for every client that
+ * offers a microphone: the command line and the editor extension.
+ *
+ * Physical work on the person's machine, so it lives here once rather than in
+ * each client (rule 17). Nothing here transcribes: the recording goes to our
+ * server, which asks a vendor, and the words come back. See the terminal's
+ * `lib/voice.ts` and the service's `transcription.py`.
+ *
+ * ── Recording without adding a dependency ─────────────────────────────────
+ *
+ * This drives a recording tool the machine already has rather than a compiled
+ * microphone library on every customer's laptop. macOS ships no command line
+ * recorder, so on a Mac with neither ffmpeg nor sox this does not work, and
+ * `missing` says so in one sentence naming the one command that fixes it.
+ *
+ * ── Stopping ──────────────────────────────────────────────────────────────
+ *
+ * Every one of these tools writes a WAV header that is only correct once the
+ * recording ends properly, so stopping means an interrupt and then WAITING for
+ * the tool to finish writing. Killing it outright leaves a file whose header
+ * claims a length it does not have, which every transcriber reads as silence.
+ */
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+/** Is this on the PATH at all. */
+function present(command) {
+    try {
+        return (0, node_child_process_1.spawnSync)('which', [command], { stdio: 'ignore' }).status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Sixteen kilohertz, one channel, everywhere.
+ *
+ * What every speech model wants and nothing more. Recording in studio quality
+ * would make a file several times the size, take longer to upload, and be
+ * downsampled by the vendor on arrival anyway.
+ */
+const RATE = '16000';
+const RECORDERS = [
+    // sox first. It is the one built for this, it needs no device name, and it
+    // stops cleanly.
+    { name: 'sox', command: 'rec', args: (out) => ['-q', '-c', '1', '-r', RATE, out] },
+    {
+        name: 'ffmpeg',
+        command: 'ffmpeg',
+        args: (out) => [
+            '-loglevel', 'quiet', '-nostdin',
+            ...(process.platform === 'darwin'
+                ? ['-f', 'avfoundation', '-i', ':default']
+                : ['-f', 'alsa', '-i', 'default']),
+            // Written as it is heard, not held until the end, so the meter and the
+            // words so far have something to read while the person is speaking.
+            '-ac', '1', '-ar', RATE, '-flush_packets', '1', '-y', out,
+        ],
+    },
+    // Linux's own, present on most desktop installs.
+    { name: 'arecord', command: 'arecord', args: (out) => ['-q', '-f', 'S16_LE', '-c', '1', '-r', RATE, out] },
+];
+/** The first recording tool this machine has, or null. */
+function recorder() {
+    return RECORDERS.find((r) => present(r.command)) ?? null;
+}
+/**
+ * What to tell somebody who has no recording tool, or null when they do.
+ *
+ * One sentence and one command. Not a list of three options with trade-offs:
+ * somebody who just wanted to say a sentence out loud is not shopping for audio
+ * software.
+ */
+function missing() {
+    if (recorder())
+        return null;
+    return process.platform === 'darwin'
+        ? 'Speaking needs a recording tool, and macOS does not come with one. '
+            + 'Install it once with:  brew install sox'
+        : 'Speaking needs a recording tool. Install it once with:  '
+            + 'sudo apt install sox   (or your system\'s package manager)';
+}
+/**
+ * Start listening.
+ *
+ * Throws when there is nothing to listen with, which the caller should have
+ * headed off with `missing` so the person gets a sentence rather than an error.
+ */
+function start() {
+    const tool = recorder();
+    if (!tool)
+        throw new Error(missing() ?? 'No recording tool.');
+    const file = path.join(fs.mkdtempSync(path.join(os.tmpdir(), 'comprism-voice-')), 'said.wav');
+    const child = (0, node_child_process_1.spawn)(tool.command, tool.args(file), {
+        stdio: ['ignore', 'ignore', 'ignore'],
+    });
+    let stopped = null;
+    // The recorder never outlives the session. Closing the window or ending the
+    // process while it listens would otherwise leave a microphone recording to a
+    // file nobody knows about, the worst thing this tool could do.
+    const abandon = () => {
+        try {
+            child.kill('SIGKILL');
+        }
+        catch { /* already gone */ }
+        discard(file);
+    };
+    const onSignal = (signal) => {
+        abandon();
+        release();
+        process.kill(process.pid, signal);
+    };
+    const release = () => {
+        process.off('exit', abandon);
+        process.off('SIGHUP', onSignal);
+        process.off('SIGTERM', onSignal);
+    };
+    process.once('exit', abandon);
+    process.once('SIGHUP', onSignal);
+    process.once('SIGTERM', onSignal);
+    child.once('close', release);
+    const stop = () => {
+        if (stopped)
+            return stopped;
+        stopped = new Promise((resolve) => {
+            const done = () => {
+                let bytes = 0;
+                try {
+                    bytes = fs.statSync(file).size;
+                }
+                catch {
+                    bytes = 0;
+                }
+                resolve({ file, bytes });
+            };
+            // Interrupt, not kill. Every one of these tools finishes writing the WAV
+            // header on an interrupt and none of them does on a kill, and a header
+            // that was never finished reads as silence to whoever transcribes it.
+            child.once('close', done);
+            try {
+                child.kill('SIGINT');
+            }
+            catch {
+                done();
+            }
+            // A tool that has not closed in two seconds is not going to. Taking the
+            // file as it stands beats leaving somebody at a prompt that has stopped
+            // answering them.
+            setTimeout(() => {
+                try {
+                    child.kill('SIGKILL');
+                }
+                catch { /* already gone */ }
+                done();
+            }, 2000).unref();
+        });
+        return stopped;
+    };
+    return { file, by: tool.name, stop };
+}
+/** Delete the recording and the folder holding it. Always, and immediately. */
+function discard(file) {
+    try {
+        fs.rmSync(path.dirname(file), { recursive: true, force: true });
+    }
+    catch { /* a temp file we could not remove is not worth a word to anybody */ }
+}

package/out/thin.js

@@ -134,6 +134,7 @@ function usage() {
         ['comprism plugins', 'packs of skills, helpers, hooks and connections'],
         ['comprism worktrees', 'separate copies of the repository'],
         ['comprism privacy', 'what your company keeps about your work'],
+        ['comprism decision-engine', 'whether your work uses a decision engine; add none or jev to change it'],
         ['comprism permissions', 'the rules in force here; permissions why <action> "<target>"'],
         ['comprism status', 'is this machine signed in, and to what'],
         ['comprism check', 'what this machine still needs, and how to add it'],
@@ -308,6 +309,12 @@ async function main() {
             process.exitCode = await cmdPrivacy();
             return;
         }
+        // Whether your work uses a decision engine (web manual 11.4).
+        case 'decision-engine': {
+            const { cmdDecisionEngine } = await Promise.resolve().then(() => __importStar(require('./commands/decisionEngine')));
+            process.exitCode = await cmdDecisionEngine(args);
+            return;
+        }
         // Separate copies of the repository (manual 2.11).
         case 'worktrees': {
             const { cmdWorktrees } = await Promise.resolve().then(() => __importStar(require('./commands/worktrees')));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@illuminis/comprism",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "CompletionPrism Companion. Records what finishing a piece of work actually costs - every attempt, and the human time spent noticing and repairing the ones that failed.",
   "license": "UNLICENSED",
   "private": false,