@craftspace/cli 0.1.0

package/dist/run.js

@@ -0,0 +1,117 @@
+import { spawn } from 'node:child_process';
+import { MACHINE_RUN_OUTPUT_MAX, spreadIfDefined } from '@craftspace/shared';
+export const runner = {
+    attended(argv) {
+        return new Promise((resolve) => {
+            const child = spawn(argv[0], argv.slice(1), { stdio: 'inherit' });
+            child.on('error', () => resolve(127));
+            child.on('close', (code) => resolve(code ?? 0));
+        });
+    },
+    async unattended({ work, onProgress, }) {
+        const argv = headlessArgv(work);
+        let output = '';
+        let agentSessionId = work.agentSessionId ?? undefined;
+        let lastText = '';
+        let pending = '';
+        const append = (text) => {
+            output = `${output}${text}`.slice(-MACHINE_RUN_OUTPUT_MAX);
+            onProgress?.({ id: work.id, state: 'running', output, ...spreadIfDefined({ agentSessionId }) });
+        };
+        const readLine = (line) => {
+            const event = parseJson(line);
+            if (event === null) {
+                append(`${line}\n`);
+                return;
+            }
+            const seen = readEvent(event);
+            if (seen.sessionId !== undefined)
+                agentSessionId = seen.sessionId;
+            if (seen.text !== undefined) {
+                lastText = seen.text;
+                append(`${seen.text}\n`);
+            }
+        };
+        const code = await new Promise((resolve) => {
+            const child = spawn(argv[0], argv.slice(1), { stdio: ['ignore', 'pipe', 'pipe'] });
+            child.stdout.setEncoding('utf8');
+            child.stderr.setEncoding('utf8');
+            child.stdout.on('data', (chunk) => {
+                pending += chunk;
+                const lines = pending.split('\n');
+                pending = lines.pop() ?? '';
+                for (const line of lines)
+                    if (line.trim() !== '')
+                        readLine(line);
+            });
+            child.stderr.on('data', (chunk) => append(chunk));
+            child.on('error', (error) => {
+                append(`${error.message}\n`);
+                resolve(127);
+            });
+            child.on('close', (exit) => {
+                if (pending.trim() !== '')
+                    readLine(pending);
+                resolve(exit ?? 0);
+            });
+        });
+        if (code === 0) {
+            return { id: work.id, state: 'done', output, exitCode: 0, ...spreadIfDefined({ agentSessionId }) };
+        }
+        if (agentSessionId !== undefined) {
+            return {
+                id: work.id,
+                state: 'needs_input',
+                output,
+                question: (lastText === '' ? 'It stopped and needs a decision from you.' : lastText).slice(0, 4000),
+                agentSessionId,
+            };
+        }
+        return { id: work.id, state: 'failed', output, exitCode: code, ...spreadIfDefined({ agentSessionId }) };
+    },
+};
+export function headlessArgv(work) {
+    const argv = work.argv;
+    if (!isAgent(argv[0]))
+        return argv;
+    // A Remote Control session is interactive and long-lived, and its whole point is that a phone drives it.
+    // Wrapping it in -p would turn it into a one-shot print run with nothing to attach to.
+    if (argv.includes('--remote-control'))
+        return argv;
+    const streaming = ['--output-format', 'stream-json', '--verbose'];
+    if (work.answer !== null && work.agentSessionId !== null) {
+        return [argv[0], '--resume', work.agentSessionId, '-p', work.answer, ...streaming];
+    }
+    if (argv.includes('-p') || argv.includes('--print'))
+        return [...argv, ...streaming];
+    return [argv[0], '-p', argv.slice(1).join(' '), ...streaming];
+}
+function isAgent(command) {
+    return AGENTS.has((command ?? '').split('/').pop() ?? '');
+}
+const AGENTS = new Set(['claude', 'codex', 'opencode']);
+function readEvent(event) {
+    const sessionId = typeof event.session_id === 'string' ? event.session_id : undefined;
+    if (event.type === 'assistant') {
+        const message = event.message;
+        const text = (message?.content ?? [])
+            .filter((part) => part.type === 'text' && typeof part.text === 'string')
+            .map((part) => part.text)
+            .join('');
+        return { ...spreadIfDefined({ sessionId }), ...spreadIfDefined({ text: text === '' ? undefined : text }) };
+    }
+    if (event.type === 'result') {
+        const result = typeof event.result === 'string' ? event.result : undefined;
+        return { ...spreadIfDefined({ sessionId }), ...spreadIfDefined({ text: result }) };
+    }
+    return spreadIfDefined({ sessionId });
+}
+function parseJson(line) {
+    try {
+        const parsed = JSON.parse(line);
+        return typeof parsed === 'object' && parsed !== null ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/setup.d.ts

@@ -0,0 +1,8 @@
+import type { MachineTool } from '@craftspace/shared';
+export declare const setup: {
+    run({ install, rewire, say, }: {
+        install: boolean;
+        rewire?: () => Promise<void>;
+        say?: (line: string) => void;
+    }): Promise<MachineTool[]>;
+};

package/dist/setup.js

@@ -0,0 +1,59 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { probe } from './probe.js';
+const run = promisify(execFile);
+export const setup = {
+    async run({ install, rewire, say, }) {
+        const found = await probe.tools();
+        if (!install)
+            return found;
+        const repairs = { ...REPAIRS, ...(rewire === undefined ? {} : { brain: { name: 'the brain', fix: rewire } }) };
+        const broken = found.filter((tool) => !tool.ok && repairs[tool.id] !== undefined);
+        if (broken.length === 0)
+            return found;
+        for (const tool of broken) {
+            const repair = repairs[tool.id];
+            if (repair === undefined)
+                continue;
+            say?.(`Setting up ${repair.name}`);
+            const failed = await repair.fix().then(() => null, (error) => firstLine(error.message));
+            say?.(failed === null ? `  ${repair.name} is ready` : `  could not set up ${repair.name}: ${failed}`);
+        }
+        return probe.tools();
+    },
+};
+const REPAIRS = {
+    claude: { name: 'Claude Code', fix: () => npmGlobal('@anthropic-ai/claude-code') },
+    codex: { name: 'Codex', fix: () => npmGlobal('@openai/codex') },
+    git: { name: 'the GitHub CLI', fix: () => installPackage({ brew: ['gh'], apt: ['gh'], dnf: ['gh'] }) },
+    chrome: {
+        name: 'Google Chrome',
+        fix: () => installPackage({ brew: ['--cask', 'google-chrome'], apt: ['chromium'], dnf: ['chromium'] }),
+    },
+};
+async function npmGlobal(name) {
+    await run('npm', ['install', '-g', name], { timeout: INSTALL_TIMEOUT_MS });
+}
+async function installPackage({ brew, apt, dnf }) {
+    if (process.platform === 'darwin') {
+        await run('brew', ['install', ...brew], { timeout: INSTALL_TIMEOUT_MS });
+        return;
+    }
+    const manager = await firstAvailable(['apt-get', 'dnf']);
+    if (manager === null)
+        throw new Error('no package manager this CLI knows how to drive');
+    const packages = manager === 'apt-get' ? apt : dnf;
+    await run('sudo', ['-n', manager, 'install', '-y', ...packages], { timeout: INSTALL_TIMEOUT_MS });
+}
+async function firstAvailable(commands) {
+    for (const command of commands) {
+        const there = await run('/bin/sh', ['-c', `command -v ${command}`]).then(() => true, () => false);
+        if (there)
+            return command;
+    }
+    return null;
+}
+function firstLine(message) {
+    return message.split('\n')[0] ?? 'it failed';
+}
+const INSTALL_TIMEOUT_MS = 180_000;

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@craftspace/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Sign a Mac or Linux machine into Craftspace and keep its agent setup in step.",
+  "license": "MIT",
+  "homepage": "https://craftspace.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/abuaboud/gus.git",
+    "directory": "packages/app/cli"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "craftspace": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "tsc && node --test test/*.test.mjs",
+    "prepack": "npm run build && esbuild dist/index.js --bundle --platform=node --format=esm --outfile=dist/index.js --allow-overwrite --banner:js=\"import{createRequire as __cr}from'node:module';const require=__cr(import.meta.url);\""
+  },
+  "devDependencies": {
+    "@craftspace/shared": "*",
+    "@types/node": "^22.0.0",
+    "commander": "^14.0.0",
+    "esbuild": "^0.28.0",
+    "typescript": "^5.6.0"
+  }
+}