@kntic/kntic 0.3.0 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kntic/kntic",
-  "version": "0.3.0",
+  "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));
+  });
+});

package/src/commands/update.js

@@ -109,6 +109,35 @@ function extractVersion(artifactFilename) {
   return match[1];
 }
 
+/**
+ * Update or create the KNTIC_VERSION variable in a .kntic.env file.
+ * If the file exists and contains a KNTIC_VERSION line, that line is replaced.
+ * If the file exists but has no KNTIC_VERSION, it is appended.
+ * If the file does not exist, it is created with the variable.
+ *
+ * @param {string} version   – semantic version string (e.g. "0.0.10")
+ * @param {string} envPath   – path to .kntic.env (default: ".kntic.env")
+ */
+function updateEnvVersion(version, envPath = ".kntic.env") {
+  const line = `KNTIC_VERSION=${version}`;
+
+  if (!fs.existsSync(envPath)) {
+    fs.writeFileSync(envPath, line + "\n");
+    return;
+  }
+
+  const content = fs.readFileSync(envPath, "utf8");
+  const regex = /^KNTIC_VERSION=.*$/m;
+
+  if (regex.test(content)) {
+    const updated = content.replace(regex, line);
+    fs.writeFileSync(envPath, updated);
+  } else {
+    const separator = content.endsWith("\n") ? "" : "\n";
+    fs.writeFileSync(envPath, content + separator + line + "\n");
+  }
+}
+
 /**
  * Recursively remove all contents of a directory (but not the directory itself).
  */
@@ -166,6 +195,9 @@ async function update() {
   console.log("Updating .kntic/lib …");
   extractLibOnly(tmpFile, ".");
 
+  // Update KNTIC_VERSION in .kntic.env
+  updateEnvVersion(version);
+
   // Clean up
   fs.unlinkSync(tmpFile);
 
@@ -177,3 +209,4 @@ module.exports = update;
 module.exports.extractLibOnly = extractLibOnly;
 module.exports.extractVersion = extractVersion;
 module.exports.clearDirectory = clearDirectory;
+module.exports.updateEnvVersion = updateEnvVersion;

package/src/commands/update.test.js

@@ -7,7 +7,7 @@ const path = require("path");
 const os = require("os");
 const { execSync } = require("child_process");
 
-const { extractLibOnly, extractVersion, clearDirectory } = require("./update");
+const { extractLibOnly, extractVersion, clearDirectory, updateEnvVersion } = require("./update");
 
 /**
  * Helper — create a tar.gz archive in `tmpDir` containing the given files.
@@ -202,6 +202,63 @@ describe("extractLibOnly", () => {
   });
 });
 
+describe("updateEnvVersion", () => {
+  let tmpDir;
+
+  beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "kntic-test-env-"));
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it("creates the file with KNTIC_VERSION if it does not exist", () => {
+    const envPath = path.join(tmpDir, ".kntic.env");
+    updateEnvVersion("1.2.3", envPath);
+
+    assert.equal(fs.readFileSync(envPath, "utf8"), "KNTIC_VERSION=1.2.3\n");
+  });
+
+  it("appends KNTIC_VERSION if file exists but variable is missing", () => {
+    const envPath = path.join(tmpDir, ".kntic.env");
+    fs.writeFileSync(envPath, "UID=1000\nGID=1000\n");
+
+    updateEnvVersion("0.0.10", envPath);
+
+    const content = fs.readFileSync(envPath, "utf8");
+    assert.ok(content.includes("UID=1000"), "existing content must be preserved");
+    assert.ok(content.includes("GID=1000"), "existing content must be preserved");
+    assert.ok(content.includes("KNTIC_VERSION=0.0.10"), "version must be appended");
+  });
+
+  it("replaces existing KNTIC_VERSION in-place", () => {
+    const envPath = path.join(tmpDir, ".kntic.env");
+    fs.writeFileSync(envPath, "UID=1000\nKNTIC_VERSION=0.0.1\nGID=1000\n");
+
+    updateEnvVersion("2.0.0", envPath);
+
+    const content = fs.readFileSync(envPath, "utf8");
+    assert.ok(content.includes("KNTIC_VERSION=2.0.0"), "version must be updated");
+    assert.ok(!content.includes("KNTIC_VERSION=0.0.1"), "old version must be gone");
+    assert.ok(content.includes("UID=1000"), "other vars must be preserved");
+    assert.ok(content.includes("GID=1000"), "other vars must be preserved");
+  });
+
+  it("handles file without trailing newline when appending", () => {
+    const envPath = path.join(tmpDir, ".kntic.env");
+    fs.writeFileSync(envPath, "UID=1000");
+
+    updateEnvVersion("0.1.0", envPath);
+
+    const content = fs.readFileSync(envPath, "utf8");
+    assert.ok(content.includes("UID=1000"), "existing content must be preserved");
+    assert.ok(content.includes("KNTIC_VERSION=0.1.0"), "version must be appended");
+    // Ensure they're on separate lines
+    assert.ok(content.includes("UID=1000\nKNTIC_VERSION=0.1.0"), "must be on separate lines");
+  });
+});
+
 describe("extractVersion (update module)", () => {
   it("parses version from artifact filename", () => {
     assert.equal(extractVersion("kntic-bootstrap-v0.0.10.tar.gz"), "0.0.10");