gitspace 0.2.0-rc.20 → 0.2.0-rc.21

package/src/lib/processes/config.ts

@@ -1,187 +0,0 @@
-/**
- * Process config loader (repo workspace only)
- */
-
-import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
-import type { ProcessesConfig, ProcessDefinition, ProcessInstanceSpec } from '../../types/processes.js';
-import { validateProcessesConfig } from './schema.js';
-import { normalizeProcessInstanceCount } from './instances.js';
-
-export interface ProcessesConfigLoadResult {
-  config: ProcessesConfig;
-  error: string | null;
-}
-
-function stripJsoncComments(input: string): string {
-  let result = '';
-  let inString = false;
-  let escaped = false;
-  let inLineComment = false;
-  let inBlockComment = false;
-
-  for (let i = 0; i < input.length; i += 1) {
-    const ch = input[i];
-    const next = input[i + 1];
-
-    if (inLineComment) {
-      if (ch === '\n') {
-        inLineComment = false;
-        result += ch;
-      }
-      continue;
-    }
-
-    if (inBlockComment) {
-      if (ch === '*' && next === '/') {
-        inBlockComment = false;
-        i += 1;
-      }
-      continue;
-    }
-
-    if (inString) {
-      result += ch;
-      if (escaped) {
-        escaped = false;
-      } else if (ch === '\\') {
-        escaped = true;
-      } else if (ch === '"') {
-        inString = false;
-      }
-      continue;
-    }
-
-    if (ch === '"') {
-      inString = true;
-      result += ch;
-      continue;
-    }
-
-    if (ch === '/' && next === '/') {
-      inLineComment = true;
-      i += 1;
-      continue;
-    }
-
-    if (ch === '/' && next === '*') {
-      inBlockComment = true;
-      i += 1;
-      continue;
-    }
-
-    result += ch;
-  }
-
-  return result;
-}
-
-function stripJsonTrailingCommas(input: string): string {
-  let result = '';
-  let inString = false;
-  let escaped = false;
-
-  for (let i = 0; i < input.length; i += 1) {
-    const ch = input[i];
-
-    if (inString) {
-      result += ch;
-      if (escaped) {
-        escaped = false;
-      } else if (ch === '\\') {
-        escaped = true;
-      } else if (ch === '"') {
-        inString = false;
-      }
-      continue;
-    }
-
-    if (ch === '"') {
-      inString = true;
-      result += ch;
-      continue;
-    }
-
-    if (ch === ',') {
-      let j = i + 1;
-      while (j < input.length && /\s/.test(input[j])) {
-        j += 1;
-      }
-      const nextNonWhitespace = input[j];
-      if (nextNonWhitespace === '}' || nextNonWhitespace === ']') {
-        continue;
-      }
-    }
-
-    result += ch;
-  }
-
-  return result;
-}
-
-function parseJsonc(raw: string): unknown {
-  const withoutComments = stripJsoncComments(raw);
-  const withoutTrailingCommas = stripJsonTrailingCommas(withoutComments);
-  return JSON.parse(withoutTrailingCommas);
-}
-
-export function getProcessesConfigPath(workspacePath: string): string {
-  return join(workspacePath, '.gitspace', 'processes.json');
-}
-
-export function loadProcessesConfigWithDiagnostics(workspacePath: string): ProcessesConfigLoadResult {
-  const path = getProcessesConfigPath(workspacePath);
-  if (!existsSync(path)) {
-    return { config: { processes: [] }, error: null };
-  }
-
-  const raw = readFileSync(path, 'utf-8').trim();
-  if (!raw) {
-    return { config: { processes: [] }, error: null };
-  }
-
-  let parsed: ProcessesConfig;
-  try {
-    parsed = parseJsonc(raw) as ProcessesConfig;
-  } catch (error) {
-    const message = error instanceof Error ? error.message : 'invalid JSONC';
-    return {
-      config: { processes: [] },
-      error: `Failed to parse .gitspace/processes.json: ${message}`,
-    };
-  }
-
-  const normalized: ProcessesConfig = {
-    processes: Array.isArray(parsed.processes) ? parsed.processes : [],
-  };
-  const validation = validateProcessesConfig(normalized);
-  if (!validation.valid) {
-    return {
-      config: normalized,
-      error: `Invalid .gitspace/processes.json: ${validation.errors.join(', ')}`,
-    };
-  }
-  return { config: normalized, error: null };
-}
-
-export function loadProcessesConfig(workspacePath: string): ProcessesConfig {
-  return loadProcessesConfigWithDiagnostics(workspacePath).config;
-}
-
-export function getProcessInstances(config: ProcessesConfig): ProcessInstanceSpec[] {
-  const instances: ProcessInstanceSpec[] = [];
-  for (const process of config.processes) {
-    const count = normalizeProcessInstanceCount(process.instances);
-    for (let idx = 1; idx <= count; idx++) {
-      instances.push({ name: process.name, instance: idx, definition: process });
-    }
-  }
-  return instances;
-}
-
-export function getProcessDefinition(
-  config: ProcessesConfig,
-  name: string
-): ProcessDefinition | null {
-  return config.processes.find((process) => process.name === name) ?? null;
-}

