@kntic/kntic 0.3.1 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kntic/kntic",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "author": "Thomas Robak <contact@kntic.ai> (https://kntic.ai)",
   "description": "KNTIC CLI — bootstrap and manage KNTIC projects",
   "main": "src/index.js",

package/src/commands/start.js

@@ -1,10 +1,42 @@
 "use strict";
 
 const { execSync } = require("child_process");
+const { readFileSync } = require("fs");
+const { basename } = require("path");
+
+function isScreenAvailable() {
+  try {
+    execSync("which screen", { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function getScreenName() {
+  try {
+    const content = readFileSync(".kntic.env", "utf8");
+    const match = content.match(/^KNTIC_PRJ_PREFIX=(.+)$/m);
+    if (match && match[1].trim()) {
+      return match[1].trim();
+    }
+  } catch {
+    // .kntic.env not found or unreadable — fall through
+  }
+  return basename(process.cwd());
+}
 
 function start() {
-  console.log("Starting KNTIC services…");
-  execSync("docker compose -f kntic.yml --env-file .kntic.env up --build", { stdio: "inherit" });
+  const composeCmd = "docker compose -f kntic.yml --env-file .kntic.env up --build";
+
+  if (isScreenAvailable()) {
+    const screenName = getScreenName();
+    console.log(`Starting KNTIC services in screen session "${screenName}"…`);
+    execSync(`screen -S ${screenName} ${composeCmd}`, { stdio: "inherit" });
+  } else {
+    console.log("Starting KNTIC services…");
+    execSync(composeCmd, { stdio: "inherit" });
+  }
 }
 
 module.exports = start;

package/src/commands/start.test.js

@@ -0,0 +1,72 @@
+"use strict";
+
+const { describe, it, beforeEach, afterEach } = require("node:test");
+const assert = require("node:assert/strict");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+// We test the helper logic by requiring the module and inspecting behaviour.
+// Since start.js uses execSync (side-effecting), we test the screen-name
+// resolution logic and the screen-detection path indirectly.
+
+describe("start — getScreenName resolution", () => {
+  let tmpDir, origCwd;
+
+  beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "kntic-start-test-"));
+    origCwd = process.cwd();
+    process.chdir(tmpDir);
+  });
+
+  afterEach(() => {
+    process.chdir(origCwd);
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it("uses KNTIC_PRJ_PREFIX from .kntic.env when present", () => {
+    fs.writeFileSync(path.join(tmpDir, ".kntic.env"), "UID=1000\nKNTIC_PRJ_PREFIX=myproject\nGID=1000\n");
+    // Re-require to get fresh module (clear cache)
+    delete require.cache[require.resolve("./start")];
+    // We can't call start() directly (it execs docker), so we extract getScreenName
+    // by reading the source and evaluating the helper in isolation.
+    const src = fs.readFileSync(require.resolve("./start"), "utf8");
+    const getScreenName = new Function("require", "process",
+      src.replace(/^"use strict";\s*/, "")
+         .replace(/module\.exports\s*=\s*start;/, "return getScreenName;")
+    )(require, process);
+    assert.equal(getScreenName(), "myproject");
+  });
+
+  it("falls back to current directory name when KNTIC_PRJ_PREFIX is missing", () => {
+    fs.writeFileSync(path.join(tmpDir, ".kntic.env"), "UID=1000\nGID=1000\n");
+    delete require.cache[require.resolve("./start")];
+    const src = fs.readFileSync(require.resolve("./start"), "utf8");
+    const getScreenName = new Function("require", "process",
+      src.replace(/^"use strict";\s*/, "")
+         .replace(/module\.exports\s*=\s*start;/, "return getScreenName;")
+    )(require, process);
+    assert.equal(getScreenName(), path.basename(tmpDir));
+  });
+
+  it("falls back to current directory name when .kntic.env does not exist", () => {
+    delete require.cache[require.resolve("./start")];
+    const src = fs.readFileSync(require.resolve("./start"), "utf8");
+    const getScreenName = new Function("require", "process",
+      src.replace(/^"use strict";\s*/, "")
+         .replace(/module\.exports\s*=\s*start;/, "return getScreenName;")
+    )(require, process);
+    assert.equal(getScreenName(), path.basename(tmpDir));
+  });
+
+  it("ignores empty KNTIC_PRJ_PREFIX value", () => {
+    fs.writeFileSync(path.join(tmpDir, ".kntic.env"), "KNTIC_PRJ_PREFIX=\nUID=1000\n");
+    delete require.cache[require.resolve("./start")];
+    const src = fs.readFileSync(require.resolve("./start"), "utf8");
+    const getScreenName = new Function("require", "process",
+      src.replace(/^"use strict";\s*/, "")
+         .replace(/module\.exports\s*=\s*start;/, "return getScreenName;")
+    )(require, process);
+    assert.equal(getScreenName(), path.basename(tmpDir));
+  });
+});