kandev 0.1.5 → 0.2.0

package/README.md

@@ -10,6 +10,13 @@ npx kandev
 
 Downloads the latest release, starts the backend + web app, and opens your browser. Data (worktrees, SQLite DB) is stored in `~/.kandev` by default.
 
+## Version and Updates
+
+- `npx kandev` (run mode) uses the latest GitHub release bundle by default.
+- At startup, the launcher prints the resolved release tag (for example: `[kandev] release: v0.2.3 (github latest)`).
+- Use `--version <tag>` to pin a specific runtime bundle release.
+- CLI package updates are checked from npm and shown as a prompt. They are not forced.
+
 ## What You Get
 
 - **Multi-agent support** - Claude Code, Codex, GitHub Copilot, Gemini CLI, Amp, Auggie, OpenCode

package/dist/dev.js

@@ -13,9 +13,20 @@ const shared_1 = require("./shared");
 const web_1 = require("./web");
 async function runDev({ repoRoot, backendPort, webPort }) {
     const ports = await (0, shared_1.pickPorts)(backendPort, webPort);
-    const backendEnv = (0, shared_1.buildBackendEnv)({ ports, extra: { KANDEV_MOCK_AGENT: "true" } });
+    const dbPath = node_path_1.default.join(repoRoot, "apps", "backend", "kandev.db");
+    const backendEnv = (0, shared_1.buildBackendEnv)({
+        ports,
+        extra: { KANDEV_MOCK_AGENT: "true", KANDEV_DATABASE_PATH: dbPath },
+    });
     const webEnv = (0, shared_1.buildWebEnv)({ ports, includeMcp: true, debug: true });
-    (0, shared_1.logPortConfig)("dev", "using local repo", ports, 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)();
     supervisor.attachSignalHandlers();
     const backendProc = (0, node_child_process_1.spawn)("make", ["-C", node_path_1.default.join("apps", "backend"), "dev"], {

package/dist/run.js

@@ -44,17 +44,19 @@ async function prepareReleaseBundle({ version, backendPort, webPort, }) {
     const actualWebPort = webPort ?? (await (0, ports_1.pickAvailablePort)(constants_1.DEFAULT_WEB_PORT));
     const agentctlPort = await (0, ports_1.pickAvailablePort)(constants_1.DEFAULT_AGENTCTL_PORT);
     const backendUrl = `http://localhost:${actualBackendPort}`;
+    const logLevel = process.env.KANDEV_LOG_LEVEL?.trim() || "warn";
     node_fs_1.default.mkdirSync(constants_1.DATA_DIR, { recursive: true });
     const dbPath = node_path_1.default.join(constants_1.DATA_DIR, "kandev.db");
     // Note: Release mode doesn't configure MCP server ports as it uses
     // the bundled configuration. Only backend and agentctl ports are set.
-    // Log level is set to warn for clean production output.
+    // Log level defaults to warn for clean output and can be overridden
+    // via KANDEV_LOG_LEVEL.
     const backendEnv = {
         ...process.env,
         KANDEV_SERVER_PORT: String(actualBackendPort),
         KANDEV_AGENT_STANDALONE_PORT: String(agentctlPort),
         KANDEV_DATABASE_PATH: dbPath,
-        KANDEV_LOG_LEVEL: "warn",
+        KANDEV_LOG_LEVEL: logLevel,
     };
     const webEnv = {
         ...process.env,
@@ -69,14 +71,31 @@ async function prepareReleaseBundle({ version, backendPort, webPort, }) {
         backendUrl,
         backendEnv,
         webEnv,
+        releaseTag: tag,
+        requestedVersion: version,
         webPort: actualWebPort,
         agentctlPort,
+        dbPath,
+        logLevel,
     };
 }
 function launchReleaseApps(prepared) {
-    console.log("[kandev] backend port:", prepared.backendEnv.KANDEV_SERVER_PORT);
-    console.log("[kandev] web port:", prepared.webPort);
-    console.log("[kandev] agentctl port:", prepared.agentctlPort);
+    const releaseSource = prepared.requestedVersion
+        ? `(requested: ${prepared.requestedVersion})`
+        : "(github latest)";
+    (0, shared_1.logStartupInfo)({
+        header: `release: ${prepared.releaseTag} ${releaseSource}`,
+        ports: {
+            backendPort: Number(prepared.backendEnv.KANDEV_SERVER_PORT),
+            webPort: prepared.webPort,
+            agentctlPort: prepared.agentctlPort,
+            mcpPort: 0,
+            backendUrl: prepared.backendUrl,
+            mcpUrl: "",
+        },
+        dbPath: prepared.dbPath,
+        logLevel: prepared.logLevel,
+    });
     const supervisor = (0, process_1.createProcessSupervisor)();
     supervisor.attachSignalHandlers();
     const backendProc = (0, node_child_process_1.spawn)(prepared.backendBin, [], {

package/dist/shared.js

@@ -9,7 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.pickPorts = pickPorts;
 exports.buildBackendEnv = buildBackendEnv;
 exports.buildWebEnv = buildWebEnv;
-exports.logPortConfig = logPortConfig;
+exports.logStartupInfo = logStartupInfo;
 exports.attachBackendExitHandler = attachBackendExitHandler;
 const constants_1 = require("./constants");
 const ports_1 = require("./ports");
@@ -83,15 +83,11 @@ function buildWebEnv(options) {
     return env;
 }
 /**
- * Logs port configuration to the console.
- *
- * @param mode - The launch mode name (e.g., "dev", "production", "release")
- * @param modeDescription - Human-readable description of the mode
- * @param ports - Port configuration to log
- * @param includeMcp - Whether to log MCP-related ports
+ * Logs a unified startup info block to the console.
  */
-function logPortConfig(mode, modeDescription, ports, includeMcp = false) {
-    console.log(`[kandev] ${mode} mode: ${modeDescription}`);
+function logStartupInfo(options) {
+    const { header, ports, dbPath, includeMcp = false, logLevel } = options;
+    console.log(`[kandev] ${header}`);
     console.log("[kandev] backend port:", ports.backendPort);
     console.log("[kandev] web port:", ports.webPort);
     console.log("[kandev] agentctl port:", ports.agentctlPort);
@@ -99,6 +95,12 @@ function logPortConfig(mode, modeDescription, ports, includeMcp = false) {
         console.log("[kandev] mcp port:", ports.mcpPort);
         console.log("[kandev] mcp url:", ports.mcpUrl);
     }
+    if (dbPath) {
+        console.log("[kandev] db path:", dbPath);
+    }
+    if (logLevel) {
+        console.log("[kandev] log level:", logLevel);
+    }
 }
 /**
  * Attaches a standardized exit handler to a backend process.

package/dist/start.js

@@ -75,15 +75,23 @@ 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 = node_path_1.default.join(constants_1.DATA_DIR, "kandev.db");
+    const logLevel = debug ? "debug" : verbose ? "info" : "warn";
     const backendEnv = (0, shared_1.buildBackendEnv)({
         ports,
-        logLevel: debug ? "debug" : verbose ? "info" : "warn",
+        logLevel,
         extra: {
             KANDEV_DATABASE_PATH: dbPath,
             ...(debug ? { KANDEV_DEBUG_AGENT_MESSAGES: "true" } : {}),
         },
     });
     const webEnv = (0, shared_1.buildWebEnv)({ ports, includeMcp: true, production: true, debug });
+    (0, shared_1.logStartupInfo)({
+        header: "start mode: using local build",
+        ports,
+        dbPath,
+        includeMcp: true,
+        logLevel,
+    });
     const supervisor = (0, process_1.createProcessSupervisor)();
     supervisor.attachSignalHandlers();
     // Start backend with piped stdio (quiet mode unless verbose/debug)
@@ -112,13 +120,6 @@ async function runStart({ repoRoot, backendPort, webPort, verbose = false, debug
         label: "web",
         quiet: !showOutput,
     });
-    // Print clean summary
-    console.log("");
-    console.log("[kandev] Server started successfully");
-    console.log("");
-    console.log(`  Web:      ${webUrl}`);
-    console.log(`  API:      ${ports.backendUrl}`);
-    console.log(`  MCP:      ${ports.mcpUrl}`);
-    console.log(`  Database: ${dbPath}`);
-    console.log("");
+    console.log(`[kandev] backend ready at ${ports.backendUrl}`);
+    console.log(`[kandev] web ready at ${webUrl}`);
 }

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "kandev",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "private": false,
   "description": "NPX launcher for Kandev",
-  "license": "UNLICENSED",
+  "license": "AGPL-3.0-only",
   "type": "commonjs",
   "bin": {
     "kandev": "bin/cli.js"