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

package/worktree.sh

@@ -0,0 +1,164 @@
+#!/bin/bash
+# Create a git worktree for the given branch with full dev setup.
+#
+# Handles four cases:
+#   1. Branch is currently checked out HERE (with or without local changes):
+#      stash the changes, switch this checkout back to the main branch, move
+#      the requested branch into the worktree, then re-apply the stash inside
+#      the worktree.
+#   2. Branch exists locally but is not active here: just check it out in the
+#      worktree (e.g. coming back to a branch after a previous worktree was
+#      deleted).
+#   3. Branch exists only on origin: create a tracking local branch in the
+#      worktree.
+#   4. Brand new branch name: create from the current branch (or main if
+#      current is detached).
+
+set -e
+
+BRANCH_NAME=$1
+
+if [ -z "$BRANCH_NAME" ]; then
+    echo "Error: Please provide a branch name." >&2
+    echo "Usage: df-worktree feat-xyz" >&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 worktree goes 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 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 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}"
+ORIGIN_DIR="$PWD"
+
+# the zellij session is named after the worktree folder and its socket path is capped at 107 bytes
+# (/run/user/<uid>/zellij/contract_version_1/<session>): 60 characters leave room for the prefix
+SESSION_MAX=60
+if [ $(( ${#REPO_NAME} + 1 + ${#BRANCH_NAME} )) -gt $SESSION_MAX ]; then
+    echo "Error: branch name \"$BRANCH_NAME\" too long for this repository: the zellij session \"${REPO_NAME}_${BRANCH_NAME}\" must fit in $SESSION_MAX characters, so at most $(( SESSION_MAX - ${#REPO_NAME} - 1 )) characters for the branch" >&2
+    exit 1
+fi
+
+if [ -e "$TARGET_DIR" ]; then
+    echo "Error: $TARGET_DIR already exists."
+    echo "Run npx --no df-worktree-delete $BRANCH_NAME first if you want to recreate it."
+    exit 1
+fi
+
+# Detect main branch (main vs master) — prefer origin/HEAD, fall back to local refs
+MAIN_BRANCH=$(git symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null | sed 's|^origin/||' || true)
+if [ -z "$MAIN_BRANCH" ]; then
+    if git show-ref --verify --quiet refs/heads/main; then
+        MAIN_BRANCH=main
+    elif git show-ref --verify --quiet refs/heads/master; then
+        MAIN_BRANCH=master
+    else
+        echo "Error: could not detect main branch (neither 'main' nor 'master' found)."
+        exit 1
+    fi
+fi
+
+echo "Fetching from origin"
+git fetch origin --prune
+
+CURRENT_BRANCH=$(git branch --show-current || true)
+LOCAL_EXISTS=no
+REMOTE_EXISTS=no
+git show-ref --verify --quiet "refs/heads/$BRANCH_NAME" && LOCAL_EXISTS=yes
+git show-ref --verify --quiet "refs/remotes/origin/$BRANCH_NAME" && REMOTE_EXISTS=yes
+
+STASH_SHA=""
+STASH_RESTORED=no
+# a failure after the stash must not leave the user's changes buried in the shared stash stack
+restore_stash() {
+    local code=$?
+    if [ "$code" -ne 0 ] && [ -n "$STASH_SHA" ] && [ "$STASH_RESTORED" != yes ]; then
+        if [ "$(git -C "$ORIGIN_DIR" branch --show-current)" = "$BRANCH_NAME" ] && git -C "$ORIGIN_DIR" stash apply -q "$STASH_SHA"; then
+            drop_stash
+            echo "Error: worktree setup failed, your local changes are back in $ORIGIN_DIR" >&2
+        else
+            echo "Error: worktree setup failed, your local changes are saved in the stash $STASH_SHA: git stash apply $STASH_SHA" >&2
+        fi
+    fi
+}
+drop_stash() {
+    local ref
+    ref=$(git -C "$ORIGIN_DIR" stash list --format='%gd %H' | awk -v sha="$STASH_SHA" '$2 == sha { print $1 }')
+    [ -n "$ref" ] && git -C "$ORIGIN_DIR" stash drop -q "$ref"
+    return 0
+}
+trap restore_stash EXIT
+
+if [ "$LOCAL_EXISTS" = "yes" ] && [ "$CURRENT_BRANCH" = "$BRANCH_NAME" ]; then
+    echo "Branch '$BRANCH_NAME' is currently checked out in $PWD — migrating it to the worktree."
+    if [ -n "$(git status --porcelain)" ]; then
+        STASH_LABEL="worktree-migration-${BRANCH_NAME}-$(date +%s)"
+        echo "Stashing local changes (incl. untracked) as '$STASH_LABEL'"
+        git stash push --include-untracked --message "$STASH_LABEL"
+        # the stash stack is shared by every worktree: keep the sha, a stash@{n} index moves
+        STASH_SHA=$(git stash list --format='%H %gs' | grep -F "$STASH_LABEL" | head -1 | awk '{print $1}')
+    fi
+    echo "Switching this checkout to $MAIN_BRANCH"
+    git checkout "$MAIN_BRANCH"
+fi
+
+if [ "$LOCAL_EXISTS" = "yes" ]; then
+    echo "Reusing existing local branch '$BRANCH_NAME' in $TARGET_DIR"
+    git worktree add "$TARGET_DIR" "$BRANCH_NAME"
+elif [ "$REMOTE_EXISTS" = "yes" ]; then
+    echo "Creating local branch '$BRANCH_NAME' tracking origin/$BRANCH_NAME in $TARGET_DIR"
+    git worktree add -b "$BRANCH_NAME" --track "$TARGET_DIR" "origin/$BRANCH_NAME"
+else
+    SOURCE_BRANCH="${CURRENT_BRANCH:-$MAIN_BRANCH}"
+    echo "Creating new branch '$BRANCH_NAME' from '$SOURCE_BRANCH' in $TARGET_DIR"
+    git worktree add -b "$BRANCH_NAME" "$TARGET_DIR" "$SOURCE_BRANCH"
+fi
+
+if [ -n "$STASH_SHA" ]; then
+    echo "Re-applying stashed changes inside the worktree"
+    ( cd "$TARGET_DIR" && git stash apply "$STASH_SHA" )
+    STASH_RESTORED=yes
+    drop_stash
+fi
+
+cd "$TARGET_DIR"
+
+if [ -d "$OLDPWD/.claude" ]; then
+    echo "Copy local Claude settings"
+    mkdir -p .claude
+    for f in "$OLDPWD/.claude"/*.json; do
+        [ -f "$f" ] && cp "$f" .claude/
+    done
+fi
+
+echo "npm ci"
+npm ci
+
+echo "df-dev setup (.env, types, UI build)"
+./node_modules/.bin/df-dev setup # local bin only, never fetched from the registry
+
+echo "-----------------------------------------------"
+echo "✅ Setup Complete!"
+echo "Location: $TARGET_DIR"
+echo "Branch:   $BRANCH_NAME"
+if [ -n "$STASH_SHA" ]; then
+    echo "(Local changes from your previous checkout were migrated.)"
+fi
+echo "-----------------------------------------------"
+echo "Next step:"
+echo "   cd $TARGET_DIR && npm run dev-zellij"

package/worktree.test.d.ts

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

package/worktree.test.js

@@ -0,0 +1,145 @@
+import { describe, it } from 'node:test';
+import { strict as assert } from 'assert';
+import { spawnSync } from 'node:child_process';
+import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, realpathSync, existsSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+const script = (name) => path.join(import.meta.dirname, name);
+// git and the scripts must only see the throwaway repositories: a git hook (pre-push runs the tests)
+// exports GIT_DIR and friends, which would point every command below at the real repository
+const isolatedEnv = {
+    ...Object.fromEntries(Object.entries(process.env).filter(([key]) => !key.startsWith('GIT_'))),
+    GIT_AUTHOR_NAME: 't',
+    GIT_AUTHOR_EMAIL: 't@t',
+    GIT_COMMITTER_NAME: 't',
+    GIT_COMMITTER_EMAIL: 't@t',
+    GIT_CONFIG_GLOBAL: '/dev/null',
+    GIT_CONFIG_NOSYSTEM: '1',
+    GIT_CEILING_DIRECTORIES: tmpdir()
+};
+const run = (name, args, cwd = mkdtempSync(path.join(tmpdir(), 'wt-'))) => spawnSync('bash', [script(name), ...args], { cwd, encoding: 'utf8', env: isolatedEnv });
+const git = (cwd, ...args) => {
+    const res = spawnSync('git', args, { cwd, encoding: 'utf8', env: isolatedEnv });
+    assert.equal(res.status, 0, `git ${args.join(' ')}: ${res.stderr}`);
+    return res.stdout.trim();
+};
+// a main checkout <tmp>/<repo> cloned from a bare origin, on master with one commit
+const checkout = (repo = 'portals') => {
+    const tmp = mkdtempSync(path.join(tmpdir(), 'wt-repo-'));
+    git(tmp, 'init', '-q', '--bare', '-b', 'master', 'origin.git');
+    git(tmp, 'clone', '-q', path.join(tmp, 'origin.git'), repo);
+    const root = path.join(tmp, repo);
+    // never commit anywhere but in the throwaway clone
+    assert.equal(git(root, 'rev-parse', '--show-toplevel'), realpathSync(root));
+    writeFileSync(path.join(root, 'README.md'), 'x\n');
+    git(root, 'add', '.');
+    git(root, 'commit', '-q', '-m', 'init');
+    git(root, 'push', '-q', 'origin', 'master');
+    return { tmp, root };
+};
+describe('worktree scripts', () => {
+    for (const name of ['worktree.sh', 'worktree-delete.sh']) {
+        it(`${name} rejects a branch name with a slash`, () => {
+            const res = run(name, ['feat/x']);
+            assert.equal(res.status, 1);
+            assert.match(res.stderr, /invalid branch name "feat\/x".*no "\/"/);
+        });
+        it(`${name} rejects a branch name longer than 60 characters`, () => {
+            const res = run(name, ['a'.repeat(61)]);
+            assert.equal(res.status, 1);
+            assert.match(res.stderr, /invalid branch name/);
+        });
+    }
+    it('worktree.sh refuses a branch that makes the zellij session name too long for this repository', () => {
+        const { root } = checkout('simple-directory');
+        const res = run('worktree.sh', ['a'.repeat(50)], root);
+        assert.equal(res.status, 1);
+        assert.match(res.stderr, /zellij session .* must fit in 60 characters, so at most 43 characters/);
+    });
+    for (const name of ['worktree.sh', 'worktree-delete.sh']) {
+        it(`${name} refuses to run from a subfolder of the repository`, () => {
+            const { root } = checkout();
+            mkdirSync(path.join(root, 'api'));
+            const res = run(name, ['feat-x'], path.join(root, 'api'));
+            assert.equal(res.status, 1);
+            assert.match(res.stderr, /from the root of the repository/);
+        });
+        it(`${name} refuses to run from a linked worktree`, () => {
+            const { tmp, root } = checkout();
+            git(root, 'worktree', 'add', '-q', '-b', 'feat-a', path.join(tmp, 'portals_feat-a'));
+            const res = run(name, ['feat-x'], path.join(tmp, 'portals_feat-a'));
+            assert.equal(res.status, 1);
+            assert.match(res.stderr, /from the main checkout, not from a worktree/);
+        });
+    }
+    it('worktree.sh puts the local changes back when the setup fails after stashing them', () => {
+        const { tmp, root } = checkout();
+        git(root, 'checkout', '-q', '-b', 'feat-x');
+        writeFileSync(path.join(root, 'README.md'), 'work in progress\n');
+        writeFileSync(path.join(root, 'notes.txt'), 'untracked\n');
+        // master is checked out by another worktree: switching the main checkout back to it fails
+        git(root, 'worktree', 'add', '-q', path.join(tmp, 'portals_other'), 'master');
+        const res = run('worktree.sh', ['feat-x'], root);
+        assert.notEqual(res.status, 0);
+        assert.match(res.stderr, /your local changes are back in/);
+        assert.equal(git(root, 'branch', '--show-current'), 'feat-x');
+        assert.equal(readFileSync(path.join(root, 'README.md'), 'utf8'), 'work in progress\n');
+        assert.equal(readFileSync(path.join(root, 'notes.txt'), 'utf8'), 'untracked\n');
+        assert.equal(git(root, 'stash', 'list'), '');
+    });
+    describe('worktree-delete.sh', () => {
+        // a fake docker on PATH records its calls: the tests never touch the real one
+        const withFakeDocker = (tmp) => {
+            const bin = path.join(tmp, 'bin');
+            mkdirSync(bin);
+            writeFileSync(path.join(bin, 'docker'), `#!/bin/sh\necho "$@" >> ${path.join(tmp, 'docker-calls')}\n`, { mode: 0o755 });
+            return { ...isolatedEnv, PATH: `${bin}:${process.env.PATH}` };
+        };
+        const dockerCalls = (tmp) => existsSync(path.join(tmp, 'docker-calls')) ? readFileSync(path.join(tmp, 'docker-calls'), 'utf8') : '';
+        const worktree = (pushed) => {
+            const { tmp, root } = checkout();
+            const dir = path.join(tmp, 'portals_feat-a');
+            git(root, 'worktree', 'add', '-q', '-b', 'feat-a', dir);
+            writeFileSync(path.join(dir, 'a.txt'), 'a\n');
+            git(dir, 'add', '.');
+            git(dir, 'commit', '-q', '-m', 'a');
+            if (pushed)
+                git(dir, 'push', '-q', 'origin', 'feat-a');
+            return { tmp, root, dir, env: withFakeDocker(tmp) };
+        };
+        const del = (root, env, ...args) => spawnSync('bash', [script('worktree-delete.sh'), ...args], { cwd: root, encoding: 'utf8', env });
+        const branches = (root) => git(root, 'branch', '--format=%(refname:short)').split('\n');
+        it('deletes a worktree without a compose file, never calling docker, and its branch', () => {
+            const { tmp, root, dir, env } = worktree(true);
+            const res = del(root, env, 'feat-a');
+            assert.equal(res.status, 0, res.stderr);
+            assert.equal(existsSync(dir), false);
+            assert.deepEqual(branches(root), ['master']);
+            assert.equal(dockerCalls(tmp), '');
+        });
+        it('takes the containers down when the worktree has a compose file', () => {
+            const { tmp, root, dir, env } = worktree(true);
+            writeFileSync(path.join(dir, 'docker-compose.yml'), 'services: {}\n');
+            const res = del(root, env, 'feat-a', '-f');
+            assert.equal(res.status, 0, res.stderr);
+            assert.match(dockerCalls(tmp), /^compose --profile \* down -v --remove-orphans --rmi local$/m);
+        });
+        it('refuses unpushed commits and keeps the worktree and its branch', () => {
+            const { root, dir, env } = worktree(false);
+            const res = del(root, env, 'feat-a');
+            assert.equal(res.status, 1);
+            assert.match(res.stdout, /1 commit\(s\) not present on any origin ref/);
+            assert.equal(existsSync(dir), true);
+            assert.ok(branches(root).includes('feat-a'));
+        });
+        it('with --force, deletes an unpushed branch and prints its commit', () => {
+            const { root, dir, env } = worktree(false);
+            const sha = git(dir, 'rev-parse', '--short', 'HEAD');
+            const res = del(root, env, 'feat-a', '--force');
+            assert.equal(res.status, 0, res.stderr);
+            assert.match(res.stdout, new RegExp(`Deleting branch feat-a \\(was ${sha}\\)`));
+            assert.deepEqual(branches(root), ['master']);
+        });
+    });
+});
+//# sourceMappingURL=worktree.test.js.map

package/worktree.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.test.js","sourceRoot":"","sources":["worktree.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, it } from 'node:test'\nimport { strict as assert } from 'assert'\nimport { spawnSync } from 'node:child_process'\nimport { mkdtempSync, mkdirSync, writeFileSync, readFileSync, realpathSync, existsSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport path from 'node:path'\n\nconst script = (name: string) => path.join(import.meta.dirname, name)\n// git and the scripts must only see the throwaway repositories: a git hook (pre-push runs the tests)\n// exports GIT_DIR and friends, which would point every command below at the real repository\nconst isolatedEnv = {\n  ...Object.fromEntries(Object.entries(process.env).filter(([key]) => !key.startsWith('GIT_'))),\n  GIT_AUTHOR_NAME: 't',\n  GIT_AUTHOR_EMAIL: 't@t',\n  GIT_COMMITTER_NAME: 't',\n  GIT_COMMITTER_EMAIL: 't@t',\n  GIT_CONFIG_GLOBAL: '/dev/null',\n  GIT_CONFIG_NOSYSTEM: '1',\n  GIT_CEILING_DIRECTORIES: tmpdir()\n}\nconst run = (name: string, args: string[], cwd = mkdtempSync(path.join(tmpdir(), 'wt-'))) => spawnSync('bash', [script(name), ...args], { cwd, encoding: 'utf8', env: isolatedEnv })\n\nconst git = (cwd: string, ...args: string[]) => {\n  const res = spawnSync('git', args, { cwd, encoding: 'utf8', env: isolatedEnv })\n  assert.equal(res.status, 0, `git ${args.join(' ')}: ${res.stderr}`)\n  return res.stdout.trim()\n}\n// a main checkout <tmp>/<repo> cloned from a bare origin, on master with one commit\nconst checkout = (repo = 'portals') => {\n  const tmp = mkdtempSync(path.join(tmpdir(), 'wt-repo-'))\n  git(tmp, 'init', '-q', '--bare', '-b', 'master', 'origin.git')\n  git(tmp, 'clone', '-q', path.join(tmp, 'origin.git'), repo)\n  const root = path.join(tmp, repo)\n  // never commit anywhere but in the throwaway clone\n  assert.equal(git(root, 'rev-parse', '--show-toplevel'), realpathSync(root))\n  writeFileSync(path.join(root, 'README.md'), 'x\\n')\n  git(root, 'add', '.')\n  git(root, 'commit', '-q', '-m', 'init')\n  git(root, 'push', '-q', 'origin', 'master')\n  return { tmp, root }\n}\n\ndescribe('worktree scripts', () => {\n  for (const name of ['worktree.sh', 'worktree-delete.sh']) {\n    it(`${name} rejects a branch name with a slash`, () => {\n      const res = run(name, ['feat/x'])\n      assert.equal(res.status, 1)\n      assert.match(res.stderr, /invalid branch name \"feat\\/x\".*no \"\\/\"/)\n    })\n\n    it(`${name} rejects a branch name longer than 60 characters`, () => {\n      const res = run(name, ['a'.repeat(61)])\n      assert.equal(res.status, 1)\n      assert.match(res.stderr, /invalid branch name/)\n    })\n  }\n\n  it('worktree.sh refuses a branch that makes the zellij session name too long for this repository', () => {\n    const { root } = checkout('simple-directory')\n    const res = run('worktree.sh', ['a'.repeat(50)], root)\n    assert.equal(res.status, 1)\n    assert.match(res.stderr, /zellij session .* must fit in 60 characters, so at most 43 characters/)\n  })\n\n  for (const name of ['worktree.sh', 'worktree-delete.sh']) {\n    it(`${name} refuses to run from a subfolder of the repository`, () => {\n      const { root } = checkout()\n      mkdirSync(path.join(root, 'api'))\n      const res = run(name, ['feat-x'], path.join(root, 'api'))\n      assert.equal(res.status, 1)\n      assert.match(res.stderr, /from the root of the repository/)\n    })\n\n    it(`${name} refuses to run from a linked worktree`, () => {\n      const { tmp, root } = checkout()\n      git(root, 'worktree', 'add', '-q', '-b', 'feat-a', path.join(tmp, 'portals_feat-a'))\n      const res = run(name, ['feat-x'], path.join(tmp, 'portals_feat-a'))\n      assert.equal(res.status, 1)\n      assert.match(res.stderr, /from the main checkout, not from a worktree/)\n    })\n  }\n\n  it('worktree.sh puts the local changes back when the setup fails after stashing them', () => {\n    const { tmp, root } = checkout()\n    git(root, 'checkout', '-q', '-b', 'feat-x')\n    writeFileSync(path.join(root, 'README.md'), 'work in progress\\n')\n    writeFileSync(path.join(root, 'notes.txt'), 'untracked\\n')\n    // master is checked out by another worktree: switching the main checkout back to it fails\n    git(root, 'worktree', 'add', '-q', path.join(tmp, 'portals_other'), 'master')\n    const res = run('worktree.sh', ['feat-x'], root)\n    assert.notEqual(res.status, 0)\n    assert.match(res.stderr, /your local changes are back in/)\n    assert.equal(git(root, 'branch', '--show-current'), 'feat-x')\n    assert.equal(readFileSync(path.join(root, 'README.md'), 'utf8'), 'work in progress\\n')\n    assert.equal(readFileSync(path.join(root, 'notes.txt'), 'utf8'), 'untracked\\n')\n    assert.equal(git(root, 'stash', 'list'), '')\n  })\n\n  describe('worktree-delete.sh', () => {\n    // a fake docker on PATH records its calls: the tests never touch the real one\n    const withFakeDocker = (tmp: string) => {\n      const bin = path.join(tmp, 'bin')\n      mkdirSync(bin)\n      writeFileSync(path.join(bin, 'docker'), `#!/bin/sh\\necho \"$@\" >> ${path.join(tmp, 'docker-calls')}\\n`, { mode: 0o755 })\n      return { ...isolatedEnv, PATH: `${bin}:${process.env.PATH}` }\n    }\n    const dockerCalls = (tmp: string) => existsSync(path.join(tmp, 'docker-calls')) ? readFileSync(path.join(tmp, 'docker-calls'), 'utf8') : ''\n    const worktree = (pushed: boolean) => {\n      const { tmp, root } = checkout()\n      const dir = path.join(tmp, 'portals_feat-a')\n      git(root, 'worktree', 'add', '-q', '-b', 'feat-a', dir)\n      writeFileSync(path.join(dir, 'a.txt'), 'a\\n')\n      git(dir, 'add', '.')\n      git(dir, 'commit', '-q', '-m', 'a')\n      if (pushed) git(dir, 'push', '-q', 'origin', 'feat-a')\n      return { tmp, root, dir, env: withFakeDocker(tmp) }\n    }\n    const del = (root: string, env: NodeJS.ProcessEnv, ...args: string[]) => spawnSync('bash', [script('worktree-delete.sh'), ...args], { cwd: root, encoding: 'utf8', env })\n    const branches = (root: string) => git(root, 'branch', '--format=%(refname:short)').split('\\n')\n\n    it('deletes a worktree without a compose file, never calling docker, and its branch', () => {\n      const { tmp, root, dir, env } = worktree(true)\n      const res = del(root, env, 'feat-a')\n      assert.equal(res.status, 0, res.stderr)\n      assert.equal(existsSync(dir), false)\n      assert.deepEqual(branches(root), ['master'])\n      assert.equal(dockerCalls(tmp), '')\n    })\n\n    it('takes the containers down when the worktree has a compose file', () => {\n      const { tmp, root, dir, env } = worktree(true)\n      writeFileSync(path.join(dir, 'docker-compose.yml'), 'services: {}\\n')\n      const res = del(root, env, 'feat-a', '-f')\n      assert.equal(res.status, 0, res.stderr)\n      assert.match(dockerCalls(tmp), /^compose --profile \\* down -v --remove-orphans --rmi local$/m)\n    })\n\n    it('refuses unpushed commits and keeps the worktree and its branch', () => {\n      const { root, dir, env } = worktree(false)\n      const res = del(root, env, 'feat-a')\n      assert.equal(res.status, 1)\n      assert.match(res.stdout, /1 commit\\(s\\) not present on any origin ref/)\n      assert.equal(existsSync(dir), true)\n      assert.ok(branches(root).includes('feat-a'))\n    })\n\n    it('with --force, deletes an unpushed branch and prints its commit', () => {\n      const { root, dir, env } = worktree(false)\n      const sha = git(dir, 'rev-parse', '--short', 'HEAD')\n      const res = del(root, env, 'feat-a', '--force')\n      assert.equal(res.status, 0, res.stderr)\n      assert.match(res.stdout, new RegExp(`Deleting branch feat-a \\\\(was ${sha}\\\\)`))\n      assert.deepEqual(branches(root), ['master'])\n    })\n  })\n})\n"]}

package/zellij.d.ts

@@ -0,0 +1,19 @@
+import type { Exec } from './exec.js';
+export type SessionState = 'running' | 'exited' | 'absent';
+export type Pane = {
+    id: number;
+    title: string;
+    exited: boolean;
+    exit_status: number | null;
+    is_plugin: boolean;
+    terminal_command: string | null;
+};
+export declare const sessionName: (root: string) => string;
+export declare const parseSessions: (out: string) => Record<string, "running" | "exited">;
+export declare const sessionState: (exec: Exec, name: string) => SessionState;
+export declare const checkVersion: (exec: Exec) => void;
+export declare const requireSession: (exec: Exec, root: string) => string;
+export declare const listPanes: (exec: Exec, session: string) => Pane[];
+export declare const findPane: (exec: Exec, session: string, title: string) => Pane;
+export declare const dumpScreen: (exec: Exec, session: string, pane: Pane) => string;
+export declare const sendKeys: (exec: Exec, session: string, pane: Pane, keys: string) => void;

package/zellij.js

@@ -0,0 +1,50 @@
+import path from 'node:path';
+export const sessionName = (root) => path.basename(root);
+export const parseSessions = (out) => {
+    const sessions = {};
+    for (const line of out.split('\n')) {
+        const name = line.trim().split(/\s+/)[0];
+        if (name)
+            sessions[name] = line.includes('EXITED') ? 'exited' : 'running';
+    }
+    return sessions;
+};
+export const sessionState = (exec, name) => {
+    let out;
+    try {
+        out = exec('zellij', ['list-sessions', '--no-formatting']);
+    }
+    catch {
+        return 'absent'; // zellij exits 1 when there is no session at all
+    }
+    return parseSessions(out)[name] ?? 'absent';
+};
+// list-panes --json, dump-screen -p and send-keys -p appeared in zellij 0.44
+export const checkVersion = (exec) => {
+    const version = exec('zellij', ['--version']).trim().split(' ')[1] ?? '0.0.0';
+    const [major, minor] = version.split('.').map(Number);
+    if (major === 0 && minor < 44)
+        throw new Error(`zellij ${version} is too old, df-dev needs zellij >= 0.44`);
+};
+export const requireSession = (exec, root) => {
+    checkVersion(exec);
+    const name = sessionName(root);
+    const state = sessionState(exec, name);
+    if (state !== 'running')
+        throw new Error(`zellij session "${name}" is not running (${state}): ask the user to start it with "npm run dev-zellij"`);
+    return name;
+};
+export const listPanes = (exec, session) => JSON.parse(exec('zellij', ['--session', session, 'action', 'list-panes', '--json'])).filter(p => !p.is_plugin);
+export const findPane = (exec, session, title) => {
+    const all = listPanes(exec, session);
+    const pane = all.find(p => p.title === title);
+    if (!pane)
+        throw new Error(`no pane "${title}" in session ${session}, available panes: ${all.map(p => p.title).join(', ')}`);
+    return pane;
+};
+const paneRef = (pane) => `terminal_${pane.id}`;
+export const dumpScreen = (exec, session, pane) => exec('zellij', ['--session', session, 'action', 'dump-screen', '-p', paneRef(pane), '--full']);
+export const sendKeys = (exec, session, pane, keys) => {
+    exec('zellij', ['--session', session, 'action', 'send-keys', '-p', paneRef(pane), keys]);
+};
+//# sourceMappingURL=zellij.js.map

package/zellij.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zellij.js","sourceRoot":"","sources":["zellij.ts"],"names":[],"mappings":"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","sourcesContent":["import path from 'node:path'\nimport type { Exec } from './exec.js'\n\nexport type SessionState = 'running' | 'exited' | 'absent'\nexport type Pane = { id: number, title: string, exited: boolean, exit_status: number | null, is_plugin: boolean, terminal_command: string | null }\n\nexport const sessionName = (root: string) => path.basename(root)\n\nexport const parseSessions = (out: string) => {\n  const sessions: Record<string, 'running' | 'exited'> = {}\n  for (const line of out.split('\\n')) {\n    const name = line.trim().split(/\\s+/)[0]\n    if (name) sessions[name] = line.includes('EXITED') ? 'exited' : 'running'\n  }\n  return sessions\n}\n\nexport const sessionState = (exec: Exec, name: string): SessionState => {\n  let out: string\n  try {\n    out = exec('zellij', ['list-sessions', '--no-formatting'])\n  } catch {\n    return 'absent' // zellij exits 1 when there is no session at all\n  }\n  return parseSessions(out)[name] ?? 'absent'\n}\n\n// list-panes --json, dump-screen -p and send-keys -p appeared in zellij 0.44\nexport const checkVersion = (exec: Exec) => {\n  const version = exec('zellij', ['--version']).trim().split(' ')[1] ?? '0.0.0'\n  const [major, minor] = version.split('.').map(Number)\n  if (major === 0 && minor < 44) throw new Error(`zellij ${version} is too old, df-dev needs zellij >= 0.44`)\n}\n\nexport const requireSession = (exec: Exec, root: string) => {\n  checkVersion(exec)\n  const name = sessionName(root)\n  const state = sessionState(exec, name)\n  if (state !== 'running') throw new Error(`zellij session \"${name}\" is not running (${state}): ask the user to start it with \"npm run dev-zellij\"`)\n  return name\n}\n\nexport const listPanes = (exec: Exec, session: string): Pane[] =>\n  (JSON.parse(exec('zellij', ['--session', session, 'action', 'list-panes', '--json'])) as Pane[]).filter(p => !p.is_plugin)\n\nexport const findPane = (exec: Exec, session: string, title: string) => {\n  const all = listPanes(exec, session)\n  const pane = all.find(p => p.title === title)\n  if (!pane) throw new Error(`no pane \"${title}\" in session ${session}, available panes: ${all.map(p => p.title).join(', ')}`)\n  return pane\n}\n\nconst paneRef = (pane: Pane) => `terminal_${pane.id}`\n\nexport const dumpScreen = (exec: Exec, session: string, pane: Pane) =>\n  exec('zellij', ['--session', session, 'action', 'dump-screen', '-p', paneRef(pane), '--full'])\n\nexport const sendKeys = (exec: Exec, session: string, pane: Pane, keys: string) => {\n  exec('zellij', ['--session', session, 'action', 'send-keys', '-p', paneRef(pane), keys])\n}\n"]}

package/zellij.test.d.ts

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

package/zellij.test.js

@@ -0,0 +1,50 @@
+import { describe, it } from 'node:test';
+import { strict as assert } from 'assert';
+import { parseSessions, sessionState, requireSession, findPane, checkVersion, sessionName } from './zellij.js';
+const panes = [
+    { id: 0, title: 'status', exited: false, exit_status: null, is_plugin: false, terminal_command: 'npx --no df-dev status --watch' },
+    { id: 1, title: 'api', exited: false, exit_status: null, is_plugin: false, terminal_command: 'bash -c ...' },
+    { id: 0, title: 'tab-bar', exited: false, exit_status: null, is_plugin: true, terminal_command: null }
+];
+const fakeExec = (outputs) => (cmd, args) => {
+    const key = [cmd, ...args].join(' ');
+    const match = Object.keys(outputs).find(k => key.includes(k));
+    if (!match)
+        throw new Error(`unexpected call: ${key}`);
+    const out = outputs[match];
+    if (out instanceof Error)
+        throw out;
+    return out;
+};
+describe('zellij sessions', () => {
+    it('names the session after the worktree dir', () => {
+        assert.equal(sessionName('/home/u/Documents/portals_feat-x'), 'portals_feat-x');
+    });
+    it('parses running and exited sessions', () => {
+        const out = 'portals [Created 2m ago] (current)\nportals_feat-x [Created 1h ago] (EXITED - attach to resurrect)\n';
+        assert.deepEqual(parseSessions(out), { portals: 'running', 'portals_feat-x': 'exited' });
+    });
+    it('reports absent when zellij has no session at all', () => {
+        const exec = fakeExec({ 'list-sessions': new Error('No active zellij sessions found.') });
+        assert.equal(sessionState(exec, 'portals'), 'absent');
+    });
+    it('tells the agent to ask the user when the session is not running', () => {
+        const exec = fakeExec({ '--version': 'zellij 0.45.1', 'list-sessions': 'portals [Created 1h ago] (EXITED - attach to resurrect)\n' });
+        assert.throws(() => requireSession(exec, '/x/portals'), /not running.*npm run dev-zellij/);
+    });
+    it('refuses zellij older than 0.44', () => {
+        assert.throws(() => checkVersion(fakeExec({ '--version': 'zellij 0.40.1' })), /0\.44/);
+        checkVersion(fakeExec({ '--version': 'zellij 0.45.1' }));
+    });
+});
+describe('zellij panes', () => {
+    it('finds a terminal pane by title', () => {
+        const exec = fakeExec({ 'list-panes': JSON.stringify(panes) });
+        assert.equal(findPane(exec, 'portals', 'api').id, 1);
+    });
+    it('lists the available titles when a pane is not found', () => {
+        const exec = fakeExec({ 'list-panes': JSON.stringify(panes) });
+        assert.throws(() => findPane(exec, 'portals', 'worker'), /no pane "worker".*status, api/);
+    });
+});
+//# sourceMappingURL=zellij.test.js.map

package/zellij.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zellij.test.js","sourceRoot":"","sources":["zellij.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, it } from 'node:test'\nimport { strict as assert } from 'assert'\nimport { parseSessions, sessionState, requireSession, findPane, checkVersion, sessionName } from './zellij.js'\nimport type { Exec } from './exec.js'\n\nconst panes = [\n  { id: 0, title: 'status', exited: false, exit_status: null, is_plugin: false, terminal_command: 'npx --no df-dev status --watch' },\n  { id: 1, title: 'api', exited: false, exit_status: null, is_plugin: false, terminal_command: 'bash -c ...' },\n  { id: 0, title: 'tab-bar', exited: false, exit_status: null, is_plugin: true, terminal_command: null }\n]\n\nconst fakeExec = (outputs: Record<string, string | Error>): Exec => (cmd, args) => {\n  const key = [cmd, ...args].join(' ')\n  const match = Object.keys(outputs).find(k => key.includes(k))\n  if (!match) throw new Error(`unexpected call: ${key}`)\n  const out = outputs[match]\n  if (out instanceof Error) throw out\n  return out\n}\n\ndescribe('zellij sessions', () => {\n  it('names the session after the worktree dir', () => {\n    assert.equal(sessionName('/home/u/Documents/portals_feat-x'), 'portals_feat-x')\n  })\n\n  it('parses running and exited sessions', () => {\n    const out = 'portals [Created 2m ago] (current)\\nportals_feat-x [Created 1h ago] (EXITED - attach to resurrect)\\n'\n    assert.deepEqual(parseSessions(out), { portals: 'running', 'portals_feat-x': 'exited' })\n  })\n\n  it('reports absent when zellij has no session at all', () => {\n    const exec = fakeExec({ 'list-sessions': new Error('No active zellij sessions found.') })\n    assert.equal(sessionState(exec, 'portals'), 'absent')\n  })\n\n  it('tells the agent to ask the user when the session is not running', () => {\n    const exec = fakeExec({ '--version': 'zellij 0.45.1', 'list-sessions': 'portals [Created 1h ago] (EXITED - attach to resurrect)\\n' })\n    assert.throws(() => requireSession(exec, '/x/portals'), /not running.*npm run dev-zellij/)\n  })\n\n  it('refuses zellij older than 0.44', () => {\n    assert.throws(() => checkVersion(fakeExec({ '--version': 'zellij 0.40.1' })), /0\\.44/)\n    checkVersion(fakeExec({ '--version': 'zellij 0.45.1' }))\n  })\n})\n\ndescribe('zellij panes', () => {\n  it('finds a terminal pane by title', () => {\n    const exec = fakeExec({ 'list-panes': JSON.stringify(panes) })\n    assert.equal(findPane(exec, 'portals', 'api').id, 1)\n  })\n\n  it('lists the available titles when a pane is not found', () => {\n    const exec = fakeExec({ 'list-panes': JSON.stringify(panes) })\n    assert.throws(() => findPane(exec, 'portals', 'worker'), /no pane \"worker\".*status, api/)\n  })\n})\n"]}