@shardflux/cli 0.14.4 → 0.15.0

package/dist/onboarding-app/AGENTS.md

@@ -0,0 +1,19 @@
+# Daylight
+
+A small task list: `server.mjs` (a Node.js server with a JSON API) and `index.html`. No dependencies.
+
+## Run it
+
+- `npm run dev` serves it on port 3000 and restarts on save. It watches files with inotifywait from inotify-tools, a
+  system package: install it with `sudo apt-get install -y inotify-tools` if it is missing.
+- Open `http://localhost:3000` in the browser on your desktop (`DISPLAY=:1 setsid -f chromium http://localhost:3000`)
+  and use the computer tool to see and click it.
+
+## Test it
+
+Use it like a person: add a task, tick it off, and look at each view (All, Active, Completed). Leave the page open.
+
+## Report
+
+Reply with one short paragraph: what you started, what you clicked, and what works and what does not. Change code only
+if you are asked to.

package/dist/onboarding-app/CLAUDE.md

@@ -0,0 +1,19 @@
+# Daylight
+
+A small task list: `server.mjs` (a Node.js server with a JSON API) and `index.html`. No dependencies.
+
+## Run it
+
+- `npm run dev` serves it on port 3000 and restarts on save. It watches files with inotifywait from inotify-tools, a
+  system package: install it with `sudo apt-get install -y inotify-tools` if it is missing.
+- Open `http://localhost:3000` in the browser on your desktop (`DISPLAY=:1 setsid -f chromium http://localhost:3000`)
+  and use the computer tool to see and click it.
+
+## Test it
+
+Use it like a person: add a task, tick it off, and look at each view (All, Active, Completed). Leave the page open.
+
+## Report
+
+Reply with one short paragraph: what you started, what you clicked, and what works and what does not. Change code only
+if you are asked to.

package/dist/onboarding-app/README.md

@@ -0,0 +1,12 @@
+# Daylight
+
+A small full-stack task list: a Node.js server with a JSON API and one HTML page. No dependencies.
+
+```sh
+npm run dev    # serves on :3000 and reloads on save; needs inotify-tools (sudo apt-get install -y inotify-tools)
+```
+
+Open `http://localhost:3000`. Tasks live in memory while the server runs. Set `PORT` to use another port.
+
+Shardflux uses Daylight for its first-run demo, "Daylight (sample)": an agent installs what it needs, starts it and
+tests it in the browser on its own computer. `CLAUDE.md` and `AGENTS.md` tell Claude Code and Codex how.

package/dist/onboarding-app/dev.mjs

@@ -0,0 +1,18 @@
+// Dev server: runs server.mjs and restarts it when a source file is saved. Watches with inotifywait (inotify-tools).
+import { spawn, spawnSync } from 'node:child_process';
+
+if (spawnSync('inotifywait', ['--help'], { stdio: 'ignore' }).error) {
+  console.error('npm run dev watches files with inotifywait. Install it with: sudo apt-get install -y inotify-tools');
+  process.exit(1);
+}
+let server;
+const start = () => { server = spawn(process.execPath, ['server.mjs'], { stdio: 'inherit' }); };
+const restart = () => { console.log('Saved. Restarting Daylight…'); server.once('exit', start); server.kill(); };
+start();
+const watcher = spawn('inotifywait', ['-m', '-q', '-e', 'close_write,moved_to', '--format', '%f', '.'], { stdio: ['ignore', 'pipe', 'inherit'] });
+let timer;
+watcher.stdout.on('data', chunk => {
+  if (!/\.(mjs|html)\b/.test(String(chunk))) return;
+  clearTimeout(timer); timer = setTimeout(restart, 150);
+});
+for (const signal of ['SIGINT', 'SIGTERM']) process.on(signal, () => { watcher.kill(); server.kill(); process.exit(0); });

package/dist/onboarding-app/index.html

