@devflow-tools/cli 0.18.3 → 0.18.5

package/dist/commands/server.d.ts

@@ -1,16 +1,30 @@
+import { type EnsureRuntimeInput, type RuntimeStateV2 } from '@devflow-tools/sdk';
 export declare const DEFAULT_SERVER_PORT = 13337;
-declare function readPort(pidFile: string): number | null;
-declare function readPid(pidFile: string): number | null;
-export { readPort as readPortFromFile, readPid as readPidFromFile };
-export declare function startServer(opts: {
-    port: number;
+export declare function resolveServerLaunch(projectRoot?: string): EnsureRuntimeInput['server'];
+export declare function getRuntimeManager(): import("@devflow-tools/sdk").RuntimeManager;
+export interface CliRuntimeOptions {
+    reason: EnsureRuntimeInput['reason'];
+    projectRoot: string;
+    port?: number;
+    explicitPort?: boolean;
+    noStart?: boolean;
+}
+export declare function ensureCliRuntime(options: CliRuntimeOptions): Promise<import("@devflow-tools/sdk").EnsureRuntimeResult>;
+export declare function startServer(options?: {
+    port?: number;
+    projectRoot?: string;
+    explicitPort?: boolean;
 }): Promise<{
     pid: number;
+    port: number;
+    state: RuntimeStateV2;
+    reused: boolean;
 }>;
 export declare function stopServer(): Promise<boolean>;
 export declare function serverStatus(): Promise<{
     running: boolean;
     pid?: number;
     port?: number;
+    state?: RuntimeStateV2 | null;
 }>;
 //# sourceMappingURL=server.d.ts.map

package/dist/commands/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AAmCA,eAAO,MAAM,mBAAmB,QAA8B,CAAC;AAE/D,iBAAS,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQhD;AAED,iBAAS,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO/C;AAED,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,OAAO,IAAI,eAAe,EAAE,CAAC;AAEpE,wBAAsB,WAAW,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BlF;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAgBnD;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB/F"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAG5B,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,wBAAgB,mBAAmB,CAAC,WAAW,SAAgB,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAU7F;AAED,wBAAgB,iBAAiB,gDAAqC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,6DAShE;AAED,wBAAsB,WAAW,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAI/L;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAuD;AAE3G,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE,CAAC,CAG9H"}

package/dist/commands/server.js

@@ -1,126 +1,41 @@
-import { spawn } from "child_process";
-import { readFileSync, writeFileSync, existsSync, unlinkSync, mkdirSync } from "fs";
-import { join } from "path";
-import { createRequire } from "module";
-import { randomUUID } from "node:crypto";
-import { DEFAULT_DEVFLOW_SERVER_PORT, readRuntimeEndpointState, resolveRuntimeEndpoint, updateRuntimeEndpointStatus, writeRuntimeEndpointState, } from "@devflow-tools/sdk";
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { createRuntimeManager, } from '@devflow-tools/sdk';
 const require = createRequire(import.meta.url);
-function getPidFile(projectRoot) {
-    const dotdev = join(projectRoot, ".devflow");
-    if (!existsSync(dotdev))
-        mkdirSync(dotdev, { recursive: true });
-    return join(dotdev, "server.pid");
-}
-function getServerScript() {
-    // Prefer bundled server.js distributed alongside the CLI
-    try {
-        return require.resolve("./server.js");
-    }
-    catch {
-        // Fallback: separate npm package
+export const DEFAULT_SERVER_PORT = 13337;
+export function resolveServerLaunch(projectRoot = process.cwd()) {
+    const candidates = [
+        () => require.resolve('@devflow-tools/server/dist/main.js'),
+        () => join(projectRoot, 'node_modules', '@devflow-tools', 'server', 'dist', 'main.js'),
+        () => join(projectRoot, 'apps', 'server', 'dist', 'main.js'),
+    ];
+    for (const candidate of candidates) {
         try {
-            return require.resolve("@devflow-tools/server/dist/main.js");
-        }
-        catch {
-            return join(process.cwd(), "apps", "server", "dist", "main.js");
+            return { command: process.execPath, args: [candidate()], cwd: projectRoot };
         }
+        catch { }
     }
-}
-export const DEFAULT_SERVER_PORT = DEFAULT_DEVFLOW_SERVER_PORT;
-function readPort(pidFile) {
-    if (!existsSync(pidFile))
-        return null;
-    const lines = readFileSync(pidFile, "utf-8").trim().split("\n");
-    if (lines.length >= 2) {
-        const port = parseInt(lines[0], 10);
-        if (!isNaN(port))
-            return port;
-    }
-    return null;
-}
-function readPid(pidFile) {
-    if (!existsSync(pidFile))
-        return null;
-    const lines = readFileSync(pidFile, "utf-8").trim().split("\n");
-    // New format: port\npid (2 lines). Old format: just pid (1 line).
-    const pidLine = lines.length >= 2 ? lines[1] : lines[0];
-    const pid = parseInt(pidLine, 10);
-    return isNaN(pid) ? null : pid;
-}
-export { readPort as readPortFromFile, readPid as readPidFromFile };
-export async function startServer(opts) {
-    const script = getServerScript();
-    const pidFile = getPidFile(process.cwd());
-    const ownerToken = randomUUID();
-    const child = spawn(process.execPath, [script, '--devflow-instance-token', ownerToken], {
-        env: { ...process.env, PORT: String(opts.port) },
-        stdio: "ignore",
-        detached: true,
-    });
-    writeFileSync(pidFile, `${opts.port}\n${child.pid ?? 0}`);
-    writeRuntimeEndpointState({
-        url: `http://127.0.0.1:${opts.port}`,
-        port: opts.port,
-        pid: child.pid ?? 0,
-        ownerToken,
-        status: 'launching',
+    throw new Error('DevFlow server entry point is not installed or built');
+}
+export function getRuntimeManager() { return createRuntimeManager(); }
+export async function ensureCliRuntime(options) {
+    return getRuntimeManager().ensureRunning({
+        reason: options.reason,
+        projectRoot: options.projectRoot,
+        port: options.port,
+        explicitPort: options.explicitPort,
+        noStart: options.noStart,
+        server: resolveServerLaunch(options.projectRoot),
     });
-    child.unref();
-    const healthy = await waitForHealth(`http://127.0.0.1:${opts.port}`, 5_000);
-    updateRuntimeEndpointStatus(healthy ? 'healthy' : 'degraded');
-    return { pid: child.pid ?? 0 };
 }
-export async function stopServer() {
-    const pidFile = getPidFile(process.cwd());
-    const pid = readPid(pidFile);
-    if (pid === null)
-        return false;
-    try {
-        process.kill(pid);
-        unlinkSync(pidFile);
-        const endpoint = readRuntimeEndpointState();
-        if (endpoint?.pid === pid)
-            updateRuntimeEndpointStatus('stopped');
-        return true;
-    }
-    catch {
-        unlinkSync(pidFile);
-        const endpoint = readRuntimeEndpointState();
-        if (endpoint?.pid === pid)
-            updateRuntimeEndpointStatus('stopped');
-        return false;
-    }
+export async function startServer(options = {}) {
+    const root = options.projectRoot ?? process.cwd();
+    const result = await ensureCliRuntime({ reason: 'cli-start', projectRoot: root, port: options.port, explicitPort: options.explicitPort });
+    return { pid: result.state.pid, port: result.state.port, state: result.state, reused: result.reused };
 }
+export async function stopServer() { return (await getRuntimeManager().stop()).stopped; }
 export async function serverStatus() {
-    const pidFile = getPidFile(process.cwd());
-    const resolved = resolveRuntimeEndpoint();
-    const port = readPort(pidFile) ?? resolved.port;
-    const { DevFlowApiClient } = await import("@devflow-tools/sdk");
-    const client = new DevFlowApiClient({ baseUrl: `http://127.0.0.1:${port}`, projectRoot: process.cwd() });
-    const reachable = await client.ping();
-    if (reachable) {
-        const pid = readPid(pidFile) ?? undefined;
-        const state = readRuntimeEndpointState();
-        if (state && (!pid || state.pid === pid))
-            updateRuntimeEndpointStatus('healthy');
-        return { running: true, pid, port };
-    }
-    const state = readRuntimeEndpointState();
-    if (state && (!readPid(pidFile) || state.pid === readPid(pidFile)))
-        updateRuntimeEndpointStatus('degraded');
-    return { running: false, port };
-}
-async function waitForHealth(url, timeoutMs) {
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-        try {
-            const response = await fetch(new URL('/api/health', url), { signal: AbortSignal.timeout(500) });
-            if (response.ok)
-                return true;
-        }
-        catch { }
-        await new Promise(resolve => setTimeout(resolve, 100));
-    }
-    return false;
+    const state = await getRuntimeManager().status();
+    return { running: Boolean(state?.status === 'ready' && state.dashboardAvailable), pid: state?.pid, port: state?.port, state };
 }
 //# sourceMappingURL=server.js.map

package/dist/commands/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,oBAAoB,GAGrB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC,MAAM,UAAU,mBAAmB,CAAC,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE;IAC7D,MAAM,UAAU,GAAG;QACjB,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,oCAAoC,CAAC;QAC3D,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC;QACtF,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC;KAC7D,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IAC/F,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,iBAAiB,KAAK,OAAO,oBAAoB,EAAE,CAAC,CAAC,CAAC;AAUtE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA0B;IAC/D,OAAO,iBAAiB,EAAE,CAAC,aAAa,CAAC;QACvC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC,WAAW,CAAC;KACjD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAA2E,EAAE;IAC7G,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1I,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AACxG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,KAAuB,OAAO,CAAC,MAAM,iBAAiB,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAE3G,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,KAAK,GAAG,MAAM,iBAAiB,EAAE,CAAC,MAAM,EAAE,CAAC;IACjD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC,kBAAkB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAChI,CAAC"}

package/dist/commands/start.d.ts

@@ -1,5 +1,7 @@
-export declare function startAll(opts: {
-    port: number;
+export declare function startAll(options: {
+    port?: number;
     background: boolean;
+    explicitPort?: boolean;
+    projectRoot?: string;
 }): Promise<void>;
 //# sourceMappingURL=start.d.ts.map

package/dist/commands/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAgBA,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0ChB"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAIA,wBAAsB,QAAQ,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB3I"}

package/dist/commands/start.js

@@ -1,58 +1,31 @@
-import chalk from "chalk";
-import { startServer, stopServer } from "./server.js";
-async function waitForServer(port, timeoutMs = 15000) {
-    const start = Date.now();
-    while (Date.now() - start < timeoutMs) {
-        try {
-            const res = await fetch(`http://127.0.0.1:${port}/api/health`);
-            if (res.ok)
-                return true;
-        }
-        catch { }
-        await new Promise((r) => setTimeout(r, 500));
-    }
-    return false;
-}
-export async function startAll(opts) {
-    // 1. Start server (serves both API and dashboard static files)
-    console.log(chalk.blue("Starting DevFlow server..."));
-    const { pid: serverPid } = await startServer({ port: opts.port });
-    console.log(chalk.green(`  Server started (PID: ${serverPid})`));
-    // 2. Wait for server to be ready
-    console.log(chalk.blue("  Waiting for server..."));
-    const ready = await waitForServer(opts.port);
-    if (!ready) {
-        console.log(chalk.yellow("  Server started but health check timed out"));
-    }
-    else {
-        console.log(chalk.green("  Server ready"));
-    }
-    // 3. Print status
-    console.log("");
-    console.log(chalk.green("╔═══════════════════════════════════════════════════════════╗"));
-    console.log(chalk.green("║") + "  DevFlow Started!                                      " + chalk.green("║"));
-    console.log(chalk.green("╠═══════════════════════════════════════════════════════════╣"));
-    console.log(chalk.green("║") + `  Server + Dashboard: http://localhost:${opts.port}`.padEnd(57) + chalk.green("║"));
-    console.log(chalk.green("║") + `  API: http://localhost:${opts.port}/api`.padEnd(57) + chalk.green("║"));
-    console.log(chalk.green("║") + "                                                           " + chalk.green("║"));
-    console.log(chalk.green("║") + "  Press Ctrl+C to stop                                   " + chalk.green("║"));
-    console.log(chalk.green("╚═══════════════════════════════════════════════════════════╝"));
-    // 4. If not background, wait for Ctrl+C
-    if (!opts.background) {
-        await new Promise((resolve) => {
-            let cleaned = false;
-            const cleanup = async () => {
-                if (cleaned)
-                    return;
-                cleaned = true;
-                console.log(chalk.blue("\nShutting down..."));
-                await stopServer();
-                console.log(chalk.green("Server stopped."));
-                resolve();
-            };
-            process.on("SIGINT", cleanup);
-            process.on("SIGTERM", cleanup);
-        });
-    }
+import chalk from 'chalk';
+import { getRuntimeManager, startServer } from './server.js';
+import { runtimeMessage } from '../lib/messages.js';
+export async function startAll(options) {
+    const projectRoot = options.projectRoot ?? process.cwd();
+    console.log(chalk.blue(runtimeMessage('starting')));
+    const result = await startServer({ port: options.port, projectRoot, explicitPort: options.explicitPort });
+    console.log(chalk.green(runtimeMessage('ready', { url: result.state.url })));
+    if (result.reused)
+        console.log(chalk.dim(runtimeMessage('reused')));
+    if (options.background)
+        return;
+    await new Promise(resolve => {
+        let finished = false;
+        const cleanup = async () => {
+            if (finished)
+                return;
+            finished = true;
+            process.off('SIGINT', cleanup);
+            process.off('SIGTERM', cleanup);
+            const current = getRuntimeManager().readState();
+            if (!result.reused && current?.generation === result.state.generation && current.ownerToken === result.state.ownerToken) {
+                await getRuntimeManager().stop().catch(() => undefined);
+            }
+            resolve();
+        };
+        process.once('SIGINT', cleanup);
+        process.once('SIGTERM', cleanup);
+    });
 }
 //# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAA6F;IAC1H,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1G,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7E,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpE,IAAI,OAAO,CAAC,UAAU;QAAE,OAAO;IAE/B,MAAM,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;QAChC,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;YACxC,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAChC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC,SAAS,EAAE,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,EAAE,UAAU,KAAK,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,KAAK,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;gBACxH,MAAM,iBAAiB,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/status.d.ts

@@ -1,2 +1,5 @@
-export declare function showStatus(): Promise<void>;
+export declare function showStatus(options?: {
+    json?: boolean;
+    projectRoot?: string;
+}): Promise<void>;
 //# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAuBA,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAgDhD"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAwBA,wBAAsB,UAAU,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAuDtG"}

package/dist/commands/status.js

@@ -1,11 +1,12 @@
 import { existsSync, statSync } from "fs";
 import chalk from "chalk";
-import { serverStatus, DEFAULT_SERVER_PORT } from "./server.js";
+import { serverStatus } from "./server.js";
 import { getGlobalDevFlowDbPath } from "@devflow-tools/database";
 import { join } from "path";
 import { DatabaseSync } from "node:sqlite";
 import { homedir } from "node:os";
 import { resolveActivePlugin, scanClaudeSkillShadowing } from "../lib/plugin-setup.js";
+import { runtimeMessage } from "../lib/messages.js";
 function hasDevFlowTables(path) {
     if (!existsSync(path))
         return false;
@@ -22,19 +23,26 @@ function hasDevFlowTables(path) {
         return true;
     }
 }
-export async function showStatus() {
-    console.log(chalk.blue("DevFlow Status"));
+export async function showStatus(options = {}) {
+    const server = await serverStatus();
+    const projectRoot = options.projectRoot ?? process.cwd();
+    if (options.json) {
+        console.log(JSON.stringify({
+            runtime: server.state ?? null,
+            running: server.running,
+            project: { root: projectRoot, initialized: existsSync(join(projectRoot, '.devflow')) },
+        }));
+        return;
+    }
+    console.log(chalk.blue(runtimeMessage('statusHeader')));
     console.log(chalk.dim("──────────────"));
     // Server status
-    const server = await serverStatus();
-    const serverPort = server.port ?? DEFAULT_SERVER_PORT;
     if (server.running) {
-        console.log(`Server:    ${chalk.green("✓")} running (port ${serverPort}${server.pid ? `, PID ${server.pid}` : ""})`);
-        console.log(`Dashboard: ${chalk.green("✓")} served at http://localhost:${serverPort}`);
+        const state = server.state;
+        console.log(chalk.green(runtimeMessage('running', { url: state.url, pid: state.pid, generation: state.generation })));
     }
     else {
-        console.log(`Server:    ${chalk.yellow("○")} not running`);
-        console.log(`Dashboard: ${chalk.yellow("○")} not running`);
+        console.log(chalk.yellow(runtimeMessage(server.state ? 'dashboardUnavailable' : 'notRunning', { status: server.state?.status ?? 'stopped' })));
     }
     const home = homedir();
     const activePlugin = resolveActivePlugin(home);

package/dist/commands/status.js.map

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

package/dist/commands/stop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AAGA,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAO7C"}
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AAIA,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAO7C"}

package/dist/commands/stop.js

@@ -1,12 +1,13 @@
 import chalk from "chalk";
 import { stopServer } from "./server.js";
+import { runtimeMessage } from "../lib/messages.js";
 export async function stopAll() {
     const stopped = await stopServer();
     if (stopped) {
-        console.log(chalk.green("Server stopped"));
+        console.log(chalk.green(runtimeMessage('stopped')));
     }
     else {
-        console.log(chalk.dim("No DevFlow services running"));
+        console.log(chalk.dim(runtimeMessage('notRunning')));
     }
 }
 //# sourceMappingURL=stop.js.map

package/dist/commands/stop.js.map

@@ -1 +1 @@
-{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;AACH,CAAC"}

package/dist/index.js

@@ -5,6 +5,7 @@ import fs from "fs";
 import path from "path";
 import { detectMode } from "./mode.js";
 import { createRequire } from "module";
+import { execFile } from "node:child_process";
 const require = createRequire(import.meta.url);
 // Read version from package.json at runtime
 // Installed: dist/cli.js → ../package.json = packages/devflow/package.json
@@ -22,6 +23,19 @@ catch {
     }
 }
 const program = new Command();
+function openDashboardUrl(url) {
+    const parsed = new URL(url);
+    if (parsed.protocol !== 'http:' || parsed.hostname !== '127.0.0.1')
+        return Promise.reject(new Error('Only loopback Dashboard URLs can be opened.'));
+    const [command, args] = process.platform === 'darwin'
+        ? ['/usr/bin/open', [url]]
+        : process.platform === 'win32'
+            ? ['cmd.exe', ['/c', 'start', '', url]]
+            : ['xdg-open', [url]];
+    return new Promise((resolve, reject) => {
+        execFile(command, args, error => error ? reject(error) : resolve());
+    });
+}
 program
     .name("devflow")
     .description("Developer Intelligence Platform for AI Coding Agents")
@@ -821,43 +835,71 @@ serverCmd
     .command("start")
     .description("Start the DevFlow REST server")
     .option("--port <n>", "Port number", "13337")
-    .action(async (opts) => {
-    console.log(chalk.blue("Starting DevFlow server..."));
+    .action(async (opts, command) => {
     const { startServer } = await import("./commands/server.js");
-    const result = await startServer({ port: parseInt(opts.port, 10) });
-    console.log(chalk.green(`Server started (pid: ${result.pid}) on port ${opts.port}`));
+    const { runtimeMessage } = await import('./lib/messages.js');
+    console.log(chalk.blue(runtimeMessage('starting')));
+    const result = await startServer({ port: Number(opts.port), explicitPort: command.getOptionValueSource('port') === 'cli' });
+    console.log(chalk.green(runtimeMessage('ready', { url: result.state.url })));
+    if (result.reused)
+        console.log(chalk.dim(runtimeMessage('reused')));
 });
 serverCmd
     .command("stop")
     .description("Stop the DevFlow REST server")
     .action(async () => {
     const { stopServer } = await import("./commands/server.js");
+    const { runtimeMessage } = await import('./lib/messages.js');
     const ok = await stopServer();
     if (ok)
-        console.log(chalk.green("Server stopped"));
+        console.log(chalk.green(runtimeMessage('stopped')));
     else
-        console.log(chalk.dim("No server running"));
+        console.log(chalk.dim(runtimeMessage('notRunning')));
 });
 serverCmd
     .command("status")
     .description("Show server status")
     .action(async () => {
     const { serverStatus } = await import("./commands/server.js");
+    const { runtimeMessage } = await import('./lib/messages.js');
     const status = await serverStatus();
-    if (status.running)
-        console.log(chalk.green(`Running (pid: ${status.pid})`));
+    if (status.running && status.state)
+        console.log(chalk.green(runtimeMessage('running', { url: status.state.url, pid: status.state.pid, generation: status.state.generation })));
     else
-        console.log(chalk.yellow("Not running"));
+        console.log(chalk.yellow(runtimeMessage(status.state ? 'dashboardUnavailable' : 'notRunning', { status: status.state?.status ?? 'stopped' })));
 });
 // --- dashboard ---
 program
     .command("dashboard")
     .description("Open DevFlow Dashboard")
-    .action(async () => {
-    const { resolveRuntimeEndpoint } = await import("@devflow-tools/sdk");
-    console.log(chalk.blue("The Dashboard is served by the DevFlow server."));
-    console.log(chalk.dim("Run: devflow start"));
-    console.log(chalk.dim(`Then open: ${resolveRuntimeEndpoint().url}`));
+    .option('--open', 'Open the ready Dashboard URL in the default browser')
+    .option('--no-start', 'Return an error when no ready runtime exists')
+    .option('--json', 'Print a stable JSON result')
+    .option('--project <path>', 'Project root', process.cwd())
+    .option('--port <n>', 'Runtime port')
+    .action(async (opts, command) => {
+    const { ensureCliRuntime } = await import('./commands/server.js');
+    const { runtimeMessage } = await import('./lib/messages.js');
+    const projectRoot = path.resolve(opts.project);
+    if (!fs.existsSync(projectRoot) || !fs.statSync(projectRoot).isDirectory())
+        throw new Error(runtimeMessage('projectRequired'));
+    const result = await ensureCliRuntime({ reason: 'cli-dashboard', projectRoot, port: opts.port === undefined ? undefined : Number(opts.port), explicitPort: command.getOptionValueSource('port') === 'cli', noStart: opts.start === false });
+    const document = { url: result.state.url, projectId: result.projectId, runtime: result.state, reused: result.reused };
+    if (opts.json)
+        console.log(JSON.stringify(document));
+    else {
+        console.log(chalk.green(runtimeMessage('ready', { url: result.state.url })));
+        if (result.reused)
+            console.log(chalk.dim(runtimeMessage('reused')));
+    }
+    if (opts.open) {
+        try {
+            await openDashboardUrl(result.state.url);
+        }
+        catch (error) {
+            console.error(chalk.yellow(runtimeMessage('openingFailed', { message: error instanceof Error ? error.message : String(error) })));
+        }
+    }
 });
 // --- start ---
 program
@@ -865,11 +907,12 @@ program
     .description("Start DevFlow server (API + Dashboard)")
     .option("--port <n>", "Server port", "13337")
     .option("-d, --background", "Run in background (detached)")
-    .action(async (opts) => {
+    .action(async (opts, command) => {
     const { startAll } = await import("./commands/start.js");
     await startAll({
-        port: parseInt(opts.port, 10),
+        port: Number(opts.port),
         background: !!opts.background,
+        explicitPort: command.getOptionValueSource('port') === 'cli',
     });
 });
 // --- stop ---
@@ -884,9 +927,11 @@ program
 program
     .command("status")
     .description("Show DevFlow services status")
-    .action(async () => {
+    .option('--json', 'Print a stable JSON result')
+    .option('--project <path>', 'Project root', process.cwd())
+    .action(async (opts) => {
     const { showStatus } = await import("./commands/status.js");
-    await showStatus();
+    await showStatus({ json: Boolean(opts.json), projectRoot: path.resolve(opts.project) });
 });
 // --- setup ---
 program