@data-fair/lib-dev 0.0.0-stage → 0.1.1

package/status.js

@@ -0,0 +1,147 @@
+import { readlinkSync } from 'node:fs';
+import path from 'node:path';
+import { realExec, jsonLines } from './exec.js';
+import { sessionName, sessionState, listPanes } from './zellij.js';
+import { readDevConfig, readEnvFile, interpolate } from './config.js';
+import { checkReady } from './panes.js';
+const COLORS = { green: '32', yellow: '33', red: '31', dim: '2' };
+export const containerMark = (c, stackRunning = true) => {
+    if (c.state === 'not started')
+        return { mark: '·', color: 'dim', text: 'not started' };
+    if (c.state === 'exited' && c.exitCode === 0) {
+        // a one-shot init container (s3-init) that completed, unless the whole stack is down: a stopped mongo exits with 0 too
+        return stackRunning ? { mark: '✔', color: 'green', text: 'done' } : { mark: '·', color: 'dim', text: 'stopped' };
+    }
+    const text = c.health || c.state;
+    if (text === 'healthy' || (c.state === 'running' && !c.health))
+        return { mark: '✔', color: 'green', text };
+    if (text === 'starting' || c.state === 'restarting' || c.state === 'created')
+        return { mark: '⠿', color: 'yellow', text };
+    return { mark: '✘', color: 'red', text };
+};
+const human = (kb) => kb >= 1048576 ? `${(kb / 1048576).toFixed(1)}G` : `${Math.round(kb / 1024)}M`;
+export const renderStatus = (data, color) => {
+    const paint = (c, s) => color ? `\x1b[${COLORS[c]}m${s}\x1b[0m` : s;
+    const lines = data.url ? [data.url, ''] : [];
+    const stackRunning = data.containers.some(c => c.state === 'running');
+    lines.push(...data.containersError
+        ? [paint('red', `containers unavailable: ${data.containersError}`)]
+        : data.containers.map(c => {
+            const m = containerMark(c, stackRunning);
+            return `${paint(m.color, m.mark)} ${c.service.padEnd(18)} ${paint(m.color, m.text.padEnd(11))} ${c.memory ?? ''}`.trimEnd();
+        }));
+    lines.push('');
+    if (data.panesError)
+        lines.push(paint('red', data.panesError));
+    for (const p of data.panes) {
+        if (p.exited)
+            lines.push(`${paint('red', '✘')} ${p.title.padEnd(18)} ${paint('red', `exited (${p.exit_status ?? '?'})`)}`);
+        else if (p.ready === false)
+            lines.push(`${paint('yellow', '⠿')} ${p.title.padEnd(18)} ${paint('yellow', `running, not ready (${p.readyUrl})`)}`);
+        else
+            lines.push(`${paint('green', '✔')} ${p.title.padEnd(18)} ${paint('green', 'running')}`);
+    }
+    lines.push('');
+    for (const p of data.procs)
+        lines.push(`${p.label.slice(0, 40).padEnd(40)} ${human(p.rssKb)}`);
+    lines.push(`${'processes total'.padEnd(40)} ${human(data.procs.reduce((sum, p) => sum + p.rssKb, 0))}`);
+    return lines.join('\n');
+};
+const SHELLS = ['bash', 'sh', 'zsh'];
+/** Processes started by the panes of a zellij session: descendants of its server, shells excluded. */
+export const sessionProcesses = (psOut, session, cwdOf, root, selfPid) => {
+    const rows = psOut.split('\n').map(line => line.trim().match(/^(\d+)\s+(\d+)\s+(\d+)\s+(.*)$/)).filter(m => !!m)
+        .map(m => ({ pid: Number(m[1]), ppid: Number(m[2]), rssKb: Number(m[3]), args: m[4] }));
+    const server = rows.find(r => / --server \S*\/zellij\/\S+\//.test(r.args) && r.args.endsWith('/' + session));
+    if (!server)
+        return [];
+    const inSession = new Set([server.pid]);
+    // the status commands (this one, the df-status pane) and their children (ps, sleep, docker) are tooling, not dev processes
+    const self = new Set([...(selfPid ? [selfPid] : []), ...rows.filter(r => / df-dev status\b|df-status\b/.test(' ' + r.args.replace(/^\S*node\s+\S*\//, ' '))).map(r => r.pid)]);
+    let grew = true;
+    while (grew) { // ps order is not parents-first when pids wrap around
+        grew = false;
+        for (const r of rows) {
+            if (!inSession.has(r.pid) && inSession.has(r.ppid)) {
+                inSession.add(r.pid);
+                grew = true;
+            }
+            if (!self.has(r.pid) && self.has(r.ppid)) {
+                self.add(r.pid);
+                grew = true;
+            }
+        }
+    }
+    const procs = [];
+    for (const r of rows) {
+        if (r.pid === server.pid || !inSession.has(r.pid) || self.has(r.pid) || SHELLS.includes(path.basename(r.args.split(' ')[0])))
+            continue;
+        const cwd = cwdOf(r.pid);
+        const dir = cwd && (cwd === root || cwd.startsWith(root + path.sep)) ? (path.relative(root, cwd) || '.') : '?';
+        procs.push({ label: `${dir}: ${r.args.replace(/^(\S*\/)?node\s+(?=\S*node_modules\/\.bin\/)/, '').replace(/^\S*node_modules\/\.bin\//, '').replace(/^\S*\//, '')}`, rssKb: r.rssKb });
+    }
+    return procs;
+};
+const collectContainers = (root, exec) => {
+    const ps = jsonLines(exec('docker', ['compose', '--project-directory', root, 'ps', '-a', '--format', 'json']));
+    const all = exec('docker', ['compose', '--project-directory', root, '--profile', '*', 'config', '--services']).split('\n').filter(Boolean);
+    const memory = {};
+    if (ps.length) {
+        for (const s of jsonLines(exec('docker', ['stats', '--no-stream', '--format', '{{json .}}', ...ps.map((c) => c.Name)]))) {
+            memory[s.Name] = String(s.MemUsage).split(' / ')[0];
+        }
+    }
+    return all.sort().map(service => {
+        const c = ps.find((p) => p.Service === service);
+        return c ? { service, state: c.State, health: c.Health ?? '', memory: memory[c.Name], exitCode: c.ExitCode } : { service, state: 'not started', health: '' };
+    });
+};
+// each part fails on its own: a docker error must not hide the panes, and the reverse
+export const collectStatus = (root, exec = realExec) => {
+    const data = { containers: [], panes: [], procs: [] };
+    try {
+        const env = readEnvFile(root);
+        const url = readDevConfig(root).url;
+        if (url)
+            data.url = interpolate(url, env);
+    }
+    catch { } // the URL is a convenience, the rest of the status must still show
+    try {
+        data.containers = collectContainers(root, exec);
+    }
+    catch (err) {
+        data.containersError = err.message.split('\n')[0];
+    }
+    const session = sessionName(root);
+    try {
+        const state = sessionState(exec, session);
+        if (state === 'running')
+            data.panes = listPanes(exec, session).map(p => ({ title: p.title, exited: p.exited, exit_status: p.exit_status }));
+        else
+            data.panesError = `zellij session "${session}" is not running (${state}): ask the user to start it with "npm run dev-zellij"`;
+    }
+    catch (err) {
+        data.panesError = `panes unavailable: ${err.message.split('\n')[0]}`;
+    }
+    const cwdOf = (pid) => { try {
+        return readlinkSync(`/proc/${pid}/cwd`);
+    }
+    catch {
+        return undefined;
+    } };
+    try {
+        const user = process.getuid ? ['-u', String(process.getuid())] : ['-e'];
+        data.procs = sessionProcesses(exec('ps', [...user, '-o', 'pid=,ppid=,rss=,args=']), session, cwdOf, root, process.pid);
+    }
+    catch { } // the process list is the least important part
+    return data;
+};
+/** A running pane can be broken: nodemon (or node --watch) stays alive "waiting for file changes" after a crash. */
+export const checkReadiness = async (panes, config, env, ready = checkReady) => Promise.all(panes.map(async (p) => {
+    const template = config.panes[p.title]?.ready;
+    if (p.exited || !template)
+        return p;
+    const readyUrl = interpolate(template, env);
+    return { ...p, ready: await ready(readyUrl), readyUrl };
+}));
+//# sourceMappingURL=status.js.map

package/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["status.ts"],"names":[],"mappings":"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","sourcesContent":["import { readlinkSync } from 'node:fs'\nimport path from 'node:path'\nimport { realExec, jsonLines, type Exec } from './exec.js'\nimport { sessionName, sessionState, listPanes } from './zellij.js'\nimport { readDevConfig, readEnvFile, interpolate, type DevConfig } from './config.js'\nimport { checkReady } from './panes.js'\n\nexport type Container = { service: string, state: string, health: string, memory?: string, exitCode?: number }\nexport type Proc = { label: string, rssKb: number }\nexport type PaneState = { title: string, exited: boolean, exit_status: number | null, ready?: boolean, readyUrl?: string }\nexport type StatusData = { url?: string, containers: Container[], containersError?: string, panes: PaneState[], panesError?: string, procs: Proc[] }\n\nconst COLORS = { green: '32', yellow: '33', red: '31', dim: '2' } as const\n\nexport const containerMark = (c: Container, stackRunning = true) => {\n  if (c.state === 'not started') return { mark: '·', color: 'dim' as const, text: 'not started' }\n  if (c.state === 'exited' && c.exitCode === 0) {\n    // a one-shot init container (s3-init) that completed, unless the whole stack is down: a stopped mongo exits with 0 too\n    return stackRunning ? { mark: '✔', color: 'green' as const, text: 'done' } : { mark: '·', color: 'dim' as const, text: 'stopped' }\n  }\n  const text = c.health || c.state\n  if (text === 'healthy' || (c.state === 'running' && !c.health)) return { mark: '✔', color: 'green' as const, text }\n  if (text === 'starting' || c.state === 'restarting' || c.state === 'created') return { mark: '⠿', color: 'yellow' as const, text }\n  return { mark: '✘', color: 'red' as const, text }\n}\n\nconst human = (kb: number) => kb >= 1048576 ? `${(kb / 1048576).toFixed(1)}G` : `${Math.round(kb / 1024)}M`\n\nexport const renderStatus = (data: StatusData, color: boolean) => {\n  const paint = (c: keyof typeof COLORS, s: string) => color ? `\\x1b[${COLORS[c]}m${s}\\x1b[0m` : s\n  const lines = data.url ? [data.url, ''] : []\n  const stackRunning = data.containers.some(c => c.state === 'running')\n  lines.push(...data.containersError\n    ? [paint('red', `containers unavailable: ${data.containersError}`)]\n    : data.containers.map(c => {\n        const m = containerMark(c, stackRunning)\n        return `${paint(m.color, m.mark)} ${c.service.padEnd(18)} ${paint(m.color, m.text.padEnd(11))} ${c.memory ?? ''}`.trimEnd()\n      }))\n  lines.push('')\n  if (data.panesError) lines.push(paint('red', data.panesError))\n  for (const p of data.panes) {\n    if (p.exited) lines.push(`${paint('red', '✘')} ${p.title.padEnd(18)} ${paint('red', `exited (${p.exit_status ?? '?'})`)}`)\n    else if (p.ready === false) lines.push(`${paint('yellow', '⠿')} ${p.title.padEnd(18)} ${paint('yellow', `running, not ready (${p.readyUrl})`)}`)\n    else lines.push(`${paint('green', '✔')} ${p.title.padEnd(18)} ${paint('green', 'running')}`)\n  }\n  lines.push('')\n  for (const p of data.procs) lines.push(`${p.label.slice(0, 40).padEnd(40)} ${human(p.rssKb)}`)\n  lines.push(`${'processes total'.padEnd(40)} ${human(data.procs.reduce((sum, p) => sum + p.rssKb, 0))}`)\n  return lines.join('\\n')\n}\n\nconst SHELLS = ['bash', 'sh', 'zsh']\n\n/** Processes started by the panes of a zellij session: descendants of its server, shells excluded. */\nexport const sessionProcesses = (psOut: string, session: string, cwdOf: (pid: number) => string | undefined, root: string, selfPid?: number): Proc[] => {\n  const rows = psOut.split('\\n').map(line => line.trim().match(/^(\\d+)\\s+(\\d+)\\s+(\\d+)\\s+(.*)$/)).filter(m => !!m)\n    .map(m => ({ pid: Number(m[1]), ppid: Number(m[2]), rssKb: Number(m[3]), args: m[4] }))\n  const server = rows.find(r => / --server \\S*\\/zellij\\/\\S+\\//.test(r.args) && r.args.endsWith('/' + session))\n  if (!server) return []\n  const inSession = new Set([server.pid])\n  // the status commands (this one, the df-status pane) and their children (ps, sleep, docker) are tooling, not dev processes\n  const self = new Set([...(selfPid ? [selfPid] : []), ...rows.filter(r => / df-dev status\\b|df-status\\b/.test(' ' + r.args.replace(/^\\S*node\\s+\\S*\\//, ' '))).map(r => r.pid)])\n  let grew = true\n  while (grew) { // ps order is not parents-first when pids wrap around\n    grew = false\n    for (const r of rows) {\n      if (!inSession.has(r.pid) && inSession.has(r.ppid)) { inSession.add(r.pid); grew = true }\n      if (!self.has(r.pid) && self.has(r.ppid)) { self.add(r.pid); grew = true }\n    }\n  }\n  const procs: Proc[] = []\n  for (const r of rows) {\n    if (r.pid === server.pid || !inSession.has(r.pid) || self.has(r.pid) || SHELLS.includes(path.basename(r.args.split(' ')[0]))) continue\n    const cwd = cwdOf(r.pid)\n    const dir = cwd && (cwd === root || cwd.startsWith(root + path.sep)) ? (path.relative(root, cwd) || '.') : '?'\n    procs.push({ label: `${dir}: ${r.args.replace(/^(\\S*\\/)?node\\s+(?=\\S*node_modules\\/\\.bin\\/)/, '').replace(/^\\S*node_modules\\/\\.bin\\//, '').replace(/^\\S*\\//, '')}`, rssKb: r.rssKb })\n  }\n  return procs\n}\n\nconst collectContainers = (root: string, exec: Exec): Container[] => {\n  const ps = jsonLines(exec('docker', ['compose', '--project-directory', root, 'ps', '-a', '--format', 'json']))\n  const all = exec('docker', ['compose', '--project-directory', root, '--profile', '*', 'config', '--services']).split('\\n').filter(Boolean)\n  const memory: Record<string, string> = {}\n  if (ps.length) {\n    for (const s of jsonLines(exec('docker', ['stats', '--no-stream', '--format', '{{json .}}', ...ps.map((c: any) => c.Name)]))) {\n      memory[s.Name] = String(s.MemUsage).split(' / ')[0]\n    }\n  }\n  return all.sort().map(service => {\n    const c = ps.find((p: any) => p.Service === service)\n    return c ? { service, state: c.State, health: c.Health ?? '', memory: memory[c.Name], exitCode: c.ExitCode } : { service, state: 'not started', health: '' }\n  })\n}\n\n// each part fails on its own: a docker error must not hide the panes, and the reverse\nexport const collectStatus = (root: string, exec: Exec = realExec): StatusData => {\n  const data: StatusData = { containers: [], panes: [], procs: [] }\n  try {\n    const env = readEnvFile(root)\n    const url = readDevConfig(root).url\n    if (url) data.url = interpolate(url, env)\n  } catch {} // the URL is a convenience, the rest of the status must still show\n  try {\n    data.containers = collectContainers(root, exec)\n  } catch (err: any) {\n    data.containersError = err.message.split('\\n')[0]\n  }\n  const session = sessionName(root)\n  try {\n    const state = sessionState(exec, session)\n    if (state === 'running') data.panes = listPanes(exec, session).map(p => ({ title: p.title, exited: p.exited, exit_status: p.exit_status }))\n    else data.panesError = `zellij session \"${session}\" is not running (${state}): ask the user to start it with \"npm run dev-zellij\"`\n  } catch (err: any) {\n    data.panesError = `panes unavailable: ${err.message.split('\\n')[0]}`\n  }\n  const cwdOf = (pid: number) => { try { return readlinkSync(`/proc/${pid}/cwd`) } catch { return undefined } }\n  try {\n    const user = process.getuid ? ['-u', String(process.getuid())] : ['-e']\n    data.procs = sessionProcesses(exec('ps', [...user, '-o', 'pid=,ppid=,rss=,args=']), session, cwdOf, root, process.pid)\n  } catch {} // the process list is the least important part\n  return data\n}\n\n/** A running pane can be broken: nodemon (or node --watch) stays alive \"waiting for file changes\" after a crash. */\nexport const checkReadiness = async (panes: PaneState[], config: DevConfig, env: Record<string, string>, ready = checkReady): Promise<PaneState[]> =>\n  Promise.all(panes.map(async p => {\n    const template = config.panes[p.title]?.ready\n    if (p.exited || !template) return p\n    const readyUrl = interpolate(template, env)\n    return { ...p, ready: await ready(readyUrl), readyUrl }\n  }))\n"]}

package/status.test.d.ts

@@ -0,0 +1 @@
+export {};

package/status.test.js

@@ -0,0 +1,123 @@
+/* eslint-disable no-template-curly-in-string -- ${VAR} placeholders are the dev/dev.json syntax */
+import { describe, it } from 'node:test';
+import { strict as assert } from 'assert';
+import { containerMark, renderStatus, sessionProcesses, collectStatus, checkReadiness } from './status.js';
+describe('status', () => {
+    it('marks containers like docker compose up --wait', () => {
+        assert.equal(containerMark({ service: 'mongo', state: 'running', health: 'healthy' }).mark, '✔');
+        assert.equal(containerMark({ service: 'sd', state: 'running', health: '' }).mark, '✔');
+        assert.equal(containerMark({ service: 'es', state: 'running', health: 'starting' }).mark, '⠿');
+        assert.equal(containerMark({ service: 'df', state: 'exited', health: '' }).color, 'red');
+        assert.equal(containerMark({ service: 'agents', state: 'not started', health: '' }).color, 'dim');
+        assert.deepEqual(containerMark({ service: 's3-init', state: 'exited', health: '', exitCode: 0 }), { mark: '✔', color: 'green', text: 'done' });
+    });
+    it('shows a stack stopped with exit code 0 as stopped, not done', () => {
+        const out = renderStatus({
+            containers: [{ service: 'mongo', state: 'exited', health: '', exitCode: 0 }, { service: 'nginx', state: 'exited', health: '', exitCode: 0 }],
+            panes: [],
+            procs: []
+        }, false);
+        assert.match(out, /· mongo\s+stopped/);
+        assert.match(out, /· nginx\s+stopped/);
+        assert.ok(!out.includes('done'));
+    });
+    it('renders containers, processes and the total in plain text', () => {
+        const out = renderStatus({
+            containers: [{ service: 'mongo', state: 'running', health: 'healthy', memory: '115MiB' }],
+            panes: [],
+            procs: [{ label: 'api: node --watch index.ts', rssKb: 245760 }]
+        }, false);
+        assert.match(out, /✔ mongo\s+healthy\s+115MiB/);
+        assert.match(out, /api: node --watch index.ts\s+240M/);
+        assert.match(out, /processes total\s+240M/);
+        assert.ok(!out.includes('\x1b['));
+    });
+    it('counts only the processes of the zellij session, with their full command line', () => {
+        const ps = [
+            '  100     1 20000 /usr/bin/zellij --server /run/user/1000/zellij/0.45.1/portals_feat-x',
+            '  101   100  3000 /bin/bash -c npx --no df-dev wait-deps && node --watch index.ts',
+            '  102   101 245760 node --watch index.ts',
+            '  103   100  3000 bash -c vite',
+            '  104   103 1048576 /home/u/.nvm/versions/node/v24.21.0/bin/node /x/portals_feat-x/node_modules/.bin/vite --port 21001',
+            '  200     1 470000 claude',
+            '  201   200 120000 npm exec chrome-devtools-mcp',
+            '  300     1 20000 /usr/bin/zellij --server /run/user/1000/zellij/0.45.1/portals'
+        ].join('\n');
+        const cwds = { 102: '/x/portals_feat-x/api', 104: '/x/portals_feat-x/ui' };
+        const procs = sessionProcesses(ps, 'portals_feat-x', pid => cwds[pid], '/x/portals_feat-x');
+        assert.deepEqual(procs, [
+            { label: 'api: node --watch index.ts', rssKb: 245760 },
+            { label: 'ui: vite --port 21001', rssKb: 1048576 }
+        ]);
+    });
+    it('finds children listed before their parent (pid wrap-around)', () => {
+        const ps = [
+            '   50   900 245760 node --watch index.ts',
+            '  100     1 20000 /usr/bin/zellij --server /run/user/1000/zellij/0.45.1/portals',
+            '  900   100  3000 bash -c node --watch index.ts'
+        ].join('\n');
+        assert.deepEqual(sessionProcesses(ps, 'portals', () => '/x/portals/api', '/x/portals').map(p => p.rssKb), [245760]);
+    });
+    it('shows exited panes with their exit code', () => {
+        const out = renderStatus({
+            containers: [],
+            panes: [{ title: 'api', exited: true, exit_status: 1 }, { title: 'ui', exited: false, exit_status: null }],
+            procs: []
+        }, false);
+        assert.match(out, /✘ api\s+exited \(1\)/);
+        assert.match(out, /✔ ui\s+running/);
+    });
+    it('still shows panes and processes when docker or ps fails, and says when the session is not running', () => {
+        const exec = (cmd, args) => {
+            if (cmd === 'docker')
+                throw new Error('Cannot connect to the Docker daemon');
+            if (args[0] === 'list-sessions')
+                throw new Error('No active zellij sessions found.');
+            if (cmd === 'ps')
+                throw new Error('ps: command not found');
+            throw new Error('unexpected ' + cmd + ' ' + args.join(' '));
+        };
+        const data = collectStatus('/x/portals', exec);
+        assert.deepEqual(data.procs, []);
+        assert.match(data.containersError ?? '', /Docker daemon/);
+        assert.match(data.panesError ?? '', /npm run dev-zellij/);
+        const out = renderStatus(data, false);
+        assert.match(out, /containers unavailable: .*Docker daemon/);
+        assert.match(out, /npm run dev-zellij/);
+    });
+    it('leaves out the status process itself and shortens executable paths', () => {
+        const ps = [
+            '  100     1 20000 /usr/bin/zellij --server /run/user/1000/zellij/0.45.1/portals',
+            '  110   100 50000 node ./node_modules/.bin/df-dev status --watch',
+            '  111   110  5000 ps -u 1000 -o pid=,ppid=,rss=,args=',
+            '  120   100 90000 /home/u/.nvm/versions/node/v24.21.0/bin/node --watch index.ts'
+        ].join('\n');
+        const procs = sessionProcesses(ps, 'portals', () => '/x/portals/api', '/x/portals', 110);
+        assert.deepEqual(procs.map(p => p.label), ['api: node --watch index.ts']);
+    });
+    it('shows the dev URL first, in full so the terminal can open them', () => {
+        const out = renderStatus({ url: 'http://feat-x.localhost:28119/portals-manager/dev', containers: [], panes: [], procs: [] }, false);
+        assert.equal(out.split('\n')[0], 'http://feat-x.localhost:28119/portals-manager/dev');
+    });
+    it('leaves out the status pane and its ps children', () => {
+        const ps = [
+            '  100     1 20000 /usr/bin/zellij --server /run/user/1000/zellij/0.45.1/portals',
+            '  130   100 60000 node /x/portals/node_modules/.bin/df-dev status --watch --start-deps',
+            '  131   130  4000 ps -u 1000 -o pid=,ppid=,rss=,args=',
+            '  140   100  3500 bash ./node_modules/.bin/df-status --start-deps',
+            '  141   140  2000 sleep 3',
+            '  120   100 90000 node --watch index.ts'
+        ].join('\n');
+        assert.deepEqual(sessionProcesses(ps, 'portals', () => '/x/portals/api', '/x/portals').map(p => p.label), ['api: node --watch index.ts']);
+    });
+    it('flags a running pane whose readiness URL does not answer (node --watch waiting after a crash)', async () => {
+        const panes = [{ title: 'api', exited: false, exit_status: null }, { title: 'ui', exited: false, exit_status: null }, { title: 'shell', exited: false, exit_status: null }];
+        const config = { ports: [], panes: { api: { ready: 'http://localhost:${P}/api/ping' }, ui: { ready: 'http://localhost:${P}/' } } };
+        const checked = await checkReadiness(panes, config, { P: '1' }, async (url) => !url.includes('api'));
+        assert.deepEqual(checked.map(p => p.ready), [false, true, undefined]);
+        const out = renderStatus({ containers: [], panes: checked, procs: [] }, false);
+        assert.match(out, /⠿ api\s+running, not ready \(http:\/\/localhost:1\/api\/ping\)/);
+        assert.match(out, /✔ ui\s+running/);
+    });
+});
+//# sourceMappingURL=status.test.js.map

package/status.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.test.js","sourceRoot":"","sources":["status.test.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable no-template-curly-in-string -- ${VAR} placeholders are the dev/dev.json syntax */\nimport { describe, it } from 'node:test'\nimport { strict as assert } from 'assert'\nimport { containerMark, renderStatus, sessionProcesses, collectStatus, checkReadiness } from './status.js'\nimport type { Exec } from './exec.js'\n\ndescribe('status', () => {\n  it('marks containers like docker compose up --wait', () => {\n    assert.equal(containerMark({ service: 'mongo', state: 'running', health: 'healthy' }).mark, '✔')\n    assert.equal(containerMark({ service: 'sd', state: 'running', health: '' }).mark, '✔')\n    assert.equal(containerMark({ service: 'es', state: 'running', health: 'starting' }).mark, '⠿')\n    assert.equal(containerMark({ service: 'df', state: 'exited', health: '' }).color, 'red')\n    assert.equal(containerMark({ service: 'agents', state: 'not started', health: '' }).color, 'dim')\n    assert.deepEqual(containerMark({ service: 's3-init', state: 'exited', health: '', exitCode: 0 }), { mark: '✔', color: 'green', text: 'done' })\n  })\n\n  it('shows a stack stopped with exit code 0 as stopped, not done', () => {\n    const out = renderStatus({\n      containers: [{ service: 'mongo', state: 'exited', health: '', exitCode: 0 }, { service: 'nginx', state: 'exited', health: '', exitCode: 0 }],\n      panes: [],\n      procs: []\n    }, false)\n    assert.match(out, /· mongo\\s+stopped/)\n    assert.match(out, /· nginx\\s+stopped/)\n    assert.ok(!out.includes('done'))\n  })\n\n  it('renders containers, processes and the total in plain text', () => {\n    const out = renderStatus({\n      containers: [{ service: 'mongo', state: 'running', health: 'healthy', memory: '115MiB' }],\n      panes: [],\n      procs: [{ label: 'api: node --watch index.ts', rssKb: 245760 }]\n    }, false)\n    assert.match(out, /✔ mongo\\s+healthy\\s+115MiB/)\n    assert.match(out, /api: node --watch index.ts\\s+240M/)\n    assert.match(out, /processes total\\s+240M/)\n    assert.ok(!out.includes('\\x1b['))\n  })\n\n  it('counts only the processes of the zellij session, with their full command line', () => {\n    const ps = [\n      '  100     1 20000 /usr/bin/zellij --server /run/user/1000/zellij/0.45.1/portals_feat-x',\n      '  101   100  3000 /bin/bash -c npx --no df-dev wait-deps && node --watch index.ts',\n      '  102   101 245760 node --watch index.ts',\n      '  103   100  3000 bash -c vite',\n      '  104   103 1048576 /home/u/.nvm/versions/node/v24.21.0/bin/node /x/portals_feat-x/node_modules/.bin/vite --port 21001',\n      '  200     1 470000 claude',\n      '  201   200 120000 npm exec chrome-devtools-mcp',\n      '  300     1 20000 /usr/bin/zellij --server /run/user/1000/zellij/0.45.1/portals'\n    ].join('\\n')\n    const cwds: Record<number, string> = { 102: '/x/portals_feat-x/api', 104: '/x/portals_feat-x/ui' }\n    const procs = sessionProcesses(ps, 'portals_feat-x', pid => cwds[pid], '/x/portals_feat-x')\n    assert.deepEqual(procs, [\n      { label: 'api: node --watch index.ts', rssKb: 245760 },\n      { label: 'ui: vite --port 21001', rssKb: 1048576 }\n    ])\n  })\n\n  it('finds children listed before their parent (pid wrap-around)', () => {\n    const ps = [\n      '   50   900 245760 node --watch index.ts',\n      '  100     1 20000 /usr/bin/zellij --server /run/user/1000/zellij/0.45.1/portals',\n      '  900   100  3000 bash -c node --watch index.ts'\n    ].join('\\n')\n    assert.deepEqual(sessionProcesses(ps, 'portals', () => '/x/portals/api', '/x/portals').map(p => p.rssKb), [245760])\n  })\n\n  it('shows exited panes with their exit code', () => {\n    const out = renderStatus({\n      containers: [],\n      panes: [{ title: 'api', exited: true, exit_status: 1 }, { title: 'ui', exited: false, exit_status: null }],\n      procs: []\n    }, false)\n    assert.match(out, /✘ api\\s+exited \\(1\\)/)\n    assert.match(out, /✔ ui\\s+running/)\n  })\n\n  it('still shows panes and processes when docker or ps fails, and says when the session is not running', () => {\n    const exec: Exec = (cmd, args) => {\n      if (cmd === 'docker') throw new Error('Cannot connect to the Docker daemon')\n      if (args[0] === 'list-sessions') throw new Error('No active zellij sessions found.')\n      if (cmd === 'ps') throw new Error('ps: command not found')\n      throw new Error('unexpected ' + cmd + ' ' + args.join(' '))\n    }\n    const data = collectStatus('/x/portals', exec)\n    assert.deepEqual(data.procs, [])\n    assert.match(data.containersError ?? '', /Docker daemon/)\n    assert.match(data.panesError ?? '', /npm run dev-zellij/)\n    const out = renderStatus(data, false)\n    assert.match(out, /containers unavailable: .*Docker daemon/)\n    assert.match(out, /npm run dev-zellij/)\n  })\n\n  it('leaves out the status process itself and shortens executable paths', () => {\n    const ps = [\n      '  100     1 20000 /usr/bin/zellij --server /run/user/1000/zellij/0.45.1/portals',\n      '  110   100 50000 node ./node_modules/.bin/df-dev status --watch',\n      '  111   110  5000 ps -u 1000 -o pid=,ppid=,rss=,args=',\n      '  120   100 90000 /home/u/.nvm/versions/node/v24.21.0/bin/node --watch index.ts'\n    ].join('\\n')\n    const procs = sessionProcesses(ps, 'portals', () => '/x/portals/api', '/x/portals', 110)\n    assert.deepEqual(procs.map(p => p.label), ['api: node --watch index.ts'])\n  })\n\n  it('shows the dev URL first, in full so the terminal can open them', () => {\n    const out = renderStatus({ url: 'http://feat-x.localhost:28119/portals-manager/dev', containers: [], panes: [], procs: [] }, false)\n    assert.equal(out.split('\\n')[0], 'http://feat-x.localhost:28119/portals-manager/dev')\n  })\n\n  it('leaves out the status pane and its ps children', () => {\n    const ps = [\n      '  100     1 20000 /usr/bin/zellij --server /run/user/1000/zellij/0.45.1/portals',\n      '  130   100 60000 node /x/portals/node_modules/.bin/df-dev status --watch --start-deps',\n      '  131   130  4000 ps -u 1000 -o pid=,ppid=,rss=,args=',\n      '  140   100  3500 bash ./node_modules/.bin/df-status --start-deps',\n      '  141   140  2000 sleep 3',\n      '  120   100 90000 node --watch index.ts'\n    ].join('\\n')\n    assert.deepEqual(sessionProcesses(ps, 'portals', () => '/x/portals/api', '/x/portals').map(p => p.label), ['api: node --watch index.ts'])\n  })\n\n  it('flags a running pane whose readiness URL does not answer (node --watch waiting after a crash)', async () => {\n    const panes = [{ title: 'api', exited: false, exit_status: null }, { title: 'ui', exited: false, exit_status: null }, { title: 'shell', exited: false, exit_status: null }]\n    const config = { ports: [], panes: { api: { ready: 'http://localhost:${P}/api/ping' }, ui: { ready: 'http://localhost:${P}/' } } }\n    const checked = await checkReadiness(panes, config, { P: '1' }, async url => !url.includes('api'))\n    assert.deepEqual(checked.map(p => p.ready), [false, true, undefined])\n    const out = renderStatus({ containers: [], panes: checked, procs: [] }, false)\n    assert.match(out, /⠿ api\\s+running, not ready \\(http:\\/\\/localhost:1\\/api\\/ping\\)/)\n    assert.match(out, /✔ ui\\s+running/)\n  })\n})\n"]}

package/worktree-delete.sh

@@ -0,0 +1,141 @@
+#!/bin/bash
+# Delete a worktree, its branch, and its docker containers/volumes/local images
+# (when the worktree has a compose file).
+#
+# Refuses to proceed if the worktree has uncommitted changes or commits not
+# pushed to any origin ref. Pass -f / --force to bypass these checks (e.g. a
+# squash-merged branch); the deleted branch's commit is printed to recover it.
+
+set -e
+
+FORCE=false
+BRANCH_NAME=""
+
+while [ $# -gt 0 ]; do
+    case "$1" in
+        -f|--force) FORCE=true ;;
+        -h|--help)
+            echo "Usage: df-worktree-delete <branch> [-f|--force]" >&2
+            echo "  --force / -f  skip uncommitted/unpushed safety checks (the branch is deleted all the same)"
+            exit 0
+            ;;
+        -*)
+            echo "Error: unknown flag '$1'" >&2
+            echo "Usage: df-worktree-delete <branch> [-f|--force]" >&2
+            exit 1
+            ;;
+        *)
+            if [ -z "$BRANCH_NAME" ]; then
+                BRANCH_NAME="$1"
+            else
+                echo "Error: too many positional arguments" >&2
+                exit 1
+            fi
+            ;;
+    esac
+    shift
+done
+
+if [ -z "$BRANCH_NAME" ]; then
+    echo "Error: Please provide a branch name." >&2
+    echo "Usage: df-worktree-delete <branch> [-f|--force]" >&2
+    exit 1
+fi
+
+# the branch name becomes a directory, a zellij session and a DEV_HOST label
+if ! [[ "$BRANCH_NAME" =~ ^[A-Za-z0-9._-]{1,60}$ ]]; then
+    echo "Error: invalid branch name \"$BRANCH_NAME\": letters, digits, '.', '_' and '-' only, no \"/\", at most 60 characters (e.g. feat-xyz)" >&2
+    exit 1
+fi
+
+# the worktrees live next to the main checkout: refuse a subfolder or another worktree
+TOPLEVEL=$(git rev-parse --show-toplevel 2>/dev/null) || { echo "Error: not inside a git repository." >&2; exit 1; }
+if [ "$TOPLEVEL" != "$(pwd -P)" ]; then
+    echo "Error: run df-worktree-delete from the root of the repository: cd $TOPLEVEL" >&2
+    exit 1
+fi
+COMMON_DIR=$(git rev-parse --path-format=absolute --git-common-dir)
+if [ "$(git rev-parse --absolute-git-dir)" != "$COMMON_DIR" ]; then
+    echo "Error: run df-worktree-delete from the main checkout, not from a worktree: cd $(dirname "$COMMON_DIR")" >&2
+    exit 1
+fi
+
+REPO_NAME=$(basename "$PWD")
+TARGET_DIR="../${REPO_NAME}_${BRANCH_NAME}"
+
+if [ ! -d "$TARGET_DIR" ]; then
+    echo "Error: Worktree directory $TARGET_DIR does not exist."
+    exit 1
+fi
+
+ORIGIN_DIR="$PWD"
+
+if [ "$FORCE" != true ]; then
+    echo "Checking $TARGET_DIR for uncommitted / unpushed work…"
+    cd "$TARGET_DIR"
+
+    # Refresh remote refs so the "unpushed" check is accurate
+    git fetch origin --quiet 2>/dev/null || true
+
+    DIRTY=$(git status --porcelain)
+    if [ -n "$DIRTY" ]; then
+        echo
+        echo "❌ Refusing to delete: $TARGET_DIR has uncommitted changes:"
+        echo "$DIRTY" | sed 's/^/    /'
+        echo
+        echo "Commit / push / stash them, or pass -f / --force to bypass."
+        exit 1
+    fi
+
+    # Commits reachable from HEAD but NOT reachable from any origin/* ref.
+    # Catches: never-pushed branches, branches ahead of upstream, detached HEAD with unique commits.
+    UNPUSHED_COUNT=$(git rev-list --count HEAD --not --remotes=origin 2>/dev/null || echo 0)
+    if [ "$UNPUSHED_COUNT" -gt 0 ]; then
+        echo
+        echo "❌ Refusing to delete: $TARGET_DIR has $UNPUSHED_COUNT commit(s) not present on any origin ref:"
+        git --no-pager log --oneline HEAD --not --remotes=origin | sed 's/^/    /'
+        echo
+        echo "Push them (e.g. 'git push -u origin $BRANCH_NAME'), or pass -f / --force to bypass."
+        exit 1
+    fi
+
+    cd "$ORIGIN_DIR"
+    echo "✓ working tree clean and all commits present on origin"
+fi
+
+# the branch checked out in the worktree, deleted with it when it is the one named (not a detached HEAD)
+WORKTREE_BRANCH=$(git -C "$TARGET_DIR" branch --show-current)
+
+cd "$TARGET_DIR"
+# a repository without containers has no compose file: docker compose would fail, or find a parent's
+HAS_COMPOSE=false
+for f in compose.yaml compose.yml docker-compose.yaml docker-compose.yml; do
+    [ -f "$f" ] && HAS_COMPOSE=true
+done
+if [ "$HAS_COMPOSE" = true ]; then
+    echo "Stopping & removing docker compose services in $TARGET_DIR (with volumes and orphans)"
+    # --profile '*' : catch every container the worktree may have started, whatever the repo names its profiles
+    # -v : drop named volumes (mongo, elasticsearch, s3mock, clamav…) — data is worktree-scoped
+    # --remove-orphans : sweep any container left over from a previous compose file
+    # --rmi local : remove images built locally for this worktree (keeps remote-pulled images)
+    docker compose --profile '*' down -v --remove-orphans --rmi local
+fi
+
+echo "Removing git worktree at $TARGET_DIR"
+cd "$ORIGIN_DIR"
+if [ "$FORCE" = true ]; then
+    git worktree remove --force "$TARGET_DIR" # untracked files (generated types, UI builds) would block a plain remove
+else
+    git worktree remove "$TARGET_DIR"
+fi
+zellij delete-session "$(basename "$TARGET_DIR")" --force >/dev/null 2>&1 || true
+
+if [ "$WORKTREE_BRANCH" = "$BRANCH_NAME" ]; then
+    # without --force every commit is on origin; with it, the printed commit is the way back
+    echo "Deleting branch $BRANCH_NAME (was $(git rev-parse --short "$BRANCH_NAME"))"
+    git branch -q -D "$BRANCH_NAME"
+fi
+
+echo "-----------------------------------------------"
+echo "✅ Worktree $BRANCH_NAME deleted!"
+echo "-----------------------------------------------"