package/src/lib/processes/control.ts

@@ -1,53 +0,0 @@
-/**
- * Process control helpers (disable/enable restarts)
- */
-
-import { existsSync, mkdirSync, rmSync, writeFileSync } from 'fs';
-import { join } from 'path';
-import { encodeProcessNameForPath } from './names.js';
-
-export function getProcessControlDir(workspacePath: string): string {
-  return join(workspacePath, '.gitspace', '.processes');
-}
-
-export function getProcessDisableDir(workspacePath: string): string {
-  return join(getProcessControlDir(workspacePath), 'disabled');
-}
-
-export function getProcessDisablePath(
-  workspacePath: string,
-  name: string,
-  instance: number
-): string {
-  return join(getProcessDisableDir(workspacePath), `${encodeProcessNameForPath(name)}-${instance}`);
-}
-
-export function disableProcessRestart(
-  workspacePath: string,
-  name: string,
-  instance: number
-): void {
-  const dir = getProcessDisableDir(workspacePath);
-  mkdirSync(dir, { recursive: true });
-  const file = getProcessDisablePath(workspacePath, name, instance);
-  writeFileSync(file, new Date().toISOString(), 'utf-8');
-}
-
-export function enableProcessRestart(
-  workspacePath: string,
-  name: string,
-  instance: number
-): void {
-  const file = getProcessDisablePath(workspacePath, name, instance);
-  if (existsSync(file)) {
-    rmSync(file, { force: true });
-  }
-}
-
-export function isProcessRestartDisabled(
-  workspacePath: string,
-  name: string,
-  instance: number
-): boolean {
-  return existsSync(getProcessDisablePath(workspacePath, name, instance));
-}

package/src/lib/processes/editor.ts

@@ -1,32 +0,0 @@
-export const PROCESSES_CONFIG_TEMPLATE = [
-  '{',
-  '  // Managed process definitions for this workspace.',
-  '  // Uncomment and edit the example below, then save and exit.',
-  '  "processes": [',
-  '    // {',
-  '    //   "name": "web",',
-  '    //   "command": "bun",',
-  '    //   "args": ["run", "dev"],',
-  '    //   "autostart": false',
-  '    // }',
-  '  ]',
-  '}',
-  '',
-].join('\n');
-
-export function buildEditProcessesCommand(): { command: string; args: string[] } {
-  const shellScript = [
-    'mkdir -p .gitspace',
-    'if [ ! -f .gitspace/processes.json ]; then',
-    "  cat > .gitspace/processes.json <<'JSONC'",
-    PROCESSES_CONFIG_TEMPLATE,
-    'JSONC',
-    'fi',
-    'exec "${EDITOR:-vi}" .gitspace/processes.json',
-  ].join('\n');
-
-  return {
-    command: 'sh',
-    args: ['-c', shellScript],
-  };
-}

package/src/lib/processes/events-config.ts

@@ -1,37 +0,0 @@
-/**
- * Process-level events config overrides
- */
-
-import type { EventsConfig } from '../../types/config.js';
-import type { ProcessDefinition } from '../../types/processes.js';
-import { getProjectEventsConfig } from '../../core/config.js';
-
-export function buildProcessEventsConfig(
-  projectName: string,
-  definition?: ProcessDefinition
-): EventsConfig {
-  const baseConfig = getProjectEventsConfig(projectName);
-
-  if (!definition?.events) {
-    return baseConfig;
-  }
-
-  let merged: EventsConfig = {
-    ...baseConfig,
-    ...definition.events,
-    fields: {
-      ...baseConfig.fields,
-      ...(definition.events?.fields || {}),
-    },
-    rotation: {
-      ...baseConfig.rotation,
-      ...(definition.events?.rotation || {}),
-    },
-  };
-
-  if (definition.events.enabled === false) {
-    merged = { ...merged, enabled: false };
-  }
-
-  return merged;
-}

package/src/lib/processes/index.ts

