@illuminis/comprism 0.1.3 → 0.1.5

package/out/commands/cost.js

@@ -0,0 +1,167 @@
+"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.cmdCost = cmdCost;
+/**
+ * `comprism cost` — what a session cost, and what drove it.
+ *
+ * ── This file draws. It decides nothing ───────────────────────────────────
+ *
+ * Every word and every number below is written by `spend_report` on our
+ * server: which figures belong on the screen, what each one is called, what
+ * order they read in, and how each is formatted. This file receives that and
+ * puts it on a terminal.
+ *
+ * It was not always so. The first cut of this command held the list of cost
+ * factors, their labels and their formatting, which meant adding a factor or
+ * renaming one obliged every customer to install a new version of the tool to
+ * see a figure we had already begun measuring. A published package is the one
+ * thing in this product we cannot change, so as little as possible is decided
+ * inside it.
+ *
+ * What genuinely has to stay here is drawing: the server does not know the
+ * width of somebody's window or whether their terminal renders color, and
+ * finished text sent from a server breaks on a narrow window.
+ *
+ * A dash is how "nobody measured this" reaches the screen. The server sends
+ * null for it, never zero, because a zero in a cost column reads as a
+ * measurement.
+ */
+const gateway_1 = require("../lib/gateway");
+const connection_1 = require("../lib/connection");
+const ui = __importStar(require("../lib/ui"));
+const out = (s = '') => process.stdout.write(`${s}\n`);
+/** A cell. Null and undefined are a figure nobody measured, so they print as a dash. */
+const cell = (v) => v === null || v === undefined || v === '' ? ui.c.dim('—') : String(v);
+async function cmdCost(args) {
+    const conn = (0, connection_1.readConnection)();
+    if (!conn?.url || !conn.workspaceKey) {
+        out();
+        out(ui.warn('This machine is not signed in, so there is no work to read.'));
+        out(`      ${ui.c.dim('$')} comprism login`);
+        out();
+        return 1;
+    }
+    // The first bare word is a session, when one is given. No flag, because
+    // "which session" is the only thing this command takes.
+    const wanted = args.find((a) => a && !a.startsWith('-'));
+    const reply = await (0, gateway_1.ask)({
+        intent: 'spend',
+        prompt: '',
+        ...(wanted ? { spendSession: wanted } : {}),
+    });
+    // A workspace whose build does not carry this question says so, and that is a
+    // complete answer rather than an absence. Reading a refusal as "no spend"
+    // would tell somebody their work cost nothing.
+    if (reply.served === false) {
+        out();
+        out(ui.warn('This workspace is running a build that cannot answer this yet.'));
+        out(`      ${ui.c.dim(reply.message || '')}`);
+        out();
+        return 1;
+    }
+    const report = reply.spend;
+    if (!report || !report.session) {
+        out();
+        out(ui.info(reply.message || 'No work has been recorded in this workspace yet.'));
+        out();
+        return 0;
+    }
+    const s = report.session;
+    // An older workspace answers without a presentation block. Saying so beats
+    // drawing an empty screen, and beats this file inventing the layout again.
+    const p = report.presentation;
+    if (!p) {
+        out();
+        out(ui.warn('This workspace answered without the breakdown this version draws.'));
+        out(`      ${ui.c.dim('Deploy the workspace, or run `comprism status` to see which one you are on.')}`);
+        out();
+        return 1;
+    }
+    out();
+    out(ui.banner(String(p.heading || 'What this session cost')));
+    out();
+    out(`  ${ui.c.bold(String(s.title || s.session_id))}`);
+    out(ui.c.dim(`  ${String(s.started_at || '').slice(0, 16).replace('T', ' ')}`
+        + `  ·  ${String(s.turns ?? 0)} turn(s)`
+        + `  ·  ${String(s.surface || 'unknown surface')}`));
+    out();
+    const headline = (p.headline || []);
+    // One line per figure, label, value and the service's note in full, so a
+    // word like "estimated" is never cut to fit a box (manual 10.11). A figure
+    // nobody measured is blank.
+    if (headline.length > 0) {
+        for (const h of headline) {
+            const value = h.value === null || h.value === undefined ? 'blank' : String(h.value);
+            out(`  ${String(h.label || '').padEnd(18)}  ${ui.c.bold(value.padEnd(9))} ${ui.c.dim(h.note ? String(h.note) : '')}`);
+        }
+        out();
+    }
+    const factorRows = (p.factor_rows || []);
+    out(ui.c.muted(`  ${String(p.factor_heading || '')}`));
+    out();
+    if (factorRows.length > 0) {
+        out(ui.table(p.factor_columns || ['factor', 'cost'], factorRows.map((r) => [String(r.label ?? ''), cell(r.value)])));
+        out();
+        if (p.driver) {
+            out(ui.c.dim(`  ${String(p.driver)}`));
+            out();
+        }
+    }
+    else if (p.factor_empty) {
+        out(ui.c.dim(`  ${String(p.factor_empty)}`));
+        out();
+    }
+    const callRows = (p.call_rows || []);
+    const callColumns = (p.call_columns || []);
+    if (callRows.length > 0 && callColumns.length > 0) {
+        out(ui.c.muted(`  ${String(p.call_heading || '')}`));
+        out();
+        out(ui.table(callColumns, 
+        // Read by the column names the server sent, so a column added there
+        // appears here without this file being told about it.
+        callRows.map((r) => callColumns.map((k) => cell(r[k])))));
+        out();
+    }
+    if (p.footnote) {
+        out(ui.c.dim(`  ${String(p.footnote)}`));
+        out();
+    }
+    if (reply.details_url) {
+        out(ui.c.dim(`  Every figure here traces to its records: ${reply.details_url}`));
+        out();
+    }
+    return 0;
+}

