@warnyin/sdlc 0.1.0 → 0.1.2

package/bin/cli.mjs

@@ -465,6 +465,18 @@ export async function main(argv = process.argv.slice(2), projectRoot = process.c
   }
 }
 
-if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+// npx invokes the bin via a node_modules/.bin symlink, so argv[1] must be
+// realpath-resolved before comparing with import.meta.url (which the ESM
+// loader already resolves) — otherwise main() silently never runs.
+function isEntrypoint() {
+  if (!process.argv[1]) return false;
+  try {
+    return fs.realpathSync.native(path.resolve(process.argv[1])) === fileURLToPath(import.meta.url);
+  } catch {
+    return false;
+  }
+}
+
+if (isEntrypoint()) {
   main();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warnyin/sdlc",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Spec-driven, AI-driven SDLC framework — token-lean specs, contract-first changes, autonomous pipeline with managed hooks. Operationalizes the Day-1 'New SDLC with Vibe Coding' work process.",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node --test \"tests/*.test.mjs\"",
+    "test": "node --test",
     "setup:dogfood": "node bin/cli.mjs init --tool claude && node bin/cli.mjs update"
   },
   "engines": {

package/payload/hooks/_shared.mjs

@@ -15,14 +15,27 @@ export function resolveRoots(importMetaUrl) {
   return { hooksDir, sdlcRoot, projectRoot };
 }
 
-export async function readStdinJson() {
-  try {
+// Reads the hook payload from stdin. Must NEVER hang: when a playbook or a
+// user script invokes a hook utility with stdin open-but-idle (no piped JSON),
+// resolve null after a short grace period instead of blocking forever.
+export function readStdinJson({ timeoutMs = 1000 } = {}) {
+  return new Promise((resolve) => {
     let data = '';
-    for await (const chunk of process.stdin) data += chunk;
-    return data.trim() ? JSON.parse(data) : null;
-  } catch {
-    return null;
-  }
+    let done = false;
+    const finish = () => {
+      if (done) return;
+      done = true;
+      // Release stdin so an open-idle stream cannot keep the event loop alive.
+      process.stdin.pause();
+      if (typeof process.stdin.unref === 'function') process.stdin.unref();
+      try { resolve(data.trim() ? JSON.parse(data) : null); } catch { resolve(null); }
+    };
+    const timer = setTimeout(finish, timeoutMs);
+    if (typeof timer.unref === 'function') timer.unref();
+    process.stdin.on('data', (chunk) => { data += chunk; });
+    process.stdin.on('end', finish);
+    process.stdin.on('error', finish);
+  });
 }
 
 // Resolve symlinks on the deepest EXISTING ancestor, then re-attach the tail.

package/scripts/validate.mjs

@@ -33,6 +33,15 @@ function main() {
   process.exit(errors > 0 ? 1 : 0);
 }
 
-if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+function isEntrypoint() {
+  if (!process.argv[1]) return false;
+  try {
+    return fs.realpathSync.native(path.resolve(process.argv[1])) === fileURLToPath(import.meta.url);
+  } catch {
+    return false;
+  }
+}
+
+if (isEntrypoint()) {
   main();
 }