dockscope 0.2.3 → 0.2.5

package/README.md

@@ -42,11 +42,12 @@ Requires Docker to be running. Opens a browser at `http://localhost:4681`.
 ```
 dockscope up [options]
 
-  -p, --port <port>   Server port (default: 4681)
-  -f, --file <path>   Docker Compose file path (default: auto-detect)
+  -p, --port <port>   Server port (default: 4681, auto-increments if in use)
   --no-open           Don't open browser automatically
 ```
 
+Docker Compose files are auto-detected (`compose.yml`, `docker-compose.yml`, etc.) and dependencies are read from container labels at runtime — no configuration needed.
+
 ### Scan Mode
 
 Output the container graph as JSON (no UI):
@@ -64,7 +65,7 @@ npm install
 npm run dev
 ```
 
-This starts the backend on port `4681` and the Vite dev server on port `4680` with hot reload.
+This starts the server on port `4681` with Vite HMR embedded — single port, same as production.
 
 ### Scripts
 

package/dist/cli.js

@@ -1,29 +1,67 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import path from 'path';
+import { createConnection } from 'net';
 import { startServer } from './server/index.js';
 import { buildGraph, checkConnection } from './docker/client.js';
+function isPortInUse(port) {
+    return new Promise((resolve) => {
+        const conn = createConnection({ port, host: '127.0.0.1' });
+        const timeout = setTimeout(() => {
+            conn.destroy();
+            resolve(false);
+        }, 500);
+        conn.on('connect', () => {
+            clearTimeout(timeout);
+            conn.destroy();
+            resolve(true);
+        });
+        conn.on('error', () => {
+            clearTimeout(timeout);
+            resolve(false);
+        });
+    });
+}
+async function findAvailablePort(start) {
+    let port = start;
+    while (await isPortInUse(port)) {
+        console.log(`  Port ${port} is in use, trying ${port + 1}...`);
+        port++;
+        if (port > start + 20) {
+            console.error(`  No available port found in range ${start}-${port}`);
+            process.exit(1);
+        }
+    }
+    return port;
+}
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(path.resolve(__dirname, '../package.json'), 'utf-8'));
+const VERSION = pkg.version;
 const program = new Command();
 program
     .name('dockscope')
     .description('Visual, interactive Docker infrastructure debugger')
-    .version('0.1.0');
+    .version(VERSION);
 program
-    .command('up')
+    .command('up', { isDefault: true })
     .description('Start the DockScope dashboard')
     .option('-p, --port <port>', 'Server port', '4681')
-    .option('-f, --file <path>', 'Docker Compose file path', 'docker-compose.yml')
     .option('--no-open', "Don't open browser automatically")
+    .option('--no-port-check', 'Skip port conflict detection')
     .action(async (opts) => {
-    const port = parseInt(opts.port, 10);
+    const requestedPort = parseInt(opts.port, 10);
+    const port = opts.portCheck === false ? requestedPort : await findAvailablePort(requestedPort);
     console.log(`
   ____             _    ____
  |  _ \\  ___   ___| | _/ ___|  ___ ___  _ __   ___
  | | | |/ _ \\ / __| |/ \\___ \\ / __/ _ \\| '_ \\ / _ \\
  | |_| | (_) | (__|   < ___) | (_| (_) | |_) |  __/
  |____/ \\___/ \\___|_|\\_\\____/ \\___\\___/| .__/ \\___|
-                                       |_|  v0.1.0
+                                       |_|  v${VERSION}
 `);
-    await startServer({ port, composeFile: opts.file, open: opts.open !== false });
+    await startServer({ port, open: opts.open !== false });
     const url = `http://localhost:${port}`;
     console.log(`  Dashboard: ${url}`);
     console.log(`  API:       ${url}/api/graph`);
@@ -38,14 +76,13 @@ program
 program
     .command('scan')
     .description('Scan Docker environment and output graph data as JSON')
-    .option('-f, --file <path>', 'Docker Compose file path', 'docker-compose.yml')
-    .action(async (opts) => {
+    .action(async () => {
     const connected = await checkConnection();
     if (!connected) {
         console.error('Cannot connect to Docker daemon. Is Docker running?');
         process.exit(1);
     }
-    const graph = await buildGraph(opts.file);
+    const graph = await buildGraph();
     console.log(JSON.stringify(graph, null, 2));
 });
 program.parse();

package/dist/server/index.js

@@ -22,12 +22,28 @@ export async function startServer(opts) {
     const metricHistory = new Map();
     // REST routes
     setupRoutes(app, opts, metricHistory);
-    // Serve built frontend in production
-    const webDir = path.resolve(__dirname, '../web');
-    app.use(express.static(webDir));
-    app.get('*', (_req, res) => {
-        res.sendFile(path.join(webDir, 'index.html'));
-    });
+    // Frontend: Vite dev server (HMR) or static files (production)
+    if (process.env.DOCKSCOPE_DEV === '1') {
+        try {
+            const { createServer: createVite } = await import('vite');
+            const vite = await createVite({
+                server: { middlewareMode: true, hmr: { server } },
+                appType: 'spa',
+            });
+            app.use(vite.middlewares);
+        }
+        catch {
+            console.error('Vite not found — install devDependencies for dev mode');
+            process.exit(1);
+        }
+    }
+    else {
+        const webDir = path.resolve(__dirname, '../web');
+        app.use(express.static(webDir));
+        app.get('*', (_req, res) => {
+            res.sendFile(path.join(webDir, 'index.html'));
+        });
+    }
     // --- WebSocket ---
     const broadcast = (msg) => {
         const data = JSON.stringify(msg);
@@ -39,7 +55,7 @@ export async function startServer(opts) {
     let cachedGraph = { nodes: [], links: [] };
     const refreshGraph = async () => {
         try {
-            cachedGraph = await buildGraph(opts.composeFile);
+            cachedGraph = await buildGraph();
             broadcast({ type: 'graph', data: cachedGraph });
         }
         catch {

package/dist/server/routes.js

@@ -2,7 +2,7 @@ import { buildGraph, checkConnection, composeAction, containerAction, getContain
 export function setupRoutes(app, opts, metricHistory) {
     app.get('/api/graph', async (_req, res) => {
         try {
-            const graph = await buildGraph(opts.composeFile);
+            const graph = await buildGraph();
             res.json(graph);
         }
         catch (err) {

package/dist/types.d.ts

@@ -88,6 +88,5 @@ export interface MetricPoint {
 }
 export interface ServerOptions {
     port: number;
-    composeFile: string;
     open: boolean;
 }