@@ -1,14 +0,0 @@
-/**
- * Process manager exports
- */
-
-export * from './config.js';
-export * from './manager.js';
-export * from './watchdog.js';
-export * from './scheduler.js';
-export * from './autostart.js';
-export * from './registry.js';
-export * from './names.js';
-export * from './events-config.js';
-export * from './schema.js';
-export * from './control.js';

package/src/lib/processes/instances.ts

@@ -1,20 +0,0 @@
-/**
- * Normalize configured process instance count.
- *
- * Semantics:
- * - undefined/null => 1
- * - 0 => disabled process definition
- * - positive integers => exact instance count
- * - invalid/non-integer values => 1 (defensive fallback)
- */
-export function normalizeProcessInstanceCount(instances?: number): number {
-  if (instances === undefined || instances === null) {
-    return 1;
-  }
-
-  if (!Number.isInteger(instances)) {
-    return 1;
-  }
-
-  return Math.max(0, instances);
-}

package/src/lib/processes/manager.ts

@@ -1,131 +0,0 @@
-/**
- * Workspace process manager
- */
-
-import { join } from 'path';
-import { listSessions, createSession, killSession } from '../tmux-lite/cli.js';
-import type { ProcessInstanceSpec, ProcessDefinition, ProcessesConfig } from '../../types/processes.js';
-import { getProcessInstances, loadProcessesConfig } from './config.js';
-import { buildProcessSessionName, parseProcessSessionName } from './names.js';
-import { enableProcessRestart, disableProcessRestart } from './control.js';
-import { markProcessStarted, clearProcessExit } from './state.js';
-
-export interface ProcessSessionInfo {
-  sessionId: string;
-  name: string;
-  workspacePath: string;
-  processName: string;
-  instance: number;
-}
-
-export interface ProcessRunResult {
-  sessionId: string;
-  created: boolean;
-}
-
-export async function listProcessSessions(workspacePath: string): Promise<ProcessSessionInfo[]> {
-  const sessions = await listSessions();
-  const isWorkspaceMatch = (cwd: string) => cwd === workspacePath || cwd.startsWith(`${workspacePath}/`);
-  return sessions
-    .filter((session) => session.name.startsWith('proc:'))
-    .map((session) => {
-      const parsed = parseProcessSessionName(session.name);
-      if (!parsed) return null;
-      return {
-        sessionId: session.id,
-        name: session.name,
-        workspacePath: session.cwd,
-        processName: parsed.processName,
-        instance: parsed.instance,
-      };
-    })
-    .filter((item): item is ProcessSessionInfo => Boolean(item))
-    .filter((item) => isWorkspaceMatch(item.workspacePath));
-}
-
-export function loadWorkspaceProcesses(workspacePath: string): ProcessesConfig {
-  return loadProcessesConfig(workspacePath);
-}
-
-export async function startProcessInstance(
-  workspacePath: string,
-  spec: ProcessInstanceSpec
-): Promise<ProcessRunResult> {
-  const existing = await listProcessSessions(workspacePath);
-  const target = existing.find(
-    (item) => item.processName === spec.name && item.instance === spec.instance
-  );
-
-  if (target) {
-    enableProcessRestart(workspacePath, spec.name, spec.instance);
-    markProcessStarted(workspacePath, spec.name, spec.instance);
-    clearProcessExit(workspacePath, spec.name, spec.instance);
-    return { sessionId: target.sessionId, created: false };
-  }
-
-  if (!spec.definition.command) {
-    throw new Error(`Process ${spec.name} is missing a command`);
-  }
-
-  const workspaceId = workspacePath.split('/').pop() ?? workspacePath;
-  const sessionName = buildProcessSessionName(workspaceId, spec.name, spec.instance);
-  const cwd = spec.definition.cwd
-    ? join(workspacePath, spec.definition.cwd)
-    : workspacePath;
-
-  const runnerArgs = [
-    "--internal-process-runner",
-    "--workspace",
-    workspacePath,
-    "--process",
-    spec.name,
-    "--instance",
-    String(spec.instance),
-  ];
-
-  const devScript = process.execPath.endsWith('bun')
-    ? [join(import.meta.dir, "../../index.ts"), ...runnerArgs]
-    : runnerArgs;
-
-  const session = await createSession(sessionName, cwd, {
-    command: process.execPath,
-    args: devScript,
-    env: spec.definition.env,
-  });
-
-  enableProcessRestart(workspacePath, spec.name, spec.instance);
-  markProcessStarted(workspacePath, spec.name, spec.instance);
-  clearProcessExit(workspacePath, spec.name, spec.instance);
-
-  return { sessionId: session.id, created: true };
-}
-
-export async function stopProcessInstance(
-  workspacePath: string,
-  spec: ProcessInstanceSpec
-): Promise<void> {
-  const sessions = await listProcessSessions(workspacePath);
-  const target = sessions.find(
-    (item) => item.processName === spec.name && item.instance === spec.instance
-  );
-  if (!target) return;
-  disableProcessRestart(workspacePath, spec.name, spec.instance);
-  clearProcessExit(workspacePath, spec.name, spec.instance);
-  await killSession(target.sessionId);
-}
-
-export function getRestartConfig(definition: ProcessDefinition) {
-  return {
-    policy: definition.restart?.policy ?? 'never',
-    maxAttempts: definition.restart?.maxAttempts ?? 5,
-    backoffMs: definition.restart?.backoffMs ?? 2000,
-    maxBackoffMs: definition.restart?.maxBackoffMs ?? 30000,
-  };
-}
-
-export function getProcessSpecs(workspacePath: string): ProcessInstanceSpec[] {
-  const config = loadProcessesConfig(workspacePath);
-  return getProcessInstances(config);
-}
-
-export { buildProcessSessionName, parseProcessSessionName } from './names.js';