package/out/commands/hooks.d.ts

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

package/out/commands/hooks.js

@@ -0,0 +1,83 @@
+"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.cmdHooks = cmdHooks;
+/**
+ * `comprism hooks` and `comprism hooks test` (manual 10.10).
+ *
+ * This reads the project's settings files and sends them; the service says
+ * which hooks are in force here, where each came from, and for a test which
+ * ones run, in order. This then runs exactly those and shows what they did.
+ */
+const ui = __importStar(require("../lib/ui"));
+const project_ops_1 = require("../lib/project-ops");
+const hooks_1 = require("../executor/hooks");
+const out = (s = "") => process.stdout.write(`${s}\n`);
+async function cmdHooks(args) {
+    const facts = await (0, project_ops_1.currentProject)();
+    const files = (0, hooks_1.hookFiles)(facts.root);
+    if (args[0] === "test") {
+        const [, when, action, target] = args;
+        if (!when) {
+            out(ui.fail("Say which moment: comprism hooks test <when> [action] [file], "
+                + "for example comprism hooks test after edit_file calc.py"));
+            return 2;
+        }
+        if ((0, hooks_1.insideHook)()) {
+            out(ui.fail("Hooks do not run from inside a hook, so nothing was run."));
+            return 1;
+        }
+        const reply = await (0, project_ops_1.call)("hooks", "test", { files, when, action: action ?? "" }, facts);
+        if (!reply)
+            return 1;
+        const chosen = (reply.data?.hooks) ?? [];
+        const done = await (0, hooks_1.runHooks)(facts.root, chosen, {
+            when, action, args: target ? { path: target } : {},
+        });
+        for (const line of (0, hooks_1.reportLines)(done))
+            out(`  ${line}`);
+        if (done.refusedBy)
+            out(`  ${done.detail}`);
+        out();
+        return done.refusedBy || done.failed.length ? 1 : 0;
+    }
+    if (args[0] && args[0] !== "list") {
+        out(ui.fail(`\`hooks ${args[0]}\` is not a command. Use comprism hooks, or comprism hooks test.`));
+        return 2;
+    }
+    const reply = await (0, project_ops_1.call)("hooks", "list", { files }, facts);
+    out();
+    return reply ? 0 : 1;
+}

package/out/commands/install.d.ts

@@ -1,6 +1,17 @@
+import { type InstallMethod } from '../lib/self';
 /** The header the tenant reads to decide whether this machine may be served. */
 export declare const WORKSPACE_KEY_HEADER = "x-comprism-key";
 export declare function envScriptPath(): string;
