@kntic/kntic 0.4.4 → 0.4.6

package/package.json

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

package/src/commands/update.js

@@ -183,12 +183,13 @@ function extractLibOnly(tarball, destDir) {
 }
 
 /**
- * Extract .kntic/lib/**, .kntic/adrs/**, and .kntic/hooks/gdr/** from a tarball
+ * Extract .kntic/lib/**, .kntic/adrs/**, and .kntic/hooks/gia/internal/** from a tarball
  * into the destination directory.
  *
  * - .kntic/lib and .kntic/adrs are **replaced** (cleared first, then extracted).
- * - .kntic/hooks/gdr is **updated** (existing files are overwritten or new files
+ * - .kntic/hooks/gia/internal is **updated** (existing files are overwritten or new files
  *   added, but files not present in the archive are preserved).
+ * - .kntic/gia/weights.json is **replaced** if present in the archive.
  *
  * @param {string} tarball  – path to the .tar.gz file
  * @param {string} destDir  – target directory (usually ".")
@@ -196,18 +197,21 @@ function extractLibOnly(tarball, destDir) {
 function extractUpdate(tarball, destDir) {
   const libDir = path.join(destDir, ".kntic", "lib");
   const adrsDir = path.join(destDir, ".kntic", "adrs");
-  const gdrDir = path.join(destDir, ".kntic", "hooks", "gdr");
+  const giaInternalDir = path.join(destDir, ".kntic", "hooks", "gia", "internal");
+  const giaDir = path.join(destDir, ".kntic", "gia");
 
   // Ensure target directories exist
   fs.mkdirSync(libDir, { recursive: true });
   fs.mkdirSync(adrsDir, { recursive: true });
-  fs.mkdirSync(gdrDir, { recursive: true });
+  fs.mkdirSync(giaInternalDir, { recursive: true });
+  fs.mkdirSync(giaDir, { recursive: true });
 
   // Clear lib and adrs (full replacement)
   clearDirectory(libDir);
   clearDirectory(adrsDir);
 
-  // Note: gdr is NOT cleared — update semantics (overwrite/add, preserve others)
+  // Note: gia/internal hooks are NOT cleared — update semantics (overwrite/add, preserve others)
+  // Note: gia is NOT cleared — only weights.json is replaced
 
   // Extract .kntic/lib/ and .kntic/adrs/ (guaranteed to be in the archive)
   execSync(
@@ -215,14 +219,24 @@ function extractUpdate(tarball, destDir) {
     { stdio: "pipe" }
   );
 
-  // Extract .kntic/hooks/gdr/ separately — archive may not contain it
+  // Extract .kntic/hooks/gia/internal/ separately — archive may not contain it
   try {
     execSync(
-      `tar xzf "${tarball}" -C "${destDir}" "./.kntic/hooks/gdr/"`,
+      `tar xzf "${tarball}" -C "${destDir}" "./.kntic/hooks/gia/internal/"`,
       { stdio: "pipe" }
     );
   } catch (_) {
-    // No .kntic/hooks/gdr/ in the archive — that's fine
+    // No .kntic/hooks/gia/internal/ in the archive — that's fine
+  }
+
+  // Extract .kntic/gia/weights.json separately — archive may not contain it
+  try {
+    execSync(
+      `tar xzf "${tarball}" -C "${destDir}" "./.kntic/gia/weights.json"`,
+      { stdio: "pipe" }
+    );
+  } catch (_) {
+    // No .kntic/gia/weights.json in the archive — that's fine
   }
 }
 
@@ -242,7 +256,7 @@ async function update(options = {}) {
     console.log("Updating .kntic/lib …");
     extractLibOnly(tmpFile, ".");
   } else {
-    console.log("Updating .kntic/lib, .kntic/adrs, and .kntic/hooks/gdr …");
+    console.log("Updating .kntic/lib, .kntic/adrs, .kntic/hooks/gia/internal, and .kntic/gia/weights.json …");
     extractUpdate(tmpFile, ".");
   }
 
@@ -256,7 +270,7 @@ async function update(options = {}) {
   if (libOnly) {
     console.log("Done. .kntic/lib updated successfully.");
   } else {
-    console.log("Done. .kntic/lib, .kntic/adrs, and .kntic/hooks/gdr updated successfully.");
+    console.log("Done. .kntic/lib, .kntic/adrs, .kntic/hooks/gia/internal, and .kntic/gia/weights.json updated successfully.");
   }
 }
 

package/src/commands/update.test.js

@@ -216,13 +216,13 @@ describe("extractUpdate", () => {
     fs.rmSync(tmpDir, { recursive: true, force: true });
   });
 
-  it("extracts .kntic/lib, .kntic/adrs, and .kntic/hooks/gdr from the archive", () => {
+  it("extracts .kntic/lib, .kntic/adrs, and .kntic/hooks/gia/internal 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/hooks/gdr/check.sh": "#!/bin/sh\necho check\n",
+      ".kntic/hooks/gia/internal/check.sh": "#!/bin/sh\necho check\n",
       ".kntic/MEMORY.MD": "# Memory\n",
       "README.md": "# Hello\n",
     });
@@ -249,13 +249,13 @@ describe("extractUpdate", () => {
       "# ADR 002\n"
     );
 
-    // hooks/gdr files must be extracted
+    // hooks/gia/internal files must be extracted
     assert.equal(
-      fs.readFileSync(path.join(destDir, ".kntic", "hooks", "gdr", "check.sh"), "utf8"),
+      fs.readFileSync(path.join(destDir, ".kntic", "hooks", "gia", "internal", "check.sh"), "utf8"),
       "#!/bin/sh\necho check\n"
     );
 
-    // Files outside lib/adrs/hooks/gdr must NOT be extracted
+    // Files outside lib/adrs/hooks/gia/internal must NOT be extracted
     assert.ok(
       !fs.existsSync(path.join(destDir, ".kntic", "MEMORY.MD")),
       "MEMORY.MD must not be extracted"
@@ -296,47 +296,47 @@ describe("extractUpdate", () => {
     );
   });
 
-  it("updates .kntic/hooks/gdr without clearing existing files (update semantics)", () => {
-    const gdrDir = path.join(destDir, ".kntic", "hooks", "gdr");
-    fs.mkdirSync(gdrDir, { recursive: true });
-    fs.writeFileSync(path.join(gdrDir, "existing-hook.sh"), "#!/bin/sh\necho existing\n");
-    fs.writeFileSync(path.join(gdrDir, "shared-hook.sh"), "#!/bin/sh\necho old\n");
+  it("updates .kntic/hooks/gia/internal without clearing existing files (update semantics)", () => {
+    const giaInternalDir = path.join(destDir, ".kntic", "hooks", "gia", "internal");
+    fs.mkdirSync(giaInternalDir, { recursive: true });
+    fs.writeFileSync(path.join(giaInternalDir, "existing-hook.sh"), "#!/bin/sh\necho existing\n");
+    fs.writeFileSync(path.join(giaInternalDir, "shared-hook.sh"), "#!/bin/sh\necho old\n");
 
     const tarball = createTarball(tmpDir, {
       ".kntic/lib/orchestrator.py": "# orchestrator\n",
       ".kntic/adrs/ADR-001.md": "# ADR 001\n",
-      ".kntic/hooks/gdr/shared-hook.sh": "#!/bin/sh\necho new\n",
-      ".kntic/hooks/gdr/new-hook.sh": "#!/bin/sh\necho added\n",
+      ".kntic/hooks/gia/internal/shared-hook.sh": "#!/bin/sh\necho new\n",
+      ".kntic/hooks/gia/internal/new-hook.sh": "#!/bin/sh\necho added\n",
     });
 
     extractUpdate(tarball, destDir);
 
     // Existing file NOT in archive must be preserved (update semantics, not replace)
     assert.equal(
-      fs.readFileSync(path.join(gdrDir, "existing-hook.sh"), "utf8"),
+      fs.readFileSync(path.join(giaInternalDir, "existing-hook.sh"), "utf8"),
       "#!/bin/sh\necho existing\n",
       "existing hook not in archive must be preserved"
     );
 
     // File in both archive and disk must be overwritten
     assert.equal(
-      fs.readFileSync(path.join(gdrDir, "shared-hook.sh"), "utf8"),
+      fs.readFileSync(path.join(giaInternalDir, "shared-hook.sh"), "utf8"),
       "#!/bin/sh\necho new\n",
       "shared hook must be overwritten with archive version"
     );
 
     // New file from archive must be added
     assert.equal(
-      fs.readFileSync(path.join(gdrDir, "new-hook.sh"), "utf8"),
+      fs.readFileSync(path.join(giaInternalDir, "new-hook.sh"), "utf8"),
       "#!/bin/sh\necho added\n",
       "new hook from archive must be added"
     );
   });
 
-  it("works when archive has no .kntic/hooks/gdr directory", () => {
-    const gdrDir = path.join(destDir, ".kntic", "hooks", "gdr");
-    fs.mkdirSync(gdrDir, { recursive: true });
-    fs.writeFileSync(path.join(gdrDir, "my-hook.sh"), "#!/bin/sh\necho mine\n");
+  it("works when archive has no .kntic/hooks/gia/internal directory", () => {
+    const giaInternalDir = path.join(destDir, ".kntic", "hooks", "gia", "internal");
+    fs.mkdirSync(giaInternalDir, { recursive: true });
+    fs.writeFileSync(path.join(giaInternalDir, "my-hook.sh"), "#!/bin/sh\necho mine\n");
 
     const tarball = createTarball(tmpDir, {
       ".kntic/lib/orchestrator.py": "# orchestrator\n",
@@ -346,11 +346,11 @@ describe("extractUpdate", () => {
     // Should not throw
     extractUpdate(tarball, destDir);
 
-    // Existing gdr hook must be preserved
+    // Existing gia/internal hook must be preserved
     assert.equal(
-      fs.readFileSync(path.join(gdrDir, "my-hook.sh"), "utf8"),
+      fs.readFileSync(path.join(giaInternalDir, "my-hook.sh"), "utf8"),
       "#!/bin/sh\necho mine\n",
-      "existing gdr hook must be preserved when archive has no gdr"
+      "existing gia/internal hook must be preserved when archive has no gia/internal"
     );
 
     // lib and adrs must still be extracted
@@ -358,7 +358,57 @@ describe("extractUpdate", () => {
     assert.ok(fs.existsSync(path.join(destDir, ".kntic", "adrs", "ADR-001.md")));
   });
 
-  it("preserves files outside .kntic/lib, .kntic/adrs, and .kntic/hooks/gdr", () => {
+  it("replaces .kntic/gia/weights.json from the archive", () => {
+    const giaDir = path.join(destDir, ".kntic", "gia");
+    fs.mkdirSync(giaDir, { recursive: true });
+    fs.writeFileSync(path.join(giaDir, "weights.json"), '{"old": true}\n');
+    fs.writeFileSync(path.join(giaDir, "state.json"), '{"keep": true}\n');
+
+    const tarball = createTarball(tmpDir, {
+      ".kntic/lib/orchestrator.py": "# orchestrator\n",
+      ".kntic/adrs/ADR-001.md": "# ADR 001\n",
+      ".kntic/gia/weights.json": '{"new": true}\n',
+    });
+
+    extractUpdate(tarball, destDir);
+
+    // weights.json must be replaced
+    assert.equal(
+      fs.readFileSync(path.join(giaDir, "weights.json"), "utf8"),
+      '{"new": true}\n',
+      "weights.json must be replaced with archive version"
+    );
+
+    // Other files in gia must be preserved
+    assert.equal(
+      fs.readFileSync(path.join(giaDir, "state.json"), "utf8"),
+      '{"keep": true}\n',
+      "state.json must not be touched"
+    );
+  });
+
+  it("works when archive has no .kntic/gia/weights.json", () => {
+    const giaDir = path.join(destDir, ".kntic", "gia");
+    fs.mkdirSync(giaDir, { recursive: true });
+    fs.writeFileSync(path.join(giaDir, "weights.json"), '{"existing": true}\n');
+
+    const tarball = createTarball(tmpDir, {
+      ".kntic/lib/orchestrator.py": "# orchestrator\n",
+      ".kntic/adrs/ADR-001.md": "# ADR 001\n",
+    });
+
+    // Should not throw
+    extractUpdate(tarball, destDir);
+
+    // Existing weights.json must be preserved when not in archive
+    assert.equal(
+      fs.readFileSync(path.join(giaDir, "weights.json"), "utf8"),
+      '{"existing": true}\n',
+      "existing weights.json must be preserved when archive has none"
+    );
+  });
+
+  it("preserves files outside .kntic/lib, .kntic/adrs, and .kntic/hooks/gia/internal", () => {
     const knticDir = path.join(destDir, ".kntic");
     fs.mkdirSync(knticDir, { recursive: true });
     fs.writeFileSync(path.join(knticDir, "MEMORY.MD"), "# My memory\n");
@@ -367,7 +417,7 @@ describe("extractUpdate", () => {
     const tarball = createTarball(tmpDir, {
       ".kntic/lib/orchestrator.py": "# orchestrator\n",
       ".kntic/adrs/ADR-001.md": "# ADR 001\n",
-      ".kntic/hooks/gdr/check.sh": "#!/bin/sh\n",
+      ".kntic/hooks/gia/internal/check.sh": "#!/bin/sh\n",
       ".kntic/MEMORY.MD": "# Archive memory\n",
       "README.md": "# Archive readme\n",
     });

package/src/commands/usage.js

@@ -9,8 +9,8 @@ function usage() {
   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, .kntic/adrs, and .kntic/hooks/gdr");
-  console.log("             --lib-only   Update only .kntic/lib (skip .kntic/adrs and .kntic/hooks/gdr)");
+  console.log("  update   Download the latest KNTIC bootstrap and update .kntic/lib, .kntic/adrs, .kntic/hooks/gia/internal, and .kntic/gia/weights.json");
+  console.log("             --lib-only   Update only .kntic/lib (skip .kntic/adrs, .kntic/hooks/gia/internal, and .kntic/gia/weights.json)");
   console.log("");
 }