@illuminis/comprism 0.1.5 → 0.1.6

package/out/commands/welcome.js

@@ -96,40 +96,31 @@ async function session() {
     return reply.session;
 }
 /**
- * The mark: the app icon as a terminal can draw it cleanly. A five layer prism,
- * each layer two blocks wider than the one above and a shade deeper, with
- * three beams leaving its right side (up, level and down) and a ring of the
- * icon's cyan to purple around it (owner, 28 September 2026).
+ * The mark: a six layer prism, each layer two cells wider than the one above,
+ * colored bottom to top in the illuminis gradient: light purple at the base,
+ * then light blue, light green, light gold, light orange and light red at the
+ * top, so the cool colors carry the weight of the wide layers. The purple,
+ * green and gold are pale shades of the illuminis logo's own
+ * (platform/branding/assets).
  *
- * Solid blocks only, no blended edges and no white, because a terminal draws a
- * solid block sharply in any font and a white one vanishes on a white screen.
- * Drawn two pixels to a character, so it is nine lines tall.
+ * No ring and no beams: at terminal size both read as rough, and straight
+ * layers stay clean in any terminal (owner, 28 September 2026). Solid colored
+ * cells only: a terminal paints a cell's background edge to edge in any font.
+ * One pixel to a character, six lines tall.
  *
  * Without color the picture cannot be drawn, so the four row block pyramid
  * stands in: full blocks only, which render the same in every font.
  */
 const ICON = [
-    '..........................................53a6ed51a1ed509cee4f98ee4d93ee4c8eee4a89ee..................................................................',
-    '..............................54abed53a6ed51a1ed..............................4984ef477fef467bef......................................................',
-    '........................54abed53a6ed......................................................4476ef4371ef................................................',
-    '..................54abed53a6ed..................................................................426cf04067f0..........................................',
-    '..................53a6ed....................................a8d8f7a8d8f7..............................3f62f0..........................................',
-    '............53a6ed51a1ed....................................a8d8f7a8d8f7..............................3f5ff0425ef0..................4292f23f8af43b82f6',
-    '............51a1ed....................................74aef074aef074aef074aef0..............................455cf0......49a2ee469af0..................',
-    '............509cee....................................74aef074aef074aef074aef0........................54bbe851b3ea4daaec..............................',
-    '............4f98ee..............................4f86e64f86e64f86e64f86e64f86e64f86e6......5bcbe458c3e6......4b59f1....................................',
-    '............4d93ee..............................4f86e64f86e64f86e64f86e64f86e64f86e6f07a36f0e35befe25aeee259ece158eae057e9df56e8de55e6de54e4dd53e3dc52',
-    '............4c8eee........................3e60d83e60d83e60d83e60d83e60d83e60d83e60d83e60d8ed7435ea6e34......5056f1....................................',
-    '............4a89ee........................3e60d83e60d83e60d83e60d83e60d83e60d83e60d83e60d8............e76932e46331e15d30..............................',
-    '............4984ef477fef............2e3a9a2e3a9a2e3a9a2e3a9a2e3a9a2e3a9a2e3a9a2e3a9a2e3a9a2e3a9a......5355f15653f2......de572fdb512e..................',
-    '..................467bef............2e3a9a2e3a9a2e3a9a2e3a9a2e3a9a2e3a9a2e3a9a2e3a9a2e3a9a2e3a9a......5653f2........................d84c2cd5462bd2402a',
-    '..................4476ef4371ef..................................................................5653f25952f2..........................................',
-    '........................426cf04067f0......................................................5653f25952f2................................................',
-    '..............................3f62f03f5ff0425ef0..............................5355f15653f25952f2......................................................',
-    '..........................................455cf0485bf14b59f14e58f15056f15355f15653f2..................................................................',
+    '..............................f69f97f69f97..............................',
+    '........................ffbd8affbd8affbd8affbd8a........................',
+    '..................ffdf7fffdf7fffdf7fffdf7fffdf7fffdf7f..................',
+    '............a1d38ca1d38ca1d38ca1d38ca1d38ca1d38ca1d38ca1d38c............',
+    '......95d2f095d2f095d2f095d2f095d2f095d2f095d2f095d2f095d2f095d2f0......',
+    'bba1ddbba1ddbba1ddbba1ddbba1ddbba1ddbba1ddbba1ddbba1ddbba1ddbba1ddbba1dd',
 ];
 function mark() {
-    const picture = ui.pixelArt(ICON);
+    const picture = ui.cellArt(ICON);
     if (picture.length)
         return picture;
     const rows = [];
@@ -176,7 +167,6 @@ async function showWelcome(known, signingIn = false, withMark = true) {
         // Nothing else here is knowable yet, and the one useful thing to say is the
         // single command that changes that.
         out(row('Signed in', ui.c.amber('not yet')));
-        out(row('Comparing', cfg.defaultModel || 'not set'));
         out(row('Workspace', `${folder.path}  ${ui.c.dim('(where you are)')}`));
         out();
         // Not said when signing in follows at once: naming a command to type, just
@@ -205,7 +195,8 @@ async function showWelcome(known, signingIn = false, withMark = true) {
     out(row('User', who));
     out(row('Company', company));
     out(row('Server', local ? address : ui.c.dim(address)));
-    out(row('Comparing', `${cfg.defaultModel || ui.c.amber('not set')}  ${ui.c.dim('change with `comprism model`')}`));
+    // The service's own record of the person's choice (service catalog 14).
+    out(row('Comparing', `${me?.comparing || ui.c.amber('not set')}  ${ui.c.dim('change with `comprism model`')}`));
     out(row('Workspace', `${folder.path}  ${ui.c.dim(folder.source === 'cwd' ? '(where you are)' : '(saved)')}`));
     if (plan) {
         out(row('Plan', allowance
@@ -214,7 +205,7 @@ async function showWelcome(known, signingIn = false, withMark = true) {
     }
     if (!me) {
         out();
-        out(`  ${ui.c.amber('your workspace could not be reached, so only local settings are shown')}`);
+        out(`  ${ui.c.amber('your organization could not be reached, so only local settings are shown')}`);
         out(`  ${ui.c.dim('nothing here is known about your account, including your provider keys')}`);
     }
     else if (me.vendors_known === false) {

package/out/commands/worktrees.d.ts

@@ -1,4 +1,4 @@
-import type { ProjectFacts } from "../lib/project";
+import type { ProjectFacts } from "../machine/folder/project";
 /** The folder a `--worktree` job runs in, creating the worktree the first time.
  *  Null after saying why, when it cannot be made. */
 export declare function ensureWorktree(facts: ProjectFacts, name: string, session: string): Promise<string | null>;

package/out/graph/sync.d.ts

@@ -57,7 +57,7 @@ export declare function readerReport(): string;
  * behind, and the agent is told the thing it just created does not exist.
  *
  * So this is awaited before the write's result goes back. One round trip: the
- * file's facts and the project's new fingerprint travel together, and the
+ * file's facts and the workspace's new fingerprint travel together, and the
  * service stores, stamps and rejoins in that single call.
  *
  * Failure is silent on purpose. A map that could not be updated must never turn

package/out/graph/sync.js

@@ -22,9 +22,9 @@ exports.pushFile = pushFile;
  * says what it needs; the machine reads exactly that and sends structure back.
  */
 const gateway_1 = require("../lib/gateway");
-const build_1 = require("./build");
-const read_python_1 = require("./read-python");
-const read_typescript_1 = require("./read-typescript");
+const build_1 = require("../machine/codemap/build");
+const read_python_1 = require("../machine/codemap/read-python");
+const read_typescript_1 = require("../machine/codemap/read-typescript");
 /** How many files' facts go in one call.
  *
  *  A whole project in one request is several megabytes and fails in the least
@@ -83,7 +83,7 @@ async function refresh(root, workspace, opts = {}) {
         return { ...blank, current: false, message: "The service could not be reached, so the map was left as it is. Work carries on without it." };
     }
     if (now.fresh && !opts.force) {
-        return { ...blank, current: true, message: `The map already matches all ${state.files.length} files in this project.` };
+        return { ...blank, current: true, message: `The map already matches all ${state.files.length} files in this workspace.` };
     }
     // What the service already holds, so only what moved is read. It came back
     // with the status above when there was a map to describe, which is one round
@@ -165,7 +165,7 @@ function coverageSentence(unread, total) {
         gaps.push(`${unread.typescript} TypeScript files could not be read because this installation has no TypeScript compiler`);
     }
     if (!gaps.length)
-        return `It covers all ${total} code files in this project.`;
+        return `It covers all ${total} code files in this workspace.`;
     return `It covers ${total - unread.python - unread.typescript} of ${total} code files: ${gaps.join("; ")}.`;
 }
 /** What this machine can read at all. Asked before anything else, so a person
@@ -193,7 +193,7 @@ function readerReport() {
  * behind, and the agent is told the thing it just created does not exist.
  *
  * So this is awaited before the write's result goes back. One round trip: the
- * file's facts and the project's new fingerprint travel together, and the
+ * file's facts and the workspace's new fingerprint travel together, and the
  * service stores, stamps and rejoins in that single call.
  *
  * Failure is silent on purpose. A map that could not be updated must never turn

package/out/lib/attach.js

@@ -83,6 +83,7 @@ const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
 const gateway_1 = require("./gateway");
+const words_1 = require("./words");
 /**
  * Take the shell's escaping back off a path.
  *
@@ -136,7 +137,7 @@ function localProblem(file, shown) {
         link = fs.lstatSync(file);
     }
     catch {
-        return { code: 'not_found', message: `not found: ${shown}` };
+        return { code: 'not_found', message: (0, words_1.word)('fileNotFound', { file: shown }) };
     }
     let stat;
     try {
@@ -145,7 +146,7 @@ function localProblem(file, shown) {
     catch {
         return link.isSymbolicLink()
             ? { code: 'broken_link', message: `${shown} points to a file that does not exist` }
-            : { code: 'unreadable', message: `cannot read ${shown}: permission denied` };
+            : { code: 'unreadable', message: (0, words_1.word)('fileNoPermission', { file: shown }) };
     }
     if (stat.isDirectory()) {
         return {
@@ -157,7 +158,7 @@ function localProblem(file, shown) {
         fs.closeSync(fs.openSync(file, 'r'));
     }
     catch {
-        return { code: 'unreadable', message: `cannot read ${shown}: permission denied` };
+        return { code: 'unreadable', message: (0, words_1.word)('fileNoPermission', { file: shown }) };
     }
     return undefined;
 }

package/out/lib/commandlist.d.ts

@@ -1,7 +1,7 @@
 export interface Listed {
     name: string;
     description: string;
-    /** `session`, `project skill`, `company skill`, `project command`, ... */
+    /** `session`, `workspace skill`, `company skill`, `workspace command`, ... */
     source: string;
 }
 export interface CommandList {

package/out/lib/commandlist.js

@@ -13,7 +13,7 @@ exports.fetchCommandList = fetchCommandList;
  * what counts as a skill, what it is called and what its line says is made on
  * the service.
  */
-const files_1 = require("../executor/files");
+const files_1 = require("../machine/executor/files");
 const gateway_1 = require("./gateway");
 const ROUNDS = 6;
 const MAX_CHARS = 8000;
@@ -35,7 +35,7 @@ async function fetchCommandList(root, words) {
     for (let round = 0; round < ROUNDS; round += 1) {
         const reply = await (0, gateway_1.ask)({
             intent: 'commands', prompt: '',
-            commandsPayload: { words, round, files, listings, project: root },
+            commandsPayload: { words, round, files, listings, project: root, forwards: true },
         });
         const body = reply.commands;
         if (!reply.ok || reply.served === false || !body) {

package/out/lib/config.d.ts

@@ -1,5 +1,7 @@
 import type { ExecutionMode, FooterConfig, Provider } from './types';
-export declare const HOME_DIR_NAME = ".comprism";
+export { HOME_DIR_NAME } from '../machine/runtime/home';
+import { homeDir } from '../machine/runtime/home';
+export { homeDir };
 export interface ContentPolicy {
     /**
      * Store request and response text alongside the records. Default false, and
@@ -68,7 +70,6 @@ export interface Config {
     updated: string;
 }
 export type Keys = Partial<Record<Provider, string>>;
-export declare function homeDir(): string;
 /**
  * Create the home directory at mode 700 if it is not there.
  *

package/out/lib/config.js

@@ -3,8 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HOME_DIR_NAME = void 0;
-exports.homeDir = homeDir;
+exports.homeDir = exports.HOME_DIR_NAME = void 0;
 exports.ensureHome = ensureHome;
 exports.configPath = configPath;
 exports.defaultConfig = defaultConfig;
@@ -41,10 +40,10 @@ exports.envVarName = envVarName;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
-exports.HOME_DIR_NAME = '.comprism';
-function homeDir() {
-    return process.env.COMPRISM_HOME || node_path_1.default.join(node_os_1.default.homedir(), exports.HOME_DIR_NAME);
-}
+var home_1 = require("../machine/runtime/home");
+Object.defineProperty(exports, "HOME_DIR_NAME", { enumerable: true, get: function () { return home_1.HOME_DIR_NAME; } });
+const home_2 = require("../machine/runtime/home");
+Object.defineProperty(exports, "homeDir", { enumerable: true, get: function () { return home_2.homeDir; } });
 /**
  * Create the home directory at mode 700 if it is not there.
  *
@@ -53,7 +52,7 @@ function homeDir() {
  * never noticed afterwards.
  */
 function ensureHome() {
-    const dir = homeDir();
+    const dir = (0, home_2.homeDir)();
     node_fs_1.default.mkdirSync(dir, { recursive: true, mode: 0o700 });
     try {
         node_fs_1.default.chmodSync(dir, 0o700);
@@ -64,7 +63,7 @@ function ensureHome() {
     return dir;
 }
 function configPath() {
-    return node_path_1.default.join(homeDir(), 'config.json');
+    return node_path_1.default.join((0, home_2.homeDir)(), 'config.json');
 }
 function defaultConfig() {
     const now = new Date().toISOString();

package/out/lib/connection.js

@@ -141,7 +141,7 @@ function isLocalAddress(url) {
 function writeConnection(connection, typed = false) {
     if (!typed && isLocalAddress(connection.url)) {
         throw new Error(`refusing to point this machine at ${connection.url}, which is this computer `
-            + 'rather than a workspace. Pass it with --workspace if that is genuinely what you want.');
+            + 'rather than an organization. Pass it with --workspace if that is genuinely what you want.');
     }
     (0, config_1.ensureHome)();
     node_fs_1.default.writeFileSync(connectionPath(), `${JSON.stringify(connection, null, 2)}\n`, { mode: 0o600 });

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';
+    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';
     client: string;
     decision: Decision;
     answer: string | null;
@@ -94,7 +94,7 @@ export interface GatewayReply {
     /**
      * Did this workspace's build serve the intent that was asked for.
      *
-     * False is a COMPLETE answer meaning "your workspace is behind", never an
+     * False is a COMPLETE answer meaning "your organization is behind", never an
      * error and never an absence. A caller that reads it as an absence repeats
      * the 17 September fault: a tool asked a workspace for its vendor list, the
      * build did not carry that question, and the refusal was reported to the
@@ -246,8 +246,8 @@ export interface GatewayReply {
      *
      * False means we never heard from it, so EVERY other field here is this
      * client's own placeholder rather than anything the workspace said. Without
-     * this a caller could not tell "the workspace says you have no provider key"
-     * from "the workspace did not answer", and it read the second as the first:
+     * this a caller could not tell "the organization says you have no provider key"
+     * from "the organization did not answer", and it read the second as the first:
      * somebody whose keys were all present and correct was told none was stored
      * and walked into a form asking them to paste one.
      */
@@ -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';
+    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';
     prompt: string;
     callingModel?: string;
     contextTokens?: number;

package/out/lib/machine.js

@@ -15,7 +15,7 @@ exports.isPlain = isPlain;
  * Kept in the tool's own `config.json`, never on the service, because none of
  * them changes what the agent does: two people sharing a project can each have
  * their own theme. Settings that do change what the agent does are the
- * service's and the project's (manual 2.10), and are not written here.
+ * service's and the workspace's (manual 2.10), and are not written here.
  */
 const config_1 = require("./config");
 /** Every machine setting, its allowed values, and its default. `editor` takes

package/out/lib/project-ops.d.ts

@@ -1,5 +1,5 @@
 import { type GatewayReply } from "./gateway";
-import { type ProjectFacts } from "./project";
+import { type ProjectFacts } from "../machine/folder/project";
 export type Intent = "instructions" | "config" | "memory" | "worktrees" | "hooks";
 export declare function useSessionFolder(folder: string | null): void;
 /** The project for this command: the session's folder, the saved default, or

package/out/lib/project-ops.js

@@ -50,8 +50,8 @@ exports.openEditor = openEditor;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const gateway_1 = require("./gateway");
-const project_1 = require("./project");
-const paths_1 = require("../executor/paths");
+const project_1 = require("../machine/folder/project");
+const paths_1 = require("../machine/executor/paths");
 const ui = __importStar(require("./ui"));
 const out = (s = "") => process.stdout.write(s + "\n");
 /** The largest file sent. An instruction or settings file is a page, not a book. */
@@ -104,8 +104,8 @@ async function call(intent, op, payload, facts, quiet = false) {
     });
     if (!reply.ok || reply.served === false) {
         out(ui.fail(reply.served === false
-            ? "Your workspace is running an older build that does not answer this yet."
-            : `Your workspace could not be reached: ${reply.message || "no answer"}`));
+            ? "Your organization is running an older build that does not answer this yet."
+            : `Your organization could not be reached: ${reply.message || "no answer"}`));
         return null;
     }
     if (reply.granted === false) {

package/out/lib/queue.js

@@ -51,7 +51,7 @@ const path = __importStar(require("path"));
 const child_process_1 = require("child_process");
 const gateway_1 = require("./gateway");
 const config_1 = require("./config");
-const self_1 = require("./self");
+const self_1 = require("../machine/runtime/self");
 async function queue(op, payload = {}) {
     return (0, gateway_1.ask)({
         intent: "queue", prompt: "", op,

package/out/lib/readiness.d.ts

@@ -1,33 +1,6 @@
-export interface Requirement {
-    /** What it is for, said as the work it makes possible. */
-    purpose: string;
-    /** Any one of these being present is enough. */
-    anyOf: string[];
-    /** Work that cannot be done without it, for the message. */
-    without: string;
-    /** True when the tool cannot function at all without this. */
-    essential: boolean;
-}
-export declare const REQUIREMENTS: Requirement[];
-/** Is this program on the machine, by name, without running anything of theirs. */
-export declare function present(program: string): boolean;
-/**
- * The one command that installs what is missing, for the machine it is on.
- *
- * Named per platform rather than guessed: telling somebody on Ubuntu to run a
- * Homebrew command is worse than saying nothing, because they now have to work
- * out that the instruction was wrong before they can work out what is right.
- */
-export declare function howToInstall(missing: string[]): string;
-export interface Readiness {
-    ready: boolean;
-    /** One line per requirement, ready to print. */
-    lines: string[];
-    /** The command to run, empty when nothing is missing. */
-    fix: string;
-}
-/** What this machine can and cannot do, and how to close the gap. */
-export declare function check(): Readiness;
+import { REQUIREMENTS, check, howToInstall, present } from '../machine/runtime/needs';
+export type { Readiness, Requirement } from '../machine/runtime/needs';
+export { REQUIREMENTS, check, howToInstall, present };
 /** One checked item: its line, whether it is required, and the fix. */
 export interface Finding {
     ok: boolean;

package/out/lib/readiness.js

@@ -36,10 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REQUIREMENTS = void 0;
-exports.present = present;
-exports.howToInstall = howToInstall;
-exports.check = check;
+exports.present = exports.howToInstall = exports.check = exports.REQUIREMENTS = void 0;
 exports.systemName = systemName;
 exports.diagnose = diagnose;
 /**
@@ -72,82 +69,16 @@ exports.diagnose = diagnose;
  * is not friction worth trading a customer's trust for.
  */
 const node_child_process_1 = require("node:child_process");
+const needs_1 = require("../machine/runtime/needs");
+Object.defineProperty(exports, "REQUIREMENTS", { enumerable: true, get: function () { return needs_1.REQUIREMENTS; } });
+Object.defineProperty(exports, "check", { enumerable: true, get: function () { return needs_1.check; } });
+Object.defineProperty(exports, "howToInstall", { enumerable: true, get: function () { return needs_1.howToInstall; } });
+Object.defineProperty(exports, "present", { enumerable: true, get: function () { return needs_1.present; } });
 const node_os_1 = __importDefault(require("node:os"));
 const install_1 = require("../commands/install");
 const connection_1 = require("./connection");
 const gateway_1 = require("./gateway");
 const node_fs_1 = __importDefault(require("node:fs"));
-exports.REQUIREMENTS = [
-    {
-        purpose: 'working with a repository',
-        anyOf: ['git'],
-        without: 'reading, branching and committing a project',
-        essential: false,
-    },
-    {
-        purpose: 'reading a PDF you already have',
-        // Three ways to do the same job. The first keeps the layout, the second is
-        // close, the third is usually there on any machine with Python at all.
-        anyOf: ['pdftotext', 'mutool', 'python3'],
-        without: 'reading a specification or a contract that arrived as a PDF',
-        essential: false,
-    },
-];
-/** Is this program on the machine, by name, without running anything of theirs. */
-function present(program) {
-    try {
-        // Windows has no /usr/bin/env, so every program read as missing there.
-        if (node_os_1.default.platform() === 'win32')
-            (0, node_child_process_1.execFileSync)('where', [program], { stdio: 'ignore' });
-        else
-            (0, node_child_process_1.execFileSync)('/usr/bin/env', ['which', program], { stdio: 'ignore' });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * The one command that installs what is missing, for the machine it is on.
- *
- * Named per platform rather than guessed: telling somebody on Ubuntu to run a
- * Homebrew command is worse than saying nothing, because they now have to work
- * out that the instruction was wrong before they can work out what is right.
- */
-function howToInstall(missing) {
-    if (missing.length === 0)
-        return '';
-    const platform = node_os_1.default.platform();
-    const parts = missing.map((m) => (m === 'pdftotext' ? 'poppler' : m));
-    if (platform === 'darwin')
-        return `brew install ${parts.join(' ')}`;
-    if (platform === 'linux') {
-        const apt = missing.map((m) => (m === 'pdftotext' ? 'poppler-utils' : m));
-        return `sudo apt-get install -y ${apt.join(' ')}`;
-    }
-    if (platform === 'win32')
-        return `winget install ${parts.join(' ')}`;
-    return `install: ${parts.join(', ')}`;
-}
-/** What this machine can and cannot do, and how to close the gap. */
-function check() {
-    const lines = [];
-    const missing = [];
-    for (const req of exports.REQUIREMENTS) {
-        const found = req.anyOf.find(present);
-        if (found) {
-            lines.push(`  ready    ${req.purpose}`);
-        }
-        else {
-            // The FIRST of the alternatives is the one named, because a list of three
-            // equivalent programs is a decision nobody wants to make about a thing
-            // they did not know they needed.
-            missing.push(req.anyOf[0]);
-            lines.push(`  missing  ${req.purpose}, so ${req.without} will not work`);
-        }
-    }
-    return { ready: missing.length === 0, lines, fix: howToInstall(missing) };
-}
 /** The system this is, in the words its owner would use. */
 function systemName() {
     try {
@@ -205,7 +136,7 @@ async function diagnose() {
     const major = Number(node.split('.')[0]);
     // The install script and Python installs carry their own Node (manual 1.1),
     // so the line says so rather than asking for a Node nobody installed.
-    const { installMethod, isStandalone } = await Promise.resolve().then(() => __importStar(require('./self')));
+    const { installMethod, isStandalone } = await Promise.resolve().then(() => __importStar(require('../machine/runtime/self')));
     if (isStandalone()) {
         const how = installMethod() === 'script' ? 'the install script' : 'Python (pip)';
         found.push({ ok: true, required: true, line: `installed with ${how}; Node ${node} is built in, nothing else needed` });
@@ -260,17 +191,17 @@ async function diagnose() {
     const git = version('git', ['--version']);
     found.push(git !== null
         ? { ok: true, required: false, line: `git ${git}` }
-        : { ok: false, required: false, line: 'git not found: reading, branching and committing a project will not work',
-            fix: howToInstall(['git']) });
+        : { ok: false, required: false, line: 'git not found: reading, branching and committing a workspace will not work',
+            fix: (0, needs_1.howToInstall)(['git']) });
     const rg = version('rg', ['--version']);
     found.push(rg !== null
         ? { ok: true, required: false, line: `ripgrep ${rg}` }
         : { ok: false, required: false, line: 'ripgrep not found: searches will be slower',
-            fix: howToInstall(['ripgrep']) });
-    const pdf = exports.REQUIREMENTS[1];
-    found.push(pdf.anyOf.some(present)
+            fix: (0, needs_1.howToInstall)(['ripgrep']) });
+    const pdf = needs_1.REQUIREMENTS[1];
+    found.push(pdf.anyOf.some(needs_1.present)
         ? { ok: true, required: false, line: 'a PDF reader' }
         : { ok: false, required: false, line: `no PDF reader: ${pdf.without} will not work`,
-            fix: howToInstall(['pdftotext']) });
+            fix: (0, needs_1.howToInstall)(['pdftotext']) });
     return found;
 }

package/out/lib/servicecommand.d.ts

@@ -0,0 +1,14 @@
+export interface ServiceAnswer {
+    /** False when nobody answered; `lines` then holds nothing. */
+    reached: boolean;
+    /** Whether the service did what was asked. */
+    ok: boolean;
+    lines: string[];
+    /** The one change to this client's own state the service asked for. */
+    action: Record<string, string> | null;
+    message?: string;
+}
+export declare function runServiceCommand(words: string, facts: {
+    cwd: string;
+    current?: string;
+}): Promise<ServiceAnswer>;

package/out/lib/servicecommand.js

@@ -0,0 +1,74 @@
+"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.runServiceCommand = runServiceCommand;
+/**
+ * Ask the service to run a command it owns (web manual 13.2 to 13.5): what was
+ * typed goes up, the service decides what it means and writes every line, and
+ * this answers its one question only this computer can, whether a folder exists.
+ *
+ * Shared by the session and by the commands typed straight at the shell, so a
+ * service command behaves the same wherever it is typed.
+ */
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const gateway_1 = require("./gateway");
+async function runServiceCommand(words, facts) {
+    const exists = {};
+    for (let round = 0; round < 4; round += 1) {
+        const reply = await (0, gateway_1.ask)({
+            intent: 'command', prompt: '',
+            payload: { words, cwd: facts.cwd, home: os.homedir(), current: facts.current ?? '', exists },
+        });
+        if (!reply.lines?.length && !reply.data) {
+            return { reached: false, ok: false, lines: [], action: null, message: reply.message ?? undefined };
+        }
+        const data = (reply.data ?? {});
+        const wanted = data.wants?.exists ?? [];
+        if (wanted.length) {
+            for (const p of wanted) {
+                try {
+                    exists[p] = fs.statSync(p).isDirectory();
+                }
+                catch {
+                    exists[p] = false;
+                }
+            }
+            continue;
+        }
+        return { reached: true, ok: reply.granted !== false, lines: reply.lines ?? [], action: data.action ?? null };
+    }
+    return { reached: false, ok: false, lines: [], action: null };
+}