kracked-core 1.5.0 → 1.5.1

package/bin/kracked-core.mjs

@@ -4,7 +4,7 @@ import { runInit } from '../src/wizard.mjs';
 import { runUninstall } from '../src/uninstall.mjs';
 import { runUpdate } from '../src/update.mjs';
 import { runStatus } from '../src/status.mjs';
-import { beginTypeAhead } from '../src/prompt.mjs';
+import { beginTypeAhead, endTypeAhead } from '../src/prompt.mjs';
 
 const USAGE = `kracked-core — memory & workflow installer for AI coding agents
 
@@ -63,7 +63,16 @@ async function main() {
   process.exit(1);
 }
 
-main().catch((err) => {
-  process.stderr.write(`\nkracked-core failed: ${err.message}\n`);
-  process.exit(1);
-});
+main()
+  .catch((err) => {
+    process.stderr.write(`\nkracked-core failed: ${err.message}\n`);
+    process.exitCode = 1;
+  })
+  // A raw-mode TTY stdin stays an ACTIVE HANDLE even after removeListener +
+  // pause(), so Node's event loop never drains and the terminal never returns —
+  // the command looks stuck even when it succeeded. Releasing stdin is not
+  // enough on its own; exit explicitly once the work is done.
+  .finally(() => {
+    endTypeAhead();
+    process.stdout.write('', () => process.exit(process.exitCode ?? 0));
+  });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kracked-core",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "Zero-dependency memory & workflow installer for AI coding agents — global identity, project memory, and skills that survive session restarts.",
   "type": "module",
   "bin": {

package/src/prompt.mjs

@@ -110,6 +110,26 @@ export function beginTypeAhead() {
   stdin.on('data', bufferEarlyKeys);
 }
 
+/**
+ * Release stdin so the process can exit.
+ *
+ * An open stdin listener keeps Node's event loop alive indefinitely, so any
+ * command that finishes WITHOUT going through a prompt's cleanup (an early
+ * return, an error path, a completed run) leaves the terminal hanging with no
+ * output and no prompt back. `process.exitCode` sets the code but does not
+ * exit. Every command path must end here.
+ */
+export function endTypeAhead() {
+  if (!stdin.isTTY) return;
+  stdin.removeListener('data', bufferEarlyKeys);
+  try {
+    if (stdin.isRaw) stdin.setRawMode(false);
+  } catch {
+    // Terminal already gone.
+  }
+  stdin.pause();
+}
+
 function bufferEarlyKeys(chunk) {
   pendingKeys.push(...splitKeys(chunk));
 }

package/src/update.mjs

@@ -87,10 +87,18 @@ export async function runUpdate() {
   stdout.write(`${bold('kracked-core update')} ${dim(`v${version}`)}\n\n`);
 
   if (!fs.existsSync(path.join(projectDir, '.kracked'))) {
-    stdout.write(
-      `No kracked-core install found in ${projectDir}\n\n` +
-      'Run `npx kracked-core init` to set it up first.\n'
-    );
+    stdout.write(`No kracked-core install found in ${projectDir}\n\n`);
+
+    // Easy mistake: running this inside the package source rather than a
+    // project that uses it. Say so instead of just repeating the error.
+    if (fs.existsSync(path.join(projectDir, 'templates', 'loaders', 'AGENTS.md'))) {
+      stdout.write(
+        'This looks like the kracked-core package source, not a project that\n' +
+        'uses it. cd into your own project first, then run this again.\n'
+      );
+    } else {
+      stdout.write('Run `npx kracked-core@latest init` to set it up first.\n');
+    }
     process.exitCode = 1;
     return;
   }