@@ -0,0 +1,25 @@
+<!doctype html>
+<html lang="en">
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Daylight · One good day</title>
+<style>
+:root{color-scheme:light;--paper:#f5f2ea;--ink:#282b27;--muted:#747970;--line:#deded3;--green:#3f614e;font-family:system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif}*{box-sizing:border-box}body{margin:0;background:var(--paper);color:var(--ink)}main{max-width:660px;margin:12vh auto;padding:24px}header{display:flex;align-items:center;justify-content:space-between}.wordmark{font-size:15px;font-weight:600;letter-spacing:-.2px}.dot{width:28px;height:28px;border:1px solid var(--green);border-radius:50%;display:inline-block;margin-right:12px;vertical-align:middle}.edition{font-size:12px;color:var(--muted)}h1{font-size:48px;line-height:1.05;font-weight:650;letter-spacing:-1.8px;margin:52px 0 14px}p{color:var(--muted);line-height:1.6}form{display:flex;gap:10px;margin:34px 0 32px}input[type=text]{flex:1;min-width:0;border:1px solid var(--line);border-radius:8px;padding:14px;background:#fffdf8;color:var(--ink);font:inherit}button{cursor:pointer;font:inherit;border:0;border-radius:7px;padding:11px 16px;background:var(--green);color:white}nav{display:flex;gap:6px;border-bottom:1px solid var(--line);padding-bottom:14px}nav button{background:transparent;color:var(--muted);font-size:13px;padding:8px 13px}nav button[aria-pressed=true]{background:#e1e7dc;color:var(--green)}ul{list-style:none;margin:0;padding:0;min-height:170px}li{display:flex;align-items:center;gap:14px;padding:21px 2px;border-bottom:1px solid var(--line)}li input{accent-color:var(--green);width:20px;height:20px;cursor:pointer}li label{flex:1}li.done label{text-decoration:line-through;color:var(--muted)}footer{display:flex;justify-content:space-between;font-size:12px;color:var(--muted);margin-top:24px}.empty{padding:35px 0;color:var(--muted)}#error{color:#a13b32;min-height:18px;font-size:13px}button:focus-visible,input:focus-visible{outline:2px solid var(--green);outline-offset:3px}@media(max-width:600px){main{margin:5vh auto}h1{font-size:44px}.edition{display:none}}
+</style>
+<main>
+<header><span class="wordmark"><span class="dot"></span>Daylight</span><span class="edition">A little room to get things done.</span></header>
+<h1>One thing at a time.</h1>
+<p>A short list. A clear head. Make room for a good day.</p>
+<form id="add"><input type="text" id="title" aria-label="New task" placeholder="What would you like to do?" maxlength="100" required><button>Add task</button></form>
+<nav aria-label="Task filters"><button type="button" data-view="all" aria-pressed="true">All</button><button type="button" data-view="active" aria-pressed="false">Active</button><button type="button" data-view="done" aria-pressed="false">Completed</button></nav>
+<ul id="tasks" aria-live="polite"></ul><div id="error" role="alert"></div>
+<footer><span id="remaining"></span><span>Small steps count.</span></footer>
+</main>
+<script type="module">
+let view='all';const list=document.querySelector('#tasks'),error=document.querySelector('#error');
+async function api(path,options){const response=await fetch(path,options);if(!response.ok)throw Error(await response.text());return response.json()}
+async function render(){try{const data=await api('/api/tasks?view='+view);list.replaceChildren();for(const task of data.tasks){const row=document.createElement('li');row.classList.toggle('done',task.done);const check=document.createElement('input');check.type='checkbox';check.checked=task.done;check.id='task-'+task.id;check.addEventListener('change',async()=>{try{await api('/api/tasks/'+task.id,{method:'PATCH'});await render()}catch(e){error.textContent=e.message}});const label=document.createElement('label');label.htmlFor=check.id;label.textContent=task.title;row.append(check,label);list.append(row)}if(!data.tasks.length){const empty=document.createElement('li');empty.className='empty';empty.textContent='Nothing here. Enjoy the space.';list.append(empty)}document.querySelector('#remaining').textContent=data.remaining+' left to do';error.textContent=''}catch(e){error.textContent=e.message}}
+document.querySelector('#add').addEventListener('submit',async e=>{e.preventDefault();try{await api('/api/tasks',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({title:document.querySelector('#title').value})});document.querySelector('#title').value='';await render()}catch(e){error.textContent=e.message}});
+for(const button of document.querySelectorAll('[data-view]'))button.addEventListener('click',()=>{view=button.dataset.view;for(const other of document.querySelectorAll('[data-view]'))other.setAttribute('aria-pressed',String(other===button));document.title=view==='all'?'Daylight · One good day':'Daylight · '+button.textContent;render()});render();
+</script>
+</html>

package/dist/onboarding-app/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "daylight",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "node dev.mjs"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

package/dist/onboarding-app/server.mjs

