@jonit-dev/night-watch-cli 1.7.79 → 1.7.81

package/dist/commands/analytics.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Analytics command - runs the Amplitude analytics job
+ */
+import { Command } from 'commander';
+export interface IAnalyticsOptions {
+    dryRun: boolean;
+    timeout?: string;
+    provider?: string;
+}
+/**
+ * Register the analytics command with the program
+ */
+export declare function analyticsCommand(program: Command): void;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/commands/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/commands/analytics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyEvD"}

package/dist/commands/analytics.js

@@ -0,0 +1,74 @@
+/**
+ * Analytics command - runs the Amplitude analytics job
+ */
+import { createSpinner, createTable, header, info, loadConfig, resolveJobProvider, runAnalytics, } from '@night-watch/core';
+import { maybeApplyCronSchedulingDelay } from './shared/env-builder.js';
+/**
+ * Register the analytics command with the program
+ */
+export function analyticsCommand(program) {
+    program
+        .command('analytics')
+        .description('Run Amplitude analytics job now')
+        .option('--dry-run', 'Show what would be executed without running')
+        .option('--timeout <seconds>', 'Override max runtime in seconds')
+        .option('--provider <string>', 'AI provider to use (claude or codex)')
+        .action(async (options) => {
+        const projectDir = process.cwd();
+        let config = loadConfig(projectDir);
+        if (options.timeout) {
+            const timeout = parseInt(options.timeout, 10);
+            if (!isNaN(timeout)) {
+                config = { ...config, analytics: { ...config.analytics, maxRuntime: timeout } };
+            }
+        }
+        if (options.provider) {
+            config = {
+                ...config,
+                _cliProviderOverride: options.provider,
+            };
+        }
+        if (!config.analytics.enabled && !options.dryRun) {
+            info('Analytics is disabled in config; skipping run.');
+            process.exit(0);
+        }
+        // Validate Amplitude keys
+        const apiKey = config.providerEnv?.AMPLITUDE_API_KEY;
+        const secretKey = config.providerEnv?.AMPLITUDE_SECRET_KEY;
+        if (!apiKey || !secretKey) {
+            info('AMPLITUDE_API_KEY and AMPLITUDE_SECRET_KEY must be set in providerEnv to run analytics.');
+            process.exit(1);
+        }
+        if (options.dryRun) {
+            header('Dry Run: Analytics Job');
+            const analyticsProvider = resolveJobProvider(config, 'analytics');
+            header('Configuration');
+            const configTable = createTable({ head: ['Setting', 'Value'] });
+            configTable.push(['Provider', analyticsProvider]);
+            configTable.push(['Max Runtime', `${config.analytics.maxRuntime}s`]);
+            configTable.push(['Lookback Days', String(config.analytics.lookbackDays)]);
+            configTable.push(['Target Column', config.analytics.targetColumn]);
+            configTable.push(['Amplitude API Key', apiKey ? '***' + apiKey.slice(-4) : 'not set']);
+            console.log(configTable.toString());
+            console.log();
+            process.exit(0);
+        }
+        const spinner = createSpinner('Running analytics job...');
+        spinner.start();
+        try {
+            await maybeApplyCronSchedulingDelay(config, 'analytics', projectDir);
+            const result = await runAnalytics(config, projectDir);
+            if (result.issuesCreated > 0) {
+                spinner.succeed(`Analytics complete — ${result.summary}`);
+            }
+            else {
+                spinner.succeed('Analytics complete — no actionable insights found');
+            }
+        }
+        catch (err) {
+            spinner.fail(`Analytics failed: ${err instanceof Error ? err.message : String(err)}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=analytics.js.map

package/dist/commands/analytics.js.map

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

package/dist/scripts/night-watch-audit-cron.sh

@@ -23,21 +23,13 @@ SCRIPT_TYPE="audit"
 PROVIDER_LABEL="${NW_PROVIDER_LABEL:-}"
 SCRIPT_START_TIME=$(date +%s)
 
-# Ensure NVM / Node / Claude are on PATH
-export NVM_DIR="${HOME}/.nvm"
-[ -s "${NVM_DIR}/nvm.sh" ] && . "${NVM_DIR}/nvm.sh"
-
 mkdir -p "${LOG_DIR}"
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck source=night-watch-helpers.sh
 source "${SCRIPT_DIR}/night-watch-helpers.sh"
-PROJECT_RUNTIME_KEY=$(project_runtime_key "${PROJECT_DIR}")
-# NOTE: Lock file path must match auditLockPath() in src/utils/status-data.ts
-LOCK_FILE="/tmp/night-watch-audit-${PROJECT_RUNTIME_KEY}.lock"
-AUDIT_PROMPT_TEMPLATE="${SCRIPT_DIR}/../templates/audit.md"
-PROVIDER_MODEL_DISPLAY=$(resolve_provider_model_display "${PROVIDER_CMD}" "${PROVIDER_LABEL}")
 
+# emit_result helper - must be defined before use
 emit_result() {
   local status="${1:?status required}"
   local details="${2:-}"
@@ -48,13 +40,25 @@ emit_result() {
   fi
 }
 
-# Validate provider
+# Validate provider name first (must be claude or codex)
 if ! validate_provider "${PROVIDER_CMD}"; then
   echo "ERROR: Unknown provider: ${PROVIDER_CMD}" >&2
   emit_result "failure" "reason=unknown_provider"
   exit 1
 fi
 
+# Ensure provider CLI is on PATH (nvm, fnm, volta, common bin dirs)
+if ! ensure_provider_on_path "${PROVIDER_CMD}"; then
+  echo "ERROR: Provider '${PROVIDER_CMD}' not found in PATH or common installation locations" >&2
+  emit_result "failure" "reason=provider_not_found"
+  exit 1
+fi
+PROJECT_RUNTIME_KEY=$(project_runtime_key "${PROJECT_DIR}")
+# NOTE: Lock file path must match auditLockPath() in src/utils/status-data.ts
+LOCK_FILE="/tmp/night-watch-audit-${PROJECT_RUNTIME_KEY}.lock"
+AUDIT_PROMPT_TEMPLATE="${SCRIPT_DIR}/../templates/audit.md"
+PROVIDER_MODEL_DISPLAY=$(resolve_provider_model_display "${PROVIDER_CMD}" "${PROVIDER_LABEL}")
+
 # Global gate: if queue is enabled and we can't acquire the global lock,
 # enqueue the job and exit. The dispatcher will run it later.
 if [ "${NW_QUEUE_ENABLED:-0}" = "1" ]; then

package/dist/scripts/night-watch-cron.sh

@@ -34,19 +34,18 @@ EFFECTIVE_PROVIDER_LABEL="${PROVIDER_LABEL}"
 BRANCH_PREFIX="${NW_BRANCH_PREFIX:-night-watch}"
 SCRIPT_START_TIME=$(date +%s)
 
-# Ensure NVM / Node / Claude are on PATH
-export NVM_DIR="${HOME}/.nvm"
-[ -s "${NVM_DIR}/nvm.sh" ] && . "${NVM_DIR}/nvm.sh"
-
-# NOTE: Environment variables should be set by the caller (Node.js CLI).
-# The .env.night-watch sourcing has been removed - config is now injected via env vars.
-
 mkdir -p "${LOG_DIR}"
 
 # Load shared helpers
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck source=night-watch-helpers.sh
 source "${SCRIPT_DIR}/night-watch-helpers.sh"
+
+# Ensure provider CLI is on PATH (nvm, fnm, volta, common bin dirs)
+if ! ensure_provider_on_path "${PROVIDER_CMD}"; then
+  echo "ERROR: Provider '${PROVIDER_CMD}' not found in PATH or common installation locations" >&2
+  exit 127
+fi
 PROJECT_RUNTIME_KEY=$(project_runtime_key "${PROJECT_DIR}")
 # NOTE: Lock file path must match executorLockPath() in src/utils/status-data.ts
 LOCK_FILE="/tmp/night-watch-${PROJECT_RUNTIME_KEY}.lock"
@@ -602,6 +601,74 @@ while [ "${ATTEMPT}" -lt "${MAX_RETRIES}" ]; do
     BACKOFF_MIN=$(( BACKOFF / 60 ))
     log "RATE-LIMITED: Attempt ${ATTEMPT}/${MAX_RETRIES}, retrying in ${BACKOFF_MIN}m"
     sleep "${BACKOFF}"
+  elif check_context_exhausted "${LOG_FILE}" "${LOG_LINE_BEFORE}"; then
+    # Context window exhausted — checkpoint progress and resume in a fresh session
+    ATTEMPT=$((ATTEMPT + 1))
+    if [ "${ATTEMPT}" -ge "${MAX_RETRIES}" ]; then
+      log "CONTEXT-EXHAUSTED: All ${MAX_RETRIES} resume attempts exhausted for ${ELIGIBLE_PRD}"
+      break
+    fi
+    log "CONTEXT-EXHAUSTED: Session ${ATTEMPT_NUM} hit context limit — checkpointing and resuming (${ATTEMPT}/${MAX_RETRIES})"
+    checkpoint_timeout_progress "${WORKTREE_DIR}" "${BRANCH_NAME}" "${ELIGIBLE_PRD}"
+    git -C "${WORKTREE_DIR}" push origin "${BRANCH_NAME}" --force-with-lease >> "${LOG_FILE}" 2>&1 || true
+    # Switch prompt to "continue" mode for the next attempt (fresh context)
+    if [ -n "${ISSUE_NUMBER}" ]; then
+      PROMPT="Continue implementing PRD (GitHub issue #${ISSUE_NUMBER}: ${ISSUE_TITLE_RAW}).
+
+The previous session ran out of context window. Progress has been committed on branch ${BRANCH_NAME}.
+
+## Your task
+1. Review the current state: check git log, existing code changes, and any task list
+2. Compare against the original PRD requirements (issue #${ISSUE_NUMBER}) to identify what is already done vs remaining
+3. Continue implementing the remaining phases/tasks
+4. Do NOT redo work that is already completed and committed
+
+## Setup
+- You are already inside an isolated worktree at: ${WORKTREE_DIR}
+- Current branch is already checked out: ${BRANCH_NAME}
+- Do NOT run git checkout/switch in ${PROJECT_DIR}
+- Do NOT create or remove worktrees; the cron script manages that
+
+## Implementation — PRD Executor Workflow
+Read ${EXECUTOR_PROMPT_REF} and follow the FULL execution pipeline for remaining phases only.
+Follow all CLAUDE.md conventions (if present).
+
+## Finalize
+- Commit all changes, push, and open a PR:
+  git push -u origin ${BRANCH_NAME}
+  gh pr create --title \"feat: <short title>\" --body \"Closes #${ISSUE_NUMBER}
+
+<summary>\"
+- Do NOT process any other issues — only issue #${ISSUE_NUMBER}"
+    else
+      PROMPT="Continue implementing the PRD at ${PRD_DIR_REL}/${ELIGIBLE_PRD}
+
+The previous session ran out of context window. Progress has been committed on branch ${BRANCH_NAME}.
+
+## Your task
+1. Review the current state: check git log, existing code changes, and any task list
+2. Compare against the original PRD to identify what is already done vs remaining
+3. Continue implementing the remaining phases/tasks
+4. Do NOT redo work that is already completed and committed
+
+## Setup
+- You are already inside an isolated worktree at: ${WORKTREE_DIR}
+- Current branch is already checked out: ${BRANCH_NAME}
+- Do NOT run git checkout/switch in ${PROJECT_DIR}
+- Do NOT create or remove worktrees; the cron script manages that
+
+## Implementation — PRD Executor Workflow
+Read ${EXECUTOR_PROMPT_REF} and follow the FULL execution pipeline for remaining phases only.
+Follow all CLAUDE.md conventions (if present).
+
+## Finalize
+- Commit all changes, push, and open a PR:
+  git push -u origin ${BRANCH_NAME}
+  gh pr create --title \"feat: <short title>\" --body \"<summary referencing PRD>\"
+- Do NOT move the PRD to done/ — the cron script handles that
+- Do NOT process any other PRDs — only ${ELIGIBLE_PRD}"
+    fi
+    # No backoff — context exhaustion is not rate-limiting
   else
     # Non-retryable failure
     break
@@ -738,6 +805,18 @@ elif [ "${DOUBLE_RATE_LIMITED}" = "1" ]; then
   fi
   night_watch_history record "${PROJECT_DIR}" "${ELIGIBLE_PRD}" rate_limited --exit-code "${EXIT_CODE}" 2>/dev/null || true
   emit_result "rate_limited" "prd=${ELIGIBLE_PRD}|branch=${BRANCH_NAME}|reason=double_rate_limit"
+elif check_context_exhausted "${LOG_FILE}" "${LOG_LINE_BEFORE}"; then
+  # All resume attempts for context exhaustion were used up
+  log "FAIL: Context window exhausted after ${MAX_RETRIES} resume attempts for ${ELIGIBLE_PRD}"
+  checkpoint_timeout_progress "${WORKTREE_DIR}" "${BRANCH_NAME}" "${ELIGIBLE_PRD}"
+  git -C "${WORKTREE_DIR}" push origin "${BRANCH_NAME}" --force-with-lease >> "${LOG_FILE}" 2>&1 || true
+  if [ -n "${ISSUE_NUMBER}" ]; then
+    "${NW_CLI}" board move-issue "${ISSUE_NUMBER}" --column "Ready" 2>>"${LOG_FILE}" || true
+    "${NW_CLI}" board comment "${ISSUE_NUMBER}" \
+      --body "Context window exhausted after ${MAX_RETRIES} resume attempts (${TOTAL_ELAPSED}s total, via ${EFFECTIVE_PROVIDER_LABEL}). Progress checkpointed on branch \`${BRANCH_NAME}\`. Will resume on next run." 2>>"${LOG_FILE}" || true
+  fi
+  night_watch_history record "${PROJECT_DIR}" "${ELIGIBLE_PRD}" context_exhausted --exit-code "${EXIT_CODE}" 2>/dev/null || true
+  emit_result "failure" "prd=${ELIGIBLE_PRD}|branch=${BRANCH_NAME}|reason=context_exhausted|exit_code=${EXIT_CODE}"
 else
   PROVIDER_ERROR_DETAIL=$(latest_failure_detail "${LOG_FILE}" "${LOG_LINE_BEFORE}")
   log "FAIL: Night watch exited with code ${EXIT_CODE} while processing ${ELIGIBLE_PRD}"

package/dist/scripts/night-watch-helpers.sh

@@ -2,6 +2,78 @@
 # Night Watch helper functions — shared by cron scripts.
 # Source this file, don't execute it directly.
 
+# ── Provider PATH resolution ─────────────────────────────────────────────────
+
+# Ensure AI provider CLI (claude, codex, etc.) and Node.js tooling are
+# discoverable on PATH.  Sources common Node version managers and probes
+# well-known bin directories so the script works regardless of how the
+# provider was installed (nvm, fnm, volta, npm global, Homebrew, etc.).
+# Returns 0 if the provider is found, 1 otherwise.
+ensure_provider_on_path() {
+  local provider="${1:-claude}"
+
+  # Already available — nothing to do
+  if command -v "${provider}" >/dev/null 2>&1; then
+    return 0
+  fi
+
+  # ── Node version managers ──────────────────────────────────────────────
+  # nvm
+  export NVM_DIR="${NVM_DIR:-${HOME}/.nvm}"
+  if [ -s "${NVM_DIR}/nvm.sh" ]; then
+    # shellcheck source=/dev/null
+    . "${NVM_DIR}/nvm.sh"
+    if command -v "${provider}" >/dev/null 2>&1; then return 0; fi
+  fi
+
+  # fnm (Fast Node Manager)
+  if command -v fnm >/dev/null 2>&1; then
+    eval "$(fnm env 2>/dev/null)" || true
+  elif [ -x "${HOME}/.local/share/fnm/fnm" ]; then
+    export PATH="${HOME}/.local/share/fnm:${PATH}"
+    eval "$(fnm env 2>/dev/null)" || true
+  fi
+  if command -v "${provider}" >/dev/null 2>&1; then return 0; fi
+
+  # volta
+  if [ -d "${HOME}/.volta/bin" ]; then
+    export PATH="${HOME}/.volta/bin:${PATH}"
+    if command -v "${provider}" >/dev/null 2>&1; then return 0; fi
+  fi
+
+  # mise / asdf
+  if [ -d "${HOME}/.local/share/mise/shims" ]; then
+    export PATH="${HOME}/.local/share/mise/shims:${PATH}"
+    if command -v "${provider}" >/dev/null 2>&1; then return 0; fi
+  fi
+  if [ -d "${HOME}/.asdf/shims" ]; then
+    export PATH="${HOME}/.asdf/shims:${PATH}"
+    if command -v "${provider}" >/dev/null 2>&1; then return 0; fi
+  fi
+
+  # ── Well-known bin directories ─────────────────────────────────────────
+  local candidate_dirs=(
+    "${HOME}/.npm-global/bin"
+    "${HOME}/.local/bin"
+    "${HOME}/.claude/bin"
+    "/usr/local/bin"
+    "${HOME}/.yarn/bin"
+    "${HOME}/.bun/bin"
+    "${HOME}/.local/share/pnpm"
+    "/home/linuxbrew/.linuxbrew/bin"
+    "/opt/homebrew/bin"
+  )
+
+  for dir in "${candidate_dirs[@]}"; do
+    if [ -x "${dir}/${provider}" ]; then
+      export PATH="${dir}:${PATH}"
+      return 0
+    fi
+  done
+
+  return 1
+}
+
 # ── Provider validation ───────────────────────────────────────────────────────
 
 # Validates that the provider command is supported.
@@ -626,6 +698,19 @@ check_rate_limited() {
   fi
 }
 
+# Detect context window exhaustion from Claude API logs.
+# Usage: check_context_exhausted <log_file> [start_line]
+# Returns 0 if context exhausted, 1 otherwise.
+check_context_exhausted() {
+  local log_file="${1:?log_file required}"
+  local start_line="${2:-0}"
+  if [ "${start_line}" -gt 0 ] 2>/dev/null; then
+    tail -n "+$((start_line + 1))" "${log_file}" 2>/dev/null | grep -qi "context window"
+  else
+    tail -20 "${log_file}" 2>/dev/null | grep -qi "context window"
+  fi
+}
+
 # Resolve URL host from a URL-like string.
 # Example: "https://api.z.ai/api/anthropic" -> "api.z.ai"
 extract_url_host() {

package/dist/scripts/night-watch-pr-reviewer-cron.sh

@@ -54,18 +54,17 @@ if [ "${REVIEWER_RETRY_DELAY}" -gt 300 ]; then
   REVIEWER_RETRY_DELAY="300"
 fi
 
-# Ensure NVM / Node / Claude are on PATH
-export NVM_DIR="${HOME}/.nvm"
-[ -s "${NVM_DIR}/nvm.sh" ] && . "${NVM_DIR}/nvm.sh"
-
-# NOTE: Environment variables should be set by the caller (Node.js CLI).
-# The .env.night-watch sourcing has been removed - config is now injected via env vars.
-
 mkdir -p "${LOG_DIR}"
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck source=night-watch-helpers.sh
 source "${SCRIPT_DIR}/night-watch-helpers.sh"
+
+# Ensure provider CLI is on PATH (nvm, fnm, volta, common bin dirs)
+if ! ensure_provider_on_path "${PROVIDER_CMD}"; then
+  echo "ERROR: Provider '${PROVIDER_CMD}' not found in PATH or common installation locations" >&2
+  exit 127
+fi
 PROJECT_RUNTIME_KEY=$(project_runtime_key "${PROJECT_DIR}")
 PROVIDER_MODEL_DISPLAY=$(resolve_provider_model_display "${PROVIDER_CMD}" "${PROVIDER_LABEL}")
 GLOBAL_LOCK_FILE="/tmp/night-watch-pr-reviewer-${PROJECT_RUNTIME_KEY}.lock"

package/dist/scripts/night-watch-qa-cron.sh

@@ -29,18 +29,17 @@ QA_ARTIFACTS="${NW_QA_ARTIFACTS:-both}"
 QA_AUTO_INSTALL_PLAYWRIGHT="${NW_QA_AUTO_INSTALL_PLAYWRIGHT:-1}"
 SCRIPT_START_TIME=$(date +%s)
 
-# Ensure NVM / Node / Claude are on PATH
-export NVM_DIR="${HOME}/.nvm"
-[ -s "${NVM_DIR}/nvm.sh" ] && . "${NVM_DIR}/nvm.sh"
-
-# NOTE: Environment variables should be set by the caller (Node.js CLI).
-# The .env.night-watch sourcing has been removed - config is now injected via env vars.
-
 mkdir -p "${LOG_DIR}"
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck source=night-watch-helpers.sh
 source "${SCRIPT_DIR}/night-watch-helpers.sh"
+
+# Ensure provider CLI is on PATH (nvm, fnm, volta, common bin dirs)
+if ! ensure_provider_on_path "${PROVIDER_CMD}"; then
+  echo "ERROR: Provider '${PROVIDER_CMD}' not found in PATH or common installation locations" >&2
+  exit 127
+fi
 PROJECT_RUNTIME_KEY=$(project_runtime_key "${PROJECT_DIR}")
 # NOTE: Lock file path must match qaLockPath() in src/utils/status-data.ts
 LOCK_FILE="/tmp/night-watch-qa-${PROJECT_RUNTIME_KEY}.lock"

package/dist/scripts/night-watch-slicer-cron.sh

@@ -25,15 +25,14 @@ PROVIDER_CMD="${NW_PROVIDER_CMD:-claude}"
 PROVIDER_LABEL="${NW_PROVIDER_LABEL:-}"
 SCRIPT_START_TIME=$(date +%s)
 
-# Ensure NVM / Node / Night Watch CLI are on PATH
-export NVM_DIR="${HOME}/.nvm"
-[ -s "${NVM_DIR}/nvm.sh" ] && . "${NVM_DIR}/nvm.sh"
-
 mkdir -p "${LOG_DIR}"
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck source=night-watch-helpers.sh
 source "${SCRIPT_DIR}/night-watch-helpers.sh"
+
+# Ensure provider CLI is on PATH (nvm, fnm, volta, common bin dirs)
+ensure_provider_on_path "${PROVIDER_CMD}" || true
 PROJECT_RUNTIME_KEY=$(project_runtime_key "${PROJECT_DIR}")
 LOCK_FILE="/tmp/night-watch-slicer-${PROJECT_RUNTIME_KEY}.lock"
 PROVIDER_MODEL_DISPLAY=$(resolve_provider_model_display "${PROVIDER_CMD}" "${PROVIDER_LABEL}")