@kntic/kntic 0.4.1 → 0.4.3

package/package.json

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

package/src/cli.js

@@ -16,7 +16,8 @@ if (!subcommand || subcommand === "usage") {
   });
 } else if (subcommand === "start") {
   try {
-    commands.start();
+    const startOpts = { screen: args.includes("--screen") };
+    commands.start(startOpts);
   } catch (err) {
     console.error(`Error: ${err.message}`);
     process.exit(1);
@@ -29,7 +30,8 @@ if (!subcommand || subcommand === "usage") {
     process.exit(1);
   }
 } else if (subcommand === "update") {
-  commands.update().catch((err) => {
+  const updateOpts = { libOnly: args.includes("--lib-only") };
+  commands.update(updateOpts).catch((err) => {
     console.error(`Error: ${err.message}`);
     process.exit(1);
   });

package/src/commands/start.js

@@ -30,16 +30,19 @@ function getScreenName() {
   return basename(process.cwd());
 }
 
-function start() {
+function start(options = {}) {
   const composeCmd = "docker compose -f kntic.yml --env-file .kntic.env up --build";
+  const useScreen = !!options.screen;
 
-  if (isScreenAvailable() && !isInsideScreen()) {
+  if (useScreen && isScreenAvailable() && !isInsideScreen()) {
     const screenName = getScreenName();
     console.log(`Starting KNTIC services in screen session "${screenName}"…`);
     execSync(`screen -S ${screenName} ${composeCmd}`, { stdio: "inherit" });
   } else {
-    if (isInsideScreen()) {
+    if (useScreen && isInsideScreen()) {
       console.log("Already inside a screen session, skipping screen wrapper.");
+    } else if (useScreen && !isScreenAvailable()) {
+      console.log("screen is not available, starting without screen wrapper.");
     }
     console.log("Starting KNTIC services…");
     execSync(composeCmd, { stdio: "inherit" });

package/src/commands/update.js

@@ -182,7 +182,35 @@ function extractLibOnly(tarball, destDir) {
   );
 }
 
-async function update() {
+/**
+ * Extract .kntic/lib/** and .kntic/adrs/** from a tarball into the destination
+ * directory. Clears both directories first, then extracts fresh content.
+ *
+ * @param {string} tarball  – path to the .tar.gz file
+ * @param {string} destDir  – target directory (usually ".")
+ */
+function extractUpdate(tarball, destDir) {
+  const libDir = path.join(destDir, ".kntic", "lib");
+  const adrsDir = path.join(destDir, ".kntic", "adrs");
+
+  // Ensure target directories exist
+  fs.mkdirSync(libDir, { recursive: true });
+  fs.mkdirSync(adrsDir, { recursive: true });
+
+  // Clear existing contents
+  clearDirectory(libDir);
+  clearDirectory(adrsDir);
+
+  // Extract both .kntic/lib/ and .kntic/adrs/ from the archive.
+  execSync(
+    `tar xzf "${tarball}" -C "${destDir}" "./.kntic/lib/" "./.kntic/adrs/"`,
+    { stdio: "pipe" }
+  );
+}
+
+async function update(options = {}) {
+  const libOnly = options.libOnly || false;
+
   // Resolve current version from the artifact metadata file
   const artifactFilename = await fetchText(BOOTSTRAP_ARTIFACT_URL);
   const version = extractVersion(artifactFilename);
@@ -192,8 +220,13 @@ async function update() {
   console.log(`Downloading KNTIC bootstrap archive… (v${version})`);
   await download(BOOTSTRAP_URL, tmpFile);
 
-  console.log("Updating .kntic/lib …");
-  extractLibOnly(tmpFile, ".");
+  if (libOnly) {
+    console.log("Updating .kntic/lib …");
+    extractLibOnly(tmpFile, ".");
+  } else {
+    console.log("Updating .kntic/lib and .kntic/adrs …");
+    extractUpdate(tmpFile, ".");
+  }
 
   // Update KNTIC_VERSION in .kntic.env
   updateEnvVersion(version);
@@ -202,11 +235,16 @@ async function update() {
   fs.unlinkSync(tmpFile);
 
   console.log(`@kntic/kntic@${version}`);
-  console.log("Done. .kntic/lib updated successfully.");
+  if (libOnly) {
+    console.log("Done. .kntic/lib updated successfully.");
+  } else {
+    console.log("Done. .kntic/lib and .kntic/adrs updated successfully.");
+  }
 }
 
 module.exports = update;
 module.exports.extractLibOnly = extractLibOnly;
+module.exports.extractUpdate = extractUpdate;
 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, updateEnvVersion } = require("./update");
+const { extractLibOnly, extractUpdate, extractVersion, clearDirectory, updateEnvVersion } = require("./update");
 
 /**
  * Helper — create a tar.gz archive in `tmpDir` containing the given files.
@@ -202,6 +202,121 @@ describe("extractLibOnly", () => {
   });
 });
 
+describe("extractUpdate", () => {
+  let tmpDir;
+  let destDir;
+
+  beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "kntic-test-extractupdate-"));
+    destDir = path.join(tmpDir, "dest");
+    fs.mkdirSync(destDir, { recursive: true });
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it("extracts both .kntic/lib and .kntic/adrs from the archive", () => {
+    const tarball = createTarball(tmpDir, {
+      ".kntic/lib/orchestrator.py": "# orchestrator\n",
+      ".kntic/lib/skills/validator.py": "# validator\n",
+      ".kntic/adrs/ADR-001.md": "# ADR 001\n",
+      ".kntic/adrs/ADR-002.md": "# ADR 002\n",
+      ".kntic/MEMORY.MD": "# Memory\n",
+      "README.md": "# Hello\n",
+    });
+
+    extractUpdate(tarball, destDir);
+
+    // lib files must be extracted
+    assert.equal(
+      fs.readFileSync(path.join(destDir, ".kntic", "lib", "orchestrator.py"), "utf8"),
+      "# orchestrator\n"
+    );
+    assert.equal(
+      fs.readFileSync(path.join(destDir, ".kntic", "lib", "skills", "validator.py"), "utf8"),
+      "# validator\n"
+    );
+
+    // adrs files must be extracted
+    assert.equal(
+      fs.readFileSync(path.join(destDir, ".kntic", "adrs", "ADR-001.md"), "utf8"),
+      "# ADR 001\n"
+    );
+    assert.equal(
+      fs.readFileSync(path.join(destDir, ".kntic", "adrs", "ADR-002.md"), "utf8"),
+      "# ADR 002\n"
+    );
+
+    // Files outside lib/adrs must NOT be extracted
+    assert.ok(
+      !fs.existsSync(path.join(destDir, ".kntic", "MEMORY.MD")),
+      "MEMORY.MD must not be extracted"
+    );
+    assert.ok(
+      !fs.existsSync(path.join(destDir, "README.md")),
+      "README.md must not be extracted"
+    );
+  });
+
+  it("replaces existing .kntic/lib and .kntic/adrs content", () => {
+    const libDir = path.join(destDir, ".kntic", "lib");
+    const adrsDir = path.join(destDir, ".kntic", "adrs");
+    fs.mkdirSync(libDir, { recursive: true });
+    fs.mkdirSync(adrsDir, { recursive: true });
+    fs.writeFileSync(path.join(libDir, "old_lib.py"), "# old lib\n");
+    fs.writeFileSync(path.join(adrsDir, "ADR-OLD.md"), "# old adr\n");
+
+    const tarball = createTarball(tmpDir, {
+      ".kntic/lib/new_lib.py": "# new lib\n",
+      ".kntic/adrs/ADR-NEW.md": "# new adr\n",
+    });
+
+    extractUpdate(tarball, destDir);
+
+    // Old files must be gone
+    assert.ok(!fs.existsSync(path.join(libDir, "old_lib.py")), "old lib file must be removed");
+    assert.ok(!fs.existsSync(path.join(adrsDir, "ADR-OLD.md")), "old adr file must be removed");
+
+    // New files must be present
+    assert.equal(
+      fs.readFileSync(path.join(libDir, "new_lib.py"), "utf8"),
+      "# new lib\n"
+    );
+    assert.equal(
+      fs.readFileSync(path.join(adrsDir, "ADR-NEW.md"), "utf8"),
+      "# new adr\n"
+    );
+  });
+
+  it("preserves files outside .kntic/lib and .kntic/adrs", () => {
+    const knticDir = path.join(destDir, ".kntic");
+    fs.mkdirSync(knticDir, { recursive: true });
+    fs.writeFileSync(path.join(knticDir, "MEMORY.MD"), "# My memory\n");
+    fs.writeFileSync(path.join(destDir, "README.md"), "# My readme\n");
+
+    const tarball = createTarball(tmpDir, {
+      ".kntic/lib/orchestrator.py": "# orchestrator\n",
+      ".kntic/adrs/ADR-001.md": "# ADR 001\n",
+      ".kntic/MEMORY.MD": "# Archive memory\n",
+      "README.md": "# Archive readme\n",
+    });
+
+    extractUpdate(tarball, destDir);
+
+    assert.equal(
+      fs.readFileSync(path.join(knticDir, "MEMORY.MD"), "utf8"),
+      "# My memory\n",
+      "MEMORY.MD must not be overwritten"
+    );
+    assert.equal(
+      fs.readFileSync(path.join(destDir, "README.md"), "utf8"),
+      "# My readme\n",
+      "README.md must not be overwritten"
+    );
+  });
+});
+
 describe("updateEnvVersion", () => {
   let tmpDir;
 

package/src/commands/usage.js

@@ -7,8 +7,10 @@ function usage() {
   console.log("  usage    List all available sub-commands");
   console.log("  init     Download and extract the KNTIC bootstrap template into the current directory");
   console.log("  start    Build and start KNTIC services via docker compose (uses kntic.yml + .kntic.env)");
+  console.log("             --screen   Run inside a GNU screen session");
   console.log("  stop     Stop KNTIC services via docker compose");
-  console.log("  update   Download the latest KNTIC bootstrap and update .kntic/lib only");
+  console.log("  update   Download the latest KNTIC bootstrap and update .kntic/lib and .kntic/adrs");
+  console.log("             --lib-only   Update only .kntic/lib (skip .kntic/adrs)");
   console.log("");
 }