@jonit-dev/night-watch-cli 1.1.4 → 1.2.0

package/dist/utils/status-data.js

@@ -0,0 +1,403 @@
+/**
+ * Status data layer for Night Watch CLI
+ * Provides data-fetching functions used by both the status command and the dashboard TUI.
+ */
+import { execSync } from "child_process";
+import * as fs from "fs";
+import * as path from "path";
+import { CLAIM_FILE_EXTENSION, LOCK_FILE_PREFIX, LOG_DIR } from "../constants.js";
+import { generateMarker, getEntries, getProjectEntries } from "./crontab.js";
+/**
+ * Get the project name from directory or package.json
+ */
+export function getProjectName(projectDir) {
+    const packageJsonPath = path.join(projectDir, "package.json");
+    if (fs.existsSync(packageJsonPath)) {
+        try {
+            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+            if (packageJson.name) {
+                return packageJson.name;
+            }
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    return path.basename(projectDir);
+}
+/**
+ * Check if a process with the given PID is running
+ */
+export function isProcessRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read PID from lock file and check if process is running
+ */
+export function checkLockFile(lockPath) {
+    if (!fs.existsSync(lockPath)) {
+        return { running: false, pid: null };
+    }
+    try {
+        const pidStr = fs.readFileSync(lockPath, "utf-8").trim();
+        const pid = parseInt(pidStr, 10);
+        if (isNaN(pid)) {
+            return { running: false, pid: null };
+        }
+        return {
+            running: isProcessRunning(pid),
+            pid,
+        };
+    }
+    catch {
+        return { running: false, pid: null };
+    }
+}
+/**
+ * Count PRDs in the PRD directory and return counts
+ */
+export function countPRDs(projectDir, prdDir, maxRuntime) {
+    const fullPrdPath = path.join(projectDir, prdDir);
+    if (!fs.existsSync(fullPrdPath)) {
+        return { pending: 0, claimed: 0, done: 0 };
+    }
+    let pending = 0;
+    let claimed = 0;
+    let done = 0;
+    const countInDir = (dir) => {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name === "done") {
+                    try {
+                        const doneEntries = fs.readdirSync(fullPath);
+                        done += doneEntries.filter((e) => e.endsWith(".md")).length;
+                    }
+                    catch {
+                        // Ignore errors
+                    }
+                }
+                else {
+                    countInDir(fullPath);
+                }
+            }
+            else if (entry.name.endsWith(".md")) {
+                const claimPath = path.join(dir, entry.name + CLAIM_FILE_EXTENSION);
+                if (fs.existsSync(claimPath)) {
+                    try {
+                        const content = fs.readFileSync(claimPath, "utf-8");
+                        const claimData = JSON.parse(content);
+                        const age = Math.floor(Date.now() / 1000) - claimData.timestamp;
+                        if (age < maxRuntime) {
+                            claimed++;
+                        }
+                        else {
+                            pending++;
+                        }
+                    }
+                    catch {
+                        pending++;
+                    }
+                }
+                else {
+                    pending++;
+                }
+            }
+        }
+    };
+    try {
+        countInDir(fullPrdPath);
+    }
+    catch {
+        // Ignore errors
+    }
+    return { pending, claimed, done };
+}
+/**
+ * Parse dependency references from a PRD file.
+ * Looks for a line matching "depends on: `name1`, `name2`" (case-insensitive).
+ */
+export function parsePrdDependencies(prdPath) {
+    try {
+        const content = fs.readFileSync(prdPath, "utf-8");
+        const match = content.match(/depends on[:\s]*([^\n]+)/i);
+        if (!match)
+            return [];
+        return match[1]
+            .split(",")
+            .map((d) => d.trim().replace(/`/g, ""))
+            .filter((d) => d.length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Collect PRD info items from the PRD directory
+ */
+export function collectPrdInfo(projectDir, prdDir, maxRuntime) {
+    const fullPrdPath = path.join(projectDir, prdDir);
+    const prds = [];
+    if (!fs.existsSync(fullPrdPath)) {
+        return prds;
+    }
+    const collectInDir = (dir) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name === "done") {
+                    try {
+                        const doneEntries = fs.readdirSync(fullPath);
+                        for (const doneEntry of doneEntries) {
+                            if (doneEntry.endsWith(".md")) {
+                                prds.push({
+                                    name: doneEntry.replace(/\.md$/, ""),
+                                    status: "done",
+                                    dependencies: [],
+                                    unmetDependencies: [],
+                                });
+                            }
+                        }
+                    }
+                    catch {
+                        // Ignore errors
+                    }
+                }
+                else {
+                    collectInDir(fullPath);
+                }
+            }
+            else if (entry.name.endsWith(".md")) {
+                const claimPath = path.join(dir, entry.name + CLAIM_FILE_EXTENSION);
+                let status = "ready";
+                if (fs.existsSync(claimPath)) {
+                    try {
+                        const content = fs.readFileSync(claimPath, "utf-8");
+                        const claimData = JSON.parse(content);
+                        const age = Math.floor(Date.now() / 1000) - claimData.timestamp;
+                        status = age < maxRuntime ? "in-progress" : "ready";
+                    }
+                    catch {
+                        status = "ready";
+                    }
+                }
+                const dependencies = parsePrdDependencies(fullPath);
+                prds.push({
+                    name: entry.name.replace(/\.md$/, ""),
+                    status,
+                    dependencies,
+                    unmetDependencies: [],
+                });
+            }
+        }
+    };
+    collectInDir(fullPrdPath);
+    // Compute unmet dependencies: a dependency is unmet if there's no "done" PRD with that name
+    const doneNames = new Set(prds.filter((p) => p.status === "done").map((p) => p.name));
+    for (const prd of prds) {
+        if (prd.dependencies.length > 0) {
+            prd.unmetDependencies = prd.dependencies.filter((dep) => !doneNames.has(dep));
+            // Mark PRDs with unmet dependencies as blocked (unless already done or in-progress)
+            if (prd.unmetDependencies.length > 0 && prd.status === "ready") {
+                prd.status = "blocked";
+            }
+        }
+    }
+    return prds;
+}
+/**
+ * Count open PRs on night-watch/ or feat/ branches using gh CLI
+ */
+export function countOpenPRs(projectDir, branchPatterns) {
+    try {
+        execSync("git rev-parse --git-dir", {
+            cwd: projectDir,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        try {
+            execSync("which gh", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+        }
+        catch {
+            return 0;
+        }
+        const output = execSync("gh pr list --state open --json headRefName,number", {
+            cwd: projectDir,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const prs = JSON.parse(output);
+        const matchingPRs = prs.filter((pr) => branchPatterns.some((pattern) => pr.headRefName.startsWith(pattern)));
+        return matchingPRs.length;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Derive CI status from gh statusCheckRollup data
+ */
+function deriveCiStatus(checks) {
+    if (!checks || checks.length === 0)
+        return "unknown";
+    const hasFailure = checks.some((c) => c.conclusion === "FAILURE" || c.conclusion === "ERROR" || c.conclusion === "CANCELLED");
+    if (hasFailure)
+        return "fail";
+    const allComplete = checks.every((c) => c.state === "COMPLETED");
+    if (allComplete)
+        return "pass";
+    return "pending";
+}
+/**
+ * Derive review score from gh reviewDecision field
+ * Maps GitHub review decisions to a numeric score (0-100)
+ */
+function deriveReviewScore(reviewDecision) {
+    if (!reviewDecision)
+        return null;
+    switch (reviewDecision) {
+        case "APPROVED":
+            return 100;
+        case "CHANGES_REQUESTED":
+            return 0;
+        case "REVIEW_REQUIRED":
+            return null;
+        default:
+            return null;
+    }
+}
+/**
+ * Collect open PR info using gh CLI
+ */
+export function collectPrInfo(projectDir, branchPatterns) {
+    try {
+        execSync("git rev-parse --git-dir", {
+            cwd: projectDir,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        try {
+            execSync("which gh", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+        }
+        catch {
+            return [];
+        }
+        const output = execSync("gh pr list --state open --json headRefName,number,title,statusCheckRollup,reviewDecision", {
+            cwd: projectDir,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const prs = JSON.parse(output);
+        return prs
+            .filter((pr) => branchPatterns.some((pattern) => pr.headRefName.startsWith(pattern)))
+            .map((pr) => ({
+            number: pr.number,
+            title: pr.title,
+            branch: pr.headRefName,
+            ciStatus: deriveCiStatus(pr.statusCheckRollup),
+            reviewScore: deriveReviewScore(pr.reviewDecision),
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get last N lines from a log file
+ */
+export function getLastLogLines(logPath, lines) {
+    if (!fs.existsSync(logPath)) {
+        return [];
+    }
+    try {
+        const content = fs.readFileSync(logPath, "utf-8");
+        const allLines = content.trim().split("\n");
+        return allLines.slice(-lines);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get log file info
+ */
+export function getLogInfo(logPath, lastLines = 5) {
+    const exists = fs.existsSync(logPath);
+    return {
+        path: logPath,
+        lastLines: exists ? getLastLogLines(logPath, lastLines) : [],
+        exists,
+        size: exists ? fs.statSync(logPath).size : 0,
+    };
+}
+/**
+ * Collect log info as ILogInfo items
+ */
+export function collectLogInfo(projectDir) {
+    const logNames = ["executor", "reviewer"];
+    return logNames.map((name) => {
+        const logPath = path.join(projectDir, LOG_DIR, `${name}.log`);
+        const exists = fs.existsSync(logPath);
+        return {
+            name,
+            path: logPath,
+            exists,
+            size: exists ? fs.statSync(logPath).size : 0,
+            lastLines: exists ? getLastLogLines(logPath, 5) : [],
+        };
+    });
+}
+/**
+ * Get crontab information for a project
+ */
+export function getCrontabInfo(projectName, projectDir) {
+    const marker = generateMarker(projectName);
+    const crontabEntries = Array.from(new Set([...getEntries(marker), ...getProjectEntries(projectDir)]));
+    return {
+        installed: crontabEntries.length > 0,
+        entries: crontabEntries,
+    };
+}
+/**
+ * Fetch a complete status snapshot for the given project
+ */
+export function fetchStatusSnapshot(projectDir, config) {
+    const projectName = getProjectName(projectDir);
+    const lockProjectName = path.basename(projectDir);
+    const executorLock = checkLockFile(`${LOCK_FILE_PREFIX}${lockProjectName}.lock`);
+    const reviewerLock = checkLockFile(`${LOCK_FILE_PREFIX}pr-reviewer-${lockProjectName}.lock`);
+    const processes = [
+        { name: "executor", running: executorLock.running, pid: executorLock.pid },
+        { name: "reviewer", running: reviewerLock.running, pid: reviewerLock.pid },
+    ];
+    const prds = collectPrdInfo(projectDir, config.prdDir, config.maxRuntime);
+    const prs = collectPrInfo(projectDir, config.branchPatterns);
+    const logs = collectLogInfo(projectDir);
+    const crontab = getCrontabInfo(projectName, projectDir);
+    return {
+        projectName,
+        projectDir,
+        config,
+        prds,
+        processes,
+        prs,
+        logs,
+        crontab,
+        timestamp: new Date(),
+    };
+}
+//# sourceMappingURL=status-data.js.map

package/dist/utils/status-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-data.js","sourceRoot":"","sources":["../../src/utils/status-data.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jonit-dev/night-watch-cli",
-  "version": "1.1.4",
+  "version": "1.2.0",
   "description": "Autonomous PRD execution using AI Provider CLIs + cron",
   "type": "module",
   "bin": {
@@ -18,7 +18,10 @@
     "test": "vitest run",
     "dev": "tsx src/cli.ts",
     "prepublishOnly": "npm run build && npm test",
-    "publish:npm": "npm publish --access public"
+    "publish:npm": "npm publish --access public",
+    "lint": "eslint src/",
+    "verify": "tsc --noEmit && eslint src/",
+    "local": "tsc && yarn link"
   },
   "files": [
     "dist/",
@@ -40,22 +43,27 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/joaopio/night-watch-cli.git"
+    "url": "https://github.com/jonit-dev/night-watch-cli.git"
   },
-  "homepage": "https://github.com/joaopio/night-watch-cli#readme",
+  "homepage": "https://github.com/jonit-dev/night-watch-cli#readme",
   "bugs": {
-    "url": "https://github.com/joaopio/night-watch-cli/issues"
+    "url": "https://github.com/jonit-dev/night-watch-cli/issues"
   },
   "dependencies": {
+    "blessed": "^0.1.81",
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
     "commander": "^12.0.0",
     "ora": "^9.3.0"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/blessed": "^0.1.27",
     "@types/node": "^20.11.0",
+    "eslint": "^10.0.0",
     "tsx": "^4.7.0",
     "typescript": "^5.3.0",
+    "typescript-eslint": "^8.56.0",
     "vitest": "^1.2.0"
   },
   "engines": {

package/scripts/night-watch-cron.sh

@@ -55,13 +55,19 @@ fi
 
 cleanup_worktrees "${PROJECT_DIR}"
 
-ELIGIBLE_PRD=$(find_eligible_prd "${PRD_DIR}")
+ELIGIBLE_PRD=$(find_eligible_prd "${PRD_DIR}" "${MAX_RUNTIME}")
 
 if [ -z "${ELIGIBLE_PRD}" ]; then
   log "SKIP: No eligible PRDs (all done, in-progress, or blocked)"
   exit 0
 fi
 
+# Claim the PRD to prevent other runs from selecting it
+claim_prd "${PRD_DIR}" "${ELIGIBLE_PRD}"
+
+# Update EXIT trap to also release claim
+trap "rm -f '${LOCK_FILE}'; release_claim '${PRD_DIR}' '${ELIGIBLE_PRD}'" EXIT
+
 PRD_NAME="${ELIGIBLE_PRD%.md}"
 BRANCH_NAME="night-watch/${PRD_NAME}"
 if [ -n "${NW_DEFAULT_BRANCH:-}" ]; then
@@ -146,6 +152,7 @@ esac
 if [ ${EXIT_CODE} -eq 0 ]; then
   PR_EXISTS=$(gh pr list --state open --json headRefName --jq '.[].headRefName' 2>/dev/null | grep -cF "${BRANCH_NAME}" || echo "0")
   if [ "${PR_EXISTS}" -gt 0 ]; then
+    release_claim "${PRD_DIR}" "${ELIGIBLE_PRD}"
     mark_prd_done "${PRD_DIR}" "${ELIGIBLE_PRD}"
     git -C "${PROJECT_DIR}" add -A docs/PRDs/night-watch/
     git -C "${PROJECT_DIR}" commit -m "chore: mark ${ELIGIBLE_PRD} as done (PR opened on ${BRANCH_NAME})

package/scripts/night-watch-helpers.sh

@@ -118,10 +118,55 @@ detect_default_branch() {
   echo "main"
 }
 
+# ── Claim management ─────────────────────────────────────────────────────────
+
+claim_prd() {
+  local prd_dir="${1:?prd_dir required}"
+  local prd_file="${2:?prd_file required}"
+  local claim_file="${prd_dir}/${prd_file}.claim"
+
+  printf '{"timestamp":%d,"hostname":"%s","pid":%d}\n' \
+    "$(date +%s)" "$(hostname)" "$$" > "${claim_file}"
+}
+
+release_claim() {
+  local prd_dir="${1:?prd_dir required}"
+  local prd_file="${2:?prd_file required}"
+  local claim_file="${prd_dir}/${prd_file}.claim"
+
+  rm -f "${claim_file}"
+}
+
+is_claimed() {
+  local prd_dir="${1:?prd_dir required}"
+  local prd_file="${2:?prd_file required}"
+  local max_runtime="${3:-7200}"
+  local claim_file="${prd_dir}/${prd_file}.claim"
+
+  if [ ! -f "${claim_file}" ]; then
+    return 1
+  fi
+
+  local claim_ts
+  claim_ts=$(grep -o '"timestamp":[0-9]*' "${claim_file}" 2>/dev/null | grep -o '[0-9]*' || echo "0")
+  local now
+  now=$(date +%s)
+  local age=$(( now - claim_ts ))
+
+  if [ "${age}" -lt "${max_runtime}" ]; then
+    return 0  # actively claimed
+  else
+    # Stale claim — remove it
+    rm -f "${claim_file}"
+    return 1
+  fi
+}
+
 # ── Find next eligible PRD ───────────────────────────────────────────────────
 
 find_eligible_prd() {
   local prd_dir="${1:?prd_dir required}"
+  local max_runtime="${2:-7200}"
   local done_dir="${prd_dir}/done"
 
   local prd_files
@@ -139,6 +184,12 @@ find_eligible_prd() {
     prd_file=$(basename "${prd_path}")
     local prd_name="${prd_file%.md}"
 
+    # Skip if claimed by another process
+    if is_claimed "${prd_dir}" "${prd_file}" "${max_runtime}"; then
+      log "SKIP-PRD: ${prd_file} — claimed by another process"
+      continue
+    fi
+
     # Skip if a PR already exists for this PRD
     if echo "${open_branches}" | grep -qF "${prd_name}"; then
       log "SKIP-PRD: ${prd_file} — open PR already exists"

package/scripts/test-helpers.bats

@@ -0,0 +1,77 @@
+#!/usr/bin/env bats
+
+# Tests for night-watch-helpers.sh claim functions
+
+setup() {
+  # Source the helpers
+  SCRIPT_DIR="$(cd "$(dirname "${BATS_TEST_FILENAME}")" && pwd)"
+
+  # Set required globals
+  export LOG_FILE="/tmp/night-watch-test-$$.log"
+
+  source "${SCRIPT_DIR}/night-watch-helpers.sh"
+
+  # Create temp PRD directory
+  TEST_PRD_DIR=$(mktemp -d)
+  echo "# Test PRD" > "${TEST_PRD_DIR}/01-test-prd.md"
+  echo "# Test PRD 2" > "${TEST_PRD_DIR}/02-test-prd.md"
+}
+
+teardown() {
+  rm -rf "${TEST_PRD_DIR}"
+  rm -f "${LOG_FILE}"
+}
+
+@test "claim_prd creates .claim file with JSON" {
+  claim_prd "${TEST_PRD_DIR}" "01-test-prd.md"
+
+  [ -f "${TEST_PRD_DIR}/01-test-prd.md.claim" ]
+
+  local content
+  content=$(cat "${TEST_PRD_DIR}/01-test-prd.md.claim")
+
+  # Check JSON contains expected fields
+  echo "${content}" | grep -q '"timestamp":'
+  echo "${content}" | grep -q '"hostname":'
+  echo "${content}" | grep -q '"pid":'
+}
+
+@test "is_claimed returns 0 for active claim" {
+  claim_prd "${TEST_PRD_DIR}" "01-test-prd.md"
+
+  run is_claimed "${TEST_PRD_DIR}" "01-test-prd.md" 7200
+  [ "$status" -eq 0 ]
+}
+
+@test "is_claimed returns 1 for stale claim" {
+  # Write a claim with an old timestamp (1 second)
+  printf '{"timestamp":1000000000,"hostname":"test","pid":1}\n' \
+    > "${TEST_PRD_DIR}/01-test-prd.md.claim"
+
+  run is_claimed "${TEST_PRD_DIR}" "01-test-prd.md" 7200
+  [ "$status" -eq 1 ]
+}
+
+@test "is_claimed returns 1 for no claim" {
+  run is_claimed "${TEST_PRD_DIR}" "01-test-prd.md" 7200
+  [ "$status" -eq 1 ]
+}
+
+@test "release_claim removes .claim file" {
+  claim_prd "${TEST_PRD_DIR}" "01-test-prd.md"
+  [ -f "${TEST_PRD_DIR}/01-test-prd.md.claim" ]
+
+  release_claim "${TEST_PRD_DIR}" "01-test-prd.md"
+  [ ! -f "${TEST_PRD_DIR}/01-test-prd.md.claim" ]
+}
+
+@test "find_eligible_prd skips claimed PRD" {
+  # Claim the first PRD
+  claim_prd "${TEST_PRD_DIR}" "01-test-prd.md"
+
+  # find_eligible_prd should skip 01 and return 02
+  local result
+  result=$(find_eligible_prd "${TEST_PRD_DIR}" 7200)
+
+  [ "${result}" = "02-test-prd.md" ]
+}

package/templates/prd.md

@@ -0,0 +1,26 @@
+# PRD: {{TITLE}}
+
+{{DEPENDS_ON}}
+
+**Complexity: {{COMPLEXITY_SCORE}} → {{COMPLEXITY_LEVEL}} mode**
+{{COMPLEXITY_BREAKDOWN}}
+
+---
+
+## Problem
+
+<!-- What problem does this solve? Describe in 1-2 sentences. -->
+
+## Solution
+
+<!-- How will you solve it? 3-5 bullets explaining the approach. -->
+
+## Phases
+
+{{PHASES}}
+
+## Acceptance Criteria
+
+- [ ] All phases complete
+- [ ] All tests pass
+- [ ] Feature is reachable (not orphaned code)