devports 0.0.1 → 1.0.1

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Secure CLI wrapper with comprehensive input validation
+ * This file provides security-hardened versions of all CLI commands
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/cli.js

@@ -0,0 +1,329 @@
+#!/usr/bin/env node
+/**
+ * Secure CLI wrapper with comprehensive input validation
+ * This file provides security-hardened versions of all CLI commands
+ */
+import { Command } from 'commander';
+const program = new Command();
+const ASCII_HEADER = `
+ ██████╗ ███████╗██╗   ██╗██████╗  ██████╗ ██████╗ ████████╗███████╗
+ ██╔══██╗██╔════╝██║   ██║██╔══██╗██╔═══██╗██╔══██╗╚══██╔══╝██╔════╝
+ ██║  ██║█████╗  ██║   ██║██████╔╝██║   ██║██████╔╝   ██║   ███████╗
+ ██║  ██║██╔══╝  ╚██╗ ██╔╝██╔═══╝ ██║   ██║██╔══██╗   ██║   ╚════██║
+ ██████╔╝███████╗ ╚████╔╝ ██║     ╚██████╔╝██║  ██║   ██║   ███████║
+ ╚═════╝ ╚══════╝  ╚═══╝  ╚═╝      ╚═════╝ ╚═╝  ╚═╝   ╚═╝   ╚══════╝
+
+ Port allocation manager for multi-project development
+`;
+// Override process.stdout.write and process.stderr.write to add extra line after output
+const originalStdoutWrite = process.stdout.write.bind(process.stdout);
+const originalStderrWrite = process.stderr.write.bind(process.stderr);
+// Track if we should add blank lines (disabled for quiet/json modes)
+let shouldAddBlankLines = true;
+function setShouldAddBlankLines(value) {
+    shouldAddBlankLines = value;
+}
+function addBlankLineAfterOutput(output) {
+    if (!shouldAddBlankLines) {
+        return output;
+    }
+    // Check if this looks like help output by looking for common help patterns
+    if (output.includes('Usage:') &&
+        (output.includes('Options:') || output.includes('Commands:'))) {
+        return `${output}\n`;
+    }
+    // Check if this looks like command completion (ends with success/error emoji and doesn't already end with newline)
+    if ((output.includes('✅') || output.includes('❌')) &&
+        !output.endsWith('\n\n')) {
+        return `${output}\n`;
+    }
+    return output;
+}
+process.stdout.write = ((chunk, encoding, callback) => {
+    if (typeof chunk === 'string') {
+        chunk = addBlankLineAfterOutput(chunk);
+    }
+    return originalStdoutWrite(chunk, encoding, callback);
+});
+process.stderr.write = ((chunk, encoding, callback) => {
+    if (typeof chunk === 'string') {
+        chunk = addBlankLineAfterOutput(chunk);
+    }
+    return originalStderrWrite(chunk, encoding, callback);
+});
+program
+    .name('devports')
+    .description('Port allocation manager for multi-project development')
+    .version('0.1.0')
+    .addHelpText('before', ASCII_HEADER);
+// Setup command
+const setupCmd = new SetupCommand();
+program
+    .command('setup')
+    .description(setupCmd.description)
+    .option('--template <file>', 'Template file to use (default: .env.devports if exists)')
+    .option('--services <services>', 'Services to allocate (comma-separated, e.g., postgres:postgres,api:api)')
+    .option('--force', 'Overwrite existing .env file (creates .env.backup)')
+    .option('--skip-render', 'Skip auto-rendering of *.devports files')
+    .option('--post-hook <script>', 'Run script after setup (passed env vars)')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    // Disable blank lines for quiet or json mode
+    if (options.quiet || options.json) {
+        setShouldAddBlankLines(false);
+    }
+    // Show ASCII header for setup command (but not if --json is used)
+    if (!options.json) {
+        console.log(ASCII_HEADER);
+    }
+    const result = await setupCmd.execute([], options);
+    process.exit(result.success ? 0 : 1);
+});
+// Worktree command group
+const worktreeAddCmd = new WorktreeAddCommand();
+const worktreeRemoveCmd = new WorktreeRemoveCommand();
+const worktree = program
+    .command('worktree')
+    .description('Git worktree integration with automatic port allocation');
+// Worktree add
+worktree
+    .command('add')
+    .description(worktreeAddCmd.description)
+    .argument('<path>', 'Path for the new worktree')
+    .option('-b, --branch <branch>', 'Create and checkout a new branch')
+    .option('--no-env', 'Skip .env file creation')
+    .option('--env-file <file>', 'Custom .env file name', '.env')
+    .option('--services <services>', 'Services to allocate (comma-separated, e.g., postgres:postgres,api:api)')
+    .option('--template <file>', 'Use template file for .env generation (default: .env.devports if exists)')
+    .option('--post-hook <script>', 'Run script after worktree creation (passed env vars)')
+    .option('--json', 'Output as JSON')
+    .action(async (path, options) => {
+    // Disable blank lines for json mode
+    if (options.json) {
+        setShouldAddBlankLines(false);
+    }
+    const result = await worktreeAddCmd.execute([path], options);
+    process.exit(result.success ? 0 : 1);
+});
+// Worktree remove
+worktree
+    .command('remove')
+    .description(worktreeRemoveCmd.description)
+    .argument('<path>', 'Path to the worktree to remove')
+    .option('-f, --force', 'Force removal even if worktree is dirty')
+    .option('--json', 'Output as JSON')
+    .action(async (path, options) => {
+    // Disable blank lines for json mode
+    if (options.json) {
+        setShouldAddBlankLines(false);
+    }
+    const result = await worktreeRemoveCmd.execute([path], options);
+    process.exit(result.success ? 0 : 1);
+});
+// Allocate command
+import { AllocateCommand } from './commands/allocate.command.js';
+import { ReleaseCommand } from './commands/release.command.js';
+import { ListCommand } from './commands/list.command.js';
+import { StatusCommand } from './commands/status.command.js';
+import { ReserveCommand } from './commands/reserve.command.js';
+import { UnreserveCommand } from './commands/unreserve.command.js';
+import { CheckCommand } from './commands/check.command.js';
+import { InfoCommand } from './commands/info.command.js';
+import { SetupCommand } from './commands/setup.command.js';
+import { WorktreeAddCommand } from './commands/worktree-add.command.js';
+import { WorktreeRemoveCommand } from './commands/worktree-remove.command.js';
+import { RenderCommand } from './commands/render.command.js';
+import { GitignoreCommand } from './commands/gitignore.command.js';
+import { CompletionCommand } from './commands/completion.command.js';
+const allocateCmd = new AllocateCommand();
+program
+    .command('allocate')
+    .description(allocateCmd.description)
+    .argument('[project]', 'Project name')
+    .argument('[service]', 'Service name (e.g., postgres, api)')
+    .option('-t, --type <type>', 'Service type (postgres, mysql, redis, api, app, custom)')
+    .option('-q, --quiet', 'Only output the port number (for scripting)')
+    .option('--json', 'Output result as JSON')
+    .option('--completion <mode>', 'Output for shell completion: projects, services, types')
+    .action(async (project, service, options) => {
+    // Disable blank lines for quiet or json mode
+    if (options.quiet || options.json) {
+        setShouldAddBlankLines(false);
+    }
+    await allocateCmd.execute([project, service], options);
+    process.exit(0);
+});
+// Release command
+const releaseCmd = new ReleaseCommand();
+program
+    .command('release')
+    .description(releaseCmd.description)
+    .argument('[project]', 'Project name (or port number with --port)')
+    .argument('[service]', 'Service name (optional if using --all or --port)')
+    .option('-a, --all', 'Release all ports for this project')
+    .option('-p, --port', 'First argument is a port number to release')
+    .option('-q, --quiet', 'Suppress output (exit code indicates success)')
+    .option('--json', 'Output result as JSON')
+    .option('--completion <mode>', 'Output for shell completion: projects, services')
+    .option('--project <name>', 'Project name for completion filtering (internal use)')
+    .action(async (projectOrPort, service, options) => {
+    // Disable blank lines for quiet or json mode
+    if (options.quiet || options.json) {
+        setShouldAddBlankLines(false);
+    }
+    const args = service ? [projectOrPort, service] : [projectOrPort];
+    const result = await releaseCmd.execute(args, options);
+    process.exit(result.success ? 0 : 1);
+});
+// List command
+const listCmd = new ListCommand();
+program
+    .command('list')
+    .description(listCmd.description)
+    .option('-p, --project <project>', 'Filter by project')
+    .option('-t, --type <type>', 'Filter by service type')
+    .option('--json', 'Output as JSON')
+    .option('-q, --quiet', 'Minimal output (just port numbers, one per line)')
+    .option('--completion <mode>', 'Output for shell completion: projects, services, types')
+    .action((options) => {
+    // Disable blank lines for quiet or json mode
+    if (options.quiet || options.json) {
+        setShouldAddBlankLines(false);
+    }
+    const result = listCmd.execute([], options);
+    if (!result.success) {
+        process.exit(1);
+    }
+});
+// Status command
+const statusCmd = new StatusCommand();
+program
+    .command('status')
+    .description(statusCmd.description)
+    .option('--json', 'Output as JSON')
+    .option('-q, --quiet', 'Minimal output (just next available ports)')
+    .action((options) => {
+    // Disable blank lines for quiet or json mode
+    if (options.quiet || options.json) {
+        setShouldAddBlankLines(false);
+    }
+    const result = statusCmd.execute([], options);
+    process.exit(result.success ? 0 : 1);
+});
+// Reserve command
+const reserveCmd = new ReserveCommand();
+program
+    .command('reserve')
+    .description(reserveCmd.description)
+    .argument('<port>', 'Port number to reserve')
+    .argument('[reason]', 'Reason for reservation', 'Reserved')
+    .option('--json', 'Output as JSON')
+    .option('-q, --quiet', 'Suppress output')
+    .action(async (portStr, reason, options) => {
+    // Disable blank lines for quiet or json mode
+    if (options.quiet || options.json) {
+        setShouldAddBlankLines(false);
+    }
+    const result = await reserveCmd.execute([portStr, reason], options);
+    process.exit(result.success ? 0 : 1);
+});
+// Unreserve command
+const unreserveCmd = new UnreserveCommand();
+program
+    .command('unreserve')
+    .description(unreserveCmd.description)
+    .argument('<port>', 'Port number to unreserve')
+    .option('--json', 'Output as JSON')
+    .option('-q, --quiet', 'Suppress output')
+    .action(async (portStr, options) => {
+    // Disable blank lines for quiet or json mode
+    if (options.quiet || options.json) {
+        setShouldAddBlankLines(false);
+    }
+    const result = await unreserveCmd.execute([portStr], options);
+    process.exit(result.success ? 0 : 1);
+});
+// Check command
+const checkCmd = new CheckCommand();
+program
+    .command('check')
+    .description(checkCmd.description)
+    .argument('<port>', 'Port number to check')
+    .option('--json', 'Output as JSON')
+    .option('-q, --quiet', 'Silent mode (exit code only: 0=available, 1=in use)')
+    .action((portStr, options) => {
+    // Disable blank lines for quiet or json mode
+    if (options.quiet || options.json) {
+        setShouldAddBlankLines(false);
+    }
+    const result = checkCmd.execute([portStr], options);
+    process.exit(result.success ? 0 : 1);
+});
+// Info command
+const infoCmd = new InfoCommand();
+program
+    .command('info')
+    .description(infoCmd.description)
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    // Disable blank lines for json mode
+    if (options.json) {
+        setShouldAddBlankLines(false);
+    }
+    const result = await infoCmd.execute([], options);
+    process.exit(result.success ? 0 : 1);
+});
+// Render command
+const renderCmd = new RenderCommand();
+program
+    .command('render')
+    .description(renderCmd.description)
+    .argument('<file>', 'Template file to process')
+    .option('-p, --project <n>', 'Project name (overrides DEVPORTS_PROJECT_NAME in template)')
+    .option('-o, --output <file>', 'Output file (defaults to stdout)')
+    .option('--json', 'Output allocation info as JSON')
+    .action(async (file, options) => {
+    // Disable blank lines for json mode
+    if (options.json) {
+        setShouldAddBlankLines(false);
+    }
+    const result = await renderCmd.execute([file], options);
+    process.exit(result.success ? 0 : 1);
+});
+// Gitignore command
+const gitignoreCmd = new GitignoreCommand();
+program
+    .command('gitignore')
+    .description(gitignoreCmd.description)
+    .option('--preview', 'Show what would be added without making changes')
+    .option('--clean', 'Remove stale devports entries from .gitignore')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    // Disable blank lines for json mode
+    if (options.json) {
+        setShouldAddBlankLines(false);
+    }
+    const result = await gitignoreCmd.execute([], options);
+    process.exit(result.success ? 0 : 1);
+});
+// Completion command
+const completionCmd = new CompletionCommand();
+program
+    .command('completion')
+    .description(completionCmd.description)
+    .argument('[shell]', 'Shell type (bash, zsh)', 'zsh')
+    .option('-i, --install', 'Install completion script to user directory')
+    .option('-u, --uninstall', 'Remove completion script and shell config')
+    .option('--check', 'Check if completion is already installed')
+    .option('--test', 'Test if completion works in a fresh shell')
+    .option('--json', 'Output as JSON')
+    .action(async (shell, options) => {
+    // Disable blank lines for json mode
+    if (options.json) {
+        setShouldAddBlankLines(false);
+    }
+    const result = await completionCmd.execute([shell], options);
+    process.exit(result.success ? 0 : 1);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/allocate.command.d.ts

@@ -0,0 +1,8 @@
+import { Command, CommandOptions, CommandResult } from './base-command.js';
+export declare class AllocateCommand implements Command {
+    name: string;
+    description: string;
+    execute(args: string[], options: CommandOptions): Promise<CommandResult>;
+    private handleCompletion;
+}
+//# sourceMappingURL=allocate.command.d.ts.map

package/dist/commands/allocate.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocate.command.d.ts","sourceRoot":"","sources":["../../src/commands/allocate.command.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,cAAc,EACd,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAM3B,qBAAa,eAAgB,YAAW,OAAO;IAC7C,IAAI,SAAc;IAClB,WAAW,SAA2C;IAEhD,OAAO,CACX,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IAuDzB,OAAO,CAAC,gBAAgB;CAwCzB"}

package/dist/commands/allocate.command.js

@@ -0,0 +1,84 @@
+import { handleCommandError, } from './base-command.js';
+import { allocatePort, listAllocations } from '../port-manager.js';
+import { ValidationService } from '../services/validation-service.js';
+import { ResponseFormatter } from '../services/response-formatter.js';
+import { VALID_PORT_TYPES } from '../types.js';
+export class AllocateCommand {
+    name = 'allocate';
+    description = 'Allocate a port for a project/service';
+    async execute(args, options) {
+        try {
+            // Handle completion mode
+            if (options.completion) {
+                return this.handleCompletion(options);
+            }
+            const [project, service] = args;
+            if (!project) {
+                throw new Error('Project name is required');
+            }
+            if (!service) {
+                throw new Error('Service name is required');
+            }
+            if (!options.type) {
+                throw new Error('Service type is required. Use --type to specify one of: postgres, mysql, redis, api, app, custom');
+            }
+            // Validate inputs
+            const validatedProject = ValidationService.validateProjectName(project);
+            const validatedService = ValidationService.validateServiceName(service);
+            const validatedType = ValidationService.validateServiceType(options.type);
+            const port = await allocatePort(validatedProject, validatedService, validatedType);
+            // Handle quiet mode first
+            if (options.quiet) {
+                return ResponseFormatter.quiet(port, { port });
+            }
+            // Use centralized formatter for all output patterns
+            const response = ResponseFormatter.portAllocation(port, validatedProject, validatedService, validatedType);
+            return ResponseFormatter.format(response, options);
+        }
+        catch (error) {
+            handleCommandError(error, options);
+            return { success: false };
+        }
+    }
+    handleCompletion(options) {
+        const mode = options.completion.toLowerCase();
+        switch (mode) {
+            case 'projects': {
+                const allocations = listAllocations();
+                const projects = [...new Set(allocations.map((a) => a.project))].sort();
+                projects.forEach((p) => console.log(p));
+                process.exit(0);
+                break;
+            }
+            case 'services': {
+                // For services, we need a specific project - check if one was provided
+                const project = options.project;
+                if (project) {
+                    const allocations = listAllocations({ project });
+                    const services = [
+                        ...new Set(allocations.map((a) => a.service)),
+                    ].sort();
+                    services.forEach((s) => console.log(s));
+                }
+                else {
+                    // No project specified, return all services
+                    const allocations = listAllocations();
+                    const services = [
+                        ...new Set(allocations.map((a) => a.service)),
+                    ].sort();
+                    services.forEach((s) => console.log(s));
+                }
+                process.exit(0);
+                break;
+            }
+            case 'types': {
+                VALID_PORT_TYPES.forEach((t) => console.log(t));
+                process.exit(0);
+                break;
+            }
+            default:
+                throw new Error(`Invalid completion mode: ${mode}`);
+        }
+    }
+}
+//# sourceMappingURL=allocate.command.js.map

package/dist/commands/allocate.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocate.command.js","sourceRoot":"","sources":["../../src/commands/allocate.command.ts"],"names":[],"mappings":"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"}

package/dist/commands/base-command.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Base command interface and utilities for CLI commands
+ */
+export interface CommandOptions {
+    [key: string]: unknown;
+}
+export interface CommandResult {
+    success: boolean;
+    message?: string;
+    data?: unknown;
+}
+/**
+ * Base interface for all commands
+ */
+export interface Command {
+    name: string;
+    description: string;
+    execute(args: string[], options: CommandOptions): Promise<CommandResult> | CommandResult;
+}
+/**
+ * Helper function for consistent JSON/text output
+ */
+export declare function formatOutput(result: CommandResult, options: CommandOptions): void;
+/**
+ * Helper function for error handling
+ */
+export declare function handleCommandError(error: unknown, options: CommandOptions): void;
+//# sourceMappingURL=base-command.d.ts.map

package/dist/commands/base-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../../src/commands/base-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CACL,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;CAC3C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,GACtB,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,cAAc,GACtB,IAAI,CAiBN"}

package/dist/commands/base-command.js

@@ -0,0 +1,33 @@
+/**
+ * Base command interface and utilities for CLI commands
+ */
+/**
+ * Helper function for consistent JSON/text output
+ */
+export function formatOutput(result, options) {
+    if (options.json) {
+        console.log(JSON.stringify(result));
+    }
+    else if (result.message) {
+        console.log(result.message);
+    }
+}
+/**
+ * Helper function for error handling
+ */
+export function handleCommandError(error, options) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (!options.quiet) {
+        if (options.json) {
+            console.error(JSON.stringify({
+                success: false,
+                error: message,
+            }));
+        }
+        else {
+            console.error(`❌ ${message}`);
+        }
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=base-command.js.map

package/dist/commands/base-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.js","sourceRoot":"","sources":["../../src/commands/base-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwBH;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAqB,EACrB,OAAuB;IAEvB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,CAAC;SAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAc,EACd,OAAuB;IAEvB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEvE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CACX,IAAI,CAAC,SAAS,CAAC;gBACb,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,OAAO;aACf,CAAC,CACH,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/commands/check.command.d.ts

@@ -0,0 +1,7 @@
+import { Command, CommandOptions, CommandResult } from './base-command.js';
+export declare class CheckCommand implements Command {
+    name: string;
+    description: string;
+    execute(args: string[], options: CommandOptions): CommandResult;
+}
+//# sourceMappingURL=check.command.d.ts.map

package/dist/commands/check.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.command.d.ts","sourceRoot":"","sources":["../../src/commands/check.command.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,cAAc,EACd,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAI3B,qBAAa,YAAa,YAAW,OAAO;IAC1C,IAAI,SAAW;IACf,WAAW,SAAoD;IAE/D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa;CAyChE"}

package/dist/commands/check.command.js

@@ -0,0 +1,44 @@
+import { handleCommandError, } from './base-command.js';
+import { listAllocations } from '../port-manager.js';
+import { ValidationService } from '../services/validation-service.js';
+export class CheckCommand {
+    name = 'check';
+    description = 'Check if a port is available (non-destructive)';
+    execute(args, options) {
+        try {
+            const [portStr] = args;
+            if (!portStr) {
+                throw new Error('Port number is required');
+            }
+            const validatedPort = ValidationService.validatePort(portStr);
+            const allocations = listAllocations();
+            const allocated = allocations.find((a) => a.port === validatedPort);
+            const available = !allocated;
+            const message = options.quiet
+                ? undefined
+                : available
+                    ? `✅ Port ${validatedPort} is available`
+                    : `❌ Port ${validatedPort} is allocated to ${ValidationService.sanitizeForDisplay(allocated?.project ?? 'unknown')}/${ValidationService.sanitizeForDisplay(allocated?.service ?? 'unknown')}`;
+            if (!options.quiet) {
+                console.log(message);
+            }
+            if (options.json) {
+                return {
+                    success: available,
+                    message,
+                    data: {
+                        port: validatedPort,
+                        available,
+                        allocation: allocated ?? null,
+                    },
+                };
+            }
+            return { success: available, message };
+        }
+        catch (error) {
+            handleCommandError(error, options);
+            return { success: false };
+        }
+    }
+}
+//# sourceMappingURL=check.command.js.map

package/dist/commands/check.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.command.js","sourceRoot":"","sources":["../../src/commands/check.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,MAAM,OAAO,YAAY;IACvB,IAAI,GAAG,OAAO,CAAC;IACf,WAAW,GAAG,gDAAgD,CAAC;IAE/D,OAAO,CAAC,IAAc,EAAE,OAAuB;QAC7C,IAAI,CAAC;YACH,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;YAEvB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YAED,MAAM,aAAa,GAAG,iBAAiB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAC9D,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;YACpE,MAAM,SAAS,GAAG,CAAC,SAAS,CAAC;YAE7B,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK;gBAC3B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,SAAS;oBACT,CAAC,CAAC,UAAU,aAAa,eAAe;oBACxC,CAAC,CAAC,UAAU,aAAa,oBAAoB,iBAAiB,CAAC,kBAAkB,CAAC,SAAS,EAAE,OAAO,IAAI,SAAS,CAAC,IAAI,iBAAiB,CAAC,kBAAkB,CAAC,SAAS,EAAE,OAAO,IAAI,SAAS,CAAC,EAAE,CAAC;YAElM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;YAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,OAAO;oBACL,OAAO,EAAE,SAAS;oBAClB,OAAO;oBACP,IAAI,EAAE;wBACJ,IAAI,EAAE,aAAa;wBACnB,SAAS;wBACT,UAAU,EAAE,SAAS,IAAI,IAAI;qBAC9B;iBACF,CAAC;YACJ,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}

package/dist/commands/completion.command.d.ts

@@ -0,0 +1,7 @@
+import { Command, CommandOptions, CommandResult } from './base-command.js';
+export declare class CompletionCommand implements Command {
+    name: string;
+    description: string;
+    execute(args: string[], options: CommandOptions): Promise<CommandResult>;
+}
+//# sourceMappingURL=completion.command.d.ts.map

package/dist/commands/completion.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.command.d.ts","sourceRoot":"","sources":["../../src/commands/completion.command.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,cAAc,EACd,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAS3B,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,IAAI,SAAgB;IACpB,WAAW,SAAsC;IAE3C,OAAO,CACX,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;CAyI1B"}