+/** The PowerShell form of the setup script, for Windows (manual 1.2). */
+export declare function envScriptPathPs(): string;
+/**
+ * The PowerShell profiles to set up on Windows: Windows PowerShell's and,
+ * where it exists, PowerShell 7's. Windows PowerShell's is created when there
+ * is none, because it is the shell every Windows machine has.
+ */
+export declare function powershellProfiles(): string[];
+/** The PowerShell script: the same rule as the POSIX one, in PowerShell. */
+export declare function envScriptPs(baseUrl: string | null, workspaceKey?: string | null): string;
 export declare function pidFilePath(): string;
 export declare function proxyLogPath(): string;
 /** Every profile we should add the line to, that actually exists. */
@@ -118,9 +129,41 @@ export declare function install(options?: {
     binary?: LaunchCommand;
     workspaceKey?: string | null;
 }): InstallReport;
-/** Take the line back out. An install you cannot cleanly undo is a liability. */
+/**
+ * Rewrite the generated script from the connection as it now stands.
+ *
+ * Sign in and sign out call this. Before, only the install wrote it, and the
+ * install runs before anybody has signed in, so the script said "not enrolled"
+ * forever and signing in never switched measurement on. After sign out it kept
+ * presenting a revoked key. Touches no shell profile: a machine that never had
+ * the line added is left exactly as it was.
+ */
+export declare function refreshEnvScript(): void;
+/**
+ * What sign in calls: refresh the setup script, and on a Python install that
+ * was never set up, do the setup now (manual 1.1, Option 3).
+ *
+ * npm runs the setup as it installs and the install script runs it itself, but
+ * pip has no step of its own, so the first sign in is the first moment this
+ * tool runs on a machine that asked for it. Returns the profiles it changed,
+ * for the caller to say so. Every other install is left to `refreshEnvScript`.
+ */
+export declare function finishSetup(): string[];
+/** Does this profile carry our fenced line. */
+export declare function profileHasSetup(profile: string): boolean;
+/**
+ * Take the line back out. An install you cannot cleanly undo is a liability.
+ *
+ * Removes only what the install wrote: the fenced profile block, the generated
+ * `env.sh` and our own Claude Desktop entry. The sign in and settings stay, and
+ * the caller says so, because deleting a live credential file is not revoking it.
+ */
 export declare function uninstall(): {
     profilesCleaned: string[];
+    scriptRemoved: boolean;
+    programRemoved: boolean;
+    method: InstallMethod;
+    kept: string;
 };
 /**
  * The command that starts this package's CLI, resolved from the package itself.

package/out/commands/install.js

@@ -5,6 +5,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WORKSPACE_KEY_HEADER = void 0;
 exports.envScriptPath = envScriptPath;
+exports.envScriptPathPs = envScriptPathPs;
+exports.powershellProfiles = powershellProfiles;
+exports.envScriptPs = envScriptPs;
 exports.pidFilePath = pidFilePath;
 exports.proxyLogPath = proxyLogPath;
 exports.shellProfiles = shellProfiles;
@@ -15,6 +18,9 @@ exports.installDesktopConnector = installDesktopConnector;
 exports.probeDesktopConnector = probeDesktopConnector;
 exports.uninstallDesktopConnector = uninstallDesktopConnector;
 exports.install = install;
+exports.refreshEnvScript = refreshEnvScript;
+exports.finishSetup = finishSetup;
+exports.profileHasSetup = profileHasSetup;
 exports.uninstall = uninstall;
 exports.launchShellString = launchShellString;
 exports.proxyHealthy = proxyHealthy;
@@ -72,6 +78,7 @@ const node_path_1 = __importDefault(require("node:path"));
 const node_child_process_1 = require("node:child_process");
 const config_1 = require("../lib/config");
 const connection_1 = require("../lib/connection");
+const self_1 = require("../lib/self");
 /** The header the tenant reads to decide whether this machine may be served. */
 exports.WORKSPACE_KEY_HEADER = 'x-comprism-key';
 const MARKER_START = '# >>> comprism >>>';
@@ -79,6 +86,53 @@ const MARKER_END = '# <<< comprism <<<';
 function envScriptPath() {
     return node_path_1.default.join((0, config_1.homeDir)(), 'env.sh');
 }