package/src/lib/processes/names.ts

@@ -1,71 +0,0 @@
-/**
- * Process session naming helpers
- */
-
-export const PROCESS_SESSION_PREFIX = 'proc';
-export const PROCESS_SESSION_MAX_NAME = 64;
-
-/**
- * Encode a process name for use as a single filesystem path segment.
- */
-export function encodeProcessNameForPath(processName: string): string {
-  return encodeURIComponent(processName);
-}
-
-export function buildProcessSessionName(
-  workspaceId: string,
-  processName: string,
-  instance: number
-): string {
-  const instancePart = String(instance);
-  const prefix = `${PROCESS_SESSION_PREFIX}:`;
-  let workspacePart = workspaceId;
-  let processPart = processName;
-
-  const build = () => `${prefix}${workspacePart}:${processPart}:${instancePart}`;
-
-  let candidate = build();
-  if (candidate.length <= PROCESS_SESSION_MAX_NAME) {
-    return candidate;
-  }
-
-  const maxWorkspaceLength = Math.max(
-    1,
-    PROCESS_SESSION_MAX_NAME - (prefix.length + 2 + instancePart.length + processPart.length)
-  );
-  if (workspacePart.length > maxWorkspaceLength) {
-    workspacePart = workspacePart.slice(0, maxWorkspaceLength);
-    candidate = build();
-  }
-
-  if (candidate.length > PROCESS_SESSION_MAX_NAME) {
-    const maxProcessLength = Math.max(
-      1,
-      PROCESS_SESSION_MAX_NAME - (prefix.length + 2 + instancePart.length + workspacePart.length)
-    );
-    processPart = processPart.slice(0, maxProcessLength);
-    candidate = build();
-  }
-
-  return candidate;
-}
-
-/**
- * Parse a process session name in the format:
- * `proc:<workspaceId>:<processName>:<instance>`
- *
- * Note: `<workspaceId>` and `<processName>` must not contain `:`.
- */
-export function parseProcessSessionName(name: string): {
-  workspaceId: string;
-  processName: string;
-  instance: number;
-} | null {
-  if (!name.startsWith(`${PROCESS_SESSION_PREFIX}:`)) return null;
-  const parts = name.split(':');
-  if (parts.length < 4) return null;
-  const [, workspaceId, processName, instanceRaw] = parts;
-  const instance = Number(instanceRaw);
-  if (!workspaceId || !processName || Number.isNaN(instance)) return null;
-  return { workspaceId, processName, instance };
-}

package/src/lib/processes/registry.ts

@@ -1,26 +0,0 @@
-/**
- * Process registry helpers
- */
-
-import { join } from 'path';
-import type { ProcessDefinition, ProcessInstanceSpec } from '../../types/processes.js';
-import { loadProcessesConfig, getProcessInstances } from './config.js';
-
-export interface WorkspaceProcessRegistry {
-  workspacePath: string;
-  processes: ProcessDefinition[];
-  instances: ProcessInstanceSpec[];
-}
-
-export function loadProcessRegistry(workspacePath: string): WorkspaceProcessRegistry {
-  const config = loadProcessesConfig(workspacePath);
-  return {
-    workspacePath,
-    processes: config.processes,
-    instances: getProcessInstances(config),
-  };
-}
-
-export function resolveProcessCwd(workspacePath: string, cwd?: string): string {
-  return cwd ? join(workspacePath, cwd) : workspacePath;
-}