cokit-cli 1.0.8 → 1.0.9

package/skills/ck-markdown-novel-viewer/scripts/lib/plan-navigator.cjs

@@ -1,509 +0,0 @@
-/**
- * Plan navigation system - detects plan structure and generates navigation
- * Enables sidebar navigation for multi-phase plans
- */
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * Detect if a file is part of a plan directory
- * @param {string} filePath - Path to markdown file
- * @returns {{isPlan: boolean, planDir: string, planFile: string, phases: Array}}
- */
-function detectPlan(filePath) {
-  const dir = path.dirname(filePath);
-  const planFile = path.join(dir, 'plan.md');
-
-  if (!fs.existsSync(planFile)) {
-    return { isPlan: false };
-  }
-
-  // Find all phase files
-  const files = fs.readdirSync(dir);
-  const phases = files
-    .filter(f => f.startsWith('phase-') && f.endsWith('.md'))
-    .sort((a, b) => {
-      // Sort by phase number
-      const numA = parseInt(a.match(/phase-(\d+)/)?.[1] || '0', 10);
-      const numB = parseInt(b.match(/phase-(\d+)/)?.[1] || '0', 10);
-      return numA - numB;
-    });
-
-  return {
-    isPlan: true,
-    planDir: dir,
-    planFile,
-    phases: phases.map(f => path.join(dir, f))
-  };
-}
-
-/**
- * Normalize status string to standard format
- * @param {string} raw - Raw status text
- * @returns {string} - Normalized status (completed, in-progress, pending)
- */
-function normalizeStatus(raw) {
-  const s = (raw || '').toLowerCase().trim();
-  // Match various completed indicators
-  if (s.includes('complete') || s.includes('done') || s.includes('✓') || s.includes('✅')) {
-    return 'completed';
-  }
-  // Match in-progress indicators
-  if (s.includes('progress') || s.includes('active') || s.includes('wip') || s.includes('🔄')) {
-    return 'in-progress';
-  }
-  return 'pending';
-}
-
-/**
- * Generate a slug from text for use as anchor ID
- * @param {string} text - Text to slugify
- * @returns {string} - URL-safe slug
- */
-function slugify(text) {
-  return text
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '-')
-    .replace(/^-|-$/g, '');
-}
-
-/**
- * Parse plan.md to extract phase metadata from table
- * Supports multiple table formats:
- * 1. Standard: | Phase | Name | Status | [Link](path) |
- * 2. Link-first: | [Phase X](path) | Description | Status | ... |
- * 3. Heading-based: ### Phase X: Name with - Status: XXX
- * @param {string} planFilePath - Path to plan.md
- * @returns {Array<{phase: number, name: string, status: string, file: string, anchor: string}>}
- */
-function parsePlanTable(planFilePath) {
-  const content = fs.readFileSync(planFilePath, 'utf8');
-  const dir = path.dirname(planFilePath);
-  const phases = [];
-
-  // Format 1: Standard table | Phase | Name | Status | [Link](path) |
-  const standardRegex = /\|\s*(\d+)\s*\|\s*([^|]+)\s*\|\s*([^|]+)\s*\|\s*\[([^\]]+)\]\(([^)]+)\)/g;
-  let match;
-  while ((match = standardRegex.exec(content)) !== null) {
-    const [, phase, name, status, linkText, linkPath] = match;
-    phases.push({
-      phase: parseInt(phase, 10),
-      name: name.trim(),
-      status: normalizeStatus(status),
-      file: path.resolve(dir, linkPath),
-      linkText: linkText.trim()
-    });
-  }
-
-  // Format 2: Link-first table | [Phase X](path) | Description | Status | ... |
-  // Matches: | [Phase 1](phase-01-xxx.md) | Description | ✓ Complete | 4h |
-  if (phases.length === 0) {
-    const linkFirstRegex = /\|\s*\[(?:Phase\s*)?(\d+)\]\(([^)]+)\)\s*\|\s*([^|]+)\s*\|\s*([^|]+)/g;
-    while ((match = linkFirstRegex.exec(content)) !== null) {
-      const [, phase, linkPath, name, status] = match;
-      phases.push({
-        phase: parseInt(phase, 10),
-        name: name.trim(),
-        status: normalizeStatus(status),
-        file: path.resolve(dir, linkPath),
-        linkText: `Phase ${phase}`
-      });
-    }
-  }
-
-  // Format 2b: Number-first with link in col 2: | 1 | [Name](path) | Status | ... |
-  // Matches: | 1 | [Tab Structure](./phase-01-xxx.md) | Pending | High | 4h |
-  if (phases.length === 0) {
-    const numLinkRegex = /\|\s*(\d+)\s*\|\s*\[([^\]]+)\]\(([^)]+)\)\s*\|\s*([^|]+)/g;
-    while ((match = numLinkRegex.exec(content)) !== null) {
-      const [, phase, name, linkPath, status] = match;
-      phases.push({
-        phase: parseInt(phase, 10),
-        name: name.trim(),
-        status: normalizeStatus(status),
-        file: path.resolve(dir, linkPath),
-        linkText: name.trim()
-      });
-    }
-  }
-
-  // Format 2c: Simple table without links: | Phase | Description | Status |
-  // Matches: | 01 | Backend: Install deps | Completed ✅ |
-  if (phases.length === 0) {
-    const simpleTblRegex = /\|\s*0?(\d+)\s*\|\s*([^|]+)\s*\|\s*([^|]+)\s*\|/g;
-    while ((match = simpleTblRegex.exec(content)) !== null) {
-      const [fullMatch, phase, name, status] = match;
-      // Skip header rows and separator rows
-      if (name.trim().toLowerCase() === 'description' || name.trim().toLowerCase() === 'name') continue;
-      if (name.includes('---') || name.includes('===')) continue;
-      const phaseNum = parseInt(phase, 10);
-      phases.push({
-        phase: phaseNum,
-        name: name.trim(),
-        status: normalizeStatus(status),
-        file: planFilePath,
-        linkText: name.trim(),
-        anchor: `phase-${String(phaseNum).padStart(2, '0')}-${slugify(name.trim())}`
-      });
-    }
-  }
-
-  // Format 3: Heading-based phases (### Phase X: Name with - Status: XXX)
-  if (phases.length === 0) {
-    const contentLines = content.split('\n');
-    let currentPhase = null;
-
-    for (let i = 0; i < contentLines.length; i++) {
-      const line = contentLines[i];
-      const headingMatch = /###\s*Phase\s*(\d+)[:\s]+(.+)/i.exec(line);
-      if (headingMatch) {
-        if (currentPhase) phases.push(currentPhase);
-        const phaseNum = parseInt(headingMatch[1], 10);
-        const phaseName = headingMatch[2].trim();
-        currentPhase = {
-          phase: phaseNum,
-          name: phaseName,
-          status: 'pending',
-          file: planFilePath,
-          linkText: `Phase ${phaseNum}`,
-          anchor: `phase-${String(phaseNum).padStart(2, '0')}-${slugify(phaseName)}`
-        };
-      }
-      // Look for status in subsequent lines
-      if (currentPhase) {
-        const statusMatch = /-\s*Status:\s*(.+)/i.exec(line);
-        if (statusMatch) {
-          currentPhase.status = normalizeStatus(statusMatch[1]);
-        }
-      }
-    }
-    if (currentPhase) phases.push(currentPhase);
-  }
-
-  // Format 4: Bullet-list phases with nested File: references (check early - specific pattern)
-  // Matches:
-  // - Phase 01: Name ✅ (date)
-  //   - File: `phase-01-name.md`
-  //   - Completed: date
-  // Check if content has this specific pattern before proceeding
-  if (phases.length === 0 && /^-\s*Phase\s*\d+[:\s]/m.test(content)) {
-    const lines = content.split('\n');
-    let currentPhase = null;
-
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i];
-
-      // Match phase line: "- Phase 01: Name ✅" or "- Phase 01: Name (date)"
-      const phaseMatch = /^-\s*Phase\s*0?(\d+)[:\s]+([^✅✓\n]+)/i.exec(line);
-      if (phaseMatch) {
-        // Save previous phase if exists
-        if (currentPhase) phases.push(currentPhase);
-
-        const phaseNum = parseInt(phaseMatch[1], 10);
-        const name = phaseMatch[2].trim().replace(/\s*\([^)]*\)\s*$/, ''); // Remove trailing (date)
-        const hasCheckmark = /[✅✓]/.test(line);
-
-        currentPhase = {
-          phase: phaseNum,
-          name: name,
-          status: hasCheckmark ? 'completed' : 'pending',
-          file: planFilePath, // Default to plan.md, will be updated if File: found
-          linkText: name,
-          anchor: `phase-${String(phaseNum).padStart(2, '0')}-${slugify(name)}`
-        };
-        continue;
-      }
-
-      // Look for nested File: reference within current phase
-      if (currentPhase) {
-        const fileMatch = /^\s+-\s*File:\s*`?([^`\n]+)`?/i.exec(line);
-        if (fileMatch) {
-          const fileName = fileMatch[1].trim();
-          currentPhase.file = path.resolve(dir, fileName);
-          // Clear anchor when separate file exists
-          currentPhase.anchor = null;
-        }
-
-        // Check for status indicators in nested lines
-        const statusMatch = /^\s+-\s*(Completed|Status):\s*(.+)/i.exec(line);
-        if (statusMatch) {
-          currentPhase.status = normalizeStatus(statusMatch[2]);
-        }
-
-        // End current phase when we hit another top-level non-phase item or section header
-        if (/^##/.test(line) || (/^-\s/.test(line) && !/^-\s*Phase/i.test(line) && !/^\s+-/.test(line))) {
-          phases.push(currentPhase);
-          currentPhase = null;
-        }
-      }
-    }
-
-    // Push last phase if exists
-    if (currentPhase) phases.push(currentPhase);
-  }
-
-  // Format 5: Numbered list phases with checkbox status
-  // Matches: 1) **Discovery** with status from - [x] Discovery: ...
-  if (phases.length === 0) {
-    // First pass: find numbered phases like "1) **Name**" or "1. **Name**"
-    const numberedPhaseRegex = /^(\d+)[)\.]\s*\*\*([^*]+)\*\*/gm;
-    const phaseMap = new Map();
-    while ((match = numberedPhaseRegex.exec(content)) !== null) {
-      const [, num, name] = match;
-      const phaseNum = parseInt(num, 10);
-      phaseMap.set(name.trim().toLowerCase(), {
-        phase: phaseNum,
-        name: name.trim(),
-        status: 'pending',
-        file: planFilePath,
-        linkText: name.trim(),
-        anchor: `phase-${String(phaseNum).padStart(2, '0')}-${slugify(name.trim())}`
-      });
-    }
-
-    // Second pass: find checkbox status like "- [x] Name:" or "- [ ] Name:"
-    const checkboxRegex = /^-\s*\[(x| )\]\s*([^:]+)/gmi;
-    while ((match = checkboxRegex.exec(content)) !== null) {
-      const [, checked, name] = match;
-      const key = name.trim().toLowerCase();
-      if (phaseMap.has(key)) {
-        phaseMap.get(key).status = checked.toLowerCase() === 'x' ? 'completed' : 'pending';
-      }
-    }
-
-    // Convert map to array sorted by phase number
-    if (phaseMap.size > 0) {
-      phases.push(...Array.from(phaseMap.values()).sort((a, b) => a.phase - b.phase));
-    }
-  }
-
-  // Format 6: Checkbox list with bold links
-  // Matches: - [ ] **[Phase 1: Name](./phase-01-xxx.md)** or - [x] **[Phase 1](path)**
-  if (phases.length === 0) {
-    const checkboxLinkRegex = /^-\s*\[(x| )\]\s*\*\*\[(?:Phase\s*)?(\d+)[:\s]*([^\]]*)\]\(([^)]+)\)\*\*/gmi;
-    while ((match = checkboxLinkRegex.exec(content)) !== null) {
-      const [, checked, phase, name, linkPath] = match;
-      phases.push({
-        phase: parseInt(phase, 10),
-        name: name.trim() || `Phase ${phase}`,
-        status: checked.toLowerCase() === 'x' ? 'completed' : 'pending',
-        file: path.resolve(dir, linkPath),
-        linkText: name.trim() || `Phase ${phase}`
-      });
-    }
-  }
-
-  // Enhancement: Extract file paths from "Phase Files" section if phases point to plan.md
-  // This handles plans with heading-based phases + separate file links section
-  if (phases.length > 0) {
-    const phaseFilesSection = content.match(/##\s*Phase\s*Files[\s\S]*?(?=##|$)/i);
-    if (phaseFilesSection) {
-      const linkRegex = /\d+\.\s*\[([^\]]+)\]\(([^)]+\.md)\)/g;
-      let linkMatch;
-      while ((linkMatch = linkRegex.exec(phaseFilesSection[0])) !== null) {
-        const [, linkName, linkPath] = linkMatch;
-        // Extract phase number from filename (phase-01-xxx.md -> 1)
-        const phaseNum = parseInt(linkName.match(/phase-0?(\d+)/i)?.[1] || '0', 10);
-        // Update corresponding phase's file path
-        const phase = phases.find(p => p.phase === phaseNum);
-        if (phase && phase.file === planFilePath) {
-          phase.file = path.resolve(dir, linkPath);
-        }
-      }
-    }
-  }
-
-  // Filter out phases that only point to the plan.md itself (inline sections)
-  // Only keep phases that have separate phase files
-  return phases.filter(p => p.file !== planFilePath);
-}
-
-/**
- * Get navigation context for a file
- * @param {string} filePath - Current file path
- * @returns {{planInfo: Object, currentIndex: number, prev: Object, next: Object, allPhases: Array}}
- */
-function getNavigationContext(filePath) {
-  const planInfo = detectPlan(filePath);
-
-  if (!planInfo.isPlan) {
-    return { planInfo, currentIndex: -1, prev: null, next: null, allPhases: [] };
-  }
-
-  // Parse plan table for metadata
-  const phaseMeta = parsePlanTable(planInfo.planFile);
-
-  // Build all phases list including plan.md
-  const allPhases = [
-    {
-      phase: 0,
-      name: 'Plan Overview',
-      status: 'overview',
-      file: planInfo.planFile
-    },
-    ...phaseMeta
-  ];
-
-  // Find current file index
-  const normalizedPath = path.normalize(filePath);
-  const currentIndex = allPhases.findIndex(p => path.normalize(p.file) === normalizedPath);
-
-  // Get prev/next
-  const prev = currentIndex > 0 ? allPhases[currentIndex - 1] : null;
-  const next = currentIndex < allPhases.length - 1 && currentIndex >= 0
-    ? allPhases[currentIndex + 1]
-    : null;
-
-  return {
-    planInfo,
-    currentIndex,
-    prev,
-    next,
-    allPhases
-  };
-}
-
-/**
- * Generate navigation sidebar HTML
- * @param {string} filePath - Current file path
- * @returns {string} - HTML navigation sidebar
- */
-function generateNavSidebar(filePath) {
-  const { planInfo, currentIndex, allPhases } = getNavigationContext(filePath);
-
-  if (!planInfo.isPlan) {
-    return '';
-  }
-
-  const planName = path.basename(planInfo.planDir);
-  const normalizedCurrentPath = path.normalize(filePath);
-
-  const items = allPhases.map((phase, index) => {
-    const isActive = index === currentIndex;
-    const statusClass = phase.status.replace(/\s+/g, '-');
-    const normalizedPhasePath = path.normalize(phase.file);
-    const isSameFile = normalizedPhasePath === normalizedCurrentPath;
-
-    // Check if phase file actually exists on disk
-    const fileExists = fs.existsSync(phase.file);
-    const unavailableClass = !fileExists ? 'unavailable' : '';
-
-    // If file doesn't exist, render as non-clickable span with tooltip
-    if (!fileExists) {
-      return `
-        <li class="phase-item ${unavailableClass}" data-status="${statusClass}" title="Phase planned but not yet implemented">
-          <span class="phase-link-disabled">
-            <span class="status-dot ${statusClass}"></span>
-            <span class="phase-name">${phase.name}</span>
-            <span class="unavailable-badge">Planned</span>
-          </span>
-        </li>
-      `;
-    }
-
-    // Build href: use anchor for same-file phases, full URL for different files
-    let href;
-    let isInlineSection = false;
-    if (isSameFile && phase.anchor) {
-      // Same file with anchor - use hash fragment only for smooth scrolling
-      href = `#${phase.anchor}`;
-      isInlineSection = true;
-    } else if (phase.anchor) {
-      // Different file with anchor
-      href = `/view?file=${encodeURIComponent(phase.file)}#${phase.anchor}`;
-    } else {
-      // No anchor (separate phase file or plan overview)
-      href = `/view?file=${encodeURIComponent(phase.file)}`;
-    }
-
-    // Add data attributes for client-side section tracking
-    const dataAnchor = phase.anchor ? `data-anchor="${phase.anchor}"` : '';
-    const inlineSectionClass = isInlineSection ? 'inline-section' : '';
-
-    // Type icon: hash/anchor for inline sections, file for separate docs
-    const typeIcon = isInlineSection
-      ? `<svg class="phase-type-icon" viewBox="0 0 16 16" fill="currentColor"><path d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-.5 9.45a.75.75 0 01-1.06-1.06l-1.25 1.25a2 2 0 01-2.83-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25z"/></svg>`
-      : `<svg class="phase-type-icon" viewBox="0 0 16 16" fill="currentColor"><path d="M3.75 1.5a.25.25 0 00-.25.25v12.5c0 .138.112.25.25.25h8.5a.25.25 0 00.25-.25V4.664a.25.25 0 00-.073-.177l-2.914-2.914a.25.25 0 00-.177-.073H3.75zM2 1.75C2 .784 2.784 0 3.75 0h5.586c.464 0 .909.184 1.237.513l2.914 2.914c.329.328.513.773.513 1.237v9.586A1.75 1.75 0 0112.25 16h-8.5A1.75 1.75 0 012 14.25V1.75z"/></svg>`;
-
-    return `
-      <li class="phase-item ${isActive ? 'active' : ''} ${inlineSectionClass}" data-status="${statusClass}" ${dataAnchor}>
-        <a href="${href}">
-          ${typeIcon}
-          <span class="status-dot ${statusClass}"></span>
-          <span class="phase-name">${phase.name}</span>
-        </a>
-      </li>
-    `;
-  }).join('');
-
-  return `
-    <nav class="plan-nav" id="plan-nav">
-      <div class="plan-title">
-        <span class="plan-icon">&#128214;</span>
-        <span>${planName}</span>
-      </div>
-      <ul class="phase-list">
-        ${items}
-      </ul>
-    </nav>
-  `;
-}
-
-/**
- * Generate prev/next navigation footer
- * @param {string} filePath - Current file path
- * @returns {string} - HTML navigation footer
- */
-function generateNavFooter(filePath) {
-  const { prev, next } = getNavigationContext(filePath);
-
-  if (!prev && !next) {
-    return '';
-  }
-
-  // Check if prev/next files exist
-  const prevExists = prev && fs.existsSync(prev.file);
-  const nextExists = next && fs.existsSync(next.file);
-
-  const prevHtml = prev ? (prevExists ? `
-    <a href="/view?file=${encodeURIComponent(prev.file)}" class="nav-prev">
-      <span class="nav-arrow">&larr;</span>
-      <span class="nav-label">${prev.name}</span>
-    </a>
-  ` : `
-    <span class="nav-prev nav-unavailable" title="Phase planned but not yet implemented">
-      <span class="nav-arrow">&larr;</span>
-      <span class="nav-label">${prev.name}</span>
-      <span class="nav-badge">Planned</span>
-    </span>
-  `) : '<span></span>';
-
-  const nextHtml = next ? (nextExists ? `
-    <a href="/view?file=${encodeURIComponent(next.file)}" class="nav-next">
-      <span class="nav-label">${next.name}</span>
-      <span class="nav-arrow">&rarr;</span>
-    </a>
-  ` : `
-    <span class="nav-next nav-unavailable" title="Phase planned but not yet implemented">
-      <span class="nav-label">${next.name}</span>
-      <span class="nav-badge">Planned</span>
-      <span class="nav-arrow">&rarr;</span>
-    </span>
-  `) : '<span></span>';
-
-  return `
-    <footer class="nav-footer">
-      ${prevHtml}
-      ${nextHtml}
-    </footer>
-  `;
-}
-
-module.exports = {
-  detectPlan,
-  parsePlanTable,
-  getNavigationContext,
-  generateNavSidebar,
-  generateNavFooter
-};

