mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-10-02 13:39:41 +02:00
Codeman maintainer
64c8048dda
The socket name was computed inside tmux-manager, which the TUI cannot import just to learn which `-L` name its degraded-mode listing belongs on (that module is the server's tmux driver, not a lookup table). The resolver moves next to `dataPath()`, where the other half of the instance identity already lives, so both processes agree by construction instead of by a copied default. Behaviour is unchanged: the override still wins only when it is a name that can be passed to `tmux -L` safely, and TmuxManager keeps warning about one that cannot. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
82 lines
3.4 KiB
TypeScript
82 lines
3.4 KiB
TypeScript
/**
|
|
* @fileoverview Per-instance isolation: data directory + tmux socket.
|
|
*
|
|
* Codeman keeps all runtime state under `~/.codeman` and runs its tmux sessions
|
|
* on a dedicated socket (`tmux -L codeman`). Both are PROCESS-WIDE and SHARED by
|
|
* every Codeman instance on the machine — so a second instance pointed at the
|
|
* same socket will discover and attach to the first instance's live sessions,
|
|
* and two instances sharing `~/.codeman/state.json` will clobber each other.
|
|
*
|
|
* To let a beta build coexist with a production one, this module derives both
|
|
* the data dir and the tmux socket from a single "instance" name:
|
|
* - default (unset/empty) → `~/.codeman` + `tmux -L codeman` (prod layout)
|
|
* - `CODEMAN_INSTANCE=beta` → `~/.codeman-beta` + `tmux -L codeman-beta`
|
|
* - `CODEMAN_INSTANCE=foo` → `~/.codeman-foo` + `tmux -L codeman-foo`
|
|
*
|
|
* The DEFAULT is the production layout so this is safe to ship to master: an
|
|
* existing install keeps reading `~/.codeman`. To run a beta ALONGSIDE prod,
|
|
* launch it with `CODEMAN_INSTANCE=beta` (and a distinct port, see below) —
|
|
* `scripts/run-beta.sh` does both. The port is unrelated to the instance and is
|
|
* set separately via `--port` / `CODEMAN_PORT` (see `src/cli.ts`).
|
|
*
|
|
* Individual overrides still win: `CODEMAN_DATA_DIR` (absolute data dir) and
|
|
* `CODEMAN_TMUX_SOCKET` (socket name, validated in tmux-manager).
|
|
*/
|
|
|
|
import { homedir } from 'node:os';
|
|
import { join } from 'node:path';
|
|
import { mkdirSync } from 'node:fs';
|
|
|
|
/**
|
|
* Instance name. Empty string (the default) = production layout (`~/.codeman`,
|
|
* `-L codeman`), so this is safe on master and existing installs are untouched.
|
|
* Set `CODEMAN_INSTANCE=beta` (e.g. via `scripts/run-beta.sh`) to run an
|
|
* isolated beta alongside prod.
|
|
*/
|
|
export const CODEMAN_INSTANCE = process.env.CODEMAN_INSTANCE ?? '';
|
|
|
|
const INSTANCE_SUFFIX = CODEMAN_INSTANCE ? `-${CODEMAN_INSTANCE}` : '';
|
|
|
|
/** Default tmux socket for this instance. `CODEMAN_TMUX_SOCKET` still overrides. */
|
|
export const DEFAULT_TMUX_SOCKET = `codeman${INSTANCE_SUFFIX}`;
|
|
|
|
/** Characters tmux accepts in a `-L` socket name. */
|
|
export const SAFE_TMUX_SOCKET_PATTERN = /^[a-zA-Z0-9_.-]+$/;
|
|
|
|
/**
|
|
* This instance's tmux socket: the `CODEMAN_TMUX_SOCKET` override when it is a
|
|
* safe name, else the instance default. Every process that runs `tmux -L` has
|
|
* to resolve it through here (the server via TmuxManager, the TUI for its
|
|
* degraded-mode listing), or a beta instance ends up driving prod's sessions.
|
|
*/
|
|
export function resolveTmuxSocketName(): string {
|
|
const raw = process.env.CODEMAN_TMUX_SOCKET;
|
|
if (raw !== undefined && SAFE_TMUX_SOCKET_PATTERN.test(raw)) return raw;
|
|
return DEFAULT_TMUX_SOCKET;
|
|
}
|
|
|
|
let _ensured = false;
|
|
|
|
/**
|
|
* Absolute path to this instance's data directory (created on first use). All
|
|
* persisted state (`state.json`, `mux-sessions.json`, settings, push keys,
|
|
* lifecycle log, screenshots, certs, …) lives here.
|
|
*/
|
|
export function getDataDir(): string {
|
|
const dir = process.env.CODEMAN_DATA_DIR || join(homedir(), `.codeman${INSTANCE_SUFFIX}`);
|
|
if (!_ensured) {
|
|
try {
|
|
mkdirSync(dir, { recursive: true });
|
|
_ensured = true;
|
|
} catch {
|
|
/* best-effort; individual writers also mkdir as needed */
|
|
}
|
|
}
|
|
return dir;
|
|
}
|
|
|
|
/** Join one or more segments onto this instance's data directory. */
|
|
export function dataPath(...segments: string[]): string {
|
|
return join(getDataDir(), ...segments);
|
|
}
|