akili-specs 2.4.0 → 2.4.2

package/CHANGELOG.md

@@ -10,6 +10,14 @@ The format is inspired by Keep a Changelog and the repository follows semantic v
 
 - No unreleased changes yet.
 
+## [2.4.2] - 2026-07-19
+
+### Changed
+- **Update banner now suggests `akili update`:** The auto-update checker banner now recommends running `akili update` instead of `npm install -g akili-specs`, since `akili update` handles both the npm package update and file reinstallation.
+## [2.4.1] - 2026-07-19
+
+### Fixed
+- **`akili update` now updates the npm package:** Previously `akili update` only reinstalled files from the already-installed version. Now it detects the installation type (global, local, or npx), runs `npm install -g akili-specs@latest` or `npm install akili-specs@latest` accordingly, and then reinstalls files with `--force`.
 ## [2.4.0] - 2026-07-19
 
 ### Added

package/bin/akili.js

@@ -5,6 +5,8 @@ const os = require("os");
 const path = require("path");
 const { parseArgs } = require("util");
 
+const { execSync } = require("child_process");
+
 const PACKAGE_ROOT = path.resolve(__dirname, "..");
 const SOURCE_CLAUDE = path.join(PACKAGE_ROOT, ".claude");
 const SOURCE_COMMANDS = path.join(SOURCE_CLAUDE, "commands");
@@ -76,7 +78,7 @@ Usage:
 
 Commands:
   install   Install commands, skills, and helper resources
-  update    Reinstall commands, skills, and helper resources
+  update    Update npm package to latest version and reinstall files
   doctor    Check whether expected files are installed
   list      List packaged commands, skills, and helper resources
   help      Show this help
@@ -382,6 +384,52 @@ function installTool(tool, args) {
   return { installed, skipped };
 }
 
+function detectInstallType() {
+  try {
+    const globalList = execSync("npm list -g akili-specs --depth=0 2>/dev/null", { encoding: "utf8" });
+    if (globalList.includes("akili-specs")) return "global";
+  } catch (e) {}
+
+  try {
+    const localList = execSync("npm list akili-specs --depth=0 2>/dev/null", { encoding: "utf8" });
+    if (localList.includes("akili-specs")) return "local";
+  } catch (e) {}
+
+  return "npx";
+}
+
+function runUpdate(args) {
+  const installType = detectInstallType();
+
+  console.log(`\n${colors.cyan}Detected installation type: ${installType}${colors.reset}`);
+
+  if (installType === "npx") {
+    console.log(`\n${colors.yellow}You are running via npx. No persistent installation to update.${colors.reset}`);
+    console.log(`To install globally: ${colors.cyan}npm install -g akili-specs${colors.reset}`);
+    console.log(`To install locally:  ${colors.cyan}npm install akili-specs${colors.reset}`);
+    return;
+  }
+
+  console.log(`\n${colors.yellow}Updating npm package...${colors.reset}`);
+
+  try {
+    if (installType === "global") {
+      execSync("npm install -g akili-specs@latest", { stdio: "inherit" });
+    } else {
+      execSync("npm install akili-specs@latest", { stdio: "inherit" });
+    }
+
+    console.log(`\n${colors.green}npm package updated successfully.${colors.reset}`);
+  } catch (e) {
+    console.error(`\n${colors.red}Failed to update npm package.${colors.reset}`);
+    process.exit(1);
+  }
+
+  console.log(`\n${colors.yellow}Reinstalling files with --force...${colors.reset}`);
+  args.force = true;
+  runInstall(args);
+}
+
 function runInstall(args) {
   let installed = 0;
   let skipped = 0;
@@ -541,22 +589,16 @@ function checkForUpdates() {
             if (isNewer) {
               const border = `╭─────────────────────────────────────────────────────────────╮`;
               const emptyLine = `│                                                             │`;
-              const msgLine1 = `│   ${colors.yellow}Update available!${colors.reset} ${colors.red}${currentVersion}${colors.reset} → ${colors.green}${latestVersion}${colors.reset}`;
-              const msgLine2 = `│   Run ${colors.cyan}npm install -g akili-specs${colors.reset} to update.`;
               
-              // Pad to keep the box neat (very rudimentary padding, assumes specific length of colors)
-              // Just manually aligning for aesthetic since console length with escape codes is tricky
               console.log(`\n${colors.yellow}${border}`);
               console.log(`${emptyLine}`);
-              // 61 total chars inside. 
-              // "Update available! x.x.x -> y.y.y"
               const rawStr1 = `   Update available! ${currentVersion} -> ${latestVersion}`;
               const pad1 = " ".repeat(Math.max(0, 61 - rawStr1.length));
               console.log(`│   ${colors.yellow}Update available!${colors.reset} ${colors.red}${currentVersion}${colors.reset} → ${colors.green}${latestVersion}${colors.reset}${pad1}│`);
               
-              const rawStr2 = `   Run npm install -g akili-specs to update.`;
+              const rawStr2 = `   Run akili update to upgrade.`;
               const pad2 = " ".repeat(Math.max(0, 61 - rawStr2.length));
-              console.log(`│   Run ${colors.cyan}npm install -g akili-specs${colors.reset} to update.${pad2}│`);
+              console.log(`│   Run ${colors.cyan}akili update${colors.reset} to upgrade.${pad2}│`);
               console.log(`${emptyLine}`);
               console.log(`╰─────────────────────────────────────────────────────────────╯${colors.reset}\n`);
             }
@@ -656,9 +698,11 @@ async function main() {
 
   switch (args.command) {
     case "install":
-    case "update":
       runInstall(args);
       break;
+    case "update":
+      runUpdate(args);
+      break;
     case "doctor":
       runDoctor(args);
       break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akili-specs",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "Portable AKILI-SPECS methodology commands and skills for AI-assisted development.",
   "homepage": "https://github.com/JuankCadavid/akili-specs#readme",
   "repository": {