+/** The PowerShell form of the setup script, for Windows (manual 1.2). */
+function envScriptPathPs() {
+    return node_path_1.default.join((0, config_1.homeDir)(), 'env.ps1');
+}
+/**
+ * The PowerShell profiles to set up on Windows: Windows PowerShell's and,
+ * where it exists, PowerShell 7's. Windows PowerShell's is created when there
+ * is none, because it is the shell every Windows machine has.
+ */
+function powershellProfiles() {
+    if (process.platform !== 'win32' && !process.env.COMPRISM_TEST_POWERSHELL)
+        return [];
+    const docs = node_path_1.default.join(process.env.USERPROFILE || node_os_1.default.homedir(), 'Documents');
+    const classic = node_path_1.default.join(docs, 'WindowsPowerShell', 'Microsoft.PowerShell_profile.ps1');
+    const modern = node_path_1.default.join(docs, 'PowerShell', 'Microsoft.PowerShell_profile.ps1');
+    const out = [classic];
+    if (node_fs_1.default.existsSync(node_path_1.default.dirname(modern)))
+        out.push(modern);
+    return out;
+}
+/** The PowerShell script: the same rule as the POSIX one, in PowerShell. */
+function envScriptPs(baseUrl, workspaceKey) {
+    const bin = (0, self_1.standaloneBinDir)();
+    const pathLine = node_fs_1.default.existsSync(node_path_1.default.join(bin, 'comprism.exe'))
+        ? `if ($env:Path -notlike '*${bin.replace(/'/g, "''")}*') { $env:Path = '${bin.replace(/'/g, "''")};' + $env:Path }\n`
+        : '';
+    const head = '# Managed by comprism. Edit nothing here; run `comprism install` to regenerate.\n' + pathLine;
+    if (!baseUrl || !workspaceKey) {
+        return `${head}#\n# This machine is not signed in, so this sets nothing and your tools are untouched.\n`;
+    }
+    const q = (v) => v.replace(/'/g, "''");
+    return `${head}#
+# Points AI clients at your CompletionPrism tenant so your work is measured.
+# If the tenant is not reachable, this sets NOTHING and your tools talk
+# straight to the provider exactly as they would without us.
+try {
+  Invoke-WebRequest -Uri '${q(baseUrl)}/health' -UseBasicParsing -TimeoutSec 2 | Out-Null
+  $env:ANTHROPIC_BASE_URL = '${q(baseUrl)}'
+  $__comprism = '${exports.WORKSPACE_KEY_HEADER}: ${q(workspaceKey)}'
+  if (-not $env:ANTHROPIC_CUSTOM_HEADERS) { $env:ANTHROPIC_CUSTOM_HEADERS = $__comprism }
+  elseif ($env:ANTHROPIC_CUSTOM_HEADERS -notlike '*${exports.WORKSPACE_KEY_HEADER}*') {
+    $env:ANTHROPIC_CUSTOM_HEADERS = "$($env:ANTHROPIC_CUSTOM_HEADERS)\`n$__comprism"
+  }
+  Remove-Variable __comprism -ErrorAction SilentlyContinue
+} catch { }
+`;
+}
 function pidFilePath() {
     return node_path_1.default.join((0, config_1.homeDir)(), 'proxy.pid');
 }
@@ -92,6 +146,11 @@ function shellProfiles() {
     const found = candidates
         .map((f) => node_path_1.default.join(home, f))
         .filter((p) => node_fs_1.default.existsSync(p));
+    // Windows shells read none of these, and the generated script is POSIX. An
+    // existing Git Bash profile is still set up; nothing is created, because a
+    // new .zshrc on Windows is litter that measures nothing.
+    if (process.platform === 'win32')
+        return found;
     // A machine with none of them: create the one matching the login shell rather
     // than silently doing nothing.
     if (found.length === 0) {
@@ -135,6 +194,21 @@ function tenantBaseUrl(explicit) {
  * the day there is an OpenAI-shaped endpoint to point at.
  */
 function envScript(baseUrl, workspaceKey) {
+    return envScriptBody(baseUrl, workspaceKey).replace(/^#!\/bin\/sh\n/, `#!/bin/sh\n${pathBlock()}`);
+}
+/**
+ * The install script puts the program in `~/.comprism/bin` (manual 1.1,
+ * Option 1), so the setup script puts that folder on the PATH, once. It is
+ * written only when the program is there, so an npm or Python install is
+ * unchanged.
+ */
+function pathBlock() {
+    const bin = (0, self_1.standaloneBinDir)();
+    if (!node_fs_1.default.existsSync(node_path_1.default.join(bin, 'comprism')))
+        return '';
+    return `case ":$PATH:" in *":${bin}:"*) : ;; *) PATH="${bin}:$PATH"; export PATH ;; esac\n`;
+}
+function envScriptBody(baseUrl, workspaceKey) {
     if (!baseUrl) {
         return `#!/bin/sh
 # Managed by comprism. Edit nothing here; run \`comprism install\` to regenerate.
@@ -388,6 +462,27 @@ function install(options = {}) {
     const line = `${MARKER_START}\n[ -f "${scriptPath}" ] && . "${scriptPath}"\n${MARKER_END}`;
     const touched = [];
     const already = [];
+    // Windows: the same fenced line, in PowerShell's own profile (manual 1.2).
+    const psProfiles = powershellProfiles();
+    if (psProfiles.length) {
+        const ps = envScriptPathPs();
+        node_fs_1.default.writeFileSync(ps, envScriptPs(baseUrl, workspaceKey));
+        const psLine = `${MARKER_START}\nif (Test-Path '${ps.replace(/'/g, "''")}') { . '${ps.replace(/'/g, "''")}' }\n${MARKER_END}`;
+        for (const profile of psProfiles) {
+            node_fs_1.default.mkdirSync(node_path_1.default.dirname(profile), { recursive: true });
+            const contents = node_fs_1.default.existsSync(profile) ? node_fs_1.default.readFileSync(profile, 'utf8') : '';
+            if (contents.includes(MARKER_START)) {
+                const next = contents.replace(new RegExp(`${MARKER_START}[\\s\\S]*?${MARKER_END}`), psLine);
+                if (next !== contents)
+                    node_fs_1.default.writeFileSync(profile, next);
+                already.push(profile);
+            }
+            else {
+                node_fs_1.default.appendFileSync(profile, `\n${psLine}\n`);
+                touched.push(profile);
+            }
+        }
+    }
     for (const profile of shellProfiles()) {
         let contents = '';
         try {
@@ -419,10 +514,60 @@ function install(options = {}) {
         desktop: installDesktopConnector(resolveDesktopBinary()),
     };
 }
-/** Take the line back out. An install you cannot cleanly undo is a liability. */
+/**
+ * Rewrite the generated script from the connection as it now stands.
+ *
+ * Sign in and sign out call this. Before, only the install wrote it, and the
+ * install runs before anybody has signed in, so the script said "not enrolled"
+ * forever and signing in never switched measurement on. After sign out it kept
+ * presenting a revoked key. Touches no shell profile: a machine that never had
+ * the line added is left exactly as it was.
+ */
+function refreshEnvScript() {
+    const script = envScriptPath();
+    if (!node_fs_1.default.existsSync(script))
+        return;
+    node_fs_1.default.writeFileSync(script, envScript(tenantBaseUrl(), (0, connection_1.readConnection)()?.workspaceKey ?? null), { mode: 0o700 });
+    const ps = envScriptPathPs();
+    if (node_fs_1.default.existsSync(ps))
+        node_fs_1.default.writeFileSync(ps, envScriptPs(tenantBaseUrl(), (0, connection_1.readConnection)()?.workspaceKey ?? null));
+}
+/**
+ * What sign in calls: refresh the setup script, and on a Python install that
+ * was never set up, do the setup now (manual 1.1, Option 3).
+ *
+ * npm runs the setup as it installs and the install script runs it itself, but
+ * pip has no step of its own, so the first sign in is the first moment this
+ * tool runs on a machine that asked for it. Returns the profiles it changed,
+ * for the caller to say so. Every other install is left to `refreshEnvScript`.
+ */
+function finishSetup() {
+    if ((0, self_1.installMethod)() === 'python' && !node_fs_1.default.existsSync(envScriptPath()))
+        return install().profilesTouched;
+    refreshEnvScript();
+    return [];
+}
+/** Does this profile carry our fenced line. */
+function profileHasSetup(profile) {
+    try {
+        return node_fs_1.default.readFileSync(profile, 'utf8').includes(MARKER_START);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Take the line back out. An install you cannot cleanly undo is a liability.
+ *
+ * Removes only what the install wrote: the fenced profile block, the generated
+ * `env.sh` and our own Claude Desktop entry. The sign in and settings stay, and
+ * the caller says so, because deleting a live credential file is not revoking it.
+ */
 function uninstall() {
+    // Read first: once the program's folder is gone it can no longer be told.
+    const method = (0, self_1.installMethod)();
     const cleaned = [];
-    for (const profile of shellProfiles()) {
+    for (const profile of [...powershellProfiles(), ...shellProfiles()]) {
         let contents = '';
         try {
             contents = node_fs_1.default.readFileSync(profile, 'utf8');
@@ -439,7 +584,54 @@ function uninstall() {
         cleaned.push(profile);
     }
     uninstallDesktopConnector();
-    return { profilesCleaned: cleaned };
+    const script = envScriptPath();
+    const scriptRemoved = node_fs_1.default.existsSync(script) || node_fs_1.default.existsSync(envScriptPathPs());
+    node_fs_1.default.rmSync(script, { force: true });
+    node_fs_1.default.rmSync(envScriptPathPs(), { force: true });
+    const programRemoved = method === 'script' ? removeStandaloneProgram() : false;
+    return { profilesCleaned: cleaned, scriptRemoved, programRemoved, method, kept: (0, config_1.homeDir)() };
+}
+/**
+ * The install script's program and its folder, and on Windows the PATH entry
+ * the installer added (manual 1.8). Only `~/.comprism/bin`: the sign in and
+ * settings beside it stay.
+ *
+ * A running program can be deleted on macOS and Linux. Windows refuses to
+ * delete it but allows it to be moved, so there the program is moved to the
+ * temporary folder and the folder removed at once; the moved copy is deleted a
+ * moment after this process exits. Everything is done before returning,
+ * rather than left to a background process: a background process can be
+ * stopped with its parent, and the first version, which worked that way, left
+ * the folder and the PATH entry behind on Windows Server.
+ */
+function removeStandaloneProgram() {
+    const bin = (0, self_1.standaloneBinDir)();
+    if (process.platform !== 'win32') {
+        node_fs_1.default.rmSync(bin, { recursive: true, force: true });
+        return true;
+    }
+    const q = (v) => v.replace(/'/g, "''");
+    (0, node_child_process_1.spawnSync)('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command',
+        `$b='${q(bin)}'; $p=[Environment]::GetEnvironmentVariable('Path','User'); `
+            + `if ($p) { [Environment]::SetEnvironmentVariable('Path', (($p -split ';') | Where-Object { $_ -and $_ -ne $b }) -join ';', 'User') }`,
+    ], { stdio: 'ignore', windowsHide: true });
+    const parked = node_path_1.default.join(node_os_1.default.tmpdir(), `comprism-removed-${process.pid}.exe`);
+    try {
+        node_fs_1.default.renameSync(node_path_1.default.join(bin, 'comprism.exe'), parked);
+    }
+    catch {
+        // Not there, or on another drive: the folder removal below says which.
+    }
+    try {
+        node_fs_1.default.rmSync(bin, { recursive: true, force: true });
+    }
+    catch {
+        return false;
+    }
+    (0, node_child_process_1.spawn)('cmd.exe', ['/d', '/c', `ping -n 3 127.0.0.1 >nul & del /f /q "${parked}"`], {
+        detached: true, stdio: 'ignore', windowsHide: true,
+    }).unref();
+    return true;
 }
 /** The shell form, quoted, for the profile script that must be a shell string. */
 function launchShellString(launch) {
@@ -486,6 +678,8 @@ function resolveBinary() {
  * genuinely better because it survives the package moving.
  */
 function resolveDesktopBinary() {
+    if ((0, self_1.isStandalone)())
+        return { command: process.execPath, args: [] };
     const compiled = node_path_1.default.join(__dirname, 'cli.js');
     if (!node_fs_1.default.existsSync(compiled))
         return resolveBinary();
@@ -514,7 +708,7 @@ async function startDaemon(port) {
         return true;
     (0, config_1.ensureHome)();
     const out = node_fs_1.default.openSync(proxyLogPath(), 'a');
-    const child = (0, node_child_process_1.spawn)(process.execPath, [process.argv[1], 'proxy', '--port', String(port)], {
+    const child = (0, node_child_process_1.spawn)(...(0, self_1.selfLaunch)(['proxy', '--port', String(port)]), {
         detached: true,
         stdio: ['ignore', out, out],
     });

package/out/commands/instructions.d.ts

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