@@ -0,0 +1,41 @@
+import { createServer } from 'node:http';
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+
+const tasks = [
+  { id: 1, title: 'Sketch the idea', done: true },
+  { id: 2, title: 'Build something useful', done: false },
+  { id: 3, title: 'Take a walk', done: false },
+];
+let nextID = 4;
+const server = createServer(async (req, res) => {
+  try {
+    const url = new URL(req.url, 'http://localhost');
+    if (url.pathname === '/api/tasks' && req.method === 'GET') {
+      const view = url.searchParams.get('view') || 'all';
+      const visible = view === 'active' ? tasks.filter(t => !t.done) : view === 'done' ? tasks.filter(t => !t.done) : tasks;
+      res.setHeader('Content-Type', 'application/json');
+      return res.end(JSON.stringify({ tasks: visible, remaining: tasks.filter(t => !t.done).length }));
+    }
+    if (url.pathname === '/api/tasks' && req.method === 'POST') {
+      let body = ''; for await (const part of req) { body += part; if (body.length > 4096) throw Error('Too much text'); }
+      const title = String(JSON.parse(body).title || '').trim();
+      if (!title || title.length > 100) { res.writeHead(400); return res.end('Use 1–100 characters.'); }
+      tasks.push({ id: nextID++, title, done: false }); res.writeHead(201); return res.end('{}');
+    }
+    const match = url.pathname.match(/^\/api\/tasks\/(\d+)$/);
+    if (match && req.method === 'PATCH') {
+      const task = tasks.find(t => t.id === Number(match[1]));
+      if (!task) { res.writeHead(404); return res.end('Task not found'); }
+      task.done = !task.done; return res.end('{}');
+    }
+    if (url.pathname === '/' && req.method === 'GET') {
+      res.setHeader('Content-Type', 'text/html; charset=utf-8');
+      return res.end(await readFile(new URL('./index.html', import.meta.url)));
+    }
+    res.writeHead(404); res.end('Not found');
+  } catch { res.writeHead(400); res.end('Could not read that request.'); }
+});
+const port = Number(process.env.PORT || 3000);
+if (process.argv[1] === fileURLToPath(import.meta.url)) server.listen(port, '0.0.0.0', () => console.log(`Daylight is running on http://0.0.0.0:${port}`));
+export { server };

package/dist/onboarding-sample.d.ts

@@ -0,0 +1,3 @@
+export declare function sampleSource(): Promise<string>;
+/** A private, fresh real Git project; never writes into the user's selected repository. */
+export declare function prepareOnboardingSample(directory: string): Promise<string>;

package/dist/onboarding-sample.js

@@ -0,0 +1,29 @@
+import { access, cp, mkdir, mkdtemp } from 'node:fs/promises';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const execute = promisify(execFile);
+export async function sampleSource() {
+    for (const url of [new URL('./onboarding-app/', import.meta.url), new URL('../../../examples/onboarding-app/', import.meta.url)]) {
+        try {
+            await access(new URL('server.mjs', url));
+            return fileURLToPath(url);
+        }
+        catch { /* source tree or published bundle */ }
+    }
+    throw new Error('The onboarding app is missing. Reinstall the Shardflux CLI.');
+}
+/** A private, fresh real Git project; never writes into the user's selected repository. */
+export async function prepareOnboardingSample(directory) {
+    const root = join(directory, 'onboarding-projects');
+    await mkdir(root, { recursive: true, mode: 0o700 });
+    // The folder's own name is what the launcher lists: "Daylight (sample)".
+    const path = join(await mkdtemp(join(root, 'sample-')), 'Daylight (sample)');
+    await cp(await sampleSource(), path, { recursive: true });
+    const git = (args) => execute('git', args, { cwd: path, timeout: 10000, env: { ...process.env, GIT_CONFIG_GLOBAL: '/dev/null', GIT_CONFIG_NOSYSTEM: '1' } });
+    await git(['init', '-q', '-b', 'main']);
+    await git(['add', '.']);
+    await git(['-c', 'user.name=Shardflux', '-c', 'user.email=first-run@shardflux.dev', '-c', 'commit.gpgsign=false', 'commit', '-qm', 'Start Daylight onboarding app']);
+    return path;
+}

package/dist/onboarding.d.ts