package/skills/ck-markdown-novel-viewer/scripts/lib/port-finder.cjs

@@ -1,48 +0,0 @@
-/**
- * Port finder utility - finds available port in range
- * Used by markdown-novel-viewer server
- */
-
-const net = require('net');
-
-const DEFAULT_PORT = 3456;
-const PORT_RANGE_END = 3500;
-
-/**
- * Check if a port is available
- * @param {number} port - Port to check
- * @returns {Promise<boolean>} - True if available
- */
-function isPortAvailable(port) {
-  return new Promise((resolve) => {
-    const server = net.createServer();
-    server.once('error', () => resolve(false));
-    server.once('listening', () => {
-      server.close();
-      resolve(true);
-    });
-    server.listen(port);
-  });
-}
-
-/**
- * Find first available port in range
- * @param {number} startPort - Starting port (default: 3456)
- * @returns {Promise<number>} - Available port
- * @throws {Error} - If no port available in range
- */
-async function findAvailablePort(startPort = DEFAULT_PORT) {
-  for (let port = startPort; port <= PORT_RANGE_END; port++) {
-    if (await isPortAvailable(port)) {
-      return port;
-    }
-  }
-  throw new Error(`No available port in range ${startPort}-${PORT_RANGE_END}`);
-}
-
-module.exports = {
-  isPortAvailable,
-  findAvailablePort,
-  DEFAULT_PORT,
-  PORT_RANGE_END
-};

