kandev 0.9.0 → 0.11.0

package/dist/cli.js

@@ -36,8 +36,8 @@ Options:
   run             Use release bundles (default).
   --dev            Alias for "dev".
   --version        Release tag to install (default: latest).
-  --backend-port   Override backend port.
-  --web-port       Override web port.
+  --backend-port   Override backend port (or KANDEV_BACKEND_PORT env var).
+  --web-port       Override web port (or KANDEV_WEB_PORT env var).
   --verbose, -v    Show info logs from backend + web (start mode only).
   --debug          Show debug logs + agent message dumps (start mode only).
   --help, -h       Show help.
@@ -97,6 +97,10 @@ function parseArgs(argv) {
     }
     return opts;
 }
+function envPort(name) {
+    const val = process.env[name];
+    return val ? Number(val) : undefined;
+}
 function findRepoRoot(startDir) {
     let current = node_path_1.default.resolve(startDir);
     while (true) {
@@ -121,8 +125,8 @@ function findRepoRoot(startDir) {
 }
 async function main() {
     const raw = parseArgs(process.argv.slice(2));
-    const backendPort = (0, ports_1.ensureValidPort)(raw.backendPort, "backend port");
-    const webPort = (0, ports_1.ensureValidPort)(raw.webPort, "web port");
+    const backendPort = (0, ports_1.ensureValidPort)(raw.backendPort ?? envPort("KANDEV_BACKEND_PORT"), "backend port");
+    const webPort = (0, ports_1.ensureValidPort)(raw.webPort ?? envPort("KANDEV_WEB_PORT"), "web port");
     if (raw.command === "dev") {
         const repoRoot = findRepoRoot(process.cwd());
         if (!repoRoot) {

package/dist/constants.js

@@ -17,7 +17,7 @@ exports.RANDOM_PORT_MAX = 60000;
 exports.RANDOM_PORT_RETRIES = 10;
 // Backend healthcheck timeout during startup.
 exports.HEALTH_TIMEOUT_MS_RELEASE = 15000;
-exports.HEALTH_TIMEOUT_MS_DEV = 60000;
+exports.HEALTH_TIMEOUT_MS_DEV = 600000;
 // Local user cache/data directories for release bundles and DB.
 exports.CACHE_DIR = node_path_1.default.join(node_os_1.default.homedir(), ".kandev", "bin");
 exports.DATA_DIR = node_path_1.default.join(node_os_1.default.homedir(), ".kandev", "data");

package/dist/dev.js

@@ -19,13 +19,12 @@ async function runDev({ repoRoot, backendPort, webPort }) {
         KANDEV_MOCK_AGENT: process.env.KANDEV_MOCK_AGENT || "true",
     };
     const backendEnv = (0, shared_1.buildBackendEnv)({ ports, extra });
-    const webEnv = (0, shared_1.buildWebEnv)({ ports, includeMcp: true, debug: true });
+    const webEnv = (0, shared_1.buildWebEnv)({ ports, debug: true });
     const logLevel = process.env.KANDEV_LOGGING_LEVEL?.trim() || process.env.KANDEV_LOG_LEVEL?.trim() || "info";
     (0, shared_1.logStartupInfo)({
         header: "dev mode: using local repo",
         ports,
         dbPath,
-        includeMcp: true,
         logLevel,
     });
     const supervisor = (0, process_1.createProcessSupervisor)();

package/dist/run.js

@@ -132,6 +132,7 @@ async function prepareReleaseBundle({ version, backendPort, webPort, }) {
     const backendEnv = {
         ...process.env,
         KANDEV_SERVER_PORT: String(actualBackendPort),
+        KANDEV_WEB_INTERNAL_URL: `http://localhost:${actualWebPort}`,
         KANDEV_AGENT_STANDALONE_PORT: String(agentctlPort),
         KANDEV_DATABASE_PATH: dbPath,
         KANDEV_LOG_LEVEL: logLevel,
@@ -139,7 +140,6 @@ async function prepareReleaseBundle({ version, backendPort, webPort, }) {
     const webEnv = {
         ...process.env,
         KANDEV_API_BASE_URL: backendUrl,
-        NEXT_PUBLIC_KANDEV_API_BASE_URL: backendUrl,
         PORT: String(actualWebPort),
     };
     webEnv.NODE_ENV = "production";
@@ -208,6 +208,6 @@ async function runRelease({ version, backendPort, webPort }) {
         quiet: true,
     });
     await (0, health_1.waitForUrlReady)(webUrl, webProc, healthTimeoutMs);
-    console.log(`[kandev] web ready at ${webUrl}`);
-    (0, web_1.openBrowser)(webUrl);
+    console.log("[kandev] ready at " + prepared.backendUrl);
+    (0, web_1.openBrowser)(prepared.backendUrl);
 }

package/dist/shared.js

@@ -45,6 +45,7 @@ function buildBackendEnv(options) {
     return {
         ...process.env,
         KANDEV_SERVER_PORT: String(ports.backendPort),
+        KANDEV_WEB_INTERNAL_URL: `http://localhost:${ports.webPort}`,
         KANDEV_AGENT_STANDALONE_PORT: String(ports.agentctlPort),
         KANDEV_AGENT_MCP_SERVER_PORT: String(ports.mcpPort),
         ...(logLevel ? { KANDEV_LOG_LEVEL: logLevel } : {}),
@@ -58,22 +59,16 @@ function buildBackendEnv(options) {
  * @returns Environment object for the web process
  */
 function buildWebEnv(options) {
-    const { ports, includeMcp = false, production = false, debug = false } = options;
-    // Server-side env vars use localhost (SSR runs on same machine as backend)
-    // Client-side uses NEXT_PUBLIC_*_PORT to build URLs dynamically from window.location.hostname
-    // This allows accessing the app from any device (iPhone, Tailscale, etc.)
+    const { ports, production = false, debug = false } = options;
     const env = {
         ...process.env,
-        // Server-side: full localhost URL for SSR
+        // Server-side: full localhost URL for SSR fetches (Next.js SSR → Go backend)
         KANDEV_API_BASE_URL: ports.backendUrl,
-        // Client-side: only pass ports, client builds URL from current hostname
+        // Client-side: port injection for dev mode (browser on :3000, API on :8080).
+        // In production, the backend reverse-proxies Next.js so the client uses same-origin.
         NEXT_PUBLIC_KANDEV_API_PORT: String(ports.backendPort),
         PORT: String(ports.webPort),
     };
-    if (includeMcp) {
-        env.KANDEV_MCP_SERVER_URL = ports.mcpUrl;
-        env.NEXT_PUBLIC_KANDEV_MCP_PORT = String(ports.mcpPort);
-    }
     if (production) {
         env.NODE_ENV = "production";
     }
@@ -86,15 +81,12 @@ function buildWebEnv(options) {
  * Logs a unified startup info block to the console.
  */
 function logStartupInfo(options) {
-    const { header, ports, dbPath, includeMcp = false, logLevel } = options;
+    const { header, ports, dbPath, logLevel } = options;
     console.log(`[kandev] ${header}`);
-    console.log("[kandev] backend port:", ports.backendPort);
-    console.log("[kandev] web port:", ports.webPort);
+    console.log("[kandev] url: http://localhost:" + ports.backendPort);
     console.log("[kandev] agentctl port:", ports.agentctlPort);
-    if (includeMcp) {
-        console.log("[kandev] mcp port:", ports.mcpPort);
-        console.log("[kandev] mcp url:", ports.mcpUrl);
-    }
+    console.log("[kandev] mcp port:", ports.mcpPort);
+    console.log("[kandev] mcp url:", ports.mcpUrl);
     if (dbPath) {
         console.log("[kandev] db path:", dbPath);
     }

package/dist/start.js

@@ -75,7 +75,7 @@ async function runStart({ repoRoot, backendPort, webPort, verbose = false, debug
     // Production mode: use warn log level for clean output unless verbose/debug
     const showOutput = verbose || debug;
     const dbPath = process.env.KANDEV_DATABASE_PATH || node_path_1.default.join(constants_1.DATA_DIR, "kandev.db");
-    const logLevel = debug ? "debug" : verbose ? "info" : "warn";
+    const logLevel = process.env.KANDEV_LOG_LEVEL?.trim() || (debug ? "debug" : verbose ? "info" : "warn");
     const backendEnv = (0, shared_1.buildBackendEnv)({
         ports,
         logLevel,
@@ -84,12 +84,11 @@ async function runStart({ repoRoot, backendPort, webPort, verbose = false, debug
             ...(debug ? { KANDEV_DEBUG_AGENT_MESSAGES: "true" } : {}),
         },
     });
-    const webEnv = (0, shared_1.buildWebEnv)({ ports, includeMcp: true, production: true, debug });
+    const webEnv = (0, shared_1.buildWebEnv)({ ports, production: true, debug });
     (0, shared_1.logStartupInfo)({
         header: "start mode: using local build",
         ports,
         dbPath,
-        includeMcp: true,
         logLevel,
     });
     const supervisor = (0, process_1.createProcessSupervisor)();
@@ -123,6 +122,6 @@ async function runStart({ repoRoot, backendPort, webPort, verbose = false, debug
         quiet: !showOutput,
     });
     await (0, health_1.waitForUrlReady)(webUrl, webProc, healthTimeoutMs);
-    console.log(`[kandev] web ready at ${webUrl}`);
-    (0, web_1.openBrowser)(webUrl);
+    console.log("[kandev] ready at " + ports.backendUrl);
+    (0, web_1.openBrowser)(ports.backendUrl);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kandev",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "private": false,
   "description": "NPX launcher for Kandev",
   "license": "AGPL-3.0-only",
@@ -14,7 +14,7 @@
     "dist"
   ],
   "dependencies": {
-    "tar": "^7.5.0",
+    "tar": "^7.5.10",
     "tree-kill": "^1.2.2"
   },
   "devDependencies": {