000_agent_foundation

Agent 0: Foundation

Plan Location: plans/0049-persistent-http-server/0049-persistent-http-server-plan.md

Scope

Features: #1, #2, #3, #7 Own: src/server-shared.ts, src/pidfile.ts, config additions Depend on: Nothing Block: Agent 1 waiting on shared init, config, PID file, extension preloading

Interfaces

Export

// #1 — server-shared.ts (CREATE)
export interface SharedResources {
  config: ServerConfig;
  configPath: string;
  db: DatabaseType;
  watcher: LimpsWatcher | null;
  loadedExtensions: LoadedExtension[];
}
export async function initializeSharedResources(configPathArg?: string): Promise<SharedResources>;
export async function cleanupSharedResources(resources: SharedResources): Promise<void>;

// #2 — config.ts (MODIFY)
// Add to ServerConfig:
//   server?: { port?: number; host?: string; }
export const DEFAULT_SERVER_PORT = 4269;
export const DEFAULT_SERVER_HOST = '127.0.0.1';
export function getServerPort(config: ServerConfig): number;
export function getServerHost(config: ServerConfig): string;

// #3 — pidfile.ts (CREATE)
export interface PidFileData { pid: number; port: number; startedAt: string; configPath: string; }
export function getPidFilePath(dataPath: string): string;
export function writePidFile(dataPath: string, data: PidFileData): void;
export function readPidFile(dataPath: string): PidFileData | null;
export function removePidFile(dataPath: string): void;
export function isServerRunning(dataPath: string): { running: boolean; data: PidFileData | null };

// #7 — server.ts (MODIFY)
export async function createServer(
  config: ServerConfig, db: DatabaseType, preloadedExtensions?: LoadedExtension[]
): Promise<McpServer & { loadedExtensions?: LoadedExtension[] }>;

Features

#1: Extract shared initialization

TL;DR: Extract init logic from server-main.ts into reusable server-shared.ts. Status: GAP Files: src/server-shared.ts (create), src/server-main.ts (modify)

Current server-main.ts lines 39-179 contain all init: config resolve → load → mkdirSync → initializeDatabase → createSchema → indexAllPaths → checkFdBudget → startWatcher. Extract lines 59-162 into initializeSharedResources().