@@ -0,0 +1,258 @@
+import type { Ctx } from './commands.js';
+import type { Values } from './args.js';
+import type { CodexConnectorView, CodexHealth } from './codex-cloud.js';
+/**
+ * The first-run demo's task: it shows the agent's own computer at work. The user copies it and pastes it into the
+ * launcher themselves; Daylight's own CLAUDE.md and AGENTS.md say how to run it and test it in the desktop browser.
+ */
+export declare const DEMO_PROMPT = "Start Daylight and test it in the browser, then tell me what works.";
+export type AgentApp = 'claude' | 'codex';
+/**
+ * Where Claude Code and Codex install their commands in a home folder. Apps opened from the Finder (the menu bar app,
+ * and this CLI run by it) get a minimal PATH; the menu bar app adds Homebrew's and /usr/local/bin, and these cover the
+ * rest (Claude Code's installer uses ~/.local/bin).
+ */
+export declare function installDirs(home: string): string[];
+/** Claude Code or Codex is on this Mac: its home folder (~/.claude, ~/.codex) or its command on PATH or in an install folder. */
+export declare function foundApps(env: NodeJS.ProcessEnv): Promise<AgentApp[]>;
+/** --apps claude,codex (repeatable or comma separated); unknown names are refused. */
+export declare function parseApps(value: unknown): AgentApp[] | undefined;
+type CredentialRow = {
+    app: string;
+    status?: string;
+    scope?: string;
+    access?: {
+        verdict: 'usable' | 'refused' | 'unknown';
+        checked_at: string;
+    };
+};
+type Action = {
+    title: string;
+    command?: string[];
+    retry?: boolean;
+};
+export interface Connection {
+    id: 'account' | AgentApp | 't3';
+    /**
+     * verified: checked live just now. action: the person does `action`. pending: it is getting there on its own.
+     * unknown: ask again. info: nothing to do here yet (T3 Code: after a project is picked, or its provider's own Sign in).
+     */
+    state: 'verified' | 'action' | 'pending' | 'unknown' | 'info';
+    /** For scripts: the command that connects it later (T3 Code over SSH, once there is a project). */
+    next?: string[];
+    fact: string;
+    action?: Action;
+    picked?: boolean;
+    found?: boolean;
+    /** T3 Code only: optional (never needed to continue), its app (for the icon) and how it connects. */
+    optional?: boolean;
+    app_path?: string;
+    mode?: 'provider' | 'ssh';
+}
+/**
+ * T3 Code, when it is installed: an ACP-capable build (0.0.46+, nightly) has Shardflux as a provider, which every
+ * `shard` run writes into T3's settings, so it is connected with nothing to sign in; stable 0.0.45 connects a project
+ * over SSH (`shard agents new --in t3`), and says which environment to add. Null when T3 Code is not installed.
+ */
+export declare function t3Connection(ctx: Ctx, signedIn: boolean, appDirs?: string[], platform?: NodeJS.Platform): Promise<Connection | null>;
+/** Claude: the account login is ready and Claude itself accepts it right now. */
+export declare function claudeConnection(row: CredentialRow | undefined): Omit<Connection, 'id' | 'picked' | 'found'>;
+/** Codex: this Mac's Codex login is copied and the account's Codex remote device (one executor) is connected. */
+export declare function codexConnection(local: boolean, synced: boolean, connector: CodexConnectorView | null, health: CodexHealth): Omit<Connection, 'id' | 'picked' | 'found'>;
+/**
+ * The onboarding report, for an agent setting itself up from chat and for the menu bar app. It verifies every
+ * connection live: the Shardflux account, Claude (Claude itself accepts the login) and Codex (the login is copied and
+ * the account's Codex remote device is connected), for the apps picked (--apps, else saved, else found on this Mac).
+ * With --connect it also does what needs no sign-in: copies the Codex login and enables the Codex remote device.
+ */
+export declare function onboardingReport(ctx: Ctx, values: Values): Promise<{
+    version: number;
+    api_url: string;
+    apps: AgentApp[];
+    found_apps: AgentApp[];
+    connections: Connection[];
+    ready: boolean;
+    account_error: string | null;
+    demo: {
+        prompt: string;
+        project: string;
+        prepare: string[];
+    };
+    activity: {
+        state: "running" | "failed" | "suspended" | "deleted" | "creating" | "starting" | "suspending" | "resuming" | "forking" | "stopping" | "deleting";
+        workspace: {
+            id: string;
+            key: string;
+        };
+        conversation: {
+            id: string;
+            state: "archived" | "working" | "needs_you" | "unresolved" | "done";
+            summary: string;
+        } | null;
+        commands: never[];
+        processes: never[];
+        ports: never[];
+        installs: never[];
+        screen: null;
+        browser: null;
+        changes: {
+            files: number;
+            commits: number;
+        };
+    } | {
+        changes: {
+            files: number;
+            commits: number;
+        };
+        observed_at: string;
+        screen: {
+            width: number;
+            height: number;
+        } | null;
+        browser: BrowserWindow | null;
+        state: string;
+        workspace: {
+            id: string;
+            key: string;
+        };
+        conversation: {
+            id: string;
+            state: "archived" | "working" | "needs_you" | "unresolved" | "done";
+            summary: string;
+        } | null;
+        commands: string[];
+        processes: {
+            command: string;
+            started_at: string | null;
+        }[];
+        ports: number[];
+        installs: {
+            packages: string[];
+            sudo: boolean;
+        }[];
+    } | null;
+    steps: ({
+        id: string;
+        title: string;
+        status: string;
+        command: string[];
+        action?: undefined;
+    } | {
+        id: string;
+        title: string;
+        status: string;
+        command?: undefined;
+        action?: undefined;
+    } | {
+        id: string;
+        title: string;
+        status: string;
+        action: string;
+        command?: undefined;
+    })[];
+}>;
+/** The report as text: one line per connection, then what to do next. */
+export declare function onboardingText(report: Awaited<ReturnType<typeof onboardingReport>>): string;
+interface ProcessRow {
+    pid: number;
+    comm: string;
+    cmdline?: string[];
+    started_at?: string | null;
+}
+/** Node names its main thread "MainThread" and npm retitles itself "npm run dev": the program is the first argument. */
+export declare function activeCommands(processes: ProcessRow[]): string[];
+/** Commands and listening ports of a running VM. Never wakes a parked computer. */
+export declare function liveActivity(ctx: Ctx, ref: string): Promise<{
+    state: "running" | "failed" | "suspended" | "deleted" | "creating" | "starting" | "suspending" | "resuming" | "forking" | "stopping" | "deleting";
+    workspace: {
+        id: string;
+        key: string;
+    };
+    conversation: {
+        id: string;
+        state: "archived" | "working" | "needs_you" | "unresolved" | "done";
+        summary: string;
+    } | null;
+    commands: never[];
+    processes: never[];
+    ports: never[];
+    installs: never[];
+    screen: null;
+    browser: null;
+    changes: {
+        files: number;
+        commits: number;
+    };
+} | {
+    changes: {
+        files: number;
+        commits: number;
+    };
+    observed_at: string;
+    screen: {
+        width: number;
+        height: number;
+    } | null;
+    browser: BrowserWindow | null;
+    state: string;
+    workspace: {
+        id: string;
+        key: string;
+    };
+    conversation: {
+        id: string;
+        state: "archived" | "working" | "needs_you" | "unresolved" | "done";
+        summary: string;
+    } | null;
+    commands: string[];
+    processes: {
+        command: string;
+        started_at: string | null;
+    }[];
+    ports: number[];
+    installs: {
+        packages: string[];
+        sudo: boolean;
+    }[];
+}>;
+/** The ranked commands with when each started: a dev server that restarts after a save starts again. */
+export declare function activeProcesses(processes: ProcessRow[]): Array<{
+    command: string;
+    started_at: string | null;
+}>;
+/**
+ * What was installed with sudo since the workspace was created, from apt's own history: the packages each
+ * `apt-get install` asked for (not their automatic dependencies). Short installs finish between two process samples;
+ * the history keeps them. Entries without Requested-By ran as root, like the image build.
+ */
+export declare function aptInstalls(history: string, since?: string): Array<{
+    packages: string[];
+    sudo: boolean;
+}>;
+export declare function gitChanges(output: string): {
+    files: number;
+    commits: number;
+};
+/**
+ * The desktop's size and its largest visible browser window, so a live view can show the page the agent is testing
+ * rather than the whole screen with its panel and clock. Null fields when the desktop or the browser is not open.
+ */
+type BrowserWindow = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    title: string;
+};
+export declare function desktopWindows(output: string): {
+    screen: {
+        width: number;
+        height: number;
+    } | null;
+    browser: BrowserWindow | null;
+};
+/** "/usr/local/bin/node server.mjs" reads as "node server.mjs"; long arguments are cut. */
+export declare function commandLine(argv: string[]): string;
+/** Listening TCP ports from `ss -ltnp` or /proc/net/tcp{,6}, without the harness's or the desktop viewer's own ports. */
+export declare function listeningPorts(output: string): number[];
+export {};