package/skills/ck-markdown-novel-viewer/scripts/lib/process-mgr.cjs

@@ -1,150 +0,0 @@
-/**
- * Process manager - handles PID files and server lifecycle
- * Used by markdown-novel-viewer server
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const PID_DIR = '/tmp';
-const PID_PREFIX = 'md-novel-viewer-';
-
-/**
- * Get PID file path for a port
- * @param {number} port - Server port
- * @returns {string} - PID file path
- */
-function getPidFilePath(port) {
-  return path.join(PID_DIR, `${PID_PREFIX}${port}.pid`);
-}
-
-/**
- * Write PID file for running server
- * @param {number} port - Server port
- * @param {number} pid - Process ID
- */
-function writePidFile(port, pid) {
-  const pidPath = getPidFilePath(port);
-  fs.writeFileSync(pidPath, String(pid));
-}
-
-/**
- * Read PID from file
- * @param {number} port - Server port
- * @returns {number|null} - PID or null if not found
- */
-function readPidFile(port) {
-  const pidPath = getPidFilePath(port);
-  if (fs.existsSync(pidPath)) {
-    const pid = fs.readFileSync(pidPath, 'utf8').trim();
-    return parseInt(pid, 10);
-  }
-  return null;
-}
-
-/**
- * Remove PID file
- * @param {number} port - Server port
- */
-function removePidFile(port) {
-  const pidPath = getPidFilePath(port);
-  if (fs.existsSync(pidPath)) {
-    fs.unlinkSync(pidPath);
-  }
-}
-
-/**
- * Find all running server instances
- * @returns {Array<{port: number, pid: number}>} - Running instances
- */
-function findRunningInstances() {
-  const instances = [];
-  const files = fs.readdirSync(PID_DIR);
-
-  for (const file of files) {
-    if (file.startsWith(PID_PREFIX) && file.endsWith('.pid')) {
-      const port = parseInt(file.replace(PID_PREFIX, '').replace('.pid', ''), 10);
-      const pid = readPidFile(port);
-      if (pid) {
-        // Check if process is actually running
-        try {
-          process.kill(pid, 0);
-          instances.push({ port, pid });
-        } catch {
-          // Process not running, clean up stale PID file
-          removePidFile(port);
-        }
-      }
-    }
-  }
-
-  return instances;
-}
-
-/**
- * Stop server by port
- * @param {number} port - Server port
- * @returns {boolean} - True if stopped successfully
- */
-function stopServer(port) {
-  const pid = readPidFile(port);
-  if (!pid) return false;
-
-  try {
-    process.kill(pid, 'SIGTERM');
-    removePidFile(port);
-    return true;
-  } catch {
-    removePidFile(port);
-    return false;
-  }
-}
-
-/**
- * Stop all running servers
- * @returns {number} - Number of servers stopped
- */
-function stopAllServers() {
-  const instances = findRunningInstances();
-  let stopped = 0;
-
-  for (const { port, pid } of instances) {
-    try {
-      process.kill(pid, 'SIGTERM');
-      removePidFile(port);
-      stopped++;
-    } catch {
-      removePidFile(port);
-    }
-  }
-
-  return stopped;
-}
-
-/**
- * Setup graceful shutdown handlers
- * @param {number} port - Server port
- * @param {Function} cleanup - Additional cleanup function
- */
-function setupShutdownHandlers(port, cleanup) {
-  const handler = (signal) => {
-    if (cleanup) cleanup();
-    removePidFile(port);
-    process.exit(0);
-  };
-
-  process.on('SIGTERM', handler);
-  process.on('SIGINT', handler);
-}
-
-module.exports = {
-  getPidFilePath,
-  writePidFile,
-  readPidFile,
-  removePidFile,
-  findRunningInstances,
-  stopServer,
-  stopAllServers,
-  setupShutdownHandlers,
-  PID_PREFIX
-};