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

package/env.js

@@ -0,0 +1,94 @@
+import { existsSync, writeFileSync } from 'node:fs';
+import net from 'node:net';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { readEnvFile } from './config.js';
+// below the kernel ephemeral range (32768+), so a port is not taken later by an outgoing connection
+export const PORT_MIN = 20000;
+export const PORT_MAX = 29999;
+export const isPortFree = (port) => new Promise(resolve => {
+    const server = net.createServer();
+    server.once('error', () => resolve(false));
+    server.listen(port, '127.0.0.1', () => server.close(() => resolve(true)));
+});
+export const pickPorts = async (ports, isFree = isPortFree, random = Math.random) => {
+    const result = {};
+    const taken = new Set();
+    for (const name of ports) {
+        for (let attempt = 0;; attempt++) {
+            if (attempt >= 100)
+                throw new Error(`no free port found for ${name} in ${PORT_MIN}-${PORT_MAX}`);
+            const port = PORT_MIN + Math.floor(random() * (PORT_MAX - PORT_MIN + 1));
+            if (!taken.has(port) && await isFree(port)) {
+                result[name] = port;
+                taken.add(port);
+                break;
+            }
+        }
+    }
+    return result;
+};
+/** Ports already written in the .env of the other worktrees of the repository: free now while their env is stopped, taken later. */
+const gitWorktreeList = (root) => execFileSync('git', ['worktree', 'list', '--porcelain'], { cwd: root, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+export const otherWorktreePorts = (root, worktreeList = gitWorktreeList) => {
+    const ports = new Set();
+    let list = '';
+    try {
+        list = worktreeList(root);
+    }
+    catch {
+        return ports; // not a git checkout: nothing to avoid
+    }
+    for (const line of list.split('\n')) {
+        if (!line.startsWith('worktree '))
+            continue;
+        const dir = line.slice('worktree '.length);
+        if (path.resolve(dir) === path.resolve(root))
+            continue;
+        for (const value of Object.values(readEnvFile(dir))) {
+            const port = Number(value);
+            if (Number.isInteger(port) && port >= PORT_MIN && port <= PORT_MAX)
+                ports.add(port);
+        }
+    }
+    return ports;
+};
+// quoted only when parseEnv would otherwise cut or change the value (#, spaces, quotes, new lines)
+export const formatEnvValue = (value) => {
+    const s = String(value);
+    if (/^[\w.,:/@%+=-]*$/.test(s))
+        return s;
+    // single quotes are read literally by parseEnv, backticks for a value that contains one
+    for (const quote of ["'", '`', '"'])
+        if (!s.includes(quote))
+            return quote + s + quote;
+    throw new Error(`cannot write a .env value that contains ', \` and ": ${s}`);
+};
+export const hostLabel = (branch) => branch.toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '').slice(0, 63).replace(/-$/, '') || 'dev';
+const currentBranch = (root) => {
+    try {
+        return execFileSync('git', ['branch', '--show-current'], { cwd: root, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim() || 'detached';
+    }
+    catch {
+        return 'dev';
+    }
+};
+export const initEnv = async (root, config, opts = {}) => {
+    const file = path.join(root, '.env');
+    if (existsSync(file) && !opts.force)
+        return { written: false, file };
+    const reserved = opts.reserved ?? otherWorktreePorts(root);
+    const isFree = opts.isFree ?? isPortFree;
+    const ports = await pickPorts(config.ports, async (port) => !reserved.has(port) && await isFree(port), opts.random);
+    const vars = {
+        // with --force, variables added by hand survive; the generated ones are drawn again
+        ...readEnvFile(root),
+        DEV_HOST: `${hostLabel(opts.branch ?? currentBranch(root))}.localhost`,
+        // all dev services listen on the loopback, the SSRF protection of the default http agents must accept it
+        SSRF_PUBLIC_IPS: '127.0.0.1,::1',
+        ...ports
+    };
+    writeFileSync(file, Object.entries(vars).map(([k, v]) => `${k}=${formatEnvValue(v)}`).join('\n') + '\n');
+    return { written: true, file };
+};
+//# sourceMappingURL=env.js.map

package/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["env.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, writeFileSync } from 'node:fs'\nimport net from 'node:net'\nimport path from 'node:path'\nimport { execFileSync } from 'node:child_process'\nimport { readEnvFile, type DevConfig } from './config.js'\n\n// below the kernel ephemeral range (32768+), so a port is not taken later by an outgoing connection\nexport const PORT_MIN = 20000\nexport const PORT_MAX = 29999\n\nexport const isPortFree = (port: number) => new Promise<boolean>(resolve => {\n  const server = net.createServer()\n  server.once('error', () => resolve(false))\n  server.listen(port, '127.0.0.1', () => server.close(() => resolve(true)))\n})\n\nexport const pickPorts = async (ports: string[], isFree = isPortFree, random = Math.random) => {\n  const result: Record<string, number> = {}\n  const taken = new Set<number>()\n  for (const name of ports) {\n    for (let attempt = 0; ; attempt++) {\n      if (attempt >= 100) throw new Error(`no free port found for ${name} in ${PORT_MIN}-${PORT_MAX}`)\n      const port = PORT_MIN + Math.floor(random() * (PORT_MAX - PORT_MIN + 1))\n      if (!taken.has(port) && await isFree(port)) {\n        result[name] = port\n        taken.add(port)\n        break\n      }\n    }\n  }\n  return result\n}\n\n/** Ports already written in the .env of the other worktrees of the repository: free now while their env is stopped, taken later. */\nconst gitWorktreeList = (root: string) => execFileSync('git', ['worktree', 'list', '--porcelain'], { cwd: root, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] })\n\nexport const otherWorktreePorts = (root: string, worktreeList = gitWorktreeList) => {\n  const ports = new Set<number>()\n  let list = ''\n  try {\n    list = worktreeList(root)\n  } catch {\n    return ports // not a git checkout: nothing to avoid\n  }\n  for (const line of list.split('\\n')) {\n    if (!line.startsWith('worktree ')) continue\n    const dir = line.slice('worktree '.length)\n    if (path.resolve(dir) === path.resolve(root)) continue\n    for (const value of Object.values(readEnvFile(dir))) {\n      const port = Number(value)\n      if (Number.isInteger(port) && port >= PORT_MIN && port <= PORT_MAX) ports.add(port)\n    }\n  }\n  return ports\n}\n\n// quoted only when parseEnv would otherwise cut or change the value (#, spaces, quotes, new lines)\nexport const formatEnvValue = (value: string | number) => {\n  const s = String(value)\n  if (/^[\\w.,:/@%+=-]*$/.test(s)) return s\n  // single quotes are read literally by parseEnv, backticks for a value that contains one\n  for (const quote of [\"'\", '`', '\"']) if (!s.includes(quote)) return quote + s + quote\n  throw new Error(`cannot write a .env value that contains ', \\` and \": ${s}`)\n}\n\nexport const hostLabel = (branch: string) =>\n  branch.toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '').slice(0, 63).replace(/-$/, '') || 'dev'\n\nconst currentBranch = (root: string) => {\n  try {\n    return execFileSync('git', ['branch', '--show-current'], { cwd: root, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim() || 'detached'\n  } catch {\n    return 'dev'\n  }\n}\n\nexport const initEnv = async (root: string, config: DevConfig, opts: { force?: boolean, branch?: string, isFree?: (port: number) => Promise<boolean>, reserved?: Set<number>, random?: () => number } = {}) => {\n  const file = path.join(root, '.env')\n  if (existsSync(file) && !opts.force) return { written: false, file }\n  const reserved = opts.reserved ?? otherWorktreePorts(root)\n  const isFree = opts.isFree ?? isPortFree\n  const ports = await pickPorts(config.ports, async port => !reserved.has(port) && await isFree(port), opts.random)\n  const vars: Record<string, string | number> = {\n    // with --force, variables added by hand survive; the generated ones are drawn again\n    ...readEnvFile(root),\n    DEV_HOST: `${hostLabel(opts.branch ?? currentBranch(root))}.localhost`,\n    // all dev services listen on the loopback, the SSRF protection of the default http agents must accept it\n    SSRF_PUBLIC_IPS: '127.0.0.1,::1',\n    ...ports\n  }\n  writeFileSync(file, Object.entries(vars).map(([k, v]) => `${k}=${formatEnvValue(v)}`).join('\\n') + '\\n')\n  return { written: true, file }\n}\n"]}

package/env.test.d.ts

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

package/env.test.js

@@ -0,0 +1,106 @@
+import { describe, it } from 'node:test';
+import { strict as assert } from 'assert';
+import { mkdirSync, mkdtempSync, readFileSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { pickPorts, hostLabel, initEnv, otherWorktreePorts, PORT_MIN, PORT_MAX } from './env.js';
+import { readEnvFile } from './config.js';
+const config = { ports: ['NGINX_PORT', 'DEV_API_PORT'], panes: {} };
+describe('pickPorts', () => {
+    it('draws distinct free ports in range', async () => {
+        const ports = await pickPorts(config.ports, async () => true);
+        for (const name of ['NGINX_PORT', 'DEV_API_PORT']) {
+            assert.ok(ports[name] >= PORT_MIN && ports[name] <= PORT_MAX);
+        }
+        assert.notEqual(ports.NGINX_PORT, ports.DEV_API_PORT);
+    });
+    it('skips ports that are busy', async () => {
+        const busy = new Set([PORT_MIN]);
+        let n = 0;
+        const random = () => (n++ === 0 ? 0 : 0.5); // first draw hits the busy PORT_MIN
+        const ports = await pickPorts(['A'], async (port) => !busy.has(port), random);
+        assert.notEqual(ports.A, PORT_MIN);
+    });
+});
+describe('hostLabel', () => {
+    it('turns any branch name into a valid hostname label', () => {
+        assert.equal(hostLabel('feat/X_y'), 'feat-x-y');
+        assert.equal(hostLabel('master'), 'master');
+        assert.equal(hostLabel('--weird--'), 'weird');
+    });
+    it('caps the label at 63 characters (DNS limit)', () => {
+        const label = hostLabel('a'.repeat(70) + '-b');
+        assert.equal(label.length, 63);
+        assert.ok(!label.endsWith('-'));
+    });
+});
+describe('initEnv', () => {
+    it('writes ports, DEV_HOST and SSRF_PUBLIC_IPS', async () => {
+        const root = mkdtempSync(path.join(tmpdir(), 'df-dev-'));
+        const res = await initEnv(root, config, { branch: 'feat/X', isFree: async () => true });
+        assert.equal(res.written, true);
+        const env = readEnvFile(root);
+        assert.equal(env.DEV_HOST, 'feat-x.localhost');
+        assert.equal(env.SSRF_PUBLIC_IPS, '127.0.0.1,::1');
+        assert.ok(Number(env.DEV_API_PORT) >= PORT_MIN);
+    });
+    it('never overwrites an existing .env without force', async () => {
+        const root = mkdtempSync(path.join(tmpdir(), 'df-dev-'));
+        writeFileSync(path.join(root, '.env'), 'NGINX_PORT=1\n');
+        const res = await initEnv(root, config, { branch: 'x', isFree: async () => true });
+        assert.equal(res.written, false);
+        assert.equal(readFileSync(path.join(root, '.env'), 'utf8'), 'NGINX_PORT=1\n');
+    });
+    it('regenerates with force', async () => {
+        const root = mkdtempSync(path.join(tmpdir(), 'df-dev-'));
+        writeFileSync(path.join(root, '.env'), 'NGINX_PORT=1\n');
+        await initEnv(root, config, { force: true, branch: 'x', isFree: async () => true });
+        assert.notEqual(readEnvFile(root).NGINX_PORT, '1');
+    });
+    it('keeps the variables added by hand when regenerating with force', async () => {
+        const root = mkdtempSync(path.join(tmpdir(), 'df-dev-'));
+        writeFileSync(path.join(root, '.env'), 'NGINX_PORT=1\nDEV_HOST=old.localhost\nMY_TOKEN=secret\n');
+        await initEnv(root, config, { force: true, branch: 'x', isFree: async () => true });
+        const env = readEnvFile(root);
+        assert.equal(env.MY_TOKEN, 'secret');
+        assert.equal(env.DEV_HOST, 'x.localhost');
+        assert.notEqual(env.NGINX_PORT, '1');
+    });
+    it('keeps hand-added values that need quotes intact through a regeneration', async () => {
+        const root = mkdtempSync(path.join(tmpdir(), 'df-dev-'));
+        writeFileSync(path.join(root, '.env'), 'NGINX_PORT=1\nSECRET=\'abc#def\'\nMSG="a b"\nQUOTE=`it\'s`\nCERT=\'line1\nline2\'\nPLAIN=x\n');
+        await initEnv(root, config, { force: true, branch: 'x', isFree: async () => true, reserved: new Set() });
+        await initEnv(root, config, { force: true, branch: 'x', isFree: async () => true, reserved: new Set() });
+        const env = readEnvFile(root);
+        assert.equal(env.SECRET, 'abc#def');
+        assert.equal(env.MSG, 'a b');
+        assert.equal(env.QUOTE, "it's");
+        assert.equal(env.CERT, 'line1\nline2');
+        assert.equal(env.PLAIN, 'x');
+        assert.match(readFileSync(path.join(root, '.env'), 'utf8'), /^PLAIN=x$/m);
+    });
+    it('never draws a port written in the .env of another worktree', async () => {
+        const root = mkdtempSync(path.join(tmpdir(), 'df-dev-'));
+        // the first draw falls on a port another worktree uses, the second on a fresh one
+        const draws = [PORT_MIN + 5, PORT_MIN + 6].map(p => (p - PORT_MIN + 0.5) / (PORT_MAX - PORT_MIN + 1));
+        let i = 0;
+        await initEnv(root, { ...config, ports: ['NGINX_PORT'] }, { branch: 'x', isFree: async () => true, reserved: new Set([PORT_MIN + 5]), random: () => draws[i++] });
+        assert.equal(readEnvFile(root).NGINX_PORT, String(PORT_MIN + 6));
+        assert.equal(i, 2);
+    });
+    it('reads the ports of the other worktrees of the repository', () => {
+        const tmp = mkdtempSync(path.join(tmpdir(), 'df-dev-wt-'));
+        const root = path.join(tmp, 'repo');
+        const other = path.join(tmp, 'repo_feat-a');
+        mkdirSync(root);
+        mkdirSync(other);
+        writeFileSync(path.join(other, '.env'), `NGINX_PORT=${PORT_MIN + 5}\nDEV_HOST=feat-a.localhost\nOTHER=80\n`);
+        writeFileSync(path.join(root, '.env'), `NGINX_PORT=${PORT_MIN + 6}\n`);
+        // output of git worktree list --porcelain, given as text: no git in this test
+        const list = () => `worktree ${root}\nHEAD abc\nbranch refs/heads/master\n\nworktree ${other}\nHEAD def\nbranch refs/heads/feat-a\n`;
+        assert.deepEqual([...otherWorktreePorts(root, list)], [PORT_MIN + 5]);
+        assert.deepEqual([...otherWorktreePorts(other, list)], [PORT_MIN + 6]);
+        assert.deepEqual([...otherWorktreePorts(root, () => { throw new Error('not a git repository'); })], []);
+    });
+});
+//# sourceMappingURL=env.test.js.map

package/env.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.test.js","sourceRoot":"","sources":["env.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, it } from 'node:test'\nimport { strict as assert } from 'assert'\nimport { mkdirSync, mkdtempSync, readFileSync, writeFileSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport path from 'node:path'\nimport { pickPorts, hostLabel, initEnv, otherWorktreePorts, PORT_MIN, PORT_MAX } from './env.js'\nimport { readEnvFile } from './config.js'\n\nconst config = { ports: ['NGINX_PORT', 'DEV_API_PORT'], panes: {} }\n\ndescribe('pickPorts', () => {\n  it('draws distinct free ports in range', async () => {\n    const ports = await pickPorts(config.ports, async () => true)\n    for (const name of ['NGINX_PORT', 'DEV_API_PORT']) {\n      assert.ok(ports[name] >= PORT_MIN && ports[name] <= PORT_MAX)\n    }\n    assert.notEqual(ports.NGINX_PORT, ports.DEV_API_PORT)\n  })\n\n  it('skips ports that are busy', async () => {\n    const busy = new Set([PORT_MIN])\n    let n = 0\n    const random = () => (n++ === 0 ? 0 : 0.5) // first draw hits the busy PORT_MIN\n    const ports = await pickPorts(['A'], async port => !busy.has(port), random)\n    assert.notEqual(ports.A, PORT_MIN)\n  })\n})\n\ndescribe('hostLabel', () => {\n  it('turns any branch name into a valid hostname label', () => {\n    assert.equal(hostLabel('feat/X_y'), 'feat-x-y')\n    assert.equal(hostLabel('master'), 'master')\n    assert.equal(hostLabel('--weird--'), 'weird')\n  })\n\n  it('caps the label at 63 characters (DNS limit)', () => {\n    const label = hostLabel('a'.repeat(70) + '-b')\n    assert.equal(label.length, 63)\n    assert.ok(!label.endsWith('-'))\n  })\n})\n\ndescribe('initEnv', () => {\n  it('writes ports, DEV_HOST and SSRF_PUBLIC_IPS', async () => {\n    const root = mkdtempSync(path.join(tmpdir(), 'df-dev-'))\n    const res = await initEnv(root, config, { branch: 'feat/X', isFree: async () => true })\n    assert.equal(res.written, true)\n    const env = readEnvFile(root)\n    assert.equal(env.DEV_HOST, 'feat-x.localhost')\n    assert.equal(env.SSRF_PUBLIC_IPS, '127.0.0.1,::1')\n    assert.ok(Number(env.DEV_API_PORT) >= PORT_MIN)\n  })\n\n  it('never overwrites an existing .env without force', async () => {\n    const root = mkdtempSync(path.join(tmpdir(), 'df-dev-'))\n    writeFileSync(path.join(root, '.env'), 'NGINX_PORT=1\\n')\n    const res = await initEnv(root, config, { branch: 'x', isFree: async () => true })\n    assert.equal(res.written, false)\n    assert.equal(readFileSync(path.join(root, '.env'), 'utf8'), 'NGINX_PORT=1\\n')\n  })\n\n  it('regenerates with force', async () => {\n    const root = mkdtempSync(path.join(tmpdir(), 'df-dev-'))\n    writeFileSync(path.join(root, '.env'), 'NGINX_PORT=1\\n')\n    await initEnv(root, config, { force: true, branch: 'x', isFree: async () => true })\n    assert.notEqual(readEnvFile(root).NGINX_PORT, '1')\n  })\n\n  it('keeps the variables added by hand when regenerating with force', async () => {\n    const root = mkdtempSync(path.join(tmpdir(), 'df-dev-'))\n    writeFileSync(path.join(root, '.env'), 'NGINX_PORT=1\\nDEV_HOST=old.localhost\\nMY_TOKEN=secret\\n')\n    await initEnv(root, config, { force: true, branch: 'x', isFree: async () => true })\n    const env = readEnvFile(root)\n    assert.equal(env.MY_TOKEN, 'secret')\n    assert.equal(env.DEV_HOST, 'x.localhost')\n    assert.notEqual(env.NGINX_PORT, '1')\n  })\n\n  it('keeps hand-added values that need quotes intact through a regeneration', async () => {\n    const root = mkdtempSync(path.join(tmpdir(), 'df-dev-'))\n    writeFileSync(path.join(root, '.env'), 'NGINX_PORT=1\\nSECRET=\\'abc#def\\'\\nMSG=\"a b\"\\nQUOTE=`it\\'s`\\nCERT=\\'line1\\nline2\\'\\nPLAIN=x\\n')\n    await initEnv(root, config, { force: true, branch: 'x', isFree: async () => true, reserved: new Set() })\n    await initEnv(root, config, { force: true, branch: 'x', isFree: async () => true, reserved: new Set() })\n    const env = readEnvFile(root)\n    assert.equal(env.SECRET, 'abc#def')\n    assert.equal(env.MSG, 'a b')\n    assert.equal(env.QUOTE, \"it's\")\n    assert.equal(env.CERT, 'line1\\nline2')\n    assert.equal(env.PLAIN, 'x')\n    assert.match(readFileSync(path.join(root, '.env'), 'utf8'), /^PLAIN=x$/m)\n  })\n\n  it('never draws a port written in the .env of another worktree', async () => {\n    const root = mkdtempSync(path.join(tmpdir(), 'df-dev-'))\n    // the first draw falls on a port another worktree uses, the second on a fresh one\n    const draws = [PORT_MIN + 5, PORT_MIN + 6].map(p => (p - PORT_MIN + 0.5) / (PORT_MAX - PORT_MIN + 1))\n    let i = 0\n    await initEnv(root, { ...config, ports: ['NGINX_PORT'] }, { branch: 'x', isFree: async () => true, reserved: new Set([PORT_MIN + 5]), random: () => draws[i++] })\n    assert.equal(readEnvFile(root).NGINX_PORT, String(PORT_MIN + 6))\n    assert.equal(i, 2)\n  })\n\n  it('reads the ports of the other worktrees of the repository', () => {\n    const tmp = mkdtempSync(path.join(tmpdir(), 'df-dev-wt-'))\n    const root = path.join(tmp, 'repo')\n    const other = path.join(tmp, 'repo_feat-a')\n    mkdirSync(root)\n    mkdirSync(other)\n    writeFileSync(path.join(other, '.env'), `NGINX_PORT=${PORT_MIN + 5}\\nDEV_HOST=feat-a.localhost\\nOTHER=80\\n`)\n    writeFileSync(path.join(root, '.env'), `NGINX_PORT=${PORT_MIN + 6}\\n`)\n    // output of git worktree list --porcelain, given as text: no git in this test\n    const list = () => `worktree ${root}\\nHEAD abc\\nbranch refs/heads/master\\n\\nworktree ${other}\\nHEAD def\\nbranch refs/heads/feat-a\\n`\n    assert.deepEqual([...otherWorktreePorts(root, list)], [PORT_MIN + 5])\n    assert.deepEqual([...otherWorktreePorts(other, list)], [PORT_MIN + 6])\n    assert.deepEqual([...otherWorktreePorts(root, () => { throw new Error('not a git repository') })], [])\n  })\n})\n"]}

package/exec.d.ts

@@ -0,0 +1,5 @@
+export type Exec = (cmd: string, args: string[]) => string;
+export declare const realExec: Exec;
+/** Run a command with the terminal attached (output visible to the user), throw if it fails. */
+export declare const run: (cmd: string, args: string[], cwd: string, env?: NodeJS.ProcessEnv) => void;
+export declare const jsonLines: (out: string) => any[];

package/exec.js

@@ -0,0 +1,11 @@
+import { execFileSync, spawnSync } from 'node:child_process';
+export const realExec = (cmd, args) => execFileSync(cmd, args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], maxBuffer: 256 * 1024 * 1024 }); // a full pane scrollback exceeds the 1 MiB default
+/** Run a command with the terminal attached (output visible to the user), throw if it fails. */
+export const run = (cmd, args, cwd, env = process.env) => {
+    const result = spawnSync(cmd, args, { cwd, env, stdio: 'inherit' });
+    if (result.status !== 0)
+        throw new Error(`${cmd} ${args.join(' ')} failed with exit code ${result.status}`);
+};
+// docker compose prints one JSON object per line (older versions: a single JSON array)
+export const jsonLines = (out) => out.split('\n').filter(l => l.trim()).flatMap(l => JSON.parse(l));
+//# sourceMappingURL=exec.js.map

package/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAI5D,MAAM,CAAC,MAAM,QAAQ,GAAS,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAA,CAAC,mDAAmD;AAE/M,gGAAgG;AAChG,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,IAAc,EAAE,GAAW,EAAE,MAAyB,OAAO,CAAC,GAAG,EAAE,EAAE;IACpG,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;IACnE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,0BAA0B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;AAC7G,CAAC,CAAA;AAED,uFAAuF;AACvF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAS,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA","sourcesContent":["import { execFileSync, spawnSync } from 'node:child_process'\n\nexport type Exec = (cmd: string, args: string[]) => string\n\nexport const realExec: Exec = (cmd, args) => execFileSync(cmd, args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], maxBuffer: 256 * 1024 * 1024 }) // a full pane scrollback exceeds the 1 MiB default\n\n/** Run a command with the terminal attached (output visible to the user), throw if it fails. */\nexport const run = (cmd: string, args: string[], cwd: string, env: NodeJS.ProcessEnv = process.env) => {\n  const result = spawnSync(cmd, args, { cwd, env, stdio: 'inherit' })\n  if (result.status !== 0) throw new Error(`${cmd} ${args.join(' ')} failed with exit code ${result.status}`)\n}\n\n// docker compose prints one JSON object per line (older versions: a single JSON array)\nexport const jsonLines = (out: string): any[] => out.split('\\n').filter(l => l.trim()).flatMap(l => JSON.parse(l))\n"]}

package/exec.test.d.ts

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

package/exec.test.js

@@ -0,0 +1,10 @@
+import { describe, it } from 'node:test';
+import { strict as assert } from 'assert';
+import { realExec } from './exec.js';
+describe('realExec', () => {
+    it('reads outputs larger than 1 MiB (a full pane scrollback)', () => {
+        const out = realExec('node', ['-e', "process.stdout.write('x'.repeat(3 * 1024 * 1024))"]);
+        assert.equal(out.length, 3 * 1024 * 1024);
+    });
+});
+//# sourceMappingURL=exec.test.js.map

package/exec.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.test.js","sourceRoot":"","sources":["exec.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,QAAQ,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,mDAAmD,CAAC,CAAC,CAAA;QACzF,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA","sourcesContent":["import { describe, it } from 'node:test'\nimport { strict as assert } from 'assert'\nimport { realExec } from './exec.js'\n\ndescribe('realExec', () => {\n  it('reads outputs larger than 1 MiB (a full pane scrollback)', () => {\n    const out = realExec('node', ['-e', \"process.stdout.write('x'.repeat(3 * 1024 * 1024))\"])\n    assert.equal(out.length, 3 * 1024 * 1024)\n  })\n})\n"]}

package/launch.d.ts

@@ -0,0 +1,13 @@
+import { type Exec } from './exec.js';
+import { type SessionState } from './zellij.js';
+export declare const launchPlan: (state: SessionState, session: string, services: string[]) => {
+    deleteFirst: boolean;
+    args: string[];
+    warning?: string;
+};
+declare const realSpawn: (args: string[], env: NodeJS.ProcessEnv) => number;
+export declare const launch: (root: string, services: string[], deps?: {
+    exec?: Exec;
+    spawn?: typeof realSpawn;
+}) => number;
+export {};

package/launch.js

@@ -0,0 +1,36 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { readEnvFile } from './config.js';
+import { realExec } from './exec.js';
+import { sessionName, sessionState, checkVersion } from './zellij.js';
+export const launchPlan = (state, session, services) => {
+    if (state === 'running') {
+        const plan = { deleteFirst: false, args: ['attach', session] };
+        if (services.length)
+            plan.warning = `session ${session} is already running, --services ignored: add them with "npx --no df-dev up ${services.join(' ')}"`;
+        return plan;
+    }
+    // an EXITED session keeps its name reserved and makes the creation fail;
+    // --layout with --session would add a tab to an existing session instead of creating one
+    return { deleteFirst: state === 'exited', args: ['--session', session, '--new-session-with-layout', '.zellij.kdl'] };
+};
+const realSpawn = (args, env) => spawnSync('zellij', args, { stdio: 'inherit', env }).status ?? 1;
+export const launch = (root, services, deps = {}) => {
+    const exec = deps.exec ?? realExec;
+    if (!existsSync(path.join(root, '.env')))
+        throw new Error('no .env in this worktree, run "npx --no df-dev setup" first');
+    checkVersion(exec);
+    const session = sessionName(root);
+    const plan = launchPlan(sessionState(exec, session), session, services);
+    if (plan.warning)
+        console.warn(plan.warning);
+    if (plan.deleteFirst)
+        exec('zellij', ['delete-session', session]);
+    const env = { ...process.env, ...readEnvFile(root) };
+    if (services.length)
+        env.COMPOSE_PROFILES = services.join(',');
+    process.chdir(root);
+    return (deps.spawn ?? realSpawn)(plan.args, env);
+};
+//# sourceMappingURL=launch.js.map

package/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["launch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAa,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAqB,MAAM,aAAa,CAAA;AAExF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAmB,EAAE,OAAe,EAAE,QAAkB,EAAE,EAAE;IACrF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,GAA+D,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAA;QAC1H,IAAI,QAAQ,CAAC,MAAM;YAAE,IAAI,CAAC,OAAO,GAAG,WAAW,OAAO,8EAA8E,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;QACzJ,OAAO,IAAI,CAAA;IACb,CAAC;IACD,yEAAyE;IACzE,yFAAyF;IACzF,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,2BAA2B,EAAE,aAAa,CAAC,EAAE,CAAA;AACtH,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,CAAC,IAAc,EAAE,GAAsB,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAA;AAE9H,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,QAAkB,EAAE,OAAkD,EAAE,EAAE,EAAE;IAC/G,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAA;IAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAA;IACxH,YAAY,CAAC,IAAI,CAAC,CAAA;IAClB,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;IACvE,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC5C,IAAI,IAAI,CAAC,WAAW;QAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAA;IACjE,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAAA;IACpD,IAAI,QAAQ,CAAC,MAAM;QAAE,GAAG,CAAC,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9D,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACnB,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AAClD,CAAC,CAAA","sourcesContent":["import { existsSync } from 'node:fs'\nimport path from 'node:path'\nimport { spawnSync } from 'node:child_process'\nimport { readEnvFile } from './config.js'\nimport { realExec, type Exec } from './exec.js'\nimport { sessionName, sessionState, checkVersion, type SessionState } from './zellij.js'\n\nexport const launchPlan = (state: SessionState, session: string, services: string[]) => {\n  if (state === 'running') {\n    const plan: { deleteFirst: boolean, args: string[], warning?: string } = { deleteFirst: false, args: ['attach', session] }\n    if (services.length) plan.warning = `session ${session} is already running, --services ignored: add them with \"npx --no df-dev up ${services.join(' ')}\"`\n    return plan\n  }\n  // an EXITED session keeps its name reserved and makes the creation fail;\n  // --layout with --session would add a tab to an existing session instead of creating one\n  return { deleteFirst: state === 'exited', args: ['--session', session, '--new-session-with-layout', '.zellij.kdl'] }\n}\n\nconst realSpawn = (args: string[], env: NodeJS.ProcessEnv) => spawnSync('zellij', args, { stdio: 'inherit', env }).status ?? 1\n\nexport const launch = (root: string, services: string[], deps: { exec?: Exec, spawn?: typeof realSpawn } = {}) => {\n  const exec = deps.exec ?? realExec\n  if (!existsSync(path.join(root, '.env'))) throw new Error('no .env in this worktree, run \"npx --no df-dev setup\" first')\n  checkVersion(exec)\n  const session = sessionName(root)\n  const plan = launchPlan(sessionState(exec, session), session, services)\n  if (plan.warning) console.warn(plan.warning)\n  if (plan.deleteFirst) exec('zellij', ['delete-session', session])\n  const env = { ...process.env, ...readEnvFile(root) }\n  if (services.length) env.COMPOSE_PROFILES = services.join(',')\n  process.chdir(root)\n  return (deps.spawn ?? realSpawn)(plan.args, env)\n}\n"]}

package/launch.test.d.ts

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

package/launch.test.js

@@ -0,0 +1,19 @@
+import { describe, it } from 'node:test';
+import { strict as assert } from 'assert';
+import { launchPlan } from './launch.js';
+describe('launchPlan', () => {
+    it('creates a missing session with the layout', () => {
+        assert.deepEqual(launchPlan('absent', 'portals', []), { deleteFirst: false, args: ['--session', 'portals', '--new-session-with-layout', '.zellij.kdl'] });
+    });
+    it('deletes an EXITED session before creating it again', () => {
+        assert.equal(launchPlan('exited', 'portals', []).deleteFirst, true);
+    });
+    it('attaches to a running session and never kills it', () => {
+        const plan = launchPlan('running', 'portals', []);
+        assert.deepEqual(plan, { deleteFirst: false, args: ['attach', 'portals'] });
+    });
+    it('warns that --services is ignored when attaching to a running session', () => {
+        assert.match(launchPlan('running', 'portals', ['agents']).warning ?? '', /df-dev up agents/);
+    });
+});
+//# sourceMappingURL=launch.test.js.map

package/launch.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.test.js","sourceRoot":"","sources":["launch.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,QAAQ,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,2BAA2B,EAAE,aAAa,CAAC,EAAE,CAAC,CAAA;IAC3J,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,CAAA;QACjD,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC,CAAA;IAC7E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAA;IAC9F,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA","sourcesContent":["import { describe, it } from 'node:test'\nimport { strict as assert } from 'assert'\nimport { launchPlan } from './launch.js'\n\ndescribe('launchPlan', () => {\n  it('creates a missing session with the layout', () => {\n    assert.deepEqual(launchPlan('absent', 'portals', []), { deleteFirst: false, args: ['--session', 'portals', '--new-session-with-layout', '.zellij.kdl'] })\n  })\n\n  it('deletes an EXITED session before creating it again', () => {\n    assert.equal(launchPlan('exited', 'portals', []).deleteFirst, true)\n  })\n\n  it('attaches to a running session and never kills it', () => {\n    const plan = launchPlan('running', 'portals', [])\n    assert.deepEqual(plan, { deleteFirst: false, args: ['attach', 'portals'] })\n  })\n\n  it('warns that --services is ignored when attaching to a running session', () => {\n    assert.match(launchPlan('running', 'portals', ['agents']).warning ?? '', /df-dev up agents/)\n  })\n})\n"]}

package/mem-cap.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+# Run a dev process under a hard memory cap, so a runaway one is killed by its own cgroup
+# instead of driving the whole host out of memory. A V8 heap limit is not enough: most of
+# vite's memory is rolldown's native memory. No-op where systemd-run is unavailable.
+# Usage: df-mem-cap vite --port 5173      (DEV_MEMORY_MAX=4G by default)
+set -euo pipefail
+
+: "${DEV_MEMORY_MAX:=4G}"
+
+if command -v systemd-run >/dev/null 2>&1 && [ -n "${XDG_RUNTIME_DIR:-}" ] && [ -S "${XDG_RUNTIME_DIR}/systemd/private" ]; then
+  # systemd-run does not see the PATH additions of npm (node_modules/.bin)
+  cmd=$(command -v "$1") || { echo "df-mem-cap: command not found: $1" >&2; exit 127; }
+  shift
+  # inside a capped cgroup node sizes its heap from the cap (about half of it: 2.2 GB for 4G),
+  # so vite died of a V8 heap OOM long before the cgroup limit; give the heap 3/4 of the cap
+  # and leave the rest to native memory (rolldown), unless the caller already chose a size
+  if [[ "${NODE_OPTIONS:-}" != *--max-old-space-size* ]]; then
+    case "$DEV_MEMORY_MAX" in
+      *[Gg]) cap_mb=$(( ${DEV_MEMORY_MAX%[Gg]} * 1024 )) ;;
+      *[Mm]) cap_mb=${DEV_MEMORY_MAX%[Mm]} ;;
+      *) cap_mb= ;;
+    esac
+    [ -n "$cap_mb" ] && export NODE_OPTIONS="${NODE_OPTIONS:+$NODE_OPTIONS }--max-old-space-size=$(( cap_mb * 3 / 4 ))"
+  fi
+  # --collect: otherwise every OOM-killed run leaves a failed scope unit to reset by hand
+  exec systemd-run --user --scope --quiet --collect \
+    --unit="dev-$(basename "$cmd")-$$" \
+    -p MemoryMax="$DEV_MEMORY_MAX" \
+    -p MemorySwapMax=0 \
+    -- "$cmd" "$@"
+fi
+
+exec "$@"

package/mem-cap.test.d.ts

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

package/mem-cap.test.js

@@ -0,0 +1,38 @@
+import { describe, it } from 'node:test';
+import { strict as assert } from 'assert';
+import { spawnSync } from 'node:child_process';
+import { existsSync, mkdtempSync, writeFileSync, chmodSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+const script = path.join(import.meta.dirname, 'mem-cap.sh');
+const runtimeDir = process.env.XDG_RUNTIME_DIR;
+// the cap only applies with a user systemd instance: the script checks its socket
+const hasSystemd = !!runtimeDir && existsSync(path.join(runtimeDir, 'systemd/private'));
+// fake systemd-run on the PATH: prints the NODE_OPTIONS the capped command would get
+const fakeBin = () => {
+    const bin = mkdtempSync(path.join(tmpdir(), 'fakebin-'));
+    writeFileSync(path.join(bin, 'systemd-run'), '#!/usr/bin/env bash\necho "$NODE_OPTIONS"\n');
+    chmodSync(path.join(bin, 'systemd-run'), 0o755);
+    return bin;
+};
+const nodeOptions = (env) => {
+    const res = spawnSync('bash', [script, 'node', '-e', ''], {
+        env: { ...process.env, PATH: `${fakeBin()}:${process.env.PATH}`, NODE_OPTIONS: '', ...env },
+        encoding: 'utf8'
+    });
+    assert.equal(res.status, 0, res.stderr);
+    return res.stdout.trim();
+};
+describe('df-mem-cap', { skip: !hasSystemd && 'no user systemd instance' }, () => {
+    it('gives the V8 heap 3/4 of the memory cap', () => {
+        assert.equal(nodeOptions({ DEV_MEMORY_MAX: '4G' }), '--max-old-space-size=3072');
+        assert.equal(nodeOptions({ DEV_MEMORY_MAX: '1536M' }), '--max-old-space-size=1152');
+    });
+    it('keeps the other node options', () => {
+        assert.equal(nodeOptions({ DEV_MEMORY_MAX: '2G', NODE_OPTIONS: '--no-warnings' }), '--no-warnings --max-old-space-size=1536');
+    });
+    it('never overrides a heap size chosen by the caller', () => {
+        assert.equal(nodeOptions({ NODE_OPTIONS: '--max-old-space-size=1000' }), '--max-old-space-size=1000');
+    });
+});
+//# sourceMappingURL=mem-cap.test.js.map

package/mem-cap.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-cap.test.js","sourceRoot":"","sources":["mem-cap.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,QAAQ,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;AAC3D,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAA;AAC9C,kFAAkF;AAClF,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAA;AAEvF,qFAAqF;AACrF,MAAM,OAAO,GAAG,GAAG,EAAE;IACnB,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC,CAAA;IACxD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,6CAA6C,CAAC,CAAA;IAC3F,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,KAAK,CAAC,CAAA;IAC/C,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED,MAAM,WAAW,GAAG,CAAC,GAA2B,EAAE,EAAE;IAClD,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE;QACxD,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,GAAG,GAAG,EAAE;QAC3F,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAA;IACF,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACvC,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;AAC1B,CAAC,CAAA;AAED,QAAQ,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,UAAU,IAAI,0BAA0B,EAAE,EAAE,GAAG,EAAE;IAC/E,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,EAAE,2BAA2B,CAAC,CAAA;QAChF,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,EAAE,2BAA2B,CAAC,CAAA;IACrF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,EAAE,yCAAyC,CAAC,CAAA;IAC/H,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,2BAA2B,EAAE,CAAC,EAAE,2BAA2B,CAAC,CAAA;IACvG,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA","sourcesContent":["import { describe, it } from 'node:test'\nimport { strict as assert } from 'assert'\nimport { spawnSync } from 'node:child_process'\nimport { existsSync, mkdtempSync, writeFileSync, chmodSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport path from 'node:path'\n\nconst script = path.join(import.meta.dirname, 'mem-cap.sh')\nconst runtimeDir = process.env.XDG_RUNTIME_DIR\n// the cap only applies with a user systemd instance: the script checks its socket\nconst hasSystemd = !!runtimeDir && existsSync(path.join(runtimeDir, 'systemd/private'))\n\n// fake systemd-run on the PATH: prints the NODE_OPTIONS the capped command would get\nconst fakeBin = () => {\n  const bin = mkdtempSync(path.join(tmpdir(), 'fakebin-'))\n  writeFileSync(path.join(bin, 'systemd-run'), '#!/usr/bin/env bash\\necho \"$NODE_OPTIONS\"\\n')\n  chmodSync(path.join(bin, 'systemd-run'), 0o755)\n  return bin\n}\n\nconst nodeOptions = (env: Record<string, string>) => {\n  const res = spawnSync('bash', [script, 'node', '-e', ''], {\n    env: { ...process.env, PATH: `${fakeBin()}:${process.env.PATH}`, NODE_OPTIONS: '', ...env },\n    encoding: 'utf8'\n  })\n  assert.equal(res.status, 0, res.stderr)\n  return res.stdout.trim()\n}\n\ndescribe('df-mem-cap', { skip: !hasSystemd && 'no user systemd instance' }, () => {\n  it('gives the V8 heap 3/4 of the memory cap', () => {\n    assert.equal(nodeOptions({ DEV_MEMORY_MAX: '4G' }), '--max-old-space-size=3072')\n    assert.equal(nodeOptions({ DEV_MEMORY_MAX: '1536M' }), '--max-old-space-size=1152')\n  })\n\n  it('keeps the other node options', () => {\n    assert.equal(nodeOptions({ DEV_MEMORY_MAX: '2G', NODE_OPTIONS: '--no-warnings' }), '--no-warnings --max-old-space-size=1536')\n  })\n\n  it('never overrides a heap size chosen by the caller', () => {\n    assert.equal(nodeOptions({ NODE_OPTIONS: '--max-old-space-size=1000' }), '--max-old-space-size=1000')\n  })\n})\n"]}

package/optional.d.ts

@@ -0,0 +1,8 @@
+type Obj = Record<string, any>;
+/**
+ * Config overrides (dev/dev.json "optional") of the optional compose services that are not running.
+ * Exported as NODE_CONFIG by the api pane: node-config merges it over the config files, like a
+ * local-development file but without touching one the developer may already have.
+ */
+export declare const absentConfig: (optional: Record<string, Obj>, running: string[]) => Obj;
+export {};

package/optional.js

@@ -0,0 +1,21 @@
+const isObj = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+const merge = (target, source) => {
+    for (const [key, value] of Object.entries(source)) {
+        target[key] = isObj(value) && isObj(target[key]) ? merge({ ...target[key] }, value) : value;
+    }
+    return target;
+};
+/**
+ * Config overrides (dev/dev.json "optional") of the optional compose services that are not running.
+ * Exported as NODE_CONFIG by the api pane: node-config merges it over the config files, like a
+ * local-development file but without touching one the developer may already have.
+ */
+export const absentConfig = (optional, running) => {
+    const result = {};
+    for (const [service, overrides] of Object.entries(optional)) {
+        if (!running.includes(service))
+            merge(result, overrides);
+    }
+    return result;
+};
+//# sourceMappingURL=optional.js.map

package/optional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional.js","sourceRoot":"","sources":["optional.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK,GAAG,CAAC,CAAU,EAAY,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AAEhG,MAAM,KAAK,GAAG,CAAC,MAAW,EAAE,MAAW,EAAE,EAAE;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAC7F,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAA6B,EAAE,OAAiB,EAAE,EAAE;IAC/E,MAAM,MAAM,GAAQ,EAAE,CAAA;IACtB,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC1D,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA","sourcesContent":["type Obj = Record<string, any>\n\nconst isObj = (v: unknown): v is Obj => typeof v === 'object' && v !== null && !Array.isArray(v)\n\nconst merge = (target: Obj, source: Obj) => {\n  for (const [key, value] of Object.entries(source)) {\n    target[key] = isObj(value) && isObj(target[key]) ? merge({ ...target[key] }, value) : value\n  }\n  return target\n}\n\n/**\n * Config overrides (dev/dev.json \"optional\") of the optional compose services that are not running.\n * Exported as NODE_CONFIG by the api pane: node-config merges it over the config files, like a\n * local-development file but without touching one the developer may already have.\n */\nexport const absentConfig = (optional: Record<string, Obj>, running: string[]) => {\n  const result: Obj = {}\n  for (const [service, overrides] of Object.entries(optional)) {\n    if (!running.includes(service)) merge(result, overrides)\n  }\n  return result\n}\n"]}

package/optional.test.d.ts

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

package/optional.test.js

@@ -0,0 +1,24 @@
+import { describe, it } from 'node:test';
+import { strict as assert } from 'assert';
+import { absentConfig } from './optional.js';
+const optional = {
+    events: { privateEventsUrl: null },
+    clamav: { clamav: { active: false } },
+    agents: { privateAgentsUrl: null, agents: { chat: false } }
+};
+describe('absentConfig', () => {
+    it('merges the overrides of the optional services that are not running', () => {
+        assert.deepEqual(absentConfig(optional, ['mongodb', 'es', 'events']), {
+            clamav: { active: false },
+            privateAgentsUrl: null,
+            agents: { chat: false }
+        });
+    });
+    it('is empty when every optional service runs', () => {
+        assert.deepEqual(absentConfig(optional, ['events', 'clamav', 'agents']), {});
+    });
+    it('deep-merges overrides that touch the same object', () => {
+        assert.deepEqual(absentConfig({ a: { x: { one: 1 } }, b: { x: { two: 2 } } }, []), { x: { one: 1, two: 2 } });
+    });
+});
+//# sourceMappingURL=optional.test.js.map

package/optional.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional.test.js","sourceRoot":"","sources":["optional.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,QAAQ,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C,MAAM,QAAQ,GAAG;IACf,MAAM,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE;IAClC,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;IACrC,MAAM,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;CAC5D,CAAA;AAED,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE;YACpE,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;YACzB,gBAAgB,EAAE,IAAI;YACtB,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;SACxB,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;IAC/G,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA","sourcesContent":["import { describe, it } from 'node:test'\nimport { strict as assert } from 'assert'\nimport { absentConfig } from './optional.js'\n\nconst optional = {\n  events: { privateEventsUrl: null },\n  clamav: { clamav: { active: false } },\n  agents: { privateAgentsUrl: null, agents: { chat: false } }\n}\n\ndescribe('absentConfig', () => {\n  it('merges the overrides of the optional services that are not running', () => {\n    assert.deepEqual(absentConfig(optional, ['mongodb', 'es', 'events']), {\n      clamav: { active: false },\n      privateAgentsUrl: null,\n      agents: { chat: false }\n    })\n  })\n\n  it('is empty when every optional service runs', () => {\n    assert.deepEqual(absentConfig(optional, ['events', 'clamav', 'agents']), {})\n  })\n\n  it('deep-merges overrides that touch the same object', () => {\n    assert.deepEqual(absentConfig({ a: { x: { one: 1 } }, b: { x: { two: 2 } } }, []), { x: { one: 1, two: 2 } })\n  })\n})\n"]}

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "@data-fair/lib-dev",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Dev environment tooling of the data-fair services: setup, zellij session, status, logs and restart for humans and agents.",
+  "files": [
+    "**/*.js",
+    "**/*.js.map",
+    "**/*.d.ts",
+    "mem-cap.sh",
+    "worktree.sh",
+    "worktree-delete.sh",
+    "status-pane.sh"
+  ],
+  "author": "",
+  "license": "MIT",
+  "scripts": {
+    "prepublishOnly": "cd .. && npm run prepublishOnly",
+    "build": "cd .. && npm run build"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "type": "module",
+  "bin": {
+    "df-dev": "cli.js",
+    "df-mem-cap": "mem-cap.sh",
+    "df-worktree": "worktree.sh",
+    "df-worktree-delete": "worktree-delete.sh",
+    "df-status": "status-pane.sh"
+  }
+}

package/panes.d.ts

@@ -0,0 +1,18 @@
+import type { DevConfig } from './config.js';
+import { type Exec } from './exec.js';
+export declare const stripAnsi: (text: string) => string;
+export declare const tailLines: (text: string, n: number) => string;
+export declare const logs: (root: string, title: string, n: number, exec?: Exec) => string;
+export type RestartResult = {
+    ok: boolean;
+    message: string;
+    logs?: string;
+};
+export declare const checkReady: (url: string) => Promise<boolean>;
+export declare const restart: (root: string, title: string, config: DevConfig, deps?: {
+    exec?: Exec;
+    ready?: (url: string) => Promise<boolean>;
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+    env?: Record<string, string>;
+}) => Promise<RestartResult>;